storyshelf 0.3.2 → 0.5.4

package/dist/commands/server/init.js

@@ -2,86 +2,234 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { detectPackageRunner, installCommand, startCommand } from "../../config.js";
 import { printError, printLine } from "../../output.js";
-import { generateComposeYaml, generateDockerfile, generateDockerignore } from "./docker.js";
-import { INFRA_PROMPTS, PROJECT_PROMPTS } from "./prompts.js";
-import { mkdir, writeFile } from "node:fs/promises";
+import { detectInstalledAdapters } from "../shared/detect-adapters.js";
+import { generateComposeYaml, generateComposeYamlWithWorker, generateDockerfile, generateDockerignore, generateWorkerDockerfile } from "./docker.js";
+import { ADVANCED_ADAPTERS_PROMPT, AWS_INFRA_PROMPTS, AZURE_INFRA_PROMPTS, DEPLOY_TARGET_PROMPT, GCP_INFRA_PROMPTS, PROJECT_PROMPTS, localInfraPrompts } from "./prompts.js";
+import { generateAwsTerraformFiles } from "./terraform-aws.js";
+import { generateAzureTerraformFiles } from "./terraform-azure.js";
+import { generateGcpTerraformFiles } from "./terraform-gcp.js";
 import { join, resolve } from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
 import prompts from "prompts";
 //#region src/commands/server/init.ts
+/** Azure SDK pins (must match @storyshelf/queue-azure peerDependencies). */
+const AZURE_STORAGE_QUEUE_SDK = "^12.31.0";
+const AZURE_SERVICE_BUS_SDK = "^7.9.5";
+/** Pub/Sub SDK pin (must match @storyshelf/queue-gcp peerDependencies). */
+const GCP_PUBSUB_SDK = "^6.1.0";
+/** DB peer SDK pins (must match db-* peerDependencies). */
+const LIBSQL_CLIENT_SDK = "^0.15.0";
+const BETTER_SQLITE3_SDK = "^12.0.0";
+const PG_SDK = "^8.0.0";
+const NEON_SDK = "^1.1.0";
+const VERCEL_POSTGRES_SDK = "^0.10.0";
+const PGLITE_SDK = "^0.5.8";
+const MYSQL2_SDK = "^3.9.0";
+const PLANETSCALE_SDK = "^1.19.0";
+const TIDBCLOUD_SDK = "^0.1.0";
+/** Email peer SDK pin (must match @storyshelf/notify-email peerDependencies). */
+const NODEMAILER_SDK = "^10.0.12";
+/** npm peer SDK for the chosen Azure queue backend. */ function azureSdkDep(queue) {
+	if (queue === "azure-service-bus") return {
+		name: "@azure/service-bus",
+		version: AZURE_SERVICE_BUS_SDK
+	};
+	return {
+		name: "@azure/storage-queue",
+		version: AZURE_STORAGE_QUEUE_SDK
+	};
+}
+/** Remote queues need a separately-assembled worker; memory runs in-process. */
+function isRemoteQueue(queue) {
+	return queue !== "memory";
+}
+/** Normalize the deploy target, preserving pre-target answers. */
+function resolveDeployTarget(answers) {
+	return answers.deployTarget ?? (answers.docker ? "docker" : "local");
+}
 const DB_PACKAGE = {
 	sqlite: "@storyshelf/db-sqlite",
-	turso: "@storyshelf/db-turso"
+	turso: "@storyshelf/db-sqlite",
+	"better-sqlite3": "@storyshelf/db-sqlite",
+	"bun-sqlite": "@storyshelf/db-sqlite",
+	d1: "@storyshelf/db-sqlite",
+	postgres: "@storyshelf/db-postgres",
+	pg: "@storyshelf/db-postgres",
+	neon: "@storyshelf/db-postgres",
+	"neon-http": "@storyshelf/db-postgres",
+	vercel: "@storyshelf/db-postgres",
+	pglite: "@storyshelf/db-postgres",
+	mysql: "@storyshelf/db-mysql",
+	planetscale: "@storyshelf/db-mysql",
+	tidb: "@storyshelf/db-mysql"
 };
 const STORAGE_PACKAGE = {
 	local: "@storyshelf/storage-local",
-	s3: "@storyshelf/storage-s3"
+	s3: "@storyshelf/storage-s3",
+	azure: "@storyshelf/storage-azure",
+	gcs: "@storyshelf/storage-gcs"
 };
 const AUTH_PACKAGE = {
 	none: null,
-	password: "@storyshelf/auth-password",
-	oauth: "@storyshelf/auth-oauth"
+	password: "@storyshelf/auth",
+	oauth: "@storyshelf/auth"
 };
 const GIT_PACKAGE = {
 	none: null,
 	github: "@storyshelf/git-github",
 	gitlab: "@storyshelf/git-gitlab"
 };
