lakebed 0.0.21 → 0.0.23-staging.26699880384

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "lakebed",
-  "version": "0.0.21",
+  "version": "0.0.23-staging.26699880384",
   "description": "Agent-native CLI and runtime for building and deploying Lakebed capsules.",
   "license": "UNLICENSED",
   "type": "module",
   "homepage": "https://lakebed.dev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pingdotgg/span.git",
+    "url": "git+https://github.com/pingdotgg/lakebed.git",
     "directory": "packages/lakebed"
   },
   "keywords": [
@@ -26,6 +26,7 @@
     "src/cli.js",
     "src/client.d.ts",
     "src/client.js",
+    "src/release.js",
     "src/runtime.js",
     "src/server.d.ts",
     "src/server.js",
@@ -55,6 +56,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "check": "node --check src/cli.js && node --check src/runtime.js && node --check src/server.js && node --check src/client.js && node --check src/release.js && node --check src/source-store.js && node --check src/source-runtime.js && node --check src/source-runtime-worker.js && node --check src/source-runtime-loader.mjs && node --check src/anonymous.js && node --check src/anonymous-server.js && node --check src/auth.js && node --check src/version.js && node --check src/services/all-in-one.js && node --check src/services/api-dashboard.js && node --check src/services/capsule-runner.js"
+  },
   "dependencies": {
     "esbuild": "^0.27.1",
     "pg": "^8.16.3",
@@ -63,8 +67,5 @@
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"
-  },
-  "scripts": {
-    "check": "node --check src/cli.js && node --check src/runtime.js && node --check src/server.js && node --check src/client.js && node --check src/source-store.js && node --check src/source-runtime.js && node --check src/source-runtime-worker.js && node --check src/source-runtime-loader.mjs && node --check src/anonymous.js && node --check src/anonymous-server.js && node --check src/auth.js && node --check src/version.js && node --check src/services/all-in-one.js && node --check src/services/api-dashboard.js && node --check src/services/capsule-runner.js"
   }
-}
+}

package/src/anonymous-server.js

@@ -111,6 +111,15 @@ function sendText(res, status, value, headers = {}) {
   res.end(value);
 }
 
