@ingestron/cli 0.0.0-stage → 1.0.0

package/dist/compare.js

@@ -0,0 +1,90 @@
+// ingestron compare: what differs between two environments once the
+// definitions are resolved: the platform, the names, and each table's methods
+// and settings. Secrets are never shown. The editor's command shows the same.
+import { resolve } from "node:path";
+import { formatDiagnostics, nodeFiles } from "@ingestron/config";
+import { resolveDefinitions } from "@ingestron/definitions";
+import { environmentsToGenerate } from "./environments.js";
+import { packs } from "./packs.js";
+/** Prints the comparison of the two environments given, else the project's first two. */
+export function compare(options, io) {
+    const definitions = resolve(io.cwd, options.definitions);
+    const [a, b, ...more] = environmentsToGenerate(definitions, options.environments);
+    if (!a || !b || (more.length > 0 && options.environments.length > 0)) {
+        io.write("compare needs two environments: name them with --env, or declare two in project.yaml.\n");
+        return 2;
+    }
+    const text = compareEnvironments(nodeFiles(definitions), a, b);
+    io.write(text);
+    return text.includes("the definitions have problems") ? 1 : 0;
+}
+/**
+ * The differences between two environments as Markdown, grouped by platform,
+ * names and table; a note with the problems when either does not resolve.
+ * @example
+ * console.log(compareEnvironments(nodeFiles("definitions"), "dev", "prod"));
+ */
+export function compareEnvironments(files, a, b) {
+    const left = resolveDefinitions(files, { packs, environment: a, envvars: {} });
+    const right = resolveDefinitions(files, { packs, environment: b, envvars: {} });
+    for (const [name, result] of [
+        [a, left],
+        [b, right],
+    ])
+        if (!result.model)
+            return `# ${a} ↔ ${b}\n\n${name}: the definitions have problems\n\n${formatDiagnostics(result.diagnostics)}\n`;
+    const before = sectionsOf(left.model);
+    const after = sectionsOf(right.model);
+    const groups = [...new Set([...Object.keys(before), ...Object.keys(after)])].flatMap((section) => {
+        const lines = differences(before[section] ?? {}, after[section] ?? {});
+        return lines.length > 0 ? [`## ${section}\n\n${lines.join("\n")}`] : [];
+    });
+    const title = `# ${a} ↔ ${b}: ${left.model.project.id}`;
+    return `${[title, ...(groups.length > 0 ? groups : ["No differences."])].join("\n\n")}\n`;
+}
+function sectionsOf(model) {
+    return {
+        Platform: flat(model.platform),
+        Names: flat(model.names),
+        ...Object.fromEntries(model.tables.map((table) => [`Table ${table.name}`, tableFacts(table)])),
+    };
+}
+function tableFacts(table) {
+    const step = (found) => found && { method: found.method, settings: found.settings };
+    return {
+        "full name": Object.values(table.fullName).join("."),
+        ...flat({
+            ingest: table.ingest && {
+                ...step(table.ingest),
+                object: table.ingest.object,
+                connection: {
+                    connectivity: table.ingest.connection.connectivity,
+                    settings: table.ingest.connection.settings,
+                },
+            },
+            transform: step(table.transform),
+            store: step(table.store),
+        }),
+        expectations: table.expectations.map((item) => `${item.name}: ${item.action}`),
+    };
+}
+/** Every leaf by its dotted path; lists and secrets are leaves. */
+function flat(value, prefix = "") {
+    const secret = typeof value === "object" && value !== null && "$secret" in value;
+    if (secret)
+        return { [prefix]: "a secret" };
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return value === undefined ? {} : { [prefix]: value };
+    return Object.assign({}, ...Object.entries(value).map(([key, item]) => flat(item, prefix ? `${prefix}.${key}` : key)));
+}
+function differences(before, after) {
+    return [...new Set([...Object.keys(before), ...Object.keys(after)])]
+        .filter((key) => JSON.stringify(before[key]) !== JSON.stringify(after[key]))
+        .map((key) => `- \`${key}\`: ${shown(before[key])} → ${shown(after[key])}`);
+}
+function shown(value) {
+    if (value === undefined)
+        return "not set";
+    return `\`${typeof value === "string" ? value : JSON.stringify(value)}\``;
+}
+//# sourceMappingURL=compare.js.map

package/dist/compare.js.map

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

