create-svc 0.1.29 → 0.1.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-svc",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Local microservice bootstrap CLI for Cloud Run and Workers services with Neon-backed data.",
   "module": "index.ts",
   "type": "module",

package/src/cli.ts

@@ -3,7 +3,7 @@ import pc from "picocolors";
 import { readdirSync } from "node:fs";
 import { basename, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { buildDeploymentVerificationCommands, runPostScaffoldFlow } from "./post-scaffold";
+import { buildDeploymentVerificationCommands, buildLocalVerificationCommands, runPostScaffoldFlow } from "./post-scaffold";
 import {
   bootstrapGitHubRepository,
   buildGitBootstrapConfig,
@@ -184,13 +184,20 @@ function formatCompletionSummary(config: ScaffoldConfig, targetDir: string, gitR
     `  Temporal API key secret: ${config.serviceName}-temporal-api-key`,
     config.runtime === "go" ? `  Go module: ${config.modulePath}` : undefined,
     "",
-    config.autoDeploy ? "Verified after deploy:" : "After deploy, verify with:",
+    config.autoDeploy ? "Verified production after deploy:" : "After deploy, verify production with:",
     ...buildDeploymentVerificationCommands(config).map(formatShellCommand),
+    config.autoDeploy ? "" : undefined,
+    config.autoDeploy ? "Local dev started:" : undefined,
+    config.autoDeploy ? "  .service/local-dev.pid" : undefined,
+    config.autoDeploy ? "  .service/local-dev.log" : undefined,
+    config.autoDeploy ? "" : undefined,
+    config.autoDeploy ? "Verified local dev:" : undefined,
+    ...(config.autoDeploy ? buildLocalVerificationCommands(config).map(formatShellCommand) : []),
     "",
-    "We suggest that you begin by typing:",
+    config.autoDeploy ? "Next:" : "We suggest that you begin by typing:",
     "",
     `  cd ${config.directory}`,
-    `  ${devCommand}`,
+    config.autoDeploy ? "  tail -f .service/local-dev.log" : `  ${devCommand}`,
     "",
     repository ? `Repository: ${repository}` : undefined,
     `Production API: https://${config.apiHostname}`,

package/src/post-scaffold.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { buildDeploymentVerificationCommands, buildPostScaffoldCommands } from "./post-scaffold";
+import { buildDeploymentVerificationCommands, buildLocalVerificationCommands, buildPostScaffoldCommands } from "./post-scaffold";
 
 describe("buildPostScaffoldCommands", () => {
   test("runs create and deploy for HTTP services", () => {
@@ -25,6 +25,32 @@ describe("buildPostScaffoldCommands", () => {
   });
 });
 
+describe("buildLocalVerificationCommands", () => {
+  test("uses local curl checks for Bun Hono services", () => {
+    expect(buildLocalVerificationCommands({ apiHostname: "api.launch.anmho.com", framework: "hono", runtime: "bun" })).toEqual([
+      { command: "sh", args: ["-c", 'curl --fail --show-error --silent "http://127.0.0.1:3000/"'] },
+      { command: "sh", args: ["-c", 'curl --fail --show-error --silent "http://127.0.0.1:3000/readyz"'] },
+      {
+        command: "sh",
+        args: [
+          "-c",
+          'TOKEN="$(service auth token)" && curl --fail --show-error --silent -H "Authorization: Bearer $TOKEN" "http://127.0.0.1:3000/v1/admin/waitlist?limit=1"',
+        ],
+      },
+    ]);
+  });
+
+  test("uses plaintext grpcurl for local Go ConnectRPC services", () => {
+    expect(buildLocalVerificationCommands({ apiHostname: "api.launch.anmho.com", framework: "connectrpc", runtime: "go" })).toContainEqual({
+      command: "sh",
+      args: [
+        "-c",
+        'TOKEN="$(service auth token)" && grpcurl -plaintext -H "Authorization: Bearer $TOKEN" -d \'{"limit":1}\' -proto protos/waitlist/v1/waitlist.proto "127.0.0.1:8080" waitlist.v1.WaitlistService/ListWaitlistEntries',
+      ],
+    });
+  });
+});
+
 describe("buildDeploymentVerificationCommands", () => {
   test("uses curl health checks for HTTP services", () => {
     expect(buildDeploymentVerificationCommands({ apiHostname: "api.launch.anmho.com", framework: "hono", runtime: "bun" })).toEqual([

package/src/post-scaffold.ts

@@ -33,12 +33,26 @@ export async function runPostScaffoldFlow(config: ScaffoldConfig, cwd: string) {
     for (const command of buildDeploymentVerificationCommands(config)) {
       runWithRetries(command, { cwd, quiet: true }, DEPLOYMENT_VERIFY_ATTEMPTS, DEPLOYMENT_VERIFY_DELAY_MS);
     }
-    return { message: "Dependencies installed, service created, service deployed, and production health verified" };
+    startLocalDevelopment(config, cwd);
+    for (const command of buildLocalVerificationCommands(config)) {
+      runWithRetries(command, { cwd, quiet: true }, 18, 5_000);
+    }
+    return { message: "Dependencies installed, service created, service deployed, production verified, and local dev started" };
   }
 
   return { message: "Backend package generated" };
 }
 
+function startLocalDevelopment(config: Pick<ScaffoldConfig, "target">, cwd: string) {
+  if (config.target === "workers") {
+    run("sh", ["-c", "mkdir -p .service && nohup bun run dev > .service/local-dev.log 2>&1 < /dev/null & echo $! > .service/local-dev.pid"], { cwd });
+    return;
+  }
+
+  run("bun", ["run", "migrate"], { cwd });
+  run("sh", ["-c", "mkdir -p .service && nohup bun run dev > .service/local-dev.log 2>&1 < /dev/null & echo $! > .service/local-dev.pid"], { cwd });
+}
+
 function runWithRetries(command: PostScaffoldCommand, options: CommandOptions, attempts: number, delayMs: number) {
   let lastError: unknown;
   for (let attempt = 1; attempt <= attempts; attempt += 1) {
@@ -68,6 +82,18 @@ export function buildDeploymentVerificationCommands(
   ];
 }
 
+export function buildLocalVerificationCommands(
+  config: Pick<ScaffoldConfig, "apiHostname" | "framework" | "runtime"> & Partial<Pick<ScaffoldConfig, "target">>
+): PostScaffoldCommand[] {
+  const origin = localVerificationOrigin(config);
+  const tokenCommand = 'TOKEN="$(service auth token)"';
+  return [
+    shellVerificationCommand(`curl --fail --show-error --silent "${origin}/"`),
+    shellVerificationCommand(`curl --fail --show-error --silent "${origin}/readyz"`),
+    protectedLocalVerificationCommand(config, origin, tokenCommand),
+  ];
+}
+
 function protectedVerificationCommand(
   config: Pick<ScaffoldConfig, "apiHostname" | "framework" | "runtime"> &
     Partial<Pick<ScaffoldConfig, "target" | "serviceName" | "gcpProject" | "region">>,
@@ -124,6 +150,33 @@ function protectedVerificationCommand(
   };
 }
 
+function protectedLocalVerificationCommand(
+  config: Pick<ScaffoldConfig, "apiHostname" | "framework" | "runtime"> & Partial<Pick<ScaffoldConfig, "target">>,
+  origin: string,
+  tokenCommand: string
+): PostScaffoldCommand {
+  if (config.framework === "connectrpc" && config.runtime === "go") {
+    const host = localVerificationHost(config);
+    return {
+      command: "sh",
+      args: [
+        "-c",
+        [
+          `${tokenCommand} &&`,
+          "grpcurl -plaintext",
+          '-H "Authorization: Bearer $TOKEN"',
+          "-d '{\"limit\":1}'",
+          "-proto protos/waitlist/v1/waitlist.proto",
+          `"${host}"`,
+          "waitlist.v1.WaitlistService/ListWaitlistEntries",
+        ].join(" "),
+      ],
+    };
+  }
+
+  return protectedVerificationCommand(config, origin, tokenCommand);
+}
+
 function shellVerificationCommand(script: string): PostScaffoldCommand {
   return { command: "sh", args: ["-c", script] };
 }
@@ -146,6 +199,20 @@ function verificationHost(
   return config.apiHostname;
 }
 
+function localVerificationOrigin(config: Partial<Pick<ScaffoldConfig, "target" | "runtime" | "framework">>) {
+  if (config.target === "workers") {
+    return "http://127.0.0.1:8787";
+  }
+  if (config.runtime === "bun" && config.framework === "hono") {
+    return "http://127.0.0.1:3000";
+  }
+  return "http://127.0.0.1:8080";
+}
+
+function localVerificationHost(config: Partial<Pick<ScaffoldConfig, "target" | "runtime" | "framework">>) {
+  return localVerificationOrigin(config).replace(/^https?:\/\//, "");
+}
+
 export function buildPostScaffoldCommands(
   config: Pick<ScaffoldConfig, "framework"> & Partial<Pick<ScaffoldConfig, "target">>
 ): PostScaffoldCommand[] {