@kumori/kdsl 0.0.14 → 0.0.16

package/dist/lib/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../src/lib/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAgBzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA6B;IAE7B,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAA;IAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,GAAG,CAAA;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAA;IAE7B,OAAO,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;AAC7D,CAAC"}

package/dist/lib/index-cmd.d.ts

@@ -0,0 +1,54 @@
+import { LibraryOptions, LibraryResult } from "./types.js";
+export interface IndexCreateOptions extends LibraryOptions {
+    /**
+     * Path to the module to generate the index entry for.
+     * Can be either a relative or absolute path.
+     * Defaults to current directory.
+     */
+    module?: string;
+    /**
+     * Path to the index file to append the new entry to.
+     * Can be either a relative or absolute path.
+     * If not provided, the entry will be returned instead of written.
+     */
+    indexFile?: string;
+    /**
+     * If true and parameters are missing, prompt interactively using @inquirer/prompts.
+     * If false and parameters are missing, return error.
+     * Defaults to false (non-interactive).
+     *
+     * NOTE: Interactive mode requires a TTY environment.
+     */
+    interactive?: boolean;
+}
+/**
+ * Create an index file entry for a Kumori module.
+ *
+ * This command generates a new index file entry for the current module or a specified
+ * module. The entry includes module metadata, artifacts, and JSON schemas.
+ *
+ * In non-interactive mode, you can provide all necessary parameters via options.
+ * In interactive mode (interactive: true), missing parameters will be prompted.
+ *
+ * @param options - Index create options
+ * @returns Result with index entry object on success, or string[] of errors
+ *
+ * @example Non-interactive usage (programmatic)
+ * ```typescript
+ * const result = await indexCreate({
+ *   services,
+ *   module: './my-module',
+ *   indexFile: './index.json',
+ *   interactive: false
+ * })
+ * ```
+ *
+ * @example Interactive usage (CLI-like)
+ * ```typescript
+ * const result = await indexCreate({
+ *   services,
+ *   interactive: true  // Will prompt for missing info
+ * })
+ * ```
+ */
+export declare function indexCreate(options: IndexCreateOptions): Promise<LibraryResult<void>>;

package/dist/lib/index-cmd.js

@@ -0,0 +1,60 @@
+import { getLogger } from "./logger.js";
+import { Ok, Err } from "@kumori/kdsl-lsp/util/result.js";
+/**
+ * Create an index file entry for a Kumori module.
+ *
+ * This command generates a new index file entry for the current module or a specified
+ * module. The entry includes module metadata, artifacts, and JSON schemas.
+ *
+ * In non-interactive mode, you can provide all necessary parameters via options.
+ * In interactive mode (interactive: true), missing parameters will be prompted.
+ *
+ * @param options - Index create options
+ * @returns Result with index entry object on success, or string[] of errors
+ *
+ * @example Non-interactive usage (programmatic)
+ * ```typescript
+ * const result = await indexCreate({
+ *   services,
+ *   module: './my-module',
+ *   indexFile: './index.json',
+ *   interactive: false
+ * })
+ * ```
+ *
+ * @example Interactive usage (CLI-like)
+ * ```typescript
+ * const result = await indexCreate({
+ *   services,
+ *   interactive: true  // Will prompt for missing info
+ * })
+ * ```
+ */
+export async function indexCreate(options) {
+    const log = getLogger(options.logger);
+    // For now, we'll use the existing implementation from the CLI
+    // This command is heavily interactive, so we'll delegate to the CLI action
+    if (!options.interactive) {
+        return Err([
+            "Index create command requires interactive mode. " +
+                "Set interactive: true to use this command programmatically with prompts, " +
+                "or use the CLI directly: kdsl index create",
+        ]);
+    }
+    // Import the action and run it
+    try {
+        const { Action } = await import("../index/create/main.js");
+        const action = Action(log);
+        // The Action function takes (options, command) but we cast to bypass type checking
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await action({
+            module: options.module ?? undefined,
+            index: options.indexFile ?? undefined,
+        });
+        return Ok(undefined);
+    }
+    catch (err) {
+        return Err([String(err)]);
+    }
+}
+//# sourceMappingURL=index-cmd.js.map

