@kumori/kdsl 0.0.14 → 0.0.16

package/dist/build/helpers/connector.d.ts

@@ -0,0 +1,13 @@
+import { Service, Connection } from "@kumori/kdsl-lsp/language/builtin/lib/kumori/service.js";
+import { Connector } from "../deployment_spec.js";
+import { SolutionJSONContext } from "./deployment.js";
+/**
+ * Converts a service connection definition into the solution JSON format.
+ * This translates the "connector" section of a service into the "connector" section
+ * of the solution JSON.
+ * @param ctx The solution JSON context.
+ * @param service The service to convert.
+ * @param cnx The connection to convert.
+ * @returns The connector representation of the connection.
+ */
+export declare function ServiceConnectionToSolutionJSON(ctx: SolutionJSONContext, service: Service, cnx: Connection): Connector;

package/dist/build/helpers/connector.js

@@ -0,0 +1,189 @@
+import { LoadBalancerName, FullConnectorName } from "@kumori/kdsl-lsp/language/builtin/lib/kumori/service.js";
+import { isService } from "./deployment.js";
+import { ReferenceUpdater } from "./utils.js";
+/**
+ * Resolves and updates a Reference object for a given component reference.
+ * @param ctx The solution JSON context.
+ * @param componentRef The component reference to resolve.
+ * @param ref The Reference object to update.
+ * @param isServiceKind Whether the reference should be marked as a service.
+ */
+// I don't like to disable eslint rules, but I'll let it be here
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function resolveReference(ctx, componentRef, ref, isServiceKind) {
+    const mod = ctx.svcs.shared.references.KumoriModules;
+    const modifiers = ReferenceUpdater(mod, ctx.nodes.get(componentRef));
+    for (const m of modifiers) {
+        m(ref);
+    }
+    if (isServiceKind) {
+        ref.kind = "service";
+    }
+    return ref;
+}
+/**
+ * Checks if a server is already present in the servers array.
+ * Deduplication is done by comparing JSON string representations.
+ * @param servers Array of existing servers.
+ * @param candidate The candidate server to check.
+ * @returns True if duplicate, false otherwise.
+ */
+function isServerDuplicate(servers, candidate) {
+    return servers.some(s => JSON.stringify(s) === JSON.stringify(candidate));
+}
+/**
+ * Builds a connector client object.
+ * @param target The role of the client.
+ * @param channel The channel of the client.
+ * @returns A ConnectorClient object.
+ */
+function buildClient(target, channel) {
+    return { role: target, channel };
+}
+/**
+ * Builds a connector server object.
+ * @param meta The meta information for the server.
+ * @param role The role of the server.
+ * @param channel The channel of the server.
+ * @returns A ConnectorServer object.
+ */
+// I don't like to disable eslint rules, but I'll let it be here
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function buildServer(meta, role, channel) {
+    return {
+        meta,
+        links: [{ role, channel }]
+    };
+}
+/**
+ * Converts a service connection definition into the solution JSON format.
+ * This translates the "connector" section of a service into the "connector" section
+ * of the solution JSON.
+ * @param ctx The solution JSON context.
+ * @param service The service to convert.
+ * @param cnx The connection to convert.
+ * @returns The connector representation of the connection.
+ */
+export function ServiceConnectionToSolutionJSON(ctx, service, cnx) {
+    const ref = {
+        version: [0, 0, 0],
+        kind: "component",
+        domain: "unknown",
+        module: "unknown",
+        name: "unknown",
+    };
+    if (cnx.$type === LoadBalancerName) {
+        cnx = cnx;
+        const servers = [];
+        const clients = [];
+        // The "from" and "to" arrays define multiple connections.
+        // We accumulate all clients and servers and then return a single connector.
+        if ("from" in cnx.value && Array.isArray(cnx.value.from) && "to" in cnx.value && Array.isArray(cnx.value.to)) {
+            for (const fromCnx of cnx.value.from) {
+                // Each "from" defines a client
+                clients.push(buildClient(fromCnx.target, fromCnx.channel));
+                // Each "to" defines a server for this client
+                for (const toCnx of cnx.value.to) {
+                    const componentRef = service.role[toCnx.target == "self" ? fromCnx.target : toCnx.target];
+                    const isServiceKind = isService(componentRef.artifact) || toCnx.target == "self";
+                    resolveReference(ctx, componentRef, ref, isServiceKind);
+                    const meta = cnx.value.meta ?? [{
+                            auto: {
+                                channel: toCnx.target !== "self" ? toCnx.target + "." + toCnx.channel : toCnx.channel,
+                                compRef: ref,
+                                roleName: toCnx.target == "self" ? fromCnx.target : toCnx.target,
+                            },
+                            user: {}
+                        }];
+                    const server = buildServer(meta, toCnx.target, toCnx.channel);
+                    // We don't want duplicates
+                    if (!isServerDuplicate(servers, server)) {
+                        servers.push(server);
+                    }
+                }
+            }
+        }
+        else if ("from" in cnx.value && !Array.isArray(cnx.value.from) && !Array.isArray(cnx.value.to)) {
+            const fromCnx = cnx.value.from;
+            const toCnx = cnx.value.to;
+            // Each "from" defines a client
+            clients.push(buildClient(fromCnx.target, fromCnx.channel));
+            // Each "to" defines a server for this client
+            const componentRef = service.role[toCnx.target == "self" ? fromCnx.target : toCnx.target];
+            const isServiceKind = isService(componentRef.artifact) || toCnx.target == "self";
+            resolveReference(ctx, componentRef, ref, isServiceKind);
+            const meta = cnx.value.meta ?? [{
+                    auto: {
+                        channel: toCnx.target !== "self" ? toCnx.target + "." + toCnx.channel : toCnx.channel,
+                        compRef: ref,
+                        roleName: toCnx.target == "self" ? fromCnx.target : toCnx.target,
+                    },
+                    user: {}
+                }];
+            const server = buildServer(meta, toCnx.target, toCnx.channel);
+            // We don't want duplicates
+            if (!isServerDuplicate(servers, server)) {
+                servers.push(server);
+            }
+        }
+        return {
+            kind: "lb",
+            clients: clients,
+            servers: servers
+        };
+    }
+    if (cnx.$type === FullConnectorName) {
+        cnx = cnx;
+        const servers = [];
+        const clients = [];
+        // The "from" and "to" arrays define multiple connections.
+        // We accumulate all clients and servers and then return a single connector.
+        // The "FullConnector" connector can have either "from" and "to" arrays or single "target" and "channel" properties.
+        if ("from" in cnx.value && Array.isArray(cnx.value.from) && "to" in cnx.value && Array.isArray(cnx.value.to)) {
+            // Each "from" defines a client
+            for (const fromCnx of cnx.value.from) {
+                clients.push(buildClient(fromCnx.target, fromCnx.channel));
+                // Each "to" defines a server for this client
+                for (const toCnx of cnx.value.to) {
+                    const componentRef = service.role[toCnx.target == "self" ? fromCnx.target : toCnx.target];
+                    const isServiceKind = isService(componentRef.artifact);
+                    resolveReference(ctx, componentRef, ref, isServiceKind);
+                    const meta = cnx.value.meta ?? [{
+                            auto: {
+                                channel: toCnx.target !== "self" ? toCnx.target + "." + toCnx.channel : toCnx.channel,
+                                compRef: ref,
+                                roleName: toCnx.target == "self" ? fromCnx.target : toCnx.target,
+                            },
+                            user: {}
+                        }];
+                    const server = buildServer(meta, toCnx.target, toCnx.channel);
+                    // We don't want duplicates
+                    if (!isServerDuplicate(servers, server)) {
+                        servers.push(server);
+                    }
+                }
+            }
+        }
+        else if ("target" in cnx.value && "channel" in cnx.value) {
+            const componentRef = service.role[cnx.value.target];
+            const isServiceKind = isService(componentRef.artifact);
+            resolveReference(ctx, componentRef, ref, isServiceKind);
+            const meta = cnx.value.meta ?? [{
+                    auto: {
+                        channel: cnx.value.channel,
+                        compRef: ref,
+                        roleName: cnx.value.target,
+                    },
+                    user: {}
+                }];
+            servers.push(buildServer(meta, cnx.value.target, cnx.value.channel));
+        }
+        return {
+            kind: "full",
+            clients: clients,
+            servers: servers,
+        };
+    }
+    throw new Error(`unknown connection type '${cnx.$type}'`);
+}
+//# sourceMappingURL=connector.js.map

