@cosmicdrift/kumiko-framework 0.406.0 → 0.410.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 (212) hide show
  1. package/AGENTS.md +4 -2
  2. package/agents/api/framework-db.md +1 -0
  3. package/agents/api/framework-engine.md +17 -2
  4. package/agents/api/framework-ui-types.md +15 -0
  5. package/agents/api/renderer-web.md +156 -2
  6. package/agents/api/types.md +113 -71
  7. package/agents/api.md +4 -4
  8. package/agents/boot-rules.md +744 -0
  9. package/agents/examples/anonymous-access.md +23 -1
  10. package/agents/examples/contact.md +173 -0
  11. package/agents/examples/delivery-notifications.md +34 -1
  12. package/agents/examples/record-detail-layout.md +13 -2
  13. package/agents/examples/search.md +65 -3
  14. package/agents/examples/secrets-demo.md +96 -2
  15. package/agents/examples/tenant-inactivity.md +138 -0
  16. package/agents/examples.md +2 -0
  17. package/agents/features-index.md +4 -0
  18. package/agents/features.md +25 -1
  19. package/agents/widgets.md +12 -1
  20. package/dist/api/export/export-rows.js +1 -0
  21. package/dist/compliance/index.d.ts +1 -1
  22. package/dist/db/event-store-executor-read-where.js +15 -5
  23. package/dist/db/index.d.ts +1 -1
  24. package/dist/db/index.js +1 -1
  25. package/dist/db/migrate-generator.js +3 -1
  26. package/dist/db/queries/event-consumer.js +11 -7
  27. package/dist/db/queries/event-store.d.ts +2 -1
  28. package/dist/db/queries/event-store.js +25 -6
  29. package/dist/db/queries/rls-boot-catalog.js +3 -1
  30. package/dist/db/queries/session-advisory-lock.d.ts +7 -0
  31. package/dist/db/queries/session-advisory-lock.js +23 -0
  32. package/dist/db/query.js +7 -10
  33. package/dist/db/row-level-security-connection.js +4 -2
  34. package/dist/engine/access.js +5 -1
  35. package/dist/engine/active-membership.js +1 -0
  36. package/dist/engine/boot-validator/access-declarations.js +76 -33
  37. package/dist/engine/boot-validator/action-wiring.js +8 -6
  38. package/dist/engine/boot-validator/agent-effect-rules.d.ts +12 -0
  39. package/dist/engine/boot-validator/agent-effect-rules.js +12 -0
  40. package/dist/engine/boot-validator/agent-effect.d.ts +2 -0
  41. package/dist/engine/boot-validator/agent-effect.js +20 -0
  42. package/dist/engine/boot-validator/boot-context.js +5 -1
  43. package/dist/engine/boot-validator/boot-environment-rules.d.ts +12 -0
  44. package/dist/engine/boot-validator/boot-environment-rules.js +12 -0
  45. package/dist/engine/boot-validator/boot-phases-app.js +5 -1
  46. package/dist/engine/boot-validator/boot-phases.js +3 -1
  47. package/dist/engine/boot-validator/boot-rules.d.ts +2624 -0
  48. package/dist/engine/boot-validator/boot-rules.js +58 -0
  49. package/dist/engine/boot-validator/bundled-lists-table.js +23 -9
  50. package/dist/engine/boot-validator/config-deps.js +71 -23
  51. package/dist/engine/boot-validator/config-edit-action-rules.d.ts +17 -0
  52. package/dist/engine/boot-validator/config-edit-action-rules.js +17 -0
  53. package/dist/engine/boot-validator/config-key-rules.d.ts +117 -0
  54. package/dist/engine/boot-validator/config-key-rules.js +117 -0
  55. package/dist/engine/boot-validator/custom-screen-write-qns.js +6 -2
  56. package/dist/engine/boot-validator/derived-sql-fields-rules.d.ts +77 -0
  57. package/dist/engine/boot-validator/derived-sql-fields-rules.js +77 -0
  58. package/dist/engine/boot-validator/derived-sql-fields.js +53 -17
  59. package/dist/engine/boot-validator/detail-screens.js +10 -4
  60. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +92 -0
  61. package/dist/engine/boot-validator/entity-declaration-rules.js +92 -0
  62. package/dist/engine/boot-validator/entity-handler-access-rules.d.ts +102 -0
  63. package/dist/engine/boot-validator/entity-handler-access-rules.js +102 -0
  64. package/dist/engine/boot-validator/entity-handler.d.ts +0 -7
  65. package/dist/engine/boot-validator/entity-handler.js +259 -355
  66. package/dist/engine/boot-validator/entity-image-variants.d.ts +2 -0
  67. package/dist/engine/boot-validator/entity-image-variants.js +91 -0
  68. package/dist/engine/boot-validator/entity-list-aggregate-options.js +8 -2
  69. package/dist/engine/boot-validator/entity-reference-embedded-rules.d.ts +117 -0
  70. package/dist/engine/boot-validator/entity-reference-embedded-rules.js +117 -0
  71. package/dist/engine/boot-validator/entity-select-image-rules.d.ts +122 -0
  72. package/dist/engine/boot-validator/entity-select-image-rules.js +122 -0
  73. package/dist/engine/boot-validator/entity-select.d.ts +8 -0
  74. package/dist/engine/boot-validator/entity-select.js +197 -0
  75. package/dist/engine/boot-validator/entity-structure-rules.d.ts +107 -0
  76. package/dist/engine/boot-validator/entity-structure-rules.js +107 -0
  77. package/dist/engine/boot-validator/field-conditions-rules.d.ts +92 -0
  78. package/dist/engine/boot-validator/field-conditions-rules.js +92 -0
  79. package/dist/engine/boot-validator/field-conditions.js +67 -22
  80. package/dist/engine/boot-validator/form-derivations-rules.d.ts +77 -0
  81. package/dist/engine/boot-validator/form-derivations-rules.js +77 -0
  82. package/dist/engine/boot-validator/form-derivations.js +52 -18
  83. package/dist/engine/boot-validator/global-tenancy.js +13 -7
  84. package/dist/engine/boot-validator/handler-declaration-rules.d.ts +77 -0
  85. package/dist/engine/boot-validator/handler-declaration-rules.js +77 -0
  86. package/dist/engine/boot-validator/handler-field-references-rules.d.ts +22 -0
  87. package/dist/engine/boot-validator/handler-field-references-rules.js +22 -0
  88. package/dist/engine/boot-validator/handler-field-references.js +14 -6
  89. package/dist/engine/boot-validator/list-bulk-actions-rules.d.ts +42 -0
  90. package/dist/engine/boot-validator/list-bulk-actions-rules.js +42 -0
  91. package/dist/engine/boot-validator/list-bulk-actions.js +29 -11
  92. package/dist/engine/boot-validator/list-column-layout.js +22 -10
  93. package/dist/engine/boot-validator/list-query-rules.d.ts +107 -0
  94. package/dist/engine/boot-validator/list-query-rules.js +107 -0
  95. package/dist/engine/boot-validator/list-table-aggregate-options.js +43 -15
  96. package/dist/engine/boot-validator/list-table-aggregate-query.js +7 -3
  97. package/dist/engine/boot-validator/list-table-aggregate-rules.d.ts +82 -0
  98. package/dist/engine/boot-validator/list-table-aggregate-rules.js +82 -0
  99. package/dist/engine/boot-validator/list-table-export-options.js +19 -7
  100. package/dist/engine/boot-validator/list-table-options.js +33 -13
  101. package/dist/engine/boot-validator/list-table-reject-unknown-keys.js +6 -2
  102. package/dist/engine/boot-validator/list-table-rules.d.ts +132 -0
  103. package/dist/engine/boot-validator/list-table-rules.js +132 -0
  104. package/dist/engine/boot-validator/nav-rules.d.ts +42 -0
  105. package/dist/engine/boot-validator/nav-rules.js +42 -0
  106. package/dist/engine/boot-validator/nav.js +33 -17
  107. package/dist/engine/boot-validator/ownership-rules.d.ts +27 -0
  108. package/dist/engine/boot-validator/ownership-rules.js +27 -0
  109. package/dist/engine/boot-validator/ownership.js +28 -12
  110. package/dist/engine/boot-validator/parent-ref.js +32 -20
  111. package/dist/engine/boot-validator/projection-list-screens.js +76 -35
  112. package/dist/engine/boot-validator/query-output-columns.js +9 -3
  113. package/dist/engine/boot-validator/query-refs.js +20 -10
  114. package/dist/engine/boot-validator/query-rules.d.ts +37 -0
  115. package/dist/engine/boot-validator/query-rules.js +37 -0
  116. package/dist/engine/boot-validator/read-gate.js +14 -10
  117. package/dist/engine/boot-validator/record-owned.js +5 -1
  118. package/dist/engine/boot-validator/related-list-table-rules.js +17 -7
  119. package/dist/engine/boot-validator/screens-actions-rules.d.ts +185 -0
  120. package/dist/engine/boot-validator/screens-actions-rules.js +185 -0
  121. package/dist/engine/boot-validator/screens-actions.js +169 -93
  122. package/dist/engine/boot-validator/screens-dashboard-chart-rules.d.ts +87 -0
  123. package/dist/engine/boot-validator/screens-dashboard-chart-rules.js +87 -0
  124. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +227 -0
  125. package/dist/engine/boot-validator/screens-dashboard-rules.js +227 -0
  126. package/dist/engine/boot-validator/screens-dashboard.js +222 -85
  127. package/dist/engine/boot-validator/screens-forms-layout-rules.d.ts +122 -0
  128. package/dist/engine/boot-validator/screens-forms-layout-rules.js +122 -0
  129. package/dist/engine/boot-validator/screens-forms-rules.d.ts +152 -0
  130. package/dist/engine/boot-validator/screens-forms-rules.js +152 -0
  131. package/dist/engine/boot-validator/screens-forms.js +240 -112
  132. package/dist/engine/boot-validator/screens-kind-config-edit.js +72 -16
  133. package/dist/engine/boot-validator/screens-kind-entity-edit.js +15 -7
  134. package/dist/engine/boot-validator/screens-kind-entity-list.js +57 -32
  135. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +92 -0
  136. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +92 -0
  137. package/dist/engine/boot-validator/screens-kind-projection-detail.js +85 -47
  138. package/dist/engine/boot-validator/screens-kind-rules.d.ts +137 -0
  139. package/dist/engine/boot-validator/screens-kind-rules.js +137 -0
  140. package/dist/engine/boot-validator/screens-kind-secret-mint.js +18 -8
  141. package/dist/engine/boot-validator/screens-kind-shared.js +40 -22
  142. package/dist/engine/boot-validator/screens-lists-rules.d.ts +82 -0
  143. package/dist/engine/boot-validator/screens-lists-rules.js +82 -0
  144. package/dist/engine/boot-validator/screens-lists.js +90 -45
  145. package/dist/engine/boot-validator/screens-rules.d.ts +57 -0
  146. package/dist/engine/boot-validator/screens-rules.js +57 -0
  147. package/dist/engine/boot-validator/screens.js +17 -12
  148. package/dist/engine/boot-validator/transaction-phases.js +12 -4
  149. package/dist/engine/boot-validator/transfer-graph.js +17 -11
  150. package/dist/engine/boot-validator/url-prefill-fields.js +9 -5
  151. package/dist/engine/boot-validator/workspaces.js +11 -5
  152. package/dist/engine/boot-validator/zod-shape.js +6 -2
  153. package/dist/engine/entity-handlers.d.ts +1 -0
  154. package/dist/engine/entity-handlers.js +3 -0
  155. package/dist/engine/entity-list-runtime-options.js +23 -29
  156. package/dist/engine/extensions/tenant-data.d.ts +3 -0
  157. package/dist/engine/factories.d.ts +1 -1
  158. package/dist/engine/factories.js +4 -3
  159. package/dist/engine/index.d.ts +4 -2
  160. package/dist/engine/index.js +2 -0
  161. package/dist/engine/project-app-schema-for-roles.js +29 -14
  162. package/dist/engine/registry-facade.js +7 -8
  163. package/dist/engine/registry-validate.js +5 -1
  164. package/dist/engine/soft-delete-cleanup.d.ts +1 -0
  165. package/dist/engine/soft-delete-cleanup.js +5 -0
  166. package/dist/engine/steps/describe-workflow-step-error.js +1 -0
  167. package/dist/es-ops/operations-schema.d.ts +1 -1
  168. package/dist/event-store/ensure-dead-letter-table.d.ts +2 -0
  169. package/dist/event-store/ensure-dead-letter-table.js +10 -0
  170. package/dist/event-store/rebuild-dead-letter.js +2 -8
  171. package/dist/event-store/upcaster-dead-letter.js +2 -8
  172. package/dist/files/copy-pending-file-refs-to-tenant.d.ts +28 -0
  173. package/dist/files/copy-pending-file-refs-to-tenant.js +87 -0
  174. package/dist/files/file-routes.d.ts +1 -1
  175. package/dist/files/file-routes.js +21 -6
  176. package/dist/files/index.d.ts +2 -0
  177. package/dist/files/index.js +1 -0
  178. package/dist/i18n/required-surface-keys.js +1 -0
  179. package/dist/jobs/job-runner-helpers.js +1 -0
  180. package/dist/jobs/job-runner.js +7 -12
  181. package/dist/logging/utils.js +30 -60
  182. package/dist/observability/metrics-handle.js +10 -21
  183. package/dist/pipeline/cascade-handler.js +7 -6
  184. package/dist/pipeline/dispatch-query.js +18 -5
  185. package/dist/pipeline/dispatch-shared.d.ts +1 -0
  186. package/dist/pipeline/dispatch-shared.js +3 -1
  187. package/dist/pipeline/dispatch-write.js +10 -12
  188. package/dist/pipeline/dispatcher.js +12 -14
  189. package/dist/pipeline/event-dispatcher-admin.js +9 -8
  190. package/dist/pipeline/event-dispatcher-delivery.d.ts +19 -1
  191. package/dist/pipeline/event-dispatcher-delivery.js +121 -29
  192. package/dist/pipeline/event-dispatcher.d.ts +5 -1
  193. package/dist/pipeline/event-dispatcher.js +28 -21
  194. package/dist/pipeline/handler-context-phase-denials.js +2 -0
  195. package/dist/pipeline/multi-stream-apply-context.js +12 -20
  196. package/dist/pipeline/system-hooks.d.ts +4 -1
  197. package/dist/pipeline/system-hooks.js +79 -6
  198. package/dist/pipeline/system-identity-switch.js +10 -7
  199. package/dist/search/build-search-snippet.d.ts +9 -0
  200. package/dist/search/build-search-snippet.js +40 -0
  201. package/dist/search/index.d.ts +1 -0
  202. package/dist/search/index.js +1 -0
  203. package/dist/search/meilisearch-adapter.d.ts +32 -0
  204. package/dist/search/meilisearch-adapter.js +153 -56
  205. package/dist/search/meilisearch-chunking.d.ts +21 -0
  206. package/dist/search/meilisearch-chunking.js +96 -0
  207. package/dist/search/reindex-entity.d.ts +1 -0
  208. package/dist/search/reindex-entity.js +97 -52
  209. package/dist/ui-types/index.d.ts +1 -1
  210. package/dist/upgrade-cli.js +3 -14
  211. package/package.json +3 -3
  212. package/src/changes.json +79 -0
