@kumori/kdsl 0.0.14 → 0.0.16

package/dist/deployment/gen/main.js

@@ -0,0 +1,158 @@
+import { Err, Ok } from "@kumori/kdsl-lsp/util/result.js";
+import { NodeFileSystem } from "langium/node";
+import { URI } from "langium";
+import { createKumoriServices, } from "@kumori/kdsl-lsp/language/kumori.js";
+import Handlebars from "handlebars";
+import * as files from "node:fs";
+import * as path from "node:path";
+const Summary = `generates a deployment based on a deployment config JSON`;
+export const Description = `
+After running the command kdsl build, which generates a deployment-config.json file containing
+the JSON representation of a particular deployment, this command can be used to generate the corresponding
+deployment artifact in Kumori DSL syntax.
+
+Sometimes it is really useful to apply patches directly to the JSON representation of a deployment,
+and then regenerate the Kumori DSL source code for that deployment. This command facilitates that process.
+
+This command attempts to search for a deployment-config.json file in the current working directory,
+and generates a deployment artifact file named generated-deployment.kumori in the same directory.
+
+Additionally, you can specify a different path to where the deployment-config.json file is located as well
+as a different output path for the generated Kumori DSL file.
+
+Examples:
+    kdsl deployment gen
+    kdsl deployment gen path/to/deployment-config.json
+    kdsl deployment gen path/to/deployment-config.json path/to/output/generated-deployment.kumori
+`.trim();
+export default { Register };
+export function Register(cmd, log) {
+    const c = cmd
+        .command("generate")
+        .alias("gen")
+        .argument("[input]", `path to deployment-config.json file`, "deployment-config.json")
+        .argument("[output]", `path to output generated Kumori DSL file`, "generated-deployment.kumori")
+        .summary(Summary)
+        .description(Description)
+        .helpOption(true)
+        .action(Action(log));
+    return c;
+}
+export function Action(log) {
+    return async (input = "deployment-config.json", output = "generated-deployment.kumori") => {
+        const svcs = createKumoriServices(NodeFileSystem).Kumori;
+        await GenDeployment(log, svcs, input, output);
+    };
+}
+export async function GenDeployment(log, svcs, input, output) {
+    // Read the input file
+    const fs = svcs.shared.workspace.FileSystemProvider;
+    let inputFile = "";
+    try {
+        const inputFilePath = path.resolve(input);
+        inputFile = fs.readFileSync(URI.file(inputFilePath));
+    }
+    catch (e) {
+        log.error(`Input file not found: ${input} error: ${e}`);
+        return Err([`Input file not found: ${input} error: ${e}`]);
+    }
+    // Parse the JSON
+    let deploymentJson;
+    try {
+        deploymentJson = JSON.parse(inputFile);
+    }
+    catch (e) {
+        log.error(`Failed to parse JSON from input file: ${input} error: ${e}`);
+        return Err([`Failed to parse JSON from input file: ${input} error: ${e}`]);
+    }
+    const name = deploymentJson.name;
+    const resilience = deploymentJson.config.resilience;
+    // Build the import path for our artifact. If package is empty, we skip it.
+    // Otherwise, we import everything up until the last slash of the package, which is the actual route
+    // to the artifact within the module
+    let artifactImport = undefined;
+    const lastSlash = deploymentJson.artifact.ref.package.lastIndexOf("/");
+    if (deploymentJson.artifact.ref.package !== "") {
+        artifactImport =
+            deploymentJson.artifact.ref.domain +
+                "/" +
+                deploymentJson.artifact.ref.module +
+                "/" +
+                deploymentJson.artifact.ref.package.substring(0, lastSlash);
+    }
+    const imports = artifactImport ? [artifactImport] : [];
+    // Build the artifact name <package>.<name>
+    // Again, if the package is empty, we just need to use the name
+    const artifact = deploymentJson.artifact.ref.package !== ""
+        ? deploymentJson.artifact.ref.package.substring(lastSlash + 1) +
+            "." +
+            deploymentJson.artifact.ref.name
+        : deploymentJson.artifact.ref.name;
+    const resources = [];
+    Object.entries(deploymentJson.config.resource).forEach(([key, value]) => {
+        const resourceName = Object.entries(Object(value))[0][1];
+        // First letter always uppercase for the resource type
+        const resourceType = Object.entries(Object(value))[0][0].charAt(0).toUpperCase() +
+            Object.entries(Object(value))[0][0].slice(1);
+        const resource = `${key} kumori.${resourceType}("${resourceName}")`;
+        resources.push(resource);
+    });
+    // Make sure to import "kumori" as well if we have resources
+    if (Object.keys(deploymentJson.config.resource).length > 0) {
+        if (!imports.includes("kumori")) {
+            imports.push("kumori");
+        }
+    }
+    const config = [];
+    Object.entries(deploymentJson.config.parameter).forEach(([key, value]) => {
+        const formattedValue = typeof value === "string" ? `"${value}"` : value;
+        config.push(`${key} ${formattedValue}`);
+        // If the value starts with "<something>.", we must import that as well
+        const splitValue = String(value).split(".");
+        if (splitValue.length == 2 && splitValue[1] != "") {
+            const importName = splitValue[0];
+            if (!imports.includes(importName)) {
+                imports.push(importName);
+            }
+        }
+    });
+    const scale = [];
+    let scaleValue = -1;
+    // We do not include inbound roles, they are always 1
+    // If the artifact is a component, we can define the scale as just a number
+    if (deploymentJson.artifact.ref.kind === "component") {
+        scaleValue = Object(deploymentJson.config.scale).hsize;
+    }
+    else {
+        Object.entries(deploymentJson.config.scale.detail)
+            .filter(([key]) => key !== "Inbound")
+            .forEach(([key, value]) => {
+            scale.push(`${key} ${Object(value).hsize}`);
+        });
+    }
+    // Call handlebars to generate the output file
+    const templateFile = fs.readFileSync(URI.file(new URL("./deployment-template.kumori", import.meta.url).pathname));
+    const template = Handlebars.compile(templateFile, { noEscape: true });
+    const outputFile = template({
+        name,
+        artifact,
+        resilience,
+        imports,
+        config,
+        scale,
+        scaleValue,
+        resources,
+    });
+    // Write the output file
+    try {
+        const outputFilePath = path.resolve(output);
+        files.writeFileSync(outputFilePath, outputFile);
+        log.info(`Generated deployment artifact at: ${output}`);
+    }
+    catch (e) {
+        log.error(`Failed to write output file: ${output} error: ${e}`);
+        return Err([`Failed to write output file: ${output} error: ${e}`]);
+    }
+    return Ok(undefined);
+}
+//# sourceMappingURL=main.js.map

