{"version":3,"sources":["../../../../../src/orm/adapters/mongodb/index.ts","../../../../../src/errors/equippedError.ts","../../../../../src/instance/index.ts","../../../../../src/instance/hooks.ts","../../../../../src/instance/settings.ts","../../../../../src/orm/fields.ts","../../../../../src/orm/filter.ts","../../../../../src/orm/updates.ts","../../../../../src/orm/adapters/mongodb/query.ts","../../../../../src/utilities/configurable.ts","../../../../../src/orm/orm-adapter.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { MongoClient, type ClientSession, type MongoClientOptions, type OptionalUnlessRequiredId } from 'mongodb'\nimport { v, type PipeOutput } from 'valleyed'\n\nimport { compileMongoAggregate, compileMongoFilter, compileMongoOps, compileMongoQuery, compileMongoUpdate } from './query'\nimport { EquippedError } from '../../../errors'\nimport { configurable } from '../../../utilities/configurable'\nimport type { FilterGroup } from '../../filter'\nimport type { DiscoveredSchema } from '../../migrations/introspection-types'\nimport type { AddIndexChange, DropIndexChange } from '../../migrations/types'\nimport { OrmAdapter, type AggregateSpec } from '../../orm-adapter'\nimport type { IterationQueryOptions, QueryOptions } from '../../query-options'\nimport type { AnySchema } from '../../schema'\nimport type { AnyUpdateOp } from '../../updates'\n\nconst mongoSchemaConfigPipe = () => v.object({ db: v.string(), col: v.string() })\nexport type MongoDbRepoConfig = PipeOutput<ReturnType<typeof mongoSchemaConfigPipe>>\n\nconst mongoConnectionPipe = () =>\n\tv.object({\n\t\turi: v.string(),\n\t})\n\nconst MIGRATION_TRACKER_COLLECTION = 'equipped_migrations'\n\nexport class MongoDbAdapter extends configurable(mongoConnectionPipe, OrmAdapter) {\n\treadonly schemaConfigPipe = mongoSchemaConfigPipe()\n\n\treadonly queryableOps = ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'notIn', 'like', 'exists', 'notExists', 'contains', 'notContains'] as const\n\treadonly updateOps = ['set', 'inc', 'mul', 'min', 'max', 'unset', 'push', 'pull', 'patch'] as const\n\treadonly aggregateOps = ['count', 'countDistinct', 'sum', 'avg', 'min', 'max'] as const\n\treadonly supportedFieldTypes = ['string', 'number', 'boolean', 'null', 'object', 'array', 'date'] as const\n\n\treadonly client: MongoClient\n\treadonly #sessionStore = new AsyncLocalStorage<ClientSession | undefined>()\n\n\tprotected constructor(config: typeof MongoDbAdapter.Config, options?: MongoClientOptions) {\n\t\tsuper(config)\n\t\tthis.client = new MongoClient(config.uri, {\n\t\t\t...options,\n\t\t\tignoreUndefined: true,\n\t\t})\n\t}\n\n\t#getCollection(schemaCfg: MongoDbRepoConfig) {\n\t\treturn this.client.db(schemaCfg.db).collection(schemaCfg.col)\n\t}\n\n\tasync connect() {\n\t\ttry {\n\t\t\tawait this.client.connect()\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('Failed to connect MongoDB client', { adapter: 'mongodb' }, error)\n\t\t}\n\t}\n\n\tasync disconnect() {\n\t\ttry {\n\t\t\tawait this.client.close()\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('Failed to disconnect MongoDB client', { adapter: 'mongodb' }, error)\n\t\t}\n\t}\n\n\tasync findByPk(schema: AnySchema, config: unknown, pk: unknown) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pkName = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst doc = await collection.findOne(\n\t\t\t\t{ [pkName]: pk },\n\t\t\t\t{ session: this.#sessionStore.getStore() },\n\t\t\t)\n\t\t\treturn doc as Record<string, unknown> | null\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB findByPk failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'findByPk', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync createMany(_schema: AnySchema, config: unknown, data: Record<string, unknown>[]) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst docs = data.map((d) => d as OptionalUnlessRequiredId<any>)\n\t\t\tawait collection.insertMany(docs, { session: this.#sessionStore.getStore() })\n\t\t\treturn data\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB createMany failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'createMany', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync updateByPk(schema: AnySchema, config: unknown, pk: unknown, ops: AnyUpdateOp[]) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pkName = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst update = compileMongoOps(ops)\n\t\t\tif (Object.keys(update).length === 0) {\n\t\t\t\treturn await collection.findOne({ [pkName]: pk }, { session: this.#sessionStore.getStore() }) as Record<string, unknown> | null\n\t\t\t}\n\t\t\treturn await collection.findOneAndUpdate(\n\t\t\t\t{ [pkName]: pk },\n\t\t\t\tupdate,\n\t\t\t\t{ returnDocument: 'after', session: this.#sessionStore.getStore() },\n\t\t\t) as Record<string, unknown> | null\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB updateByPk failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'updateByPk', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync deleteByPk(schema: AnySchema, config: unknown, pk: unknown) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pkName = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\treturn await collection.findOneAndDelete(\n\t\t\t\t{ [pkName]: pk },\n\t\t\t\t{ session: this.#sessionStore.getStore() },\n\t\t\t) as Record<string, unknown> | null\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB deleteByPk failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'deleteByPk', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync raw(_schema: AnySchema, config: unknown, pipeline: Record<string, unknown>[]) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst result = await collection.aggregate(pipeline, { session: this.#sessionStore.getStore() }).toArray()\n\t\t\treturn result\n\t\t} catch (error) {\n\t\t\tif (error instanceof EquippedError) throw error\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB raw failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'raw', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync aggregate(schema: AnySchema, config: unknown, spec: AggregateSpec): Promise<Array<Record<string, unknown>>> {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst pipeline = compileMongoAggregate(spec, pk)\n\t\t\tconst result = await collection.aggregate(pipeline, { session: this.#sessionStore.getStore() }).toArray()\n\t\t\treturn result as Array<Record<string, unknown>>\n\t\t} catch (error) {\n\t\t\tif (error instanceof EquippedError) throw error\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB aggregate failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'aggregate', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync findMany(schema: AnySchema, config: unknown, filter: FilterGroup, options?: QueryOptions) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst { filter: mongoFilter, sort, limit, skip, projection } = compileMongoQuery(filter, options, pk)\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\n\t\t\tlet cursor = collection.find(mongoFilter, {\n\t\t\t\tsession: this.#sessionStore.getStore(),\n\t\t\t\tprojection,\n\t\t\t})\n\t\t\tif (sort) cursor = cursor.sort(sort)\n\t\t\tif (limit) cursor = cursor.limit(limit)\n\t\t\tif (skip) cursor = cursor.skip(skip)\n\n\t\t\treturn await cursor.toArray()\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB findMany failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'findMany', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync count(schema: AnySchema, config: unknown, filter: FilterGroup) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\treturn await collection.countDocuments(compileMongoFilter(filter, pk), { session: this.#sessionStore.getStore() })\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB count failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'count', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync *iterateMany(schema: AnySchema, config: unknown, filter: FilterGroup, options?: IterationQueryOptions) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\tlet cursor: any\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst { filter: mongoFilter, sort, limit, skip, projection } = compileMongoQuery(filter, options, pk)\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\n\t\t\tcursor = collection.find(mongoFilter, {\n\t\t\t\tsession: this.#sessionStore.getStore(),\n\t\t\t\tprojection,\n\t\t\t})\n\t\t\tif (sort) cursor = cursor.sort(sort)\n\t\t\tif (limit) cursor = cursor.limit(limit)\n\t\t\tif (skip) cursor = cursor.skip(skip)\n\t\t\tif (options?.batchSize !== undefined) cursor = cursor.batchSize(options.batchSize)\n\n\t\t\tfor await (const row of cursor) {\n\t\t\t\tyield row as Record<string, unknown>\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB iterateMany failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'iterateMany', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t} finally {\n\t\t\tawait cursor?.close()\n\t\t}\n\t}\n\n\tasync updateMany(schema: AnySchema, config: unknown, filter: FilterGroup, data: Record<string, unknown>) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst session = this.#sessionStore.getStore()\n\t\t\tconst mongoFilter = compileMongoFilter(filter, pk)\n\n\t\t\tconst matchingDocs = await collection.find(mongoFilter, { session, projection: { [pk]: 1 } }).toArray()\n\t\t\tconst ids = matchingDocs.map((d) => d[pk])\n\t\t\tconst idFilter = { [pk]: { $in: ids } }\n\n\t\t\tconst update = compileMongoUpdate(data)\n\t\t\tif (Object.keys(update).length > 0) {\n\t\t\t\tawait collection.updateMany(idFilter, update, { session })\n\t\t\t}\n\n\t\t\treturn await collection.find({ [pk]: { $in: ids } }, { session }).toArray()\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB updateMany failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'updateMany', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync deleteMany(schema: AnySchema, config: unknown, filter: FilterGroup) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst session = this.#sessionStore.getStore()\n\t\t\tconst mongoFilter = compileMongoFilter(filter, pk)\n\n\t\t\tconst docs = await collection.find(mongoFilter, { session }).toArray()\n\t\t\tif (docs.length > 0) {\n\t\t\t\tawait collection.deleteMany(mongoFilter, { session })\n\t\t\t}\n\t\t\treturn docs\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB deleteMany failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'deleteMany', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync upsertOne(schema: AnySchema, config: unknown, filter: FilterGroup, create: Record<string, unknown>, ops: AnyUpdateOp[]) {\n\t\tconst schemaCfg = config as MongoDbRepoConfig\n\t\ttry {\n\t\t\tconst pk = schema.pkField.name\n\t\t\tconst collection = this.#getCollection(schemaCfg)\n\t\t\tconst mongoFilter = compileMongoFilter(filter, pk)\n\n\t\t\tconst updateDoc = compileMongoOps(ops)\n\t\t\tconst doc = await collection.findOneAndUpdate(\n\t\t\t\tmongoFilter,\n\t\t\t\t{\n\t\t\t\t\t...updateDoc,\n\t\t\t\t\t$setOnInsert: create,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\treturnDocument: 'after',\n\t\t\t\t\tsession: this.#sessionStore.getStore(),\n\t\t\t\t\tupsert: true,\n\t\t\t\t},\n\t\t\t)\n\n\t\t\treturn doc as Record<string, unknown>\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'MongoDB upsertOne failed',\n\t\t\t\t{ adapter: 'mongodb', operation: 'upsertOne', collection: schemaCfg.col },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync session<T>(fn: () => Promise<T>): Promise<T> {\n\t\tif (this.#sessionStore.getStore()) return fn()\n\t\ttry {\n\t\t\tconst session = await this.client.startSession()\n\t\t\ttry {\n\t\t\t\treturn await session.withTransaction(async () => this.#sessionStore.run(session, fn))\n\t\t\t} finally {\n\t\t\t\tawait session.endSession()\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (error instanceof EquippedError) throw error\n\t\t\tthrow new EquippedError('MongoDB session failed', { adapter: 'mongodb', operation: 'session' }, error)\n\t\t}\n\t}\n\n\tasync loadMigrations(): Promise<{ id: string; appliedAt: number }[]> {\n\t\tconst db = this.client.db()\n\t\tconst docs = await db.collection(MIGRATION_TRACKER_COLLECTION).find({}).toArray()\n\t\treturn docs.map((d) => ({ id: String(d._id), appliedAt: d.appliedAt as number }))\n\t}\n\n\tasync recordMigration(id: string, appliedAt: number): Promise<void> {\n\t\tconst db = this.client.db()\n\t\tawait db.collection(MIGRATION_TRACKER_COLLECTION).insertOne({ _id: id as any, appliedAt })\n\t}\n\n\tasync applyAddIndex(change: AddIndexChange): Promise<void> {\n\t\tconst db = this.client.db()\n\t\tconst fields: Record<string, 1> = {}\n\t\tfor (const f of change.on) {\n\t\t\tfields[f] = 1\n\t\t}\n\t\tconst name = change.name ?? `${change.table}_${change.on.join('_')}_idx`\n\t\tawait db.collection(change.table).createIndex(fields, { unique: change.unique ?? false, name })\n\t}\n\n\tasync applyDropIndex(change: DropIndexChange): Promise<void> {\n\t\tconst db = this.client.db()\n\t\tconst collections = await db.listCollections().toArray()\n\t\tfor (const col of collections) {\n\t\t\tconst indexes = await db.collection(col.name).listIndexes().toArray()\n\t\t\tif (indexes.some((idx) => idx.name === change.name)) {\n\t\t\t\tawait db.collection(col.name).dropIndex(change.name)\n\t\t\t\treturn\n\t\t\t}\n\t\t}\n\t}\n\n\tasync introspect(): Promise<DiscoveredSchema[]> {\n\t\tconst db = this.client.db()\n\t\tconst collections = await db.listCollections().toArray()\n\t\tconst schemas: DiscoveredSchema[] = []\n\t\tfor (const col of collections) {\n\t\t\tif (col.name === MIGRATION_TRACKER_COLLECTION) continue\n\t\t\tconst rawIndexes = await db.collection(col.name).listIndexes().toArray()\n\t\t\tconst indexes = rawIndexes\n\t\t\t\t.filter((idx) => idx.name !== '_id_')\n\t\t\t\t.map((idx) => ({\n\t\t\t\t\tname: idx.name as string,\n\t\t\t\t\ton: Object.keys(idx.key as Record<string, unknown>) as ReadonlyArray<string>,\n\t\t\t\t\tunique: !!(idx.unique),\n\t\t\t\t}))\n\t\t\tschemas.push({\n\t\t\t\tname: col.name,\n\t\t\t\tpk: undefined,\n\t\t\t\tfields: [],\n\t\t\t\tindexes,\n\t\t\t\tforeignKeys: [],\n\t\t\t})\n\t\t}\n\t\treturn schemas\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect, expectTypeOf } = import.meta.vitest\n\n\tdescribe('MongoDbAdapter: class-via-configurable shape', () => {\n\t\ttest('MongoDbAdapter.create validates connection config via pipe', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\texpect(adapter).toBeInstanceOf(MongoDbAdapter)\n\t\t\texpect(adapter.client).toBeInstanceOf(MongoClient)\n\t\t})\n\n\t\ttest('MongoDbAdapter.create rejects invalid config', () => {\n\t\t\texpect(() => MongoDbAdapter.create({} as any)).toThrow()\n\t\t\texpect(() => MongoDbAdapter.create({ uri: 123 } as any)).toThrow()\n\t\t})\n\n\t\ttest('readonly schemaConfigPipe declared with { db, col } shape', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\texpect(adapter.schemaConfigPipe).toBeDefined()\n\t\t})\n\n\t\ttest('capability declarations use as const', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\n\t\t\texpect(adapter.supportedFieldTypes).toEqual([\n\t\t\t\t'string', 'number', 'boolean', 'null', 'object', 'array', 'date',\n\t\t\t])\n\t\t\texpect(adapter.queryableOps).toEqual([\n\t\t\t\t'eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'notIn', 'like', 'exists', 'notExists', 'contains', 'notContains',\n\t\t\t])\n\t\t\texpect(adapter.updateOps).toEqual([\n\t\t\t\t'set', 'inc', 'mul', 'min', 'max', 'unset', 'push', 'pull', 'patch',\n\t\t\t])\n\t\t\texpect(adapter.aggregateOps).toEqual([\n\t\t\t\t'count', 'countDistinct', 'sum', 'avg', 'min', 'max',\n\t\t\t])\n\t\t})\n\n\t\ttest('underlying MongoClient exposed as readonly instance field', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\texpect(adapter.client).toBeInstanceOf(MongoClient)\n\t\t})\n\n\t\ttest('adapter.use returns OrmUse-shaped object', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst schema = Schema.from('test').pk('id', v.string(), () => 'x').build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tconst use = adapter.use(schema, { db: 'testdb', col: 'testcol' })\n\n\t\t\texpect(use.findMany).toBeTypeOf('function')\n\t\t\texpect(use.iterateMany).toBeTypeOf('function')\n\t\t\texpect(use.findOne).toBeTypeOf('function')\n\t\t\texpect(use.count).toBeTypeOf('function')\n\t\t\texpect(use.createOne).toBeTypeOf('function')\n\t\t\texpect(use.createMany).toBeTypeOf('function')\n\t\t\texpect(use.updateMany).toBeTypeOf('function')\n\t\t\texpect(use.updateOne).toBeTypeOf('function')\n\t\t\texpect(use.upsertOne).toBeTypeOf('function')\n\t\t\texpect(use.deleteOne).toBeTypeOf('function')\n\t\t\texpect(use.deleteMany).toBeTypeOf('function')\n\t\t\texpect(use.raw).toBeTypeOf('function')\n\t\t})\n\n\t\ttest('type-level: adapter declares all 9 canonical update ops', () => {\n\t\t\tconst _adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\ttype Ops = typeof _adapter.updateOps\n\t\t\texpectTypeOf<Ops>().toEqualTypeOf<\n\t\t\t\treadonly ['set', 'inc', 'mul', 'min', 'max', 'unset', 'push', 'pull', 'patch']\n\t\t\t>()\n\t\t})\n\n\t\ttest('type-level: adapter declares all 7 field types', () => {\n\t\t\tconst _adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\ttype Types = typeof _adapter.supportedFieldTypes\n\t\t\texpectTypeOf<Types>().toEqualTypeOf<\n\t\t\t\treadonly ['string', 'number', 'boolean', 'null', 'object', 'array', 'date']\n\t\t\t>()\n\t\t})\n\n\t\ttest('type-level: adapter declares all 13 queryable ops', () => {\n\t\t\tconst _adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\ttype Ops = typeof _adapter.queryableOps\n\t\t\texpectTypeOf<Ops>().toEqualTypeOf<\n\t\t\t\treadonly ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'notIn', 'like', 'exists', 'notExists', 'contains', 'notContains']\n\t\t\t>()\n\t\t})\n\n\t\ttest('type-level: Repo.from with MongoDbAdapter enables all builder methods', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\t\t\tconst _TestSchema = Schema.from('test').pk('id', v.string(), () => 'x').build()\n\n\t\t\tconst _one = repo.on(_TestSchema).one()\n\t\t\tconst _all = repo.on(_TestSchema).all()\n\t\t\tconst _ref = repo.on(_TestSchema)\n\t\t\texpectTypeOf(_one.create).toBeFunction()\n\t\t\texpectTypeOf(_one.find).toBeFunction()\n\t\t\texpectTypeOf(_one.update).toBeFunction()\n\t\t\texpectTypeOf(_one.delete).toBeFunction()\n\t\t\texpectTypeOf(_one.upsert).toBeFunction()\n\t\t\texpectTypeOf(_all.create).toBeFunction()\n\t\t\texpectTypeOf(_all.find).toBeFunction()\n\t\t\texpectTypeOf(_all.count).toBeFunction()\n\t\t\texpectTypeOf(_all.update).toBeFunction()\n\t\t\texpectTypeOf(_all.delete).toBeFunction()\n\t\t\texpectTypeOf(_ref.raw).toBeFunction()\n\t\t\texpectTypeOf(repo.session).toBeFunction()\n\t\t})\n\n\t\ttest('type-level: raw arg-tuple infers (pipeline: Record<string, unknown>[]) from MongoDbAdapter', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\t\t\tconst _TestSchema = Schema.from('test').pk('id', v.string(), () => 'x').build()\n\t\t\tconst _ref = repo.on(_TestSchema)\n\n\t\t\texpectTypeOf(_ref.raw).parameters.toEqualTypeOf<[pipeline: Record<string, unknown>[]]>()\n\t\t})\n\n\t\ttest('type-level: per-call <T> override narrows MongoDbAdapter raw return type', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\t\t\tconst _TestSchema = Schema.from('test').pk('id', v.string(), () => 'x').build()\n\t\t\tconst _ref = repo.on(_TestSchema)\n\n\t\t\texpectTypeOf(_ref.raw<{ total: number }[]>).returns.toEqualTypeOf<Promise<{ total: number }[]>>()\n\t\t})\n\n\t\ttest('count forwards compiled filter to collection.countDocuments', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\t\t\tconst schema = Schema.from('mongo_count').pk('_id', v.string(), () => 'x').field('name', v.string()).build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tlet capturedFilter: unknown\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: () => ({\n\t\t\t\t\tcountDocuments: async (filter: unknown, _opts: unknown) => {\n\t\t\t\t\t\tcapturedFilter = filter\n\t\t\t\t\t\treturn 7\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t})\n\n\t\t\tconst result = await adapter.count(schema, { db: 'testdb', col: 'things' }, FilterGroup.create().eq('name', 'Alice'))\n\t\t\texpect(capturedFilter).toEqual({ name: { $eq: 'Alice' } })\n\t\t\texpect(result).toBe(7)\n\t\t})\n\n\t\ttest('raw forwards pipeline to collection.aggregate at runtime', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst schema = Schema.from('mongo_raw').pk('id', v.string(), () => 'x').build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tlet capturedPipeline: unknown\n\t\t\tconst mockResults = [{ total: 42 }]\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: () => ({\n\t\t\t\t\taggregate: (pipeline: unknown, _opts: unknown) => {\n\t\t\t\t\t\tcapturedPipeline = pipeline\n\t\t\t\t\t\treturn { toArray: async () => mockResults }\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t})\n\t\t\tconst result = await adapter.use(schema, { db: 'testdb', col: 'things' }).raw([{ $count: 'total' }])\n\t\t\texpect(capturedPipeline).toEqual([{ $count: 'total' }])\n\t\t\texpect(result).toEqual(mockResults)\n\t\t})\n\n\t\ttest('iterateMany forwards batchSize and closes cursor on early return', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\t\t\tconst { OrderBy } = await import('../../query-options')\n\t\t\tconst schema = Schema.from('mongo_iter').pk('_id', v.string(), () => 'x').field('age', v.number()).build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tlet capturedFindFilter: unknown\n\t\t\tlet capturedFindOptions: unknown\n\t\t\tlet capturedSort: unknown\n\t\t\tlet capturedLimit: unknown\n\t\t\tlet capturedSkip: unknown\n\t\t\tlet capturedBatchSize: unknown\n\t\t\tlet closeCalls = 0\n\t\t\tconst cursor = {\n\t\t\t\tsort(sort: unknown) {\n\t\t\t\t\tcapturedSort = sort\n\t\t\t\t\treturn this\n\t\t\t\t},\n\t\t\t\tlimit(limit: unknown) {\n\t\t\t\t\tcapturedLimit = limit\n\t\t\t\t\treturn this\n\t\t\t\t},\n\t\t\t\tskip(skip: unknown) {\n\t\t\t\t\tcapturedSkip = skip\n\t\t\t\t\treturn this\n\t\t\t\t},\n\t\t\t\tbatchSize(batchSize: unknown) {\n\t\t\t\t\tcapturedBatchSize = batchSize\n\t\t\t\t\treturn this\n\t\t\t\t},\n\t\t\t\tasync close() {\n\t\t\t\t\tcloseCalls += 1\n\t\t\t\t},\n\t\t\t\tasync *[Symbol.asyncIterator]() {\n\t\t\t\t\tyield { _id: 'u4', age: 50 }\n\t\t\t\t\tyield { _id: 'u3', age: 40 }\n\t\t\t\t},\n\t\t\t}\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: () => ({\n\t\t\t\t\tfind: (filter: unknown, options: unknown) => {\n\t\t\t\t\t\tcapturedFindFilter = filter\n\t\t\t\t\t\tcapturedFindOptions = options\n\t\t\t\t\t\treturn cursor\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t})\n\n\t\t\tconst rows: Record<string, unknown>[] = []\n\t\t\tfor await (const row of adapter.use(schema, { db: 'testdb', col: 'people' }).iterateMany(FilterGroup.create().gt('age', 19), {\n\t\t\t\torderBy: [new OrderBy('age', 'desc')],\n\t\t\t\toffset: 1,\n\t\t\t\tlimit: 2,\n\t\t\t\tbatchSize: 25,\n\t\t\t})) {\n\t\t\t\trows.push(row)\n\t\t\t\tbreak\n\t\t\t}\n\n\t\t\texpect(capturedFindFilter).toEqual({ age: { $gt: 19 } })\n\t\t\texpect(capturedFindOptions).toEqual({ session: undefined, projection: undefined })\n\t\t\texpect(capturedSort).toEqual({ age: -1 })\n\t\t\texpect(capturedLimit).toBe(2)\n\t\t\texpect(capturedSkip).toBe(1)\n\t\t\texpect(capturedBatchSize).toBe(25)\n\t\t\texpect(rows).toEqual([{ _id: 'u4', age: 50 }])\n\t\t\texpect(closeCalls).toBe(1)\n\t\t})\n\n\t\ttest('iterateMany closes cursor on normal completion', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\t\t\tconst schema = Schema.from('mongo_iter_complete').pk('_id', v.string(), () => 'x').field('age', v.number()).build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tlet closeCalls = 0\n\t\t\tconst cursor = {\n\t\t\t\tasync close() {\n\t\t\t\t\tcloseCalls += 1\n\t\t\t\t},\n\t\t\t\tasync *[Symbol.asyncIterator]() {\n\t\t\t\t\tyield { _id: 'u1', age: 30 }\n\t\t\t\t\tyield { _id: 'u2', age: 40 }\n\t\t\t\t},\n\t\t\t}\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: () => ({\n\t\t\t\t\tfind: () => cursor,\n\t\t\t\t}),\n\t\t\t})\n\n\t\t\tconst rows: Record<string, unknown>[] = []\n\t\t\tfor await (const row of adapter.use(schema, { db: 'testdb', col: 'people' }).iterateMany(FilterGroup.create())) {\n\t\t\t\trows.push(row)\n\t\t\t}\n\n\t\t\texpect(rows).toEqual([{ _id: 'u1', age: 30 }, { _id: 'u2', age: 40 }])\n\t\t\texpect(closeCalls).toBe(1)\n\t\t})\n\n\t\ttest('nested session returns callback without starting new transaction', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\texpect(adapter.session).toBeTypeOf('function')\n\t\t})\n\n\t\ttest('type-level: adapter declares all 6 canonical aggregate ops', () => {\n\t\t\tconst _adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\ttype Ops = typeof _adapter.aggregateOps\n\t\t\texpectTypeOf<Ops>().toEqualTypeOf<\n\t\t\t\treadonly ['count', 'countDistinct', 'sum', 'avg', 'min', 'max']\n\t\t\t>()\n\t\t})\n\n\t\ttest('type-level: Repo.from with MongoDbAdapter enables aggregate method', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\t\t\tconst _TestSchema = Schema.from('test').pk('id', v.string(), () => 'x').build()\n\t\t\tconst _ref = repo.on(_TestSchema)\n\t\t\texpectTypeOf(_ref.aggregate).toBeFunction()\n\t\t})\n\n\t\ttest('aggregate forwards compiled pipeline to collection.aggregate', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst schema = Schema.from('mongo_agg').pk('_id', v.string(), () => 'x').field('amount', v.number()).build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tlet capturedPipeline: unknown\n\t\t\tconst mockResults = [{ total: 3, revenue: 150 }]\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: () => ({\n\t\t\t\t\taggregate: (pipeline: unknown, _opts: unknown) => {\n\t\t\t\t\t\tcapturedPipeline = pipeline\n\t\t\t\t\t\treturn { toArray: async () => mockResults }\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t})\n\t\t\tconst result = await adapter.aggregate(schema, { db: 'testdb', col: 'orders' }, {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'count', alias: 'total' },\n\t\t\t\t\t{ fn: 'sum', field: 'amount', alias: 'revenue' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t})\n\t\t\texpect(capturedPipeline).toEqual([\n\t\t\t\t{ $group: { _id: null, total: { $sum: 1 }, revenue: { $sum: '$amount' } } },\n\t\t\t\t{ $project: { _id: 0, total: 1, revenue: 1 } },\n\t\t\t])\n\t\t\texpect(result).toEqual(mockResults)\n\t\t})\n\n\t\ttest('aggregate with where and groupBy produces correct pipeline', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { v } = await import('valleyed')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\t\t\tconst schema = Schema.from('mongo_agg2').pk('_id', v.string(), () => 'x').field('region', v.string()).field('amount', v.number()).build()\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\t\t\tlet capturedPipeline: unknown\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: () => ({\n\t\t\t\t\taggregate: (pipeline: unknown, _opts: unknown) => {\n\t\t\t\t\t\tcapturedPipeline = pipeline\n\t\t\t\t\t\treturn { toArray: async () => [{ region: 'US', total: 2 }] }\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t})\n\t\t\tawait adapter.aggregate(schema, { db: 'testdb', col: 'orders' }, {\n\t\t\t\twhere: FilterGroup.create().gt('amount', 10),\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t})\n\t\t\texpect(capturedPipeline).toEqual([\n\t\t\t\t{ $match: { amount: { $gt: 10 } } },\n\t\t\t\t{ $group: { _id: { region: '$region' }, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, region: '$_id.region', total: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('auto-wires Instance hooks for connect/disconnect', async () => {\n\t\t\tconst { Instance: Inst } = await import('../../../instance')\n\t\t\tconst { vi } = await import('vitest')\n\t\t\tconst onSpy = vi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tMongoDbAdapter.create({ uri: 'mongodb://localhost:27017' })\n\n\t\t\texpect(onSpy).toHaveBeenCalledWith('start', expect.any(Function), expect.objectContaining({ class: MongoDbAdapter }))\n\t\t\texpect(onSpy).toHaveBeenCalledWith('close', expect.any(Function), expect.objectContaining({ class: MongoDbAdapter }))\n\n\t\t\tonSpy.mockRestore()\n\t\t})\n\t})\n\n\tdescribe('MongoDbAdapter: migrations', () => {\n\t\tfunction mockMongoDb(adapter: MongoDbAdapter) {\n\t\t\tconst state = {\n\t\t\t\tmigrations: new Map<string, { _id: string; appliedAt: number }>(),\n\t\t\t\tcollections: new Map<string, { indexes: Array<{ name: string; key: Record<string, number>; unique?: boolean }> }>(),\n\t\t\t}\n\n\t\t\tconst getCol = (name: string) => {\n\t\t\t\tif (!state.collections.has(name)) {\n\t\t\t\t\tstate.collections.set(name, { indexes: [] })\n\t\t\t\t}\n\t\t\t\treturn state.collections.get(name)!\n\t\t\t}\n\n\t\t\t;(adapter.client as any).db = () => ({\n\t\t\t\tcollection: (name: string) => {\n\t\t\t\t\tif (name === MIGRATION_TRACKER_COLLECTION) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tfind: () => ({ toArray: async () => [...state.migrations.values()] }),\n\t\t\t\t\t\t\tinsertOne: async (doc: { _id: string; appliedAt: number }) => {\n\t\t\t\t\t\t\t\tstate.migrations.set(doc._id, doc)\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tconst col = getCol(name)\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcreateIndex: async (fields: Record<string, number>, opts: { unique?: boolean; name: string }) => {\n\t\t\t\t\t\t\tcol.indexes.push({ name: opts.name, key: fields, unique: opts.unique })\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdropIndex: async (indexName: string) => {\n\t\t\t\t\t\t\tcol.indexes = col.indexes.filter((i) => i.name !== indexName)\n\t\t\t\t\t\t},\n\t\t\t\t\t\tlistIndexes: () => ({\n\t\t\t\t\t\t\ttoArray: async () => [\n\t\t\t\t\t\t\t\t{ name: '_id_', key: { _id: 1 } },\n\t\t\t\t\t\t\t\t...col.indexes,\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t}),\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tlistCollections: () => ({\n\t\t\t\t\ttoArray: async () => [...state.collections.keys()].map((name) => ({ name })),\n\t\t\t\t}),\n\t\t\t})\n\n\t\t\treturn state\n\t\t}\n\n\t\ttest('loadMigrations reads from equipped_migrations collection', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tstate.migrations.set('0001', { _id: '0001', appliedAt: 1000 })\n\t\t\tstate.migrations.set('0002', { _id: '0002', appliedAt: 2000 })\n\n\t\t\tconst result = await adapter.loadMigrations()\n\t\t\texpect(result).toEqual([\n\t\t\t\t{ id: '0001', appliedAt: 1000 },\n\t\t\t\t{ id: '0002', appliedAt: 2000 },\n\t\t\t])\n\t\t})\n\n\t\ttest('loadMigrations returns empty array when no migrations exist', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tmockMongoDb(adapter)\n\n\t\t\tconst result = await adapter.loadMigrations()\n\t\t\texpect(result).toEqual([])\n\t\t})\n\n\t\ttest('recordMigration inserts into equipped_migrations with _id', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\n\t\t\tawait adapter.recordMigration('0001', 1234)\n\n\t\t\texpect(state.migrations.has('0001')).toBe(true)\n\t\t\texpect(state.migrations.get('0001')).toEqual({ _id: '0001', appliedAt: 1234 })\n\t\t})\n\n\t\ttest('applyAddIndex creates index with specified name and fields', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\n\t\t\tawait adapter.applyAddIndex({ kind: 'addIndex', table: 'users', on: ['email'], unique: true, name: 'users_email_unique' })\n\n\t\t\tconst col = state.collections.get('users')!\n\t\t\texpect(col.indexes).toHaveLength(1)\n\t\t\texpect(col.indexes[0]).toEqual({ name: 'users_email_unique', key: { email: 1 }, unique: true })\n\t\t})\n\n\t\ttest('applyAddIndex auto-derives name when absent', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\n\t\t\tawait adapter.applyAddIndex({ kind: 'addIndex', table: 'users', on: ['email'] })\n\n\t\t\tconst col = state.collections.get('users')!\n\t\t\texpect(col.indexes[0].name).toBe('users_email_idx')\n\t\t})\n\n\t\ttest('applyAddIndex auto-derived compound index name', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\n\t\t\tawait adapter.applyAddIndex({ kind: 'addIndex', table: 'orders', on: ['userId', 'createdAt'] })\n\n\t\t\tconst col = state.collections.get('orders')!\n\t\t\texpect(col.indexes[0].name).toBe('orders_userId_createdAt_idx')\n\t\t\texpect(col.indexes[0].key).toEqual({ userId: 1, createdAt: 1 })\n\t\t})\n\n\t\ttest('applyDropIndex finds and drops index by scanning collections', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tstate.collections.set('users', { indexes: [{ name: 'users_email_idx', key: { email: 1 }, unique: true }] })\n\n\t\t\tawait adapter.applyDropIndex({ kind: 'dropIndex', name: 'users_email_idx' })\n\n\t\t\texpect(state.collections.get('users')!.indexes).toHaveLength(0)\n\t\t})\n\n\t\ttest('applyDropIndex is a no-op when index not found', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tmockMongoDb(adapter)\n\n\t\t\tawait adapter.applyDropIndex({ kind: 'dropIndex', name: 'nonexistent_idx' })\n\t\t})\n\n\t\ttest('introspect returns DiscoveredSchema with empty fields, pk, and foreignKeys', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tstate.collections.set('users', { indexes: [] })\n\t\t\tstate.collections.set('posts', { indexes: [] })\n\n\t\t\tconst schemas = await adapter.introspect()\n\n\t\t\texpect(schemas).toHaveLength(2)\n\t\t\tfor (const s of schemas) {\n\t\t\t\texpect(s.pk).toBeUndefined()\n\t\t\t\texpect(s.fields).toEqual([])\n\t\t\t\texpect(s.foreignKeys).toEqual([])\n\t\t\t}\n\t\t})\n\n\t\ttest('introspect skips _id_ index', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tstate.collections.set('users', { indexes: [{ name: 'users_email_idx', key: { email: 1 }, unique: false }] })\n\n\t\t\tconst schemas = await adapter.introspect()\n\n\t\t\texpect(schemas).toHaveLength(1)\n\t\t\texpect(schemas[0].indexes).toHaveLength(1)\n\t\t\texpect(schemas[0].indexes[0].name).toBe('users_email_idx')\n\t\t})\n\n\t\ttest('introspect skips tracker collection', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tstate.collections.set('users', { indexes: [] })\n\t\t\tstate.collections.set(MIGRATION_TRACKER_COLLECTION, { indexes: [] })\n\n\t\t\tconst schemas = await adapter.introspect()\n\n\t\t\texpect(schemas).toHaveLength(1)\n\t\t\texpect(schemas[0].name).toBe('users')\n\t\t})\n\n\t\ttest('introspect maps index keys to on array and unique flag', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tstate.collections.set('orders', {\n\t\t\t\tindexes: [\n\t\t\t\t\t{ name: 'orders_userId_createdAt_idx', key: { userId: 1, createdAt: 1 }, unique: false },\n\t\t\t\t\t{ name: 'orders_email_unique', key: { email: 1 }, unique: true },\n\t\t\t\t],\n\t\t\t})\n\n\t\t\tconst schemas = await adapter.introspect()\n\n\t\t\texpect(schemas[0].indexes).toEqual([\n\t\t\t\t{ name: 'orders_userId_createdAt_idx', on: ['userId', 'createdAt'], unique: false },\n\t\t\t\t{ name: 'orders_email_unique', on: ['email'], unique: true },\n\t\t\t])\n\t\t})\n\n\t\ttest('adapter does not implement acquireMigrationLock', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\texpect((adapter as any).acquireMigrationLock).toBeUndefined()\n\t\t})\n\n\t\ttest('adapter does not implement DDL apply methods', () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\texpect((adapter as any).applyCreateTable).toBeUndefined()\n\t\t\texpect((adapter as any).applyDropTable).toBeUndefined()\n\t\t\texpect((adapter as any).applyAddField).toBeUndefined()\n\t\t\texpect((adapter as any).applyDropField).toBeUndefined()\n\t\t\texpect((adapter as any).applyModifyField).toBeUndefined()\n\t\t\texpect((adapter as any).applyRenameTable).toBeUndefined()\n\t\t\texpect((adapter as any).applyRenameField).toBeUndefined()\n\t\t\texpect((adapter as any).applyAddForeignKey).toBeUndefined()\n\t\t\texpect((adapter as any).applyDropForeignKey).toBeUndefined()\n\t\t})\n\n\t\ttest('type-level: ChangeFor<MongoDbAdapter> excludes DDL variants', () => {\n\t\t\ttype Changes = import('../../migrations/types').ChangeFor<MongoDbAdapter>\n\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'addIndex' }>>().not.toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'dropIndex' }>>().not.toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'execute' }>>().not.toBeNever()\n\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'addField' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'createTable' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'dropTable' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'modifyField' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'renameTable' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'renameField' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'dropField' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'addForeignKey' }>>().toBeNever()\n\t\t\texpectTypeOf<Extract<Changes, { kind: 'dropForeignKey' }>>().toBeNever()\n\t\t})\n\n\t\ttest('type-level: Migrator.from(repo, adapter).build() works without withoutLock', async () => {\n\t\t\tconst { Migrator } = await import('../../migrations/migrator')\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\t\t\tconst step = Migrator.from(repo, adapter).migrations([])\n\n\t\t\texpectTypeOf(step).toHaveProperty('build')\n\t\t\texpectTypeOf(step).toHaveProperty('withoutLock')\n\t\t})\n\n\t\ttest('type-level: Migrator.from(repo, adapter).withoutLock().build() also works', async () => {\n\t\t\tconst { Migrator } = await import('../../migrations/migrator')\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\t\t\tconst migrator = Migrator.from(repo, adapter).migrations([]).withoutLock().build()\n\t\t\texpect(migrator).toBeDefined()\n\t\t})\n\n\t\ttest('end-to-end: Migrator runs addIndex + dropIndex + execute changes', async () => {\n\t\t\tconst { Migrator } = await import('../../migrations/migrator')\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\n\t\t\tlet executeRan = false\n\t\t\ttype M = import('../../migrations/types').Migration<typeof adapter>\n\t\t\tconst migrations: M[] = [\n\t\t\t\t{\n\t\t\t\t\tid: '0001-add-idx',\n\t\t\t\t\ttx: false,\n\t\t\t\t\tchanges: [\n\t\t\t\t\t\t{ kind: 'addIndex', table: 'users', on: ['email'], unique: true },\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: '0002-backfill',\n\t\t\t\t\ttx: false,\n\t\t\t\t\tchanges: [\n\t\t\t\t\t\t{ kind: 'execute', up: async () => { executeRan = true } },\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: '0003-drop-idx',\n\t\t\t\t\ttx: false,\n\t\t\t\t\tchanges: [\n\t\t\t\t\t\t{ kind: 'dropIndex', name: 'users_email_idx' },\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst migrator = Migrator.from(repo, adapter).migrations(migrations).build()\n\t\t\tconst result = await migrator.up()\n\n\t\t\texpect(result.ran).toEqual(['0001-add-idx', '0002-backfill', '0003-drop-idx'])\n\t\t\texpect(executeRan).toBe(true)\n\t\t\texpect(state.migrations.size).toBe(3)\n\t\t\texpect(state.collections.get('users')!.indexes).toHaveLength(0)\n\t\t})\n\n\t\ttest('introspect round-trip: addIndex then introspect sees the index', async () => {\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tconst state = mockMongoDb(adapter)\n\n\t\t\tstate.collections.set('users', {\n\t\t\t\tindexes: [{ name: 'users_email_idx', key: { email: 1 }, unique: true }],\n\t\t\t})\n\n\t\t\tconst schemas = await adapter.introspect()\n\n\t\t\texpect(schemas).toHaveLength(1)\n\t\t\texpect(schemas[0].name).toBe('users')\n\t\t\texpect(schemas[0].pk).toBeUndefined()\n\t\t\texpect(schemas[0].fields).toEqual([])\n\t\t\texpect(schemas[0].foreignKeys).toEqual([])\n\t\t\texpect(schemas[0].indexes).toEqual([\n\t\t\t\t{ name: 'users_email_idx', on: ['email'], unique: true },\n\t\t\t])\n\t\t})\n\n\t\ttest('data backfill via execute change', async () => {\n\t\t\tconst { Migrator } = await import('../../migrations/migrator')\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\n\t\t\tconst adapter = MongoDbAdapter.create({ uri: 'mongodb://localhost:27017/testdb' })\n\t\t\tmockMongoDb(adapter)\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ db: 'test', col: 'test' })).build()\n\n\t\t\tconst backfilledData: string[] = []\n\t\t\ttype M = import('../../migrations/types').Migration<typeof adapter>\n\t\t\tconst m: M = {\n\t\t\t\tid: '0001-backfill',\n\t\t\t\ttx: false,\n\t\t\t\tchanges: [{\n\t\t\t\t\tkind: 'execute',\n\t\t\t\t\tup: async () => {\n\t\t\t\t\t\tbackfilledData.push('user-1-normalized')\n\t\t\t\t\t\tbackfilledData.push('user-2-normalized')\n\t\t\t\t\t},\n\t\t\t\t}],\n\t\t\t}\n\n\t\t\tconst migrator = Migrator.from(repo, adapter).migrations([m]).build()\n\t\t\tawait migrator.up()\n\n\t\t\texpect(backfilledData).toEqual(['user-1-normalized', 'user-2-normalized'])\n\t\t})\n\t})\n}\n","export class EquippedError extends Error {\n\tconstructor(\n\t\tpublic readonly message: string,\n\t\tpublic readonly context: Record<string, unknown>,\n\t\tpublic readonly cause?: unknown,\n\t) {\n\t\tsuper(message, { cause })\n\t}\n}\n","import pino, { type Logger } from 'pino'\nimport { ulid } from 'ulid'\nimport { type Pipe, v } from 'valleyed'\n\nimport { EquippedError } from '../errors'\nimport { type ClassRef, type HookCb, type HookEvent, type HookOptions, type HookRecord, registerHook, runHooks } from './hooks'\nimport { instanceSettingsPipe, type Settings, type SettingsInput } from './settings'\n\nexport type { ClassRef, HookCb, HookEvent, HookOptions }\n\nexport class Instance {\n\tstatic #id: string | undefined\n\tstatic #instance: Instance | undefined\n\tstatic #hooks: Partial<Record<HookEvent, HookRecord[]>> = {}\n\treadonly settings: Readonly<Settings>\n\treadonly log: Logger<never>\n\n\tprivate constructor(settings: Settings) {\n\t\tInstance.#instance = this\n\t\tthis.settings = Object.freeze(settings)\n\t\tthis.log = pino<never>({\n\t\t\tlevel: this.settings.log.level,\n\t\t\tserializers: {\n\t\t\t\terr: pino.stdSerializers.err,\n\t\t\t\terror: pino.stdSerializers.err,\n\t\t\t\treq: pino.stdSerializers.req,\n\t\t\t\tres: pino.stdSerializers.res,\n\t\t\t},\n\t\t\tmixin: () => ({\n\t\t\t\tinstanceId: Instance.#id,\n\t\t\t}),\n\t\t})\n\t\tInstance.#registerOnExitHandler()\n\t}\n\n\talias(id: string) {\n\t\tif (Instance.#id !== undefined) return Instance.crash(new EquippedError('Instance already has an alias', {}))\n\t\tInstance.#id = id\n\t}\n\n\tget id() {\n\t\tif (Instance.#id === undefined) return Instance.crash(new EquippedError('Instance doesnt have an alias yet', {}))\n\t\treturn Instance.#id\n\t}\n\n\tgetScopedName(name: string, key = '.') {\n\t\treturn [this.settings.app.name, name].join(key)\n\t}\n\n\tasync start() {\n\t\ttry {\n\t\t\tawait runHooks(Instance.#hooks['setup'] ?? [])\n\t\t\tawait runHooks(Instance.#hooks['start'] ?? [])\n\t\t} catch (error) {\n\t\t\tInstance.crash(new EquippedError(`Error starting instance`, {}, error))\n\t\t}\n\t}\n\n\tstatic envs<E extends object>(envsPipe: Pipe<unknown, E>): E {\n\t\tconst envValidity = v.validate(envsPipe, process.env)\n\t\tif (!envValidity.valid) {\n\t\t\tInstance.crash(\n\t\t\t\tnew EquippedError(`Environment variables are not valid\\n${envValidity.error.toString()}`, {\n\t\t\t\t\tmessages: envValidity.error.messages,\n\t\t\t\t}),\n\t\t\t)\n\t\t}\n\t\treturn envValidity.value\n\t}\n\n\tstatic create(settings: SettingsInput) {\n\t\tif (Instance.#instance) return Instance.crash(new EquippedError('Instance has been initialized already', {}))\n\t\tconst settingsValidity = v.validate(instanceSettingsPipe(), settings)\n\t\tif (!settingsValidity.valid) {\n\t\t\tInstance.crash(\n\t\t\t\tnew EquippedError(`Settings are not valid\\n${settingsValidity.error.toString()}`, {\n\t\t\t\t\tmessages: settingsValidity.error.messages,\n\t\t\t\t}),\n\t\t\t)\n\t\t}\n\t\treturn new Instance(settingsValidity.value)\n\t}\n\n\tstatic get() {\n\t\tif (!Instance.#instance)\n\t\t\treturn Instance.crash(\n\t\t\t\tnew EquippedError('Has not been initialized. Make sure an instance has been created before you get an instance', {}),\n\t\t\t)\n\t\treturn Instance.#instance\n\t}\n\n\tstatic maybeGet() {\n\t\treturn Instance.#instance\n\t}\n\n\tstatic on(event: HookEvent, cb: HookCb, options?: HookOptions) {\n\t\tInstance.#hooks[event] ??= []\n\t\tconst record: HookRecord = { cb, class: options?.class, after: options?.after ?? [] }\n\t\tregisterHook(Instance.#hooks[event], record)\n\t}\n\n\tstatic #registerOnExitHandler() {\n\t\tconst signals = {\n\t\t\tSIGHUP: 1,\n\t\t\tSIGINT: 2,\n\t\t\tSIGTERM: 15,\n\t\t}\n\n\t\tObject.entries(signals).forEach(([signal, code]) => {\n\t\t\tprocess.on(signal, async () => {\n\t\t\t\tawait runHooks(Instance.#hooks['close'] ?? [], () => {}, true)\n\t\t\t\tprocess.exit(128 + code)\n\t\t\t})\n\t\t})\n\t}\n\n\tstatic resolveBeforeCrash<T>(cb: () => Promise<T>) {\n\t\tconst value = cb()\n\t\tInstance.on('close', async () => await value)\n\t\treturn value\n\t}\n\n\tstatic crash(error: EquippedError): never {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error(error)\n\t\tprocess.exit(1)\n\t}\n\n\tstatic createId(opts?: { prefix?: string; time?: Date }) {\n\t\treturn `${opts?.prefix ?? ''}${ulid(opts?.time?.getTime())}`\n\t}\n}\n","export type HookEvent = 'setup' | 'start' | 'close'\nexport type HookCb = Promise<unknown | void> | (() => void | unknown | Promise<void | unknown>)\n\nexport type ClassRef = Function & { prototype: unknown; name: string }\nexport type HookOptions = {\n\tclass?: ClassRef\n\tafter?: ClassRef[]\n}\nexport type HookRecord = { cb: HookCb; class?: ClassRef; after: ClassRef[] }\n\nexport function registerHook(hooks: HookRecord[], record: HookRecord): void {\n\tfor (const dep of record.after) {\n\t\tif (!hooks.some((h) => h.class === dep)) {\n\t\t\tconst depName = dep.name || 'unknown'\n\t\t\tconst ownerName = record.class?.name || 'anonymous'\n\t\t\tthrow new Error(`Missing dependency: ${ownerName} declares after: [${depName}], but ${depName} is not registered`)\n\t\t}\n\t}\n\n\tif (record.class) {\n\t\tconst tentative = [...hooks, record]\n\t\tdetectCycle(tentative)\n\t}\n\n\thooks.push(record)\n}\n\nfunction detectCycle(hooks: HookRecord[]): void {\n\tconst classToAfter = new Map<ClassRef, ClassRef[]>()\n\tfor (const h of hooks) {\n\t\tif (!h.class) continue\n\t\tconst existing = classToAfter.get(h.class)\n\t\tif (existing) {\n\t\t\tfor (const dep of h.after) {\n\t\t\t\tif (!existing.includes(dep)) existing.push(dep)\n\t\t\t}\n\t\t} else {\n\t\t\tclassToAfter.set(h.class, [...h.after])\n\t\t}\n\t}\n\n\tconst visited = new Set<ClassRef>()\n\tconst stack = new Set<ClassRef>()\n\n\tfunction visit(cls: ClassRef, path: ClassRef[]): void {\n\t\tif (stack.has(cls)) {\n\t\t\tconst cycleStart = path.indexOf(cls)\n\t\t\tconst cycle = [...path.slice(cycleStart), cls]\n\t\t\tconst names = cycle.map((c) => c.name || 'unknown')\n\t\t\tthrow new Error(`Cycle detected: ${names.join(' → ')}`)\n\t\t}\n\t\tif (visited.has(cls)) return\n\t\tstack.add(cls)\n\t\tpath.push(cls)\n\t\tfor (const dep of classToAfter.get(cls) ?? []) {\n\t\t\tvisit(dep, path)\n\t\t}\n\t\tpath.pop()\n\t\tstack.delete(cls)\n\t\tvisited.add(cls)\n\t}\n\n\tfor (const cls of classToAfter.keys()) {\n\t\tvisit(cls, [])\n\t}\n}\n\nexport type HookLayer = HookRecord[]\n\nexport function resolveHookDAG(hooks: HookRecord[], invert: boolean = false): HookLayer[] {\n\tif (hooks.length === 0) return []\n\n\tconst classToHooks = new Map<ClassRef, HookRecord[]>()\n\tconst anonymous: HookRecord[] = []\n\n\tfor (const h of hooks) {\n\t\tif (h.class) {\n\t\t\tconst list = classToHooks.get(h.class)\n\t\t\tif (list) list.push(h)\n\t\t\telse classToHooks.set(h.class, [h])\n\t\t} else {\n\t\t\tanonymous.push(h)\n\t\t}\n\t}\n\n\tconst classes = [...classToHooks.keys()]\n\n\tconst inDegree = new Map<ClassRef, number>()\n\tconst graph = new Map<ClassRef, ClassRef[]>()\n\n\tfor (const cls of classes) {\n\t\tinDegree.set(cls, 0)\n\t\tgraph.set(cls, [])\n\t}\n\n\tfor (const h of hooks) {\n\t\tif (!h.class) continue\n\t\tfor (const dep of h.after) {\n\t\t\tconst [from, to] = invert ? [h.class, dep] : [dep, h.class]\n\t\t\tconst edges = graph.get(from)!\n\t\t\tif (!edges.includes(to)) {\n\t\t\t\tedges.push(to)\n\t\t\t\tinDegree.set(to, inDegree.get(to)! + 1)\n\t\t\t}\n\t\t}\n\t}\n\n\tconst layers: HookLayer[] = []\n\tlet queue = classes.filter((c) => inDegree.get(c) === 0)\n\n\twhile (queue.length > 0) {\n\t\tconst layer: HookRecord[] = []\n\t\tconst next: ClassRef[] = []\n\n\t\tfor (const cls of queue) {\n\t\t\tlayer.push(...(classToHooks.get(cls) ?? []))\n\t\t}\n\t\tlayers.push(layer)\n\n\t\tfor (const cls of queue) {\n\t\t\tfor (const neighbor of graph.get(cls) ?? []) {\n\t\t\t\tconst d = inDegree.get(neighbor)! - 1\n\t\t\t\tinDegree.set(neighbor, d)\n\t\t\t\tif (d === 0) next.push(neighbor)\n\t\t\t}\n\t\t}\n\n\t\tqueue = next\n\t}\n\n\tif (anonymous.length > 0) {\n\t\tconst anonWithDeps = anonymous.filter((h) => h.after.length > 0)\n\t\tconst anonWithoutDeps = anonymous.filter((h) => h.after.length === 0)\n\n\t\tif (anonWithDeps.length > 0) {\n\t\t\tlet maxLayer = -1\n\t\t\tfor (const h of anonWithDeps) {\n\t\t\t\tfor (const dep of h.after) {\n\t\t\t\t\tconst depLayer = layers.findIndex((l) => l.some((r) => r.class === dep))\n\t\t\t\t\tif (depLayer > maxLayer) maxLayer = depLayer\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst insertAt = maxLayer + 1\n\t\t\tif (insertAt < layers.length) {\n\t\t\t\tlayers[insertAt].push(...anonWithDeps)\n\t\t\t} else {\n\t\t\t\tlayers.push(anonWithDeps)\n\t\t\t}\n\t\t}\n\n\t\tif (anonWithoutDeps.length > 0) {\n\t\t\tif (layers.length > 0) {\n\t\t\t\tlayers[layers.length - 1].push(...anonWithoutDeps)\n\t\t\t} else {\n\t\t\t\tlayers.push(anonWithoutDeps)\n\t\t\t}\n\t\t}\n\t}\n\n\treturn layers\n}\n\nexport async function runHooks(\n\thooks: HookRecord[],\n\tonError: (error: Error) => void = (error) => {\n\t\tthrow error\n\t},\n\tinvert: boolean = false,\n) {\n\tconst layers = resolveHookDAG(hooks, invert)\n\tfor (const layer of layers)\n\t\tawait Promise.all(\n\t\t\tlayer.map(async (h) => {\n\t\t\t\ttry {\n\t\t\t\t\tif (typeof h.cb === 'function') return await h.cb()\n\t\t\t\t\treturn await h.cb\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn onError(error instanceof Error ? error : new Error(`${error}`))\n\t\t\t\t}\n\t\t\t}),\n\t\t)\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect } = import.meta.vitest\n\n\tclass A {}\n\tclass B {}\n\tclass C {}\n\tclass D {}\n\n\tconst noop = () => {}\n\n\tdescribe('registerHook', () => {\n\t\ttest('registers a hook with no dependencies', () => {\n\t\t\tconst hooks: HookRecord[] = []\n\t\t\tregisterHook(hooks, { cb: noop, class: A, after: [] })\n\t\t\texpect(hooks).toHaveLength(1)\n\t\t})\n\n\t\ttest('throws on missing dependency', () => {\n\t\t\tconst hooks: HookRecord[] = []\n\t\t\texpect(() => registerHook(hooks, { cb: noop, class: B, after: [A] })).toThrow(/Missing dependency.*B.*A/)\n\t\t})\n\n\t\ttest('throws on cycle: A→B→A', () => {\n\t\t\tconst hooks: HookRecord[] = []\n\t\t\tregisterHook(hooks, { cb: noop, class: A, after: [] })\n\t\t\tregisterHook(hooks, { cb: noop, class: B, after: [A] })\n\t\t\texpect(() => registerHook(hooks, { cb: noop, class: A, after: [B] })).toThrow(/Cycle detected/)\n\t\t})\n\n\t\ttest('throws on transitive cycle: A→B→C→A', () => {\n\t\t\tconst hooks: HookRecord[] = []\n\t\t\tregisterHook(hooks, { cb: noop, class: A, after: [] })\n\t\t\tregisterHook(hooks, { cb: noop, class: B, after: [A] })\n\t\t\tregisterHook(hooks, { cb: noop, class: C, after: [B] })\n\t\t\texpect(() => registerHook(hooks, { cb: noop, class: A, after: [C] })).toThrow(/Cycle detected/)\n\t\t})\n\n\t\ttest('allows anonymous hooks with dependencies', () => {\n\t\t\tconst hooks: HookRecord[] = []\n\t\t\tregisterHook(hooks, { cb: noop, class: A, after: [] })\n\t\t\tregisterHook(hooks, { cb: noop, after: [A] })\n\t\t\texpect(hooks).toHaveLength(2)\n\t\t})\n\n\t\ttest('anonymous hook throws on missing dependency', () => {\n\t\t\tconst hooks: HookRecord[] = []\n\t\t\texpect(() => registerHook(hooks, { cb: noop, after: [A] })).toThrow(/Missing dependency.*anonymous.*A/)\n\t\t})\n\t})\n\n\tdescribe('resolveHookDAG', () => {\n\t\ttest('linear chain: A → B → C', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, class: C, after: [B] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\texpect(layers).toHaveLength(3)\n\t\t\texpect(layers[0].every((h) => h.class === A)).toBe(true)\n\t\t\texpect(layers[1].every((h) => h.class === B)).toBe(true)\n\t\t\texpect(layers[2].every((h) => h.class === C)).toBe(true)\n\t\t})\n\n\t\ttest('fan-out: A → B, A → C (B and C are parallel)', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, class: C, after: [A] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\texpect(layers).toHaveLength(2)\n\t\t\texpect(layers[0].every((h) => h.class === A)).toBe(true)\n\t\t\tconst secondClasses = layers[1].map((h) => h.class)\n\t\t\texpect(secondClasses).toContain(B)\n\t\t\texpect(secondClasses).toContain(C)\n\t\t})\n\n\t\ttest('fan-in: B → D, C → D', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: B, after: [] },\n\t\t\t\t{ cb: noop, class: C, after: [] },\n\t\t\t\t{ cb: noop, class: D, after: [B, C] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\texpect(layers).toHaveLength(2)\n\t\t\tconst firstClasses = layers[0].map((h) => h.class)\n\t\t\texpect(firstClasses).toContain(B)\n\t\t\texpect(firstClasses).toContain(C)\n\t\t\texpect(layers[1].every((h) => h.class === D)).toBe(true)\n\t\t})\n\n\t\ttest('diamond: A → B, A → C, B → D, C → D', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, class: C, after: [A] },\n\t\t\t\t{ cb: noop, class: D, after: [B, C] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\texpect(layers).toHaveLength(3)\n\t\t\texpect(layers[0][0].class).toBe(A)\n\t\t\tconst midClasses = layers[1].map((h) => h.class)\n\t\t\texpect(midClasses).toContain(B)\n\t\t\texpect(midClasses).toContain(C)\n\t\t\texpect(layers[2][0].class).toBe(D)\n\t\t})\n\n\t\ttest('close-event inversion reverses the graph', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, class: C, after: [B] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks, true)\n\t\t\texpect(layers).toHaveLength(3)\n\t\t\texpect(layers[0].every((h) => h.class === C)).toBe(true)\n\t\t\texpect(layers[1].every((h) => h.class === B)).toBe(true)\n\t\t\texpect(layers[2].every((h) => h.class === A)).toBe(true)\n\t\t})\n\n\t\ttest('close inversion: fan-out becomes fan-in', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, class: C, after: [A] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks, true)\n\t\t\texpect(layers).toHaveLength(2)\n\t\t\tconst firstClasses = layers[0].map((h) => h.class)\n\t\t\texpect(firstClasses).toContain(B)\n\t\t\texpect(firstClasses).toContain(C)\n\t\t\texpect(layers[1].every((h) => h.class === A)).toBe(true)\n\t\t})\n\n\t\ttest('multiple hooks per class are all in the same layer', () => {\n\t\t\tconst cb1 = () => {}\n\t\t\tconst cb2 = () => {}\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: cb1, class: A, after: [] },\n\t\t\t\t{ cb: cb2, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\texpect(layers).toHaveLength(2)\n\t\t\texpect(layers[0]).toHaveLength(2)\n\t\t\texpect(layers[0].every((h) => h.class === A)).toBe(true)\n\t\t})\n\n\t\ttest('anonymous hooks without deps run at deepest level', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, after: [] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\texpect(layers).toHaveLength(2)\n\t\t\tconst lastLayer = layers[layers.length - 1]\n\t\t\texpect(lastLayer.some((h) => h.class === undefined)).toBe(true)\n\t\t})\n\n\t\ttest('anonymous hooks with deps run after their dependencies', () => {\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: noop, class: A, after: [] },\n\t\t\t\t{ cb: noop, class: B, after: [A] },\n\t\t\t\t{ cb: noop, class: C, after: [B] },\n\t\t\t\t{ cb: noop, after: [A] },\n\t\t\t]\n\t\t\tconst layers = resolveHookDAG(hooks)\n\t\t\tconst anonLayer = layers.findIndex((l) => l.some((h) => h.class === undefined))\n\t\t\tconst aLayer = layers.findIndex((l) => l.some((h) => h.class === A))\n\t\t\texpect(anonLayer).toBeGreaterThan(aLayer)\n\t\t})\n\n\t\ttest('empty hooks returns empty layers', () => {\n\t\t\texpect(resolveHookDAG([])).toEqual([])\n\t\t})\n\t})\n\n\tdescribe('runHooks', () => {\n\t\ttest('same-depth siblings observably overlap', async () => {\n\t\t\tconst log: string[] = []\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{\n\t\t\t\t\tcb: async () => {\n\t\t\t\t\t\tlog.push('B-start')\n\t\t\t\t\t\tawait new Promise((r) => setTimeout(r, 20))\n\t\t\t\t\t\tlog.push('B-end')\n\t\t\t\t\t},\n\t\t\t\t\tclass: B,\n\t\t\t\t\tafter: [],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tcb: async () => {\n\t\t\t\t\t\tlog.push('C-start')\n\t\t\t\t\t\tawait new Promise((r) => setTimeout(r, 20))\n\t\t\t\t\t\tlog.push('C-end')\n\t\t\t\t\t},\n\t\t\t\t\tclass: C,\n\t\t\t\t\tafter: [],\n\t\t\t\t},\n\t\t\t]\n\t\t\tawait runHooks(hooks)\n\t\t\texpect(log[0]).toBe('B-start')\n\t\t\texpect(log[1]).toBe('C-start')\n\t\t})\n\n\t\ttest('different depths run sequentially', async () => {\n\t\t\tconst log: string[] = []\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{\n\t\t\t\t\tcb: async () => {\n\t\t\t\t\t\tlog.push('A')\n\t\t\t\t\t},\n\t\t\t\t\tclass: A,\n\t\t\t\t\tafter: [],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tcb: async () => {\n\t\t\t\t\t\tlog.push('B')\n\t\t\t\t\t},\n\t\t\t\t\tclass: B,\n\t\t\t\t\tafter: [A],\n\t\t\t\t},\n\t\t\t]\n\t\t\tawait runHooks(hooks)\n\t\t\texpect(log).toEqual(['A', 'B'])\n\t\t})\n\n\t\ttest('close inversion runs hooks in reverse dependency order', async () => {\n\t\t\tconst log: string[] = []\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{ cb: async () => log.push('A'), class: A, after: [] },\n\t\t\t\t{ cb: async () => log.push('B'), class: B, after: [A] },\n\t\t\t\t{ cb: async () => log.push('C'), class: C, after: [B] },\n\t\t\t]\n\t\t\tawait runHooks(hooks, undefined, true)\n\t\t\texpect(log).toEqual(['C', 'B', 'A'])\n\t\t})\n\n\t\ttest('errors are routed to onError handler', async () => {\n\t\t\tconst errors: Error[] = []\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{\n\t\t\t\t\tcb: () => {\n\t\t\t\t\t\tthrow new Error('boom')\n\t\t\t\t\t},\n\t\t\t\t\tclass: A,\n\t\t\t\t\tafter: [],\n\t\t\t\t},\n\t\t\t]\n\t\t\tawait runHooks(hooks, (e) => {\n\t\t\t\terrors.push(e)\n\t\t\t})\n\t\t\texpect(errors).toHaveLength(1)\n\t\t\texpect(errors[0].message).toBe('boom')\n\t\t})\n\n\t\ttest('raw promise callbacks are awaited', async () => {\n\t\t\tconst log: string[] = []\n\t\t\tconst hooks: HookRecord[] = [\n\t\t\t\t{\n\t\t\t\t\tcb: Promise.resolve().then(() => log.push('resolved')),\n\t\t\t\t\tclass: A,\n\t\t\t\t\tafter: [],\n\t\t\t\t},\n\t\t\t]\n\t\t\tawait runHooks(hooks)\n\t\t\texpect(log).toContain('resolved')\n\t\t})\n\t})\n}\n","import { type ConditionalObjectKeys, type PipeInput, type PipeOutput, v } from 'valleyed'\n\nexport const instanceSettingsPipe = () =>\n\tv.object({\n\t\tapp: v.object({\n\t\t\tname: v.string(),\n\t\t}),\n\t\tlog: v.defaults(\n\t\t\tv.object({\n\t\t\t\tlevel: v.defaults(v.in(['fatal', 'error', 'warn', 'info', 'debug', 'trace', 'silent'] as const), 'info'),\n\t\t\t}),\n\t\t\t{},\n\t\t),\n\t\tutils: v.defaults(\n\t\t\tv.object({\n\t\t\t\thashSaltRounds: v.defaults(v.number(), 10),\n\t\t\t\tpaginationDefaultLimit: v.defaults(v.number(), 100),\n\t\t\t\tmaxFileUploadSizeInMb: v.defaults(v.number(), 500),\n\t\t\t}),\n\t\t\t{},\n\t\t),\n\t})\n\nexport type Settings = PipeOutput<ReturnType<typeof instanceSettingsPipe>>\nexport type SettingsInput = ConditionalObjectKeys<PipeInput<ReturnType<typeof instanceSettingsPipe>>>\n","import { v, type Pipe, type PipeOutput } from 'valleyed'\n\nexport class Field<T = unknown, Name extends string = string, S = unknown> {\n\tdeclare readonly __valueType?: T\n\tdeclare readonly __schema?: S\n\treadonly name: Name\n\treadonly path: readonly string[]\n\n\tconstructor(name: Name, path?: readonly string[]) {\n\t\tthis.name = name\n\t\tthis.path = path ?? [name]\n\t}\n}\n\nexport type AnyField = Field<unknown, string, any>\n\nexport function toFieldName(field: string | AnyField): string {\n\tif (field instanceof Field) return field.path.join('.')\n\treturn field\n}\n\nexport class SchemaField<\n\tName extends string = string,\n\tP extends Pipe<any, any> = Pipe<any, any>,\n\tHasOnCreate extends boolean = false,\n> extends Field<PipeOutput<P>, Name> {\n\tdeclare readonly __hasOnCreate?: HasOnCreate\n\treadonly pipe: P\n\treadonly onCreate?: () => PipeOutput<P>\n\treadonly onUpdate?: () => PipeOutput<P>\n\n\tconstructor(name: Name, pipe: P, opts?: { onCreate?: () => PipeOutput<P>; onUpdate?: () => PipeOutput<P> }) {\n\t\tsuper(name)\n\t\tthis.pipe = pipe\n\t\tthis.onCreate = opts?.onCreate\n\t\tthis.onUpdate = opts?.onUpdate\n\t}\n}\n\nexport type AnySchemaField = SchemaField<string, Pipe<any, any>, boolean>\n\nexport class ComputedField<\n\tName extends string = string,\n\tP extends Pipe<any, any> = Pipe<any, any>,\n\tDeps extends readonly string[] = readonly string[],\n> {\n\tconstructor(\n\t\treadonly name: Name,\n\t\treadonly pipe: P,\n\t\treadonly deps: Deps,\n\t\treadonly compute: (data: Record<Deps[number], unknown>) => PipeOutput<P>,\n\t) {}\n}\n\nexport type AnyComputedField = ComputedField<string, Pipe<any, any>, readonly string[]>\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect } = import.meta.vitest\n\n\tdescribe('Fields', () => {\n\t\tdescribe('Field', () => {\n\t\t\ttest('stores name and defaults path to [name]', () => {\n\t\t\t\tconst f = new Field('email')\n\t\t\t\texpect(f.name).toBe('email')\n\t\t\t\texpect(f.path).toEqual(['email'])\n\t\t\t})\n\n\t\t\ttest('stores provided custom path', () => {\n\t\t\t\tconst f = new Field('profile', ['profile', 'displayName'])\n\t\t\t\texpect(f.name).toBe('profile')\n\t\t\t\texpect(f.path).toEqual(['profile', 'displayName'])\n\t\t\t})\n\t\t})\n\n\t\tdescribe('toFieldName()', () => {\n\t\t\ttest('returns string input unchanged', () => {\n\t\t\t\texpect(toFieldName('createdAt')).toBe('createdAt')\n\t\t\t})\n\n\t\t\ttest('converts Field path into dot notation', () => {\n\t\t\t\tconst f = new Field('profile', ['profile', 'displayName'])\n\t\t\t\texpect(toFieldName(f)).toBe('profile.displayName')\n\t\t\t})\n\t\t})\n\n\t\tdescribe('SchemaField', () => {\n\t\t\ttest('extends Field and stores pipe', () => {\n\t\t\t\tconst mockPipe = v.string()\n\t\t\t\tconst f = new SchemaField('email', mockPipe)\n\t\t\t\texpect(f).toBeInstanceOf(Field)\n\t\t\t\texpect(f.name).toBe('email')\n\t\t\t\texpect(f.path).toEqual(['email'])\n\t\t\t\texpect(f.pipe).toBe(mockPipe)\n\t\t\t})\n\n\t\t\ttest('stores lifecycle hooks when provided', () => {\n\t\t\t\tconst mockPipe = v.number()\n\t\t\t\tconst f = new SchemaField('updatedAt', mockPipe, {\n\t\t\t\t\tonCreate: () => 1000,\n\t\t\t\t\tonUpdate: () => 2000,\n\t\t\t\t})\n\t\t\t\texpect(f.onCreate?.()).toBe(1000)\n\t\t\t\texpect(f.onUpdate?.()).toBe(2000)\n\t\t\t})\n\n\t\t\ttest('keeps lifecycle hooks undefined when omitted', () => {\n\t\t\t\tconst mockPipe = v.string()\n\t\t\t\tconst f = new SchemaField('name', mockPipe)\n\t\t\t\texpect(f.onCreate).toBeUndefined()\n\t\t\t\texpect(f.onUpdate).toBeUndefined()\n\t\t\t})\n\t\t})\n\t})\n}\n","import type { FilterOpName } from './adapter'\nimport { EquippedError } from '../errors'\nimport { OrmValidationError, type OrmValidationFailure } from './errors'\nimport { toFieldName, type AnyField, type Field } from './fields'\nimport type { AggregateSpec } from './orm-adapter'\nimport type { AnySchema } from './schema'\n\nexport class Filter {\n\treadonly field: string\n\tconstructor(\n\t\tfield: string | AnyField,\n\t\treadonly op: FilterOpName,\n\t\treadonly value: unknown,\n\t) {\n\t\tthis.field = toFieldName(field)\n\t}\n}\n\nexport type FilterChild = Filter | FilterGroup\n\nexport type FilterFactory = (q: FilterGroup) => FilterGroup\n\nexport type FilterGroupOp = 'and' | 'or'\n\nexport class FilterGroup {\n\treadonly children: readonly FilterChild[]\n\n\tprivate constructor(\n\t\treadonly op: FilterGroupOp = 'and',\n\t\tchildren?: readonly FilterChild[],\n\t) {\n\t\tthis.children = children ?? []\n\t}\n\n\t#withChild(child: FilterChild): FilterGroup {\n\t\treturn new FilterGroup(this.op, [...this.children, child])\n\t}\n\n\teq<T>(field: string | Field<T>, value: T): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'eq', value))\n\t}\n\n\tne<T>(field: string | Field<T>, value: T): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'ne', value))\n\t}\n\n\tgt<T>(field: string | Field<T>, value: T): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'gt', value))\n\t}\n\n\tgte<T>(field: string | Field<T>, value: T): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'gte', value))\n\t}\n\n\tlt<T>(field: string | Field<T>, value: T): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'lt', value))\n\t}\n\n\tlte<T>(field: string | Field<T>, value: T): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'lte', value))\n\t}\n\n\tin<T>(field: string | Field<T>, value: T[]): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'in', value))\n\t}\n\n\tnotIn<T>(field: string | Field<T>, value: T[]): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'notIn', value))\n\t}\n\n\tlike(field: string | Field<string>, value: string): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'like', value))\n\t}\n\n\texists(field: string | Field<unknown>): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'exists', true))\n\t}\n\n\tnotExists(field: string | Field<unknown>): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'notExists', true))\n\t}\n\n\tcontains<T>(field: string | Field<T>, value: T[]): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'contains', value))\n\t}\n\n\tnotContains<T>(field: string | Field<T>, value: T[]): FilterGroup {\n\t\treturn this.#withChild(new Filter(field, 'notContains', value))\n\t}\n\n\tand(facFns: FilterFactory[]): FilterGroup {\n\t\tif (facFns.length === 0) throw new EquippedError('and() requires at least one filter factory', { op: 'and' })\n\t\tconst group = new FilterGroup('and', facFns.map((fn) => fn(FilterGroup.create())))\n\t\treturn this.#withChild(group)\n\t}\n\n\tor(facFns: FilterFactory[]): FilterGroup {\n\t\tif (facFns.length === 0) throw new EquippedError('or() requires at least one filter factory', { op: 'or' })\n\t\tconst group = new FilterGroup('or', facFns.map((fn) => fn(FilterGroup.create())))\n\t\treturn this.#withChild(group)\n\t}\n\n\tclone(): FilterGroup {\n\t\treturn new FilterGroup(\n\t\t\tthis.op,\n\t\t\tthis.children.map((c) => {\n\t\t\t\tif (c instanceof Filter) return new Filter(c.field, c.op, structuredClone(c.value))\n\t\t\t\treturn c.clone()\n\t\t\t}),\n\t\t)\n\t}\n\n\tstatic create(): FilterGroup {\n\t\treturn new FilterGroup()\n\t}\n}\n\n\nexport type GatedFilterGroup<DeclaredOps extends readonly FilterOpName[]> = {\n\t[K in FilterOpName]: K extends DeclaredOps[number] ? FilterGroup[K] : never\n} & Pick<FilterGroup, 'and' | 'or' | 'clone' | 'children' | 'op'>\n\nexport type GatedFilterFactory<DeclaredOps extends readonly FilterOpName[]> = (\n\tq: GatedFilterGroup<DeclaredOps>,\n) => GatedFilterGroup<DeclaredOps>\n\nexport function assertNormalisedAggregate(schema: AnySchema, adapter: { aggregateOps: readonly string[] }, spec: AggregateSpec): void {\n\tconst failures: OrmValidationFailure[] = []\n\n\tif (spec.aggregates.length === 0) {\n\t\tfailures.push({ cause: 'At least one aggregator step is required' })\n\t}\n\n\tconst seenAliases = new Set<string>()\n\tfor (const agg of spec.aggregates) {\n\t\tif (seenAliases.has(agg.alias)) {\n\t\t\tfailures.push({ alias: agg.alias, cause: `Duplicate alias \"${agg.alias}\"` })\n\t\t}\n\t\tseenAliases.add(agg.alias)\n\n\t\tif (!adapter.aggregateOps.includes(agg.fn)) {\n\t\t\tfailures.push({ alias: agg.alias, cause: `Undeclared aggregate op \"${agg.fn}\"` })\n\t\t}\n\t}\n\n\tconst allFields = schema.fields as Record<string, unknown>\n\tconst fieldNames = new Set(Object.keys(allFields))\n\tfor (const field of spec.groupBy) {\n\t\tif (!fieldNames.has(field)) {\n\t\t\tfailures.push({ field, cause: `Unknown groupBy field \"${field}\" on schema \"${schema.name}\"` })\n\t\t}\n\t\tif (seenAliases.has(field)) {\n\t\t\tfailures.push({ alias: field, cause: `Alias \"${field}\" collides with groupBy field name` })\n\t\t}\n\t}\n\n\tif (failures.length > 0) {\n\t\tthrow new OrmValidationError('aggregate', schema.name, 'aggregate', failures)\n\t}\n\n\tif (spec.where) {\n\t\tassertNormalisedFilter(schema, spec.where)\n\t}\n\n\tif (spec.having) {\n\t\tconst validHavingFields = new Set([...seenAliases, ...spec.groupBy])\n\t\tconst havingErrors: OrmValidationFailure[] = []\n\n\t\tfunction walkHaving(node: FilterChild): void {\n\t\t\tif (node instanceof Filter) {\n\t\t\t\tif (!validHavingFields.has(node.field)) {\n\t\t\t\t\thavingErrors.push({ field: node.field, cause: `Unknown having field \"${node.field}\" — must be an aggregator alias or groupBy field` })\n\t\t\t\t}\n\t\t\t} else if (node instanceof FilterGroup) {\n\t\t\t\tfor (const child of node.children) walkHaving(child)\n\t\t\t}\n\t\t}\n\n\t\tfor (const child of spec.having.children) walkHaving(child)\n\n\t\tif (havingErrors.length > 0) {\n\t\t\tthrow new OrmValidationError('aggregate', schema.name, 'aggregate', havingErrors)\n\t\t}\n\t}\n}\n\nexport function assertNormalisedFilter(schema: AnySchema, group: FilterGroup): void {\n\tconst allFields = schema.fields as Record<string, unknown>\n\tconst fieldNames = new Set(Object.keys(allFields))\n\tconst errors: Array<{ field: string; cause: string }> = []\n\n\tfunction walk(node: FilterChild): void {\n\t\tif (node instanceof Filter) {\n\t\t\tif (!fieldNames.has(node.field)) {\n\t\t\t\terrors.push({ field: node.field, cause: `Unknown field \"${node.field}\" on schema \"${schema.name}\"` })\n\t\t\t}\n\t\t} else if (node instanceof FilterGroup) {\n\t\t\tfor (const child of node.children) walk(child)\n\t\t}\n\t}\n\n\tfor (const child of group.children) walk(child)\n\n\tif (errors.length > 0) {\n\t\tthrow new OrmValidationError(\n\t\t\t'validation',\n\t\t\tschema.name,\n\t\t\t'filter',\n\t\t\terrors.map((e) => ({ field: e.field, cause: e.cause })),\n\t\t)\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect } = import.meta.vitest\n\tconst { v } = await import('valleyed')\n\tconst { Schema } = await import('./schema')\n\n\tconst UserSchema = Schema.from('users')\n\t\t.pk('id', v.string(), () => 'u1')\n\t\t.field('email', v.string())\n\t\t.field('age', v.number())\n\t\t.field('name', v.string())\n\t\t.field('tags', v.array(v.string()))\n\t\t.build()\n\n\tdescribe('FilterGroup', () => {\n\t\tdescribe('filter-op methods', () => {\n\t\t\ttest('eq adds a filter clause with op eq', () => {\n\t\t\t\tconst g = FilterGroup.create().eq(UserSchema.fields.age, 25)\n\t\t\t\texpect(g.children).toHaveLength(1)\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.field).toBe('age')\n\t\t\t\texpect(f.op).toBe('eq')\n\t\t\t\texpect(f.value).toBe(25)\n\t\t\t})\n\n\t\t\ttest('ne adds a filter clause with op ne', () => {\n\t\t\t\tconst g = FilterGroup.create().ne('name', 'Bob')\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.op).toBe('ne')\n\t\t\t\texpect(f.value).toBe('Bob')\n\t\t\t})\n\n\t\t\ttest('gt/gte/lt/lte produce correct ops', () => {\n\t\t\t\tconst g = FilterGroup.create()\n\t\t\t\t\t.gt(UserSchema.fields.age, 10)\n\t\t\t\t\t.gte(UserSchema.fields.age, 20)\n\t\t\t\t\t.lt(UserSchema.fields.age, 30)\n\t\t\t\t\t.lte(UserSchema.fields.age, 40)\n\t\t\t\texpect(g.children.map((c) => (c as Filter).op)).toEqual(['gt', 'gte', 'lt', 'lte'])\n\t\t\t})\n\n\t\t\ttest('in adds a filter clause with array value', () => {\n\t\t\t\tconst g = FilterGroup.create().in(UserSchema.fields.age, [1, 2, 3])\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.op).toBe('in')\n\t\t\t\texpect(f.value).toEqual([1, 2, 3])\n\t\t\t})\n\n\t\t\ttest('notIn adds a filter clause with op notIn', () => {\n\t\t\t\tconst g = FilterGroup.create().notIn(UserSchema.fields.age, [4, 5])\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.op).toBe('notIn')\n\t\t\t\texpect(f.value).toEqual([4, 5])\n\t\t\t})\n\n\t\t\ttest('like adds a filter clause with op like', () => {\n\t\t\t\tconst g = FilterGroup.create().like(UserSchema.fields.email, 'alice')\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.op).toBe('like')\n\t\t\t\texpect(f.value).toBe('alice')\n\t\t\t})\n\n\t\t\ttest('exists adds a filter clause with op exists', () => {\n\t\t\t\tconst g = FilterGroup.create().exists(UserSchema.fields.name)\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.op).toBe('exists')\n\t\t\t})\n\n\t\t\ttest('notExists is its own op, not a boolean form of exists', () => {\n\t\t\t\tconst g = FilterGroup.create().notExists(UserSchema.fields.name)\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.op).toBe('notExists')\n\t\t\t\texpect(f.op).not.toBe('exists')\n\t\t\t})\n\n\t\t\ttest('contains/notContains produce correct ops', () => {\n\t\t\t\tconst g = FilterGroup.create()\n\t\t\t\t\t.contains('tags', ['a'])\n\t\t\t\t\t.notContains('tags', ['b'])\n\t\t\t\texpect((g.children[0] as Filter).op).toBe('contains')\n\t\t\t\texpect((g.children[1] as Filter).op).toBe('notContains')\n\t\t\t})\n\n\t\t\ttest('all 13 filter ops produce matching Filter.op values (name-parity)', () => {\n\t\t\t\tconst g = FilterGroup.create()\n\t\t\t\t\t.eq('f', 1)\n\t\t\t\t\t.ne('f', 1)\n\t\t\t\t\t.gt('f', 1)\n\t\t\t\t\t.gte('f', 1)\n\t\t\t\t\t.lt('f', 1)\n\t\t\t\t\t.lte('f', 1)\n\t\t\t\t\t.in('f', [1])\n\t\t\t\t\t.notIn('f', [1])\n\t\t\t\t\t.like('f', 'x')\n\t\t\t\t\t.exists('f')\n\t\t\t\t\t.notExists('f')\n\t\t\t\t\t.contains('f', [1])\n\t\t\t\t\t.notContains('f', [1])\n\t\t\t\tconst ops = g.children.map((c) => (c as Filter).op)\n\t\t\t\texpect(ops).toEqual([\n\t\t\t\t\t'eq', 'ne', 'gt', 'gte', 'lt', 'lte',\n\t\t\t\t\t'in', 'notIn', 'like', 'exists', 'notExists',\n\t\t\t\t\t'contains', 'notContains',\n\t\t\t\t])\n\t\t\t})\n\t\t})\n\n\t\tdescribe('raw-string field overload', () => {\n\t\t\ttest('accepts raw string field name', () => {\n\t\t\t\tconst g = FilterGroup.create().eq('age', 18)\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.field).toBe('age')\n\t\t\t})\n\n\t\t\ttest('accepts typed Field ref and extracts field name', () => {\n\t\t\t\tconst g = FilterGroup.create().eq(UserSchema.fields.age, 18)\n\t\t\t\tconst f = g.children[0] as Filter\n\t\t\t\texpect(f.field).toBe('age')\n\t\t\t})\n\t\t})\n\n\t\tdescribe('structural combinators', () => {\n\t\t\ttest('and() creates a nested and-group', () => {\n\t\t\t\tconst g = FilterGroup.create().and([\n\t\t\t\t\t(q) => q.eq('age', 10),\n\t\t\t\t\t(q) => q.eq('name', 'Alice'),\n\t\t\t\t])\n\t\t\t\texpect(g.children).toHaveLength(1)\n\t\t\t\tconst nested = g.children[0] as FilterGroup\n\t\t\t\texpect(nested.op).toBe('and')\n\t\t\t\texpect(nested.children).toHaveLength(2)\n\t\t\t})\n\n\t\t\ttest('or() creates a nested or-group', () => {\n\t\t\t\tconst g = FilterGroup.create().or([\n\t\t\t\t\t(q) => q.eq('name', 'Alice'),\n\t\t\t\t\t(q) => q.eq('name', 'Bob'),\n\t\t\t\t])\n\t\t\t\tconst nested = g.children[0] as FilterGroup\n\t\t\t\texpect(nested.op).toBe('or')\n\t\t\t})\n\t\t})\n\n\t\tdescribe('empty-combinator rejection', () => {\n\t\t\ttest('and([]) throws at builder time', () => {\n\t\t\t\texpect(() => FilterGroup.create().and([])).toThrow()\n\t\t\t})\n\n\t\t\ttest('or([]) throws at builder time', () => {\n\t\t\t\texpect(() => FilterGroup.create().or([])).toThrow()\n\t\t\t})\n\n\t\t\ttest('thrown error has stack pointing at offending call', () => {\n\t\t\t\ttry {\n\t\t\t\t\tFilterGroup.create().and([])\n\t\t\t\t\texpect.unreachable()\n\t\t\t\t} catch (e) {\n\t\t\t\t\texpect((e as Error).stack).toContain('filter.ts')\n\t\t\t\t}\n\t\t\t})\n\t\t})\n\n\t\tdescribe('clone()', () => {\n\t\t\ttest('deep-clones the tree', () => {\n\t\t\t\tconst original = FilterGroup.create()\n\t\t\t\t\t.eq('name', 'Alice')\n\t\t\t\t\t.and([(q) => q.gt('age', 20)])\n\t\t\t\tconst cloned = original.clone()\n\n\t\t\t\texpect(cloned.children).toHaveLength(2)\n\t\t\t\texpect(cloned).not.toBe(original)\n\t\t\t\texpect(cloned.children[0]).not.toBe(original.children[0])\n\t\t\t})\n\n\t\t\ttest('structuredClone of values — mutations on clone do not leak', () => {\n\t\t\t\tconst arr = [1, 2, 3]\n\t\t\t\tconst original = FilterGroup.create().in('ids', arr)\n\t\t\t\tconst cloned = original.clone()\n\n\t\t\t\tconst clonedValue = (cloned.children[0] as Filter).value as number[]\n\t\t\t\tclonedValue.push(4)\n\n\t\t\t\texpect((original.children[0] as Filter).value).toEqual([1, 2, 3])\n\t\t\t\texpect(clonedValue).toEqual([1, 2, 3, 4])\n\t\t\t})\n\t\t})\n\t})\n\n\tdescribe('clone-on-step: fan-out independence', () => {\n\t\ttest('.eq() returns a new FilterGroup, not the same instance', () => {\n\t\t\tconst base = FilterGroup.create()\n\t\t\tconst a = base.eq('name', 'Alice')\n\t\t\texpect(a).not.toBe(base)\n\t\t})\n\n\t\ttest('fan-out from shared base does not pollute either branch', () => {\n\t\t\tconst base = FilterGroup.create().eq('name', 'Alice')\n\t\t\tconst branchA = base.gt('age', 20)\n\t\t\tconst branchB = base.lt('age', 40)\n\n\t\t\texpect(branchA.children).toHaveLength(2)\n\t\t\texpect(branchB.children).toHaveLength(2)\n\t\t\texpect(base.children).toHaveLength(1)\n\t\t\texpect((branchA.children[1] as Filter).op).toBe('gt')\n\t\t\texpect((branchB.children[1] as Filter).op).toBe('lt')\n\t\t})\n\n\t\ttest('.and() returns a new FilterGroup', () => {\n\t\t\tconst base = FilterGroup.create().eq('name', 'Alice')\n\t\t\tconst withAnd = base.and([(q) => q.gt('age', 20)])\n\t\t\texpect(withAnd).not.toBe(base)\n\t\t\texpect(base.children).toHaveLength(1)\n\t\t\texpect(withAnd.children).toHaveLength(2)\n\t\t})\n\n\t\ttest('.or() returns a new FilterGroup', () => {\n\t\t\tconst base = FilterGroup.create().eq('name', 'Alice')\n\t\t\tconst withOr = base.or([(q) => q.gt('age', 20)])\n\t\t\texpect(withOr).not.toBe(base)\n\t\t\texpect(base.children).toHaveLength(1)\n\t\t\texpect(withOr.children).toHaveLength(2)\n\t\t})\n\t})\n\n\tdescribe('assertNormalisedFilter', () => {\n\t\ttest('passes for valid filter referencing known fields', () => {\n\t\t\tconst g = FilterGroup.create().eq(UserSchema.fields.age, 25)\n\t\t\texpect(() => assertNormalisedFilter(UserSchema, g)).not.toThrow()\n\t\t})\n\n\t\ttest('passes for raw string field that exists on schema', () => {\n\t\t\tconst g = FilterGroup.create().eq('email', 'test@test.com')\n\t\t\texpect(() => assertNormalisedFilter(UserSchema, g)).not.toThrow()\n\t\t})\n\n\t\ttest('rejects unknown field name with OrmValidationError', () => {\n\t\t\tconst g = FilterGroup.create().eq('unknownField', 42)\n\t\t\texpect(() => assertNormalisedFilter(UserSchema, g)).toThrow(OrmValidationError)\n\t\t})\n\n\t\ttest('rejected error has kind validation', () => {\n\t\t\tconst g = FilterGroup.create().eq('badField', 42)\n\t\t\ttry {\n\t\t\t\tassertNormalisedFilter(UserSchema, g)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\texpect(e).toBeInstanceOf(OrmValidationError)\n\t\t\t\texpect((e as OrmValidationError).kind).toBe('validation')\n\t\t\t\texpect((e as OrmValidationError).failures).toHaveLength(1)\n\t\t\t\texpect((e as OrmValidationError).failures[0].field).toBe('badField')\n\t\t\t}\n\t\t})\n\n\t\ttest('preserves logical field names verbatim for Field refs', () => {\n\t\t\tconst g = FilterGroup.create().eq(UserSchema.fields.email, 'a@b.com')\n\t\t\tconst f = g.children[0] as Filter\n\t\t\texpect(f.field).toBe('email')\n\t\t\tassertNormalisedFilter(UserSchema, g)\n\t\t})\n\n\t\ttest('preserves logical field names verbatim for raw-string overloads', () => {\n\t\t\tconst g = FilterGroup.create().eq('age', 18)\n\t\t\tconst f = g.children[0] as Filter\n\t\t\texpect(f.field).toBe('age')\n\t\t\tassertNormalisedFilter(UserSchema, g)\n\t\t})\n\n\t\ttest('walks nested groups to detect unknown fields', () => {\n\t\t\tconst g = FilterGroup.create().and([\n\t\t\t\t(q) => q.eq('name', 'Alice'),\n\t\t\t\t(q) => q.or([(inner) => inner.eq('nonexistent', 'val')]),\n\t\t\t])\n\t\t\texpect(() => assertNormalisedFilter(UserSchema, g)).toThrow(OrmValidationError)\n\t\t})\n\t})\n\n\tdescribe('assertNormalisedAggregate', () => {\n\t\tconst adapter = { aggregateOps: ['count'] as readonly string[] }\n\n\t\ttest('passes for valid count aggregate', () => {\n\t\t\tconst spec = { aggregates: [{ fn: 'count' as const, alias: 'total' }], groupBy: [] }\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, adapter, spec)).not.toThrow()\n\t\t})\n\n\t\ttest('rejects empty aggregator list', () => {\n\t\t\tconst spec = { aggregates: [], groupBy: [] }\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, adapter, spec)).toThrow(OrmValidationError)\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, adapter, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\texpect((e as OrmValidationError).kind).toBe('aggregate')\n\t\t\t}\n\t\t})\n\n\t\ttest('rejects undeclared aggregate op', () => {\n\t\t\tconst spec = { aggregates: [{ fn: 'sum' as const, alias: 'total', field: 'age' }], groupBy: [] }\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, adapter, spec)).toThrow(OrmValidationError)\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, adapter, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('aggregate')\n\t\t\t\texpect(err.failures[0].alias).toBe('total')\n\t\t\t\texpect(err.failures[0].cause).toContain('Undeclared')\n\t\t\t}\n\t\t})\n\n\t\ttest('rejects duplicate aliases', () => {\n\t\t\tconst spec = {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'count' as const, alias: 'total' },\n\t\t\t\t\t{ fn: 'count' as const, alias: 'total' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, adapter, spec)).toThrow(OrmValidationError)\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, adapter, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.failures.some((f) => f.alias === 'total')).toBe(true)\n\t\t\t}\n\t\t})\n\n\t\ttest('validates where filter against schema', () => {\n\t\t\tconst spec = {\n\t\t\t\taggregates: [{ fn: 'count' as const, alias: 'total' }],\n\t\t\t\tgroupBy: [],\n\t\t\t\twhere: FilterGroup.create().eq('unknownField', 42),\n\t\t\t}\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, adapter, spec)).toThrow(OrmValidationError)\n\t\t})\n\n\t\ttest('collects multiple failures', () => {\n\t\t\tconst spec = {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'sum' as const, alias: 'x', field: 'age' },\n\t\t\t\t\t{ fn: 'avg' as const, alias: 'x', field: 'age' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, adapter, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.failures.length).toBeGreaterThanOrEqual(2)\n\t\t\t}\n\t\t})\n\n\t\ttest('rejects unknown groupBy field', () => {\n\t\t\tconst allOps = { aggregateOps: ['count', 'sum'] as readonly string[] }\n\t\t\tconst spec = {\n\t\t\t\taggregates: [{ fn: 'count' as const, alias: 'total' }],\n\t\t\t\tgroupBy: ['nonexistent'],\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, allOps, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('aggregate')\n\t\t\t\texpect(err.failures[0].cause).toContain('groupBy')\n\t\t\t\texpect(err.failures[0].field).toBe('nonexistent')\n\t\t\t}\n\t\t})\n\n\t\ttest('rejects alias colliding with groupBy field name', () => {\n\t\t\tconst allOps = { aggregateOps: ['count'] as readonly string[] }\n\t\t\tconst spec = {\n\t\t\t\taggregates: [{ fn: 'count' as const, alias: 'name' }],\n\t\t\t\tgroupBy: ['name'],\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, allOps, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('aggregate')\n\t\t\t\texpect(err.failures.some((f) => String(f.cause).includes('collides'))).toBe(true)\n\t\t\t}\n\t\t})\n\n\t\ttest('rejects unknown having field', () => {\n\t\t\tconst allOps = { aggregateOps: ['count'] as readonly string[] }\n\t\t\tconst spec = {\n\t\t\t\taggregates: [{ fn: 'count' as const, alias: 'total' }],\n\t\t\t\tgroupBy: ['name'],\n\t\t\t\thaving: FilterGroup.create().gt('nonexistent', 0),\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tassertNormalisedAggregate(UserSchema, allOps, spec)\n\t\t\t\texpect.unreachable()\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('aggregate')\n\t\t\t\texpect(err.failures[0].cause).toContain('having')\n\t\t\t}\n\t\t})\n\n\t\ttest('having accepts alias and groupBy field names', () => {\n\t\t\tconst allOps = { aggregateOps: ['count'] as readonly string[] }\n\t\t\tconst spec = {\n\t\t\t\taggregates: [{ fn: 'count' as const, alias: 'total' }],\n\t\t\t\tgroupBy: ['name'],\n\t\t\t\thaving: FilterGroup.create().gt('total', 0).eq('name', 'Alice'),\n\t\t\t}\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, allOps, spec)).not.toThrow()\n\t\t})\n\n\t\ttest('passes valid groupBy with known schema fields', () => {\n\t\t\tconst allOps = { aggregateOps: ['count'] as readonly string[] }\n\t\t\tconst spec = {\n\t\t\t\taggregates: [{ fn: 'count' as const, alias: 'total' }],\n\t\t\t\tgroupBy: ['name', 'age'],\n\t\t\t}\n\t\t\texpect(() => assertNormalisedAggregate(UserSchema, allOps, spec)).not.toThrow()\n\t\t})\n\t})\n}\n","import type { PipeInput, PipeOutput } from 'valleyed'\n\nimport type { AnyField, AnySchemaField, SchemaField } from './fields'\nimport { toFieldName } from './fields'\nimport type { AnySchema, SchemaFields } from './schema'\nimport type { Prettify } from './utils'\n\nexport type NumericFieldOf<S extends AnySchema> = {\n\t[K in keyof SchemaFields<S>]: SchemaFields<S>[K] extends SchemaField<any, infer P, any>\n\t\t? PipeOutput<P> extends number\n\t\t\t? SchemaFields<S>[K]\n\t\t\t: never\n\t\t: never\n}[keyof SchemaFields<S>]\n\nexport type ComparableFieldOf<S extends AnySchema> = {\n\t[K in keyof SchemaFields<S>]: SchemaFields<S>[K] extends SchemaField<any, infer P, any>\n\t\t? PipeOutput<P> extends number | string | Date\n\t\t\t? SchemaFields<S>[K]\n\t\t\t: never\n\t\t: never\n}[keyof SchemaFields<S>]\n\nexport type OptionalFieldOf<S extends AnySchema> = {\n\t[K in keyof SchemaFields<S>]: SchemaFields<S>[K] extends SchemaField<any, infer P, any>\n\t\t? undefined extends PipeOutput<P>\n\t\t\t? SchemaFields<S>[K]\n\t\t\t: never\n\t\t: never\n}[keyof SchemaFields<S>]\n\nexport type ArrayFieldOf<S extends AnySchema> = {\n\t[K in keyof SchemaFields<S>]: SchemaFields<S>[K] extends SchemaField<any, infer P, any>\n\t\t? PipeOutput<P> extends readonly any[]\n\t\t\t? SchemaFields<S>[K]\n\t\t\t: never\n\t\t: never\n}[keyof SchemaFields<S>]\n\nexport type ObjectFieldOf<S extends AnySchema> = {\n\t[K in keyof SchemaFields<S>]: SchemaFields<S>[K] extends SchemaField<any, infer P, any>\n\t\t? PipeOutput<P> extends Record<string, any>\n\t\t\t? PipeOutput<P> extends readonly any[]\n\t\t\t\t? never\n\t\t\t\t: SchemaFields<S>[K]\n\t\t\t: never\n\t\t: never\n}[keyof SchemaFields<S>]\n\nexport type SetValues<S extends AnySchema> = Prettify<\n\tPartial<{\n\t\t[K in keyof SchemaFields<S>]: SchemaFields<S>[K] extends AnySchemaField ? PipeInput<SchemaFields<S>[K]['pipe']> : never\n\t}>\n>\n\nexport class SetOp {\n\treadonly kind = 'set' as const\n\tconstructor(readonly values: Record<string, unknown>) {}\n}\nexport class IncOp {\n\treadonly kind = 'inc' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: number,\n\t) {}\n}\nexport class MulOp {\n\treadonly kind = 'mul' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: number,\n\t) {}\n}\nexport class MinOp<T = unknown> {\n\treadonly kind = 'min' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: T,\n\t) {}\n}\nexport class MaxOp<T = unknown> {\n\treadonly kind = 'max' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: T,\n\t) {}\n}\nexport class UnsetOp {\n\treadonly kind = 'unset' as const\n\tconstructor(readonly field: string) {}\n}\nexport class PushOp<T = unknown> {\n\treadonly kind = 'push' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: T,\n\t) {}\n}\nexport class PullOp<T = unknown> {\n\treadonly kind = 'pull' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: T,\n\t) {}\n}\nexport class PatchOp<T = unknown> {\n\treadonly kind = 'patch' as const\n\tconstructor(\n\t\treadonly field: string,\n\t\treadonly value: T,\n\t) {}\n}\n\nexport type AnyUpdateOp = SetOp | IncOp | MulOp | MinOp | MaxOp | UnsetOp | PushOp | PullOp | PatchOp\n\nexport function isUpdateOp(v: unknown): v is AnyUpdateOp {\n\treturn (\n\t\tv instanceof SetOp ||\n\t\tv instanceof IncOp ||\n\t\tv instanceof MulOp ||\n\t\tv instanceof MinOp ||\n\t\tv instanceof MaxOp ||\n\t\tv instanceof UnsetOp ||\n\t\tv instanceof PushOp ||\n\t\tv instanceof PullOp ||\n\t\tv instanceof PatchOp\n\t)\n}\n\nexport type HasOp<A, Op extends string> = A extends { updateOps: readonly (infer U)[] } ? (Op extends U ? true : false) : false\n\nexport type UpdateOp<_S extends AnySchema, A> =\n\t| (HasOp<A, 'set'> extends true ? SetOp : never)\n\t| (HasOp<A, 'inc'> extends true ? IncOp : never)\n\t| (HasOp<A, 'mul'> extends true ? MulOp : never)\n\t| (HasOp<A, 'min'> extends true ? MinOp : never)\n\t| (HasOp<A, 'max'> extends true ? MaxOp : never)\n\t| (HasOp<A, 'unset'> extends true ? UnsetOp : never)\n\t| (HasOp<A, 'push'> extends true ? PushOp : never)\n\t| (HasOp<A, 'pull'> extends true ? PullOp : never)\n\t| (HasOp<A, 'patch'> extends true ? PatchOp : never)\n\nexport function set<S extends AnySchema>(values: SetValues<S>): SetOp {\n\treturn new SetOp(values as Record<string, unknown>)\n}\n\nexport function inc<S extends AnySchema>(field: NumericFieldOf<S>, value: number): IncOp {\n\treturn new IncOp(toFieldName(field as AnyField), value)\n}\n\nexport function mul<S extends AnySchema>(field: NumericFieldOf<S>, value: number): MulOp {\n\treturn new MulOp(toFieldName(field as AnyField), value)\n}\n\nexport function min<S extends AnySchema>(field: ComparableFieldOf<S>, value: unknown): MinOp {\n\treturn new MinOp(toFieldName(field as AnyField), value)\n}\n\nexport function max<S extends AnySchema>(field: ComparableFieldOf<S>, value: unknown): MaxOp {\n\treturn new MaxOp(toFieldName(field as AnyField), value)\n}\n\nexport function unset<S extends AnySchema>(field: OptionalFieldOf<S>): UnsetOp {\n\treturn new UnsetOp(toFieldName(field as AnyField))\n}\n\nexport function push<S extends AnySchema>(field: ArrayFieldOf<S>, value: unknown): PushOp {\n\treturn new PushOp(toFieldName(field as AnyField), value)\n}\n\nexport function pull<S extends AnySchema>(field: ArrayFieldOf<S>, value: unknown): PullOp {\n\treturn new PullOp(toFieldName(field as AnyField), value)\n}\n\nexport function patch<S extends AnySchema>(field: ObjectFieldOf<S>, value: Record<string, unknown>): PatchOp {\n\treturn new PatchOp(toFieldName(field as AnyField), value)\n}\n\nexport function opTouchedFields(op: AnyUpdateOp): string[] {\n\tif (op instanceof SetOp) return Object.keys(op.values)\n\treturn [op.field]\n}\n\nexport function flattenOps(ops: AnyUpdateOp[]): Record<string, unknown> {\n\tconst data: Record<string, unknown> = {}\n\tfor (const op of ops) {\n\t\tif (op instanceof SetOp) Object.assign(data, op.values)\n\t\telse data[op.field] = op\n\t}\n\treturn data\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect, expectTypeOf } = import.meta.vitest\n\tconst { v } = await import('valleyed')\n\tconst { Schema } = await import('./schema')\n\n\tconst TestSchema = Schema.from('test')\n\t\t.pk('id', v.string(), () => 'x')\n\t\t.field('name', v.string())\n\t\t.field('age', v.number())\n\t\t.field('score', v.optional(v.number()))\n\t\t.field('tags', v.array(v.string()))\n\t\t.field('meta', v.object({ a: v.number() }))\n\t\t.field('createdAt', v.number(), { onCreate: () => 1000 })\n\t\t.field('updatedAt', v.number(), { onCreate: () => 1000, onUpdate: () => 2000 })\n\t\t.build()\n\n\tdescribe('op classes', () => {\n\t\ttest('SetOp has kind \"set\" and stores values', () => {\n\t\t\tconst op = new SetOp({ name: 'Alice' })\n\t\t\texpect(op.kind).toBe('set')\n\t\t\texpect(op.values).toEqual({ name: 'Alice' })\n\t\t})\n\t\ttest('IncOp has kind \"inc\" and stores field + value', () => {\n\t\t\tconst op = new IncOp('age', 5)\n\t\t\texpect(op.kind).toBe('inc')\n\t\t\texpect(op.field).toBe('age')\n\t\t\texpect(op.value).toBe(5)\n\t\t})\n\t\ttest('MulOp has kind \"mul\" and stores field + value', () => {\n\t\t\tconst op = new MulOp('score', 3)\n\t\t\texpect(op.kind).toBe('mul')\n\t\t\texpect(op.field).toBe('score')\n\t\t\texpect(op.value).toBe(3)\n\t\t})\n\t\ttest('MinOp has kind \"min\"', () => {\n\t\t\texpect(new MinOp('age', 10).kind).toBe('min')\n\t\t})\n\t\ttest('MaxOp has kind \"max\"', () => {\n\t\t\texpect(new MaxOp('age', 99).kind).toBe('max')\n\t\t})\n\t\ttest('UnsetOp has kind \"unset\"', () => {\n\t\t\texpect(new UnsetOp('score').kind).toBe('unset')\n\t\t})\n\t\ttest('PushOp has kind \"push\"', () => {\n\t\t\texpect(new PushOp('tags', 'x').kind).toBe('push')\n\t\t})\n\t\ttest('PullOp has kind \"pull\"', () => {\n\t\t\texpect(new PullOp('tags', 'x').kind).toBe('pull')\n\t\t})\n\t\ttest('PatchOp has kind \"patch\"', () => {\n\t\t\texpect(new PatchOp('meta', { a: 9 }).kind).toBe('patch')\n\t\t})\n\t})\n\n\tdescribe('isUpdateOp', () => {\n\t\ttest('returns true for every op class', () => {\n\t\t\texpect(isUpdateOp(new SetOp({}))).toBe(true)\n\t\t\texpect(isUpdateOp(new IncOp('f', 1))).toBe(true)\n\t\t\texpect(isUpdateOp(new MulOp('f', 2))).toBe(true)\n\t\t\texpect(isUpdateOp(new MinOp('f', 0))).toBe(true)\n\t\t\texpect(isUpdateOp(new MaxOp('f', 10))).toBe(true)\n\t\t\texpect(isUpdateOp(new UnsetOp('f'))).toBe(true)\n\t\t\texpect(isUpdateOp(new PushOp('f', 'v'))).toBe(true)\n\t\t\texpect(isUpdateOp(new PullOp('f', 'v'))).toBe(true)\n\t\t\texpect(isUpdateOp(new PatchOp('f', {}))).toBe(true)\n\t\t})\n\t\ttest('returns false for non-op values', () => {\n\t\t\texpect(isUpdateOp('string')).toBe(false)\n\t\t\texpect(isUpdateOp(42)).toBe(false)\n\t\t\texpect(isUpdateOp(null)).toBe(false)\n\t\t\texpect(isUpdateOp({})).toBe(false)\n\t\t})\n\t})\n\n\tdescribe('op helper functions', () => {\n\t\ttest('set() creates SetOp with values', () => {\n\t\t\tconst op = set<typeof TestSchema>({ name: 'Alice', age: 30 })\n\t\t\texpect(op).toBeInstanceOf(SetOp)\n\t\t\texpect(op.kind).toBe('set')\n\t\t\texpect(op.values).toEqual({ name: 'Alice', age: 30 })\n\t\t})\n\t\ttest('inc() creates IncOp from field ref', () => {\n\t\t\tconst op = inc<typeof TestSchema>(TestSchema.fields.age, 5)\n\t\t\texpect(op).toBeInstanceOf(IncOp)\n\t\t\texpect(op.field).toBe('age')\n\t\t\texpect(op.value).toBe(5)\n\t\t})\n\t\ttest('mul() creates MulOp from field ref', () => {\n\t\t\tconst op = mul<typeof TestSchema>(TestSchema.fields.age, 3)\n\t\t\texpect(op).toBeInstanceOf(MulOp)\n\t\t\texpect(op.field).toBe('age')\n\t\t\texpect(op.value).toBe(3)\n\t\t})\n\t\ttest('min() creates MinOp from field ref', () => {\n\t\t\tconst op = min<typeof TestSchema>(TestSchema.fields.age, 10)\n\t\t\texpect(op).toBeInstanceOf(MinOp)\n\t\t\texpect(op.field).toBe('age')\n\t\t})\n\t\ttest('max() creates MaxOp from field ref', () => {\n\t\t\tconst op = max<typeof TestSchema>(TestSchema.fields.age, 99)\n\t\t\texpect(op).toBeInstanceOf(MaxOp)\n\t\t\texpect(op.field).toBe('age')\n\t\t})\n\t\ttest('unset() creates UnsetOp from field ref', () => {\n\t\t\tconst op = unset<typeof TestSchema>(TestSchema.fields.score)\n\t\t\texpect(op).toBeInstanceOf(UnsetOp)\n\t\t\texpect(op.field).toBe('score')\n\t\t})\n\t\ttest('push() creates PushOp from field ref', () => {\n\t\t\tconst op = push<typeof TestSchema>(TestSchema.fields.tags, 'new-tag')\n\t\t\texpect(op).toBeInstanceOf(PushOp)\n\t\t\texpect(op.field).toBe('tags')\n\t\t\texpect(op.value).toBe('new-tag')\n\t\t})\n\t\ttest('pull() creates PullOp from field ref', () => {\n\t\t\tconst op = pull<typeof TestSchema>(TestSchema.fields.tags, 'old-tag')\n\t\t\texpect(op).toBeInstanceOf(PullOp)\n\t\t\texpect(op.field).toBe('tags')\n\t\t})\n\t\ttest('patch() creates PatchOp from field ref', () => {\n\t\t\tconst op = patch<typeof TestSchema>(TestSchema.fields.meta, { a: 9 })\n\t\t\texpect(op).toBeInstanceOf(PatchOp)\n\t\t\texpect(op.field).toBe('meta')\n\t\t\texpect(op.value).toEqual({ a: 9 })\n\t\t})\n\t})\n\n\tdescribe('opTouchedFields', () => {\n\t\ttest('SetOp returns all keys from values', () => {\n\t\t\texpect(opTouchedFields(new SetOp({ name: 'A', age: 1 }))).toEqual(['name', 'age'])\n\t\t})\n\t\ttest('IncOp returns the field', () => {\n\t\t\texpect(opTouchedFields(new IncOp('age', 1))).toEqual(['age'])\n\t\t})\n\t\ttest('UnsetOp returns the field', () => {\n\t\t\texpect(opTouchedFields(new UnsetOp('score'))).toEqual(['score'])\n\t\t})\n\t})\n\n\tdescribe('type-level: field-category helpers', () => {\n\t\ttest('NumericFieldOf only matches numeric fields (excludes optional numeric)', () => {\n\t\t\ttype Numeric = NumericFieldOf<typeof TestSchema>\n\t\t\texpectTypeOf<Numeric['name']>().toEqualTypeOf<'age' | 'createdAt' | 'updatedAt'>()\n\t\t})\n\t\ttest('ComparableFieldOf matches numeric and string fields (excludes optional)', () => {\n\t\t\ttype Comparable = ComparableFieldOf<typeof TestSchema>\n\t\t\texpectTypeOf<Comparable['name']>().toEqualTypeOf<'id' | 'name' | 'age' | 'createdAt' | 'updatedAt'>()\n\t\t})\n\t\ttest('OptionalFieldOf only matches optional fields', () => {\n\t\t\ttype Optional = OptionalFieldOf<typeof TestSchema>\n\t\t\texpectTypeOf<Optional['name']>().toEqualTypeOf<'score'>()\n\t\t})\n\t\ttest('ArrayFieldOf only matches array fields', () => {\n\t\t\ttype Arr = ArrayFieldOf<typeof TestSchema>\n\t\t\texpectTypeOf<Arr['name']>().toEqualTypeOf<'tags'>()\n\t\t})\n\t\ttest('ObjectFieldOf only matches object fields (not arrays)', () => {\n\t\t\ttype Obj = ObjectFieldOf<typeof TestSchema>\n\t\t\texpectTypeOf<Obj['name']>().toEqualTypeOf<'meta'>()\n\t\t})\n\t})\n\n\tdescribe('type-level: inc on a string field is a TS error', () => {\n\t\ttest('inc rejects non-numeric fields', () => {\n\t\t\t// @ts-expect-error — name is a string field, not numeric\n\t\t\tinc<typeof TestSchema>(TestSchema.fields.name, 1)\n\t\t})\n\t})\n\n\tdescribe('type-level: push on a non-array field is a TS error', () => {\n\t\ttest('push rejects non-array fields', () => {\n\t\t\t// @ts-expect-error — name is a string field, not array\n\t\t\tpush<typeof TestSchema>(TestSchema.fields.name, 'val')\n\t\t})\n\t})\n\n\tdescribe('type-level: per-op gating via UpdateOp<S, A>', () => {\n\t\ttest('undeclared ops resolve to never', async () => {\n\t\t\tconst { OrmAdapter } = await import('./orm-adapter')\n\t\t\tclass LimitedAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({})\n\t\t\t\treadonly supportedFieldTypes = ['string', 'number'] as const\n\t\t\t\treadonly updateOps = ['set', 'inc'] as const\n\t\t\t}\n\n\t\t\ttype Limited = UpdateOp<typeof TestSchema, LimitedAdapter>\n\t\t\texpectTypeOf<Limited>().toEqualTypeOf<SetOp | IncOp>()\n\t\t})\n\n\t\ttest('adapter with no updateOps resolves all variants to never', async () => {\n\t\t\tconst { OrmAdapter } = await import('./orm-adapter')\n\t\t\tclass NoOpsAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({})\n\t\t\t\treadonly supportedFieldTypes = ['string'] as const\n\t\t\t\treadonly updateOps = [] as const\n\t\t\t}\n\n\t\t\ttype NoOps = UpdateOp<typeof TestSchema, NoOpsAdapter>\n\t\t\texpectTypeOf<NoOps>().toBeNever()\n\t\t})\n\n\t\ttest('adapter with all updateOps includes all variants', async () => {\n\t\t\tconst { OrmAdapter } = await import('./orm-adapter')\n\t\t\tclass FullAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({})\n\t\t\t\treadonly supportedFieldTypes = ['string', 'number'] as const\n\t\t\t\treadonly updateOps = ['set', 'inc', 'mul', 'min', 'max', 'unset', 'push', 'pull', 'patch'] as const\n\t\t\t}\n\n\t\t\ttype Full = UpdateOp<typeof TestSchema, FullAdapter>\n\t\t\ttype Expected =\n\t\t\t\t| SetOp\n\t\t\t\t| IncOp\n\t\t\t\t| MulOp\n\t\t\t\t| MinOp\n\t\t\t\t| MaxOp\n\t\t\t\t| UnsetOp\n\t\t\t\t| PushOp\n\t\t\t\t| PullOp\n\t\t\t\t| PatchOp\n\t\t\texpectTypeOf<Full>().toEqualTypeOf<Expected>()\n\t\t})\n\t})\n}\n","import { Filter, FilterGroup, type FilterChild } from '../../filter'\nimport type { AggregateSpec } from '../../orm-adapter'\nimport type { QueryOptions } from '../../query-options'\nimport { flattenOps, IncOp, MaxOp, MinOp, MulOp, PatchOp, PullOp, PushOp, SetOp, UnsetOp, type AnyUpdateOp } from '../../updates'\n\ntype MongoFilter = Record<string, unknown>\n\nexport function compileMongoFilter(group: FilterGroup, primaryKey: string): MongoFilter {\n\tconst clauses: MongoFilter[] = []\n\tfor (const child of group.children) {\n\t\tconst compiled = compileChild(child, primaryKey)\n\t\tif (compiled) clauses.push(compiled)\n\t}\n\n\tif (clauses.length === 0) return {}\n\tif (clauses.length === 1) return clauses[0]\n\treturn { $and: clauses }\n}\n\nexport function compileMongoQuery(\n\tgroup: FilterGroup,\n\toptions: QueryOptions | undefined,\n\tprimaryKey: string,\n): {\n\tfilter: MongoFilter\n\tsort: Record<string, 1 | -1> | undefined\n\tlimit: number | undefined\n\tskip: number | undefined\n\tprojection: Record<string, 1> | undefined\n} {\n\tconst mongoFilter = compileMongoFilter(group, primaryKey)\n\n\tconst orderBys = options?.orderBy ?? []\n\tconst sort =\n\t\torderBys.length > 0\n\t\t\t? Object.fromEntries(orderBys.map((o) => [mapField(o.field, primaryKey), o.direction === 'desc' ? -1 : 1]))\n\t\t\t: undefined\n\n\tconst selects = options?.select ?? []\n\tconst projection = selects.length > 0 ? Object.fromEntries(selects.map((f) => [mapField(f, primaryKey), 1])) : undefined\n\n\treturn {\n\t\tfilter: mongoFilter,\n\t\tsort: sort as Record<string, 1 | -1> | undefined,\n\t\tlimit: options?.limit,\n\t\tskip: options?.offset,\n\t\tprojection: projection as Record<string, 1> | undefined,\n\t}\n}\n\nfunction mapField(field: string, primaryKey: string): string {\n\tif (field === 'id' && primaryKey === '_id') return '_id'\n\treturn field\n}\n\nfunction compileFilter(f: Filter, primaryKey: string): MongoFilter {\n\tconst field = mapField(f.field, primaryKey)\n\n\tswitch (f.op) {\n\t\tcase 'eq':\n\t\t\treturn { [field]: { $eq: f.value } }\n\t\tcase 'ne':\n\t\t\treturn { [field]: { $ne: f.value } }\n\t\tcase 'gt':\n\t\t\treturn { [field]: { $gt: f.value } }\n\t\tcase 'gte':\n\t\t\treturn { [field]: { $gte: f.value } }\n\t\tcase 'lt':\n\t\t\treturn { [field]: { $lt: f.value } }\n\t\tcase 'lte':\n\t\t\treturn { [field]: { $lte: f.value } }\n\t\tcase 'in':\n\t\t\treturn { [field]: { $in: f.value } }\n\t\tcase 'notIn':\n\t\t\treturn { [field]: { $nin: f.value } }\n\t\tcase 'like':\n\t\t\treturn { [field]: { $regex: new RegExp(String(f.value), 'i') } }\n\t\tcase 'exists':\n\t\t\treturn { [field]: { $exists: true, $ne: null } }\n\t\tcase 'notExists':\n\t\t\treturn { [field]: { $eq: null } }\n\t\tcase 'contains':\n\t\t\treturn { [field]: { $all: Array.isArray(f.value) ? f.value : [f.value] } }\n\t\tcase 'notContains':\n\t\t\treturn { [field]: { $not: { $all: Array.isArray(f.value) ? f.value : [f.value] } } }\n\t\tdefault:\n\t\t\treturn { [field]: { $eq: f.value } }\n\t}\n}\n\nfunction compileChild(child: FilterChild, primaryKey: string): MongoFilter | null {\n\tif (child instanceof Filter) return compileFilter(child, primaryKey)\n\tif (child instanceof FilterGroup) return compileGroup(child, primaryKey)\n\treturn null\n}\n\nfunction compileGroup(group: FilterGroup, primaryKey: string): MongoFilter | null {\n\tconst clauses = group.children.map((c) => compileChild(c, primaryKey)).filter((c): c is MongoFilter => c !== null)\n\tif (clauses.length === 0) return null\n\tif (clauses.length === 1) return clauses[0]\n\treturn { [group.op === 'or' ? '$or' : '$and']: clauses }\n}\n\nexport function compileMongoUpdate(data: Record<string, unknown>): Record<string, unknown> {\n\tconst $set: Record<string, unknown> = {}\n\tconst $inc: Record<string, unknown> = {}\n\tconst $mul: Record<string, unknown> = {}\n\tconst $min: Record<string, unknown> = {}\n\tconst $max: Record<string, unknown> = {}\n\tconst $unset: Record<string, ''> = {}\n\tconst $push: Record<string, unknown> = {}\n\tconst $pull: Record<string, unknown> = {}\n\n\tfor (const [key, value] of Object.entries(data)) {\n\t\tif (value instanceof IncOp) $inc[key] = value.value\n\t\telse if (value instanceof MulOp) $mul[key] = value.value\n\t\telse if (value instanceof MinOp) $min[key] = value.value\n\t\telse if (value instanceof MaxOp) $max[key] = value.value\n\t\telse if (value instanceof UnsetOp) $unset[key] = ''\n\t\telse if (value instanceof PushOp) $push[key] = value.value\n\t\telse if (value instanceof PullOp) $pull[key] = value.value\n\t\telse if (value instanceof PatchOp) {\n\t\t\tconst patchVal = value.value as Record<string, unknown>\n\t\t\tfor (const [subKey, subVal] of Object.entries(patchVal)) {\n\t\t\t\t$set[`${key}.${subKey}`] = subVal\n\t\t\t}\n\t\t} else $set[key] = value\n\t}\n\n\tconst result: Record<string, unknown> = {}\n\tif (Object.keys($set).length) result.$set = $set\n\tif (Object.keys($inc).length) result.$inc = $inc\n\tif (Object.keys($mul).length) result.$mul = $mul\n\tif (Object.keys($min).length) result.$min = $min\n\tif (Object.keys($max).length) result.$max = $max\n\tif (Object.keys($unset).length) result.$unset = $unset\n\tif (Object.keys($push).length) result.$push = $push\n\tif (Object.keys($pull).length) result.$pull = $pull\n\n\treturn result\n}\n\nexport function compileMongoOps(ops: AnyUpdateOp[]): Record<string, unknown> {\n\treturn compileMongoUpdate(flattenOps(ops))\n}\n\nexport function compileMongoAggregate(spec: AggregateSpec, primaryKey: string): Record<string, unknown>[] {\n\tconst pipeline: Record<string, unknown>[] = []\n\n\tif (spec.where) {\n\t\tconst match = compileMongoFilter(spec.where, primaryKey)\n\t\tif (Object.keys(match).length > 0) pipeline.push({ $match: match })\n\t}\n\n\tconst groupId: Record<string, string> | null =\n\t\tspec.groupBy.length > 0\n\t\t\t? Object.fromEntries(spec.groupBy.map((f) => [f, `$${mapField(f, primaryKey)}`]))\n\t\t\t: null\n\n\tconst accumulators: Record<string, unknown> = {}\n\tfor (const agg of spec.aggregates) {\n\t\tconst fieldRef = agg.field ? `$${mapField(agg.field, primaryKey)}` : undefined\n\t\tswitch (agg.fn) {\n\t\t\tcase 'count':\n\t\t\t\taccumulators[agg.alias] = { $sum: 1 }\n\t\t\t\tbreak\n\t\t\tcase 'countDistinct':\n\t\t\t\taccumulators[agg.alias] = { $addToSet: fieldRef }\n\t\t\t\tbreak\n\t\t\tcase 'sum':\n\t\t\tcase 'avg':\n\t\t\tcase 'min':\n\t\t\tcase 'max':\n\t\t\t\taccumulators[agg.alias] = { [`$${agg.fn}`]: fieldRef }\n\t\t\t\tbreak\n\t\t}\n\t}\n\n\tpipeline.push({ $group: { _id: groupId, ...accumulators } })\n\n\tconst project: Record<string, unknown> = { _id: 0 }\n\tfor (const f of spec.groupBy) {\n\t\tproject[f] = `$_id.${f}`\n\t}\n\tfor (const agg of spec.aggregates) {\n\t\tif (agg.fn === 'countDistinct') {\n\t\t\tproject[agg.alias] = { $size: `$${agg.alias}` }\n\t\t} else {\n\t\t\tproject[agg.alias] = 1\n\t\t}\n\t}\n\tpipeline.push({ $project: project })\n\n\tif (spec.having) {\n\t\tconst havingMatch = compileMongoFilter(spec.having, '')\n\t\tif (Object.keys(havingMatch).length > 0) pipeline.push({ $match: havingMatch })\n\t}\n\n\treturn pipeline\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect } = import.meta.vitest\n\tconst { FilterGroup } = await import('../../filter')\n\tconst { OrderBy } = await import('../../query-options')\n\n\tdescribe('compileMongoFilter', () => {\n\t\ttest('empty filter group compiles to empty object', () => {\n\t\t\tconst group = FilterGroup.create()\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({})\n\t\t})\n\n\t\ttest('single eq filter compiles to $eq', () => {\n\t\t\tconst group = FilterGroup.create().eq('name', 'Alice')\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ name: { $eq: 'Alice' } })\n\t\t})\n\n\t\ttest('ne, gt, gte, lt, lte compile to corresponding Mongo ops', () => {\n\t\t\texpect(compileMongoFilter(FilterGroup.create().ne('age', 5), 'id')).toEqual({ age: { $ne: 5 } })\n\t\t\texpect(compileMongoFilter(FilterGroup.create().gt('age', 10), 'id')).toEqual({ age: { $gt: 10 } })\n\t\t\texpect(compileMongoFilter(FilterGroup.create().gte('age', 20), 'id')).toEqual({ age: { $gte: 20 } })\n\t\t\texpect(compileMongoFilter(FilterGroup.create().lt('age', 30), 'id')).toEqual({ age: { $lt: 30 } })\n\t\t\texpect(compileMongoFilter(FilterGroup.create().lte('age', 40), 'id')).toEqual({ age: { $lte: 40 } })\n\t\t})\n\n\t\ttest('in compiles to $in', () => {\n\t\t\tconst group = FilterGroup.create().in('status', ['a', 'b'])\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ status: { $in: ['a', 'b'] } })\n\t\t})\n\n\t\ttest('notIn compiles to $nin (canonical name notIn, Mongo op $nin)', () => {\n\t\t\tconst group = FilterGroup.create().notIn('status', ['x', 'y'])\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ status: { $nin: ['x', 'y'] } })\n\t\t})\n\n\t\ttest('like compiles to $regex with case-insensitive flag', () => {\n\t\t\tconst group = FilterGroup.create().like('name', 'ali')\n\t\t\tconst result = compileMongoFilter(group, 'id')\n\t\t\texpect(result.name).toEqual({ $regex: expect.any(RegExp) })\n\t\t\tconst regex = (result.name as any).$regex as RegExp\n\t\t\texpect(regex.flags).toBe('i')\n\t\t\texpect(regex.test('Alice')).toBe(true)\n\t\t})\n\n\t\ttest('exists compiles to $exists: true, $ne: null', () => {\n\t\t\tconst group = FilterGroup.create().exists('val')\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ val: { $exists: true, $ne: null } })\n\t\t})\n\n\t\ttest('notExists is its own op — compiles to $eq: null', () => {\n\t\t\tconst group = FilterGroup.create().notExists('val')\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ val: { $eq: null } })\n\t\t})\n\n\t\ttest('contains compiles to $all', () => {\n\t\t\tconst group = FilterGroup.create().contains('tags', ['a', 'b'])\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ tags: { $all: ['a', 'b'] } })\n\t\t})\n\n\t\ttest('notContains compiles to $not: { $all }', () => {\n\t\t\tconst group = FilterGroup.create().notContains('tags', ['x'])\n\t\t\texpect(compileMongoFilter(group, 'id')).toEqual({ tags: { $not: { $all: ['x'] } } })\n\t\t})\n\n\t\ttest('multiple clauses produce $and', () => {\n\t\t\tconst group = FilterGroup.create().eq('a', 1).gt('b', 2)\n\t\t\tconst result = compileMongoFilter(group, 'id')\n\t\t\texpect(result).toEqual({ $and: [{ a: { $eq: 1 } }, { b: { $gt: 2 } }] })\n\t\t})\n\n\t\ttest('nested and/or groups compile correctly', () => {\n\t\t\tconst group = FilterGroup.create().and([\n\t\t\t\t(q) => q.eq('a', 1),\n\t\t\t\t(q) => q.or([(g) => g.eq('b', 2), (g) => g.eq('c', 3)]),\n\t\t\t])\n\t\t\tconst result = compileMongoFilter(group, 'id')\n\t\t\texpect(result).toEqual({\n\t\t\t\t$and: [{ a: { $eq: 1 } }, { $or: [{ b: { $eq: 2 } }, { c: { $eq: 3 } }] }],\n\t\t\t})\n\t\t})\n\n\t\ttest('maps id field to _id when primaryKey is _id', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'abc')\n\t\t\texpect(compileMongoFilter(group, '_id')).toEqual({ _id: { $eq: 'abc' } })\n\t\t})\n\t})\n\n\tdescribe('compileMongoQuery', () => {\n\t\ttest('options: sort, limit, skip, projection', () => {\n\t\t\tconst group = FilterGroup.create().eq('active', true)\n\t\t\tconst options = {\n\t\t\t\torderBy: [new OrderBy('name', 'asc'), new OrderBy('age', 'desc')],\n\t\t\t\tlimit: 10,\n\t\t\t\toffset: 5,\n\t\t\t\tselect: ['name', 'age'] as const,\n\t\t\t}\n\t\t\tconst result = compileMongoQuery(group, options, 'id')\n\t\t\texpect(result.filter).toEqual({ active: { $eq: true } })\n\t\t\texpect(result.sort).toEqual({ name: 1, age: -1 })\n\t\t\texpect(result.limit).toBe(10)\n\t\t\texpect(result.skip).toBe(5)\n\t\t\texpect(result.projection).toEqual({ name: 1, age: 1 })\n\t\t})\n\n\t\ttest('undefined options returns undefined for sort/limit/skip/projection', () => {\n\t\t\tconst group = FilterGroup.create().eq('x', 1)\n\t\t\tconst result = compileMongoQuery(group, undefined, 'id')\n\t\t\texpect(result.sort).toBeUndefined()\n\t\t\texpect(result.limit).toBeUndefined()\n\t\t\texpect(result.skip).toBeUndefined()\n\t\t\texpect(result.projection).toBeUndefined()\n\t\t})\n\t})\n\n\tdescribe('compileMongoUpdate', () => {\n\t\ttest('plain values go into $set', () => {\n\t\t\tconst result = compileMongoUpdate({ name: 'Alice', age: 30 })\n\t\t\texpect(result).toEqual({ $set: { name: 'Alice', age: 30 } })\n\t\t})\n\n\t\ttest('IncOp goes into $inc', () => {\n\t\t\tconst result = compileMongoUpdate({ count: new IncOp('count', 5) })\n\t\t\texpect(result).toEqual({ $inc: { count: 5 } })\n\t\t})\n\n\t\ttest('MulOp goes into $mul', () => {\n\t\t\tconst result = compileMongoUpdate({ score: new MulOp('score', 2) })\n\t\t\texpect(result).toEqual({ $mul: { score: 2 } })\n\t\t})\n\n\t\ttest('MinOp/MaxOp go into $min/$max', () => {\n\t\t\tconst result = compileMongoUpdate({\n\t\t\t\tlo: new MinOp('lo', 1),\n\t\t\t\thi: new MaxOp('hi', 99),\n\t\t\t})\n\t\t\texpect(result).toEqual({ $min: { lo: 1 }, $max: { hi: 99 } })\n\t\t})\n\n\t\ttest('UnsetOp goes into $unset', () => {\n\t\t\tconst result = compileMongoUpdate({ old: new UnsetOp('old') })\n\t\t\texpect(result).toEqual({ $unset: { old: '' } })\n\t\t})\n\n\t\ttest('PushOp/PullOp go into $push/$pull', () => {\n\t\t\tconst result = compileMongoUpdate({\n\t\t\t\ttags: new PushOp('tags', 'new'),\n\t\t\t\tremoved: new PullOp('removed', 'old'),\n\t\t\t})\n\t\t\texpect(result).toEqual({ $push: { tags: 'new' }, $pull: { removed: 'old' } })\n\t\t})\n\n\t\ttest('PatchOp produces dot-notation $set entries', () => {\n\t\t\tconst result = compileMongoUpdate({ meta: new PatchOp('meta', { a: 1, b: 2 }) })\n\t\t\texpect(result).toEqual({ $set: { 'meta.a': 1, 'meta.b': 2 } })\n\t\t})\n\n\t\ttest('empty data produces empty result', () => {\n\t\t\tconst result = compileMongoUpdate({})\n\t\t\texpect(result).toEqual({})\n\t\t})\n\t})\n\n\tdescribe('compileMongoOps', () => {\n\t\ttest('SetOp values go into $set', () => {\n\t\t\tconst result = compileMongoOps([new SetOp({ name: 'Bob', age: 25 })])\n\t\t\texpect(result).toEqual({ $set: { name: 'Bob', age: 25 } })\n\t\t})\n\n\t\ttest('mixed ops compile to separate Mongo update operators', () => {\n\t\t\tconst result = compileMongoOps([\n\t\t\t\tnew SetOp({ name: 'Alice' }),\n\t\t\t\tnew IncOp('count', 1),\n\t\t\t\tnew PushOp('tags', 'x'),\n\t\t\t])\n\t\t\texpect(result).toEqual({\n\t\t\t\t$set: { name: 'Alice' },\n\t\t\t\t$inc: { count: 1 },\n\t\t\t\t$push: { tags: 'x' },\n\t\t\t})\n\t\t})\n\n\t\ttest('empty ops produces empty result', () => {\n\t\t\texpect(compileMongoOps([])).toEqual({})\n\t\t})\n\t})\n\n\tdescribe('compileMongoAggregate', () => {\n\t\ttest('bare count produces $group with $sum:1 and $project', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $group: { _id: null, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, total: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('multi-aggregator produces all accumulators in $group', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'count', alias: 'total' },\n\t\t\t\t\t{ fn: 'sum', field: 'amount', alias: 'revenue' },\n\t\t\t\t\t{ fn: 'avg', field: 'price', alias: 'avgPrice' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{\n\t\t\t\t\t$group: {\n\t\t\t\t\t\t_id: null,\n\t\t\t\t\t\ttotal: { $sum: 1 },\n\t\t\t\t\t\trevenue: { $sum: '$amount' },\n\t\t\t\t\t\tavgPrice: { $avg: '$price' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{ $project: { _id: 0, total: 1, revenue: 1, avgPrice: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('single-column groupBy produces composite _id and $project lift', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $group: { _id: { region: '$region' }, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, region: '$_id.region', total: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('multi-column groupBy via composite _id', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [{ fn: 'sum', field: 'amount', alias: 'revenue' }],\n\t\t\t\tgroupBy: ['region', 'year'],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{\n\t\t\t\t\t$group: {\n\t\t\t\t\t\t_id: { region: '$region', year: '$year' },\n\t\t\t\t\t\trevenue: { $sum: '$amount' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t$project: {\n\t\t\t\t\t\t_id: 0,\n\t\t\t\t\t\tregion: '$_id.region',\n\t\t\t\t\t\tyear: '$_id.year',\n\t\t\t\t\t\trevenue: 1,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t])\n\t\t})\n\n\t\ttest('where-only emits $match before $group', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\twhere: FilterGroup.create().eq('active', true),\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $match: { active: { $eq: true } } },\n\t\t\t\t{ $group: { _id: null, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, total: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('having-only emits $match after $project', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t\thaving: FilterGroup.create().gt('total', 5),\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $group: { _id: { region: '$region' }, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, region: '$_id.region', total: 1 } },\n\t\t\t\t{ $match: { total: { $gt: 5 } } },\n\t\t\t])\n\t\t})\n\n\t\ttest('where + having produces both $match stages', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\twhere: FilterGroup.create().eq('active', true),\n\t\t\t\taggregates: [{ fn: 'sum', field: 'amount', alias: 'revenue' }],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t\thaving: FilterGroup.create().gte('revenue', 1000),\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $match: { active: { $eq: true } } },\n\t\t\t\t{\n\t\t\t\t\t$group: {\n\t\t\t\t\t\t_id: { region: '$region' },\n\t\t\t\t\t\trevenue: { $sum: '$amount' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{ $project: { _id: 0, region: '$_id.region', revenue: 1 } },\n\t\t\t\t{ $match: { revenue: { $gte: 1000 } } },\n\t\t\t])\n\t\t})\n\n\t\ttest('countDistinct uses $addToSet in $group and $size in $project', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [{ fn: 'countDistinct', field: 'userId', alias: 'uniqueUsers' }],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $group: { _id: null, uniqueUsers: { $addToSet: '$userId' } } },\n\t\t\t\t{ $project: { _id: 0, uniqueUsers: { $size: '$uniqueUsers' } } },\n\t\t\t])\n\t\t})\n\n\t\ttest('min/max produce $min/$max accumulators', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'min', field: 'price', alias: 'lowest' },\n\t\t\t\t\t{ fn: 'max', field: 'price', alias: 'highest' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{\n\t\t\t\t\t$group: {\n\t\t\t\t\t\t_id: null,\n\t\t\t\t\t\tlowest: { $min: '$price' },\n\t\t\t\t\t\thighest: { $max: '$price' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{ $project: { _id: 0, lowest: 1, highest: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('field-name mapping: id field maps to _id when primaryKey is _id', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\twhere: FilterGroup.create().eq('id', 'abc'),\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: ['id'],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $match: { _id: { $eq: 'abc' } } },\n\t\t\t\t{ $group: { _id: { id: '$_id' }, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, id: '$_id.id', total: 1 } },\n\t\t\t])\n\t\t})\n\n\t\ttest('countDistinct with groupBy combines $addToSet, groupBy lift, and $size', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [{ fn: 'countDistinct', field: 'category', alias: 'uniqueCats' }],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{\n\t\t\t\t\t$group: {\n\t\t\t\t\t\t_id: { region: '$region' },\n\t\t\t\t\t\tuniqueCats: { $addToSet: '$category' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t$project: {\n\t\t\t\t\t\t_id: 0,\n\t\t\t\t\t\tregion: '$_id.region',\n\t\t\t\t\t\tuniqueCats: { $size: '$uniqueCats' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t])\n\t\t})\n\n\t\ttest('all six aggregators in a single pipeline', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'count', alias: 'total' },\n\t\t\t\t\t{ fn: 'countDistinct', field: 'status', alias: 'uniqueStatuses' },\n\t\t\t\t\t{ fn: 'sum', field: 'amount', alias: 'totalAmount' },\n\t\t\t\t\t{ fn: 'avg', field: 'amount', alias: 'avgAmount' },\n\t\t\t\t\t{ fn: 'min', field: 'amount', alias: 'minAmount' },\n\t\t\t\t\t{ fn: 'max', field: 'amount', alias: 'maxAmount' },\n\t\t\t\t],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t}\n\t\t\tconst pipeline = compileMongoAggregate(spec, '_id')\n\t\t\texpect(pipeline).toEqual([\n\t\t\t\t{\n\t\t\t\t\t$group: {\n\t\t\t\t\t\t_id: { region: '$region' },\n\t\t\t\t\t\ttotal: { $sum: 1 },\n\t\t\t\t\t\tuniqueStatuses: { $addToSet: '$status' },\n\t\t\t\t\t\ttotalAmount: { $sum: '$amount' },\n\t\t\t\t\t\tavgAmount: { $avg: '$amount' },\n\t\t\t\t\t\tminAmount: { $min: '$amount' },\n\t\t\t\t\t\tmaxAmount: { $max: '$amount' },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t$project: {\n\t\t\t\t\t\t_id: 0,\n\t\t\t\t\t\tregion: '$_id.region',\n\t\t\t\t\t\ttotal: 1,\n\t\t\t\t\t\tuniqueStatuses: { $size: '$uniqueStatuses' },\n\t\t\t\t\t\ttotalAmount: 1,\n\t\t\t\t\t\tavgAmount: 1,\n\t\t\t\t\t\tminAmount: 1,\n\t\t\t\t\t\tmaxAmount: 1,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t])\n\t\t})\n\n\t\ttest('empty where filter is omitted from pipeline', () => {\n\t\t\tconst spec: AggregateSpec = {\n\t\t\t\twhere: FilterGroup.create(),\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: [],\n\t\t\t}\n\t\t\texpect(compileMongoAggregate(spec, '_id')).toEqual([\n\t\t\t\t{ $group: { _id: null, total: { $sum: 1 } } },\n\t\t\t\t{ $project: { _id: 0, total: 1 } },\n\t\t\t])\n\t\t})\n\t})\n}\n","import { v, type ConditionalObjectKeys, type Pipe, type PipeInput, type PipeOutput } from 'valleyed'\n\ntype CtorParams<T> = ConstructorParameters<T & (abstract new (...args: any[]) => any)>\ntype BaseCtorParams<T> = T extends abstract new (...args: infer A) => any ? A : never\n\nexport function configurable<P extends Pipe<any, any>, Base extends abstract new (...args: any[]) => any>(pipeFn: () => P, base: Base) {\n\tconst pipe = pipeFn()\n\tv.compile(pipe)\n\n\tabstract class Configurable extends (base as unknown as new (...args: any[]) => any) {\n\t\tdeclare static readonly Config: PipeOutput<P>\n\n\t\tprotected constructor (protected readonly config: PipeOutput<P>, ...baseArgs: BaseCtorParams<Base>) {\n\t\t\t// eslint-disable-next-line constructor-super\n\t\t\tsuper(...baseArgs)\n\t\t}\n\n\t\tstatic create<This extends Function & { prototype: any }>(\n\t\t\tthis: This,\n\t\t\tinput: ConditionalObjectKeys<PipeInput<P>>,\n\t\t\t...args: CtorParams<This> extends [PipeOutput<P>, ...infer R] ? R : never\n\t\t): This['prototype'] {\n\t\t\tconst r = v.validate(pipe, input)\n\t\t\tif (!r.valid) throw r.error\n\t\t\treturn new (this as any)(r.value, ...args) as This['prototype']\n\t\t}\n\t}\n\n\treturn Configurable as unknown as (abstract new (validated: PipeOutput<P>, ...baseArgs: BaseCtorParams<Base>) => InstanceType<Base> & { readonly config: PipeOutput<P> }) & {\n\t\treadonly Config: PipeOutput<P>\n\t\tcreate<This extends Function & { prototype: any }>(\n\t\t\tthis: This,\n\t\t\tinput: ConditionalObjectKeys<PipeInput<P>>,\n\t\t\t...args: CtorParams<This> extends [PipeOutput<P>, ...infer R] ? R : never\n\t\t): This['prototype']\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect, expectTypeOf } = import.meta.vitest\n\tconst { v } = await import('valleyed')\n\n\tconst testPipe = () =>\n\t\tv.object({\n\t\t\thost: v.string(),\n\t\t\tport: v.number(),\n\t\t})\n\n\ttype TestConfig = PipeOutput<ReturnType<typeof testPipe>>\n\n\tclass TestBase {\n\t\tbaseValue: string\n\t\tconstructor() {\n\t\t\tthis.baseValue = 'base'\n\t\t}\n\t}\n\n\tclass TestBaseWithArgs {\n\t\tlabel: string\n\t\tconstructor(label: string) {\n\t\t\tthis.label = label\n\t\t}\n\t}\n\n\tdescribe('configurable', () => {\n\t\ttest('validation runs in static create before constructor body executes', () => {\n\t\t\tlet constructorRan = false\n\n\t\t\tconst Wrapped = configurable(testPipe, TestBase)\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof MyClass.Config) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t\tconstructorRan = true\n\t\t\t\t}\n\t\t\t}\n\n\t\t\texpect(() => MyClass.create({ host: 123, port: 'bad' } as any)).toThrow()\n\t\t\texpect(constructorRan).toBe(false)\n\n\t\t\tMyClass.create({ host: 'localhost', port: 3000 })\n\t\t\texpect(constructorRan).toBe(true)\n\t\t})\n\n\t\ttest('constructor receives validated value', () => {\n\t\t\tconst Wrapped = configurable(testPipe, TestBase)\n\t\t\tlet receivedConfig: unknown\n\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof MyClass.Config) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t\treceivedConfig = this.config\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tMyClass.create({ host: 'localhost', port: 3000 })\n\n\t\t\texpect(receivedConfig).toEqual({ host: 'localhost', port: 3000 })\n\t\t})\n\n\t\ttest('external new is a compile error', () => {\n\t\t\tconst Wrapped = configurable(testPipe, TestBase)\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof MyClass.Config) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// @ts-expect-error — external `new` on a class with protected constructor is a compile error\n\t\t\tvoid (() => new MyClass({ host: 'localhost', port: 3000 }))\n\t\t})\n\n\t\ttest('static Config resolves to PipeOutput<P> at the type level', () => {\n\t\t\tconst Wrapped = configurable(testPipe, TestBase)\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof MyClass.Config) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\texpectTypeOf<typeof MyClass.Config>().toEqualTypeOf<TestConfig>()\n\t\t\texpect(MyClass.create).toBeTypeOf('function')\n\t\t})\n\n\t\ttest('ConstructorParameters<This>-based extras inference works for non-zero-arg leaf signatures', () => {\n\t\t\tconst Wrapped = configurable(testPipe, TestBase)\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\textra: number\n\t\t\t\tprotected constructor(config: typeof MyClass.Config, extra: number) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t\tthis.extra = extra\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst instance = MyClass.create({ host: 'localhost', port: 3000 }, 42)\n\n\t\t\texpect(instance.extra).toBe(42)\n\t\t\texpectTypeOf(instance).toHaveProperty('extra')\n\t\t\texpectTypeOf(instance.extra).toEqualTypeOf<number>()\n\n\t\t\t// @ts-expect-error — wrong extra type\n\t\t\tvoid (() => MyClass.create({ host: 'localhost', port: 3000 }, 'not-a-number'))\n\t\t})\n\n\t\ttest('base-args forwarding works for non-zero-arg bases', () => {\n\t\t\tconst Wrapped = configurable(testPipe, TestBaseWithArgs)\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof MyClass.Config, label: string) {\n\t\t\t\t\tsuper(config, label)\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst instance = MyClass.create({ host: 'localhost', port: 3000 }, 'test-label')\n\n\t\t\texpect(instance.label).toBe('test-label')\n\t\t})\n\n\t\ttest('config is accessible as protected readonly on instances', () => {\n\t\t\tconst Wrapped = configurable(testPipe, TestBase)\n\t\t\tclass MyClass extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof MyClass.Config) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t}\n\n\t\t\t\tgetHost() {\n\t\t\t\t\treturn this.config.host\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst instance = MyClass.create({ host: 'localhost', port: 3000 })\n\t\t\texpect(instance.getHost()).toBe('localhost')\n\t\t})\n\n\t\ttest('accepts an abstract base class', () => {\n\t\t\tabstract class AbstractBase {\n\t\t\t\tabstract greet(): string\n\t\t\t}\n\n\t\t\tconst Wrapped = configurable(testPipe, AbstractBase)\n\t\t\tclass Concrete extends Wrapped {\n\t\t\t\tprotected constructor(config: typeof Concrete.Config) {\n\t\t\t\t\tsuper(config)\n\t\t\t\t}\n\t\t\t\tgreet() {\n\t\t\t\t\treturn `hello from ${this.config.host}`\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst instance = Concrete.create({ host: 'localhost', port: 3000 })\n\t\t\texpect(instance.greet()).toBe('hello from localhost')\n\t\t\texpectTypeOf(instance).toHaveProperty('config')\n\t\t})\n\t})\n}\n","import type { Pipe } from 'valleyed'\n\nimport { EquippedError } from '../errors'\nimport { Instance, type ClassRef } from '../instance'\nimport type { AggregateOpName, FieldTypeName, FilterOpName, UpdateOpName } from './adapter'\nimport type { OrmUse } from './adapters/base'\nimport { FilterGroup } from './filter'\nimport type { DiscoveredSchema } from './migrations/introspection-types'\nimport type { AddFieldChange, AddForeignKeyChange, AddIndexChange, CreateTableChange, DropFieldChange, DropForeignKeyChange, DropIndexChange, DropTableChange, ModifyFieldChange, RenameFieldChange, RenameTableChange } from './migrations/types'\nimport type { IterationQueryOptions, QueryOptions } from './query-options'\nimport type { AnySchema } from './schema'\nimport type { AnyUpdateOp } from './updates'\n\nexport type AggregateSpec = {\n\twhere?: FilterGroup\n\taggregates: ReadonlyArray<{\n\t\tfn: AggregateOpName\n\t\tfield?: string\n\t\talias: string\n\t}>\n\tgroupBy: readonly string[]\n\thaving?: FilterGroup\n}\n\nexport abstract class OrmAdapter {\n\treadonly queryableOps: readonly FilterOpName[] = []\n\treadonly updateOps: readonly UpdateOpName[] = []\n\treadonly aggregateOps: readonly AggregateOpName[] = []\n\treadonly supportedFieldTypes: readonly FieldTypeName[] = []\n\n\tabstract readonly schemaConfigPipe: Pipe<any, any>\n\n\tconnect?(): Promise<void>\n\tdisconnect?(): Promise<void>\n\tfindByPk?(schema: AnySchema, config: unknown, pk: unknown): Promise<Record<string, unknown> | null>\n\tcreateMany?(schema: AnySchema, config: unknown, data: Record<string, unknown>[]): Promise<Record<string, unknown>[]>\n\tupdateByPk?(schema: AnySchema, config: unknown, pk: unknown, ops: AnyUpdateOp[]): Promise<Record<string, unknown> | null>\n\tdeleteByPk?(schema: AnySchema, config: unknown, pk: unknown): Promise<Record<string, unknown> | null>\n\traw?(schema: AnySchema, config: unknown, ...args: any[]): Promise<any>\n\tfindMany?(schema: AnySchema, config: unknown, filter: FilterGroup, options?: QueryOptions): Promise<Record<string, unknown>[]>\n\tcount?(schema: AnySchema, config: unknown, filter: FilterGroup): Promise<number>\n\titerateMany?(schema: AnySchema, config: unknown, filter: FilterGroup, options?: IterationQueryOptions): AsyncGenerator<Record<string, unknown>, void, void>\n\tupdateMany?(schema: AnySchema, config: unknown, filter: FilterGroup, data: Record<string, unknown>): Promise<Record<string, unknown>[]>\n\tdeleteMany?(schema: AnySchema, config: unknown, filter: FilterGroup): Promise<Record<string, unknown>[]>\n\tupsertOne?(\n\t\tschema: AnySchema,\n\t\tconfig: unknown,\n\t\tfilter: FilterGroup,\n\t\tcreate: Record<string, unknown>,\n\t\tops: AnyUpdateOp[],\n\t): Promise<Record<string, unknown>>\n\taggregate?(schema: AnySchema, config: unknown, spec: AggregateSpec): Promise<Array<Record<string, unknown>>>\n\tsession?<T>(fn: () => Promise<T>): Promise<T>\n\n\tloadMigrations?(): Promise<{ id: string; appliedAt: number }[]>\n\trecordMigration?(id: string, appliedAt: number): Promise<void>\n\tacquireMigrationLock?<T>(fn: () => Promise<T>): Promise<T>\n\tapplyCreateTable?(change: CreateTableChange<any>): Promise<void>\n\tapplyDropTable?(change: DropTableChange): Promise<void>\n\tapplyAddField?(change: AddFieldChange<any>): Promise<void>\n\tapplyDropField?(change: DropFieldChange): Promise<void>\n\tapplyModifyField?(change: ModifyFieldChange<any>): Promise<void>\n\tapplyRenameTable?(change: RenameTableChange): Promise<void>\n\tapplyRenameField?(change: RenameFieldChange): Promise<void>\n\tapplyAddIndex?(change: AddIndexChange): Promise<void>\n\tapplyDropIndex?(change: DropIndexChange): Promise<void>\n\tapplyAddForeignKey?(change: AddForeignKeyChange): Promise<void>\n\tapplyDropForeignKey?(change: DropForeignKeyChange): Promise<void>\n\tintrospect?(): Promise<DiscoveredSchema[]>\n\n\tprotected onFatalError(err: unknown): never {\n\t\tconst wrapped = err instanceof EquippedError ? err : new EquippedError('OrmAdapter fatal error', {}, err)\n\t\tInstance.crash(wrapped)\n\t}\n\n\tconstructor() {\n\t\tconst self = this as any\n\t\tif (typeof self.connect === 'function') {\n\t\t\tInstance.on('start', () => self.connect(), { class: this.constructor as ClassRef })\n\t\t}\n\t\tif (typeof self.disconnect === 'function') {\n\t\t\tInstance.on('close', () => self.disconnect(), { class: this.constructor as ClassRef })\n\t\t}\n\t}\n\n\tuse(schema: AnySchema, config: unknown): OrmUse {\n\t\tconst self = this as any\n\t\tconst emptyIterator = async function* (): AsyncGenerator<Record<string, unknown>, void, void> {}\n\t\tconst use: OrmUse = {\n\t\t\tfindMany: (filter, opts) => self.findMany?.(schema, config, filter, opts) ?? Promise.resolve([]),\n\t\t\titerateMany: (filter, opts) => self.iterateMany?.(schema, config, filter, opts) ?? emptyIterator(),\n\t\t\tfindOne: async (filter) => {\n\t\t\t\tconst rows = await use.findMany(filter, { limit: 1 })\n\t\t\t\treturn rows[0] ?? null\n\t\t\t},\n\t\t\tcount: (filter) => self.count?.(schema, config, filter) ?? Promise.reject(new Error('count not implemented')),\n\t\t\tcreateOne: async (d) => {\n\t\t\t\tconst rows = await use.createMany([d])\n\t\t\t\treturn rows[0]\n\t\t\t},\n\t\t\tcreateMany: (d) => self.createMany?.(schema, config, d) ?? Promise.resolve([]),\n\t\t\tupdateMany: (filter, d) => self.updateMany?.(schema, config, filter, d) ?? Promise.resolve([]),\n\t\t\tupdateOne: async (filter, d) => {\n\t\t\t\tconst match = await use.findOne(filter)\n\t\t\t\tif (!match) return null\n\t\t\t\tconst pk = schema.pkField.name\n\t\t\t\tconst pkFilter = FilterGroup.create().eq(pk, match[pk])\n\t\t\t\tconst rows = await use.updateMany(pkFilter, d)\n\t\t\t\treturn rows[0] ?? null\n\t\t\t},\n\t\t\tupsertOne: (filter, create, ops) =>\n\t\t\t\tself.upsertOne?.(schema, config, filter, create, ops) ?? Promise.reject(new Error('upsertOne not implemented')),\n\t\t\tdeleteOne: async (filter) => {\n\t\t\t\tconst row = await use.findOne(filter)\n\t\t\t\tif (!row) return null\n\t\t\t\tconst pk = schema.pkField.name\n\t\t\t\tif (self.deleteByPk) {\n\t\t\t\t\tawait self.deleteByPk(schema, config, row[pk])\n\t\t\t\t} else if (self.deleteMany) {\n\t\t\t\t\tconst pkFilter = FilterGroup.create().eq(pk, row[pk])\n\t\t\t\t\tawait self.deleteMany(schema, config, pkFilter)\n\t\t\t\t}\n\t\t\t\treturn row\n\t\t\t},\n\t\t\tdeleteMany: (filter) => self.deleteMany?.(schema, config, filter) ?? Promise.resolve([]),\n\t\t\traw: (...args: any[]) => self.raw?.(schema, config, ...args) ?? Promise.reject(new Error('raw not implemented')),\n\t\t\taggregate: (spec) => self.aggregate?.(schema, config, spec) ?? Promise.reject(new Error('aggregate not implemented')),\n\t\t\taggregateOps: self.aggregateOps ?? [],\n\t\t}\n\t\treturn use\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect, vi } = import.meta.vitest\n\tconst { v } = await import('valleyed')\n\n\tdescribe('OrmAdapter', () => {\n\t\ttest('subclass with connect/disconnect auto-registers Instance hooks', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tconst onSpy = vi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tclass TestAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\treadonly supportedFieldTypes = ['string'] as const\n\t\t\t\tasync connect() {}\n\t\t\t\tasync disconnect() {}\n\t\t\t}\n\n\t\t\tnew (TestAdapter as any)()\n\n\t\t\texpect(onSpy).toHaveBeenCalledWith('start', expect.any(Function), expect.objectContaining({ class: TestAdapter }))\n\t\t\texpect(onSpy).toHaveBeenCalledWith('close', expect.any(Function), expect.objectContaining({ class: TestAdapter }))\n\n\t\t\tonSpy.mockRestore()\n\t\t})\n\n\t\ttest('subclass without connect/disconnect does not register hooks', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tconst onSpy = vi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tclass MinimalAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t}\n\n\t\t\tnew (MinimalAdapter as any)()\n\t\t\texpect(onSpy).not.toHaveBeenCalled()\n\n\t\t\tonSpy.mockRestore()\n\t\t})\n\n\t\ttest('capability declarations default to empty arrays', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tclass DefaultAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t}\n\t\t\tconst adapter = new (DefaultAdapter as any)() as DefaultAdapter\n\t\t\texpect(adapter.queryableOps).toEqual([])\n\t\t\texpect(adapter.updateOps).toEqual([])\n\t\t\texpect(adapter.aggregateOps).toEqual([])\n\t\t\texpect(adapter.supportedFieldTypes).toEqual([])\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('onFatalError wraps non-EquippedError and calls Instance.crash', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\t\t\tconst crashSpy = vi.spyOn(Inst, 'crash').mockImplementation((() => {\n\t\t\t\tthrow new Error('crash')\n\t\t\t}) as any)\n\n\t\t\tclass FatalAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\ttriggerFatal() {\n\t\t\t\t\tthis.onFatalError(new Error('something broke'))\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst adapter = new (FatalAdapter as any)() as FatalAdapter\n\t\t\texpect(() => adapter.triggerFatal()).toThrow('crash')\n\t\t\texpect(crashSpy).toHaveBeenCalled()\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('onFatalError passes through EquippedError directly', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\t\t\tlet crashedWith: unknown\n\t\t\tvi.spyOn(Inst, 'crash').mockImplementation(((err: any) => {\n\t\t\t\tcrashedWith = err\n\t\t\t\tthrow err\n\t\t\t}) as any)\n\n\t\t\tclass FatalAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\ttriggerFatal() {\n\t\t\t\t\tthis.onFatalError(new EquippedError('equipped error', { detail: 'test' }))\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst adapter = new (FatalAdapter as any)() as FatalAdapter\n\t\t\texpect(() => adapter.triggerFatal()).toThrow()\n\t\t\texpect(crashedWith).toBeInstanceOf(EquippedError)\n\t\t\texpect((crashedWith as EquippedError).message).toBe('equipped error')\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('use() creates OrmUse bridge that delegates to flat methods', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tconst { Schema } = await import('./schema')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tclass BridgeAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\treadonly supportedFieldTypes = ['string'] as const\n\t\t\t\treadonly queryableOps = ['eq'] as const\n\n\t\t\t\tasync findMany(_s: AnySchema, _c: unknown, _f: any, _o?: any) {\n\t\t\t\t\treturn [{ id: 'found' }]\n\t\t\t\t}\n\t\t\t\tasync count(_s: AnySchema, _c: unknown, _f: any) {\n\t\t\t\t\treturn 1\n\t\t\t\t}\n\t\t\t\tasync *iterateMany(_s: AnySchema, _c: unknown, _f: any, _o?: any) {\n\t\t\t\t\tyield { id: 'iterated' }\n\t\t\t\t}\n\t\t\t\tasync createMany(_s: AnySchema, _c: unknown, data: Record<string, unknown>[]) {\n\t\t\t\t\treturn data\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst TestSchema = Schema.from('bridge_test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = new (BridgeAdapter as any)() as BridgeAdapter\n\t\t\tconst ormUse = adapter.use(TestSchema, { table: 'bridge_test' })\n\n\t\t\tconst rows = await ormUse.findMany(FilterGroup.create())\n\t\t\texpect(rows).toEqual([{ id: 'found' }])\n\t\t\tawait expect(ormUse.count(FilterGroup.create())).resolves.toBe(1)\n\n\t\t\tconst iterated: Record<string, unknown>[] = []\n\t\t\tfor await (const row of ormUse.iterateMany(FilterGroup.create())) iterated.push(row)\n\t\t\texpect(iterated).toEqual([{ id: 'iterated' }])\n\n\t\t\tconst created = await ormUse.createOne({ id: 'new' })\n\t\t\texpect(created).toEqual({ id: 'new' })\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('use() bridge delegates updateMany to flat method', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tconst { Schema } = await import('./schema')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tclass UpdateAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\treadonly supportedFieldTypes = ['string', 'number'] as const\n\t\t\t\treadonly updateOps = ['set'] as const\n\n\t\t\t\tasync findMany(_s: AnySchema, _c: unknown, _f: any) {\n\t\t\t\t\treturn [{ id: 'u1', name: 'old' }]\n\t\t\t\t}\n\t\t\t\tasync updateMany(_s: AnySchema, _c: unknown, _f: any, data: Record<string, unknown>) {\n\t\t\t\t\treturn [{ id: 'u1', ...data }]\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst TestSchema = Schema.from('upd_test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.field('name', v.string())\n\t\t\t\t.build()\n\t\t\tconst adapter = new (UpdateAdapter as any)() as UpdateAdapter\n\t\t\tconst ormUse = adapter.use(TestSchema, { table: 'upd_test' })\n\n\t\t\tconst updated = await ormUse.updateOne(FilterGroup.create().eq('id', 'u1'), { name: 'new' })\n\t\t\texpect(updated).not.toBeNull()\n\t\t\texpect(updated!.name).toBe('new')\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('use().iterateMany does not fall back to findMany when adapter omits iterateMany', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tconst { Schema } = await import('./schema')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tlet findManyCalls = 0\n\t\t\tclass FindOnlyAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\treadonly supportedFieldTypes = ['string'] as const\n\t\t\t\tasync findMany() {\n\t\t\t\t\tfindManyCalls += 1\n\t\t\t\t\treturn [{ id: 'found' }]\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst TestSchema = Schema.from('iter_no_fallback')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = new (FindOnlyAdapter as any)() as FindOnlyAdapter\n\t\t\tconst rows: Record<string, unknown>[] = []\n\t\t\tfor await (const row of adapter.use(TestSchema, { table: 'iter_no_fallback' }).iterateMany(FilterGroup.create())) rows.push(row)\n\n\t\t\texpect(rows).toEqual([])\n\t\t\texpect(findManyCalls).toBe(0)\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('use() bridge delegates deleteByPk via deleteOne', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tconst { Schema } = await import('./schema')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tlet deletedPk: unknown = null\n\t\t\tclass DeleteAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\treadonly supportedFieldTypes = ['string'] as const\n\n\t\t\t\tasync findMany(_s: AnySchema, _c: unknown, _f: any) {\n\t\t\t\t\treturn [{ id: 'd1' }]\n\t\t\t\t}\n\t\t\t\tasync deleteByPk(_s: AnySchema, _c: unknown, pk: unknown) {\n\t\t\t\t\tdeletedPk = pk\n\t\t\t\t\treturn { id: String(pk) }\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst TestSchema = Schema.from('del_test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = new (DeleteAdapter as any)() as DeleteAdapter\n\t\t\tconst ormUse = adapter.use(TestSchema, { table: 'del_test' })\n\n\t\t\tconst deleted = await ormUse.deleteOne(FilterGroup.create().eq('id', 'd1'))\n\t\t\texpect(deleted).toEqual({ id: 'd1' })\n\t\t\texpect(deletedPk).toBe('d1')\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('use() bridge delegates session to flat method', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tlet sessionRan = false\n\t\t\tclass SessionAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\tasync session<T>(fn: () => Promise<T>): Promise<T> {\n\t\t\t\t\tsessionRan = true\n\t\t\t\t\treturn fn()\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst adapter = new (SessionAdapter as any)() as SessionAdapter\n\t\t\tconst result = await adapter.session!(async () => 42)\n\t\t\texpect(result).toBe(42)\n\t\t\texpect(sessionRan).toBe(true)\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\n\t\ttest('type-level: subclass method override enforces canonical signature', async () => {\n\t\t\tconst { Instance: Inst } = await import('../instance')\n\t\t\tvi.spyOn(Inst, 'on').mockImplementation(() => {})\n\n\t\t\tclass CorrectAdapter extends OrmAdapter {\n\t\t\t\treadonly schemaConfigPipe = v.object({ table: v.string() })\n\t\t\t\tasync findByPk(_s: AnySchema, _c: unknown, _pk: unknown) {\n\t\t\t\t\treturn null\n\t\t\t\t}\n\t\t\t\tasync createMany(_s: AnySchema, _c: unknown, _d: Record<string, unknown>[]) {\n\t\t\t\t\treturn []\n\t\t\t\t}\n\t\t\t\tasync raw(_s: AnySchema, _c: unknown, ..._args: any[]) {\n\t\t\t\t\treturn null\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst adapter = new (CorrectAdapter as any)() as CorrectAdapter\n\t\t\texpect(adapter.findByPk).toBeTypeOf('function')\n\t\t\texpect(adapter.createMany).toBeTypeOf('function')\n\t\t\texpect(adapter.raw).toBeTypeOf('function')\n\n\t\t\tvi.restoreAllMocks()\n\t\t})\n\t})\n}\n"],"mappings":"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","names":["mongodb_exports","__export","MongoDbAdapter","__toCommonJS","import_node_async_hooks","import_mongodb","import_valleyed","EquippedError","message","context","cause","import_pino","import_ulid","import_valleyed","registerHook","hooks","record","dep","h","depName","ownerName","tentative","detectCycle","classToAfter","existing","visited","stack","visit","cls","path","cycleStart","names","c","resolveHookDAG","invert","classToHooks","anonymous","list","classes","inDegree","graph","from","to","edges","layers","queue","layer","next","neighbor","d","anonWithDeps","anonWithoutDeps","maxLayer","depLayer","l","r","insertAt","runHooks","onError","error","import_valleyed","instanceSettingsPipe","Instance","_Instance","#id","#instance","#hooks","settings","pino","#registerOnExitHandler","id","EquippedError","name","key","runHooks","error","envsPipe","envValidity","settingsValidity","instanceSettingsPipe","event","cb","options","record","registerHook","signal","code","value","opts","import_valleyed","Field","name","path","toFieldName","field","Filter","field","op","value","toFieldName","FilterGroup","_FilterGroup","children","#withChild","child","facFns","EquippedError","group","fn","c","SetOp","values","IncOp","field","value","MulOp","MinOp","MaxOp","UnsetOp","PushOp","PullOp","PatchOp","flattenOps","ops","data","op","SetOp","compileMongoFilter","group","primaryKey","clauses","child","compiled","compileChild","compileMongoQuery","options","mongoFilter","orderBys","sort","o","mapField","selects","projection","f","field","compileFilter","Filter","FilterGroup","compileGroup","c","compileMongoUpdate","data","$set","$inc","$mul","$min","$max","$unset","$push","$pull","key","value","IncOp","MulOp","MinOp","MaxOp","UnsetOp","PushOp","PullOp","PatchOp","patchVal","subKey","subVal","result","compileMongoOps","ops","flattenOps","compileMongoAggregate","spec","pipeline","match","groupId","accumulators","agg","fieldRef","project","havingMatch","import_valleyed","configurable","pipeFn","base","pipe","Configurable","config","baseArgs","input","args","r","OrmAdapter","err","wrapped","EquippedError","Instance","self","schema","config","emptyIterator","use","filter","opts","d","match","pk","pkFilter","FilterGroup","create","ops","row","args","spec","mongoSchemaConfigPipe","mongoConnectionPipe","MIGRATION_TRACKER_COLLECTION","MongoDbAdapter","configurable","OrmAdapter","#sessionStore","config","options","#getCollection","schemaCfg","error","EquippedError","schema","pk","pkName","_schema","data","collection","docs","d","ops","update","compileMongoOps","pipeline","spec","compileMongoAggregate","filter","mongoFilter","sort","limit","skip","projection","compileMongoQuery","cursor","compileMongoFilter","row","session","ids","idFilter","compileMongoUpdate","create","updateDoc","fn","id","appliedAt","change","db","fields","f","name","collections","col","idx","schemas","indexes"]}