@grest-ts/config 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Grest Games OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @grest-ts/config
+
+Type-safe configuration management for Grest Framework.
+
+## Features
+
+- Type-safe configuration keys with validation
+- Multiple key types (Settings, Secrets, Resources)
+- Pluggable storage backends (file, environment, remote)
+- Runtime configuration updates with watchers
+- Centralized configuration definitions
+- Config values are validated!
+
+## Pattern
+
+- Keys are defined statically, but values are resolved at runtime from async context
+- Different key types (Setting, Secret, Resource) can use different storage backends (Strategy pattern)
+- Supports watching for runtime configuration changes (Observer pattern)
+
+## Quick usage example
+
+```typescript
+import {GGConfig, GGResource, GGSecret, GGSetting} from "@grest-ts/config"
+
+// Define configuration keys
+export const AppConfig = GGConfig.define('/app/', () => ({
+    port: new GGSetting('port', 3000, 'Server port', IsInt),
+    apiKey: new GGSecret('apiKey', '', 'External API key', IsString),
+    dbUrl: new GGResource('db/url', 'localhost:5432', 'Database URL', IsString)
+}));
+
+// Usage in runtime
+const port = AppConfig.port.get();
+const apiKey = AppConfig.apiKey.reveal();
+const dbUrl = AppConfig.dbUrl.get(); // if value changes, you get the new value
+
+// Watch for changes (in case you need to) - as a simple example: you need to roll a mysql user password and start a new pool without any downtime.
+AppConfig.dbUrl.watch(() => {
+    // Do something when dbUrl changes
+})
+
+// Where actually values come from? You define the source in the runtime compose.
+// in example we use a file (don't really use files, use proper services for each category!)
+// These particular stores also watch the file for updates. Most stores should allow dynamic config updates!
+// You can also add your own stores, groups etc rather easily.
+new GGConfigLoader(new Map<any, any>([
+    [GGSetting, new GGConfigStoreFile("./config/settings.json", import.meta.url)],
+    [GGSecret, new GGConfigStoreFile("./config/secrets.json", import.meta.url)],
+    [GGResource, new GGConfigStoreFile("./config/resources.json", import.meta.url)]
+]));
+
+```
+
+## Documentation
+
+- [Usage](./README-usage.md) - How to define and use configuration
+- [Extending](./README-extending.md) - How to add custom key types and stores

package/dist/src/GGConfig.d.ts

@@ -0,0 +1,13 @@
+import { GGConfigDefinition } from "./GGConfigLocator";
+import { GGConfigKey } from "./GGConfigKey";
+export interface GGConfigKeyCreationContext {
+    name: string;
+    add: (key: GGConfigKey) => void;
+}
+export declare class GGConfig {
+    static define<T>(name: string, define: () => T): GGConfigDefinition<T>;
+    static getCreationContext(): GGConfigKeyCreationContext;
+    static toJSON(config: GGConfigDefinition<any>): Record<string, unknown>;
+    private static collectKeys;
+}
+//# sourceMappingURL=GGConfig.d.ts.map

package/dist/src/GGConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfig.d.ts","sourceRoot":"","sources":["../../src/GGConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAG1C,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;CACnC;AAID,qBAAa,QAAQ;WAEH,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;WAmB/D,kBAAkB,IAAI,0BAA0B;WAQhD,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAM9E,OAAO,CAAC,MAAM,CAAC,WAAW;CAsB7B"}

package/dist/src/GGConfig.js

