create-relkit 0.4.0 → 0.5.0

package/dist/create-preview.js

@@ -0,0 +1,50 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { EXAMPLE_PATH_PREFIXES, listProjectFiles } from "./generate-files.js";
+import { readAppDiscovery } from "./project-discovery-app.js";
+import { validateCreateOptions } from "./validate.js";
+import { resolveTemplateRoot } from "./template-root.js";
+export async function planCreate(options, context = {}) {
+    const validated = validateCreateOptions(options, context.cwd === undefined ? {} : { cwd: context.cwd });
+    const root = join(resolveTemplateRoot(context), options.jobs === undefined ? options.template : "tasks");
+    const manifest = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+    const dependencies = { ...manifest.dependencies, ...manifest.devDependencies };
+    const version = dependencies["@relkit/app"] ?? "0.4.0";
+    if (options.cloud === "aws")
+        dependencies["@relkit/aws"] = version;
+    if (options.deploy === "pulumi")
+        dependencies["@relkit/pulumi"] = version;
+    if (options.jobs !== undefined) {
+        dependencies["@relkit/docker"] = version;
+        dependencies[`@relkit/${options.jobs.replace(/-docker$/u, "")}`] = version;
+    }
+    const configPath = join(root, "relkit.config.ts");
+    const app = readAppDiscovery(await readFile(configPath, "utf8"), configPath, root);
+    const files = (await listProjectFiles(root))
+        .map((path) => (path === "gitignore" ? ".gitignore" : path))
+        .filter((path) => options.examples ||
+        !EXAMPLE_PATH_PREFIXES.some((prefix) => path === prefix || path.startsWith(`${prefix}/`)));
+    return Object.freeze({
+        destination: validated.destination,
+        files: Object.freeze(files),
+        dependencies: Object.freeze(Object.fromEntries(Object.entries(dependencies).sort())),
+        profiles: Object.freeze(app.profiles.map((profile) => `${profile.capability}:${profile.name}`)),
+        warnings: Object.freeze([]),
+    });
+}
+export function formatCreatePlan(plan) {
+    return [
+        `Destination: ${plan.destination}`,
+        "Files:",
+        ...plan.files.map((path) => `  ${path}`),
+        "Dependencies:",
+        ...Object.entries(plan.dependencies).map(([name, version]) => `  ${name}@${version}`),
+        ...(plan.profiles.length
+            ? ["Profiles:", ...plan.profiles.map((profile) => `  ${profile}`)]
+            : []),
+        ...(plan.warnings.length
+            ? ["Warnings:", ...plan.warnings.map((warning) => `  ${warning}`)]
+            : []),
+    ].join("\n");
+}
+//# sourceMappingURL=create-preview.js.map

package/dist/create-preview.js.map

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

package/dist/create-resolver.d.ts

@@ -0,0 +1,14 @@
+import { type CreateOptions } from "./options.js";
+import { type PromptDriver } from "./prompt-driver.js";
+export interface ResolveCreateContext {
+    readonly json?: boolean;
+    readonly interactive?: boolean;
+    readonly promptDriver?: PromptDriver;
+}
+export interface ResolvedCreateOptions {
+    readonly options: CreateOptions;
+    readonly prompted: boolean;
+}
+export declare function resolveCreateOptions(args: readonly string[], context?: ResolveCreateContext): Promise<CreateOptions>;
+export declare function resolveCreateOptionsDetails(args: readonly string[], context?: ResolveCreateContext): Promise<ResolvedCreateOptions>;
+//# sourceMappingURL=create-resolver.d.ts.map

package/dist/create-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-resolver.d.ts","sourceRoot":"","sources":["../src/create-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKhF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAExB;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAkFhC"}

package/dist/create-resolver.js