package/dist/deployment/gen/main.js.map

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

package/dist/deployment/gen/types.d.ts

@@ -0,0 +1,27 @@
+export type DeploymentJson = {
+    name: string;
+    config: {
+        parameter: Record<string, {
+            [k: string]: unknown;
+        }>;
+        resource: Record<string, {
+            [k: string]: unknown;
+        }>;
+        resilience: number;
+        scale: {
+            detail: Record<string, {
+                hsize: number;
+            }>;
+        };
+    };
+    artifact: {
+        ref: {
+            version: [number, number, number];
+            kind: "service" | "component" | string;
+            domain: string;
+            module: string;
+            name: string;
+            package: string;
+        };
+    };
+};

package/dist/deployment/gen/types.js

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

package/dist/deployment/gen/types.js.map

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

package/dist/deployment/main.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "@commander-js/extra-typings";
+import { ILogLayer } from "loglayer";
+declare const _default: {
+    Register: typeof Register;
+};
+export default _default;
+export declare function Register(cmd: Command, log: ILogLayer): Command<[], {}, {}>;
+export declare const Description: string;

package/dist/deployment/main.js

@@ -0,0 +1,17 @@
+import gen from "./gen/main.js";
+export default { Register };
+export function Register(cmd, log) {
+    const program = cmd
+        .command("deployment")
+        .summary(Summary)
+        .description(Description)
+        .helpCommand(false)
+        .helpOption(false);
+    gen.Register(program, log);
+    return program;
+}
+const Summary = `deployment operations`;
+export const Description = `
+Provides access to operations on deployments.
+`.trim();
+//# sourceMappingURL=main.js.map

