@justscale/core 0.1.0

package/dist/features/config/cli/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI Utilities
+ *
+ * Helper functions for CLI commands.
+ */
+/**
+ * Get nested value from object by dot-separated path
+ */
+export declare function getPath(obj: any, path: string): unknown;
+/**
+ * Format value for display (mask secrets)
+ */
+export declare function formatValue(value: unknown, isSecret?: boolean): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/features/config/cli/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/features/config/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAIpE"}

package/dist/features/config/cli/utils.js

@@ -0,0 +1,29 @@
+/**
+ * CLI Utilities
+ *
+ * Helper functions for CLI commands.
+ */
+/**
+ * Get nested value from object by dot-separated path
+ */
+export function getPath(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === undefined || current === null)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Format value for display (mask secrets)
+ */
+export function formatValue(value, isSecret = false) {
+    if (isSecret)
+        return '[secret] ••••••••';
+    if (typeof value === 'object')
+        return JSON.stringify(value, null, 2);
+    return String(value);
+}
+//# sourceMappingURL=utils.js.map

package/dist/features/config/cli/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/features/config/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,GAAQ,EAAE,IAAY;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAChE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAQ,GAAG,KAAK;IAC1D,IAAI,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/features/config/config-of.d.ts

@@ -0,0 +1,36 @@
+import type { Token } from '../../builder/index.js';
+import type { ConfigPartial } from './types.js';
+/**
+ * Brand for config tokens
+ */
+declare const CONFIG_TOKEN_BRAND: unique symbol;
+/**
+ * A config token that can be used with the DI system
+ */
+export interface ConfigToken<T> extends Token<T> {
+    readonly [CONFIG_TOKEN_BRAND]?: T;
+    readonly description: string;
+    readonly key: symbol;
+    resolve(container: {
+        get(key: symbol): T;
+    }): T;
+}
+/**
+ * Create a DI token for a config partial.
+ *
+ * The token can be used with container.get() to retrieve the config value.
+ * The actual resolution happens in the ConfigService.
+ */
+export declare function createToken<T>(description: string, options: {
+    resolve: (container: {
+        get: (key: symbol) => T;
+    }) => T;
+}): ConfigToken<T>;
+/**
+ * Create an injection token for a config partial.
+ */
+export declare const Config: {
+    of<T>(partial: ConfigPartial<T>): ConfigToken<T>;
+};
+export {};
+//# sourceMappingURL=config-of.d.ts.map

package/dist/features/config/config-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-of.d.ts","sourceRoot":"","sources":["../../../src/features/config/config-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,SAAS,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE,GAAG,CAAC,CAAA;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,OAAO,EAAE,CAAC,SAAS,EAAE;QAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAA;KAAE,KAAK,CAAC,CAAA;CACvD,GACA,WAAW,CAAC,CAAC,CAAC,CAMhB;AAUD;;GAEG;AACH,eAAO,MAAM,MAAM;OACd,CAAC,WAAW,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;CASjD,CAAC"}

package/dist/features/config/config-of.js

@@ -0,0 +1,36 @@
+/**
+ * Create a DI token for a config partial.
+ *
+ * The token can be used with container.get() to retrieve the config value.
+ * The actual resolution happens in the ConfigService.
+ */
+export function createToken(description, options) {
+    return {
+        description,
+        key: Symbol.for(description),
+        ...options
+    };
+}
+/**
+ * Memoize Config.of(partial) so that multiple call-sites receive the same
+ * token instance. Required for DI validation, which compares by token
+ * identity - different injections of the "same" partial must resolve to one
+ * token object.
+ */
+const configTokenCache = new WeakMap();
+/**
+ * Create an injection token for a config partial.
+ */
+export const Config = {
+    of(partial) {
+        const cached = configTokenCache.get(partial);
+        if (cached)
+            return cached;
+        const token = createToken(`Config.of(${partial.name})`, {
+            resolve: (container) => container.get(partial.key)
+        });
+        configTokenCache.set(partial, token);
+        return token;
+    }
+};
+//# sourceMappingURL=config-of.js.map