@@ -0,0 +1,57 @@
1
+ export const SCREEN_RULES = {
2
+ customNoComponent: {
3
+ id: "screen/custom-no-component",
4
+ summary: "A custom screen renderer declares a react or native component.",
5
+ fix: "Set react or native on the renderer.",
6
+ },
7
+ unknownType: {
8
+ id: "screen/unknown-type",
9
+ summary: "A screen has a known type.",
10
+ fix: "Use a supported screen type.",
11
+ },
12
+ urlPrefillFieldsSet: {
13
+ id: "screen/url-prefill-fields-set",
14
+ summary: "Screens do not set urlPrefillFields; buildAppSchema derives it.",
15
+ fix: "Declare params on the navigating action instead.",
16
+ },
17
+ submitPrefilledUnsupported: {
18
+ id: "screen/submit-prefilled-unsupported",
19
+ summary: "Only actionForm and secretMint screens set submitPrefilled.",
20
+ fix: "Remove submitPrefilled.",
21
+ },
22
+ submitPrefilledHiddenRequired: {
23
+ id: "screen/submit-prefilled-hidden-required",
24
+ summary: "With submitPrefilled, a hidden required field is passed in by a navigate action's params.",
25
+ fix: "Add the field to the params of a navigate action targeting the screen, make it visible, or drop required.",
26
+ },
27
+ customWriteQnUnregistered: {
28
+ id: "screen/custom-write-qn-unregistered",
29
+ summary: "Every dispatcher.write QN in app source names a registered write handler.",
30
+ fix: "Check the spelling against registered write handlers (<feature>:write:<handler>).",
31
+ },
32
+ detailForDuplicate: {
33
+ id: "screen/detail-for-duplicate",
34
+ summary: "At most one screen declares detailFor for an entity.",
35
+ fix: "Keep detailFor on one screen per entity.",
36
+ },
37
+ detailForUnknownEntity: {
38
+ id: "screen/detail-for-unknown-entity",
39
+ summary: "detailFor names an entity a feature registers.",
40
+ fix: "Set detailFor to a registered entity name or remove it.",
41
+ },
42
+ actionFieldFunction: {
43
+ id: "screen/action-field-function",
44
+ summary: "Action payload, params, entityId and visible are declarative values, not functions.",
45
+ fix: "Use the declarative DSL ({ pick }, { map }, field name, { field, eq }).",
46
+ },
47
+ editFieldConditionFunction: {
48
+ id: "screen/edit-field-condition-function",
49
+ summary: "Edit field visible, readOnly and required are FieldConditions, not functions.",
50
+ fix: "Use a FieldCondition (boolean or { field, eq/ne/in/notIn }).",
51
+ },
52
+ rendererFunction: {
53
+ id: "screen/renderer-function",
54
+ summary: "Field and column renderers are FormatSpecs, not functions.",
55
+ fix: 'Use a FormatSpec ({ format: "..." }).',
56
+ },
57
+ };
@@ -1,8 +1,5 @@
1
- // Screen validation entry point. The per-kind validators live in the
2
- // screens-kind-*.ts siblings and the shared sub-validators in screens-dashboard/
3
- // forms/lists/actions; dependencies only point one way (screens.ts ->
4
- // screens-kind-*.ts -> screens-kind-shared.ts -> dashboard/forms/lists -> actions),
5
- // so there is no same-folder require cycle.
1
+ import { bootRuleError } from "./boot-rule.js";
2
+ import { SCREEN_RULES } from "./screens-rules.js";
6
3
  import { qualifyEntityName } from "../qualified-name.js";
