pipework 0.251.0 → 0.252.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.
Files changed (730) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/dist/core/config/load.d.ts +2 -0
  3. package/dist/core/config/load.d.ts.map +1 -1
  4. package/dist/core/config/load.js +1 -0
  5. package/dist/core/config/load.js.map +1 -1
  6. package/dist/core/config/namespace.d.ts +1 -0
  7. package/dist/core/config/namespace.d.ts.map +1 -1
  8. package/dist/core/config/schema.d.ts +2 -0
  9. package/dist/core/config/schema.d.ts.map +1 -1
  10. package/dist/core/config/schema.js +1 -0
  11. package/dist/core/config/schema.js.map +1 -1
  12. package/dist/core/surface/types.d.ts +1 -0
  13. package/dist/core/surface/types.d.ts.map +1 -1
  14. package/dist/data/db/namespace.d.ts +3 -0
  15. package/dist/data/db/namespace.d.ts.map +1 -1
  16. package/dist/data/db/namespace.js +3 -0
  17. package/dist/data/db/namespace.js.map +1 -1
  18. package/dist/data/db/pool.d.ts.map +1 -1
  19. package/dist/data/db/pool.js +6 -1
  20. package/dist/data/db/pool.js.map +1 -1
  21. package/dist/data/db/query-label.d.ts +5 -0
  22. package/dist/data/db/query-label.d.ts.map +1 -0
  23. package/dist/data/db/query-label.js +11 -0
  24. package/dist/data/db/query-label.js.map +1 -0
  25. package/dist/data/db/query-watch.d.ts +21 -0
  26. package/dist/data/db/query-watch.d.ts.map +1 -0
  27. package/dist/data/db/query-watch.js +90 -0
  28. package/dist/data/db/query-watch.js.map +1 -0
  29. package/dist/data/query/postgres-js/driver.js +1 -1
  30. package/dist/data/query/postgres-js/driver.js.map +1 -1
  31. package/dist/data/query/postgres-js/session.d.ts +5 -1
  32. package/dist/data/query/postgres-js/session.d.ts.map +1 -1
  33. package/dist/data/query/postgres-js/session.js +16 -11
  34. package/dist/data/query/postgres-js/session.js.map +1 -1
  35. package/dist/data/query/utils.d.ts +2 -0
  36. package/dist/data/query/utils.d.ts.map +1 -1
  37. package/dist/data/query/utils.js.map +1 -1
  38. package/dist/infra/credits/schema.d.ts +1 -1
  39. package/dist/test/plugin.d.ts.map +1 -1
  40. package/dist/test/plugin.js +10 -4
  41. package/dist/test/plugin.js.map +1 -1
  42. package/package.json +4 -3
  43. package/src/async/jobs/abortable-delay.ts +18 -0
  44. package/src/async/jobs/claims.ts +52 -0
  45. package/src/async/jobs/cron.ts +179 -0
  46. package/src/async/jobs/errors.ts +56 -0
  47. package/src/async/jobs/exclusion.ts +117 -0
  48. package/src/async/jobs/execute.ts +219 -0
  49. package/src/async/jobs/index.ts +10 -0
  50. package/src/async/jobs/listener.ts +135 -0
  51. package/src/async/jobs/namespace.ts +20 -0
  52. package/src/async/jobs/queue-door.ts +44 -0
  53. package/src/async/jobs/queue.ts +1012 -0
  54. package/src/async/jobs/run-script.ts +67 -0
  55. package/src/async/jobs/scheduler.ts +218 -0
  56. package/src/async/jobs/schedules-table.ts +37 -0
  57. package/src/async/jobs/serialize-error.ts +48 -0
  58. package/src/async/jobs/table.ts +191 -0
  59. package/src/async/pipeline/define.ts +53 -0
  60. package/src/async/pipeline/errors.ts +35 -0
  61. package/src/async/pipeline/execute.ts +53 -0
  62. package/src/async/pipeline/index.ts +13 -0
  63. package/src/async/pipeline/namespace.ts +12 -0
  64. package/src/async/pipeline/resume.ts +67 -0
  65. package/src/async/pipeline/run-steps.ts +98 -0
  66. package/src/async/pipeline/types.ts +57 -0
  67. package/src/async/state-machine/define.ts +64 -0
  68. package/src/async/state-machine/errors.ts +29 -0
  69. package/src/async/state-machine/index.ts +3 -0
  70. package/src/async/state-machine/namespace.ts +12 -0
  71. package/src/async/state-machine/transition.ts +90 -0
  72. package/src/async/state-machine/types.ts +37 -0
  73. package/src/async/steps/errors.ts +31 -0
  74. package/src/async/steps/graph.ts +1214 -0
  75. package/src/async/steps/hash.ts +40 -0
  76. package/src/async/steps/index.ts +7 -0
  77. package/src/async/steps/namespace.ts +7 -0
  78. package/src/async/steps/table.ts +97 -0
  79. package/src/async/steps/types.ts +318 -0
  80. package/src/audit/chain/index.ts +9 -0
  81. package/src/audit/chain/install.ts +113 -0
  82. package/src/audit/chain/retire.ts +52 -0
  83. package/src/audit/chain/verify.ts +257 -0
  84. package/src/audit/query/cursor.ts +37 -0
  85. package/src/audit/query/index.ts +9 -0
  86. package/src/audit/query/query.ts +223 -0
  87. package/src/audit/schema/audit-record-fields.ts +68 -0
  88. package/src/audit/schema/audit-record.ts +23 -0
  89. package/src/auth/auth/audit.ts +31 -0
  90. package/src/auth/auth/chain.ts +84 -0
  91. package/src/auth/auth/cookie.ts +136 -0
  92. package/src/auth/auth/email-links.ts +311 -0
  93. package/src/auth/auth/guard.ts +128 -0
  94. package/src/auth/auth/index.ts +18 -0
  95. package/src/auth/auth/multi-org.ts +337 -0
  96. package/src/auth/auth/namespace.ts +34 -0
  97. package/src/auth/auth/parse-expiry.ts +13 -0
  98. package/src/auth/auth/passwords.ts +110 -0
  99. package/src/auth/auth/schema.ts +110 -0
  100. package/src/auth/auth/sessions.ts +565 -0
  101. package/src/auth/auth/sign-in.ts +156 -0
  102. package/src/auth/auth/signing-keys.ts +69 -0
  103. package/src/auth/auth/types.ts +26 -0
  104. package/src/auth/auth/uuid.ts +10 -0
  105. package/src/auth/rbac/cache.ts +55 -0
  106. package/src/auth/rbac/check.ts +30 -0
  107. package/src/auth/rbac/create.ts +35 -0
  108. package/src/auth/rbac/index.ts +5 -0
  109. package/src/auth/rbac/middleware.ts +20 -0
  110. package/src/auth/rbac/namespace.ts +15 -0
  111. package/src/auth/rbac/resolve.ts +31 -0
  112. package/src/auth/rbac/schema.sql +31 -0
  113. package/src/auth/rbac/seed.ts +67 -0
  114. package/src/auth/rbac/tables.ts +32 -0
  115. package/src/auth/rbac/types.ts +65 -0
  116. package/src/auth/tenant/extract.ts +33 -0
  117. package/src/auth/tenant/in-tenant.ts +49 -0
  118. package/src/auth/tenant/index.ts +7 -0
  119. package/src/auth/tenant/namespace.ts +23 -0
  120. package/src/auth/tenant/propagate.ts +20 -0
  121. package/src/auth/tenant/rls.ts +120 -0
  122. package/src/auth/tenant/scope.ts +33 -0
  123. package/src/auth/tenant/scoped-db.ts +581 -0
  124. package/src/auth/tenant/types.ts +14 -0
  125. package/src/auth/tenant/validate.ts +27 -0
  126. package/src/cli/commands/add.ts +158 -0
  127. package/src/cli/commands/alerts.ts +98 -0
  128. package/src/cli/commands/check.ts +1418 -0
  129. package/src/cli/commands/codemod.ts +78 -0
  130. package/src/cli/commands/db.ts +356 -0
  131. package/src/cli/commands/dev.ts +101 -0
  132. package/src/cli/commands/generate.ts +75 -0
  133. package/src/cli/commands/init.ts +36 -0
  134. package/src/cli/commands/install.ts +28 -0
  135. package/src/cli/commands/lint.ts +62 -0
  136. package/src/cli/commands/migrate.ts +132 -0
  137. package/src/cli/commands/openapi.ts +63 -0
  138. package/src/cli/commands/remove.ts +72 -0
  139. package/src/cli/commands/run.ts +50 -0
  140. package/src/cli/commands/scope.ts +54 -0
  141. package/src/cli/commands/serve.ts +68 -0
  142. package/src/cli/commands/shard.ts +31 -0
  143. package/src/cli/commands/shared/config-pipework-version.ts +28 -0
  144. package/src/cli/commands/shared/find-config.ts +22 -0
  145. package/src/cli/commands/shared/load-config.ts +35 -0
  146. package/src/cli/commands/shared/pnpm-install.ts +95 -0
  147. package/src/cli/commands/shared/report-removed.ts +8 -0
  148. package/src/cli/commands/sync.ts +32 -0
  149. package/src/cli/commands/test.ts +307 -0
  150. package/src/cli/commands/upgrade.ts +48 -0
  151. package/src/cli/dev-bootstrap.ts +24 -0
  152. package/src/cli/errors.ts +10 -0
  153. package/src/cli/index.ts +303 -0
  154. package/src/cli/output.ts +17 -0
  155. package/src/cli/port.ts +15 -0
  156. package/src/cli/surface-kinds.ts +20 -0
  157. package/src/client/index.ts +4 -0
  158. package/src/client/poll.ts +130 -0
  159. package/src/client/report-fault.ts +119 -0
  160. package/src/core/config/app-pool.ts +19 -0
  161. package/src/core/config/aws-env.ts +29 -0
  162. package/src/core/config/base-dir.ts +24 -0
  163. package/src/core/config/discover.ts +64 -0
  164. package/src/core/config/env-resolve.ts +87 -0
  165. package/src/core/config/env-types.ts +116 -0
  166. package/src/core/config/env.ts +55 -0
  167. package/src/core/config/errors.ts +9 -0
  168. package/src/core/config/import-config.ts +40 -0
  169. package/src/core/config/index.ts +8 -0
  170. package/src/core/config/load.ts +417 -0
  171. package/src/core/config/namespace.ts +14 -0
  172. package/src/core/config/resolve.ts +195 -0
  173. package/src/core/config/schema.ts +488 -0
  174. package/src/core/config/statement-observer.ts +48 -0
  175. package/src/core/config/ts-inline-hooks.ts +75 -0
  176. package/src/core/config/ts-register.ts +4 -0
  177. package/src/core/config/ts-resolve-hooks.ts +101 -0
  178. package/src/core/errors/base.ts +49 -0
  179. package/src/core/errors/http.ts +146 -0
  180. package/src/core/errors/index.ts +2 -0
  181. package/src/core/errors/namespace.ts +31 -0
  182. package/src/core/lifecycle/drain.ts +33 -0
  183. package/src/core/lifecycle/health.ts +72 -0
  184. package/src/core/lifecycle/index.ts +4 -0
  185. package/src/core/lifecycle/namespace.ts +7 -0
  186. package/src/core/lifecycle/startup.ts +102 -0
  187. package/src/core/lifecycle/types.ts +36 -0
  188. package/src/core/logging/context.ts +60 -0
  189. package/src/core/logging/error-chain.ts +68 -0
  190. package/src/core/logging/index.ts +5 -0
  191. package/src/core/logging/logger.ts +65 -0
  192. package/src/core/logging/namespace.ts +16 -0
  193. package/src/core/logging/proxy.ts +22 -0
  194. package/src/core/logging/redact-match.ts +24 -0
  195. package/src/core/logging/types.ts +47 -0
  196. package/src/core/pipework.ts +566 -0
  197. package/src/core/runtime/broker.ts +69 -0
  198. package/src/core/surface/http.ts +133 -0
  199. package/src/core/surface/index.ts +11 -0
  200. package/src/core/surface/job-timeout.ts +40 -0
  201. package/src/core/surface/namespace.ts +13 -0
  202. package/src/core/surface/script.ts +33 -0
  203. package/src/core/surface/start.ts +142 -0
  204. package/src/core/surface/types.ts +225 -0
  205. package/src/core/surface/validate.ts +88 -0
  206. package/src/core/surface/worker.ts +528 -0
  207. package/src/core/validation/connectivity.ts +49 -0
  208. package/src/core/validation/domain.ts +99 -0
  209. package/src/core/validation/index.ts +5 -0
  210. package/src/core/validation/queue-tables.ts +312 -0
  211. package/src/core/validation/rls-role.ts +138 -0
  212. package/src/core/validation/startup.ts +51 -0
  213. package/src/core/validation/surfaces.ts +65 -0
  214. package/src/core/validation/types.ts +25 -0
  215. package/src/data/db/advisory-lock.ts +55 -0
  216. package/src/data/db/aggregates.ts +172 -0
  217. package/src/data/db/array-elements.ts +111 -0
  218. package/src/data/db/bulk-set.ts +53 -0
  219. package/src/data/db/col/index.ts +14 -0
  220. package/src/data/db/composed.ts +53 -0
  221. package/src/data/db/db.ts +276 -0
  222. package/src/data/db/excluded.ts +16 -0
  223. package/src/data/db/expressions.ts +473 -0
  224. package/src/data/db/filter.ts +90 -0
  225. package/src/data/db/function-source.ts +114 -0
  226. package/src/data/db/identifiers.ts +16 -0
  227. package/src/data/db/idx/index.ts +9 -0
  228. package/src/data/db/in-list.ts +49 -0
  229. package/src/data/db/index.ts +9 -0
  230. package/src/data/db/insert-split.ts +137 -0
  231. package/src/data/db/instrumentation.ts +82 -0
  232. package/src/data/db/maintenance.ts +28 -0
  233. package/src/data/db/namespace.ts +107 -0
  234. package/src/data/db/owner-labels.ts +9 -0
  235. package/src/data/db/pool.ts +187 -0
  236. package/src/data/db/query-label.ts +13 -0
  237. package/src/data/db/query-watch.ts +116 -0
  238. package/src/data/db/raw-client-warning.ts +37 -0
  239. package/src/data/db/readonly.ts +23 -0
  240. package/src/data/db/reservation.ts +151 -0
  241. package/src/data/db/schema-features.ts +14 -0
  242. package/src/data/db/serializable.ts +83 -0
  243. package/src/data/db/sql.ts +1 -0
  244. package/src/data/db/timeouts.ts +76 -0
  245. package/src/data/db/types.ts +18 -0
  246. package/src/data/db/unbound.ts +33 -0
  247. package/src/data/db/values.ts +29 -0
  248. package/src/data/domain/brand.ts +15 -0
  249. package/src/data/domain/build-factory.ts +193 -0
  250. package/src/data/domain/build-schema.ts +161 -0
  251. package/src/data/domain/build-table.ts +355 -0
  252. package/src/data/domain/define.ts +239 -0
  253. package/src/data/domain/external-registry.ts +34 -0
  254. package/src/data/domain/external.ts +77 -0
  255. package/src/data/domain/field.ts +279 -0
  256. package/src/data/domain/index.ts +13 -0
  257. package/src/data/domain/naming.ts +6 -0
  258. package/src/data/domain/projections.ts +57 -0
  259. package/src/data/domain/trace-safe-projection.ts +31 -0
  260. package/src/data/domain/traits.ts +108 -0
  261. package/src/data/domain/types.ts +289 -0
  262. package/src/data/jsonb/composed.ts +18 -0
  263. package/src/data/jsonb/index.ts +1 -0
  264. package/src/data/jsonb/namespace.ts +30 -0
  265. package/src/data/jsonb/query.ts +86 -0
  266. package/src/data/migrate/append-only-generate.ts +47 -0
  267. package/src/data/migrate/applied.ts +47 -0
  268. package/src/data/migrate/apply.ts +309 -0
  269. package/src/data/migrate/check.ts +119 -0
  270. package/src/data/migrate/diff.ts +357 -0
  271. package/src/data/migrate/door-generate.ts +130 -0
  272. package/src/data/migrate/framework-rls.ts +58 -0
  273. package/src/data/migrate/generate.ts +201 -0
  274. package/src/data/migrate/history.ts +215 -0
  275. package/src/data/migrate/index.ts +9 -0
  276. package/src/data/migrate/internal-definitions.ts +175 -0
  277. package/src/data/migrate/post-process.ts +73 -0
  278. package/src/data/migrate/pragma.ts +73 -0
  279. package/src/data/migrate/provision-framework.ts +147 -0
  280. package/src/data/migrate/rls-generate.ts +61 -0
  281. package/src/data/migrate/run.ts +124 -0
  282. package/src/data/migrate/safety.ts +167 -0
  283. package/src/data/migrate/snapshot.ts +368 -0
  284. package/src/data/migrate/sql-emit.ts +392 -0
  285. package/src/data/migrate/statements.ts +312 -0
  286. package/src/data/query/alias.ts +126 -0
  287. package/src/data/query/batch.ts +8 -0
  288. package/src/data/query/cache/core/cache.ts +78 -0
  289. package/src/data/query/cache/core/index.ts +1 -0
  290. package/src/data/query/cache/core/types.ts +29 -0
  291. package/src/data/query/cache/readme.md +230 -0
  292. package/src/data/query/casing.ts +76 -0
  293. package/src/data/query/collation.ts +11 -0
  294. package/src/data/query/column-builder.ts +370 -0
  295. package/src/data/query/column.ts +150 -0
  296. package/src/data/query/entity.ts +42 -0
  297. package/src/data/query/errors.ts +33 -0
  298. package/src/data/query/index.ts +14 -0
  299. package/src/data/query/logger.ts +47 -0
  300. package/src/data/query/operations.ts +45 -0
  301. package/src/data/query/pg-core/alias.ts +12 -0
  302. package/src/data/query/pg-core/checks.ts +32 -0
  303. package/src/data/query/pg-core/columns/all.ts +71 -0
  304. package/src/data/query/pg-core/columns/bigint.ts +110 -0
  305. package/src/data/query/pg-core/columns/bigserial.ts +128 -0
  306. package/src/data/query/pg-core/columns/boolean.ts +43 -0
  307. package/src/data/query/pg-core/columns/char.ts +85 -0
  308. package/src/data/query/pg-core/columns/cidr.ts +43 -0
  309. package/src/data/query/pg-core/columns/common.ts +366 -0
  310. package/src/data/query/pg-core/columns/custom.ts +232 -0
  311. package/src/data/query/pg-core/columns/date.common.ts +15 -0
  312. package/src/data/query/pg-core/columns/date.ts +112 -0
  313. package/src/data/query/pg-core/columns/double-precision.ts +55 -0
  314. package/src/data/query/pg-core/columns/enum.ts +201 -0
  315. package/src/data/query/pg-core/columns/index.ts +35 -0
  316. package/src/data/query/pg-core/columns/inet.ts +43 -0
  317. package/src/data/query/pg-core/columns/int.common.ts +57 -0
  318. package/src/data/query/pg-core/columns/integer.ts +53 -0
  319. package/src/data/query/pg-core/columns/interval.ts +83 -0
  320. package/src/data/query/pg-core/columns/json.ts +58 -0
  321. package/src/data/query/pg-core/columns/jsonb.ts +56 -0
  322. package/src/data/query/pg-core/columns/line.ts +117 -0
  323. package/src/data/query/pg-core/columns/macaddr.ts +43 -0
  324. package/src/data/query/pg-core/columns/macaddr8.ts +43 -0
  325. package/src/data/query/pg-core/columns/numeric.ts +227 -0
  326. package/src/data/query/pg-core/columns/point.ts +127 -0
  327. package/src/data/query/pg-core/columns/postgis_extension/geometry.ts +119 -0
  328. package/src/data/query/pg-core/columns/postgis_extension/utils.ts +47 -0
  329. package/src/data/query/pg-core/columns/real.ts +58 -0
  330. package/src/data/query/pg-core/columns/serial.ts +55 -0
  331. package/src/data/query/pg-core/columns/smallint.ts +53 -0
  332. package/src/data/query/pg-core/columns/smallserial.ts +60 -0
  333. package/src/data/query/pg-core/columns/text.ts +67 -0
  334. package/src/data/query/pg-core/columns/time.ts +72 -0
  335. package/src/data/query/pg-core/columns/timestamp.ts +163 -0
  336. package/src/data/query/pg-core/columns/uuid.ts +51 -0
  337. package/src/data/query/pg-core/columns/varchar.ts +89 -0
  338. package/src/data/query/pg-core/columns/vector_extension/bit.ts +68 -0
  339. package/src/data/query/pg-core/columns/vector_extension/halfvec.ts +80 -0
  340. package/src/data/query/pg-core/columns/vector_extension/sparsevec.ts +67 -0
  341. package/src/data/query/pg-core/columns/vector_extension/vector.ts +80 -0
  342. package/src/data/query/pg-core/db.ts +674 -0
  343. package/src/data/query/pg-core/dialect.ts +1404 -0
  344. package/src/data/query/pg-core/expressions.ts +25 -0
  345. package/src/data/query/pg-core/foreign-keys.ts +130 -0
  346. package/src/data/query/pg-core/index.ts +21 -0
  347. package/src/data/query/pg-core/indexes.ts +276 -0
  348. package/src/data/query/pg-core/policies.ts +56 -0
  349. package/src/data/query/pg-core/primary-keys.ts +62 -0
  350. package/src/data/query/pg-core/query-builders/count.ts +86 -0
  351. package/src/data/query/pg-core/query-builders/delete.ts +293 -0
  352. package/src/data/query/pg-core/query-builders/index.ts +7 -0
  353. package/src/data/query/pg-core/query-builders/insert.ts +452 -0
  354. package/src/data/query/pg-core/query-builders/query-builder.ts +123 -0
  355. package/src/data/query/pg-core/query-builders/query.ts +157 -0
  356. package/src/data/query/pg-core/query-builders/raw.ts +49 -0
  357. package/src/data/query/pg-core/query-builders/refresh-materialized-view.ts +108 -0
  358. package/src/data/query/pg-core/query-builders/select.ts +1346 -0
  359. package/src/data/query/pg-core/query-builders/select.types.ts +437 -0
  360. package/src/data/query/pg-core/query-builders/update.ts +626 -0
  361. package/src/data/query/pg-core/roles.ts +41 -0
  362. package/src/data/query/pg-core/schema.ts +72 -0
  363. package/src/data/query/pg-core/sequence.ts +41 -0
  364. package/src/data/query/pg-core/session.ts +292 -0
  365. package/src/data/query/pg-core/subquery.ts +46 -0
  366. package/src/data/query/pg-core/table.ts +252 -0
  367. package/src/data/query/pg-core/unique-constraint.ts +73 -0
  368. package/src/data/query/pg-core/utils/array.ts +95 -0
  369. package/src/data/query/pg-core/utils/index.ts +1 -0
  370. package/src/data/query/pg-core/utils.ts +104 -0
  371. package/src/data/query/pg-core/view-base.ts +14 -0
  372. package/src/data/query/pg-core/view-common.ts +1 -0
  373. package/src/data/query/pg-core/view.ts +435 -0
  374. package/src/data/query/pg-core/with-builder.ts +41 -0
  375. package/src/data/query/postgres-js/README.md +46 -0
  376. package/src/data/query/postgres-js/array-parser.ts +45 -0
  377. package/src/data/query/postgres-js/driver-error-boundary.ts +149 -0
  378. package/src/data/query/postgres-js/driver.ts +163 -0
  379. package/src/data/query/postgres-js/index.ts +2 -0
  380. package/src/data/query/postgres-js/session.ts +234 -0
  381. package/src/data/query/primary-key.ts +11 -0
  382. package/src/data/query/query-builders/query-builder.ts +19 -0
  383. package/src/data/query/query-builders/select.types.ts +175 -0
  384. package/src/data/query/query-promise.ts +35 -0
  385. package/src/data/query/relations.ts +725 -0
  386. package/src/data/query/runnable-query.ts +12 -0
  387. package/src/data/query/selection-proxy.ts +121 -0
  388. package/src/data/query/session.ts +8 -0
  389. package/src/data/query/sql/expressions/conditions.ts +741 -0
  390. package/src/data/query/sql/expressions/index.ts +2 -0
  391. package/src/data/query/sql/expressions/select.ts +45 -0
  392. package/src/data/query/sql/functions/aggregate.ts +129 -0
  393. package/src/data/query/sql/functions/index.ts +2 -0
  394. package/src/data/query/sql/functions/vector.ts +178 -0
  395. package/src/data/query/sql/index.ts +3 -0
  396. package/src/data/query/sql/sql.ts +794 -0
  397. package/src/data/query/subquery.ts +53 -0
  398. package/src/data/query/table.ts +208 -0
  399. package/src/data/query/table.utils.ts +2 -0
  400. package/src/data/query/tracing-utils.ts +3 -0
  401. package/src/data/query/tracing.ts +11 -0
  402. package/src/data/query/utils.ts +357 -0
  403. package/src/data/query/version.ts +4 -0
  404. package/src/data/query/view-common.ts +1 -0
  405. package/src/data/schema/branded.ts +13 -0
  406. package/src/data/schema/generated/coerce.ts +5 -0
  407. package/src/data/schema/generated/combinator.ts +6 -0
  408. package/src/data/schema/generated/encoding.ts +5 -0
  409. package/src/data/schema/generated/error.ts +6 -0
  410. package/src/data/schema/generated/format.ts +5 -0
  411. package/src/data/schema/generated/type-constructor.ts +10 -0
  412. package/src/data/schema/generated/type.ts +6 -0
  413. package/src/data/schema/index.ts +6 -0
  414. package/src/data/schema/json-schema.ts +33 -0
  415. package/src/data/schema/namespace.ts +55 -0
  416. package/src/data/schema/parse.ts +39 -0
  417. package/src/data/schema/types.ts +39 -0
  418. package/src/data/temporal/append-only.ts +134 -0
  419. package/src/data/temporal/close.ts +27 -0
  420. package/src/data/temporal/columns.ts +10 -0
  421. package/src/data/temporal/definition-queries.ts +70 -0
  422. package/src/data/temporal/errors.ts +10 -0
  423. package/src/data/temporal/get-current.ts +22 -0
  424. package/src/data/temporal/index.ts +9 -0
  425. package/src/data/temporal/namespace.ts +36 -0
  426. package/src/data/temporal/query.ts +25 -0
  427. package/src/data/temporal/resolve.ts +17 -0
  428. package/src/data/temporal/revise.ts +67 -0
  429. package/src/data/temporal/types.ts +22 -0
  430. package/src/data/valve/artifact.ts +33 -0
  431. package/src/data/valve/contract-diff.ts +21 -0
  432. package/src/data/valve/cross.ts +57 -0
  433. package/src/data/valve/crossing-ledger.ts +50 -0
  434. package/src/data/valve/decision.ts +44 -0
  435. package/src/data/valve/durable-crossing.ts +52 -0
  436. package/src/data/valve/execute-crossing.ts +77 -0
  437. package/src/data/valve/faucet.ts +56 -0
  438. package/src/data/valve/gate.ts +114 -0
  439. package/src/data/valve/graph.ts +77 -0
  440. package/src/data/valve/index.ts +53 -0
  441. package/src/data/valve/namespace.ts +57 -0
  442. package/src/data/valve/registry.ts +50 -0
  443. package/src/data/valve/schema/valve-crossing-fields.ts +23 -0
  444. package/src/data/valve/schema/valve-crossing.ts +9 -0
  445. package/src/data/valve/supply.ts +154 -0
  446. package/src/data/valve/types.ts +143 -0
  447. package/src/data/vector/columns.ts +27 -0
  448. package/src/data/vector/index.ts +4 -0
  449. package/src/data/vector/namespace.ts +33 -0
  450. package/src/data/vector/query.ts +85 -0
  451. package/src/data/vector/validate.ts +16 -0
  452. package/src/data/write/audit/actor.ts +15 -0
  453. package/src/data/write/audit/audit-columns.ts +18 -0
  454. package/src/data/write/audit/audit-select.ts +111 -0
  455. package/src/data/write/audit/bound-transaction.ts +14 -0
  456. package/src/data/write/audit/cte-compile.ts +32 -0
  457. package/src/data/write/audit/decode-returning.ts +47 -0
  458. package/src/data/write/audit/final-select.ts +43 -0
  459. package/src/data/write/audit/infra-audit.ts +36 -0
  460. package/src/data/write/audit/primary-key.ts +65 -0
  461. package/src/data/write/audit/projection.ts +41 -0
  462. package/src/data/write/audit/read-touches.ts +86 -0
  463. package/src/data/write/audit/touch-match.ts +78 -0
  464. package/src/data/write/audit/verb-delete.ts +62 -0
  465. package/src/data/write/audit/verb-insert.ts +36 -0
  466. package/src/data/write/audit/verb-select.ts +47 -0
  467. package/src/data/write/audit/verb-update.ts +60 -0
  468. package/src/data/write/audit/verb-upsert.ts +104 -0
  469. package/src/data/write/conflict.ts +43 -0
  470. package/src/data/write/delete.ts +38 -0
  471. package/src/data/write/execute.ts +243 -0
  472. package/src/data/write/index.ts +11 -0
  473. package/src/data/write/insert.ts +63 -0
  474. package/src/data/write/state.ts +43 -0
  475. package/src/data/write/update.ts +54 -0
  476. package/src/data/write/upsert.ts +58 -0
  477. package/src/data/write/values.ts +19 -0
  478. package/src/index.ts +230 -0
  479. package/src/infra/access-links/code.ts +70 -0
  480. package/src/infra/access-links/handle.ts +892 -0
  481. package/src/infra/access-links/index.ts +9 -0
  482. package/src/infra/access-links/namespace.ts +30 -0
  483. package/src/infra/access-links/person-check.ts +177 -0
  484. package/src/infra/access-links/schema.ts +71 -0
  485. package/src/infra/alerts/async-sources.ts +231 -0
  486. package/src/infra/alerts/audit.ts +36 -0
  487. package/src/infra/alerts/beat.ts +123 -0
  488. package/src/infra/alerts/client-faults.ts +111 -0
  489. package/src/infra/alerts/faults.ts +156 -0
  490. package/src/infra/alerts/handle.ts +778 -0
  491. package/src/infra/alerts/http.ts +192 -0
  492. package/src/infra/alerts/index.ts +12 -0
  493. package/src/infra/alerts/infra-sources.ts +180 -0
  494. package/src/infra/alerts/namespace.ts +81 -0
  495. package/src/infra/alerts/redact.ts +21 -0
  496. package/src/infra/alerts/request-faults.ts +41 -0
  497. package/src/infra/alerts/schema.ts +124 -0
  498. package/src/infra/alerts/sinks.ts +125 -0
  499. package/src/infra/alerts/source-options.ts +26 -0
  500. package/src/infra/alerts/sources.ts +503 -0
  501. package/src/infra/alerts/subsystem-sources.ts +137 -0
  502. package/src/infra/audit/emit.ts +87 -0
  503. package/src/infra/audit/index.ts +2 -0
  504. package/src/infra/audit/namespace.ts +22 -0
  505. package/src/infra/audit/schema.sql +35 -0
  506. package/src/infra/audit/types.ts +18 -0
  507. package/src/infra/aws/credentials.ts +147 -0
  508. package/src/infra/aws/sigv4.ts +140 -0
  509. package/src/infra/cache/create.ts +58 -0
  510. package/src/infra/cache/entry.ts +81 -0
  511. package/src/infra/cache/index.ts +4 -0
  512. package/src/infra/cache/namespace.ts +10 -0
  513. package/src/infra/cache/tenant.ts +93 -0
  514. package/src/infra/cache/types.ts +24 -0
  515. package/src/infra/crawl/audit.ts +35 -0
  516. package/src/infra/crawl/errors.ts +25 -0
  517. package/src/infra/crawl/handle.ts +693 -0
  518. package/src/infra/crawl/index.ts +9 -0
  519. package/src/infra/crawl/links.ts +160 -0
  520. package/src/infra/crawl/namespace.ts +36 -0
  521. package/src/infra/crawl/robots.ts +100 -0
  522. package/src/infra/crawl/schema.ts +89 -0
  523. package/src/infra/credit-line/handle.ts +883 -0
  524. package/src/infra/credit-line/index.ts +6 -0
  525. package/src/infra/credit-line/namespace.ts +7 -0
  526. package/src/infra/credit-line/schema.ts +96 -0
  527. package/src/infra/credits/handle.ts +706 -0
  528. package/src/infra/credits/index.ts +5 -0
  529. package/src/infra/credits/namespace.ts +7 -0
  530. package/src/infra/credits/schema.ts +83 -0
  531. package/src/infra/email/audit.ts +36 -0
  532. package/src/infra/email/inbound.ts +622 -0
  533. package/src/infra/email/index.ts +11 -0
  534. package/src/infra/email/mail.ts +517 -0
  535. package/src/infra/email/mime.ts +447 -0
  536. package/src/infra/email/namespace.ts +22 -0
  537. package/src/infra/email/providers.ts +111 -0
  538. package/src/infra/email/schema.ts +96 -0
  539. package/src/infra/email/sns.ts +200 -0
  540. package/src/infra/email/unsubscribe.ts +44 -0
  541. package/src/infra/fetch/address.ts +88 -0
  542. package/src/infra/fetch/connect-retry.ts +87 -0
  543. package/src/infra/fetch/handle.ts +329 -0
  544. package/src/infra/fetch/index.ts +7 -0
  545. package/src/infra/fetch/namespace.ts +70 -0
  546. package/src/infra/idempotency/index.ts +3 -0
  547. package/src/infra/idempotency/middleware.ts +87 -0
  548. package/src/infra/idempotency/store.ts +92 -0
  549. package/src/infra/idempotency/types.ts +30 -0
  550. package/src/infra/join-requests/handle.ts +312 -0
  551. package/src/infra/join-requests/index.ts +2 -0
  552. package/src/infra/join-requests/namespace.ts +7 -0
  553. package/src/infra/join-requests/schema.ts +33 -0
  554. package/src/infra/outbox/core.ts +165 -0
  555. package/src/infra/quota/errors.ts +32 -0
  556. package/src/infra/quota/handle.ts +215 -0
  557. package/src/infra/quota/index.ts +5 -0
  558. package/src/infra/quota/namespace.ts +7 -0
  559. package/src/infra/quota/schema.ts +15 -0
  560. package/src/infra/storage/backend.ts +34 -0
  561. package/src/infra/storage/handle.ts +513 -0
  562. package/src/infra/storage/index.ts +9 -0
  563. package/src/infra/storage/local.ts +104 -0
  564. package/src/infra/storage/namespace.ts +13 -0
  565. package/src/infra/storage/s3.ts +257 -0
  566. package/src/infra/storage/schema.ts +24 -0
  567. package/src/infra/support/handle.ts +854 -0
  568. package/src/infra/support/http.ts +229 -0
  569. package/src/infra/support/index.ts +7 -0
  570. package/src/infra/support/namespace.ts +12 -0
  571. package/src/infra/support/schema.ts +96 -0
  572. package/src/infra/webhook/inbound.ts +45 -0
  573. package/src/infra/webhook/index.ts +5 -0
  574. package/src/infra/webhook/namespace.ts +24 -0
  575. package/src/infra/webhook/outbound.ts +315 -0
  576. package/src/infra/webhook/sign.ts +32 -0
  577. package/src/infra/webhook/verify.ts +82 -0
  578. package/src/invariants/assert.ts +26 -0
  579. package/src/invariants/index.ts +1 -0
  580. package/src/lint/config.ts +56 -0
  581. package/src/lint/doctrine.ts +163 -0
  582. package/src/lint/include.ts +97 -0
  583. package/src/lint/index.ts +3 -0
  584. package/src/lint/preset.ts +10 -0
  585. package/src/lint/resolver.ts +218 -0
  586. package/src/lint/rules/no-reexports.ts +46 -0
  587. package/src/request/behavior/audited.ts +85 -0
  588. package/src/request/behavior/cached.ts +62 -0
  589. package/src/request/behavior/compose.ts +28 -0
  590. package/src/request/behavior/index.ts +5 -0
  591. package/src/request/behavior/namespace.ts +16 -0
  592. package/src/request/behavior/types.ts +26 -0
  593. package/src/request/behavior/versioned.ts +54 -0
  594. package/src/request/context/create.ts +103 -0
  595. package/src/request/context/guard.ts +49 -0
  596. package/src/request/context/index.ts +4 -0
  597. package/src/request/context/run-in-transaction.ts +200 -0
  598. package/src/request/context/store.ts +28 -0
  599. package/src/request/context/types.ts +50 -0
  600. package/src/request/di/builder.ts +535 -0
  601. package/src/request/di/index.ts +8 -0
  602. package/src/request/di/resolve.ts +271 -0
  603. package/src/request/di/types.ts +262 -0
  604. package/src/request/fitting/namespace.ts +7 -0
  605. package/src/request/fixture/batch.ts +71 -0
  606. package/src/request/fixture/builder.ts +26 -0
  607. package/src/request/fixture/errors.ts +10 -0
  608. package/src/request/fixture/index.ts +8 -0
  609. package/src/request/fixture/namespace.ts +23 -0
  610. package/src/request/fixture/paginate.ts +44 -0
  611. package/src/request/fixture/to-handlers.ts +260 -0
  612. package/src/request/fixture/types.ts +79 -0
  613. package/src/request/flow/act-as.ts +78 -0
  614. package/src/request/flow/namespace.ts +17 -0
  615. package/src/request/http/error-step.ts +42 -0
  616. package/src/request/http/file.ts +141 -0
  617. package/src/request/http/index.ts +4 -0
  618. package/src/request/http/middleware.ts +141 -0
  619. package/src/request/http/namespace.ts +5 -0
  620. package/src/request/http/rate-limit-classes.ts +170 -0
  621. package/src/request/http/response.ts +82 -0
  622. package/src/request/http/server.ts +916 -0
  623. package/src/request/http/sniff.ts +261 -0
  624. package/src/request/http/types.ts +250 -0
  625. package/src/request/http/upload.ts +284 -0
  626. package/src/request/internal/text.ts +6 -0
  627. package/src/request/openapi/generate.ts +205 -0
  628. package/src/request/openapi/index.ts +2 -0
  629. package/src/request/openapi/namespace.ts +7 -0
  630. package/src/test/auth.ts +13 -0
  631. package/src/test/auto-setup.ts +45 -0
  632. package/src/test/context.ts +91 -0
  633. package/src/test/crawl-fixture.ts +157 -0
  634. package/src/test/discover-fork.ts +17 -0
  635. package/src/test/fingerprint.ts +135 -0
  636. package/src/test/globals.d.ts +7 -0
  637. package/src/test/index.ts +19 -0
  638. package/src/test/namespace.ts +87 -0
  639. package/src/test/plugin.ts +189 -0
  640. package/src/test/progress.ts +185 -0
  641. package/src/test/reap-after-run.ts +28 -0
  642. package/src/test/reap.ts +286 -0
  643. package/src/test/reset.ts +253 -0
  644. package/src/test/savepoints.ts +172 -0
  645. package/src/test/setup.ts +1422 -0
  646. package/src/test/system-channel.ts +50 -0
  647. package/src/test/vitest-plugin.ts +142 -0
  648. package/src/test/vitest-workspace.ts +507 -0
  649. package/src/test/vitest.ts +333 -0
  650. package/src/test/watch.ts +105 -0
  651. package/src/trace/capture/bounded-serializer.ts +146 -0
  652. package/src/trace/cardinality/analyze.ts +173 -0
  653. package/src/trace/cardinality/branch-context.ts +214 -0
  654. package/src/trace/cardinality/check.ts +33 -0
  655. package/src/trace/cardinality/classify-edge.ts +64 -0
  656. package/src/trace/cardinality/structural-max.ts +107 -0
  657. package/src/trace/check/coverage-check.ts +188 -0
  658. package/src/trace/check/flow-check.ts +103 -0
  659. package/src/trace/check/flow-step-site.ts +234 -0
  660. package/src/trace/check/io-pattern.ts +116 -0
  661. package/src/trace/codemod/add-cardinality.ts +152 -0
  662. package/src/trace/codemod/run.ts +80 -0
  663. package/src/trace/entry/child-trace.ts +21 -0
  664. package/src/trace/entry/close-trace.ts +87 -0
  665. package/src/trace/entry/finalize-trace.ts +28 -0
  666. package/src/trace/entry/open-trace.ts +138 -0
  667. package/src/trace/entry/parent-trace.ts +20 -0
  668. package/src/trace/entry/parse-traceparent.ts +39 -0
  669. package/src/trace/entry/process-start.ts +38 -0
  670. package/src/trace/entry/trace-context.ts +26 -0
  671. package/src/trace/entry/tracing-enabled.ts +10 -0
  672. package/src/trace/external/record.ts +195 -0
  673. package/src/trace/external/report.ts +66 -0
  674. package/src/trace/namespace.ts +19 -0
  675. package/src/trace/partition/day.ts +47 -0
  676. package/src/trace/partition/index.ts +14 -0
  677. package/src/trace/partition/partition-name.ts +23 -0
  678. package/src/trace/partition/plan.ts +82 -0
  679. package/src/trace/partition/schedule.ts +26 -0
  680. package/src/trace/partition/startup-hook.ts +39 -0
  681. package/src/trace/partition/sync.ts +154 -0
  682. package/src/trace/partition/tables.ts +53 -0
  683. package/src/trace/read/tree.ts +83 -0
  684. package/src/trace/retain/copy-on-error.ts +76 -0
  685. package/src/trace/runtime/expire-stale-traces.ts +54 -0
  686. package/src/trace/runtime/flow-step.ts +147 -0
  687. package/src/trace/runtime/flush-steps.ts +31 -0
  688. package/src/trace/runtime/pending-writes.ts +54 -0
  689. package/src/trace/runtime/step-buffer.ts +298 -0
  690. package/src/trace/runtime/step-error.ts +21 -0
  691. package/src/trace/runtime/step-meta.ts +55 -0
  692. package/src/trace/runtime/thenable.ts +12 -0
  693. package/src/trace/runtime/truncate-trace.ts +62 -0
  694. package/src/trace/schema/trace-fields.ts +52 -0
  695. package/src/trace/schema/trace-retained.ts +22 -0
  696. package/src/trace/schema/trace-step-fields.ts +44 -0
  697. package/src/trace/schema/trace-step-retained.ts +25 -0
  698. package/src/trace/schema/trace-step.ts +18 -0
  699. package/src/trace/schema/trace.ts +12 -0
  700. package/src/trace/transformer/apply.ts +79 -0
  701. package/src/trace/transformer/build-meta-literal.ts +30 -0
  702. package/src/trace/transformer/find-flow-step-sites.ts +85 -0
  703. package/src/trace/transformer/inject-flow-step-import.ts +39 -0
  704. package/src/trace/transformer/transform-error.ts +14 -0
  705. package/src/trace/transformer/transform-flow-steps.ts +123 -0
  706. package/src/trace/transformer/wrap-function-declaration.ts +62 -0
  707. package/src/trace/transformer/wrap-variable-declaration.ts +67 -0
  708. package/src/workspace/affected.ts +110 -0
  709. package/src/workspace/changed-files.ts +163 -0
  710. package/src/workspace/check-deps.ts +213 -0
  711. package/src/workspace/checksum.ts +20 -0
  712. package/src/workspace/dependency-graph.ts +67 -0
  713. package/src/workspace/detect-pipework-copies.ts +93 -0
  714. package/src/workspace/discover.ts +206 -0
  715. package/src/workspace/generate.ts +401 -0
  716. package/src/workspace/index.ts +7 -0
  717. package/src/workspace/module-imports-pipework.ts +39 -0
  718. package/src/workspace/module-package-name.ts +12 -0
  719. package/src/workspace/scrub-git-env.ts +23 -0
  720. package/src/workspace/source-paths.ts +36 -0
  721. package/src/workspace/sync.ts +182 -0
  722. package/dist/REFERENCE.md +0 -1477
  723. package/dist/infra/access-links/rate-limit.d.ts +0 -10
  724. package/dist/infra/access-links/rate-limit.d.ts.map +0 -1
  725. package/dist/infra/access-links/rate-limit.js +0 -28
  726. package/dist/infra/access-links/rate-limit.js.map +0 -1
  727. package/dist/infra/email/sigv4.d.ts +0 -24
  728. package/dist/infra/email/sigv4.d.ts.map +0 -1
  729. package/dist/infra/email/sigv4.js +0 -55
  730. package/dist/infra/email/sigv4.js.map +0 -1
