@cosmicdrift/kumiko-dev-server 0.129.0 → 0.130.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.129.0",
+  "version": "0.130.0",
   "description": "Development server bootstrap for Kumiko apps. Bundles the client, mints dev-JWTs, injects the resolved AppSchema, and seeds an admin. Not for production.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -30,6 +30,14 @@
       "types": "./src/compose-features.ts",
       "default": "./src/compose-features.ts"
     },
+    "./compose-stacks": {
+      "types": "./src/compose-stacks.ts",
+      "default": "./src/compose-stacks.ts"
+    },
+    "./setup-test-stack-from-features": {
+      "types": "./src/setup-test-stack-from-features.ts",
+      "default": "./src/setup-test-stack-from-features.ts"
+    },
     "./schema-apply": {
       "types": "./src/schema-apply.ts",
       "default": "./src/schema-apply.ts"
@@ -50,8 +58,8 @@
     "kumiko-schema-check": "./bin/kumiko-schema-check.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.129.0",
-    "@cosmicdrift/kumiko-framework": "0.129.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.130.0",
+    "@cosmicdrift/kumiko-framework": "0.130.0",
     "ts-morph": "^28.0.0"
   },
   "publishConfig": {

package/src/__tests__/compose-stacks.test.ts

@@ -0,0 +1,156 @@
+import { describe, expect, test } from "bun:test";
+import {
+  composeFileStack,
+  composeGdprStack,
+  composeMailStack,
+  composeOpsStack,
+  composePagesStack,
+  composeRendererStack,
+  composeUserDataRightsStack,
+  stackFeatureNames,
+} from "../compose-stacks";
+
+describe("composeStacks", () => {
+  test("composeRendererStack → template-resolver, renderer-foundation, renderer-simple", () => {
+    expect(stackFeatureNames(composeRendererStack())).toEqual([
+      "template-resolver",
+      "renderer-foundation",
+      "renderer-simple",
+    ]);
+  });
+
+  test("composePagesStack → text-content + legal-pages", () => {
+    expect(stackFeatureNames(composePagesStack())).toEqual(["text-content", "legal-pages"]);
+  });
+
+  test("composeMailStack mounts foundation + selected transports", () => {
+    expect(stackFeatureNames(composeMailStack({ transports: ["inmemory", "smtp"] }))).toEqual([
+      "mail-foundation",
+      "mail-transport-inmemory",
+      "mail-transport-smtp",
+    ]);
+  });
+
+  test("composeFileStack mounts foundation + providers + files entity", () => {
+    expect(stackFeatureNames(composeFileStack({ providers: ["inmemory", "s3"] }))).toEqual([
+      "file-foundation",
+      "file-provider-inmemory",
+      "file-provider-s3",
+      "files",
+    ]);
+  });
+
+  test("composeGdprStack retention-first (money-horse / publicstatus pattern)", () => {
+    expect(stackFeatureNames(composeGdprStack({ tenantLifecycle: true, sessions: true }))).toEqual([
+      "data-retention",
+      "compliance-profiles",
+      "tenant-lifecycle",
+      "sessions",
+    ]);
+  });
+
+  test("composeGdprStack compliance-first (studio pattern)", () => {
+    expect(stackFeatureNames(composeGdprStack({ order: "compliance-first" }))).toEqual([
+      "compliance-profiles",
+      "data-retention",
+    ]);
+  });
+
+  test("composeUserDataRightsStack → udr + defaults", () => {
+    expect(stackFeatureNames(composeUserDataRightsStack())).toEqual([
+      "user-data-rights",
+      "user-data-rights-defaults",
+    ]);
+  });
+
+  test("composeOpsStack defaults delivery + audit + jobs", () => {
+    expect(stackFeatureNames(composeOpsStack())).toEqual(["delivery", "audit", "jobs"]);
+  });
+
+  test("composeOpsStack rateLimiting opt-in", () => {
+    expect(stackFeatureNames(composeOpsStack({ rateLimiting: true }))).toEqual([
+      "delivery",
+      "audit",
+      "jobs",
+      "rate-limiting",
+    ]);
+  });
+});
+
+/** Parity: preset name-sets match blocks used in studio / money-horse / publicstatus run-config. */
+describe("composeStacks parity (feature names)", () => {
+  test("studio SaaS blocks are covered by presets", () => {
+    const names = stackFeatureNames([
+      ...composeOpsStack({ rateLimiting: true }),
+      ...composePagesStack(),
+      ...composeMailStack({ transports: ["inmemory", "smtp"] }),
+      ...composeFileStack({ providers: ["inmemory", "s3"] }),
+      ...composeGdprStack({ order: "compliance-first" }),
+      ...composeUserDataRightsStack(),
+    ]);
+    for (const expected of [
+      "delivery",
+      "audit",
+      "jobs",
+      "rate-limiting",
+      "text-content",
+      "legal-pages",
+      "mail-foundation",
+      "file-foundation",
+      "files",
+      "compliance-profiles",
+      "data-retention",
+      "user-data-rights",
+      "user-data-rights-defaults",
+    ]) {
+      expect(names).toContain(expected);
+    }
+  });
+
+  test("money-horse GDPR + file block names", () => {
+    const names = stackFeatureNames([
+      ...composePagesStack(),
+      ...composeRendererStack(),
+      ...composeOpsStack({ delivery: true, audit: false, jobs: false }),
+      ...composeGdprStack({ sessions: true }),
+      ...composeFileStack({ providers: ["s3-env"] }),
+      ...composeUserDataRightsStack(),
+    ]);
+    for (const expected of [
+      "text-content",
+      "legal-pages",
+      "data-retention",
+      "compliance-profiles",
+      "sessions",
+      "file-foundation",
+      "file-provider-s3-env",
+      "files",
+      "user-data-rights",
+    ]) {
+      expect(names).toContain(expected);
+    }
+  });
+
+  test("publicstatus core stack block names", () => {
+    const names = stackFeatureNames([
+      ...composePagesStack(),
+      ...composeGdprStack({ tenantLifecycle: true }),
+      ...composeOpsStack({ delivery: true, audit: true, jobs: true, sessions: false }),
+      ...composeRendererStack(),
+      ...composeFileStack({ providers: ["inmemory"] }),
+      ...composeUserDataRightsStack(),
+    ]);
+    for (const expected of [
+      "text-content",
+      "legal-pages",
+      "tenant-lifecycle",
+      "audit",
+      "delivery",
+      "jobs",
+      "renderer-simple",
+      "files",
+    ]) {
+      expect(names).toContain(expected);
+    }
+  });
+});

package/src/__tests__/setup-test-stack-from-features.integration.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, test } from "bun:test";
+import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
+import { setupTestStackFromFeatures } from "../setup-test-stack-from-features";
+
+const noopFeature = defineFeature("noop-app", () => {});
+
+describe("setupTestStackFromFeatures", () => {
+  test("includeBundled prepends config/user/tenant/auth", async () => {
+    const stack = await setupTestStackFromFeatures([noopFeature], { includeBundled: true });
+    try {
+      for (const name of ["config", "user", "tenant", "auth-email-password", "noop-app"]) {
+        expect(stack.registry.getFeature(name)).toBeDefined();
+      }
+    } finally {
+      await stack.cleanup();
+    }
+  });
+
+  test("config preset wires configResolver in extraContext", async () => {
+    const stack = await setupTestStackFromFeatures([noopFeature], {
+      includeBundled: true,
+      presets: ["config"],
+    });
+    try {
+      expect(stack.registry.getFeature("config")).toBeDefined();
+    } finally {
+      await stack.cleanup();
+    }
+  });
+});