7
4
  import { validateActionHasIcon, validateScreenVisibleWhen } from "./screens-actions.js";
8
5
  import { validateDashboardActions, validateDashboardRecordBinding, validateDashboardScreen, } from "./screens-dashboard.js";
@@ -20,8 +17,10 @@ export { validateDashboardCustomPanel, validateDashboardScreenPanel } from "./sc
20
17
  export { validateColumnRendererForm } from "./screens-lists.js";
21
18
  function validateCustomScreen(ctx, screenId, screen) {
22
19
  if (!screen.renderer.react && !screen.renderer.native) {
23
- throw new Error(`[Feature ${ctx.feature.name}] Screen "${screenId}" has type="custom" but the renderer ` +
24
- `declares neither a react nor a native component — at least one platform must be set.`);
20
+ throw bootRuleError(SCREEN_RULES.customNoComponent, {
21
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" has type="custom" but the renderer ` +
22
+ `declares neither a react nor a native component — at least one platform must be set.`,
23
+ });
25
24
  }
26
25
  }
27
26
  function validateDashboardKindScreen(ctx, screenId, screen) {
@@ -53,7 +52,9 @@ function validateScreenOfKind(ctx, screenId, kind, screen) {
53
52
  // lookup would surface as a TypeError instead of a boot error.
54
53
  function rejectUnknownScreenKind(featureName, screenId, screen) {
55
54
  if (!Object.hasOwn(SCREEN_KIND_VALIDATORS, screen.type)) {
56
- throw new Error(`[Feature ${featureName}] Screen "${screenId}" has unknown type "${String(screen.type)}".`);
55
+ throw bootRuleError(SCREEN_RULES.unknownType, {
56
+ message: `[Feature ${featureName}] Screen "${screenId}" has unknown type "${String(screen.type)}".`,
57
+ });
57
58
  }
58
59
  }
59
60
  function buildScreenValidationContext(feature, featureMap, allWriteHandlerQns, allScreenQns, configKeyDefsByQn, screensByShortId, detailForScreens) {
@@ -89,8 +90,10 @@ function rejectAuthoredUrlPrefillFields(featureName, screenId, screen) {
89
90
  screen.type === "actionForm" ||
90
91
  screen.type === "secretMint") &&
91
92
  screen.urlPrefillFields !== undefined) {
92
- throw new Error(`[Feature ${featureName}] Screen "${screenId}" (${screen.type}) sets urlPrefillFields — ` +
93
- `it is derived from navigate params by buildAppSchema; declare params on the navigating action instead.`);
93
+ throw bootRuleError(SCREEN_RULES.urlPrefillFieldsSet, {
94
+ message: `[Feature ${featureName}] Screen "${screenId}" (${screen.type}) sets urlPrefillFields — ` +
95
+ `it is derived from navigate params by buildAppSchema; declare params on the navigating action instead.`,
96
+ });
94
97
  }
95
98
  }
96
99
  function rejectSubmitPrefilledOutsideForms(featureName, screenId, screen) {
@@ -98,8 +101,10 @@ function rejectSubmitPrefilledOutsideForms(featureName, screenId, screen) {
98
101
  screen.type !== "secretMint" &&
99
102
  "submitPrefilled" in screen &&
100
103
  screen.submitPrefilled !== undefined) {
101
- throw new Error(`[Feature ${featureName}] Screen "${screenId}" (${screen.type}) sets submitPrefilled — ` +
102
- `only actionForm and secretMint screens support it. Remove it.`);
104
+ throw bootRuleError(SCREEN_RULES.submitPrefilledUnsupported, {
105
+ message: `[Feature ${featureName}] Screen "${screenId}" (${screen.type}) sets submitPrefilled — ` +
106
+ `only actionForm and secretMint screens support it. Remove it.`,
107
+ });
103
108
  }
104
109
  }
105
110
  function validateScreenPrelude(ctx, screenId, screen) {
@@ -1,3 +1,5 @@
1
+ import { bootRuleError } from "./boot-rule.js";
2
+ import { HANDLER_DECLARATION_RULES } from "./handler-declaration-rules.js";
1
3
  function perCommandConflict(handler) {
2
4
  if (handler.transaction !== "perCommand")
3
5
  return undefined;
@@ -10,8 +12,10 @@ function perCommandConflict(handler) {
10
12
  export function validatePerCommandTransaction(featureName, handlerName, handler) {
11
13
  const conflicting = perCommandConflict(handler);
12
14
  if (conflicting !== undefined) {
13
- throw new Error(`write handler "${featureName}:write:${handlerName}" declares transaction: "perCommand" together with ${conflicting} — ` +
14
- "a perCommand handler holds no transaction, so move the phase into the commands it issues via ctx.dispatch.write.");
15
+ throw bootRuleError(HANDLER_DECLARATION_RULES.perCommandWithPhase, {
16
+ message: `write handler "${featureName}:write:${handlerName}" declares transaction: "perCommand" together with ${conflicting} — ` +
17
+ "a perCommand handler holds no transaction, so move the phase into the commands it issues via ctx.dispatch.write.",
18
+ });
15
19
  }
16
20
  }
17
21
  export function validateBeforeTransactionWhenNested(featureName, handlerName, handler) {
@@ -20,9 +24,13 @@ export function validateBeforeTransactionWhenNested(featureName, handlerName, ha
20
24
  return;
21
25
  const where = `write handler "${featureName}:write:${handlerName}" declares beforeTransactionWhenNested`;
22
26
  if (!handler.beforeTransaction) {
23
- throw new Error(`${where} without beforeTransaction — there is no phase to skip.`);
27
+ throw bootRuleError(HANDLER_DECLARATION_RULES.nestedSkipWithoutPhase, {
28
+ message: `${where} without beforeTransaction — there is no phase to skip.`,
29
+ });
24
30
  }
25
31
  if (handler.reserveBeforeTransaction) {
26
- throw new Error(`${where} together with reserveBeforeTransaction — a nested run cannot skip the reservation, it would run unreserved.`);
32
+ throw bootRuleError(HANDLER_DECLARATION_RULES.nestedSkipWithReservation, {
33
+ message: `${where} together with reserveBeforeTransaction — a nested run cannot skip the reservation, it would run unreserved.`,
34
+ });
27
35
  }
28
36
  }
@@ -1,5 +1,7 @@
1
1
  import { parseRefTargetEntityName } from "../parse-ref-target.js";
2
2
  import { findOverDeepTransferChain, MAX_TRANSFER_DEPTH, resolveTransferAdjacency, } from "../transfer-adjacency.js";
3
+ import { bootRuleError } from "./boot-rule.js";
4
+ import { ENTITY_DECLARATION_RULES } from "./entity-declaration-rules.js";
3
5
  // --- Transfer-graph boot validation ---
4
6
  //
5
7
  // tenant-handover walks an entity graph across the tenant boundary along two
@@ -37,12 +39,14 @@ function validateNoMultipleReferenceEdge(entry, featureName, transferable) {
37
39
  continue;
38
40
  if (!transferable.has(parseRefTargetEntityName(field.entity)))
39
41
  continue;
40
- throw new Error(`[Kumiko TransferGraph] entity "${entry.name}" declares transferable: true and a ` +
41
- `multiple reference field "${fieldName}" -> "${field.entity}" (feature: "${featureName}"). ` +
42
- `A multiple reference stores a jsonb array, which the tenant-handover transfer graph ` +
43
- `cannot match rows on — those rows would stay behind in the source tenant. ` +
44
- `Fix: model the link as a single reference on the owning side, or drop transferable ` +
45
- `from "${entry.name}".`);
42
+ throw bootRuleError(ENTITY_DECLARATION_RULES.transferMultipleReference, {
43
+ message: `[Kumiko TransferGraph] entity "${entry.name}" declares transferable: true and a ` +
44
+ `multiple reference field "${fieldName}" -> "${field.entity}" (feature: "${featureName}"). ` +
45
+ `A multiple reference stores a jsonb array, which the tenant-handover transfer graph ` +
46
+ `cannot match rows on — those rows would stay behind in the source tenant. ` +
47
+ `Fix: model the link as a single reference on the owning side, or drop transferable ` +
48
+ `from "${entry.name}".`,
49
+ });
46
50
  }
47
51
  }
48
52
  export function validateTransferGraph(feature, featureMap) {
@@ -58,11 +62,13 @@ export function validateTransferGraph(feature, featureMap) {
58
62
  continue;
59
63
  const tooDeep = findOverDeepTransferChain(adjacency, [name]);
60
64
  if (tooDeep !== undefined) {
61
- throw new Error(`[Kumiko TransferGraph] the transfer graph rooted at entity "${name}" is deeper than ` +
62
- `the ${MAX_TRANSFER_DEPTH}-level limit (feature: "${feature.name}"): ` +
63
- `${tooDeep.join(" -> ")}. Beyond that depth tenant-handover would move fewer rows ` +
64
- `than the declaration implies. Fix: flatten the chain, or mark a reference field on ` +
65
- `an entity in it that should not move with its host \`handover: "stay"\`.`);
65
+ throw bootRuleError(ENTITY_DECLARATION_RULES.transferGraphTooDeep, {
66
+ message: `[Kumiko TransferGraph] the transfer graph rooted at entity "${name}" is deeper than ` +
67
+ `the ${MAX_TRANSFER_DEPTH}-level limit (feature: "${feature.name}"): ` +
68
+ `${tooDeep.join(" -> ")}. Beyond that depth tenant-handover would move fewer rows ` +
69
+ `than the declaration implies. Fix: flatten the chain, or mark a reference field on ` +
70
+ `an entity in it that should not move with its host \`handover: "stay"\`.`,
71
+ });
66
72
  }
67
73
  }
68
74
  }
@@ -1,6 +1,8 @@
1
1
  import { qualifyEntityName } from "../qualified-name.js";
2
2
  import { isFieldsEditSection, normalizeEditField, sectionFieldSpecs } from "../screen-helpers.js";
3
+ import { bootRuleError } from "./boot-rule.js";
3
4
  import { collectScreensByShortId, readsNavigateParamsAsFormPrefill, rowFieldExtractorKeys, validateDrawerPrefillKeys, } from "./screens.js";
5
+ import { SCREEN_RULES } from "./screens-rules.js";
4
6
  function isNavigateKind(action) {
5
7
  return action.kind === undefined || action.kind === "navigate";
6
8
  }
@@ -146,11 +148,13 @@ function assertHiddenRequiredFieldsSeeded(featureName, screenId, screen, seeded)
146
148
  }
147
149
  if (seeded.has(spec.field))
148
150
  continue;
149
- throw new Error(`[Feature ${featureName}] Screen "${screenId}" (${screen.type}) sets submitPrefilled but ` +
150
- `hides required field "${spec.field}" (visible: false) and no navigate action passes it in ` +
151
- `params — the field could never get a value and the form could never submit. Add ` +
152
- `"${spec.field}" to the params of a navigate action targeting this screen, make the field ` +
153
- `visible, or drop required.`);
151
+ throw bootRuleError(SCREEN_RULES.submitPrefilledHiddenRequired, {
152
+ message: `[Feature ${featureName}] Screen "${screenId}" (${screen.type}) sets submitPrefilled but ` +
153
+ `hides required field "${spec.field}" (visible: false) and no navigate action passes it in ` +
154
+ `params — the field could never get a value and the form could never submit. Add ` +
155
+ `"${spec.field}" to the params of a navigate action targeting this screen, make the field ` +
156
+ `visible, or drop required.`,
157
+ });
154
158
  }
155
159
  }
156
160
  }
