@buildepicshit/cli 0.0.4 → 0.0.5

package/package.json

@@ -35,5 +35,5 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"type": "module",
-	"version": "0.0.4"
+	"version": "0.0.5"
 }

package/src/orchestrator/core/__tests__/command.test.ts

@@ -133,14 +133,14 @@ describe("command identity", () => {
 		expect(c.identity.name).toBe("tsx");
 	});
 
-	it("overrides identity with .identity(suffix)", () => {
-		const c = cmd("node server.js").identity("custom").dir("apps/api");
+	it("overrides identity with .withIdentity(suffix)", () => {
+		const c = cmd("node server.js").withIdentity("custom").dir("apps/api");
 		expect(c.identity.name).toBe("custom");
 	});
 
 	it("identity suffix propagates through builder chain", () => {
 		const c = cmd("node server.js")
-			.identity("api")
+			.withIdentity("api")
 			.dir("apps/server")
 			.env({ KEY: "value" })
 			.flag("verbose");
@@ -149,13 +149,13 @@ describe("command identity", () => {
 
 	it("identity is immutable across branches", () => {
 		const base = cmd("node server.js");
-		const withId = base.identity("custom");
+		const withId = base.withIdentity("custom");
 		expect(base.identity.name).toBe("node");
 		expect(withId.identity.name).toBe("custom");
 	});
 
 	it("identity.port() returns a token", async () => {
-		const c = cmd("node server.js").identity("api").dir("apps/api");
+		const c = cmd("node server.js").withIdentity("api").dir("apps/api");
 		const token = c.identity.port();
 		expect(typeof token).toBe("function");
 		const port = Number.parseInt(
@@ -167,14 +167,14 @@ describe("command identity", () => {
 	});
 
 	it("identity.localhostUrl() returns a token", async () => {
-		const c = cmd("node server.js").identity("api");
+		const c = cmd("node server.js").withIdentity("api");
 		const token = c.identity.localhostUrl("/health");
 		const url = await (token as (ctx: ComputeContext) => Promise<string>)(ctx);
 		expect(url).toMatch(/^http:\/\/localhost:\d+\/health$/);
 	});
 
 	it("cross-command identity access works", async () => {
-		const server = cmd("node server.js").identity("api").dir("apps/api");
+		const server = cmd("node server.js").withIdentity("api").dir("apps/api");
 		const built = await cmd("next dev")
 			.env({ API_URL: server.identity.localhostUrl() })
 			.build(ctx);
@@ -182,7 +182,7 @@ describe("command identity", () => {
 	});
 
 	it("identity.port(name) resolves a named sub-identity", async () => {
-		const c = cmd("docker compose").identity("infra");
+		const c = cmd("docker compose").withIdentity("infra");
 		const dbPortToken = c.identity.port("database");
 		const infraPortToken = c.identity.port();
 		const dbPort = await (dbPortToken as (ctx: ComputeContext) => Promise<string>)(ctx);
@@ -193,7 +193,7 @@ describe("command identity", () => {
 	});
 
 	it("identity.localhostUrl with portIdentity option", async () => {
-		const c = cmd("docker compose").identity("infra");
+		const c = cmd("docker compose").withIdentity("infra");
 		const urlToken = c.identity.localhostUrl("/health", { portIdentity: "minio" });
 		const url = await (urlToken as (ctx: ComputeContext) => Promise<string>)(ctx);
 		expect(url).toMatch(/^http:\/\/localhost:\d+\/health$/);
@@ -216,7 +216,7 @@ describe("multiple waitFor", () => {
 
 	it("accepts callback form for multiple waitFor", async () => {
 		const c = cmd("node server.js")
-			.identity("api")
+			.withIdentity("api")
 			.waitFor((self) => health.http(self.identity.url("/livez")))
 			.waitFor((self) => health.tcp("localhost", self.identity.port()));
 		const built = await c.build(ctx);
@@ -227,7 +227,7 @@ describe("multiple waitFor", () => {
 describe("waitFor callback form", () => {
 	it("accepts a callback that receives the command", async () => {
 		const c = cmd("node server.js")
-			.identity("api")
+			.withIdentity("api")
 			.dir("apps/api")
 			.waitFor((self) => health.http(self.identity.url("/livez")));
 
@@ -240,7 +240,7 @@ describe("waitFor callback form", () => {
 describe("env callback form", () => {
 	it("accepts a callback that receives the command", async () => {
 		const c = cmd("node server.js")
-			.identity("api")
+			.withIdentity("api")
 			.env((self) => ({ PORT: self.identity.port() }));
 
 		const built = await c.build(ctx);
@@ -251,7 +251,7 @@ describe("env callback form", () => {
 
 	it("mixes callback env with record env", async () => {
 		const c = cmd("node server.js")
-			.identity("api")
+			.withIdentity("api")
 			.env({ A: "1" })
 			.env((self) => ({ PORT: self.identity.port() }))
 			.env({ B: "2" });

package/src/orchestrator/core/command.ts

@@ -14,7 +14,6 @@ import {
 	type HealthCheck,
 	type HealthCheckCallback,
 	type ICommand,
-	type IdentityAccessor,
 	isEnvCallback,
 	isLazyEnvSource,
 	type Runnable,
@@ -41,24 +40,14 @@ class Command implements ICommand {
 		this.state = state;
 	}
 
-	get identity(): IdentityAccessor {
-		const id = createIdentity(
+	get identity() {
+		return createIdentity(
 			this.state.identitySuffix ?? this.deriveName(),
 		);
-		const self = this;
-		const setter = (suffix: string): ICommand => {
-			return new Command({ ...self.state, identitySuffix: suffix });
-		};
-		// Function.name is read-only, must use defineProperty
-		Object.defineProperty(setter, "name", {
-			configurable: true,
-			value: id.name,
-		});
-		return Object.assign(setter, {
-			localhostUrl: id.localhostUrl,
-			port: id.port,
-			url: id.url,
-		}) as IdentityAccessor;
+	}
+
+	withIdentity(suffix: string): ICommand {
+		return new Command({ ...this.state, identitySuffix: suffix });
 	}
 
 	flag(name: string, value?: Token): ICommand {

package/src/orchestrator/core/index.ts

@@ -29,7 +29,7 @@ export type {
 	HealthCheckCallback,
 	ICommand,
 	ICompound,
-	IdentityAccessor,
+
 	LazyEnvSource,
 	ProcessStatus,
 	Runnable,

package/src/orchestrator/core/types.ts

@@ -46,10 +46,6 @@ export interface BuiltCommand {
 	env: Record<string, string>;
 }
 
-export interface IdentityAccessor extends Identity {
-	(suffix: string): ICommand;
-}
-
 export interface ICommand {
 	readonly __type: "command";
 	arg(value: Token): ICommand;
@@ -60,9 +56,10 @@ export interface ICommand {
 	dir(path: string): ICommand;
 	env(source: EnvSource): ICommand;
 	flag(name: string, value?: Token): ICommand;
-	readonly identity: IdentityAccessor;
+	readonly identity: Identity;
 	run(): Promise<void>;
 	waitFor(check: HealthCheck | HealthCheckCallback): ICommand;
+	withIdentity(suffix: string): ICommand;
 }
 
 // ─── Compound ────────────────────────────────────────────────────────────────

package/src/orchestrator/index.ts

@@ -25,7 +25,7 @@ export type {
 	HealthCheckCallback,
 	ICommand,
 	ICompound,
-	IdentityAccessor,
+
 	ProcessStatus,
 	Runnable,
 	Token,

package/src/orchestrator/presets/docker.ts

@@ -6,14 +6,15 @@ import type {
 	HealthCheck,
 	HealthCheckCallback,
 	ICommand,
-	IdentityAccessor,
 	Runnable,
 	Token,
 } from "../core/types.js";
+import type { Identity } from "../utils/dna.js";
 
 export interface IDockerCompose extends ICommand {
 	file(path: string): IDockerCompose;
 	up(options?: { detach?: boolean }): IDockerCompose;
+	withIdentity(suffix: string): IDockerCompose;
 }
 
 interface DockerComposeState {
@@ -49,24 +50,12 @@ class DockerCompose implements IDockerCompose {
 
 	// ─── ICommand delegation (returns IDockerCompose for chaining) ───────
 
-	get identity(): IdentityAccessor {
-		const innerAccessor = this.inner.identity;
-		const self = this;
-		const setter = (suffix: string): IDockerCompose => {
-			return new DockerCompose(
-				self.inner.identity(suffix),
-				self.dcState,
-			);
-		};
-		Object.defineProperty(setter, "name", {
-			configurable: true,
-			value: innerAccessor.name,
-		});
-		return Object.assign(setter, {
-			localhostUrl: innerAccessor.localhostUrl,
-			port: innerAccessor.port,
-			url: innerAccessor.url,
-		}) as IdentityAccessor;
+	get identity(): Identity {
+		return this.inner.identity;
+	}
+
+	withIdentity(suffix: string): IDockerCompose {
+		return new DockerCompose(this.inner.withIdentity(suffix), this.dcState);
 	}
 
 	flag(name: string, value?: Token): IDockerCompose {

package/src/orchestrator/presets/nextjs.ts

@@ -6,12 +6,14 @@ import type {
 	HealthCheck,
 	HealthCheckCallback,
 	ICommand,
-	IdentityAccessor,
 	Runnable,
 	Token,
 } from "../core/types.js";
+import type { Identity } from "../utils/dna.js";
 
-export interface INextjs extends ICommand {}
+export interface INextjs extends ICommand {
+	withIdentity(suffix: string): INextjs;
+}
 
 /** @deprecated Use `INextjs` instead */
 export type NextPreset = INextjs;
@@ -26,21 +28,12 @@ class Nextjs implements INextjs {
 
 	// ─── ICommand delegation (returns INextjs for chaining) ─────────────
 
-	get identity(): IdentityAccessor {
-		const innerAccessor = this.inner.identity;
-		const self = this;
-		const setter = (suffix: string): INextjs => {
-			return new Nextjs(self.inner.identity(suffix));
-		};
-		Object.defineProperty(setter, "name", {
-			configurable: true,
-			value: innerAccessor.name,
-		});
-		return Object.assign(setter, {
-			localhostUrl: innerAccessor.localhostUrl,
-			port: innerAccessor.port,
-			url: innerAccessor.url,
-		}) as IdentityAccessor;
+	get identity(): Identity {
+		return this.inner.identity;
+	}
+
+	withIdentity(suffix: string): INextjs {
+		return new Nextjs(this.inner.withIdentity(suffix));
 	}
 
 	flag(name: string, value?: Token): INextjs {