package/dist/build/helpers/connector.js.map

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

package/dist/build/helpers/deployment.d.ts

@@ -0,0 +1,326 @@
+import { Builtin } from "@kumori/kdsl-lsp/language/builtin/lib/kumori/builtin.js";
+import { Component } from "@kumori/kdsl-lsp/language/builtin/lib/kumori/component.js";
+import { Deployment } from "@kumori/kdsl-lsp/language/builtin/lib/kumori/deployment.js";
+import { Service } from "@kumori/kdsl-lsp/language/builtin/lib/kumori/service.js";
+import { KumoriServices } from "@kumori/kdsl-lsp/language/kumori.js";
+import { AstNode } from "langium";
+import { KukuSolutionSpec, V3DeploymentSpec } from "../deployment_spec.js";
+export interface SolutionJSONContext {
+    svcs: KumoriServices;
+    root: KukuSolutionSpec;
+    nodes: Map<object, AstNode>;
+    path: string[];
+}
+export declare const CtxId: (ctx: SolutionJSONContext) => string;
+export declare const CtxParentId: (ctx: SolutionJSONContext) => string;
+export declare const WithPath: (ctx: SolutionJSONContext, name: string) => SolutionJSONContext;
+export declare const AddDeployment: (ctx: SolutionJSONContext, dep: V3DeploymentSpec) => {
+    name: string;
+    meta?: any;
+    up?: string | undefined;
+    artifact?: {
+        ref: {
+            name: string;
+            kind: "deployment" | "service" | "component";
+            domain: string;
+            version: number[];
+            module?: string | undefined;
+            prerelease?: string | undefined;
+            buildmetadata?: string | undefined;
+        };
+        spec: number[];
+        description: {
+            builtin: boolean;
+            config?: {
+                resilience: number;
+                parameter?: Record<string, any> | undefined;
+                resource?: Record<string, {
+                    certificate?: string | undefined;
+                    ca?: string | undefined;
+                    domain?: string | undefined;
+                    port?: string | undefined;
+                    secret?: string | undefined;
+                    volume?: any;
+                }> | undefined;
+                scale?: ({
+                    qos?: any;
+                    hsize?: number | undefined;
+                } & {
+                    detail?: Record<string, ({
+                        qos?: any;
+                        hsize?: number | undefined;
+                    } & /*elided*/ any) | undefined>;
+                }) | undefined;
+            } | undefined;
+            srv?: {
+                duplex?: Record<string, {
+                    inherited: boolean;
+                    protocol: "http" | "tcp" | "udp" | "grpc";
+                    port?: number | undefined;
+                    portnum?: number | undefined;
+                }> | undefined;
+                client?: Record<string, {
+                    inherited: boolean;
+                    protocol: "http" | "tcp" | "udp" | "grpc";
+                    port?: number | undefined;
+                    portnum?: number | undefined;
+                }> | undefined;
+                server?: Record<string, {
+                    inherited: boolean;
+                    protocol: "http" | "tcp" | "udp" | "grpc";
+                    port?: number | undefined;
+                    portnum?: number | undefined;
+                }> | undefined;
+            } | undefined;
+            role?: Record<string, {
+                name: string;
+                artifact: {
+                    ref: {
+                        name: string;
+                        kind: "deployment" | "service" | "component";
+                        domain: string;
+                        version: number[];
+                        module?: string | undefined;
+                        prerelease?: string | undefined;
+                        buildmetadata?: string | undefined;
+                    };
+                    spec: number[];
+                    description?: {
+                        builtin: boolean;
+                        size: {
+                            mincpu: {
+                                kind: "storage" | "cpu" | "ram" | "bandwidth";
+                                size: number;
+                                unit: string;
+                            };
+                            bandwidth: {
+                                kind: "storage" | "cpu" | "ram" | "bandwidth";
+                                size: number;
+                                unit: string;
+                            };
+                            minbandwidth: number;
+                        };
+                        config?: {
+                            resilience: number;
+                            parameter?: Record<string, any> | undefined;
+                            resource?: Record<string, {
+                                certificate?: string | undefined;
+                                ca?: string | undefined;
+                                domain?: string | undefined;
+                                port?: string | undefined;
+                                secret?: string | undefined;
+                                volume?: any;
+                            }> | undefined;
+                            scale?: ({
+                                qos?: any;
+                                hsize?: number | undefined;
+                            } & {
+                                detail?: Record<string, ({
+                                    qos?: any;
+                                    hsize?: number | undefined;
+                                } & /*elided*/ any) | undefined>;
+                            }) | undefined;
+                        } | undefined;
+                        srv?: {
+                            duplex?: Record<string, {
+                                inherited: boolean;
+                                protocol: "http" | "tcp" | "udp" | "grpc";
+                                port?: number | undefined;
+                                portnum?: number | undefined;
+                            }> | undefined;
+                            client?: Record<string, {
+                                inherited: boolean;
+                                protocol: "http" | "tcp" | "udp" | "grpc";
+                                port?: number | undefined;
+                                portnum?: number | undefined;
+                            }> | undefined;
+                            server?: Record<string, {
+                                inherited: boolean;
+                                protocol: "http" | "tcp" | "udp" | "grpc";
+                                port?: number | undefined;
+                                portnum?: number | undefined;
+                            }> | undefined;
+                        } | undefined;
+                        profile?: {
+                            threadability: string;
+                            iopsintensive: boolean;
+                        } | undefined;
+                        code?: Record<string, {
+                            name: string;
+                            image: {
+                                tag: string;
+                                hub?: {
+                                    name: string;
+                                    secret?: string | undefined;
+                                } | undefined;
+                            };
+                            entrypoint?: string[] | undefined;
+                            cmd?: string[] | undefined;
+                            mapping?: {
+                                env?: Record<string, {
+                                    secret?: string | undefined;
+                                    port?: string | undefined;
+                                    domain?: string | undefined;
+                                    certificate?: string | undefined;
+                                    ca?: string | undefined;
+                                    value?: string | number | boolean | undefined;
+                                    enableTemplate?: boolean | undefined;
+                                }> | undefined;
+                                filesystem?: Record<string, {
+                                    data?: {
+                                        secret?: string | undefined;
+                                        port?: string | undefined;
+                                        domain?: string | undefined;
+                                        certificate?: string | undefined;
+                                        ca?: string | undefined;
+                                        value?: string | undefined;
+                                    } | undefined;
+                                    format?: "text" | "json" | "yaml" | undefined;
+                                    group?: number | undefined;
+                                    mode?: number | undefined;
+                                    path?: string | undefined;
+                                    user?: number | undefined;
+                                    rebootOnUpdate?: boolean | undefined;
+                                    volume?: string | undefined;
+                                    enableTemplate?: boolean | undefined;
+                                }> | undefined;
+                            } | undefined;
+                            size?: {
+                                cpu: {
+                                    kind: "storage" | "cpu" | "ram" | "bandwidth";
+                                    size: number;
+                                    unit: string;
+                                };
+                                mincpu: number;
+                                memory: {
+                                    kind: "storage" | "cpu" | "ram" | "bandwidth";
+                                    size: number;
+                                    unit: string;
+                                };
+                            } | undefined;
+                            user?: {
+                                userid: number;
+                                groupid: number;
+                            } | undefined;
+                            init?: boolean | undefined;
+                        }> | undefined;
+                        probe?: Record<string, {
+                            liveness?: {
+                                protocol: {
+                                    http?: {
+                                        port: number;
+                                        path: string;
+                                    } | undefined;
+                                    tcp?: {
+                                        port: number;
+                                    } | undefined;
+                                    exec?: {
+                                        path: string;
+                                    } | undefined;
+                                };
+                                startupGraceWindow?: {
+                                    unit: "attempts" | "ms";
+                                    duration: number;
+                                    probe: boolean;
+                                } | undefined;
+                                frequency?: any;
+                                timeout?: number | undefined;
+                            } | undefined;
+                            readiness?: {
+                                protocol: {
+                                    http?: {
+                                        port: number;
+                                        path: string;
+                                    } | undefined;
+                                    tcp?: {
+                                        port: number;
+                                    } | undefined;
+                                    exec?: {
+                                        path: string;
+                                    } | undefined;
+                                };
+                                frequency?: any;
+                                timeout?: number | undefined;
+                            } | undefined;
+                            pmetrics?: {
+                                protocol: {
+                                    http?: {
+                                        port: number;
+                                        path: string;
+                                    } | undefined;
+                                };
+                            } | undefined;
+                        }> | undefined;
+                    } | undefined;
+                };
+                config?: {
+                    resilience: number;
+                    parameter?: Record<string, any> | undefined;
+                    resource?: Record<string, {
+                        certificate?: string | undefined;
+                        ca?: string | undefined;
+                        domain?: string | undefined;
+                        port?: string | undefined;
+                        secret?: string | undefined;
+                        volume?: any;
+                    }> | undefined;
+                    scale?: ({
+                        qos?: any;
+                        hsize?: number | undefined;
+                    } & {
+                        detail?: Record<string, ({
+                            qos?: any;
+                            hsize?: number | undefined;
+                        } & /*elided*/ any) | undefined>;
+                    }) | undefined;
+                } | undefined;
+                updates?: "free" | undefined;
+                meta?: any;
+            }> | undefined;
+            connector?: Record<string, {
+                kind: "lb" | "full";
+                clients: {
+                    role: string;
+                    channel: string;
+                }[];
+                servers: {
+                    links: {
+                        role: string;
+                        channel: string;
+                    }[];
+                    meta?: any;
+                }[];
+            }> | undefined;
+        };
+    } | undefined;
+    config?: {
+        resilience: number;
+        parameter?: Record<string, any> | undefined;
+        resource?: Record<string, {
+            certificate?: string | undefined;
+            ca?: string | undefined;
+            domain?: string | undefined;
+            port?: string | undefined;
+            secret?: string | undefined;
+            volume?: any;
+        }> | undefined;
+        scale?: ({
+            qos?: any;
+            hsize?: number | undefined;
+        } & {
+            detail?: Record<string, ({
+                qos?: any;
+                hsize?: number | undefined;
+            } & /*elided*/ any) | undefined>;
+        }) | undefined;
+    } | undefined;
+};
+/**
+ * Convert a deployment artifact to a solution JSON representation.
+ * @param deployment - The deployment artifact to convert.
+ * @returns The solution JSON representation.
+ */
+export declare function DeploymentToSolutionJSON(svcs: KumoriServices, nodes: SolutionJSONContext["nodes"], deployment: Deployment): KukuSolutionSpec;
+export declare function isComponent(v: Component | Service | Builtin): v is Component;
+export declare function isService(v: Component | Service | Builtin): v is Service;
+export declare function isBuiltin(v: Component | Service | Builtin): v is Builtin;