@@ -1,6 +1,8 @@
1
1
  // Workspace validation.
2
2
  import { SETTINGS_HUB_AUDIENCE_NAV_QNS } from "../build-config-feature-schema.js";
3
3
  import { qualifyEntityName } from "../qualified-name.js";
4
+ import { bootRuleError } from "./boot-rule.js";
5
+ import { NAV_RULES } from "./nav-rules.js";
4
6
  // --- Workspace validation ---
5
7
  //
6
8
  // Per-app workspace registry, built once up front. Carries `featureName`
@@ -24,9 +26,11 @@ export function validateWorkspaces(feature, allNavQns) {
24
26
  if (SETTINGS_HUB_AUDIENCE_NAV_QN_SET.has(navQn))
25
27
  continue;
26
28
  if (!allNavQns.has(navQn)) {
27
- throw new Error(`[Feature ${feature.name}] Workspace "${wsId}" references nav "${navQn}" ` +
28
- `which is not registered. Expected a qualified name of the form ` +
29
- `"<feature>:nav:<id>" pointing at an r.nav() declaration.`);
29
+ throw bootRuleError(NAV_RULES.workspaceNavUnregistered, {
30
+ message: `[Feature ${feature.name}] Workspace "${wsId}" references nav "${navQn}" ` +
31
+ `which is not registered. Expected a qualified name of the form ` +
32
+ `"<feature>:nav:<id>" pointing at an r.nav() declaration.`,
33
+ });
30
34
  }
31
35
  }
