create-relkit 0.6.0 → 0.7.1

package/dist/generate-files.d.ts

@@ -1,5 +1,34 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
 import type { CreateOptions } from "./options.js";
-export { EXAMPLE_PATH_PREFIXES, cleanupStagedProject, listProjectFiles, projectId, removeExamples, replaceOnce, requireFiles, requireTemplate, type StageCleanupResult, } from "./generate-files-utilities.js";
+export { EXAMPLE_PATH_PREFIXES, cleanupStagedProject, cleanupStagedProjectEffect, listProjectFiles, listProjectFilesEffect, projectId, removeExamples, removeExamplesEffect, replaceOnce, replaceOnceEffect, requireFiles, requireFilesEffect, requireTemplate, requireTemplateEffect, type StageCleanupResult, } from "./generate-files-utilities.js";
+/**
+ * Copies template entries in order and rejects unsupported entries before publication.
+ * @param source - Template directory copied without executing its source files.
+ * @param target - Owned staging directory receiving the copied files.
+ * @returns Completion after supported template files/directories are copied with deterministic modes.
+ */
+export declare const copyTemplateEffect: (source: string, target: string) => Effect.Effect<void, GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Applies name, application identity, deployment and example choices inside the owned stage.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after project name, ID, deployment choices and example selection are materialized.
+ */
+export declare const customizeProjectEffect: (root: string, options: CreateOptions) => Effect.Effect<void, GeneratorIoError | GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Preserves ordered template copy's Promise API.
+ * @param source - Template directory copied without executing its source files.
+ * @param target - Owned staging directory receiving the copied files.
+ * @returns Completion after the existing contract has been applied.
+ */
 export declare function copyTemplate(source: string, target: string): Promise<void>;
+/**
+ * Preserves project customization's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after the existing contract has been applied.
+ */
 export declare function customizeProject(root: string, options: CreateOptions): Promise<void>;
 //# sourceMappingURL=generate-files.d.ts.map