@@ -0,0 +1,96 @@
+import { CREATE_CLOUDS, CREATE_DEPLOYMENTS, CREATE_JOBS, CREATE_TEMPLATES, normalizeCreateOptions, } from "./options.js";
+import { createClackPromptDriver } from "./prompt-driver.js";
+import { isValidPackageName } from "./validate.js";
+const VALUE_OPTIONS = new Set(["template", "cloud", "deploy", "jobs", "directory"]);
+export async function resolveCreateOptions(args, context = {}) {
+    return (await resolveCreateOptionsDetails(args, context)).options;
+}
+export async function resolveCreateOptionsDetails(args, context = {}) {
+    if (context.interactive !== true) {
+        return {
+            options: normalizeCreateOptions(args, context.json === undefined ? {} : { json: context.json }),
+            prompted: false,
+        };
+    }
+    const prompt = context.promptDriver ?? createClackPromptDriver("RELKIT_CREATE_CANCELLED");
+    const output = [...args];
+    const complete = Boolean(positional(output)) &&
+        ["template", "cloud", "deploy", "jobs", "directory"].every((name) => has(output, name)) &&
+        ["examples", "install", "git"].every((name) => has(output, name) || has(output, `no-${name}`));
+    let name = positional(output);
+    if (!name) {
+        name = await prompt.text({
+            message: "Project name",
+            validate: (value) => isValidPackageName(value) ? undefined : "Use a valid npm package name.",
+        });
+        output.unshift(name);
+    }
+    if (!has(output, "template"))
+        output.push("--template", await prompt.select({
+            message: "Starter template",
+            options: CREATE_TEMPLATES.map((value) => ({ value, label: title(value) })),
+            initialValue: "minimal",
+        }));
+    if (!has(output, "cloud"))
+        output.push("--cloud", await prompt.select({
+            message: "Cloud provider",
+            options: CREATE_CLOUDS.map((value) => ({ value, label: title(value) })),
+            initialValue: "none",
+        }));
+    if (!has(output, "deploy"))
+        output.push("--deploy", await prompt.select({
+            message: "Deployment adapter",
+            options: CREATE_DEPLOYMENTS.map((value) => ({ value, label: title(value) })),
+            initialValue: "none",
+        }));
+    if (!has(output, "jobs")) {
+        const selected = await prompt.select({
+            message: "Jobs service",
+            options: [
+                { value: "none", label: "None" },
+                ...CREATE_JOBS.map((value) => ({ value, label: title(value) })),
+            ],
+            initialValue: "none",
+        });
+        if (selected !== "none")
+            output.push("--jobs", selected);
+    }
+    await booleanChoice(output, prompt, "examples", "Include examples?", true);
+    await booleanChoice(output, prompt, "install", "Install dependencies?", true);
+    await booleanChoice(output, prompt, "git", "Initialize a Git repository?", true);
+    if (!has(output, "directory"))
+        output.push("--directory", await prompt.text({
+            message: "Destination",
+            initialValue: name,
+            validate: (value) => (value?.trim() ? undefined : "A destination is required."),
+        }));
+    return {
+        options: normalizeCreateOptions(output, context.json === undefined ? {} : { json: context.json }),
+        prompted: !complete,
+    };
+}
+async function booleanChoice(args, prompt, name, message, initialValue) {
+    if (has(args, name) || has(args, `no-${name}`))
+        return;
+    args.push(`--${(await prompt.confirm({ message, initialValue })) ? name : `no-${name}`}`);
+}
+function has(args, name) {
+    return args.some((value) => value === `--${name}` || value.startsWith(`--${name}=`));
+}
+function positional(args) {
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (value.startsWith("--")) {
+            const name = value.slice(2).split("=", 1)[0];
+            if (!value.includes("=") && VALUE_OPTIONS.has(name))
+                index += 1;
+        }
+        else
+            return value;
+    }
+    return undefined;
+}
+function title(value) {
+    return value.replace(/^./, (character) => character.toUpperCase());
+}
+//# sourceMappingURL=create-resolver.js.map

package/dist/create-resolver.js.map

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

package/dist/domain-planning.d.ts

