@cosmicdrift/kumiko-samples 0.367.0 → 0.368.0

package/packages/bundled-features/src/workflow-runner/index.ts

@@ -2,7 +2,7 @@
 
 export { workflowRunAggregateId } from "./aggregate-id.js";
 export { registerEventTrigger } from "./event-trigger.js";
-export { workflowRunnerFeature } from "./feature.js";
+export { createWorkflowRunnerFeature, workflowRunnerFeature } from "./feature.js";
 export {
   startAndRunWorkflow,
   type WorkflowRunCompletedPayload,

package/packages/bundled-features/src/workflow-runner/pending-projection.ts

@@ -12,8 +12,8 @@
 // this table and dispatches the actual resume. This projection only writes
 // the rows.
 
-import { deleteMany, fetchOne, upsertOnConflict } from "@cosmicdrift/kumiko-framework/bun-db";
 import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
+import { deleteMany, fetchOne, upsertOnConflict } from "@cosmicdrift/kumiko-framework/db";
 import type {
   FeatureRegistrar,
   MultiStreamProjectionDefinition,

package/samples/apps/admin-console/src/run-config.ts

@@ -14,7 +14,7 @@ import {
   tenantJobFailuresMetric,
 } from "@cosmicdrift/kumiko-bundled-features/metrics";
 import { createSecretsFeature } from "@cosmicdrift/kumiko-bundled-features/secrets";
-import { tierEngineFeature } from "@cosmicdrift/kumiko-bundled-features/tier-engine";
+import { createTierEngineFeature } from "@cosmicdrift/kumiko-bundled-features/tier-engine";
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import { localeDe } from "@cosmicdrift/kumiko-locale-de";
 
@@ -50,7 +50,7 @@ export const APP_FEATURES = [
   createAuditFeature(),
   createDeliveryFeature(),
   createJobsFeature(),
-  tierEngineFeature,
+  createTierEngineFeature(),
   createMetricsFeature({ metrics: CONSOLE_METRICS }),
   createSystemMetricsFeature({ metrics: CONSOLE_METRICS }),
   createAdminShellFeature({ metrics: CONSOLE_METRICS }),

package/samples/apps/cap-billing-demo/package.json

@@ -12,5 +12,8 @@
     "@cosmicdrift/kumiko-framework": "workspace:*",
     "zod": "^4.4.3",
     "@cosmicdrift/kumiko-locale-de": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/apps/cap-billing-demo/src/feature.ts

@@ -38,8 +38,8 @@ import {
 } from "@cosmicdrift/kumiko-bundled-features/cap-counter";
 import type { EmailMessage } from "@cosmicdrift/kumiko-bundled-features/channel-email";
 import {
+  createMailFoundationFeature,
   createTransportForTenant,
-  mailFoundationFeature,
 } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
 import {
   access,
@@ -185,7 +185,7 @@ export const newsletterFeature = defineFeature(FEATURE_NAME, (r) => {
   // klarer für boot-Validator-Errors).
   r.requires({ features: ["config"] });
   r.requires({ features: ["cap-counter"] });
-  r.requires({ features: [mailFoundationFeature.name] });
+  r.requires({ features: [createMailFoundationFeature().name] });
   r.requires({ features: [BILLING_FOUNDATION_FEATURE] });
 
   // Tier-config-key. Tenant-Admin setzt's; default "free".

package/samples/apps/cap-billing-demo/src/run-config.ts

@@ -18,11 +18,11 @@
 //                               der eigenen run-config.
 //   - newsletter             — die Demo-Domain mit cap-aware send
 
-import { billingFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
-import { capCounterFeature } from "@cosmicdrift/kumiko-bundled-features/cap-counter";
+import { createBillingFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
+import { createCapCounterFeature } from "@cosmicdrift/kumiko-bundled-features/cap-counter";
 import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
-import { mailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
-import { mailTransportInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory";
+import { createMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
+import { createMailTransportInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory";
 import { createSecretsFeature } from "@cosmicdrift/kumiko-bundled-features/secrets";
 import { createTenantLifecycleFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-lifecycle";
 import { localeDe } from "@cosmicdrift/kumiko-locale-de";
@@ -39,12 +39,12 @@ import { newsletterFeature } from "./feature";
 export const APP_FEATURES = [
   localeDe(),
   createSecretsFeature(),
-  capCounterFeature,
-  mailFoundationFeature,
-  mailTransportInMemoryFeature,
+  createCapCounterFeature(),
+  createMailFoundationFeature(),
+  createMailTransportInMemoryFeature(),
   createComplianceProfilesFeature(),
   createTenantLifecycleFeature(),
-  billingFoundationFeature,
+  createBillingFoundationFeature(),
   newsletterFeature,
 ] as const;
 

package/samples/apps/marketing-demo/src/app/seed.ts

@@ -9,7 +9,7 @@
 // nur Logik: Random-Generator, Datums-Helper, der eigentliche Seed.
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
 import { countAssetsForTenant, countTicketsForTenant } from "../db/queries/seed-counts";
 import { ASSET_STATUSES } from "../features/assets/schema";

package/samples/apps/marketing-demo/src/db/queries/seed-counts.ts

@@ -1,5 +1,5 @@
-import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
 import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
+import { asRawClient } from "@cosmicdrift/kumiko-framework/db";
 
 export async function countAssetsForTenant(db: DbRunner, tenantId: string): Promise<number> {
   const rows = await asRawClient(db).unsafe<{ count: number }>(

package/samples/apps/showcase/package.json

@@ -19,5 +19,8 @@
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "@cosmicdrift/kumiko-locale-de": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/apps/showcase/src/app/seed-items.ts

@@ -9,7 +9,7 @@
 // bei jedem Restart neu geseeded sonst.
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
 const STATUSES = ["draft", "active", "blocked", "done"] as const;
 

package/samples/apps/styleguide/src/app/seed.ts

@@ -1,7 +1,7 @@
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import { createTenantDb } from "@cosmicdrift/kumiko-framework/db";
 import { createEntityExecutor } from "@cosmicdrift/kumiko-framework/engine";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
 import { demoEntity } from "../features/demo/feature";
 
@@ -26,7 +26,7 @@ export const seedStyleguideItems: SeedFn = async (stack) => {
   // Calling the executor directly is the framework's documented "seed
   // pattern" for a caller-chosen aggregate id (event-store-executor-write.ts).
   const { executor } = createEntityExecutor("item", demoEntity);
-  const tenantDb = createTenantDb(stack.db, TestUsers.admin.tenantId);
+  const tenantDb = createTenantDb({ db: stack.db, tenantId: TestUsers.admin.tenantId });
 
   for (let i = 0; i < 8; i++) {
     const payload = {

package/samples/apps/styleguide/src/features/ai-settings/seed.ts

@@ -1,14 +1,14 @@
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import { createTenantDb } from "@cosmicdrift/kumiko-framework/db";
 import { createEntityExecutor } from "@cosmicdrift/kumiko-framework/engine";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
 import { ANTHROPIC_CONNECTION_ID, OPENROUTER_CONNECTION_ID } from "./catalog";
 import { connectionEntity } from "./feature";
 
 export const seedAiConnections: SeedFn = async (stack) => {
   const { executor } = createEntityExecutor("connection", connectionEntity);
-  const tenantDb = createTenantDb(stack.db, TestUsers.admin.tenantId);
+  const tenantDb = createTenantDb({ db: stack.db, tenantId: TestUsers.admin.tenantId });
   const connections = [
     {
       id: ANTHROPIC_CONNECTION_ID,

package/samples/apps/ui-walkthrough/scripts/emit-e2e-data.ts

@@ -7,7 +7,7 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { createRegistry } from "@cosmicdrift/kumiko-framework/engine";
-import { generateE2ESpec } from "@cosmicdrift/kumiko-framework/testing/e2e-generator";
+import { generateE2ESpec } from "@cosmicdrift/kumiko-testing/helpers/e2e-generator";
 import { taskFeature } from "../src/features/tasks";
 
 const outPath = resolve(import.meta.dir, "..", "e2e", ".e2e-data.json");

package/samples/apps/ui-walkthrough/src/app/auth-constants.ts

@@ -3,7 +3,7 @@
 // `e2e/_helpers/login.ts` gelesen.
 //
 // Warum getrennt: e2e-Specs laufen im Playwright-Worker, der nichts aus
-// `@cosmicdrift/kumiko-framework/testing` (zieht `vitest`) oder
+// `@cosmicdrift/kumiko-testing/helpers` (zieht `vitest`) oder
 // `@cosmicdrift/kumiko-bundled-features/.../testing` (zieht das ebenfalls) ertragen
 // kann — Vitest's expect redefined Object.prototype-Symbole und kollidiert
 // mit Playwrights expect. Diese Datei bleibt importchain-leer und ist die

package/samples/apps/ui-walkthrough/src/app/seed-rental.ts

@@ -3,7 +3,7 @@
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import { createTenantDb } from "@cosmicdrift/kumiko-framework/db";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { countRowsForTenant } from "../db/queries/row-counts";
 import { leaseExecutor, partyExecutor, positionExecutor } from "../features/rental/lease-support";
 
@@ -214,7 +214,7 @@ function generatedLease(index: number): BoardLease & { readonly terminated: bool
 export const seedRental: SeedFn = async (stack) => {
   const { tenantId } = TestUsers.admin;
   if ((await countRowsForTenant(stack.db, "read_ui_walkthrough_leases", tenantId)) > 0) return;
-  const db = createTenantDb(stack.db, tenantId);
+  const db = createTenantDb({ db: stack.db, tenantId });
 
   const createLease = async (lease: BoardLease, terminated: boolean, id?: string) => {
     const result = await leaseExecutor.create(

package/samples/apps/ui-walkthrough/src/app/seed-vehicles.ts

@@ -1,5 +1,5 @@
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { countRowsForTenant } from "../db/queries/row-counts";
 
 const OCTAVIA_DESCRIPTION = [

package/samples/apps/ui-walkthrough/src/app/seed.ts

@@ -5,7 +5,7 @@
 // tenant already has tasks (persistent KUMIKO_DEV_DB_NAME survives reboots).
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { countTasksForTenant } from "../db/queries/task-counts";
 
 const DEMO_TASKS = [

package/samples/apps/ui-walkthrough/src/db/queries/row-counts.ts

@@ -1,5 +1,5 @@
-import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
 import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
+import { asRawClient } from "@cosmicdrift/kumiko-framework/db";
 
 type CountedTable = "read_ui_walkthrough_leases" | "read_ui_walkthrough_vehicles";
 

package/samples/apps/ui-walkthrough/src/db/queries/task-counts.ts

@@ -1,5 +1,5 @@
-import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
 import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
+import { asRawClient } from "@cosmicdrift/kumiko-framework/db";
 
 export async function countTasksForTenant(db: DbRunner, tenantId: string): Promise<number> {
   const rows = await asRawClient(db).unsafe<{ count: number }>(

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

@@ -31,5 +31,8 @@
     "zod": "^4.4.3",
     "@cosmicdrift/kumiko-locale-de": "workspace:*",
     "@cosmicdrift/kumiko-locale-es": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/apps/use-all-bundled/scripts/check-coverage.ts

@@ -23,10 +23,10 @@ const FRAMEWORK_ROOT = resolve(ROOT, "..", "..", "..");
 // Held-back exports: existieren in bundled-features, sind aber nicht
 // als runtime-feature in use-all-bundled mountbar.
 //
-// Nur Utilities ohne defineFeature (foundation-shared, files-provider-s3 sind pure helpers)
+// Nur Utilities ohne defineFeature (foundation-shared sowie files-provider-s3, der deprecated Alias von file-provider-s3/lib, sind pure helpers)
 // und scaffold-only Features. Gemountete Features gehören nicht hierher.
 const EXPECTED_HELD_BACK = new Set([
-  "files-provider-s3", // utility (createS3Provider helpers), kein defineFeature
+  "files-provider-s3", // deprecated alias of file-provider-s3/lib (createS3Provider helpers), kein defineFeature
   "foundation-shared", // utilities (requireDefined/requireNonEmpty), kein feature
   "page-render", // shared HTML render/cache helpers (legal/managed-pages), kein defineFeature
   "presets", // feature-bundle helpers (dsgvoSelfServiceFeatures, securityBaselineFeatures), kein defineFeature

package/samples/apps/use-all-bundled/src/app/auth-constants.ts

@@ -1,6 +1,6 @@
 // Reine Konstanten — kein Framework-Import, damit der E2E-Login-Helper
 // (Playwright-Worker) sie lesen kann, ohne die vitest-Importchain aus
-// `@cosmicdrift/kumiko-framework/testing` mitzuziehen (kollidiert mit
+// `@cosmicdrift/kumiko-testing/helpers` mitzuziehen (kollidiert mit
 // Playwrights expect über Object.prototype-Symbole).
 
 export const ADMIN_EMAIL = "admin@kumiko.dev";

package/samples/apps/use-all-bundled/src/app/cap-overview-caps.ts

@@ -2,8 +2,8 @@ import type { CapSpec } from "@cosmicdrift/kumiko-bundled-features/cap-overview"
 import { noteEntryTable } from "@cosmicdrift/kumiko-bundled-features/notes-history";
 import { tagEntity } from "@cosmicdrift/kumiko-bundled-features/tags";
 import { tenantMembershipsTable } from "@cosmicdrift/kumiko-bundled-features/tenant";
-import { selectMany } from "@cosmicdrift/kumiko-framework/bun-db";
-import { buildEntityTable } from "@cosmicdrift/kumiko-framework/db";
+
+import { buildEntityTable, selectMany } from "@cosmicdrift/kumiko-framework/db";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
 
 const tagTable = buildEntityTable("tag", tagEntity);

package/samples/apps/use-all-bundled/src/app/dev-app-options.ts

@@ -19,7 +19,7 @@ import { notesFeature } from "./notes-feature";
 import { appScreensFeature } from "./screens-feature";
 import { seedScreenshotData } from "./seed";
 
-// tier-admin rendert mit dem bare tierEngineFeature (aus APP_FEATURES) den
+// tier-admin rendert mit dem bare createTierEngineFeature() (aus APP_FEATURES) den
 // ehrlichen Empty-State ("no TierMap configured"). Eine konfigurierte tierMap
 // würde den Resolver auf jedem Write aktivieren (inkl. Login) und braucht
 // per-Tenant Tier-Assignments — disproportional für einen Preview-Screenshot.

package/samples/apps/use-all-bundled/src/app/seed-documents.ts

@@ -9,7 +9,7 @@ import { TemplateResolverHandlers } from "@cosmicdrift/kumiko-bundled-features/t
 import { seedSystemTemplate } from "@cosmicdrift/kumiko-bundled-features/template-resolver/seeding";
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import type { SessionUser, TenantId } from "@cosmicdrift/kumiko-framework/engine";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { BETA_TENANT_ID, DEV_TENANT_ID, INVOICE_TEMPLATE_SLUG } from "./auth-constants";
 
 type Stack = Parameters<SeedFn>[0];

package/samples/apps/use-all-bundled/src/app/seed.ts

@@ -24,16 +24,22 @@ import {
 } from "@cosmicdrift/kumiko-bundled-features/tier-engine";
 import { userTable } from "@cosmicdrift/kumiko-bundled-features/user";
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { fetchOne, insertOne } from "@cosmicdrift/kumiko-framework/bun-db";
-import { createTenantDb, type DbConnection } from "@cosmicdrift/kumiko-framework/db";
+
+import {
+  createTenantDb,
+  type DbConnection,
+  fetchOne,
+  insertOne,
+} from "@cosmicdrift/kumiko-framework/db";
 import {
   createEntityExecutor,
   type SessionUser,
   SYSTEM_TENANT_ID,
   type TenantId,
 } from "@cosmicdrift/kumiko-framework/engine";
-import { TestUsers, unsafeCreateEntityTable } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { generateId } from "@cosmicdrift/kumiko-framework/utils";
+import { unsafeCreateEntityTable } from "@cosmicdrift/kumiko-testing/stack";
 import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
 import { ADMIN_EMAIL, BETA_TENANT_ID, DEMO_NOTE_ID, DEV_TENANT_ID } from "./auth-constants";
 import { noteEntity } from "./notes-feature";
@@ -80,7 +86,7 @@ async function seedTierAssignment(
   adminUserId: string,
 ): Promise<void> {
   const by: SessionUser = { ...TestUsers.systemAdmin, tenantId, id: adminUserId };
-  const tdb = createTenantDb(db, tenantId, "system");
+  const tdb = createTenantDb({ db, tenantId, mode: "system" });
   const result = await tierAssignmentExecutor.create(
     { id: tierAssignmentAggregateId(tenantId), tier, source: "manual", tenantId },
     by,
@@ -104,7 +110,7 @@ async function seedTagsAndNotes(
   adminUserId: string,
 ): Promise<void> {
   const by: SessionUser = { ...TestUsers.systemAdmin, tenantId, id: adminUserId };
-  const tdb = createTenantDb(db, tenantId, "system");
+  const tdb = createTenantDb({ db, tenantId, mode: "system" });
 
   const created = async (
     label: string,

package/samples/apps/use-all-bundled/src/run-config.ts

@@ -16,11 +16,11 @@
 
 import { createAdminShellFeature } from "@cosmicdrift/kumiko-bundled-features/admin-shell";
 import { createAgentToolsFeature } from "@cosmicdrift/kumiko-bundled-features/agent-tools";
-import { authFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
+import { createAuthFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
 import { createAuthMfaFeature } from "@cosmicdrift/kumiko-bundled-features/auth-mfa";
-import { authMfaUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/auth-mfa-user-data";
-import { billingFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
-import { capCounterFeature } from "@cosmicdrift/kumiko-bundled-features/cap-counter";
+import { createAuthMfaUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/auth-mfa-user-data";
+import { createBillingFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
+import { createCapCounterFeature } from "@cosmicdrift/kumiko-bundled-features/cap-counter";
 import { createCapOverviewFeature } from "@cosmicdrift/kumiko-bundled-features/cap-overview";
 import { createChannelDiscordFeature } from "@cosmicdrift/kumiko-bundled-features/channel-discord";
 import {
@@ -36,33 +36,32 @@ import { createChannelSlackFeature } from "@cosmicdrift/kumiko-bundled-features/
 import { createChannelTeamsFeature } from "@cosmicdrift/kumiko-bundled-features/channel-teams";
 import { createChannelTelegramFeature } from "@cosmicdrift/kumiko-bundled-features/channel-telegram";
 import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
-import { complianceProfilesOpsFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles-ops";
-import { customFieldsFeature } from "@cosmicdrift/kumiko-bundled-features/custom-fields";
+import { createComplianceProfilesOpsFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles-ops";
+import { createCustomFieldsFeature } from "@cosmicdrift/kumiko-bundled-features/custom-fields";
 import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
 import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
-import { derivativesSharpFeature } from "@cosmicdrift/kumiko-bundled-features/derivatives-sharp";
-import { documentIngestFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/document-ingest-foundation";
+import { createDerivativesSharpFeature } from "@cosmicdrift/kumiko-bundled-features/derivatives-sharp";
+import { createDocumentIngestFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/document-ingest-foundation";
 import { createFeatureTogglesFeature } from "@cosmicdrift/kumiko-bundled-features/feature-toggles";
 import { createFileDerivativesFeature } from "@cosmicdrift/kumiko-bundled-features/file-derivatives";
-import { fileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
-import { fileProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory";
-import { fileProviderS3Feature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3";
-import { fileProviderS3EnvFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3-env";
+import { createFileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
+import { createFileProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory";
+import { createFileProviderS3Feature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3";
 import { createFilesFeature } from "@cosmicdrift/kumiko-bundled-features/files";
 import { createFilesTenantDataFeature } from "@cosmicdrift/kumiko-bundled-features/files-tenant-data";
-import { foldersFeature } from "@cosmicdrift/kumiko-bundled-features/folders";
-import { foldersUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/folders-user-data";
-import { formDraftFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft";
-import { formDraftUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft-user-data";
-import { inboundMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
-import { inboundProviderImapFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-imap";
-import { inboundProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-inmemory";
+import { createFoldersFeature } from "@cosmicdrift/kumiko-bundled-features/folders";
+import { createFoldersUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/folders-user-data";
+import { createFormDraftFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft";
+import { createFormDraftUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft-user-data";
+import { createInboundMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
+import { createInboundProviderImapFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-imap";
+import { createInboundProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-inmemory";
 import { createJobsFeature } from "@cosmicdrift/kumiko-bundled-features/jobs";
-import { ledgerFeature } from "@cosmicdrift/kumiko-bundled-features/ledger";
+import { createLedgerFeature } from "@cosmicdrift/kumiko-bundled-features/ledger";
 import { createLegalPagesFeature } from "@cosmicdrift/kumiko-bundled-features/legal-pages";
-import { mailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
-import { mailTransportInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory";
-import { mailTransportSmtpFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-smtp";
+import { createMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
+import { createMailTransportInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory";
+import { createMailTransportSmtpFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-smtp";
 import { createManagedPagesFeature } from "@cosmicdrift/kumiko-bundled-features/managed-pages";
 import {
   createMetricsFeature,
@@ -70,10 +69,10 @@ import {
   DEFAULT_METRICS,
 } from "@cosmicdrift/kumiko-bundled-features/metrics";
 import { createNotesHistoryFeature } from "@cosmicdrift/kumiko-bundled-features/notes-history";
-import { notesHistoryUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/notes-history-user-data";
+import { createNotesHistoryUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/notes-history-user-data";
 import { createPersonalAccessTokensFeature } from "@cosmicdrift/kumiko-bundled-features/personal-access-tokens";
 import { securityBaselineFeatures } from "@cosmicdrift/kumiko-bundled-features/presets";
-import { readinessFeature } from "@cosmicdrift/kumiko-bundled-features/readiness";
+import { createReadinessFeature } from "@cosmicdrift/kumiko-bundled-features/readiness";
 import { createRendererFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/renderer-foundation";
 import { createRendererPdfFeature } from "@cosmicdrift/kumiko-bundled-features/renderer-pdf";
 import { createSecretsFeature } from "@cosmicdrift/kumiko-bundled-features/secrets";
@@ -83,16 +82,16 @@ import { createSubscriptionMollieFeature } from "@cosmicdrift/kumiko-bundled-fea
 import { createSubscriptionStripeFeature } from "@cosmicdrift/kumiko-bundled-features/subscription-stripe";
 import { createTagsFeature } from "@cosmicdrift/kumiko-bundled-features/tags";
 import { createTemplateResolverFeature } from "@cosmicdrift/kumiko-bundled-features/template-resolver";
-import { templateResolverUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/template-resolver-user-data";
+import { createTemplateResolverUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/template-resolver-user-data";
 import { createTenantHandoverFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-handover";
 import { createTenantLifecycleFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-lifecycle";
 import { createTenantSettingsFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-settings";
-import { tierEngineFeature } from "@cosmicdrift/kumiko-bundled-features/tier-engine";
+import { createTierEngineFeature } from "@cosmicdrift/kumiko-bundled-features/tier-engine";
 import { createUserDataRightsFeature } from "@cosmicdrift/kumiko-bundled-features/user-data-rights";
 import { createUserDataRightsDefaultsFeature } from "@cosmicdrift/kumiko-bundled-features/user-data-rights-defaults";
 import { createUserProfileFeature } from "@cosmicdrift/kumiko-bundled-features/user-profile";
 import { createWaitlistFeature } from "@cosmicdrift/kumiko-bundled-features/waitlist";
-import { workflowRunnerFeature } from "@cosmicdrift/kumiko-bundled-features/workflow-runner";
+import { createWorkflowRunnerFeature } from "@cosmicdrift/kumiko-bundled-features/workflow-runner";
 import { createDocumentDesignerFeature } from "@cosmicdrift/kumiko-document-designer";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
 import { localeDe } from "@cosmicdrift/kumiko-locale-de";
@@ -139,7 +138,7 @@ export const APP_FEATURES = [
   // Owns the `tokenVerifier` extension-point personal-access-tokens
   // registers against below — required whenever a bearer-auth provider is
   // mounted (kumiko-framework#1369).
-  authFoundationFeature,
+  createAuthFoundationFeature(),
   // Per-domain scopes (like cashcolt's credit/bauspar/miete): the token picks
   // WHICH API × the permission LEVEL (read vs read+write). Each domain declares
   // its read + write QN globs.
@@ -159,7 +158,7 @@ export const APP_FEATURES = [
       ledger: { label: "Ledger", read: ["ledger:query:*"], write: ["ledger:write:*"] },
     },
   }),
-  readinessFeature,
+  createReadinessFeature(),
 
   // delivery + channels
   createDeliveryFeature(),
@@ -180,20 +179,20 @@ export const APP_FEATURES = [
   createChannelTelegramFeature(),
 
   // mail (foundation before transport)
-  mailFoundationFeature,
-  mailTransportInMemoryFeature,
-  mailTransportSmtpFeature,
+  createMailFoundationFeature(),
+  createMailTransportInMemoryFeature(),
+  createMailTransportSmtpFeature(),
 
   // inbound mail (foundation before providers)
-  inboundMailFoundationFeature,
-  inboundProviderInMemoryFeature,
-  inboundProviderImapFeature,
+  createInboundMailFoundationFeature(),
+  createInboundProviderInMemoryFeature(),
+  createInboundProviderImapFeature(),
 
   // files (foundation before provider)
-  fileFoundationFeature,
-  fileProviderInMemoryFeature,
-  fileProviderS3Feature,
-  fileProviderS3EnvFeature,
+  createFileFoundationFeature(),
+  createFileProviderInMemoryFeature(),
+  createFileProviderS3Feature(),
+  createFileProviderS3Feature({ fromEnv: true }),
   createFilesFeature(),
   // resolveApexTenant is what registers the `public-variant` query and the
   // anonymous /media route — the option-less export leaves both out and hides
@@ -204,10 +203,10 @@ export const APP_FEATURES = [
   // a single-tenant smoke sample and a cross-tenant leak in a real app, where
   // the host is the ONLY thing that may decide which tenant's bytes go out.
   createFileDerivativesFeature({ resolveApexTenant: () => DEV_TENANT_ID as TenantId }),
-  derivativesSharpFeature,
+  createDerivativesSharpFeature(),
 
   // billing + providers
-  billingFoundationFeature,
+  createBillingFoundationFeature(),
   createSubscriptionStripeFeature({
     apiKey: "sk_test_smoke",
     webhookSecret: "whsec_smoke",
@@ -228,8 +227,8 @@ export const APP_FEATURES = [
   }),
 
   // tiering + caps
-  tierEngineFeature,
-  capCounterFeature,
+  createTierEngineFeature(),
+  createCapCounterFeature(),
   // cap-overview: read-only tier/usage visibility. Caps are example
   // entities this sample already mounts (notes-history, tags,
   // tenant-membership) — see cap-overview-caps.ts. Requires tenant
@@ -263,11 +262,11 @@ export const APP_FEATURES = [
   // workflow-runner: no entities/MSPs/handlers of its own — reserves the
   // manifest slot and provides startAndRunWorkflow/registerEventTrigger for
   // consumer features to wire up defineWorkflow-based workflows.
-  workflowRunnerFeature,
+  createWorkflowRunnerFeature(),
 
   // compliance / DSGVO
   createComplianceProfilesFeature(),
-  complianceProfilesOpsFeature,
+  createComplianceProfilesOpsFeature(),
   createTenantLifecycleFeature(),
   // tenant-handover: try-before-signup ownership handover (kumiko-
   // framework#3035). No entities/mount-options of its own — it reads
@@ -327,7 +326,7 @@ export const APP_FEATURES = [
   // user-content-entry rows the `signatures` collection writes. Mandatory
   // whenever a user-owned collection is mounted — the boot guard refuses the
   // subject-carrying entity without it.
-  templateResolverUserDataFeature,
+  createTemplateResolverUserDataFeature(),
   // collection-labels: the app-side nav labels for the two collections above.
   collectionLabelsFeature,
   createRendererFoundationFeature(),
@@ -366,7 +365,7 @@ export const APP_FEATURES = [
   createAdminShellFeature({ includeCapOverview: true, includeDocumentDesigner: true }),
 
   // app-author-grade
-  customFieldsFeature,
+  createCustomFieldsFeature(),
   // The default tag roles are TenantAdmin/TenantMember; this app's operator is a
   // global SystemAdmin (see server.ts admin), so add SystemAdmin or every tag
   // query/screen is access_denied — exactly what the constants doc warns about.
@@ -377,30 +376,30 @@ export const APP_FEATURES = [
   // notes-history-user-data: GDPR export/erase coverage for note-entry.
   // Depends (optionally) on notes-history + (hard) on user-data-rights —
   // both mounted here.
-  notesHistoryUserDataFeature,
-  formDraftFeature,
+  createNotesHistoryUserDataFeature(),
+  createFormDraftFeature(),
   // form-draft-user-data: GDPR export/erase coverage for the form-draft
   // entity. Depends (optionally) on form-draft + (hard) on
   // user-data-rights — both mounted here.
-  formDraftUserDataFeature,
-  foldersFeature,
+  createFormDraftUserDataFeature(),
+  createFoldersFeature(),
   // folders-user-data: GDPR hooks for folder entities. Depends (optionally)
   // on folders + (hard) on user-data-rights — both mounted above.
-  foldersUserDataFeature,
+  createFoldersUserDataFeature(),
   // auth-mfa-user-data: GDPR hooks for the user-mfa entity. Depends
   // (optionally) on auth-mfa + (hard) on user-data-rights — both mounted
   // above.
-  authMfaUserDataFeature,
+  createAuthMfaUserDataFeature(),
   // files-tenant-data: tenant-destroy row purge + storage-prefix binary wipe
   // for fileRef, plus the orphaned-derivative backfill/GC job (#2474).
   // Depends (optionally) on files + (hard) on tenant-lifecycle — both
   // mounted above.
   createFilesTenantDataFeature(),
   // ledger: double-entry bookkeeping primitive (account + immutable transaction).
-  ledgerFeature,
+  createLedgerFeature(),
   // document-ingest-foundation: Phase-1 skeleton — documentExtract entity +
   // ocrLanguage/maxPagesPerFile config, no handlers yet (kumiko-framework#1497).
-  documentIngestFoundationFeature,
+  createDocumentIngestFoundationFeature(),
   createAgentToolsFeature(),
 ] as const;
 

package/samples/apps/user-data-rights-demo/README.md

@@ -109,8 +109,8 @@ then 500s). For a real deploy, swap to the persistent provider in
 `src/run-config.ts`:
 
 ```ts illustration
-// import { fileProviderS3EnvFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3-env";
-// APP_FEATURES: fileProviderInMemoryFeature -> fileProviderS3EnvFeature
+// import { createFileProviderS3Feature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3";
+// APP_FEATURES: createFileProviderInMemoryFeature() -> createFileProviderS3Feature({ fromEnv: true })
 ```
 
 Then set `S3_BUCKET` / `S3_REGION` / `S3_ACCESS_KEY` / `S3_SECRET_KEY` (plus