package/dist/lib/index-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/lib/index-cmd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAA;AA2BzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA2B;IAE3B,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAErC,8DAA8D;IAC9D,2EAA2E;IAC3E,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;YACT,kDAAkD;gBAChD,2EAA2E;gBAC3E,4CAA4C;SAC/C,CAAC,CAAA;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAE1B,mFAAmF;QACnF,8DAA8D;QAC9D,MAAO,MAAc,CAAC;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;YACnC,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;SACtC,CAAC,CAAA;QAEF,OAAO,EAAE,CAAO,SAAS,CAAC,CAAA;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @kumori/kdsl - Kumori DSL Library
+ *
+ * Programmatic access to Kumori DSL commands.
+ * For CLI usage, use the `kdsl` command instead.
+ *
+ * @example
+ * ```typescript
+ * import { createKumoriServices } from '@kumori/kdsl-lsp/language/kumori.js'
+ * import { NodeFileSystem } from 'langium/node'
+ * import { build, check, moduleInit } from '@kumori/kdsl'
+ *
+ * const services = createKumoriServices(NodeFileSystem).Kumori
+ *
+ * // Build a package
+ * const buildResult = await build({
+ *   services,
+ *   package: 'my-package',
+ *   directory: '.'
+ * })
+ *
+ * if (buildResult.ok) {
+ *   console.log('Build succeeded!')
+ * } else {
+ *   console.error('Build failed:', buildResult.err)
+ * }
+ *
+ * // Check a module
+ * const checkResult = await check({
+ *   services,
+ *   directory: './my-module'
+ * })
+ *
+ * // Initialize a new module
+ * const initResult = await moduleInit({
+ *   name: 'kumori.systems/my-module',
+ *   version: '1.0.0'
+ * })
+ * ```
+ */
+export { build } from "./build.js";
+export type { BuildOptions } from "./build.js";
+export { generateDeployment } from "./deployment.js";
+export type { DeploymentGenOptions } from "./deployment.js";
+export { check } from "./check.js";
+export type { CheckOptions } from "./check.js";
+export { clean } from "./clean.js";
+export type { CleanOptions } from "./clean.js";
+export { createKumoriServices } from "@kumori/kdsl-lsp/language/kumori.js";
+export type {} from "@kumori/kdsl-lsp/language/kumori.js";
+export { moduleInit, moduleDependency, moduleDownload, moduleUpdate, moduleChecksum, moduleSchemaGet, } from "./mod.js";
+export type { ModuleInitOptions, ModuleDependencyOptions, ModuleDownloadOptions, ModuleUpdateOptions, ModuleChecksumOptions, ModuleSchemaGetOptions, } from "./mod.js";
+export { registryAdd, registryList, registryRemove } from "./registry.js";
+export type { RegistryAddOptions, RegistryListOptions, RegistryRemoveOptions, } from "./registry.js";
+export { indexCreate } from "./index-cmd.js";
+export type { IndexCreateOptions } from "./index-cmd.js";
+export type { LibraryOptions, LibraryResult } from "./types.js";
+export { createSilentLogger, getLogger } from "./logger.js";

package/dist/lib/index.js