@@ -0,0 +1,58 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { GGConfigKey } from "./GGConfigKey.js";
+const defineContext = new AsyncLocalStorage();
+export class GGConfig {
+    static define(name, define) {
+        const keysMap = new Map();
+        const ctx = Object.freeze({
+            name,
+            add: (key) => {
+                const cls = key.constructor;
+                if (!keysMap.has(cls)) {
+                    keysMap.set(cls, []);
+                }
+                keysMap.get(cls).push(key);
+            }
+        });
+        const result = defineContext.run(ctx, define);
+        keysMap.forEach(list => Object.freeze(list));
+        result.__getKeysMap = ((cls) => keysMap);
+        Object.freeze(result);
+        return result;
+    }
+    static getCreationContext() {
+        const store = defineContext.getStore();
+        if (!store) {
+            throw new Error("No prefix defined in context");
+        }
+        return store;
+    }
+    static toJSON(config) {
+        const result = {};
+        this.collectKeys(config, result);
+        return result;
+    }
+    static collectKeys(obj, result) {
+        if (obj instanceof GGConfigKey) {
+            const storeKey = obj.getStoreKey();
+            if (!result[storeKey]) {
+                result[storeKey] = {};
+            }
+            const segments = obj.name.split('/').filter(s => s.length > 0);
+            let current = result[storeKey];
+            for (let i = 0; i < segments.length - 1; i++) {
+                if (!current[segments[i]]) {
+                    current[segments[i]] = {};
+                }
+                current = current[segments[i]];
+            }
+            current[segments[segments.length - 1]] = obj.getDefault();
+        }
+        else if (obj && typeof obj === 'object') {
+            for (const value of Object.values(obj)) {
+                this.collectKeys(value, result);
+            }
+        }
+    }
+}
+//# sourceMappingURL=GGConfig.js.map

package/dist/src/GGConfig.js.map

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

package/dist/src/GGConfigKey.d.ts

@@ -0,0 +1,29 @@
+import { GGValidator } from "@grest-ts/schema";
+/**
+ * Widens literal types to their base primitive type.
+ * This allows T to be inferred from the validator while defaultValue accepts compatible values.
+ * e.g., Widen<tPosInt> = number, so defaultValue can be 5000
+ */
+export type Widen<T> = T extends number ? number : T extends string ? string : T extends boolean ? boolean : T;
+export type GGConfigKeyConstructor<T = unknown> = {
+    readonly NAME: string;
+    new (...args: any[]): GGConfigKey<T>;
+};
+export declare abstract class GGConfigKey<T = unknown> {
+    private static readonly registry;
+    static hasKey(name: string): boolean;
+    static getKey(name: string): GGConfigKey;
+    readonly root: string;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly schema: GGValidator<T> | undefined;
+    /** File location where this ConfigKey was defined (file:line:col) */
+    readonly definedAt: string | undefined;
+    constructor(name: string, schema: GGValidator<T>, description: string);
+    getDefault(): T | undefined;
+    protected getValue(): T;
+    watch(listener: (value: T) => void): () => void;
+    abstract getStoreKey(): string;
+    getStore(): import("./GGConfigStore").GGConfigStore<any>;
+}
+//# sourceMappingURL=GGConfigKey.d.ts.map

package/dist/src/GGConfigKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigKey.d.ts","sourceRoot":"","sources":["../../src/GGConfigKey.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAG7C;;;;GAIG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC;AAE/G,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;CACtC,CAAC;AAEF,8BAAsB,WAAW,CAAC,CAAC,GAAG,OAAO;IAEzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAkC;WAEpD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;WAI7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAQ/C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,SAAgB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnD,qEAAqE;IACrE,SAAgB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAElC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM;IAkB9D,UAAU,IAAI,CAAC,GAAG,SAAS;IAIlC,SAAS,CAAC,QAAQ,IAAI,CAAC;IAQhB,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;aAItC,WAAW,IAAI,MAAM;IAE9B,QAAQ;CAGlB"}

package/dist/src/GGConfigKey.js

