@cosmicdrift/kumiko-dev-server 0.348.0 → 0.349.0

package/bin/kumiko-upgrade.ts

@@ -1,5 +1,8 @@
 #!/usr/bin/env bun
 // Shipped, app-facing upgrade CLI: `kumiko-upgrade [--from <version>] [--json] [--verbose]`.
+// `--apply` runs the codemods and moves the marker to the installed version in one run;
+// breaking changes without a codemod stay open in the marker until
+// `--resolve <id|version> --reason "<text>" [--not-applicable]` marks them done.
 //
 // Self-contained — delegates to the framework's runUpgradeCli core, so apps
 // check for breaking changes without the full dev `kumiko` CLI. Run from the

package/dist/scaffold-deploy.d.ts

@@ -38,9 +38,11 @@ export type ScaffoldDeployDetected = {
      *  `bun install` in the manifests-first install variant. */
     readonly registryConfigFiles: readonly RegistryConfigFile[];
     /** DB user for migrate-step.sh's DATABASE_URL — from
-     *  `package.json#kumiko.deploy.dbUser`, default = appName. The db name
-     *  always stays appName regardless of this value. */
+     *  `package.json#kumiko.deploy.dbUser`, default = appName. */
     readonly dbUser: string;
+    /** DB name for migrate-step.sh's DATABASE_URL — from
+     *  `package.json#kumiko.deploy.dbName`, default = appName. */
+    readonly dbName: string;
 };
 export type ScaffoldedFile = {
     readonly path: string;

package/dist/scaffold-deploy.js

@@ -54,6 +54,7 @@ export function renderDeployFiles(options) {
         githubOrg,
         installManifests,
         dbUser: detected.dbUser,
+        dbName: detected.dbName,
     };
     const flags = {
         hasSeeds: detected.hasSeeds,
@@ -61,6 +62,7 @@ export function renderDeployFiles(options) {
         installFromFullTree: detected.installFromFullTree,
         installFromManifests: !detected.installFromFullTree,
         customDbUser: detected.dbUser !== options.appName,
+        customDbName: detected.dbName !== options.appName,
     };
     const dir = templatesDir();
     const files = TEMPLATE_FILES.map(({ template, output }) => ({
@@ -131,13 +133,14 @@ function extractDeployConfigRaw(raw) {
     return kumiko["deploy"];
 }
 const LOCAL_DEP_SPEC_RE = /^(file:|workspace:|link:)/;
-// The user part of DATABASE_URL — deliberately stricter than a full Postgres
-// role-name grammar (no quoting support) since it is interpolated into a
-// shell string, not passed through a driver's escaping.
-const DB_USER_RE = /^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,62}$/;
+// The user and database parts of DATABASE_URL — deliberately stricter than a
+// full Postgres identifier grammar (no quoting support) since they are
+// interpolated into a shell string, not passed through a driver's escaping.
+const DB_IDENTIFIER_RE = /^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,62}$/;
 const kumikoDeployConfigSchema = z
     .object({
-    dbUser: z.string().regex(DB_USER_RE).optional(),
+    dbUser: z.string().regex(DB_IDENTIFIER_RE).optional(),
+    dbName: z.string().regex(DB_IDENTIFIER_RE).optional(),
     // "directory" is the only behaviour left; the key stays valid so existing
     // package.json files keep scaffolding.
     stackNetwork: z
@@ -149,8 +152,8 @@ const kumikoDeployConfigSchema = z
 })
     .strict();
 /** `package.json#kumiko.deploy` must be well-formed — silently falling back
- *  to defaults on an invalid `dbUser`/`stackNetwork` would render a migrate
- *  step that talks to the wrong DB user or the wrong stack network, breaking
+ *  to defaults on an invalid `dbUser`/`dbName`/`stackNetwork` would render a migrate
+ *  step that talks to the wrong DB user, DB or stack network, breaking
  *  prod migrations without anyone noticing. Unlike detectOptionalSurfaces'
  *  malformed-JSON fallback, this throws (fail loud) and names the field. */
 function parseDeployConfig(raw) {
@@ -167,20 +170,26 @@ function parseDeployConfig(raw) {
             : ["kumiko", "deploy", ...issue.path.map(String)].join(".");
     throw new Error(`scaffoldDeploy: invalid package.json#${location} — ${issue?.message ?? "validation failed"}`);
 }
-function resolveDeployConfig(deployConfigRaw, appName) {
-    const config = parseDeployConfig(deployConfigRaw);
-    const dbUser = config.dbUser ?? appName;
+function resolveDbIdentifier(configured, appName, field, role) {
+    const effective = configured ?? appName;
     // The default (appName) already passed isKebabSegment's charset check but
-    // not DB_USER_RE's length cap — validate the effective value so an
-    // over-long appName fails loud here instead of producing a DB user
+    // not DB_IDENTIFIER_RE's length cap — validate the effective value so an
+    // over-long appName fails loud here instead of producing a DB identifier
     // Postgres itself would reject at migrate-time.
-    if (!DB_USER_RE.test(dbUser)) {
-        if (config.dbUser === undefined) {
-            throw new Error(`scaffoldDeploy: appName "${appName}" cannot serve as the default DB user (must match ${DB_USER_RE}); set package.json#kumiko.deploy.dbUser`);
+    if (!DB_IDENTIFIER_RE.test(effective)) {
+        if (configured === undefined) {
+            throw new Error(`scaffoldDeploy: appName "${appName}" cannot serve as the default ${role} (must match ${DB_IDENTIFIER_RE}); set package.json#kumiko.deploy.${field}`);
         }
-        throw new Error(`scaffoldDeploy: invalid package.json#kumiko.deploy.dbUser — effective value "${dbUser}" (defaulted from appName) does not match ${DB_USER_RE}`);
+        throw new Error(`scaffoldDeploy: invalid package.json#kumiko.deploy.${field} — effective value "${effective}" does not match ${DB_IDENTIFIER_RE}`);
     }
-    return { dbUser };
+    return effective;
+}
+function resolveDeployConfig(deployConfigRaw, appName) {
+    const config = parseDeployConfig(deployConfigRaw);
+    return {
+        dbUser: resolveDbIdentifier(config.dbUser, appName, "dbUser", "DB user"),
+        dbName: resolveDbIdentifier(config.dbName, appName, "dbName", "DB name"),
+    };
 }
 function detectOptionalSurfaces(sourceDir, appName) {
     const hasSeeds = existsSync(join(sourceDir, "seeds"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.348.0",
+  "version": "0.349.0",
   "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding, codegen. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -64,11 +64,11 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.348.0",
-    "@cosmicdrift/kumiko-framework": "0.348.0",
-    "@cosmicdrift/kumiko-headless": "0.348.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.348.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.348.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.349.0",
+    "@cosmicdrift/kumiko-framework": "0.349.0",
+    "@cosmicdrift/kumiko-headless": "0.349.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.349.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.349.0",
     "bun-types": "^1.3.13",
     "ts-morph": "^28.0.0",
     "zod": "^4.4.3"

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.349.0",
+    "type": "improvement",
+    "title": "init-deploy reads kumiko.deploy.dbName for the migrate step's DATABASE_URL",
+    "detail": "init-deploy: `package.json#kumiko.deploy.dbName`\n`migrate-step.sh` builds `DATABASE_URL` with `kumiko.deploy.dbName` as the database (default: appName), validated like `dbUser`. Apps without the key render byte-identical output."
+  },
   {
     "version": "0.347.0",
     "type": "fix",

package/templates/deploy/migrate-step.sh.template

@@ -51,13 +51,16 @@ urlencode() {
 {{#customDbUser}}
 # The db user is overridden via package.json#kumiko.deploy.dbUser.
 {{/customDbUser}}
+{{#customDbName}}
+# The db name is overridden via package.json#kumiko.deploy.dbName.
+{{/customDbName}}
 # Image tag pinned to :latest — swap to :${BUILD_SHA} for atomic deploys.
 #
 # Compose DATABASE_URL into the shell env and pass it to the container by
 # NAME (`-e DATABASE_URL`, no value) so the expanded password never appears
 # in `docker run`'s argv — otherwise it would be visible in `ps auxe` for
 # the duration of the migrate run.
-export DATABASE_URL="postgresql://{{dbUser}}:$(urlencode "$DB_PASSWORD")@db:5432/{{appName}}"
+export DATABASE_URL="postgresql://{{dbUser}}:$(urlencode "$DB_PASSWORD")@db:5432/{{dbName}}"
 docker run --rm \
   --network "$STACK_NETWORK" \
   -e DATABASE_URL \