32
36
  }
@@ -75,7 +79,9 @@ export function validateDefaultWorkspaceUniqueness(allWorkspaceQns) {
75
79
  defaults.push(qn);
76
80
  }
77
81
  if (defaults.length > 1) {
78
- throw new Error(`[Kumiko Workspaces] Multiple workspaces declare default: true — ` +
79
- `${defaults.join(", ")}. At most one workspace per app may be the default.`);
82
+ throw bootRuleError(NAV_RULES.multipleDefaultWorkspaces, {
83
+ message: `[Kumiko Workspaces] Multiple workspaces declare default: true — ` +
84
+ `${defaults.join(", ")}. At most one workspace per app may be the default.`,
85
+ });
80
86
  }
81
87
  }
@@ -1,4 +1,6 @@
1
1
  import { ZodArray, ZodCatch, ZodDefault, ZodIntersection, ZodLazy, ZodMap, ZodNever, ZodNonOptional, ZodNullable, ZodObject, ZodOptional, ZodPipe, ZodPrefault, ZodPromise, ZodReadonly, ZodRecord, ZodSet, ZodTuple, ZodUnion, ZodXor, } from "zod";
2
+ import { bootRuleError } from "./boot-rule.js";
3
+ import { HANDLER_FIELD_REFERENCE_RULES } from "./handler-field-references-rules.js";
2
4
  // Drills through wrapper types (.nullable(), .optional(), .default()) a
3
5
  // handler's schema may use around its actual object/array shape — e.g. a
4
6
  // detail query returning `Row | null` when the record doesn't exist.