@@ -0,0 +1,54 @@
+/**
+ * @kumori/kdsl - Kumori DSL Library
+ *
+ * Programmatic access to Kumori DSL commands.
+ * For CLI usage, use the `kdsl` command instead.
+ *
+ * @example
+ * ```typescript
+ * import { createKumoriServices } from '@kumori/kdsl-lsp/language/kumori.js'
+ * import { NodeFileSystem } from 'langium/node'
+ * import { build, check, moduleInit } from '@kumori/kdsl'
+ *
+ * const services = createKumoriServices(NodeFileSystem).Kumori
+ *
+ * // Build a package
+ * const buildResult = await build({
+ *   services,
+ *   package: 'my-package',
+ *   directory: '.'
+ * })
+ *
+ * if (buildResult.ok) {
+ *   console.log('Build succeeded!')
+ * } else {
+ *   console.error('Build failed:', buildResult.err)
+ * }
+ *
+ * // Check a module
+ * const checkResult = await check({
+ *   services,
+ *   directory: './my-module'
+ * })
+ *
+ * // Initialize a new module
+ * const initResult = await moduleInit({
+ *   name: 'kumori.systems/my-module',
+ *   version: '1.0.0'
+ * })
+ * ```
+ */
+// Core command exports
+export { build } from "./build.js";
+export { generateDeployment } from "./deployment.js";
+export { check } from "./check.js";
+export { clean } from "./clean.js";
+export { createKumoriServices } from "@kumori/kdsl-lsp/language/kumori.js";
+// Module command exports
+export { moduleInit, moduleDependency, moduleDownload, moduleUpdate, moduleChecksum, moduleSchemaGet, } from "./mod.js";
+// Registry command exports
+export { registryAdd, registryList, registryRemove } from "./registry.js";
+// Index command exports
+export { indexCreate } from "./index-cmd.js";
+export { createSilentLogger, getLogger } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,uBAAuB;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAG1E,yBAAyB;AACzB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAA;AAUjB,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAOzE,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/lib/io/lib.kumori

@@ -0,0 +1,5 @@
+package io
+
+library
+
+func Open(path string, args? struct open[]) string

package/dist/lib/kumori/builtin/httpinbound.h.kumori

@@ -0,0 +1,27 @@
+package builtin
+
+import "kumori"
+
+builtin HTTPInbound {
+    id {
+        name    "inbound"
+        kind    "service"
+        domain  "kumori.systems"
+        module  "builtins/inbound"
+        version "1.3.0"
+    }
+    
+    srv {
+        client { inbound "http" }
+    }
+    
+    config {
+        type "https"
+    }
+    
+    resource {
+        servercert:     kumori.Certificate
+        serverdomain:   kumori.Domain
+        clientcertca?:  kumori.CA
+    }
+}

package/dist/lib/kumori/builtin/tcpinbound.h.kumori

@@ -0,0 +1,25 @@
+package builtin
+
+import "kumori"
+
+builtin TCPInbound {
+    id {
+        name    "inbound"
+        kind    "service"
+        domain  "kumori.systems"
+        module  "builtins/inbound"
+        version "1.3.0"
+    }
+    
+    srv {
+        client { inbound "tcp" }
+    }
+    
+    config {
+        type "tcp"
+    }
+    
+    resource {
+        port: kumori.Port
+    }
+}

package/dist/lib/kumori/builtin.kumori

@@ -0,0 +1,18 @@
+package kumori
+
+library
+
+alias builtin struct {
+    id          Ref
+    srv         Links
+    config      struct open[]
+    resource    struct open[Resource]
+}
+
+alias Ref struct {
+    name    string
+    kind    "service" | "component"
+    domain  string
+    module  string
+    version string
+}

package/dist/lib/kumori/component.kumori

