@cosmicdrift/kumiko-framework 0.386.0 → 0.388.0

package/dist/i18n/required-surface-keys.js

@@ -35,8 +35,8 @@ function isI18nKey(value) {
 /**
  * `treatAsKey` bypasses the colon-only `isI18nKey` check — used by the Settings-Hub
  * generator's dot-form labels (`${feature}.settings`, mask titles), which are
- * always i18n references by construction, never literal display text (fw#2260).
- * `isI18nKey` itself also accepts dot-form labels explicitly marked via `i18nKey()` (fw#2313).
+ * always i18n references by construction, never literal display text.
+ * `isI18nKey` itself also accepts dot-form labels explicitly marked via `i18nKey()`.
  */
 function pushKey(out, value, treatAsKey = false) {
     if (value !== undefined && (treatAsKey || isI18nKey(value)))
@@ -112,7 +112,7 @@ function pushDashboardScreenKeys(out, dashboard) {
         pushRowActionKeys(out, action);
 }
 function pushDashboardPanelKeys(out, panel) {
-    // skip: custom-Panel übersetzt sich selbst, kein Key hier
+    // skip: custom panels translate themselves, so no key is collected here
     if (panel.kind === "custom")
         return;
     pushKey(out, panel.label);
@@ -221,221 +221,198 @@ function pushExpandableRowKeys(out, section) {
         pushRowActionKeys(out, section.emptyState.action);
     }
 }
-export function requiredKeysFromScreen(featureName, screen, options = {}) {
-    const { treatDotFormAsKey = false } = options;
-    const out = new Set();
-    pushKey(out, screenTitleKey(screen.id));
-    switch (screen.type) {
-        case "entityList": {
-            const list = screen;
-            for (const col of list.columns) {
-                const normalized = normalizeListColumn(col);
-                if (normalized.label !== undefined) {
-                    pushKey(out, normalized.label);
-                }
-                else {
-                    out.add(fieldLabelKey(featureName, list.entity, normalized.field));
-                }
-            }
-            pushKey(out, list.createLabel);
-            pushKey(out, list.searchPlaceholder);
-            pushKey(out, list.description);
-            pushListEmptyStateKeys(out, list.emptyState);
-            for (const action of list.rowActions ?? [])
-                pushRowActionKeys(out, action);
-            for (const action of list.toolbarActions ?? [])
-                pushToolbarActionKeys(out, action);
-            if (list.expandableRow !== undefined)
-                pushExpandableRowKeys(out, list.expandableRow);
-            break;
+function pushFieldLabelOrOverrideKey(ctx, labelEntity, fieldName, fieldLabels, treatAsKey = false) {
+    const override = fieldLabels?.[fieldName];
+    if (override !== undefined)
+        pushKey(ctx.out, override, treatAsKey);
+    else
+        ctx.out.add(fieldLabelKey(ctx.featureName, labelEntity, fieldName));
+}
+function pushListChromeKeys(out, list) {
+    pushKey(out, list.createLabel);
+    pushKey(out, list.searchPlaceholder);
+    pushKey(out, list.description);
+    pushListEmptyStateKeys(out, list.emptyState);
+    for (const action of list.rowActions ?? [])
+        pushRowActionKeys(out, action);
+    for (const action of list.toolbarActions ?? [])
+        pushToolbarActionKeys(out, action);
+}
+function collectEntityListKeys(ctx, list) {
+    for (const col of list.columns) {
+        const normalized = normalizeListColumn(col);
+        if (normalized.label !== undefined) {
+            pushKey(ctx.out, normalized.label);
         }
-        case "projectionList": {
-            const list = screen;
-            // Keine Entity → keine field-label-Fallbacks; nur explizite Column-Labels.
-            for (const col of list.columns) {
-                const normalized = normalizeListColumn(col);
-                if (normalized.label !== undefined)
-                    pushKey(out, normalized.label);
-            }
-            pushKey(out, list.createLabel);
-            pushKey(out, list.searchPlaceholder);
-            pushKey(out, list.description);
-            pushListEmptyStateKeys(out, list.emptyState);
-            for (const action of list.rowActions ?? [])
-                pushRowActionKeys(out, action);
-            for (const action of list.toolbarActions ?? [])
-                pushToolbarActionKeys(out, action);
-            break;
+        else {
+            ctx.out.add(fieldLabelKey(ctx.featureName, list.entity, normalized.field));
         }
-        case "dashboard": {
-            pushDashboardScreenKeys(out, screen);
-            break;
+    }
+    pushListChromeKeys(ctx.out, list);
+    if (list.expandableRow !== undefined)
+        pushExpandableRowKeys(ctx.out, list.expandableRow);
+}
+function collectProjectionListKeys(ctx, list) {
+    // No entity means there are no field-label fallbacks; only explicit column labels are
+    // collected.
+    for (const col of list.columns) {
+        const normalized = normalizeListColumn(col);
+        if (normalized.label !== undefined)
+            pushKey(ctx.out, normalized.label);
+    }
+    pushListChromeKeys(ctx.out, list);
+}
+function pushEditLayoutSectionKeys(ctx, sections, labelEntity, fieldLabels) {
+    for (const section of sections) {
+        if (isExtensionEditSection(section)) {
+            pushKey(ctx.out, section.title);
+            continue;
         }
-        case "entityEdit": {
-            const edit = screen;
-            pushKey(out, edit.submitLabel);
-            pushKey(out, edit.titleTemplate);
-            for (const section of edit.layout.sections) {
-                if (isExtensionEditSection(section)) {
-                    pushKey(out, section.title);
-                    continue;
-                }
-                if (section.kind === "relatedList")
-                    continue; // rejected at boot, unreachable here
-                pushSectionTitles(out, section);
-                for (const f of sectionFieldSpecs(section)) {
-                    pushEditFieldTextKeys(out, f);
-                    const fieldName = editFieldName(f);
-                    const override = edit.fieldLabels?.[fieldName];
-                    if (override !== undefined)
-                        pushKey(out, override);
-                    else
-                        out.add(fieldLabelKey(featureName, edit.entity, fieldName));
-                }
-            }
-            break;
+        if (section.kind === "relatedList")
+            continue; // rejected at boot, unreachable here
+        pushSectionTitles(ctx.out, section);
+        for (const f of sectionFieldSpecs(section)) {
+            pushEditFieldTextKeys(ctx.out, f);
+            pushFieldLabelOrOverrideKey(ctx, labelEntity, editFieldName(f), fieldLabels);
         }
-        case "actionForm": {
-            const form = screen;
-            pushKey(out, form.submitLabel);
-            pushKey(out, form.summary?.title);
-            pushKey(out, form.summary?.subtitle);
-            for (const action of form.footerActions ?? [])
-                pushKey(out, action.label);
-            for (const link of form.successLinks ?? [])
-                pushKey(out, link.label);
-            for (const fact of form.successFacts ?? [])
-                pushKey(out, fact.label);
-            for (const fieldName of Object.keys(form.fields)) {
-                const override = form.fieldLabels?.[fieldName];
-                if (override !== undefined)
-                    pushKey(out, override);
-                else
-                    out.add(fieldLabelKey(featureName, ACTION_FORM_ENTITY, fieldName));
-            }
-            for (const section of form.layout.sections) {
-                if (isExtensionEditSection(section)) {
-                    pushKey(out, section.title);
-                    continue;
-                }
-                if (section.kind === "relatedList")
-                    continue; // rejected at boot, unreachable here
-                pushSectionTitles(out, section);
-                for (const f of sectionFieldSpecs(section)) {
-                    pushEditFieldTextKeys(out, f);
-                    const fieldName = editFieldName(f);
-                    const override = form.fieldLabels?.[fieldName];
-                    if (override !== undefined)
-                        pushKey(out, override);
-                    else
-                        out.add(fieldLabelKey(featureName, ACTION_FORM_ENTITY, fieldName));
-                }
-            }
-            break;
+    }
+}
+function collectEntityEditKeys(ctx, edit) {
+    pushKey(ctx.out, edit.submitLabel);
+    pushKey(ctx.out, edit.titleTemplate);
+    pushEditLayoutSectionKeys(ctx, edit.layout.sections, edit.entity, edit.fieldLabels);
+}
+function collectActionFormKeys(ctx, form) {
+    pushKey(ctx.out, form.submitLabel);
+    pushKey(ctx.out, form.summary?.title);
+    pushKey(ctx.out, form.summary?.subtitle);
+    for (const action of form.footerActions ?? [])
+        pushKey(ctx.out, action.label);
+    for (const link of form.successLinks ?? [])
+        pushKey(ctx.out, link.label);
+    for (const fact of form.successFacts ?? [])
+        pushKey(ctx.out, fact.label);
+    for (const fieldName of Object.keys(form.fields)) {
+        pushFieldLabelOrOverrideKey(ctx, ACTION_FORM_ENTITY, fieldName, form.fieldLabels);
+    }
+    pushEditLayoutSectionKeys(ctx, form.layout.sections, ACTION_FORM_ENTITY, form.fieldLabels);
+}
+function collectSecretMintKeys(ctx, mint) {
+    const { out, featureName } = ctx;
+    pushKey(out, mint.submitLabel);
+    pushActionFormShapedKeys(out, featureName, mint);
+    pushKey(out, mint.reveal.title);
+    pushKey(out, mint.reveal.warning);
+    pushKey(out, mint.reveal.confirmLabel);
+    pushKey(out, mint.reveal.acknowledge);
+    for (const revealField of mint.reveal.fields) {
+        pushKey(out, revealField.label);
+    }
+    if (mint.confirm !== undefined) {
+        pushKey(out, mint.confirm.submitLabel);
+        pushKey(out, mint.confirm.doneMessage);
+        pushActionFormShapedKeys(out, featureName, mint.confirm);
+    }
+}
+function pushConfigEditSectionKeys(ctx, config) {
+    const { out, treatDotFormAsKey } = ctx;
+    for (const section of config.layout.sections) {
+        if (isExtensionEditSection(section)) {
+            pushKey(out, section.title);
+            continue;
         }
-        case "secretMint": {
-            const mint = screen;
-            pushKey(out, mint.submitLabel);
-            pushActionFormShapedKeys(out, featureName, mint);
-            pushKey(out, mint.reveal.title);
-            pushKey(out, mint.reveal.warning);
-            pushKey(out, mint.reveal.confirmLabel);
-            pushKey(out, mint.reveal.acknowledge);
-            for (const revealField of mint.reveal.fields) {
-                pushKey(out, revealField.label);
-            }
-            if (mint.confirm !== undefined) {
-                pushKey(out, mint.confirm.submitLabel);
-                pushKey(out, mint.confirm.doneMessage);
-                pushActionFormShapedKeys(out, featureName, mint.confirm);
-            }
-            break;
+        if (section.kind === "relatedList")
+            continue; // rejected at boot, unreachable here
+        pushSectionTitles(out, section, treatDotFormAsKey);
+        pushKey(out, section.description, treatDotFormAsKey);
+        for (const f of sectionFieldSpecs(section)) {
+            pushEditFieldTextKeys(out, f, treatDotFormAsKey);
+            pushFieldLabelOrOverrideKey(ctx, CONFIG_EDIT_ENTITY, editFieldName(f), config.fieldLabels, treatDotFormAsKey);
         }
-        case "configEdit": {
-            const config = screen;
-            pushKey(out, config.submitLabel);
-            pushKey(out, config.description, treatDotFormAsKey);
-            for (const key of Object.values(config.fieldDescriptions ?? {})) {
-                pushKey(out, key, treatDotFormAsKey);
-            }
-            for (const fieldName of Object.keys(config.fields)) {
-                const override = config.fieldLabels?.[fieldName];
-                if (override !== undefined)
-                    pushKey(out, override, treatDotFormAsKey);
-                else
-                    out.add(fieldLabelKey(featureName, CONFIG_EDIT_ENTITY, fieldName));
-            }
-            for (const section of config.layout.sections) {
-                if (isExtensionEditSection(section)) {
-                    pushKey(out, section.title);
-                    continue;
-                }
-                if (section.kind === "relatedList")
-                    continue; // rejected at boot, unreachable here
-                pushSectionTitles(out, section, treatDotFormAsKey);
-                pushKey(out, section.description, treatDotFormAsKey);
-                for (const f of sectionFieldSpecs(section)) {
-                    pushEditFieldTextKeys(out, f, treatDotFormAsKey);
-                    const fieldName = editFieldName(f);
-                    const override = config.fieldLabels?.[fieldName];
-                    if (override !== undefined)
-                        pushKey(out, override, treatDotFormAsKey);
-                    else
-                        out.add(fieldLabelKey(featureName, CONFIG_EDIT_ENTITY, fieldName));
-                }
-            }
-            break;
+    }
+}
+function collectConfigEditKeys(ctx, config) {
+    const { out, treatDotFormAsKey } = ctx;
+    pushKey(out, config.submitLabel);
+    pushKey(out, config.description, treatDotFormAsKey);
+    for (const key of Object.values(config.fieldDescriptions ?? {})) {
+        pushKey(out, key, treatDotFormAsKey);
+    }
+    for (const fieldName of Object.keys(config.fields)) {
+        pushFieldLabelOrOverrideKey(ctx, CONFIG_EDIT_ENTITY, fieldName, config.fieldLabels, treatDotFormAsKey);
+    }
+    pushConfigEditSectionKeys(ctx, config);
+}
+function collectSecretsEditKeys(ctx, secretsEdit) {
+    const { out, treatDotFormAsKey } = ctx;
+    for (const key of Object.values(secretsEdit.fieldLabels))
+        pushKey(out, key, treatDotFormAsKey);
+    for (const key of Object.values(secretsEdit.fieldHints ?? {})) {
+        pushKey(out, key, treatDotFormAsKey);
+    }
+    for (const section of secretsEdit.sections)
+        pushKey(out, section.title, treatDotFormAsKey);
+}
+function pushWriteFormSectionKeys(ctx, section) {
+    pushKey(ctx.out, section.title);
+    pushKey(ctx.out, section.description);
+    pushKey(ctx.out, section.submitLabel);
+    for (const f of section.fields) {
+        pushEditFieldTextKeys(ctx.out, f);
+        ctx.out.add(fieldLabelKey(ctx.featureName, WRITE_FORM_SECTION_ENTITY, editFieldName(f)));
+    }
+}
+function collectProjectionDetailKeys(ctx, detail) {
+    for (const metric of detail.metrics ?? [])
+        pushKey(ctx.out, metric.label);
+    for (const section of detail.layout.sections) {
+        if (isExtensionEditSection(section)) {
+            pushKey(ctx.out, section.title);
+            continue;
         }
-        case "secretsEdit": {
-            const secretsEdit = screen;
-            for (const key of Object.values(secretsEdit.fieldLabels))
-                pushKey(out, key, treatDotFormAsKey);
-            for (const key of Object.values(secretsEdit.fieldHints ?? {})) {
-                pushKey(out, key, treatDotFormAsKey);
-            }
-            for (const section of secretsEdit.sections)
-                pushKey(out, section.title, treatDotFormAsKey);
-            break;
+        if (section.kind === "relatedList") {
+            pushRelatedListSectionKeys(ctx.out, section);
+            continue;
         }
-        case "projectionDetail": {
-            const detail = screen;
-            for (const section of detail.layout.sections) {
-                if (isExtensionEditSection(section)) {
-                    pushKey(out, section.title);
-                    continue;
-                }
-                if (section.kind === "relatedList") {
-                    pushRelatedListSectionKeys(out, section);
-                    continue;
-                }
-                if (isWriteFormEditSection(section)) {
-                    pushKey(out, section.title);
-                    pushKey(out, section.description);
-                    pushKey(out, section.submitLabel);
-                    for (const f of section.fields) {
-                        pushEditFieldTextKeys(out, f);
-                        const fieldName = editFieldName(f);
-                        out.add(fieldLabelKey(featureName, WRITE_FORM_SECTION_ENTITY, fieldName));
-                    }
-                    continue;
-                }
-                pushSectionTitles(out, section);
-                for (const f of sectionFieldSpecs(section)) {
-                    pushEditFieldTextKeys(out, f);
-                    const fieldName = editFieldName(f);
-                    const override = detail.fieldLabels?.[fieldName];
-                    if (override !== undefined)
-                        pushKey(out, override);
-                    else
-                        out.add(fieldLabelKey(featureName, PROJECTION_DETAIL_ENTITY, fieldName));
-                }
-            }
-            break;
+        if (isWriteFormEditSection(section)) {
+            pushWriteFormSectionKeys(ctx, section);
+            continue;
+        }
+        pushSectionTitles(ctx.out, section);
+        for (const f of sectionFieldSpecs(section)) {
+            pushEditFieldTextKeys(ctx.out, f);
+            pushFieldLabelOrOverrideKey(ctx, PROJECTION_DETAIL_ENTITY, editFieldName(f), detail.fieldLabels);
         }
-        case "custom":
-            break;
     }
-    return [...out];
+}
+const SCREEN_KEY_COLLECTORS = {
+    entityList: collectEntityListKeys,
+    projectionList: collectProjectionListKeys,
+    entityEdit: collectEntityEditKeys,
+    actionForm: collectActionFormKeys,
+    secretMint: collectSecretMintKeys,
+    configEdit: collectConfigEditKeys,
+    secretsEdit: collectSecretsEditKeys,
+    projectionDetail: collectProjectionDetailKeys,
+    dashboard: (ctx, screen) => pushDashboardScreenKeys(ctx.out, screen),
+    // Custom screens translate their own texts.
+    custom: () => { },
+};
+function collectScreenKeysOfKind(ctx, kind, screen) {
+    SCREEN_KEY_COLLECTORS[kind](ctx, screen);
+}
+export function requiredKeysFromScreen(featureName, screen, options = {}) {
+    const ctx = {
+        out: new Set(),
+        featureName,
+        treatDotFormAsKey: options.treatDotFormAsKey ?? false,
+    };
+    pushKey(ctx.out, screenTitleKey(screen.id));
+    // An unknown type is only reachable by casting past ScreenDefinition and yields the title key alone.
+    if (Object.hasOwn(SCREEN_KEY_COLLECTORS, screen.type)) {
+        collectScreenKeysOfKind(ctx, screen.type, screen);
+    }
+    return [...ctx.out];
 }
 export function requiredKeysFromNav(nav, options = {}) {
     const out = new Set();
@@ -454,9 +431,8 @@ function collectEntityListFilterKeys(feature, out) {
         const entity = feature.entities?.[screen.entity];
         if (!entity)
             continue;
-        for (const [fieldName, rawDef] of Object.entries(entity.fields)) {
-            const def = rawDef;
-            if (def.filterable !== true)
+        for (const [fieldName, def] of Object.entries(entity.fields)) {
+            if (!("filterable" in def) || def.filterable !== true)
                 continue;
             if (def.type === "boolean") {
                 for (const key of booleanFacetOptionKeys(feature.name, screen.entity, fieldName)) {
@@ -513,7 +489,7 @@ export function buildEffectiveTranslationKeys(features) {
         for (const key of Object.keys(feature.translations ?? {})) {
             out.add(`${feature.name}:${key}`);
             // Blank form too — Settings-Hub group namespaces (`group: "tenant-settings"`)
-            // require `${group}.settings` which is not `${feature}:${key}` (fw#2314).
+            // require `${group}.settings` which is not `${feature}:${key}`.
             out.add(key);
         }
     }

package/dist/internal/stack-support.d.ts

@@ -1,6 +1,7 @@
+export { isClosedConnectionError } from "../db/closed-connection.ts";
 export { createDbConnection } from "../db/connection.ts";
 export { acquireSessionAdvisoryLock, createDatabase, databaseExists, dropDatabaseIfExists, listDatabaseNamesWithPrefix, renameDatabase, truncateTablesRestartIdentity, } from "../db/queries/test-stack.ts";
-export { type AnyDb, isClosedConnectionError } from "../db/query.ts";
+export type { AnyDb } from "../db/query.ts";
 export { columnNamesOf } from "../db/schema-inspection.ts";
 export { schemaTableName } from "../db/table-introspection.ts";
 export { addMissingColumns, addMissingIndexes, tableToMeta, unsafeCreateEntityTable, unsafeEnsureEntityTable, unsafePushTables, } from "../db/table-push.ts";

package/dist/internal/stack-support.js

@@ -1,7 +1,7 @@
 // @runtime dev
+export { isClosedConnectionError } from "../db/closed-connection.js";
 export { createDbConnection } from "../db/connection.js";
 export { acquireSessionAdvisoryLock, createDatabase, databaseExists, dropDatabaseIfExists, listDatabaseNamesWithPrefix, renameDatabase, truncateTablesRestartIdentity, } from "../db/queries/test-stack.js";
-export { isClosedConnectionError } from "../db/query.js";
 export { columnNamesOf } from "../db/schema-inspection.js";
 export { schemaTableName } from "../db/table-introspection.js";
 export { addMissingColumns, addMissingIndexes, tableToMeta, unsafeCreateEntityTable, unsafeEnsureEntityTable, unsafePushTables, } from "../db/table-push.js";

package/dist/jobs/job-runner-context.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="temporal-polyfill/global" preserve="true" />
+import type { ConfigAccessor } from "@cosmicdrift/kumiko-types/config";
+import type { WriteOrigin } from "@cosmicdrift/kumiko-types/event-store-types";
+import type { DbRow } from "../db/connection.ts";
+import type { JobContext, JobDefinition } from "../engine/types/index.ts";
+import type { JobRunnerScope } from "./job-runner-scope.ts";
+import type { JobInvocation, JobLogEntry, JobMeta } from "./job-runner-types.ts";
+export type TenantVisibleSubjects = {
+    readonly failureSubject: string | null;
+    readonly runSubject: string | null;
+    readonly configError: Error | undefined;
+};
+export type JobRun = {
+    readonly jobName: string;
+    readonly jobDef: JobDefinition;
+    readonly jobId: string;
+    readonly startTime: number;
+    readonly logs: JobLogEntry[];
+    readonly rawData: DbRow;
+    readonly attempt: number;
+    readonly finalAttempt: boolean;
+    readonly meta: JobMeta;
+    readonly payload: Record<string, unknown>;
+    readonly tenantId: string;
+    readonly triggeredById: string | null;
+    readonly subjects: TenantVisibleSubjects;
+    readonly writeOrigin: WriteOrigin | undefined;
+    readonly writeOriginInvalid: boolean;
+    readonly config: ConfigAccessor | undefined;
+    readonly jobContext: Omit<JobContext, "tz">;
+};
+export declare function prepareJobRun(scope: JobRunnerScope, jobDef: JobDefinition, bullJob: JobInvocation, token: string | undefined): JobRun;