package/dist/environments.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The environments to generate: the requested ones, else every environment
+ * in project.yaml, else one unnamed environment (`undefined`).
+ */
+export declare function environmentsToGenerate(definitions: string, requested: string[]): (string | undefined)[];
+//# sourceMappingURL=environments.d.ts.map

package/dist/environments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,GAClB,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAcxB"}

package/dist/environments.js

@@ -0,0 +1,25 @@
+// The environments declared in project.yaml.
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse } from "yaml";
+/**
+ * The environments to generate: the requested ones, else every environment
+ * in project.yaml, else one unnamed environment (`undefined`).
+ */
+export function environmentsToGenerate(definitions, requested) {
+    if (requested.length > 0)
+        return requested;
+    const manifest = join(definitions, "project.yaml");
+    if (!existsSync(manifest))
+        return [undefined];
+    try {
+        const data = parse(readFileSync(manifest, "utf8"));
+        const names = Object.keys(data?.environments ?? {});
+        return names.length > 0 ? names : [undefined];
+    }
+    catch {
+        // Loading reports the problem with its location.
+        return [undefined];
+    }
+}
+//# sourceMappingURL=environments.js.map

package/dist/environments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.js","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,SAAmB;IAEnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAEhD,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;QACjD,OAAO,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,16 @@
+import { type ResolvedModel } from "@ingestron/definitions";
+import type { Options } from "./args.js";
+import type { Io } from "./io.js";
+/** Runs plan, apply or check for each environment. Returns the exit code. */
+export declare function generate(options: Options, io: Io): number;
+/**
+ * The files each pack the standard names generates for one environment. The
+ * label is the output sub-folder: `<environment>`, or `<environment>/<pack>`
+ * with several packs.
+ */
+export declare function generatedOutputs(model: ResolvedModel, environment: string): {
+    pack: string;
+    label: string;
+    files: Record<string, string>;
+}[];
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAW7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAYlC,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAsBzD;AAyDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EAAE,CAOlE"}

package/dist/generate.js