+const QUEUE_PACKAGE = {
+	memory: null,
+	sqs: "@storyshelf/queue-sqs",
+	redis: "@storyshelf/queue-redis",
+	"azure-storage-queues": "@storyshelf/queue-azure",
+	"azure-service-bus": "@storyshelf/queue-azure",
+	"gcp-pubsub": "@storyshelf/queue-gcp"
+};
 const DB_IMPORT = {
 	sqlite: `import { createSqliteDatabase } from "@storyshelf/db-sqlite";`,
-	turso: `import { createTursoDatabase } from "@storyshelf/db-turso";`
+	turso: `import { createTursoDatabase } from "@storyshelf/db-sqlite/turso";`,
+	"better-sqlite3": `import { createBetterSqlite3Database } from "@storyshelf/db-sqlite/better-sqlite3";`,
+	"bun-sqlite": `import { createBunSqliteDatabase } from "@storyshelf/db-sqlite/bun-sqlite";`,
+	d1: `import { createD1Database } from "@storyshelf/db-sqlite/d1";`,
+	postgres: `import { createPostgresDatabase } from "@storyshelf/db-postgres";`,
+	pg: `import { createPgDatabase } from "@storyshelf/db-postgres/pg";`,
+	neon: `import { createNeonDatabase } from "@storyshelf/db-postgres/neon";`,
+	"neon-http": `import { createNeonHttpDatabase } from "@storyshelf/db-postgres/neon-http";`,
+	vercel: `import { createVercelDatabase } from "@storyshelf/db-postgres/vercel";`,
+	pglite: `import { createPgliteDatabase } from "@storyshelf/db-postgres/pglite";`,
+	mysql: `import { createMysqlDatabase } from "@storyshelf/db-mysql";`,
+	planetscale: `import { createPlanetscaleDatabase } from "@storyshelf/db-mysql/planetscale";`,
+	tidb: `import { createTidbDatabase } from "@storyshelf/db-mysql/tidb";`
 };
 const STORAGE_IMPORT = {
 	local: `import { createLocalStorage } from "@storyshelf/storage-local";`,
-	s3: `import { createS3Storage } from "@storyshelf/storage-s3";`
+	s3: `import { createS3Storage } from "@storyshelf/storage-s3";`,
+	azure: `import { createAzureStorage } from "@storyshelf/storage-azure";`,
+	gcs: `import { createGcsStorage } from "@storyshelf/storage-gcs";`
 };
 const DB_INIT = {
 	sqlite: `createSqliteDatabase(\`\${dataDir}/shelf.db\`)`,
-	turso: `createTursoDatabase({ url: process.env.TURSO_DATABASE_URL!, authToken: process.env.TURSO_AUTH_TOKEN })`
+	turso: `createTursoDatabase({ url: process.env.TURSO_DATABASE_URL!, authToken: process.env.TURSO_AUTH_TOKEN })`,
+	"better-sqlite3": `createBetterSqlite3Database({ path: \`\${dataDir}/shelf.db\` })`,
+	"bun-sqlite": `createBunSqliteDatabase({ path: \`\${dataDir}/shelf.db\` })`,
+	d1: `createD1Database({ client: getD1Binding() })`,
+	postgres: `createPostgresDatabase({ url: process.env.DATABASE_URL! })`,
+	pg: `createPgDatabase({ url: process.env.DATABASE_URL! })`,
+	neon: `createNeonDatabase({ url: process.env.DATABASE_URL! })`,
+	"neon-http": `createNeonHttpDatabase({ url: process.env.DATABASE_URL! })`,
+	vercel: `createVercelDatabase()`,
+	pglite: `createPgliteDatabase()`,
+	mysql: `createMysqlDatabase({ url: process.env.DATABASE_URL! })`,
+	planetscale: `createPlanetscaleDatabase({ url: process.env.DATABASE_URL! })`,
+	tidb: `createTidbDatabase({ url: process.env.DATABASE_URL! })`
 };
+/** Extra scaffolding before `const database = ...` (D1 binding stub). */
+function dbPrelude(database) {
+	if (database !== "d1") return [];
+	return [
+		`// TODO: provide your D1 binding (Cloudflare Workers: env.DB).`,
+		`function getD1Binding(): never {`,
+		`  throw new Error("Provide your D1 database binding (env.DB).");`,
+		`}`
+	];
+}
 const STORAGE_INIT = {
 	local: `createLocalStorage(dataDir)`,
-	s3: `createS3Storage({ bucket: process.env.S3_BUCKET!, region: process.env.AWS_REGION })`
+	s3: `createS3Storage({ bucket: process.env.S3_BUCKET!, region: process.env.AWS_REGION })`,
+	azure: `createAzureStorage({ container: "storybook", connectionString: process.env.AZURE_STORAGE_CONNECTION! })`,
+	gcs: `createGcsStorage({ bucket: process.env.GCS_BUCKET! })`
 };
