@cosmicdrift/kumiko-samples 0.365.1 → 0.367.0

package/samples/apps/styleguide/src/features/widgets/ai-text-demo.ts

@@ -46,10 +46,10 @@ function cannedText(payload: RunInput): string {
 }
 
 export const aiTextDemoFeature = defineFeature("ai-text", (r) => {
-  r.queryHandler(
-    "run",
-    runInput,
-    async ({ payload }) => {
+  r.queryHandler({
+    name: "run",
+    schema: runInput,
+    handler: async ({ payload }) => {
       const text = cannedText(payload);
       return {
         type: "text" as const,
@@ -57,14 +57,12 @@ export const aiTextDemoFeature = defineFeature("ai-text", (r) => {
         usage: { inputTokens: payload.text.length, outputTokens: text.length },
       };
     },
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo stand-in for a real LLM call: returns canned text transforms with no " +
-            "side effects or per-user data; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo stand-in for a real LLM call: returns canned text transforms with no " +
+          "side effects or per-user data; any signed-in user may query it",
       },
     },
-  );
+  });
 });

package/samples/apps/styleguide/src/features/widgets/feature.ts

@@ -198,10 +198,10 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
     ],
   });
 
-  r.queryHandler(
-    "metrics:portfolio-stat",
-    z.object({ region: z.string().optional() }),
-    async ({ payload: { region } }, ctx) => ({
+  r.queryHandler({
+    name: "metrics:portfolio-stat",
+    schema: z.object({ region: z.string().optional() }),
+    handler: async ({ payload: { region } }, ctx) => ({
       value:
         region === "us"
           ? demoMoney(38120, "USD", ctx.locale)
@@ -212,86 +212,76 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
       deltaDirection: "up",
       deltaTone: "positive",
     }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:net-worth-assets",
-    z.object({ region: z.string().optional() }),
-    async (_query, ctx) => ({ value: demoMoney(120000, "EUR", ctx.locale) }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+  });
+  r.queryHandler({
+    name: "metrics:net-worth-assets",
+    schema: z.object({ region: z.string().optional() }),
+    handler: async (_query, ctx) => ({ value: demoMoney(120000, "EUR", ctx.locale) }),
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:net-worth-debts",
-    z.object({ region: z.string().optional() }),
-    async (_query, ctx) => ({ value: demoMoney(65370, "EUR", ctx.locale) }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+  });
+  r.queryHandler({
+    name: "metrics:net-worth-debts",
+    schema: z.object({ region: z.string().optional() }),
+    handler: async (_query, ctx) => ({ value: demoMoney(65370, "EUR", ctx.locale) }),
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:response-times",
-    z.object({}),
-    async () => ({
+  });
+  r.queryHandler({
+    name: "metrics:response-times",
+    schema: z.object({}),
+    handler: async () => ({
       points: RESPONSE_POINTS,
       windowStartMs: 0,
       windowEndMs: 24 * 60 * 60 * 1000,
     }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:loan",
-    z.object({}),
-    async () => ({
+  });
+  r.queryHandler({
+    name: "metrics:loan",
+    schema: z.object({}),
+    handler: async () => ({
       series: LOAN_SERIES,
       markers: LOAN_MARKERS,
       windowStartMs: LOAN_START_MS,
       windowEndMs: loanMonthMs(LOAN_MONTHS),
       todayMs: LOAN_TODAY_MS,
     }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:latest-items",
-    z.object({}),
-    async (_query, ctx) => ({
+  });
+  r.queryHandler({
+    name: "metrics:latest-items",
+    schema: z.object({}),
+    handler: async (_query, ctx) => ({
       rows: [
         {
           id: "i1",
@@ -306,25 +296,23 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
       ],
       nextCursor: null,
     }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:inbox-messages",
-    z.object({
+  });
+  r.queryHandler({
+    name: "metrics:inbox-messages",
+    schema: z.object({
       cursor: z.coerce.number().int().min(0).optional(),
       limit: z.number().int().min(1).max(100).optional(),
       unreadOnly: z.boolean().optional(),
       search: z.string().optional(),
     }),
-    async ({ payload: { cursor, limit, unreadOnly, search } }) => {
+    handler: async ({ payload: { cursor, limit, unreadOnly, search } }) => {
       const term = search?.trim().toLowerCase() ?? "";
       const filtered = INBOX_MESSAGES.filter(
         (m) =>
@@ -339,20 +327,18 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
       const nextCursor = start + pageSize < filtered.length ? String(start + pageSize) : null;
       return { rows, nextCursor };
     },
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:upcoming-events",
-    z.object({}),
-    async (_query, ctx) => ({
+  });
+  r.queryHandler({
+    name: "metrics:upcoming-events",
+    schema: z.object({}),
+    handler: async (_query, ctx) => ({
       rows: [
         {
           primary: demoText("widgets:dashboard:demo-event-rate-adjustment", ctx.locale),
@@ -364,20 +350,18 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
         },
       ],
     }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
-  r.queryHandler(
-    "metrics:goal-progress",
-    z.object({}),
-    async (_query, ctx) => ({
+  });
+  r.queryHandler({
+    name: "metrics:goal-progress",
+    schema: z.object({}),
+    handler: async (_query, ctx) => ({
       rows: [
         {
           label: demoText("widgets:dashboard:demo-goal-mortgage", ctx.locale),
@@ -391,16 +375,14 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
         },
       ],
     }),
-    {
-      access: {
-        openToAll: {
-          reason:
-            "demo dashboard widget: returns static canned data with no per-user or " +
-            "tenant scoping; any signed-in user may query it",
-        },
+    access: {
+      openToAll: {
+        reason:
+          "demo dashboard widget: returns static canned data with no per-user or " +
+          "tenant scoping; any signed-in user may query it",
       },
     },
-  );
+  });
 
   r.translations({ keys: WIDGETS_I18N });
 

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

@@ -32,6 +32,7 @@ import {
   SYSTEM_INVOICE_ISSUED,
   SYSTEM_PDF_LAYOUT,
   SYSTEM_TENANCY_CERTIFICATE,
+  SYSTEM_TERMS_CHANGED,
   TENANT_INVOICE_OVERRIDES,
   TENANT_MAIL_LAYOUT_VERSIONS,
   TENANT_UTILITY_STATEMENT,
@@ -165,6 +166,7 @@ export const seedTemplates: SeedFn = async (stack) => {
   await upsertSystem(SYSTEM_PDF_LAYOUT);
   for (const mail of SYSTEM_AUTH_MAILS) await upsertSystem(mail);
   await upsertSystem(SYSTEM_INVOICE_ISSUED);
+  await upsertSystem(SYSTEM_TERMS_CHANGED);
   for (const document of SYSTEM_INVOICE_DOCUMENTS) await upsertSystem(document);
   const certificate = await upsertSystem(SYSTEM_TENANCY_CERTIFICATE);
   await stack.http.writeOk(

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

@@ -276,6 +276,18 @@ export const INVOICE_CORRECTED_DRAFT: SeedTemplate = {
   meta: invoiceIssuedMeta("Ihre Rechnung {{invoiceNumber}} von {{tenantName}}"),
 };
 
+export const SYSTEM_TERMS_CHANGED: SeedTemplate = {
+  slug: "billing:notify:terms-changed",
+  kind: "mail",
+  locale: "de",
+  title: "AGB-Änderung",
+  content: [
+    `<p>Guten Tag ${v("customerName")},</p>`,
+    `<p>zum ${v("effectiveDate")} ändern sich die Allgemeinen Geschäftsbedingungen des Mieterportals.</p>`,
+  ].join(""),
+  meta: { subject: "Änderung der Geschäftsbedingungen" },
+};
+
 export const PAYMENT_REMINDER_TEMPLATES: readonly SeedTemplate[] = [
   {
     slug: "billing:notify:payment-reminder",

package/samples/apps/ui-walkthrough/src/features/billing/feature.ts

@@ -63,10 +63,17 @@ const PAYMENT_REMINDER_VARIABLES = {
   invoiceUrl: templateVariable.link({ required: true }),
 } as const;
 
+const TERMS_CHANGED_VARIABLES = {
+  customerName: templateVariable.text({ required: true, example: "Familie Yilmaz" }),
+  effectiveDate: templateVariable.date({ required: true, example: "2026-12-01" }),
+} as const;
+
 export const billingFeature = defineFeature("billing", (r) => {
   r.translations({ keys: toKeyFirst(billingTranslations) });
 
   r.notification("invoice-issued", { variables: INVOICE_ISSUED_VARIABLES });
   r.notification("invoice-corrected", { variables: INVOICE_ISSUED_VARIABLES });
   r.notification("payment-reminder", { variables: PAYMENT_REMINDER_VARIABLES });
+  // Legal wording the platform owns: tenant admins neither see nor override it.
+  r.notification("terms-changed", { variables: TERMS_CHANGED_VARIABLES, systemOnly: true });
 });

package/samples/apps/ui-walkthrough/src/features/billing/i18n.ts

@@ -8,11 +8,13 @@ export const billingTranslations: TranslationsByLocale = {
     "billing:notify.invoice-issued.label": "Rechnung gestellt",
     "billing:notify.invoice-corrected.label": "Rechnung korrigiert",
     "billing:notify.payment-reminder.label": "Mahnlauf",
+    "billing:notify.terms-changed.label": "AGB-Änderung",
   },
   en: {
     "billing:feature.label": "Invoices",
     "billing:notify.invoice-issued.label": "Invoice issued",
     "billing:notify.invoice-corrected.label": "Invoice corrected",
     "billing:notify.payment-reminder.label": "Dunning run",
+    "billing:notify.terms-changed.label": "Terms update",
   },
 };

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

@@ -71,10 +71,10 @@ export const rentalFeature = defineFeature("rental", (r) => {
   r.crud("leasePosition", leasePositionEntity, { write: open, read: open });
   r.crud("leaseParty", leasePartyEntity, { write: open, read: open });
 
-  r.queryHandler(
-    "lease:akte",
-    idPayloadSchema,
-    async (query, ctx) => {
+  r.queryHandler({
+    name: "lease:akte",
+    schema: idPayloadSchema,
+    handler: async (query, ctx) => {
       const row = await leaseExecutor.detail({ id: query.payload.id }, query.user, ctx.db);
       if (!row) return failNotFound("lease", query.payload.id);
       const lease = parseLeaseRow(row);
@@ -104,13 +104,13 @@ export const rentalFeature = defineFeature("rental", (r) => {
         positionCount: await countChildren(positionExecutor),
       };
     },
-    open,
-  );
+    ...open,
+  });
 
-  r.queryHandler(
-    "lease:positions",
-    idPayloadSchema,
-    async (query, ctx) => {
+  r.queryHandler({
+    name: "lease:positions",
+    schema: idPayloadSchema,
+    handler: async (query, ctx) => {
       const page = await positionExecutor.list(
         { filter: { field: "lease", op: "eq", value: query.payload.id }, limit: 100 },
         query.user,
@@ -132,13 +132,13 @@ export const rentalFeature = defineFeature("rental", (r) => {
         }),
       };
     },
-    open,
-  );
+    ...open,
+  });
 
-  r.queryHandler(
-    "lease:kennzahlen",
-    z.object({}),
-    async () => ({
+  r.queryHandler({
+    name: "lease:kennzahlen",
+    schema: z.object({}),
+    handler: async () => ({
       debt: "123.456 €",
       debtSub: "nach 10 Jahren",
       debtDelta: "15 %",
@@ -146,13 +146,13 @@ export const rentalFeature = defineFeature("rental", (r) => {
       rent: "48.200 €",
       rentSub: "319 Verträge",
     }),
-    open,
-  );
+    ...open,
+  });
 
-  r.writeHandler(
-    "lease:terminate",
-    idPayloadSchema,
-    async (event, ctx) =>
+  r.writeHandler({
+    name: "lease:terminate",
+    schema: idPayloadSchema,
+    handler: async (event, ctx) =>
       leaseExecutor.update(
         {
           id: event.payload.id,
@@ -165,13 +165,13 @@ export const rentalFeature = defineFeature("rental", (r) => {
         ctx.db,
         { skipOptimisticLock: true },
       ),
-    open,
-  );
+    ...open,
+  });
 
-  r.writeHandler(
-    "lease:record-positions",
-    recordPositionsPayloadSchema,
-    async (event, ctx) => {
+  r.writeHandler({
+    name: "lease:record-positions",
+    schema: recordPositionsPayloadSchema,
+    handler: async (event, ctx) => {
       let created: Awaited<ReturnType<typeof positionExecutor.create>> | undefined;
       const unitLabels = new Map<string, string | null | undefined>();
       for (const unitId of new Set(event.payload.items.map((item) => item.unit))) {
@@ -189,13 +189,13 @@ export const rentalFeature = defineFeature("rental", (r) => {
       }
       return created ?? failNotFound("leasePosition", event.payload.lease);
     },
-    open,
-  );
+    ...open,
+  });
 
-  r.writeHandler(
-    "rent:adjust",
-    rentAdjustPayloadSchema,
-    async (event, ctx) => {
+  r.writeHandler({
+    name: "rent:adjust",
+    schema: rentAdjustPayloadSchema,
+    handler: async (event, ctx) => {
       const { positionId, wirksamAb, neuerBetrag } = event.payload;
       const current = await positionExecutor.detail({ id: positionId }, event.user, ctx.db);
       if (!current) return failNotFound("leasePosition", positionId);
@@ -229,8 +229,8 @@ export const rentalFeature = defineFeature("rental", (r) => {
         { skipOptimisticLock: true },
       );
     },
-    open,
-  );
+    ...open,
+  });
 
   r.screen(leaseListScreen);
   r.screen(leaseListShortScreen);

package/samples/apps/ui-walkthrough/src/features/vehicles/feature.ts

@@ -32,10 +32,10 @@ export const vehiclesFeature = defineFeature("vehicles", (r) => {
   r.crud("campaign", campaignEntity, { write: open, read: open });
   r.crud("campaignPost", campaignPostEntity, { write: open, read: open });
 
-  r.writeHandler(
-    "campaign-post:mark-posted",
-    markPostedPayloadSchema,
-    async (event, ctx) => {
+  r.writeHandler({
+    name: "campaign-post:mark-posted",
+    schema: markPostedPayloadSchema,
+    handler: async (event, ctx) => {
       const current = await campaignPostExecutor.detail(
         { id: event.payload.id },
         event.user,
@@ -62,8 +62,8 @@ export const vehiclesFeature = defineFeature("vehicles", (r) => {
         { skipOptimisticLock: true },
       );
     },
-    open,
-  );
+    ...open,
+  });
 
   r.screen(vehicleListScreen);
   r.screen(vehicleEditScreen);

package/samples/apps/use-all-bundled/e2e-billing-gallery/gallery-features.ts

@@ -117,14 +117,14 @@ export const galleryProviderFeature: FeatureDefinition = defineFeature(
   "gallery-mock-provider",
   (r) => {
     r.describe("E2E-only mock subscription provider for the consent/termination gallery.");
-    r.requires("billing-foundation");
+    r.requires({ features: ["billing-foundation"] });
     r.useExtension("subscriptionProvider", GALLERY_PROVIDER, galleryProviderPlugin);
   },
 );
 
 export const galleryScreensFeature: FeatureDefinition = defineFeature("gallery-screens", (r) => {
   r.describe("E2E-only nav entry for the billing plans screen plus plan labels.");
-  r.requires("billing-foundation", "admin-shell");
+  r.requires({ features: ["billing-foundation", "admin-shell"] });
   r.nav({
     id: "billing",
     label: "gallery:nav.billing",

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

@@ -407,7 +407,7 @@
     },
     {
       "name": "channel-email",
-      "description": "Wires an `EmailTransport` (typically `mail-transport-smtp` in production, `createInMemoryTransport()` in tests) into the delivery system as the `email` channel. Requires `delivery`; pass an `EmailChannelOptions` with a `transport` and a `resolveEmail` function that maps a user ID to their email address. Mails render from stored templates (`renderer-mail-html`): a notification routed to this channel needs `template` + `meta` on `r.notification`, otherwise its delivery fails.",
+      "description": "Wires an `EmailTransport` (typically `mail-transport-smtp` in production, `createInMemoryTransport()` in tests) into the delivery system as the `email` channel. Requires `delivery`; pass an `EmailChannelOptions` with a `transport` and a `resolveEmail` function that maps a user ID to their email address. Mails render from stored templates (`renderer-mail-html`): a notification routed to this channel needs `template` + `meta` on `r.notification`, otherwise its delivery fails. Pass `tenantTransport: tenantMailTransport` (from `mail-foundation`) to send each tenant's mail through its own configured provider: a broken provider fails the send, a tenant without one uses the app `transport`. Notifications declared with `unsubscribe: true` get a signed `data.unsubscribeUrl` from delivery, which turns into the `List-Unsubscribe` headers.",
       "toggleableDefault": null,
       "requires": [
         "delivery"
@@ -725,7 +725,7 @@
     },
     {
       "name": "delivery",
-      "description": "The notification dispatch core: call `ctx.notify(notificationType, { to, route, data, priority, idempotencyKey })` from any handler to fan out a notification across all registered channels (email, in-app, push). Inside a write handler the delivery runs after the write has committed (the call returns `{ kind: \"deferred\" }`, a rolled-back write sends nothing); `immediate: true` delivers synchronously and returns `{ kind: \"dispatched\", deliveries }`. It stores per-user channel preferences in the `notification-preference` entity, opt-outs for no-account recipient addresses in `notification-address-opt-out` (keyed by a blind-index hash, never the plaintext address), logs every attempt to `store_delivery_attempts`, and enforces idempotency and rate-limiting — add `channel-email`, `channel-in-app`, or `channel-push` on top to actually send anything. Unsubscribe/resubscribe links are served by `createUnsubscribeRoutes({ secret })` mounted via the app's `extraRoutes` at `/api/delivery/unsubscribe` and `/api/delivery/resubscribe`: `GET /unsubscribe?token=` renders a confirmation page (no write), `POST /unsubscribe` performs the opt-out (RFC 8058 one-click, token from the form body or query), `POST /resubscribe` undoes it (JSON `{token}` or form body only, never the query — reachable by a mail-client link prefetcher) — sign links with `signUnsubscribeToken` / `signAddressUnsubscribeToken` using the same secret. `channel-email` sets `List-Unsubscribe` / `List-Unsubscribe-Post` automatically when a message's `data.unsubscribeUrl` points at the unsubscribe route.",
+      "description": "The notification dispatch core: call `ctx.notify(notificationType, { to, route, data, priority, idempotencyKey })` from any handler to fan out a notification across all registered channels (email, in-app, push). Inside a write handler the delivery runs after the write has committed (the call returns `{ kind: \"deferred\" }`, a rolled-back write sends nothing); `immediate: true` delivers synchronously and returns `{ kind: \"dispatched\", deliveries }`. It stores per-user channel preferences in the `notification-preference` entity, opt-outs for no-account recipient addresses in `notification-address-opt-out` (keyed by a blind-index hash, never the plaintext address), logs every attempt to `store_delivery_attempts`, and enforces idempotency and rate-limiting — add `channel-email`, `channel-in-app`, or `channel-push` on top to actually send anything. Unsubscribe/resubscribe links are served by `createUnsubscribeRoutes({ secret })` mounted via the app's `extraRoutes` at `/api/delivery/unsubscribe` and `/api/delivery/resubscribe`: `GET /unsubscribe?token=` renders a confirmation page (no write), `POST /unsubscribe` performs the opt-out (RFC 8058 one-click, token from the form body or query), `POST /resubscribe` undoes it (JSON `{token}` or form body only, never the query — reachable by a mail-client link prefetcher) — sign links with `signUnsubscribeToken` / `signAddressUnsubscribeToken` using the same secret. `channel-email` sets `List-Unsubscribe` / `List-Unsubscribe-Post` automatically when a message's `data.unsubscribeUrl` points at the unsubscribe route. A notification declared with `unsubscribe: true` gets that link from delivery itself when the service has `unsubscribeLinks` (`runProdApp` option `unsubscribe: { secret }` mounts the routes and wires it; base URL from `auth.publicOrigin`, `auth.mail.baseUrl` or `APP_BASE_URL`): user recipients get a user token, `route` recipients an address token (needs a blind-index key, otherwise no link); a `data.unsubscribeUrl` from the caller wins. `unsubscribe.tenantOrigin: (ctx) => origin | null` points the link at the tenant's own host (subdomain or custom domain, must serve this app's `/api`); null, a throw or a non-https value fall back to the app origin. The token carries the mail's locale, so the confirmation and result pages render in the mail's language. To react to a no-account opt-out (e.g. remove the app's own subscriber row), declare `r.job(name, { trigger: { on: DeliveryHandlers.unsubscribeAddress } }, handler)` on a lane the app consumes: it runs after each committed opt-out, also an idempotent repeat, with `unsubscribeAddressPayloadSchema` (`addressHash`, `notificationType`, `channel`) as payload and the tenant in `ctx.triggeredBy.tenantId`; match the subscriber via `hashUnsubscribeAddress(email)`. Declare `unsubscribeUrl` as an optional template variable if the mail body shows it.",
       "toggleableDefault": null,
       "requires": [
         "tenant"
@@ -1507,7 +1507,7 @@
     },
     {
       "name": "mail-foundation",
-      "description": "Defines the `mailTransport` extension point and a per-tenant `provider` config key that selects which registered transport plugin to use at runtime. Call `createTransportForTenant(ctx, tenantId)` to get an `EmailTransport` ready for sending — use this feature together with at least one `mail-transport-*` feature; use `delivery` + `channel-email` instead when you need the full notification pipeline with delivery attempts and user preferences.",
+      "description": "Defines the `mailTransport` extension point and a per-tenant `provider` config key that selects which registered transport plugin to use at runtime. Call `createTransportForTenant(ctx, tenantId)` to get an `EmailTransport` ready for sending — use this feature together with at least one `mail-transport-*` feature; use `delivery` + `channel-email` instead when you need the full notification pipeline with delivery attempts and user preferences. Pass `tenantMailTransport` as `tenantTransport` to `createChannelEmailFeature` so a tenant with a provider configured sends delivery mails through its own transport and other tenants through the app transport.",
       "toggleableDefault": null,
       "requires": [
         "config"
@@ -2122,7 +2122,7 @@
     },
     {
       "name": "renderer-mail-html",
-      "description": "A `renderer-foundation` plugin that handles `RenderRequest { kind: \"mail\" }` and returns `{ subject, html, text, previewText? }` suitable for sending via `channel-email`. The mail template (`kind: \"mail\"`, document HTML, subject in `meta`) resolves through `template-resolver`'s DB fallback, its body is compiled to Handlebars by template-resolver and rendered with escaping, then placed into an MJML layout (`kind: \"mail-layout\"`, slug `default` unless `meta.layoutSlug` says otherwise, an in-code structured layout with the tenant branding logo and accent color as last resort) that `mjml()` compiles to email-safe table HTML, with `html-to-text` producing the plain-text alternative. An optional `footer` resolver adds the platform imprint, privacy link and footer text below every structured layout, and an optional `brandSuffix` resolver adds a word after the tenant name in the brand row of the in-code layout. Mail meta `headerChip`, `tone` and `footerNote` add a chip beside the brand, the tone of the top line and chip, and a note above the site and unsubscribe links of the card. Seed an editable system layout with `seedSystemMailLayout(db)`. Requires `renderer-foundation` + `template-resolver`.",
+      "description": "A `renderer-foundation` plugin that handles `RenderRequest { kind: \"mail\" }` and returns `{ subject, html, text, previewText? }` suitable for sending via `channel-email`. The mail template (`kind: \"mail\"`, document HTML, subject in `meta`) resolves through `template-resolver`'s DB fallback, its body is compiled to Handlebars by template-resolver and rendered with escaping, then placed into an MJML layout (`kind: \"mail-layout\"`, slug `default` unless `meta.layoutSlug` says otherwise, an in-code structured layout with the tenant branding logo and accent color as last resort) that `mjml()` compiles to email-safe table HTML, with `html-to-text` producing the plain-text alternative. An optional `footer` resolver adds the platform imprint, privacy link and footer text below every structured layout, an optional `brandSuffix` resolver adds a word after the tenant name in the brand row of the in-code layout, and an optional `siteUrl` resolver supplies the site link of the card when the tenant branding has no site URL (without either, the link is left out). The brand row and `data-resource=\"logo\"` images use the branding logo upload, or the branding logo https address when no file is uploaded. Mail meta `headerChip`, `tone` and `footerNote` add a chip beside the brand, the tone of the top line and chip, and a note above the site and unsubscribe links of the card. Seed an editable system layout with `seedSystemMailLayout(db)`. Requires `renderer-foundation` + `template-resolver`.",
       "toggleableDefault": null,
       "requires": [
         "renderer-foundation",

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

@@ -21,6 +21,7 @@
     "@cosmicdrift/kumiko-document-designer": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*",
     "@cosmicdrift/kumiko-headless": "workspace:*",
+    "@cosmicdrift/kumiko-renderer-mail-html": "workspace:*",
     "@cosmicdrift/kumiko-renderer-puppeteer-client": "workspace:*",
     "@cosmicdrift/kumiko-renderer-web": "workspace:*",
     "@cosmicdrift/kumiko-server-runtime": "workspace:*",

package/samples/apps/use-all-bundled/scripts/gen-sample-index.ts

@@ -89,13 +89,13 @@ export function extractFeaturesFromText(rawText: string): Set<string> {
     const name = m[1];
     if (name) feats.add(name);
   }
-  for (const m of text.matchAll(/r\.requires\(\s*["']([a-z0-9-]+)["']/g)) {
-    const name = m[1];
-    if (name) feats.add(name);
-  }
-  for (const m of text.matchAll(/r\.optionalRequires\(\s*["']([a-z0-9-]+)["']/g)) {
-    const name = m[1];
-    if (name) feats.add(name);
+  for (const m of text.matchAll(
+    /r\.(?:requires|optionalRequires)\(\s*\{\s*features:\s*\[([^\]]*)\]/g,
+  )) {
+    for (const quoted of (m[1] ?? "").matchAll(/["']([a-z0-9-]+)["']/g)) {
+      const name = quoted[1];
+      if (name) feats.add(name);
+    }
   }
   return feats;
 }

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

@@ -120,9 +120,9 @@ export const notesFeature: FeatureDefinition = defineFeature("notes-demo", (r) =
   r.describe(
     "Dev-only host entity demonstrating tags, custom-fields, and folders on a real entityEdit screen.",
   );
-  r.requires("tags");
-  r.requires("custom-fields");
-  r.requires("folders");
+  r.requires({ features: ["tags"] });
+  r.requires({ features: ["custom-fields"] });
+  r.requires({ features: ["folders"] });
 
   wireCustomFieldsFor(r, "note", noteTable);
 

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

@@ -9,7 +9,7 @@ import { defineFeature, type FeatureDefinition } from "@cosmicdrift/kumiko-frame
 
 export const appScreensFeature: FeatureDefinition = defineFeature("app-screens", (r) => {
   r.describe("App-side nav placement for the user-profile self-service page.");
-  r.requires("user-profile");
+  r.requires({ features: ["user-profile"] });
   r.nav({
     id: "profile",
     label: "screen:profile.title",