+function healthReleaseMetadata(env = process.env) {
+  return {
+    environment: env.RAILWAY_ENVIRONMENT_NAME ?? null,
+    gitSha: env.RAILWAY_GIT_COMMIT_SHA ?? null,
+    service: env.RAILWAY_SERVICE_NAME ?? null,
+    version: LAKEBED_VERSION
+  };
+}
+
 function redirect(res, location, headers = {}) {
   res.writeHead(302, {
     Location: location,
@@ -436,6 +445,48 @@ function isApiDashboardRoute(pathname) {
   );
 }
 
+function isDashboardBrowserRoute(pathname) {
+  return (
+    pathname === "/" ||
+    pathname === "/deploys" ||
+    pathname === "/dashboard" ||
+    pathname === "/auth" ||
+    pathname.startsWith("/auth/") ||
+    pathname === "/admin" ||
+    pathname.startsWith("/admin/") ||
+    pathname.startsWith("/claim/")
+  );
+}
+
+function normalizedUrlHost(value) {
+  try {
+    return new URL(value).host.toLowerCase();
+  } catch {
+    return "";
+  }
+}
+
+function dashboardRedirectLocation({ dashboardRootUrl, requestUrl }) {
+  const pathname = requestUrl.pathname === "/" ? "/deploys" : requestUrl.pathname;
+  const target = new URL(pathname, dashboardRootUrl);
+  target.search = requestUrl.search;
+  return target.href;
+}
+
+function shouldRedirectToDashboardHost({ dashboardRootUrl, host, publicRootUrl, requestUrl }) {
+  if (!isDashboardBrowserRoute(requestUrl.pathname)) {
+    return false;
+  }
+
+  const publicHost = normalizedUrlHost(publicRootUrl);
+  const dashboardHost = normalizedUrlHost(dashboardRootUrl);
+  if (!publicHost || !dashboardHost || publicHost === dashboardHost) {
+    return false;
+  }
+
+  return String(host).toLowerCase() === publicHost;
+}
+
 function appUrlForSlug({ appBaseDomain, slug }) {
   if (!appBaseDomain) {
     throw new Error("LAKEBED_APP_BASE_DOMAIN is required to create hosted deploy URLs.");
@@ -6213,7 +6264,23 @@ export async function startAnonymousServer({
 
     try {
       if (req.method === "GET" && requestUrl.pathname === "/healthz") {
-        sendJson(res, 200, { ok: true });
+        sendJson(res, 200, {
+          ok: true,
+          release: healthReleaseMetadata()
+        });
+        return;
+      }
+
+      if (
+        servesApiDashboard &&
+        shouldRedirectToDashboardHost({
+          dashboardRootUrl: resolvedDashboardRootUrl,
+          host,
+          publicRootUrl: resolvedPublicRootUrl,
+          requestUrl
+        })
+      ) {
+        redirect(res, dashboardRedirectLocation({ dashboardRootUrl: resolvedDashboardRootUrl, requestUrl }));
         return;
       }
 

package/src/cli.js

@@ -23,6 +23,11 @@ import {
 } from "./anonymous.js";
 import { startAnonymousServer } from "./anonymous-server.js";
 import { authFromUrl as resolveAuthFromUrl, createGuestAuth, requestOrigin, shooBaseUrlFromEnv } from "./auth.js";
+import {
+  LAKEBED_APP_BASE_DOMAIN as defaultHostedAppBaseDomain,
+  LAKEBED_DEPLOY_API_URL as defaultDeployApiUrl,
+  LAKEBED_RELEASE_CHANNEL
+} from "./release.js";
 import { LogBuffer, StateCell } from "./runtime.js";
 import { MemorySourceStore, createMemorySourceStoreFromDirectory, sourcePathDirname, sourcePathJoin } from "./source-store.js";
 
@@ -30,7 +35,10 @@ const root = process.cwd();
 const packageDir = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const packageNodeModules = resolve(packageDir, "node_modules");
 const sourceNamespace = "lakebed-source";
-const defaultDeployApiUrl = "https://api.lakebed.dev";
+const cliPackageSpec = LAKEBED_RELEASE_CHANNEL === "staging" ? "lakebed@staging" : "lakebed";
+const cliCommand = `npx ${cliPackageSpec}`;
+const productionDeployApiUrl = "https://api.lakebed.dev";
+const legacyDeployApiUrl = "https://api.lakebed.app";
 const execFileAsync = promisify(execFile);
 const endpointBodyMaxBytes = 2 * 1024 * 1024;
 
@@ -38,21 +46,21 @@ function usage() {
   console.log(`lakebed
 
 Usage:
-  npx lakebed new [name] [--template todo] [--no-git]
-  npx lakebed create [name] [--template todo] [--no-git]
-  npx lakebed dev [capsule-dir] [--port 3000]
-  npx lakebed build [capsule-dir] --target anonymous [--out .lakebed/artifacts/app.json] [--json]
-  npx lakebed deploy [capsule-dir] [--api <url>] [--public-inspect] [--json]
-  npx lakebed claim [capsule-dir] [--api <url>] [--json]
-  npx lakebed domains add <subdomain.lakebed.app> [--api <url>] [--json]
-  npx lakebed anonymous-server [--port 8787] [--public-root-url <url>] [--dashboard-root-url <url>] [--app-base-domain <domain>] [--role all|api-dashboard|runner]
-  npx lakebed inspect <deploy-id-or-url> [--api <url>] [--inspect-token <token>] [--json]
-  npx lakebed run-many [capsule-dir] [--count 20] [--base-port 4000]
-  npx lakebed auth as <name>
-  npx lakebed auth reset
-  npx lakebed db list [deploy-id-or-url] [--port 3000] [--inspect-token <token>]
-  npx lakebed db dump [deploy-id-or-url] [--port 3000] [--inspect-token <token>]
-  npx lakebed logs [deploy-id-or-url] [--port 3000] [--inspect-token <token>]
+  ${cliCommand} new [name] [--template todo] [--no-git]
+  ${cliCommand} create [name] [--template todo] [--no-git]
+  ${cliCommand} dev [capsule-dir] [--port 3000]
+  ${cliCommand} build [capsule-dir] --target anonymous [--out .lakebed/artifacts/app.json] [--json]
+  ${cliCommand} deploy [capsule-dir] [--api <url>] [--public-inspect] [--json]
+  ${cliCommand} claim [capsule-dir] [--api <url>] [--json]
+  ${cliCommand} domains add <subdomain.${defaultHostedAppBaseDomain}> [--api <url>] [--json]
+  ${cliCommand} anonymous-server [--port 8787] [--public-root-url <url>] [--dashboard-root-url <url>] [--app-base-domain <domain>] [--role all|api-dashboard|runner]
+  ${cliCommand} inspect <deploy-id-or-url> [--api <url>] [--inspect-token <token>] [--json]
+  ${cliCommand} run-many [capsule-dir] [--count 20] [--base-port 4000]
+  ${cliCommand} auth as <name>
+  ${cliCommand} auth reset
+  ${cliCommand} db list [deploy-id-or-url] [--port 3000] [--inspect-token <token>]
+  ${cliCommand} db dump [deploy-id-or-url] [--port 3000] [--inspect-token <token>]
+  ${cliCommand} logs [deploy-id-or-url] [--port 3000] [--inspect-token <token>]
 `);
 }
 
@@ -1096,7 +1104,7 @@ export default capsule({
         <p className="text-sm font-semibold uppercase tracking-wide text-cyan-300">Lakebed deploy</p>
         <h1 className="mt-3 text-3xl font-semibold">Claim required</h1>
         <p className="mt-4 text-neutral-300">
-          This capsule uses ${feature}. Claim this deploy, then run npx lakebed deploy again to publish the app.
+          This capsule uses ${feature}. Claim this deploy, then run ${cliCommand} deploy again to publish the app.
         </p>
       </section>
     </main>
@@ -1193,16 +1201,16 @@ function claimTokenFromDeployResponse(deployed) {
   return null;
 }
 
-function claimUrlFromDeployMetadata(metadata) {
+function claimUrlFromDeployMetadata(metadata, api = metadata?.api) {
   if (!metadata?.api || !metadata?.deployId || !metadata?.claimToken) {
     return null;
   }
 
-  return `${String(metadata.api).replace(/\/+$/g, "")}/claim/${encodeURIComponent(metadata.deployId)}/${encodeURIComponent(metadata.claimToken)}`;
+  return `${normalizeHostedUrl(api)}/claim/${encodeURIComponent(metadata.deployId)}/${encodeURIComponent(metadata.claimToken)}`;
 }
 
 function claimCommandText({ api, capsuleArg }) {
-  const parts = ["npx", "lakebed", "claim"];
+  const parts = ["npx", cliPackageSpec, "claim"];
   if (capsuleArg) {
     parts.push(capsuleArg);
   }
@@ -1219,7 +1227,7 @@ function normalizeDomainCommandHostname(value) {
   }
 
   if (/^[a-z][a-z0-9+.-]*:\/\//i.test(raw) || raw.includes("/") || raw.includes("\\") || raw.includes(":")) {
-    throw new Error("Enter a domain like my-app.lakebed.app, without a scheme, port, or path.");
+    throw new Error(`Enter a domain like my-app.${defaultHostedAppBaseDomain}, without a scheme, port, or path.`);
   }
 
   const hostname = domainToASCII(raw.replace(/\.$/, "").toLowerCase());
@@ -1330,6 +1338,15 @@ function normalizeHostedUrl(value) {
   }
 }
 
+function canonicalDeployApiUrl(value) {
+  const normalized = normalizeHostedUrl(value);
+  return normalized === legacyDeployApiUrl ? productionDeployApiUrl : normalized;
+}
+
+function deployApiUrlsMatch(left, right) {
+  return canonicalDeployApiUrl(left) === canonicalDeployApiUrl(right);
+}
+
 async function readResponseJson(response) {
   const body = await response.text();
   if (!response.ok) {
@@ -1340,7 +1357,7 @@ async function readResponseJson(response) {
 
 async function deployCommand(args) {
   if (args.some((arg) => arg === "--ttl" || arg.startsWith("--ttl="))) {
-    throw new Error("npx lakebed deploy no longer accepts --ttl. Deploy expiry is set by the server.");
+    throw new Error(`${cliCommand} deploy no longer accepts --ttl. Deploy expiry is set by the server.`);
   }
 
   const [capsuleArg] = positionals(args);
@@ -1354,7 +1371,7 @@ async function deployCommand(args) {
   const inspectPolicy = hasFlag(args, "--public-inspect") ? "public" : undefined;
   const metadata = await readDeployMetadata(capsuleDir);
   const canUpdate =
-    metadata?.api === api && typeof metadata?.deployId === "string" && typeof metadata?.claimToken === "string";
+    deployApiUrlsMatch(metadata?.api, api) && typeof metadata?.deployId === "string" && typeof metadata?.claimToken === "string";
   let currentDeploy = null;
   if (canUpdate) {
     const currentResponse = await fetch(`${api}/v1/deploys/${encodeURIComponent(metadata.deployId)}`);
@@ -1367,7 +1384,7 @@ async function deployCommand(args) {
   if (!currentDeploy?.claimed && hasServerEnvValues) {
     if (canUpdate && currentDeploy) {
       throw new Error(
-        `This capsule defines server env in ${SERVER_ENV_FILE}.\n\nThis deploy is still anonymous. Claim it first, then run npx lakebed deploy again to sync server env.`
+        `This capsule defines server env in ${SERVER_ENV_FILE}.\n\nThis deploy is still anonymous. Claim it first, then run ${cliCommand} deploy again to sync server env.`
       );
     }
     try {
@@ -1384,7 +1401,7 @@ async function deployCommand(args) {
     } catch (error) {
       if (error instanceof AnonymousCompilerError && canUpdate && currentDeploy && !currentDeploy.claimed) {
         throw new Error(
-          `${error.message}\n\nThis deploy is still anonymous. Claim it first, then run npx lakebed deploy again to use server-side fetch.`
+          `${error.message}\n\nThis deploy is still anonymous. Claim it first, then run ${cliCommand} deploy again to use server-side fetch.`
         );
       }
       if ((!canUpdate || !currentDeploy) && canDeployAfterClaim(error)) {
@@ -1466,7 +1483,7 @@ async function deployCommand(args) {
   if (deployed.claimUrl) {
     console.log(`Claim:      ${claimCommandText({ api, capsuleArg })}`);
   }
-  console.log(`Inspect:    npx lakebed inspect ${deployed.deployId}`);
+  console.log(`Inspect:    ${cliCommand} inspect ${deployed.deployId}`);
   if (deployed.inspectPolicy === "public") {
     console.log("Inspect policy: public - data and logs are readable by anyone with the app URL.");
   }
@@ -1484,7 +1501,7 @@ async function deployCommand(args) {
   }
   if (envelope.claimRequired) {
     console.log("\nThis app needs a claimed deploy before server-side fetch or server env can run.");
-    console.log(`Run ${claimCommandText({ api, capsuleArg })}, then run npx lakebed deploy again.`);
+    console.log(`Run ${claimCommandText({ api, capsuleArg })}, then run ${cliCommand} deploy again.`);
   }
 }
 
@@ -1495,14 +1512,14 @@ async function claimCommand(args) {
   const metadata = await readDeployMetadata(capsuleDir);
 
   if (!metadata) {
-    throw new Error(`No Lakebed deploy metadata found at ${deployMetadataPath(capsuleDir)}. Run npx lakebed deploy from this project first.`);
+    throw new Error(`No Lakebed deploy metadata found at ${deployMetadataPath(capsuleDir)}. Run ${cliCommand} deploy from this project first.`);
   }
 
-  if (metadata.api !== api) {
+  if (!deployApiUrlsMatch(metadata.api, api)) {
     throw new Error(`Saved deploy metadata is for ${metadata.api}, but this command is using ${api}. Pass --api ${metadata.api} to claim it.`);
   }
 
-  const claimUrl = claimUrlFromDeployMetadata(metadata);
+  const claimUrl = claimUrlFromDeployMetadata(metadata, api);
   if (!claimUrl) {
     throw new Error("This project does not have a saved claim token. Redeploy to create a new claim URL.");
   }
@@ -1559,9 +1576,9 @@ async function domainsCommand(args) {
   const api = deployApiUrl(args);
   const metadata = await readDeployMetadata(capsuleDir);
   if (!metadata) {
-    throw new Error(`No Lakebed deploy metadata found at ${deployMetadataPath(capsuleDir)}. Run npx lakebed deploy from this project first.`);
+    throw new Error(`No Lakebed deploy metadata found at ${deployMetadataPath(capsuleDir)}. Run ${cliCommand} deploy from this project first.`);
   }
-  if (metadata.api !== api) {
+  if (!deployApiUrlsMatch(metadata.api, api)) {
     throw new Error(`Saved deploy metadata is for ${metadata.api}, but this command is using ${api}. Pass --api ${metadata.api} to use it.`);
   }
   if (!metadata.deployId || !metadata.claimToken) {
@@ -1603,7 +1620,7 @@ async function anonymousServerCommand(args) {
 
 function deployLookupApiUrl(target, args, metadata) {
   if (!hasExplicitOption(args, "--api") && metadata?.api && metadata.deployId === target) {
-    return String(metadata.api).replace(/\/+$/g, "");
+    return canonicalDeployApiUrl(metadata.api);
   }
 
   return deployApiUrl(args);
@@ -1841,7 +1858,7 @@ Your role is to build software within this capsule. Lakebed is the runtime, the
 ## Hard rules
 
 - No installing node modules. You can use the built-in APIs. Write TypeScript for anything that is not included.
-- Lakebed CLI should always be run with \`npx lakebed [command]\`. It is not a global. Launch with \`npx\` always.
+- Lakebed CLI should always be run with \`${cliCommand} [command]\`. It is not a global. Launch with \`npx\` always.
 - All client code goes in the \`client\` directory, and all server code goes in the \`server\` directory. Shared code can go in \`shared\`.
 - Use \`lakebed/server\` only from \`server/*.ts\`.
 - Use \`lakebed/client\` only from \`client/*.tsx\`.
@@ -1855,7 +1872,7 @@ Your role is to build software within this capsule. Lakebed is the runtime, the
 - Read server-only environment variables through \`ctx.env\`; define them in \`.env.lakebed.server\`.
 - Auth can be added with a Google sign-in using \`<SignInWithGoogle />\` or \`signInWithGoogle()\` from \`lakebed/client\`.
 - Keep \`shared/\` free of DOM, Node, env, and Lakebed runtime imports.
-- Environment variables are only available on the server, and must be defined in \`.env.lakebed.server\`. They are not available during build time. If you need build-time environment variables, define them in code and do conditional logic based on them. They will be synced with production on \`npx lakebed deploy\`.
+- Environment variables are only available on the server, and must be defined in \`.env.lakebed.server\`. They are not available during build time. If you need build-time environment variables, define them in code and do conditional logic based on them. They will be synced with ${LAKEBED_RELEASE_CHANNEL} on \`${cliCommand} deploy\`.
 
 ## Default project structure
 
@@ -1868,21 +1885,21 @@ Your role is to build software within this capsule. Lakebed is the runtime, the
 Run locally:
 
 \`\`\`sh
-npx lakebed dev
+${cliCommand} dev
 \`\`\`
 
 Deploy:
 
 \`\`\`sh
-npx lakebed deploy
+${cliCommand} deploy
 \`\`\`
 
-Inspect local state while \`npx lakebed dev\` is running:
+Inspect local state while \`${cliCommand} dev\` is running:
 
 \`\`\`sh
-npx lakebed db list --port 3000
-npx lakebed db dump --port 3000
-npx lakebed logs --port 3000
+${cliCommand} db list --port 3000
+${cliCommand} db dump --port 3000
+${cliCommand} logs --port 3000
 \`\`\`
 
 ## External endpoints
@@ -1902,8 +1919,8 @@ Use \`endpoint({ method, path }, handler)\` from \`lakebed/server\` when the app
 - No file storage.
 - No outbound fetch in anonymous deploys. Claim the deploy before using server-side fetch.
 - Non-empty \`.env.lakebed.server\` files sync only after a deploy is claimed.
-- Local state resets when \`npx lakebed dev\` restarts.
-- All production deploys are on 'lakebed.app'
+- Local state resets when \`${cliCommand} dev\` restarts.
+- All ${LAKEBED_RELEASE_CHANNEL} deploys are on '${defaultHostedAppBaseDomain}'
 `;
 }
 
@@ -2091,7 +2108,7 @@ export function cleanTodoText(value: string): string {
 Run this Lakebed capsule:
 
 \`\`\`sh
-npx lakebed dev
+${cliCommand} dev
 \`\`\`
 
 The starter app includes two client routes:
@@ -2138,12 +2155,19 @@ async function newCommand(args) {
   const gitStatus = shouldInitGit ? await initializeGitRepository(targetDir) : "Skipped git setup (--no-git).";
   console.log(gitStatus);
   console.log(`
+Project files:
+  AGENTS.md contains the Lakebed-specific instructions for agents working in this capsule.
+  CLAUDE.md mirrors AGENTS.md for Claude-based workflows.
+
 Next:
   cd ${shellQuote(name)}
-  npx lakebed dev
+  ${cliCommand} dev
+
+Deploy:
+  ${cliCommand} deploy
 
-deploy instantly for free with:
-  npx lakebed deploy`);
+Notice to agents who run this command:
+  make sure to read AGENTS.md before changing files in this capsule.`);
 }
 
 async function initializeGitRepository(targetDir) {

package/src/release.js

@@ -0,0 +1,3 @@
+export const LAKEBED_RELEASE_CHANNEL = "staging";
+export const LAKEBED_DEPLOY_API_URL = "https://api.staging.lakebed.dev";
+export const LAKEBED_APP_BASE_DOMAIN = "staging.lakebed.app";

package/src/version.js

@@ -1 +1 @@
-export const LAKEBED_VERSION = "0.0.21";
+export const LAKEBED_VERSION = "0.0.23-staging.26699880384";