express-file-cluster 0.7.1 → 0.9.0

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.
Files changed (210) hide show
  1. package/README.md +3 -1
  2. package/dist/auth/index.cjs +3 -3
  3. package/dist/auth/index.d.cts +1 -1
  4. package/dist/auth/index.d.ts +1 -1
  5. package/dist/auth/index.js +2 -2
  6. package/dist/{chunk-ZDM5JHVK.cjs → chunk-2J3HHQKP.cjs} +3 -3
  7. package/dist/{chunk-ZDM5JHVK.cjs.map → chunk-2J3HHQKP.cjs.map} +1 -1
  8. package/dist/chunk-2PBMLMO4.js +1386 -0
  9. package/dist/chunk-2PBMLMO4.js.map +1 -0
  10. package/dist/chunk-66R7S7J3.cjs +1386 -0
  11. package/dist/chunk-66R7S7J3.cjs.map +1 -0
  12. package/dist/{chunk-6OGOVV57.js → chunk-6QNLN6AI.js} +118 -1266
  13. package/dist/chunk-6QNLN6AI.js.map +1 -0
  14. package/dist/chunk-BBSZLGZW.js +113 -0
  15. package/dist/chunk-BBSZLGZW.js.map +1 -0
  16. package/dist/{chunk-BUBXO7WU.js → chunk-HXV543HZ.js} +10 -3
  17. package/dist/chunk-HXV543HZ.js.map +1 -0
  18. package/dist/chunk-QL6EWT4B.cjs +113 -0
  19. package/dist/chunk-QL6EWT4B.cjs.map +1 -0
  20. package/dist/{chunk-AZYXQU3Z.cjs → chunk-RGTENTDN.cjs} +239 -1387
  21. package/dist/chunk-RGTENTDN.cjs.map +1 -0
  22. package/dist/{chunk-TRC4DUZB.js → chunk-RSZB7VAO.js} +2 -2
  23. package/dist/{chunk-MGH4VDV3.cjs → chunk-VQSWSYK6.cjs} +10 -3
  24. package/dist/chunk-VQSWSYK6.cjs.map +1 -0
  25. package/dist/cli/db-runner.cjs +613 -28
  26. package/dist/cli/db-runner.cjs.map +1 -1
  27. package/dist/cli/db-runner.js +611 -26
  28. package/dist/cli/db-runner.js.map +1 -1
  29. package/dist/cli/index.cjs +1210 -12
  30. package/dist/cli/index.cjs.map +1 -1
  31. package/dist/cli/index.js +1221 -23
  32. package/dist/cli/index.js.map +1 -1
  33. package/dist/docs/api-reference/db.md +1 -0
  34. package/dist/docs/api-reference/ignite.md +19 -0
  35. package/dist/docs/api-reference/table.md +3 -0
  36. package/dist/docs/cli/add.md +136 -0
  37. package/dist/docs/cli/db.md +25 -2
  38. package/dist/docs/cli/index.md +10 -1
  39. package/dist/docs/core-concepts/middleware.md +1 -1
  40. package/dist/docs/getting-started/index.md +25 -18
  41. package/dist/docs/getting-started/project-structure.md +6 -7
  42. package/dist/docs/guides/authentication.md +3 -1
  43. package/dist/docs/guides/coming-from-prisma.md +75 -0
  44. package/dist/docs/guides/database.md +5 -2
  45. package/dist/docs/guides/generated-portals.md +36 -19
  46. package/dist/docs/guides/mailer.md +7 -10
  47. package/dist/docs/guides/migrations.md +114 -3
  48. package/dist/docs/guides/oauth.md +94 -0
  49. package/dist/docs/guides/rbac.md +5 -40
  50. package/dist/docs/guides/relations.md +147 -0
  51. package/dist/docs/guides/which-api.md +50 -0
  52. package/dist/docs/index.md +7 -3
  53. package/dist/docs/skills/SKILL.md +3 -3
  54. package/dist/docs/skills/api-surface.md +1 -0
  55. package/dist/docs/skills/what-not-to-invent.md +22 -6
  56. package/dist/index.cjs +20 -18
  57. package/dist/index.cjs.map +1 -1
  58. package/dist/index.d.cts +2 -2
  59. package/dist/index.d.ts +2 -2
  60. package/dist/index.js +12 -10
  61. package/dist/index.js.map +1 -1
  62. package/dist/registry/index.json +506 -0
  63. package/dist/registry/js-mongo/_base.json +1 -0
  64. package/dist/registry/js-mongo/account-security.json +1 -0
  65. package/dist/registry/js-mongo/account-settings.json +1 -0
  66. package/dist/registry/js-mongo/admin-admins.json +1 -0
  67. package/dist/registry/js-mongo/admin-analytics.json +1 -0
  68. package/dist/registry/js-mongo/admin-billing.json +1 -0
  69. package/dist/registry/js-mongo/admin-content.json +1 -0
  70. package/dist/registry/js-mongo/admin-logs.json +1 -0
  71. package/dist/registry/js-mongo/admin-support.json +1 -0
  72. package/dist/registry/js-mongo/admin-system.json +1 -0
  73. package/dist/registry/js-mongo/admin-users.json +1 -0
  74. package/dist/registry/js-mongo/admin.json +1 -0
  75. package/dist/registry/js-mongo/auth.json +1 -0
  76. package/dist/registry/js-mongo/auth@apple.json +1 -0
  77. package/dist/registry/js-mongo/auth@google.json +1 -0
  78. package/dist/registry/js-mongo/billing.json +1 -0
  79. package/dist/registry/js-mongo/email-client.json +1 -0
  80. package/dist/registry/js-mongo/email-verification.json +1 -0
  81. package/dist/registry/js-mongo/files.json +1 -0
  82. package/dist/registry/js-mongo/forgot-password.json +1 -0
  83. package/dist/registry/js-mongo/notifications.json +1 -0
  84. package/dist/registry/js-mongo/support.json +1 -0
  85. package/dist/registry/js-mongo/user-profile.json +1 -0
  86. package/dist/registry/js-pg-model/_base.json +1 -0
  87. package/dist/registry/js-pg-model/account-security.json +1 -0
  88. package/dist/registry/js-pg-model/account-settings.json +1 -0
  89. package/dist/registry/js-pg-model/admin-admins.json +1 -0
  90. package/dist/registry/js-pg-model/admin-analytics.json +1 -0
  91. package/dist/registry/js-pg-model/admin-billing.json +1 -0
  92. package/dist/registry/js-pg-model/admin-content.json +1 -0
  93. package/dist/registry/js-pg-model/admin-logs.json +1 -0
  94. package/dist/registry/js-pg-model/admin-support.json +1 -0
  95. package/dist/registry/js-pg-model/admin-system.json +1 -0
  96. package/dist/registry/js-pg-model/admin-users.json +1 -0
  97. package/dist/registry/js-pg-model/admin.json +1 -0
  98. package/dist/registry/js-pg-model/auth.json +1 -0
  99. package/dist/registry/js-pg-model/auth@apple.json +1 -0
  100. package/dist/registry/js-pg-model/auth@google.json +1 -0
  101. package/dist/registry/js-pg-model/billing.json +1 -0
  102. package/dist/registry/js-pg-model/email-client.json +1 -0
  103. package/dist/registry/js-pg-model/email-verification.json +1 -0
  104. package/dist/registry/js-pg-model/files.json +1 -0
  105. package/dist/registry/js-pg-model/forgot-password.json +1 -0
  106. package/dist/registry/js-pg-model/notifications.json +1 -0
  107. package/dist/registry/js-pg-model/support.json +1 -0
  108. package/dist/registry/js-pg-model/user-profile.json +1 -0
  109. package/dist/registry/js-pg-table/_base.json +1 -0
  110. package/dist/registry/js-pg-table/account-security.json +1 -0
  111. package/dist/registry/js-pg-table/account-settings.json +1 -0
  112. package/dist/registry/js-pg-table/admin-admins.json +1 -0
  113. package/dist/registry/js-pg-table/admin-analytics.json +1 -0
  114. package/dist/registry/js-pg-table/admin-billing.json +1 -0
  115. package/dist/registry/js-pg-table/admin-content.json +1 -0
  116. package/dist/registry/js-pg-table/admin-logs.json +1 -0
  117. package/dist/registry/js-pg-table/admin-support.json +1 -0
  118. package/dist/registry/js-pg-table/admin-system.json +1 -0
  119. package/dist/registry/js-pg-table/admin-users.json +1 -0
  120. package/dist/registry/js-pg-table/admin.json +1 -0
  121. package/dist/registry/js-pg-table/auth.json +1 -0
  122. package/dist/registry/js-pg-table/auth@apple.json +1 -0
  123. package/dist/registry/js-pg-table/auth@google.json +1 -0
  124. package/dist/registry/js-pg-table/billing.json +1 -0
  125. package/dist/registry/js-pg-table/email-client.json +1 -0
  126. package/dist/registry/js-pg-table/email-verification.json +1 -0
  127. package/dist/registry/js-pg-table/files.json +1 -0
  128. package/dist/registry/js-pg-table/forgot-password.json +1 -0
  129. package/dist/registry/js-pg-table/notifications.json +1 -0
  130. package/dist/registry/js-pg-table/support.json +1 -0
  131. package/dist/registry/js-pg-table/user-profile.json +1 -0
  132. package/dist/registry/ts-mongo/_base.json +1 -0
  133. package/dist/registry/ts-mongo/account-security.json +1 -0
  134. package/dist/registry/ts-mongo/account-settings.json +1 -0
  135. package/dist/registry/ts-mongo/admin-admins.json +1 -0
  136. package/dist/registry/ts-mongo/admin-analytics.json +1 -0
  137. package/dist/registry/ts-mongo/admin-billing.json +1 -0
  138. package/dist/registry/ts-mongo/admin-content.json +1 -0
  139. package/dist/registry/ts-mongo/admin-logs.json +1 -0
  140. package/dist/registry/ts-mongo/admin-support.json +1 -0
  141. package/dist/registry/ts-mongo/admin-system.json +1 -0
  142. package/dist/registry/ts-mongo/admin-users.json +1 -0
  143. package/dist/registry/ts-mongo/admin.json +1 -0
  144. package/dist/registry/ts-mongo/auth.json +1 -0
  145. package/dist/registry/ts-mongo/auth@apple.json +1 -0
  146. package/dist/registry/ts-mongo/auth@google.json +1 -0
  147. package/dist/registry/ts-mongo/billing.json +1 -0
  148. package/dist/registry/ts-mongo/email-client.json +1 -0
  149. package/dist/registry/ts-mongo/email-verification.json +1 -0
  150. package/dist/registry/ts-mongo/files.json +1 -0
  151. package/dist/registry/ts-mongo/forgot-password.json +1 -0
  152. package/dist/registry/ts-mongo/notifications.json +1 -0
  153. package/dist/registry/ts-mongo/support.json +1 -0
  154. package/dist/registry/ts-mongo/user-profile.json +1 -0
  155. package/dist/registry/ts-pg-model/_base.json +1 -0
  156. package/dist/registry/ts-pg-model/account-security.json +1 -0
  157. package/dist/registry/ts-pg-model/account-settings.json +1 -0
  158. package/dist/registry/ts-pg-model/admin-admins.json +1 -0
  159. package/dist/registry/ts-pg-model/admin-analytics.json +1 -0
  160. package/dist/registry/ts-pg-model/admin-billing.json +1 -0
  161. package/dist/registry/ts-pg-model/admin-content.json +1 -0
  162. package/dist/registry/ts-pg-model/admin-logs.json +1 -0
  163. package/dist/registry/ts-pg-model/admin-support.json +1 -0
  164. package/dist/registry/ts-pg-model/admin-system.json +1 -0
  165. package/dist/registry/ts-pg-model/admin-users.json +1 -0
  166. package/dist/registry/ts-pg-model/admin.json +1 -0
  167. package/dist/registry/ts-pg-model/auth.json +1 -0
  168. package/dist/registry/ts-pg-model/auth@apple.json +1 -0
  169. package/dist/registry/ts-pg-model/auth@google.json +1 -0
  170. package/dist/registry/ts-pg-model/billing.json +1 -0
  171. package/dist/registry/ts-pg-model/email-client.json +1 -0
  172. package/dist/registry/ts-pg-model/email-verification.json +1 -0
  173. package/dist/registry/ts-pg-model/files.json +1 -0
  174. package/dist/registry/ts-pg-model/forgot-password.json +1 -0
  175. package/dist/registry/ts-pg-model/notifications.json +1 -0
  176. package/dist/registry/ts-pg-model/support.json +1 -0
  177. package/dist/registry/ts-pg-model/user-profile.json +1 -0
  178. package/dist/registry/ts-pg-table/_base.json +1 -0
  179. package/dist/registry/ts-pg-table/account-security.json +1 -0
  180. package/dist/registry/ts-pg-table/account-settings.json +1 -0
  181. package/dist/registry/ts-pg-table/admin-admins.json +1 -0
  182. package/dist/registry/ts-pg-table/admin-analytics.json +1 -0
  183. package/dist/registry/ts-pg-table/admin-billing.json +1 -0
  184. package/dist/registry/ts-pg-table/admin-content.json +1 -0
  185. package/dist/registry/ts-pg-table/admin-logs.json +1 -0
  186. package/dist/registry/ts-pg-table/admin-support.json +1 -0
  187. package/dist/registry/ts-pg-table/admin-system.json +1 -0
  188. package/dist/registry/ts-pg-table/admin-users.json +1 -0
  189. package/dist/registry/ts-pg-table/admin.json +1 -0
  190. package/dist/registry/ts-pg-table/auth.json +1 -0
  191. package/dist/registry/ts-pg-table/auth@apple.json +1 -0
  192. package/dist/registry/ts-pg-table/auth@google.json +1 -0
  193. package/dist/registry/ts-pg-table/billing.json +1 -0
  194. package/dist/registry/ts-pg-table/email-client.json +1 -0
  195. package/dist/registry/ts-pg-table/email-verification.json +1 -0
  196. package/dist/registry/ts-pg-table/files.json +1 -0
  197. package/dist/registry/ts-pg-table/forgot-password.json +1 -0
  198. package/dist/registry/ts-pg-table/notifications.json +1 -0
  199. package/dist/registry/ts-pg-table/support.json +1 -0
  200. package/dist/registry/ts-pg-table/user-profile.json +1 -0
  201. package/dist/tasks/index.d.cts +1 -1
  202. package/dist/tasks/index.d.ts +1 -1
  203. package/dist/{types-B6lVw4bj.d.ts → types-gyvA7BtO.d.cts} +18 -1
  204. package/dist/{types-B6lVw4bj.d.cts → types-gyvA7BtO.d.ts} +18 -1
  205. package/package.json +11 -2
  206. package/dist/chunk-6OGOVV57.js.map +0 -1
  207. package/dist/chunk-AZYXQU3Z.cjs.map +0 -1
  208. package/dist/chunk-BUBXO7WU.js.map +0 -1
  209. package/dist/chunk-MGH4VDV3.cjs.map +0 -1
  210. /package/dist/{chunk-TRC4DUZB.js.map → chunk-RSZB7VAO.js.map} +0 -0
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/db/query-log.ts","../src/db/postgres.ts"],"sourcesContent":["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\ninterface Resolved {\n all: boolean;\n slowMs: number;\n nPlusOne: number | false;\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 }\n : {\n all: q.all ?? false,\n slowMs: q.slowMs ?? DEFAULTS.slowMs,\n nPlusOne: q.nPlusOne ?? DEFAULTS.nPlusOne,\n };\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 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 type { Pool } from 'pg';\nimport { getLogger } from '../logger.js';\nimport { countStatement } from './query-log.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(url: string): 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({ connectionString: url });\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 await next.query('select 1');\n pool = next;\n // Every model statement goes through Drizzle, in or out of a transaction: count it.\n orm = drizzle(next, { logger: { logQuery: countStatement } });\n getLogger().info('PostgreSQL connected');\n return next;\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"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-MGH4VDV3.cjs","../src/db/query-log.ts","../src/db/postgres.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACLA,0CAAkC;AA6BlC,IAAM,SAAA,EAAW,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAA,EAAU,GAAG,CAAA;AAE7C,IAAI,MAAA;AACJ,IAAM,UAAA,kBAAY,IAAI,GAAA,CAAiC,CAAA;AACvD,IAAM,YAAA,EAA8B,CAAC,CAAA;AAG9B,SAAS,iBAAA,CAAkB,OAAA,EAAkD;AAClF,EAAA,MAAM,EAAA,EAAI,QAAA,IAAY,MAAA,EAAQ,KAAA,EAAA,kBAAY,OAAA,2BAAS,SAAA;AACnD,EAAA,OAAA,EAAS,CAAC,EAAA,EACN,KAAA,EAAA,EACA,EAAA,IAAM,KAAA,EACJ,EAAE,GAAA,EAAK,IAAA,EAAM,GAAG,SAAS,EAAA,EACzB;AAAA,IACE,GAAA,mBAAK,CAAA,CAAE,GAAA,UAAO,OAAA;AAAA,IACd,MAAA,mBAAQ,CAAA,CAAE,MAAA,UAAU,QAAA,CAAS,QAAA;AAAA,IAC7B,QAAA,mBAAU,CAAA,CAAE,QAAA,UAAY,QAAA,CAAS;AAAA,EACnC,CAAA;AACN,EAAA,GAAA,CAAI,MAAA,EAAQ,IAAA,CAAA,MAAW,KAAA,GAAQ,WAAA,EAAa,IAAA,CAAK,CAAA;AACnD;AAEA,SAAS,MAAA,CAAA,EAAkB;AACzB,EAAA,OAAO,OAAA,IAAW,KAAA,EAAA,GAAa,SAAA,CAAU,KAAA,EAAO,CAAA;AAClD;AAaO,SAAS,iBAAA,CAAkB,OAAA,EAA2B;AAC3D,EAAA,WAAA,CAAY,IAAA,CAAK,OAAO,CAAA;AACxB,EAAA,GAAA,CAAI,MAAA,CAAO,CAAA,EAAG,OAAA,CAAQ,CAAA;AACxB;AAOA,IAAM,OAAA,EAAS,IAAI,mCAAA,CAAqC,CAAA;AAGjD,SAAS,cAAA,CAAA,EAAuB;AACrC,EAAA,IAAA,CAAA,IAAS,EAAA,EAAI,MAAA,CAAO,QAAA,CAAS,CAAA,EAAG,CAAA,EAAG,EAAA,EAAI,CAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,UAAA,EAAA;AACrD;AAGO,SAAS,SAAA,CAAa,EAAA,EAAgB;AAC3C,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,KAAA,CAAA,EAAW,EAAE,CAAA;AACjC;AAGA,SAAS,QAAA,CAAS,MAAA,EAA2D;AAC3E,EAAA,MAAM,OAAA,EAA6B,CAAC,CAAA;AACpC,EAAA,KAAA,CAAM,iBAAA,CAAkB,MAAA,EAAQ,MAAM,CAAA;AACtC,EAAA,MAAM,KAAA,kBAAO,MAAA,qBAAO,KAAA,6BAAO,KAAA,mBAAM,IAAI,CAAA,qBAAE,CAAC,GAAA;AACxC,EAAA,uBAAO,IAAA,6BAAM,IAAA,mBAAK,CAAA,qBAAE,OAAA,mBAAQ,MAAA,EAAQ,EAAE,GAAA;AACxC;AAEA,SAAS,IAAA,CAAK,KAAA,EAAmB,IAAA,EAA0B,GAAA,EAAoB;AAC7E,EAAA,IAAA,CAAA,MAAW,SAAA,GAAY,SAAA,EAAW,QAAA,CAAS,KAAK,CAAA;AAChD,EAAA,GAAA,CAAI,CAAC,MAAA,EAAQ,MAAA;AACb,EAAA,MAAM,IAAA,EAAM,yCAAA,CAAU;AACtB,EAAA,MAAM,IAAA,EAAM,CAAA,EAAA;AAEN,EAAA;AACC,EAAA;AACG,EAAA;AACG,IAAA;AACF,EAAA;AACA,IAAA;AACX,EAAA;AACW,EAAA;AACb;AAES;AACK,EAAA;AACF,EAAA;AACE,EAAA;AACN,EAAA;AACK,EAAA;AACA,EAAA;AACD,EAAA;AACE,EAAA;AACD,IAAA;AACT,IAAA;AACF,EAAA;AACF;AAMgB;AACJ,EAAA;AACC,EAAA;AACE,IAAA;AACL,IAAA;AACC,MAAA;AACC,MAAA;AACA,MAAA;AAEA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACN,QAAA;AACE,UAAA;AACE,YAAA;AACA,YAAA;AACA,YAAA;AACA,YAAA;AACI,YAAA;AACA,YAAA;AACN,UAAA;AACA,UAAA;AACC,UAAA;AACH,QAAA;AACF,MAAA;AACO,MAAA;AAGF,QAAA;AACC,UAAA;AACA,UAAA;AACF,QAAA;AACC,QAAA;AACC,UAAA;AACA,UAAA;AACF,QAAA;AACF,MAAA;AACJ,IAAA;AACQ,IAAA;AACV,EAAA;AACO,EAAA;AACT;ADhEe;AACA;AErGX;AAGY;AACA,EAAA;AACP,EAAA;AAGT;AACI;AAEkB;AAChB,EAAA;AACA,EAAA;AACU,IAAA;AAIA,IAAA;AACL,EAAA;AACD,IAAA;AACR,EAAA;AACI,EAAA;AACA,EAAA;AACS,IAAA;AAGJ,EAAA;AACD,IAAA;AACR,EAAA;AAEa,EAAA;AAGL,EAAA;AACG,EAAA;AACJ,EAAA;AAED,EAAA;AACM,EAAA;AACL,EAAA;AACT;AAEgB;AACJ,EAAA;AACE,IAAA;AACR,MAAA;AACF,IAAA;AACF,EAAA;AACO,EAAA;AACT;AAEgB;AACH,EAAA;AACJ,EAAA;AACT;AAEsB;AACV,EAAA;AACH,EAAA;AACD,EAAA;AACO,EAAA;AACf;AFsFe;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/express-file-cluster/express-file-cluster/packages/core/dist/chunk-MGH4VDV3.cjs","sourcesContent":[null,"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\ninterface Resolved {\n all: boolean;\n slowMs: number;\n nPlusOne: number | false;\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 }\n : {\n all: q.all ?? false,\n slowMs: q.slowMs ?? DEFAULTS.slowMs,\n nPlusOne: q.nPlusOne ?? DEFAULTS.nPlusOne,\n };\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 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 type { Pool } from 'pg';\nimport { getLogger } from '../logger.js';\nimport { countStatement } from './query-log.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(url: string): 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({ connectionString: url });\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 await next.query('select 1');\n pool = next;\n // Every model statement goes through Drizzle, in or out of a transaction: count it.\n orm = drizzle(next, { logger: { logQuery: countStatement } });\n getLogger().info('PostgreSQL connected');\n return next;\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"]}