@@ -0,0 +1,24 @@
+import { type NormalizedArtifactName } from "./add-name.js";
+import { PlanBuilder } from "./plan-builder.js";
+import type { DiscoveredArtifact, DiscoveredService } from "./project-discovery-types.js";
+export interface DomainTarget {
+    readonly domain: NormalizedArtifactName;
+    readonly servicePath: string;
+    readonly service: DiscoveredService | undefined;
+}
+export interface DomainArtifact {
+    readonly name: NormalizedArtifactName;
+    readonly path: string;
+    readonly id: string;
+    readonly binding: string;
+    readonly exportKind: "default" | "named";
+}
+export declare function resolveDomain(builder: PlanBuilder): Promise<DomainTarget>;
+export declare function addPublicMember(builder: PlanBuilder, target: DomainTarget, category: "functions" | "events" | "tasks" | "jobs", artifact: DomainArtifact, artifactPath: string): Promise<void>;
+export declare function domainArtifact(target: DomainTarget, value: string, directory: string, fileSuffix: string, kindSuffix?: string, exportKind?: "default" | "named"): DomainArtifact;
+export declare function resolveArtifact(builder: PlanBuilder, target: DomainTarget, kind: DiscoveredArtifact["kind"], value: string): DiscoveredArtifact;
+export declare function assertAvailableId(builder: PlanBuilder, id: string): void;
+export declare function sourceModule(path: string): string;
+export declare function sourceImport(binding: string, module: string, exportKind: "default" | "named" | undefined): string;
+export declare function serviceSource(domain: NormalizedArtifactName): string;
+//# sourceMappingURL=domain-planning.d.ts.map

package/dist/domain-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-planning.d.ts","sourceRoot":"","sources":["../src/domain-planning.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAG1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC;CAC1C;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAqC/E;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,EACnD,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,GAAE,SAAS,GAAG,OAAmB,GAC1C,cAAc,CAUhB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAgBpB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAC1C,MAAM,CAIR;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAEpE"}

package/dist/domain-planning.js