@@ -0,0 +1,120 @@
+package kumori
+
+library
+
+alias ComponentInterface struct {
+    srv?         Links
+    config?      struct open[]
+    resource?    struct open[Resource]
+}
+
+alias component struct {
+    srv?         Links
+    config?      struct open[]
+    resource?    struct open[Resource]
+    
+    code?   struct open[Code]
+    init?   []struct {
+        cmd?     []string
+        image    Image
+        entrypoint? []string
+        
+        size struct {
+            memory  RAMSized
+            cpu     CPUSized
+            mincpu? CPUSized
+        }
+
+        env? struct open[Env]
+        fs?  struct open[File]
+    }
+    size   struct {
+        bandwidth       BandwidthSized
+        minbandwidth?   BandwidthSized
+        mincpu          CPUSized
+    }
+    probe?  struct open[Probes]
+}
+
+alias Code struct {
+    cmd?     []string
+    image    Image
+    entrypoint? []string
+    
+    size struct {
+        memory  RAMSized
+        cpu     CPUSized
+        mincpu? CPUSized
+    }
+
+    env? struct open[Env]
+    fs?  struct open[File]
+}
+
+alias Image string | struct { hub: struct { name: string, secret?: string }, tag: string }
+
+alias File string | FSMap | struct { volume: string }
+alias FSMap FSData | FSSecret | FSPort | FSDomain | FSCertificate | FSCa
+
+alias AllowedFormat "text" | "json" | "yaml" | "flatdict"
+
+alias FSData struct { data: string, mode?: number, format?: AllowedFormat }
+alias FSSecret struct { secret: string, mode?: number, format?: AllowedFormat }
+alias FSPort struct { port: string, mode?: number, format?: AllowedFormat }
+alias FSDomain struct { domain: string, mode?: number, format?: AllowedFormat }
+alias FSCertificate struct { certificate: string, mode?: number, format?: AllowedFormat }
+alias FSCa struct { ca: string, mode?: number, format?: AllowedFormat }
+
+alias Env string | bool | number | struct { secret: string }
+
+alias Probes struct {
+    liveness?   LivenessProbeAttributes
+    readiness? ReadinessProbeAttributes
+    pmetrics? PrometheusMetricsProbeAttributes
+}
+
+alias LivenessProbeAttributes struct {
+    protocol            ProbeProtocol
+    startupGraceWindow? StartupGraceWindow
+    frequency?          any
+    timeout?            number
+}
+
+alias ReadinessProbeAttributes struct {
+    protocol    ProbeProtocol
+    frequency?  any
+    timeout?    number
+}
+
+alias PrometheusMetricsProbeAttributes struct {
+    protocol HTTPOnlyProbeProtocol
+}
+
+alias ProbeProtocol struct {
+    http? HTTPProbeProtocol
+    tcp?  TCPProbeProtocol
+    exec? ExecProbeProtocol
+}
+
+alias HTTPOnlyProbeProtocol struct {
+    http HTTPProbeProtocol
+}
+
+alias HTTPProbeProtocol struct {
+    port number
+    path string
+}
+
+alias TCPProbeProtocol struct {
+    port number
+}
+
+alias ExecProbeProtocol struct {
+    path string
+}
+
+alias StartupGraceWindow struct {
+    unit     "ms" | "attempt"
+    duration number
+    probe    bool
+}

package/dist/lib/kumori/deployment.kumori

@@ -0,0 +1,16 @@
+package kumori
+
+library
+
+alias deployment struct {
+    name        string
+    artifact    any
+    resilience? number
+    
+    scale?      ScaleSpec
+    config?     struct open[]
+    resource?   struct open[Resource]
+    meta?       struct open[]
+}
+
+alias ScaleSpec struct open[] | number

package/dist/lib/kumori/resource.kumori

@@ -0,0 +1,25 @@
+package kumori
+
+library
+
+alias Resource      Volume | CA | Certificate | Secret | Domain | Port
+
+type CA             string
+type Certificate    string
+type Secret         string
+type Domain         string
+type Port           string
+
+alias Volume        Registered | InlineVolume | DeprecatedVolume
+alias InlineVolume  NonReplicated | Persisted | Volatile 
+
+type Registered     string
+type NonReplicated  StorageSized
+type Persisted      StorageSized
+type Volatile       StorageSized
+
+// NOTE: These are here to retain backwards compatibility.
+//       **Do not use.** Will be removed in the future.
+alias DeprecatedVolume     Ephemeral | Persistent
+type Ephemeral             StorageSized
+type Persistent            string

