{"version":3,"sources":["../../../../../src/errors/equippedError.ts","../../../../../src/errors/requestError.ts","../../../../../src/instance/hooks.ts","../../../../../src/instance/settings.ts","../../../../../src/instance/index.ts","../../../../../src/errors/types/badRequestError.ts","../../../../../src/errors/types/notAuthenticatedError.ts","../../../../../src/errors/types/notAuthorizedError.ts","../../../../../src/errors/types/notFoundError.ts","../../../../../src/errors/types/preconditionRequiredError.ts","../../../../../src/errors/types/tokenExpired.ts","../../../../../src/errors/types/validationError.ts","../../../../../src/errors/index.ts","../../../../../src/orm/errors/introspection.ts","../../../../../src/orm/adapters/postgresql/index.ts","../../../../../src/orm/filter.ts","../../../../../src/orm/fields.ts","../../../../../src/orm/errors/validation.ts","../../../../../src/orm/updates.ts","../../../../../src/orm/adapters/postgresql/query.ts","../../../../../src/utilities/configurable.ts","../../../../../src/orm/orm-adapter.ts"],"sourcesContent":["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 type { StatusCodesEnum } from '../server'\nimport { EquippedError } from './equippedError'\n\nexport abstract class RequestError extends EquippedError {\n\tabstract readonly statusCode: StatusCodesEnum\n\n\tprotected constructor(\n\t\tpublic readonly message: string,\n\t\tpublic readonly serializedErrors: { message: string; field?: string }[],\n\t\tcause?: unknown,\n\t) {\n\t\tsuper(message, { serializedErrors }, cause)\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 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","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\nexport class BadRequestError extends RequestError {\n\tstatusCode = StatusCodes.BadRequest\n\n\tconstructor(message: string, cause?: unknown) {\n\t\tsuper(message, [{ message }], cause)\n\t}\n}\n","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\nexport class NotAuthenticatedError extends RequestError {\n\tstatusCode = StatusCodes.NotAuthenticated\n\n\tconstructor(message = 'Not authenticated', cause?: unknown) {\n\t\tsuper(message, [{ message }], cause)\n\t}\n}\n","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\nexport class NotAuthorizedError extends RequestError {\n\tstatusCode = StatusCodes.NotAuthorized\n\n\tconstructor(message = 'Not authorized', cause?: unknown) {\n\t\tsuper(message, [{ message }], cause)\n\t}\n}\n","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\nexport class NotFoundError extends RequestError {\n\tstatusCode = StatusCodes.NotFound\n\n\tconstructor(message = 'Not found', cause?: unknown) {\n\t\tsuper(message, [{ message }], cause)\n\t}\n}\n","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\nexport class PreconditionRequiredError extends RequestError {\n\tstatusCode = StatusCodes.PreconditionRequired\n\n\tconstructor(message = 'Precondition required', cause?: unknown) {\n\t\tsuper(message, [{ message }], cause)\n\t}\n}\n","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\nexport class TokenExpired extends RequestError {\n\tstatusCode = StatusCodes.TokenExpired\n\n\tconstructor(message = 'Token expired', cause?: unknown) {\n\t\tsuper(message, [{ message }], cause)\n\t}\n}\n","import { StatusCodes } from '../../server'\nimport { RequestError } from '../requestError'\n\ntype ValidError = {\n\tmessages: string[]\n\tfield: string\n}\n\nexport class ValidationError extends RequestError {\n\tstatusCode = StatusCodes.ValidationError\n\n\tconstructor(errors: ValidError[], cause?: unknown) {\n\t\tsuper(\n\t\t\t'Unprocessable Entity',\n\t\t\terrors.flatMap(({ field, messages }) => messages.map((message) => ({ message, field }))),\n\t\t\tcause,\n\t\t)\n\t}\n}\n","export * from './equippedError'\nexport * from './requestError'\nexport * from './types/badRequestError'\nexport * from './types/notAuthenticatedError'\nexport * from './types/notAuthorizedError'\nexport * from './types/notFoundError'\nexport * from './types/preconditionRequiredError'\nexport * from './types/tokenExpired'\nexport * from './types/validationError'\n","import { EquippedError } from '../../errors'\n\nexport class OrmIntrospectionError extends EquippedError {\n\treadonly adapter: string\n\treadonly table: string\n\n\tconstructor(opts: { adapter: string; table: string; cause: unknown }) {\n\t\tsuper(`Introspection failed for table '${opts.table}' on adapter '${opts.adapter}'`, { adapter: opts.adapter, table: opts.table }, opts.cause)\n\t\tthis.adapter = opts.adapter\n\t\tthis.table = opts.table\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect } = import.meta.vitest\n\tconst { EquippedError } = await import('../../errors')\n\n\tdescribe('OrmIntrospectionError', () => {\n\t\ttest('stores adapter, table, and cause on the instance', () => {\n\t\t\tconst cause = new Error('unknown column type')\n\t\t\tconst err = new OrmIntrospectionError({ adapter: 'postgres', table: 'users', cause })\n\t\t\texpect(err.adapter).toBe('postgres')\n\t\t\texpect(err.table).toBe('users')\n\t\t\texpect(err.cause).toBe(cause)\n\t\t})\n\n\t\ttest('message includes adapter and table', () => {\n\t\t\tconst err = new OrmIntrospectionError({ adapter: 'pg', table: 'posts', cause: 'bad type' })\n\t\t\texpect(err.message).toBe(\"Introspection failed for table 'posts' on adapter 'pg'\")\n\t\t})\n\n\t\ttest('instanceof EquippedError is true', () => {\n\t\t\tconst err = new OrmIntrospectionError({ adapter: 'x', table: 'y', cause: null })\n\t\t\texpect(err).toBeInstanceOf(OrmIntrospectionError)\n\t\t\texpect(err).toBeInstanceOf(EquippedError)\n\t\t})\n\n\t\ttest('context carries adapter and table', () => {\n\t\t\tconst err = new OrmIntrospectionError({ adapter: 'mem', table: 'items', cause: 'fail' })\n\t\t\texpect((err.context as any).adapter).toBe('mem')\n\t\t\texpect((err.context as any).table).toBe('items')\n\t\t})\n\n\t\ttest('discriminates from sibling error classes', async () => {\n\t\t\tconst { OrmMigrationError } = await import('./migration')\n\t\t\tconst { OrmValidationError } = await import('./validation')\n\t\t\tconst err = new OrmIntrospectionError({ adapter: 'x', table: 'y', cause: null })\n\t\t\texpect(err).not.toBeInstanceOf(OrmMigrationError)\n\t\t\texpect(err).not.toBeInstanceOf(OrmValidationError)\n\t\t})\n\t})\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { Pool, type PoolClient } from 'pg'\nimport Cursor from 'pg-cursor'\nimport { v } from 'valleyed'\n\nimport {\n\tbuildAggregateQuery,\n\tbuildCountQuery,\n\tbuildCreateQuery,\n\tbuildDeleteQuery,\n\tbuildPkUpdateQuery,\n\tbuildSelectQuery,\n\tbuildUpdateQuery,\n\tbuildUpsertQuery,\n\textractUpsertConflictColumn,\n} from './query'\nimport { EquippedError } from '../../../errors'\nimport { configurable } from '../../../utilities'\nimport type { FieldTypeName } from '../../adapter'\nimport type { FilterGroup } from '../../filter'\nimport type { DiscoveredSchema, ForeignKeyAction } from '../../migrations/introspection-types'\nimport type {\n\tAddFieldChange,\n\tAddForeignKeyChange,\n\tAddIndexChange,\n\tCreateTableChange,\n\tDropFieldChange,\n\tDropForeignKeyChange,\n\tDropIndexChange,\n\tDropTableChange,\n\tModifyFieldChange,\n\tRenameFieldChange,\n\tRenameTableChange,\n} from '../../migrations/types'\nimport { OrmAdapter, type AggregateSpec } from '../../orm-adapter'\nimport type { IterationQueryOptions, QueryOptions } from '../../query-options'\nimport type { AnySchema } from '../../schema'\nimport { flattenOps, type AnyUpdateOp } from '../../updates'\n\nexport type PostgresqlRepoConfig = {\n\tschema?: string\n\ttable: string\n}\n\nexport type PostgresqlConnectionConfig = {\n\thost: string\n\tport: number\n\tusername: string\n\tpassword: string\n\tdatabase: string\n\tssl?: boolean\n}\n\nconst postgresqlConnectionPipe = () =>\n\tv.object({\n\t\thost: v.string(),\n\t\tport: v.number(),\n\t\tusername: v.string(),\n\t\tpassword: v.string(),\n\t\tdatabase: v.string(),\n\t\tssl: v.defaults(v.boolean(), false),\n\t})\n\nconst TRACKER_TABLE = 'equipped_migrations'\nconst ADVISORY_LOCK_KEY = 3_735_928_559\nconst DEFAULT_CURSOR_BATCH_SIZE = 1000\n\ntype PostgresCursor<T extends Record<string, unknown>> = {\n\tread: (rowCount: number) => Promise<T[]>\n\tclose: () => Promise<void>\n}\n\nconst FIELD_TYPE_TO_PG: Record<string, string> = {\n\tstring: 'text',\n\tnumber: 'double precision',\n\tboolean: 'boolean',\n\tdate: 'timestamptz',\n\tnull: 'text',\n\tobject: 'jsonb',\n\tarray: 'jsonb',\n}\n\nconst PG_TO_FIELD_TYPE: Record<string, FieldTypeName> = {\n\ttext: 'string',\n\t'character varying': 'string',\n\tvarchar: 'string',\n\tchar: 'string',\n\tcharacter: 'string',\n\t'double precision': 'number',\n\treal: 'number',\n\tinteger: 'number',\n\tsmallint: 'number',\n\tnumeric: 'number',\n\tdecimal: 'number',\n\tboolean: 'boolean',\n\t'timestamp with time zone': 'date',\n\t'timestamp without time zone': 'date',\n\ttimestamptz: 'date',\n\ttimestamp: 'date',\n\tdate: 'date',\n\tjsonb: 'object',\n\tjson: 'object',\n}\n\nexport class PostgresAdapter extends configurable(postgresqlConnectionPipe, OrmAdapter) {\n\treadonly schemaConfigPipe = v.object({\n\t\tschema: v.optional(v.string()),\n\t\ttable: v.string(),\n\t})\n\n\treadonly supportedFieldTypes = ['string', 'number', 'boolean', 'null', 'object', 'array', 'date'] as const\n\treadonly queryableOps = [\n\t\t'eq',\n\t\t'ne',\n\t\t'gt',\n\t\t'gte',\n\t\t'lt',\n\t\t'lte',\n\t\t'in',\n\t\t'notIn',\n\t\t'like',\n\t\t'exists',\n\t\t'notExists',\n\t\t'contains',\n\t\t'notContains',\n\t] 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\n\treadonly pool: Pool\n\t#sessionStore = new AsyncLocalStorage<PoolClient | undefined>()\n\n\tprotected constructor(config: typeof PostgresAdapter.Config) {\n\t\tsuper(config)\n\t\tthis.pool = new Pool({\n\t\t\thost: config.host,\n\t\t\tport: config.port,\n\t\t\tuser: config.username,\n\t\t\tpassword: config.password,\n\t\t\tdatabase: config.database,\n\t\t\tssl: config.ssl ? { rejectUnauthorized: false } : false,\n\t\t})\n\t}\n\n\t#getClient() {\n\t\treturn this.#sessionStore.getStore() ?? this.pool\n\t}\n\n\t#resolveTableName(config: PostgresqlRepoConfig) {\n\t\treturn config.schema && config.schema !== 'public' ? `${config.schema}.${config.table}` : config.table\n\t}\n\n\tasync connect() {}\n\n\tasync disconnect() {\n\t\ttry {\n\t\t\tawait this.pool.end()\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('Failed to disconnect PostgreSQL pool', { adapter: 'postgresql' }, error)\n\t\t}\n\t}\n\n\tasync findByPk(schema: AnySchema, config: unknown, pk: unknown) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst pkName = schema.pkField.name\n\t\t\tconst result = await this.#getClient().query(`SELECT * FROM \"${tableName}\" WHERE \"${pkName}\" = $1`, [pk])\n\t\t\treturn result.rows[0] ?? null\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('PostgreSQL findByPk failed', { adapter: 'postgresql', operation: 'findByPk', table: c.table }, error)\n\t\t}\n\t}\n\n\tasync createMany(_schema: AnySchema, config: unknown, data: Record<string, unknown>[]) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst client = this.#getClient()\n\t\t\tconst results: Record<string, unknown>[] = []\n\t\t\tfor (const doc of data) {\n\t\t\t\tconst { sql, params } = buildCreateQuery(tableName, doc)\n\t\t\t\tconst result = await client.query(sql, params)\n\t\t\t\tresults.push(result.rows[0])\n\t\t\t}\n\t\t\treturn results\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'PostgreSQL createMany failed',\n\t\t\t\t{ adapter: 'postgresql', operation: 'createMany', table: c.table },\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 c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst pkName = schema.pkField.name\n\t\t\tconst data = flattenOps(ops)\n\t\t\tif (Object.keys(data).length === 0) {\n\t\t\t\tconst result = await this.#getClient().query(`SELECT * FROM \"${tableName}\" WHERE \"${pkName}\" = $1`, [pk])\n\t\t\t\treturn result.rows[0] ?? null\n\t\t\t}\n\t\t\tconst { sql, params } = buildPkUpdateQuery(tableName, pkName, pk, data)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn result.rows[0] ?? null\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'PostgreSQL updateByPk failed',\n\t\t\t\t{ adapter: 'postgresql', operation: 'updateByPk', table: c.table },\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 c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst pkName = schema.pkField.name\n\t\t\tconst result = await this.#getClient().query(`DELETE FROM \"${tableName}\" WHERE \"${pkName}\" = $1 RETURNING *`, [pk])\n\t\t\treturn result.rows[0] ?? null\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'PostgreSQL deleteByPk failed',\n\t\t\t\t{ adapter: 'postgresql', operation: 'deleteByPk', table: c.table },\n\t\t\t\terror,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync raw(_schema: AnySchema, config: unknown, command: string, params: unknown[] = []) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst result = await this.#getClient().query(command, params)\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('PostgreSQL raw failed', { adapter: 'postgresql', operation: 'raw', table: c.table }, error)\n\t\t}\n\t}\n\n\tasync findMany(schema: AnySchema, config: unknown, filter: FilterGroup, options?: QueryOptions) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst { sql, params } = buildSelectQuery(filter, options, tableName, schema.pkField.name)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn result.rows\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('PostgreSQL findMany failed', { adapter: 'postgresql', operation: 'findMany', table: c.table }, error)\n\t\t}\n\t}\n\n\tasync count(schema: AnySchema, config: unknown, filter: FilterGroup) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst { sql, params } = buildCountQuery(filter, tableName, schema.pkField.name)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn Number(result.rows[0]?.count ?? 0)\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('PostgreSQL count failed', { adapter: 'postgresql', operation: 'count', table: c.table }, error)\n\t\t}\n\t}\n\n\tasync *iterateMany(schema: AnySchema, config: unknown, filter: FilterGroup, options?: IterationQueryOptions) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\tlet client: PoolClient | undefined\n\t\tlet releaseClient = false\n\t\tlet cursor: PostgresCursor<Record<string, unknown>> | undefined\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst { sql, params } = buildSelectQuery(filter, options, tableName, schema.pkField.name)\n\t\t\tconst sessionClient = this.#sessionStore.getStore()\n\t\t\tif (sessionClient) {\n\t\t\t\tclient = sessionClient\n\t\t\t} else {\n\t\t\t\tclient = await this.pool.connect()\n\t\t\t\treleaseClient = true\n\t\t\t}\n\t\t\tcursor = client.query(new Cursor<Record<string, unknown>>(sql, params) as any) as PostgresCursor<Record<string, unknown>>\n\t\t\tconst batchSize = options?.batchSize ?? DEFAULT_CURSOR_BATCH_SIZE\n\n\t\t\twhile (true) {\n\t\t\t\tconst rows = await cursor.read(batchSize)\n\t\t\t\tif (rows.length === 0) break\n\t\t\t\tfor (const row of rows) yield row\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError('PostgreSQL iterateMany failed', { adapter: 'postgresql', operation: 'iterateMany', table: c.table }, error)\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tawait cursor?.close()\n\t\t\t} finally {\n\t\t\t\tif (releaseClient) client?.release()\n\t\t\t}\n\t\t}\n\t}\n\n\tasync updateMany(schema: AnySchema, config: unknown, filter: FilterGroup, data: Record<string, unknown>) {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst { sql, params } = buildUpdateQuery(filter, tableName, schema.pkField.name, data)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn result.rows\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'PostgreSQL updateMany failed',\n\t\t\t\t{ adapter: 'postgresql', operation: 'updateMany', table: c.table },\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 c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst { sql, params } = buildDeleteQuery(filter, tableName, schema.pkField.name)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn result.rows\n\t\t} catch (error) {\n\t\t\tthrow new EquippedError(\n\t\t\t\t'PostgreSQL deleteMany failed',\n\t\t\t\t{ adapter: 'postgresql', operation: 'deleteMany', table: c.table },\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 c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst conflictColumn = extractUpsertConflictColumn(filter, schema.name)\n\t\t\tconst data = ops.length > 0 ? flattenOps(ops) : {}\n\t\t\tconst { sql, params } = buildUpsertQuery(tableName, conflictColumn, schema.pkField.name, create, data)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn result.rows[0]\n\t\t} catch (error) {\n\t\t\tif (error instanceof EquippedError) throw error\n\t\t\tthrow new EquippedError('PostgreSQL upsertOne failed', { adapter: 'postgresql', operation: 'upsertOne', table: c.table }, error)\n\t\t}\n\t}\n\n\tasync aggregate(schema: AnySchema, config: unknown, spec: AggregateSpec): Promise<Array<Record<string, unknown>>> {\n\t\tconst c = config as PostgresqlRepoConfig\n\t\ttry {\n\t\t\tconst tableName = this.#resolveTableName(c)\n\t\t\tconst { sql, params } = buildAggregateQuery(spec, tableName, schema.pkField.name)\n\t\t\tconst result = await this.#getClient().query(sql, params)\n\t\t\treturn result.rows.map((row: Record<string, unknown>) => {\n\t\t\t\tconst mapped: Record<string, unknown> = {}\n\t\t\t\tfor (const agg of spec.aggregates) {\n\t\t\t\t\tconst val = row[agg.alias]\n\t\t\t\t\tif (agg.fn === 'min' || agg.fn === 'max') {\n\t\t\t\t\t\tmapped[agg.alias] = val\n\t\t\t\t\t} else {\n\t\t\t\t\t\tmapped[agg.alias] = typeof val === 'string' ? Number(val) : Number(val ?? 0)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tfor (const field of spec.groupBy) {\n\t\t\t\t\tmapped[field] = row[field]\n\t\t\t\t}\n\t\t\t\treturn mapped\n\t\t\t})\n\t\t} catch (error) {\n\t\t\tif (error instanceof EquippedError) throw error\n\t\t\tthrow new EquippedError('PostgreSQL aggregate failed', { adapter: 'postgresql', operation: 'aggregate', table: c.table }, error)\n\t\t}\n\t}\n\n\tasync loadMigrations(): Promise<{ id: string; appliedAt: number }[]> {\n\t\tconst client = this.#getClient()\n\t\tawait client.query(`\n\t\t\tCREATE TABLE IF NOT EXISTS \"${TRACKER_TABLE}\" (\n\t\t\t\tid text PRIMARY KEY,\n\t\t\t\tapplied_at bigint NOT NULL\n\t\t\t)\n\t\t`)\n\t\tconst result = await client.query(`SELECT id, applied_at FROM \"${TRACKER_TABLE}\"`)\n\t\treturn result.rows.map((row: any) => ({ id: row.id, appliedAt: Number(row.applied_at) }))\n\t}\n\n\tasync recordMigration(id: string, appliedAt: number): Promise<void> {\n\t\tconst client = this.#getClient()\n\t\tawait client.query(`INSERT INTO \"${TRACKER_TABLE}\" (id, applied_at) VALUES ($1, $2)`, [id, appliedAt])\n\t}\n\n\tasync acquireMigrationLock<T>(fn: () => Promise<T>): Promise<T> {\n\t\tconst client = this.#getClient()\n\t\tawait client.query(`SELECT pg_advisory_lock($1)`, [ADVISORY_LOCK_KEY])\n\t\ttry {\n\t\t\treturn await fn()\n\t\t} finally {\n\t\t\tawait client.query(`SELECT pg_advisory_unlock($1)`, [ADVISORY_LOCK_KEY])\n\t\t}\n\t}\n\n\tasync applyCreateTable(change: CreateTableChange<any>): Promise<void> {\n\t\tconst pkType = FIELD_TYPE_TO_PG[change.pk.type] ?? 'text'\n\t\tconst cols = [`\"${change.pk.name}\" ${pkType} PRIMARY KEY`]\n\t\tfor (const f of change.fields) {\n\t\t\tcols.push(this.#renderColumnDef(f))\n\t\t}\n\t\tawait this.#getClient().query(`CREATE TABLE \"${change.name}\" (${cols.join(', ')})`)\n\t}\n\n\tasync applyDropTable(change: DropTableChange): Promise<void> {\n\t\tawait this.#getClient().query(`DROP TABLE \"${change.name}\"`)\n\t}\n\n\tasync applyAddField(change: AddFieldChange<any>): Promise<void> {\n\t\tconst colDef = this.#renderColumnDef(change.field)\n\t\tawait this.#getClient().query(`ALTER TABLE \"${change.table}\" ADD COLUMN ${colDef}`)\n\t}\n\n\tasync applyDropField(change: DropFieldChange): Promise<void> {\n\t\tawait this.#getClient().query(`ALTER TABLE \"${change.table}\" DROP COLUMN \"${change.name}\"`)\n\t}\n\n\tasync applyModifyField(change: ModifyFieldChange<any>): Promise<void> {\n\t\tconst client = this.#getClient()\n\t\tconst table = `\"${change.table}\"`\n\t\tconst col = `\"${change.name}\"`\n\t\tconst newType = FIELD_TYPE_TO_PG[change.to.type] ?? 'text'\n\t\tawait client.query(`ALTER TABLE ${table} ALTER COLUMN ${col} TYPE ${newType} USING ${col}::${newType}`)\n\t\tif (change.to.nullable) {\n\t\t\tawait client.query(`ALTER TABLE ${table} ALTER COLUMN ${col} DROP NOT NULL`)\n\t\t} else {\n\t\t\tawait client.query(`ALTER TABLE ${table} ALTER COLUMN ${col} SET NOT NULL`)\n\t\t}\n\t\tif (change.to.default !== undefined) {\n\t\t\tawait client.query(`ALTER TABLE ${table} ALTER COLUMN ${col} SET DEFAULT ${this.#renderDefault(change.to.default)}`)\n\t\t} else {\n\t\t\tawait client.query(`ALTER TABLE ${table} ALTER COLUMN ${col} DROP DEFAULT`)\n\t\t}\n\t\tif (change.to.name !== change.name) {\n\t\t\tawait client.query(`ALTER TABLE ${table} RENAME COLUMN ${col} TO \"${change.to.name}\"`)\n\t\t}\n\t}\n\n\tasync applyRenameTable(change: RenameTableChange): Promise<void> {\n\t\tawait this.#getClient().query(`ALTER TABLE \"${change.from}\" RENAME TO \"${change.to}\"`)\n\t}\n\n\tasync applyRenameField(change: RenameFieldChange): Promise<void> {\n\t\tawait this.#getClient().query(`ALTER TABLE \"${change.table}\" RENAME COLUMN \"${change.from}\" TO \"${change.to}\"`)\n\t}\n\n\tasync applyAddIndex(change: AddIndexChange): Promise<void> {\n\t\tconst name = change.name ?? this.#deriveIndexName(change.table, change.on as string[], change.unique)\n\t\tconst unique = change.unique ? 'UNIQUE ' : ''\n\t\tconst cols = (change.on as string[]).map((c) => `\"${c}\"`).join(', ')\n\t\tawait this.#getClient().query(`CREATE ${unique}INDEX \"${name}\" ON \"${change.table}\" (${cols})`)\n\t}\n\n\tasync applyDropIndex(change: DropIndexChange): Promise<void> {\n\t\tawait this.#getClient().query(`DROP INDEX \"${change.name}\"`)\n\t}\n\n\tasync applyAddForeignKey(change: AddForeignKeyChange): Promise<void> {\n\t\tconst name = change.name ?? `fk_${change.table}_${change.on}`\n\t\tlet sql = `ALTER TABLE \"${change.table}\" ADD CONSTRAINT \"${name}\" FOREIGN KEY (\"${change.on}\") REFERENCES \"${change.references.table}\" (\"${change.references.column}\")`\n\t\tif (change.onDelete) sql += ` ON DELETE ${this.#renderFkAction(change.onDelete)}`\n\t\tif (change.onUpdate) sql += ` ON UPDATE ${this.#renderFkAction(change.onUpdate)}`\n\t\tawait this.#getClient().query(sql)\n\t}\n\n\tasync applyDropForeignKey(change: DropForeignKeyChange): Promise<void> {\n\t\tawait this.#getClient().query(`ALTER TABLE \"${change.table}\" DROP CONSTRAINT \"${change.name}\"`)\n\t}\n\n\tasync introspect(): Promise<DiscoveredSchema[]> {\n\t\tconst { OrmIntrospectionError } = await import('../../errors/introspection')\n\t\tconst client = this.#getClient()\n\n\t\tconst tablesResult = await client.query(`\n\t\t\tSELECT table_name FROM information_schema.tables\n\t\t\tWHERE table_schema = 'public' AND table_type = 'BASE TABLE' AND table_name != $1\n\t\t`, [TRACKER_TABLE])\n\n\t\tconst schemas: DiscoveredSchema[] = []\n\n\t\tfor (const tableRow of tablesResult.rows) {\n\t\t\tconst tableName = tableRow.table_name\n\n\t\t\tconst colsResult = await client.query(`\n\t\t\t\tSELECT column_name, data_type, is_nullable, column_default\n\t\t\t\tFROM information_schema.columns\n\t\t\t\tWHERE table_schema = 'public' AND table_name = $1\n\t\t\t\tORDER BY ordinal_position\n\t\t\t`, [tableName])\n\n\t\t\tconst pkResult = await client.query(`\n\t\t\t\tSELECT kcu.column_name\n\t\t\t\tFROM information_schema.table_constraints tc\n\t\t\t\tJOIN information_schema.key_column_usage kcu\n\t\t\t\t\tON tc.constraint_name = kcu.constraint_name AND tc.table_schema = kcu.table_schema\n\t\t\t\tWHERE tc.table_schema = 'public' AND tc.table_name = $1 AND tc.constraint_type = 'PRIMARY KEY'\n\t\t\t`, [tableName])\n\n\t\t\tconst pkColName = pkResult.rows[0]?.column_name as string | undefined\n\n\t\t\tconst uniqueResult = await client.query(`\n\t\t\t\tSELECT kcu.column_name\n\t\t\t\tFROM information_schema.table_constraints tc\n\t\t\t\tJOIN information_schema.key_column_usage kcu\n\t\t\t\t\tON tc.constraint_name = kcu.constraint_name AND tc.table_schema = kcu.table_schema\n\t\t\t\tWHERE tc.table_schema = 'public' AND tc.table_name = $1 AND tc.constraint_type = 'UNIQUE'\n\t\t\t`, [tableName])\n\t\t\tconst uniqueCols = new Set(uniqueResult.rows.map((r: any) => r.column_name))\n\n\t\t\tlet pk: { name: string; type: FieldTypeName } | undefined\n\t\t\tconst fields: { name: string; type: FieldTypeName; nullable: boolean; default?: string | number | boolean | null; unique?: boolean }[] = []\n\n\t\t\tfor (const col of colsResult.rows) {\n\t\t\t\tconst pgType = (col.data_type as string).toLowerCase()\n\t\t\t\tconst fieldType = PG_TO_FIELD_TYPE[pgType]\n\t\t\t\tif (!fieldType) {\n\t\t\t\t\tthrow new OrmIntrospectionError({ adapter: 'postgresql', table: tableName, cause: `Unsupported column type '${pgType}' on column '${col.column_name}'` })\n\t\t\t\t}\n\n\t\t\t\tif (col.column_name === pkColName) {\n\t\t\t\t\tpk = { name: col.column_name, type: fieldType }\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\n\t\t\t\tconst nullable = col.is_nullable === 'YES'\n\t\t\t\tconst raw = col.column_default as string | null\n\t\t\t\tconst def = this.#parseDefault(raw)\n\n\t\t\t\tfields.push({\n\t\t\t\t\tname: col.column_name,\n\t\t\t\t\ttype: fieldType,\n\t\t\t\t\tnullable,\n\t\t\t\t\t...(def !== undefined ? { default: def } : {}),\n\t\t\t\t\t...(uniqueCols.has(col.column_name) ? { unique: true } : {}),\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tconst idxResult = await client.query(`\n\t\t\t\tSELECT indexname, indexdef\n\t\t\t\tFROM pg_indexes\n\t\t\t\tWHERE schemaname = 'public' AND tablename = $1\n\t\t\t`, [tableName])\n\n\t\t\tconst indexes: { name: string; on: readonly string[]; unique: boolean }[] = []\n\t\t\tfor (const idx of idxResult.rows) {\n\t\t\t\tconst idxName = idx.indexname as string\n\t\t\t\tconst idxDef = idx.indexdef as string\n\t\t\t\tif (idxDef.includes('PRIMARY KEY') || idxName.endsWith('_pkey')) continue\n\t\t\t\tconst unique = idxDef.toUpperCase().includes('UNIQUE')\n\t\t\t\tconst colMatch = idxDef.match(/\\(([^)]+)\\)/)\n\t\t\t\tconst cols = colMatch ? colMatch[1].split(',').map((c: string) => c.trim().replace(/\"/g, '')) : []\n\t\t\t\tindexes.push({ name: idxName, on: cols, unique })\n\t\t\t}\n\n\t\t\tconst fkResult = await client.query(`\n\t\t\t\tSELECT\n\t\t\t\t\ttc.constraint_name,\n\t\t\t\t\tkcu.column_name,\n\t\t\t\t\tccu.table_name AS foreign_table_name,\n\t\t\t\t\tccu.column_name AS foreign_column_name,\n\t\t\t\t\trc.delete_rule,\n\t\t\t\t\trc.update_rule\n\t\t\t\tFROM information_schema.table_constraints tc\n\t\t\t\tJOIN information_schema.key_column_usage kcu\n\t\t\t\t\tON tc.constraint_name = kcu.constraint_name AND tc.table_schema = kcu.table_schema\n\t\t\t\tJOIN information_schema.constraint_column_usage ccu\n\t\t\t\t\tON tc.constraint_name = ccu.constraint_name AND tc.table_schema = ccu.table_schema\n\t\t\t\tJOIN information_schema.referential_constraints rc\n\t\t\t\t\tON tc.constraint_name = rc.constraint_name AND tc.table_schema = rc.constraint_schema\n\t\t\t\tWHERE tc.table_schema = 'public' AND tc.table_name = $1 AND tc.constraint_type = 'FOREIGN KEY'\n\t\t\t`, [tableName])\n\n\t\t\tconst foreignKeys: { name: string; on: string; references: { table: string; column: string }; onDelete?: ForeignKeyAction; onUpdate?: ForeignKeyAction }[] = []\n\t\t\tfor (const fk of fkResult.rows) {\n\t\t\t\tforeignKeys.push({\n\t\t\t\t\tname: fk.constraint_name,\n\t\t\t\t\ton: fk.column_name,\n\t\t\t\t\treferences: { table: fk.foreign_table_name, column: fk.foreign_column_name },\n\t\t\t\t\t...(fk.delete_rule && fk.delete_rule !== 'NO ACTION' ? { onDelete: this.#parseFkAction(fk.delete_rule) } : {}),\n\t\t\t\t\t...(fk.update_rule && fk.update_rule !== 'NO ACTION' ? { onUpdate: this.#parseFkAction(fk.update_rule) } : {}),\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tschemas.push({ name: tableName, pk, fields, indexes, foreignKeys })\n\t\t}\n\n\t\treturn schemas\n\t}\n\n\t#renderColumnDef(f: { name: string; type: string; nullable?: boolean; default?: string | number | boolean | null; unique?: boolean }): string {\n\t\tconst pgType = FIELD_TYPE_TO_PG[f.type] ?? 'text'\n\t\tlet def = `\"${f.name}\" ${pgType}`\n\t\tif (!f.nullable) def += ' NOT NULL'\n\t\tif (f.default !== undefined) def += ` DEFAULT ${this.#renderDefault(f.default)}`\n\t\tif (f.unique) def += ' UNIQUE'\n\t\treturn def\n\t}\n\n\t#renderDefault(val: string | number | boolean | null | undefined): string {\n\t\tif (val === null) return 'NULL'\n\t\tif (typeof val === 'string') return `'${val.replace(/'/g, \"''\")}'`\n\t\tif (typeof val === 'boolean') return val ? 'TRUE' : 'FALSE'\n\t\treturn String(val)\n\t}\n\n\t#deriveIndexName(table: string, cols: string[], unique?: boolean): string {\n\t\tconst base = `idx_${table}_${cols.join('_')}`\n\t\treturn unique ? `${base}_unique` : base\n\t}\n\n\t#renderFkAction(action: string): string {\n\t\tconst map: Record<string, string> = { cascade: 'CASCADE', restrict: 'RESTRICT', setnull: 'SET NULL', noaction: 'NO ACTION' }\n\t\treturn map[action.toLowerCase()] ?? 'NO ACTION'\n\t}\n\n\t#parseFkAction(rule: string): ForeignKeyAction {\n\t\tconst map: Record<string, ForeignKeyAction> = { CASCADE: 'cascade', RESTRICT: 'restrict', 'SET NULL': 'setNull' }\n\t\treturn map[rule.toUpperCase()] ?? 'noAction'\n\t}\n\n\t#parseDefault(raw: string | null): string | number | boolean | null | undefined {\n\t\tif (raw === null || raw === undefined) return undefined\n\t\tif (raw === 'NULL' || raw === 'NULL::text') return null\n\t\tif (raw === 'true' || raw === 'TRUE') return true\n\t\tif (raw === 'false' || raw === 'FALSE') return false\n\t\tconst numMatch = raw.match(/^(-?\\d+(?:\\.\\d+)?)$/)\n\t\tif (numMatch) return Number(numMatch[1])\n\t\tconst strMatch = raw.match(/^'(.*)'(?:::.*)?$/)\n\t\tif (strMatch) return strMatch[1].replace(/''/g, \"'\")\n\t\treturn undefined\n\t}\n\n\tasync session<T>(fn: () => Promise<T>): Promise<T> {\n\t\tif (this.#sessionStore.getStore()) return fn()\n\t\tlet client: PoolClient | undefined\n\t\ttry {\n\t\t\tclient = await this.pool.connect()\n\t\t\tawait client.query('BEGIN')\n\t\t\tconst result = await this.#sessionStore.run(client, fn)\n\t\t\tawait client.query('COMMIT')\n\t\t\treturn result\n\t\t} catch (error) {\n\t\t\tif (client) {\n\t\t\t\ttry {\n\t\t\t\t\tawait client.query('ROLLBACK')\n\t\t\t\t} catch {\n\t\t\t\t\t// ignore rollback errors and report original failure\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (error instanceof EquippedError) throw error\n\t\t\tthrow new EquippedError('PostgreSQL session failed', { adapter: 'postgresql', operation: 'session' }, error)\n\t\t} finally {\n\t\t\tclient?.release()\n\t\t}\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect, expectTypeOf, vi, beforeEach, afterEach } = import.meta.vitest\n\n\tconst testConnectionConfig = {\n\t\thost: 'localhost',\n\t\tport: 5432,\n\t\tusername: 'test',\n\t\tpassword: 'test',\n\t\tdatabase: 'testdb',\n\t\tssl: false,\n\t} as const\n\n\tdescribe('PostgresAdapter: class-via-configurable shape', () => {\n\t\tlet onSpy: ReturnType<typeof vi.spyOn>\n\n\t\tbeforeEach(async () => {\n\t\t\tconst { Instance } = await import('../../../instance')\n\t\t\tonSpy = vi.spyOn(Instance, 'on').mockImplementation(() => {})\n\t\t})\n\n\t\tafterEach(() => {\n\t\t\tonSpy.mockRestore()\n\t\t})\n\n\t\ttest('PostgresAdapter.create returns instance with correct capability declarations', () => {\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\n\t\t\texpect(adapter.supportedFieldTypes).toEqual(['string', 'number', 'boolean', 'null', 'object', 'array', 'date'])\n\t\t\texpect(adapter.queryableOps).toEqual([\n\t\t\t\t'eq',\n\t\t\t\t'ne',\n\t\t\t\t'gt',\n\t\t\t\t'gte',\n\t\t\t\t'lt',\n\t\t\t\t'lte',\n\t\t\t\t'in',\n\t\t\t\t'notIn',\n\t\t\t\t'like',\n\t\t\t\t'exists',\n\t\t\t\t'notExists',\n\t\t\t\t'contains',\n\t\t\t\t'notContains',\n\t\t\t])\n\t\t\texpect(adapter.updateOps).toEqual(['set', 'inc', 'mul', 'min', 'max', 'unset', 'push', 'pull', 'patch'])\n\t\t})\n\n\t\ttest('PostgresAdapter.create validates connection config', () => {\n\t\t\texpect(() => PostgresAdapter.create({ host: 123, port: 'bad' } as any)).toThrow()\n\t\t})\n\n\t\ttest('pool is exposed as a readonly instance field', () => {\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\n\t\t\texpect(adapter.pool).toBeInstanceOf(Pool)\n\t\t})\n\n\t\ttest('schemaConfigPipe is declared as readonly with table-name shape', () => {\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\n\t\t\texpect(adapter.schemaConfigPipe).toBeDefined()\n\t\t})\n\n\t\ttest('auto-wires Instance hooks for connect and disconnect', () => {\n\t\t\tPostgresAdapter.create(testConnectionConfig)\n\n\t\t\texpect(onSpy).toHaveBeenCalledWith('start', expect.any(Function), expect.objectContaining({ class: PostgresAdapter }))\n\t\t\texpect(onSpy).toHaveBeenCalledWith('close', expect.any(Function), expect.objectContaining({ class: PostgresAdapter }))\n\t\t})\n\n\t\ttest('adapter.use returns OrmUse-shaped object', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst use = adapter.use(schema, { table: 'test' })\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: capability declarations use as const', () => {\n\t\t\tconst _adapter = PostgresAdapter.create(testConnectionConfig)\n\n\t\t\ttype Ops = typeof _adapter.updateOps\n\t\t\texpectTypeOf<Ops>().toEqualTypeOf<readonly ['set', 'inc', 'mul', 'min', 'max', 'unset', 'push', 'pull', 'patch']>()\n\n\t\t\ttype Types = typeof _adapter.supportedFieldTypes\n\t\t\texpectTypeOf<Types>().toEqualTypeOf<readonly ['string', 'number', 'boolean', 'null', 'object', 'array', 'date']>()\n\n\t\t\ttype QOps = typeof _adapter.queryableOps\n\t\t\texpectTypeOf<QOps>().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 PostgresAdapter enables all builder methods', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst repo = Repo.from(adapter)\n\t\t\t\t.resolve(() => ({ table: 'test' }))\n\t\t\t\t.build()\n\t\t\tconst _TestSchema = Schema.from('test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.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 (command: string, params?: unknown[]) from PostgresAdapter', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst repo = Repo.from(adapter)\n\t\t\t\t.resolve(() => ({ table: 'test' }))\n\t\t\t\t.build()\n\t\t\tconst _TestSchema = Schema.from('test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst _ref = repo.on(_TestSchema)\n\n\t\t\texpectTypeOf(_ref.raw).parameters.toEqualTypeOf<[command: string, params?: unknown[]]>()\n\t\t})\n\n\t\ttest('type-level: per-call <T> override narrows PostgresAdapter raw return type', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst repo = Repo.from(adapter)\n\t\t\t\t.resolve(() => ({ table: 'test' }))\n\t\t\t\t.build()\n\t\t\tconst _TestSchema = Schema.from('test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst _ref = repo.on(_TestSchema)\n\n\t\t\texpectTypeOf(_ref.raw<{ id: string }[]>).returns.toEqualTypeOf<Promise<{ id: string }[]>>()\n\t\t})\n\n\t\ttest('count forwards COUNT query to pool.query and returns a number', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\n\t\t\tconst schema = Schema.from('pg_count')\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 = PostgresAdapter.create(testConnectionConfig)\n\t\t\tlet capturedSql: unknown\n\t\t\tlet capturedParams: unknown\n\t\t\t;(adapter.pool as any).query = async (sql: unknown, params: unknown) => {\n\t\t\t\tcapturedSql = sql\n\t\t\t\tcapturedParams = params\n\t\t\t\treturn { rows: [{ count: '4' }] }\n\t\t\t}\n\n\t\t\tconst result = await adapter.count(schema, { table: 'users' }, FilterGroup.create().eq('name', 'Alice'))\n\t\t\texpect(capturedSql).toBe('SELECT COUNT(*) as count FROM \"users\" WHERE \"name\" = $1')\n\t\t\texpect(capturedParams).toEqual(['Alice'])\n\t\t\texpect(result).toBe(4)\n\t\t})\n\n\t\ttest('raw forwards (command, params) to pool.query at runtime', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('pg_raw')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tlet capturedCommand: unknown\n\t\t\tlet capturedParams: unknown\n\t\t\tconst mockResult = { rows: [{ id: '1' }], rowCount: 1 }\n\t\t\t;(adapter.pool as any).query = async (cmd: unknown, params: unknown) => {\n\t\t\t\tcapturedCommand = cmd\n\t\t\t\tcapturedParams = params\n\t\t\t\treturn mockResult\n\t\t\t}\n\t\t\tconst result = await adapter.use(schema, { table: 'users' }).raw('SELECT * FROM users WHERE id = $1', ['abc'])\n\t\t\texpect(capturedCommand).toBe('SELECT * FROM users WHERE id = $1')\n\t\t\texpect(capturedParams).toEqual(['abc'])\n\t\t\texpect(result).toBe(mockResult)\n\t\t})\n\n\t\ttest('raw defaults params to [] when omitted', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('pg_raw2')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tlet capturedParams: unknown\n\t\t\t;(adapter.pool as any).query = async (_cmd: unknown, params: unknown) => {\n\t\t\t\tcapturedParams = params\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t\tawait adapter.use(schema, { table: 'users' }).raw('SELECT 1')\n\t\t\texpect(capturedParams).toEqual([])\n\t\t})\n\n\t\ttest('iterateMany opens a dedicated cursor client, reads in batchSize chunks, and releases on completion', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\t\t\tconst { OrderBy } = await import('../../query-options')\n\n\t\t\tconst schema = Schema.from('pg_iter')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.field('age', v.number())\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tlet capturedCursor: Cursor<Record<string, unknown>> | undefined\n\t\t\tconst release = vi.fn()\n\t\t\tconst cursor = {\n\t\t\t\tread: vi.fn()\n\t\t\t\t\t.mockResolvedValueOnce([{ id: 'u3', age: 40 }])\n\t\t\t\t\t.mockResolvedValueOnce([{ id: 'u1', age: 30 }])\n\t\t\t\t\t.mockResolvedValueOnce([]),\n\t\t\t\tclose: vi.fn().mockResolvedValue(undefined),\n\t\t\t}\n\t\t\tconst client = {\n\t\t\t\tquery: vi.fn((query: Cursor<Record<string, unknown>>) => {\n\t\t\t\t\tcapturedCursor = query\n\t\t\t\t\treturn cursor\n\t\t\t\t}),\n\t\t\t\trelease,\n\t\t\t}\n\t\t\t;(adapter.pool as any).connect = vi.fn(async () => client)\n\n\t\t\tconst rows: Record<string, unknown>[] = []\n\t\t\tfor await (const row of adapter.use(schema, { table: '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: 1,\n\t\t\t})) {\n\t\t\t\trows.push(row)\n\t\t\t}\n\n\t\t\texpect((adapter.pool as any).connect).toHaveBeenCalledTimes(1)\n\t\t\texpect(capturedCursor).toBeInstanceOf(Cursor)\n\t\t\tconst capturedCursorConfig = capturedCursor as unknown as { text: string; values: unknown[] }\n\t\t\texpect(capturedCursorConfig.text).toBe('SELECT * FROM \"people\" WHERE \"age\" > $1 ORDER BY \"age\" DESC LIMIT $2 OFFSET $3')\n\t\t\texpect(capturedCursorConfig.values).toEqual(['19', '2', '1'])\n\t\t\texpect(cursor.read).toHaveBeenNthCalledWith(1, 1)\n\t\t\texpect(cursor.read).toHaveBeenNthCalledWith(2, 1)\n\t\t\texpect(cursor.read).toHaveBeenNthCalledWith(3, 1)\n\t\t\texpect(cursor.close).toHaveBeenCalledTimes(1)\n\t\t\texpect(release).toHaveBeenCalledTimes(1)\n\t\t\texpect(rows).toEqual([{ id: 'u3', age: 40 }, { id: 'u1', age: 30 }])\n\t\t})\n\n\t\ttest('iterateMany closes cursor and releases dedicated client on early break', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\n\t\t\tconst schema = Schema.from('pg_iter_break')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst release = vi.fn()\n\t\t\tconst cursor = {\n\t\t\t\tread: vi.fn().mockResolvedValueOnce([{ id: 'u1' }, { id: 'u2' }]),\n\t\t\t\tclose: vi.fn().mockResolvedValue(undefined),\n\t\t\t}\n\t\t\t;(adapter.pool as any).connect = vi.fn(async () => ({\n\t\t\t\tquery: vi.fn(() => cursor),\n\t\t\t\trelease,\n\t\t\t}))\n\n\t\t\tconst rows: Record<string, unknown>[] = []\n\t\t\tfor await (const row of adapter.use(schema, { table: 'people' }).iterateMany(FilterGroup.create())) {\n\t\t\t\trows.push(row)\n\t\t\t\tbreak\n\t\t\t}\n\n\t\t\texpect(rows).toEqual([{ id: 'u1' }])\n\t\t\texpect(cursor.close).toHaveBeenCalledTimes(1)\n\t\t\texpect(release).toHaveBeenCalledTimes(1)\n\t\t})\n\n\t\ttest('iterateMany closes cursor and releases dedicated client when the consumer throws', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\n\t\t\tconst schema = Schema.from('pg_iter_throw')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst release = vi.fn()\n\t\t\tconst cursor = {\n\t\t\t\tread: vi.fn().mockResolvedValueOnce([{ id: 'u1' }]),\n\t\t\t\tclose: vi.fn().mockResolvedValue(undefined),\n\t\t\t}\n\t\t\t;(adapter.pool as any).connect = vi.fn(async () => ({\n\t\t\t\tquery: vi.fn(() => cursor),\n\t\t\t\trelease,\n\t\t\t}))\n\t\t\tconst consumerError = new Error('consumer failed')\n\n\t\t\tawait expect(async () => {\n\t\t\t\tfor await (const _row of adapter.use(schema, { table: 'people' }).iterateMany(FilterGroup.create())) {\n\t\t\t\t\tthrow consumerError\n\t\t\t\t}\n\t\t\t}).rejects.toThrow(consumerError)\n\n\t\t\texpect(cursor.close).toHaveBeenCalledTimes(1)\n\t\t\texpect(release).toHaveBeenCalledTimes(1)\n\t\t})\n\n\t\ttest('iterateMany inside a session uses the active client and leaves release ownership to session', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\t\t\tconst { FilterGroup } = await import('../../filter')\n\n\t\t\tconst schema = Schema.from('pg_iter_session')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst events: string[] = []\n\t\t\tconst release = vi.fn(() => events.push('release'))\n\t\t\tconst cursor = {\n\t\t\t\tread: vi.fn()\n\t\t\t\t\t.mockResolvedValueOnce([{ id: 'u1' }])\n\t\t\t\t\t.mockResolvedValueOnce([]),\n\t\t\t\tclose: vi.fn(async () => events.push('cursor.close')),\n\t\t\t}\n\t\t\tconst client = {\n\t\t\t\tquery: vi.fn((query: string | Cursor<Record<string, unknown>>) => {\n\t\t\t\t\tif (typeof query === 'string') {\n\t\t\t\t\t\tevents.push(query)\n\t\t\t\t\t\treturn { rows: [] }\n\t\t\t\t\t}\n\t\t\t\t\tevents.push('cursor.open')\n\t\t\t\t\treturn cursor\n\t\t\t\t}),\n\t\t\t\trelease,\n\t\t\t}\n\t\t\t;(adapter.pool as any).connect = vi.fn(async () => client)\n\n\t\t\tconst rows: Record<string, unknown>[] = []\n\t\t\tawait adapter.session(async () => {\n\t\t\t\tfor await (const row of adapter.use(schema, { table: 'people' }).iterateMany(FilterGroup.create(), { batchSize: 1 })) {\n\t\t\t\t\trows.push(row)\n\t\t\t\t}\n\t\t\t\tevents.push('session.body.done')\n\t\t\t})\n\n\t\t\texpect((adapter.pool as any).connect).toHaveBeenCalledTimes(1)\n\t\t\texpect(rows).toEqual([{ id: 'u1' }])\n\t\t\texpect(events).toEqual(['BEGIN', 'cursor.open', 'cursor.close', 'session.body.done', 'COMMIT', 'release'])\n\t\t\texpect(release).toHaveBeenCalledTimes(1)\n\t\t})\n\n\t\ttest('session method is exposed on the adapter', () => {\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\texpect(adapter.session).toBeDefined()\n\t\t\texpect(adapter.session).toBeTypeOf('function')\n\t\t})\n\n\t\ttest('declares aggregateOps with all six canonical ops', () => {\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\texpect(adapter.aggregateOps).toEqual(['count', 'countDistinct', 'sum', 'avg', 'min', 'max'])\n\t\t})\n\n\t\ttest('type-level: aggregateOps is a readonly tuple of all six ops', () => {\n\t\t\tconst _adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\ttype AggOps = typeof _adapter.aggregateOps\n\t\t\texpectTypeOf<AggOps>().toEqualTypeOf<\n\t\t\t\treadonly ['count', 'countDistinct', 'sum', 'avg', 'min', 'max']\n\t\t\t>()\n\t\t})\n\n\t\ttest('aggregate method forwards spec to pool.query and returns mapped rows', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('pg_agg')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.field('amount', v.number())\n\t\t\t\t.field('region', v.string())\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tlet capturedSql: unknown\n\t\t\tlet capturedParams: unknown\n\t\t\t;(adapter.pool as any).query = async (sql: unknown, params: unknown) => {\n\t\t\t\tcapturedSql = sql\n\t\t\t\tcapturedParams = params\n\t\t\t\treturn { rows: [{ total: '5' }] }\n\t\t\t}\n\t\t\tconst result = await adapter.aggregate(schema, { table: 'orders' }, {\n\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\tgroupBy: [],\n\t\t\t})\n\t\t\texpect(capturedSql).toBe('SELECT COUNT(*) AS \"total\" FROM \"orders\"')\n\t\t\texpect(capturedParams).toEqual([])\n\t\t\texpect(result).toEqual([{ total: 5 }])\n\t\t})\n\n\t\ttest('aggregate converts PG bigint/numeric strings to numbers for count/sum/avg', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('pg_agg_types')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.field('amount', v.number())\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\t;(adapter.pool as any).query = async () => ({\n\t\t\t\trows: [{ cnt: '10', revenue: '250.50', avgAmt: '25.05' }],\n\t\t\t})\n\t\t\tconst result = await adapter.aggregate(schema, { table: 'orders' }, {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'count', alias: 'cnt' },\n\t\t\t\t\t{ fn: 'sum', field: 'amount', alias: 'revenue' },\n\t\t\t\t\t{ fn: 'avg', field: 'amount', alias: 'avgAmt' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t})\n\t\t\texpect(result[0].cnt).toBe(10)\n\t\t\texpect(result[0].revenue).toBe(250.5)\n\t\t\texpect(result[0].avgAmt).toBe(25.05)\n\t\t})\n\n\t\ttest('aggregate preserves original type for min/max', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('pg_agg_minmax')\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 = PostgresAdapter.create(testConnectionConfig)\n\t\t\t;(adapter.pool as any).query = async () => ({\n\t\t\t\trows: [{ lowest: 'Alice', highest: 'Zara' }],\n\t\t\t})\n\t\t\tconst result = await adapter.aggregate(schema, { table: 'users' }, {\n\t\t\t\taggregates: [\n\t\t\t\t\t{ fn: 'min', field: 'name', alias: 'lowest' },\n\t\t\t\t\t{ fn: 'max', field: 'name', alias: 'highest' },\n\t\t\t\t],\n\t\t\t\tgroupBy: [],\n\t\t\t})\n\t\t\texpect(result[0].lowest).toBe('Alice')\n\t\t\texpect(result[0].highest).toBe('Zara')\n\t\t})\n\n\t\ttest('aggregate includes groupBy fields in result rows', async () => {\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst schema = Schema.from('pg_agg_group')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.field('region', v.string())\n\t\t\t\t.build()\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\t;(adapter.pool as any).query = async () => ({\n\t\t\t\trows: [\n\t\t\t\t\t{ cnt: '3', region: 'US' },\n\t\t\t\t\t{ cnt: '2', region: 'EU' },\n\t\t\t\t],\n\t\t\t})\n\t\t\tconst result = await adapter.aggregate(schema, { table: 'orders' }, {\n\t\t\t\taggregates: [{ fn: 'count', alias: 'cnt' }],\n\t\t\t\tgroupBy: ['region'],\n\t\t\t})\n\t\t\texpect(result).toEqual([\n\t\t\t\t{ cnt: 3, region: 'US' },\n\t\t\t\t{ cnt: 2, region: 'EU' },\n\t\t\t])\n\t\t})\n\n\t\ttest('type-level: Repo.from with PostgresAdapter enables aggregate method', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tconst adapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tconst repo = Repo.from(adapter)\n\t\t\t\t.resolve(() => ({ table: 'test' }))\n\t\t\t\t.build()\n\t\t\tconst _TestSchema = Schema.from('test')\n\t\t\t\t.pk('id', v.string(), () => 'x')\n\t\t\t\t.build()\n\n\t\t\tconst _ref = repo.on(_TestSchema)\n\t\t\texpectTypeOf(_ref.aggregate).toBeFunction()\n\t\t})\n\t})\n\n\tdescribe('PostgresAdapter: migration methods', () => {\n\t\tlet onSpy: ReturnType<typeof vi.spyOn>\n\t\tlet adapter: PostgresAdapter\n\t\tlet queries: { sql: string; params?: unknown[] }[]\n\n\t\tbeforeEach(async () => {\n\t\t\tconst { Instance } = await import('../../../instance')\n\t\t\tonSpy = vi.spyOn(Instance, 'on').mockImplementation(() => {})\n\t\t\tadapter = PostgresAdapter.create(testConnectionConfig)\n\t\t\tqueries = []\n\t\t\t;(adapter.pool as any).query = async (sql: string, params?: unknown[]) => {\n\t\t\t\tqueries.push({ sql, params })\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t})\n\n\t\tafterEach(() => {\n\t\t\tonSpy.mockRestore()\n\t\t})\n\n\t\ttest('loadMigrations creates tracker table then selects rows', async () => {\n\t\t\t;(adapter.pool as any).query = async (sql: string, params?: unknown[]) => {\n\t\t\t\tqueries.push({ sql, params })\n\t\t\t\tif (sql.includes('SELECT id')) {\n\t\t\t\t\treturn { rows: [{ id: '0001', applied_at: '1700000000000' }] }\n\t\t\t\t}\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t\tconst result = await adapter.loadMigrations()\n\t\t\texpect(queries).toHaveLength(2)\n\t\t\texpect(queries[0].sql).toContain('CREATE TABLE IF NOT EXISTS')\n\t\t\texpect(queries[0].sql).toContain('equipped_migrations')\n\t\t\texpect(queries[1].sql).toContain('SELECT id, applied_at')\n\t\t\texpect(result).toEqual([{ id: '0001', appliedAt: 1700000000000 }])\n\t\t})\n\n\t\ttest('recordMigration inserts into tracker table', async () => {\n\t\t\tawait adapter.recordMigration('0001-init', 1700000000000)\n\t\t\texpect(queries).toHaveLength(1)\n\t\t\texpect(queries[0].sql).toContain('INSERT INTO')\n\t\t\texpect(queries[0].sql).toContain('equipped_migrations')\n\t\t\texpect(queries[0].params).toEqual(['0001-init', 1700000000000])\n\t\t})\n\n\t\ttest('acquireMigrationLock wraps fn with pg_advisory_lock/unlock', async () => {\n\t\t\tconst result = await adapter.acquireMigrationLock(async () => {\n\t\t\t\tqueries.push({ sql: 'USER_FN' })\n\t\t\t\treturn 42\n\t\t\t})\n\t\t\texpect(result).toBe(42)\n\t\t\texpect(queries[0].sql).toContain('pg_advisory_lock')\n\t\t\texpect(queries[1].sql).toBe('USER_FN')\n\t\t\texpect(queries[2].sql).toContain('pg_advisory_unlock')\n\t\t})\n\n\t\ttest('acquireMigrationLock unlocks even on error', async () => {\n\t\t\tawait expect(adapter.acquireMigrationLock(async () => {\n\t\t\t\tthrow new Error('boom')\n\t\t\t})).rejects.toThrow('boom')\n\t\t\texpect(queries[0].sql).toContain('pg_advisory_lock')\n\t\t\texpect(queries[1].sql).toContain('pg_advisory_unlock')\n\t\t})\n\n\t\ttest('applyCreateTable generates correct DDL', async () => {\n\t\t\tawait adapter.applyCreateTable({\n\t\t\t\tkind: 'createTable',\n\t\t\t\tname: 'users',\n\t\t\t\tpk: { name: 'id', type: 'string' },\n\t\t\t\tfields: [\n\t\t\t\t\t{ name: 'email', type: 'string', unique: true },\n\t\t\t\t\t{ name: 'age', type: 'number', nullable: true },\n\t\t\t\t\t{ name: 'active', type: 'boolean', default: true },\n\t\t\t\t],\n\t\t\t})\n\t\t\texpect(queries).toHaveLength(1)\n\t\t\tconst sql = queries[0].sql\n\t\t\texpect(sql).toContain('CREATE TABLE \"users\"')\n\t\t\texpect(sql).toContain('\"id\" text PRIMARY KEY')\n\t\t\texpect(sql).toContain('\"email\" text NOT NULL UNIQUE')\n\t\t\texpect(sql).toContain('\"age\" double precision')\n\t\t\texpect(sql).not.toContain('\"age\" double precision NOT NULL')\n\t\t\texpect(sql).toContain('\"active\" boolean NOT NULL DEFAULT TRUE')\n\t\t})\n\n\t\ttest('applyDropTable generates DROP TABLE', async () => {\n\t\t\tawait adapter.applyDropTable({ kind: 'dropTable', name: 'users' })\n\t\t\texpect(queries[0].sql).toBe('DROP TABLE \"users\"')\n\t\t})\n\n\t\ttest('applyAddField generates ALTER TABLE ADD COLUMN', async () => {\n\t\t\tawait adapter.applyAddField({\n\t\t\t\tkind: 'addField',\n\t\t\t\ttable: 'users',\n\t\t\t\tfield: { name: 'bio', type: 'string', nullable: true, default: 'none' },\n\t\t\t})\n\t\t\texpect(queries[0].sql).toContain('ALTER TABLE \"users\" ADD COLUMN')\n\t\t\texpect(queries[0].sql).toContain('\"bio\" text')\n\t\t\texpect(queries[0].sql).not.toContain('NOT NULL')\n\t\t\texpect(queries[0].sql).toContain(\"DEFAULT 'none'\")\n\t\t})\n\n\t\ttest('applyDropField generates ALTER TABLE DROP COLUMN', async () => {\n\t\t\tawait adapter.applyDropField({ kind: 'dropField', table: 'users', name: 'bio' })\n\t\t\texpect(queries[0].sql).toBe('ALTER TABLE \"users\" DROP COLUMN \"bio\"')\n\t\t})\n\n\t\ttest('applyModifyField generates ALTER COLUMN statements for type, nullable, default', async () => {\n\t\t\tawait adapter.applyModifyField({\n\t\t\t\tkind: 'modifyField',\n\t\t\t\ttable: 'users',\n\t\t\t\tname: 'age',\n\t\t\t\tto: { name: 'age', type: 'string', nullable: true, default: null },\n\t\t\t})\n\t\t\texpect(queries[0].sql).toContain('ALTER COLUMN \"age\" TYPE text')\n\t\t\texpect(queries[1].sql).toContain('DROP NOT NULL')\n\t\t\texpect(queries[2].sql).toContain('SET DEFAULT NULL')\n\t\t})\n\n\t\ttest('applyModifyField renames column when to.name differs', async () => {\n\t\t\tawait adapter.applyModifyField({\n\t\t\t\tkind: 'modifyField',\n\t\t\t\ttable: 'users',\n\t\t\t\tname: 'age',\n\t\t\t\tto: { name: 'years', type: 'number' },\n\t\t\t})\n\t\t\tconst renameSql = queries.find((q) => q.sql.includes('RENAME COLUMN'))\n\t\t\texpect(renameSql).toBeDefined()\n\t\t\texpect(renameSql!.sql).toContain('RENAME COLUMN \"age\" TO \"years\"')\n\t\t})\n\n\t\ttest('applyRenameTable generates ALTER TABLE RENAME', async () => {\n\t\t\tawait adapter.applyRenameTable({ kind: 'renameTable', from: 'users', to: 'accounts' })\n\t\t\texpect(queries[0].sql).toBe('ALTER TABLE \"users\" RENAME TO \"accounts\"')\n\t\t})\n\n\t\ttest('applyRenameField generates ALTER TABLE RENAME COLUMN', async () => {\n\t\t\tawait adapter.applyRenameField({ kind: 'renameField', table: 'users', from: 'name', to: 'fullName' })\n\t\t\texpect(queries[0].sql).toBe('ALTER TABLE \"users\" RENAME COLUMN \"name\" TO \"fullName\"')\n\t\t})\n\n\t\ttest('applyAddIndex generates CREATE INDEX with auto-derived name', async () => {\n\t\t\tawait adapter.applyAddIndex({ kind: 'addIndex', table: 'users', on: ['email'] })\n\t\t\texpect(queries[0].sql).toBe('CREATE INDEX \"idx_users_email\" ON \"users\" (\"email\")')\n\t\t})\n\n\t\ttest('applyAddIndex generates CREATE UNIQUE INDEX with explicit name', async () => {\n\t\t\tawait adapter.applyAddIndex({ kind: 'addIndex', table: 'users', on: ['email'], unique: true, name: 'my_idx' })\n\t\t\texpect(queries[0].sql).toBe('CREATE UNIQUE INDEX \"my_idx\" ON \"users\" (\"email\")')\n\t\t})\n\n\t\ttest('applyAddIndex auto-derives unique suffix when unique and no name', async () => {\n\t\t\tawait adapter.applyAddIndex({ kind: 'addIndex', table: 'posts', on: ['author', 'title'], unique: true })\n\t\t\texpect(queries[0].sql).toBe('CREATE UNIQUE INDEX \"idx_posts_author_title_unique\" ON \"posts\" (\"author\", \"title\")')\n\t\t})\n\n\t\ttest('applyDropIndex generates DROP INDEX', async () => {\n\t\t\tawait adapter.applyDropIndex({ kind: 'dropIndex', name: 'idx_users_email' })\n\t\t\texpect(queries[0].sql).toBe('DROP INDEX \"idx_users_email\"')\n\t\t})\n\n\t\ttest('applyAddForeignKey generates ALTER TABLE ADD CONSTRAINT with auto-derived name', async () => {\n\t\t\tawait adapter.applyAddForeignKey({\n\t\t\t\tkind: 'addForeignKey',\n\t\t\t\ttable: 'posts',\n\t\t\t\ton: 'authorId',\n\t\t\t\treferences: { table: 'users', column: 'id' },\n\t\t\t\tonDelete: 'cascade',\n\t\t\t\tonUpdate: 'setNull',\n\t\t\t})\n\t\t\tconst sql = queries[0].sql\n\t\t\texpect(sql).toContain('ALTER TABLE \"posts\" ADD CONSTRAINT \"fk_posts_authorId\"')\n\t\t\texpect(sql).toContain('FOREIGN KEY (\"authorId\") REFERENCES \"users\" (\"id\")')\n\t\t\texpect(sql).toContain('ON DELETE CASCADE')\n\t\t\texpect(sql).toContain('ON UPDATE SET NULL')\n\t\t})\n\n\t\ttest('applyAddForeignKey uses explicit name when provided', async () => {\n\t\t\tawait adapter.applyAddForeignKey({\n\t\t\t\tkind: 'addForeignKey',\n\t\t\t\ttable: 'posts',\n\t\t\t\ton: 'authorId',\n\t\t\t\treferences: { table: 'users', column: 'id' },\n\t\t\t\tname: 'custom_fk',\n\t\t\t})\n\t\t\texpect(queries[0].sql).toContain('ADD CONSTRAINT \"custom_fk\"')\n\t\t})\n\n\t\ttest('applyDropForeignKey generates ALTER TABLE DROP CONSTRAINT', async () => {\n\t\t\tawait adapter.applyDropForeignKey({ kind: 'dropForeignKey', table: 'posts', name: 'fk_posts_authorId' })\n\t\t\texpect(queries[0].sql).toBe('ALTER TABLE \"posts\" DROP CONSTRAINT \"fk_posts_authorId\"')\n\t\t})\n\n\t\ttest('introspect queries information_schema and builds DiscoveredSchema[]', async () => {\n\t\t\t;(adapter.pool as any).query = async (sql: string, params?: unknown[]) => {\n\t\t\t\tqueries.push({ sql, params })\n\t\t\t\tif (sql.includes('information_schema.tables')) {\n\t\t\t\t\treturn { rows: [{ table_name: 'users' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes('information_schema.columns')) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\trows: [\n\t\t\t\t\t\t\t{ column_name: 'id', data_type: 'text', is_nullable: 'NO', column_default: null },\n\t\t\t\t\t\t\t{ column_name: 'email', data_type: 'character varying', is_nullable: 'NO', column_default: null },\n\t\t\t\t\t\t\t{ column_name: 'age', data_type: 'integer', is_nullable: 'YES', column_default: '25' },\n\t\t\t\t\t\t],\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (sql.includes('PRIMARY KEY')) {\n\t\t\t\t\treturn { rows: [{ column_name: 'id' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes(\"constraint_type = 'UNIQUE'\")) {\n\t\t\t\t\treturn { rows: [{ column_name: 'email' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes('pg_indexes')) {\n\t\t\t\t\treturn { rows: [{ indexname: 'users_email_idx', indexdef: 'CREATE UNIQUE INDEX users_email_idx ON public.users USING btree (email)' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes(\"constraint_type = 'FOREIGN KEY'\")) {\n\t\t\t\t\treturn { rows: [] }\n\t\t\t\t}\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t\tconst schemas = await adapter.introspect()\n\t\t\texpect(schemas).toHaveLength(1)\n\t\t\tconst s = schemas[0]\n\t\t\texpect(s.name).toBe('users')\n\t\t\texpect(s.pk).toEqual({ name: 'id', type: 'string' })\n\t\t\texpect(s.fields).toEqual([\n\t\t\t\t{ name: 'email', type: 'string', nullable: false, unique: true },\n\t\t\t\t{ name: 'age', type: 'number', nullable: true, default: 25 },\n\t\t\t])\n\t\t\texpect(s.indexes).toEqual([{ name: 'users_email_idx', on: ['email'], unique: true }])\n\t\t\texpect(s.foreignKeys).toEqual([])\n\t\t})\n\n\t\ttest('introspect throws OrmIntrospectionError on unsupported PG type', async () => {\n\t\t\tconst { OrmIntrospectionError } = await import('../../errors/introspection')\n\t\t\t;(adapter.pool as any).query = async (sql: string) => {\n\t\t\t\tif (sql.includes('information_schema.tables')) {\n\t\t\t\t\treturn { rows: [{ table_name: 'files' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes('information_schema.columns')) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\trows: [\n\t\t\t\t\t\t\t{ column_name: 'id', data_type: 'text', is_nullable: 'NO', column_default: null },\n\t\t\t\t\t\t\t{ column_name: 'data', data_type: 'bytea', is_nullable: 'YES', column_default: null },\n\t\t\t\t\t\t],\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (sql.includes('PRIMARY KEY')) {\n\t\t\t\t\treturn { rows: [{ column_name: 'id' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes(\"constraint_type = 'UNIQUE'\")) {\n\t\t\t\t\treturn { rows: [] }\n\t\t\t\t}\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t\tawait expect(adapter.introspect()).rejects.toThrow(OrmIntrospectionError)\n\t\t\ttry {\n\t\t\t\tawait adapter.introspect()\n\t\t\t} catch (err: any) {\n\t\t\t\texpect(err.adapter).toBe('postgresql')\n\t\t\t\texpect(err.table).toBe('files')\n\t\t\t\texpect(err.cause).toContain('bytea')\n\t\t\t}\n\t\t})\n\n\t\ttest('introspect parses foreign keys with cascade actions', async () => {\n\t\t\t;(adapter.pool as any).query = async (sql: string) => {\n\t\t\t\tif (sql.includes('information_schema.tables')) {\n\t\t\t\t\treturn { rows: [{ table_name: 'posts' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes('information_schema.columns')) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\trows: [\n\t\t\t\t\t\t\t{ column_name: 'id', data_type: 'text', is_nullable: 'NO', column_default: null },\n\t\t\t\t\t\t\t{ column_name: 'author_id', data_type: 'text', is_nullable: 'NO', column_default: null },\n\t\t\t\t\t\t],\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (sql.includes('PRIMARY KEY')) {\n\t\t\t\t\treturn { rows: [{ column_name: 'id' }] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes(\"constraint_type = 'UNIQUE'\")) {\n\t\t\t\t\treturn { rows: [] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes('pg_indexes')) {\n\t\t\t\t\treturn { rows: [] }\n\t\t\t\t}\n\t\t\t\tif (sql.includes(\"constraint_type = 'FOREIGN KEY'\")) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\trows: [{\n\t\t\t\t\t\t\tconstraint_name: 'fk_posts_author_id',\n\t\t\t\t\t\t\tcolumn_name: 'author_id',\n\t\t\t\t\t\t\tforeign_table_name: 'users',\n\t\t\t\t\t\t\tforeign_column_name: 'id',\n\t\t\t\t\t\t\tdelete_rule: 'CASCADE',\n\t\t\t\t\t\t\tupdate_rule: 'SET NULL',\n\t\t\t\t\t\t}],\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t\tconst schemas = await adapter.introspect()\n\t\t\texpect(schemas[0].foreignKeys).toEqual([{\n\t\t\t\tname: 'fk_posts_author_id',\n\t\t\t\ton: 'author_id',\n\t\t\t\treferences: { table: 'users', column: 'id' },\n\t\t\t\tonDelete: 'cascade',\n\t\t\t\tonUpdate: 'setNull',\n\t\t\t}])\n\t\t})\n\n\t\ttest('introspect excludes tracker table from results', async () => {\n\t\t\t;(adapter.pool as any).query = async (sql: string, params?: unknown[]) => {\n\t\t\t\tif (sql.includes('information_schema.tables')) {\n\t\t\t\t\texpect(params).toContain('equipped_migrations')\n\t\t\t\t\treturn { rows: [] }\n\t\t\t\t}\n\t\t\t\treturn { rows: [] }\n\t\t\t}\n\t\t\tconst schemas = await adapter.introspect()\n\t\t\texpect(schemas).toEqual([])\n\t\t})\n\n\t\ttest('type-level: PostgresAdapter declares all migration methods', () => {\n\t\t\texpectTypeOf(adapter.loadMigrations).toBeFunction()\n\t\t\texpectTypeOf(adapter.recordMigration).toBeFunction()\n\t\t\texpectTypeOf(adapter.acquireMigrationLock).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyCreateTable).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyDropTable).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyAddField).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyDropField).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyModifyField).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyRenameTable).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyRenameField).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyAddIndex).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyDropIndex).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyAddForeignKey).toBeFunction()\n\t\t\texpectTypeOf(adapter.applyDropForeignKey).toBeFunction()\n\t\t\texpectTypeOf(adapter.introspect).toBeFunction()\n\t\t})\n\n\t\ttest('type-level: Migrator.from rejects withoutLock for PostgresAdapter', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Migrator } = await import('../../migrations/migrator')\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ table: 'test' })).build()\n\t\t\tconst step = Migrator.from(repo, adapter).migrations([])\n\t\t\texpectTypeOf(step).toHaveProperty('build')\n\t\t\texpectTypeOf(step).not.toHaveProperty('withoutLock')\n\t\t})\n\n\t\ttest('applyCreateTable maps all field types to correct PG types', async () => {\n\t\t\tawait adapter.applyCreateTable({\n\t\t\t\tkind: 'createTable',\n\t\t\t\tname: 'all_types',\n\t\t\t\tpk: { name: 'id', type: 'string' },\n\t\t\t\tfields: [\n\t\t\t\t\t{ name: 'f_num', type: 'number' },\n\t\t\t\t\t{ name: 'f_bool', type: 'boolean' },\n\t\t\t\t\t{ name: 'f_date', type: 'date' },\n\t\t\t\t\t{ name: 'f_null', type: 'null' },\n\t\t\t\t\t{ name: 'f_obj', type: 'object' },\n\t\t\t\t\t{ name: 'f_arr', type: 'array' },\n\t\t\t\t],\n\t\t\t})\n\t\t\tconst sql = queries[0].sql\n\t\t\texpect(sql).toContain('\"f_num\" double precision NOT NULL')\n\t\t\texpect(sql).toContain('\"f_bool\" boolean NOT NULL')\n\t\t\texpect(sql).toContain('\"f_date\" timestamptz NOT NULL')\n\t\t\texpect(sql).toContain('\"f_null\" text NOT NULL')\n\t\t\texpect(sql).toContain('\"f_obj\" jsonb NOT NULL')\n\t\t\texpect(sql).toContain('\"f_arr\" jsonb NOT NULL')\n\t\t})\n\n\t\ttest('applyModifyField sets NOT NULL when nullable is falsy', async () => {\n\t\t\tawait adapter.applyModifyField({\n\t\t\t\tkind: 'modifyField',\n\t\t\t\ttable: 'users',\n\t\t\t\tname: 'email',\n\t\t\t\tto: { name: 'email', type: 'string' },\n\t\t\t})\n\t\t\texpect(queries[1].sql).toContain('SET NOT NULL')\n\t\t})\n\n\t\ttest('applyModifyField drops default when to.default is undefined', async () => {\n\t\t\tawait adapter.applyModifyField({\n\t\t\t\tkind: 'modifyField',\n\t\t\t\ttable: 'users',\n\t\t\t\tname: 'age',\n\t\t\t\tto: { name: 'age', type: 'number' },\n\t\t\t})\n\t\t\texpect(queries[2].sql).toContain('DROP DEFAULT')\n\t\t})\n\n\t\ttest('applyAddField with string default escapes single quotes', async () => {\n\t\t\tawait adapter.applyAddField({\n\t\t\t\tkind: 'addField',\n\t\t\t\ttable: 'users',\n\t\t\t\tfield: { name: 'bio', type: 'string', default: \"it's\" },\n\t\t\t})\n\t\t\texpect(queries[0].sql).toContain(\"DEFAULT 'it''s'\")\n\t\t})\n\n\t\ttest('end-to-end: Migrator.from(repo, adapter) wires up correctly', async () => {\n\t\t\tconst { Repo } = await import('../../repo/repo')\n\t\t\tconst { Migrator } = await import('../../migrations/migrator')\n\t\t\tconst { Schema } = await import('../../schema')\n\n\t\t\tSchema.from('users').pk('id', v.string(), () => 'x').field('email', v.string()).build()\n\t\t\tconst repo = Repo.from(adapter).resolve(() => ({ table: 'test' })).build()\n\n\t\t\tlet loadCalls = 0\n\t\t\tconst mockClient = {\n\t\t\t\tquery: async (sql: string, _params?: unknown[]) => {\n\t\t\t\t\tif (sql.includes('pg_advisory_lock') || sql.includes('pg_advisory_unlock')) return { rows: [] }\n\t\t\t\t\tif (sql.includes('CREATE TABLE IF NOT EXISTS')) return { rows: [] }\n\t\t\t\t\tif (sql.includes('SELECT id, applied_at')) { loadCalls++; return { rows: [] } }\n\t\t\t\t\tif (sql.includes('INSERT INTO')) return { rows: [] }\n\t\t\t\t\tif (sql.includes('CREATE TABLE')) return { rows: [] }\n\t\t\t\t\tif (sql === 'BEGIN' || sql === 'COMMIT' || sql === 'ROLLBACK') return { rows: [] }\n\t\t\t\t\treturn { rows: [] }\n\t\t\t\t},\n\t\t\t\trelease: () => {},\n\t\t\t}\n\t\t\t;(adapter.pool as any).query = mockClient.query\n\t\t\t;(adapter.pool as any).connect = async () => mockClient\n\n\t\t\tconst migrator = Migrator.from(repo, adapter).migrations([\n\t\t\t\t{ id: '0001', changes: [{ kind: 'createTable', name: 'users', pk: { name: 'id', type: 'string' }, fields: [{ name: 'email', type: 'string' }] }] },\n\t\t\t]).build()\n\n\t\t\tconst result = await migrator.up()\n\t\t\texpect(result.ran).toEqual(['0001'])\n\t\t\texpect(loadCalls).toBe(1)\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 { 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 { EquippedError } from '../../errors'\n\nexport type OrmValidationErrorKind = 'validation' | 'conflicting-ops' | 'empty-group' | 'undeclared-op' | 'upsert-filter-incompatible' | 'aggregate' | 'query-shape' | 'changes'\n\nexport type OrmValidationFailure = {\n\topIndex?: number\n\trowIndex?: number\n\tfield?: string\n\talias?: string\n\toption?: 'limit' | 'offset' | 'page' | 'batchSize'\n\tmigrationId?: string\n\tchangeIndex?: number\n\tcause: unknown\n}\n\nexport class OrmValidationError extends EquippedError {\n\tconstructor(\n\t\treadonly kind: OrmValidationErrorKind,\n\t\treadonly schema: string,\n\t\treadonly operation: string,\n\t\treadonly failures: OrmValidationFailure[],\n\t) {\n\t\tsuper(`ORM validation error (${kind}) on ${schema}.${operation}`, {\n\t\t\tkind,\n\t\t\tschema,\n\t\t\toperation,\n\t\t\tfailures,\n\t\t})\n\t}\n}\n\nif (import.meta.vitest) {\n\tconst { describe, test, expect } = import.meta.vitest\n\tconst { EquippedError } = await import('../../errors')\n\n\tdescribe('OrmValidationError', () => {\n\t\ttest('constructs with aggregate kind', () => {\n\t\t\tconst err = new OrmValidationError('aggregate', 'orders', 'aggregate', [])\n\t\t\texpect(err.kind).toBe('aggregate')\n\t\t\texpect(err.operation).toBe('aggregate')\n\t\t\texpect(err.message).toBe('ORM validation error (aggregate) on orders.aggregate')\n\t\t\texpect(err).toBeInstanceOf(OrmValidationError)\n\t\t\texpect(err).toBeInstanceOf(EquippedError)\n\t\t})\n\n\t\ttest('failure carries alias through to context', () => {\n\t\t\tconst failures: OrmValidationFailure[] = [\n\t\t\t\t{ alias: 'total_price', cause: 'alias collision' },\n\t\t\t]\n\t\t\tconst err = new OrmValidationError('aggregate', 'orders', 'aggregate', failures)\n\t\t\texpect(err.failures[0].alias).toBe('total_price')\n\t\t\texpect((err.context as any).failures[0].alias).toBe('total_price')\n\t\t})\n\n\t\ttest('failure without alias still works', () => {\n\t\t\tconst failures: OrmValidationFailure[] = [\n\t\t\t\t{ field: 'amount', cause: 'invalid field' },\n\t\t\t]\n\t\t\tconst err = new OrmValidationError('validation', 'orders', 'createOne', failures)\n\t\t\texpect(err.failures[0].alias).toBeUndefined()\n\t\t\texpect(err.failures[0].field).toBe('amount')\n\t\t})\n\n\t\ttest.each([\n\t\t\t'validation',\n\t\t\t'conflicting-ops',\n\t\t\t'empty-group',\n\t\t\t'undeclared-op',\n\t\t\t'upsert-filter-incompatible',\n\t\t\t'query-shape',\n\t\t\t'changes',\n\t\t] as const)('kind %s still works', (kind) => {\n\t\t\tconst err = new OrmValidationError(kind, 'users', 'createOne', [])\n\t\t\texpect(err.kind).toBe(kind)\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 type { AggregateOpName } from '../../adapter'\nimport { OrmValidationError } from '../../errors'\nimport { Filter, FilterGroup, type FilterChild } from '../../filter'\nimport type { AggregateSpec } from '../../orm-adapter'\nimport type { QueryOptions } from '../../query-options'\nimport { IncOp, MaxOp, MinOp, MulOp, PatchOp, PullOp, PushOp, UnsetOp } from '../../updates'\n\nfunction mapField(field: string, primaryKey: string): string {\n\tif (field === 'id' && primaryKey !== 'id') return primaryKey\n\treturn field\n}\n\nfunction compileOps(f: Filter, field: string, nextParam: (v: unknown) => string): string {\n\tswitch (f.op) {\n\t\tcase 'eq':\n\t\t\treturn f.value === null ? `${field} IS NULL` : `${field} = ${nextParam(f.value)}`\n\t\tcase 'ne':\n\t\t\treturn f.value === null ? `${field} IS NOT NULL` : `${field} != ${nextParam(f.value)}`\n\t\tcase 'gt':\n\t\t\treturn `${field} > ${nextParam(f.value)}`\n\t\tcase 'gte':\n\t\t\treturn `${field} >= ${nextParam(f.value)}`\n\t\tcase 'lt':\n\t\t\treturn `${field} < ${nextParam(f.value)}`\n\t\tcase 'lte':\n\t\t\treturn `${field} <= ${nextParam(f.value)}`\n\t\tcase 'in':\n\t\t\treturn `${field} = ANY(${nextParam(f.value)})`\n\t\tcase 'notIn':\n\t\t\treturn `NOT (${field} = ANY(${nextParam(f.value)}))`\n\t\tcase 'like':\n\t\t\treturn `${field} ILIKE ${nextParam(`%${f.value}%`)}`\n\t\tcase 'exists':\n\t\t\treturn `${field} IS NOT NULL`\n\t\tcase 'notExists':\n\t\t\treturn `${field} IS NULL`\n\t\tcase 'contains':\n\t\t\treturn `${field} @> ${nextParam(JSON.stringify(f.value))}::jsonb`\n\t\tcase 'notContains':\n\t\t\treturn `NOT (${field} @> ${nextParam(JSON.stringify(f.value))}::jsonb)`\n\t\tdefault:\n\t\t\treturn `${field} = ${nextParam(f.value)}`\n\t}\n}\n\nfunction compileFilter(f: Filter, primaryKey: string, nextParam: (v: unknown) => string): string {\n\treturn compileOps(f, `\"${mapField(f.field, primaryKey)}\"`, nextParam)\n}\n\nfunction compileChildren(group: FilterGroup, compileLeaf: (f: Filter) => string): string[] {\n\treturn group.children.map((c) => compileChild(c, compileLeaf)).filter((c): c is string => c !== null)\n}\n\nfunction compileGroup(group: FilterGroup, compileLeaf: (f: Filter) => string): string | null {\n\tconst parts = compileChildren(group, compileLeaf)\n\tif (parts.length === 0) return null\n\tif (parts.length === 1) return parts[0]\n\treturn `(${parts.join(group.op === 'or' ? ' OR ' : ' AND ')})`\n}\n\nfunction compileChild(child: FilterChild, compileLeaf: (f: Filter) => string): string | null {\n\tif (child instanceof Filter) return compileLeaf(child)\n\tif (child instanceof FilterGroup) return compileGroup(child, compileLeaf)\n\treturn null\n}\n\nfunction compilePgFilter(\n\tgroup: FilterGroup,\n\tprimaryKey: string,\n\tstartIndex = 1,\n): { whereClause: string; params: unknown[]; nextParamIndex: number } {\n\tconst params: unknown[] = []\n\tlet paramIndex = startIndex\n\n\tfunction nextParam(value: unknown): string {\n\t\tparams.push(value)\n\t\treturn `$${paramIndex++}`\n\t}\n\n\tconst leaf = (f: Filter) => compileFilter(f, primaryKey, nextParam)\n\tconst whereParts = compileChildren(group, leaf)\n\n\tconst whereClause = whereParts.length > 0 ? `WHERE ${whereParts.join(' AND ')}` : ''\n\treturn { whereClause, params, nextParamIndex: paramIndex }\n}\n\nfunction buildSetParts(\n\tdata: Record<string, unknown>,\n\tstartIndex: number,\n): { setParts: string[]; params: unknown[]; nextParamIndex: number } {\n\tconst params: unknown[] = []\n\tlet paramIndex = startIndex\n\n\tconst setParts = Object.entries(data).map(([key, value]) => {\n\t\tconst col = `\"${key}\"`\n\n\t\tif (value instanceof IncOp) {\n\t\t\tparams.push(value.value)\n\t\t\treturn `${col} = ${col} + $${paramIndex++}`\n\t\t}\n\t\tif (value instanceof MulOp) {\n\t\t\tparams.push(value.value)\n\t\t\treturn `${col} = ${col} * $${paramIndex++}`\n\t\t}\n\t\tif (value instanceof MinOp) {\n\t\t\tparams.push(value.value)\n\t\t\treturn `${col} = LEAST(${col}, $${paramIndex++})`\n\t\t}\n\t\tif (value instanceof MaxOp) {\n\t\t\tparams.push(value.value)\n\t\t\treturn `${col} = GREATEST(${col}, $${paramIndex++})`\n\t\t}\n\t\tif (value instanceof UnsetOp) {\n\t\t\treturn `${col} = NULL`\n\t\t}\n\t\tif (value instanceof PushOp) {\n\t\t\tparams.push(JSON.stringify(value.value))\n\t\t\treturn `${col} = ${col} || jsonb_build_array($${paramIndex++}::jsonb)`\n\t\t}\n\t\tif (value instanceof PullOp) {\n\t\t\tparams.push(JSON.stringify(value.value))\n\t\t\treturn `${col} = (SELECT COALESCE(jsonb_agg(e), '[]'::jsonb) FROM jsonb_array_elements(${col}) e WHERE e <> $${paramIndex++}::jsonb)`\n\t\t}\n\t\tif (value instanceof PatchOp) {\n\t\t\tparams.push(JSON.stringify(value.value))\n\t\t\treturn `${col} = ${col} || $${paramIndex++}::jsonb`\n\t\t}\n\n\t\tparams.push(value)\n\t\treturn `${col} = $${paramIndex++}`\n\t})\n\n\treturn { setParts, params, nextParamIndex: paramIndex }\n}\n\nexport function buildSelectQuery(\n\tgroup: FilterGroup,\n\toptions: QueryOptions | undefined,\n\ttableName: string,\n\tprimaryKey: string,\n): { sql: string; params: unknown[] } {\n\tconst { whereClause, params, nextParamIndex } = compilePgFilter(group, primaryKey)\n\tlet i = nextParamIndex\n\n\tconst orderParts = (options?.orderBy ?? []).map((o) => `\"${mapField(o.field, primaryKey)}\" ${o.direction.toUpperCase()}`)\n\tconst orderClause = orderParts.length > 0 ? `ORDER BY ${orderParts.join(', ')}` : ''\n\n\tlet limitClause = ''\n\tif (options?.limit != null) {\n\t\tparams.push(options.limit)\n\t\tlimitClause = `LIMIT $${i++}`\n\t}\n\tlet offsetClause = ''\n\tif (options?.offset != null) {\n\t\tparams.push(options.offset)\n\t\toffsetClause = `OFFSET $${i++}`\n\t}\n\tconst selectClause = options?.select?.length ? options.select.map((f) => `\"${mapField(f, primaryKey)}\"`).join(', ') : '*'\n\n\tconst sql = `SELECT ${selectClause} FROM \"${tableName}\" ${whereClause} ${orderClause} ${limitClause} ${offsetClause}`\n\t\t.trim()\n\t\t.replace(/\\s+/g, ' ')\n\treturn { sql, params }\n}\n\nexport function buildCountQuery(group: FilterGroup, tableName: string, primaryKey: string): { sql: string; params: unknown[] } {\n\tconst { whereClause, params } = compilePgFilter(group, primaryKey)\n\tconst sql = `SELECT COUNT(*) as count FROM \"${tableName}\" ${whereClause}`.trim().replace(/\\s+/g, ' ')\n\treturn { sql, params }\n}\n\nexport function buildCreateQuery(tableName: string, data: Record<string, unknown>): { sql: string; params: unknown[] } {\n\tconst keys = Object.keys(data)\n\tconst params = Object.values(data)\n\tconst placeholders = keys.map((_, i) => `$${i + 1}`)\n\tconst columns = keys.map((k) => `\"${k}\"`).join(', ')\n\tconst sql = `INSERT INTO \"${tableName}\" (${columns}) VALUES (${placeholders.join(', ')}) RETURNING *`\n\treturn { sql, params }\n}\n\nexport function buildUpdateQuery(\n\tgroup: FilterGroup,\n\ttableName: string,\n\tprimaryKey: string,\n\tdata: Record<string, unknown>,\n): { sql: string; params: unknown[] } {\n\tconst { setParts, params: setParams, nextParamIndex } = buildSetParts(data, 1)\n\tconst { whereClause, params: whereParams } = compilePgFilter(group, primaryKey, nextParamIndex)\n\tconst params = [...setParams, ...whereParams]\n\tconst sql = `UPDATE \"${tableName}\" SET ${setParts.join(', ')} ${whereClause} RETURNING *`.trim().replace(/\\s+/g, ' ')\n\treturn { sql, params }\n}\n\nexport function buildPkUpdateQuery(\n\ttableName: string,\n\tprimaryKey: string,\n\tpk: unknown,\n\tdata: Record<string, unknown>,\n): { sql: string; params: unknown[] } {\n\tconst { setParts, params: setParams, nextParamIndex } = buildSetParts(data, 1)\n\tsetParams.push(pk)\n\tconst sql = `UPDATE \"${tableName}\" SET ${setParts.join(', ')} WHERE \"${primaryKey}\" = $${nextParamIndex} RETURNING *`.replace(\n\t\t/\\s+/g,\n\t\t' ',\n\t)\n\treturn { sql, params: setParams }\n}\n\nexport function buildDeleteQuery(group: FilterGroup, tableName: string, primaryKey: string): { sql: string; params: unknown[] } {\n\tconst { whereClause, params } = compilePgFilter(group, primaryKey)\n\tconst sql = `DELETE FROM \"${tableName}\" ${whereClause} RETURNING *`.trim().replace(/\\s+/g, ' ')\n\treturn { sql, params }\n}\n\nexport function buildUpsertQuery(\n\ttableName: string,\n\tconflictColumn: string,\n\tprimaryKey: string,\n\tcreate: Record<string, unknown>,\n\tdata: Record<string, unknown>,\n): { sql: string; params: unknown[] } {\n\tconst columns = Object.keys(create)\n\tconst createParams = Object.values(create)\n\tconst placeholders = columns.map((_, i) => `$${i + 1}`)\n\tconst pgConflictCol = mapField(conflictColumn, primaryKey)\n\n\tlet setClause: string\n\tconst allParams = [...createParams]\n\n\tif (Object.keys(data).length > 0) {\n\t\tconst { setParts, params: setParams } = buildSetParts(data, columns.length + 1)\n\t\tsetClause = setParts.join(', ')\n\t\tallParams.push(...setParams)\n\t} else {\n\t\tsetClause = `\"${pgConflictCol}\" = EXCLUDED.\"${pgConflictCol}\"`\n\t}\n\n\tconst sql =\n\t\t`INSERT INTO \"${tableName}\" (${columns.map((c) => `\"${c}\"`).join(', ')}) VALUES (${placeholders.join(', ')}) ON CONFLICT (\"${pgConflictCol}\") DO UPDATE SET ${setClause} RETURNING *`.replace(\n\t\t\t/\\s+/g,\n\t\t\t' ',\n\t\t)\n\treturn { sql, params: allParams }\n}\n\nexport function extractUpsertConflictColumn(filter: FilterGroup, schemaName: string): string {\n\tif (filter.children.length === 1 && filter.children[0] instanceof Filter && filter.children[0].op === 'eq') {\n\t\treturn filter.children[0].field\n\t}\n\n\tlet description: string\n\tif (filter.children.length === 0) {\n\t\tdescription = 'empty filter'\n\t} else if (filter.children.length === 1) {\n\t\tconst child = filter.children[0]\n\t\tconst opDesc = child instanceof Filter ? child.op : 'group'\n\t\tdescription = `single non-eq filter (op: ${opDesc})`\n\t} else {\n\t\tdescription = `${filter.children.length} filter clauses`\n\t}\n\n\tthrow new OrmValidationError('upsert-filter-incompatible', schemaName, 'upsertOne', [\n\t\t{\n\t\t\tcause: `PostgreSQL upsert requires a single eq filter on a UNIQUE-indexed column; received ${description}`,\n\t\t},\n\t])\n}\n\nfunction aggFnToSql(fn: AggregateOpName, field: string | undefined, primaryKey: string): string {\n\tif (fn === 'count') return 'COUNT(*)'\n\tconst col = `\"${mapField(field!, primaryKey)}\"`\n\tswitch (fn) {\n\t\tcase 'countDistinct':\n\t\t\treturn `COUNT(DISTINCT ${col})`\n\t\tcase 'sum':\n\t\t\treturn `SUM(${col})`\n\t\tcase 'avg':\n\t\t\treturn `AVG(${col})`\n\t\tcase 'min':\n\t\t\treturn `MIN(${col})`\n\t\tcase 'max':\n\t\t\treturn `MAX(${col})`\n\t}\n}\n\nfunction resolveHavingField(\n\tfield: string,\n\tprimaryKey: string,\n\taliasToExpr: Map<string, string>,\n\tgroupBySet: Set<string>,\n): string {\n\tif (aliasToExpr.has(field)) return aliasToExpr.get(field)!\n\tif (groupBySet.has(field)) return `\"${mapField(field, primaryKey)}\"`\n\treturn `\"${field}\"`\n}\n\nexport function buildAggregateQuery(\n\tspec: AggregateSpec,\n\ttableName: string,\n\tprimaryKey: string,\n): { sql: string; params: unknown[] } {\n\tconst params: unknown[] = []\n\tlet paramIndex = 1\n\n\tfunction nextParam(value: unknown): string {\n\t\tparams.push(value)\n\t\treturn `$${paramIndex++}`\n\t}\n\n\tconst selectParts: string[] = []\n\tconst aliasToExpr = new Map<string, string>()\n\n\tfor (const agg of spec.aggregates) {\n\t\tconst expr = aggFnToSql(agg.fn, agg.field, primaryKey)\n\t\taliasToExpr.set(agg.alias, expr)\n\t\tselectParts.push(`${expr} AS \"${agg.alias}\"`)\n\t}\n\n\tconst groupByFields: string[] = []\n\tfor (const f of spec.groupBy) {\n\t\tconst col = `\"${mapField(f, primaryKey)}\"`\n\t\tgroupByFields.push(col)\n\t\tselectParts.push(`${col} AS \"${f}\"`)\n\t}\n\n\tlet whereClause = ''\n\tif (spec.where) {\n\t\tconst whereLeaf = (f: Filter) => compileFilter(f, primaryKey, nextParam)\n\t\tconst whereParts = compileChildren(spec.where, whereLeaf)\n\t\tif (whereParts.length > 0) whereClause = `WHERE ${whereParts.join(' AND ')}`\n\t}\n\n\tconst groupByClause = groupByFields.length > 0 ? `GROUP BY ${groupByFields.join(', ')}` : ''\n\n\tlet havingClause = ''\n\tif (spec.having) {\n\t\tconst groupBySet = new Set(spec.groupBy)\n\t\tconst havingLeaf = (f: Filter) =>\n\t\t\tcompileOps(f, resolveHavingField(f.field, primaryKey, aliasToExpr, groupBySet), nextParam)\n\t\tconst havingParts = compileChildren(spec.having, havingLeaf)\n\t\tif (havingParts.length > 0) havingClause = `HAVING ${havingParts.join(' AND ')}`\n\t}\n\n\tconst sql = `SELECT ${selectParts.join(', ')} FROM \"${tableName}\" ${whereClause} ${groupByClause} ${havingClause}`\n\t\t.trim()\n\t\t.replace(/\\s+/g, ' ')\n\treturn { sql, params }\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\tconst { IncOp, MulOp, MinOp, MaxOp, UnsetOp, PushOp, PullOp, PatchOp, SetOp, flattenOps } = await import('../../updates')\n\tconst { OrmValidationError } = await import('../../errors')\n\n\tdescribe('compilePgFilter', () => {\n\t\ttest('empty filter group compiles to empty WHERE clause', () => {\n\t\t\tconst group = FilterGroup.create()\n\t\t\tconst { sql } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toBe('SELECT * FROM \"users\"')\n\t\t})\n\n\t\ttest('single eq filter compiles to WHERE field = $1', () => {\n\t\t\tconst group = FilterGroup.create().eq('name', 'Alice')\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toBe('SELECT * FROM \"users\" WHERE \"name\" = $1')\n\t\t\texpect(params).toEqual(['Alice'])\n\t\t})\n\n\t\ttest('eq with null compiles to IS NULL', () => {\n\t\t\tconst group = FilterGroup.create().eq('name', null)\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toBe('SELECT * FROM \"users\" WHERE \"name\" IS NULL')\n\t\t\texpect(params).toEqual([])\n\t\t})\n\n\t\ttest('ne compiles to != (or IS NOT NULL for null)', () => {\n\t\t\tconst group = FilterGroup.create().ne('age', 5)\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toBe('SELECT * FROM \"users\" WHERE \"age\" != $1')\n\t\t\texpect(params).toEqual([5])\n\n\t\t\tconst nullGroup = FilterGroup.create().ne('age', null)\n\t\t\tconst { sql: nullSql } = buildSelectQuery(nullGroup, undefined, 'users', 'id')\n\t\t\texpect(nullSql).toBe('SELECT * FROM \"users\" WHERE \"age\" IS NOT NULL')\n\t\t})\n\n\t\ttest('gt, gte, lt, lte compile to >, >=, <, <=', () => {\n\t\t\texpect(buildSelectQuery(FilterGroup.create().gt('age', 10), undefined, 't', 'id').sql).toContain('\"age\" > $1')\n\t\t\texpect(buildSelectQuery(FilterGroup.create().gte('age', 20), undefined, 't', 'id').sql).toContain('\"age\" >= $1')\n\t\t\texpect(buildSelectQuery(FilterGroup.create().lt('age', 30), undefined, 't', 'id').sql).toContain('\"age\" < $1')\n\t\t\texpect(buildSelectQuery(FilterGroup.create().lte('age', 40), undefined, 't', 'id').sql).toContain('\"age\" <= $1')\n\t\t})\n\n\t\ttest('in compiles to = ANY($N)', () => {\n\t\t\tconst group = FilterGroup.create().in('status', ['a', 'b'])\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('\"status\" = ANY($1)')\n\t\t\texpect(params).toEqual([['a', 'b']])\n\t\t})\n\n\t\ttest('notIn compiles to NOT (field = ANY($N)) — canonical name notIn', () => {\n\t\t\tconst group = FilterGroup.create().notIn('status', ['x', 'y'])\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('NOT (\"status\" = ANY($1))')\n\t\t\texpect(params).toEqual([['x', 'y']])\n\t\t})\n\n\t\ttest('like compiles to ILIKE with % wrapping', () => {\n\t\t\tconst group = FilterGroup.create().like('name', 'ali')\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('\"name\" ILIKE $1')\n\t\t\texpect(params).toEqual(['%ali%'])\n\t\t})\n\n\t\ttest('exists compiles to IS NOT NULL (own op, not boolean form)', () => {\n\t\t\tconst group = FilterGroup.create().exists('val')\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('\"val\" IS NOT NULL')\n\t\t\texpect(params).toEqual([])\n\t\t})\n\n\t\ttest('notExists is its own op — compiles to IS NULL', () => {\n\t\t\tconst group = FilterGroup.create().notExists('val')\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('\"val\" IS NULL')\n\t\t\texpect(params).toEqual([])\n\t\t})\n\n\t\ttest('contains compiles to @> jsonb', () => {\n\t\t\tconst group = FilterGroup.create().contains('tags', ['a', 'b'])\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('\"tags\" @> $1::jsonb')\n\t\t\texpect(params).toEqual([JSON.stringify(['a', 'b'])])\n\t\t})\n\n\t\ttest('notContains compiles to NOT (@> jsonb)', () => {\n\t\t\tconst group = FilterGroup.create().notContains('tags', ['x'])\n\t\t\tconst { sql, params } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toContain('NOT (\"tags\" @> $1::jsonb)')\n\t\t\texpect(params).toEqual([JSON.stringify(['x'])])\n\t\t})\n\n\t\ttest('multiple clauses produce AND-joined WHERE', () => {\n\t\t\tconst group = FilterGroup.create().eq('a', 1).gt('b', 2)\n\t\t\tconst { sql } = buildSelectQuery(group, undefined, 't', 'id')\n\t\t\texpect(sql).toContain('WHERE \"a\" = $1 AND \"b\" > $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 { sql, params } = buildSelectQuery(group, undefined, 't', 'id')\n\t\t\texpect(sql).toContain('(\"a\" = $1 AND (\"b\" = $2 OR \"c\" = $3))')\n\t\t\texpect(params).toEqual([1, 2, 3])\n\t\t})\n\n\t\ttest('maps id field to primaryKey when primaryKey differs', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'abc')\n\t\t\tconst { sql } = buildSelectQuery(group, undefined, 'users', 'user_id')\n\t\t\texpect(sql).toContain('\"user_id\" = $1')\n\t\t})\n\t})\n\n\tdescribe('buildSelectQuery', () => {\n\t\ttest('options: sort, limit, offset, select', () => {\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 { sql, params } = buildSelectQuery(group, options, 'users', 'id')\n\t\t\texpect(sql).toContain('SELECT \"name\", \"age\"')\n\t\t\texpect(sql).toContain('ORDER BY \"name\" ASC, \"age\" DESC')\n\t\t\texpect(sql).toContain('LIMIT $2')\n\t\t\texpect(sql).toContain('OFFSET $3')\n\t\t\texpect(params).toEqual([true, 10, 5])\n\t\t})\n\n\t\ttest('undefined options returns basic SELECT *', () => {\n\t\t\tconst group = FilterGroup.create().eq('x', 1)\n\t\t\tconst { sql } = buildSelectQuery(group, undefined, 'users', 'id')\n\t\t\texpect(sql).toBe('SELECT * FROM \"users\" WHERE \"x\" = $1')\n\t\t})\n\t})\n\n\tdescribe('buildCreateQuery', () => {\n\t\ttest('produces INSERT with RETURNING *', () => {\n\t\t\tconst { sql, params } = buildCreateQuery('users', { name: 'Alice', age: 30 })\n\t\t\texpect(sql).toBe('INSERT INTO \"users\" (\"name\", \"age\") VALUES ($1, $2) RETURNING *')\n\t\t\texpect(params).toEqual(['Alice', 30])\n\t\t})\n\t})\n\n\tdescribe('buildUpdateQuery', () => {\n\t\ttest('plain values produce SET col = $N', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql, params } = buildUpdateQuery(group, 'users', 'id', { name: 'Bob', age: 25 })\n\t\t\texpect(sql).toBe('UPDATE \"users\" SET \"name\" = $1, \"age\" = $2 WHERE \"id\" = $3 RETURNING *')\n\t\t\texpect(params).toEqual(['Bob', 25, 'u1'])\n\t\t})\n\n\t\ttest('IncOp produces col = col + $N', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql, params } = buildUpdateQuery(group, 'users', 'id', { count: new IncOp('count', 5) })\n\t\t\texpect(sql).toContain('\"count\" = \"count\" + $1')\n\t\t\texpect(params[0]).toBe(5)\n\t\t})\n\n\t\ttest('MulOp produces col = col * $N', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql } = buildUpdateQuery(group, 'users', 'id', { score: new MulOp('score', 2) })\n\t\t\texpect(sql).toContain('\"score\" = \"score\" * $1')\n\t\t})\n\n\t\ttest('MinOp/MaxOp produce LEAST/GREATEST', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql } = buildUpdateQuery(group, 'users', 'id', {\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(sql).toContain('LEAST(\"lo\", $1)')\n\t\t\texpect(sql).toContain('GREATEST(\"hi\", $2)')\n\t\t})\n\n\t\ttest('UnsetOp produces col = NULL', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql } = buildUpdateQuery(group, 'users', 'id', { old: new UnsetOp('old') })\n\t\t\texpect(sql).toContain('\"old\" = NULL')\n\t\t})\n\n\t\ttest('PushOp produces jsonb array append', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql } = buildUpdateQuery(group, 'users', 'id', { tags: new PushOp('tags', 'new') })\n\t\t\texpect(sql).toContain('jsonb_build_array($1::jsonb)')\n\t\t})\n\n\t\ttest('PullOp produces jsonb array removal', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql } = buildUpdateQuery(group, 'users', 'id', { tags: new PullOp('tags', 'old') })\n\t\t\texpect(sql).toContain('jsonb_array_elements')\n\t\t})\n\n\t\ttest('PatchOp produces jsonb merge', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql } = buildUpdateQuery(group, 'users', 'id', { meta: new PatchOp('meta', { a: 1 }) })\n\t\t\texpect(sql).toContain('|| $1::jsonb')\n\t\t})\n\t})\n\n\tdescribe('buildPkUpdateQuery', () => {\n\t\ttest('builds UPDATE with PK WHERE clause', () => {\n\t\t\tconst { sql, params } = buildPkUpdateQuery('users', 'id', 'u1', { name: 'Bob' })\n\t\t\texpect(sql).toBe('UPDATE \"users\" SET \"name\" = $1 WHERE \"id\" = $2 RETURNING *')\n\t\t\texpect(params).toEqual(['Bob', 'u1'])\n\t\t})\n\n\t\ttest('handles ops in PK update', () => {\n\t\t\tconst { sql, params } = buildPkUpdateQuery('users', 'id', 'u1', { count: new IncOp('count', 3) })\n\t\t\texpect(sql).toContain('\"count\" = \"count\" + $1')\n\t\t\texpect(sql).toContain('WHERE \"id\" = $2')\n\t\t\texpect(params).toEqual([3, 'u1'])\n\t\t})\n\t})\n\n\tdescribe('buildDeleteQuery', () => {\n\t\ttest('produces DELETE with RETURNING *', () => {\n\t\t\tconst group = FilterGroup.create().eq('id', 'u1')\n\t\t\tconst { sql, params } = buildDeleteQuery(group, 'users', 'id')\n\t\t\texpect(sql).toBe('DELETE FROM \"users\" WHERE \"id\" = $1 RETURNING *')\n\t\t\texpect(params).toEqual(['u1'])\n\t\t})\n\t})\n\n\tdescribe('buildUpsertQuery', () => {\n\t\ttest('produces INSERT ON CONFLICT with SET parts from data', () => {\n\t\t\tconst data = flattenOps([new SetOp({ name: 'Updated' })])\n\t\t\tconst { sql, params } = buildUpsertQuery('users', 'email', 'id', { id: 'u1', email: 'a@b.com', name: 'Alice' }, data)\n\t\t\texpect(sql).toContain('INSERT INTO \"users\"')\n\t\t\texpect(sql).toContain('ON CONFLICT (\"email\") DO UPDATE SET')\n\t\t\texpect(sql).toContain('\"name\" = $4')\n\t\t\texpect(sql).toContain('RETURNING *')\n\t\t\texpect(params).toEqual(['u1', 'a@b.com', 'Alice', 'Updated'])\n\t\t})\n\n\t\ttest('empty data produces no-op SET on conflict column', () => {\n\t\t\tconst { sql, params } = buildUpsertQuery('users', 'email', 'id', { id: 'u1', email: 'a@b.com' }, {})\n\t\t\texpect(sql).toContain('ON CONFLICT (\"email\") DO UPDATE SET \"email\" = EXCLUDED.\"email\"')\n\t\t\texpect(params).toEqual(['u1', 'a@b.com'])\n\t\t})\n\n\t\ttest('maps conflict column via mapField when primaryKey differs', () => {\n\t\t\tconst { sql } = buildUpsertQuery('users', 'id', 'user_id', { user_id: 'u1', name: 'A' }, {})\n\t\t\texpect(sql).toContain('ON CONFLICT (\"user_id\")')\n\t\t})\n\n\t\ttest('handles ops in upsert SET clause', () => {\n\t\t\tconst data = flattenOps([new IncOp('views', 1)])\n\t\t\tconst { sql, params } = buildUpsertQuery('posts', 'slug', 'id', { id: 'p1', slug: 'hello', views: 0 }, data)\n\t\t\texpect(sql).toContain('\"views\" = \"views\" + $4')\n\t\t\texpect(params).toEqual(['p1', 'hello', 0, 1])\n\t\t})\n\t})\n\n\tdescribe('extractUpsertConflictColumn', () => {\n\t\ttest('extracts field from single eq filter', () => {\n\t\t\tconst filter = FilterGroup.create().eq('email', 'a@b.com')\n\t\t\texpect(extractUpsertConflictColumn(filter, 'users')).toBe('email')\n\t\t})\n\n\t\ttest('throws upsert-filter-incompatible on empty filter', () => {\n\t\t\tconst filter = FilterGroup.create()\n\t\t\texpect(() => extractUpsertConflictColumn(filter, 'users')).toThrow(OrmValidationError)\n\t\t\ttry {\n\t\t\t\textractUpsertConflictColumn(filter, 'users')\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('upsert-filter-incompatible')\n\t\t\t\texpect(err.schema).toBe('users')\n\t\t\t\texpect(err.operation).toBe('upsertOne')\n\t\t\t\texpect(err.failures[0].cause).toContain('empty filter')\n\t\t\t}\n\t\t})\n\n\t\ttest('throws upsert-filter-incompatible on multiple filters', () => {\n\t\t\tconst filter = FilterGroup.create().eq('a', 1).eq('b', 2)\n\t\t\texpect(() => extractUpsertConflictColumn(filter, 'users')).toThrow(OrmValidationError)\n\t\t\ttry {\n\t\t\t\textractUpsertConflictColumn(filter, 'users')\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('upsert-filter-incompatible')\n\t\t\t\texpect(err.failures[0].cause).toContain('2 filter clauses')\n\t\t\t}\n\t\t})\n\n\t\ttest('throws upsert-filter-incompatible on non-eq filter', () => {\n\t\t\tconst filter = FilterGroup.create().gt('age', 10)\n\t\t\texpect(() => extractUpsertConflictColumn(filter, 'users')).toThrow(OrmValidationError)\n\t\t\ttry {\n\t\t\t\textractUpsertConflictColumn(filter, 'users')\n\t\t\t} catch (e) {\n\t\t\t\tconst err = e as OrmValidationError\n\t\t\t\texpect(err.kind).toBe('upsert-filter-incompatible')\n\t\t\t\texpect(err.failures[0].cause).toContain('non-eq filter')\n\t\t\t}\n\t\t})\n\n\t\ttest('throws with clear message naming received filter shape', () => {\n\t\t\tconst filter = FilterGroup.create().in('status', ['a', 'b'])\n\t\t\ttry {\n\t\t\t\textractUpsertConflictColumn(filter, 'test')\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('upsert-filter-incompatible')\n\t\t\t\texpect(err.failures[0].cause).toContain('single eq filter')\n\t\t\t\texpect(err.failures[0].cause).toContain('UNIQUE-indexed column')\n\t\t\t}\n\t\t})\n\t})\n\n\tdescribe('buildAggregateQuery', () => {\n\t\ttest('bare count produces SELECT COUNT(*) AS alias', () => {\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{ aggregates: [{ fn: 'count', alias: 'total' }], groupBy: [] },\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe('SELECT COUNT(*) AS \"total\" FROM \"orders\"')\n\t\t\texpect(params).toEqual([])\n\t\t})\n\n\t\ttest('multi-aggregator produces all functions', () => {\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [\n\t\t\t\t\t\t{ fn: 'count', alias: 'cnt' },\n\t\t\t\t\t\t{ fn: 'sum', field: 'amount', alias: 'revenue' },\n\t\t\t\t\t\t{ fn: 'avg', field: 'amount', alias: 'avgAmt' },\n\t\t\t\t\t\t{ fn: 'min', field: 'amount', alias: 'lo' },\n\t\t\t\t\t\t{ fn: 'max', field: 'amount', alias: 'hi' },\n\t\t\t\t\t],\n\t\t\t\t\tgroupBy: [],\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe(\n\t\t\t\t'SELECT COUNT(*) AS \"cnt\", SUM(\"amount\") AS \"revenue\", AVG(\"amount\") AS \"avgAmt\", MIN(\"amount\") AS \"lo\", MAX(\"amount\") AS \"hi\" FROM \"orders\"',\n\t\t\t)\n\t\t\texpect(params).toEqual([])\n\t\t})\n\n\t\ttest('countDistinct produces COUNT(DISTINCT col)', () => {\n\t\t\tconst { sql } = buildAggregateQuery(\n\t\t\t\t{ aggregates: [{ fn: 'countDistinct', field: 'category', alias: 'unique' }], groupBy: [] },\n\t\t\t\t'items',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe('SELECT COUNT(DISTINCT \"category\") AS \"unique\" FROM \"items\"')\n\t\t})\n\n\t\ttest('single-column groupBy produces GROUP BY clause', () => {\n\t\t\tconst { sql } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'count', alias: 'cnt' }],\n\t\t\t\t\tgroupBy: ['region'],\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe('SELECT COUNT(*) AS \"cnt\", \"region\" AS \"region\" FROM \"orders\" GROUP BY \"region\"')\n\t\t})\n\n\t\ttest('multi-column groupBy produces all GROUP BY columns', () => {\n\t\t\tconst { sql } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'count', alias: 'cnt' }],\n\t\t\t\t\tgroupBy: ['region', 'product'],\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe(\n\t\t\t\t'SELECT COUNT(*) AS \"cnt\", \"region\" AS \"region\", \"product\" AS \"product\" FROM \"orders\" GROUP BY \"region\", \"product\"',\n\t\t\t)\n\t\t})\n\n\t\ttest('where-only produces WHERE clause with params', () => {\n\t\t\tconst where = FilterGroup.create().eq('status', 'active')\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{ aggregates: [{ fn: 'count', alias: 'total' }], groupBy: [], where },\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe('SELECT COUNT(*) AS \"total\" FROM \"orders\" WHERE \"status\" = $1')\n\t\t\texpect(params).toEqual(['active'])\n\t\t})\n\n\t\ttest('having-only filters on aggregate alias via repeated expression', () => {\n\t\t\tconst having = FilterGroup.create().gt('total', 10)\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'count', alias: 'total' }],\n\t\t\t\t\tgroupBy: ['region'],\n\t\t\t\t\thaving,\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe(\n\t\t\t\t'SELECT COUNT(*) AS \"total\", \"region\" AS \"region\" FROM \"orders\" GROUP BY \"region\" HAVING COUNT(*) > $1',\n\t\t\t)\n\t\t\texpect(params).toEqual([10])\n\t\t})\n\n\t\ttest('where + having both produce correct param ordering', () => {\n\t\t\tconst where = FilterGroup.create().eq('status', 'active')\n\t\t\tconst having = FilterGroup.create().gte('revenue', 1000)\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'sum', field: 'amount', alias: 'revenue' }],\n\t\t\t\t\tgroupBy: ['region'],\n\t\t\t\t\twhere,\n\t\t\t\t\thaving,\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe(\n\t\t\t\t'SELECT SUM(\"amount\") AS \"revenue\", \"region\" AS \"region\" FROM \"orders\" WHERE \"status\" = $1 GROUP BY \"region\" HAVING SUM(\"amount\") >= $2',\n\t\t\t)\n\t\t\texpect(params).toEqual(['active', 1000])\n\t\t})\n\n\t\ttest('having on groupBy field uses column name directly', () => {\n\t\t\tconst having = FilterGroup.create().eq('region', 'US')\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'count', alias: 'cnt' }],\n\t\t\t\t\tgroupBy: ['region'],\n\t\t\t\t\thaving,\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toBe(\n\t\t\t\t'SELECT COUNT(*) AS \"cnt\", \"region\" AS \"region\" FROM \"orders\" GROUP BY \"region\" HAVING \"region\" = $1',\n\t\t\t)\n\t\t\texpect(params).toEqual(['US'])\n\t\t})\n\n\t\ttest('field-name mapping: id maps to primaryKey when primaryKey differs', () => {\n\t\t\tconst { sql } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'countDistinct', field: 'id', alias: 'uniqueIds' }],\n\t\t\t\t\tgroupBy: [],\n\t\t\t\t},\n\t\t\t\t'users',\n\t\t\t\t'user_id',\n\t\t\t)\n\t\t\texpect(sql).toBe('SELECT COUNT(DISTINCT \"user_id\") AS \"uniqueIds\" FROM \"users\"')\n\t\t})\n\n\t\ttest('groupBy with id field maps to primaryKey', () => {\n\t\t\tconst { sql } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'count', alias: 'cnt' }],\n\t\t\t\t\tgroupBy: ['id'],\n\t\t\t\t},\n\t\t\t\t'users',\n\t\t\t\t'user_id',\n\t\t\t)\n\t\t\texpect(sql).toContain('GROUP BY \"user_id\"')\n\t\t\texpect(sql).toContain('\"user_id\" AS \"id\"')\n\t\t})\n\n\t\ttest('complex having with AND/OR groups', () => {\n\t\t\tconst having = FilterGroup.create().and([\n\t\t\t\t(q) => q.gt('cnt', 5),\n\t\t\t\t(q) => q.or([(g) => g.eq('region', 'US'), (g) => g.eq('region', 'EU')]),\n\t\t\t])\n\t\t\tconst { sql, params } = buildAggregateQuery(\n\t\t\t\t{\n\t\t\t\t\taggregates: [{ fn: 'count', alias: 'cnt' }],\n\t\t\t\t\tgroupBy: ['region'],\n\t\t\t\t\thaving,\n\t\t\t\t},\n\t\t\t\t'orders',\n\t\t\t\t'id',\n\t\t\t)\n\t\t\texpect(sql).toContain('HAVING (COUNT(*) > $1 AND (\"region\" = $2 OR \"region\" = $3))')\n\t\t\texpect(params).toEqual([5, 'US', 'EU'])\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":["EquippedError","init_equippedError","__esmMin","message","context","cause","init_requestError","__esmMin","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","init_hooks","__esmMin","import_valleyed","instanceSettingsPipe","init_settings","__esmMin","import_pino","import_ulid","import_valleyed","Instance","init_instance","__esmMin","init_errors","init_hooks","init_settings","_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","init_badRequestError","__esmMin","init_notAuthenticatedError","__esmMin","init_notAuthorizedError","__esmMin","init_notFoundError","__esmMin","init_preconditionRequiredError","__esmMin","init_tokenExpired","__esmMin","init_validationError","__esmMin","init_errors","__esmMin","init_equippedError","init_requestError","init_badRequestError","init_notAuthenticatedError","init_notAuthorizedError","init_notFoundError","init_preconditionRequiredError","init_tokenExpired","init_validationError","introspection_exports","__export","OrmIntrospectionError","init_introspection","__esmMin","init_errors","EquippedError","opts","postgresql_exports","__export","PostgresAdapter","__toCommonJS","import_node_async_hooks","import_pg","import_pg_cursor","import_valleyed","init_errors","import_valleyed","Field","name","path","toFieldName","field","Filter","field","op","value","toFieldName","FilterGroup","_FilterGroup","children","#withChild","child","facFns","EquippedError","group","fn","c","init_errors","OrmValidationError","EquippedError","kind","schema","operation","failures","SetOp","values","IncOp","field","value","MulOp","MinOp","MaxOp","UnsetOp","PushOp","PullOp","PatchOp","flattenOps","ops","data","op","SetOp","mapField","field","primaryKey","compileOps","f","nextParam","compileFilter","compileChildren","group","compileLeaf","c","compileChild","compileGroup","parts","child","Filter","FilterGroup","compilePgFilter","startIndex","params","paramIndex","value","whereParts","buildSetParts","data","key","col","IncOp","MulOp","MinOp","MaxOp","UnsetOp","PushOp","PullOp","PatchOp","buildSelectQuery","options","tableName","whereClause","nextParamIndex","i","orderParts","o","orderClause","limitClause","offsetClause","buildCountQuery","buildCreateQuery","keys","placeholders","_","columns","k","buildUpdateQuery","setParts","setParams","whereParams","buildPkUpdateQuery","pk","buildDeleteQuery","buildUpsertQuery","conflictColumn","create","createParams","pgConflictCol","setClause","allParams","extractUpsertConflictColumn","filter","schemaName","description","OrmValidationError","aggFnToSql","fn","resolveHavingField","aliasToExpr","groupBySet","buildAggregateQuery","spec","selectParts","agg","expr","groupByFields","whereLeaf","groupByClause","havingClause","havingLeaf","havingParts","init_errors","import_valleyed","configurable","pipeFn","base","pipe","Configurable","config","baseArgs","input","args","r","init_errors","init_instance","OrmAdapter","err","wrapped","EquippedError","Instance","self","schema","config","emptyIterator","use","filter","opts","d","match","pk","pkFilter","FilterGroup","create","ops","row","args","spec","postgresqlConnectionPipe","TRACKER_TABLE","ADVISORY_LOCK_KEY","DEFAULT_CURSOR_BATCH_SIZE","FIELD_TYPE_TO_PG","PG_TO_FIELD_TYPE","PostgresAdapter","configurable","OrmAdapter","#sessionStore","config","#getClient","#resolveTableName","error","EquippedError","schema","pk","c","tableName","pkName","_schema","data","client","results","doc","sql","params","buildCreateQuery","result","ops","flattenOps","buildPkUpdateQuery","command","filter","options","buildSelectQuery","buildCountQuery","releaseClient","cursor","sessionClient","Cursor","batchSize","rows","row","buildUpdateQuery","buildDeleteQuery","create","conflictColumn","extractUpsertConflictColumn","buildUpsertQuery","spec","buildAggregateQuery","mapped","agg","val","field","id","appliedAt","fn","change","pkType","cols","f","#renderColumnDef","colDef","table","col","newType","#renderDefault","name","#deriveIndexName","unique","#renderFkAction","OrmIntrospectionError","tablesResult","schemas","tableRow","colsResult","pkColName","uniqueResult","uniqueCols","r","fields","pgType","fieldType","nullable","raw","def","#parseDefault","idxResult","indexes","idx","idxName","idxDef","colMatch","fkResult","foreignKeys","fk","#parseFkAction","base","action","rule","numMatch","strMatch"]}