package/dist/build/helpers/deployment.js

@@ -0,0 +1,85 @@
+import { ComponentServiceToSolutionJSON } from "./component.js";
+import { ServiceToSolutionJSON } from "./service.js";
+import { ResourceToSolutionJSON } from "./resource.js";
+import { isComponentArtifact } from "@kumori/kdsl-lsp/language/generated/ast.js";
+export const CtxId = (ctx) => ctx.path.join(".");
+export const CtxParentId = (ctx) => ctx.path.slice(0, -1).join(".");
+export const WithPath = (ctx, name) => ({ ...ctx, path: [...ctx.path, name] });
+export const AddDeployment = (ctx, dep) => ctx.root.deployments[CtxId(ctx)] = dep;
+/**
+ * Convert a deployment artifact to a solution JSON representation.
+ * @param deployment - The deployment artifact to convert.
+ * @returns The solution JSON representation.
+ */
+export function DeploymentToSolutionJSON(svcs, nodes, deployment) {
+    const root = {
+        cspec: "1.0",
+        top: deployment.name,
+        deployments: {},
+        links: [],
+    };
+    const ctx = { svcs, path: [deployment.name], root, nodes };
+    root.deployments[deployment.name] = {
+        name: deployment.name,
+        meta: deployment.meta,
+        config: {
+            parameter: deployment.config ?? {},
+            resource: Object.fromEntries(Object.entries(deployment.resource ?? {})
+                .map(([k, v]) => [k, ResourceToSolutionJSON(v)])),
+            resilience: deployment.resilience ?? 0,
+            scale: {
+                detail: (() => {
+                    if (isComponent(deployment.artifact)) {
+                        const componentArtifact = ctx.nodes.get(deployment.artifact);
+                        let componentName = "";
+                        if (componentArtifact && isComponentArtifact(componentArtifact)) {
+                            componentName = componentArtifact.name.value.$refText;
+                        }
+                        if (componentName === "") {
+                            throw new Error("Unable to determine component name for scale detail.");
+                        }
+                        return { [componentName]: { hsize: typeof deployment.scale === "number" ? deployment.scale : 1 } };
+                    }
+                    if (isService(deployment.artifact)) {
+                        const roles = Object.entries(deployment.artifact.role ?? {});
+                        return Object.fromEntries(roles.map(([roleName]) => [
+                            roleName,
+                            {
+                                hsize: (deployment.scale &&
+                                    typeof deployment.scale === "object" &&
+                                    !Array.isArray(deployment.scale) &&
+                                    roleName in deployment.scale)
+                                    ? deployment.scale[roleName]
+                                    : 1
+                            }
+                        ]));
+                    }
+                    return {};
+                })()
+            },
+        },
+        artifact: (() => {
+            if (isComponent(deployment.artifact)) {
+                return ComponentServiceToSolutionJSON(ctx, deployment.artifact, deployment.scale);
+            }
+            if (isService(deployment.artifact)) {
+                return ServiceToSolutionJSON(ctx, deployment.artifact, deployment.scale);
+            }
+            if (isBuiltin(deployment.artifact)) {
+                throw new Error("not implemented: handle builtin");
+            }
+            throw new Error("unknown artifact");
+        })()
+    };
+    return root;
+}
+export function isComponent(v) {
+    return "size" in v;
+}
+export function isService(v) {
+    return !(isComponent(v) || isBuiltin(v));
+}
+export function isBuiltin(v) {
+    return "id" in v;
+}
+//# sourceMappingURL=deployment.js.map

package/dist/build/helpers/deployment.js.map

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