package/dist/lib/kumori/service.kumori

@@ -0,0 +1,49 @@
+package kumori
+
+library
+
+alias ServiceInterface struct {
+    srv?         Links
+    config?      struct open[]
+    resource?    struct open[Resource]
+}
+
+alias service struct {
+    srv?         Links
+    config?      struct open[]
+    resource?    struct open[Resource]
+
+    role?    struct open[Role]
+    connect? struct open[Connection]
+}
+
+alias Role struct {
+    artifact     any // TODO: service, component or builtin
+    config?      struct open[]
+    resource?    struct open[Resource]
+    meta?        struct open[]
+}
+
+alias Connection LoadBalancer | FullConnector
+
+type LoadBalancer struct {
+    from struct { target string, channel string } | []struct { target string, channel string }
+    to struct { target string, channel string } | []struct { target string, channel string }
+
+    meta? any
+}
+
+type FullConnector ReducedFullConnector | CompleteFullConnector
+
+alias ReducedFullConnector struct {
+    target string
+    channel string
+    meta? any
+}
+
+alias CompleteFullConnector struct {
+    from struct { target string, channel string } | []struct { target string, channel string }
+    to struct { target string, channel string } | []struct { target string, channel string }
+
+    meta? any
+}

package/dist/lib/kumori/shared.kumori

@@ -0,0 +1,11 @@
+library
+
+alias Links struct {
+    client? struct open[Client]
+    server? struct open[Server]
+    duplex? struct open[Server]
+}
+
+alias Channel "udp" | "tcp" | "http" | "grpc"
+alias Client Channel
+alias Server Channel | struct { protocol Channel, port number }

package/dist/lib/kumori/sized.kumori

@@ -0,0 +1,25 @@
+library
+
+alias StorageUnit "k" | "M" | "G" | "T" | "P" | "E" | "Ki" | "Mi" | "Gi" | "Ti" | "Pi" | "Ei"
+alias StorageSized struct {
+    size number
+    unit StorageUnit
+}
+
+alias CPUUnit "m"
+alias CPUSized struct {
+    size number
+    unit CPUUnit
+}
+
+alias RAMUnit "G" | "M" | "Gi" | "Mi"
+alias RAMSized struct {
+    size number
+    unit RAMUnit
+}
+
+alias BandwidthUnit "G" | "M" | "Gi" | "Mi"
+alias BandwidthSized struct {
+    size number
+    unit BandwidthUnit
+}

package/dist/lib/logger.d.ts

@@ -0,0 +1,10 @@
+import { ILogLayer } from "loglayer";
+/**
+ * Creates a silent logger that discards all output.
+ * Used as default when no logger is provided to library functions.
+ */
+export declare function createSilentLogger(): ILogLayer;
+/**
+ * Gets a logger from options or returns silent logger.
+ */
+export declare function getLogger(logger?: ILogLayer): ILogLayer;

package/dist/lib/logger.js

@@ -0,0 +1,23 @@
+import { LogLayer } from "loglayer";
+/**
+ * Creates a silent logger that discards all output.
+ * Used as default when no logger is provided to library functions.
+ */
+export function createSilentLogger() {
+    // Create a silent logger using a no-op transport
+    const noopTransport = {
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return new LogLayer({ transport: noopTransport });
+}
+/**
+ * Gets a logger from options or returns silent logger.
+ */
+export function getLogger(logger) {
+    return logger ?? createSilentLogger();
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE9C;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,iDAAiD;IACjD,MAAM,aAAa,GAAG;QACpB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;KAChB,CAAA;IAED,8DAA8D;IAC9D,OAAO,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,aAAoB,EAAE,CAAC,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAkB;IAC1C,OAAO,MAAM,IAAI,kBAAkB,EAAE,CAAA;AACvC,CAAC"}