@prisma/composer 0.2.0-dev.18 → 0.2.0-dev.19

package/dist/{app-config-B-mHQL-a-CPD39ljh.d.mts → app-config-Dw3r7sUa-D3dr8rg2.d.mts}

@@ -5,7 +5,7 @@ import { Input, StackServices } from "alchemy";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import { State } from "alchemy/State/State";
-//#region ../../0-framework/1-core/core/dist/app-config-B-mHQL-a.d.mts
+//#region ../../0-framework/1-core/core/dist/app-config-Dw3r7sUa.d.mts
 //#region src/container-transport.d.ts
 /**
  * Carries resolved containers from the CLI process into the alchemy process
@@ -445,8 +445,10 @@ interface LocalTargetAttachment {
     readonly address: string;
     readonly url: string;
   }[]>;
-  /** Merged, line-oriented log stream across the app's services (including services that appear after later converges). Ends when `signal` aborts. */
-  logs(signal: AbortSignal): AsyncIterable<{
+  /** Merged, line-oriented log stream across the app's services (including services that appear after later converges). `opts.tail` is how many trailing lines of existing history to emit before live output (default 0 — live only). Ends when `signal` aborts. */
+  logs(signal: AbortSignal, opts?: {
+    readonly tail?: number;
+  }): AsyncIterable<{
     readonly service: string;
     readonly line: string;
   }>;
@@ -490,4 +492,4 @@ interface PrismaAppConfig {
 declare function defineConfig(config: PrismaAppConfig): PrismaAppConfig;
 //#endregion
 export { ProvisionerDescriptor as A, joinDeployment as B, Lowering as C, PreflightInput as D, PackageInput as E, containerEnv as F, lowering as H, containerEnvVarName as I, defineConfig as L, StateDescriptor as M, TeardownInput as N, PrismaAppConfig as O, buildConfig as P, deserializeContainers as R, LoweredResult as S, Outputs as T, mergedProviders as U, lower as V, resolveStateLayer as W, LocalTargetProvidersInput as _, Bundle as a, LowerError as b, DEV_DIR as c, DeploymentResult as d, ExtensionDescriptor as f, LocalTargetEmulatorsInput as g, LocalTargetDescriptor as h, AssembleInput as i, ServiceLowering as j, ProvisionEdge as k, DeployedEntity as l, LocalTargetAttachment as m, ApplicationDescriptor as n, ContainerDescriptor as o, LocalTargetAttachInput as p, Artifact as r, ContainerInstance as s, AlchemyStateLayer as t, DeployedNode as u, LocateContainerInput as v, NodeDescriptor as w, LowerOptions as x, LowerContext as y, isBuildOnlyExtension as z };
-//# sourceMappingURL=app-config-B-mHQL-a-CPD39ljh.d.mts.map
+//# sourceMappingURL=app-config-Dw3r7sUa-D3dr8rg2.d.mts.map

package/dist/{app-config-B-mHQL-a-CPD39ljh.d.mts.map → app-config-Dw3r7sUa-D3dr8rg2.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"app-config-B-mHQL-a-CPD39ljh.d.mts","names":[],"sources":["../../../0-framework/1-core/core/dist/app-config-B-mHQL-a.d.mts"],"mappings":"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"}
+{"version":3,"file":"app-config-Dw3r7sUa-D3dr8rg2.d.mts","names":[],"sources":["../../../0-framework/1-core/core/dist/app-config-Dw3r7sUa.d.mts"],"mappings":"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"}

package/dist/bin.mjs

@@ -2220,7 +2220,7 @@ var esm_default = {
 	FSWatcher
 };
 //#endregion
-//#region ../../0-framework/3-tooling/cli/dist/cli-B3LcFQLH.mjs
+//#region ../../0-framework/3-tooling/cli/dist/cli-CH8Ewf_a.mjs
 /**
 * A user-facing failure with a message that already names the fix (deploy-cli.md
 * § Error surface). `bin.ts` catches this — and any other Error, including
@@ -2395,6 +2395,27 @@ function validateRegistryCoverage(graph, config) {
 * cannot drift.
 */
 /**
+* The pipeline's front — config discovery/load, entry load, name resolution —
+* WITHOUT Load, coverage, or assemble. `log` needs only who the app is (its
+* config and resolved name) to reach the already-running local instance; it
+* neither builds nor provisions, so it must not require the user's built
+* output the way the full pipeline does.
+*/
+async function resolveAppIdentity(entry, overrideName, cwd, deps = {}) {
+	const resolvedEntryPath = path.resolve(cwd, entry);
+	const configPath = findConfigPathForEntry(resolvedEntryPath);
+	if (configPath === void 0) throw missingConfigError(resolvedEntryPath);
+	const config = deps.config ?? (await loadAppConfig(configPath)).config;
+	const entryModule = await loadEntry(entry, cwd);
+	const name = overrideName ?? entryModule.root.name;
+	if (name.length === 0) throw new CliError("The root node has no name — name it at authoring, or pass --name.");
+	return {
+		configPath,
+		config,
+		name
+	};
+}
+/**
 * Runs config discovery/load, entry load, Load, registry coverage, name
 * resolution, and assemble — steps 1–6 of `run()`. `onAssembleError`, when
 * given, lets a caller decorate an assemble failure with command-specific
@@ -2656,7 +2677,7 @@ function startWatch(targets, onChange) {
 * against a generated dev stack file, attach (front door + merged logs),
 * watch loop until interrupted.
 */
-function toCliError(error) {
+function toCliError$1(error) {
 	return error instanceof CliError ? error : new CliError(error instanceof Error ? error.message : String(error));
 }
 /** `[dev] ready:` then one line per endpoint, ordered by address depth (fewest dots first) then lexicographic. Exported for tests. */
@@ -2687,19 +2708,6 @@ async function withEmulatorRetry(call) {
 async function mergedEndpoints(attachments) {
 	return (await Promise.all(attachments.map((a) => withEmulatorRetry(() => a.endpoints())))).flat();
 }
-/** Pumps every attachment's merged log stream to stdout, each line prefixed `[<service>] `, until `signal` aborts. */
-function pumpLogs(attachments, signal) {
-	for (const attachment of attachments) (async () => {
-		try {
-			for await (const { service, line } of attachment.logs(signal)) {
-				if (signal.aborted) return;
-				console.log(`[${service}] ${line}`);
-			}
-		} catch (error) {
-			if (!signal.aborted) console.error(`[dev] log stream failed: ${error instanceof Error ? error.message : String(error)}`);
-		}
-	})();
-}
 /** Runs the full dev pipeline; returns the process exit code. */
 async function runDev(args, deps = {}) {
 	if (process.platform === "win32") throw new CliError("local dev is not supported on Windows yet.");
@@ -2714,7 +2722,7 @@ async function runDev(args, deps = {}) {
 	try {
 		resolved = await resolveLocalTargets(config);
 	} catch (error) {
-		throw toCliError(error);
+		throw toCliError$1(error);
 	}
 	const containers = /* @__PURE__ */ new Map();
 	for (const [id, dev] of resolved) try {
@@ -2723,7 +2731,7 @@ async function runDev(args, deps = {}) {
 			stage: void 0
 		}));
 	} catch (error) {
-		throw toCliError(error);
+		throw toCliError$1(error);
 	}
 	if (args.fresh) for (const [id, dev] of resolved) {
 		if (dev.teardown === void 0) continue;
@@ -2733,7 +2741,7 @@ async function runDev(args, deps = {}) {
 				stage: void 0
 			});
 		} catch (error) {
-			throw toCliError(error);
+			throw toCliError$1(error);
 		}
 	}
 	for (const [id, dev] of resolved) {
@@ -2745,7 +2753,7 @@ async function runDev(args, deps = {}) {
 				stage: void 0
 			});
 		} catch (error) {
-			throw toCliError(error);
+			throw toCliError$1(error);
 		}
 	}
 	for (const [id, dev] of resolved) {
@@ -2757,7 +2765,7 @@ async function runDev(args, deps = {}) {
 				devDir
 			});
 		} catch (error) {
-			throw toCliError(error);
+			throw toCliError$1(error);
 		}
 	}
 	const converge = () => {
@@ -2794,11 +2802,10 @@ async function runDev(args, deps = {}) {
 		started.push(attachment);
 	} catch (error) {
 		await Promise.all(started.map((a) => a.stopServices().catch(() => void 0)));
-		throw toCliError(error);
+		throw toCliError$1(error);
 	}
 	printFrontDoor(await mergedEndpoints(attachments));
-	const logsController = new AbortController();
-	pumpLogs(attachments, logsController.signal);
+	console.log(`[dev] logs: prisma-composer log ${args.entry}`);
 	const { targets, unwatchable } = watchTargetsFrom(assembled.bundles);
 	for (const address of unwatchable) console.log(`[dev] ${address} has no watchable inputs`);
 	const watch = startWatch(targets, () => {
@@ -2837,7 +2844,6 @@ async function runDev(args, deps = {}) {
 			console.log("[dev] stopping — the app's services are stopping; emulators and data stay up.");
 			watch.stop();
 			(async () => {
-				logsController.abort();
 				for (const attachment of attachments) await attachment.stopServices().catch(() => void 0);
 				console.log("[dev] stopped.");
 				resolve();
@@ -2903,6 +2909,70 @@ function writeStackFile(input) {
 	return filePath;
 }
 const GENERATED_STACK_RELATIVE_PATH = path.join(GENERATED_DIR, GENERATED_FILE);
+/**
+* `prisma-composer log <entry> [address]` — tail the merged logs of an
+* already-running local app. It resolves the app the way `dev` does (config →
+* localTarget → container → attach) but calls only the attachment's `logs()`
+* view: it neither builds, provisions, starts, nor stops anything. `dev` no
+* longer streams logs inline (that drowned the front door once it supervises
+* more than one service); this is where logs live.
+*/
+function toCliError(error) {
+	return error instanceof CliError ? error : new CliError(error instanceof Error ? error.message : String(error));
+}
+/** Runs the log tail until interrupted; returns the process exit code. */
+async function runLog(args, deps = {}) {
+	if (process.platform === "win32") throw new CliError("local dev is not supported on Windows yet.");
+	const cwd = process.cwd();
+	const devDir = path.join(cwd, DEV_DIR);
+	const { config, name } = deps.identity ?? await resolveAppIdentity(args.entry, args.name, cwd, { config: deps.config });
+	let resolved;
+	try {
+		resolved = await resolveLocalTargets(config);
+	} catch (error) {
+		throw toCliError(error);
+	}
+	const attachments = [];
+	for (const target of resolved.values()) try {
+		const container = await target.container.ensure({
+			appName: name,
+			stage: void 0
+		});
+		attachments.push(await target.attach({
+			container,
+			devDir
+		}));
+	} catch (error) {
+		throw toCliError(error);
+	}
+	const services = (await Promise.all(attachments.map((a) => a.endpoints()))).flat();
+	if (services.length === 0) {
+		console.error(`[log] no running services for "${name}" — start it first with \`prisma-composer dev ${args.entry}\`.`);
+		return 0;
+	}
+	if (args.address !== void 0 && !services.some((s) => s.address === args.address)) throw new CliError(`no service "${args.address}" in "${name}" — running services: ${services.map((s) => s.address).join(", ")}.`);
+	const controller = new AbortController();
+	const finish = () => controller.abort();
+	process.on("SIGINT", finish);
+	process.on("SIGTERM", finish);
+	try {
+		await Promise.all(attachments.map(async (attachment) => {
+			try {
+				for await (const { service, line } of attachment.logs(controller.signal, { tail: args.tail })) {
+					if (controller.signal.aborted) return;
+					if (args.address !== void 0 && service !== args.address) continue;
+					console.log(`[${service}] ${line}`);
+				}
+			} catch (error) {
+				if (!controller.signal.aborted) console.error(`[log] stream failed: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}));
+	} finally {
+		process.off("SIGINT", finish);
+		process.off("SIGTERM", finish);
+	}
+	return 0;
+}
 /** A stage name must be a valid git ref (deploy-cli.md) — checked via `git check-ref-format`, never silently normalized. Runs before anything platform-specific. */
 function validateStageName(stage) {
 	const result = spawnSync("git", ["check-ref-format", `refs/heads/${stage}`], { stdio: "ignore" });
@@ -2955,11 +3025,29 @@ var DevCommand = class extends Command {
 		return 0;
 	}
 };
+var LogCommand = class extends Command {
+	static paths = [["log"]];
+	static usage = Command.Usage({
+		description: "Tail the merged logs of the locally-running application whose root node is <entry>'s default export.",
+		examples: [["Tail every service", "$0 log src/service.ts"], ["Tail one service", "$0 log src/service.ts catalog.service"]]
+	});
+	entry = Option.String({ name: "entry" });
+	address = Option.String({
+		name: "address",
+		required: false
+	});
+	name = Option.String("--name", { description: "Override the root node's name — the dev instance's application name." });
+	tail = Option.String("--tail", { description: `How many trailing history lines to show before live output (default ${String(DEFAULT_LOG_TAIL)}).` });
+	async execute() {
+		return 0;
+	}
+};
 function buildCli() {
 	return Cli.from([
 		DeployCommand,
 		DestroyCommand,
-		DevCommand
+		DevCommand,
+		LogCommand
 	], {
 		binaryName: BINARY_NAME,
 		binaryLabel: "The prisma-composer deploy CLI"
@@ -2973,6 +3061,8 @@ function isUnknownSyntaxError(error) {
 	const meta = error.clipanion;
 	return typeof meta === "object" && meta !== null && meta.type === "none";
 }
+/** `log`'s default backlog: an empty screen reads as broken, so show a little recent history before going live. */
+const DEFAULT_LOG_TAIL = 20;
 /** Exported for direct testing (main.test.ts) — not part of the package's public barrel (see index.ts). */
 function parseArgs(argv) {
 	const cli = buildCli();
@@ -2999,6 +3089,20 @@ function parseArgs(argv) {
 		production: false,
 		fresh: command.fresh
 	};
+	if (command instanceof LogCommand) {
+		const tail = command.tail === void 0 ? DEFAULT_LOG_TAIL : Number.parseInt(command.tail, 10);
+		if (Number.isNaN(tail) || tail < 0) throw new UsageError("`--tail` must be a non-negative integer.");
+		return {
+			command: "log",
+			entry: command.entry,
+			name: command.name,
+			stage: void 0,
+			production: false,
+			fresh: false,
+			address: command.address,
+			tail
+		};
+	}
 	if (argv.includes("--help") || argv.includes("-h")) throw new HelpRequested(cli.usage(null, { detailed: true }));
 	throw new UsageError(cli.usage(null, { detailed: true }));
 }
@@ -3031,6 +3135,12 @@ async function run(argv, deps = {}) {
 		throw error;
 	}
 	if (args.command === "dev") return runDev(args, deps);
+	if (args.command === "log") return runLog({
+		entry: args.entry,
+		name: args.name,
+		address: args.address,
+		tail: args.tail ?? DEFAULT_LOG_TAIL
+	}, { config: deps.config });
 	const stage = effectiveStage(args);
 	if (stage !== void 0) validateStageName(stage);
 	const cwd = process.cwd();