@@ -111,8 +113,10 @@ export function collectZodObjectKeys(schema) {
111
113
  if (visited.has(next))
112
114
  continue;
113
115
  if (visited.size >= MAX_WALKED_SCHEMAS) {
114
- throw new Error(`collectZodObjectKeys: schema has more than ${MAX_WALKED_SCHEMAS} nodes — ` +
115
- "a z.lazy() getter probably returns a new schema on every call; hoist it into a constant.");
116
+ throw bootRuleError(HANDLER_FIELD_REFERENCE_RULES.zodWalkLimit, {
117
+ message: `collectZodObjectKeys: schema has more than ${MAX_WALKED_SCHEMAS} nodes — ` +
118
+ "a z.lazy() getter probably returns a new schema on every call; hoist it into a constant.",
119
+ });
116
120
  }
117
121
  visited.add(next);
118
122
  if (next instanceof ZodObject) {
@@ -19,6 +19,7 @@ export declare const entityListSchema: z.ZodObject<{
19
19
  offset: z.ZodOptional<z.ZodNumber>;
20
20
  totalCount: z.ZodOptional<z.ZodBoolean>;
21
21
  includeDeleted: z.ZodOptional<z.ZodBoolean>;
22
+ onlyDeleted: z.ZodOptional<z.ZodBoolean>;
22
23
  filter: z.ZodOptional<z.ZodObject<{
23
24
  field: z.ZodString;
24
25
  op: z.ZodEnum<{
@@ -91,6 +91,9 @@ export const entityListSchema = z.object({
91
91
  // entities; the dispatcher mirrors it onto ctx.includeDeleted. Tenant +
92
92
  // ownership filters still apply.
93
93
  includeDeleted: z.boolean().optional(),
94
+ // Trash list: only soft-deleted rows (restore candidates). Rejected together with
95
+ // includeDeleted and on entities without softDelete.
96
+ onlyDeleted: z.boolean().optional(),
94
97
  filter: z
95
98
  .object({
96
99
  field: z.string(),
@@ -6,24 +6,19 @@ import { extractTableInfo } from "../db/table-info.js";
6
6
  import { hasAccess } from "./access.js";
7
7
  import { IMPLICIT_PROJECTION_SUFFIX } from "./registry-state.js";
8
8
  // The rules only change with the registry, so they are collected once, not per request.
9
- const readAccessByRegistry = new WeakMap();
10
- const detailAccessByRegistry = new WeakMap();
11
- function detailAccessOf(registry) {
12
- let rules = detailAccessByRegistry.get(registry);
13
- if (rules === undefined) {
14
- rules = collectEntityDetailAccess(registry);
15
- detailAccessByRegistry.set(registry, rules);
16
- }
17
- return rules;
18
- }
19
- function readAccessOf(registry) {
20
- let rules = readAccessByRegistry.get(registry);
21
- if (rules === undefined) {
22
- rules = collectEntityReadAccess(registry);
23
- readAccessByRegistry.set(registry, rules);
24
- }
25
- return rules;
9
+ function memoizePerRegistry(collect) {
10
+ const cache = new WeakMap();
11
+ return (registry) => {
12
+ let value = cache.get(registry);
13
+ if (value === undefined) {
14
+ value = collect(registry);
15
+ cache.set(registry, value);
16
+ }
17
+ return value;
18
+ };
26
19
  }
20
+ const detailAccessOf = memoizePerRegistry(collectEntityDetailAccess);
21
+ const readAccessOf = memoizePerRegistry(collectEntityReadAccess);
27
22
  // An entity with a backingTable is read from that table; the implicit projection holds it.
28
23
  function readTableOf(ctx, entityName, entity) {
29
24
  const implicit = ctx.registry
@@ -31,6 +26,14 @@ function readTableOf(ctx, entityName, entity) {
31
26
  .find((projection) => projection.name.endsWith(`:projection:${entityName}${IMPLICIT_PROJECTION_SUFFIX}`));
32
27
  return implicit?.table ?? buildEntityTable(entityName, entity);
33
28
  }
29
+ function readTableResolver(ctx, label) {
30
+ return (name) => {
31
+ const entity = ctx.registry.getEntity(name);
32
+ if (entity === undefined)
33
+ throw new Error(`${label}: unknown entity "${name}"`);
34
+ return readTableOf(ctx, name, entity);
35
+ };
36
+ }
34
37
  // The join-row and read gates resolve hosts and file owners against the registry, which only
35
38
  // exists at request time; the handler check is the one live signals use too.
36
39
  export function parentVisibilityFor(ctx, user) {
@@ -41,12 +44,7 @@ export function parentVisibilityFor(ctx, user) {
41
44
  const rule = detailRules.get(name);
42
45
  return rule !== undefined && hasAccess(user, rule);
43
46
  },
44
- resolveTable: (name) => {
45
- const entity = ctx.registry.getEntity(name);
46
- if (entity === undefined)
47
- throw new Error(`parentVisibility: unknown entity "${name}"`);
48
- return readTableOf(ctx, name, entity);
49
- },
47
+ resolveTable: readTableResolver(ctx, "parentVisibility"),
50
48
  };
51
49
  }
52
50
  // Registry access only exists at request time, so the searchable/sortable-reference
@@ -55,12 +53,7 @@ export function parentVisibilityFor(ctx, user) {
55
53
  export function entityListRuntime(ctx, entityName, user) {
56
54
  const parentVisibility = parentVisibilityFor(ctx, user);
57
55
  const resolveEntity = (name) => ctx.registry.getEntity(name);
58
- const resolveTable = (name) => {
59
- const entity = ctx.registry.getEntity(name);
60
- if (entity === undefined)
61
- throw new Error(`entityListRuntime: unknown entity "${name}"`);
62
- return readTableOf(ctx, name, entity);
63
- };
56
+ const resolveTable = readTableResolver(ctx, "entityListRuntime");
64
57
  const readRules = readAccessOf(ctx.registry);
65
58
  return {
66
59
  runtimeOptions: {
@@ -68,6 +61,7 @@ export function entityListRuntime(ctx, entityName, user) {
68
61
  searchAdapter: ctx.services.searchAdapter,
69
62
  }),
70
63
  ...(ctx.includeDeleted === true && { includeDeleted: true }),
64
+ ...(ctx.onlyDeleted === true && { onlyDeleted: true }),
71
65
  referenceSearch: {
72
66
  fields: ctx.registry.getSearchableReferences(entityName),
73
67
  resolveEntity,
@@ -8,10 +8,13 @@ export interface TenantDataHookCtx {
8
8
  readonly tenantId: TenantId;
9
9
  readonly deadlineAt?: number;
10
10
  readonly fileProviderResolver?: FileProviderResolver;
11
+ readonly heldFileRefIds?: ReadonlySet<string>;
11
12
  readonly log?: (message: string) => void;
12
13
  }
14
+ export type TenantDataDestroyPhase = "app-data" | "tenant-row";
13
15
  export type TenantDataDestroyHook = (ctx: TenantDataHookCtx) => Promise<TenantDestroyHookResult | void>;
14
16
  export interface TenantDataExtensionHooks {
15
17
  readonly destroy: TenantDataDestroyHook;
18
+ readonly phase?: TenantDataDestroyPhase;
16
19
  }
17
20
  export declare function isTenantDataExtensionHooks(o: unknown): o is TenantDataExtensionHooks;
@@ -22,7 +22,7 @@ export declare function createTextField<R extends true | false = false>(override
22
22
  * `sortable`) — see DerivedFieldDef.
23
23
  */
24
24
  export declare function createDerivedField(spec: DerivedFieldDef): DerivedFieldDef;
25
- export declare function createLongTextField<R extends true | false = false>(overrides: Partial<Omit<LongTextFieldDef, "type" | "required" | keyof ResolvedPiiFlags>> & PersonalAnnotationsLongText & {
25
+ export declare function createLongTextField<R extends true | false = false>(overrides: Partial<Omit<LongTextFieldDef, "type" | "required" | "searchable" | keyof ResolvedPiiFlags>> & PersonalAnnotationsLongText & {
26
26
  required?: R;
27
27
  }): EntityLongTextFieldDef & {
28
28
  required: R;
@@ -55,10 +55,10 @@ function expandPersonalAnnotations(overrides) {
55
55
  }
56
56
  // `find` is mandatory once a subject is named (types require it — see
57
57
  // PersonalAnnotations / PersonalAnnotationsLongText), but the valid values
58
- // differ per factory: longText has no lookup/search machinery.
58
+ // differ per factory: longText has no blind-index lookup ("exact").
59
59
  const TEXT_FIELD_STANCE_FIND_VALUES = {
60
60
  createTextField: ["exact", "fuzzy", "none", "secret"],
61
- createLongTextField: ["none", "secret"],
61
+ createLongTextField: ["none", "fuzzy", "secret"],
62
62
  };
63
63
  function textFieldStanceHint(factoryName) {
64
64
  const find = TEXT_FIELD_STANCE_FIND_VALUES[factoryName].map((f) => `"${f}"`).join(" | ");
@@ -147,10 +147,11 @@ export function createDerivedField(spec) {
147
147
  }
148
148
  export function createLongTextField(overrides) {
149
149
  assertTextFieldStance("createLongTextField", overrides);
150
+ const { lookupable: _noBlindIndex, ...expanded } = expandPersonalAnnotations(overrides);
150
151
  return {
151
152
  type: "longText",
152
153
  required: false,
153
- ...expandPersonalAnnotations(overrides),
154
+ ...expanded,
154
155
  }; // @cast-boundary engine-payload
155
156
  }
156
157
  export function createBooleanField(overrides) {
@@ -6,7 +6,7 @@ export type { ExtensionOptionsArgs, ExtensionOptionsFor, KumikoExtensionOptionsM
6
6
  export type { BootOptionName, SecretKeyDefinition, SecretKeyHandle, SecretNamespaceDefinition, SecretNamespaceHandle, SecretNamespaceOptions, } from "@cosmicdrift/kumiko-types/feature";
7
7
  export type { FeatureRegistrar } from "@cosmicdrift/kumiko-types/feature-registrar";
8
8
  export type { DeriveContext, EntityDefinition, FieldDefinition, JsonbFieldDef, ResolvedPiiFlags, RetentionDef, } from "@cosmicdrift/kumiko-types/fields";
9
- export type { AccessRule, AgentHandlerHints, AgentRisk, AuthClaimsContext, BeforeTransactionResult, ChatSendFailureCode, ClaimKeyType, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchUseEvent, EventDef, JobContext, JobDeferral, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, QueryHandlerDef, RateLimitPer, RoleAccessPersonalData, RoleAccessRule, StreamHandlerDef, TenantWriteTarget, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "@cosmicdrift/kumiko-types/handlers";
9
+ export type { AccessRule, AgentEffect, AgentHandlerHints, AgentRisk, AuthClaimsContext, BeforeTransactionResult, ChatSendFailureCode, ClaimKeyType, DeliveryErrorCode, DeliveryFailureCode, DeliverySkipReason, EscapeHatchAuditSink, EscapeHatchDeclaration, EscapeHatchKind, EscapeHatchUseEvent, EventDef, JobContext, JobDeferral, NotifyDelivery, NotifyDeliveryStatus, NotifyDispatched, NotifyFactory, NotifyFn, NotifyJobDispatcher, NotifyOptions, NotifyPriority, NotifyResult, QueryHandlerDef, RateLimitPer, RoleAccessPersonalData, RoleAccessRule, StreamHandlerDef, TenantWriteTarget, WriteEvent, WriteHandlerDef, WriteHandlerFn, WriteResult, } from "@cosmicdrift/kumiko-types/handlers";
10
10
  export { DELIVERY_FAILURE_CODES, DELIVERY_SKIP_REASONS, HTTP_ERROR_CODE_PATTERN, isDeliveryErrorCode, isOpenToAllGranted, } from "@cosmicdrift/kumiko-types/handlers";
11
11
  export type { DeleteContext, PostDeleteHookFn, PostSaveHookFn, PreDeleteHookFn, PreSaveHookFn, SaveContext, ValidationError, ValidationHookFn, } from "@cosmicdrift/kumiko-types/hooks";
12
12
  export type { EntityId } from "@cosmicdrift/kumiko-types/identifiers";
@@ -56,7 +56,7 @@ export { EXT_ASSIGNABLE_ROLE, EXT_DERIVATIVE_OVERLAY_RESOLVER, EXT_DERIVATIVE_PU
56
56
  export { extensionSelectorTargets, SELECTED_EXTENSIONS_QUERY, selectablePluginIds, } from "./extension-selector-plugins.ts";
57
57
  export { extensionUsageEscapeHatchReason } from "./extensions/escape-hatch-usage.ts";
58
58
  export type { StorageProviderDestroyTenantHook, StorageProviderHookCtx, } from "./extensions/storage-provider.ts";
59
- export { isTenantDataExtensionHooks, type TenantDataDestroyHook, type TenantDataHookCtx, } from "./extensions/tenant-data.ts";
59
+ export { isTenantDataExtensionHooks, type TenantDataDestroyHook, type TenantDataDestroyPhase, type TenantDataHookCtx, } from "./extensions/tenant-data.ts";
60
60
  export { isTenantResourceExtensionHooks, type TenantDestroyHookResult, type TenantResourceDestroyHook, type TenantResourceHookCtx, } from "./extensions/tenant-resource.ts";
61
61
  export type { TenantUserModel, UserDataDeleteHook, UserDataDeleteStrategy, UserDataExportHook, UserDataExportSnippet, UserDataHookCtx, UserDataStorageProvider, } from "./extensions/user-data.ts";
62
62
  export { createBigIntField, createBooleanField, createDateField, createDecimalField, createDerivedField, createEmbeddedField, createEmbeddedListField, createEntity, createFileField, createFilesField, createImageField, createImagesField, createJsonbField, createLocatedTimestampField, createLongTextField, createMoneyField, createMultiSelectField, createNumberField, createReferenceField, createSelectField, createTextField, createTimestampField, createTzField, } from "./factories.ts";
@@ -64,6 +64,7 @@ export { type ChangelogEntry, compareVersions, filterEntriesAfter, parseFeatureC
64
64
  export { buildManifestFromRegistry, type FeatureManifest, type ManifestConfigKey, type ManifestExtension, type ManifestFeature, type ManifestSecret, type ManifestSystemEvent, serializeManifest, } from "./feature-manifest.ts";
65
65
  export { filterReadFields, maskWriteOnlyFields, } from "./field-access.ts";
66
66
  export { DEFAULT_CURRENCIES, DEFAULT_LOCALES } from "./field-helpers.ts";
67
+ export { findEntity } from "./find-entity.ts";
67
68
  export { handlerFieldReference } from "./handler-field-references.ts";
68
69
  export { withResponseData } from "./handler-helpers.ts";
69
70
  export { HookPhases } from "./hook-helpers.ts";
@@ -86,6 +87,7 @@ export { assignableAppRolesFromUsages, assignableAppRolesOf, BUILT_IN_MEMBERSHIP
86
87
  export { runPipeline, runStepList } from "./run-pipeline.ts";
87
88
  export { buildInsertSchema, buildUpdateSchema, fieldToZod, SYSTEM_ONLY_JSON_SCHEMA_KEY, } from "./schema-builder.ts";
88
89
  export { isFieldsEditSection, normalizeEditField, normalizeListColumn, sectionFieldSpecs, } from "./screen-helpers.ts";
90
+ export { DEFAULT_GRACE_DAYS as SOFT_DELETE_DEFAULT_GRACE_DAYS, readSoftDeleteGraceDays, SOFT_DELETE_GRACE_DAYS_KEY, } from "./soft-delete-cleanup.ts";
89
91
  export type { TransitionGraph } from "./state-machine.ts";
90
92
  export { defineTransitions, guardTransition } from "./state-machine.ts";
91
93
  export { evaluateEventMatch } from "./steps/_event-match.ts";
@@ -43,6 +43,7 @@ export { compareVersions, filterEntriesAfter, parseFeatureChangelog, } from "./f
43
43
  export { buildManifestFromRegistry, serializeManifest, } from "./feature-manifest.js";
44
44
  export { filterReadFields, maskWriteOnlyFields, } from "./field-access.js";
45
45
  export { DEFAULT_CURRENCIES, DEFAULT_LOCALES } from "./field-helpers.js";
46
+ export { findEntity } from "./find-entity.js";
46
47
  export { handlerFieldReference } from "./handler-field-references.js";
47
48
  export { withResponseData } from "./handler-helpers.js";
48
49
  export { HookPhases } from "./hook-helpers.js";
@@ -69,6 +70,7 @@ export { assignableAppRolesFromUsages, assignableAppRolesOf, BUILT_IN_MEMBERSHIP
69
70
  export { runPipeline, runStepList } from "./run-pipeline.js";
70
71
  export { buildInsertSchema, buildUpdateSchema, fieldToZod, SYSTEM_ONLY_JSON_SCHEMA_KEY, } from "./schema-builder.js";
71
72
  export { isFieldsEditSection, normalizeEditField, normalizeListColumn, sectionFieldSpecs, } from "./screen-helpers.js";
73
+ export { DEFAULT_GRACE_DAYS as SOFT_DELETE_DEFAULT_GRACE_DAYS, readSoftDeleteGraceDays, SOFT_DELETE_GRACE_DAYS_KEY, } from "./soft-delete-cleanup.js";
72
74
  export { defineTransitions, guardTransition } from "./state-machine.js";
73
75
  export { evaluateEventMatch } from "./steps/_event-match.js";
74
76
  export { STEP_DISPATCH_AGGREGATE_TYPE, STEP_DISPATCH_FAILED_TYPE, STEP_DISPATCH_REQUESTED_TYPE, STEP_DISPATCHED_TYPE, WORKFLOW_AGGREGATE_TYPE, WORKFLOW_RESUMED_TYPE, WORKFLOW_RETRY_SCHEDULED_TYPE, WORKFLOW_RUN_COMPLETED_TYPE, WORKFLOW_RUN_FAILED_TYPE, WORKFLOW_RUN_STARTED_TYPE, WORKFLOW_WAITING_FOR_EVENT_TYPE, WORKFLOW_WAITING_TYPE, } from "./steps/_step-dispatch-constants.js";
@@ -226,8 +226,7 @@ function isRedirectTargetKept(featureName, target, keptScreenQns) {
226
226
  function isDrawerTargetKept(feature, shortId, keptScreenQns) {
227
227
  return keptScreenQns.has(qualifyEntityName(feature.featureName, "screen", shortId));
228
228
  }
229
- function isListScreenIdKept(listScreenId, indices, keptScreenQns) {
230
- const target = indices.screensByShortId.get(listScreenId);
229
+ function isTargetKept(target, keptScreenQns) {
231
230
  if (target === undefined)
232
231
  return false;
233
232
  return keptScreenQns.has(qualifyEntityName(target.featureName, "screen", target.screen.id));
@@ -281,12 +280,6 @@ function projectTreeAction(action, keptScreenQns) {
281
280
  return undefined;
282
281
  return keepTreeAction(action, keptScreenQns) ? action : undefined;
283
282
  }
284
- function isRowClickEntityKept(entity, indices, keptScreenQns) {
285
- const target = indices.detailForScreens.get(entity);
286
- if (target === undefined)
287
- return false;
288
- return keptScreenQns.has(qualifyEntityName(target.featureName, "screen", target.screen.id));
289
- }
290
283
  // --- EditLayout / EditSectionSpec projection ---
291
284
  function projectEmptyState(emptyState, feature, indices, keptScreenQns) {
292
285
  if (emptyState === undefined)
@@ -303,7 +296,8 @@ function projectRelatedListSection(section, feature, indices, keptScreenQns) {
303
296
  const nextActions = projectActionArray(actions, feature, indices, keptScreenQns);
304
297
  const nextRowActions = projectActionArray(rowActions, feature, indices, keptScreenQns);
305
298
  const nextToolbarActions = projectActionArray(toolbarActions, feature, indices, keptScreenQns);
306
- const nextRowClick = rowClick === undefined || isRowClickEntityKept(rowClick.entity, indices, keptScreenQns)
299
+ const nextRowClick = rowClick === undefined ||
300
+ isTargetKept(indices.detailForScreens.get(rowClick.entity), keptScreenQns)
307
301
  ? rowClick
308
302
  : undefined;
309
303
  const nextEmptyState = projectEmptyState(emptyState, feature, indices, keptScreenQns);
@@ -410,8 +404,11 @@ function projectDashboardPanels(panels, feature, keptScreenQns) {
410
404
  function projectListScreenId(listScreenId, indices, keptScreenQns) {
411
405
  if (listScreenId === undefined)
412
406
  return undefined;
413
- return isListScreenIdKept(listScreenId, indices, keptScreenQns) ? listScreenId : undefined;
407
+ return isTargetKept(indices.screensByShortId.get(listScreenId), keptScreenQns)
408
+ ? listScreenId
409
+ : undefined;
414
410
  }
411
+ // guard:dup-ok sibling of projectListScreenId for a different reference kind with its own keep check
415
412
  function projectRedirect(featureName, redirect, keptScreenQns) {
416
413
  if (redirect === undefined)
417
414
  return undefined;
@@ -496,16 +493,33 @@ function projectEntityEditScreen(screen, feature, indices, keptScreenQns) {
496
493
  ...(nextListScreenId !== undefined && { listScreenId: nextListScreenId }),
497
494
  };
498
495
  }
496
+ function projectSuccessLinks(featureName, successLinks, keptScreenQns) {
497
+ if (successLinks === undefined)
498
+ return undefined;
499
+ const kept = successLinks.filter((link) => isRedirectTargetKept(featureName, link, keptScreenQns));
500
+ if (kept.length === successLinks.length)
501
+ return successLinks;
502
+ return kept.length === 0 ? undefined : kept;
503
+ }
504
+ // The hints stay without their link: what they say is still true for the role.
505
+ function projectSuccessItems(featureName, successItems, keptScreenQns) {
506
+ if (successItems?.link === undefined)
507
+ return successItems;
508
+ return isRedirectTargetKept(featureName, successItems.link, keptScreenQns)
509
+ ? successItems
510
+ : { field: successItems.field };
511
+ }
499
512
  function projectActionFormScreen(screen, feature, indices, keptScreenQns) {
500
- const { redirect, successLinks, cancelTarget, layout, listScreenId, ...rest } = screen;
513
+ const { redirect, successLinks, successItems, cancelTarget, layout, listScreenId, ...rest } = screen;
501
514
  const nextRedirect = projectRedirect(feature.featureName, redirect, keptScreenQns);
502
- const keptSuccessLinks = successLinks?.filter((link) => isRedirectTargetKept(feature.featureName, link, keptScreenQns));
503
- const nextSuccessLinks = keptSuccessLinks?.length === 0 ? undefined : keptSuccessLinks;
515
+ const nextSuccessLinks = projectSuccessLinks(feature.featureName, successLinks, keptScreenQns);
516
+ const nextSuccessItems = projectSuccessItems(feature.featureName, successItems, keptScreenQns);
504
517
  const nextCancelTarget = projectCancelTarget(feature.featureName, cancelTarget, keptScreenQns);
505
518
  const nextLayout = projectEditLayout(layout, feature, indices, keptScreenQns);
506
519
  const nextListScreenId = projectListScreenId(listScreenId, indices, keptScreenQns);
507
520
  const unchanged = nextRedirect === redirect &&
508
- nextSuccessLinks?.length === successLinks?.length &&
521
+ nextSuccessLinks === successLinks &&
522
+ nextSuccessItems === successItems &&
509
523
  nextCancelTarget === cancelTarget &&
510
524
  nextLayout === layout &&
511
525
  nextListScreenId === listScreenId;
@@ -516,6 +530,7 @@ function projectActionFormScreen(screen, feature, indices, keptScreenQns) {
516
530
  layout: nextLayout,
517
531
  ...(nextRedirect !== undefined && { redirect: nextRedirect }),
518
532
  ...(nextSuccessLinks !== undefined && { successLinks: nextSuccessLinks }),
533
+ ...(nextSuccessItems !== undefined && { successItems: nextSuccessItems }),
519
534
  ...(nextCancelTarget !== undefined && { cancelTarget: nextCancelTarget }),
520
535
  ...(nextListScreenId !== undefined && { listScreenId: nextListScreenId }),
521
536
  };