@@ -0,0 +1,79 @@
+import { GGConfig } from "./GGConfig.js";
+import { assureValidConfigPath } from "./assureValidConfigPath.js";
+import { GG_CONFIG } from "./GG_CONFIG.js";
+export class GGConfigKey {
+    static registry = new Map();
+    static hasKey(name) {
+        return GGConfigKey.registry.has(name);
+    }
+    static getKey(name) {
+        const result = GGConfigKey.registry.get(name);
+        if (result === undefined) {
+            throw new Error(`Config key not found: ${name}`);
+        }
+        return result;
+    }
+    root;
+    name;
+    description;
+    schema;
+    /** File location where this ConfigKey was defined (file:line:col) */
+    definedAt;
+    constructor(name, schema, description) {
+        this.definedAt = captureDefinitionLocation();
+        const ctx = GGConfig.getCreationContext();
+        ctx.add(this);
+        this.root = ctx.name;
+        this.name = this.root + name;
+        assureValidConfigPath(this.name);
+        this.description = description;
+        this.schema = schema;
+        Object.freeze(this);
+        if (GGConfigKey.registry.has(this.name)) {
+            throw new Error(`Duplicate config key: ${this.name}`);
+        }
+        GGConfigKey.registry.set(this.name, this);
+    }
+    getDefault() {
+        return undefined;
+    }
+    getValue() {
+        const store = this.getStore();
+        if (!store.started) {
+            throw new Error(`Cannot read config key "${this.name}" before the config store has been started.`);
+        }
+        return store.getValue(this);
+    }
+    watch(listener) {
+        return this.getStore().watch(this, listener);
+    }
+    getStore() {
+        return GG_CONFIG.get().getStore(this.constructor);
+    }
+}
+function captureDefinitionLocation() {
+    const stack = new Error().stack;
+    /* This could be one possible error we are filtering for.
+    Error
+    at captureDefinitionLocation (\GG_ROOT\packages\config\src\GGConfigKey.ts:24:19)
+    at new GGConfigKey (\GG_ROOT\packages\config\src\GGConfigKey.ts:60:26)
+    at new GGResource (\GG_ROOT\packages\config\src\keys\GGResource.ts:3:8)
+    at Object.createAwsSnsProviderConfig (\GG_ROOT\packages-libs\events\events-aws\src\AwsSnsAdapter.ts:26:19)
+    at new EventPublisherConfig (\GG_ROOT\packages-libs\events\events\src\pub\EventPublisherConfig.ts:56:52)
+    at EventPublisherResource.config (\GG_ROOT\packages-libs\events\events\src\pub\EventPublisherResource.ts:39:16)
+    at <anonymous> (\GG_ROOT\examples\checklist\checklist\ChecklistConfig.ts:26:41)
+    at AsyncLocalStorage.run (node:internal/async_local_storage/async_context_frame:63:14)
+    at GGConfig.define (\GG_ROOT\packages\config\src\GGConfig.ts:27:38)
+    at <anonymous> (\GG_ROOT\examples\checklist\checklist\ChecklistConfig.ts:8:41)
+     */
+    const lines = stack.split('\n').reverse();
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        // Remember that minification might change the names of things.
+        if (lines[i - 1]?.includes('at AsyncLocalStorage.run ') && line?.includes('at <anonymous>')) {
+            return line.substring(0, line.length - 1).trim().replace("at <anonymous> (", "");
+        }
+    }
+    return stack;
+}
+//# sourceMappingURL=GGConfigKey.js.map

package/dist/src/GGConfigKey.js.map

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

package/dist/src/GGConfigLocator.d.ts

