@cosmicdrift/kumiko-framework 0.406.0 → 0.409.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.
- package/agents/api/framework-db.md +1 -0
- package/agents/api/framework-engine.md +15 -2
- package/agents/api/framework-ui-types.md +15 -0
- package/agents/api/renderer-web.md +156 -2
- package/agents/api/types.md +113 -71
- package/agents/api.md +4 -4
- package/agents/boot-rules.md +743 -0
- package/agents/examples/contact.md +167 -0
- package/agents/examples/delivery-notifications.md +34 -1
- package/agents/examples/record-detail-layout.md +13 -2
- package/agents/examples/search.md +65 -3
- package/agents/examples/secrets-demo.md +96 -2
- package/agents/examples/tenant-inactivity.md +138 -0
- package/agents/examples.md +2 -0
- package/agents/features-index.md +4 -0
- package/agents/features.md +24 -1
- package/agents/widgets.md +12 -1
- package/dist/api/export/export-rows.js +1 -0
- package/dist/compliance/index.d.ts +1 -1
- package/dist/db/event-store-executor-read-where.js +15 -5
- package/dist/db/index.d.ts +1 -1
- package/dist/db/index.js +1 -1
- package/dist/db/migrate-generator.js +3 -1
- package/dist/db/queries/event-consumer.js +11 -7
- package/dist/db/queries/event-store.d.ts +2 -1
- package/dist/db/queries/event-store.js +25 -6
- package/dist/db/queries/rls-boot-catalog.js +3 -1
- package/dist/db/queries/session-advisory-lock.d.ts +7 -0
- package/dist/db/queries/session-advisory-lock.js +23 -0
- package/dist/db/query.js +7 -10
- package/dist/db/row-level-security-connection.js +4 -2
- package/dist/engine/active-membership.js +1 -0
- package/dist/engine/boot-validator/access-declarations.js +57 -33
- package/dist/engine/boot-validator/action-wiring.js +8 -6
- package/dist/engine/boot-validator/agent-effect-rules.d.ts +12 -0
- package/dist/engine/boot-validator/agent-effect-rules.js +12 -0
- package/dist/engine/boot-validator/agent-effect.d.ts +2 -0
- package/dist/engine/boot-validator/agent-effect.js +20 -0
- package/dist/engine/boot-validator/boot-context.js +5 -1
- package/dist/engine/boot-validator/boot-environment-rules.d.ts +12 -0
- package/dist/engine/boot-validator/boot-environment-rules.js +12 -0
- package/dist/engine/boot-validator/boot-phases-app.js +5 -1
- package/dist/engine/boot-validator/boot-phases.js +3 -1
- package/dist/engine/boot-validator/boot-rules.d.ts +2619 -0
- package/dist/engine/boot-validator/boot-rules.js +58 -0
- package/dist/engine/boot-validator/bundled-lists-table.js +23 -9
- package/dist/engine/boot-validator/config-deps.js +71 -23
- package/dist/engine/boot-validator/config-edit-action-rules.d.ts +17 -0
- package/dist/engine/boot-validator/config-edit-action-rules.js +17 -0
- package/dist/engine/boot-validator/config-key-rules.d.ts +117 -0
- package/dist/engine/boot-validator/config-key-rules.js +117 -0
- package/dist/engine/boot-validator/custom-screen-write-qns.js +6 -2
- package/dist/engine/boot-validator/derived-sql-fields-rules.d.ts +77 -0
- package/dist/engine/boot-validator/derived-sql-fields-rules.js +77 -0
- package/dist/engine/boot-validator/derived-sql-fields.js +53 -17
- package/dist/engine/boot-validator/detail-screens.js +10 -4
- package/dist/engine/boot-validator/entity-declaration-rules.d.ts +92 -0
- package/dist/engine/boot-validator/entity-declaration-rules.js +92 -0
- package/dist/engine/boot-validator/entity-handler-access-rules.d.ts +102 -0
- package/dist/engine/boot-validator/entity-handler-access-rules.js +102 -0
- package/dist/engine/boot-validator/entity-handler.d.ts +0 -7
- package/dist/engine/boot-validator/entity-handler.js +259 -355
- package/dist/engine/boot-validator/entity-image-variants.d.ts +2 -0
- package/dist/engine/boot-validator/entity-image-variants.js +91 -0
- package/dist/engine/boot-validator/entity-list-aggregate-options.js +8 -2
- package/dist/engine/boot-validator/entity-reference-embedded-rules.d.ts +117 -0
- package/dist/engine/boot-validator/entity-reference-embedded-rules.js +117 -0
- package/dist/engine/boot-validator/entity-select-image-rules.d.ts +122 -0
- package/dist/engine/boot-validator/entity-select-image-rules.js +122 -0
- package/dist/engine/boot-validator/entity-select.d.ts +8 -0
- package/dist/engine/boot-validator/entity-select.js +197 -0
- package/dist/engine/boot-validator/entity-structure-rules.d.ts +107 -0
- package/dist/engine/boot-validator/entity-structure-rules.js +107 -0
- package/dist/engine/boot-validator/field-conditions-rules.d.ts +92 -0
- package/dist/engine/boot-validator/field-conditions-rules.js +92 -0
- package/dist/engine/boot-validator/field-conditions.js +67 -22
- package/dist/engine/boot-validator/form-derivations-rules.d.ts +77 -0
- package/dist/engine/boot-validator/form-derivations-rules.js +77 -0
- package/dist/engine/boot-validator/form-derivations.js +52 -18
- package/dist/engine/boot-validator/global-tenancy.js +13 -7
- package/dist/engine/boot-validator/handler-declaration-rules.d.ts +72 -0
- package/dist/engine/boot-validator/handler-declaration-rules.js +72 -0
- package/dist/engine/boot-validator/handler-field-references-rules.d.ts +22 -0
- package/dist/engine/boot-validator/handler-field-references-rules.js +22 -0
- package/dist/engine/boot-validator/handler-field-references.js +14 -6
- package/dist/engine/boot-validator/list-bulk-actions-rules.d.ts +42 -0
- package/dist/engine/boot-validator/list-bulk-actions-rules.js +42 -0
- package/dist/engine/boot-validator/list-bulk-actions.js +29 -11
- package/dist/engine/boot-validator/list-column-layout.js +22 -10
- package/dist/engine/boot-validator/list-query-rules.d.ts +107 -0
- package/dist/engine/boot-validator/list-query-rules.js +107 -0
- package/dist/engine/boot-validator/list-table-aggregate-options.js +43 -15
- package/dist/engine/boot-validator/list-table-aggregate-query.js +7 -3
- package/dist/engine/boot-validator/list-table-aggregate-rules.d.ts +82 -0
- package/dist/engine/boot-validator/list-table-aggregate-rules.js +82 -0
- package/dist/engine/boot-validator/list-table-export-options.js +19 -7
- package/dist/engine/boot-validator/list-table-options.js +33 -13
- package/dist/engine/boot-validator/list-table-reject-unknown-keys.js +6 -2
- package/dist/engine/boot-validator/list-table-rules.d.ts +132 -0
- package/dist/engine/boot-validator/list-table-rules.js +132 -0
- package/dist/engine/boot-validator/nav-rules.d.ts +42 -0
- package/dist/engine/boot-validator/nav-rules.js +42 -0
- package/dist/engine/boot-validator/nav.js +29 -15
- package/dist/engine/boot-validator/ownership-rules.d.ts +27 -0
- package/dist/engine/boot-validator/ownership-rules.js +27 -0
- package/dist/engine/boot-validator/ownership.js +28 -12
- package/dist/engine/boot-validator/parent-ref.js +32 -20
- package/dist/engine/boot-validator/projection-list-screens.js +76 -35
- package/dist/engine/boot-validator/query-output-columns.js +9 -3
- package/dist/engine/boot-validator/query-refs.js +20 -10
- package/dist/engine/boot-validator/query-rules.d.ts +37 -0
- package/dist/engine/boot-validator/query-rules.js +37 -0
- package/dist/engine/boot-validator/read-gate.js +14 -10
- package/dist/engine/boot-validator/record-owned.js +5 -1
- package/dist/engine/boot-validator/related-list-table-rules.js +17 -7
- package/dist/engine/boot-validator/screens-actions-rules.d.ts +185 -0
- package/dist/engine/boot-validator/screens-actions-rules.js +185 -0
- package/dist/engine/boot-validator/screens-actions.js +169 -93
- package/dist/engine/boot-validator/screens-dashboard-chart-rules.d.ts +87 -0
- package/dist/engine/boot-validator/screens-dashboard-chart-rules.js +87 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +227 -0
- package/dist/engine/boot-validator/screens-dashboard-rules.js +227 -0
- package/dist/engine/boot-validator/screens-dashboard.js +222 -85
- package/dist/engine/boot-validator/screens-forms-layout-rules.d.ts +122 -0
- package/dist/engine/boot-validator/screens-forms-layout-rules.js +122 -0
- package/dist/engine/boot-validator/screens-forms-rules.d.ts +152 -0
- package/dist/engine/boot-validator/screens-forms-rules.js +152 -0
- package/dist/engine/boot-validator/screens-forms.js +240 -112
- package/dist/engine/boot-validator/screens-kind-config-edit.js +72 -16
- package/dist/engine/boot-validator/screens-kind-entity-edit.js +15 -7
- package/dist/engine/boot-validator/screens-kind-entity-list.js +57 -32
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +92 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +92 -0
- package/dist/engine/boot-validator/screens-kind-projection-detail.js +85 -47
- package/dist/engine/boot-validator/screens-kind-rules.d.ts +137 -0
- package/dist/engine/boot-validator/screens-kind-rules.js +137 -0
- package/dist/engine/boot-validator/screens-kind-secret-mint.js +18 -8
- package/dist/engine/boot-validator/screens-kind-shared.js +40 -22
- package/dist/engine/boot-validator/screens-lists-rules.d.ts +82 -0
- package/dist/engine/boot-validator/screens-lists-rules.js +82 -0
- package/dist/engine/boot-validator/screens-lists.js +90 -45
- package/dist/engine/boot-validator/screens-rules.d.ts +57 -0
- package/dist/engine/boot-validator/screens-rules.js +57 -0
- package/dist/engine/boot-validator/screens.js +17 -12
- package/dist/engine/boot-validator/transaction-phases.js +12 -4
- package/dist/engine/boot-validator/transfer-graph.js +17 -11
- package/dist/engine/boot-validator/url-prefill-fields.js +9 -5
- package/dist/engine/boot-validator/workspaces.js +11 -5
- package/dist/engine/boot-validator/zod-shape.js +6 -2
- package/dist/engine/entity-handlers.d.ts +1 -0
- package/dist/engine/entity-handlers.js +3 -0
- package/dist/engine/entity-list-runtime-options.js +23 -29
- package/dist/engine/extensions/tenant-data.d.ts +3 -0
- package/dist/engine/factories.d.ts +1 -1
- package/dist/engine/factories.js +4 -3
- package/dist/engine/index.d.ts +4 -2
- package/dist/engine/index.js +2 -0
- package/dist/engine/project-app-schema-for-roles.js +29 -14
- package/dist/engine/registry-facade.js +7 -8
- package/dist/engine/registry-validate.js +5 -1
- package/dist/engine/soft-delete-cleanup.d.ts +1 -0
- package/dist/engine/soft-delete-cleanup.js +5 -0
- package/dist/engine/steps/describe-workflow-step-error.js +1 -0
- package/dist/es-ops/operations-schema.d.ts +1 -1
- package/dist/event-store/ensure-dead-letter-table.d.ts +2 -0
- package/dist/event-store/ensure-dead-letter-table.js +10 -0
- package/dist/event-store/rebuild-dead-letter.js +2 -8
- package/dist/event-store/upcaster-dead-letter.js +2 -8
- package/dist/files/copy-pending-file-refs-to-tenant.d.ts +28 -0
- package/dist/files/copy-pending-file-refs-to-tenant.js +87 -0
- package/dist/files/file-routes.d.ts +1 -1
- package/dist/files/file-routes.js +21 -6
- package/dist/files/index.d.ts +2 -0
- package/dist/files/index.js +1 -0
- package/dist/i18n/required-surface-keys.js +1 -0
- package/dist/jobs/job-runner-helpers.js +1 -0
- package/dist/jobs/job-runner.js +7 -12
- package/dist/logging/utils.js +30 -60
- package/dist/observability/metrics-handle.js +10 -21
- package/dist/pipeline/cascade-handler.js +7 -6
- package/dist/pipeline/dispatch-query.js +18 -5
- package/dist/pipeline/dispatch-shared.d.ts +1 -0
- package/dist/pipeline/dispatch-shared.js +3 -1
- package/dist/pipeline/dispatch-write.js +10 -12
- package/dist/pipeline/dispatcher.js +12 -14
- package/dist/pipeline/event-dispatcher-admin.js +9 -8
- package/dist/pipeline/event-dispatcher-delivery.d.ts +19 -1
- package/dist/pipeline/event-dispatcher-delivery.js +121 -29
- package/dist/pipeline/event-dispatcher.d.ts +5 -1
- package/dist/pipeline/event-dispatcher.js +28 -21
- package/dist/pipeline/handler-context-phase-denials.js +2 -0
- package/dist/pipeline/multi-stream-apply-context.js +12 -20
- package/dist/pipeline/system-hooks.d.ts +4 -1
- package/dist/pipeline/system-hooks.js +79 -6
- package/dist/pipeline/system-identity-switch.js +10 -7
- package/dist/search/build-search-snippet.d.ts +9 -0
- package/dist/search/build-search-snippet.js +40 -0
- package/dist/search/index.d.ts +1 -0
- package/dist/search/index.js +1 -0
- package/dist/search/meilisearch-adapter.d.ts +32 -0
- package/dist/search/meilisearch-adapter.js +153 -56
- package/dist/search/meilisearch-chunking.d.ts +21 -0
- package/dist/search/meilisearch-chunking.js +96 -0
- package/dist/search/reindex-entity.d.ts +1 -0
- package/dist/search/reindex-entity.js +97 -52
- package/dist/ui-types/index.d.ts +1 -1
- package/dist/upgrade-cli.js +3 -14
- package/package.json +3 -3
- package/src/changes.json +73 -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
|
-
|
|
2
|
-
|
|
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
|
|
24
|
-
`
|
|
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
|
|
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
|
|
93
|
-
`
|
|
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
|
|
102
|
-
`
|
|
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
|
|
14
|
-
|
|
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
|
|
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
|
|
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
|
|
41
|
-
`
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
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
|
|
62
|
-
`the
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
|
150
|
-
`
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
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
|
|
28
|
-
`
|
|
29
|
-
|
|
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
|
|
79
|
-
|
|
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
|
|
115
|
-
|
|
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
|
-
|
|
10
|
-
const
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
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: (
|
|
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 = (
|
|
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;
|
package/dist/engine/factories.js
CHANGED
|
@@ -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
|
|
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
|
-
...
|
|
154
|
+
...expanded,
|
|
154
155
|
}; // @cast-boundary engine-payload
|
|
155
156
|
}
|
|
156
157
|
export function createBooleanField(overrides) {
|
package/dist/engine/index.d.ts
CHANGED
|
@@ -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";
|
package/dist/engine/index.js
CHANGED
|
@@ -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
|
|
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 ||
|
|
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
|
|
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
|
|
503
|
-
const
|
|
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
|
|
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
|
};
|