@@ -0,0 +1,94 @@
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { normalizeArtifactName } from "./add-name.js";
+import { PlanBuilder } from "./plan-builder.js";
+import { addFactoryObjectMember, addSourceImport } from "./source-edit.js";
+export async function resolveDomain(builder) {
+    const request = builder.request;
+    if (request.service && request.createService)
+        usage("--service and --create-service are exclusive.");
+    if (request.createService) {
+        const domain = normalizeArtifactName(request.createService);
+        if (builder.discovery.services.some((service) => service.domain === domain.fileStem)) {
+            collision(`Service ${domain.fileStem} already exists.`);
+        }
+        const servicePath = `src/${domain.fileStem}/service.ts`;
+        await builder.create(servicePath, serviceSource(domain));
+        return { domain, servicePath, service: undefined };
+    }
+    const generic = builder.discovery.services.filter((service) => service.capability === "generic");
+    const selected = request.service
+        ? generic.find((service) => [service.domain, service.binding].includes(normalizeArtifactName(request.service).fileStem))
+        : generic.length === 1
+            ? generic[0]
+            : undefined;
+    if (selected === undefined) {
+        usage(request.service
+            ? `Unknown generic service: ${request.service}`
+            : generic.length === 0
+                ? "No generic service exists; use --create-service <name>."
+                : "Multiple generic services exist; use --service <name>.");
+    }
+    return {
+        domain: normalizeArtifactName(selected.domain),
+        servicePath: selected.path,
+        service: selected,
+    };
+}
+export async function addPublicMember(builder, target, category, artifact, artifactPath) {
+    const importPath = sourceModule(artifactPath);
+    await builder.update(target.servicePath, (source) => {
+        const imported = addSourceImport(source, target.servicePath, sourceImport(artifact.binding, importPath, artifact.exportKind));
+        return addFactoryObjectMember(imported, target.servicePath, ["defineService"], [category], artifact.binding, artifact.binding);
+    });
+}
+export function domainArtifact(target, value, directory, fileSuffix, kindSuffix, exportKind = "default") {
+    const name = normalizeArtifactName(value);
+    const suffix = kindSuffix ? normalizeArtifactName(kindSuffix) : undefined;
+    return {
+        name,
+        path: `src/${target.domain.fileStem}/${directory}/${name.fileStem}.${fileSuffix}.ts`,
+        id: `${target.domain.idSegment}.${name.idSegment}${suffix ? `-${suffix.idSegment}` : ""}`,
+        binding: `${name.identifier}${suffix ? capitalize(suffix.identifier) : ""}`,
+        exportKind,
+    };
+}
+export function resolveArtifact(builder, target, kind, value) {
+    const normalized = normalizeArtifactName(value);
+    const candidates = builder.artifacts.filter((artifact) => artifact.domain === target.domain.fileStem && artifact.kind === kind);
+    const exact = candidates.find((artifact) => [artifact.binding, artifact.id, fileStem(artifact.path)].includes(value));
+    const normalizedMatch = candidates.find((artifact) => normalizeArtifactName(artifact.binding).fileStem === normalized.fileStem ||
+        normalizeArtifactName(fileStem(artifact.path)).fileStem === normalized.fileStem);
+    const result = exact ?? normalizedMatch;
+    if (result === undefined)
+        usage(`Unknown ${kind} in ${target.domain.fileStem}: ${value}`);
+    return result;
+}
+export function assertAvailableId(builder, id) {
+    if (builder.artifacts.some((artifact) => artifact.id === id)) {
+        collision(`Descriptor ID ${id} already exists.`);
+    }
+}
+export function sourceModule(path) {
+    return `@app/${path.replace(/^src\//, "").replace(/\.ts$/, ".js")}`;
+}
+export function sourceImport(binding, module, exportKind) {
+    return exportKind === "named"
+        ? `import { ${binding} } from "${module}";`
+        : `import ${binding} from "${module}";`;
+}
+export function serviceSource(domain) {
+    return `import { defineService } from "@relkit/app/services";\n\nexport default defineService({ id: "${domain.idSegment}" });\n`;
+}
+function usage(message) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.usage, message);
+}
+function collision(message) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.collision, message);
+}
+function capitalize(value) {
+    return `${value[0].toUpperCase()}${value.slice(1)}`;
+}
+function fileStem(path) {
+    return path.split("/").at(-1).split(".")[0];
+}
+//# sourceMappingURL=domain-planning.js.map

package/dist/domain-planning.js.map

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

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

@@ -0,0 +1,18 @@
+export declare const EXAMPLE_PATH_PREFIXES: readonly ["src/routes", "src/orders", "src/echo", "src/hello/tools", "src/hello/agents", "tests"];
+export interface StageCleanupResult {
+    readonly temporaryPath?: string;
+    readonly removed: boolean;
+}
+export declare function cleanupStagedProject(stage: string | undefined, destination: string): Promise<StageCleanupResult>;
+export declare function requireTemplate(path: string): Promise<void>;
+export declare function requireFiles(root: string, paths: readonly string[]): Promise<void>;
+export declare function replaceOnce(path: string, before: string, after: string): Promise<void>;
+export declare function removeExamples(root: string): Promise<void>;
+export declare function listProjectFiles(root: string, current?: string): Promise<string[]>;
+export declare function projectId(name: string): string;
+export declare function compareNames(left: {
+    name: string;
+}, right: {
+    name: string;
+}): number;
+//# sourceMappingURL=generate-files-utilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-files-utilities.d.ts","sourceRoot":"","sources":["../src/generate-files-utilities.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,mGAOxB,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAiB7B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5F;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUtF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpF"}

package/dist/generate-files-utilities.js