package/dist/features/config/config-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-of.js","sourceRoot":"","sources":["../../../src/features/config/config-of.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,WAAmB,EACnB,OAEC;IAED,OAAO;QACL,WAAW;QACX,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAC5B,GAAG,OAAO;KACO,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAwC,CAAC;AAE7E;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,EAAE,CAAI,OAAyB;QAC7B,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,MAAM;YAAE,OAAO,MAAwB,CAAC;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAI,aAAa,OAAO,CAAC,IAAI,GAAG,EAAE;YACzD,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC;SACnD,CAAC,CAAC;QACH,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/features/config/config-service.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ConfigService - Runtime mutations and persistence
+ *
+ * Provides:
+ * - Runtime config mutations (CLI `config set`)
+ * - Persistence to `.justscale/config.json`
+ * - Watching for changes via async iterables
+ */
+import { type Resolver } from '../../core/index.js';
+import type { ConfigPartial } from './types.js';
+export interface ConfigService {
+    /**
+     * Update a config value at runtime.
+     * - Updates in-memory state in the container
+     * - Persists to .justscale/config.json
+     * - Notifies all watchers
+     *
+     * @returns Number of watchers notified
+     */
+    set<T>(partial: ConfigPartial<T>, path: string, value: unknown): Promise<number>;
+    /**
+     * Watch for config changes via async iterable.
+     *
+     * @example
+     * ```typescript
+     * for await (const [oldConfig, newConfig] of configService.watch(PgConfig)) {
+     *   console.log('Config changed:', oldConfig, '→', newConfig)
+     * }
+     * ```
+     */
+    watch<T>(partial: ConfigPartial<T>, path?: string): AsyncIterable<[T, T]>;
+}
+export interface ConfigServiceOptions {
+    /** Custom config directory path. Defaults to `${cwd}/.justscale` */
+    configDir?: string;
+}
+declare const ConfigServiceDef_base: import("../../core/service.js").Service<ConfigService, {}>;
+/** ConfigService DI token. */
+export declare class ConfigServiceDef extends ConfigServiceDef_base {
+}
+/**
+ * Create a ConfigService instance with custom options.
+ * Useful for testing with isolated config directories.
+ *
+ * @example
+ * ```typescript
+ * const configService = createConfigService(resolver, {
+ *   configDir: '/tmp/my-test-config'
+ * })
+ * ```
+ */
+export declare function createConfigService(resolver: Resolver, options?: ConfigServiceOptions): ConfigService;
+export {};
+//# sourceMappingURL=config-service.d.ts.map

package/dist/features/config/config-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.d.ts","sourceRoot":"","sources":["../../../src/features/config/config-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEhF;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CAC1E;AA0CD,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;;AAoJD,8BAA8B;AAC9B,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG;AAEL;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAEf"}

package/dist/features/config/config-service.js