@@ -0,0 +1,193 @@
1
+ import { randomUUID } from 'node:crypto'
2
+ import type { DB } from '../db/types.js'
3
+ import type { DefinedTable, FactoryBuilder, FactoryOptions, FieldMeta } from './types.js'
4
+ import { resolveDefinitionRef } from './types.js'
5
+ import { getContext } from '../../request/context/store.js'
6
+
7
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accepts any DefinedTable regardless of field generics
8
+ export function projectFactory(definition: DefinedTable<any>): FactoryBuilder {
9
+ return {
10
+ async create(overrides, options) {
11
+ const values = await buildValues(definition, overrides ?? {}, options)
12
+
13
+ if (definition.$options.virtual === true) {
14
+ return values
15
+ }
16
+
17
+ const db = resolveDb(definition, options)
18
+ const table = definition.table()
19
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle insert requires runtime table type
20
+ const [row] = await (db as any).insert(table).values(values).returning()
21
+ return row as Record<string, unknown>
22
+ },
23
+
24
+ async createMany(count, overrides, options) {
25
+ const rows: Record<string, unknown>[] = []
26
+ for (let i = 0; i < count; i++) {
27
+ const ov = typeof overrides === 'function' ? overrides(i) : (overrides ?? {})
28
+ rows.push(await this.create(ov, options))
29
+ }
30
+ return rows
31
+ },
32
+ }
33
+ }
34
+
35
+ function resolveDb(definition: DefinedTable, options?: FactoryOptions): DB {
36
+ if (options?.db !== undefined) {
37
+ return options.db as DB
38
+ }
39
+
40
+ const ctx = getContext()
41
+ if (ctx === undefined) {
42
+ throw new Error(
43
+ `[pipework] .factory().create() requires an active context or explicit { db } option.\n\n` +
44
+ ' In a test body: ensure you have test isolation set up (pipework wraps each test in a flow context).\n' +
45
+ ' In beforeAll: pass { db: useSetupDb() } as the options argument.\n',
46
+ )
47
+ }
48
+
49
+ const dbName = definition.$options.database ?? ctx.instance.config.defaultDatabaseName()
50
+ const dbConfig = ctx.instance.config.database(dbName)
51
+
52
+ const bound = ctx.transactions.get(dbName)
53
+ if (bound !== undefined) {
54
+ return bound.drizzle
55
+ }
56
+
57
+ return ctx.instance.pool.getOrCreate(dbConfig).drizzle
58
+ }
59
+
60
+ async function buildValues(
61
+ definition: DefinedTable,
62
+ overrides: Partial<Record<string, unknown>>,
63
+ options?: FactoryOptions,
64
+ ): Promise<Record<string, unknown>> {
65
+ const values: Record<string, unknown> = {}
66
+
67
+ for (const [key, descriptor] of Object.entries(definition.$fields)) {
68
+ const meta = descriptor._meta
69
+
70
+ if (meta.generated !== undefined) {
71
+ if (key in overrides) {
72
+ throw new Error(
73
+ `[pipework] factory override for "${key}" on "${definition.$name}": the field is a generated column, which Postgres computes.\n\n` +
74
+ ` Fix: drop "${key}" from the overrides and set the fields its expression reads.\n`,
75
+ )
76
+ }
77
+ continue
78
+ }
79
+
80
+ if (key in overrides) {
81
+ values[key] = overrides[key]
82
+ continue
83
+ }
84
+
85
+ if (meta.primaryKey && meta.defaultRandom) continue
86
+ if (meta.hasDefault) continue
87
+ if (meta.nullable) continue
88
+
89
+ if (meta.tenant) {
90
+ values[key] = resolveTenantId(options)
91
+ continue
92
+ }
93
+
94
+ if (meta.reference !== undefined) {
95
+ const parentDef = resolveDefinitionRef(meta.reference.definition)
96
+ const parent = await parentDef.factory().create(undefined, options)
97
+ values[key] = parent[meta.reference.field]
98
+ continue
99
+ }
100
+
101
+ values[key] = generateDefault(key, meta)
102
+ }
103
+
104
+ return values
105
+ }
106
+
107
+ function resolveTenantId(options?: FactoryOptions): string {
108
+ if (options?.tenantId !== undefined) return options.tenantId
109
+
110
+ const ctx = getContext()
111
+ if (ctx?.tenant !== undefined && ctx.tenant !== null) return ctx.tenant
112
+
113
+ return randomUUID()
114
+ }
115
+
116
+ let _counter = 0
117
+
118
+ export function resetFactoryCounter(): void {
119
+ _counter = 0
120
+ }
121
+
122
+ function generateDefault(key: string, meta: FieldMeta): unknown {
123
+ if (meta.array) return [generateElement(key, meta)]
124
+ return generateElement(key, meta)
125
+ }
126
+
127
+ function generateElement(key: string, meta: FieldMeta): unknown {
128
+ switch (meta.kind) {
129
+ case 'uuid':
130
+ return randomUUID()
131
+
132
+ case 'text': {
133
+ const suffix = String(++_counter)
134
+ if (meta.email) return `${key}_${suffix}@test.example`
135
+ if (meta.url) return `https://test.example/${key}/${suffix}`
136
+ let text = `${key}_${suffix}`
137
+ if (meta.min !== undefined && text.length < meta.min) {
138
+ text = text.padEnd(meta.min, 'x')
139
+ }
140
+ if (meta.max !== undefined && text.length > meta.max) {
141
+ text = text.substring(0, meta.max)
142
+ }
143
+ return text
144
+ }
145
+
146
+ case 'integer':
147
+ case 'serial': {
148
+ if (meta.min !== undefined) return meta.min
149
+ if (meta.max !== undefined) return Math.min(0, meta.max)
150
+ return 0
151
+ }
152
+
153
+ case 'bigint': {
154
+ if (meta.serializedAs === 'string') return String(meta.min ?? 0)
155
+ return BigInt(meta.min ?? 0)
156
+ }
157
+
158
+ case 'boolean':
159
+ return false
160
+
161
+ case 'timestamp':
162
+ return new Date().toISOString()
163
+
164
+ case 'date':
165
+ return new Date().toISOString().slice(0, 10)
166
+
167
+ case 'enum': {
168
+ if (meta.enumValues === undefined || meta.enumValues.length === 0) {
169
+ throw new Error(`[pipework] Cannot generate default for enum field "${key}" — no values defined`)
170
+ }
171
+ return meta.enumValues[0]
172
+ }
173
+
174
+ case 'jsonb':
175
+ return {}
176
+
177
+ case 'decimal':
178
+ return '0'
179
+
180
+ case 'pgLsn':
181
+ return `0/${(++_counter).toString(16).toUpperCase()}`
182
+
183
+ case 'custom':
184
+ throw new Error(
185
+ `[pipework] Cannot generate default for custom field "${key}".\n\n` +
186
+ ' Custom fields require an explicit override or .default() value.\n' +
187
+ ` Pass { ${key}: <value> } to .factory().create().\n`,
188
+ )
189
+
190
+ default:
191
+ throw new Error(`[pipework] Unknown field kind: ${meta.kind as string}`)
192
+ }
193
+ }
@@ -0,0 +1,161 @@
1
+ import { z } from 'zod/v4'
2
+ import type { FieldDescriptor, FieldMeta, FieldRecord } from './types.js'
3
+ import type { InsertProjection, SelectProjection, UpdateProjection } from './projections.js'
4
+
5
+ export function projectInsertShape<TFields extends FieldRecord>(fields: TFields): z.ZodType<InsertProjection<TFields>>
6
+ export function projectInsertShape(fields: Record<string, FieldDescriptor>): z.ZodType
7
+ export function projectInsertShape(fields: Record<string, FieldDescriptor>): z.ZodType {
8
+ const shape: Record<string, z.ZodType> = {}
9
+
10
+ for (const [key, descriptor] of Object.entries(fields)) {
11
+ const meta = descriptor._meta
12
+
13
+ if (meta.primaryKey && (meta.defaultRandom || meta.kind === 'serial')) continue
14
+ if (meta.autoManaged) continue
15
+ if (meta.generated !== undefined) continue
16
+
17
+ let validator = buildValidator(meta)
18
+
19
+ if (meta.nullable) {
20
+ validator = validator.nullable()
21
+ }
22
+ if (meta.nullable || meta.hasDefault) {
23
+ validator = validator.optional()
24
+ }
25
+
26
+ shape[key] = validator
27
+ }
28
+
29
+ return z.object(shape)
30
+ }
31
+
32
+ export function projectSelectShape<TFields extends FieldRecord>(fields: TFields): z.ZodType<SelectProjection<TFields>>
33
+ export function projectSelectShape(fields: Record<string, FieldDescriptor>): z.ZodType
34
+ export function projectSelectShape(fields: Record<string, FieldDescriptor>): z.ZodType {
35
+ const shape: Record<string, z.ZodType> = {}
36
+
37
+ for (const [key, descriptor] of Object.entries(fields)) {
38
+ const meta = descriptor._meta
39
+ let validator = buildValidator(meta)
40
+
41
+ if (meta.nullable) {
42
+ validator = validator.nullable()
43
+ }
44
+
45
+ shape[key] = validator
46
+ }
47
+
48
+ return z.object(shape)
49
+ }
50
+
51
+ export function projectUpdateShape<TFields extends FieldRecord>(fields: TFields): z.ZodType<UpdateProjection<TFields>>
52
+ export function projectUpdateShape(fields: Record<string, FieldDescriptor>): z.ZodType
53
+ export function projectUpdateShape(fields: Record<string, FieldDescriptor>): z.ZodType {
54
+ const shape: Record<string, z.ZodType> = {}
55
+
56
+ for (const [key, descriptor] of Object.entries(fields)) {
57
+ const meta = descriptor._meta
58
+
59
+ if (meta.primaryKey) continue
60
+ if (meta.readOnly) continue
61
+ if (meta.autoManaged) continue
62
+ if (meta.generated !== undefined) continue
63
+
64
+ let validator = buildValidator(meta)
65
+
66
+ if (meta.nullable) {
67
+ validator = validator.nullable()
68
+ }
69
+
70
+ shape[key] = validator.optional()
71
+ }
72
+
73
+ return z.object(shape)
74
+ }
75
+
76
+ function buildValidator(meta: FieldMeta): z.ZodType {
77
+ const element = buildElementValidator(meta)
78
+ return meta.array ? z.array(element) : element
79
+ }
80
+
81
+ function buildElementValidator(meta: FieldMeta): z.ZodType {
82
+ switch (meta.kind) {
83
+ case 'uuid': {
84
+ let v: z.ZodType = z.string().uuid()
85
+ if (meta.brand !== undefined) {
86
+ v = v.brand(meta.brand)
87
+ }
88
+ return v
89
+ }
90
+
91
+ case 'text': {
92
+ let v: z.ZodType = z.string()
93
+ if (meta.min !== undefined) v = (v as z.ZodString).min(meta.min)
94
+ if (meta.max !== undefined) v = (v as z.ZodString).max(meta.max)
95
+ if (meta.email) v = (v as z.ZodString).email()
96
+ if (meta.url) v = (v as z.ZodString).url()
97
+ if (meta.regex !== undefined) v = (v as z.ZodString).regex(meta.regex)
98
+ if (meta.brand !== undefined) v = v.brand(meta.brand)
99
+ return v
100
+ }
101
+
102
+ case 'integer':
103
+ case 'serial': {
104
+ let v: z.ZodType = z.number().int()
105
+ if (meta.min !== undefined) v = (v as z.ZodNumber).min(meta.min)
106
+ if (meta.max !== undefined) v = (v as z.ZodNumber).max(meta.max)
107
+ if (meta.brand !== undefined) v = v.brand(meta.brand)
108
+ return v
109
+ }
110
+
111
+ case 'bigint': {
112
+ if (meta.serializedAs === 'string') {
113
+ let v: z.ZodType = z.string()
114
+ if (meta.brand !== undefined) v = v.brand(meta.brand)
115
+ return v
116
+ }
117
+ let v: z.ZodType = z.bigint()
118
+ if (meta.min !== undefined) v = (v as z.ZodBigInt).min(BigInt(meta.min))
119
+ if (meta.max !== undefined) v = (v as z.ZodBigInt).max(BigInt(meta.max))
120
+ if (meta.brand !== undefined) v = v.brand(meta.brand)
121
+ return v
122
+ }
123
+
124
+ case 'boolean':
125
+ return z.boolean()
126
+
127
+ case 'timestamp':
128
+ return z.union([z.string().datetime(), z.date()])
129
+
130
+ case 'date':
131
+ return z.union([z.string(), z.date()])
132
+
133
+ case 'enum':
134
+ if (!meta.enumValues || meta.enumValues.length === 0) {
135
+ throw new Error('[pipework] enum field requires at least one value')
136
+ }
137
+ return z.enum(meta.enumValues as unknown as [string, ...string[]])
138
+
139
+ case 'jsonb':
140
+ return meta.jsonbShape ?? z.unknown()
141
+
142
+ case 'decimal': {
143
+ let v: z.ZodType = z.string()
144
+ if (meta.brand !== undefined) v = v.brand(meta.brand)
145
+ return v
146
+ }
147
+
148
+ case 'pgLsn': {
149
+ // pg_lsn text form: two hex numbers separated by a slash, e.g. '0/16B3748'.
150
+ let v: z.ZodType = z.string().regex(/^[0-9A-Fa-f]+\/[0-9A-Fa-f]+$/)
151
+ if (meta.brand !== undefined) v = v.brand(meta.brand)
152
+ return v
153
+ }
154
+
155
+ case 'custom':
156
+ return meta.customValidator ?? z.unknown()
157
+
158
+ default:
159
+ throw new Error(`[pipework] Unknown field kind: ${meta.kind as string}`)
160
+ }
161
+ }
@@ -0,0 +1,355 @@
1
+ import {
2
+ pgTable,
3
+ text, uuid, integer, serial, bigint as pgBigint, boolean,
4
+ timestamp, date, jsonb, numeric, customType,
5
+ check, primaryKey, foreignKey,
6
+ } from '../query/pg-core/index.js'
7
+ import { sql } from '../query/index.js'
8
+ import type { FieldDescriptor, FieldMeta, DefineOptions, CompositeForeignKey } from './types.js'
9
+ import { resolveDefinitionRef } from './types.js'
10
+ import { camelToSnake } from './naming.js'
11
+
12
+ export function projectTable(
13
+ tableName: string,
14
+ fields: Record<string, FieldDescriptor>,
15
+ options: DefineOptions,
16
+ ) {
17
+ if (options.virtual === true) {
18
+ throw new Error(
19
+ `[pipework] "${tableName}" is a virtual definition — no database table.\n\n` +
20
+ ' Virtual definitions have no .table() projection.\n' +
21
+ ' Remove { virtual: true } if this definition needs a database table.\n',
22
+ )
23
+ }
24
+
25
+ /* eslint-disable @typescript-eslint/no-explicit-any -- Drizzle pgTable callback requires untyped column builders */
26
+ const { columns, extraConfig } = buildColumns(fields, false, tableName)
27
+
28
+ validateKeyOptions(tableName, fields, options)
29
+
30
+ const needsCallback =
31
+ options.indexes !== undefined ||
32
+ options.primaryKey !== undefined ||
33
+ options.foreignKeys !== undefined ||
34
+ extraConfig.length > 0
35
+
36
+ if (!needsCallback) {
37
+ return pgTable(tableName, columns)
38
+ }
39
+
40
+ return pgTable(tableName, columns, (table) => {
41
+ const all: any[] = [...extraConfig]
42
+
43
+ if (options.primaryKey !== undefined) {
44
+ all.push(primaryKey({ columns: options.primaryKey.map(k => table[k]) as [any, ...any[]] }))
45
+ }
46
+
47
+ if (options.foreignKeys !== undefined) {
48
+ for (const cfk of options.foreignKeys) {
49
+ all.push(buildForeignKey(cfk, table))
50
+ }
51
+ }
52
+
53
+ if (options.indexes !== undefined) {
54
+ const indexes = options.indexes(table)
55
+ for (const [, idx] of Object.entries(indexes)) {
56
+ all.push(idx)
57
+ }
58
+ }
59
+
60
+ return all
61
+ })
62
+ /* eslint-enable @typescript-eslint/no-explicit-any */
63
+ }
64
+
65
+ /**
66
+ * Builds the column builders for a field record. With `readOnly`, only name, type
67
+ * and nullability are kept: keys, defaults, uniqueness, references and checks
68
+ * describe a table pipework owns, and a relation read from elsewhere emits none.
69
+ */
70
+ /* eslint-disable @typescript-eslint/no-explicit-any -- Drizzle column builders are deeply generic */
71
+ export function buildColumns(
72
+ fields: Record<string, FieldDescriptor>,
73
+ readOnly: boolean,
74
+ tableName = '',
75
+ ): { columns: Record<string, any>; extraConfig: any[] } {
76
+ const columns: Record<string, any> = {}
77
+ const extraConfig: any[] = []
78
+
79
+ for (const [key, descriptor] of Object.entries(fields)) {
80
+ const meta = descriptor._meta
81
+ const colName = camelToSnake(key)
82
+
83
+ let col = buildColumn(colName, meta)
84
+ if (meta.array) col = col.array()
85
+
86
+ if (!meta.nullable) {
87
+ col = col.notNull()
88
+ }
89
+
90
+ if (readOnly) {
91
+ columns[key] = col
92
+ continue
93
+ }
94
+
95
+ if (meta.collation !== undefined) {
96
+ col = col.collate(meta.collation)
97
+ }
98
+
99
+ if (meta.generated !== undefined) {
100
+ col = col.generatedAlwaysAs(meta.generated.as)
101
+ }
102
+
103
+ if (meta.primaryKey) {
104
+ col = col.primaryKey()
105
+ }
106
+
107
+ if (meta.unique) {
108
+ col = col.unique()
109
+ }
110
+
111
+ if (meta.defaultRandom && meta.kind === 'uuid') {
112
+ col = col.defaultRandom()
113
+ } else if (meta.hasDefault && meta.defaultValue === 'now' && meta.kind === 'timestamp') {
114
+ col = col.defaultNow()
115
+ } else if (meta.hasDefault && meta.defaultValue === 'currentWal' && meta.kind === 'pgLsn') {
116
+ col = col.default(sql`pg_current_wal_lsn()`)
117
+ } else if (meta.hasDefault && meta.defaultValue !== undefined) {
118
+ col = col.default(meta.defaultValue)
119
+ }
120
+
121
+ if (meta.reference !== undefined && meta.reference.enforced !== false) {
122
+ const refDef = resolveDefinitionRef(meta.reference.definition)
123
+ const refTable = refDef.table()
124
+ const refField = meta.reference.field
125
+ col = col.references(() => {
126
+ const refCol = (refTable as any)[refField]
127
+ if (refCol === undefined) {
128
+ throw new Error(
129
+ `[pipework] "${tableName}.${key}" references "${refDef.$name}.${refField}", which has no such field. ` +
130
+ `Fix: name a field key of "${refDef.$name}" (camelCase, as declared).`,
131
+ )
132
+ }
133
+ return refCol
134
+ })
135
+ }
136
+
137
+ columns[key] = col
138
+
139
+ buildChecks(colName, meta, extraConfig)
140
+ }
141
+
142
+ return { columns, extraConfig }
143
+ }
144
+ /* eslint-enable @typescript-eslint/no-explicit-any */
145
+
146
+ /* eslint-disable @typescript-eslint/no-explicit-any -- Drizzle column/builder types are deeply generic */
147
+ function buildForeignKey(cfk: CompositeForeignKey, table: Record<string, any>): any {
148
+ const refDef = resolveDefinitionRef(cfk.references.definition)
149
+ const refTable = refDef.table() as Record<string, any>
150
+ let builder = foreignKey({
151
+ columns: cfk.columns.map(k => table[k]) as [any, ...any[]],
152
+ foreignColumns: cfk.references.columns.map(k => refTable[k]) as [any, ...any[]],
153
+ })
154
+ if (typeof cfk.onDelete === 'object') {
155
+ const setNull = 'setNull' in cfk.onDelete
156
+ const list = 'setNull' in cfk.onDelete ? cfk.onDelete.setNull : cfk.onDelete.setDefault
157
+ builder = builder
158
+ .onDelete(setNull ? 'set null' : 'set default')
159
+ .onDeleteColumns(list.map(k => (table[k] as { name: string }).name))
160
+ } else if (cfk.onDelete !== undefined) {
161
+ builder = builder.onDelete(cfk.onDelete)
162
+ }
163
+ if (cfk.onUpdate !== undefined) builder = builder.onUpdate(cfk.onUpdate)
164
+ return builder
165
+ }
166
+ /* eslint-enable @typescript-eslint/no-explicit-any */
167
+
168
+ function validateKeyOptions(
169
+ tableName: string,
170
+ fields: Record<string, FieldDescriptor>,
171
+ options: DefineOptions,
172
+ ): void {
173
+ const has = (key: string): boolean => Object.prototype.hasOwnProperty.call(fields, key)
174
+
175
+ if (options.primaryKey !== undefined) {
176
+ const fieldPk = Object.keys(fields).find(k => fields[k]!._meta.primaryKey)
177
+ if (fieldPk !== undefined) {
178
+ throw new Error(
179
+ `[pipework] "${tableName}" declares both a composite primaryKey option and a field-level .primaryKey() on "${fieldPk}".\n\n` +
180
+ ' A table has exactly one primary key.\n' +
181
+ ` Use the composite primaryKey option, or drop .primaryKey() from "${fieldPk}".\n`,
182
+ )
183
+ }
184
+ for (const key of options.primaryKey) {
185
+ if (!has(key)) {
186
+ throw new Error(
187
+ `[pipework] "${tableName}" primaryKey references unknown field "${key}".\n\n` +
188
+ ` Known fields: ${Object.keys(fields).join(', ')}\n` +
189
+ ` Fix the field name in the primaryKey option.\n`,
190
+ )
191
+ }
192
+ }
193
+ }
194
+
195
+ if (options.partitionBy !== undefined) {
196
+ const col = options.partitionBy.column
197
+ if (!has(col)) {
198
+ throw new Error(
199
+ `[pipework] "${tableName}" partitionBy references unknown field "${col}".\n\n` +
200
+ ` Known fields: ${Object.keys(fields).join(', ')}\n` +
201
+ ` Fix the column name in the partitionBy option.\n`,
202
+ )
203
+ }
204
+ if (options.primaryKey === undefined || !options.primaryKey.includes(col)) {
205
+ throw new Error(
206
+ `[pipework] "${tableName}" is partitioned by "${col}", but "${col}" is not in the primary key.\n\n` +
207
+ ' Postgres requires the partition column to be part of every unique constraint, including the primary key.\n' +
208
+ ` Add "${col}" to the primaryKey option: primaryKey: [..., '${col}'].\n`,
209
+ )
210
+ }
211
+ }
212
+
213
+ if (options.foreignKeys !== undefined) {
214
+ for (const cfk of options.foreignKeys) {
215
+ for (const key of cfk.columns) {
216
+ if (!has(key)) {
217
+ throw new Error(
218
+ `[pipework] "${tableName}" foreignKey references unknown local field "${key}".\n\n` +
219
+ ` Known fields: ${Object.keys(fields).join(', ')}\n` +
220
+ ` Fix the field name in the foreignKeys option.\n`,
221
+ )
222
+ }
223
+ }
224
+ if (cfk.columns.length !== cfk.references.columns.length) {
225
+ throw new Error(
226
+ `[pipework] "${tableName}" foreignKey column count mismatch: ${String(cfk.columns.length)} local vs ${String(cfk.references.columns.length)} foreign.\n\n` +
227
+ ' A composite foreign key maps local columns positionally to foreign columns.\n' +
228
+ ' Give the same number of columns on both sides.\n',
229
+ )
230
+ }
231
+ if (typeof cfk.onDelete === 'object') {
232
+ const action = 'setNull' in cfk.onDelete ? 'setNull' : 'setDefault'
233
+ const list = 'setNull' in cfk.onDelete ? cfk.onDelete.setNull : cfk.onDelete.setDefault
234
+ const fkName = `(${cfk.columns.join(', ')})`
235
+ if (list.length === 0) {
236
+ throw new Error(
237
+ `[pipework] "${tableName}" foreignKey ${fkName} onDelete { ${action} } has an empty column list.\n\n` +
238
+ ` Name the fields to clear, from: ${cfk.columns.join(', ')}.\n` +
239
+ ` To clear every column of the key, use onDelete: '${action === 'setNull' ? 'set null' : 'set default'}'.\n`,
240
+ )
241
+ }
242
+ const seen = new Set<string>()
243
+ for (const k of list) {
244
+ if (seen.has(k)) {
245
+ throw new Error(
246
+ `[pipework] "${tableName}" foreignKey ${fkName} onDelete { ${action} } lists "${k}" twice.\n\n` +
247
+ ' Remove the duplicate from the column list.\n',
248
+ )
249
+ }
250
+ seen.add(k)
251
+ if (!cfk.columns.includes(k)) {
252
+ throw new Error(
253
+ `[pipework] "${tableName}" foreignKey ${fkName} onDelete { ${action} } lists "${k}", which is not a column of the key.\n\n` +
254
+ ` The list must be a subset of the key's columns: ${cfk.columns.join(', ')}.\n` +
255
+ ' Fix the field name in the column list.\n',
256
+ )
257
+ }
258
+ }
259
+ }
260
+ }
261
+ }
262
+ }
263
+
264
+ const pgLsnColumn = customType<{ data: string }>({
265
+ dataType() { return 'pg_lsn' },
266
+ })
267
+
268
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle column builders have deeply generic types
269
+ function buildColumn(colName: string, meta: FieldMeta): any {
270
+ switch (meta.kind) {
271
+ case 'uuid':
272
+ return uuid(colName)
273
+ case 'text':
274
+ return text(colName)
275
+ case 'integer':
276
+ return integer(colName)
277
+ case 'serial':
278
+ return serial(colName)
279
+ case 'bigint':
280
+ return pgBigint(colName, { mode: 'bigint' })
281
+ case 'boolean':
282
+ return boolean(colName)
283
+ case 'timestamp':
284
+ return timestamp(colName, { withTimezone: true })
285
+ case 'date':
286
+ return date(colName)
287
+ case 'enum':
288
+ return text(colName)
289
+ case 'jsonb':
290
+ return jsonb(colName)
291
+ case 'decimal':
292
+ if (meta.precision !== undefined) {
293
+ return numeric(colName, { precision: meta.precision.p, scale: meta.precision.s })
294
+ }
295
+ return numeric(colName)
296
+ case 'money': {
297
+ const p = meta.precision?.p ?? 18
298
+ const s = meta.precision?.s ?? 4
299
+ return numeric(colName, { precision: p, scale: s })
300
+ }
301
+ case 'pgLsn':
302
+ return pgLsnColumn(colName)
303
+ case 'custom':
304
+ return meta.customColumn
305
+ default:
306
+ throw new Error(`[pipework] Unknown field kind: ${meta.kind as string}`)
307
+ }
308
+ }
309
+
310
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle check constraint types
311
+ function buildChecks(colName: string, meta: FieldMeta, checks: any[]): void {
312
+ if (meta.kind === 'custom' || meta.array) return
313
+
314
+ const isNumeric = meta.kind === 'integer' || meta.kind === 'serial' || meta.kind === 'bigint' || meta.kind === 'decimal' || meta.kind === 'money'
315
+ const isText = meta.kind === 'text'
316
+
317
+ if (isNumeric) {
318
+ if (meta.min !== undefined && meta.max !== undefined) {
319
+ checks.push(
320
+ check(`${colName}_range`, sql`${sql.raw(colName)} >= ${sql.raw(String(meta.min))} AND ${sql.raw(colName)} <= ${sql.raw(String(meta.max))}`),
321
+ )
322
+ } else if (meta.min !== undefined) {
323
+ checks.push(
324
+ check(`${colName}_min`, sql`${sql.raw(colName)} >= ${sql.raw(String(meta.min))}`),
325
+ )
326
+ } else if (meta.max !== undefined) {
327
+ checks.push(
328
+ check(`${colName}_max`, sql`${sql.raw(colName)} <= ${sql.raw(String(meta.max))}`),
329
+ )
330
+ }
331
+ }
332
+
333
+ if (isText) {
334
+ if (meta.min !== undefined && meta.max !== undefined) {
335
+ checks.push(
336
+ check(`${colName}_length`, sql`length(${sql.raw(colName)}) >= ${sql.raw(String(meta.min))} AND length(${sql.raw(colName)}) <= ${sql.raw(String(meta.max))}`),
337
+ )
338
+ } else if (meta.min !== undefined) {
339
+ checks.push(
340
+ check(`${colName}_min_length`, sql`length(${sql.raw(colName)}) >= ${sql.raw(String(meta.min))}`),
341
+ )
342
+ } else if (meta.max !== undefined) {
343
+ checks.push(
344
+ check(`${colName}_max_length`, sql`length(${sql.raw(colName)}) <= ${sql.raw(String(meta.max))}`),
345
+ )
346
+ }
347
+ }
348
+
349
+ if (meta.kind === 'enum' && meta.enumValues !== undefined && meta.enumValues.length > 0) {
350
+ const escaped = meta.enumValues.map(v => `'${v.replace(/'/g, "''")}'`)
351
+ checks.push(
352
+ check(`${colName}_enum`, sql`${sql.raw(colName)} IN (${sql.raw(escaped.join(', '))})`),
353
+ )
354
+ }
355
+ }