@cosmicdrift/kumiko-framework 0.413.1 → 0.415.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 (479) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +69 -13
  4. package/agents/api/framework-errors.md +1 -1
  5. package/agents/api/framework-event-store.md +14 -0
  6. package/agents/api/framework-ui-types.md +158 -21
  7. package/agents/api/renderer-web.md +112 -11
  8. package/agents/api/testing-helpers.md +3 -2
  9. package/agents/api/testing-stack.md +3 -0
  10. package/agents/api/types.md +248 -24
  11. package/agents/api.md +7 -7
  12. package/agents/boot-rules.md +66 -10
  13. package/agents/examples/api-docs.md +2 -6
  14. package/agents/examples/auth-mfa.md +57 -10
  15. package/agents/examples/chat-channels.md +2 -0
  16. package/agents/examples/crypto-shredding-hr.md +63 -1
  17. package/agents/examples/currencies-global.md +1 -0
  18. package/agents/examples/env-composition.md +7 -11
  19. package/agents/examples/managed-pages.md +90 -1
  20. package/agents/examples/pwa-shell.md +210 -0
  21. package/agents/examples/rate-limiting.md +3 -3
  22. package/agents/examples/record-detail-layout.md +1643 -67
  23. package/agents/examples/workflow-engine.md +16 -12
  24. package/agents/examples.md +1 -0
  25. package/agents/features-index.md +4 -2
  26. package/agents/features.md +22 -7
  27. package/agents/widgets.md +26 -1
  28. package/dist/api/api-constants.d.ts +1 -0
  29. package/dist/api/api-constants.js +4 -0
  30. package/dist/api/auth-middleware.js +4 -3
  31. package/dist/api/auth-routes-shared.js +2 -1
  32. package/dist/api/entity-read-access.d.ts +1 -0
  33. package/dist/api/entity-read-access.js +18 -0
  34. package/dist/api/export/export-route.d.ts +6 -1
  35. package/dist/api/export/export-route.js +27 -1
  36. package/dist/api/export/export-rows.js +19 -3
  37. package/dist/api/request-context-internals.d.ts +2 -0
  38. package/dist/api/request-context-scopes.js +9 -2
  39. package/dist/api/request-context.js +1 -1
  40. package/dist/api/routes.d.ts +2 -0
  41. package/dist/api/routes.js +9 -1
  42. package/dist/api/server-event-dispatcher.js +3 -0
  43. package/dist/api/server-extra-routes.js +2 -1
  44. package/dist/api/server-feature-http-routes.d.ts +9 -0
  45. package/dist/api/server-feature-http-routes.js +109 -0
  46. package/dist/api/server-middleware.js +2 -19
  47. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  48. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  49. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  50. package/dist/api/server-rate-limit-wiring.js +37 -0
  51. package/dist/api/server-routes.d.ts +4 -12
  52. package/dist/api/server-routes.js +12 -171
  53. package/dist/api/server-schema-route.d.ts +3 -0
  54. package/dist/api/server-schema-route.js +58 -0
  55. package/dist/api/server-wiring.js +2 -37
  56. package/dist/api/server.js +3 -1
  57. package/dist/compliance/override-schema.js +5 -5
  58. package/dist/compliance/sub-processors.js +10 -1
  59. package/dist/crypto/index.d.ts +1 -1
  60. package/dist/crypto/index.js +1 -1
  61. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  62. package/dist/crypto/pii-field-encryption.js +16 -1
  63. package/dist/db/apply-entity-event.js +4 -0
  64. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  65. package/dist/db/bun-sql-connection-codes.js +7 -0
  66. package/dist/db/collect-table-metas.js +4 -1
  67. package/dist/db/config-seed.js +1 -1
  68. package/dist/db/derived-field-sql.js +15 -13
  69. package/dist/db/derived-related-sql.d.ts +2 -2
  70. package/dist/db/derived-related-sql.js +4 -2
  71. package/dist/db/dialect.d.ts +3 -0
  72. package/dist/db/dialect.js +1 -3
  73. package/dist/db/driver-row-coercion.js +2 -2
  74. package/dist/db/driver-value-preparation.js +1 -1
  75. package/dist/db/eagerload.js +15 -12
  76. package/dist/db/entity-table-meta.d.ts +2 -0
  77. package/dist/db/entity-table-meta.js +7 -0
  78. package/dist/db/event-store-executor-context.js +13 -8
  79. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  80. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  81. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  82. package/dist/db/event-store-executor-read-filter.js +28 -11
  83. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  84. package/dist/db/event-store-executor-read-search.js +6 -6
  85. package/dist/db/event-store-executor-read-sort.js +3 -3
  86. package/dist/db/event-store-executor-read-where.js +14 -5
  87. package/dist/db/event-store-executor-read.js +7 -7
  88. package/dist/db/event-store-executor-write.js +50 -95
  89. package/dist/db/executor-managed-tables.js +4 -1
  90. package/dist/db/index.d.ts +4 -2
  91. package/dist/db/index.js +4 -2
  92. package/dist/db/known-table-names.d.ts +1 -0
  93. package/dist/db/known-table-names.js +7 -5
  94. package/dist/db/list-aggregate-labels.d.ts +1 -0
  95. package/dist/db/list-aggregate-labels.js +9 -1
  96. package/dist/db/migrate-generator.js +23 -4
  97. package/dist/db/migrate-rls-diff.d.ts +1 -0
  98. package/dist/db/migrate-rls-diff.js +15 -1
  99. package/dist/db/migrate-runner.js +2 -2
  100. package/dist/db/money.d.ts +1 -1
  101. package/dist/db/money.js +1 -4
  102. package/dist/db/parent-ref-clause.d.ts +6 -2
  103. package/dist/db/parent-ref-clause.js +105 -24
  104. package/dist/db/parent-ref-global-hosts.d.ts +23 -0
  105. package/dist/db/parent-ref-global-hosts.js +85 -0
  106. package/dist/db/production-schema-command-hint.d.ts +1 -0
  107. package/dist/db/production-schema-command-hint.js +3 -0
  108. package/dist/db/queries/backfill-pii.js +55 -29
  109. package/dist/db/queries/ddl.js +13 -2
  110. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  111. package/dist/db/queries/event-store-open-streams.js +33 -0
  112. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  113. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  114. package/dist/db/queries/event-store.js +0 -1
  115. package/dist/db/queries/raw-sql.js +0 -1
  116. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  117. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  118. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  119. package/dist/db/queries/rls-boot-catalog.js +13 -9
  120. package/dist/db/queries/rls-shape.d.ts +3 -1
  121. package/dist/db/queries/rls-shape.js +31 -6
  122. package/dist/db/queries/session-advisory-lock.js +2 -1
  123. package/dist/db/queries/test-stack.js +7 -7
  124. package/dist/db/query.js +16 -11
  125. package/dist/db/rebuild-marker.js +11 -2
  126. package/dist/db/render-rls-ddl.d.ts +2 -0
  127. package/dist/db/render-rls-ddl.js +16 -11
  128. package/dist/db/replay-migration-sql.js +1 -1
  129. package/dist/db/row-level-security-boot-check.js +18 -5
  130. package/dist/db/row-level-security-connection.js +25 -12
  131. package/dist/db/row-level-security-scope.d.ts +2 -1
  132. package/dist/db/row-level-security-scope.js +9 -5
  133. package/dist/db/sql-identifier.d.ts +1 -0
  134. package/dist/db/sql-identifier.js +3 -0
  135. package/dist/db/system-tenant-read-db.d.ts +5 -0
  136. package/dist/db/system-tenant-read-db.js +28 -0
  137. package/dist/db/table-builder.d.ts +3 -1
  138. package/dist/db/table-builder.js +18 -8
  139. package/dist/db/table-info.d.ts +1 -2
  140. package/dist/db/table-introspection.d.ts +3 -0
  141. package/dist/db/table-introspection.js +6 -0
  142. package/dist/db/table-push.d.ts +1 -0
  143. package/dist/db/table-push.js +7 -1
  144. package/dist/db/tenant-db-runner.d.ts +3 -0
  145. package/dist/db/tenant-db-runner.js +19 -1
  146. package/dist/db/transaction-serialization.d.ts +1 -0
  147. package/dist/db/transaction-serialization.js +20 -3
  148. package/dist/db/where-clause.js +11 -2
  149. package/dist/db/write-ownership-failures.d.ts +25 -0
  150. package/dist/db/write-ownership-failures.js +82 -0
  151. package/dist/engine/boot-validator/boot-check.js +7 -1
  152. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  153. package/dist/engine/boot-validator/boot-phases.js +3 -2
  154. package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
  155. package/dist/engine/boot-validator/boot-rules.js +4 -0
  156. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  157. package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
  158. package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
  159. package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
  160. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  161. package/dist/engine/boot-validator/config-deps.js +0 -28
  162. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  163. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  164. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  165. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  166. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  167. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  168. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  170. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  171. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  172. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  173. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  174. package/dist/engine/boot-validator/entity-list-screens.js +35 -13
  175. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  176. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  177. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  178. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  179. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  180. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  181. package/dist/engine/boot-validator/list-row-guidance.js +143 -0
  182. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  183. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  184. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  185. package/dist/engine/boot-validator/list-sort-summary.js +160 -0
  186. package/dist/engine/boot-validator/list-table-options.js +15 -1
  187. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  188. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  189. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  190. package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
  191. package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
  192. package/dist/engine/boot-validator/named-filter-rules.js +42 -2
  193. package/dist/engine/boot-validator/ownership.js +10 -1
  194. package/dist/engine/boot-validator/parent-ref.js +87 -50
  195. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  196. package/dist/engine/boot-validator/projection-list-screens.js +32 -1
  197. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  198. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  199. package/dist/engine/boot-validator/query-output-guidance.js +40 -0
  200. package/dist/engine/boot-validator/query-refs.js +34 -1
  201. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  202. package/dist/engine/boot-validator/row-decoration.js +16 -0
  203. package/dist/engine/boot-validator/screens-actions.js +1 -1
  204. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  205. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  206. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  207. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  208. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  209. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  210. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  211. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  212. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  213. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  214. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  215. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  216. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  217. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  218. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  219. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  220. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  221. package/dist/engine/boot-validator/screens-lists.js +19 -3
  222. package/dist/engine/boot-validator/screens.js +1 -1
  223. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  224. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  225. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  226. package/dist/engine/boot-validator/zod-shape.js +19 -1
  227. package/dist/engine/build-app-schema.js +4 -0
  228. package/dist/engine/config-helpers.d.ts +1 -2
  229. package/dist/engine/config-helpers.js +6 -7
  230. package/dist/engine/define-feature.js +1 -0
  231. package/dist/engine/define-handler.d.ts +1 -0
  232. package/dist/engine/define-handler.js +4 -2
  233. package/dist/engine/definition-violations.js +2 -2
  234. package/dist/engine/entity-handlers.js +3 -8
  235. package/dist/engine/entity-list-runtime-options.js +9 -8
  236. package/dist/engine/factories.d.ts +2 -0
  237. package/dist/engine/feature-config-events-jobs.js +1 -0
  238. package/dist/engine/feature-entity-handlers.js +5 -2
  239. package/dist/engine/field-access.d.ts +1 -1
  240. package/dist/engine/field-access.js +7 -10
  241. package/dist/engine/find-entity.js +3 -3
  242. package/dist/engine/form-derivations.js +3 -3
  243. package/dist/engine/index.d.ts +3 -3
  244. package/dist/engine/index.js +2 -2
  245. package/dist/engine/named-filter-roles.d.ts +3 -0
  246. package/dist/engine/named-filter-roles.js +15 -0
  247. package/dist/engine/pipeline.js +0 -1
  248. package/dist/engine/project-app-schema-for-roles.js +17 -2
  249. package/dist/engine/qualified-name.js +0 -1
  250. package/dist/engine/registry-facade.js +1 -2
  251. package/dist/engine/registry-state.d.ts +1 -1
  252. package/dist/engine/registry-state.js +5 -2
  253. package/dist/engine/registry-validate.js +2 -1
  254. package/dist/engine/resolve-named-list-filters.js +5 -2
  255. package/dist/engine/schema-builder.js +9 -11
  256. package/dist/engine/screen-helpers.d.ts +12 -0
  257. package/dist/engine/screen-helpers.js +17 -1
  258. package/dist/engine/soft-delete-cleanup.js +3 -5
  259. package/dist/engine/state-machine.js +0 -1
  260. package/dist/engine/steps/_database-clock.d.ts +2 -0
  261. package/dist/engine/steps/_database-clock.js +6 -0
  262. package/dist/engine/steps/compute.js +1 -1
  263. package/dist/engine/steps/retry.js +5 -1
  264. package/dist/engine/steps/return.js +0 -1
  265. package/dist/engine/steps/wait-for-event.js +2 -1
  266. package/dist/engine/steps/wait.js +2 -1
  267. package/dist/engine/system-user.d.ts +2 -2
  268. package/dist/engine/system-user.js +2 -2
  269. package/dist/engine/types/handlers.d.ts +1 -1
  270. package/dist/engine/types/handlers.js +1 -1
  271. package/dist/engine/types/screen.d.ts +1 -1
  272. package/dist/engine/types/screen.js +1 -1
  273. package/dist/engine/webhook-contracts.d.ts +2 -3
  274. package/dist/engine/webhook-contracts.js +2 -25
  275. package/dist/engine/webhook-events.js +48 -29
  276. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  277. package/dist/engine/webhook-payload-strictness.js +53 -0
  278. package/dist/env/_zod-introspect.d.ts +1 -0
  279. package/dist/env/dry-run.d.ts +1 -1
  280. package/dist/env/dry-run.js +1 -1
  281. package/dist/env/field-meta.d.ts +4 -0
  282. package/dist/env/field-meta.js +67 -0
  283. package/dist/env/field-rules.d.ts +9 -0
  284. package/dist/env/field-rules.js +46 -0
  285. package/dist/env/index.d.ts +3 -3
  286. package/dist/env/index.js +16 -71
  287. package/dist/env/internals.d.ts +3 -0
  288. package/dist/env/internals.js +1 -2
  289. package/dist/env/required-env.d.ts +3 -1
  290. package/dist/env/required-env.js +5 -2
  291. package/dist/errors/reasons.d.ts +1 -0
  292. package/dist/errors/reasons.js +4 -0
  293. package/dist/errors/serialize.js +2 -2
  294. package/dist/errors/write-error-info.js +0 -2
  295. package/dist/es-ops/operations-schema.js +18 -7
  296. package/dist/event-store/admin-api.js +3 -3
  297. package/dist/event-store/event-store.js +0 -3
  298. package/dist/event-store/index.d.ts +1 -0
  299. package/dist/event-store/index.js +1 -0
  300. package/dist/event-store/transfer.js +1 -1
  301. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  302. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  303. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  304. package/dist/files/bind-pending-file-refs.js +54 -27
  305. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  306. package/dist/files/create-file-ref.d.ts +4 -1
  307. package/dist/files/create-file-ref.js +14 -3
  308. package/dist/files/default-file-guard.js +4 -1
  309. package/dist/files/file-claim.d.ts +6 -0
  310. package/dist/files/file-claim.js +17 -0
  311. package/dist/files/file-field-slots.d.ts +2 -0
  312. package/dist/files/file-field-slots.js +28 -0
  313. package/dist/files/file-ref-entity.d.ts +3 -0
  314. package/dist/files/file-ref-entity.js +2 -0
  315. package/dist/files/file-ref-table.d.ts +3 -0
  316. package/dist/files/file-routes.d.ts +4 -1
  317. package/dist/files/file-routes.js +80 -16
  318. package/dist/files/in-memory-provider.d.ts +1 -1
  319. package/dist/files/in-memory-provider.js +2 -1
  320. package/dist/files/index.d.ts +1 -1
  321. package/dist/files/index.js +1 -1
  322. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  323. package/dist/files/invalid-file-ref-error.js +15 -0
  324. package/dist/files/local-provider.js +9 -2
  325. package/dist/files/provider-resolver.js +1 -1
  326. package/dist/files/rebind-file-ref.d.ts +3 -2
  327. package/dist/files/rebind-file-ref.js +24 -18
  328. package/dist/files/resolve-file-handles.d.ts +13 -0
  329. package/dist/files/resolve-file-handles.js +57 -0
  330. package/dist/files/storage-tracking.d.ts +1 -1
  331. package/dist/files/storage-tracking.js +5 -2
  332. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  333. package/dist/files/types.d.ts +4 -0
  334. package/dist/files/types.js +10 -0
  335. package/dist/files/upload-field-resolution.d.ts +1 -0
  336. package/dist/files/upload-field-resolution.js +16 -2
  337. package/dist/files/upload-ledger.js +1 -1
  338. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  339. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  340. package/dist/i18n/required-surface-keys.js +21 -5
  341. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  342. package/dist/internal/boot-rule-table-expectations.js +29 -0
  343. package/dist/internal/row-level-security.d.ts +1 -0
  344. package/dist/internal/row-level-security.js +1 -0
  345. package/dist/internal/testing.d.ts +1 -0
  346. package/dist/internal/testing.js +1 -0
  347. package/dist/jobs/index.d.ts +1 -0
  348. package/dist/jobs/index.js +1 -0
  349. package/dist/jobs/job-load-events.d.ts +10 -0
  350. package/dist/jobs/job-load-events.js +12 -0
  351. package/dist/jobs/job-runner-context.js +6 -158
  352. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  353. package/dist/jobs/job-runner-dispatch.js +57 -0
  354. package/dist/jobs/job-runner-event-triggers.js +18 -9
  355. package/dist/jobs/job-runner-execution.js +5 -2
  356. package/dist/jobs/job-runner-facets.d.ts +48 -0
  357. package/dist/jobs/job-runner-facets.js +156 -0
  358. package/dist/jobs/job-runner-gates.js +19 -11
  359. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  360. package/dist/jobs/job-runner-helpers.js +18 -3
  361. package/dist/jobs/job-runner-scope.d.ts +1 -0
  362. package/dist/jobs/job-runner-scope.js +2 -0
  363. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  364. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  365. package/dist/jobs/job-runner-types.d.ts +1 -0
  366. package/dist/jobs/job-runner.js +39 -70
  367. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  368. package/dist/jobs/obliterate-job-queues.js +23 -0
  369. package/dist/lifecycle/lifecycle.js +1 -1
  370. package/dist/migrations/event-header-scrub.d.ts +11 -0
  371. package/dist/migrations/event-header-scrub.js +33 -0
  372. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  373. package/dist/migrations/event-payload-scrub.js +36 -4
  374. package/dist/migrations/index.d.ts +1 -0
  375. package/dist/migrations/index.js +2 -0
  376. package/dist/migrations/kumiko-drift.d.ts +5 -2
  377. package/dist/migrations/kumiko-drift.js +51 -14
  378. package/dist/migrations/pending-rebuilds.js +4 -5
  379. package/dist/observability/sensitive-filter.js +0 -12
  380. package/dist/pipeline/aggregate-type-removal.js +17 -4
  381. package/dist/pipeline/context-services.d.ts +2 -0
  382. package/dist/pipeline/context-services.js +5 -2
  383. package/dist/pipeline/dispatch-batch.js +4 -3
  384. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  385. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  386. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  387. package/dist/pipeline/dispatch-nested-write.js +119 -0
  388. package/dist/pipeline/dispatch-query.js +10 -3
  389. package/dist/pipeline/dispatch-scope.js +4 -3
  390. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  391. package/dist/pipeline/dispatch-shared.js +6 -38
  392. package/dist/pipeline/dispatch-write.d.ts +0 -1
  393. package/dist/pipeline/dispatch-write.js +3 -302
  394. package/dist/pipeline/dispatcher-utils.js +6 -0
  395. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  396. package/dist/pipeline/effective-system-scope.js +22 -0
  397. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  398. package/dist/pipeline/event-dispatcher-delivery.js +20 -9
  399. package/dist/pipeline/event-dispatcher.d.ts +6 -1
  400. package/dist/pipeline/event-dispatcher.js +6 -7
  401. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  402. package/dist/pipeline/handler-context-auth.js +3 -4
  403. package/dist/pipeline/handler-context-db.js +11 -4
  404. package/dist/pipeline/handler-context-dispatch.js +2 -2
  405. package/dist/pipeline/handler-context-events.d.ts +8 -3
  406. package/dist/pipeline/handler-context-events.js +20 -65
  407. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  408. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  409. package/dist/pipeline/handler-context-notify.js +2 -0
  410. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  411. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  412. package/dist/pipeline/handler-context-projection.js +39 -0
  413. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  414. package/dist/pipeline/handler-context-scope.js +14 -2
  415. package/dist/pipeline/index.d.ts +1 -1
  416. package/dist/pipeline/index.js +1 -1
  417. package/dist/pipeline/irreversible-operation-gate.js +36 -10
  418. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  419. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  420. package/dist/pipeline/member-reader.js +4 -2
  421. package/dist/pipeline/msp-rebuild.js +1 -1
  422. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  423. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  424. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  425. package/dist/pipeline/projection-rebuild.js +16 -7
  426. package/dist/pipeline/projection-state.js +4 -6
  427. package/dist/pipeline/system-hooks.js +36 -6
  428. package/dist/pipeline/write-result-masking.js +31 -3
  429. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  430. package/dist/pipeline/write-transition-guard.js +95 -0
  431. package/dist/schema-cli/shared.d.ts +2 -0
  432. package/dist/schema-cli/shared.js +4 -2
  433. package/dist/schema-cli/validate-command.js +43 -28
  434. package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
  435. package/dist/search/meilisearch-adapter-internals.js +5 -0
  436. package/dist/search/meilisearch-adapter.d.ts +1 -0
  437. package/dist/search/meilisearch-adapter.js +17 -11
  438. package/dist/search/reindex-entity.d.ts +2 -0
  439. package/dist/search/reindex-entity.js +32 -4
  440. package/dist/search/reindex-tenants-search.js +20 -4
  441. package/dist/time/tz-context.js +1 -1
  442. package/dist/ui-types/card-column-roles.d.ts +6 -0
  443. package/dist/ui-types/card-column-roles.js +21 -3
  444. package/dist/ui-types/index.d.ts +3 -3
  445. package/dist/ui-types/index.js +2 -2
  446. package/dist/utils/ids.js +0 -1
  447. package/dist/utils/index.d.ts +1 -0
  448. package/dist/utils/index.js +1 -0
  449. package/dist/utils/return-path-limit.d.ts +1 -0
  450. package/dist/utils/return-path-limit.js +1 -0
  451. package/package.json +5 -3
  452. package/presets/biome-app.json +39 -21
  453. package/presets/biome-plugins/admin-api.grit +10 -0
  454. package/presets/biome-plugins/error-reasons.grit +53 -0
  455. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  456. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  457. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  458. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  459. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  460. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  461. package/presets/biome-plugins/no-date-api.grit +11 -0
  462. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  463. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  464. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  465. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  466. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  467. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  468. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  469. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  470. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  471. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  472. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  473. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  474. package/presets/biome-plugins/test-title.grit +20 -0
  475. package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
  476. package/presets/biome-rules.json +467 -0
  477. package/src/changes.json +366 -0
  478. package/dist/engine/minor-units.d.ts +0 -2
  479. package/dist/engine/minor-units.js +0 -8
