gencow 0.1.258 → 0.1.259

package/lib/cli-command-runner.mjs

@@ -83,10 +83,16 @@ const SAFE_LOCAL_ERROR_CODES = new Map([
   [
     "CODEGEN_SOURCE_LOAD_FAILED",
     {
-      message: "Deploy stopped before upload: a backend source file throws while it is loaded.",
+      message: "Deploy stopped before upload: a backend source file could not be loaded.",
       stage: "codegen",
-      action:
-        "Retryable: yes, after the top-level code that throws during module load is fixed — run `npx gencow@latest codegen` to confirm it passes, then rerun your deploy command. The throw location is not available; check the backend files that run code at import time.",
+      action: (caught) => {
+        const cause =
+          "the top-level code that throws during module load, or an import path that does not resolve (check the path and that the imported package is installed)";
+        if (safeSourceLocation(caught)) {
+          return `Retryable: yes, after the source at the location above is fixed (${cause}) — run \`npx gencow@latest codegen\` to confirm it passes, then rerun your deploy command.`;
+        }
+        return `Retryable: yes, after ${cause} is fixed — run \`npx gencow@latest codegen\` to confirm it passes, then rerun your deploy command. The failing location is not available; check the backend files that run code at import time and the paths they import.`;
+      },
     },
   ],
   [

package/lib/deploy-codegen-failure.mjs

@@ -33,6 +33,18 @@ function toProjectRelativePath(rawPath, cwd, processCwd) {
   return normalized;
 }
 
+// esbuild prints one diagnostic per line (`<file>:<line>:<col>: ERROR: <text>`) and the
+// Bun loader prints `Could not resolve`/`Cannot find module` for an import path that does
+// not exist. Those are load failures: the source is well-formed, its import is not.
+const DIAGNOSTIC_LINE_PATTERN = /ERROR: |Could not resolve "|Cannot find (?:module|package)\b/u;
+const UNRESOLVED_MODULE_PATTERN = /Could not resolve "|Cannot find (?:module|package)\b/u;
+
+// The first diagnostic decides the class, matching how the first location is reported.
+function isUnresolvedModuleFailure(message) {
+  const firstDiagnostic = message.split("\n").find((line) => DIAGNOSTIC_LINE_PATTERN.test(line)) ?? message;
+  return UNRESOLVED_MODULE_PATTERN.test(firstDiagnostic);
+}
+
 // Returns the first project-relative source location found in a raw message, or null.
 // Absolute paths, stacks and the raw text are never returned.
 function findProjectSourceLocation(message, { cwd, processCwd }) {
@@ -53,11 +65,14 @@ export function classifyDeployCodegenFailure(error, { cwd, backendRoot = "gencow
   const message = (error instanceof Error ? error.message : String(error ?? "")).slice(0, MAX_CLASSIFIED_MESSAGE_LENGTH);
   if (message.includes("Transpile error:")) {
     const location = findProjectSourceLocation(message, { cwd, processCwd });
+    const backendLocation = location && location.sourceFile.startsWith(`${backendRoot}/`) ? location : null;
+    if (isUnresolvedModuleFailure(message)) {
+      return { code: CODEGEN_FAILURE_CODES.SOURCE_LOAD_FAILED, ...(backendLocation ?? {}) };
+    }
     if (location) {
-      const inBackend = location.sourceFile.startsWith(`${backendRoot}/`);
       return {
         code: CODEGEN_FAILURE_CODES.SOURCE_SYNTAX_ERROR,
-        ...(inBackend ? location : {}),
+        ...(backendLocation ?? {}),
       };
     }
   }

package/lib/deploy-prod-target.mjs

@@ -0,0 +1,144 @@
+import { existsSync, readFileSync, writeFileSync } from "fs";
+
+import { CONFIRMATION_MODE, resolveConfirmationMode } from "./confirm-gate.mjs";
+import { confirmFirstProductionDeploy } from "./deploy-first-prod-confirm.mjs";
+import { reconcileProductionAppTarget } from "./deploy-app-target.mjs";
+import { readJsonObjectResponse } from "./http-response-json.mjs";
+import { BOLD, DIM, GREEN, RED, RESET, error, info, log, success } from "./output.mjs";
+import { prodCreateFailureMessage } from "./prod-create-failure.mjs";
+
+export async function ensureProductionDeployTarget({
+  appId,
+  displayName,
+  createCloudAppIfNeeded,
+  createInterfaceImpl,
+  creds,
+  deployArgs,
+  gencowJsonPath,
+  platformFetchImpl,
+  processEnv = process.env,
+  readFileSyncImpl = readFileSync,
+  setTimeoutImpl = setTimeout,
+  successImpl = success,
+  errorImpl = error,
+  infoImpl = info,
+  logImpl = log,
+  writeFileSyncImpl = writeFileSync,
+  exitImpl = (code) => process.exit(code),
+  prodAppId = null,
+  region = null,
+  prepareLocalSource = null,
+}) {
+  const confirmMode = resolveConfirmationMode({
+    allowCiBypass: true,
+    args: deployArgs,
+    createInterfaceImpl,
+    processEnv,
+  });
+  // Without a recorded prod app, the first create always needs confirmation, so a
+  // non-interactive run fails before any platform lookup or create request.
+  if (!prodAppId && confirmMode === CONFIRMATION_MODE.NON_INTERACTIVE) {
+    await confirmFirstProductionDeploy({ appId, errorImpl, infoImpl, logImpl, mode: confirmMode, region });
+    exitImpl(1);
+    return null;
+  }
+  const reconciledTarget = await reconcileProductionAppTarget({
+    appId,
+    prodAppId,
+    creds,
+    displayName,
+    gencowJsonPath,
+    platformFetchImpl,
+    createCloudAppIfNeeded,
+    infoImpl,
+    errorImpl,
+    exitImpl,
+  });
+  if (!reconciledTarget) return null;
+  const productionParentAppId = reconciledTarget.appId;
+  const existingProdAppId = reconciledTarget.prodAppId;
+  if (existingProdAppId) return existingProdAppId;
+  if (!productionParentAppId) return null;
+
+  const proceed = await confirmFirstProductionDeploy({
+    appId: productionParentAppId,
+    createInterfaceImpl,
+    errorImpl,
+    infoImpl,
+    logImpl,
+    mode: confirmMode,
+    region,
+  });
+  if (!proceed) {
+    exitImpl(1);
+    return null;
+  }
+
+  // Local source validation must pass before any remote create: a rejected source
+  // (for example a codegen failure) must not leave an empty production app behind.
+  // The callback renders its own diagnosis and returns false when it aborts.
+  if (prepareLocalSource && !(await prepareLocalSource())) return null;
+
+  infoImpl("Creating prod app...");
+  const createProdRes = await platformFetchImpl(
+    creds,
+    `/platform/apps/${productionParentAppId}/create-prod`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(region ? { region } : {}),
+    },
+  );
+
+  if (!createProdRes.ok) {
+    const errData = await readJsonObjectResponse(createProdRes);
+    if (createProdRes.status === 403) {
+      logImpl("");
+      logImpl(`  ${RED}⛔ Production Deploy — Startup or Enterprise required${RESET}`);
+      logImpl("");
+      logImpl(`  ${DIM}gencow deploy --prod is for production deployment.${RESET}`);
+      logImpl("");
+      logImpl(`  ${BOLD}💡 Dev environment deploy:${RESET}`);
+      logImpl(`     ${GREEN}gencow deploy${RESET}          ${DIM}← Deploy backend to dev${RESET}`);
+      logImpl(`     ${GREEN}gencow dev${RESET}             ${DIM}← Real-time backend + live logs${RESET}`);
+      logImpl(`     ${GREEN}gencow static dist/${RESET}    ${DIM}← Static file (dist/) deploy${RESET}`);
+      logImpl("");
+      logImpl(`  ${BOLD}🚀 Unlock production deploy:${RESET}`);
+      logImpl(`     ${GREEN}gencow upgrade${RESET}       ${DIM}← Upgrade to Startup${RESET}`);
+      logImpl("");
+    } else {
+      errorImpl(prodCreateFailureMessage(errData, createProdRes));
+    }
+    exitImpl(1);
+    return null;
+  }
+
+  const createProdData = await readJsonObjectResponse(createProdRes);
+  if (!createProdData) {
+    errorImpl("Prod app creation failed: server returned an invalid JSON response");
+    exitImpl(1);
+    return null;
+  }
+  const nextProdAppId = createProdData.prodApp;
+  const gencowJson = existsSync(gencowJsonPath) ? JSON.parse(readFileSyncImpl(gencowJsonPath, "utf8")) : {};
+  gencowJson.prodApp = nextProdAppId;
+  writeFileSyncImpl(gencowJsonPath, JSON.stringify(gencowJson, null, 2));
+
+  if (createProdData.alreadyExists) {
+    infoImpl(`Prod app verified: ${nextProdAppId}`);
+    if (region && createProdData.region && createProdData.region !== region) {
+      infoImpl(
+        `Region unchanged: existing prod app is in ${createProdData.region}; --region only applies to first prod creation.`,
+      );
+    }
+  } else {
+    successImpl(`Prod app created: ${nextProdAppId}`);
+    infoImpl(`URL: ${createProdData.url}`);
+    if (createProdData.region) {
+      infoImpl(`Region: ${createProdData.region} (${createProdData.regionSource || "selected"})`);
+    }
+    await new Promise((resolveDelay) => setTimeoutImpl(resolveDelay, 3000));
+  }
+
+  return nextProdAppId;
+}

package/lib/deploy-runtime.mjs

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, unlinkSync, writeFileSync } from "fs";
 import { basename, resolve } from "path";
 import { readProjectDisplayName } from "./cli-project-runtime.mjs";
-import { BOLD, CYAN, DIM, GREEN, RED, RESET, YELLOW, error, info, log, success, warn } from "./output.mjs";
+import { BOLD, CYAN, DIM, RESET, YELLOW, error, info, log, success, warn } from "./output.mjs";
 import { createDeployPackageRuntime } from "./deploy-package-runtime.mjs";
 import {
   getCliInvocationSelection,
@@ -17,11 +17,8 @@ import {
 } from "./deploy-static-fullstack-runtime.mjs";
 import { detectStaticDeployBackend, preflightStaticDeployArtifact } from "./static-deploy-command.mjs";
 import { formatCommandError } from "./cli-command-runner.mjs";
-import { prodCreateFailureMessage } from "./prod-create-failure.mjs";
 import { readJsonObjectResponse } from "./http-response-json.mjs";
-import { reconcileProductionAppTarget } from "./deploy-app-target.mjs";
-import { CONFIRMATION_MODE, resolveConfirmationMode } from "./confirm-gate.mjs";
-import { confirmFirstProductionDeploy } from "./deploy-first-prod-confirm.mjs";
+import { ensureProductionDeployTarget } from "./deploy-prod-target.mjs";
 
 export function parseDeployArgs(deployArgs) {
   const parsed = {
@@ -186,134 +183,12 @@ function showUnknownDeployArgument(arg, { errorImpl = error, infoImpl = info, lo
   infoImpl("  gencow static [dir]           Deploy static files only");
 }
 
-async function ensureProductionDeployTarget({
-  appId,
-  displayName,
-  createCloudAppIfNeeded,
-  createInterfaceImpl,
-  creds,
-  deployArgs,
-  gencowJsonPath,
-  platformFetchImpl,
-  processEnv = process.env,
-  readFileSyncImpl = readFileSync,
-  setTimeoutImpl = setTimeout,
-  successImpl = success,
-  errorImpl = error,
-  infoImpl = info,
-  logImpl = log,
-  writeFileSyncImpl = writeFileSync,
-  exitImpl = (code) => process.exit(code),
-  prodAppId = null,
-  region = null,
-}) {
-  const confirmMode = resolveConfirmationMode({
-    allowCiBypass: true,
-    args: deployArgs,
-    createInterfaceImpl,
-    processEnv,
-  });
-  // Without a recorded prod app, the first create always needs confirmation, so a
-  // non-interactive run fails before any platform lookup or create request.
-  if (!prodAppId && confirmMode === CONFIRMATION_MODE.NON_INTERACTIVE) {
-    await confirmFirstProductionDeploy({ appId, errorImpl, infoImpl, logImpl, mode: confirmMode, region });
-    exitImpl(1);
-    return null;
-  }
-  const reconciledTarget = await reconcileProductionAppTarget({
-    appId,
-    prodAppId,
-    creds,
-    displayName,
-    gencowJsonPath,
-    platformFetchImpl,
-    createCloudAppIfNeeded,
-    infoImpl,
-    errorImpl,
-    exitImpl,
-  });
-  if (!reconciledTarget) return null;
-  const productionParentAppId = reconciledTarget.appId;
-  const existingProdAppId = reconciledTarget.prodAppId;
-  if (existingProdAppId) return existingProdAppId;
-  if (!productionParentAppId) return null;
-
-  const proceed = await confirmFirstProductionDeploy({
-    appId: productionParentAppId,
-    createInterfaceImpl,
-    errorImpl,
-    infoImpl,
-    logImpl,
-    mode: confirmMode,
-    region,
-  });
-  if (!proceed) {
-    exitImpl(1);
-    return null;
-  }
-
-  infoImpl("Creating prod app...");
-  const createProdRes = await platformFetchImpl(
-    creds,
-    `/platform/apps/${productionParentAppId}/create-prod`,
-    {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(region ? { region } : {}),
-    },
-  );
-
-  if (!createProdRes.ok) {
-    const errData = await readJsonObjectResponse(createProdRes);
-    if (createProdRes.status === 403) {
-      logImpl("");
-      logImpl(`  ${RED}⛔ Production Deploy — Startup or Enterprise required${RESET}`);
-      logImpl("");
-      logImpl(`  ${DIM}gencow deploy --prod is for production deployment.${RESET}`);
-      logImpl("");
-      logImpl(`  ${BOLD}💡 Dev environment deploy:${RESET}`);
-      logImpl(`     ${GREEN}gencow deploy${RESET}          ${DIM}← Deploy backend to dev${RESET}`);
-      logImpl(`     ${GREEN}gencow dev${RESET}             ${DIM}← Real-time backend + live logs${RESET}`);
-      logImpl(`     ${GREEN}gencow static dist/${RESET}    ${DIM}← Static file (dist/) deploy${RESET}`);
-      logImpl("");
-      logImpl(`  ${BOLD}🚀 Unlock production deploy:${RESET}`);
-      logImpl(`     ${GREEN}gencow upgrade${RESET}       ${DIM}← Upgrade to Startup${RESET}`);
-      logImpl("");
-    } else {
-      errorImpl(prodCreateFailureMessage(errData, createProdRes));
-    }
-    exitImpl(1);
-    return null;
-  }
-
-  const createProdData = await readJsonObjectResponse(createProdRes);
-  if (!createProdData) {
-    errorImpl("Prod app creation failed: server returned an invalid JSON response");
-    exitImpl(1);
-    return null;
-  }
-  const nextProdAppId = createProdData.prodApp;
-  const gencowJson = existsSync(gencowJsonPath) ? JSON.parse(readFileSyncImpl(gencowJsonPath, "utf8")) : {};
-  gencowJson.prodApp = nextProdAppId;
-  writeFileSyncImpl(gencowJsonPath, JSON.stringify(gencowJson, null, 2));
-
-  if (createProdData.alreadyExists) {
-    infoImpl(`Prod app verified: ${nextProdAppId}`);
-    if (region && createProdData.region && createProdData.region !== region) {
-      infoImpl(
-        `Region unchanged: existing prod app is in ${createProdData.region}; --region only applies to first prod creation.`,
-      );
-    }
-  } else {
-    successImpl(`Prod app created: ${nextProdAppId}`);
-    infoImpl(`URL: ${createProdData.url}`);
-    if (createProdData.region) {
-      infoImpl(`Region: ${createProdData.region} (${createProdData.regionSource || "selected"})`);
-    }
-    await new Promise((resolveDelay) => setTimeoutImpl(resolveDelay, 3000));
-  }
-
-  return nextProdAppId;
+// Returns the prepared backend source, or null when the capability check rejected it
+// (the rejection is already rendered and exit is already requested).
+async function prepareBackendSourceForProdCreate(runtime) {
+  if ((await runtime.preflightBackendCapability?.()) === false) return null;
+  const generatorVersion = await runtime.prepareDeployProjectSource?.({ existingBundleMode: false });
+  return { runtime, generatorVersion };
 }
 
 async function runRollbackDeploy({
@@ -618,28 +493,46 @@ export function createDeployCommand({
       return;
     }
 
+    // Backend source preparation (capability check, migration generation, codegen) runs
+    // before the production app is created, so a rejected source creates no remote app.
+    // It is prepared once here and handed to deployBackendPackage/runStaticDeployFlow.
+    let preparedSource = null;
     if (parsed.envTarget === "prod" && appId && !parsed.existingBundleMode && !parsed.resumeRequested) {
-      const prodTarget = await ensureProductionDeployTarget({
-        appId: rootAppId,
-        displayName,
-        createCloudAppIfNeeded: backendDeployRuntime.createCloudAppIfNeeded,
-        createInterfaceImpl,
-        creds,
-        deployArgs,
-        gencowJsonPath,
-        platformFetchImpl,
-        processEnv,
-        readFileSyncImpl,
-        setTimeoutImpl,
-        successImpl,
-        errorImpl,
-        infoImpl,
-        logImpl,
-        writeFileSyncImpl,
-        exitImpl,
-        prodAppId,
-        region: parsed.region,
-      });
+      // A static-only deploy has no backend source to prepare.
+      const preparesBackendSource = !parsed.staticDeploy || hasDetectedBackend;
+      let prodTarget = null;
+      try {
+        prodTarget = await ensureProductionDeployTarget({
+          appId: rootAppId,
+          displayName,
+          createCloudAppIfNeeded: backendDeployRuntime.createCloudAppIfNeeded,
+          createInterfaceImpl,
+          creds,
+          deployArgs,
+          gencowJsonPath,
+          platformFetchImpl,
+          processEnv,
+          readFileSyncImpl,
+          setTimeoutImpl,
+          successImpl,
+          errorImpl,
+          infoImpl,
+          logImpl,
+          writeFileSyncImpl,
+          exitImpl,
+          prodAppId,
+          region: parsed.region,
+          prepareLocalSource: preparesBackendSource
+            ? async () => {
+                preparedSource = await prepareBackendSourceForProdCreate(backendDeployRuntime);
+                return preparedSource !== null;
+              }
+            : null,
+        });
+      } finally {
+        // Prepared codegen output is temporary; drop it when no production app was created.
+        if (!prodTarget) backendDeployRuntime.cleanupPreparedDeploySource?.();
+      }
       if (!prodTarget) return;
       appId = prodTarget;
       infoImpl(`Deploy target: ${CYAN}${appId}${RESET} (production)`);
@@ -653,6 +546,7 @@ export function createDeployCommand({
     if (parsed.staticDeploy) {
       await runStaticDeployFlow({
         appId,
+        preparedSource,
         backendRoot: backendProjectRoot,
         creds,
         displayName,
@@ -740,6 +634,7 @@ export function createDeployCommand({
 
       await deployBackendPackage({
         activePackageRuntime,
+        preparedSource,
         appId,
         creds,
         displayName,

package/lib/deploy-static-fullstack-runtime.mjs

@@ -72,6 +72,9 @@ export function createScopedDeployPackageRuntime({
 
 export async function deployBackendPackage({
   activePackageRuntime,
+  // Set when the backend source was prepared before the production app was created.
+  // Its runtime must be the one that packages (it holds the prepared codegen output).
+  preparedSource = null,
   appId,
   creds,
   displayName,
@@ -122,10 +125,12 @@ export async function deployBackendPackage({
       });
       if (!activeAppId) return null;
     } else {
-      if ((await activePackageRuntime.preflightBackendCapability?.()) === false) return null;
-      const preparedGeneratorVersion = await activePackageRuntime.prepareDeployProjectSource?.({
-        existingBundleMode,
-      });
+      if (!preparedSource) {
+        if ((await activePackageRuntime.preflightBackendCapability?.()) === false) return null;
+      }
+      const preparedGeneratorVersion = preparedSource
+        ? preparedSource.generatorVersion
+        : await activePackageRuntime.prepareDeployProjectSource?.({ existingBundleMode });
       packageResult = await activePackageRuntime.packageDeployProject({
         forceDeploy,
         existingBundleMode,
@@ -262,6 +267,7 @@ export async function deployBackendPackage({
 
 export async function runStaticDeployFlow({
   appId,
+  preparedSource = null,
   backendRoot,
   creds,
   displayName,
@@ -332,11 +338,13 @@ export async function runStaticDeployFlow({
     logImpl("");
 
     const runtime =
-      backendRoot === frontendCwd
+      preparedSource?.runtime ??
+      (backendRoot === frontendCwd
         ? deployPackageRuntime
-        : createDeployPackageRuntimeForCwd(() => backendRoot);
+        : createDeployPackageRuntimeForCwd(() => backendRoot));
     const deployed = await deployBackendPackage({
       activePackageRuntime: runtime,
+      preparedSource,
       appId: activeAppId,
       creds,
       displayName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.258",
+  "version": "0.1.259",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {
@@ -41,10 +41,10 @@
     "better-auth": "1.7.11",
     "postgres": "^3.4.9",
     "@gencow/client": "0.2.8",
+    "@gencow/shared": "0.0.0",
     "@gencow/core": "0.1.47",
-    "@gencow/react": "0.2.8",
     "@gencow/server": "0.1.3",
-    "@gencow/shared": "0.0.0"
+    "@gencow/react": "0.2.8"
   },
   "scripts": {
     "build": "node scripts/bundle-core.mjs && node scripts/bundle-shared.mjs && node scripts/bundle-server.mjs",