@@ -0,0 +1,87 @@
+import { access, chmod, lstat, readdir, readFile, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { GenerateProjectError } from "./generate-types.js";
+export const EXAMPLE_PATH_PREFIXES = [
+    "src/routes",
+    "src/orders",
+    "src/echo",
+    "src/hello/tools",
+    "src/hello/agents",
+    "tests",
+];
+export async function cleanupStagedProject(stage, destination) {
+    if (stage === undefined)
+        return { removed: false };
+    const temporaryPath = resolve(stage);
+    const parent = resolve(dirname(destination));
+    const prefix = `.${basename(destination)}-relkit-`;
+    if (dirname(temporaryPath) !== parent || !basename(temporaryPath).startsWith(prefix))
+        return { removed: false };
+    try {
+        const info = await lstat(temporaryPath);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            return { temporaryPath, removed: false };
+        await rm(temporaryPath, { recursive: true, force: true });
+        return { temporaryPath, removed: true };
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return { temporaryPath, removed: true };
+        return { temporaryPath, removed: false };
+    }
+}
+export async function requireTemplate(path) {
+    try {
+        if ((await readdir(path)).length === 0)
+            throw new Error("empty");
+    }
+    catch {
+        throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_MISSING", "Selected template is missing.");
+    }
+}
+export async function requireFiles(root, paths) {
+    for (const path of paths) {
+        try {
+            await access(join(root, path));
+        }
+        catch {
+            throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template file is missing: ${path}`);
+        }
+    }
+}
+export async function replaceOnce(path, before, after) {
+    const content = await readFile(path, "utf8");
+    const first = content.indexOf(before);
+    if (first < 0 || first !== content.lastIndexOf(before))
+        throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template substitution is unavailable: ${path}`);
+    await writeFile(path, content.slice(0, first) + after + content.slice(first + before.length), "utf8");
+    await chmod(path, 0o644);
+}
+export async function removeExamples(root) {
+    for (const directory of EXAMPLE_PATH_PREFIXES)
+        await rm(join(root, directory), { recursive: true, force: true });
+}
+export async function listProjectFiles(root, current = root) {
+    const result = [];
+    for (const entry of (await readdir(current, { withFileTypes: true })).sort(compareNames)) {
+        if (entry.name === ".git" || entry.name === "node_modules" || entry.name === ".relkit")
+            continue;
+        const path = join(current, entry.name);
+        if (entry.isDirectory())
+            result.push(...(await listProjectFiles(root, path)));
+        else if (entry.isFile())
+            result.push(relative(root, path).replaceAll("\\", "/"));
+    }
+    return result;
+}
+export function projectId(name) {
+    const value = name
+        .replace(/^@/, "")
+        .replace("/", "-")
+        .replace(/[^A-Za-z0-9._-]+/g, "-");
+    return value.replace(/^[._-]+/, "").replace(/(?<![._-])[._-]+$/, "") || "app";
+}
+export function compareNames(left, right) {
+    return left.name < right.name ? -1 : left.name > right.name ? 1 : 0;
+}
+//# sourceMappingURL=generate-files-utilities.js.map

package/dist/generate-files-utilities.js.map

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

package/dist/generate-files.d.ts

@@ -1,16 +1,5 @@
 import type { CreateOptions } from "./options.js";
-export interface StageCleanupResult {
-    readonly temporaryPath?: string;
-    readonly removed: boolean;
-}
+export { EXAMPLE_PATH_PREFIXES, cleanupStagedProject, listProjectFiles, projectId, removeExamples, replaceOnce, requireFiles, requireTemplate, type StageCleanupResult, } from "./generate-files-utilities.js";
 export declare function copyTemplate(source: string, target: string): Promise<void>;
 export declare function customizeProject(root: string, options: CreateOptions): Promise<void>;
-/** Removes only a verified mkdtemp sibling; broad or unresolved paths are never recursed. */
-export declare function cleanupStagedProject(stage: string | undefined, destination: string): Promise<StageCleanupResult>;
-export declare function requireTemplate(path: string): Promise<void>;
-export declare function requireFiles(root: string, paths: readonly string[]): Promise<void>;
-export declare function replaceOnce(path: string, before: string, after: string): Promise<void>;
-export declare function removeExamples(root: string): Promise<void>;
-export declare function listProjectFiles(root: string, current?: string): Promise<string[]>;
-export declare function projectId(name: string): string;
 //# 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;AAKlD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,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;AAyCD,6FAA6F;AAC7F,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAmB7B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5F;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUtF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C"}
+{"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"}

package/dist/generate-files.js

@@ -1,6 +1,8 @@
 import { access, chmod, lstat, mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve } from "node:path";
-import { GenerateProjectError } from "./generate.js";
+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) {
@@ -33,11 +35,26 @@ async function customizeDeployment(root, options) {
     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" },'
-        : "");
+    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"];
@@ -45,6 +62,10 @@ async function customizeDeployment(root, options) {
         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/${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";
@@ -54,92 +75,20 @@ async function customizeDeployment(root, options) {
     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"],');
+}
 function sorted(values) {
     return Object.fromEntries(Object.entries(values).sort(([left], [right]) => left.localeCompare(right)));
 }
-/** Removes only a verified mkdtemp sibling; broad or unresolved paths are never recursed. */
-export async function cleanupStagedProject(stage, destination) {
-    if (stage === undefined)
-        return { removed: false };
-    const temporaryPath = resolve(stage);
-    const parent = resolve(dirname(destination));
-    const prefix = `.${basename(destination)}-relkit-`;
-    if (dirname(temporaryPath) !== parent || !basename(temporaryPath).startsWith(prefix)) {
-        return { removed: false };
-    }
-    try {
-        const info = await lstat(temporaryPath);
-        if (!info.isDirectory() || info.isSymbolicLink())
-            return { temporaryPath, removed: false };
-        await rm(temporaryPath, { recursive: true, force: true });
-        return { temporaryPath, removed: true };
-    }
-    catch (error) {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-            return { temporaryPath, removed: true };
-        }
-        return { temporaryPath, removed: false };
-    }
-}
-export async function requireTemplate(path) {
-    try {
-        if ((await readdir(path)).length === 0)
-            throw new Error("empty");
-    }
-    catch {
-        throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_MISSING", "Selected template is missing.");
-    }
-}
-export async function requireFiles(root, paths) {
-    for (const path of paths) {
-        try {
-            await access(join(root, path));
-        }
-        catch {
-            throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template file is missing: ${path}`);
-        }
-    }
-}
-export async function replaceOnce(path, before, after) {
-    const content = await readFile(path, "utf8");
-    const first = content.indexOf(before);
-    if (first < 0 || first !== content.lastIndexOf(before))
-        throw new GenerateProjectError("RELKIT_CREATE_TEMPLATE_INVALID", `Template substitution is unavailable: ${path}`);
-    await writeFile(path, content.slice(0, first) + after + content.slice(first + before.length), "utf8");
-    await chmod(path, FILE_MODE);
-}
-export async function removeExamples(root) {
-    for (const directory of [
-        "src/routes",
-        "src/orders",
-        "src/echo",
-        "src/hello/tools",
-        "src/hello/agents",
-        "tests",
-    ])
-        await rm(join(root, directory), { recursive: true, force: true });
-}
-export async function listProjectFiles(root, current = root) {
-    const result = [];
-    for (const entry of (await readdir(current, { withFileTypes: true })).sort(compareNames)) {
-        if (entry.name === ".git" || entry.name === "node_modules" || entry.name === ".relkit")
-            continue;
-        const path = join(current, entry.name);
-        if (entry.isDirectory())
-            result.push(...(await listProjectFiles(root, path)));
-        else if (entry.isFile())
-            result.push(relative(root, path).replaceAll("\\", "/"));
-    }
-    return result;
-}
-export function projectId(name) {
-    const value = name
-        .replace(/^@/, "")
-        .replace("/", "-")
-        .replace(/[^A-Za-z0-9._-]+/g, "-");
-    return value.replace(/^[._-]+/, "").replace(/(?<![._-])[._-]+$/, "") || "app";
-}
-function compareNames(left, right) {
-    return left.name < right.name ? -1 : left.name > right.name ? 1 : 0;
-}
 //# sourceMappingURL=generate-files.js.map