@@ -0,0 +1,35 @@
+import { GGConfigStore } from "./GGConfigStore";
+import { GGConfigKey, GGConfigKeyConstructor } from "./GGConfigKey";
+import { ConfigValues, GGConfigStoreLocal } from "./stores/GGConfigStoreLocal";
+export type GGConfigDefinition<T> = T & {
+    __isGGConfigDefinition: never;
+    __getKeysMap: () => ReadonlyMap<GGConfigKeyConstructor, GGConfigKey[]>;
+};
+export declare class GGConfigLocator<T extends object> {
+    #private;
+    protected readonly localConfig: GGConfigStoreLocal<T, any>;
+    /**
+     * @param config - Config definition.
+     * @param localConfig - Optional local config values. If provided, stores will use this instead of the real values when not running in production.
+     *  new GGConfigLocator(MyConfig, localConfig) is shorthand for this: new GGConfigLocator(MyConfig).add(AllKeys, new GGConfigStoreLocal(MyConfig, localConfig))
+     */
+    constructor(config: GGConfigDefinition<T>, localConfig?: ConfigValues<T>);
+    /**
+     * Can override this if you want custom handling.
+     */
+    onNotifyError: (error: Error) => never;
+    /**
+     * Add a config store for a key type.
+     *
+     * Note for framework development: Testkit overrides this function.
+     */
+    add<Key extends GGConfigKey>(key: GGConfigKeyConstructor<Key> | GGConfigKeyConstructor<Key>[], store: GGConfigStore<Key>): this;
+    protected _useLocalStoreIfNeeded<Key extends GGConfigKey>(store: GGConfigStore<Key>): GGConfigStore<Key>;
+    protected _add<Key extends GGConfigKey>(key: GGConfigKeyConstructor<Key> | GGConfigKeyConstructor<Key>[], store: GGConfigStore<Key>): this;
+    getStore<Key extends GGConfigKey>(keyType: GGConfigKeyConstructor<Key>): GGConfigStore<Key>;
+    getStoreByConfigKeyName<Key extends GGConfigKey>(name: string): GGConfigStore<Key>;
+    getStores(): GGConfigStore<GGConfigKey>[];
+    start(): Promise<void>;
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=GGConfigLocator.d.ts.map

package/dist/src/GGConfigLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigLocator.d.ts","sourceRoot":"","sources":["../../src/GGConfigLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAE,sBAAsB,EAAC,MAAM,eAAe,CAAC;AAGlE,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAE7E,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG;IACpC,sBAAsB,EAAE,KAAK,CAAC;IAC9B,YAAY,EAAE,MAAM,WAAW,CAAC,sBAAsB,EAAE,WAAW,EAAE,CAAC,CAAA;CACzE,CAAC;AAEF,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM;;IAOzC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAY;IAEtE;;;;OAIG;gBACS,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAWxE;;OAEG;IACI,aAAa,GAAI,OAAO,KAAK,KAAG,KAAK,CAE3C;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAG,SAAS,WAAW,EAAE,GAAG,EAAE,sBAAsB,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI;IAItI,SAAS,CAAC,sBAAsB,CAAC,GAAG,SAAS,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC;IAQxG,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,WAAW,EAAE,GAAG,EAAE,sBAAsB,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI;IAiBnI,QAAQ,CAAC,GAAG,SAAS,WAAW,EAAE,OAAO,EAAE,sBAAsB,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC;IAI3F,uBAAuB,CAAC,GAAG,SAAS,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC;IAQlF,SAAS,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE;IAInC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/dist/src/GGConfigLocator.js

@@ -0,0 +1,95 @@
+import { GGLocator, GGLocatorServiceType } from "@grest-ts/locator";
+import { GG_CONFIG } from "./GG_CONFIG.js";
+import { GGConfigStoreLocal } from "./stores/GGConfigStoreLocal.js";
+export class GGConfigLocator {
+    #isStarted = false;
+    #config;
+    #storesList = [];
+    #storesMap = new Map();
+    localConfig = undefined;
+    /**
+     * @param config - Config definition.
+     * @param localConfig - Optional local config values. If provided, stores will use this instead of the real values when not running in production.
+     *  new GGConfigLocator(MyConfig, localConfig) is shorthand for this: new GGConfigLocator(MyConfig).add(AllKeys, new GGConfigStoreLocal(MyConfig, localConfig))
+     */
+    constructor(config, localConfig) {
+        if (!config)
+            throw new Error("Config definition is required");
+        this.#config = config;
+        this.localConfig = localConfig ? new GGConfigStoreLocal(config, localConfig) : undefined;
+        GGLocator.getScope().setWithLifecycle(GG_CONFIG, this, {
+            type: GGLocatorServiceType.CONFIG,
+            start: () => this.start(),
+            teardown: () => this.teardown()
+        });
+    }
+    /**
+     * Can override this if you want custom handling.
+     */
+    onNotifyError = (error) => {
+        throw error;
+    };
+    /**
+     * Add a config store for a key type.
+     *
+     * Note for framework development: Testkit overrides this function.
+     */
+    add(key, store) {
+        return this._add(key, this._useLocalStoreIfNeeded(store));
+    }
+    _useLocalStoreIfNeeded(store) {
+        if (process.env.NODE_ENV === "production" || !this.localConfig) {
+            return store;
+        }
+        else {
+            return this.localConfig;
+        }
+    }
+    _add(key, store) {
+        if (this.#isStarted) {
+            throw new Error("Cannot add store after config holder is started");
+        }
+        const keyTypes = Array.isArray(key) ? key : [key];
+        const keysMap = this.#config.__getKeysMap();
+        for (const keyType of keyTypes) {
+            const keysForType = (keysMap.get(keyType) ?? []);
+            store.setKeys(keysForType);
+            this.#storesMap.set(keyType.NAME, store);
+        }
+        if (!this.#storesList.includes(store)) {
+            this.#storesList.push(store);
+        }
+        return this;
+    }
+    getStore(keyType) {
+        return this.getStoreByConfigKeyName(keyType.NAME);
+    }
+    getStoreByConfigKeyName(name) {
+        const store = this.#storesMap.get(name);
+        if (!store) {
+            throw new Error(`No store for store key: ${name ?? 'undefined'}.`);
+        }
+        return store;
+    }
+    getStores() {
+        return this.#storesList;
+    }
+    async start() {
+        if (this.#isStarted) {
+            throw new Error("Already started");
+        }
+        this.#isStarted = true;
+        this.#config.__getKeysMap().forEach((_, keyType) => {
+            if (!this.#storesMap.has(keyType.NAME)) {
+                throw new Error(`Missing stores for config key type '${keyType.NAME}'`);
+            }
+        });
+        Object.freeze(this.#storesMap);
+        Object.freeze(this.#storesList);
+        await Promise.all(this.#storesList.map((store) => store.start()));
+    }
+    async teardown() {
+        await Promise.all(this.#storesList.map(s => s.teardown()));
+    }
+}
+//# sourceMappingURL=GGConfigLocator.js.map

package/dist/src/GGConfigLocator.js.map

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

package/dist/src/GGConfigStore.d.ts

@@ -0,0 +1,24 @@
+import { GGConfigKey } from "./GGConfigKey";
+export type ConfigUpdateCallback = (value: any) => void | Promise<void>;
+/**
+ * Important when extending: Use resolveValue() to resolve and validate config values.
+ */
+export declare abstract class GGConfigStore<Key extends GGConfigKey> {
+    #private;
+    get keys(): readonly Key[];
+    protected isStarted: boolean;
+    get started(): boolean;
+    setKeys(keys: readonly Key[]): void;
+    abstract getValue<T>(key: GGConfigKey<T>): T;
+    /**
+     * Resolves the final value for a config key: uses storeValue if present, falls back to key.getDefault(),
+     * then validates against schema. If the resolved value is undefined and the schema doesn't allow it,
+     * validation will fail — this is how missing required keys are caught.
+     */
+    protected resolveValue<T>(key: GGConfigKey<T>, storeValue: unknown, isInitialLoad?: boolean): T;
+    start(): Promise<void>;
+    teardown(): Promise<void>;
+    watch(key: GGConfigKey, callback: ConfigUpdateCallback): () => void;
+    notify(key: GGConfigKey): Promise<void>;
+}
+//# sourceMappingURL=GGConfigStore.d.ts.map

package/dist/src/GGConfigStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigStore.d.ts","sourceRoot":"","sources":["../../src/GGConfigStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAG1C,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE;;GAEG;AACH,8BAAsB,aAAa,CAAC,GAAG,SAAS,WAAW;;IAGvD,IAAW,IAAI,IAAI,SAAS,GAAG,EAAE,CAAsB;IAGvD,SAAS,CAAC,SAAS,UAAS;IAE5B,IAAW,OAAO,IAAI,OAAO,CAE5B;IAEM,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI;aAO1B,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAEnD;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAE,OAAe,GAAG,CAAC;IAWzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAa7D,MAAM,CAAC,GAAG,EAAE,WAAW;CAwBvC"}

package/dist/src/GGConfigStore.js

@@ -0,0 +1,89 @@
+import { GG_CONFIG } from "./GG_CONFIG.js";
+/**
+ * Important when extending: Use resolveValue() to resolve and validate config values.
+ */
+export class GGConfigStore {
+    #keys = [];
+    get keys() { return this.#keys; }
+    #watchers = new Map();
+    isStarted = false;
+    get started() {
+        return this.isStarted;
+    }
+    setKeys(keys) {
+        if (this.isStarted) {
+            throw new Error(`Cannot set keys after store is started: ${this.constructor.name}`);
+        }
+        this.#keys.push(...keys);
+    }
+    /**
+     * Resolves the final value for a config key: uses storeValue if present, falls back to key.getDefault(),
+     * then validates against schema. If the resolved value is undefined and the schema doesn't allow it,
+     * validation will fail — this is how missing required keys are caught.
+     */
+    resolveValue(key, storeValue, isInitialLoad = false) {
+        const val = storeValue !== undefined ? storeValue : key.getDefault();
+        const check = key.schema.safeParse(val);
+        if (check.success === false) {
+            const errors = JSON.stringify(check.issues.toJSON(), null, 2).replaceAll("\n", "\n\t\t");
+            throw new Error(`Config validation failed for "${key.name}" during ${isInitialLoad ? "initial-load" : "reload"}.\n\tDefined at:\n\t\t${key.definedAt}\n\tIssues:\n\t\t${errors}`);
+        }
+        else {
+            return check.value;
+        }
+    }
+    async start() {
+        if (this.isStarted === true) {
+            throw new Error(`Config store already started: ${this.constructor.name}`);
+        }
+        this.isStarted = true;
+        Object.freeze(this.#keys);
+        this.keys.forEach(key => {
+            this.getValue(key); // Get every value so that config values are definitely initialized (or they would throw)
+        });
+    }
+    async teardown() {
+        this.#watchers.clear();
+        this.isStarted = false;
+    }
+    watch(key, callback) {
+        if (!this.#watchers.has(key)) {
+            this.#watchers.set(key, []);
+        }
+        this.#watchers.get(key).push(callback);
+        return () => {
+            const list = this.#watchers.get(key);
+            if (!list)
+                return;
+            const index = list.indexOf(callback);
+            if (index >= 0)
+                list.splice(index, 1);
+        };
+    }
+    async notify(key) {
+        if (this.#watchers.has(key)) {
+            const promises = [];
+            const newValue = this.getValue(key);
+            this.#watchers.get(key).forEach(callback => {
+                try {
+                    const result = callback(newValue);
+                    if (result instanceof Promise) {
+                        promises.push(result);
+                    }
+                }
+                catch (err) {
+                    GG_CONFIG.get().onNotifyError(err);
+                }
+            });
+            if (promises.length > 0) {
+                const results = await Promise.allSettled(promises);
+                for (const result of results) {
+                    if (result.status === 'rejected') {
+                        GG_CONFIG.get().onNotifyError(result.reason);
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=GGConfigStore.js.map

package/dist/src/GGConfigStore.js.map

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

package/dist/src/GG_CONFIG.d.ts

@@ -0,0 +1,4 @@
+import { GGLocatorKey } from "@grest-ts/locator";
+import type { GGConfigLocator } from "./GGConfigLocator";
+export declare const GG_CONFIG: GGLocatorKey<GGConfigLocator<any>>;
+//# sourceMappingURL=GG_CONFIG.d.ts.map

package/dist/src/GG_CONFIG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GG_CONFIG.d.ts","sourceRoot":"","sources":["../../src/GG_CONFIG.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAEvD,eAAO,MAAM,SAAS,oCAAqD,CAAC"}

package/dist/src/GG_CONFIG.js

@@ -0,0 +1,3 @@
+import { GGLocatorKey } from "@grest-ts/locator";
+export const GG_CONFIG = new GGLocatorKey("GGConfig");
+//# sourceMappingURL=GG_CONFIG.js.map

package/dist/src/GG_CONFIG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GG_CONFIG.js","sourceRoot":"","sources":["../../src/GG_CONFIG.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAG/C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAuB,UAAU,CAAC,CAAC"}

package/dist/src/assureValidConfigPath.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validates config key name for compatibility with external providers.
+ * Rules:
+ * - Must start with forward slash
+ * - Only letters, numbers, underscore, forward slash allowed
+ * - Each segment (word) must start with a letter
+ * - No double slashes
+ * - Cannot end with slash
+ * - Max 2048 characters (AWS limit)
+ */
+export declare function assureValidConfigPath(path: string): void;
+//# sourceMappingURL=assureValidConfigPath.d.ts.map

package/dist/src/assureValidConfigPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assureValidConfigPath.d.ts","sourceRoot":"","sources":["../../src/assureValidConfigPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,QAuBjD"}

package/dist/src/assureValidConfigPath.js

@@ -0,0 +1,35 @@
+/**
+ * Validates config key name for compatibility with external providers.
+ * Rules:
+ * - Must start with forward slash
+ * - Only letters, numbers, underscore, forward slash allowed
+ * - Each segment (word) must start with a letter
+ * - No double slashes
+ * - Cannot end with slash
+ * - Max 2048 characters (AWS limit)
+ */
+export function assureValidConfigPath(path) {
+    if (path.length > 2048) {
+        throw new Error(`Config key name exceeds 2048 characters: ${path}`);
+    }
+    if (!path.startsWith('/')) {
+        throw new Error(`Config key name must start with '/': ${path}`);
+    }
+    if (path.endsWith('/')) {
+        throw new Error(`Config key name cannot end with '/': ${path}`);
+    }
+    if (path.includes('//')) {
+        throw new Error(`Config key name cannot contain '//': ${path}`);
+    }
+    if (!/^[a-zA-Z0-9_\/]+$/.test(path)) {
+        throw new Error(`Config key name contains invalid characters (allowed: a-z, A-Z, 0-9, _, /): ${path}`);
+    }
+    // Each segment must start with a letter
+    const segments = path.split('/').filter(s => s.length > 0);
+    for (const segment of segments) {
+        if (!/^[a-zA-Z]/.test(segment)) {
+            throw new Error(`Each path segment must start with a letter: ${path}`);
+        }
+    }
+}
+//# sourceMappingURL=assureValidConfigPath.js.map

package/dist/src/assureValidConfigPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assureValidConfigPath.js","sourceRoot":"","sources":["../../src/assureValidConfigPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+EAA+E,IAAI,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,wCAAwC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/src/index-node.d.ts

@@ -0,0 +1,12 @@
+export * from './GGConfig';
+export * from './GG_CONFIG';
+export * from './GGConfigLocator';
+export * from "./GGConfigKey";
+export * from "./GGConfigStore";
+export * from "./stores/GGConfigStoreFile";
+export * from "./stores/GGConfigStoreLocal";
+export * from "./keys/GGSetting";
+export * from "./keys/GGSecret";
+export * from "./keys/GGResource";
+export { assureValidConfigPath } from "./assureValidConfigPath";
+//# sourceMappingURL=index-node.d.ts.map