@cosmicdrift/kumiko-samples 0.367.0 → 0.368.0

package/samples/recipes/ledger-banking/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/ledger-invoicing/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/legal-pages/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/lifecycle-hooks/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/managed-config/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/managed-pages/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/notes-history-basic/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/ownership/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/pdf-audit-export/package.json

@@ -7,6 +7,7 @@
     "@cosmicdrift/kumiko-framework": "workspace:*"
   },
   "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*",
     "unpdf": "^1.8.1"
   }
 }

package/samples/recipes/pipeline-basics/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/public-share-token/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/public-share-token/src/feature.ts

@@ -6,7 +6,7 @@
 // A full consumer adds domain snapshots, layouts and tier gates on top.
 
 import { generateToken } from "@cosmicdrift/kumiko-framework/api";
-import { fetchOne } from "@cosmicdrift/kumiko-framework/bun-db";
+import { fetchOne } from "@cosmicdrift/kumiko-framework/db";
 import {
   createEntity,
   createEntityExecutor,

package/samples/recipes/rate-limiting/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/realtime-sse/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/record-detail-layout/package.json

@@ -14,6 +14,7 @@
   },
   "devDependencies": {
     "@cosmicdrift/kumiko-server-runtime": "workspace:*",
+    "@cosmicdrift/kumiko-testing": "workspace:*",
     "@playwright/test": "^1.62.1",
     "@tailwindcss/cli": "^4.3.0",
     "@types/react": "^19.2.14",

package/samples/recipes/reference-data/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/relations/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/screens-nav/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/search/package.json

@@ -4,5 +4,8 @@
   "private": true,
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/secrets-demo/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/security-baseline/src/feature.ts

@@ -3,7 +3,7 @@
 // rate-limiting, audit) and how it silences the NODE_ENV=production boot
 // warning that fires when one of those four is missing.
 
-import { authFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
+import { createAuthFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
 import { createConfigFeature } from "@cosmicdrift/kumiko-bundled-features/config";
 import { securityBaselineFeatures } from "@cosmicdrift/kumiko-bundled-features/presets";
 import { createTenantFeature } from "@cosmicdrift/kumiko-bundled-features/tenant";
@@ -14,6 +14,6 @@ export const APP_FEATURES: FeatureDefinition[] = [
   createConfigFeature(),
   createUserFeature(),
   createTenantFeature(),
-  authFoundationFeature,
+  createAuthFoundationFeature(),
   ...securityBaselineFeatures(),
 ];

package/samples/recipes/session-revocation/README.md

@@ -15,7 +15,7 @@ The production wiring shape: an app builds `createSessionCallbacks()` against a
 ## What to copy into your app
 
 ```ts illustration
-const db = createDbConnection(config.databaseUrl);
+const db = createDbConnection({ url: config.databaseUrl });
 const callbacks = createSessionCallbacks({ db });
 
 const server = buildServer({

package/samples/recipes/session-revocation/package.json

@@ -5,5 +5,8 @@
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/session-revocation/src/feature.ts

@@ -8,7 +8,7 @@
 //
 // What to copy into your own app:
 //
-//   const db = createDbConnection(config.databaseUrl);
+//   const db = createDbConnection({ url: config.databaseUrl });
 //   const callbacks = createSessionCallbacks({ db });
 //   const server = buildServer({
 //     registry: buildRegistry([

package/samples/recipes/state-machine/package.json

@@ -3,7 +3,9 @@
   "description": "Enforced entity state transitions. No more illegal state changes.",
   "private": true,
   "dependencies": {
-    "@app/define": "file:./.kumiko",
     "@cosmicdrift/kumiko-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/recipes/state-machine/src/entities/invoice.ts

@@ -1,11 +1,11 @@
+import { buildEntityTable } from "@cosmicdrift/kumiko-framework/db";
 import {
   createEntity,
   createMoneyField,
   createSelectField,
   createTextField,
   defineTransitions,
-} from "@app/define";
-import { buildEntityTable } from "@cosmicdrift/kumiko-framework/db";
+} from "@cosmicdrift/kumiko-framework/engine";
 
 export const INVOICE_STATES = ["draft", "sent", "paid", "cancelled"] as const;
 

package/samples/recipes/state-machine/src/events.ts

@@ -3,6 +3,9 @@
 // strings, so a rename here propagates everywhere instead of silently
 // breaking the reducer.
 
+import type { EventDef } from "@cosmicdrift/kumiko-framework/engine";
+import { z } from "zod";
+
 export const FEATURE_NAME = "billing";
 export const ENTITY_NAME = "invoice";
 
@@ -30,3 +33,19 @@ export function eventName<const TShort extends string>(
 // The auto-generated event the executor emits on create — entity name dot
 // "created", no feature prefix (executor convention).
 export const INVOICE_CREATED_EVENT = `${ENTITY_NAME}.created` as const;
+
+export const emptyEventPayload = z.object({});
+export const statusForcedPayload = z.object({
+  newStatus: z.enum(["draft", "sent", "paid", "cancelled"]),
+  fromStatus: z.enum(["draft", "sent", "paid", "cancelled"]),
+});
+
+// The EventDefs r.defineEvent returns inside the feature setup. Handlers receive them so that
+// emitEvent checks each payload against the event's own schema.
+export type InvoiceEvents = {
+  readonly sent: EventDef<z.infer<typeof emptyEventPayload>>;
+  readonly markedPaid: EventDef<z.infer<typeof emptyEventPayload>>;
+  readonly cancelled: EventDef<z.infer<typeof emptyEventPayload>>;
+  readonly reopened: EventDef<z.infer<typeof emptyEventPayload>>;
+  readonly statusForced: EventDef<z.infer<typeof statusForcedPayload>>;
+};

package/samples/recipes/state-machine/src/feature.ts

@@ -21,20 +21,17 @@
 //   handlers/create.ts        — invoice:create (uses executor)
 //   handlers/transitions.ts   — the six state-change handlers
 
-import { defineFeature, setFields } from "@app/define";
-import { z } from "zod";
+import { defineFeature, setFields, typedPayload } from "@cosmicdrift/kumiko-framework/engine";
 import { invoiceEntity, invoiceTable } from "./entities/invoice";
-import { eventName, INVOICE_EVENTS } from "./events";
-import { invoiceCreate } from "./handlers/create";
 import {
-  invoiceCancel,
-  invoiceForceStatus,
-  invoiceMarkPaid,
-  invoiceReopen,
-  invoiceSend,
-  invoiceUpdateStatus,
-} from "./handlers/transitions";
-import type { InvoiceStatus } from "./reducer";
+  emptyEventPayload,
+  eventName,
+  INVOICE_EVENTS,
+  type InvoiceEvents,
+  statusForcedPayload,
+} from "./events";
+import { invoiceCreate } from "./handlers/create";
+import { createInvoiceTransitionHandlers } from "./handlers/transitions";
 
 export { invoiceEntity } from "./entities/invoice";
 
@@ -45,18 +42,15 @@ export const stateMachineFeature = defineFeature("billing", (r) => {
   // and the projection stay in sync. The auto "invoice.created" event from
   // the executor's create-path covers the initial insert, so we only declare
   // the state-change events here.
-  r.defineEvent(INVOICE_EVENTS.sent, z.object({}), { piiFields: "none" });
-  r.defineEvent(INVOICE_EVENTS.markedPaid, z.object({}), { piiFields: "none" });
-  r.defineEvent(INVOICE_EVENTS.cancelled, z.object({}), { piiFields: "none" });
-  r.defineEvent(INVOICE_EVENTS.reopened, z.object({}), { piiFields: "none" });
-  r.defineEvent(
-    INVOICE_EVENTS.statusForced,
-    z.object({
-      newStatus: z.enum(["draft", "sent", "paid", "cancelled"]),
-      fromStatus: z.enum(["draft", "sent", "paid", "cancelled"]),
+  const events: InvoiceEvents = {
+    sent: r.defineEvent(INVOICE_EVENTS.sent, emptyEventPayload, { piiFields: "none" }),
+    markedPaid: r.defineEvent(INVOICE_EVENTS.markedPaid, emptyEventPayload, { piiFields: "none" }),
+    cancelled: r.defineEvent(INVOICE_EVENTS.cancelled, emptyEventPayload, { piiFields: "none" }),
+    reopened: r.defineEvent(INVOICE_EVENTS.reopened, emptyEventPayload, { piiFields: "none" }),
+    statusForced: r.defineEvent(INVOICE_EVENTS.statusForced, statusForcedPayload, {
+      piiFields: "none",
     }),
-    { piiFields: "none" },
-  );
+  };
 
   // The aggregate table (sample_sm_invoices) is INSERTed by the executor on
   // invoice:create. State-change events update the same row via this inline
@@ -74,16 +68,17 @@ export const stateMachineFeature = defineFeature("billing", (r) => {
       [eventName(INVOICE_EVENTS.cancelled)]: setFields(invoiceTable, { status: "cancelled" }),
       [eventName(INVOICE_EVENTS.reopened)]: setFields(invoiceTable, { status: "draft" }),
       [eventName(INVOICE_EVENTS.statusForced)]: setFields(invoiceTable, (e) => ({
-        status: (e.payload as { newStatus: InvoiceStatus }).newStatus,
+        status: typedPayload(e, events.statusForced).newStatus,
       })),
     },
   });
 
+  const transitions = createInvoiceTransitionHandlers(events);
   r.writeHandler(invoiceCreate);
-  r.writeHandler(invoiceSend);
-  r.writeHandler(invoiceMarkPaid);
-  r.writeHandler(invoiceCancel);
-  r.writeHandler(invoiceReopen);
-  r.writeHandler(invoiceUpdateStatus);
-  r.writeHandler(invoiceForceStatus);
+  r.writeHandler(transitions.invoiceSend);
+  r.writeHandler(transitions.invoiceMarkPaid);
+  r.writeHandler(transitions.invoiceCancel);
+  r.writeHandler(transitions.invoiceReopen);
+  r.writeHandler(transitions.invoiceUpdateStatus);
+  r.writeHandler(transitions.invoiceForceStatus);
 });

package/samples/recipes/state-machine/src/handlers/_helpers.ts

@@ -2,25 +2,25 @@
 // optionally guardTransition, append the domain event, return a WriteResult
 // that reflects the post-write status.
 
-import type { AccessRule, KumikoEventTypeMap } from "@app/define";
-import { defineWriteHandler, guardTransition } from "@app/define";
+import {
+  type AccessRule,
+  defineWriteHandler,
+  type EventDef,
+  emitEvent,
+  guardTransition,
+} from "@cosmicdrift/kumiko-framework/engine";
 import { failNotFound } from "@cosmicdrift/kumiko-framework/errors";
 import { z } from "zod";
 import { INVOICE_TRANSITIONS } from "../entities/invoice";
-import { ENTITY_NAME } from "../events";
+import { ENTITY_NAME, type emptyEventPayload } from "../events";
 import { type InvoiceStatus, loadInvoiceState } from "../reducer";
 
-// Narrow TEvent to event-types whose payload is `{}` — this helper
-// always emits an empty payload. Anyone trying to use it with a non-
-// empty-payload event-type gets caught at the call-site, not at runtime.
-type EmptyPayloadEvent = {
-  [K in keyof KumikoEventTypeMap]: KumikoEventTypeMap[K] extends Record<string, never> ? K : never;
-}[keyof KumikoEventTypeMap];
-
-export function transitionHandler<const TEvent extends EmptyPayloadEvent>(opts: {
+// The event carries an empty payload — this helper always emits `{}`, so an EventDef with a
+// non-empty payload is a compile error at the call site.
+export function transitionHandler(opts: {
   name: string;
   toStatus: InvoiceStatus;
-  eventType: TEvent;
+  event: EventDef<z.infer<typeof emptyEventPayload>>;
   access: AccessRule;
   skipGuard?: boolean;
 }) {
@@ -41,10 +41,9 @@ export function transitionHandler<const TEvent extends EmptyPayloadEvent>(opts:
         guardTransition(INVOICE_TRANSITIONS, state.status as InvoiceStatus, opts.toStatus);
       }
 
-      await ctx.appendEvent({
+      await emitEvent(ctx, opts.event, {
         aggregateId: event.payload.id,
         aggregateType: ENTITY_NAME,
-        type: opts.eventType,
         payload: {},
       });
 

package/samples/recipes/state-machine/src/handlers/create.ts

@@ -6,8 +6,8 @@
 // keeps amount + amountCurrency flat, while the entity stores them as a
 // money pair.
 
-import { defineWriteHandler } from "@app/define";
 import { createEventStoreExecutor } from "@cosmicdrift/kumiko-framework/db";
+import { defineWriteHandler } from "@cosmicdrift/kumiko-framework/engine";
 import { z } from "zod";
 import { invoiceEntity, invoiceTable } from "../entities/invoice";