@cosmicdrift/kumiko-samples 0.338.0

package/samples/apps/use-all-bundled/schema/generate.ts

@@ -0,0 +1,577 @@
+#!/usr/bin/env bun
+// @runtime dev
+// biome-ignore-all lint/suspicious/noConsole: CLI-Script, console ist Feature.
+//
+// Regeneriert schema.generated.ts (Entity-Tables) für die use-all-bundled
+// Smoke-App. Pattern aus einer vergleichbaren Studio-App adaptiert auf
+// die 29 bundled-features die hier gemountet sind (siehe ../src/run-config.ts).
+//
+// Usage:
+//   bun run schema/generate.ts
+//
+// Output: schema/schema.generated.ts.
+// Erweitern wenn use-all-bundled ein neues bundled-Feature mountet:
+// FEATURE_IMPORT_REGISTRY hier ergänzen. Memory-würdig dass die Liste
+// mit run-config.ts in Sync bleibt — wird in M5 als Lint-Guard verdrahtet.
+
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { composeFeatures } from "@cosmicdrift/kumiko-server-runtime/compose-features";
+import { APP_FEATURES, AUTH_COMPOSE_OPTIONS } from "../src/run-config";
+
+type FeatureImport = (
+  | {
+      readonly kind: "factory";
+      readonly path: string;
+      readonly factory: string;
+      // Literal args rendered inside the factory call, for factories with a
+      // required parameter (e.g. managed-pages' resolveApexTenant). Only the
+      // entity shape is consumed here, so a no-op stub is sufficient.
+      readonly defaultArgs?: string;
+    }
+  | {
+      readonly kind: "named";
+      readonly path: string;
+      readonly exportName: string;
+    }
+) & {
+  readonly projectionTables?: readonly string[];
+};
+
+const FEATURE_IMPORT_REGISTRY: Record<string, FeatureImport> = {
+  config: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/config",
+    factory: "createConfigFeature",
+  },
+  user: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/user",
+    factory: "createUserFeature",
+  },
+  tenant: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/tenant",
+    factory: "createTenantFeature",
+  },
+  secrets: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/secrets",
+    factory: "createSecretsFeature",
+  },
+  sessions: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/sessions",
+    factory: "createSessionsFeature",
+  },
+  "personal-access-tokens": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/personal-access-tokens",
+    factory: "createPersonalAccessTokensFeature",
+    defaultArgs: "{ scopes: {} }",
+  },
+  // Owns the tokenVerifier extension-point personal-access-tokens registers
+  // against. No r.entity → generate.ts skips it silently. Listed for
+  // schema-check ↔ mounted-set consistency (kumiko-framework#1369).
+  "auth-foundation": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/auth-foundation",
+    exportName: "authFoundationFeature",
+  },
+  // auth-email-password auto-mounted via composeFeatures(includeBundled:true).
+  // Kein r.entity → generate.ts skipt silent. Listed für schema-check ↔
+  // mounted-set Konsistenz.
+  "auth-email-password": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/auth-email-password",
+    factory: "createAuthEmailPasswordFeature",
+  },
+  // Companion toggle auto-mounted by composeFeatures when authOptions.signup
+  // is set (#1521). No r.entity — listed for schema-check parity.
+  "auth-self-registration": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/auth-email-password",
+    factory: "createAuthSelfRegistrationToggleFeature",
+  },
+  // Opt-in German copy. No r.entity — listed for schema-check ↔ mounted-set.
+  "locale-de": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-locale-de",
+    factory: "localeDe",
+  },
+  "auth-mfa": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/auth-mfa",
+    factory: "createAuthMfaFeature",
+    defaultArgs:
+      '{ setupTokenSecret: "stub-setup-secret-at-least-32-bytes-long!!", challengeTokenSecret: "stub-challenge-secret-at-least-32-bytes!!", issuer: "stub" }',
+  },
+  delivery: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/delivery",
+    factory: "createDeliveryFeature",
+    projectionTables: ["deliveryAttemptsTable"],
+  },
+  "channel-in-app": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/channel-in-app",
+    factory: "createChannelInAppFeature",
+  },
+  "mail-foundation": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/mail-foundation",
+    exportName: "mailFoundationFeature",
+  },
+  "mail-transport-inmemory": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory",
+    exportName: "mailTransportInMemoryFeature",
+  },
+  "inbound-mail-foundation": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation",
+    exportName: "inboundMailFoundationFeature",
+    projectionTables: [
+      "mailAccountsProjectionTable",
+      "inboundMessagesProjectionTable",
+      "mailThreadsProjectionTable",
+    ],
+  },
+  "inbound-provider-imap": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/inbound-provider-imap",
+    exportName: "inboundProviderImapFeature",
+  },
+  "inbound-provider-inmemory": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/inbound-provider-inmemory",
+    exportName: "inboundProviderInMemoryFeature",
+  },
+  "file-foundation": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/file-foundation",
+    exportName: "fileFoundationFeature",
+  },
+  "file-provider-inmemory": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory",
+    exportName: "fileProviderInMemoryFeature",
+  },
+  "file-derivatives": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/file-derivatives",
+    exportName: "fileDerivativesFeature",
+  },
+  "derivatives-sharp": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/derivatives-sharp",
+    exportName: "derivativesSharpFeature",
+  },
+  "file-provider-s3-env": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/file-provider-s3-env",
+    exportName: "fileProviderS3EnvFeature",
+  },
+  files: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/files",
+    factory: "createFilesFeature",
+  },
+  "files-tenant-data": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/files-tenant-data",
+    factory: "createFilesTenantDataFeature",
+  },
+  "billing-foundation": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/billing-foundation",
+    exportName: "billingFoundationFeature",
+    projectionTables: ["subscriptionsProjectionTable"],
+  },
+  "tier-engine": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/tier-engine",
+    exportName: "tierEngineFeature",
+  },
+  // cap-overview: no r.entity of its own (reads tier-engine/billing-
+  // foundation/tenant + caller-supplied CapSpec callbacks) — this entry
+  // never renders into schema.generated.ts, listed only for check-coverage
+  // ↔ mounted-set consistency. defaultArgs mirrors run-config.ts's real
+  // CAP_OVERVIEW_CAPS shape so it stays buildable if entities are added later.
+  "cap-overview": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/cap-overview",
+    factory: "createCapOverviewFeature",
+    defaultArgs: '{ caps: [{ id: "stub", label: "stub", limit: () => 0, usage: async () => 0 }] }',
+  },
+  // cap-overview-labels: app-local, translations only for the example
+  // cap ids this sample chose — same pattern as collection-labels below.
+  "cap-overview-labels": {
+    kind: "named",
+    path: "../src/app/cap-overview-labels-feature",
+    exportName: "capOverviewLabelsFeature",
+  },
+  // metrics / metrics-system: no entities, so they never render into
+  // schema.generated.ts; the empty metric list is a build stub only.
+  metrics: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/metrics",
+    factory: "createMetricsFeature",
+    defaultArgs: "{ metrics: [] }",
+  },
+  "metrics-system": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/metrics",
+    factory: "createSystemMetricsFeature",
+    defaultArgs: "{ metrics: [] }",
+  },
+  "cap-counter": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/cap-counter",
+    exportName: "capCounterFeature",
+  },
+  jobs: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/jobs",
+    factory: "createJobsFeature",
+    projectionTables: ["jobRunsTable", "jobRunLogsTable"],
+  },
+  "step-dispatcher": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/step-dispatcher",
+    factory: "createStepDispatcherFeature",
+  },
+  "compliance-profiles": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/compliance-profiles",
+    factory: "createComplianceProfilesFeature",
+  },
+  "tenant-lifecycle": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/tenant-lifecycle",
+    factory: "createTenantLifecycleFeature",
+  },
+  // No r.entity of its own — it reads OTHER entities' `transferable`/
+  // `parentRef` declarations off the registry. generate.ts skips it
+  // silently; listed for schema-check ↔ mounted-set parity.
+  "tenant-handover": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/tenant-handover",
+    factory: "createTenantHandoverFeature",
+  },
+  "data-retention": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/data-retention",
+    factory: "createDataRetentionFeature",
+  },
+  "user-data-rights": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/user-data-rights",
+    factory: "createUserDataRightsFeature",
+  },
+  "user-data-rights-defaults": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/user-data-rights-defaults",
+    factory: "createUserDataRightsDefaultsFeature",
+  },
+  "user-profile": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/user-profile",
+    factory: "createUserProfileFeature",
+  },
+  "legal-pages": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/legal-pages",
+    factory: "createLegalPagesFeature",
+  },
+  "managed-pages": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/managed-pages",
+    factory: "createManagedPagesFeature",
+    defaultArgs: "{ resolveApexTenant: () => null, allowCustomCss: true }",
+  },
+  seo: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/seo",
+    factory: "createSeoFeature",
+    defaultArgs: "{ sitemapEntries: () => [], includeLegalPages: true }",
+  },
+  // Mounted in run-config (#1581); coverage lint requires registry parity.
+  "tenant-settings": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/tenant-settings",
+    factory: "createTenantSettingsFeature",
+  },
+  "template-resolver": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/template-resolver",
+    factory: "createTemplateResolverFeature",
+  },
+  "renderer-foundation": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/renderer-foundation",
+    factory: "createRendererFoundationFeature",
+  },
+  "renderer-simple": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/renderer-simple",
+    factory: "createRendererSimpleFeature",
+  },
+  "rate-limiting": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/rate-limiting",
+    factory: "createRateLimitingFeature",
+  },
+  audit: {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/audit",
+    factory: "createAuditFeature",
+  },
+  // admin-shell: workspaces + nav only, kein r.entity → generate.ts skipt
+  // silent. Listed für schema-check ↔ mounted-set Konsistenz.
+  "admin-shell": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/admin-shell",
+    factory: "createAdminShellFeature",
+  },
+  // agent-tools: tool catalog + boot-time doc lint only, no r.entity — the
+  // generator skips it and it is listed purely for the schema-check ↔
+  // mounted-set consistency.
+  "agent-tools": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/agent-tools",
+    factory: "createAgentToolsFeature",
+  },
+  // compliance-profiles-ops: just a cross-tenant read on tenant/
+  // compliance-profiles, no own r.entity → generate.ts skips silently.
+  "compliance-profiles-ops": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/compliance-profiles-ops",
+    exportName: "complianceProfilesOpsFeature",
+  },
+  "crypto-shredding": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/crypto-shredding",
+    factory: "createCryptoShreddingFeature",
+  },
+  "custom-fields": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/custom-fields",
+    exportName: "customFieldsFeature",
+  },
+  tags: {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/tags",
+    exportName: "tagsFeature",
+  },
+  "notes-history": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/notes-history",
+    exportName: "notesHistoryFeature",
+  },
+  "notes-history-user-data": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/notes-history-user-data",
+    exportName: "notesHistoryUserDataFeature",
+  },
+  "form-draft": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/form-draft",
+    exportName: "formDraftFeature",
+  },
+  "form-draft-user-data": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/form-draft-user-data",
+    exportName: "formDraftUserDataFeature",
+  },
+  "template-resolver-user-data": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/template-resolver-user-data",
+    exportName: "templateResolverUserDataFeature",
+  },
+  // collection-labels: app-local, translations only, kein r.entity →
+  // generate.ts skipt silent. Listed für schema-check ↔ mounted-set Konsistenz.
+  "collection-labels": {
+    kind: "named",
+    path: "../src/app/collection-labels-feature",
+    exportName: "collectionLabelsFeature",
+  },
+  folders: {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/folders",
+    exportName: "foldersFeature",
+  },
+  "folders-user-data": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/folders-user-data",
+    exportName: "foldersUserDataFeature",
+  },
+  "auth-mfa-user-data": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/auth-mfa-user-data",
+    exportName: "authMfaUserDataFeature",
+  },
+  ledger: {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/ledger",
+    exportName: "ledgerFeature",
+  },
+  "document-ingest-foundation": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/document-ingest-foundation",
+    exportName: "documentIngestFoundationFeature",
+  },
+  // workflow-runner: no r.entity/MSPs/handlers → generate.ts skips it
+  // silently. Listed for schema-check ↔ mounted-set consistency.
+  "workflow-runner": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/workflow-runner",
+    exportName: "workflowRunnerFeature",
+  },
+  // M0.1 hold-back features. Meist keine eigenen entities/projection-tables
+  // (generate.ts skipt sie silent in der entity-loop) — gelistet für
+  // check-coverage.ts (Maintenance-Lint M5 erwartet jeden mounted
+  // feature-export im Registry). Ausnahme: feature-toggles trägt die
+  // Store-Table store_global_feature_state (r.storeTable, siehe
+  // global-feature-state-table.ts) — der projectionTables-Key hier steuert
+  // nur den Drizzle-Schema-Export, ist keine echte Projection.
+  "channel-email": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/channel-email",
+    factory: "createChannelEmailFeature",
+  },
+  "channel-push": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/channel-push",
+    factory: "createChannelPushFeature",
+  },
+  readiness: {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/readiness",
+    exportName: "readinessFeature",
+  },
+  "mail-transport-smtp": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/mail-transport-smtp",
+    exportName: "mailTransportSmtpFeature",
+  },
+  "file-provider-s3": {
+    kind: "named",
+    path: "@cosmicdrift/kumiko-bundled-features/file-provider-s3",
+    exportName: "fileProviderS3Feature",
+  },
+  "subscription-stripe": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/subscription-stripe",
+    factory: "createSubscriptionStripeFeature",
+  },
+  "subscription-mollie": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/subscription-mollie",
+    factory: "createSubscriptionMollieFeature",
+  },
+  "feature-toggles": {
+    kind: "factory",
+    path: "@cosmicdrift/kumiko-bundled-features/feature-toggles",
+    factory: "createFeatureTogglesFeature",
+    projectionTables: ["globalFeatureStateTable"],
+  },
+};
+
+const features = composeFeatures([...APP_FEATURES], {
+  includeBundled: true,
+  authOptions: AUTH_COMPOSE_OPTIONS,
+});
+
+const importLines: string[] = [
+  'import { buildEntityTable } from "@cosmicdrift/kumiko-framework/db";',
+];
+const constLines: string[] = [];
+const seenFeature = new Set<string>();
+const featureVarNames = new Map<string, string>();
+const projectionTableReexports: Array<{
+  readonly path: string;
+  readonly tables: readonly string[];
+}> = [];
+
+for (const feature of features) {
+  const hasEntities = Object.keys(feature.entities).length > 0;
+  const entry = FEATURE_IMPORT_REGISTRY[feature.name];
+  const hasProjectionTables = entry !== undefined && (entry.projectionTables?.length ?? 0) > 0;
+  if (!hasEntities && !hasProjectionTables) continue;
+  if (seenFeature.has(feature.name)) continue;
+  seenFeature.add(feature.name);
+
+  if (!entry) {
+    throw new Error(
+      `schema/generate.ts: feature "${feature.name}" has no import entry. ` +
+        `Add it to FEATURE_IMPORT_REGISTRY at the top of this file.`,
+    );
+  }
+
+  if (hasEntities) {
+    const varName = toIdent(`_${feature.name}`);
+    featureVarNames.set(feature.name, varName);
+    if (entry.kind === "factory") {
+      importLines.push(`import { ${entry.factory} } from "${entry.path}";`);
+      constLines.push(`const ${varName} = ${entry.factory}(${entry.defaultArgs ?? ""});`);
+    } else {
+      importLines.push(`import { ${entry.exportName} } from "${entry.path}";`);
+      constLines.push(`const ${varName} = ${entry.exportName};`);
+    }
+  }
+
+  if (hasProjectionTables && entry.projectionTables) {
+    projectionTableReexports.push({
+      path: entry.path,
+      tables: entry.projectionTables,
+    });
+  }
+}
+
+const lines: string[] = [
+  "// Auto-generated by schema/generate.ts — DO NOT EDIT",
+  "// Re-run: bun run schema/generate.ts",
+  "// biome-ignore-all format: generated output",
+  "// biome-ignore-all assist/source/organizeImports: generated output",
+  "// biome-ignore-all lint/style/noNonNullAssertion: generated output — entity-lookup ist immer present per registry-contract",
+  "",
+  ...importLines,
+  "",
+  ...constLines,
+  "",
+];
+
+let entityCount = 0;
+const seenEntityFeature = new Set<string>();
+for (const feature of features) {
+  const varName = featureVarNames.get(feature.name);
+  if (!varName) continue;
+  if (seenEntityFeature.has(feature.name)) continue;
+  seenEntityFeature.add(feature.name);
+  for (const entityName of Object.keys(feature.entities)) {
+    const exportName = `${toIdent(entityName)}Table`;
+    lines.push(
+      `export const ${exportName} = buildEntityTable("${entityName}", ${varName}.entities["${entityName}"]!);`,
+    );
+    entityCount++;
+  }
+}
+
+let projectionTableCount = 0;
+for (const { path, tables } of projectionTableReexports) {
+  lines.push(`export { ${tables.join(", ")} } from "${path}";`);
+  projectionTableCount += tables.length;
+}
+
+lines.push("");
+
+const outPath = resolve(import.meta.dir, "schema.generated.ts");
+writeFileSync(outPath, lines.join("\n"), "utf-8");
+console.log(
+  `  Entity-Tables: ${entityCount} + Projection-Tables: ${projectionTableCount} → schema.generated.ts`,
+);
+
+function toIdent(name: string): string {
+  return name.replace(/-([a-z0-9])/g, (_, c: string) => c.toUpperCase());
+}