package/src/compose-stacks.ts

@@ -0,0 +1,147 @@
+// Composable SaaS stack presets — explicit opt-in blocks for run-config.ts.
+// Presets export feature instances only; no implicit PAT scopes, anonymousAccess,
+// or tier maps (those stay in bin/server.ts / app run-config).
+
+import { createAuditFeature } from "@cosmicdrift/kumiko-bundled-features/audit";
+import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
+import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
+import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
+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 { createFilesFeature } from "@cosmicdrift/kumiko-bundled-features/files";
+import { createJobsFeature } from "@cosmicdrift/kumiko-bundled-features/jobs";
+import {
+  createLegalPagesFeature,
+  type LegalPagesOptions,
+} 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 { createRateLimitingFeature } from "@cosmicdrift/kumiko-bundled-features/rate-limiting";
+import { createRendererFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/renderer-foundation";
+import { createRendererSimpleFeature } from "@cosmicdrift/kumiko-bundled-features/renderer-simple";
+import { createSessionsFeature } from "@cosmicdrift/kumiko-bundled-features/sessions";
+import { createTemplateResolverFeature } from "@cosmicdrift/kumiko-bundled-features/template-resolver";
+import { createTenantLifecycleFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-lifecycle";
+import { createTextContentFeature } from "@cosmicdrift/kumiko-bundled-features/text-content";
+import {
+  createUserDataRightsFeature,
+  type UserDataRightsOptions,
+} from "@cosmicdrift/kumiko-bundled-features/user-data-rights";
+import { createUserDataRightsDefaultsFeature } from "@cosmicdrift/kumiko-bundled-features/user-data-rights-defaults";
+import type { FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
+
+export type FileProviderKind = "inmemory" | "s3" | "s3-env";
+export type MailTransportKind = "inmemory" | "smtp";
+export type GdprStackOrder = "retention-first" | "compliance-first";
+
+export type FileStackOptions = {
+  readonly providers: readonly FileProviderKind[];
+  readonly includeFilesFeature?: boolean;
+};
+
+export type MailStackOptions = {
+  readonly transports: readonly MailTransportKind[];
+};
+
+export type PagesStackOptions = {
+  readonly wrapLayout?: LegalPagesOptions["wrapLayout"];
+};
+
+export type GdprStackOptions = {
+  readonly order?: GdprStackOrder;
+  readonly sessions?: boolean;
+  readonly tenantLifecycle?: boolean;
+};
+
+export type UserDataRightsStackOptions = {
+  readonly userDataRights?: UserDataRightsOptions;
+  readonly includeDefaults?: boolean;
+};
+
+export type OpsStackOptions = {
+  readonly delivery?: boolean;
+  readonly audit?: boolean;
+  readonly jobs?: boolean;
+  readonly sessions?: boolean;
+  readonly rateLimiting?: boolean;
+};
+
+export function stackFeatureNames(features: readonly FeatureDefinition[]): string[] {
+  return features.map((f) => f.name);
+}
+
+export function composePagesStack(options: PagesStackOptions = {}): FeatureDefinition[] {
+  return [
+    createTextContentFeature(),
+    createLegalPagesFeature(
+      options.wrapLayout !== undefined ? { wrapLayout: options.wrapLayout } : {},
+    ),
+  ];
+}
+
+export function composeRendererStack(): FeatureDefinition[] {
+  return [
+    createTemplateResolverFeature(),
+    createRendererFoundationFeature(),
+    createRendererSimpleFeature(),
+  ];
+}
+
+export function composeMailStack(options: MailStackOptions): FeatureDefinition[] {
+  const out: FeatureDefinition[] = [mailFoundationFeature];
+  for (const transport of options.transports) {
+    if (transport === "inmemory") out.push(mailTransportInMemoryFeature);
+    if (transport === "smtp") out.push(mailTransportSmtpFeature);
+  }
+  return out;
+}
+
+export function composeFileStack(options: FileStackOptions): FeatureDefinition[] {
+  const out: FeatureDefinition[] = [fileFoundationFeature];
+  for (const provider of options.providers) {
+    if (provider === "inmemory") out.push(fileProviderInMemoryFeature);
+    if (provider === "s3") out.push(fileProviderS3Feature);
+    if (provider === "s3-env") out.push(fileProviderS3EnvFeature);
+  }
+  if (options.includeFilesFeature ?? true) out.push(createFilesFeature());
+  return out;
+}
+
+/** Retention + compliance (+ optional lifecycle/sessions). UDR/files mount separately — order varies per app. */
+export function composeGdprStack(options: GdprStackOptions = {}): FeatureDefinition[] {
+  const order = options.order ?? "retention-first";
+  const retention = createDataRetentionFeature();
+  const compliance = createComplianceProfilesFeature();
+  const out: FeatureDefinition[] =
+    order === "compliance-first" ? [compliance, retention] : [retention, compliance];
+  if (options.tenantLifecycle) out.push(createTenantLifecycleFeature());
+  if (options.sessions) out.push(createSessionsFeature());
+  return out;
+}
+
+export function composeUserDataRightsStack(
+  options: UserDataRightsStackOptions = {},
+): FeatureDefinition[] {
+  const includeDefaults = options.includeDefaults ?? true;
+  const out: FeatureDefinition[] = [createUserDataRightsFeature(options.userDataRights ?? {})];
+  if (includeDefaults) out.push(createUserDataRightsDefaultsFeature());
+  return out;
+}
+
+export function composeOpsStack(options: OpsStackOptions = {}): FeatureDefinition[] {
+  const delivery = options.delivery ?? true;
+  const audit = options.audit ?? true;
+  const jobs = options.jobs ?? true;
+  const sessions = options.sessions ?? false;
+  const rateLimiting = options.rateLimiting ?? false;
+  const out: FeatureDefinition[] = [];
+  if (delivery) out.push(createDeliveryFeature());
+  if (audit) out.push(createAuditFeature());
+  if (jobs) out.push(createJobsFeature());
+  if (sessions) out.push(createSessionsFeature());
+  if (rateLimiting) out.push(createRateLimitingFeature());
+  return out;
+}

package/src/index.ts

@@ -26,6 +26,25 @@ export {
   scanEvents,
 } from "./codegen";
 export { type ComposeFeaturesOptions, composeFeatures } from "./compose-features";
+export {
+  composeFileStack,
+  composeGdprStack,
+  composeMailStack,
+  composeOpsStack,
+  composePagesStack,
+  composeRendererStack,
+  composeUserDataRightsStack,
+  type FileProviderKind,
+  type FileStackOptions,
+  type GdprStackOptions,
+  type GdprStackOrder,
+  type MailStackOptions,
+  type MailTransportKind,
+  type OpsStackOptions,
+  type PagesStackOptions,
+  stackFeatureNames,
+  type UserDataRightsStackOptions,
+} from "./compose-stacks";
 export {
   type CreateKumikoServerOptions,
   createKumikoServer,
@@ -73,4 +92,9 @@ export type {
 export { scaffoldDeploy } from "./scaffold-deploy";
 export type { ScaffoldFeatureOptions, ScaffoldFeatureResult } from "./scaffold-feature";
 export { scaffoldFeature } from "./scaffold-feature";
+export {
+  type SetupTestStackFromFeaturesOptions,
+  setupTestStackFromFeatures,
+  type TestStackPreset,
+} from "./setup-test-stack-from-features";
 export { renderWelcomeBanner, type WelcomeBannerInput } from "./welcome-banner";

package/src/setup-test-stack-from-features.ts

@@ -0,0 +1,58 @@
+// Test helper: composeFeatures + setupTestStack in one call.
+// Apps pass the same feature list as run-config (APP_FEATURES / buildAppFeatures).
+
+import { createConfigResolver } from "@cosmicdrift/kumiko-bundled-features/config";
+import { createTextContentApi } from "@cosmicdrift/kumiko-bundled-features/text-content";
+import type { FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
+import {
+  setupTestStack,
+  type TestStack,
+  type TestStackOptions,
+} from "@cosmicdrift/kumiko-framework/stack";
+import { type ComposeFeaturesOptions, composeFeatures } from "./compose-features";
+
+export type TestStackPreset = "config" | "text-content";
+
+export type SetupTestStackFromFeaturesOptions = Omit<TestStackOptions, "features"> & {
+  readonly includeBundled?: boolean;
+  readonly authOptions?: ComposeFeaturesOptions["authOptions"];
+  readonly presets?: readonly TestStackPreset[];
+};
+
+function mergeExtraContext(
+  base: TestStackOptions["extraContext"],
+  presets: readonly TestStackPreset[],
+): TestStackOptions["extraContext"] {
+  if (presets.length === 0) return base;
+
+  return (deps) => {
+    const fromBase =
+      typeof base === "function" ? base(deps) : base !== undefined ? { ...base } : {};
+    const merged: Record<string, unknown> = { ...fromBase };
+
+    if (presets.includes("config")) {
+      const configResolver = createConfigResolver();
+      merged["configResolver"] = configResolver;
+    }
+    if (presets.includes("text-content")) {
+      merged["textContent"] = createTextContentApi(deps.db);
+    }
+
+    return merged;
+  };
+}
+
+export async function setupTestStackFromFeatures(
+  appFeatures: readonly FeatureDefinition[],
+  options: SetupTestStackFromFeaturesOptions = {},
+): Promise<TestStack> {
+  const { includeBundled = false, authOptions, presets = [], ...stackOptions } = options;
+  const features = composeFeatures(appFeatures, { includeBundled, authOptions });
+  const extraContext = mergeExtraContext(stackOptions.extraContext, presets);
+
+  return setupTestStack({
+    ...stackOptions,
+    features,
+    ...(extraContext !== undefined && { extraContext }),
+  });
+}