@cosmicdrift/kumiko-bundled-features 0.15.0 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-bundled-features",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/compliance-profiles/_internal/parse-override.ts

@@ -0,0 +1,19 @@
+import type { ComplianceProfileOverride } from "@cosmicdrift/kumiko-framework/compliance";
+import { parseJsonSafe } from "@cosmicdrift/kumiko-framework/utils";
+
+export function parseComplianceProfileOverride(
+  raw: string | null,
+  tenantId: string,
+  callerLabel: string,
+): ComplianceProfileOverride | undefined {
+  if (!raw || raw.trim() === "") return undefined;
+  const parsed = parseJsonSafe<ComplianceProfileOverride | null>(raw, null);
+  if (parsed === null) {
+    // biome-ignore lint/suspicious/noConsole: operator visibility for DB-corruption edge-case
+    console.warn(
+      `[${callerLabel}] tenant ${tenantId}: stored override is not valid JSON, ignoring.`,
+    );
+    return undefined;
+  }
+  return parsed;
+}

package/src/compliance-profiles/handlers/for-tenant.query.ts

@@ -1,12 +1,12 @@
 import { fetchOne } from "@cosmicdrift/kumiko-framework/bun-db";
 import {
   type ComplianceProfileKey,
-  type ComplianceProfileOverride,
   type EffectiveComplianceProfile,
   resolveComplianceProfile,
 } from "@cosmicdrift/kumiko-framework/compliance";
 import { defineQueryHandler } from "@cosmicdrift/kumiko-framework/engine";
 import { z } from "zod";
+import { parseComplianceProfileOverride } from "../_internal/parse-override";
 import { tenantComplianceProfileTable } from "../schema/profile-selection";
 
 // Liefert das effektive Compliance-Profile fuer den aktuellen Tenant.
@@ -29,33 +29,14 @@ export const forTenantQuery = defineQueryHandler({
       return resolveComplianceProfile({});
     }
 
-    const override = parseOverride(row.override, query.user.tenantId);
+    const override = parseComplianceProfileOverride(
+      row.override,
+      query.user.tenantId,
+      "compliance-profiles:for-tenant",
+    );
     return resolveComplianceProfile({
       selection: row.profileKey as ComplianceProfileKey, // @cast-boundary engine-payload
       override,
     });
   },
 });
-
-function parseOverride(
-  raw: string | null,
-  tenantId: string,
-): ComplianceProfileOverride | undefined {
-  if (!raw || raw.trim() === "") return undefined;
-  try {
-    const parsed: unknown = JSON.parse(raw);
-    return parsed as ComplianceProfileOverride; // @cast-boundary engine-payload
-  } catch (e: unknown) {
-    const reason = e instanceof Error ? e.message : String(e);
-    // Defensiv: ungültiges JSON wird als "kein Override" behandelt. Der
-    // set-profile-Handler validiert Zod das Override schon — invalides
-    // JSON in der DB ist also nur möglich bei manueller DB-Manipulation
-    // oder Migration-Bug. Resolver-Caller darf trotzdem nicht crashen.
-    // Operator-Sichtbarkeit via console.warn — Telemetry-Hook spaeter.
-    // biome-ignore lint/suspicious/noConsole: operator visibility for DB-corruption edge-case
-    console.warn(
-      `[compliance-profiles:for-tenant] tenant ${tenantId}: stored override is not valid JSON, falling back to base profile. Reason: ${reason}`,
-    );
-    return undefined;
-  }
-}

package/src/compliance-profiles/resolve-for-tenant.ts

@@ -11,12 +11,12 @@
 import { fetchOne } from "@cosmicdrift/kumiko-framework/bun-db";
 import {
   type ComplianceProfileKey,
-  type ComplianceProfileOverride,
   type EffectiveComplianceProfile,
   resolveComplianceProfile,
 } from "@cosmicdrift/kumiko-framework/compliance";
 import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
+import { parseComplianceProfileOverride } from "./_internal/parse-override";
 import { tenantComplianceProfileTable } from "./schema/profile-selection";
 
 export interface ResolveProfileForTenantArgs {
@@ -35,27 +35,13 @@ export async function resolveProfileForTenant(
     return resolveComplianceProfile({});
   }
 
-  const override = parseOverride(row.override, args.tenantId);
+  const override = parseComplianceProfileOverride(
+    row.override,
+    args.tenantId,
+    "compliance-profiles:resolve-for-tenant",
+  );
   return resolveComplianceProfile({
     selection: row.profileKey as ComplianceProfileKey, // @cast-boundary engine-payload
     override,
   });
 }
-
-function parseOverride(
-  raw: string | null,
-  tenantId: string,
-): ComplianceProfileOverride | undefined {
-  if (!raw || raw.trim() === "") return undefined;
-  try {
-    const parsed: unknown = JSON.parse(raw);
-    return parsed as ComplianceProfileOverride; // @cast-boundary engine-payload
-  } catch (e: unknown) {
-    const reason = e instanceof Error ? e.message : String(e);
-    // biome-ignore lint/suspicious/noConsole: operator visibility for DB-corruption edge-case
-    console.warn(
-      `[compliance-profiles:resolve-for-tenant] tenant ${tenantId}: stored override is not valid JSON, ignoring. Reason: ${reason}`,
-    );
-    return undefined;
-  }
-}

package/src/delivery/feature.ts

@@ -6,12 +6,19 @@ import { deliveryAttemptSchema } from "./events";
 import { logQuery } from "./handlers/log.query";
 import { preferencesQuery } from "./handlers/preferences.query";
 import { setPreferenceWrite } from "./handlers/set-preference.write";
-import { deliveryAttemptsTable, notificationPreferenceEntity } from "./tables";
+import {
+  deliveryAttemptsTable,
+  deliveryAttemptsTableMeta,
+  notificationPreferenceEntity,
+} from "./tables";
 
 export function createDeliveryFeature(): FeatureDefinition {
   return defineFeature("delivery", (r) => {
     r.systemScope();
     r.entity("notification-preference", notificationPreferenceEntity);
+    r.unmanagedTable(deliveryAttemptsTableMeta, {
+      reason: "read_side.delivery_attempt_log",
+    });
 
     // Events-only projection source: "deliveryAttempt" is the aggregate-
     // type on the events-table, but there's no r.entity for it — each

package/src/jobs/feature.ts

@@ -19,11 +19,14 @@ import {
   JOB_RUN_FAILED_EVENT,
   JOB_RUN_STARTED_EVENT,
 } from "./job-run-logger";
-import { jobRunLogsTable, jobRunsTable } from "./job-run-table";
+import { jobRunLogsTable, jobRunLogsTableMeta, jobRunsTable } from "./job-run-table";
 
 export function createJobsFeature(): FeatureDefinition {
   return defineFeature("jobs", (r) => {
     r.systemScope();
+    r.unmanagedTable(jobRunLogsTableMeta, {
+      reason: "read_side.job_run_logs",
+    });
     // Events-only aggregate: "jobRun" has no r.entity registration, because
     // the entire lifecycle is driven by BullMQ-callback → r.defineEvent
     // (no executor, no CRUD). The boot-validator accepts the two