@relkit/cli 0.0.0

package/dist/commands/doctor-compat.js

@@ -0,0 +1,97 @@
+import { readFile } from "node:fs/promises";
+import { isDescriptor } from "@relkit/contracts";
+export async function readJson(path) {
+    try {
+        const value = JSON.parse(await readFile(path, "utf8"));
+        return isRecord(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function versionChecks(manifest, root) {
+    if (manifest === undefined)
+        return [{ name: "packages", ok: false, message: "package.json was not found." }];
+    const expectedBun = packageManagerVersion(manifest);
+    const bunOk = expectedBun === undefined || satisfies(Bun.version, expectedBun);
+    const expectedTypeScript = dependency(manifest, "typescript") ?? "5.9.2";
+    let actualTypeScript;
+    try {
+        const path = Bun.resolveSync("typescript/package.json", root);
+        actualTypeScript = JSON.parse(await readFile(path, "utf8")).version;
+    }
+    catch { }
+    const typeScriptOk = actualTypeScript !== undefined && satisfies(actualTypeScript, expectedTypeScript);
+    const relkit = relkitVersions(manifest);
+    return [
+        {
+            name: "bun",
+            ok: bunOk,
+            message: bunOk
+                ? `Bun ${Bun.version} is compatible.`
+                : `Bun ${Bun.version} does not satisfy ${expectedBun}.`,
+        },
+        {
+            name: "typescript",
+            ok: typeScriptOk,
+            message: typeScriptOk
+                ? `TypeScript ${actualTypeScript} is compatible.`
+                : "A compatible TypeScript installation was not found.",
+        },
+        { name: "relkit-packages", ok: relkit.ok, message: relkit.message, details: relkit.details },
+    ];
+}
+function packageManagerVersion(manifest) {
+    const value = typeof manifest.packageManager === "string" ? manifest.packageManager : "";
+    return /^bun@(.+)$/.exec(value)?.[1] ?? manifest.engines?.bun;
+}
+function dependency(manifest, name) {
+    return (manifest.dependencies?.[name] ??
+        manifest.devDependencies?.[name] ??
+        manifest.optionalDependencies?.[name]);
+}
+function relkitVersions(manifest) {
+    const entries = Object.entries({
+        ...manifest.dependencies,
+        ...manifest.devDependencies,
+        ...manifest.optionalDependencies,
+    }).filter(([name]) => name.startsWith("@relkit/"));
+    const versions = [
+        ...new Set(entries
+            .map(([, version]) => String(version))
+            .filter((version) => !["workspace:*", "*"].includes(version) && !version.startsWith("link:"))),
+    ];
+    return {
+        ok: versions.length <= 1,
+        message: versions.length <= 1
+            ? "RelKit package versions are compatible."
+            : "RelKit package versions do not match.",
+        details: { packages: entries.map(([name]) => name), versions },
+    };
+}
+export function detectDeployment(manifest, config) {
+    const dependencies = Object.entries({
+        ...manifest?.dependencies,
+        ...manifest?.devDependencies,
+    });
+    return (dependencies.some(([name, value]) => name.includes("pulumi") || String(value).includes("pulumi")) ||
+        (isRecord(config) && config.deployment !== undefined));
+}
+export function isAppDescriptor(value) {
+    if (!isRecord(value) || !isDescriptor(value, "app"))
+        return false;
+    const env = Reflect.get(value, "env");
+    return isRecord(env) && env.kind === "env-definition";
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function satisfies(version, range) {
+    try {
+        return Bun.semver.satisfies(version, range);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=doctor-compat.js.map

package/dist/commands/doctor-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-compat.js","sourceRoot":"","sources":["../../src/commands/doctor-compat.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor-support.d.ts

@@ -0,0 +1,36 @@
+export interface DoctorCheck {
+    readonly name: string;
+    readonly ok: boolean;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export interface DoctorResult {
+    readonly ok: boolean;
+    readonly command: "doctor";
+    readonly projectRoot: string;
+    readonly checks: readonly DoctorCheck[];
+}
+export interface DoctorOptions {
+    readonly projectRoot?: string;
+    readonly source?: Readonly<Record<string, string | undefined>>;
+    readonly backendPort?: number;
+    readonly inspectorPort?: number;
+    readonly deploymentEnabled?: boolean;
+    readonly commandRunner?: DoctorCommandRunner;
+    readonly portProbe?: (port: number) => Promise<boolean>;
+}
+export type DoctorCommandRunner = (command: readonly string[], cwd: string) => Promise<{
+    readonly exitCode: number;
+}>;
+export declare class DoctorCommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+type ParsedDoctorArgs = Pick<DoctorOptions, "projectRoot" | "backendPort" | "inspectorPort"> & {
+    readonly deploymentEnabled?: boolean;
+};
+export declare function doctorProject(options?: DoctorOptions): Promise<DoctorResult>;
+export declare function parseDoctorArgs(args: readonly string[]): ParsedDoctorArgs;
+export declare function formatDoctor(result: DoctorResult): string;
+export {};
+//# sourceMappingURL=doctor-support.d.ts.map

package/dist/commands/doctor-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-support.d.ts","sourceRoot":"","sources":["../../src/commands/doctor-support.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AACD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AACD,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,KACR,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5C,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,KAAK,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC,GAAG;IAC7F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBtF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAsBzE;AAoED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAKzD"}

package/dist/commands/doctor-support.js

@@ -0,0 +1,123 @@
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { ConfigValidationError, loadConfig } from "@relkit/compiler";
+import { checkAws, checkLockfile, checkPorts, checkPulumi, checkRoots, availablePort, } from "./doctor-checks.js";
+import { detectDeployment, isAppDescriptor, readJson, versionChecks } from "./doctor-compat.js";
+export class DoctorCommandError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "DoctorCommandError";
+        this.code = code;
+    }
+}
+export async function doctorProject(options = {}) {
+    const root = resolve(options.projectRoot ?? process.cwd());
+    const checks = [];
+    const manifest = await readJson(join(root, "package.json"));
+    checks.push(...(await versionChecks(manifest, root)));
+    const config = await checkConfig(root, checks);
+    const app = await checkApp(root, config, checks);
+    const enabled = options.deploymentEnabled ?? detectDeployment(manifest, config);
+    checks.push(await checkPulumi(enabled, root, options.commandRunner));
+    checks.push(checkAws(enabled, options.source ?? process.env));
+    checks.push(await checkRoots(root));
+    checks.push(await checkPorts(config, options, options.portProbe ?? availablePort));
+    checks.push(await checkLockfile(root, options.commandRunner));
+    return Object.freeze({
+        ok: checks.every((check) => check.ok),
+        command: "doctor",
+        projectRoot: root,
+        checks: Object.freeze(checks.map((check) => Object.freeze(check))),
+    });
+}
+export function parseDoctorArgs(args) {
+    let projectRoot;
+    let backendPort;
+    let inspectorPort;
+    let deploymentEnabled;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--project-root")
+            projectRoot = requiredValue(args, ++index, arg);
+        else if (arg === "--port")
+            backendPort = parsePort(requiredValue(args, ++index, arg), arg, true);
+        else if (arg === "--inspector-port")
+            inspectorPort = parsePort(requiredValue(args, ++index, arg), arg, false);
+        else if (arg === "--pulumi")
+            deploymentEnabled = true;
+        else if (arg === "--no-pulumi")
+            deploymentEnabled = false;
+        else
+            throw new DoctorCommandError("RELKIT_DOCTOR_USAGE", `Unknown doctor option: ${arg}`);
+    }
+    return {
+        ...(projectRoot === undefined ? {} : { projectRoot }),
+        ...(backendPort === undefined ? {} : { backendPort }),
+        ...(inspectorPort === undefined ? {} : { inspectorPort }),
+        ...(deploymentEnabled === undefined ? {} : { deploymentEnabled }),
+    };
+}
+async function checkConfig(root, checks) {
+    try {
+        const loaded = await import(`${pathToFileURL(join(root, "relkit.config.ts")).href}?relkit_doctor=1`);
+        const config = loadConfig(loaded.default ?? loaded, root);
+        checks.push({ name: "config", ok: true, message: "relkit.config.ts is valid." });
+        return config;
+    }
+    catch (error) {
+        const detail = error instanceof ConfigValidationError
+            ? error.issues.map((issue) => `${issue.path}:${issue.code}`).join(", ")
+            : "file is missing or could not be loaded";
+        checks.push({ name: "config", ok: false, message: `Invalid relkit.config.ts (${detail}).` });
+        return undefined;
+    }
+}
+async function checkApp(root, config, checks) {
+    if (config === undefined) {
+        checks.push({
+            name: "app",
+            ok: false,
+            message: "App cannot be checked because config is invalid.",
+        });
+        return undefined;
+    }
+    try {
+        const file = "relkit.config.ts";
+        const loaded = await import(`${pathToFileURL(resolve(root, file)).href}?relkit_doctor_app=1`);
+        const app = loaded.default;
+        const ok = isAppDescriptor(app);
+        checks.push({
+            name: "app",
+            ok,
+            message: ok ? `${file} defines the application.` : `${file} is not a valid app config.`,
+        });
+        return app;
+    }
+    catch {
+        checks.push({ name: "app", ok: false, message: "relkit.config.ts could not be loaded." });
+        return undefined;
+    }
+}
+function validPort(value, dynamic) {
+    return Number.isInteger(value) && value >= (dynamic ? 0 : 1) && value <= 65535;
+}
+function parsePort(value, option, dynamic) {
+    const port = Number(value);
+    if (!validPort(port, dynamic))
+        throw new DoctorCommandError("RELKIT_DOCTOR_USAGE", `${option} must be a valid port.`);
+    return port;
+}
+function requiredValue(args, index, option) {
+    const value = args[index];
+    if (value === undefined || value.startsWith("-"))
+        throw new DoctorCommandError("RELKIT_DOCTOR_USAGE", `${option} requires a value.`);
+    return value;
+}
+export function formatDoctor(result) {
+    return [
+        ...result.checks.map((check) => `${check.ok ? "✓" : "✗"} ${check.name}: ${check.message}`),
+        result.ok ? "Doctor passed." : "Doctor found prerequisite failures.",
+    ].join("\n");
+}
+//# sourceMappingURL=doctor-support.js.map

package/dist/commands/doctor-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-support.js","sourceRoot":"","sources":["../../src/commands/doctor-support.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,6 @@
+import { type CliCommandContext } from "../main-support.js";
+import { type DoctorOptions } from "./doctor-support.js";
+export * from "./doctor-support.js";
+/** Runs prerequisite checks through the shared CLI reporter. */
+export declare function runDoctor(args: readonly string[], context: Pick<CliCommandContext, "json" | "reporter">, options?: DoctorOptions): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,cAAc,qBAAqB,CAAC;AAEpC,gEAAgE;AAChE,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,UAAU,CAAC,EACrD,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/commands/doctor.js

@@ -0,0 +1,18 @@
+import { CLI_EXIT_CODES } from "../main-support.js";
+import { DoctorCommandError, doctorProject, formatDoctor, parseDoctorArgs, } from "./doctor-support.js";
+export * from "./doctor-support.js";
+/** Runs prerequisite checks through the shared CLI reporter. */
+export async function runDoctor(args, context, options = {}) {
+    try {
+        const parsed = parseDoctorArgs(args);
+        const result = await doctorProject({ ...options, ...parsed });
+        context.reporter.output(result, formatDoctor(result));
+        return result.ok ? CLI_EXIT_CODES.success : CLI_EXIT_CODES.failure;
+    }
+    catch (error) {
+        const code = error instanceof DoctorCommandError ? error.code : "RELKIT_DOCTOR_FAILED";
+        context.reporter.error(code, error instanceof Error ? error.message : String(error));
+        return code === "RELKIT_DOCTOR_USAGE" ? CLI_EXIT_CODES.usage : CLI_EXIT_CODES.failure;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAE7B,cAAc,qBAAqB,CAAC;AAEpC,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAuB,EACvB,OAAqD,EACrD,UAAyB,EAAE;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,KAAK,YAAY,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC;QACvF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrF,OAAO,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/commands/env-format.d.ts

@@ -0,0 +1,46 @@
+import type { EnvIssue, EnvMetadata, EnvProjection } from "@relkit/config";
+export declare class EnvCommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export type EnvStatus = "set" | "default" | "optional" | "missing" | "invalid";
+export type ParsedEnvArgs = {
+    readonly command: "check" | "example" | "explain" | "list";
+    readonly name?: string;
+    readonly environment?: string;
+    readonly projectRoot?: string;
+    readonly examplePath?: string;
+    readonly write: boolean;
+};
+export type EnvCommandOptions = {
+    readonly projectRoot?: string;
+    readonly definition?: import("@relkit/config").EnvDefinition<import("@relkit/config").EnvShape>;
+    readonly source?: import("@relkit/config").EnvSource;
+    readonly environment?: string;
+    readonly envPath?: string;
+    readonly examplePath?: string;
+};
+export type SafeEnvIssue = Pick<EnvIssue, "name" | "code" | "sensitive"> & {
+    readonly message: string;
+};
+export declare function parseEnvArgs(args: readonly string[]): ParsedEnvArgs;
+export declare function exampleValue(field: EnvProjection): string;
+export declare function isRequired(field: Pick<EnvMetadata, "requiredIn" | "optional">, environment: string): boolean;
+export declare function formatCheck(result: {
+    readonly ok: boolean;
+    readonly environment: string;
+    readonly items: readonly {
+        readonly name: string;
+        readonly status: EnvStatus;
+    }[];
+}): string;
+export declare function formatExplain(result: {
+    readonly name: string;
+    readonly type: string;
+    readonly requiredIn: readonly string[];
+    readonly required: boolean;
+    readonly hasDefault: boolean;
+    readonly sensitive: boolean;
+    readonly description?: string;
+}): string;
+//# sourceMappingURL=env-format.d.ts.map

package/dist/commands/env-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-format.d.ts","sourceRoot":"","sources":["../../src/commands/env-format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAEzF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,gBAAgB,EAAE,aAAa,CAAC,OAAO,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,gBAAgB,EAAE,SAAS,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,GAAG;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA0CnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAezD;AAYD,wBAAgB,UAAU,CACxB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC,EACnD,WAAW,EAAE,MAAM,GAClB,OAAO,CAET;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CAClF,GAAG,MAAM,CAMT;AACD,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,MAAM,CAUT"}

package/dist/commands/env-format.js

@@ -0,0 +1,102 @@
+import { canonicalJson } from "@relkit/contracts";
+export class EnvCommandError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "EnvCommandError";
+        this.code = code;
+    }
+}
+export function parseEnvArgs(args) {
+    const command = args[0];
+    if (command !== "check" && command !== "example" && command !== "explain" && command !== "list")
+        throw new EnvCommandError("RELKIT_ENV_USAGE", "Usage: relkit env check|example|explain <NAME>|list [options]");
+    let name;
+    let environment;
+    let projectRoot;
+    let examplePath;
+    let write = false;
+    for (let index = 1; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--write")
+            write = true;
+        else if (arg === "--environment" || arg === "--env")
+            environment = requiredValue(args, ++index, arg);
+        else if (arg === "--project-root")
+            projectRoot = requiredValue(args, ++index, arg);
+        else if (arg === "--path" || arg === "--file")
+            examplePath = requiredValue(args, ++index, arg);
+        else if (arg.startsWith("-"))
+            throw new EnvCommandError("RELKIT_ENV_USAGE", `Unknown env option: ${arg}`);
+        else if (name === undefined)
+            name = arg;
+        else
+            throw new EnvCommandError("RELKIT_ENV_USAGE", "Only one environment variable name is allowed.");
+    }
+    if (command === "explain" && name === undefined)
+        throw new EnvCommandError("RELKIT_ENV_USAGE", "env explain requires a variable name.");
+    if (command !== "example" && write)
+        throw new EnvCommandError("RELKIT_ENV_USAGE", "--write is only valid for env example.");
+    if (command !== "example" && examplePath !== undefined)
+        throw new EnvCommandError("RELKIT_ENV_USAGE", "--path is only valid for env example.");
+    return {
+        command,
+        ...(name === undefined ? {} : { name }),
+        ...(environment === undefined ? {} : { environment }),
+        ...(projectRoot === undefined ? {} : { projectRoot }),
+        ...(examplePath === undefined ? {} : { examplePath }),
+        write,
+    };
+}
+export function exampleValue(field) {
+    if (field.sensitive)
+        return "[redacted]";
+    if (field.example !== undefined)
+        return envValue(field.example);
+    if (field.type === "literal" && field.values?.[0] !== undefined)
+        return envValue(field.values[0]);
+    const placeholders = {
+        string: "example",
+        number: "0",
+        boolean: "false",
+        port: "3000",
+        literal: "",
+        url: "https://example.invalid",
+        json: "{}",
+        "secret-string": "[redacted]",
+    };
+    return placeholders[field.type];
+}
+function envValue(value) {
+    if (typeof value === "string")
+        return /[\s#"'\\\r\n]/.test(value) ? JSON.stringify(value) : value;
+    return canonicalJson(value);
+}
+function requiredValue(args, index, option) {
+    const value = args[index];
+    if (value === undefined || value.startsWith("-"))
+        throw new EnvCommandError("RELKIT_ENV_USAGE", `${option} requires a value.`);
+    return value;
+}
+export function isRequired(field, environment) {
+    return field.requiredIn.length > 0 ? field.requiredIn.includes(environment) : !field.optional;
+}
+export function formatCheck(result) {
+    return [
+        `Environment: ${result.environment}`,
+        ...result.items.map((item) => `${item.name}: ${item.status}`),
+        result.ok ? "Environment is valid." : "Environment is invalid.",
+    ].join("\n");
+}
+export function formatExplain(result) {
+    return [
+        result.name,
+        `type: ${result.type}`,
+        `required: ${result.required ? "yes" : "no"}`,
+        `requiredIn: ${result.requiredIn.join(", ") || "none"}`,
+        `default: ${result.hasDefault ? "yes" : "no"}`,
+        `sensitive: ${result.sensitive ? "yes" : "no"}`,
+        ...(result.description === undefined ? [] : [`description: ${result.description}`]),
+    ].join("\n");
+}
+//# sourceMappingURL=env-format.js.map

package/dist/commands/env-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-format.js","sourceRoot":"","sources":["../../src/commands/env-format.ts"],"names":[],"mappings":"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"}

package/dist/commands/env-support.d.ts

@@ -0,0 +1,22 @@
+import { type EnvDefinition, type EnvProjection, type EnvShape, type EnvSource } from "@relkit/config";
+import { type EnvCommandOptions, type EnvStatus, type SafeEnvIssue } from "./env-format.js";
+export { EnvCommandError, formatCheck, formatExplain, isRequired, parseEnvArgs, } from "./env-format.js";
+export type { EnvCommandOptions, EnvStatus, ParsedEnvArgs, SafeEnvIssue } from "./env-format.js";
+export declare function loadEnvDefinition(options: Pick<EnvCommandOptions, "definition" | "projectRoot" | "envPath">): Promise<EnvDefinition<EnvShape>>;
+export declare function createExample(fields: readonly EnvProjection[], options: Pick<EnvCommandOptions, "projectRoot" | "examplePath">, write: boolean): Promise<{
+    ok: true;
+    command: "example";
+    path: string;
+    existing: boolean;
+    written: boolean;
+    content: string;
+}>;
+export declare function resolveStatus(definition: EnvDefinition<EnvShape>, fields: readonly EnvProjection[], environment: string, source: EnvSource): {
+    ok: boolean;
+    items: {
+        name: string;
+        status: EnvStatus;
+    }[];
+    issues: readonly SafeEnvIssue[];
+};
+//# sourceMappingURL=env-support.d.ts.map

package/dist/commands/env-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-support.d.ts","sourceRoot":"","sources":["../../src/commands/env-support.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAOL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjG,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC,GACzE,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAgClC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,aAAa,CAAC,EAC/D,KAAK,EAAE,OAAO;;;;;;;GA0Bf;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,EACnC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS;;;;;;;EAiClB"}

package/dist/commands/env-support.js

@@ -0,0 +1,102 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { EnvResolutionError, resolveEnv, } from "@relkit/config";
+import { exampleValue, EnvCommandError, formatCheck, formatExplain, isRequired, parseEnvArgs, } from "./env-format.js";
+export { EnvCommandError, formatCheck, formatExplain, isRequired, parseEnvArgs, } from "./env-format.js";
+export async function loadEnvDefinition(options) {
+    if (options.definition !== undefined)
+        return options.definition;
+    const root = resolve(options.projectRoot ?? process.cwd());
+    const path = resolve(root, options.envPath ?? join("src", "env.ts"));
+    if (!inside(root, path))
+        throw new EnvCommandError("RELKIT_ENV_USAGE", "Environment path must remain inside the project root.");
+    let loaded;
+    try {
+        loaded = await import(`${pathToFileURL(path).href}?relkit_env=1`);
+    }
+    catch {
+        throw new EnvCommandError("RELKIT_ENV_NOT_FOUND", `Environment contract was not found at ${relative(root, path)}.`);
+    }
+    const module = loaded;
+    const value = module.default ?? module.env ?? loaded;
+    const definition = isRecord(value) && value.kind === "env-definition"
+        ? value
+        : isRecord(value)
+            ? value.env
+            : undefined;
+    if (!isRecord(definition) || definition.kind !== "env-definition")
+        throw new EnvCommandError("RELKIT_ENV_INVALID", "The environment module does not export an environment definition.");
+    return definition;
+}
+export async function createExample(fields, options, write) {
+    const content = `${fields.map((field) => `${field.name}=${exampleValue(field)}`).join("\n")}\n`;
+    const root = resolve(options.projectRoot ?? process.cwd());
+    const path = resolve(root, options.examplePath ?? ".env.example");
+    if (!inside(root, path))
+        throw new EnvCommandError("RELKIT_ENV_USAGE", "Example path must remain inside the project root.");
+    let existing = false;
+    try {
+        await readFile(path);
+        existing = true;
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    if (write)
+        await writeFile(path, content, "utf8");
+    return {
+        ok: true,
+        command: "example",
+        path,
+        existing,
+        written: write,
+        content,
+    };
+}
+export function resolveStatus(definition, fields, environment, source) {
+    const issues = (() => {
+        try {
+            resolveEnv(definition, { environment, source });
+            return [];
+        }
+        catch (error) {
+            if (!(error instanceof EnvResolutionError))
+                throw error;
+            return error.issues.map(({ name, code, sensitive }) => ({
+                name,
+                code,
+                sensitive,
+                message: code === "missing" ? "Required value is missing" : "Value is invalid",
+            }));
+        }
+    })();
+    const issueByName = new Map(issues.map((issue) => [issue.name, issue]));
+    const items = fields.map((field) => {
+        const issue = issueByName.get(field.name);
+        const supplied = Object.hasOwn(source, field.name) && source[field.name] !== undefined;
+        const status = issue?.code === "invalid"
+            ? "invalid"
+            : issue?.code === "missing"
+                ? "missing"
+                : supplied
+                    ? "set"
+                    : field.hasDefault
+                        ? "default"
+                        : "optional";
+        return { name: field.name, status };
+    });
+    return { ok: issues.length === 0, items, issues };
+}
+function inside(root, path) {
+    const pathFromRoot = relative(root, path);
+    return pathFromRoot === "" || (!pathFromRoot.startsWith("..") && !isAbsolute(pathFromRoot));
+}
+function isNotFound(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=env-support.js.map

package/dist/commands/env-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-support.js","sourceRoot":"","sources":["../../src/commands/env-support.ts"],"names":[],"mappings":"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"}

package/dist/commands/env.d.ts

@@ -0,0 +1,7 @@
+import { createExample, EnvCommandError, formatCheck, formatExplain, loadEnvDefinition, parseEnvArgs, resolveStatus, isRequired, type EnvCommandOptions } from "./env-support.js";
+import { type CliCommandContext } from "../main-support.js";
+export { createExample, EnvCommandError, formatCheck, formatExplain, loadEnvDefinition, parseEnvArgs, resolveStatus, isRequired, };
+export type { EnvCommandOptions } from "./env-support.js";
+/** Runs the secret-safe environment command family through the shared reporter. */
+export declare function runEnv(args: readonly string[], context: Pick<CliCommandContext, "json" | "reporter">, options?: EnvCommandOptions): Promise<number>;
+//# sourceMappingURL=env.d.ts.map

package/dist/commands/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,UAAU,GACX,CAAC;AACF,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,mFAAmF;AACnF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,UAAU,CAAC,EACrD,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAwEjB"}