@cosmicdrift/kumiko-samples 0.378.0 → 0.379.0

package/packages/bundled-features/src/compliance-profiles/web/index.ts

@@ -1,4 +1,3 @@
-// @runtime client
 export {
   type ComplianceProfilesClientOptions,
   complianceProfilesClient,

package/packages/bundled-features/src/config/index.ts

@@ -4,12 +4,6 @@ import type { Registry } from "@cosmicdrift/kumiko-framework/engine";
 import type { EnvelopeCipher } from "@cosmicdrift/kumiko-framework/secrets";
 import { configValueEntity, configValuesTable } from "./table.ts";
 
-export {
-  CONFIG_FEATURE,
-  ConfigErrors,
-  ConfigHandlers,
-  ConfigQueries,
-} from "./constants.ts";
 export type { ConfigContext } from "./feature.ts";
 export {
   createConfigAccessor,
@@ -24,6 +18,12 @@ export {
 export type { AppConfigOverrides, ConfigResolver } from "./resolver.ts";
 export { buildEnvConfigOverrides, createConfigResolver, validateAppOverrides } from "./resolver.ts";
 export { configValueEntity, configValuesTable } from "./table.ts";
+export {
+  CONFIG_FEATURE,
+  ConfigErrors,
+  ConfigHandlers,
+  ConfigQueries,
+} from "./web/constants.ts";
 
 // Boot helper for runDevApp / runProdApp: pulls every ConfigSeedDef from
 // the registry and writes the matching system/tenant/user rows via the

package/packages/bundled-features/src/config/web/client-plugin.ts

@@ -1,6 +1,5 @@
-// @runtime client
 import { mergeTranslations, type TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
-import { CONFIG_FEATURE } from "../constants.ts";
+import { CONFIG_FEATURE } from "./constants.ts";
 import { defaultTranslations } from "./i18n.ts";
 
 export type ConfigClientOptions = {

package/packages/bundled-features/src/config/{constants.ts → web/constants.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // Pure name/string constants — browser-safe, importable from web client code
 // (configClient() pins its feature name to CONFIG_FEATURE).
 export const CONFIG_FEATURE = "config" as const;

package/packages/bundled-features/src/config/web/i18n.ts

@@ -1,4 +1,3 @@
-// @runtime client
 // Default labels for the auto-generated Settings-Hub. The generator
 // (buildConfigFeatureSchema) emits `config.settings.<scope>` for the audience
 // groups and `config.settings.title` for the synthetic workspace — generic

package/packages/bundled-features/src/config/web/index.ts

@@ -1,9 +1,7 @@
-// @runtime client
-
-export { ConfigQueries } from "../constants.ts";
 export {
   type ConfigClientFeature,
   type ConfigClientOptions,
   configClient,
 } from "./client-plugin.ts";
+export { ConfigQueries } from "./constants.ts";
 export { defaultTranslations } from "./i18n.ts";

package/packages/bundled-features/src/config/write-helpers.ts

@@ -30,9 +30,9 @@ import {
 } from "@cosmicdrift/kumiko-framework/errors";
 import type { EnvelopeCipher } from "@cosmicdrift/kumiko-framework/secrets";
 import { assertUnreachable } from "@cosmicdrift/kumiko-framework/utils";
-import { ConfigErrors } from "./constants.ts";
 import { decryptStoredValue } from "./resolver.ts";
 import { configValuesTable } from "./table.ts";
+import { ConfigErrors } from "./web/constants.ts";
 
 export type ConfigRowLookup = {
   readonly id: string;

package/packages/bundled-features/src/custom-fields/feature.ts

@@ -53,14 +53,6 @@ import {
   type WriteHandlerDef,
 } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
-import {
-  CUSTOM_FIELD_CLEARED_EVENT,
-  CUSTOM_FIELD_SET_EVENT,
-  CUSTOM_FIELDS_EXTENSION,
-  CUSTOM_FIELDS_FEATURE_NAME,
-  DEFAULT_FIELD_DEFINITION_LIST_ROLES,
-  FIELD_DEFINITION_DELETED_EVENT,
-} from "./constants.ts";
 import { fieldDefinitionEntity } from "./entity.ts";
 import { customFieldClearedSchema, customFieldSetSchema } from "./events.ts";
 import {
@@ -85,6 +77,14 @@ import {
   createUpdateTenantFieldHandler,
   updateTenantFieldHandler,
 } from "./handlers/update-tenant-field.write.ts";
+import {
+  CUSTOM_FIELD_CLEARED_EVENT,
+  CUSTOM_FIELD_SET_EVENT,
+  CUSTOM_FIELDS_EXTENSION,
+  CUSTOM_FIELDS_FEATURE_NAME,
+  DEFAULT_FIELD_DEFINITION_LIST_ROLES,
+  FIELD_DEFINITION_DELETED_EVENT,
+} from "./web/constants.ts";
 
 const fieldDefinitionDeletedSchema = z.object({
   entityName: z.string(),

package/packages/bundled-features/src/custom-fields/handlers/clear-custom-field.write.ts

@@ -1,9 +1,9 @@
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { failNotFound, failUnprocessable } from "@cosmicdrift/kumiko-framework/errors";
 import * as z from "zod";
-import { DEFAULT_VALUE_WRITE_ROLES } from "../constants.ts";
 import { createCustomFieldsFeature } from "../feature.ts";
 import { checkFieldAccessForWrite } from "../lib/field-access.ts";
+import { DEFAULT_VALUE_WRITE_ROLES } from "../web/constants.ts";
 
 export const clearCustomFieldPayloadSchema = z.object({
   entityName: z.string().min(1).max(64),

package/packages/bundled-features/src/custom-fields/handlers/define-tenant-field.write.ts

@@ -1,11 +1,11 @@
 import { isSystemTenant, type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { failUnprocessable } from "@cosmicdrift/kumiko-framework/errors";
 import { fieldDefinitionAggregateId } from "../aggregate-id.ts";
-import { DEFAULT_FIELD_DEFINITION_WRITE_ROLES } from "../constants.ts";
 import { defineOrResurrectFieldDefinition } from "../lib/define-or-resurrect.ts";
 import { buildFieldDefinitionColumns } from "../lib/field-definition-row.ts";
 import { countTenantFieldDefinitions } from "../lib/quota.ts";
 import { type DefineFieldPayload, defineFieldPayloadSchema } from "../schemas.ts";
+import { DEFAULT_FIELD_DEFINITION_WRITE_ROLES } from "../web/constants.ts";
 
 // define-tenant-field — TenantAdmin definiert eine Custom-Field-Definition
 // für seinen eigenen Tenant. tenantId wird automatisch aus event.user.tenantId

package/packages/bundled-features/src/custom-fields/handlers/delete-system-field.write.ts

@@ -1,10 +1,10 @@
 import { SYSTEM_TENANT_ID, type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { requireForTenant } from "../../shared/index.ts";
 import { fieldDefinitionAggregateId } from "../aggregate-id.ts";
-import { FIELD_DEFINITION_AGGREGATE_TYPE } from "../constants.ts";
 import { fieldDefinitionExecutor } from "../executor.ts";
 import { createCustomFieldsFeature } from "../feature.ts";
 import { type DeleteFieldPayload, deleteFieldPayloadSchema } from "../schemas.ts";
+import { FIELD_DEFINITION_AGGREGATE_TYPE } from "../web/constants.ts";
 
 // delete-system-field — SystemAdmin entfernt eine system-weite Field-
 // Definition. Konsequenz: KEIN Tenant kann mehr neue Werte dafür setzen,

package/packages/bundled-features/src/custom-fields/handlers/delete-tenant-field.write.ts

@@ -1,12 +1,12 @@
 import { isSystemTenant, type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { fieldDefinitionAggregateId } from "../aggregate-id.ts";
-import {
-  DEFAULT_FIELD_DEFINITION_WRITE_ROLES,
-  FIELD_DEFINITION_AGGREGATE_TYPE,
-} from "../constants.ts";
 import { fieldDefinitionExecutor } from "../executor.ts";
 import { createCustomFieldsFeature } from "../feature.ts";
 import { type DeleteFieldPayload, deleteFieldPayloadSchema } from "../schemas.ts";
+import {
+  DEFAULT_FIELD_DEFINITION_WRITE_ROLES,
+  FIELD_DEFINITION_AGGREGATE_TYPE,
+} from "../web/constants.ts";
 
 // delete-tenant-field — TenantAdmin löscht eigene Field-Definition.
 // Spec-Promise (Plan-Doc v2 "wie Entity-Delete"): Events bleiben im event-

package/packages/bundled-features/src/custom-fields/handlers/set-custom-field.write.ts

@@ -1,10 +1,10 @@
 import type { WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { failNotFound, failUnprocessable } from "@cosmicdrift/kumiko-framework/errors";
 import * as z from "zod";
-import { DEFAULT_VALUE_WRITE_ROLES } from "../constants.ts";
 import { createCustomFieldsFeature } from "../feature.ts";
 import { fieldWriteAccessDeniedRoles, loadFieldDefinition } from "../lib/field-access.ts";
 import { buildCustomFieldValueSchema } from "../lib/value-schema.ts";
+import { DEFAULT_VALUE_WRITE_ROLES } from "../web/constants.ts";
 
 export const setCustomFieldPayloadSchema = z.object({
   entityName: z.string().min(1).max(64),

package/packages/bundled-features/src/custom-fields/handlers/update-tenant-field.write.ts

@@ -1,10 +1,10 @@
 import { isSystemTenant, type WriteHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
 import { failNotFound, failUnprocessable } from "@cosmicdrift/kumiko-framework/errors";
 import { fieldDefinitionAggregateId } from "../aggregate-id.ts";
-import { DEFAULT_FIELD_DEFINITION_WRITE_ROLES } from "../constants.ts";
 import { fieldDefinitionExecutor } from "../executor.ts";
 import { buildFieldDefinitionColumns } from "../lib/field-definition-row.ts";
 import { fieldTypeSchema, type UpdateFieldPayload, updateFieldPayloadSchema } from "../schemas.ts";
+import { DEFAULT_FIELD_DEFINITION_WRITE_ROLES } from "../web/constants.ts";
 
 // update-tenant-field: a TenantAdmin replaces the state of an existing field
 // definition (full replacement: payload shape = define except that

package/packages/bundled-features/src/custom-fields/index.ts

@@ -1,12 +1,4 @@
 export { fieldDefinitionAggregateId } from "./aggregate-id.ts";
-export {
-  CUSTOM_FIELDS_EXTENSION,
-  CUSTOM_FIELDS_FEATURE_NAME,
-  FIELD_DEFINITION_CREATED_EVENT,
-  FIELD_DEFINITION_UPDATED_EVENT,
-  SUPPORTED_FIELD_TYPES,
-  type SupportedFieldType,
-} from "./constants.ts";
 export { fieldDefinitionEntity } from "./entity.ts";
 export {
   type CustomFieldClearedPayload,
@@ -36,4 +28,12 @@ export {
   defineFieldPayloadSchema,
   deleteFieldPayloadSchema,
 } from "./schemas.ts";
+export {
+  CUSTOM_FIELDS_EXTENSION,
+  CUSTOM_FIELDS_FEATURE_NAME,
+  FIELD_DEFINITION_CREATED_EVENT,
+  FIELD_DEFINITION_UPDATED_EVENT,
+  SUPPORTED_FIELD_TYPES,
+  type SupportedFieldType,
+} from "./web/constants.ts";
 export { customFieldsField, wireCustomFieldsFor } from "./wire-for-entity.ts";

package/packages/bundled-features/src/custom-fields/lib/value-schema.ts

@@ -5,7 +5,7 @@ import {
 } from "@cosmicdrift/kumiko-framework/engine";
 import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
 import type * as z from "zod";
-import { SUPPORTED_FIELD_TYPES } from "../constants.ts";
+import { SUPPORTED_FIELD_TYPES } from "../web/constants.ts";
 
 // Builds a Zod schema that validates a custom-field VALUE against its
 // fieldDefinition. Reuses the framework's `fieldToZod` (Builder-Reuse /

package/packages/bundled-features/src/custom-fields/schemas.ts

@@ -1,5 +1,5 @@
 import * as z from "zod";
-import { SUPPORTED_FIELD_TYPES } from "./constants.ts";
+import { SUPPORTED_FIELD_TYPES } from "./web/constants.ts";
 
 // Field-Type-Validator — pinnt valid type-Werte für fieldDefinition.
 export const fieldTypeSchema = z.enum(SUPPORTED_FIELD_TYPES);

package/packages/bundled-features/src/custom-fields/web/client-plugin.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // Client-Feature-Factory für custom-fields. Wird vom App-Code in
 // createKumikoApp({ clientFeatures: [customFieldsClient()] }) eingehängt
 // und registriert die CustomFieldsFormSection unter dem Namen
@@ -12,7 +11,7 @@
 //   ]}
 
 import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
-import { CUSTOM_FIELDS_FEATURE_NAME, CUSTOM_FIELDS_FORM_EXTENSION_NAME } from "../constants.ts";
+import { CUSTOM_FIELDS_FEATURE_NAME, CUSTOM_FIELDS_FORM_EXTENSION_NAME } from "./constants.ts";
 import { CustomFieldsFormSection } from "./custom-fields-form-section.tsx";
 import { defaultTranslations } from "./i18n.ts";
 

package/packages/bundled-features/src/custom-fields/{constants.ts → web/constants.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // custom-fields bundle constants — feature-name + event-names.
 //
 // Spec: kumiko-platform/docs/plans/features/custom-fields.md
@@ -6,10 +5,10 @@
 
 export const CUSTOM_FIELDS_FEATURE_NAME = "custom-fields";
 
-// Qualified handler names (QN format: scope:type:name). Mirror text-
-// content's Handler/Queries object pattern — Clients (z.B. die
-// CustomFieldsFormSection web-component) referenzieren über das Object
-// statt magic-strings.
+// Qualified handler names (QN format: scope:type:name). Mirrors text-
+// content's Handler/Queries object pattern: clients (e.g. the
+// CustomFieldsFormSection web component) reference the object instead of
+// magic strings.
 export const CustomFieldsHandlers = {
   defineTenantField: "custom-fields:write:define-tenant-field",
   defineSystemField: "custom-fields:write:define-system-field",
@@ -37,24 +36,24 @@ export const FIELD_DEFINITION_UPDATED_EVENT = "field-definition.updated";
 // (no dots): qualifyEntityName runs toKebab which collapses dots to dashes.
 export const FIELD_DEFINITION_DELETED_EVENT = "field-definition-deleted";
 
-// Custom-field-VALUE events. Live auf host-aggregate stream (ES-Option-B).
-// Short-names werden via r.defineEvent qualified zu `custom-fields:event:
+// Custom-field VALUE events. They live on the host aggregate stream (ES option B).
+// Short names are qualified via r.defineEvent to `custom-fields:event:
 // custom-field-set` etc. (qualifyEntityName runs toKebab which collapses dots
-// to dashes — so the short-name MUST already be in dash form, otherwise
+// to dashes, so the short name MUST already be in dash form, otherwise
 // handler-built strings won't match the registry key).
 export const CUSTOM_FIELD_SET_EVENT = "custom-field-set";
 export const CUSTOM_FIELD_CLEARED_EVENT = "custom-field-cleared";
 
-// Extension-name für r.useExtension("customFields", "<entity>") — registriert
-// dass eine host-entity Custom-Fields haben darf.
+// Extension name for r.useExtension("customFields", "<entity>"): registers
+// that a host entity may have custom fields.
 export const CUSTOM_FIELDS_EXTENSION = "customFields";
 
-// Default-RBAC der Value-Write- und List-Pfade. Apps mit eigenem Rollen-
-// Vokabular (publicstatus: "Admin"/"Editor" statt "TenantAdmin"/
-// "TenantMember") überschreiben via createCustomFieldsFeature({
-// valueWriteRoles, fieldDefinitionListRoles }) — sonst sind die hart
-// verdrahteten Bundle-QNs, die die CustomFieldsFormSection dispatcht,
-// für jeden App-User access_denied.
+// Default RBAC of the value-write and list paths. Apps with their own role
+// vocabulary (publicstatus: "Admin"/"Editor" instead of "TenantAdmin"/
+// "TenantMember") override via createCustomFieldsFeature({
+// valueWriteRoles, fieldDefinitionListRoles }); otherwise the hard-wired
+// bundle QNs that CustomFieldsFormSection dispatches are access_denied for
+// every app user.
 export const DEFAULT_VALUE_WRITE_ROLES = ["TenantAdmin", "TenantMember"] as const;
 export const DEFAULT_FIELD_DEFINITION_LIST_ROLES = ["TenantAdmin"] as const;
 // Default-RBAC of the definition-CRUD triad (define-/update-/delete-tenant-field,
@@ -64,9 +63,9 @@ export const DEFAULT_FIELD_DEFINITION_LIST_ROLES = ["TenantAdmin"] as const;
 // "TenantAdmin" role (same Role-Naming-Drift as DEFAULT_VALUE_WRITE_ROLES above).
 export const DEFAULT_FIELD_DEFINITION_WRITE_ROLES = ["TenantAdmin"] as const;
 
-// Field-type union — identisch zu Stammfeld-Field-Type-System (Spec Z.59-73:
-// `Identisch zu Entity-Feld-Typen`). Builder-Reuse-Promise: was `r.field.X()`
-// kann, kann eine Custom-Field-Definition auch.
+// Field-type union, identical to the core field type system (spec lines 59-73:
+// `identical to entity field types`). Builder-reuse promise: whatever
+// `r.field.X()` can do, a custom field definition can do too.
 export const SUPPORTED_FIELD_TYPES = [
   "text",
   "number",

package/packages/bundled-features/src/custom-fields/web/custom-fields-form-section.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // CustomFieldsFormSection — extension-section component für entityEdit-
 // Screens. Lädt die fieldDefinition-Liste des Tenants, filtert auf die
 // host-Entity, rendert pro Definition einen typed Input, dispatched
@@ -19,7 +18,7 @@ import {
   useTranslation,
 } from "@cosmicdrift/kumiko-renderer";
 import { type ReactNode, useState } from "react";
-import { CustomFieldsHandlers, CustomFieldsQueries } from "../constants.ts";
+import { CustomFieldsHandlers, CustomFieldsQueries } from "./constants.ts";
 
 type FieldDefinitionRow = {
   readonly id: string;

package/packages/bundled-features/src/custom-fields/web/i18n.ts

@@ -1,4 +1,3 @@
-// @runtime client
 // Default translation bundle for the custom-fields UI. customFieldsClient()
 // hangs it into the LocaleProvider as a fallback bundle — apps override
 // individual keys via `customFieldsClient({ translations })`.

package/packages/bundled-features/src/custom-fields/web/index.ts

@@ -1,8 +1,7 @@
-// @runtime client
+export { customFieldsClient } from "./client-plugin.tsx";
 export {
   CUSTOM_FIELDS_FORM_EXTENSION_NAME,
   CustomFieldsHandlers,
   CustomFieldsQueries,
-} from "../constants.ts";
-export { customFieldsClient } from "./client-plugin.tsx";
+} from "./constants.ts";
 export { CustomFieldsFormSection } from "./custom-fields-form-section.tsx";

package/packages/bundled-features/src/custom-fields/wire-for-entity.ts

@@ -7,16 +7,15 @@ import {
   type TenantId,
 } from "@cosmicdrift/kumiko-framework/engine";
 import type { StoredEvent } from "@cosmicdrift/kumiko-framework/event-store";
-import { CUSTOM_FIELDS_EXTENSION, FIELD_DEFINITION_AGGREGATE_TYPE } from "./constants.ts";
 import {
   clearCustomFieldKey,
   removeCustomFieldKeyForTenant,
   removeCustomFieldKeyFromAllTenants,
   setCustomFieldValue,
 } from "./db/queries/projection.ts";
-
 import type { CustomFieldClearedPayload, CustomFieldSetPayload } from "./events.ts";
 import { createCustomFieldsFeature } from "./feature.ts";
+import { CUSTOM_FIELDS_EXTENSION, FIELD_DEFINITION_AGGREGATE_TYPE } from "./web/constants.ts";
 
 // Helper für entity-definitions — fügt eine `customFields jsonb`-Spalte
 // hinzu. Consumer:

package/packages/bundled-features/src/delivery/address-opt-out.ts

@@ -7,8 +7,8 @@ import {
 import type { SessionUser, TenantId, WriteResult } from "@cosmicdrift/kumiko-framework/engine";
 import { ConflictError, writeFailure } from "@cosmicdrift/kumiko-framework/errors";
 import { generateDeterministicId } from "@cosmicdrift/kumiko-framework/utils";
-import { DeliveryErrors } from "./public-names.ts";
 import { notificationAddressOptOutEntity, notificationAddressOptOutsTable } from "./tables.ts";
+import { DeliveryErrors } from "./web/public-names.ts";
 
 const executor = createEventStoreExecutor(
   notificationAddressOptOutsTable,

package/packages/bundled-features/src/delivery/attempt-log-retention.ts

@@ -1,5 +1,6 @@
 import type { DbConnection } from "@cosmicdrift/kumiko-framework/db";
-import { deleteManyBatched } from "@cosmicdrift/kumiko-framework/db";
+import { selectMany } from "@cosmicdrift/kumiko-framework/db";
+import { deleteRowsWithoutReplayableStream } from "@cosmicdrift/kumiko-framework/event-store";
 import { type PruneEventsOptions, pruneEvents } from "@cosmicdrift/kumiko-framework/pipeline";
 import { deliveryAttemptsTable } from "./tables.ts";
 
@@ -30,11 +31,26 @@ export async function runAttemptLogRetention(
   options: AttemptLogRetentionOptions,
 ): Promise<{ readonly deletedEvents: number; readonly deletedRows: number }> {
   const pruned = await pruneEvents(db, { ...options, aggregateTypes: ["deliveryAttempt"] });
-  const rows = await deleteManyBatched(
-    db,
-    deliveryAttemptsTable,
-    { createdAt: { lt: pruned.cutoff } },
-    { limit: ROW_DELETE_BATCH_SIZE },
-  );
-  return { deletedEvents: pruned.deletedCount, deletedRows: rows.deleted };
+  let deletedRows = 0;
+  let afterId: string | undefined;
+  for (;;) {
+    const page = await selectMany<{ id: string }>(
+      db,
+      deliveryAttemptsTable,
+      {
+        createdAt: { lt: pruned.cutoff },
+        ...(afterId === undefined ? {} : { id: { gt: afterId } }),
+      },
+      { fields: ["id"], orderBy: { col: "id", direction: "asc" }, limit: ROW_DELETE_BATCH_SIZE },
+    );
+    if (page.length === 0) break;
+    const deleted = await deleteRowsWithoutReplayableStream(db, {
+      table: deliveryAttemptsTable,
+      ids: page.map((row) => row.id),
+    });
+    deletedRows += deleted.length;
+    if (page.length < ROW_DELETE_BATCH_SIZE) break;
+    afterId = page[page.length - 1]?.id;
+  }
+  return { deletedEvents: pruned.deletedCount, deletedRows };
 }

package/packages/bundled-features/src/delivery/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Package ships its event-store table catalog",
+    "detail": "kumiko-es-tables.json is included in the published files; no runtime change."
+  },
   {
     "version": "0.372.0",
     "type": "breaking",

package/packages/bundled-features/src/delivery/constants.ts

@@ -1,6 +1,6 @@
 import type { NotifyPriority } from "@cosmicdrift/kumiko-framework/engine";
 import { QnTypes, qn } from "@cosmicdrift/kumiko-framework/engine";
-import { DELIVERY_FEATURE, DeliveryJobNames } from "./public-names.ts";
+import { DELIVERY_FEATURE, DeliveryJobNames } from "./web/public-names.ts";
 
 // Extension-point name for delivery-channel plugins (channel-email,
 // channel-in-app, channel-push, ...).
@@ -26,7 +26,7 @@ export {
   DeliveryQueries,
   DeliveryStatus,
   type DeliveryStatusValue,
-} from "./public-names.ts";
+} from "./web/public-names.ts";
 
 // Single source for claim (delivery-service) and terminal-failure release (jobs).
 export function deliveryIdempotencyRedisKey(tenantId: string, key: string): string {

package/packages/bundled-features/src/delivery/i18n.ts

@@ -4,7 +4,7 @@ import {
   type DeliveryFailureCode,
   type DeliverySkipReason,
 } from "@cosmicdrift/kumiko-framework/engine";
-import { DeliveryStatus, type DeliveryStatusValue } from "./public-names.ts";
+import { DeliveryStatus, type DeliveryStatusValue } from "./web/public-names.ts";
 
 type LocalizedString = { readonly en: string };
 

package/packages/bundled-features/src/delivery/unsubscribe-page.ts

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { mailT } from "@cosmicdrift/kumiko-framework/i18n";
 import { escapeHtml, escapeHtmlAttr } from "@cosmicdrift/kumiko-renderer/headless";
 import type { MailChrome, MailChromeLink } from "../renderer-foundation/index.ts";
-import { DELIVERY_RESUBSCRIBE_PATH, DELIVERY_UNSUBSCRIBE_PATH } from "./public-names.ts";
+import { DELIVERY_RESUBSCRIBE_PATH, DELIVERY_UNSUBSCRIBE_PATH } from "./web/public-names.ts";
 import "./unsubscribe-page-strings.ts";
 
 export type UnsubscribePageState =

package/packages/bundled-features/src/delivery/web/client-plugin.tsx

@@ -1,6 +1,10 @@
-// @runtime client
 import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
 import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
+import { DeliveryChannelCell } from "./delivery-channel-cell.tsx";
+import { DeliveryErrorCell } from "./delivery-error-cell.tsx";
+import { DeliveryStatusCell } from "./delivery-status-cell.tsx";
+import { DeliveryTimeCell } from "./delivery-time-cell.tsx";
+import { DeliveryTypeCell } from "./delivery-type-cell.tsx";
 import {
   DELIVERY_CHANNEL_CELL_COMPONENT,
   DELIVERY_ERROR_CELL_COMPONENT,
@@ -8,12 +12,7 @@ import {
   DELIVERY_STATUS_CELL_COMPONENT,
   DELIVERY_TIME_CELL_COMPONENT,
   DELIVERY_TYPE_CELL_COMPONENT,
-} from "../public-names.ts";
-import { DeliveryChannelCell } from "./delivery-channel-cell.tsx";
-import { DeliveryErrorCell } from "./delivery-error-cell.tsx";
-import { DeliveryStatusCell } from "./delivery-status-cell.tsx";
-import { DeliveryTimeCell } from "./delivery-time-cell.tsx";
-import { DeliveryTypeCell } from "./delivery-type-cell.tsx";
+} from "./public-names.ts";
 
 export type DeliveryClientOptions = {
   readonly translations?: TranslationsByLocale;

package/packages/bundled-features/src/delivery/web/delivery-channel-cell.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // Channel column: the label comes from `delivery.channel.<name>`, registered by each
 // channel feature; unknown channels show their raw name.
 

package/packages/bundled-features/src/delivery/web/delivery-error-cell.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // Error column. The log only carries fixed codes (`DeliveryErrorCode`); `http_<status>`
 // takes the status as a parameter, anything unknown shows as the raw value.
 

package/packages/bundled-features/src/delivery/web/delivery-status-cell.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // Column-renderer for the delivery-log screen's status column, registered
 // via `deliveryClient()`'s `columnRenderers` map (screen.columns[].renderer
 // in feature.ts). The list frame itself is the generic declarative
@@ -8,7 +7,7 @@ import { type ColumnRendererProps, useTranslation } from "@cosmicdrift/kumiko-re
 import { StatusBadge, type StatusTone } from "@cosmicdrift/kumiko-renderer/web";
 import type { ReactNode } from "react";
 import { translateOrRaw } from "../../shared/web/translate-or-raw.ts";
-import { DeliveryStatus } from "../public-names.ts";
+import { DeliveryStatus } from "./public-names.ts";
 
 const STATUS_TONE: Readonly<Record<string, StatusTone>> = {
   [DeliveryStatus.sent]: "ok",

package/packages/bundled-features/src/delivery/web/delivery-time-cell.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 import { type ColumnRendererProps, formatWhen } from "@cosmicdrift/kumiko-renderer";
 import type { ReactNode } from "react";
 

package/packages/bundled-features/src/delivery/web/delivery-type-cell.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // Notification type column. Types are QNs like `<scope>:notify:<name>`; the
 // translation key is `<scope>.notification.<name>`, registered by the app that
 // owns the notification (bundled features register none). Falls back to the short

package/packages/bundled-features/src/delivery/web/index.ts

@@ -1,3 +1,2 @@
-// @runtime client
 export { type DeliveryClientOptions, deliveryClient } from "./client-plugin.tsx";
 export { DeliveryStatusCell } from "./delivery-status-cell.tsx";

package/packages/bundled-features/src/delivery/{public-names.ts → web/public-names.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // String-only delivery QNs and screen ids — safe for client bundles.
 
 export const DELIVERY_FEATURE = "delivery" as const;

package/packages/bundled-features/src/document-ingest-foundation/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "documentExtract projection survives a rebuild",
+    "detail": "DOCUMENT_EXTRACT_AGGREGATE_TYPE is exported, and the documentExtract entity projection applies the stored document-extract.* events, so rebuildProjection restores the rows. No event is rewritten."
+  },
   {
     "version": "0.370.0",
     "type": "breaking",

package/packages/bundled-features/src/document-ingest-foundation/events.ts

@@ -8,6 +8,10 @@ import * as z from "zod";
 // worker job (kumiko-enterprise LiteParse provider) subscribes to.
 export const DOCUMENT_INGEST_AGGREGATE_TYPE = "document-ingest";
 
+// Stream name of stored extract events; differs from the camelCase r.entity name
+// "documentExtract", so the projection replays this stream through an extension.
+export const DOCUMENT_EXTRACT_AGGREGATE_TYPE = "document-extract";
+
 export const DOCUMENT_INGEST_REQUESTED_EVENT_SHORT = "documentIngest.requested" as const;
 
 // Qualified name — what ctx.unsafeAppendEvent's `type` actually needs

package/packages/bundled-features/src/document-ingest-foundation/executor.ts

@@ -4,9 +4,10 @@
 
 import { createEventStoreExecutor } from "@cosmicdrift/kumiko-framework/db";
 import { documentExtractEntity, documentExtractsTable } from "./entity.ts";
+import { DOCUMENT_EXTRACT_AGGREGATE_TYPE } from "./events.ts";
 
 export const documentExtractExecutor = createEventStoreExecutor(
   documentExtractsTable,
   documentExtractEntity,
-  { entityName: "document-extract" },
+  { entityName: DOCUMENT_EXTRACT_AGGREGATE_TYPE },
 );