express-file-cluster 0.11.0 → 0.12.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/auth/index.cjs +8 -7
- package/dist/auth/index.cjs.map +1 -1
- package/dist/auth/index.d.cts +1 -1
- package/dist/auth/index.d.ts +1 -1
- package/dist/auth/index.js +7 -5
- package/dist/{chunk-JBOMTZT5.js → chunk-3JQWQF2M.js} +3 -3
- package/dist/chunk-3ROVNEDR.js +20 -0
- package/dist/chunk-3ROVNEDR.js.map +1 -0
- package/dist/{chunk-WHBSVYUY.cjs → chunk-4FQP6QX3.cjs} +3 -3
- package/dist/{chunk-WHBSVYUY.cjs.map → chunk-4FQP6QX3.cjs.map} +1 -1
- package/dist/chunk-546TNO2V.js +226 -0
- package/dist/chunk-546TNO2V.js.map +1 -0
- package/dist/{chunk-EJDZZ4KX.js → chunk-74R37C4I.js} +48 -21
- package/dist/chunk-74R37C4I.js.map +1 -0
- package/dist/{chunk-H2PVWCWC.cjs → chunk-A2QGDWCG.cjs} +15 -8
- package/dist/chunk-A2QGDWCG.cjs.map +1 -0
- package/dist/{chunk-DGYPIIJE.cjs → chunk-AG7PVYPE.cjs} +90 -64
- package/dist/chunk-AG7PVYPE.cjs.map +1 -0
- package/dist/{chunk-O2E7H2XA.js → chunk-BCSJOPYH.js} +2 -2
- package/dist/{chunk-OM2XJJWX.js → chunk-EBJELA7T.js} +30 -25
- package/dist/chunk-EBJELA7T.js.map +1 -0
- package/dist/{chunk-IEF6AEK3.cjs → chunk-H6MHRHUP.cjs} +104 -50
- package/dist/chunk-H6MHRHUP.cjs.map +1 -0
- package/dist/chunk-I2IVJURJ.cjs +20 -0
- package/dist/chunk-I2IVJURJ.cjs.map +1 -0
- package/dist/{chunk-6WTMRZS7.cjs → chunk-IG3V2IOK.cjs} +57 -30
- package/dist/chunk-IG3V2IOK.cjs.map +1 -0
- package/dist/chunk-JAPZYQVJ.cjs +143 -0
- package/dist/chunk-JAPZYQVJ.cjs.map +1 -0
- package/dist/{chunk-QSIP7YLW.cjs → chunk-JHCXIYJH.cjs} +25 -48
- package/dist/chunk-JHCXIYJH.cjs.map +1 -0
- package/dist/{chunk-GWMW6XY7.cjs → chunk-JVB5NLEM.cjs} +15 -13
- package/dist/chunk-JVB5NLEM.cjs.map +1 -0
- package/dist/chunk-PUM5ZDAH.js +140 -0
- package/dist/chunk-PUM5ZDAH.js.map +1 -0
- package/dist/{chunk-CGY7JU4Y.cjs → chunk-PUYBKDYD.cjs} +11 -2
- package/dist/chunk-PUYBKDYD.cjs.map +1 -0
- package/dist/{chunk-336IU55W.js → chunk-QLM3JEER.js} +5 -3
- package/dist/{chunk-336IU55W.js.map → chunk-QLM3JEER.js.map} +1 -1
- package/dist/{chunk-SOU3PBJC.cjs → chunk-SV4C4HWP.cjs} +89 -89
- package/dist/{chunk-SOU3PBJC.cjs.map → chunk-SV4C4HWP.cjs.map} +1 -1
- package/dist/{chunk-2IDRC7RK.js → chunk-UJ2ISRLP.js} +11 -34
- package/dist/chunk-UJ2ISRLP.js.map +1 -0
- package/dist/chunk-URKE3OXN.cjs +226 -0
- package/dist/chunk-URKE3OXN.cjs.map +1 -0
- package/dist/{chunk-DTMDJGRW.cjs → chunk-VLGN3XUM.cjs} +40 -35
- package/dist/chunk-VLGN3XUM.cjs.map +1 -0
- package/dist/{chunk-R6GPQZLI.js → chunk-X2B7WBKH.js} +88 -34
- package/dist/chunk-X2B7WBKH.js.map +1 -0
- package/dist/chunk-Y7I2633P.js +12 -0
- package/dist/chunk-Y7I2633P.js.map +1 -0
- package/dist/{chunk-B6MB6HEG.js → chunk-ZBQUYFI3.js} +14 -7
- package/dist/chunk-ZBQUYFI3.js.map +1 -0
- package/dist/{chunk-LECHRAU3.js → chunk-ZU2GK5WY.js} +84 -58
- package/dist/chunk-ZU2GK5WY.js.map +1 -0
- package/dist/cli/db-runner.cjs +26 -25
- package/dist/cli/db-runner.cjs.map +1 -1
- package/dist/cli/db-runner.js +5 -3
- package/dist/cli/db-runner.js.map +1 -1
- package/dist/cli/index.cjs +20 -16
- package/dist/cli/index.cjs.map +1 -1
- package/dist/cli/index.js +13 -8
- package/dist/cli/index.js.map +1 -1
- package/dist/docs/api-reference/auth.md +2 -0
- package/dist/docs/api-reference/ignite.md +4 -0
- package/dist/docs/api-reference/tasks.md +6 -2
- package/dist/docs/api-reference/testing.md +2 -0
- package/dist/docs/api-reference/tracing.md +18 -0
- package/dist/docs/cli/add.md +1 -1
- package/dist/docs/cli/diagnostics.md +1 -1
- package/dist/docs/cli/index.md +1 -1
- package/dist/docs/core-concepts/background-tasks.md +7 -1
- package/dist/docs/core-concepts/file-based-routing.md +4 -0
- package/dist/docs/core-concepts/middleware.md +2 -0
- package/dist/docs/guides/caching.md +12 -0
- package/dist/docs/guides/error-handling.md +2 -0
- package/dist/docs/guides/feature-matrix.md +7 -0
- package/dist/docs/guides/logging.md +2 -0
- package/dist/docs/guides/tracing.md +64 -0
- package/dist/docs/index.md +2 -1
- package/dist/docs/skills/SKILL.md +5 -3
- package/dist/docs/skills/api-surface.md +8 -0
- package/dist/docs/skills/auth-internals.md +4 -2
- package/dist/docs/skills/pre-flight.md +4 -0
- package/dist/docs/skills/routing-rules.md +3 -1
- package/dist/docs/skills/tasks-internals.md +12 -4
- package/dist/docs/skills/what-not-to-invent.md +2 -0
- package/dist/index.cjs +167 -71
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +5 -14
- package/dist/index.d.ts +5 -14
- package/dist/index.js +124 -27
- package/dist/index.js.map +1 -1
- package/dist/pgboss-backend-5DXF4G22.js +16 -0
- package/dist/pgboss-backend-KRTFHRNZ.cjs +16 -0
- package/dist/pgboss-backend-KRTFHRNZ.cjs.map +1 -0
- package/dist/registry/index.json +1 -1
- package/dist/tasks/index.cjs +3 -3
- package/dist/tasks/index.d.cts +2 -2
- package/dist/tasks/index.d.ts +2 -2
- package/dist/tasks/index.js +2 -1
- package/dist/testing.cjs +16 -14
- package/dist/testing.cjs.map +1 -1
- package/dist/testing.d.cts +2 -1
- package/dist/testing.d.ts +2 -1
- package/dist/testing.js +10 -7
- package/dist/testing.js.map +1 -1
- package/dist/thread-runner.cjs +5 -4
- package/dist/thread-runner.cjs.map +1 -1
- package/dist/thread-runner.d.cts +1 -1
- package/dist/thread-runner.d.ts +1 -1
- package/dist/thread-runner.js +4 -2
- package/dist/{types-D3QmZgeX.d.ts → types-Bgeqpm-n.d.cts} +12 -1
- package/dist/{types-D3QmZgeX.d.cts → types-Bgeqpm-n.d.ts} +12 -1
- package/package.json +7 -3
- package/dist/chunk-2IDRC7RK.js.map +0 -1
- package/dist/chunk-3SWI46YK.js +0 -74
- package/dist/chunk-3SWI46YK.js.map +0 -1
- package/dist/chunk-6WTMRZS7.cjs.map +0 -1
- package/dist/chunk-B6MB6HEG.js.map +0 -1
- package/dist/chunk-CGY7JU4Y.cjs.map +0 -1
- package/dist/chunk-DGYPIIJE.cjs.map +0 -1
- package/dist/chunk-DTMDJGRW.cjs.map +0 -1
- package/dist/chunk-EJDZZ4KX.js.map +0 -1
- package/dist/chunk-GWMW6XY7.cjs.map +0 -1
- package/dist/chunk-H2PVWCWC.cjs.map +0 -1
- package/dist/chunk-IEF6AEK3.cjs.map +0 -1
- package/dist/chunk-LECHRAU3.js.map +0 -1
- package/dist/chunk-OM2XJJWX.js.map +0 -1
- package/dist/chunk-QSIP7YLW.cjs.map +0 -1
- package/dist/chunk-R6GPQZLI.js.map +0 -1
- package/dist/chunk-RPL2IFWK.cjs +0 -77
- package/dist/chunk-RPL2IFWK.cjs.map +0 -1
- package/dist/pgboss-backend-PQW6I3VF.js +0 -14
- package/dist/pgboss-backend-QVXISTLP.cjs +0 -15
- package/dist/pgboss-backend-QVXISTLP.cjs.map +0 -1
- /package/dist/{chunk-JBOMTZT5.js.map → chunk-3JQWQF2M.js.map} +0 -0
- /package/dist/{chunk-O2E7H2XA.js.map → chunk-BCSJOPYH.js.map} +0 -0
- /package/dist/{pgboss-backend-PQW6I3VF.js.map → pgboss-backend-5DXF4G22.js.map} +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JHCXIYJH.cjs","../src/logger.ts","../src/db/query-log.ts","../src/db/prepared-statements.ts","../src/db/postgres.ts"],"names":["pool"],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JHCXIYJH.cjs","sourcesContent":[null,"import { traceLogFields } from './tracing.js';\nimport cluster from 'node:cluster';\nimport { randomUUID } from 'node:crypto';\nimport type { RequestHandler } from 'express';\nimport pc from 'picocolors';\nimport { pino, type Logger, type DestinationStream } from 'pino';\nimport type { LoggingConfig } from './types.js';\nimport { getRequestContext } from './context.js';\n\nexport type { Logger };\n\nconst LEVEL_LABELS: Record<number, string> = {\n 10: pc.gray('TRACE'),\n 20: pc.blue('DEBUG'),\n 30: pc.green('INFO '),\n 40: pc.yellow('WARN '),\n 50: pc.red('ERROR'),\n 60: pc.bgRed('FATAL'),\n};\n\nconst OMIT = new Set(['level', 'time', 'msg', 'pid', 'hostname', 'worker', 'reqId']);\n\n// Dev-friendly one-line renderer, so readable output doesn't need pino-pretty or a\n// transport worker thread: `12:00:01 INFO [w2] a1b2c3d4 GET /users 200 (3ms)`.\nfunction prettyStream(out: NodeJS.WritableStream = process.stdout): DestinationStream {\n return {\n write(line: string) {\n let rec: Record<string, unknown>;\n try {\n rec = JSON.parse(line) as Record<string, unknown>;\n } catch {\n out.write(line);\n return;\n }\n const time = new Date(rec['time'] as number).toTimeString().slice(0, 8);\n const level = LEVEL_LABELS[rec['level'] as number] ?? String(rec['level']);\n const worker = rec['worker'] !== undefined ? pc.dim(`[${String(rec['worker'])}] `) : '';\n const reqId = rec['reqId'] ? pc.magenta(String(rec['reqId']).slice(0, 8)) + ' ' : '';\n const extra = Object.entries(rec).filter(([k]) => !OMIT.has(k));\n const err = rec['err'] as { stack?: string } | undefined;\n const fields = extra\n .filter(([k]) => k !== 'err')\n .map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`)\n .join(' ');\n out.write(\n `${pc.dim(time)} ${level} ${worker}${reqId}${String(rec['msg'] ?? '')}` +\n (fields ? ' ' + pc.dim(fields) : '') +\n (err?.stack ? '\\n' + pc.red(err.stack) : '') +\n '\\n',\n );\n },\n };\n}\n\nfunction workerLabel(): string {\n return cluster.isWorker ? `w${cluster.worker?.id ?? '?'}` : 'primary';\n}\n\nfunction build(config: LoggingConfig | false | undefined): Logger {\n if (config === false) return pino({ level: 'silent' });\n const opts = config ?? {};\n const pretty =\n opts.pretty ?? (process.env['NODE_ENV'] !== 'production' && process.stdout.isTTY === true);\n const base = { worker: workerLabel() };\n const level = opts.level ?? 'info';\n return pretty\n ? pino({ level, base, errorKey: 'err' }, prettyStream())\n : pino({ level, base, errorKey: 'err', timestamp: pino.stdTimeFunctions.isoTime });\n}\n\nlet rootLogger: Logger = build(undefined);\nlet logRequests = true;\n\n/** Called by ignite() during Pre-Flight; before that the defaults apply. */\nexport function configureLogger(config: LoggingConfig | false | undefined): void {\n rootLogger = build(config);\n logRequests = config !== false && (config?.requests ?? true);\n}\n\n/**\n * The logger for the current scope: inside a request it is a child carrying that\n * request's `reqId`, so everything logged while handling it can be correlated;\n * elsewhere (startup, task handlers, timers) it is the root logger.\n */\nexport function getLogger(): Logger {\n const log = getRequestContext()?.log ?? rootLogger;\n const fields = traceLogFields();\n return fields.span_id && log.bindings().span_id !== fields.span_id ? log.child(fields) : log;\n}\n\n/** Root logger proxy — always reflects the latest configureLogger() call. */\nexport const logger: Logger = new Proxy({} as Logger, {\n get(_t, prop) {\n const target = getLogger() as unknown as Record<PropertyKey, unknown>;\n const value = target[prop];\n return typeof value === 'function'\n ? (value as (...a: unknown[]) => unknown).bind(target)\n : value;\n },\n});\n\nconst SAFE_REQUEST_ID = /^[\\w.:-]{1,128}$/;\n\n/**\n * Assigns the request ID (trusting a well-formed incoming `X-Request-Id`, e.g. from\n * a load balancer), echoes it back, attaches `req.id` / `req.log`, and logs one\n * line per completed request. Must run inside the request's context.\n */\nexport function requestLogger(): RequestHandler {\n return (req, res, next) => {\n const incoming = req.get('x-request-id');\n const id = incoming && SAFE_REQUEST_ID.test(incoming) ? incoming : randomUUID();\n const log = rootLogger.child({ reqId: id, ...traceLogFields() });\n\n req.id = id;\n req.log = log;\n res.setHeader('X-Request-Id', id);\n const ctx = getRequestContext();\n if (ctx) {\n ctx.requestId = id;\n ctx.log = log;\n }\n\n if (logRequests) {\n const start = process.hrtime.bigint();\n res.on('finish', () => {\n const durationMs = Number(process.hrtime.bigint() - start) / 1e6;\n const status = res.statusCode;\n const line = {\n method: req.method,\n url: req.originalUrl,\n status,\n durationMs: Math.round(durationMs * 10) / 10,\n };\n const msg = `${req.method} ${req.originalUrl} ${status}`;\n if (status >= 500) log.error(line, msg);\n else if (status >= 400) log.warn(line, msg);\n else log.info(line, msg);\n });\n }\n next();\n };\n}\n\ndeclare module 'express-serve-static-core' {\n interface Request {\n /** Request ID — the incoming `X-Request-Id` if well-formed, else a UUID. */\n id: string;\n /** Logger bound to this request's ID. */\n log: Logger;\n }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { LoggingConfig } from '../types.js';\nimport { getRequestContext } from '../context.js';\nimport { getLogger } from '../logger.js';\n\n// Query logging (`logging.queries`): one event per model operation — model, operation,\n// duration, how many database statements it issued, and the request ID — plus slow-query\n// warnings and an N+1 detector. Statements are counted at the driver: Drizzle's logger on\n// PostgreSQL, mongoose's debug hook on MongoDB.\n\n/** One finished model operation. */\nexport interface QueryEvent {\n model: string;\n op: string;\n durationMs: number;\n /** Database statements (SQL statements / MongoDB commands) issued, nested calls included. */\n statements: number;\n /** The request it ran in, if any. */\n reqId?: string;\n /** Set when it threw. */\n error?: string;\n}\n\n/** Aggregated per-process model operation statistics; never contains SQL/parameter values. */\nexport interface QueryMetric {\n model: string;\n op: string;\n calls: number;\n errors: number;\n statements: number;\n totalMs: number;\n minMs: number;\n maxMs: number;\n meanMs: number;\n slow: number;\n}\nexport interface QueryMetricsSnapshot {\n enabled: boolean;\n since: number;\n dropped: number;\n entries: ReadonlyArray<QueryMetric>;\n}\nconst metrics = new Map<string, QueryMetric>();\nlet metricsSince = Date.now();\nlet metricsDropped = 0;\n\n/** Returns detached, deterministically ordered counters; no logs or SQL are exposed. */\nexport function getQueryMetrics(): QueryMetricsSnapshot {\n return {\n enabled: !!config?.metricsLimit,\n since: metricsSince,\n dropped: metricsDropped,\n entries: [...metrics.values()]\n .map((entry) => ({ ...entry }))\n .sort((a, b) => a.model.localeCompare(b.model) || a.op.localeCompare(b.op)),\n };\n}\n/** Clears this process's counters/window; does not disable collection. */\nexport function resetQueryMetrics(): void {\n metrics.clear();\n metricsDropped = 0;\n metricsSince = Date.now();\n}\nfunction collectMetric(event: QueryEvent): void {\n if (!config?.metricsLimit) return;\n const key = event.model + '\\0' + event.op;\n let metric = metrics.get(key);\n if (!metric) {\n if (metrics.size >= config.metricsLimit) {\n metricsDropped++;\n return;\n }\n metric = {\n model: event.model,\n op: event.op,\n calls: 0,\n errors: 0,\n statements: 0,\n totalMs: 0,\n minMs: event.durationMs,\n maxMs: event.durationMs,\n meanMs: 0,\n slow: 0,\n };\n metrics.set(key, metric);\n }\n metric.calls++;\n if (event.error !== undefined) metric.errors++;\n metric.statements += event.statements;\n metric.totalMs += event.durationMs;\n metric.minMs = Math.min(metric.minMs, event.durationMs);\n metric.maxMs = Math.max(metric.maxMs, event.durationMs);\n metric.meanMs = metric.totalMs / metric.calls;\n if (event.durationMs >= config.slowMs) metric.slow++;\n}\n\ninterface Resolved {\n all: boolean;\n slowMs: number;\n nPlusOne: number | false;\n metricsLimit: number;\n}\n\nconst DEFAULTS = { slowMs: 500, nPlusOne: 10 } as const;\n\nlet config: Resolved | undefined;\nconst listeners = new Set<(event: QueryEvent) => void>();\nconst enableHooks: (() => void)[] = [];\n\n/** Called by ignite() during Pre-Flight, next to configureLogger(). */\nexport function configureQueryLog(logging: LoggingConfig | false | undefined): void {\n const q = logging === false ? undefined : logging?.queries;\n config = !q\n ? undefined\n : q === true\n ? { all: true, ...DEFAULTS, metricsLimit: 0 }\n : {\n all: q.all ?? false,\n slowMs: q.slowMs ?? DEFAULTS.slowMs,\n nPlusOne: q.nPlusOne ?? DEFAULTS.nPlusOne,\n metricsLimit: !q.metrics\n ? 0\n : typeof q.metrics === 'object'\n ? (q.metrics.maxEntries ?? 1000)\n : 1000,\n };\n if (config && (!Number.isSafeInteger(config.metricsLimit) || config.metricsLimit < 0)) {\n config = undefined;\n resetQueryMetrics();\n throw new Error('[EFC] logging.queries.metrics.maxEntries must be a nonnegative safe integer');\n }\n resetQueryMetrics();\n if (config) for (const hook of enableHooks) hook();\n}\n\nfunction active(): boolean {\n return config !== undefined || listeners.size > 0;\n}\n\n/**\n * Receives every model operation while subscribed (whether or not `logging.queries` is\n * on). Returns the unsubscribe function. Internal — tests use it to count statements.\n */\nexport function onQuery(listener: (event: QueryEvent) => void): () => void {\n listeners.add(listener);\n for (const hook of enableHooks) hook();\n return () => listeners.delete(listener);\n}\n\n/** Registers a driver hook to install once query tracking is first needed. */\nexport function whenQueryTracking(install: () => void): void {\n enableHooks.push(install);\n if (active()) install();\n}\n\ninterface Frame {\n statements: number;\n parent: Frame | undefined;\n}\n\nconst frames = new AsyncLocalStorage<Frame | undefined>();\n\n/** Called by the driver hooks for each statement sent to the database. */\nexport function countStatement(): void {\n for (let f = frames.getStore(); f; f = f.parent) f.statements++;\n}\n\n/** Runs `fn` outside any operation, so its statements (e.g. auto-sync) are not counted. */\nexport function untracked<R>(fn: () => R): R {\n return frames.run(undefined, fn);\n}\n\n// The first stack frame outside EFC: the line in the app that made the call.\nfunction callSite(callee: (...args: never[]) => unknown): string | undefined {\n const holder: { stack?: string } = {};\n Error.captureStackTrace(holder, callee);\n const line = holder.stack?.split('\\n')[1];\n return line?.trim().replace(/^at /, '');\n}\n\nfunction emit(event: QueryEvent, site: string | undefined, top: boolean): void {\n for (const listener of listeners) listener(event);\n if (!config) return;\n collectMetric(event);\n const log = getLogger();\n const msg = `${event.model}.${event.op} ${event.durationMs}ms`;\n // The request's logger already carries reqId.\n const fields: Partial<QueryEvent> = { ...event };\n delete fields.reqId;\n if (event.durationMs >= config.slowMs) {\n log.warn({ ...fields, slow: true }, `Slow query: ${msg}`);\n } else if (config.all) {\n log.info(fields, msg);\n }\n if (top && config.nPlusOne !== false) detectNPlusOne(event, site, config.nPlusOne);\n}\n\nfunction detectNPlusOne(event: QueryEvent, site: string | undefined, threshold: number): void {\n const ctx = getRequestContext();\n if (!ctx) return;\n const key = `${event.model}.${event.op}`;\n const counts = (ctx.queryCounts ??= new Map());\n const n = (counts.get(key) ?? 0) + 1;\n counts.set(key, n);\n if (n !== threshold) return;\n getLogger().warn(\n { model: event.model, op: event.op, count: n, ...(site !== undefined && { site }) },\n `Possible N+1: ${key} ran ${n} times in one request — load them in one query instead`,\n );\n}\n\n/**\n * Wraps a model's public operations so each call is timed, its statements counted and\n * the result reported. A no-op wrapper while query logging is off.\n */\nexport function traceOps<M extends object>(model: string, target: M, ops: readonly string[]): M {\n const t = target as Record<string, unknown>;\n for (const op of ops) {\n const fn = t[op] as (...args: unknown[]) => Promise<unknown>;\n const traced = function (this: unknown, ...args: unknown[]): Promise<unknown> {\n if (!active()) return fn.apply(this, args);\n const parent = frames.getStore();\n const frame: Frame = { statements: 0, parent };\n // Only N+1 checks need the call site; capture it while the caller is on the stack.\n const site = !parent && config && config.nPlusOne !== false ? callSite(traced) : undefined;\n const start = process.hrtime.bigint();\n const finish = (error?: unknown) => {\n const durationMs = Math.round(Number(process.hrtime.bigint() - start) / 1e5) / 10;\n const reqId = getRequestContext()?.requestId;\n emit(\n {\n model,\n op,\n durationMs,\n statements: frame.statements,\n ...(reqId !== undefined && { reqId }),\n ...(error !== undefined && { error: (error as Error)?.message ?? String(error) }),\n },\n site,\n !parent,\n );\n };\n return frames\n .run(frame, () => fn.apply(this, args))\n .then(\n (result) => {\n finish();\n return result;\n },\n (err: unknown) => {\n finish(err);\n throw err;\n },\n );\n };\n t[op] = traced;\n }\n return target;\n}\n","import { createHash } from 'node:crypto';\nimport type { Pool, PoolClient } from 'pg';\n\nconst invalidators = new WeakMap<Pool, () => void>();\n\n/** Clear reusable shapes after EFC changes a table; existing server names stay bounded. */\nexport function invalidatePreparedStatements(pool: Pool): void {\n invalidators.get(pool)?.();\n}\n\n/**\n * Private Drizzle driver view. The exported native Pool is unchanged. Each real\n * connection owns its names, including connections checked out for transactions.\n * Once its lifetime budget is full, new shapes use the ordinary unnamed protocol.\n */\nexport function preparedDriver(pool: Pool, max: number): Pool {\n if (!Number.isSafeInteger(max) || max < 0) {\n throw new Error('[EFC] databasePool.preparedStatements.max must be a nonnegative safe integer');\n }\n if (max === 0) return pool;\n let generation = 0;\n invalidators.set(pool, () => {\n generation++;\n });\n const clients = new WeakMap<PoolClient, PoolClient>();\n const wrap = (client: PoolClient): PoolClient => {\n const existing = clients.get(client);\n if (existing) return existing;\n let allocated = 0;\n let seenGeneration = generation;\n const names = new Map<string, string>();\n const proxy = new Proxy(client, {\n get(target, prop) {\n if (prop === 'query')\n return (...args: unknown[]) => {\n if (seenGeneration !== generation) {\n names.clear();\n seenGeneration = generation;\n }\n const query = args[0];\n if (query && typeof query === 'object' && 'text' in query) {\n const config = query as Record<string, unknown>;\n const text = config.text;\n // No DDL, transaction control, multi-statements, or caller-named queries.\n if (\n !config.name &&\n typeof text === 'string' &&\n /^\\s*(select|insert|update|delete|with)\\b/i.test(text) &&\n !text.trim().replace(/;$/, '').includes(';')\n ) {\n let name = names.get(text);\n if (!name && allocated < max) {\n name =\n 'efc_auto_' +\n createHash('sha256')\n .update(generation + ':' + text)\n .digest('hex')\n .slice(0, 48);\n names.set(text, name);\n allocated++;\n }\n if (name) args[0] = { ...config, name };\n }\n }\n return Reflect.apply(target.query, target, args);\n };\n const value = Reflect.get(target, prop, target) as unknown;\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n clients.set(client, proxy);\n return proxy;\n };\n return new Proxy(pool, {\n get(target, prop) {\n if (prop === 'connect') return async () => wrap(await target.connect());\n if (prop === 'query')\n return async (...args: unknown[]) => {\n const client = await target.connect();\n // Match Pool.query's connection-error ownership while checked out: do\n // not leave a network error unhandled, and discard failed connections.\n let failure: Error | undefined;\n const onError = (err: Error) => {\n failure = err;\n };\n client.once('error', onError);\n try {\n return await Reflect.apply(wrap(client).query, wrap(client), args);\n } catch (err) {\n failure = err instanceof Error ? err : new Error(String(err));\n throw err;\n } finally {\n client.removeListener('error', onError);\n client.release(failure);\n }\n };\n const value = Reflect.get(target, prop, target) as unknown;\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n}\n","import type { Pool } from 'pg';\nimport { getLogger } from '../logger.js';\nimport { countStatement } from './query-log.js';\nimport type { DatabasePoolConfig } from '../types.js';\nimport { preparedDriver } from './prepared-statements.js';\n\n// Pre-Flight's PostgreSQL connection: a node-postgres Pool (exposed as `db`) plus a\n// Drizzle instance over it that the model adapter queries through.\n\n/* eslint-disable @typescript-eslint/no-explicit-any -- drizzle is an optional peer, loaded dynamically */\nlet pool: Pool | undefined;\n\n/** Only a genuinely missing package becomes \"not installed\"; other load errors surface as-is. */\nexport function notInstalled(err: unknown, pkg: string, install: string): Error {\n const code = (err as { code?: string }).code;\n return code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND'\n ? new Error(`[EFC] ${pkg} is not installed. Run: ${install}`)\n : (err as Error);\n}\nlet orm: any;\n\nexport async function connectPostgres(\n url: string,\n poolConfig: DatabasePoolConfig = {},\n): Promise<Pool> {\n let PoolCtor: typeof Pool;\n try {\n const pg = (await import('pg')) as unknown as {\n default?: { Pool: typeof Pool };\n Pool?: typeof Pool;\n };\n PoolCtor = (pg.default?.Pool ?? pg.Pool)!;\n } catch (err) {\n throw notInstalled(err, 'pg', 'npm install pg drizzle-orm');\n }\n let drizzle: (client: Pool, config: object) => unknown;\n try {\n ({ drizzle } = (await import('drizzle-orm/node-postgres')) as unknown as {\n drizzle: (client: Pool, config: object) => unknown;\n });\n } catch (err) {\n throw notInstalled(err, 'drizzle-orm', 'npm install drizzle-orm');\n }\n\n const next = new PoolCtor({\n connectionString: url,\n ...(poolConfig.max !== undefined && { max: poolConfig.max }),\n ...(poolConfig.idleTimeoutMs !== undefined && { idleTimeoutMillis: poolConfig.idleTimeoutMs }),\n ...(poolConfig.connectionTimeoutMs !== undefined && {\n connectionTimeoutMillis: poolConfig.connectionTimeoutMs,\n }),\n });\n const prepared = poolConfig.preparedStatements;\n const maxStatements =\n prepared === false ? 0 : typeof prepared === 'object' ? (prepared.max ?? 100) : 100;\n let driver: Pool;\n try {\n driver = preparedDriver(next, maxStatements);\n } catch (err) {\n await next.end();\n throw err;\n }\n // Idle-client errors (e.g. the server restarting) are emitted on the pool; unhandled\n // they would crash the process.\n next.on('error', (err) => getLogger().error({ err }, 'PostgreSQL pool error'));\n try {\n await next.query('select 1');\n } catch (err) {\n await next.end().catch(() => {});\n throw explainPostgresError(err, url);\n }\n pool = next;\n // Every model statement goes through Drizzle, in or out of a transaction: count it.\n orm = drizzle(driver, { logger: { logQuery: countStatement } });\n getLogger().info('PostgreSQL connected');\n return next;\n}\n\n/** Where a connection string points, without the password (for error messages). */\nfunction describeUrl(url: string): { where: string; user: string; database: string } {\n try {\n const u = new URL(url);\n const database = decodeURIComponent(u.pathname.slice(1)) || '(default)';\n return {\n where: `${u.hostname || 'localhost'}:${u.port || '5432'}`,\n user: decodeURIComponent(u.username) || '(none)',\n database,\n };\n } catch {\n return { where: '(unparsable DATABASE_URL)', user: '?', database: '?' };\n }\n}\n\n/**\n * node-postgres' connection errors, said in terms of DATABASE_URL — e.g. a URL with no password\n * surfaces from pg as \"SASL: SCRAM-SERVER-FIRST-MESSAGE: client password must be a string\".\n * Unrecognised errors come back unchanged. The original is kept as `cause`.\n */\nexport function explainPostgresError(err: unknown, url: string): Error {\n const e = err as { code?: string; message?: string };\n const msg = e.message ?? '';\n const { where, user, database } = describeUrl(url);\n const hosted = 'For Neon, Supabase or RDS, copy the full connection string from the dashboard.';\n let text: string | undefined;\n if (/client password must be a string/.test(msg)) {\n text = `PostgreSQL asked for a password and DATABASE_URL has none (user \"${user}\" at ${where}). Put it in the URL: postgres://${user === '(none)' ? 'user' : user}:<password>@${where}/${database === '(default)' ? 'db' : database}. ${hosted}`;\n } else if (e.code === '28P01') {\n text = `PostgreSQL rejected the password for user \"${user}\" at ${where}. Check DATABASE_URL (special characters in the password must be URL-encoded). ${hosted}`;\n } else if (e.code === '28000' && /role .* does not exist/.test(msg)) {\n text = `PostgreSQL has no user \"${user}\" at ${where}. Create it (CREATE ROLE ${user} LOGIN PASSWORD '…';) or fix the user in DATABASE_URL.`;\n } else if (/no pg_hba\\.conf entry.*no encryption/.test(msg)) {\n text = `PostgreSQL at ${where} only accepts encrypted connections. Add ?sslmode=require to DATABASE_URL.`;\n } else if (e.code === '28000') {\n text = `PostgreSQL at ${where} refused user \"${user}\": ${msg}`;\n } else if (e.code === '3D000') {\n text = `Database \"${database}\" does not exist at ${where}. Create it first: createdb ${database} (or CREATE DATABASE \"${database}\";).`;\n } else if (/does not support SSL/.test(msg)) {\n text = `PostgreSQL at ${where} doesn't support SSL. Remove sslmode / ssl from DATABASE_URL (local servers usually run without it).`;\n } else if (e.code === 'ECONNREFUSED') {\n text = `Nothing is accepting connections at ${where}. Is PostgreSQL running, and is the host/port in DATABASE_URL right?`;\n } else if (e.code === 'ENOTFOUND' || e.code === 'EAI_AGAIN') {\n text = `Can't resolve the PostgreSQL host in DATABASE_URL (${where}). Check the hostname.`;\n } else if (e.code === 'ETIMEDOUT' || /timeout/i.test(msg)) {\n text = `Timed out connecting to PostgreSQL at ${where}. Check the host, and that a firewall / the provider's IP allow-list lets this machine in.`;\n }\n return text ? new Error(`[EFC] ${text}`, { cause: err }) : (err as Error);\n}\n\n/**\n * Every cluster worker opens its own pools, so a machine's total is `workers × (pool + …)`.\n * Logs that total against the server's limit, warning when this machine alone can exhaust it.\n * Best effort: a failure to read the limit is ignored.\n */\nexport async function checkConnectionBudget(perMachine: number, breakdown: string): Promise<void> {\n const log = getLogger();\n try {\n const { rows } = await getPool().query<{ max: number; reserved: number }>(\n `select current_setting('max_connections')::int as max,\n current_setting('superuser_reserved_connections')::int as reserved`,\n );\n const { max, reserved } = rows[0]!;\n const usable = max - reserved;\n if (perMachine > usable) {\n log.warn(\n `[EFC] PostgreSQL connections: up to ${perMachine} from this machine (${breakdown}), but the server allows ${usable} (max_connections ${max} − ${reserved} reserved). Under load, queries will fail with \"too many clients\". Lower databasePool.max or workers, or put PgBouncer in front.`,\n );\n } else {\n log.info(\n `PostgreSQL connections: up to ${perMachine} from this machine (${breakdown}) of ${usable} allowed — multiply by your instance count if you run several`,\n );\n }\n } catch {\n /* can't read the limit (permissions, pooler) — nothing to compare against */\n }\n}\n\nexport function getOrm(): any {\n if (!orm) {\n throw new Error(\n '[EFC] PostgreSQL not connected — set database/databaseUrl in ignite() (or call connectPostgres)',\n );\n }\n return orm;\n}\n\nexport function getPool(): Pool {\n if (!pool) throw new Error('[EFC] PostgreSQL not connected');\n return pool;\n}\n\nexport async function closePostgres(): Promise<void> {\n const p = pool;\n pool = undefined;\n orm = undefined;\n await p?.end();\n}\n"]}
|
|
@@ -6,8 +6,10 @@ var _chunkAGOYTFROcjs = require('./chunk-AGOYTFRO.cjs');
|
|
|
6
6
|
|
|
7
7
|
|
|
8
8
|
|
|
9
|
+
var _chunkJHCXIYJHcjs = require('./chunk-JHCXIYJH.cjs');
|
|
9
10
|
|
|
10
|
-
|
|
11
|
+
|
|
12
|
+
var _chunkURKE3OXNcjs = require('./chunk-URKE3OXN.cjs');
|
|
11
13
|
|
|
12
14
|
// src/db/schema.ts
|
|
13
15
|
var _crypto = require('crypto');
|
|
@@ -177,10 +179,10 @@ function isDefaultOperator(value) {
|
|
|
177
179
|
function resolveDefault(value, objectId) {
|
|
178
180
|
if (!isDefaultOperator(value)) return value;
|
|
179
181
|
if (value === "$objectId") return objectId;
|
|
180
|
-
if (value === "$currentUser") return () =>
|
|
182
|
+
if (value === "$currentUser") return () => _chunkURKE3OXNcjs.getCurrentUser.call(void 0, );
|
|
181
183
|
if (isCurrentUserOperator(value)) {
|
|
182
184
|
const key = value.slice("$currentUser.".length);
|
|
183
|
-
return () => _optionalChain([
|
|
185
|
+
return () => _optionalChain([_chunkURKE3OXNcjs.getCurrentUser.call(void 0, ), 'optionalAccess', _ => _[key]]);
|
|
184
186
|
}
|
|
185
187
|
return STATIC_DEFAULT_OPERATORS[value];
|
|
186
188
|
}
|
|
@@ -653,7 +655,7 @@ function pgTable(name, tree, options, config) {
|
|
|
653
655
|
synced ??= reconcile(false).then(
|
|
654
656
|
(changes) => {
|
|
655
657
|
if (changes.length)
|
|
656
|
-
|
|
658
|
+
_chunkJHCXIYJHcjs.getLogger.call(void 0, ).info({ table, changes: changes.length }, `Synced table ${table}`);
|
|
657
659
|
},
|
|
658
660
|
(err) => {
|
|
659
661
|
synced = void 0;
|
|
@@ -666,7 +668,7 @@ function pgTable(name, tree, options, config) {
|
|
|
666
668
|
};
|
|
667
669
|
const client = () => {
|
|
668
670
|
const tx = currentTx();
|
|
669
|
-
return _optionalChain([tx, 'optionalAccess', _10 => _10.engine]) === "postgresql" ? tx.tx :
|
|
671
|
+
return _optionalChain([tx, 'optionalAccess', _10 => _10.engine]) === "postgresql" ? tx.tx : _chunkJHCXIYJHcjs.getOrm.call(void 0, );
|
|
670
672
|
};
|
|
671
673
|
const columnFor = (t, field) => {
|
|
672
674
|
if (!columns.has(field))
|
|
@@ -933,7 +935,7 @@ function pgTable(name, tree, options, config) {
|
|
|
933
935
|
}
|
|
934
936
|
return out;
|
|
935
937
|
}
|
|
936
|
-
const tableExists = async (t) => (await
|
|
938
|
+
const tableExists = async (t) => (await _chunkJHCXIYJHcjs.getPool.call(void 0, ).query(
|
|
937
939
|
`SELECT 1 FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
|
|
938
940
|
WHERE c.relname = $1 AND n.nspname = current_schema() AND c.relkind IN ('r', 'p')`,
|
|
939
941
|
[t]
|
|
@@ -953,7 +955,7 @@ function pgTable(name, tree, options, config) {
|
|
|
953
955
|
for (const fk of fks) deferred.add(fk.name);
|
|
954
956
|
tx.afterCommit.push(() => {
|
|
955
957
|
reconcile(false).catch(
|
|
956
|
-
(err) =>
|
|
958
|
+
(err) => _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error({ err }, `${name}: adding foreign keys to "${table}" failed`)
|
|
957
959
|
);
|
|
958
960
|
});
|
|
959
961
|
}
|
|
@@ -964,7 +966,7 @@ function pgTable(name, tree, options, config) {
|
|
|
964
966
|
if (running) {
|
|
965
967
|
deferred.add(fk.name);
|
|
966
968
|
void running.then(() => reconcile(false)).catch(
|
|
967
|
-
(err) =>
|
|
969
|
+
(err) => _chunkJHCXIYJHcjs.getLogger.call(void 0, ).error({ err }, `${name}: adding foreign keys to "${table}" failed`)
|
|
968
970
|
);
|
|
969
971
|
} else {
|
|
970
972
|
await getRegisteredModel(fk.target).sync();
|
|
@@ -986,7 +988,7 @@ function pgTable(name, tree, options, config) {
|
|
|
986
988
|
async function reconcileTable(mode, fks, deferred) {
|
|
987
989
|
const { dryRun } = mode;
|
|
988
990
|
const generating = mode.plan !== void 0;
|
|
989
|
-
const pool =
|
|
991
|
+
const pool = _chunkJHCXIYJHcjs.getPool.call(void 0, );
|
|
990
992
|
const conn = await pool.connect();
|
|
991
993
|
try {
|
|
992
994
|
await conn.query("BEGIN");
|
|
@@ -1291,14 +1293,14 @@ function pgTable(name, tree, options, config) {
|
|
|
1291
1293
|
}
|
|
1292
1294
|
}
|
|
1293
1295
|
await conn.query(dryRun ? "ROLLBACK" : "COMMIT");
|
|
1294
|
-
if (!dryRun && steps.length)
|
|
1296
|
+
if (!dryRun && steps.length) _chunkJHCXIYJHcjs.invalidatePreparedStatements.call(void 0, _chunkJHCXIYJHcjs.getPool.call(void 0, ));
|
|
1295
1297
|
if (!dryRun) {
|
|
1296
1298
|
for (const [i, fk] of toValidate.entries()) {
|
|
1297
1299
|
try {
|
|
1298
1300
|
await conn.query(validations[i]);
|
|
1299
1301
|
} catch (e3) {
|
|
1300
1302
|
const n = await conn.query(orphans(fk)).then((r) => _nullishCoalesce(_optionalChain([r, 'access', _68 => _68.rows, 'access', _69 => _69[0], 'optionalAccess', _70 => _70.n]), () => ( "?"))).catch(() => "?");
|
|
1301
|
-
|
|
1303
|
+
_chunkJHCXIYJHcjs.getLogger.call(void 0, ).warn(
|
|
1302
1304
|
{ table, constraint: fk.name, orphans: Number(n) },
|
|
1303
1305
|
`${name}.${fk.field}: ${n} row(s) reference a missing ${fk.target} \u2014 the foreign key applies to new writes; fix those rows, then run efc db sync to validate it`
|
|
1304
1306
|
);
|
|
@@ -1317,7 +1319,7 @@ function pgTable(name, tree, options, config) {
|
|
|
1317
1319
|
async function drop() {
|
|
1318
1320
|
const { sql } = await compile();
|
|
1319
1321
|
await client().execute(sql.raw(`DROP TABLE IF EXISTS ${q(table)}`));
|
|
1320
|
-
|
|
1322
|
+
_chunkJHCXIYJHcjs.invalidatePreparedStatements.call(void 0, _chunkJHCXIYJHcjs.getPool.call(void 0, ));
|
|
1321
1323
|
}
|
|
1322
1324
|
return {
|
|
1323
1325
|
name,
|
|
@@ -1370,4 +1372,4 @@ function pgTable(name, tree, options, config) {
|
|
|
1370
1372
|
|
|
1371
1373
|
|
|
1372
1374
|
exports.normalizeSchema = normalizeSchema; exports.timestampFields = timestampFields; exports.resolveDefault = resolveDefault; exports.ModelValidationError = ModelValidationError; exports.sequenceFields = sequenceFields; exports.nodeAt = nodeAt; exports.validateAtPath = validateAtPath; exports.setDbEngine = setDbEngine; exports.getDbEngine = getDbEngine; exports.setAutoSync = setAutoSync; exports.isAutoSync = isAutoSync; exports.setSyncSuppressed = setSyncSuppressed; exports.isSyncSuppressed = isSyncSuppressed; exports.registerModel = registerModel; exports.getRegisteredModel = getRegisteredModel; exports.registeredModels = registeredModels; exports.currentTx = currentTx; exports.runInTx = runInTx; exports.tableNameFor = tableNameFor; exports.snakeCase = snakeCase; exports.q = q; exports.pgTable = pgTable;
|
|
1373
|
-
//# sourceMappingURL=chunk-
|
|
1375
|
+
//# sourceMappingURL=chunk-JVB5NLEM.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JVB5NLEM.cjs","../src/db/schema.ts","../src/db/engine.ts","../src/db/pg-table.ts"],"names":[],"mappings":"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","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-JVB5NLEM.cjs","sourcesContent":[null,"import { randomBytes, randomUUID } from 'node:crypto';\nimport type {\n DefaultOperator,\n CollectionPrimitiveFieldType,\n CollectionSchema,\n ModelSchema,\n ModelOptions,\n TableFieldDefinition,\n TablePrimitiveFieldType,\n TableSchema,\n TableSchemaField,\n} from '../types.js';\nimport { getCurrentUser } from '../context.js';\nimport { HttpError } from '../errors.js';\n\n// ── Normalised schema tree ───────────────────────────────────────────────────\n// The three accepted field syntaxes (FieldDefinition, nested-schema shorthand,\n// [schema] tuple) collapse into one tree that the engine adapters walk. The tree\n// covers defineTable's SQL types too; defineModel schemas just never contain them.\n\nexport type ScalarType =\n | 'string'\n | 'number'\n | 'boolean'\n | 'date'\n | 'objectId'\n | 'integer'\n | 'bigint'\n | 'decimal'\n | 'uuid'\n | 'decimal128'\n | 'long'\n | 'geoPoint'\n | 'binary';\n\n/** Every field definition the tree holds (a superset of the portable `FieldDefinition`). */\nexport type AnyFieldDefinition = Omit<TableFieldDefinition, 'type' | 'index'> & {\n type: TablePrimitiveFieldType | CollectionPrimitiveFieldType | 'array';\n index?: boolean | '2dsphere' | 'text' | 'hashed';\n};\n\nexport type FieldNode =\n | { kind: 'scalar'; type: ScalarType; def: AnyFieldDefinition }\n | { kind: 'json'; def: AnyFieldDefinition } // untyped object / untyped array / json\n | { kind: 'object'; fields: SchemaTree; def: AnyFieldDefinition }\n | { kind: 'array'; item: FieldNode; def: AnyFieldDefinition };\n\nexport type SchemaTree = Record<string, FieldNode>;\n\n/** Which model API a schema belongs to — it decides the field types allowed. */\nexport type SchemaMode = 'model' | 'table' | 'collection';\n\nconst MODEL_TYPES = new Set(['string', 'number', 'boolean', 'date', 'object', 'objectId', 'array']);\nconst TABLE_ONLY_TYPES = new Set(['integer', 'bigint', 'decimal', 'uuid', 'json']);\nconst COLLECTION_ONLY_TYPES = new Set(['decimal128', 'long', 'geoPoint', 'binary']);\nconst SPECIAL_INDEXES = new Set(['2dsphere', 'text', 'hashed']);\nconst TABLE_ONLY_OPTIONS = ['precision', 'scale', 'nativeEnum', 'column', 'onDelete'] as const;\nconst REFERENTIAL_ACTIONS = new Set(['restrict', 'cascade', 'setNull']);\nconst FOREIGN_KEY_TYPES = new Set(['objectId', 'uuid', 'integer', 'bigint']);\n\nexport function isFieldDefinition(value: unknown): value is AnyFieldDefinition {\n if (value == null || typeof value !== 'object' || Array.isArray(value)) return false;\n const type = (value as { type?: unknown }).type;\n return (\n typeof type === 'string' &&\n (MODEL_TYPES.has(type) || TABLE_ONLY_TYPES.has(type) || COLLECTION_ONLY_TYPES.has(type))\n );\n}\n\nconst untyped = (): FieldNode => ({ kind: 'json', def: { type: 'object' } });\n\nclass SchemaBuilder {\n constructor(\n private readonly model: string,\n private readonly mode: SchemaMode,\n ) {}\n\n private fail(path: string, message: string): never {\n throw new Error(`[EFC] ${this.model}.${path}: ${message}`);\n }\n\n private checkType(type: string, path: string) {\n if (this.mode !== 'table' && TABLE_ONLY_TYPES.has(type)) {\n this.fail(path, `type '${type}' is PostgreSQL-only — use defineTable, or a portable type`);\n }\n if (this.mode !== 'collection' && COLLECTION_ONLY_TYPES.has(type)) {\n this.fail(path, `type '${type}' is MongoDB-only — use defineCollection, or a portable type`);\n }\n }\n\n private checkDefinition(def: AnyFieldDefinition, path: string, topLevel: boolean) {\n this.checkType(def.type, path);\n if (def.renamedFrom !== undefined && !topLevel) {\n this.fail(path, `'renamedFrom' only applies to top-level fields`);\n }\n const index = def.index as unknown;\n if (typeof index === 'string' && (this.mode !== 'collection' || !SPECIAL_INDEXES.has(index))) {\n this.fail(\n path,\n `index must be true or false${this.mode === 'collection' ? `, '2dsphere', 'text' or 'hashed'` : ''}`,\n );\n }\n if (this.mode !== 'table') {\n for (const opt of TABLE_ONLY_OPTIONS) {\n if (def[opt] !== undefined) this.fail(path, `'${opt}' is a defineTable option`);\n }\n return;\n }\n if ((def.precision !== undefined || def.scale !== undefined) && def.type !== 'decimal') {\n this.fail(path, `'precision' / 'scale' only apply to decimal fields`);\n }\n if (def.scale !== undefined && def.precision === undefined) {\n this.fail(path, `'scale' needs 'precision'`);\n }\n if (def.nativeEnum && !(def.enum && def.enum.every((v) => typeof v === 'string'))) {\n this.fail(path, `'nativeEnum' needs a string 'enum'`);\n }\n if (def.column !== undefined && !topLevel) {\n this.fail(path, `'column' only applies to top-level fields`);\n }\n if (def.onDelete !== undefined) {\n if (def.ref === undefined) this.fail(path, `'onDelete' needs 'ref'`);\n if (!REFERENTIAL_ACTIONS.has(def.onDelete)) {\n this.fail(path, `onDelete must be 'restrict', 'cascade' or 'setNull'`);\n }\n if (def.onDelete === 'setNull' && def.required) {\n this.fail(path, `onDelete: 'setNull' can't clear a required field`);\n }\n }\n // A scalar ref is a foreign key, an array of refs a many-to-many join table: both\n // top-level and typed like the target's id.\n if (def.ref !== undefined) {\n const many = def.type === 'array';\n if (!topLevel) this.fail(path, `'ref' only applies to top-level fields`);\n if (!FOREIGN_KEY_TYPES.has(many ? String(def.of) : def.type)) {\n this.fail(\n path,\n many\n ? `a many-to-many 'ref' needs of: objectId, uuid, integer or bigint`\n : `'ref' needs an id type: objectId, uuid, integer or bigint`,\n );\n }\n if (many && def.onDelete !== undefined) {\n this.fail(\n path,\n `'onDelete' doesn't apply to many-to-many refs — links are always removed with either record`,\n );\n }\n if (many && (def.unique || def.index)) {\n this.fail(path, `many-to-many refs are indexed already; 'unique' / 'index' don't apply`);\n }\n }\n }\n\n private item(of: AnyFieldDefinition['of'], parent: AnyFieldDefinition, path: string): FieldNode {\n if (of === undefined) return untyped();\n if (typeof of === 'string') {\n this.checkType(of, path);\n if (of === 'object' || of === 'json') return untyped();\n const def: AnyFieldDefinition = {\n type: of,\n ...(parent.ref !== undefined && { ref: parent.ref }),\n };\n return { kind: 'scalar', type: of, def };\n }\n return { kind: 'object', fields: this.tree(of, `${path}.$`), def: { type: 'object' } };\n }\n\n field(field: TableSchemaField, path: string, topLevel: boolean): FieldNode {\n if (Array.isArray(field)) {\n const inner = (field as readonly TableSchema[])[0];\n return {\n kind: 'array',\n item: inner\n ? { kind: 'object', fields: this.tree(inner, `${path}.$`), def: { type: 'object' } }\n : untyped(),\n def: { type: 'array' },\n };\n }\n if (!isFieldDefinition(field)) {\n const type = (field as { type?: unknown }).type;\n if (typeof type === 'string') this.fail(path, `unknown field type '${type}'`);\n return {\n kind: 'object',\n fields: this.tree(field as TableSchema, path),\n def: { type: 'object' },\n };\n }\n const def = field;\n this.checkDefinition(def, path, topLevel);\n if (def.type === 'array') return { kind: 'array', item: this.item(def.of, def, path), def };\n if (def.type === 'object') {\n return def.fields\n ? { kind: 'object', fields: this.tree(def.fields, path), def }\n : { kind: 'json', def };\n }\n if (def.type === 'json') return { kind: 'json', def };\n return { kind: 'scalar', type: def.type, def };\n }\n\n tree(schema: TableSchema, prefix = ''): SchemaTree {\n const out: SchemaTree = {};\n for (const [key, field] of Object.entries(schema)) {\n out[key] = this.field(field, prefix ? `${prefix}.${key}` : key, prefix === '');\n }\n return out;\n }\n}\n\n/**\n * Normalises a schema. `model` mode (defineModel) rejects the PostgreSQL-only types and\n * options with an `[EFC]` error naming the field; `table` mode (defineTable) accepts them.\n */\nexport function normalizeSchema(\n schema: ModelSchema | TableSchema | CollectionSchema,\n mode: SchemaMode = 'model',\n model = 'Model',\n): SchemaTree {\n return new SchemaBuilder(model, mode).tree(schema as TableSchema);\n}\n\nexport function timestampFields(options: ModelOptions): { createdAt?: string; updatedAt?: string } {\n const ts = options.timestamps ?? true;\n if (ts === false) return {};\n if (ts === true) return { createdAt: 'createdAt', updatedAt: 'updatedAt' };\n const out: { createdAt?: string; updatedAt?: string } = {};\n if (ts.createdAt !== false) out.createdAt = ts.createdAt ?? 'createdAt';\n if (ts.updatedAt !== false) out.updatedAt = ts.updatedAt ?? 'updatedAt';\n return out;\n}\n\n// ── Default operator codes ───────────────────────────────────────────────────\n\nconst STATIC_DEFAULT_OPERATORS: Record<string, () => unknown> = {\n $now: () => new Date(),\n $uuid: () => randomUUID(),\n $timestamp: () => Date.now(),\n $shortId: () => randomBytes(12).toString('base64url'),\n};\n\nconst FIXED_DEFAULT_OPERATORS = new Set(['$now', '$uuid', '$objectId', '$timestamp', '$shortId']);\n\nfunction isCurrentUserOperator(value: unknown): value is '$currentUser' | `$currentUser.${string}` {\n return (\n typeof value === 'string' && (value === '$currentUser' || value.startsWith('$currentUser.'))\n );\n}\n\nexport function isDefaultOperator(value: unknown): value is DefaultOperator {\n return (\n (typeof value === 'string' && FIXED_DEFAULT_OPERATORS.has(value)) ||\n isCurrentUserOperator(value)\n );\n}\n\n/**\n * Turns a `default` into something evaluated per record: operator codes become\n * generator functions (so each insert — or, for `$currentUser`, each request — gets a\n * fresh value), functions pass through, literals are returned as-is. `objectId` is the\n * engine's id generator (mongoose ObjectId, or a UUID on PostgreSQL).\n */\nexport function resolveDefault(value: unknown, objectId: () => unknown): unknown {\n if (!isDefaultOperator(value)) return value;\n if (value === '$objectId') return objectId;\n if (value === '$currentUser') return () => getCurrentUser();\n if (isCurrentUserOperator(value)) {\n const key = value.slice('$currentUser.'.length);\n return () => getCurrentUser()?.[key];\n }\n return STATIC_DEFAULT_OPERATORS[value];\n}\n\n/** Applies defaults for missing top-level fields and nested object fields (PostgreSQL path). */\nexport function applyDefaults(\n tree: SchemaTree,\n data: Record<string, unknown>,\n objectId: () => unknown,\n): Record<string, unknown> {\n const out: Record<string, unknown> = { ...data };\n for (const [key, node] of Object.entries(tree)) {\n if (out[key] === undefined && node.def.default !== undefined) {\n const d = resolveDefault(node.def.default, objectId);\n const value = typeof d === 'function' ? (d as () => unknown)() : structuredClone(d);\n if (value !== undefined) out[key] = value;\n }\n if (node.kind === 'object' && out[key] != null && typeof out[key] === 'object') {\n out[key] = applyDefaults(node.fields, out[key] as Record<string, unknown>, objectId);\n }\n if (node.kind === 'array' && node.item.kind === 'object' && Array.isArray(out[key])) {\n const fields = node.item.fields;\n out[key] = (out[key] as unknown[]).map((v) =>\n v != null && typeof v === 'object'\n ? applyDefaults(fields, v as Record<string, unknown>, objectId)\n : v,\n );\n }\n }\n return out;\n}\n\n// ── Validation ───────────────────────────────────────────────────────────────\n\nexport interface FieldIssue {\n path: string;\n message: string;\n}\n\n/** Thrown by every model write that fails validation, on either engine. → HTTP 400. */\nexport class ModelValidationError extends HttpError {\n readonly issues: FieldIssue[];\n\n constructor(model: string, issues: FieldIssue[]) {\n super(\n 400,\n `${model} validation failed: ${issues.map((i) => `${i.path}: ${i.message}`).join('; ')}`,\n );\n this.name = 'ModelValidationError';\n this.issues = issues;\n }\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nconst INT4 = 2 ** 31;\nconst INT8_MIN = -(2n ** 63n);\nconst INT8_MAX = 2n ** 63n - 1n;\nconst DECIMAL_RE = /^[+-]?(\\d+(\\.\\d*)?|\\.\\d+)$/;\n\n/** Digits before / after the point of a decimal string or number. */\nfunction decimalDigits(value: string | number): { int: number; frac: number } {\n const str = typeof value === 'number' ? String(value) : value;\n const [i = '', f = ''] = str.replace(/^[+-]/, '').split('.');\n return { int: i.replace(/^0+/, '').length, frac: f.replace(/0+$/, '').length };\n}\n\nfunction typeError(type: ScalarType, def: AnyFieldDefinition, value: unknown): string | null {\n switch (type) {\n case 'string':\n return typeof value === 'string' ? null : 'must be a string';\n case 'number':\n return typeof value === 'number' && Number.isFinite(value) ? null : 'must be a number';\n case 'integer':\n return typeof value === 'number' && Number.isInteger(value) && value >= -INT4 && value < INT4\n ? null\n : 'must be a 32-bit integer';\n case 'bigint': {\n const big =\n typeof value === 'bigint'\n ? value\n : typeof value === 'number' && Number.isSafeInteger(value)\n ? BigInt(value)\n : undefined;\n return big !== undefined && big >= INT8_MIN && big <= INT8_MAX\n ? null\n : 'must be a 64-bit integer (bigint)';\n }\n case 'decimal': {\n const ok =\n (typeof value === 'number' && Number.isFinite(value)) ||\n (typeof value === 'string' && DECIMAL_RE.test(value));\n if (!ok) return 'must be a decimal number or numeric string';\n if (def.precision !== undefined) {\n const scale = def.scale ?? 0;\n const { int, frac } = decimalDigits(value as string | number);\n if (frac > scale) return `must have at most ${scale} decimal places`;\n if (int > def.precision - scale)\n return `must have at most ${def.precision - scale} digits before the decimal point`;\n }\n return null;\n }\n case 'boolean':\n return typeof value === 'boolean' ? null : 'must be a boolean';\n case 'date':\n return !Number.isNaN(new Date(value as string | number | Date).getTime())\n ? null\n : 'must be a date';\n case 'objectId':\n return typeof value === 'string' && UUID_RE.test(value) ? null : 'must be a valid id';\n case 'uuid':\n return typeof value === 'string' && UUID_RE.test(value) ? null : 'must be a UUID';\n case 'decimal128':\n case 'long':\n case 'geoPoint':\n case 'binary':\n return null; // defineCollection only: mongoose casts and validates these\n }\n}\n\ntype Bound = number | bigint | string | Date;\n\n/** < 0 / 0 / > 0 comparing a (type-checked) value with a min/max bound. */\nfunction compareBound(def: AnyFieldDefinition, value: unknown, bound: Bound): number {\n if (def.type === 'bigint') {\n const a = BigInt(value as bigint | number);\n const b = BigInt(bound instanceof Date ? bound.getTime() : bound);\n return a < b ? -1 : a > b ? 1 : 0;\n }\n const num = (v: unknown) =>\n v instanceof Date\n ? v.getTime()\n : def.type === 'date'\n ? new Date(v as string | number).getTime()\n : Number(v);\n return num(value) - num(bound);\n}\n\nasync function checkRules(\n def: AnyFieldDefinition,\n value: unknown,\n path: string,\n issues: FieldIssue[],\n) {\n if (def.enum && !def.enum.includes(value as string | number)) {\n issues.push({ path, message: `must be one of: ${def.enum.join(', ')}` });\n }\n const ordered =\n typeof value === 'number' ||\n typeof value === 'bigint' ||\n value instanceof Date ||\n def.type === 'date' ||\n (def.type === 'decimal' && typeof value === 'string');\n if (ordered) {\n if (def.min !== undefined && compareBound(def, value, def.min) < 0)\n issues.push({ path, message: `must be >= ${String(def.min)}` });\n if (def.max !== undefined && compareBound(def, value, def.max) > 0)\n issues.push({ path, message: `must be <= ${String(def.max)}` });\n }\n if (typeof value === 'string' && def.type !== 'decimal') {\n if (def.minLength !== undefined && value.length < def.minLength)\n issues.push({ path, message: `must be at least ${def.minLength} characters` });\n if (def.maxLength !== undefined && value.length > def.maxLength)\n issues.push({ path, message: `must be at most ${def.maxLength} characters` });\n if (def.match && !def.match.test(value))\n issues.push({ path, message: `must match ${String(def.match)}` });\n }\n if (def.validate) {\n const result = await def.validate(value);\n if (result !== true)\n issues.push({ path, message: typeof result === 'string' ? result : 'is invalid' });\n }\n}\n\nasync function validateNode(\n node: FieldNode,\n value: unknown,\n path: string,\n issues: FieldIssue[],\n partial: boolean,\n) {\n if (value === undefined || value === null) {\n if (node.def.required && !partial) issues.push({ path, message: 'is required' });\n if (node.def.required && partial && value === null)\n issues.push({ path, message: 'is required' });\n return;\n }\n switch (node.kind) {\n case 'scalar': {\n const err = typeError(node.type, node.def, value);\n if (err) {\n issues.push({ path, message: err });\n return;\n }\n await checkRules(node.def, value, path, issues);\n return;\n }\n case 'json':\n await checkRules(node.def, value, path, issues);\n return;\n case 'object':\n if (typeof value !== 'object' || Array.isArray(value)) {\n issues.push({ path, message: 'must be an object' });\n return;\n }\n await validateTree(node.fields, value as Record<string, unknown>, issues, false, path);\n await checkRules(node.def, value, path, issues);\n return;\n case 'array':\n if (!Array.isArray(value)) {\n issues.push({ path, message: 'must be an array' });\n return;\n }\n for (let i = 0; i < value.length; i++) {\n await validateNode(\n { ...node.item, def: { ...node.item.def, required: true } } as FieldNode,\n value[i],\n `${path}.${i}`,\n issues,\n false,\n );\n }\n await checkRules(node.def, value, path, issues);\n }\n}\n\n/**\n * Validates `data` against the tree. `partial` (updates) only checks fields present in\n * `data`, but still rejects explicitly nulling a required field.\n */\nexport async function validateTree(\n tree: SchemaTree,\n data: Record<string, unknown>,\n issues: FieldIssue[],\n partial: boolean,\n prefix = '',\n): Promise<FieldIssue[]> {\n for (const [key, node] of Object.entries(tree)) {\n if (partial && !(key in data)) continue;\n await validateNode(node, data[key], prefix ? `${prefix}.${key}` : key, issues, partial);\n }\n return issues;\n}\n\n/** Fields declared with `ref` (top-level objectId or objectId arrays) → referenced model name. */\nexport function refFields(tree: SchemaTree): Map<string, { model: string; many: boolean }> {\n const refs = new Map<string, { model: string; many: boolean }>();\n for (const [key, node] of Object.entries(tree)) {\n if (node.kind === 'scalar' && node.type === 'objectId' && node.def.ref) {\n refs.set(key, { model: node.def.ref, many: false });\n } else if (\n node.kind === 'array' &&\n node.item.kind === 'scalar' &&\n node.item.type === 'objectId' &&\n node.def.ref\n ) {\n refs.set(key, { model: node.def.ref, many: true });\n }\n }\n return refs;\n}\n\nexport function sequenceFields(name: string, tree: SchemaTree): { path: string; key: string }[] {\n const out: { path: string; key: string }[] = [];\n for (const [path, node] of Object.entries(tree)) {\n if (node.def.sequence) {\n out.push({\n path,\n key: typeof node.def.sequence === 'string' ? node.def.sequence : `${name}.${path}`,\n });\n }\n }\n return out;\n}\n\n/** The schema node a dotted path points at (`meta.counts.views`, `items.0.sku`), if any. */\nexport function nodeAt(tree: SchemaTree, path: string[]): FieldNode | undefined {\n let node: FieldNode | undefined = tree[path[0]!];\n for (const part of path.slice(1)) {\n if (!node) return undefined;\n if (node.kind === 'object') node = node.fields[part];\n else if (node.kind === 'array' && /^\\d+$/.test(part)) node = node.item;\n else if (node.kind === 'json')\n return node; // untyped JSON: anything goes below here\n else return undefined;\n }\n return node;\n}\n\n/** Validates one value written to a dotted path (partial-update rules). */\nexport async function validateAtPath(\n tree: SchemaTree,\n dotted: string,\n value: unknown,\n issues: FieldIssue[],\n): Promise<void> {\n const node = nodeAt(tree, dotted.split('.'));\n if (!node) {\n issues.push({ path: dotted, message: 'unknown field' });\n return;\n }\n await validateNode(node, value, dotted, issues, true);\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { DatabaseEngine } from '../types.js';\n\n// Which adapter defineModel() compiles to. Set during Pre-Flight from\n// config.database / the DATABASE_URL scheme; MongoDB until then, which keeps code\n// that connects mongoose itself (tests, scripts) working without ignite().\nlet engine: DatabaseEngine | undefined;\n\nexport function setDbEngine(value: DatabaseEngine): void {\n engine = value;\n}\n\nexport function getDbEngine(): DatabaseEngine {\n return engine ?? 'mongodb';\n}\n\n// Whether models reconcile their table/collection on first use (EFCConfig.autoSync).\nlet autoSync = true;\n\nexport function setAutoSync(value: boolean): void {\n autoSync = value;\n}\n\nexport function isAutoSync(): boolean {\n return autoSync;\n}\n\n// Set while `efc db generate` replays migrations into its shadow schema: a migration that\n// calls `Model.sync()` (the scaffolded init migration does) mirrors the models as they are\n// *now*, which would hide every change from the diff — so those calls do nothing there.\nlet syncSuppressed = false;\n\nexport function setSyncSuppressed(value: boolean): void {\n syncSuppressed = value;\n}\n\nexport function isSyncSuppressed(): boolean {\n return syncSuppressed;\n}\n\n/** One step of a generated migration. */\nexport interface PlanStep {\n /**\n * PostgreSQL: a SQL statement. MongoDB: a JavaScript statement run against `db` (the\n * mongoose Connection). With `check`, a query returning `n` that must be 0.\n */\n sql: string;\n /** Best-effort reverse, for the migration's `down()`; `''` = nothing to undo. */\n down?: string;\n /** PostgreSQL: skip `sql` when this query returns a row (already applied). */\n skipIf?: string;\n /** `sql` counts offending rows: the migration stops with this message (`%n` = count). */\n check?: string;\n /** Foreign keys run after every table exists. */\n phase: 'main' | 'fk';\n}\n\n/** The explicit, possibly lossy extras `efc db generate` may add to the sync plan. */\nexport interface PlanOptions {\n /** Drop columns the model no longer declares. */\n allowDrop?: boolean;\n /** Add NOT NULL for required fields and validate enum checks, behind row checks. */\n tighten?: boolean;\n}\n\n/** What every model API (defineModel, defineTable) registers about itself. */\nexport interface RegisteredModel {\n readonly name: string;\n sync(options?: { dryRun?: boolean }): Promise<string[]>;\n /** The migration steps that would bring the database in line with the model. */\n plan?(options?: PlanOptions): Promise<PlanStep[]>;\n drop(): Promise<void>;\n /** Records by id — what `populate` needs from a `ref` target. */\n findByIds(ids: unknown[]): Promise<Record<string, unknown>[]>;\n /** PostgreSQL: its table and id strategy — what a foreign key to it needs. */\n pgTarget?(): { table: string; idKind: 'uuid' | 'serial' | 'bigserial' };\n /** defineTable only: its runtime, for `include` from other tables. */\n tableRuntime?(): unknown;\n /** `efc db studio --write`: where it stores, and writes through the model (validated). */\n studio?: StudioWriter;\n}\n\nexport interface StudioWriter {\n /** The table (PostgreSQL) or collection (MongoDB) its records live in. */\n storage(): Promise<string>;\n create(data: Record<string, unknown>): Promise<unknown>;\n /** `id` as it appears in the URL; the model converts it. */\n update(id: string, data: Record<string, unknown>): Promise<unknown>;\n delete(id: string): Promise<unknown>;\n}\n\n// Every defined model by name, so `populate` can resolve a `ref` on either engine\n// and `efc db` commands can sync everything that was imported.\nconst registry = new Map<string, RegisteredModel>();\n\nexport function registerModel(model: RegisteredModel): void {\n registry.set(model.name, model);\n}\n\nexport function getRegisteredModel(name: string): RegisteredModel | undefined {\n return registry.get(name);\n}\n\nexport function registeredModels(): RegisteredModel[] {\n return [...registry.values()];\n}\n\n// ── Transactions ─────────────────────────────────────────────────────────────\n\n/** The open transaction for the current async scope: a mongoose session or a Drizzle tx. */\nexport type TxHandle =\n | { engine: 'mongodb'; session: unknown }\n | {\n engine: 'postgresql';\n tx: unknown;\n /** Work to run once the transaction has committed (e.g. deferred foreign keys). */\n afterCommit: (() => void)[];\n };\n\nconst txStorage = new AsyncLocalStorage<TxHandle>();\n\nexport function currentTx(): TxHandle | undefined {\n return txStorage.getStore();\n}\n\nexport function runInTx<T>(handle: TxHandle, fn: () => Promise<T>): Promise<T> {\n return txStorage.run(handle, fn);\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any -- drizzle is an optional peer, loaded dynamically */\n// The PostgreSQL table behind a model: columns, the Drizzle table, schema sync, record\n// conversion, insert preparation, validation and error mapping. Shared by both query\n// layers on top of it — defineModel's MongoDB-style API (pg-model.ts) and defineTable's\n// Prisma-style API (table-model.ts) — so the same table reads and writes the same records.\nimport { randomUUID } from 'node:crypto';\nimport type { ModelOptions, ReferentialAction, TableOptions } from '../types.js';\nimport { HttpError } from '../errors.js';\nimport {\n applyDefaults,\n ModelValidationError,\n refFields,\n sequenceFields,\n timestampFields,\n validateTree,\n type AnyFieldDefinition,\n type FieldIssue,\n type FieldNode,\n type ScalarType,\n type SchemaTree,\n} from './schema.js';\nimport {\n currentTx,\n getRegisteredModel,\n isAutoSync,\n isSyncSuppressed,\n registeredModels,\n type PlanOptions,\n type PlanStep,\n} from './engine.js';\nimport { getOrm, getPool } from './postgres.js';\nimport { invalidatePreparedStatements } from './prepared-statements.js';\nimport { getLogger } from '../logger.js';\n\ntype AnyRecord = Record<string, unknown>;\n\ninterface Drizzle {\n sql: any;\n pgCore: any;\n}\n\nlet drizzlePromise: Promise<Drizzle> | undefined;\n\nexport function loadDrizzle(): Promise<Drizzle> {\n drizzlePromise ??= Promise.all([import('drizzle-orm'), import('drizzle-orm/pg-core')])\n .then(([orm, pgCore]) => ({ sql: (orm as any).sql, pgCore }))\n .catch(() => {\n drizzlePromise = undefined;\n throw new Error('[EFC] drizzle-orm is not installed. Run: npm install pg drizzle-orm');\n });\n return drizzlePromise;\n}\n\n/** mongoose-style collection naming so both engines agree: User → users, Category → categories. */\nexport function tableNameFor(model: string): string {\n const lower = model.toLowerCase();\n if (/[^aeiou]y$/.test(lower)) return lower.slice(0, -1) + 'ies';\n if (/(s|x|z|ch|sh)$/.test(lower)) return lower + 'es';\n return lower + 's';\n}\n\nexport const snakeCase = (s: string) =>\n s\n .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')\n .toLowerCase();\n\nexport const q = (ident: string) => `\"${ident.replace(/\"/g, '\"\"')}\"`;\nconst sequenceName = (key: string) => `efc_seq_${key.replace(/[^A-Za-z0-9_]/g, '_').toLowerCase()}`;\nconst literal = (v: string | number) =>\n typeof v === 'number' ? String(v) : `'${v.replace(/'/g, \"''\")}'`;\n\n// Tables whose sync is running in this process, so a foreign key to one of them can wait\n// for it instead of syncing it again (A ↔ B references would otherwise recurse).\nconst syncing = new Map<string, Promise<unknown>>();\n\nconst ACTION_SQL: Record<ReferentialAction, string> = {\n restrict: 'RESTRICT',\n cascade: 'CASCADE',\n setNull: 'SET NULL',\n};\n// pg_constraint.confdeltype\nconst ACTION_CODE: Record<ReferentialAction, string> = {\n restrict: 'r',\n cascade: 'c',\n setNull: 'n',\n};\n// The column kind (and the field type to declare) a reference to each id strategy needs.\nconst ID_COLUMN = {\n uuid: { kind: 'uuid', type: 'uuid' },\n serial: { kind: 'integer', type: 'integer' },\n bigserial: { kind: 'bigint', type: 'bigint' },\n} as const;\n\n/** The model owning a table, for messages. */\nconst modelOfTable = (table: string) =>\n registeredModels().find((m) => {\n try {\n return m.pgTarget?.().table === table;\n } catch {\n return false;\n }\n })?.name ?? table;\n\n// ── Columns ──────────────────────────────────────────────────────────────────\n\nexport type ScalarKind =\n | 'text'\n | 'varchar'\n | 'double'\n | 'integer'\n | 'bigint'\n | 'numeric'\n | 'boolean'\n | 'timestamptz'\n | 'uuid'\n | 'enum';\nexport type ColumnKind = ScalarKind | 'jsonb' | 'array';\n\nexport interface ColumnSpec {\n /** Record key. */\n field: string;\n /** Database column name. */\n column: string;\n kind: ColumnKind;\n /** Type in DDL (`varchar(80)`, `integer[]`, `\"orders_status_enum\"`). */\n ddl: string;\n /** The same type as `format_type()` prints it, to compare with the live table. */\n formatted: string;\n /** Element kind of a native array column. */\n item?: ScalarKind;\n /** Schema node (absent for id and timestamps). */\n node?: FieldNode;\n /** `bigint` columns: JS `bigint` values, or `number` (sequences, defineModel). */\n bigintAs?: 'bigint' | 'number';\n length?: number;\n precision?: number;\n scale?: number;\n enumType?: string;\n enumValues?: string[];\n}\n\n/** A many-to-many `ref` array on defineTable, stored in a join table instead of a column. */\nexport interface JoinSpec {\n field: string;\n /** The join table: `<table>_<column>`, holding (owner_id, ref_id, position). */\n table: string;\n /** Where the array lived before it had a join table (backfilled from on first sync). */\n legacyColumn: string;\n target: string;\n /** Element kind: the target's id type. */\n item: 'uuid' | 'integer' | 'bigint';\n /** Array type of the ids (`uuid[]`, `integer[]`, `bigint[]`). */\n ddl: string;\n node: FieldNode;\n}\n\ntype ScalarSpec = Pick<\n ColumnSpec,\n 'kind' | 'ddl' | 'formatted' | 'length' | 'precision' | 'scale' | 'bigintAs'\n>;\n\nfunction scalarSpec(type: ScalarType, def: AnyFieldDefinition, native: boolean): ScalarSpec {\n switch (type) {\n case 'string':\n if (native && def.maxLength !== undefined) {\n return {\n kind: 'varchar',\n ddl: `varchar(${def.maxLength})`,\n formatted: `character varying(${def.maxLength})`,\n length: def.maxLength,\n };\n }\n return { kind: 'text', ddl: 'text', formatted: 'text' };\n case 'number':\n return { kind: 'double', ddl: 'double precision', formatted: 'double precision' };\n case 'integer':\n return { kind: 'integer', ddl: 'integer', formatted: 'integer' };\n case 'bigint':\n return { kind: 'bigint', ddl: 'bigint', formatted: 'bigint', bigintAs: 'bigint' };\n case 'decimal': {\n if (def.precision === undefined)\n return { kind: 'numeric', ddl: 'numeric', formatted: 'numeric' };\n const t = `numeric(${def.precision},${def.scale ?? 0})`;\n return {\n kind: 'numeric',\n ddl: t,\n formatted: t,\n precision: def.precision,\n scale: def.scale ?? 0,\n };\n }\n case 'boolean':\n return { kind: 'boolean', ddl: 'boolean', formatted: 'boolean' };\n case 'date':\n return { kind: 'timestamptz', ddl: 'timestamptz', formatted: 'timestamp with time zone' };\n case 'objectId':\n case 'uuid':\n return { kind: 'uuid', ddl: 'uuid', formatted: 'uuid' };\n case 'decimal128':\n case 'long':\n case 'geoPoint':\n case 'binary':\n // The schema builder refuses MongoDB-only types outside defineCollection.\n throw new Error(`[EFC] type '${type}' is MongoDB-only`);\n }\n}\n\nexport interface PgTableConfig {\n /** defineTable: SQL-native types, native arrays, varchar, enums, naming, id strategies. */\n native: boolean;\n /** Which API defined it, for messages. */\n api: 'defineModel' | 'defineTable';\n}\n\nexport type IdKind = 'uuid' | 'serial' | 'bigserial';\n\nexport type PgTable = ReturnType<typeof pgTable>;\n\nexport function pgTable(\n name: string,\n tree: SchemaTree,\n options: ModelOptions & TableOptions,\n config: PgTableConfig,\n) {\n const snake = config.native && options.naming === 'snake_case';\n const table = options.collection ?? tableNameFor(snake ? snakeCase(name) : name);\n const columnName = (field: string, def?: AnyFieldDefinition) =>\n def?.column ?? (snake ? snakeCase(field) : field);\n const idKind: IdKind = (config.native && options.id) || 'uuid';\n if (tree['id']) throw new Error(`[EFC] ${name}: \"id\" is the primary key — don't declare it`);\n\n const ts = timestampFields(options);\n const sequences = sequenceFields(name, tree);\n const sequenceKeys = new Map(sequences.map((s) => [s.path, s.key]));\n const refs = refFields(tree);\n\n const columns = new Map<string, ColumnSpec>();\n const joins = new Map<string, JoinSpec>();\n const idSpec: ColumnSpec =\n idKind === 'uuid'\n ? { field: 'id', column: 'id', kind: 'uuid', ddl: 'uuid', formatted: 'uuid' }\n : idKind === 'serial'\n ? { field: 'id', column: 'id', kind: 'integer', ddl: 'integer', formatted: 'integer' }\n : {\n field: 'id',\n column: 'id',\n kind: 'bigint',\n ddl: 'bigint',\n formatted: 'bigint',\n bigintAs: 'bigint',\n };\n columns.set('id', idSpec);\n\n for (const [field, node] of Object.entries(tree)) {\n const column = columnName(field, node.def);\n const base = { field, column, node };\n if (sequenceKeys.has(field)) {\n columns.set(field, {\n ...base,\n kind: 'bigint',\n ddl: 'bigint',\n formatted: 'bigint',\n bigintAs: 'number',\n });\n } else if (node.kind === 'scalar') {\n if (config.native && node.def.nativeEnum && node.def.enum) {\n const enumType = `${table}_${column}_enum`;\n columns.set(field, {\n ...base,\n kind: 'enum',\n ddl: q(enumType),\n formatted: /^[a-z_][a-z0-9_]*$/.test(enumType) ? enumType : q(enumType),\n enumType,\n enumValues: node.def.enum.map(String),\n });\n } else {\n columns.set(field, { ...base, ...scalarSpec(node.type, node.def, config.native) });\n }\n } else if (\n config.native &&\n node.kind === 'array' &&\n node.item.kind === 'scalar' &&\n node.def.ref !== undefined\n ) {\n // Many-to-many: a join table, not a column.\n const item = scalarSpec(node.item.type, node.item.def, false).kind as JoinSpec['item'];\n joins.set(field, {\n field,\n table: `${table}_${column}`,\n legacyColumn: column,\n target: node.def.ref,\n item,\n ddl: `${item}[]`,\n node,\n });\n } else if (config.native && node.kind === 'array' && node.item.kind === 'scalar') {\n // Items are plain scalars: no varchar length, no enum type.\n const item = scalarSpec(node.item.type, node.item.def, false);\n columns.set(field, {\n ...base,\n ...item,\n kind: 'array',\n item: item.kind as ScalarKind,\n ddl: `${item.ddl}[]`,\n formatted: `${item.formatted}[]`,\n });\n } else {\n columns.set(field, { ...base, kind: 'jsonb', ddl: 'jsonb', formatted: 'jsonb' });\n }\n }\n for (const field of [ts.createdAt, ts.updatedAt]) {\n if (field) {\n columns.set(field, {\n field,\n column: columnName(field),\n kind: 'timestamptz',\n ddl: 'timestamptz',\n formatted: 'timestamp with time zone',\n });\n }\n }\n const byColumn = new Map([...columns.values()].map((c) => [c.column, c]));\n\n // ── Drizzle table ──────────────────────────────────────────────────────────\n\n const builder = (pgCore: any, kind: ScalarKind, spec: ColumnSpec) => {\n const c = spec.column;\n switch (kind) {\n case 'varchar':\n return pgCore.varchar(c, { length: spec.length });\n case 'double':\n return pgCore.doublePrecision(c);\n case 'integer':\n return pgCore.integer(c);\n case 'bigint':\n return pgCore.bigint(c, { mode: spec.bigintAs ?? 'bigint' });\n case 'numeric':\n return pgCore.numeric(\n c,\n spec.precision !== undefined ? { precision: spec.precision, scale: spec.scale } : {},\n );\n case 'boolean':\n return pgCore.boolean(c);\n case 'timestamptz':\n return pgCore.timestamp(c, { withTimezone: true, mode: 'date' });\n case 'uuid':\n return pgCore.uuid(c);\n default:\n return pgCore.text(c); // text, enum (PostgreSQL casts parameters to the enum type)\n }\n };\n\n let compiled: Promise<{ t: any; sql: any }> | undefined;\n const compile = () =>\n (compiled ??= loadDrizzle().then(({ sql, pgCore }) => {\n const cols: AnyRecord = {};\n for (const [field, spec] of columns) {\n let c: any;\n if (spec.kind === 'jsonb') c = pgCore.jsonb(spec.column);\n else if (spec.kind === 'array') c = builder(pgCore, spec.item!, spec).array();\n else c = builder(pgCore, spec.kind, spec);\n if (field === 'id') {\n c =\n idKind === 'uuid'\n ? c.primaryKey().defaultRandom()\n : c.primaryKey().generatedByDefaultAsIdentity();\n }\n cols[field] = c;\n }\n return { t: pgCore.pgTable(table, cols), sql };\n }));\n\n // Like MongoDB creating collections and indexes on first use: the first query through\n // this model reconciles its table (unless autoSync is off). Memoised per process; a\n // failure is retried on the next use instead of being cached.\n let synced: Promise<void> | undefined;\n const ready = async () => {\n const result = await compile();\n if (isAutoSync()) {\n synced ??= reconcile(false).then(\n (changes) => {\n if (changes.length)\n getLogger().info({ table, changes: changes.length }, `Synced table ${table}`);\n },\n (err: unknown) => {\n synced = undefined;\n throw err;\n },\n );\n await synced;\n }\n return result;\n };\n\n const client = () => {\n const tx = currentTx();\n return tx?.engine === 'postgresql' ? tx.tx : getOrm();\n };\n\n const columnFor = (t: any, field: string) => {\n if (!columns.has(field))\n throw new ModelValidationError(name, [{ path: field, message: 'unknown field' }]);\n return t[field];\n };\n\n // ── Values in and out ──────────────────────────────────────────────────────\n\n const scalarToDb = (kind: ScalarKind | undefined, spec: ColumnSpec, v: unknown): unknown => {\n if (v == null) return v;\n if (kind === 'timestamptz') return v instanceof Date ? v : new Date(v as string);\n if (kind === 'bigint')\n return spec.bigintAs === 'number' ? Number(v) : BigInt(v as bigint | number | string);\n if (kind === 'numeric') return String(v);\n return v;\n };\n\n /** A record value → what the Drizzle column takes. */\n const toDb = (field: string, value: unknown): unknown => {\n const spec = columns.get(field);\n if (!spec || value == null) return value;\n if (spec.kind === 'array') {\n return Array.isArray(value) ? value.map((v) => scalarToDb(spec.item, spec, v)) : value;\n }\n if (spec.kind === 'jsonb') return value;\n return scalarToDb(spec.kind, spec, value);\n };\n\n // jsonb keeps dates as ISO strings; turn the ones the schema declares back into Dates,\n // as MongoDB returns them.\n const revive = (node: FieldNode, value: unknown): unknown => {\n if (value == null) return value;\n if (node.kind === 'scalar') {\n if (node.type === 'date' && typeof value === 'string') return new Date(value);\n return value;\n }\n if (node.kind === 'array' && Array.isArray(value))\n return value.map((v) => revive(node.item, v));\n if (node.kind === 'object' && typeof value === 'object' && !Array.isArray(value)) {\n const out: AnyRecord = { ...(value as AnyRecord) };\n for (const [k, child] of Object.entries(node.fields)) {\n if (out[k] !== undefined) out[k] = revive(child, out[k]);\n }\n return out;\n }\n return value;\n };\n const hasNestedDate = (node: FieldNode): boolean =>\n node.kind === 'scalar'\n ? node.type === 'date'\n : node.kind === 'array'\n ? hasNestedDate(node.item)\n : node.kind === 'object' && Object.values(node.fields).some(hasNestedDate);\n const datedJson = [...columns.values()].filter(\n (c) => c.kind === 'jsonb' && c.node && hasNestedDate(c.node),\n );\n const bigintCols = [...columns.values()].filter(\n (c) =>\n (c.kind === 'bigint' && c.bigintAs === 'bigint') ||\n (c.kind === 'array' && c.item === 'bigint'),\n );\n\n /** A Drizzle row (keyed by field) → a record: NULLs dropped, so unset fields are absent. */\n const fromRow = (row: AnyRecord): AnyRecord => {\n const out: AnyRecord = {};\n for (const [k, v] of Object.entries(row)) if (v !== null) out[k] = v;\n for (const c of datedJson)\n if (out[c.field] !== undefined) out[c.field] = revive(c.node!, out[c.field]);\n for (const c of bigintCols) {\n const v = out[c.field];\n if (typeof v === 'string' || typeof v === 'number') out[c.field] = BigInt(v);\n else if (Array.isArray(v)) out[c.field] = v.map((x) => (x == null ? x : BigInt(x as string)));\n }\n return out;\n };\n\n /** A raw SQL row (keyed by column) → a record. */\n const fromRawRow = (row: AnyRecord): AnyRecord => {\n const keyed: AnyRecord = {};\n for (const [col, v] of Object.entries(row)) {\n const spec = byColumn.get(col);\n if (!spec) continue;\n keyed[spec.field] =\n v != null && spec.kind === 'timestamptz' && !(v instanceof Date)\n ? new Date(v as string)\n : v;\n }\n return fromRow(keyed);\n };\n\n const validate = async (data: AnyRecord, partial: boolean) => {\n const issues: FieldIssue[] = [];\n const checkTree: SchemaTree = {};\n for (const [k, node] of Object.entries(tree)) {\n // The database assigns sequence values, so they can't be \"missing\" on insert.\n checkTree[k] = sequenceKeys.has(k)\n ? ({ ...node, def: { ...node.def, required: false } } as FieldNode)\n : node;\n }\n await validateTree(checkTree, data, issues, partial);\n if (issues.length) throw new ModelValidationError(name, issues);\n };\n\n // Undeclared fields are dropped silently on every write (mongoose's strict mode).\n const known = (data: AnyRecord): AnyRecord =>\n Object.fromEntries(\n Object.entries(data).filter(([k]) => {\n const top = k.split('.')[0]!;\n return columns.has(top) || joins.has(top);\n }),\n );\n\n const prepareInsert = async (input: AnyRecord): Promise<AnyRecord> => {\n const { id, ...rest } = known(input);\n for (const f of [ts.createdAt, ts.updatedAt]) if (f) delete rest[f];\n const data = applyDefaults(tree, rest, randomUUID);\n await validate(data, false);\n const now = new Date();\n if (ts.createdAt) data[ts.createdAt] = now;\n if (ts.updatedAt) data[ts.updatedAt] = now;\n if (id !== undefined) data['id'] = id;\n for (const [k, v] of Object.entries(data)) data[k] = toDb(k, v);\n return data;\n };\n\n const fieldOfColumn = (column: string) => byColumn.get(column)?.field ?? column;\n\n /** Maps PostgreSQL errors to EFC's: 409 duplicates, 400 validation, a hint for missing tables. */\n const guard = async <R>(fn: () => Promise<R>): Promise<R> => {\n try {\n return await fn();\n } catch (err) {\n const e =\n (err as { cause?: { code?: string; detail?: string; column?: string; table?: string } })\n .cause ?? (err as { code?: string; detail?: string; column?: string; table?: string });\n if (e?.code === '42P01') {\n throw new Error(\n `[EFC] ${name}: table \"${table}\" does not exist — autoSync is off, so create it with a migration (Model.sync() / efc db sync)`,\n );\n }\n if (e?.code === '23505') {\n const cols = /\\(([^)]+)\\)=/.exec(e.detail ?? '')?.[1] ?? 'field';\n const fields = cols\n .split(',')\n .map((c) => fieldOfColumn(c.trim().replace(/\"/g, '')))\n .join(', ');\n throw new HttpError(409, `${name} with this ${fields} already exists`);\n }\n // 23503 foreign_key_violation; 23001 restrict_violation (ON DELETE RESTRICT).\n if (e?.code === '23503' || e?.code === '23001') {\n const ref = /Key \\(([^)]+)\\)=\\([^)]*\\) is not present in table \"([^\"]+)\"/.exec(\n e.detail ?? '',\n );\n if (ref) {\n throw new ModelValidationError(name, [\n {\n // In a join table: the many-to-many field it backs.\n path: joinByTable.get(e.table ?? '') ?? fieldOfColumn(ref[1]!.replace(/\"/g, '')),\n message: `${modelOfTable(ref[2]!)} not found`,\n },\n ]);\n }\n const by = /is (?:still )?referenced from table \"([^\"]+)\"/.exec(e.detail ?? '')?.[1];\n throw new HttpError(\n 409,\n `${name} is still referenced${by ? ` by ${modelOfTable(by)}` : ''} — delete or reassign those records first`,\n );\n }\n if (e?.code === '23502')\n throw new ModelValidationError(name, [\n { path: fieldOfColumn(e.column ?? ''), message: 'is required' },\n ]);\n if (e?.code === '22P02' || e?.code === '22003' || e?.code === '23514')\n throw new ModelValidationError(name, [{ path: '', message: 'invalid value' }]);\n throw err;\n }\n };\n\n // ── Schema reconciliation ──────────────────────────────────────────────────\n // Brings the table in line with the model the way MongoDB \"just works\" when a schema\n // changes: create what's missing, convert changed column types, relax constraints the\n // model no longer asks for, rebuild enum checks, drop indexes EFC created that the\n // model no longer declares. Never drops a column or a row. Validation (required,\n // enum, ...) stays in the model, as on MongoDB — the database only keeps types,\n // uniqueness and enum checks, so editing a model can't strand existing rows.\n\n const JSONB_TO_ARRAY = 'efc_jsonb_text_array';\n const jsonbToArrayFn = `CREATE OR REPLACE FUNCTION ${JSONB_TO_ARRAY}(j jsonb) RETURNS text[] LANGUAGE sql IMMUTABLE AS $$ SELECT CASE WHEN j IS NULL OR jsonb_typeof(j) = 'null' THEN NULL WHEN jsonb_typeof(j) = 'array' THEN ARRAY(SELECT jsonb_array_elements_text(j)) ELSE ARRAY[j #>> '{}'] END $$`;\n\n // USING expression converting an existing column to the model's type.\n const castExpr = (spec: ColumnSpec, from: string): string => {\n const c = q(spec.column);\n if (spec.kind === 'jsonb') return `to_jsonb(${c})`;\n if (spec.kind === 'array') {\n if (from === 'jsonb') return `${JSONB_TO_ARRAY}(${c})::${spec.ddl}`;\n if (from.endsWith('[]')) return `${c}::${spec.ddl}`;\n return `CASE WHEN ${c} IS NULL THEN NULL ELSE ARRAY[${c}::text]::${spec.ddl} END`;\n }\n const scalar = from === 'jsonb' ? `(${c} #>> '{}')` : c;\n if (spec.kind === 'enum') return `${scalar}::text::${spec.ddl}`;\n if (spec.kind === 'bigint' || spec.kind === 'integer') {\n return `round(${scalar}::numeric)::${spec.ddl}`;\n }\n return `${scalar}::${spec.ddl}`;\n };\n\n // varchar never shrinks (and a text column isn't narrowed to varchar): rows could stop fitting.\n const needsTypeChange = (spec: ColumnSpec, existing: string): boolean => {\n if (existing === spec.formatted) return false;\n if (spec.kind === 'varchar') {\n if (existing === 'text') return false;\n const m = /^character varying\\((\\d+)\\)$/.exec(existing);\n if (m && Number(m[1]) >= spec.length!) return false;\n }\n return true;\n };\n\n const enumCheck = (column: string) => `${table}_${column}_enum`;\n\n // ── Foreign keys (defineTable refs) ────────────────────────────────────────\n\n interface ForeignKey {\n field: string;\n /** The table holding the constraint: this one, or one of its join tables. */\n onTable: string;\n column: string;\n name: string;\n target: string;\n targetTable: string;\n action: ReferentialAction;\n }\n\n const fkName = (column: string) => `${table}_${column}_fkey`;\n const isForeignKey = (spec: ColumnSpec) =>\n config.native && spec.node?.kind === 'scalar' && spec.node.def.ref !== undefined;\n\n /** A `ref`'s target table, checked against the field's id type. */\n function resolveTarget(field: string, targetName: string, kind: string, many: boolean) {\n const target =\n targetName === name ? { table, idKind } : getRegisteredModel(targetName)?.pgTarget?.();\n if (!target) {\n throw new Error(\n `[EFC] ${name}.${field} references \"${targetName}\", which is not defined — import that model before using ${name}`,\n );\n }\n const want = ID_COLUMN[target.idKind];\n if (kind !== want.kind) {\n const hint = many\n ? `{ type: 'array', of: '${want.type}', ref: '${targetName}' }`\n : `{ type: '${want.type}', ref: '${targetName}' }`;\n throw new Error(\n `[EFC] ${name}.${field} references ${targetName}, whose id is ${want.type} (id: '${target.idKind}') — declare it ${hint}`,\n );\n }\n return target;\n }\n\n /**\n * The foreign keys the model declares, resolved against their target models: one per\n * scalar ref, and two per join table (to this table and to the target, both cascading).\n */\n function foreignKeys(): ForeignKey[] {\n const out: ForeignKey[] = [];\n for (const spec of columns.values()) {\n if (!isForeignKey(spec)) continue;\n const def = spec.node!.def;\n const target = resolveTarget(spec.field, def.ref!, spec.kind, false);\n out.push({\n field: spec.field,\n onTable: table,\n column: spec.column,\n name: fkName(spec.column),\n target: def.ref!,\n targetTable: target.table,\n action: def.onDelete ?? 'restrict',\n });\n }\n for (const join of joins.values()) {\n const target = resolveTarget(join.field, join.target, join.item, true);\n const base = { field: join.field, onTable: join.table, action: 'cascade' as const };\n out.push(\n {\n ...base,\n column: 'owner_id',\n name: `${join.table}_owner_id_fkey`,\n target: name,\n targetTable: table,\n },\n {\n ...base,\n column: 'ref_id',\n name: `${join.table}_ref_id_fkey`,\n target: join.target,\n targetTable: target.table,\n },\n );\n }\n return out;\n }\n\n const joinByTable = new Map([...joins.values()].map((j) => [j.table, j.field]));\n const managedIndexName = /_(key|idx)$/;\n\n function desiredIndexes(): Map<string, string> {\n const out = new Map<string, string>();\n for (const spec of columns.values()) {\n const def = spec.node?.def;\n if (!def) continue;\n const col = spec.column;\n if (def.unique) {\n out.set(\n `${table}_${col}_key`,\n `CREATE UNIQUE INDEX ${q(`${table}_${col}_key`)} ON ${q(table)} (${q(col)})`,\n );\n } else if (def.index || (isForeignKey(spec) && def.index !== false)) {\n // Foreign key columns are indexed (joins, ON DELETE lookups) unless index: false.\n out.set(\n `${table}_${col}_idx`,\n `CREATE INDEX ${q(`${table}_${col}_idx`)} ON ${q(table)} (${q(col)})`,\n );\n }\n }\n for (const idx of options.indexes ?? []) {\n const fields = Object.entries(idx.fields).map(\n ([f, d]) => [columns.get(f)?.column ?? f, d] as const,\n );\n if (idx.expireAfterSeconds !== undefined) {\n throw new Error(`[EFC] ${name}: TTL indexes (expireAfterSeconds) are MongoDB-only`);\n }\n const idxName =\n idx.name ?? `${table}_${fields.map(([f]) => f).join('_')}_${idx.unique ? 'key' : 'idx'}`;\n if (fields.some(([, d]) => d === 'text')) {\n const doc = fields.map(([f]) => `coalesce(${q(f)}::text, '')`).join(` || ' ' || `);\n out.set(\n idxName,\n `CREATE INDEX ${q(idxName)} ON ${q(table)} USING gin (to_tsvector('simple', ${doc}))`,\n );\n } else {\n const cols = fields.map(([f, d]) => `${q(f)} ${d === -1 ? 'DESC' : 'ASC'}`).join(', ');\n out.set(\n idxName,\n `CREATE ${idx.unique ? 'UNIQUE ' : ''}INDEX ${q(idxName)} ON ${q(table)} (${cols})`,\n );\n }\n }\n return out;\n }\n\n const tableExists = async (t: string) =>\n (\n await getPool().query(\n `SELECT 1 FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace\n WHERE c.relname = $1 AND n.nspname = current_schema() AND c.relkind IN ('r', 'p')`,\n [t],\n )\n ).rowCount! > 0;\n\n /**\n * Syncs the table. A foreign key needs its target table, so missing targets are synced\n * first; one whose sync is already running here (A ↔ B references) is skipped this pass\n * and added by a second pass once that sync finishes.\n */\n async function reconcile(dryRun: boolean): Promise<string[]> {\n if (isSyncSuppressed()) return [];\n const fks = foreignKeys();\n if (dryRun) return statements(await reconcileTable({ dryRun: true }, fks, new Set()));\n let release!: () => void;\n const mine = new Promise<void>((resolve) => (release = resolve));\n const prev = syncing.get(table);\n syncing.set(table, mine);\n try {\n const deferred = new Set<string>();\n // First used inside a transaction: adding a foreign key locks the referenced table,\n // which that transaction may already have written to — the sync (on its own\n // connection) and the transaction would wait for each other forever. Create the\n // tables now; add the keys once the transaction has committed.\n const tx = currentTx();\n if (tx?.engine === 'postgresql' && fks.length) {\n for (const fk of fks) deferred.add(fk.name);\n tx.afterCommit.push(() => {\n reconcile(false).catch((err: unknown) =>\n getLogger().error({ err }, `${name}: adding foreign keys to \"${table}\" failed`),\n );\n });\n }\n for (const fk of fks) {\n if (deferred.has(fk.name)) continue;\n if (fk.targetTable === table || (await tableExists(fk.targetTable))) continue;\n const running = syncing.get(fk.targetTable);\n if (running) {\n deferred.add(fk.name);\n void running\n .then(() => reconcile(false))\n .catch((err: unknown) =>\n getLogger().error({ err }, `${name}: adding foreign keys to \"${table}\" failed`),\n );\n } else {\n await getRegisteredModel(fk.target)!.sync();\n }\n }\n return statements(await reconcileTable({ dryRun: false }, fks, deferred));\n } finally {\n release();\n if (syncing.get(table) === mine) {\n if (prev) syncing.set(table, prev);\n else syncing.delete(table);\n }\n }\n }\n\n const statements = (steps: PlanStep[]) => steps.filter((s) => !s.check).map((s) => s.sql);\n\n /**\n * The migration `efc db generate` writes for this table: what sync would do, plus the\n * explicit extras (`allowDrop`, `tighten`), each step with a best-effort reverse.\n */\n function plan(options: PlanOptions = {}): Promise<PlanStep[]> {\n return reconcileTable({ dryRun: true, plan: options }, foreignKeys(), new Set());\n }\n\n async function reconcileTable(\n mode: { dryRun: boolean; plan?: PlanOptions },\n fks: ForeignKey[],\n deferred: Set<string>,\n ): Promise<PlanStep[]> {\n const { dryRun } = mode;\n const generating = mode.plan !== undefined;\n const pool = getPool();\n const conn = await pool.connect();\n try {\n await conn.query('BEGIN');\n // Serialises concurrent syncs of this table (every cluster worker runs one on boot).\n await conn.query('SELECT pg_advisory_xact_lock(hashtext($1))', [`efc_sync:${table}`]);\n\n const existing = new Map<string, { type: string; nullable: boolean }>(\n (\n await conn.query<{ name: string; type: string; nullable: boolean }>(\n `SELECT a.attname AS name, format_type(a.atttypid, a.atttypmod) AS type, NOT a.attnotnull AS nullable\n FROM pg_attribute a JOIN pg_class c ON c.oid = a.attrelid JOIN pg_namespace n ON n.oid = c.relnamespace\n WHERE c.relname = $1 AND n.nspname = current_schema() AND a.attnum > 0 AND NOT a.attisdropped`,\n [table],\n )\n ).rows.map((r) => [r.name, { type: r.type, nullable: r.nullable }]),\n );\n const checks = new Map<string, { def: string; valid: boolean }>(\n (\n await conn.query<{ name: string; def: string; valid: boolean }>(\n `SELECT con.conname AS name, pg_get_constraintdef(con.oid) AS def, con.convalidated AS valid\n FROM pg_constraint con JOIN pg_class c ON c.oid = con.conrelid JOIN pg_namespace n ON n.oid = c.relnamespace\n WHERE c.relname = $1 AND n.nspname = current_schema() AND con.contype = 'c'`,\n [table],\n )\n ).rows.map((r) => [r.name, { def: r.def, valid: r.valid }]),\n );\n const indexes = new Map(\n (\n await conn.query<{ name: string; def: string }>(\n `SELECT indexname AS name, indexdef AS def FROM pg_indexes WHERE tablename = $1 AND schemaname = current_schema()`,\n [table],\n )\n ).rows.map((r) => [r.name, r.def]),\n );\n\n const liveFks = new Map(\n (\n await conn.query<{\n name: string;\n target: string;\n action: string;\n valid: boolean;\n def: string;\n }>(\n `SELECT con.conname AS name, ft.relname AS target, con.confdeltype AS action, con.convalidated AS valid,\n pg_get_constraintdef(con.oid) AS def\n FROM pg_constraint con JOIN pg_class c ON c.oid = con.conrelid JOIN pg_namespace n ON n.oid = c.relnamespace\n JOIN pg_class ft ON ft.oid = con.confrelid\n WHERE c.relname = ANY($1) AND n.nspname = current_schema() AND con.contype = 'f'`,\n [[table, ...joinByTable.keys()]],\n )\n ).rows.map((r) => [r.name, r]),\n );\n const liveJoinTables = new Set(\n (\n await conn.query<{ name: string }>(\n `SELECT c.relname AS name FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace\n WHERE c.relname = ANY($1) AND n.nspname = current_schema() AND c.relkind IN ('r', 'p')`,\n [[...joinByTable.keys()]],\n )\n ).rows.map((r) => r.name),\n );\n\n const steps: PlanStep[] = [];\n const add = (sql: string, extra: Omit<Partial<PlanStep>, 'sql'> = {}) => {\n if (!steps.some((s) => s.sql === sql)) steps.push({ phase: 'main', ...extra, sql });\n };\n const columnExists = (column: string) =>\n `SELECT 1 FROM information_schema.columns WHERE table_schema = current_schema() AND table_name = ${literal(table)} AND column_name = ${literal(column)}`;\n\n // Foreign keys on the model's fields that it no longer declares (or declares\n // differently) go first, before any column type change. Constraints on columns the\n // model doesn't declare are left alone.\n const wantedFks = new Map(fks.map((fk) => [fk.name, fk]));\n for (const [con, live] of liveFks) {\n const want = wantedFks.get(con);\n // Join tables are entirely EFC's.\n const ours =\n [...joinByTable.keys()].some((jt) => con.startsWith(`${jt}_`)) ||\n [...columns.values()].some((c) => c.field !== 'id' && fkName(c.column) === con);\n if (\n ours &&\n (!want || live.target !== want.targetTable || live.action !== ACTION_CODE[want.action])\n ) {\n const on = [...joinByTable.keys()].find((jt) => con.startsWith(`${jt}_`)) ?? table;\n add(`ALTER TABLE ${q(on)} DROP CONSTRAINT IF EXISTS ${q(con)}`, {\n down: `ALTER TABLE ${q(on)} ADD CONSTRAINT ${q(con)} ${live.def}`,\n });\n liveFks.delete(con);\n }\n }\n for (const { key } of sequences) {\n const seq = sequenceName(key);\n const found = await conn.query(\n `SELECT 1 FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace\n WHERE c.relkind = 'S' AND c.relname = $1 AND n.nspname = current_schema()`,\n [seq],\n );\n if (found.rowCount === 0)\n add(`CREATE SEQUENCE IF NOT EXISTS ${q(seq)}`, {\n down: `DROP SEQUENCE IF EXISTS ${q(seq)}`,\n });\n }\n\n // Native enum types: create, or add values the model gained. Values are never\n // removed (rows may hold them); the model rejects them on writes.\n const enumSpecs = [...columns.values()].filter((c) => c.kind === 'enum');\n if (enumSpecs.length) {\n const live = new Map<string, Set<string>>();\n for (const r of (\n await conn.query<{ type: string; label: string | null }>(\n `SELECT t.typname AS type, e.enumlabel AS label FROM pg_type t\n JOIN pg_namespace n ON n.oid = t.typnamespace LEFT JOIN pg_enum e ON e.enumtypid = t.oid\n WHERE n.nspname = current_schema() AND t.typname = ANY($1)`,\n [enumSpecs.map((c) => c.enumType)],\n )\n ).rows) {\n const set = live.get(r.type) ?? new Set<string>();\n if (r.label !== null) set.add(r.label);\n live.set(r.type, set);\n }\n for (const spec of enumSpecs) {\n const have = live.get(spec.enumType!);\n if (!have) {\n add(`CREATE TYPE ${spec.ddl} AS ENUM (${spec.enumValues!.map(literal).join(', ')})`, {\n down: `DROP TYPE IF EXISTS ${spec.ddl}`,\n skipIf: `SELECT 1 FROM pg_type t JOIN pg_namespace n ON n.oid = t.typnamespace WHERE n.nspname = current_schema() AND t.typname = ${literal(spec.enumType!)}`,\n });\n } else {\n for (const v of spec.enumValues!) {\n if (!have.has(v)) add(`ALTER TYPE ${spec.ddl} ADD VALUE IF NOT EXISTS ${literal(v)}`);\n }\n }\n }\n }\n\n const columnSql = (spec: ColumnSpec) => {\n const seq = sequenceKeys.get(spec.field);\n return `${q(spec.column)} ${spec.ddl}${seq ? ` DEFAULT nextval('${sequenceName(seq)}')` : ''}`;\n };\n const idSql =\n idKind === 'uuid'\n ? `${q('id')} uuid PRIMARY KEY DEFAULT gen_random_uuid()`\n : `${q('id')} ${idSpec.ddl} GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY`;\n const isRequired = (spec: ColumnSpec) =>\n spec.field !== 'id' && spec.node?.kind !== undefined && spec.node.def.required === true;\n\n if (existing.size === 0) {\n const defs = [...columns.values()].map((spec) =>\n spec.field === 'id' ? idSql : columnSql(spec),\n );\n add(`CREATE TABLE IF NOT EXISTS ${q(table)} (\\n ${defs.join(',\\n ')}\\n)`, {\n down: `DROP TABLE IF EXISTS ${q(table)}`,\n });\n } else {\n // Renames first: `renamedFrom` moves the old column (and its data) to the new name\n // instead of adding an empty one beside it.\n for (const spec of columns.values()) {\n const old = spec.node?.def.renamedFrom;\n if (old === undefined || existing.has(spec.column)) continue;\n const oldColumn = columnName(old);\n const col = existing.get(oldColumn);\n if (!col) continue;\n add(`ALTER TABLE ${q(table)} RENAME COLUMN ${q(oldColumn)} TO ${q(spec.column)}`, {\n down: `ALTER TABLE ${q(table)} RENAME COLUMN ${q(spec.column)} TO ${q(oldColumn)}`,\n skipIf: columnExists(spec.column),\n });\n existing.delete(oldColumn);\n existing.set(spec.column, col);\n }\n for (const spec of columns.values()) {\n const col = existing.get(spec.column);\n if (!col) {\n add(`ALTER TABLE ${q(table)} ADD COLUMN IF NOT EXISTS ${columnSql(spec)}`, {\n down: `ALTER TABLE ${q(table)} DROP COLUMN IF EXISTS ${q(spec.column)}`,\n });\n } else if (spec.field !== 'id' && needsTypeChange(spec, col.type)) {\n if (spec.kind === 'array' && col.type === 'jsonb') add(jsonbToArrayFn, { down: '' });\n const back =\n col.type === 'jsonb'\n ? `to_jsonb(${q(spec.column)})`\n : `${q(spec.column)}::${col.type}`;\n add(\n `ALTER TABLE ${q(table)} ALTER COLUMN ${q(spec.column)} TYPE ${spec.ddl} USING ${castExpr(spec, col.type)}`,\n {\n down: `ALTER TABLE ${q(table)} ALTER COLUMN ${q(spec.column)} TYPE ${col.type} USING ${back}`,\n skipIf: `SELECT 1 FROM pg_attribute a JOIN pg_class c ON c.oid = a.attrelid JOIN pg_namespace n ON n.oid = c.relnamespace WHERE n.nspname = current_schema() AND c.relname = ${literal(table)} AND a.attname = ${literal(spec.column)} AND format_type(a.atttypid, a.atttypmod) = ${literal(spec.formatted)}`,\n },\n );\n }\n }\n // NOT NULL is the model's job (validation), as on MongoDB: relax any the model\n // doesn't ask for — left over from an older model, an earlier EFC version, or a\n // column it no longer declares — so dropping/loosening a field never breaks inserts.\n for (const [column, col] of existing) {\n const spec = byColumn.get(column);\n if (column !== 'id' && !col.nullable && !(spec && isRequired(spec))) {\n add(`ALTER TABLE ${q(table)} ALTER COLUMN ${q(column)} DROP NOT NULL`, {\n down: `ALTER TABLE ${q(table)} ALTER COLUMN ${q(column)} SET NOT NULL`,\n });\n }\n }\n }\n\n // Enum checks: one managed constraint per (non-native) enum field, rebuilt when the\n // values change. NOT VALID: like MongoDB, existing rows aren't re-validated.\n const wantedChecks = new Map<string, string>();\n for (const spec of columns.values()) {\n const def = spec.node?.def;\n if (spec.node?.kind === 'scalar' && def?.enum && spec.kind !== 'enum') {\n wantedChecks.set(\n enumCheck(spec.column),\n `CHECK (${q(spec.column)} IN (${def.enum.map(literal).join(', ')}))`,\n );\n }\n }\n for (const [con, { def }] of checks) {\n const legacy = con.endsWith('_check') && con.startsWith(`${table}_`); // inline CHECKs from older EFC\n const drop = () => {\n add(`ALTER TABLE ${q(table)} DROP CONSTRAINT IF EXISTS ${q(con)}`, {\n down: `ALTER TABLE ${q(table)} ADD CONSTRAINT ${q(con)} ${def}`,\n });\n checks.delete(con);\n };\n if (\n (con.endsWith('_enum') && con.startsWith(`${table}_`) && !wantedChecks.has(con)) ||\n legacy\n ) {\n drop();\n } else if (wantedChecks.has(con)) {\n const want = wantedChecks.get(con)!;\n // pg_get_constraintdef normalises the text; compare the value lists only.\n const values = (d: string) =>\n [...d.matchAll(/'((?:[^']|'')*)'|(-?\\d+(?:\\.\\d+)?)/g)]\n .map((m) => m[1] ?? m[2])\n .sort()\n .join('|');\n if (values(def) !== values(want)) drop();\n }\n }\n for (const [con, def] of wantedChecks) {\n if (!checks.has(con))\n add(`ALTER TABLE ${q(table)} ADD CONSTRAINT ${q(con)} ${def} NOT VALID`, {\n down: `ALTER TABLE ${q(table)} DROP CONSTRAINT IF EXISTS ${q(con)}`,\n skipIf: `SELECT 1 FROM pg_constraint con JOIN pg_class c ON c.oid = con.conrelid JOIN pg_namespace n ON n.oid = c.relnamespace WHERE n.nspname = current_schema() AND c.relname = ${literal(table)} AND con.conname = ${literal(con)}`,\n });\n }\n\n // Indexes: create declared ones, drop EFC-named ones the model no longer declares.\n const wantedIndexes = desiredIndexes();\n for (const [idx, def] of indexes) {\n if (\n idx !== `${table}_pkey` &&\n idx.startsWith(`${table}_`) &&\n managedIndexName.test(idx) &&\n !wantedIndexes.has(idx)\n ) {\n add(`DROP INDEX IF EXISTS ${q(idx)}`, { down: def });\n }\n }\n for (const [idx, create] of wantedIndexes)\n if (!indexes.has(idx))\n add(create.replace(/^CREATE (UNIQUE )?INDEX /, 'CREATE $1INDEX IF NOT EXISTS '), {\n down: `DROP INDEX IF EXISTS ${q(idx)}`,\n });\n\n // Join tables for many-to-many refs: created once, filled from the array column the\n // field used before (if any). That column is kept, as sync never drops columns.\n const ownerDdl = idSpec.ddl;\n for (const join of joins.values()) {\n if (liveJoinTables.has(join.table)) continue;\n const refDdl = join.item;\n add(\n `CREATE TABLE IF NOT EXISTS ${q(join.table)} (\\n ${q('owner_id')} ${ownerDdl} NOT NULL,\\n ${q('ref_id')} ${refDdl} NOT NULL,\\n ${q('position')} integer NOT NULL DEFAULT 0,\\n PRIMARY KEY (${q('owner_id')}, ${q('ref_id')})\\n)`,\n { down: `DROP TABLE IF EXISTS ${q(join.table)}` },\n );\n add(\n `CREATE INDEX IF NOT EXISTS ${q(`${join.table}_ref_id_idx`)} ON ${q(join.table)} (${q('ref_id')})`,\n { down: '' }, // dropped with the table\n );\n const legacy = existing.get(join.legacyColumn)?.type;\n if (legacy === 'jsonb' || legacy?.endsWith('[]')) {\n const c = `o.${q(join.legacyColumn)}`;\n const items =\n legacy === 'jsonb'\n ? `jsonb_array_elements_text(CASE WHEN jsonb_typeof(${c}) = 'array' THEN ${c} ELSE '[]'::jsonb END)`\n : `unnest(${c}::text[])`;\n const valid =\n join.item === 'uuid'\n ? `'^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$'`\n : `'^-?[0-9]{1,18}$'`;\n add(\n `INSERT INTO ${q(join.table)} (${q('owner_id')}, ${q('ref_id')}, ${q('position')}) SELECT o.${q('id')}, x.v::${refDdl}, x.n FROM ${q(table)} o, ${items} WITH ORDINALITY AS x(v, n) WHERE x.v ~ ${valid} ON CONFLICT DO NOTHING`,\n { down: '' }, // the old column is kept\n );\n }\n }\n\n // `efc db generate` only, never automatic: changes that can fail on existing rows or\n // lose data. Each tightening is guarded by a check that names the offending rows.\n if (mode.plan?.tighten) {\n for (const spec of columns.values()) {\n if (!isRequired(spec) || existing.get(spec.column)?.nullable === false) continue;\n add(`SELECT count(*)::int AS n FROM ${q(table)} WHERE ${q(spec.column)} IS NULL`, {\n check: `${name}.${spec.field} is required, but %n row(s) of \"${table}\" have no value — fill them in, then run the migration again`,\n });\n add(`ALTER TABLE ${q(table)} ALTER COLUMN ${q(spec.column)} SET NOT NULL`, {\n down: `ALTER TABLE ${q(table)} ALTER COLUMN ${q(spec.column)} DROP NOT NULL`,\n });\n }\n for (const [con, def] of wantedChecks) {\n if (checks.get(con)?.valid) continue;\n const spec = byColumn.get(con.slice(table.length + 1, -'_enum'.length));\n const values = /IN \\((.*)\\)\\)$/.exec(def)?.[1];\n if (spec && values) {\n add(\n `SELECT count(*)::int AS n FROM ${q(table)} WHERE ${q(spec.column)} IS NOT NULL AND ${q(spec.column)} NOT IN (${values})`,\n {\n check: `${name}.${spec.field}: %n row(s) of \"${table}\" hold a value outside its enum — fix them, then run the migration again`,\n },\n );\n }\n add(`ALTER TABLE ${q(table)} VALIDATE CONSTRAINT ${q(con)}`, { down: '' });\n }\n }\n if (mode.plan?.allowDrop) {\n for (const [column, col] of existing) {\n if (byColumn.has(column)) continue;\n add(`ALTER TABLE ${q(table)} DROP COLUMN IF EXISTS ${q(column)}`, {\n down: `ALTER TABLE ${q(table)} ADD COLUMN IF NOT EXISTS ${q(column)} ${col.type} -- data is not restored`,\n });\n }\n }\n\n // Added NOT VALID — instant, and existing rows can't fail the sync — then validated\n // after the commit, where orphaned rows only produce a warning. A generated\n // migration validates in the same run, behind an orphaned-rows check.\n const toValidate: ForeignKey[] = [];\n for (const fk of fks) {\n if (deferred.has(fk.name)) continue;\n const live = liveFks.get(fk.name);\n if (!live) {\n add(\n `ALTER TABLE ${q(fk.onTable)} ADD CONSTRAINT ${q(fk.name)} FOREIGN KEY (${q(fk.column)}) REFERENCES ${q(fk.targetTable)} (${q('id')}) ON DELETE ${ACTION_SQL[fk.action]} NOT VALID`,\n {\n phase: 'fk',\n down: `ALTER TABLE ${q(fk.onTable)} DROP CONSTRAINT IF EXISTS ${q(fk.name)}`,\n skipIf: `SELECT 1 FROM pg_constraint con JOIN pg_class c ON c.oid = con.conrelid JOIN pg_namespace n ON n.oid = c.relnamespace WHERE n.nspname = current_schema() AND c.relname = ${literal(fk.onTable)} AND con.conname = ${literal(fk.name)}`,\n },\n );\n }\n if (!live?.valid) toValidate.push(fk);\n }\n const orphans = (fk: ForeignKey) =>\n `SELECT count(*)::int AS n FROM ${q(fk.onTable)} r WHERE ${q(fk.column)} IS NOT NULL AND NOT EXISTS (SELECT 1 FROM ${q(fk.targetTable)} t WHERE t.${q('id')} = r.${q(fk.column)})`;\n const validations = toValidate.map(\n (fk) => `ALTER TABLE ${q(fk.onTable)} VALIDATE CONSTRAINT ${q(fk.name)}`,\n );\n if (generating) {\n for (const [i, fk] of toValidate.entries()) {\n add(orphans(fk), {\n phase: 'fk',\n check: `${name}.${fk.field}: %n row(s) reference a missing ${fk.target} — fix them, then run the migration again`,\n });\n add(validations[i]!, { phase: 'fk', down: '' });\n }\n }\n\n if (!dryRun) {\n for (const { sql: stmt } of steps) {\n try {\n await conn.query(stmt);\n } catch (err) {\n throw new Error(\n `[EFC] ${name}: syncing table \"${table}\" failed on: ${stmt}\\n ${(err as Error).message}`,\n );\n }\n }\n }\n await conn.query(dryRun ? 'ROLLBACK' : 'COMMIT');\n if (!dryRun && steps.length) invalidatePreparedStatements(getPool());\n if (!dryRun) {\n for (const [i, fk] of toValidate.entries()) {\n try {\n await conn.query(validations[i]!);\n } catch {\n const n = await conn\n .query<{ n: number }>(orphans(fk))\n .then((r) => r.rows[0]?.n ?? '?')\n .catch(() => '?');\n getLogger().warn(\n { table, constraint: fk.name, orphans: Number(n) },\n `${name}.${fk.field}: ${n} row(s) reference a missing ${fk.target} — the foreign key applies to new writes; fix those rows, then run efc db sync to validate it`,\n );\n }\n }\n }\n return generating\n ? steps\n : [...steps, ...validations.map((sql) => ({ sql, phase: 'fk' as const }))];\n } catch (err) {\n await conn.query('ROLLBACK').catch(() => {});\n throw err;\n } finally {\n conn.release();\n }\n }\n\n async function drop() {\n const { sql } = await compile();\n await client().execute(sql.raw(`DROP TABLE IF EXISTS ${q(table)}`));\n invalidatePreparedStatements(getPool());\n }\n\n return {\n name,\n table,\n tree,\n idKind,\n columns,\n joins,\n ts,\n sequenceKeys,\n refs,\n compile,\n ready,\n client,\n columnFor,\n toDb,\n fromRow,\n fromRawRow,\n validate,\n known,\n prepareInsert,\n guard,\n reconcile,\n plan,\n drop,\n };\n}\n"]}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import {
|
|
2
|
+
ENQUEUE_BRIDGE,
|
|
3
|
+
enqueue
|
|
4
|
+
} from "./chunk-ZBQUYFI3.js";
|
|
5
|
+
import {
|
|
6
|
+
extractTrace,
|
|
7
|
+
injectTrace,
|
|
8
|
+
runWithContext
|
|
9
|
+
} from "./chunk-546TNO2V.js";
|
|
10
|
+
|
|
11
|
+
// src/tasks/thread-runner.ts
|
|
12
|
+
import { randomUUID } from "crypto";
|
|
13
|
+
import { context } from "@opentelemetry/api";
|
|
14
|
+
import { Worker, workerData, parentPort, isMainThread } from "worker_threads";
|
|
15
|
+
if (!isMainThread && parentPort && workerData?.efcTask) {
|
|
16
|
+
const port = parentPort;
|
|
17
|
+
const {
|
|
18
|
+
handlerPath,
|
|
19
|
+
payload,
|
|
20
|
+
token,
|
|
21
|
+
trace: parentTrace
|
|
22
|
+
} = workerData;
|
|
23
|
+
const waiting = /* @__PURE__ */ new Map();
|
|
24
|
+
let seq = 0;
|
|
25
|
+
port.unref();
|
|
26
|
+
port.on("message", (msg) => {
|
|
27
|
+
if (msg?.type !== "enqueued" || msg.token !== token) return;
|
|
28
|
+
const w = waiting.get(msg.id);
|
|
29
|
+
if (!w) return;
|
|
30
|
+
waiting.delete(msg.id);
|
|
31
|
+
if (waiting.size === 0) port.unref();
|
|
32
|
+
if (msg.error === void 0) w.resolve();
|
|
33
|
+
else w.reject(new Error(msg.error));
|
|
34
|
+
});
|
|
35
|
+
globalThis[ENQUEUE_BRIDGE] = (name, payload2) => new Promise((resolve, reject) => {
|
|
36
|
+
const id = ++seq;
|
|
37
|
+
waiting.set(id, { resolve, reject });
|
|
38
|
+
port.ref();
|
|
39
|
+
port.postMessage({
|
|
40
|
+
type: "enqueue",
|
|
41
|
+
token,
|
|
42
|
+
id,
|
|
43
|
+
name,
|
|
44
|
+
payload: payload2,
|
|
45
|
+
...parentTrace && { trace: injectTrace() }
|
|
46
|
+
});
|
|
47
|
+
});
|
|
48
|
+
(async () => {
|
|
49
|
+
try {
|
|
50
|
+
const mod = await import(handlerPath);
|
|
51
|
+
const def = mod["default"];
|
|
52
|
+
if (!def || typeof def.handler !== "function") {
|
|
53
|
+
throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);
|
|
54
|
+
}
|
|
55
|
+
const ctx = parentTrace ? extractTrace(parentTrace) : context.active();
|
|
56
|
+
await runWithContext(
|
|
57
|
+
{ otelContext: ctx },
|
|
58
|
+
() => context.with(ctx, () => def.handler(payload))
|
|
59
|
+
);
|
|
60
|
+
port.postMessage({ type: "done", ok: true, token });
|
|
61
|
+
} catch (err) {
|
|
62
|
+
port.postMessage({ type: "done", ok: false, error: String(err), token });
|
|
63
|
+
}
|
|
64
|
+
})();
|
|
65
|
+
}
|
|
66
|
+
function runInThread(handlerPath, payload, tracing = false) {
|
|
67
|
+
return new Promise((resolve, reject) => {
|
|
68
|
+
const token = randomUUID();
|
|
69
|
+
const worker = new Worker(new URL("./thread-runner.js", import.meta.url), {
|
|
70
|
+
workerData: {
|
|
71
|
+
efcTask: true,
|
|
72
|
+
handlerPath,
|
|
73
|
+
payload,
|
|
74
|
+
token,
|
|
75
|
+
...tracing && { trace: injectTrace() }
|
|
76
|
+
}
|
|
77
|
+
});
|
|
78
|
+
let completed = false;
|
|
79
|
+
let exited = false;
|
|
80
|
+
let settled = false;
|
|
81
|
+
const pending = /* @__PURE__ */ new Set();
|
|
82
|
+
const settle = (error) => {
|
|
83
|
+
if (settled) return;
|
|
84
|
+
settled = true;
|
|
85
|
+
if (error) reject(error);
|
|
86
|
+
else resolve();
|
|
87
|
+
};
|
|
88
|
+
worker.on("message", (message) => {
|
|
89
|
+
if (!message || typeof message !== "object" || message.token !== token)
|
|
90
|
+
return;
|
|
91
|
+
const msg = message;
|
|
92
|
+
if (msg.type === "enqueue") {
|
|
93
|
+
if (completed || !Number.isSafeInteger(msg.id) || typeof msg.name !== "string") return;
|
|
94
|
+
const reply = (error) => {
|
|
95
|
+
if (exited) return;
|
|
96
|
+
try {
|
|
97
|
+
worker.postMessage({
|
|
98
|
+
type: "enqueued",
|
|
99
|
+
token,
|
|
100
|
+
id: msg.id,
|
|
101
|
+
...error !== void 0 && { error }
|
|
102
|
+
});
|
|
103
|
+
} catch {
|
|
104
|
+
}
|
|
105
|
+
};
|
|
106
|
+
const parent = msg.trace ? extractTrace(msg.trace) : context.active();
|
|
107
|
+
const operation = Promise.resolve().then(() => context.with(parent, () => enqueue(msg.name, msg.payload))).then(
|
|
108
|
+
() => reply(),
|
|
109
|
+
(err) => reply(err instanceof Error ? err.message : String(err))
|
|
110
|
+
);
|
|
111
|
+
pending.add(operation);
|
|
112
|
+
void operation.then(() => pending.delete(operation));
|
|
113
|
+
return;
|
|
114
|
+
}
|
|
115
|
+
if (msg.type !== "done" || typeof msg.ok !== "boolean" || completed) return;
|
|
116
|
+
completed = true;
|
|
117
|
+
void Promise.allSettled([...pending]).then(() => worker.terminate()).then(
|
|
118
|
+
() => settle(
|
|
119
|
+
msg.ok ? void 0 : new Error(typeof msg.error === "string" ? msg.error : "Thread task failed")
|
|
120
|
+
),
|
|
121
|
+
(error) => settle(error instanceof Error ? error : new Error(String(error)))
|
|
122
|
+
);
|
|
123
|
+
});
|
|
124
|
+
worker.on("error", (error) => {
|
|
125
|
+
void worker.terminate().catch(() => {
|
|
126
|
+
});
|
|
127
|
+
settle(error);
|
|
128
|
+
});
|
|
129
|
+
worker.on("exit", (code) => {
|
|
130
|
+
exited = true;
|
|
131
|
+
if (!completed)
|
|
132
|
+
settle(new Error(`Thread worker exited with code ${code} before reporting completion`));
|
|
133
|
+
});
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
export {
|
|
138
|
+
runInThread
|
|
139
|
+
};
|
|
140
|
+
//# sourceMappingURL=chunk-PUM5ZDAH.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/tasks/thread-runner.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { context } from '@opentelemetry/api';\nimport { injectTrace, extractTrace, type TraceCarrier } from '../tracing.js';\nimport { runWithContext } from '../context.js';\nimport { Worker, workerData, parentPort, isMainThread } from 'node:worker_threads';\nimport type { TaskDefinition } from '../types.js';\nimport { enqueue, ENQUEUE_BRIDGE } from './index.js';\n\n// `{ thread: true }` tasks run here, in a worker_thread. The task queue lives on the main\n// thread, so `enqueue()` inside the thread is bridged: the thread posts the call, the main\n// thread runs the real enqueue() and posts back the outcome.\n\ntype FromThread = (\n | { type: 'done'; ok: true }\n | { type: 'done'; ok: false; error: string }\n | { type: 'enqueue'; id: number; name: string; payload: unknown; trace?: TraceCarrier }\n) & { token: string };\ntype ToThread = { type: 'enqueued'; id: number; error?: string; token: string };\n\n// ── Worker-thread side ────────────────────────────────────────────────────────\nif (!isMainThread && parentPort && (workerData as { efcTask?: boolean })?.efcTask) {\n const port = parentPort;\n const {\n handlerPath,\n payload,\n token,\n trace: parentTrace,\n } = workerData as { handlerPath: string; payload: unknown; trace?: TraceCarrier; token: string };\n const waiting = new Map<number, { resolve: () => void; reject: (e: Error) => void }>();\n let seq = 0;\n // The port only keeps the thread alive while an enqueue waits for its answer, so a\n // finished task's thread still exits.\n port.unref();\n port.on('message', (msg: ToThread) => {\n if (msg?.type !== 'enqueued' || msg.token !== token) return;\n const w = waiting.get(msg.id);\n if (!w) return;\n waiting.delete(msg.id);\n if (waiting.size === 0) port.unref();\n if (msg.error === undefined) w.resolve();\n else w.reject(new Error(msg.error));\n });\n // On globalThis, so the task's own copy of express-file-cluster/tasks (ESM or CJS)\n // finds it too.\n (globalThis as Record<symbol, unknown>)[ENQUEUE_BRIDGE] = (name: string, payload: unknown) =>\n new Promise<void>((resolve, reject) => {\n const id = ++seq;\n waiting.set(id, { resolve, reject });\n port.ref();\n port.postMessage({\n type: 'enqueue',\n token,\n id,\n name,\n payload,\n ...(parentTrace && { trace: injectTrace() }),\n } satisfies FromThread);\n });\n\n (async () => {\n try {\n const mod = (await import(handlerPath)) as Record<string, unknown>;\n const def = mod['default'] as TaskDefinition | undefined;\n if (!def || typeof def.handler !== 'function') {\n throw new Error(`[EFC] Thread runner: no valid task export in ${handlerPath}`);\n }\n const ctx = parentTrace ? extractTrace(parentTrace) : context.active();\n // A thread has no SDK unless the app initializes one there. Preserve the\n // carrier for nested enqueue even with the API's no-op context manager.\n await runWithContext({ otelContext: ctx }, () =>\n context.with(ctx, () => def.handler(payload)),\n );\n port.postMessage({ type: 'done', ok: true, token } satisfies FromThread);\n } catch (err) {\n port.postMessage({ type: 'done', ok: false, error: String(err), token } satisfies FromThread);\n }\n })();\n}\n\n// ── Main-thread side ──────────────────────────────────────────────────────────\nexport function runInThread(handlerPath: string, payload: unknown, tracing = false): Promise<void> {\n return new Promise((resolve, reject) => {\n const token = randomUUID();\n const worker = new Worker(new URL('./thread-runner.js', import.meta.url), {\n workerData: {\n efcTask: true,\n handlerPath,\n payload,\n token,\n ...(tracing && { trace: injectTrace() }),\n },\n });\n\n let completed = false;\n let exited = false;\n let settled = false;\n const pending = new Set<Promise<void>>();\n const settle = (error?: Error) => {\n if (settled) return;\n settled = true;\n if (error) reject(error);\n else resolve();\n };\n worker.on('message', (message: unknown) => {\n if (\n !message ||\n typeof message !== 'object' ||\n (message as { token?: unknown }).token !== token\n )\n return;\n const msg = message as FromThread;\n if (msg.type === 'enqueue') {\n if (completed || !Number.isSafeInteger(msg.id) || typeof msg.name !== 'string') return;\n const reply = (error?: string) => {\n if (exited) return;\n try {\n worker.postMessage({\n type: 'enqueued',\n token,\n id: msg.id,\n ...(error !== undefined && { error }),\n } satisfies ToThread);\n } catch {\n /* An exited worker has nobody left waiting for the reply. */\n }\n };\n const parent = msg.trace ? extractTrace(msg.trace) : context.active();\n const operation = Promise.resolve()\n .then(() => context.with(parent, () => enqueue(msg.name, msg.payload)))\n .then(\n () => reply(),\n (err: unknown) => reply(err instanceof Error ? err.message : String(err)),\n );\n pending.add(operation);\n void operation.then(() => pending.delete(operation));\n return;\n }\n if (msg.type !== 'done' || typeof msg.ok !== 'boolean' || completed) return;\n completed = true;\n // The job owns this isolate. Wait for bridge acknowledgments, then dispose\n // timers/open handles before releasing its queue slot or retrying it.\n void Promise.allSettled([...pending])\n .then(() => worker.terminate())\n .then(\n () =>\n settle(\n msg.ok\n ? undefined\n : new Error(typeof msg.error === 'string' ? msg.error : 'Thread task failed'),\n ),\n (error: unknown) => settle(error instanceof Error ? error : new Error(String(error))),\n );\n });\n worker.on('error', (error) => {\n void worker.terminate().catch(() => {});\n settle(error);\n });\n worker.on('exit', (code) => {\n exited = true;\n if (!completed)\n settle(new Error(`Thread worker exited with code ${code} before reporting completion`));\n });\n });\n}\n"],"mappings":"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","names":["payload"]}
|
|
@@ -2,7 +2,16 @@
|
|
|
2
2
|
var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
|
|
3
3
|
var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
|
|
4
4
|
|
|
5
|
+
// src/process-state.ts
|
|
6
|
+
function processState(name, initialize) {
|
|
7
|
+
const key = /* @__PURE__ */ Symbol.for("express-file-cluster.runtime.v1." + name);
|
|
8
|
+
const globals = globalThis;
|
|
9
|
+
if (!(key in globals)) globals[key] = initialize();
|
|
10
|
+
return globals[key];
|
|
11
|
+
}
|
|
5
12
|
|
|
6
13
|
|
|
7
|
-
|
|
8
|
-
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
exports.importMetaUrl = importMetaUrl; exports.processState = processState;
|
|
17
|
+
//# sourceMappingURL=chunk-PUYBKDYD.cjs.map
|