+/** Whether the generated server wires notification providers. */
+function wantsNotifications(answers) {
+	return answers.notifications ?? true;
+}
 function buildImports(answers) {
 	const imports = [
 		`import { serve } from "@hono/node-server";`,
-		`import { createShelfRouter } from "@storyshelf/router";`,
+		`import { createShelfApp } from "@storyshelf/app";`,
 		`import { createShelfLogger } from "@storyshelf/core/logger";`,
+		`import { otelLogMixin } from "@storyshelf/observability";`,
+		`import { initObservabilityFromEnv } from "@storyshelf/observability/node";`,
 		DB_IMPORT[answers.database],
 		STORAGE_IMPORT[answers.storage]
 	];
-	if (answers.auth !== "none") imports.push(`import { createPasswordAuth } from "${AUTH_PACKAGE[answers.auth]}";`);
+	if (answers.queue === "sqs") imports.push(`import { createSqsCaptureQueue } from "@storyshelf/queue-sqs";`);
+	if (answers.queue === "redis") imports.push(`import { createRedisCaptureQueue } from "@storyshelf/queue-redis";`);
+	if (answers.queue === "azure-storage-queues") imports.push(`import { createAzureStorageQueuesQueue } from "@storyshelf/queue-azure/storage-queues";`);
+	if (answers.queue === "azure-service-bus") imports.push(`import { createAzureServiceBusQueue } from "@storyshelf/queue-azure/service-bus";`);
+	if (answers.queue === "gcp-pubsub") imports.push(`import { createGcpPubSubQueue } from "@storyshelf/queue-gcp";`);
+	if (answers.auth === "password") imports.push(`import { createShelfAuth, ensurePasswordAdmin } from "@storyshelf/auth";`);
+	if (answers.auth === "oauth") {
+		imports.push(`import { createShelfAuth } from "@storyshelf/auth";`);
+		if (resolveDeployTarget(answers) === "aws") imports.push(`import { cognitoPreset } from "@storyshelf/auth";`);
+		else imports.push(`import { keycloakPreset } from "@storyshelf/auth";`);
+	}
 	if (answers.git !== "none") {
 		const host = answers.git === "github" ? "gitHubHost" : "gitLabHost";
 		imports.push(`import { ${host} } from "${GIT_PACKAGE[answers.git]}";`);
 	}
-	imports.push(`import { createPlaywrightCaptureRunner } from "@storyshelf/runner-playwright";`);
+	if (wantsNotifications(answers)) {
+		imports.push(`import { chatNotifiers } from "@storyshelf/notify-chat";`, `import { createEmailNotifier, smtpPresetFromEnv } from "@storyshelf/notify-email";`);
+		if (answers.auth !== "none") imports.push(`import { createAuthSystemHook } from "@storyshelf/app";`);
+	}
+	if (answers.queue === "memory") imports.push(`import { createPlaywrightCaptureRunner } from "@storyshelf/runner-playwright";`);
 	return imports;
 }
 function buildAdapterLines(answers) {
-	return [
+	const lines = [
 		`// Adapters — swap these for your deployment`,
+		...dbPrelude(answers.database),
 		`const database = ${DB_INIT[answers.database]};`,
-		`const storage = ${STORAGE_INIT[answers.storage]};`,
-		`const captureRunner = createPlaywrightCaptureRunner();`,
-		`const logger = createShelfLogger({ level: process.env.LOG_LEVEL });`
+		`const storage = ${STORAGE_INIT[answers.storage]};`
 	];
+	if (answers.queue === "sqs") lines.push(`const captureQueue = createSqsCaptureQueue({ queueUrl: process.env.QUEUE_URL! });`);
+	if (answers.queue === "redis") lines.push(`const captureQueue = createRedisCaptureQueue({ url: process.env.REDIS_URL! });`);
+	if (answers.queue === "azure-storage-queues") lines.push(`const captureQueue = createAzureStorageQueuesQueue({ queueName: "capture-jobs", connectionString: process.env.AZURE_STORAGE_CONNECTION! });`);
+	if (answers.queue === "azure-service-bus") lines.push(`const captureQueue = createAzureServiceBusQueue({ queueName: "capture-jobs", connectionString: process.env.AZURE_SERVICE_BUS_CONNECTION! });`);
+	if (answers.queue === "gcp-pubsub") lines.push(`const captureQueue = createGcpPubSubQueue({ topic: "capture-jobs", subscription: "capture-jobs-worker", projectId: process.env.GOOGLE_CLOUD_PROJECT! });`);
+	if (answers.queue === "memory") lines.push(`const captureRunner = createPlaywrightCaptureRunner();`);
+	if (wantsNotifications(answers)) lines.push(`// Notifications: SMTP sender from SMTP_* env (undefined keeps invites out-of-band).`, `const emailSender = smtpPresetFromEnv(process.env);`, `const emailNotifiers = emailSender ? [createEmailNotifier(emailSender, { from: process.env.SMTP_FROM })] : [];`);
+	return lines;
 }
 function buildRouterLines(answers) {
 	const lines = [
-		`const app = createShelfRouter({`,
+		`// Observability (noop unless OTEL_EXPORTER_OTLP_ENDPOINT is set).`,
+		`const observability = await initObservabilityFromEnv();`,
+		`const shelfLogger = createShelfLogger({ mixin: otelLogMixin });`,
+		``,
+		`const app = createShelfApp({`,
 		`  database,`,
-		`  storage,`,
-		`  captureRunner,`,
-		`  logger,`
+		`  storage,`
 	];
-	if (answers.auth !== "none") lines.push(`  auth: createPasswordAuth({ password: process.env.AUTH_PASSWORD! }),`);
+	if (isRemoteQueue(answers.queue)) lines.push(`  captureQueue,`);
+	else lines.push(`  captureRunner,`);
+	if (wantsNotifications(answers)) lines.push(`  notifiers: [...chatNotifiers, ...emailNotifiers],`);
+	if (answers.auth === "password") {
+		const notifyArgs = wantsNotifications(answers) ? `, emailSender, fromEmail: process.env.SMTP_FROM, onAuthSystemEvent: createAuthSystemHook()` : ``;
+		lines.push(`  auth: createShelfAuth({ db: database, secret: process.env.SECRET!, baseURL: process.env.PUBLIC_BASE_URL!${notifyArgs} }).adapter,`);
+	}
+	if (answers.auth === "oauth" && resolveDeployTarget(answers) === "aws") lines.push(`  auth: createShelfAuth({`, `    db: database,`, `    secret: process.env.SECRET!,`, `    baseURL: process.env.PUBLIC_BASE_URL!,`, ...wantsNotifications(answers) ? [
+		`    emailSender,`,
+		`    fromEmail: process.env.SMTP_FROM,`,
+		`    onAuthSystemEvent: createAuthSystemHook(),`
+	] : [], `    social: [`, `      cognitoPreset({`, `        domain: process.env.COGNITO_DOMAIN!,`, `        region: process.env.COGNITO_REGION!,`, `        userPoolId: process.env.COGNITO_USER_POOL_ID!,`, `        clientId: process.env.OIDC_CLIENT_ID!,`, `        clientSecret: process.env.OIDC_CLIENT_SECRET,`, `      }),`, `    ],`, `  }).adapter,`);
+	if (answers.auth === "oauth" && resolveDeployTarget(answers) !== "aws") lines.push(`  auth: createShelfAuth({`, `    db: database,`, `    secret: process.env.SECRET!,`, `    baseURL: process.env.PUBLIC_BASE_URL!,`, ...wantsNotifications(answers) ? [
+		`    emailSender,`,
+		`    fromEmail: process.env.SMTP_FROM,`,
+		`    onAuthSystemEvent: createAuthSystemHook(),`
+	] : [], `    oauth: [`, `      keycloakPreset(process.env.OIDC_ISSUER!, {`, `        clientId: process.env.OIDC_CLIENT_ID!,`, `        clientSecret: process.env.OIDC_CLIENT_SECRET,`, `      }),`, `    ],`, `  }).adapter,`);
 	if (answers.git !== "none") {
 		const host = answers.git === "github" ? "gitHubHost" : "gitLabHost";
 		lines.push(`  gitHosts: [${host}],`);
 	}
-	lines.push(`  config: {`, `    secret: process.env.SECRET,`, `    scratchDir: dataDir,`, `  },`, `});`, ``, `await app.lifecycle.init();`);
+	if (answers.queue === "memory") lines.push(`  logger: shelfLogger,`, `  observability,`, `  config: {`, `    secret: process.env.SECRET,`, `    // Rotation: keep the old SECRET here until credentials are re-encrypted.`, `    previousSecret: process.env.SECRET_PREVIOUS || undefined,`, `    migrateCredentialsOnBoot: process.env.SECRET_MIGRATE === "true",`, `    scratchDir: dataDir,`, `  },`);
+	else lines.push(`  logger: shelfLogger,`, `  observability,`, `  config: {`, `    secret: process.env.SECRET,`, `    // Rotation: keep the old SECRET here until credentials are re-encrypted.`, `    previousSecret: process.env.SECRET_PREVIOUS || undefined,`, `    migrateCredentialsOnBoot: process.env.SECRET_MIGRATE === "true",`, `  },`);
+	lines.push(`});`, ``, `await app.lifecycle.setup();`, `const logger = app.lifecycle.logger;`);
+	if (answers.auth === "password") lines.push(``, `// Provision the env-driven local admin (AUTH_PASSWORD, at least 12 chars).`, `await ensurePasswordAdmin(database, {`, `  email: process.env.AUTH_EMAIL ?? "admin@local",`, `  password: process.env.AUTH_PASSWORD!,`, `});`);
 	return lines;
 }
 function generateServer(answers) {
@@ -100,7 +248,7 @@ function generateServer(answers) {
 		`});`,
 		``,
 		`const shutdown = async () => {`,
-		`  await app.lifecycle.close();`,
+		`  await app.lifecycle.teardown();`,
 		`  server.close();`,
 		`};`,
 		`process.on("SIGTERM", () => {`,
@@ -112,19 +260,122 @@ function generateServer(answers) {
 		``
 	].join("\n");
 }
+function workerQueueImport(queue) {
+	if (queue === "redis") return `import { createRedisCaptureQueue } from "@storyshelf/queue-redis";`;
+	if (queue === "azure-storage-queues") return `import { createAzureStorageQueuesQueue } from "@storyshelf/queue-azure/storage-queues";`;
+	if (queue === "azure-service-bus") return `import { createAzureServiceBusQueue } from "@storyshelf/queue-azure/service-bus";`;
+	if (queue === "gcp-pubsub") return `import { createGcpPubSubQueue } from "@storyshelf/queue-gcp";`;
+	return `import { createSqsCaptureQueue } from "@storyshelf/queue-sqs";`;
+}
+function workerQueueInit(queue) {
+	if (queue === "redis") return `const queue = createRedisCaptureQueue({ url: process.env.REDIS_URL! });`;
+	if (queue === "azure-storage-queues") return `const queue = createAzureStorageQueuesQueue({ queueName: "capture-jobs", connectionString: process.env.AZURE_STORAGE_CONNECTION! });`;
+	if (queue === "azure-service-bus") return `const queue = createAzureServiceBusQueue({ queueName: "capture-jobs", connectionString: process.env.AZURE_SERVICE_BUS_CONNECTION! });`;
+	if (queue === "gcp-pubsub") return `const queue = createGcpPubSubQueue({ topic: "capture-jobs", subscription: "capture-jobs-worker", projectId: process.env.GOOGLE_CLOUD_PROJECT! });`;
+	return `const queue = createSqsCaptureQueue({ queueUrl: process.env.QUEUE_URL! });`;
+}
+function generateWorkerFile(answers) {
+	const queueImport = workerQueueImport(answers.queue);
+	const queueInit = workerQueueInit(answers.queue);
+	return [
+		queueImport,
+		`import { createCaptureWorker } from "@storyshelf/worker";`,
+		`import { initObservabilityFromEnv } from "@storyshelf/observability/node";`,
+		`import { createPlaywrightCaptureRunner } from "@storyshelf/runner-playwright";`,
+		DB_IMPORT[answers.database],
+		STORAGE_IMPORT[answers.storage],
+		``,
+		`// Observability (noop unless OTEL_EXPORTER_OTLP_ENDPOINT is set).`,
+		`const observability = await initObservabilityFromEnv();`,
+		``,
+		`const dataDir = process.env.DATA_DIR || "./data";`,
+		...dbPrelude(answers.database),
+		`const database = ${DB_INIT[answers.database]};`,
+		`const storage = ${STORAGE_INIT[answers.storage]};`,
+		queueInit,
+		`const runner = createPlaywrightCaptureRunner();`,
+		``,
+		`const worker = createCaptureWorker({`,
+		`  queue,`,
+		`  db: database,`,
+		`  storage,`,
+		`  runner,`,
+		`  scratchDir: dataDir,`,
+		`  config: { concurrency: Number(process.env.WORKER_CONCURRENCY) || 2 },`,
+		`});`,
+		``,
+		`await worker.start();`,
+		``,
+		`const shutdown = async () => {`,
+		`  await worker.stop();`,
+		`  await observability.shutdown();`,
+		`};`,
+		`process.on("SIGTERM", () => { shutdown().catch(() => {}); });`,
+		`process.on("SIGINT", () => { shutdown().catch(() => {}); });`,
+		``
+	].join("\n");
+}
 function buildDeps(answers) {
 	const deps = {
 		"@hono/node-server": "^1.17.0",
-		"@storyshelf/core": "0.3.2",
-		"@storyshelf/router": "0.3.2",
-		[DB_PACKAGE[answers.database]]: "0.3.2",
-		"@storyshelf/runner-playwright": "0.3.2"
+		"@storyshelf/core": "0.5.4",
+		"@storyshelf/app": "0.5.4",
+		"@storyshelf/observability": "0.5.4",
+		[DB_PACKAGE[answers.database]]: "0.5.4"
 	};
-	if (answers.storage !== "local") deps[STORAGE_PACKAGE[answers.storage]] = "0.3.2";
-	if (answers.auth !== "none") deps[AUTH_PACKAGE[answers.auth] ?? ""] = "0.3.2";
-	if (answers.git !== "none") deps[GIT_PACKAGE[answers.git] ?? ""] = "0.3.2";
+	if (answers.database === "turso") deps["@libsql/client"] = LIBSQL_CLIENT_SDK;
+	if (answers.database === "better-sqlite3") deps["better-sqlite3"] = BETTER_SQLITE3_SDK;
+	if (answers.database === "pg") deps["pg"] = PG_SDK;
+	if (answers.database === "neon" || answers.database === "neon-http") deps["@neondatabase/serverless"] = NEON_SDK;
+	if (answers.database === "vercel") deps["@vercel/postgres"] = VERCEL_POSTGRES_SDK;
+	if (answers.database === "pglite") deps["@electric-sql/pglite"] = PGLITE_SDK;
+	if (answers.database === "mysql") deps["mysql2"] = MYSQL2_SDK;
+	if (answers.database === "planetscale") deps["@planetscale/database"] = PLANETSCALE_SDK;
+	if (answers.database === "tidb") deps["@tidbcloud/serverless"] = TIDBCLOUD_SDK;
+	if (answers.storage !== "local") deps[STORAGE_PACKAGE[answers.storage]] = "0.5.4";
+	if (answers.queue === "sqs" || answers.queue === "redis") {
+		const queuePkg = answers.queue === "redis" ? "@storyshelf/queue-redis" : "@storyshelf/queue-sqs";
+		deps[queuePkg] = "0.5.4";
+		if (answers.includeWorker) {
+			deps["@storyshelf/worker"] = "0.5.4";
+			deps["@storyshelf/runner-playwright"] = "0.5.4";
+		}
+	} else if (answers.queue === "azure-storage-queues" || answers.queue === "azure-service-bus") {
+		deps["@storyshelf/queue-azure"] = "0.5.4";
+		const sdk = azureSdkDep(answers.queue);
+		deps[sdk.name] = sdk.version;
+		if (answers.includeWorker) {
+			deps["@storyshelf/worker"] = "0.5.4";
+			deps["@storyshelf/runner-playwright"] = "0.5.4";
+		}
+	} else if (answers.queue === "gcp-pubsub") {
+		deps["@storyshelf/queue-gcp"] = "0.5.4";
+		deps["@google-cloud/pubsub"] = GCP_PUBSUB_SDK;
+		if (answers.includeWorker) {
+			deps["@storyshelf/worker"] = "0.5.4";
+			deps["@storyshelf/runner-playwright"] = "0.5.4";
+		}
+	} else deps["@storyshelf/runner-playwright"] = "0.5.4";
+	if (answers.auth !== "none") deps[AUTH_PACKAGE[answers.auth] ?? ""] = "0.5.4";
+	if (answers.git !== "none") deps[GIT_PACKAGE[answers.git] ?? ""] = "0.5.4";
+	if (wantsNotifications(answers)) {
+		deps["@storyshelf/notify-chat"] = "0.5.4";
+		deps["@storyshelf/notify-email"] = "0.5.4";
+		deps["nodemailer"] = NODEMAILER_SDK;
+	}
+	if (answers.queue !== "memory") {
+		const queuePkg = QUEUE_PACKAGE[answers.queue];
+		if (queuePkg) deps[queuePkg] = "0.5.4";
+	}
 	return deps;
 }
+function addInfraScripts(scripts) {
+	scripts["infra:init"] = "terraform -chdir=terraform init";
+	scripts["infra:plan"] = "terraform -chdir=terraform plan -out=tfplan";
+	scripts["infra:apply"] = "terraform -chdir=terraform apply tfplan";
+	scripts["infra:destroy"] = "terraform -chdir=terraform destroy";
+	scripts["infra:outputs"] = "terraform -chdir=terraform output -json";
+}
 function generatePackageJson(answers) {
 	const pkg = {
 		name: answers.name,
@@ -139,50 +390,249 @@ function generatePackageJson(answers) {
 		dependencies: buildDeps(answers),
 		devDependencies: { typescript: "^7.0.2" }
 	};
+	if (answers.includeWorker) {
+		pkg.scripts["worker"] = "node --experimental-transform-types worker.ts";
+		pkg.scripts["worker:dev"] = "node --experimental-transform-types --watch worker.ts";
+	}
+	if (resolveDeployTarget(answers) === "docker") {
+		const scripts = pkg.scripts;
+		scripts["docker:build"] = "docker compose build";
+		scripts["docker:up"] = "docker compose up --build";
+		scripts["docker:down"] = "docker compose down";
+		scripts["docker:logs"] = "docker compose logs -f";
+	}
+	if (resolveDeployTarget(answers) === "aws" || resolveDeployTarget(answers) === "azure" || resolveDeployTarget(answers) === "gcp") addInfraScripts(pkg.scripts);
 	return JSON.stringify(pkg, null, 2);
 }
 async function writeFiles(outDir, answers) {
 	const serverCode = generateServer(answers);
 	await writeFile(join(outDir, "server.ts"), serverCode);
 	printLine(`Created server.ts`);
+	if (answers.includeWorker) {
+		const workerCode = generateWorkerFile(answers);
+		await writeFile(join(outDir, "worker.ts"), workerCode);
+		printLine(`Created worker.ts`);
+	}
 	const pkgCode = generatePackageJson(answers);
 	await writeFile(join(outDir, "package.json"), pkgCode);
 	printLine(`Created package.json`);
-	await writeDockerFiles(outDir, answers.docker);
+	if (resolveDeployTarget(answers) === "aws") await writeTerraformFiles(outDir, answers);
+	if (resolveDeployTarget(answers) === "azure") await writeAzureTerraformFiles(outDir, answers);
+	if (resolveDeployTarget(answers) === "gcp") await writeGcpTerraformFiles(outDir, answers);
+	await writeDockerFiles(outDir, answers);
+}
+/** Write the GCP Terraform reference stack (`terraform/*.tf` + README). */
+async function writeGcpTerraformFiles(outDir, answers) {
+	const files = generateGcpTerraformFiles({
+		project: answers.name,
+		gcpProjectId: answers.gcpProjectId ?? "",
+		location: answers.gcpLocation ?? "us-central1",
+		...answers.domainName ? { domainName: answers.domainName } : {},
+		...answers.identityTenant ? { identityTenant: answers.identityTenant } : {}
+	});
+	await mkdir(join(outDir, "terraform"), { recursive: true });
+	for (const [relative, contents] of Object.entries(files)) await writeFile(join(outDir, relative), contents);
+	printLine(`Created terraform/ (${Object.keys(files).length} files)`);
+}
+/** Write the Azure Terraform reference stack (`terraform/*.tf` + README). */
+async function writeAzureTerraformFiles(outDir, answers) {
+	const files = generateAzureTerraformFiles({
+		project: answers.name,
+		location: answers.azureLocation ?? "eastus",
+		queueBackend: answers.azureQueueBackend ?? "storage-queues",
+		...answers.domainName ? { domainName: answers.domainName } : {},
+		...answers.entraTenantId ? { entraTenantId: answers.entraTenantId } : {}
+	});
+	await mkdir(join(outDir, "terraform"), { recursive: true });
+	for (const [relative, contents] of Object.entries(files)) await writeFile(join(outDir, relative), contents);
+	printLine(`Created terraform/ (${Object.keys(files).length} files)`);
 }
-async function writeDockerFiles(outDir, docker) {
-	if (!docker) return;
+/** Write the AWS Terraform reference stack (`terraform/*.tf` + README). */
+async function writeTerraformFiles(outDir, answers) {
+	const files = generateAwsTerraformFiles({
+		project: answers.name,
+		region: answers.awsRegion ?? "us-east-1",
+		dbEngine: answers.dbEngine ?? "rds",
+		...answers.domainName ? { domainName: answers.domainName } : {},
+		...answers.samlMetadataUrl ? { samlMetadataUrl: answers.samlMetadataUrl } : {}
+	});
+	await mkdir(join(outDir, "terraform"), { recursive: true });
+	for (const [relative, contents] of Object.entries(files)) await writeFile(join(outDir, relative), contents);
+	printLine(`Created terraform/ (${Object.keys(files).length} files)`);
+}
+async function writeDockerFiles(outDir, answers) {
+	if (!answers.docker) return;
+	if (isRemoteQueue(answers.queue) && answers.includeWorker) {
+		const slimDockerfile = [
+			"FROM node:lts-alpine",
+			"WORKDIR /app",
+			"COPY package.json ./",
+			"RUN npm install --omit=dev",
+			"COPY server.ts ./",
+			"RUN npx esbuild server.ts --bundle --platform=node --format=esm --outfile=dist/server.mjs",
+			"EXPOSE 3000",
+			"CMD [\"node\", \"dist/server.mjs\"]"
+		].join("\n");
+		await writeFile(join(outDir, "Dockerfile"), slimDockerfile);
+		await writeFile(join(outDir, "Dockerfile.worker"), generateWorkerDockerfile());
+		await writeFile(join(outDir, ".dockerignore"), generateDockerignore());
+		await writeFile(join(outDir, "compose.yaml"), generateComposeYamlWithWorker(answers.database));
+		printLine(`Created Dockerfile, Dockerfile.worker, .dockerignore, compose.yaml`);
+		return;
+	}
 	await writeFile(join(outDir, "Dockerfile"), generateDockerfile());
 	await writeFile(join(outDir, ".dockerignore"), generateDockerignore());
-	await writeFile(join(outDir, "compose.yaml"), generateComposeYaml());
+	await writeFile(join(outDir, "compose.yaml"), generateComposeYaml(answers.database));
 	printLine(`Created Dockerfile, .dockerignore, compose.yaml`);
 }
-function printNextSteps(answers) {
+function printNextSteps(answers, runner) {
 	printLine(`\nScaffolded ${answers.name} in ${resolve(answers.dir)}`);
 	printLine(`\nNext steps:`);
 	printLine(`  cd ${answers.dir}`);
-	if (answers.docker) printLine(`  docker compose up`);
-	else {
+	const target = resolveDeployTarget(answers);
+	if (target === "aws") {
+		printLine(`  terraform -chdir=terraform init`);
+		printLine(`  terraform -chdir=terraform plan -out=tfplan   # review before applying`);
+		printLine(`  terraform -chdir=terraform apply tfplan       # or: npm run infra:apply`);
+		printLine(`  # wire outputs into env (terraform output -json / npm run infra:outputs):`);
+		printLine(`  #   S3_BUCKET / AWS_REGION, QUEUE_URL, DATABASE_URL, COGNITO_* credentials`);
+		printLine(`  npm install`);
+		printLine(`  npm start`);
+		return;
+	}
+	if (target === "azure") {
+		printLine(`  az login`);
+		printLine(`  terraform -chdir=terraform init`);
+		printLine(`  terraform -chdir=terraform plan -out=tfplan   # review before applying`);
+		printLine(`  terraform -chdir=terraform apply tfplan       # or: npm run infra:apply`);
+		printLine(`  # wire outputs into env (terraform output -json / npm run infra:outputs):`);
+		printLine(`  #   AZURE_STORAGE_CONNECTION (+ AZURE_SERVICE_BUS_CONNECTION), DATABASE_URL, OIDC_* credentials`);
 		printLine(`  npm install`);
 		printLine(`  npm start`);
+		return;
+	}
+	if (target === "gcp") {
+		printLine(`  gcloud auth login`);
+		printLine(`  terraform -chdir=terraform init`);
+		printLine(`  terraform -chdir=terraform plan -out=tfplan   # review before applying`);
+		printLine(`  terraform -chdir=terraform apply tfplan       # or: npm run infra:apply`);
+		printLine(`  # wire outputs into env (terraform output -json / npm run infra:outputs):`);
+		printLine(`  #   GCS_BUCKET + GOOGLE_CLOUD_PROJECT, DATABASE_URL, OIDC_* credentials`);
+		printLine(`  npm install`);
+		printLine(`  npm start`);
+		return;
+	}
+	if (target === "docker") {
+		printLine(`  npm run docker:up      # builds + starts app (+ worker)`);
+		printLine(`  npm run docker:logs    # follow logs`);
+		printLine(`  npm run docker:down    # tear down`);
+		if (answers.includeWorker) {
+			printLine(`  # or separately:`);
+			printLine(`  # docker compose up storyshelf worker`);
+		}
+		return;
+	}
+	printLine(`  ${installCommand(runner)}`);
+	printLine(`  ${startCommand(runner)}`);
+	if (answers.includeWorker) {
+		printLine(`  # in another terminal:`);
+		printLine(`  npx storyshelf worker serve --dir .`);
 	}
 }
+function promptInitial(choices, value) {
+	if (value === void 0 || value === "") return;
+	const idx = choices.findIndex((c) => c.value === value);
+	if (idx === -1) return void 0;
+	return idx;
+}
 /**
-* Scaffold a new StoryShelf server project.
+* Scaffold a new StoryShelf server project via interactive prompts.
+*
+* Asks for project name, database, storage, auth, and git provider choices,
+* then generates `server.ts`, `package.json`, and optional Docker files in
+* the chosen directory.
 *
-* @param _options - Server init command options.
+* @param _options - Reserved for future CLI flags; currently prompts for all choices interactively
 */
 async function runServerInit(_options) {
-	const responses = await prompts([...PROJECT_PROMPTS, ...INFRA_PROMPTS]);
-	if (!responses["name"] || !responses["dir"]) {
+	const cwdPkg = detectInstalledAdapters(process.cwd());
+	const phase1 = await prompts([...PROJECT_PROMPTS, DEPLOY_TARGET_PROMPT]) ?? {};
+	if (!phase1["name"] || !phase1["dir"]) {
 		printError("Cancelled.");
 		return;
 	}
-	const answers = responses;
+	const answers = { ...phase1 };
+	const target = resolveDeployTarget(answers);
+	if (target === "local" || target === "docker") {
+		const advPhase = await prompts(ADVANCED_ADAPTERS_PROMPT) ?? {};
+		const advanced = answers.advancedAdapters ?? advPhase["advancedAdapters"] ?? false;
+		answers.advancedAdapters = advanced;
+		const localPrompts = localInfraPrompts(advanced).map((prompt) => {
+			if (prompt.type !== "select") return prompt;
+			const legacy = answers[prompt.name];
+			const detected = cwdPkg[prompt.name];
+			const initial = promptInitial(prompt.choices, legacy ?? detected);
+			if (initial !== void 0) return {
+				...prompt,
+				initial
+			};
+			return prompt;
+		});
+		const phase2 = await prompts(localPrompts) ?? {};
+		Object.assign(answers, phase2);
+		answers.advancedAdapters = advanced;
+		answers.deployTarget ??= target;
+	} else {
+		const legacyInfra = { ...phase1 };
+		Object.assign(answers, legacyInfra);
+	}
+	if (!answers.queue) answers.queue = "memory";
+	if (resolveDeployTarget(answers) === "aws") {
+		answers.database = "postgres";
+		answers.storage = "s3";
+		answers.queue = "sqs";
+		answers.includeWorker = true;
+		answers.docker = true;
+		const awsAnswers = await prompts(AWS_INFRA_PROMPTS) ?? {};
+		answers.awsRegion = awsAnswers["awsRegion"] ?? "us-east-1";
+		answers.dbEngine = awsAnswers["dbEngine"] ?? "rds";
+		answers.domainName = awsAnswers["domainName"] ?? void 0;
+		answers.samlMetadataUrl = awsAnswers["samlMetadataUrl"] ?? void 0;
+	}
+	if (resolveDeployTarget(answers) === "azure") {
+		answers.database = "postgres";
+		answers.storage = "azure";
+		answers.includeWorker = true;
+		answers.docker = true;
+		const azureAnswers = await prompts(AZURE_INFRA_PROMPTS) ?? {};
+		answers.azureLocation = azureAnswers["azureLocation"] ?? "eastus";
+		answers.azureQueueBackend = azureAnswers["azureQueueBackend"] ?? "storage-queues";
+		answers.queue = answers.azureQueueBackend === "service-bus" ? "azure-service-bus" : "azure-storage-queues";
+		answers.domainName = azureAnswers["domainName"] ?? void 0;
+		answers.entraTenantId = azureAnswers["entraTenantId"] ?? void 0;
+	}
+	if (resolveDeployTarget(answers) === "gcp") {
+		answers.database = "postgres";
+		answers.storage = "gcs";
+		answers.queue = "gcp-pubsub";
+		answers.includeWorker = true;
+		answers.docker = true;
+		const gcpAnswers = await prompts(GCP_INFRA_PROMPTS) ?? {};
+		answers.gcpProjectId = gcpAnswers["gcpProjectId"] ?? void 0;
+		answers.gcpLocation = gcpAnswers["gcpLocation"] ?? "us-central1";
+		answers.domainName = gcpAnswers["domainName"] ?? void 0;
+		answers.identityTenant = gcpAnswers["identityTenant"] ?? void 0;
+	}
+	if (resolveDeployTarget(answers) !== "aws" && resolveDeployTarget(answers) !== "azure" && resolveDeployTarget(answers) !== "gcp" && isRemoteQueue(answers.queue)) answers.includeWorker = (await prompts({
+		type: "confirm",
+		name: "includeWorker",
+		message: "Generate worker service alongside server?",
+		initial: true
+	}) ?? {})["includeWorker"] ?? true;
 	const outDir = resolve(answers.dir);
 	await mkdir(outDir, { recursive: true });
 	await writeFiles(outDir, answers);
-	printNextSteps(answers);
+	printNextSteps(answers, await detectPackageRunner(process.cwd()));
 }
 //#endregion
 export { runServerInit };