@@ -19,7 +19,7 @@ defineStep({
19
19
  kind: "compute",
20
20
  defaultFailureStrategy: "throw",
21
21
  resultKey: (args) => args.name,
22
- run: (args, ctx) => args.fn(ctx), // @wrapper-known semantic-alias
22
+ run: (args, ctx) => args.fn(ctx),
23
23
  });
24
24
  export function buildComputeStep(name, fn) {
25
25
  return {
@@ -6,9 +6,11 @@
6
6
  // event and returns SUSPEND_SENTINEL to suspend. The Resume-Loop picks it up
7
7
  // after the backoff duration and re-enters the step at the same index.
8
8
  // After all attempts exhausted, the original error propagates.
9
+ import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
9
10
  import { createFallbackLogger } from "../../logging/index.js";
10
11
  import { defineStep } from "../define-step.js";
11
12
  import { runStepList } from "../run-pipeline.js";
13
+ import { databaseNowIso } from "./_database-clock.js";
12
14
  import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_RETRY_SCHEDULED_TYPE, } from "./_step-dispatch-constants.js";
13
15
  import { describeWorkflowStepError } from "./describe-workflow-step-error.js";
14
16
  import { unwrapWorkflowStepError } from "./workflow-step-error.js";
@@ -42,7 +44,9 @@ defineStep({
42
44
  error: String(unwrapWorkflowStepError(error)),
43
45
  });
44
46
  const backoffMs = calculateBackoff(attempt, args.backoff);
45
- const wakeAt = Temporal.Now.instant().add({ milliseconds: backoffMs }).toString();
47
+ const wakeAt = Temporal.Instant.from(await databaseNowIso(ctx))
48
+ .add({ milliseconds: backoffMs })
49
+ .toString();
46
50
  await ctx.events.unsafeAppend({
47
51
  aggregateId: ctx.workflow.runId,
48
52
  aggregateType: WORKFLOW_AGGREGATE_TYPE,
@@ -14,7 +14,6 @@ defineStep({
14
14
  kind: "return",
15
15
  defaultFailureStrategy: "throw",
16
16
  resultKey: () => RETURN_RESULT_KEY,
17
- // @wrapper-known semantic-alias
18
17
  run: (args, ctx) => resolveRequired(args.resolver, ctx),
19
18
  });
20
19
  export function buildReturnStep(resolver) {
@@ -21,6 +21,7 @@
21
21
  // result), so a subsequent step only ever sees the matched event's payload
22
22
  // after a resume seeds it in.
23
23
  import { defineStep } from "../define-step.js";
24
+ import { databaseNowIso } from "./_database-clock.js";
24
25
  import { addDuration } from "./_duration-utils.js";
25
26
  import { resolveOptional, resolveRequired } from "./_resolver-utils.js";
26
27
  import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_WAITING_FOR_EVENT_TYPE, } from "./_step-dispatch-constants.js";
@@ -36,7 +37,7 @@ defineStep({
36
37
  }
37
38
  const timeout = resolveRequired(args.timeout, ctx);
38
39
  const resolvedMatch = resolveOptional(args.match, ctx);
39
- const now = Temporal.Now.instant().toString();
40
+ const now = await databaseNowIso(ctx);
40
41
  const timeoutAt = timeout.startsWith("P") || timeout.startsWith("PT") ? addDuration(now, timeout) : timeout;
41
42
  await ctx.events.unsafeAppend({
42
43
  aggregateId: ctx.workflow.runId,
@@ -9,6 +9,7 @@
9
9
  // The `for` resolver accepts ISO-8601 duration strings ("PT1H", "P1D")
10
10
  // or absolute ISO timestamps ("2026-05-16T12:00:00Z").
11
11
  import { defineStep } from "../define-step.js";
12
+ import { databaseNowIso } from "./_database-clock.js";
12
13
  import { addDuration } from "./_duration-utils.js";
13
14
  import { resolveRequired } from "./_resolver-utils.js";
14
15
  import { SUSPEND_SENTINEL, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_WAITING_TYPE, } from "./_step-dispatch-constants.js";
@@ -22,7 +23,7 @@ defineStep({
22
23
  "sync handlers cannot suspend (use r.step.webhook.send with mode: 'deferred' instead).");
23
24
  }
24
25
  const duration = resolveRequired(args.for, ctx);
25
- const now = Temporal.Now.instant().toString();
26
+ const now = await databaseNowIso(ctx);
26
27
  const wakeAt = duration.startsWith("P") || duration.startsWith("PT") ? addDuration(now, duration) : duration;
27
28
  await ctx.events.unsafeAppend({
28
29
  aggregateId: ctx.workflow.runId,
@@ -1,9 +1,9 @@
1
+ import { ANONYMOUS_ROLE } from "./types/handlers.ts";
1
2
  import { SYSTEM_USER_ID, type TenantId } from "./types/identifiers.ts";
2
3
  import type { SessionUser } from "./types/index.ts";
3
- export { SYSTEM_USER_ID };
4
+ export { ANONYMOUS_ROLE, SYSTEM_USER_ID };
4
5
  export declare const SYSTEM_ROLE: "system";
5
6
  export declare function createSystemUser(tenantId: TenantId, extraRoles?: readonly string[]): SessionUser;
6
7
  export declare const ANONYMOUS_USER_ID = "anonymous";
7
- export declare const ANONYMOUS_ROLE: "anonymous";
8
8
  export declare function isAnonymousSessionUser(user: Pick<SessionUser, "roles">): boolean;
9
9
  export declare function createAnonymousUser(tenantId: TenantId): SessionUser;
@@ -1,5 +1,6 @@
1
+ import { ANONYMOUS_ROLE } from "./types/handlers.js";
1
2
  import { SYSTEM_USER_ID } from "./types/identifiers.js";
2
- export { SYSTEM_USER_ID };
3
+ export { ANONYMOUS_ROLE, SYSTEM_USER_ID };
3
4
  export const SYSTEM_ROLE = "system";
4
5
  // extraRoles: hasAccess has no system bypass — handlers gate on
5
6
  // explicit roles. Callers that must reach handlers gated e.g. on
@@ -19,7 +20,6 @@ export function createSystemUser(tenantId, extraRoles = []) {
19
20
  // like SYSTEM_ROLE: the boot-validator rejects apps that declare these as
20
21
  // custom roles.
21
22
  export const ANONYMOUS_USER_ID = "anonymous";
22
- export const ANONYMOUS_ROLE = "anonymous";
23
23
  export function isAnonymousSessionUser(user) {
24
24
  return user.roles.includes(ANONYMOUS_ROLE);
25
25
  }
@@ -1,2 +1,2 @@
1
1
  export type * from "@cosmicdrift/kumiko-types/handlers";
2
- export { isOpenToAllGranted, isUiAccessGranted } from "@cosmicdrift/kumiko-types/handlers";
2
+ export { ANONYMOUS_ROLE, isOpenToAllGranted, isUiAccessGranted, } from "@cosmicdrift/kumiko-types/handlers";
@@ -1 +1 @@
1
- export { isOpenToAllGranted, isUiAccessGranted } from "@cosmicdrift/kumiko-types/handlers";
1
+ export { ANONYMOUS_ROLE, isOpenToAllGranted, isUiAccessGranted, } from "@cosmicdrift/kumiko-types/handlers";
@@ -1,2 +1,2 @@
1
1
  export type * from "@cosmicdrift/kumiko-types/screen";
2
- export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
2
+ export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
@@ -1 +1 @@
1
- export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
1
+ export { DEFAULT_EXPORT_MAX_ROWS, LIST_BULK_ACTION_KEYS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_SUMMARY_ROW_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_BULK_SELECTION, MAX_EXPORT_MAX_ROWS, relatedListGroupHeaderLabel, relatedListGroupKey, } from "@cosmicdrift/kumiko-types/screen";
@@ -1,5 +1,6 @@
1
- import type { WebhookEventContract } from "@cosmicdrift/kumiko-types/feature";
1
+ import type { WebhookEntityVerb, WebhookEventContract } from "@cosmicdrift/kumiko-types/feature";
2
2
  import type { FeatureDefinition } from "./types/index.ts";
3
+ export declare const WEBHOOK_ENTITY_VERBS: readonly WebhookEntityVerb[];
3
4
  export type WebhookContractResolver = {
4
5
  /** Declared contract, or one derived from an entity lifecycle event (`entity.verb`). */
5
6
  get(qualifiedName: string): WebhookEventContract | undefined;
@@ -8,5 +9,3 @@ export type WebhookContractResolver = {
8
9
  };
9
10
  /** Works on the feature list so a boot check, which has no registry, resolves the same contracts. */
10
11
  export declare function createWebhookContractResolver(features: readonly FeatureDefinition[]): WebhookContractResolver;
11
- /** Receivers tell events apart by wire name, so two contracts must never share one. */
12
- export declare function assertUniqueWebhookWireNames(features: readonly FeatureDefinition[]): void;
@@ -2,7 +2,7 @@ import * as z from "zod";
2
2
  import { DEFAULT_CURRENCIES } from "./field-helpers.js";
3
3
  import { personalFieldNames } from "./personal-data-fields.js";
4
4
  import { fieldToZod } from "./schema-builder.js";
5
- const ENTITY_VERBS = ["created", "updated", "deleted"];
5
+ export const WEBHOOK_ENTITY_VERBS = ["created", "updated", "deleted"];
6
6
  const CONTRACT_VERSION = 1;
7
7
  // money and locatedTimestamp are stored as several flat columns (amount plus currency, instant
8
8
  // plus zone); the event shape of such a field is not mapped yet, so they stay out instead of
@@ -112,7 +112,7 @@ function entityVerbOf(qualifiedName) {
112
112
  const dot = qualifiedName.lastIndexOf(".");
113
113
  if (dot <= 0)
114
114
  return undefined;
115
- const verb = ENTITY_VERBS.find((candidate) => candidate === qualifiedName.slice(dot + 1));
115
+ const verb = WEBHOOK_ENTITY_VERBS.find((candidate) => candidate === qualifiedName.slice(dot + 1));
116
116
  return verb === undefined ? undefined : { entity: qualifiedName.slice(0, dot), verb };
117
117
  }
118
118
  /** Works on the feature list so a boot check, which has no registry, resolves the same contracts. */
@@ -147,26 +147,3 @@ export function createWebhookContractResolver(features) {
147
147
  },
148
148
  };
149
149
  }
150
- /** Receivers tell events apart by wire name, so two contracts must never share one. */
151
- export function assertUniqueWebhookWireNames(features) {
152
- const qnByWireName = new Map();
153
- const claim = (wireName, qn) => {
154
- const existing = qnByWireName.get(wireName);
155
- if (existing !== undefined && existing !== qn) {
156
- throw new Error(`Webhook wire name "${wireName}" is used by both "${existing}" and "${qn}"; give one of them another wireName.`);
157
- }
158
- qnByWireName.set(wireName, qn);
159
- };
160
- for (const feature of features) {
161
- for (const def of Object.values(feature.webhookEvents ?? {}))
162
- claim(def.wireName, def.qn);
163
- }
164
- for (const feature of features) {
165
- for (const [name, entity] of Object.entries(feature.entities ?? {})) {
166
- if (entity.webhookEvents !== true)
167
- continue;
168
- for (const verb of ENTITY_VERBS)
169
- claim(`${name}.${verb}`, `${name}.${verb}`);
170
- }
171
- }
172
- }
@@ -3,6 +3,7 @@ import { bootRuleError } from "./boot-validator/boot-rule.js";
3
3
  import { DEFINITION_WEBHOOK_EVENT_RULES } from "./boot-validator/definition-webhook-events-rules.js";
4
4
  import { isObjectArgument, throwObjectArgumentRequired } from "./object-form.js";
5
5
  import { isKebabSegment, toKebab } from "./qualified-name.js";
6
+ import { findOpenPayloadShape } from "./webhook-payload-strictness.js";
6
7
  /** Delivery sends the returned payload, never the input: zod strips keys the contract does not
7
8
  * declare, so a field added to the source row cannot leak into a webhook by accident. */
8
9
  export function parseWebhookPayload(contract, payload) {
@@ -22,9 +23,17 @@ export function parseWebhookPayload(contract, payload) {
22
23
  * included, even when the event payload carries them. */
23
24
  export function toEntityWebhookPayload(contract, event) {
24
25
  const { aggregateId, payload } = event;
25
- const shaped = contract.verb === "created"
26
- ? { ...payload, id: aggregateId }
27
- : { id: aggregateId, changes: payload["changes"], previous: payload["previous"] };
26
+ const shaped = (() => {
27
+ switch (contract.verb) {
28
+ case "created":
29
+ return { ...payload, id: aggregateId };
30
+ case "updated":
31
+ case "deleted":
32
+ return { id: aggregateId, changes: payload["changes"], previous: payload["previous"] };
33
+ case undefined:
34
+ throw new Error("toEntityWebhookPayload needs an entity-derived contract; a declared contract has no verb.");
35
+ }
36
+ })();
28
37
  return parseWebhookPayload(contract, shaped);
29
38
  }
30
39
  export function formatWebhookPayloadIssues(issues) {
@@ -32,6 +41,41 @@ export function formatWebhookPayloadIssues(issues) {
32
41
  .map((issue) => `${issue.path === "" ? "(root)" : issue.path}: ${issue.message}`)
33
42
  .join("; ");
34
43
  }
44
+ function assertValidWebhookEventDefinition(where, definition) {
45
+ const { name, description, payload, version } = definition;
46
+ if (typeof name !== "string" || !isKebabSegment(name)) {
47
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.nameNotKebab, {
48
+ message: `${where}: name must be kebab-case, got ${JSON.stringify(name)}`,
49
+ });
50
+ }
51
+ if (typeof description !== "string" || description.trim() === "") {
52
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.descriptionEmpty, {
53
+ message: `${where}("${name}"): description must be a non-empty sentence`,
54
+ });
55
+ }
56
+ if (!(payload instanceof ZodObject)) {
57
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadNotZodObject, {
58
+ message: `${where}("${name}"): payload must be a zod object schema`,
59
+ });
60
+ }
61
+ const openShape = findOpenPayloadShape(payload);
62
+ if (openShape !== undefined) {
63
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadOpenShape, {
64
+ message: `${where}("${name}"): payload lets undeclared keys through at ${openShape}; use closed objects (no looseObject, passthrough or catchall)`,
65
+ });
66
+ }
67
+ if (!Number.isInteger(version) || version < 1) {
68
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.versionInvalid, {
69
+ message: `${where}("${name}"): version must be a positive integer`,
70
+ });
71
+ }
72
+ if (definition.wireName !== undefined &&
73
+ (typeof definition.wireName !== "string" || definition.wireName.trim() === "")) {
74
+ throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.wireNameEmpty, {
75
+ message: `${where}("${name}"): wireName must be a non-empty string`,
76
+ });
77
+ }
78
+ }
35
79
  export function buildWebhookEventMethods(state, featureName) {
36
80
  return {
37
81
  defineWebhookEvent(definition) {
@@ -39,32 +83,7 @@ export function buildWebhookEventMethods(state, featureName) {
39
83
  throwObjectArgumentRequired(featureName, "defineWebhookEvent");
40
84
  const { name, description, payload, version } = definition;
41
85
  const where = `[Feature ${featureName}] defineWebhookEvent`;
42
- if (typeof name !== "string" || !isKebabSegment(name)) {
43
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.nameNotKebab, {
44
- message: `${where}: name must be kebab-case, got ${JSON.stringify(name)}`,
45
- });
46
- }
47
- if (typeof description !== "string" || description.trim() === "") {
48
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.descriptionEmpty, {
49
- message: `${where}("${name}"): description must be a non-empty sentence`,
50
- });
51
- }
52
- if (!(payload instanceof ZodObject)) {
53
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.payloadNotZodObject, {
54
- message: `${where}("${name}"): payload must be a zod object schema`,
55
- });
56
- }
57
- if (!Number.isInteger(version) || version < 1) {
58
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.versionInvalid, {
59
- message: `${where}("${name}"): version must be a positive integer`,
60
- });
61
- }
62
- if (definition.wireName !== undefined &&
63
- (typeof definition.wireName !== "string" || definition.wireName.trim() === "")) {
64
- throw bootRuleError(DEFINITION_WEBHOOK_EVENT_RULES.wireNameEmpty, {
65
- message: `${where}("${name}"): wireName must be a non-empty string`,
66
- });
67
- }
86
+ assertValidWebhookEventDefinition(where, definition);
68
87
  const wireName = definition.wireName?.trim() ?? name;
69
88
  const qn = `${toKebab(featureName)}:${name}`;
70
89
  if (state.webhookEvents[qn] !== undefined) {
@@ -0,0 +1,7 @@
1
+ import type { $ZodType } from "zod/v4/core";
2
+ /**
3
+ * Path of the first object that would let undeclared keys through, else undefined.
4
+ * Only open object shapes count: record/any/unknown are explicitly declared field types
5
+ * carrying one named value, so they do not smuggle unknown keys of the row into the payload.
6
+ */
7
+ export declare function findOpenPayloadShape(schema: $ZodType, path?: string, visited?: Set<$ZodType>): string | undefined;
@@ -0,0 +1,53 @@
1
+ import { propertyOf } from "@cosmicdrift/kumiko-types/type-guards";
2
+ function isLooseDef(def) {
3
+ return typeof def === "object" && def !== null && typeof propertyOf(def, "type") === "string";
4
+ }
5
+ function childSchemas(def, path) {
6
+ const candidates = [
7
+ [def.element, `${path}[]`],
8
+ [def.innerType, path],
9
+ [def.rest, `${path}[]`],
10
+ [def.in, path],
11
+ [def.out, path],
12
+ [def.valueType, `${path}[]`],
13
+ [def.left, path],
14
+ [def.right, path],
15
+ [def.getter?.(), path],
16
+ ...(def.options ?? []).map((option) => [option, path]),
17
+ ...(def.items ?? []).map((item) => [item, path]),
18
+ ];
19
+ return candidates.flatMap(([child, childPath]) => child === undefined ? [] : [[child, childPath]]);
20
+ }
21
+ function findInObject(def, path, visited) {
22
+ if (def.catchall !== undefined && def.catchall._zod.def.type !== "never") {
23
+ return path === "" ? "(root)" : path;
24
+ }
25
+ for (const [key, child] of Object.entries(def.shape ?? {})) {
26
+ const found = findOpenPayloadShape(child, path === "" ? key : `${path}.${key}`, visited);
27
+ if (found !== undefined)
28
+ return found;
29
+ }
30
+ return undefined;
31
+ }
32
+ /**
33
+ * Path of the first object that would let undeclared keys through, else undefined.
34
+ * Only open object shapes count: record/any/unknown are explicitly declared field types
35
+ * carrying one named value, so they do not smuggle unknown keys of the row into the payload.
36
+ */
37
+ export function findOpenPayloadShape(schema, path = "", visited = new Set()) {
38
+ // A lazy getter may point back at an ancestor; every schema is walked once.
39
+ if (visited.has(schema))
40
+ return undefined;
41
+ visited.add(schema);
42
+ const def = schema._zod.def;
43
+ if (!isLooseDef(def))
44
+ return undefined;
45
+ if (def.type === "object")
46
+ return findInObject(def, path, visited);
47
+ for (const [child, childPath] of childSchemas(def, path)) {
48
+ const found = findOpenPayloadShape(child, childPath, visited);
49
+ if (found !== undefined)
50
+ return found;
51
+ }
52
+ return undefined;
53
+ }
@@ -3,6 +3,7 @@ export type ZodDef = {
3
3
  readonly innerType?: z.ZodType;
4
4
  readonly in?: z.ZodType;
5
5
  readonly element?: z.ZodType;
6
+ readonly options?: readonly z.ZodType[];
6
7
  readonly defaultValue?: unknown;
7
8
  };
8
9
  /** Read Zod v4 `.meta()` value. Undefined when no meta is set. */
@@ -1,5 +1,5 @@
1
1
  import type { DryRunOptions } from "./dry-run-internals.ts";
2
- import { type ComposedEnvSchema, type EnvFieldInspection } from "./index.ts";
2
+ import type { ComposedEnvSchema, EnvFieldInspection } from "./index.ts";
3
3
  export type DryRunMode = "human" | "json" | "pulumi" | "k8s";
4
4
  /** `boot` runs the boot validators without connecting anywhere; the other
5
5
  * modes only render the env inventory. */
@@ -8,7 +8,7 @@
8
8
  // The same schema introspection (`classifyField`, `readKumikoMeta`) used
9
9
  // by parseEnv drives the output here — single source of truth.
10
10
  import { zodShape } from "./_zod-introspect.js";
11
- import { classifyField, readKumikoMeta, } from "./index.js";
11
+ import { classifyField, readKumikoMeta } from "./field-meta.js";
12
12
  import { getDefaultValue, getFieldDescription, pulumiConfigKey } from "./internals.js";
13
13
  export const DRY_RUN_ENV_VAR = "KUMIKO_DRY_RUN_ENV";
14
14
  /** Reads `KUMIKO_DRY_RUN_ENV`. `1` and `true` mean `human`; an unknown value
@@ -0,0 +1,4 @@
1
+ import * as z from "zod";
2
+ import type { EnvFieldClass, KumikoEnvMeta } from "./internals.ts";
3
+ export declare function readKumikoMeta(field: z.ZodType): KumikoEnvMeta;
4
+ export declare function classifyField(field: z.ZodType): EnvFieldClass;
@@ -0,0 +1,67 @@
1
+ import * as z from "zod";
2
+ import { zodDef, zodMeta } from "./_zod-introspect.js";
3
+ function isKumikoMeta(value) {
4
+ if (value === null || typeof value !== "object")
5
+ return false;
6
+ // @cast-boundary schema-walk — runtime-shape narrowing of zod-meta payload
7
+ const v = value;
8
+ if (v.kms !== undefined && v.kms !== true)
9
+ return false;
10
+ if (v.pulumi === undefined)
11
+ return true;
12
+ if (v.pulumi === null || typeof v.pulumi !== "object")
13
+ return false;
14
+ // @cast-boundary schema-walk
15
+ const p = v.pulumi;
16
+ if (p.name !== undefined && typeof p.name !== "string")
17
+ return false;
18
+ if (p.generator !== undefined && typeof p.generator !== "string")
19
+ return false;
20
+ if (p.secret !== undefined && typeof p.secret !== "boolean")
21
+ return false;
22
+ return true;
23
+ }
24
+ export function readKumikoMeta(field) {
25
+ const meta = zodMeta(field);
26
+ if (meta && typeof meta === "object" && meta !== null && "kumiko" in meta) {
27
+ // @cast-boundary schema-walk
28
+ const k = meta.kumiko;
29
+ if (isKumikoMeta(k))
30
+ return k;
31
+ }
32
+ return {};
33
+ }
34
+ export function classifyField(field) {
35
+ // Drill through ZodEffects/ZodPipe wrappers to find the inner kind.
36
+ let current = field;
37
+ for (let i = 0; i < 8; i++) {
38
+ if (current instanceof z.ZodDefault)
39
+ return "withDefault";
40
+ // `.required()` on an object wraps optional fields in nonoptional(); the
41
+ // wrapper makes the field required, whatever the optional beneath it says.
42
+ if (current instanceof z.ZodNonOptional) {
43
+ const beneath = zodDef(current)?.innerType;
44
+ if (beneath instanceof z.ZodOptional) {
45
+ const unwrapped = zodDef(beneath)?.innerType;
46
+ if (unwrapped === undefined)
47
+ return "required";
48
+ current = unwrapped;
49
+ continue;
50
+ }
51
+ }
52
+ if (current instanceof z.ZodOptional || current instanceof z.ZodNullable) {
53
+ return "optional";
54
+ }
55
+ const inner = zodDef(current);
56
+ if (inner?.innerType) {
57
+ current = inner.innerType;
58
+ continue;
59
+ }
60
+ if (inner?.in) {
61
+ current = inner.in;
62
+ continue;
63
+ }
64
+ break;
65
+ }
66
+ return "required";
67
+ }
@@ -0,0 +1,9 @@
1
+ import type * as z from "zod";
2
+ /** Cross-variable rule on one env field: gets the field's raw value and the whole env being
3
+ * booted (so `NODE_ENV` comes from the injected source, not `process.env`), returns a message
4
+ * when the value is unacceptable. Attach via `.meta({ kumiko: { envRule } })`. */
5
+ export type EnvFieldRule = (value: string, env: Readonly<Record<string, string | undefined>>) => string | undefined;
6
+ /** Rule message for one set field; undefined when the field has no rule or the value passes. */
7
+ export declare function envRuleViolation(field: z.ZodType, value: string, env: Readonly<Record<string, string | undefined>>): string | undefined;
8
+ /** Field name to rule message for every set field whose rule rejects it. */
9
+ export declare function envRuleViolations(schema: z.ZodObject<z.ZodRawShape>, env: Readonly<Record<string, string | undefined>>): ReadonlyMap<string, string>;
@@ -0,0 +1,46 @@
1
+ import { zodDef, zodMeta, zodShape } from "./_zod-introspect.js";
2
+ function isEnvFieldRule(value) {
3
+ return typeof value === "function";
4
+ }
5
+ function ownEnvRule(field) {
6
+ const meta = zodMeta(field);
7
+ if (typeof meta !== "object" || meta === null || !("kumiko" in meta))
8
+ return undefined;
9
+ const kumiko = meta.kumiko;
10
+ if (typeof kumiko !== "object" || kumiko === null || !("envRule" in kumiko))
11
+ return undefined;
12
+ return isEnvFieldRule(kumiko.envRule) ? kumiko.envRule : undefined;
13
+ }
14
+ // `.optional()`/`.default()` and unions wrap a fresh instance without the inner meta, so a
15
+ // reusable schema that carries the rule keeps it when an app wraps it in its own field.
16
+ function envRuleOf(field) {
17
+ const own = ownEnvRule(field);
18
+ if (own !== undefined)
19
+ return own;
20
+ const def = zodDef(field);
21
+ if (def?.innerType !== undefined)
22
+ return envRuleOf(def.innerType);
23
+ for (const option of def?.options ?? []) {
24
+ const fromOption = envRuleOf(option);
25
+ if (fromOption !== undefined)
26
+ return fromOption;
27
+ }
28
+ return undefined;
29
+ }
30
+ /** Rule message for one set field; undefined when the field has no rule or the value passes. */
31
+ export function envRuleViolation(field, value, env) {
32
+ return envRuleOf(field)?.(value, env);
33
+ }
34
+ /** Field name to rule message for every set field whose rule rejects it. */
35
+ export function envRuleViolations(schema, env) {
36
+ const violations = new Map();
37
+ for (const [name, field] of Object.entries(zodShape(schema))) {
38
+ const value = env[name];
39
+ if (value === undefined)
40
+ continue;
41
+ const message = envRuleViolation(field, value, env);
42
+ if (message !== undefined)
43
+ violations.set(name, message);
44
+ }
45
+ return violations;
46
+ }
@@ -1,12 +1,12 @@
1
1
  import * as z from "zod";
2
2
  import type { FeatureDefinition } from "../engine/types/feature.ts";
3
- import { type ComposedEnvShape, type ComposeEnvSchemaOptions, type EmptyShape, type EnvError, type EnvFieldClass, type EnvFieldStatus, type KumikoEnvMeta, type ParseEnvOptions } from "./internals.ts";
3
+ import { classifyField, readKumikoMeta } from "./field-meta.ts";
4
+ import { type ComposedEnvShape, type ComposeEnvSchemaOptions, type EmptyShape, type EnvError, type EnvFieldClass, type EnvFieldStatus, type ParseEnvOptions } from "./internals.ts";
4
5
  export { type EnvSource, requiredEnvFor } from "./required-env.ts";
5
- export declare function readKumikoMeta(field: z.ZodType): KumikoEnvMeta;
6
+ export { classifyField, readKumikoMeta };
6
7
  /** Env names whose schema field declares `kms: true` — the slots
7
8
  * `resolvePlatformKeks` resolves from a ciphertext. */
8
9
  export declare function kmsSlotsOf(schema: z.ZodObject<z.ZodRawShape>): readonly string[];
9
- export declare function classifyField(field: z.ZodType): EnvFieldClass;
10
10
  /** A feature whose registered env schema is visible in its type, so
11
11
  * `composeEnvSchema` can type the merged schema from the feature list. */
12
12
  export type FeatureWithEnvSchema<TFeature extends FeatureDefinition, TShape extends z.ZodRawShape> = TFeature & {