actor-ts 0.9.0

package/dist/config/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,SAAS,EACT,aAAa,EACb,UAAU,EACV,oBAAoB,EAErB,MAAM,kBAAkB,CAAC;AAI1B;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IACG,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAzC,OAAO;IAIP,MAAM,CAAC,KAAK,IAAI,MAAM;IAEtB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAK1C,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKtC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAQvC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM;IAe9C,oEAAoE;IACpE,OAAO,CAAC,MAAM,CAAC,eAAe,CAAuB;IACrD,MAAM,CAAC,aAAa,IAAI,MAAM;IAQ9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWjC,gCAAgC;IAChC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOjC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO9B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAUrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAMpC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAMrC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM/B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAInC,wDAAwD;IACxD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI9B,2FAA2F;IAC3F,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU5B,wDAAwD;IACxD,MAAM,IAAI,YAAY;IAMtB,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,YAAY;CAKrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAED,kDAAkD;AAClD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AA2BD,iFAAiF;AACjF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/Config.js

@@ -0,0 +1,240 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseDuration } from './Duration.js';
+import { deepMerge, isPlainObject, parseHocon, resolveSubstitutions, stripUndefined, } from './HoconParser.js';
+import { REFERENCE_CONF } from './reference.js';
+import { parseSize } from './Size.js';
+/**
+ * Immutable configuration tree loaded from HOCON files and/or code
+ * overrides.  All accessors throw `ConfigError` on missing or
+ * incorrectly-typed paths; `hasPath` lets callers probe beforehand.
+ *
+ *  Primary entry points:
+ *  - `Config.load()` — merge reference.conf + application.conf + env.
+ *  - `Config.parseString(s)` — parse an inline HOCON snippet.
+ *  - `Config.parseFile(path)` — parse a file.
+ *  - `Config.fromObject(obj)` — build from a plain JS object (code overrides).
+ */
+export class Config {
+    tree;
+    constructor(tree) {
+        this.tree = tree;
+    }
+    /* ------------------------------ Constructors ----------------------------- */
+    static empty() { return new Config({}); }
+    static parseString(source) {
+        const parsed = parseHocon(source);
+        return new Config(stripUndefined(resolveSubstitutions(parsed)));
+    }
+    static parseFile(path) {
+        const source = readFileSync(path, 'utf8');
+        return Config.parseString(source);
+    }
+    static fromObject(obj) {
+        if (obj === undefined || obj === null)
+            return Config.empty();
+        if (!isPlainObject(obj)) {
+            throw new ConfigError(`Config.fromObject expects a plain object, got ${typeof obj}`);
+        }
+        return new Config(cloneTree(obj));
+    }
+    /**
+     * Load the standard config chain.  Precedence (highest first):
+     *
+     *   1. `overrides` passed in code.
+     *   2. `application.conf` resolved via `appConfPath` → `process.env.ACTOR_TS_CONFIG`
+     *      → `./application.conf` in CWD.
+     *   3. `reference.conf` bundled with this package.
+     *
+     * Environment variables are consulted during substitution resolution
+     * (inside each parse step), not as a separate layer.
+     */
+    static load(options = {}) {
+        const reference = Config.loadReference();
+        const applicationPath = options.appConfPath
+            ?? (typeof process !== 'undefined' ? process.env.ACTOR_TS_CONFIG : undefined)
+            ?? defaultApplicationConfPath();
+        const application = applicationPath && existsSync(applicationPath)
+            ? Config.parseFile(applicationPath)
+            : Config.empty();
+        const overrides = options.overrides
+            ? (options.overrides instanceof Config ? options.overrides : Config.fromObject(options.overrides))
+            : Config.empty();
+        // Build from reference up, with each layer overriding the last.
+        return reference.merge(application).merge(overrides);
+    }
+    /** Load the bundled reference defaults.  Cached for the process. */
+    static _referenceCache = null;
+    static loadReference() {
+        if (Config._referenceCache)
+            return Config._referenceCache;
+        Config._referenceCache = Config.parseString(REFERENCE_CONF);
+        return Config._referenceCache;
+    }
+    /* --------------------------------- Access -------------------------------- */
+    hasPath(path) {
+        return this.lookup(path) !== undefined;
+    }
+    getString(path) {
+        const v = this.requireValue(path);
+        if (typeof v === 'string')
+            return v;
+        if (typeof v === 'number' || typeof v === 'boolean')
+            return String(v);
+        throw typeError(path, 'string', v);
+    }
+    getInt(path) {
+        const n = this.getNumber(path);
+        if (!Number.isInteger(n))
+            throw typeError(path, 'integer', n);
+        return n;
+    }
+    getNumber(path) {
+        const v = this.requireValue(path);
+        if (typeof v === 'number')
+            return v;
+        if (typeof v === 'string' && /^-?\d+(\.\d+)?$/.test(v))
+            return Number(v);
+        throw typeError(path, 'number', v);
+    }
+    getBoolean(path) {
+        const v = this.requireValue(path);
+        if (typeof v === 'boolean')
+            return v;
+        if (typeof v === 'string') {
+            const s = v.toLowerCase();
+            if (s === 'true' || s === 'yes' || s === 'on')
+                return true;
+            if (s === 'false' || s === 'no' || s === 'off')
+                return false;
+        }
+        throw typeError(path, 'boolean', v);
+    }
+    /** Duration in milliseconds. */
+    getDuration(path) {
+        const v = this.requireValue(path);
+        if (typeof v === 'number')
+            return v;
+        if (typeof v === 'string')
+            return parseDuration(v);
+        throw typeError(path, 'duration', v);
+    }
+    /** Byte count. */
+    getBytes(path) {
+        const v = this.requireValue(path);
+        if (typeof v === 'number')
+            return v;
+        if (typeof v === 'string')
+            return parseSize(v);
+        throw typeError(path, 'size', v);
+    }
+    getStringList(path) {
+        const v = this.requireValue(path);
+        if (!Array.isArray(v))
+            throw typeError(path, 'list', v);
+        return v.map((x, i) => {
+            if (typeof x === 'string')
+                return x;
+            if (typeof x === 'number' || typeof x === 'boolean')
+                return String(x);
+            throw new ConfigError(`${path}[${i}] is not a string (got ${typeof x})`);
+        });
+    }
+    getList(path) {
+        const v = this.requireValue(path);
+        if (!Array.isArray(v))
+            throw typeError(path, 'list', v);
+        return v;
+    }
+    getObject(path) {
+        const v = this.requireValue(path);
+        if (!isPlainObject(v))
+            throw typeError(path, 'object', v);
+        return v;
+    }
+    getConfig(path) {
+        return new Config(this.getObject(path));
+    }
+    /* ------------------------------- Layering ------------------------------- */
+    /**
+     * Merge `other` underneath this config — i.e. values defined here win,
+     * keys that only exist in `other` are filled in.
+     */
+    withFallback(other) {
+        return new Config(deepMerge(other.tree, this.tree));
+    }
+    /** Inverse of withFallback — layer `overlay` on top. */
+    merge(overlay) {
+        return new Config(deepMerge(this.tree, overlay.tree));
+    }
+    /** Wrap the tree under the given path: `{a:{b:1}}`.atPath("x.y") → `{x:{y:{a:{b:1}}}}`. */
+    atPath(path) {
+        const parts = path.split('.').filter(Boolean);
+        let cur = this.tree;
+        for (let i = parts.length - 1; i >= 0; i--) {
+            const k = parts[i];
+            cur = { [k]: cur };
+        }
+        return new Config(cur);
+    }
+    /** Deep-clone the underlying tree as a plain object. */
+    toJSON() {
+        return cloneTree(this.tree);
+    }
+    /* ------------------------------- Internal ------------------------------- */
+    lookup(path) {
+        const parts = path.split('.');
+        let cur = this.tree;
+        for (const p of parts) {
+            if (!isPlainObject(cur))
+                return undefined;
+            cur = cur[p];
+            if (cur === undefined)
+                return undefined;
+        }
+        return cur;
+    }
+    requireValue(path) {
+        const v = this.lookup(path);
+        if (v === undefined)
+            throw new ConfigError(`Missing config value at path "${path}"`);
+        return v;
+    }
+}
+/** Thrown on type mismatches or missing paths. */
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+function typeError(path, expected, actual) {
+    const actualType = actual === null ? 'null' : Array.isArray(actual) ? 'list' : typeof actual;
+    return new ConfigError(`Config at "${path}" is not a ${expected} (got ${actualType})`);
+}
+function cloneTree(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (Array.isArray(v)) {
+            out[k] = v.map(x => (isPlainObject(x) ? cloneTree(x) : x));
+        }
+        else if (isPlainObject(v)) {
+            out[k] = cloneTree(v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+function defaultApplicationConfPath() {
+    try {
+        return resolve(process.cwd(), 'application.conf');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Re-exports for callers that want to build Configs without using the class. */
+export { deepMerge, isPlainObject, parseHocon, resolveSubstitutions };
+//# sourceMappingURL=Config.js.map

package/dist/config/Config.js.map

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

package/dist/config/ConfigKeys.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Single source of truth for the framework's HOCON config-key paths.
+ *
+ * Every key the framework ever reads from `Config.get(...)` /
+ * `Config.hasPath(...)` should be reachable from this const-tree.
+ * Two motivations:
+ *
+ *   1. **Typo-safety**: a string literal like
+ *      `'actor-ts.io.broker.mqqt'` (oops — three Q's) is a silent
+ *      runtime null at a config-lookup site.  `ConfigKeys.io.broker.mqtt`
+ *      is a typed reference — IDE autocomplete + TypeScript catch
+ *      typos before they ship.
+ *
+ *   2. **Discoverability**: a new contributor can scan this file to
+ *      see every key the framework recognises, without grepping the
+ *      whole codebase.
+ *
+ * Convention: every leaf is the full dotted path as a string-literal
+ * type.  Group structure mirrors the dotted hierarchy.
+ *
+ * Migration policy: existing string literals are migrated in-place
+ * one site at a time.  The tree's runtime values are the SAME strings
+ * the codebase already uses — no behavioural change, just better
+ * compile-time safety.
+ */
+export declare const ConfigKeys: {
+    /** Logger root — `actor-ts.logger.*`. */
+    readonly logger: {
+        readonly level: "actor-ts.logger.level";
+    };
+    /** Dispatcher root — `actor-ts.dispatcher.*`. */
+    readonly dispatcher: {
+        readonly default: "actor-ts.dispatcher.default";
+        readonly throughput: "actor-ts.dispatcher.throughput";
+    };
+    /** Cache plugin-ids — `actor-ts.cache.*`. */
+    readonly cache: {
+        readonly inMemory: "actor-ts.cache.in-memory";
+        readonly redis: "actor-ts.cache.redis";
+        readonly memcached: "actor-ts.cache.memcached";
+    };
+    /** IO broker config roots — `actor-ts.io.broker.*`. */
+    readonly io: {
+        readonly broker: {
+            readonly amqp: "actor-ts.io.broker.amqp";
+            readonly grpc: {
+                readonly client: "actor-ts.io.broker.grpc.client";
+                readonly server: "actor-ts.io.broker.grpc.server";
+            };
+            readonly jetstream: "actor-ts.io.broker.jetstream";
+            readonly kafka: "actor-ts.io.broker.kafka";
+            readonly mqtt: "actor-ts.io.broker.mqtt";
+            readonly nats: "actor-ts.io.broker.nats";
+            readonly redisStreams: "actor-ts.io.broker.redis-streams";
+            readonly sse: "actor-ts.io.broker.sse";
+            readonly tcp: "actor-ts.io.broker.tcp";
+            readonly udp: "actor-ts.io.broker.udp";
+            readonly websocket: "actor-ts.io.broker.websocket";
+        };
+    };
+    /** Persistence plugin selection + config — `actor-ts.persistence.*`. */
+    readonly persistence: {
+        readonly journal: {
+            readonly plugin: "actor-ts.persistence.journal.plugin";
+            readonly inMemory: "actor-ts.persistence.journal.in-memory";
+            readonly cassandra: "actor-ts.persistence.journal.cassandra";
+        };
+        readonly snapshotStore: {
+            readonly plugin: "actor-ts.persistence.snapshot-store.plugin";
+            readonly inMemory: "actor-ts.persistence.snapshot-store.in-memory";
+            readonly cassandra: "actor-ts.persistence.snapshot-store.cassandra";
+            readonly objectStorage: "actor-ts.persistence.snapshot-store.object-storage";
+        };
+        readonly durableState: {
+            readonly objectStorage: "actor-ts.persistence.durable-state.object-storage";
+        };
+    };
+    /** Cluster transport root — `actor-ts.transport`. */
+    readonly transport: "actor-ts.transport";
+    /**
+     * Worker IPC sentinels — used by the multi-runtime test harness and
+     * the worker-mesh code.  Unlike the config paths above, these are
+     * message-`kind` strings, so they intentionally drop the `actor-ts.`
+     * prefix — wire-format discriminators don't need a framework
+     * namespace.
+     */
+    readonly worker: {
+        readonly hello: "worker-hello";
+        readonly init: "worker-init";
+        readonly ready: "worker-ready";
+        readonly transport: "worker-transport";
+    };
+};
+//# sourceMappingURL=ConfigKeys.d.ts.map

package/dist/config/ConfigKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigKeys.d.ts","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,UAAU;IACrB,yCAAyC;;;;IAKzC,iDAAiD;;;;;IAMjD,6CAA6C;;;;;;IAO7C,uDAAuD;;;;;;;;;;;;;;;;;;;IAoBvD,wEAAwE;;;;;;;;;;;;;;;;;IAkBxE,qDAAqD;;IAGrD;;;;;;OAMG;;;;;;;CAOK,CAAC"}

package/dist/config/ConfigKeys.js

@@ -0,0 +1,94 @@
+/**
+ * Single source of truth for the framework's HOCON config-key paths.
+ *
+ * Every key the framework ever reads from `Config.get(...)` /
+ * `Config.hasPath(...)` should be reachable from this const-tree.
+ * Two motivations:
+ *
+ *   1. **Typo-safety**: a string literal like
+ *      `'actor-ts.io.broker.mqqt'` (oops — three Q's) is a silent
+ *      runtime null at a config-lookup site.  `ConfigKeys.io.broker.mqtt`
+ *      is a typed reference — IDE autocomplete + TypeScript catch
+ *      typos before they ship.
+ *
+ *   2. **Discoverability**: a new contributor can scan this file to
+ *      see every key the framework recognises, without grepping the
+ *      whole codebase.
+ *
+ * Convention: every leaf is the full dotted path as a string-literal
+ * type.  Group structure mirrors the dotted hierarchy.
+ *
+ * Migration policy: existing string literals are migrated in-place
+ * one site at a time.  The tree's runtime values are the SAME strings
+ * the codebase already uses — no behavioural change, just better
+ * compile-time safety.
+ */
+export const ConfigKeys = {
+    /** Logger root — `actor-ts.logger.*`. */
+    logger: {
+        level: 'actor-ts.logger.level',
+    },
+    /** Dispatcher root — `actor-ts.dispatcher.*`. */
+    dispatcher: {
+        default: 'actor-ts.dispatcher.default',
+        throughput: 'actor-ts.dispatcher.throughput',
+    },
+    /** Cache plugin-ids — `actor-ts.cache.*`. */
+    cache: {
+        inMemory: 'actor-ts.cache.in-memory',
+        redis: 'actor-ts.cache.redis',
+        memcached: 'actor-ts.cache.memcached',
+    },
+    /** IO broker config roots — `actor-ts.io.broker.*`. */
+    io: {
+        broker: {
+            amqp: 'actor-ts.io.broker.amqp',
+            grpc: {
+                client: 'actor-ts.io.broker.grpc.client',
+                server: 'actor-ts.io.broker.grpc.server',
+            },
+            jetstream: 'actor-ts.io.broker.jetstream',
+            kafka: 'actor-ts.io.broker.kafka',
+            mqtt: 'actor-ts.io.broker.mqtt',
+            nats: 'actor-ts.io.broker.nats',
+            redisStreams: 'actor-ts.io.broker.redis-streams',
+            sse: 'actor-ts.io.broker.sse',
+            tcp: 'actor-ts.io.broker.tcp',
+            udp: 'actor-ts.io.broker.udp',
+            websocket: 'actor-ts.io.broker.websocket',
+        },
+    },
+    /** Persistence plugin selection + config — `actor-ts.persistence.*`. */
+    persistence: {
+        journal: {
+            plugin: 'actor-ts.persistence.journal.plugin',
+            inMemory: 'actor-ts.persistence.journal.in-memory',
+            cassandra: 'actor-ts.persistence.journal.cassandra',
+        },
+        snapshotStore: {
+            plugin: 'actor-ts.persistence.snapshot-store.plugin',
+            inMemory: 'actor-ts.persistence.snapshot-store.in-memory',
+            cassandra: 'actor-ts.persistence.snapshot-store.cassandra',
+            objectStorage: 'actor-ts.persistence.snapshot-store.object-storage',
+        },
+        durableState: {
+            objectStorage: 'actor-ts.persistence.durable-state.object-storage',
+        },
+    },
+    /** Cluster transport root — `actor-ts.transport`. */
+    transport: 'actor-ts.transport',
+    /**
+     * Worker IPC sentinels — used by the multi-runtime test harness and
+     * the worker-mesh code.  Unlike the config paths above, these are
+     * message-`kind` strings, so they intentionally drop the `actor-ts.`
+     * prefix — wire-format discriminators don't need a framework
+     * namespace.
+     */
+    worker: {
+        hello: 'worker-hello',
+        init: 'worker-init',
+        ready: 'worker-ready',
+        transport: 'worker-transport',
+    },
+};
+//# sourceMappingURL=ConfigKeys.js.map

package/dist/config/ConfigKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigKeys.js","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,yCAAyC;IACzC,MAAM,EAAE;QACN,KAAK,EAAE,uBAAuB;KAC/B;IAED,iDAAiD;IACjD,UAAU,EAAE;QACV,OAAO,EAAE,6BAA6B;QACtC,UAAU,EAAE,gCAAgC;KAC7C;IAED,6CAA6C;IAC7C,KAAK,EAAE;QACL,QAAQ,EAAE,0BAA0B;QACpC,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,0BAA0B;KACtC;IAED,uDAAuD;IACvD,EAAE,EAAE;QACF,MAAM,EAAE;YACN,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE;gBACJ,MAAM,EAAE,gCAAgC;gBACxC,MAAM,EAAE,gCAAgC;aACzC;YACD,SAAS,EAAE,8BAA8B;YACzC,KAAK,EAAE,0BAA0B;YACjC,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,yBAAyB;YAC/B,YAAY,EAAE,kCAAkC;YAChD,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,wBAAwB;YAC7B,GAAG,EAAE,wBAAwB;YAC7B,SAAS,EAAE,8BAA8B;SAC1C;KACF;IAED,wEAAwE;IACxE,WAAW,EAAE;QACX,OAAO,EAAE;YACP,MAAM,EAAE,qCAAqC;YAC7C,QAAQ,EAAE,wCAAwC;YAClD,SAAS,EAAE,wCAAwC;SACpD;QACD,aAAa,EAAE;YACb,MAAM,EAAE,4CAA4C;YACpD,QAAQ,EAAE,+CAA+C;YACzD,SAAS,EAAE,+CAA+C;YAC1D,aAAa,EAAE,oDAAoD;SACpE;QACD,YAAY,EAAE;YACZ,aAAa,EAAE,mDAAmD;SACnE;KACF;IAED,qDAAqD;IACrD,SAAS,EAAE,oBAAoB;IAE/B;;;;;;OAMG;IACH,MAAM,EAAE;QACN,KAAK,EAAM,cAAc;QACzB,IAAI,EAAO,aAAa;QACxB,KAAK,EAAM,cAAc;QACzB,SAAS,EAAE,kBAAkB;KAC9B;CACO,CAAC"}

package/dist/config/Duration.d.ts

@@ -0,0 +1,2 @@
+export declare function parseDuration(input: string | number): number;
+//# sourceMappingURL=Duration.d.ts.map

package/dist/config/Duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Duration.d.ts","sourceRoot":"","sources":["../../src/config/Duration.ts"],"names":[],"mappings":"AAkDA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAe5D"}

package/dist/config/Duration.js

@@ -0,0 +1,70 @@
+/**
+ * Parse a HOCON-style duration string into milliseconds.
+ *
+ *   parseDuration("500ms")       → 500
+ *   parseDuration("2 seconds")   → 2000
+ *   parseDuration("1 h")         → 3_600_000
+ *   parseDuration(42)            → 42          (already a number)
+ *   parseDuration("42")          → 42          (bare number → ms)
+ *
+ * Accepts short and long unit names, case-insensitive, with or without
+ * whitespace between the number and the unit.  Negative and fractional
+ * values are allowed (e.g. "1.5s" → 1500).
+ */
+const UNIT_MS = {
+    ns: 1e-6,
+    nano: 1e-6,
+    nanos: 1e-6,
+    nanosecond: 1e-6,
+    nanoseconds: 1e-6,
+    us: 1e-3,
+    'μs': 1e-3,
+    micro: 1e-3,
+    micros: 1e-3,
+    microsecond: 1e-3,
+    microseconds: 1e-3,
+    ms: 1,
+    milli: 1,
+    millis: 1,
+    millisecond: 1,
+    milliseconds: 1,
+    s: 1_000,
+    sec: 1_000,
+    secs: 1_000,
+    second: 1_000,
+    seconds: 1_000,
+    m: 60_000,
+    min: 60_000,
+    mins: 60_000,
+    minute: 60_000,
+    minutes: 60_000,
+    h: 3_600_000,
+    hr: 3_600_000,
+    hrs: 3_600_000,
+    hour: 3_600_000,
+    hours: 3_600_000,
+    d: 86_400_000,
+    day: 86_400_000,
+    days: 86_400_000,
+};
+export function parseDuration(input) {
+    if (typeof input === 'number') {
+        if (!Number.isFinite(input))
+            throw new Error(`Invalid duration: ${input}`);
+        return input;
+    }
+    const trimmed = input.trim();
+    if (trimmed === '')
+        throw new Error('Invalid duration: empty string');
+    if (/^[+-]?\d+(?:\.\d+)?$/.test(trimmed))
+        return parseFloat(trimmed); // bare number ⇒ ms
+    const match = trimmed.match(/^([+-]?\d+(?:\.\d+)?)\s*([A-Za-zμ]+)$/);
+    if (!match)
+        throw new Error(`Invalid duration: ${input}`);
+    const [, num, unitRaw] = match;
+    const factor = UNIT_MS[unitRaw.toLowerCase()];
+    if (factor === undefined)
+        throw new Error(`Unknown duration unit "${unitRaw}" in ${input}`);
+    return parseFloat(num) * factor;
+}
+//# sourceMappingURL=Duration.js.map

package/dist/config/Duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Duration.js","sourceRoot":"","sources":["../../src/config/Duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,GAA2B;IACtC,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;IAClB,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,CAAC,EAAE,KAAK;IACR,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,CAAC,EAAE,MAAM;IACT,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,CAAC,EAAE,SAAS;IACZ,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,CAAC,EAAE,UAAU;IACb,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;CACjB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,KAAsB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACtE,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;IAEzF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC;IAC5F,OAAO,UAAU,CAAC,GAAI,CAAC,GAAG,MAAM,CAAC;AACnC,CAAC"}

package/dist/config/HoconParser.d.ts

@@ -0,0 +1,19 @@
+export type ConfigPrimitive = string | number | boolean | null;
+export type ConfigValue = ConfigPrimitive | ConfigValue[] | ConfigObject | Substitution;
+export type ConfigObject = {
+    [key: string]: ConfigValue;
+};
+export interface Substitution {
+    readonly __substitution: true;
+    readonly path: string;
+    readonly optional: boolean;
+}
+export declare function isSubstitution(v: unknown): v is Substitution;
+export declare function parseHocon(source: string): ConfigObject;
+export declare function resolveSubstitutions(obj: ConfigObject, env?: Record<string, string | undefined>): ConfigObject;
+export declare function isPlainObject(v: unknown): v is ConfigObject;
+/** Deep merge — values in `overlay` win, objects merge recursively, arrays overwrite. */
+export declare function deepMerge(base: ConfigObject, overlay: ConfigObject): ConfigObject;
+/** Strip undefined values that originated from optional substitutions. */
+export declare function stripUndefined(obj: ConfigObject): ConfigObject;
+//# sourceMappingURL=HoconParser.d.ts.map

package/dist/config/HoconParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HoconParser.d.ts","sourceRoot":"","sources":["../../src/config/HoconParser.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,WAAW,EAAE,GAAG,YAAY,GAAG,YAAY,CAAC;AACxF,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,CAE5D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAGvD;AAuRD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAmB,GACxD,YAAY,CAad;AAkED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,CAE3D;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAUjF;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAS9D"}