@@ -0,0 +1,184 @@
+/**
+ * ConfigService - Runtime mutations and persistence
+ *
+ * Provides:
+ * - Runtime config mutations (CLI `config set`)
+ * - Persistence to `.justscale/config.json`
+ * - Watching for changes via async iterables
+ */
+import { defineService } from '../../core/index.js';
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+// ============================================================================
+// Path Utilities
+// ============================================================================
+/**
+ * Set a value at a nested path in an object.
+ * Creates a shallow copy at each level.
+ */
+function setPath(obj, path, value) {
+    const result = { ...obj };
+    const keys = path.split('.');
+    let current = result;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        current[key] = { ...current[key] };
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+    return result;
+}
+/**
+ * Get a value at a nested path in an object.
+ */
+function getPath(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === undefined || current === null)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+class ConfigServiceImpl {
+    resolver;
+    /** Watchers per partial (by symbol key) */
+    watchers = new Map();
+    /** Config directory path */
+    configDir;
+    /** Config file path */
+    configPath;
+    constructor(resolver, options) {
+        this.resolver = resolver;
+        this.configDir = options?.configDir ?? join(process.cwd(), '.justscale');
+        this.configPath = join(this.configDir, 'config.json');
+    }
+    /**
+     * Load persisted config from disk.
+     */
+    loadPersistedConfig() {
+        if (!existsSync(this.configPath))
+            return {};
+        try {
+            return JSON.parse(readFileSync(this.configPath, 'utf-8'));
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Save config to disk.
+     */
+    persistConfig(partialName, value) {
+        if (!existsSync(this.configDir)) {
+            mkdirSync(this.configDir, { recursive: true });
+        }
+        const existing = this.loadPersistedConfig();
+        existing[partialName] = value;
+        writeFileSync(this.configPath, JSON.stringify(existing, null, 2));
+    }
+    async set(partial, path, value) {
+        // Get current value from container using the partial's symbol key
+        // The resolver can resolve any token, including raw symbols
+        const oldValue = await this.resolver(partial.key);
+        // Create new value with the path updated
+        const newValue = setPath(oldValue, path, value);
+        // Validate against schema
+        partial.schema.parse(newValue);
+        // Update container so subsequent resolves return the new value
+        this.resolver.registerInstance(partial.key, newValue);
+        // Persist to disk
+        this.persistConfig(partial.name, newValue);
+        const callbacks = this.watchers.get(partial.key) ?? new Set();
+        for (const cb of callbacks) {
+            try {
+                cb(oldValue, newValue);
+            }
+            catch {
+                callbacks.delete(cb);
+            }
+        }
+        return callbacks.size;
+    }
+    watch(partial, path) {
+        const watchers = this.watchers;
+        const partialKey = partial.key;
+        return {
+            [Symbol.asyncIterator]() {
+                const queue = [];
+                let resolve = null;
+                let done = false;
+                const callback = (oldVal, newVal) => {
+                    if (done)
+                        return;
+                    // If watching a specific path, check if it changed
+                    if (path) {
+                        const oldPath = getPath(oldVal, path);
+                        const newPath = getPath(newVal, path);
+                        if (oldPath === newPath)
+                            return;
+                    }
+                    const pair = [oldVal, newVal];
+                    if (resolve) {
+                        resolve({ value: pair, done: false });
+                        resolve = null;
+                    }
+                    else {
+                        queue.push(pair);
+                    }
+                };
+                // Register watcher
+                if (!watchers.has(partialKey)) {
+                    watchers.set(partialKey, new Set());
+                }
+                watchers.get(partialKey).add(callback);
+                return {
+                    async next() {
+                        if (queue.length > 0) {
+                            return { value: queue.shift(), done: false };
+                        }
+                        if (done) {
+                            return { value: undefined, done: true };
+                        }
+                        return new Promise(r => { resolve = r; });
+                    },
+                    async return() {
+                        done = true;
+                        watchers.get(partialKey)?.delete(callback);
+                        return { value: undefined, done: true };
+                    },
+                    async throw(e) {
+                        done = true;
+                        watchers.get(partialKey)?.delete(callback);
+                        throw e;
+                    },
+                };
+            }
+        };
+    }
+}
+// ============================================================================
+// Service Definition
+// ============================================================================
+/** ConfigService DI token. */
+export class ConfigServiceDef extends defineService({
+    inject: {},
+    factory: (_deps, resolver) => new ConfigServiceImpl(resolver),
+}) {
+}
+/**
+ * Create a ConfigService instance with custom options.
+ * Useful for testing with isolated config directories.
+ *
+ * @example
+ * ```typescript
+ * const configService = createConfigService(resolver, {
+ *   configDir: '/tmp/my-test-config'
+ * })
+ * ```
+ */
+export function createConfigService(resolver, options) {
+    return new ConfigServiceImpl(resolver, options);
+}
+//# sourceMappingURL=config-service.js.map

package/dist/features/config/config-service.js.map

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

package/dist/features/config/create-config.d.ts

@@ -0,0 +1,21 @@
+import type { ServiceToken, InstanceOf } from '../../core/service.js';
+import type { ConfigPartial, ConfigComponent } from './types.js';
+type InferDeps<T extends Record<string, ServiceToken<any>>> = {
+    [K in keyof T]: InstanceOf<T[K]>;
+};
+type ConfigFactory<TInject extends Record<string, ServiceToken<any>>> = (deps: InferDeps<TInject>) => Record<symbol, any> | Promise<Record<symbol, any>>;
+interface CreateConfigOptions<TInject extends Record<string, ServiceToken<any>>, P extends readonly ConfigPartial<any>[]> {
+    provides?: P;
+    inject?: TInject;
+    factory: ConfigFactory<TInject>;
+}
+/**
+ * Create a config component that provides multiple partials.
+ *
+ * When `provides` is passed, the builder validates factory output against
+ * each partial's zod schema at boot. When omitted, values are registered
+ * as-is without validation (kept for backward-compat with older tests).
+ */
+export declare function createConfig<const TInject extends Record<string, ServiceToken<any>> = {}, const P extends readonly ConfigPartial<any>[] = readonly []>(options: CreateConfigOptions<TInject, P>): ConfigComponent<P>;
+export {};
+//# sourceMappingURL=create-config.d.ts.map

package/dist/features/config/create-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-config.d.ts","sourceRoot":"","sources":["../../../src/features/config/create-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI;KAC3D,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAClE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAEnF,UAAU,mBAAmB,CAC3B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EACjD,CAAC,SAAS,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE;IAEvC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAC5D,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE,EAC3D,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAO9D"}

package/dist/features/config/create-config.js

@@ -0,0 +1,16 @@
+/**
+ * Create a config component that provides multiple partials.
+ *
+ * When `provides` is passed, the builder validates factory output against
+ * each partial's zod schema at boot. When omitted, values are registered
+ * as-is without validation (kept for backward-compat with older tests).
+ */
+export function createConfig(options) {
+    return {
+        __configComponent: true,
+        provides: (options.provides ?? []),
+        inject: (options.inject ?? {}),
+        factory: options.factory,
+    };
+}
+//# sourceMappingURL=create-config.js.map

package/dist/features/config/create-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-config.js","sourceRoot":"","sources":["../../../src/features/config/create-config.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAG1B,OAAwC;IACxC,OAAO;QACL,iBAAiB,EAAE,IAAI;QACvB,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAM;QACvC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAA+B;QAC5D,OAAO,EAAE,OAAO,CAAC,OAA2D;KAC7E,CAAC;AACJ,CAAC"}

package/dist/features/config/define-config-partial.d.ts

@@ -0,0 +1,13 @@
+import type { z } from 'zod';
+import { type ConfigPartial } from './types.js';
+/**
+ * Define a config partial with a Zod schema.
+ *
+ * The returned object carries a fresh `Symbol('config:<name>')` on `.key`.
+ * Plain `Symbol()` (not `Symbol.for`) so two features that happen to pick
+ * the same name get distinct tokens and do not silently share a container
+ * slot. Consumers import the token object from the declaring module and
+ * inject it directly; no string-keyed lookup is involved.
+ */
+export declare function defineConfigPartial<T extends z.ZodType>(name: string, schema: T): ConfigPartial<z.infer<T>>;
+//# sourceMappingURL=define-config-partial.d.ts.map

package/dist/features/config/define-config-partial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config-partial.d.ts","sourceRoot":"","sources":["../../../src/features/config/define-config-partial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACrD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,GACR,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAO3B"}

package/dist/features/config/define-config-partial.js

@@ -0,0 +1,19 @@
+import { CONFIG_PARTIAL } from './types.js';
+/**
+ * Define a config partial with a Zod schema.
+ *
+ * The returned object carries a fresh `Symbol('config:<name>')` on `.key`.
+ * Plain `Symbol()` (not `Symbol.for`) so two features that happen to pick
+ * the same name get distinct tokens and do not silently share a container
+ * slot. Consumers import the token object from the declaring module and
+ * inject it directly; no string-keyed lookup is involved.
+ */
+export function defineConfigPartial(name, schema) {
+    return {
+        [CONFIG_PARTIAL]: true,
+        key: Symbol(`config:${name}`),
+        name,
+        schema: schema,
+    };
+}
+//# sourceMappingURL=define-config-partial.js.map

package/dist/features/config/define-config-partial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config-partial.js","sourceRoot":"","sources":["../../../src/features/config/define-config-partial.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,MAAS;IAET,OAAO;QACL,CAAC,cAAc,CAAC,EAAE,IAAI;QACtB,GAAG,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC7B,IAAI;QACJ,MAAM,EAAE,MAA+B;KACxC,CAAC;AACJ,CAAC"}

package/dist/features/config/env-service.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Environment Variable Service
+ *
+ * Provides typed access to environment variables with validation and parsing.
+ */
+/**
+ * Service for typed environment variable access.
+ */
+export interface EnvService {
+    /**
+     * Get string value from env
+     */
+    string(key: string, defaultValue?: string): string;
+    /**
+     * Get number value from env.
+     *
+     * Uses `Number(raw)` + `Number.isFinite` so values like '3.7' remain 3.7
+     * (not silently truncated to 3) and partial numerics like '100px' throw
+     * instead of returning 100. Throws when the value is missing and no
+     * default is supplied.
+     */
+    number(key: string, defaultValue?: number): number;
+    /**
+     * Get boolean value from env
+     * Truthy: 'true', '1', 'yes', 'on'
+     * Falsy: 'false', '0', 'no', 'off', undefined
+     */
+    boolean(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Get JSON-parsed value from env
+     */
+    json<T>(key: string, defaultValue?: T): T;
+    /**
+     * Check if an env key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get raw value (no parsing)
+     */
+    raw(key: string): string | undefined;
+    /**
+     * Watch an env key for changes (via file watcher)
+     * Only works with file-backed env (.env files)
+     */
+    watch(key: string): {
+        subscribe: (callback: (value: string | undefined) => void) => () => void;
+    };
+}
+declare const EnvServiceDef_base: import("../../core/service.js").Service<EnvService, {}>;
+/** EnvService DI token. */
+export declare class EnvServiceDef extends EnvServiceDef_base {
+}
+export {};
+//# sourceMappingURL=env-service.d.ts.map

package/dist/features/config/env-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-service.d.ts","sourceRoot":"","sources":["../../../src/features/config/env-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAElD;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAElD;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IAErD;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IAEzC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAEzB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAEpC;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG;QAClB,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;KACzE,CAAA;CACF;;AA+ID,2BAA2B;AAC3B,qBAAa,aAAc,SAAQ,kBAGjC;CAAG"}

package/dist/features/config/env-service.js

@@ -0,0 +1,115 @@
+/**
+ * Environment Variable Service
+ *
+ * Provides typed access to environment variables with validation and parsing.
+ */
+import { defineService } from '../../core/index.js';
+import { watchEnvFiles } from './file-watcher.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+class EnvServiceImpl {
+    fileWatcher = null;
+    raw(key) {
+        return process.env[key];
+    }
+    has(key) {
+        const v = process.env[key];
+        return typeof v === 'string' && v.length > 0;
+    }
+    string(key, defaultValue) {
+        const value = this.raw(key);
+        if (value === undefined) {
+            if (defaultValue !== undefined) {
+                return defaultValue;
+            }
+            throw new Error(`Required environment variable "${key}" is not set`);
+        }
+        return value;
+    }
+    number(key, defaultValue) {
+        const value = this.raw(key);
+        if (value === undefined) {
+            if (defaultValue !== undefined) {
+                return defaultValue;
+            }
+            throw new Error(`Required environment variable "${key}" is not set`);
+        }
+        if (value === '') {
+            throw new Error(`EnvService.number('${key}'): value '' is not a valid number`);
+        }
+        const parsed = Number(value);
+        if (!Number.isFinite(parsed)) {
+            throw new Error(`EnvService.number('${key}'): value '${value}' is not a valid number`);
+        }
+        return parsed;
+    }
+    boolean(key, defaultValue) {
+        const value = this.raw(key);
+        if (value === undefined) {
+            if (defaultValue !== undefined) {
+                return defaultValue;
+            }
+            return false;
+        }
+        const lower = value.toLowerCase();
+        // Truthy values
+        if (lower === 'true' || lower === '1' || lower === 'yes' || lower === 'on') {
+            return true;
+        }
+        // Falsy values
+        if (lower === 'false' || lower === '0' || lower === 'no' || lower === 'off') {
+            return false;
+        }
+        throw new Error(`Environment variable "${key}" has invalid boolean value: "${value}". ` +
+            'Expected one of: true, false, 1, 0, yes, no, on, off');
+    }
+    json(key, defaultValue) {
+        const value = this.raw(key);
+        if (value === undefined) {
+            if (defaultValue !== undefined) {
+                return defaultValue;
+            }
+            throw new Error(`Required environment variable "${key}" is not set`);
+        }
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            throw new Error(`Environment variable "${key}" has invalid JSON value: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    watch(key) {
+        // Lazy-init file watcher
+        if (!this.fileWatcher) {
+            // Common .env file locations
+            const envPaths = [
+                process.cwd() + '/.env',
+                process.cwd() + '/.env.local',
+            ];
+            this.fileWatcher = watchEnvFiles(envPaths);
+        }
+        const watcher = this.fileWatcher;
+        return {
+            subscribe: (callback) => {
+                // Call immediately with current value
+                callback(watcher.values[key]);
+                // Subscribe to changes
+                const unsubscribe = watcher.subscribe((values) => {
+                    callback(values[key]);
+                });
+                return unsubscribe;
+            },
+        };
+    }
+}
+// ============================================================================
+// Service Definition
+// ============================================================================
+/** EnvService DI token. */
+export class EnvServiceDef extends defineService({
+    inject: {},
+    factory: () => new EnvServiceImpl(),
+}) {
+}
+//# sourceMappingURL=env-service.js.map