package/dist/deployment/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/deployment/main.ts"],"names":[],"mappings":"AAEA,OAAO,GAAG,MAAM,eAAe,CAAA;AAE/B,eAAe,EAAE,QAAQ,EAAE,CAAA;AAC3B,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,GAAc;IACnD,MAAM,OAAO,GAAG,GAAG;SAChB,OAAO,CAAC,YAAY,CAAC;SACrB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,WAAW,CAAC;SACxB,WAAW,CAAC,KAAK,CAAC;SAClB,UAAU,CAAC,KAAK,CAAC,CAAA;IAEpB,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAE1B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,OAAO,GAAG,uBAAuB,CAAA;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG;;CAE1B,CAAC,IAAI,EAAE,CAAA"}

package/dist/help/main.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "@commander-js/extra-typings";
+import { CommanderActionParams } from "../util.js";
+declare const _default: {
+    Register: typeof Register;
+};
+export default _default;
+export declare function Register(cmd: Command): Command<[string[]], {
+    all?: true | undefined;
+}, {}>;
+export declare const Description: string;
+export declare const RegisterTopic: (topic: string, fn: () => Promise<void>) => Map<string, () => Promise<void>>;
+type Exec = CommanderActionParams<ReturnType<typeof Register>>;
+export declare const Exec: Exec;

package/dist/help/main.js

@@ -0,0 +1,49 @@
+export default { Register };
+export function Register(cmd) {
+    const c = cmd
+        .command("help")
+        .summary(Summary)
+        .description(Description)
+        .argument("[topic...]")
+        .option("-a, --all", "list all available topics")
+        .action(Exec);
+    return c;
+}
+const Summary = `
+displays helpful information on various topics
+`.trim();
+export const Description = `
+Use "kdsl help -a" for a list of available topics.
+`.trim();
+const Topics = new Map();
+export const RegisterTopic = (topic, fn) => Topics.set(topic, fn);
+export const Exec = async (topics, options, cmd) => {
+    if (options.all) {
+        return ListTopics();
+    }
+    if (!topics.length) {
+        cmd.outputHelp();
+        return;
+    }
+    const topic = topics.join(" ");
+    const fn = Topics.get(topic);
+    if (!fn) {
+        console.error(`unknown topic '${topic}'\n`);
+        return ListTopics();
+    }
+    await fn();
+};
+const ListTopics = () => {
+    console.log("Available topics:\n");
+    console.log(Array.from(Topics.keys())
+        .sort()
+        .map((e) => "\t" + e)
+        .join("\n"));
+};
+import mod_dep from "./topic/mod_dep.js";
+RegisterTopic(...mod_dep);
+import mod_dl from "./topic/mod_dl.js";
+RegisterTopic(...mod_dl);
+import build from "./topic/build.js";
+RegisterTopic(...build);
+//# sourceMappingURL=main.js.map