@@ -0,0 +1,118 @@
+// plan, apply and check: definitions → files → the output folder.
+import { join, relative, resolve, sep } from "node:path";
+import { formatDiagnostics } from "@ingestron/config";
+import { loadDefinitions } from "@ingestron/definitions";
+import { applyPlan, formatPlan, manifestFile, nodeFolder, planGeneration, } from "@ingestron/generate";
+import { packs } from "./packs.js";
+import { environmentsToGenerate } from "./environments.js";
+import { extraFiles, generatedFolders } from "./outputs.js";
+/** Runs plan, apply or check for each environment. Returns the exit code. */
+export function generate(options, io) {
+    const definitions = resolve(io.cwd, options.definitions);
+    const planned = [];
+    const unresolved = [];
+    for (const environment of environmentsToGenerate(definitions, options.environments)) {
+        const outputs = planEnvironment(options, io, definitions, environment);
+        if (!outputs)
+            unresolved.push(environment ?? "default");
+        planned.push(...(outputs ?? []));
+    }
+    const roots = planned.map((item) => item.root);
+    const done = planned.filter((item) => finish(options, io, item, roots)).map(({ name }) => name);
+    const notDone = [
+        ...planned.filter(({ name }) => !done.includes(name)).map(({ name }) => name),
+        ...unresolved,
+    ];
+    const retired = retiredFolders(options, resolve(io.cwd, options.out), roots, unresolved);
+    for (const folder of retired)
+        io.write(`${relative(io.cwd, folder)}: no longer generated. Delete the folder, or delete its ${manifestFile} to keep it as your own.\n`);
+    if (options.command === "apply")
+        summarise(io, done, notDone);
+    return notDone.length > 0 || (options.command === "check" && retired.length > 0) ? 1 : 0;
+}
+/** After apply, when some output folders were written and others not, says which. */
+function summarise(io, done, notDone) {
+    if (done.length > 0 && notDone.length > 0)
+        io.write(`Applied: ${done.join(", ")}. Not applied: ${notDone.join(", ")}.\n`);
+}
+/**
+ * Folders under the output folder that hold a manifest but that the
+ * definitions no longer generate. With --env, only those environments'
+ * folders are looked at; nor are those of an environment that failed to load.
+ */
+function retiredFolders(options, out, current, unresolved) {
+    const within = (folder, root) => folder === root || folder.startsWith(root + sep);
+    const looked = options.environments.length > 0
+        ? options.environments.map((environment) => join(out, environment))
+        : [out];
+    const skipped = unresolved.map((environment) => join(out, environment));
+    return looked
+        .flatMap(generatedFolders)
+        .filter((folder) => !current.includes(folder))
+        .filter((folder) => !skipped.some((root) => within(folder, root)));
+}
+/**
+ * One plan per pack the standard names. With one pack the output folder is
+ * `<out>/<environment>`; with several, each pack gets `<out>/<environment>/<pack>`.
+ */
+function planEnvironment(options, io, definitions, environment) {
+    const name = environment ?? "default";
+    const result = loadDefinitions(definitions, { packs, environment, envvars: process.env });
+    if (!result.model) {
+        io.write(`${name}: the definitions have problems\n${formatDiagnostics(result.diagnostics)}\n`);
+        return undefined;
+    }
+    if (result.diagnostics.length > 0)
+        io.write(`${name}: warnings\n${formatDiagnostics(result.diagnostics)}\n`);
+    return generatedOutputs(result.model, name).map(({ label, files }) => {
+        const output = resolve(io.cwd, options.out, label);
+        const folder = nodeFolder(output);
+        const plan = planGeneration(folder, files);
+        return { name: label, folder, plan, root: output, output: relative(io.cwd, output) };
+    });
+}
+/**
+ * The files each pack the standard names generates for one environment. The
+ * label is the output sub-folder: `<environment>`, or `<environment>/<pack>`
+ * with several packs.
+ */
+export function generatedOutputs(model, environment) {
+    const used = packs.filter((pack) => model.standard.packs.includes(`${pack.id}@${pack.version}`));
+    return used.map((pack) => ({
+        pack: pack.id,
+        label: used.length > 1 ? `${environment}/${pack.id}` : environment,
+        files: pack.build(model),
+    }));
+}
+/**
+ * Prints the plan and, for apply, writes it. True when this output folder
+ * succeeded. check also fails on files in the folder that were not
+ * generated, unless --allow-extra; `roots` are every output folder, so one
+ * inside another is not counted as extra.
+ */
+function finish(options, io, planned, roots) {
+    const { name, folder, plan, output } = planned;
+    if (options.command === "check")
+        return check(options, io, planned, roots);
+    io.write(`${name} → ${output}\n`);
+    io.write(`${formatPlan(plan, { diffs: options.diffs })}\n`);
+    if (options.command === "plan" || !plan.clean)
+        return plan.clean;
+    if (plan.upToDate)
+        return true;
+    const result = applyPlan(folder, plan);
+    io.write(result.ok ? "Applied.\n" : `${result.problems.map((problem) => problem.message).join("\n")}\n`);
+    return result.ok;
+}
+/** check for one output folder: up to date, and nothing in it that was not generated. */
+function check(options, io, { name, plan, root }, roots) {
+    const known = new Set(plan.changes.map((change) => change.path));
+    const extra = options.allowExtra ? [] : extraFiles(root, known, roots);
+    io.write(plan.upToDate ? `${name}: up to date\n` : `${name}: not up to date\n${formatPlan(plan)}\n`);
+    for (const path of extra)
+        io.write(`${name}: not generated  ${path}\n`);
+    if (extra.length > 0)
+        io.write("Move files that were not generated out of the output folder, or check with --allow-extra.\n");
+    return plan.upToDate && extra.length === 0;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { commands, flags } from "./args.js";
+import type { Io } from "./io.js";
+export type { Io } from "./io.js";
+export { packs } from "./packs.js";
+export { nameProblem, projectId } from "./scaffold.js";
+export { generatedOutputs } from "./generate.js";
+export { platformRequest } from "./request.js";
+export { compareEnvironments } from "./compare.js";
+export { contractFromSample } from "./sample-contract.js";
+export { listSamples, readSample, sampleFacts, templatesFolder, type Sample, type SampleFacts, } from "./samples.js";
+export { projectSources, projectRoutes, type ProjectSource, type ProjectRoute, } from "./project-choices.js";
+export { projectRecipe, type ProjectRecipe } from "./project-recipes.js";
+export { builtInTemplates, parseTemplate, templateSchema, type Template } from "./templates.js";
+/**
+ * Runs `ingestron` with `args` and returns the exit code: 0 success, 1
+ * problems in the definitions or the output folder, 2 a usage mistake.
+ * @example
+ * process.exitCode = run(process.argv.slice(2), { cwd: process.cwd(), write: (text) => process.stdout.write(text) });
+ */
+export declare function run(args: string[], io: Io): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAMlC,YAAY,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEhG;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAelD"}

package/dist/index.js

@@ -0,0 +1,46 @@
+// Public API of @ingestron/cli: run the command line in-process.
+import { readArgs, usage } from "./args.js";
+export { commands, flags } from "./args.js";
+import { generate } from "./generate.js";
+import { init } from "./init.js";
+import { compare } from "./compare.js";
+import { request } from "./request.js";
+import { draftContract } from "./sample-contract.js";
+import { writeSchemas } from "./schemas.js";
+export { packs } from "./packs.js";
+export { nameProblem, projectId } from "./scaffold.js";
+export { generatedOutputs } from "./generate.js";
+export { platformRequest } from "./request.js";
+export { compareEnvironments } from "./compare.js";
+export { contractFromSample } from "./sample-contract.js";
+export { listSamples, readSample, sampleFacts, templatesFolder, } from "./samples.js";
+export { projectSources, projectRoutes, } from "./project-choices.js";
+export { projectRecipe } from "./project-recipes.js";
+export { builtInTemplates, parseTemplate, templateSchema } from "./templates.js";
+/**
+ * Runs `ingestron` with `args` and returns the exit code: 0 success, 1
+ * problems in the definitions or the output folder, 2 a usage mistake.
+ * @example
+ * process.exitCode = run(process.argv.slice(2), { cwd: process.cwd(), write: (text) => process.stdout.write(text) });
+ */
+export function run(args, io) {
+    const options = readArgs(args);
+    if (options === "help") {
+        io.write(usage);
+        return 0;
+    }
+    if ("mistake" in options) {
+        io.write(`${options.mistake}\n\n${usage}`);
+        return 2;
+    }
+    if (options.command === "init")
+        return init(options, io);
+    if (options.command === "request")
+        return request(options, io);
+    if (options.command === "compare")
+        return compare(options, io);
+    if (options.command === "contract")
+        return draftContract(options, io);
+    return options.command === "schemas" ? writeSchemas(options, io) : generate(options, io);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,GAGhB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,aAAa,GAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AAEhG;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,IAAc,EAAE,EAAM;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;QACzB,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/init-choice.d.ts

@@ -0,0 +1,10 @@
+import type { Options } from "./args.js";
+/** The existing init question contract. */
+export type Ask = (question: string, flag: string, fallback: string, check?: (answer: string) => string | undefined) => string;
+/** Select a connector, reachable network and compatible ingestion route. */
+export declare function chooseProject(flags: Options["init"], ask: Ask): {
+    done: () => void;
+    template: import("./templates.js").Template;
+    files: Record<string, import("./scaffold.js").Content>;
+};
+//# sourceMappingURL=init-choice.d.ts.map

package/dist/init-choice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-choice.d.ts","sourceRoot":"","sources":["../src/init-choice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,2CAA2C;AAC3C,MAAM,MAAM,GAAG,GAAG,CAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,KAC3C,MAAM,CAAC;AACZ,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG;;;;EAsC7D"}

package/dist/init-choice.js

@@ -0,0 +1,36 @@
+import { projectRoutes, projectSources } from "./project-choices.js";
+import { projectRecipe } from "./project-recipes.js";
+/** Select a connector, reachable network and compatible ingestion route. */
+export function chooseProject(flags, ask) {
+    const sources = projectSources();
+    let connector = flags.connector;
+    if (!connector) {
+        const categories = [...new Set(sources.map((source) => source.category))];
+        const category = choose("Source category", categories, "Files and storage", "--connector", ask);
+        connector = choose("Connector", sources.filter((source) => source.category === category).map((source) => source.id), category === "Files and storage" ? "files" : "", "--connector", ask);
+    }
+    if (!sources.some((source) => source.id === connector))
+        throw new Error(`Unknown connector "${connector}".`);
+    const available = projectRoutes(connector);
+    const networks = [...new Set(available.flatMap((route) => route.connectivity))];
+    const preferred = available.some((route) => route.via === "databricks")
+        ? connector === "sqlserver"
+            ? "workspace"
+            : "public"
+        : "private";
+    const connectivity = flags.connectivity ?? choose("Connectivity", networks, preferred, "--connectivity", ask);
+    const routes = projectRoutes(connector, connectivity);
+    if (!routes.length)
+        throw new Error(`No route for ${connector} with ${connectivity} connectivity.`);
+    const via = flags.via ??
+        choose(`Route (${routes.map((route) => `${route.via}: ${route.title}, ${route.maturity}`).join("; ")})`, routes.map((route) => route.via), routes[0].via, "--via", ask);
+    return { ...projectRecipe(connector, via, connectivity), done: () => { } };
+}
+function choose(title, values, fallback, flag, ask) {
+    if (values.length === 1)
+        return values[0];
+    const normalise = (answer) => /^\d+$/.test(answer) ? (values[Number(answer) - 1] ?? answer) : answer;
+    const prompt = `${title}:\n${values.map((value, index) => `  ${index + 1}. ${value}`).join("\n")}\nChoice [${fallback || values[0]}]: `;
+    return normalise(ask(prompt, flag, fallback || values[0], (answer) => values.includes(normalise(answer)) ? undefined : `Choose one of: ${values.join(", ")}.`));
+}
+//# sourceMappingURL=init-choice.js.map

package/dist/init-choice.js.map

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

package/dist/init-preflight.d.ts

@@ -0,0 +1,4 @@
+import type { Content } from "./scaffold.js";
+/** All requested environments must resolve, including the selected standard. */
+export declare function projectProblem(files: Record<string, Content>): string | undefined;
+//# sourceMappingURL=init-preflight.d.ts.map

package/dist/init-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-preflight.d.ts","sourceRoot":"","sources":["../src/init-preflight.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAYjF"}

package/dist/init-preflight.js

@@ -0,0 +1,18 @@
+// Validate the composed project before the scaffold writer creates any files.
+import { memoryFiles, formatDiagnostics } from "@ingestron/config";
+import { resolveDefinitions } from "@ingestron/definitions";
+import { parse } from "yaml";
+import { packs } from "./packs.js";
+/** All requested environments must resolve, including the selected standard. */
+export function projectProblem(files) {
+    const source = memoryFiles(Object.fromEntries(Object.entries(files).map(([path, content]) => [path, content.toString()])));
+    const project = parse(String(files["project.yaml"]));
+    const names = Object.keys(project.environments ?? {});
+    for (const environment of names.length ? names : [undefined]) {
+        const result = resolveDefinitions(source, { packs, environment });
+        if (!result.model)
+            return `Project is not compatible in ${environment}; nothing written.\n${formatDiagnostics(result.diagnostics)}`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=init-preflight.js.map

package/dist/init-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-preflight.js","sourceRoot":"","sources":["../src/init-preflight.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC3D,MAAM,MAAM,GAAG,WAAW,CACxB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAC/F,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAA8B,CAAC;IAClF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACtD,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,OAAO,gCAAgC,WAAW,uBAAuB,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;IACrH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,5 @@
+import type { Options } from "./args.js";
+import type { Io } from "./io.js";
+/** Creates the project and shows its plan. Returns the exit code. */
+export declare function init(options: Options, io: Io): number;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAalC,qEAAqE;AACrE,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAmBrD"}

package/dist/init.js

@@ -0,0 +1,136 @@
+// ingestron init: a new project from a connection or explicit template. Every answer comes from a
+// flag, else the default with --yes, else a question; without a terminal a
+// missing answer is an error that names the flag, never a wait.
+import { readFileSync } from "node:fs";
+import { basename, join, relative, resolve } from "node:path";
+import { parse } from "yaml";
+import { chooseProject } from "./init-choice.js";
+import { projectProblem } from "./init-preflight.js";
+import { generate } from "./generate.js";
+import { nameProblem, projectId, scaffoldFiles, writeScaffold } from "./scaffold.js";
+import { standardSource, templateSource } from "./sources.js";
+import {} from "./templates.js";
+/** Creates the project and shows its plan. Returns the exit code. */
+export function init(options, io) {
+    const cleanups = [];
+    try {
+        checkFlags(options);
+        const ask = asker(options, io);
+        const target = resolve(io.cwd, options.init.folder);
+        const source = options
+            .init.template
+            ? templateSource(options.init.template, io.cwd)
+            : chooseProject(options.init, ask);
+        cleanups.push(source.done);
+        const answers = gather(options, io, ask, source.template, target, cleanups);
+        return create(options, io, target, source.template, answers, source.files);
+    }
+    catch (error) {
+        io.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    finally {
+        for (const cleanup of cleanups)
+            cleanup();
+    }
+}
+function gather(options, io, ask, template, target, cleanups) {
+    const { init: flags } = options;
+    const suggested = projectId(basename(target));
+    const name = flags.name ??
+        ask(`Project name [${suggested}]: `, "--name", suggested, (answer) => nameProblem(answer, "project"));
+    const known = (flags.template ? templateEnvironments(template) : ["dev", "prod"]).join(", ");
+    const environments = options.environments.length > 0
+        ? options.environments
+        : list(ask(`Environments [${known}]: `, "--env", known, environmentsProblem));
+    // Optional: keeping the template's standard needs no answer.
+    const standard = flags.standard ??
+        (io.ask && !flags.yes
+            ? ask("Standard: a path or Git URL, or Enter to keep the supplied default: ", "--standard", "")
+            : "");
+    const answers = { name, environments, values: {} };
+    if (standard) {
+        const found = standardSource(standard, io.cwd);
+        cleanups.push(found.done);
+        answers.standard = { file: found.file, source: found.source };
+    }
+    answers.values = values(flags.set, template, ask);
+    return answers;
+}
+function values(set, template, ask) {
+    const asked = template.questions.map((question) => question.value);
+    const unknown = Object.keys(set).find((key) => !asked.includes(key));
+    if (unknown)
+        throw new Error(`The template asks no "${unknown}". It asks: ${asked.join(", ") || "nothing"}.`);
+    return Object.fromEntries(template.questions.map((question) => [
+        question.value,
+        set[question.value] ??
+            ask(`${question.ask} [${question.default}]: `, `--set ${question.value}=…`, question.default),
+    ]));
+}
+/** The answer from the terminal, else the default with --yes, else an error naming the flag. */
+function asker(options, io) {
+    return (question, flag, fallback, check) => {
+        if (options.init.yes)
+            return fallback;
+        if (!io.ask)
+            throw new Error(`Missing ${flag}. Pass it, or --yes to take the defaults.`);
+        let prompt = question;
+        for (;;) {
+            const answer = io.ask(prompt)?.trim() || fallback;
+            const problem = check?.(answer);
+            if (!problem)
+                return answer;
+            prompt = `${problem}\n${question}`;
+        }
+    };
+}
+/** Writes the project, unless a file is in the way, then shows its plan. */
+function create(options, io, target, template, answers, prepared) {
+    const files = scaffoldFiles(template, answers, prepared);
+    const problem = projectProblem(files);
+    if (problem)
+        throw new Error(problem);
+    const result = writeScaffold(target, files);
+    const shown = relative(io.cwd, target) || ".";
+    if ("clashes" in result) {
+        const listed = result.clashes.map((path) => `  ${path}\n`).join("");
+        io.write(`Nothing written: these files already exist in ${shown}:\n${listed}`);
+        return 1;
+    }
+    io.write(`Created ${shown} from ${options.init.template ? "the template " : ""}${template.name} (${result.written.length} files).\n\n`);
+    const plan = {
+        command: "plan",
+        environments: [],
+        definitions: target,
+        out: join(target, "build"),
+        diffs: false,
+    };
+    return generate({ ...options, ...plan }, io);
+}
+/** Names given as flags are checked before anything else happens. */
+function checkFlags(options) {
+    if (options.init.template &&
+        (options.init.connector || options.init.via || options.init.connectivity))
+        throw new Error("Choose connection options or --template, not both.");
+    const problem = (options.init.name !== undefined ? nameProblem(options.init.name, "project") : undefined) ??
+        options.environments.map((name) => nameProblem(name, "environment")).find(Boolean);
+    if (problem)
+        throw new Error(problem);
+}
+function environmentsProblem(answer) {
+    return list(answer)
+        .map((name) => nameProblem(name, "environment"))
+        .find(Boolean);
+}
+function templateEnvironments(template) {
+    const project = parse(readFileSync(join(template.folder, "project.yaml"), "utf8"));
+    return Object.keys(project.environments ?? { dev: {} });
+}
+function list(text) {
+    return text
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=init.js.map