package/dist/generate-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-files.d.ts","sourceRoot":"","sources":["../src/generate-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,+BAA+B,CAAC;AAYvC,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1F"}
+{"version":3,"file":"generate-files.d.ts","sourceRoot":"","sources":["../src/generate-files.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,uHA2B9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,6HAiBlC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF"}

package/dist/generate-files.js

@@ -1,95 +1,66 @@
-import { access, chmod, lstat, mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
-import { basename, dirname, join, relative, resolve } from "node:path";
+import { join } from "node:path";
+import { Effect } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
 import { GenerateProjectError } from "./generate-types.js";
-export { EXAMPLE_PATH_PREFIXES, cleanupStagedProject, listProjectFiles, projectId, removeExamples, replaceOnce, requireFiles, requireTemplate, } from "./generate-files-utilities.js";
-import { EXAMPLE_PATH_PREFIXES, compareNames, listProjectFiles, projectId, removeExamples, replaceOnce, } from "./generate-files-utilities.js";
-const FILE_MODE = 0o644;
-const DIRECTORY_MODE = 0o755;
-export async function copyTemplate(source, target) {
-    await mkdir(target, { recursive: true, mode: DIRECTORY_MODE });
-    await chmod(target, DIRECTORY_MODE);
-    const entries = (await readdir(source, { withFileTypes: true })).sort(compareNames);
-    for (const entry of entries) {
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { domainError } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
+import { customizeDeploymentEffect } from "./generate-deployment.js";
+import { compareNames, projectId, removeExamplesEffect, replaceOnceEffect, } from "./generate-files-utilities.js";
+export { EXAMPLE_PATH_PREFIXES, cleanupStagedProject, cleanupStagedProjectEffect, listProjectFiles, listProjectFilesEffect, projectId, removeExamples, removeExamplesEffect, replaceOnce, replaceOnceEffect, requireFiles, requireFilesEffect, requireTemplate, requireTemplateEffect, } from "./generate-files-utilities.js";
+/**
+ * Copies template entries in order and rejects unsupported entries before publication.
+ * @param source - Template directory copied without executing its source files.
+ * @param target - Owned staging directory receiving the copied files.
+ * @returns Completion after supported template files/directories are copied with deterministic modes.
+ */
+export const copyTemplateEffect = Effect.fn("ProjectFiles.copy")(function* (source, target) {
+    const fs = yield* GeneratorFileSystem;
+    yield* fs.mkdir(target, { recursive: true, mode: 0o755 });
+    yield* fs.chmod(target, 0o755);
+    for (const entry of [...(yield* fs.entries(source))].sort(compareNames)) {
         const from = join(source, entry.name);
         const to = join(target, entry.name === "gitignore" ? ".gitignore" : entry.name);
-        if (entry.isDirectory())
-            await copyTemplate(from, to);
-        else if (entry.isFile()) {
-            await writeFile(to, await readFile(from), { mode: FILE_MODE });
-            await chmod(to, FILE_MODE);
+        if (entry.kind === "directory")
+            yield* copyTemplateEffect(from, to);
+        else if (entry.kind === "file") {
+            yield* fs.write(to, yield* fs.readBytes(from), { mode: 0o644 });
+            yield* fs.chmod(to, 0o644);
         }
         else
-            throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", "Template contains an unsupported entry.");
+            return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", "Template contains an unsupported entry.")));
     }
-}
-export async function customizeProject(root, options) {
-    await replaceOnce(join(root, "package.json"), '"name": "my-app"', `"name": ${JSON.stringify(options.name)}`);
-    await replaceOnce(join(root, "README.md"), "# my-app", `# ${options.name}`);
-    await replaceOnce(join(root, "relkit.config.ts"), "export default defineApp({", `export default defineApp({\n  id: ${JSON.stringify(projectId(options.name))},`);
-    await customizeDeployment(root, options);
+}, (effect) => observeExecution("generator", "generation.copy", effect));
+/**
+ * Applies name, application identity, deployment and example choices inside the owned stage.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after project name, ID, deployment choices and example selection are materialized.
+ */
+export const customizeProjectEffect = Effect.fn("ProjectFiles.customize")(function* (root, options) {
+    yield* replaceOnceEffect(join(root, "package.json"), '"name": "my-app"', `"name": ${JSON.stringify(options.name)}`);
+    yield* replaceOnceEffect(join(root, "README.md"), "# my-app", `# ${options.name}`);
+    yield* replaceOnceEffect(join(root, "relkit.config.ts"), "export default defineApp({", `export default defineApp({\n  id: ${JSON.stringify(projectId(options.name))},`);
+    yield* customizeDeploymentEffect(root, options);
     if (!options.examples)
-        await removeExamples(root);
-}
-async function customizeDeployment(root, options) {
-    const configPath = join(root, "relkit.config.ts");
-    const imports = [
-        ...(options.cloud === "aws" ? ['import "@relkit/aws";'] : []),
-        ...(options.deploy === "pulumi" ? ['import "@relkit/pulumi";'] : []),
-        ...(options.jobs === undefined ? [] : ['import { docker } from "@relkit/docker";']),
-        ...(options.jobs === "inngest-docker" ? ['import { inngest } from "@relkit/inngest";'] : []),
-        ...(options.jobs === "effect-mq-docker"
-            ? ['import { effectMq } from "@relkit/effect-mq";']
-            : []),
-        ...(options.jobs === "trigger-docker" ? ['import { trigger } from "@relkit/trigger";'] : []),
-    ].join("\n");
-    await replaceOnce(configPath, "// relkit:create:deployment-imports", imports);
-    await replaceOnce(configPath, "  // relkit:create:deployment", [
-        options.cloud === "aws" && options.deploy === "pulumi"
-            ? '  deployment: { engine: "pulumi", host: "aws" },'
-            : "",
-        options.jobs === "inngest-docker" ? "  jobs: { default: docker(inngest()) }," : "",
-        options.jobs === "effect-mq-docker" ? "  jobs: { default: docker(effectMq()) }," : "",
-        options.jobs === "trigger-docker" ? "  jobs: { default: docker(trigger()) }," : "",
-        options.jobs === undefined ? "" : '  defaults: { jobs: "default" },',
-    ]
-        .filter(Boolean)
-        .join("\n"));
-    await customizeTaskFixture(root, options);
-    const manifestPath = join(root, "package.json");
-    const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
-    const version = manifest.dependencies["@relkit/app"];
-    if (options.cloud === "aws")
-        manifest.dependencies["@relkit/aws"] = version;
-    if (options.deploy === "pulumi")
-        manifest.dependencies["@relkit/pulumi"] = version;
-    if (options.jobs !== undefined) {
-        manifest.dependencies["@relkit/docker"] = version;
-        manifest.dependencies["@relkit/local"] = version;
-        manifest.dependencies[`@relkit/${options.jobs.replace(/-docker$/u, "")}`] = version;
-    }
-    if (options.cloud === "aws" && options.deploy === "pulumi") {
-        manifest.scripts["deploy:preview"] = "relkit deploy preview";
-        manifest.scripts.deploy = "relkit deploy up";
-    }
-    manifest.scripts = sorted(manifest.scripts);
-    manifest.dependencies = sorted(manifest.dependencies);
-    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
-    await chmod(manifestPath, FILE_MODE);
-}
-async function customizeTaskFixture(root, options) {
-    if (options.jobs === undefined || options.jobs === "inngest-docker")
-        return;
-    const taskPath = join(root, "src/orders/tasks/export-orders.task.ts");
-    const jobPath = join(root, "src/orders/jobs/export-orders.job.ts");
-    if (options.jobs === "effect-mq-docker")
-        await replaceOnce(taskPath, 'execution: "durable"', 'execution: "retryable"');
-    await replaceOnce(taskPath, "  progress: z.object({ completed: z.number().int().nonnegative() }),\n", "");
-    await replaceOnce(taskPath, "    await context.progress.emit({ completed: 0 });\n", "");
-    await replaceOnce(taskPath, "    await context.progress.emit({ completed: orderIds.length });\n", "");
-    await replaceOnce(jobPath, '    operations: ["trigger", "get", "list", "watch"],', '    operations: ["trigger"],');
-    await replaceOnce(jobPath, '    fields: ["status", "progress", "output"],', '    fields: ["status", "output"],');
+        yield* removeExamplesEffect(root);
+}, (effect) => observeExecution("generator", "generation.customize", effect));
+/**
+ * Preserves ordered template copy's Promise API.
+ * @param source - Template directory copied without executing its source files.
+ * @param target - Owned staging directory receiving the copied files.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function copyTemplate(source, target) {
+    return runGeneratorPromise(copyTemplateEffect(source, target));
 }
-function sorted(values) {
-    return Object.fromEntries(Object.entries(values).sort(([left], [right]) => left.localeCompare(right)));
+/**
+ * Preserves project customization's Promise API.
+ * @param root - Absolute project or owned resource root.
+ * @param options - Explicit options retaining existing defaults.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function customizeProject(root, options) {
+    return runGeneratorPromise(customizeProjectEffect(root, options));
 }
 //# sourceMappingURL=generate-files.js.map

package/dist/generate-files.js.map

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

package/dist/generate-output.d.ts

@@ -1,21 +1,18 @@
 import type { CreateOptions } from "./options.js";
-export interface GenerateNextSteps {
-    readonly commands: Readonly<{
-        readonly cd: string;
-        readonly install?: "bun install";
-        readonly dev: "bun run dev";
-        readonly test: "bun run test";
-        readonly check: "bun run check";
-        readonly build: "bun run build";
-    }>;
-    readonly endpoints: Readonly<{
-        readonly backend: "http://localhost:3000";
-        readonly inspector: "http://localhost:3210";
-        readonly openapi: "http://localhost:3000/_relkit/v1/openapi.json";
-        readonly apiReference: "http://localhost:3000/_relkit/v1/api-reference";
-        readonly route?: "GET http://localhost:3000/hello?name=RelKit";
-    }>;
-}
+/**
+ * Builds local commands and endpoints for a generated project.
+ * @param options - Installation and examples flags.
+ * @param destination - Generated project's absolute destination path.
+ * @param cwd - Working directory for the operation.
+ * @returns Frozen commands and endpoints reflecting installation and example choices.
+ */
 export declare function createGenerateNextSteps(options: Pick<CreateOptions, "examples" | "install">, destination: string, cwd?: string): GenerateNextSteps;
+/**
+ * Formats a recognizable generation result for terminal display.
+ * @param value - Generation result or an unrecognized output value.
+ * @returns Success details, commands, endpoints and warnings; other values use JSON serialization.
+ */
 export declare function formatGenerateResult(value: unknown): string;
+import type { GenerateNextSteps } from "./generate-output.types.js";
+export type { GenerateNextSteps } from "./generate-output.types.js";
 //# sourceMappingURL=generate-output.d.ts.map

package/dist/generate-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-output.d.ts","sourceRoot":"","sources":["../src/generate-output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;QAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;KACjC,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;QAC1C,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;QAC5C,QAAQ,CAAC,OAAO,EAAE,+CAA+C,CAAC;QAClE,QAAQ,CAAC,YAAY,EAAE,gDAAgD,CAAC;QACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,6CAA6C,CAAC;KAChE,CAAC,CAAC;CACJ;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,SAAS,CAAC,EACpD,WAAW,EAAE,MAAM,EACnB,GAAG,SAAgB,GAClB,iBAAiB,CAkBnB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6B3D"}
+{"version":3,"file":"generate-output.d.ts","sourceRoot":"","sources":["../src/generate-output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,SAAS,CAAC,EACpD,WAAW,EAAE,MAAM,EACnB,GAAG,SAAgB,GAClB,iBAAiB,CAkBnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6B3D;AA8CD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/generate-output.js

@@ -1,4 +1,11 @@
 import { basename, relative, resolve } from "node:path";
+/**
+ * Builds local commands and endpoints for a generated project.
+ * @param options - Installation and examples flags.
+ * @param destination - Generated project's absolute destination path.
+ * @param cwd - Working directory for the operation.
+ * @returns Frozen commands and endpoints reflecting installation and example choices.
+ */
 export function createGenerateNextSteps(options, destination, cwd = process.cwd()) {
     const directory = relative(resolve(cwd), resolve(destination)) || basename(destination);
     const commands = Object.freeze({
@@ -18,6 +25,11 @@ export function createGenerateNextSteps(options, destination, cwd = process.cwd(
     });
     return Object.freeze({ commands, endpoints });
 }
+/**
+ * Formats a recognizable generation result for terminal display.
+ * @param value - Generation result or an unrecognized output value.
+ * @returns Success details, commands, endpoints and warnings; other values use JSON serialization.
+ */
 export function formatGenerateResult(value) {
     if (!isRecord(value) || !isNextSteps(value.nextSteps))
         return JSON.stringify(value);
@@ -47,11 +59,21 @@ export function formatGenerateResult(value) {
         commands.build,
     ].join("\n");
 }
+/**
+ * Quotes a generated directory as one safe shell argument.
+ * @param value - Directory path placed in the displayed cd command.
+ * @returns The literal safe word or a single-quoted word with escaped apostrophes.
+ */
 function shellWord(value) {
     if (/^[A-Za-z0-9_./@-]+$/.test(value))
         return value.startsWith("-") ? `./${value}` : value;
     return `'${value.replaceAll("'", "'\\''")}'`;
 }
+/**
+ * Checks that an unknown result contains the supported commands and endpoints.
+ * @param value - Unknown nextSteps field.
+ * @returns Whether the value matches the generated next-steps contract.
+ */
 function isNextSteps(value) {
     if (!isRecord(value) || !isRecord(value.commands) || !isRecord(value.endpoints))
         return false;
@@ -70,6 +92,11 @@ function isNextSteps(value) {
         (endpoints.route === undefined ||
             endpoints.route === "GET http://localhost:3000/hello?name=RelKit"));
 }
+/**
+ * Narrows an unknown value to a non-null object excluding arrays.
+ * @param value - Unknown value at the object boundary.
+ * @returns Whether the value is a non-null, non-array object.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/generate-output.js.map

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

package/dist/generate-output.types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Local commands and endpoints displayed after successful project creation.
+ */
+export interface GenerateNextSteps {
+    readonly commands: Readonly<{
+        readonly cd: string;
+        readonly install?: "bun install";
+        readonly dev: "bun run dev";
+        readonly test: "bun run test";
+        readonly check: "bun run check";
+        readonly build: "bun run build";
+    }>;
+    readonly endpoints: Readonly<{
+        readonly backend: "http://localhost:3000";
+        readonly inspector: "http://localhost:3210";
+        readonly openapi: "http://localhost:3000/_relkit/v1/openapi.json";
+        readonly apiReference: "http://localhost:3000/_relkit/v1/api-reference";
+        readonly route?: "GET http://localhost:3000/hello?name=RelKit";
+    }>;
+}
+//# sourceMappingURL=generate-output.types.d.ts.map

package/dist/generate-output.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-output.types.d.ts","sourceRoot":"","sources":["../src/generate-output.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;QAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;KACjC,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;QAC1C,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;QAC5C,QAAQ,CAAC,OAAO,EAAE,+CAA+C,CAAC;QAClE,QAAQ,CAAC,YAAY,EAAE,gDAAgD,CAAC;QACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,6CAA6C,CAAC;KAChE,CAAC,CAAC;CACJ"}

package/dist/generate-output.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate-output.types.js.map

package/dist/generate-output.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-output.types.js","sourceRoot":"","sources":["../src/generate-output.types.ts"],"names":[],"mappings":""}

package/dist/generate-process.d.ts

@@ -1,9 +1,69 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorProcess } from "./generator-process.js";
 import { GenerateProjectError, type GenerateCommandResult, type GenerateFailurePoint, type GenerateProjectContext } from "./generate-types.js";
 import type { StageCleanupResult } from "./generate-files.js";
+/**
+ * Maps a boundary failure to the public generation error contract.
+ * @param error - Original public or internal failure.
+ * @param fallback - Code used when the original failure has no public code.
+ * @param cleanup - Optional staging path and cleanup outcome.
+ * @returns The preserved or translated failure with optional staging disposition.
+ */
 export declare function generationError(error: unknown, fallback: string, cleanup?: StageCleanupResult): GenerateProjectError;
+/**
+ * Runs deterministic failure injection for generation regression tests.
+ * @param context - Caller-owned settings and cancellation.
+ * @param point - Fixed deterministic generation failure-injection point.
+ * @returns Completion when the hook succeeds; injected failures retain the generation error contract.
+ */
 export declare function injectGenerateFailure(context: GenerateProjectContext, point: GenerateFailurePoint): void;
+/**
+ * Executes one generation step through scoped process authority.
+ * @param context - Existing progress, failure injection and executable settings.
+ * @param command - Literal command vector.
+ * @param cwd - Staged project directory.
+ * @param step - Fixed operation label used by the public failure code.
+ * @param point - Fixed deterministic generation failure-injection point.
+ * @returns Completion only after process output and exit have settled.
+ */
+export declare const runProjectStepEffect: (context: GenerateProjectContext, command: readonly string[], cwd: string, step: string, point: GenerateFailurePoint) => Effect.Effect<undefined, import("./generator-errors.js").GeneratorProcessError | import("./generator-errors.js").GeneratorDomainError, GeneratorProcess>;
+/**
+ * Preserves generation step's public Promise adapter.
+ * @param context - Caller-owned settings and cancellation.
+ * @param command - Literal executable and argument vector.
+ * @param cwd - Working directory for the operation.
+ * @param step - Fixed generated-project verification step.
+ * @param point - Fixed deterministic generation failure-injection point.
+ * @returns Completion after the existing contract has been applied.
+ */
 export declare function runProjectStep(context: GenerateProjectContext, command: readonly string[], cwd: string, step: string, point: GenerateFailurePoint): Promise<void>;
+/**
+ * Throws the caller's existing cancellation reason before any new work is started.
+ * @param signal - Optional caller cancellation signal.
+ * @returns Completion after the existing contract has been applied.
+ */
 export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+/**
+ * Resolves the supported CLI using filesystem and process authority without importing it.
+ * @param context - Caller-owned settings and cancellation.
+ * @param root - Absolute project or owned resource root.
+ * @returns The explicit, local or globally available relkit executable for project checks.
+ */
+export declare const resolveRelkitExecutableEffect: (context: Pick<GenerateProjectContext, "relkitExecutable" | "commandRunner">, root: string) => Effect.Effect<string, import("./generator-errors.js").GeneratorProcessError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem | GeneratorProcess>;
+/**
+ * Preserves the CLI executable Promise API.
+ * @param context - Caller-owned settings and cancellation.
+ * @param root - Absolute project or owned resource root.
+ * @returns The resolved CLI executable path after validating the supplied or available binary.
+ */
 export declare function resolveRelkitExecutable(context: GenerateProjectContext, root: string): Promise<string>;
+/**
+ * Runs a native child at the compatibility edge, with interruption owned by its resource scope.
+ * @param command - Executable and literal arguments.
+ * @param cwd - Working directory.
+ * @param signal - Optional caller cancellation.
+ * @returns Output and exit status after the child has been awaited.
+ */
 export declare function runProjectCommand(command: readonly string[], cwd: string, signal?: AbortSignal): Promise<GenerateCommandResult>;
 //# sourceMappingURL=generate-process.d.ts.map

package/dist/generate-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-process.d.ts","sourceRoot":"","sources":["../src/generate-process.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,oBAAoB,CA0BtB;AAOD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,oBAAoB,GAC1B,IAAI,CAUN;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAKpE;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAchC"}
+{"version":3,"file":"generate-process.d.ts","sourceRoot":"","sources":["../src/generate-process.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAKjF,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,oBAAoB,CAsBtB;AAYD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,oBAAoB,GAC1B,IAAI,CAUN;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,mRA2BhC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAKpE;AAED;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,4QA2BzC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAKhC"}