@cosmicdrift/kumiko-samples 0.371.1 → 0.372.0

package/samples/apps/ui-walkthrough/src/features/rental/screens.ts

@@ -178,6 +178,7 @@ export const leaseDetailScreen: ProjectionDetailScreenDefinition = {
     einheit: "rental:entity:lease:field:einheit",
     liegenschaft: "rental:entity:lease:field:liegenschaft",
     ende: "rental:entity:lease:field:ende",
+    vorgaenger: "rental:entity:lease:field:vorgaenger",
     kontostand: "rental:entity:lease:field:kontostand",
     notizen: "rental:entity:lease:field:notizen",
   },
@@ -268,7 +269,13 @@ export const leaseDetailScreen: ProjectionDetailScreenDefinition = {
         kind: "fields",
         title: "rental.tab.contractData",
         columns: 2,
-        fields: ["einheit", "liegenschaft", "beginn", "ende"],
+        fields: [
+          "einheit",
+          "liegenschaft",
+          "beginn",
+          "ende",
+          { field: "vorgaenger", refEntity: "lease", refLabelField: "einheit" },
+        ],
       },
       {
         id: "notes",
@@ -497,3 +504,17 @@ export const leaseListEmptyScreen: EntityListScreenDefinition = {
   rowActions: [openLeaseDetail],
   access: OPEN_ACCESS,
 };
+
+// Reference column next to empty plain cells: the predecessor links to its
+// lease, a lease without one shows the empty-value placeholder.
+export const leaseSuccessionListScreen: EntityListScreenDefinition = {
+  id: "lease-succession-list",
+  type: "entityList",
+  entity: "lease",
+  dormant: true,
+  columns: ["mieter", "vorgaenger", "ende", "beginn"],
+  defaultSort: { field: "beginn", dir: "desc" },
+  pageSize: 25,
+  rowActions: [openLeaseDetail],
+  access: OPEN_ACCESS,
+};

package/samples/apps/use-all-bundled/package.json

@@ -30,7 +30,9 @@
     "react-dom": "^19.2.6",
     "zod": "^4.4.3",
     "@cosmicdrift/kumiko-locale-de": "workspace:*",
-    "@cosmicdrift/kumiko-locale-es": "workspace:*"
+    "@cosmicdrift/kumiko-locale-es": "workspace:*",
+    "@cosmicdrift/kumiko-locale-fr": "workspace:*",
+    "@cosmicdrift/kumiko-locale-it": "workspace:*"
   },
   "devDependencies": {
     "@cosmicdrift/kumiko-testing": "workspace:*"

package/samples/recipes/custom-handlers/src/feature.ts

@@ -12,9 +12,6 @@ import {
 import { failNotFound } from "@cosmicdrift/kumiko-framework/errors";
 import { z } from "zod";
 
-// detail() returns an untyped row; parse the two fields the increment needs once.
-const counterVersionRowSchema = z.object({ count: z.number(), version: z.number() });
-
 export const counterEntity = createEntity({
   table: "read_sample_counters",
   fields: {
@@ -51,8 +48,9 @@ export const counterFeature = defineFeature("counters", (r) => {
         return failNotFound("counter", event.payload.id);
       }
 
-      const { count, version } = counterVersionRowSchema.parse(current);
-      const newCount = count + event.payload.amount;
+      // detail() returns the entity's own row type; count is nullable because the field is not required.
+      const { count, version } = current;
+      const newCount = (count ?? 0) + event.payload.amount;
       // Read-modify-write on counter: use the version we just read so two
       // concurrent increments don't clobber each other's changes.
       return counterExecutor.update(

package/samples/recipes/embedded-entity-form/src/feature.ts

@@ -99,7 +99,7 @@ export const prospectsFeature = defineFeature("prospects", (r) => {
       const flipped = await suggestionExecutor.update(
         {
           id: event.payload.suggestionId,
-          version: suggestion["version"] as number,
+          version: suggestion["version"],
           changes: { status: "accepted" },
         },
         event.user,

package/samples/recipes/pdf-audit-export/README.md

@@ -6,7 +6,7 @@ A write handler exports tenant data as a PDF and keeps it as a FileRef.
 
 - `renderTablePdf` (`@cosmicdrift/kumiko-bundled-features/renderer-pdf`) draws a table document in pure JavaScript: repeating header, weighted columns, page footer. The handler passes ready-formatted strings.
 - The export is a `beforeTransaction` handler: it reads the rows (reads work in that phase), renders the PDF and calls `uploadFileBytesBeforeTransaction` (`@cosmicdrift/kumiko-framework/files`), which validates the bytes and writes them to the tenant-prefixed storage key. The upload runs before the transaction because storage I/O inside it would hold a pool connection for as long as the upload takes.
-- The handler itself calls `createFileRefFromUploadedBytes(ctx, event.prepared)` and creates the `file_refs` row and the `fileRef.created` event in the transaction. If the transaction does not commit, the phase's `release` deletes the uploaded bytes again (only when no row exists for the storage key). A crash between upload and commit leaves the bytes in storage; nothing sweeps them.
+- The handler itself calls `createFileRefFromUploadedBytes(ctx, event.prepared)` and creates the `file_refs` row and the `fileRef.created` event in the transaction. If the transaction does not commit, the phase's `release` deletes the uploaded bytes again (only when no row exists for the storage key). A crash between upload and commit leaves the bytes in storage; the hourly `files:job:sweep-orphaned-uploads` job deletes them once they are older than the grace period (24 hours by default, `uploadSweepGraceHours`).
 - The result is a normal FileRef: `GET /api/files/:id` serves it with `Content-Type: application/pdf`, other tenants get 404.
 
 ## Source

package/samples/recipes/user-data-rights/README.md

@@ -75,6 +75,28 @@ Step-by-step proof:
 2. Deletion + expired grace → `runForgetCleanup` removes all notes
 3. Strategy `anonymize` → `authorId=null`, title/body remain
 
+## Retention with files
+
+`runRetentionCleanup` is exported for app tests. A `hardDelete` entity with a file field loses
+its bytes (and derivatives), its `file_refs` row and then the row itself; a storage error keeps
+the row and reports `file_delete_failed` in `skipped`. `src/retained-docs.ts` holds the entity,
+`src/__tests__/retention-files.integration.test.ts` drives the run with only public imports:
+
+```ts illustration
+import { runRetentionCleanup } from "@cosmicdrift/kumiko-bundled-features/data-retention";
+import { createFileContext } from "@cosmicdrift/kumiko-framework/files";
+
+const result = await runRetentionCleanup({
+  db: stack.db,
+  registry: stack.registry,
+  tenantId,
+  preloadedTenantPreset: null,
+  now: getTemporal().Now.instant().add({ hours: 31 * 24 }), // keepFor 30d + 1 day
+  files: createFileContext(() => Promise.resolve(provider)), // the stack's storage provider
+});
+// result.hardDeleted === 1, bytes and file_refs row gone
+```
+
 ## Full app vs this recipe
 
 | | This recipe | [user-data-rights-demo](/en/samples/apps-user-data-rights-demo/) |

package/samples/recipes/user-data-rights/src/retained-docs.ts

@@ -0,0 +1,35 @@
+// Retention with files: a hardDelete entity whose file field is cleaned up together with the
+// row. runRetentionCleanup removes the bytes (and derivatives) and the file_refs row first,
+// then the row itself; the cron in data-retention does the same with the tenant's FileContext.
+
+import {
+  createEntity,
+  createFileField,
+  createTextField,
+  defineEntityCreateHandler,
+  defineEntityDetailHandler,
+  defineFeature,
+} from "@cosmicdrift/kumiko-framework/engine";
+
+export const retainedDocEntity = createEntity({
+  table: "store_retained_docs",
+  fields: {
+    title: createTextField({ personal: false, reason: "is_business_data", required: true }),
+    attachment: createFileField(),
+  },
+  retention: { keepFor: "30d", strategy: "hardDelete", reference: "createdAt" },
+});
+
+export const retainedDocsFeature = defineFeature("retained-docs", (r) => {
+  r.entity({ name: "retained-doc", ...retainedDocEntity });
+  r.writeHandler(
+    defineEntityCreateHandler("retained-doc", retainedDocEntity, {
+      access: { roles: ["Admin"] },
+    }),
+  );
+  r.queryHandler(
+    defineEntityDetailHandler("retained-doc", retainedDocEntity, {
+      access: { roles: ["Admin"] },
+    }),
+  );
+});