storyshelf 0.3.2 → 0.5.4

package/dist/commands/server/prompts.js

@@ -14,66 +14,348 @@ const PROJECT_PROMPTS = [{
 	message: "Directory?",
 	initial: (prev) => `./${prev}`
 }];
-const INFRA_PROMPTS = [
+const DEPLOY_TARGET_PROMPT = {
+	type: "select",
+	name: "deployTarget",
+	message: "Deploy target?",
+	choices: [
+		{
+			title: "Local (bare node)",
+			value: "local"
+		},
+		{
+			title: "Docker (compose)",
+			value: "docker"
+		},
+		{
+			title: "AWS (ECS + S3 + SQS + Postgres + Cognito)",
+			value: "aws"
+		},
+		{
+			title: "Azure (Container Apps + Blob + Queues/Service Bus + Postgres + Entra)",
+			value: "azure"
+		},
+		{
+			title: "Google Cloud (Cloud Run + GCS + Pub/Sub + Postgres + Identity Platform)",
+			value: "gcp"
+		}
+	]
+};
+/**
+* Curated shortlists for the local/docker path — one per engine plus the
+* zero-config default first. Everything else lives behind the advanced
+* toggle so newcomers pick from 4 databases, not 14.
+*/
+const CURATED_DATABASE_CHOICES = [
+	{
+		title: "SQLite (node:sqlite, local)",
+		value: "sqlite"
+	},
+	{
+		title: "Postgres (postgres.js, default)",
+		value: "postgres"
+	},
+	{
+		title: "MySQL / MariaDB (mysql2)",
+		value: "mysql"
+	},
+	{
+		title: "PGlite (embedded WASM Postgres)",
+		value: "pglite"
+	}
+];
+const ADVANCED_DATABASE_CHOICES = [
+	{
+		title: "Turso (libSQL, serverless)",
+		value: "turso"
+	},
+	{
+		title: "better-sqlite3 (native, local)",
+		value: "better-sqlite3"
+	},
+	{
+		title: "Bun SQLite (bun:sqlite)",
+		value: "bun-sqlite"
+	},
+	{
+		title: "Cloudflare D1 (serverless edge)",
+		value: "d1"
+	},
+	{
+		title: "Postgres pg (node-postgres, pooler-safe)",
+		value: "pg"
+	},
+	{
+		title: "Neon (serverless Postgres)",
+		value: "neon"
+	},
+	{
+		title: "Neon HTTP (fetch, edge)",
+		value: "neon-http"
+	},
+	{
+		title: "Vercel Postgres",
+		value: "vercel"
+	},
+	{
+		title: "PlanetScale (serverless MySQL)",
+		value: "planetscale"
+	},
+	{
+		title: "TiDB Serverless (MySQL)",
+		value: "tidb"
+	}
+];
+const CURATED_STORAGE_CHOICES = [{
+	title: "Local filesystem",
+	value: "local"
+}, {
+	title: "S3-compatible",
+	value: "s3"
+}];
+const ADVANCED_STORAGE_CHOICES = [{
+	title: "Azure Blob Storage",
+	value: "azure"
+}, {
+	title: "GCS (Google Cloud Storage)",
+	value: "gcs"
+}];
+const CURATED_QUEUE_CHOICES = [{
+	title: "In-memory (single server)",
+	value: "memory"
+}, {
+	title: "Redis (self-hosted, Docker Compose)",
+	value: "redis"
+}];
+const ADVANCED_QUEUE_CHOICES = [
+	{
+		title: "SQS (AWS remote worker)",
+		value: "sqs"
+	},
+	{
+		title: "Azure Storage Queues (Azurite-local, remote worker)",
+		value: "azure-storage-queues"
+	},
+	{
+		title: "Azure Service Bus (native dead-lettering, remote worker)",
+		value: "azure-service-bus"
+	},
+	{
+		title: "GCP Pub/Sub (emulator-local, remote worker)",
+		value: "gcp-pubsub"
+	}
+];
+/** Opt-in to the full adapter matrix on the local/docker path. */
+const ADVANCED_ADAPTERS_PROMPT = {
+	type: "confirm",
+	name: "advancedAdapters",
+	message: "Show all adapter options (serverless/edge presets)?",
+	initial: false
+};
+/** Database choices for the local/docker path. */
+function databaseChoices(advanced) {
+	return advanced ? [...CURATED_DATABASE_CHOICES, ...ADVANCED_DATABASE_CHOICES] : [...CURATED_DATABASE_CHOICES];
+}
+/** Storage choices for the local/docker path. */
+function storageChoices(advanced) {
+	return advanced ? [...CURATED_STORAGE_CHOICES, ...ADVANCED_STORAGE_CHOICES] : [...CURATED_STORAGE_CHOICES];
+}
+/** Capture-queue choices for the local/docker path. */
+function queueChoices(advanced) {
+	return advanced ? [...CURATED_QUEUE_CHOICES, ...ADVANCED_QUEUE_CHOICES] : [...CURATED_QUEUE_CHOICES];
+}
+const AUTH_SELECT = {
+	type: "select",
+	name: "auth",
+	message: "Which auth?",
+	choices: [
+		{
+			title: "None",
+			value: "none"
+		},
+		{
+			title: "Local accounts",
+			value: "password"
+		},
+		{
+			title: "OAuth/OIDC",
+			value: "oauth"
+		}
+	]
+};
+const GIT_SELECT = {
+	type: "select",
+	name: "git",
+	message: "Which git provider?",
+	choices: [
+		{
+			title: "None",
+			value: "none"
+		},
+		{
+			title: "GitHub",
+			value: "github"
+		},
+		{
+			title: "GitLab",
+			value: "gitlab"
+		}
+	]
+};
+const DOCKER_CONFIRM = {
+	type: "confirm",
+	name: "docker",
+	message: "Generate Docker files?",
+	initial: true
+};
+const NOTIFICATIONS_CONFIRM = {
+	type: "confirm",
+	name: "notifications",
+	message: "Enable email + chat notifications (Slack/Teams/email channels)?",
+	initial: true
+};
+/**
+* Curated prompts for the local/docker path — deploy target is asked first
+* (phase 1), then these (phase 2) with the shortlist or full matrix behind
+* the advanced toggle.
+*/
+function localInfraPrompts(advanced) {
+	return [
+		{
+			type: "select",
+			name: "database",
+			message: "Which database?",
+			choices: databaseChoices(advanced)
+		},
+		{
+			type: "select",
+			name: "storage",
+			message: "Which storage?",
+			choices: storageChoices(advanced)
+		},
+		AUTH_SELECT,
+		GIT_SELECT,
+		{
+			type: "select",
+			name: "queue",
+			message: "Which capture queue?",
+			choices: queueChoices(advanced)
+		},
+		DOCKER_CONFIRM,
+		NOTIFICATIONS_CONFIRM
+	];
+}
+const WORKER_INFRA_PROMPTS = [
 	{
 		type: "select",
 		name: "database",
 		message: "Which database?",
-		choices: [{
-			title: "SQLite (local)",
-			value: "sqlite"
-		}, {
-			title: "Turso (serverless)",
-			value: "turso"
-		}]
+		choices: [
+			{
+				title: "SQLite (node:sqlite, local)",
+				value: "sqlite"
+			},
+			{
+				title: "Turso (libSQL, serverless)",
+				value: "turso"
+			},
+			{
+				title: "better-sqlite3 (native, local)",
+				value: "better-sqlite3"
+			},
+			{
+				title: "Bun SQLite (bun:sqlite)",
+				value: "bun-sqlite"
+			},
+			{
+				title: "Cloudflare D1 (serverless edge)",
+				value: "d1"
+			},
+			{
+				title: "Postgres (postgres.js, default)",
+				value: "postgres"
+			},
+			{
+				title: "Postgres pg (node-postgres)",
+				value: "pg"
+			},
+			{
+				title: "Neon (serverless Postgres)",
+				value: "neon"
+			},
+			{
+				title: "Neon HTTP (fetch)",
+				value: "neon-http"
+			},
+			{
+				title: "Vercel Postgres",
+				value: "vercel"
+			},
+			{
+				title: "PGlite (embedded)",
+				value: "pglite"
+			},
+			{
+				title: "MySQL / MariaDB",
+				value: "mysql"
+			},
+			{
+				title: "PlanetScale",
+				value: "planetscale"
+			},
+			{
+				title: "TiDB Serverless",
+				value: "tidb"
+			}
+		]
 	},
 	{
 		type: "select",
 		name: "storage",
 		message: "Which storage?",
-		choices: [{
-			title: "Local filesystem",
-			value: "local"
-		}, {
-			title: "S3-compatible",
-			value: "s3"
-		}]
-	},
-	{
-		type: "select",
-		name: "auth",
-		message: "Which auth?",
 		choices: [
 			{
-				title: "None",
-				value: "none"
+				title: "Local filesystem",
+				value: "local"
 			},
 			{
-				title: "Shared password",
-				value: "password"
+				title: "S3-compatible",
+				value: "s3"
 			},
 			{
-				title: "OAuth/OIDC",
-				value: "oauth"
+				title: "GCS (Google Cloud Storage)",
+				value: "gcs"
 			}
 		]
 	},
 	{
 		type: "select",
-		name: "git",
-		message: "Which git provider?",
+		name: "queue",
+		message: "Which queue?",
 		choices: [
 			{
-				title: "None",
-				value: "none"
+				title: "SQS (AWS)",
+				value: "sqs"
+			},
+			{
+				title: "Redis (self-hosted)",
+				value: "redis"
 			},
 			{
-				title: "GitHub",
-				value: "github"
+				title: "Azure Storage Queues",
+				value: "azure-storage-queues"
 			},
 			{
-				title: "GitLab",
-				value: "gitlab"
+				title: "Azure Service Bus",
+				value: "azure-service-bus"
+			},
+			{
+				title: "GCP Pub/Sub",
+				value: "gcp-pubsub"
+			},
+			{
+				title: "In-memory (local dev only)",
+				value: "memory"
 			}
 		]
 	},
@@ -84,5 +366,98 @@ const INFRA_PROMPTS = [
 		initial: true
 	}
 ];
+/** Follow-up prompts for the GCP deploy target (single prompts call). */
+const GCP_INFRA_PROMPTS = [
+	{
+		type: "text",
+		name: "gcpProjectId",
+		message: "GCP project ID?",
+		initial: ""
+	},
+	{
+		type: "text",
+		name: "gcpLocation",
+		message: "GCP region?",
+		initial: "us-central1"
+	},
+	{
+		type: "text",
+		name: "domainName",
+		message: "Public domain for the app? (empty skips DNS)",
+		initial: ""
+	},
+	{
+		type: "text",
+		name: "identityTenant",
+		message: "Identity Platform tenant display name? (empty skips it)",
+		initial: ""
+	}
+];
+/** Follow-up prompts for the Azure deploy target (single prompts call). */
+const AZURE_INFRA_PROMPTS = [
+	{
+		type: "text",
+		name: "azureLocation",
+		message: "Azure region?",
+		initial: "eastus"
+	},
+	{
+		type: "select",
+		name: "azureQueueBackend",
+		message: "Azure capture queue backend?",
+		choices: [{
+			title: "Storage Queues (Azurite-testable, visibility-timeout)",
+			value: "storage-queues"
+		}, {
+			title: "Service Bus (native dead-lettering, SQS + DLQ parity)",
+			value: "service-bus"
+		}]
+	},
+	{
+		type: "text",
+		name: "domainName",
+		message: "Public domain for the app? (empty skips DNS)",
+		initial: ""
+	},
+	{
+		type: "text",
+		name: "entraTenantId",
+		message: "Entra tenant ID for the app registration? (empty skips it)",
+		initial: ""
+	}
+];
+/** Follow-up prompts for the AWS deploy target (single prompts call). */
+const AWS_INFRA_PROMPTS = [
+	{
+		type: "text",
+		name: "awsRegion",
+		message: "AWS region?",
+		initial: "us-east-1"
+	},
+	{
+		type: "select",
+		name: "dbEngine",
+		message: "Postgres engine?",
+		choices: [{
+			title: "RDS (VPC-isolated, battle-tested)",
+			value: "rds"
+		}, {
+			title: "Aurora DSQL (serverless)",
+			value: "dsql"
+		}]
+	},
+	{
+		type: "text",
+		name: "domainName",
+		message: "Public domain for the ALB? (empty leaves it HTTP-only)",
+		initial: ""
+	},
+	{
+		type: "text",
+		name: "samlMetadataUrl",
+		message: "SAML metadata URL for Cognito federation? (empty skips it)",
+		initial: ""
+	}
+];
 //#endregion
-export { INFRA_PROMPTS, PROJECT_PROMPTS };
+export { ADVANCED_ADAPTERS_PROMPT, ADVANCED_DATABASE_CHOICES, ADVANCED_QUEUE_CHOICES, ADVANCED_STORAGE_CHOICES, AWS_INFRA_PROMPTS, AZURE_INFRA_PROMPTS, CURATED_DATABASE_CHOICES, CURATED_QUEUE_CHOICES, CURATED_STORAGE_CHOICES, DEPLOY_TARGET_PROMPT, GCP_INFRA_PROMPTS, PROJECT_PROMPTS, WORKER_INFRA_PROMPTS, databaseChoices, localInfraPrompts, queueChoices, storageChoices };

package/dist/commands/server/serve.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+import "node:path";
+import "node:url";
+import.meta.url;
+import { detectPackageRunner, installCommand } from "../../config.js";
+import { printLine } from "../../output.js";
+import { join, resolve } from "node:path";
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+//#region src/commands/server/serve.ts
+/** Server entry filenames tried in order. */
+const SERVER_CANDIDATES = [
+	"server.ts",
+	"server.js",
+	"server.mjs",
+	"index.ts",
+	"index.js",
+	"index.mjs"
+];
+/**
+* Locate the server entry file in a scaffolded project.
+* Tries `server.ts`, `server.js`, `server.mjs`, then `index.*` fallbacks.
+*
+* @param dir - Absolute path to the server project directory
+* @returns Absolute path to the first entry that exists
+* @throws If no candidate is found (suggests running `storyshelf server init`)
+*/
+async function resolveServerFile(dir) {
+	for (const candidate of SERVER_CANDIDATES) {
+		const full = join(dir, candidate);
+		try {
+			await access(full);
+			return full;
+		} catch {
+			continue;
+		}
+	}
+	throw new Error(`No server entry found in ${dir} (looked for ${SERVER_CANDIDATES.join(", ")}). Run "storyshelf server init" first.`);
+}
+/** Node flags for an entry file (TypeScript needs the transform flag). */
+function nodeArgs(file) {
+	return file.endsWith(".ts") ? ["--experimental-transform-types", file] : [file];
+}
+/** Forward SIGINT/SIGTERM to the child; returns a handle to detach and inspect. */
+function relaySignals(child) {
+	let relayed = false;
+	const relay = (signal) => {
+		relayed = true;
+		child.kill(signal);
+	};
+	const onSigint = () => {
+		relay("SIGINT");
+	};
+	const onSigterm = () => {
+		relay("SIGTERM");
+	};
+	process.on("SIGINT", onSigint);
+	process.on("SIGTERM", onSigterm);
+	return {
+		stop: () => {
+			process.off("SIGINT", onSigint);
+			process.off("SIGTERM", onSigterm);
+		},
+		relayed: () => relayed
+	};
+}
+/** Resolve the child exit code (relay-terminated exits count as clean). */
+function waitForExit(child, relay) {
+	return new Promise((resolvePromise, rejectPromise) => {
+		child.on("error", rejectPromise);
+		child.on("exit", (code, signal) => {
+			if (signal && relay.relayed()) resolvePromise(0);
+			else resolvePromise(code ?? 1);
+		});
+	});
+}
+/** Spawn a child server, forwarding signals and resolving its exit code. */
+async function defaultSpawnProcess(command, args, options) {
+	const child = spawn(command, [...args], {
+		stdio: "inherit",
+		cwd: options.cwd,
+		env: options.env
+	});
+	const relay = relaySignals(child);
+	try {
+		return await waitForExit(child, relay);
+	} finally {
+		relay.stop();
+	}
+}
+async function warnIfUninstalled(dir) {
+	try {
+		await access(join(dir, "node_modules"));
+	} catch {
+		const runner = await detectPackageRunner(dir);
+		printLine(`Warning: no node_modules in ${dir} — run "${installCommand(runner)}" there first if the server fails to start.`);
+	}
+}
+/**
+* Run an existing scaffolded server project.
+*
+* @param options - Directory and port override.
+* @param deps - Injectable process spawner (test seam).
+*/
+async function runServerServe(options, deps = {}) {
+	const dir = resolve(options.dir ?? process.cwd());
+	const file = await resolveServerFile(dir);
+	await warnIfUninstalled(dir);
+	printLine(`Starting server: ${file}`);
+	const code = await (deps.spawnProcess ?? defaultSpawnProcess)(process.execPath, nodeArgs(file), {
+		cwd: dir,
+		env: childEnv(options)
+	});
+	if (code !== 0) throw new Error(`Server exited with code ${code}`);
+}
+/** Child environment: inherit the parent, applying the port override. */
+function childEnv(options) {
+	const env = { ...process.env };
+	if (options.port !== void 0) env["PORT"] = options.port;
+	return env;
+}
+//#endregion
+export { resolveServerFile, runServerServe };