package/dist/help/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/help/main.ts"],"names":[],"mappings":"AAGA,eAAe,EAAE,QAAQ,EAAE,CAAA;AAC3B,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,MAAM,CAAC,GAAG,GAAG;SACV,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,WAAW,CAAC;SACxB,QAAQ,CAAC,YAAY,CAAC;SACtB,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;SAChD,MAAM,CAAC,IAAI,CAAC,CAAA;IACf,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,OAAO,GAAG;;CAEf,CAAC,IAAI,EAAE,CAAA;AACR,MAAM,CAAC,MAAM,WAAW,GAAG;;CAE1B,CAAC,IAAI,EAAE,CAAA;AAER,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAA;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,EAAuB,EAAE,EAAE,CACtE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAGvB,MAAM,CAAC,MAAM,IAAI,GAAS,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAiB,EAAE;IACtE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,UAAU,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,GAAG,CAAC,UAAU,EAAE,CAAA;QAChB,OAAM;IACR,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC5B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,KAAK,CAAC,CAAA;QAC3C,OAAO,UAAU,EAAE,CAAA;IACrB,CAAC;IAED,MAAM,EAAE,EAAE,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,GAAG,EAAE;IACtB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IAClC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SACtB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;SACpB,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;AACH,CAAC,CAAA;AAED,OAAO,OAAO,MAAM,oBAAoB,CAAA;AACxC,aAAa,CAAC,GAAG,OAAO,CAAC,CAAA;AAEzB,OAAO,MAAM,MAAM,mBAAmB,CAAA;AACtC,aAAa,CAAC,GAAG,MAAM,CAAC,CAAA;AAExB,OAAO,KAAK,MAAM,kBAAkB,CAAA;AACpC,aAAa,CAAC,GAAG,KAAK,CAAC,CAAA"}

package/dist/help/topic/build.d.ts

@@ -0,0 +1,2 @@
+declare const _default: readonly ["build", () => Promise<void>];
+export default _default;

package/dist/help/topic/build.js

@@ -0,0 +1,7 @@
+export default [
+    "build",
+    async () => {
+        console.log("TBD");
+    },
+];
+//# sourceMappingURL=build.js.map

package/dist/help/topic/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/help/topic/build.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,OAAO;IACP,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;CACO,CAAA"}

package/dist/help/topic/mod_dep.d.ts

@@ -0,0 +1,2 @@
+declare const _default: readonly ["mod dep", () => Promise<void>];
+export default _default;

package/dist/help/topic/mod_dep.js

@@ -0,0 +1,8 @@
+import { Description } from "../../mod/dependency/main.js";
+export default [
+    "mod dep",
+    async () => {
+        console.log(Description);
+    },
+];
+//# sourceMappingURL=mod_dep.js.map

package/dist/help/topic/mod_dep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod_dep.js","sourceRoot":"","sources":["../../../src/help/topic/mod_dep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE1D,eAAe;IACb,SAAS;IACT,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC1B,CAAC;CACO,CAAA"}

package/dist/help/topic/mod_dl.d.ts

@@ -0,0 +1,2 @@
+declare const _default: readonly ["mod dl", () => Promise<void>];
+export default _default;

package/dist/help/topic/mod_dl.js

@@ -0,0 +1,25 @@
+import { Description } from "../../mod/download/main.js";
+export default [
+    "mod dl",
+    async () => {
+        console.log(Description);
+        console.log(`
+    kdsl mod download
+    kdsl mod dl
+
+Without arguments, downloads all dependencies and validates against the avail-
+able checksums.
+
+    kdsl mod dl example.com/module
+
+Downloads all dependencies that match the particular target (can match multi-
+ple).
+
+    kdsl mod dl example.com/module@v1.2.3
+
+Downloads a specific dependency, whether or not it is registered in the mani-
+fest.
+`.trimEnd());
+    },
+];
+//# sourceMappingURL=mod_dl.js.map

package/dist/help/topic/mod_dl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod_dl.js","sourceRoot":"","sources":["../../../src/help/topic/mod_dl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAExD,eAAe;IACb,QAAQ;IACR,KAAK,IAAI,EAAE;QACT,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxB,OAAO,CAAC,GAAG,CACT;;;;;;;;;;;;;;;;CAgBL,CAAC,OAAO,EAAE,CACN,CAAA;IACH,CAAC;CACO,CAAA"}

package/dist/index/create/main.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "@commander-js/extra-typings";
+import { ILogLayer } from "loglayer";
+import { CommanderActionParams } from "../../util.js";
+export declare const Description: string;
+declare const _default: {
+    Register: typeof Register;
+};
+export default _default;
+export declare function Register(cmd: Command, log: ILogLayer): Command<[], {
+    module?: string | undefined;
+    index?: string | undefined;
+}, {}>;
+type Exec = CommanderActionParams<ReturnType<typeof Register>>;
+export declare function Action(log: ILogLayer): Exec;