@cosmicdrift/kumiko-dev-server 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,57 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Marc Frost
+
+Licensed Work:        @cosmicdrift/kumiko-framework
+                      The Licensed Work is © 2026 Marc Frost.
+
+Additional Use Grant: 
+You may use the Licensed Work in production for any purpose, including 
+commercially, EXCEPT for the Restricted Use. 
+
+"Restricted Use" is defined as using the Licensed Work to provide a platform 
+or service to third parties that allows them to host, deploy, or run their 
+own applications built with the Licensed Work. This includes, but is not 
+limited to: managed hosting services, software-as-a-service (SaaS) platforms, 
+platform-as-a-service (PaaS), developer platforms, or any multi-tenant 
+managed offering of the Licensed Work.
+
+This restriction does not apply to the Licensor, any entity controlled by, 
+controlling, or under common control with the Licensor ("Affiliates"), or 
+contractors acting on their behalf. The Licensor remains free to use the 
+Licensed Work for any purpose, including for the operation of kumiko.so.
+
+Change Date:          2030-05-05
+Change License:       Apache License, Version 2.0
+
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative works, 
+redistribute, and make non-production use of the Licensed Work. The Licensor may 
+make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly 
+available distribution of the Licensed Work under this License, whichever comes 
+first, this License will convert to the Change License.
+
+This Business Source License governs use of the Licensed Work in all cases, except 
+as to any use that is explicitly granted in the Additional Use Grant above or 
+under the Change License after the Change Date.
+
+If your use of the Licensed Work does not comply with the requirements of this 
+License, you must cease use of the Licensed Work immediately.
+
+All copies of the Licensed Work, and all derivative works thereof, must include 
+this License.
+
+This License does not grant you any right, title, or interest in any trademark, 
+logo, or branding of the Licensor, except as required to comply with this License.
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN 
+“AS IS” BASIS. LICENSOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
+WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, 
+TITLE, AND NON-INFRINGEMENT. IN NO EVENT WILL LICENSOR BE LIABLE FOR ANY DAMAGES 
+ARISING OUT OF OR RELATED TO THIS LICENSE OR THE USE OF THE LICENSED WORK.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.1.0",
+  "version": "0.2.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>",

package/src/__tests__/compose-features-wiring.integration.ts

@@ -36,11 +36,11 @@ import { seedTenantMembership } from "@cosmicdrift/kumiko-bundled-features/tenan
 import { UserHandlers, userEntity, userTable } from "@cosmicdrift/kumiko-bundled-features/user";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
 import {
-  createEntityTable,
-  pushTables,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
+  unsafePushTables,
 } from "@cosmicdrift/kumiko-framework/stack";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test } from "vitest";
 import { composeFeatures } from "../compose-features";
@@ -110,9 +110,9 @@ async function bootStack(
     },
   });
 
-  await createEntityTable(stack.db, userEntity);
-  await createEntityTable(stack.db, tenantEntity);
-  await pushTables(stack.db, { configValuesTable, tenantMembershipsTable });
+  await unsafeCreateEntityTable(stack.db, userEntity);
+  await unsafeCreateEntityTable(stack.db, tenantEntity);
+  await unsafePushTables(stack.db, { configValuesTable, tenantMembershipsTable });
 
   return { stack, resetEmails, verifyEmails };
 }

package/src/__tests__/run-prod-app.integration.ts

@@ -27,7 +27,7 @@ import {
   createEventConsumerStateTable,
   createProjectionStateTable,
 } from "@cosmicdrift/kumiko-framework/pipeline";
-import { ensureEntityTable } from "@cosmicdrift/kumiko-framework/stack";
+import { unsafeEnsureEntityTable } from "@cosmicdrift/kumiko-framework/stack";
 import { sql } from "drizzle-orm";
 import postgres from "postgres";
 import { afterEach, beforeAll, describe, expect, test } from "vitest";
@@ -116,7 +116,7 @@ async function migrateTestDb(): Promise<void> {
     await createArchivedStreamsTable(db);
     await createProjectionStateTable(db);
     await createEventConsumerStateTable(db);
-    await ensureEntityTable(db, widgetEntity, "widget");
+    await unsafeEnsureEntityTable(db, widgetEntity, "widget");
   } finally {
     await close();
   }
@@ -167,7 +167,7 @@ describe("runProdApp", () => {
   test("second boot against the same DB is idempotent — no crash, no duplicate tables", async () => {
     await boot();
     // First boot left tables in place. Restart on the same DB —
-    // ensureEntityTable should be a no-op for the existing rows.
+    // unsafeEnsureEntityTable should be a no-op for the existing rows.
     const second = await boot();
 
     const res = await second.entrypoint.app.fetch(new Request("http://test/health"));

package/src/create-kumiko-server.ts

@@ -23,7 +23,7 @@ import { type AuthRoutesConfig, generateToken } from "@cosmicdrift/kumiko-framew
 import { buildAppSchema, type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
 import {
-  ensureEntityTable,
+  pushEntityProjectionTables,
   setupTestStack,
   type TestStack,
   type TestStackOptions,
@@ -171,7 +171,7 @@ export type CreateKumikoServerOptions = {
    *  Header/Cookie/Default; siehe AnonymousAccessConfig. */
   readonly anonymousAccess?: TestStackOptions["anonymousAccess"];
   /** Wird nach dem Aufsetzen der Entity-Tabellen aufgerufen. Hook für
-   *  non-entity-tables (pushTables) und Seeding (admin user, initial
+   *  non-entity-tables (unsafePushTables) und Seeding (admin user, initial
    *  tenant, …). Muss idempotent sein — im persistent-DB-Modus läuft
    *  es bei jedem Boot. */
   readonly onAfterSetup?: (stack: TestStack) => Promise<void>;
@@ -526,26 +526,6 @@ async function startTailwindWatcher(
   };
 }
 
-// Create all entity tables declared by the given features. Uses
-// ensureEntityTable so a persistent DB (KUMIKO_DEV_DB_NAME) can
-// reuse tables from the previous boot without the caller having to
-// check.
-async function createEntityTablesForFeatures(
-  stack: TestStack,
-  features: readonly FeatureDefinition[],
-): Promise<void> {
-  for (const feature of features) {
-    for (const [entityName, entity] of Object.entries(feature.entities)) {
-      const created = await ensureEntityTable(stack.db, entity, entityName);
-      if (!created) {
-        logInfo(
-          `[kumiko-server] table ${entity.table ?? entityName} already exists — skipping create`,
-        );
-      }
-    }
-  }
-}
-
 /** @internal — normalisierte Client-Entry-Form, einheitlich über
  *  Single-Mode (`clientEntry`) und Multi-Mode (`clientEntries`). */
 type NormalizedEntry = {
@@ -663,7 +643,7 @@ export async function createKumikoServer(
     ...(options.anonymousAccess !== undefined && { anonymousAccess: options.anonymousAccess }),
   });
   await createEventsTable(stack.db);
-  await createEntityTablesForFeatures(stack, options.features);
+  await pushEntityProjectionTables(stack, stack.registry);
 
   // Hook für Caller-spezifische Tables + Seed. Läuft nach den Entity-
   // Tabellen damit das Sample auf `stack.db` / `stack.dispatcher`