@grest-ts/config 0.0.5

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC"}

package/dist/src/index-node.js

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

package/dist/src/index-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC"}

package/dist/src/keys/GGResource.d.ts

@@ -0,0 +1,9 @@
+import { GGConfigKey } from "../GGConfigKey";
+import { GGValidator } from "@grest-ts/schema";
+export declare class GGResource<T> extends GGConfigKey<T> {
+    static readonly NAME = "[GGResource]";
+    constructor(name: string, schema: GGValidator<T>, description: string);
+    getStoreKey(): string;
+    get(): T;
+}
+//# sourceMappingURL=GGResource.d.ts.map

package/dist/src/keys/GGResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGResource.d.ts","sourceRoot":"","sources":["../../../src/keys/GGResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAE7C,gBAAuB,IAAI,kBAAkB;gBAEjC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM;IAI9D,WAAW,IAAI,MAAM;IAIrB,GAAG,IAAI,CAAC;CAIlB"}

package/dist/src/keys/GGResource.js

@@ -0,0 +1,14 @@
+import { GGConfigKey } from "../GGConfigKey.js";
+export class GGResource extends GGConfigKey {
+    static NAME = "[GGResource]";
+    constructor(name, schema, description) {
+        super(name, schema, description);
+    }
+    getStoreKey() {
+        return GGResource.NAME;
+    }
+    get() {
+        return this.getValue();
+    }
+}
+//# sourceMappingURL=GGResource.js.map

package/dist/src/keys/GGResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGResource.js","sourceRoot":"","sources":["../../../src/keys/GGResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAG3C,MAAM,OAAO,UAAc,SAAQ,WAAc;IAEtC,MAAM,CAAU,IAAI,GAAG,cAAc,CAAC;IAE7C,YAAY,IAAY,EAAE,MAAsB,EAAE,WAAmB;QACjE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;IAEM,WAAW;QACd,OAAO,UAAU,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEM,GAAG;QACN,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC"}

package/dist/src/keys/GGSecret.d.ts

@@ -0,0 +1,9 @@
+import { GGConfigKey } from "../GGConfigKey";
+import { GGValidator } from "@grest-ts/schema";
+export declare class GGSecret<T> extends GGConfigKey<T> {
+    static readonly NAME = "[GGSecret]";
+    constructor(name: string, schema: GGValidator<T>, description: string);
+    getStoreKey(): string;
+    reveal(): T;
+}
+//# sourceMappingURL=GGSecret.d.ts.map

package/dist/src/keys/GGSecret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGSecret.d.ts","sourceRoot":"","sources":["../../../src/keys/GGSecret.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,QAAQ,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAE3C,gBAAuB,IAAI,gBAAgB;gBAE/B,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM;IAI9D,WAAW,IAAI,MAAM;IAIrB,MAAM,IAAI,CAAC;CAIrB"}

package/dist/src/keys/GGSecret.js

@@ -0,0 +1,14 @@
+import { GGConfigKey } from "../GGConfigKey.js";
+export class GGSecret extends GGConfigKey {
+    static NAME = "[GGSecret]";
+    constructor(name, schema, description) {
+        super(name, schema, description);
+    }
+    getStoreKey() {
+        return GGSecret.NAME;
+    }
+    reveal() {
+        return this.getValue();
+    }
+}
+//# sourceMappingURL=GGSecret.js.map

package/dist/src/keys/GGSecret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGSecret.js","sourceRoot":"","sources":["../../../src/keys/GGSecret.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAG3C,MAAM,OAAO,QAAY,SAAQ,WAAc;IAEpC,MAAM,CAAU,IAAI,GAAG,YAAY,CAAC;IAE3C,YAAY,IAAY,EAAE,MAAsB,EAAE,WAAmB;QACjE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;IAEM,WAAW;QACd,OAAO,QAAQ,CAAC,IAAI,CAAA;IACxB,CAAC;IAEM,MAAM;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC"}

package/dist/src/keys/GGSetting.d.ts

@@ -0,0 +1,11 @@
+import { GGConfigKey, Widen } from "../GGConfigKey";
+import { GGValidator } from "@grest-ts/schema";
+export declare class GGSetting<T> extends GGConfigKey<T> {
+    #private;
+    static readonly NAME = "[GGSetting]";
+    constructor(name: string, schema: GGValidator<T>, defaultValue: Widen<T>, description: string);
+    getDefault(): T;
+    getStoreKey(): string;
+    get(): T;
+}
+//# sourceMappingURL=GGSetting.d.ts.map

package/dist/src/keys/GGSetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGSetting.d.ts","sourceRoot":"","sources":["../../../src/keys/GGSetting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;;IAE5C,gBAAuB,IAAI,iBAAiB;gBAIhC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM;IAK7E,UAAU,IAAI,CAAC;IAIxB,WAAW,IAAI,MAAM;IAIrB,GAAG,IAAI,CAAC;CAIlB"}

package/dist/src/keys/GGSetting.js

@@ -0,0 +1,20 @@
+import { GGConfigKey } from "../GGConfigKey.js";
+import { deepFreeze } from "@grest-ts/common";
+export class GGSetting extends GGConfigKey {
+    static NAME = "[GGSetting]";
+    #default;
+    constructor(name, schema, defaultValue, description) {
+        super(name, schema, description);
+        this.#default = deepFreeze(defaultValue);
+    }
+    getDefault() {
+        return this.#default;
+    }
+    getStoreKey() {
+        return GGSetting.NAME;
+    }
+    get() {
+        return this.getValue();
+    }
+}
+//# sourceMappingURL=GGSetting.js.map

package/dist/src/keys/GGSetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGSetting.js","sourceRoot":"","sources":["../../../src/keys/GGSetting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAQ,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAG5C,MAAM,OAAO,SAAa,SAAQ,WAAc;IAErC,MAAM,CAAU,IAAI,GAAG,aAAa,CAAC;IAEnC,QAAQ,CAAI;IAErB,YAAY,IAAY,EAAE,MAAsB,EAAE,YAAsB,EAAE,WAAmB;QACzF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,YAAiB,CAAC,CAAC;IAClD,CAAC;IAEe,UAAU;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,WAAW;QACd,OAAO,SAAS,CAAC,IAAI,CAAA;IACzB,CAAC;IAEM,GAAG;QACN,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC"}

package/dist/src/stores/GGConfigStoreFile.d.ts

@@ -0,0 +1,17 @@
+import { GGConfigStore } from "../GGConfigStore";
+import { GGConfigKey } from "../GGConfigKey";
+/**
+ * Local file-based settings strategy.
+ * Reads settings from settings.json in the config directory.
+ * Watches file for changes and automatically reloads.
+ */
+export declare class GGConfigStoreFile<Key extends GGConfigKey> extends GGConfigStore<Key> {
+    #private;
+    private readonly file;
+    constructor(file: string, moduleUrl?: string);
+    start(): Promise<void>;
+    teardown(): Promise<void>;
+    refresh(isInitialLoad: boolean): Promise<void>;
+    getValue<T>(key: GGConfigKey<T>): T;
+}
+//# sourceMappingURL=GGConfigStoreFile.d.ts.map

package/dist/src/stores/GGConfigStoreFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigStoreFile.d.ts","sourceRoot":"","sources":["../../../src/stores/GGConfigStoreFile.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAI3C;;;;GAIG;AACH,qBAAa,iBAAiB,CAAC,GAAG,SAAS,WAAW,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC;;IAE9E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAKlB,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAMtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC,OAAO,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;CAI7C"}

package/dist/src/stores/GGConfigStoreFile.js

@@ -0,0 +1,62 @@
+import * as fs from 'fs';
+import { GGConfigStore } from "../GGConfigStore.js";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Local file-based settings strategy.
+ * Reads settings from settings.json in the config directory.
+ * Watches file for changes and automatically reloads.
+ */
+export class GGConfigStoreFile extends GGConfigStore {
+    file;
+    #watcher = null;
+    #debounceTimer = null;
+    #valuesCache = new Map();
+    constructor(file, moduleUrl) {
+        super();
+        const prefix = moduleUrl ? dirname(fileURLToPath(moduleUrl)) : "";
+        this.file = join(prefix, file);
+    }
+    async start() {
+        await super.start();
+        await this.refresh(true);
+        this.#watcher = fs.watch(this.file, (eventType) => {
+            if (eventType === 'change') {
+                if (this.#debounceTimer)
+                    clearTimeout(this.#debounceTimer);
+                // Adding debounce so file writes would have time to correctly complete.
+                this.#debounceTimer = setTimeout(() => this.refresh(false), 100);
+            }
+        });
+    }
+    async teardown() {
+        if (this.#watcher) {
+            this.#watcher.close();
+            this.#watcher = null;
+        }
+        await super.teardown();
+    }
+    async refresh(isInitialLoad) {
+        const fileContent = fs.readFileSync(this.file, 'utf-8');
+        if (!fileContent) {
+            throw new Error("Settings file is empty! Why is that?");
+        }
+        const fileJson = JSON.parse(fileContent);
+        this.#valuesCache.clear();
+        this.keys.forEach(key => {
+            const path = key.name.split("/");
+            let val = undefined;
+            if (path.length > 1) {
+                val = fileJson;
+                for (let i = 1; i < path.length; i++) {
+                    val = val?.[path[i]];
+                }
+            }
+            this.#valuesCache.set(key, this.resolveValue(key, val, isInitialLoad));
+        });
+    }
+    getValue(key) {
+        return this.#valuesCache.get(key);
+    }
+}
+//# sourceMappingURL=GGConfigStoreFile.js.map

package/dist/src/stores/GGConfigStoreFile.js.map

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

package/dist/src/stores/GGConfigStoreLocal.d.ts

@@ -0,0 +1,54 @@
+import { GGConfigStore } from "../GGConfigStore";
+import { GGConfigKey, Widen } from "../GGConfigKey";
+/**
+ * Extracts the keys from T that are GGConfigKey instances or objects containing them.
+ * Uses a depth limit (D) to prevent infinite recursion on circular types (e.g. GGSchema).
+ */
+type ConfigKeyOf<T, D extends 1[] = []> = D['length'] extends 5 ? never : {
+    [K in keyof T]: [T[K]] extends [never] ? never : T[K] extends GGConfigKey<any> ? K : T[K] extends Function ? never : T[K] extends object ? (ConfigKeyOf<T[K], [...D, 1]> extends never ? never : K) : never;
+}[keyof T];
+/**
+ * Maps a config definition to the shape of values it expects.
+ * GGConfigKey<V> → V, objects with config keys → recurse, everything else → excluded.
+ */
+export type ConfigValues<T, D extends 1[] = []> = D['length'] extends 5 ? never : T extends GGConfigKey<infer V> ? Widen<V> : T extends object ? (ConfigKeyOf<T, D> extends never ? never : {
+    [K in ConfigKeyOf<T, D>]: ConfigValues<T[K], [...D, 1]>;
+}) : never;
+/**
+ * Type-checks a local config values object against a config definition.
+ * Returns the values object as-is — this is a compile-time helper, not a store.
+ *
+ * Use with GGConfigStoreLocal in your runtime's compose():
+ * @example
+ * ```typescript
+ * // config/local.ts — just data:
+ * export default createLocalConfig(MyConfig, {
+ *     mysql: {
+ *         host: { host: "localhost", port: 3306, database: "mydb" },
+ *         user: { username: "root", password: "root" },
+ *     },
+ *     jwtSecret: "dev-secret",
+ * })
+ *
+ * // runtime.ts — fresh store per compose():
+ * import localConfig from "./config/local.js";
+ * new GGConfigLocator(MyConfig)
+ *     .add([GGResource, GGSecret], new GGConfigStoreLocal(MyConfig, localConfig))
+ * ```
+ */
+export declare function createLocalConfig<T extends object>(_config: T, values: ConfigValues<T>): ConfigValues<T>;
+/**
+ * Type-safe local development config store.
+ * Refuses to start in production — crashes immediately if NODE_ENV is "production".
+ * Use createLocalConfig() for the best DX, or .set() for manual control.
+ */
+export declare class GGConfigStoreLocal<Struct extends object, Key extends GGConfigKey = GGConfigKey> extends GGConfigStore<Key> {
+    #private;
+    constructor(config: Struct, values: ConfigValues<Struct>);
+    set<T>(key: GGConfigKey<T>, value: T): this;
+    start(): Promise<void>;
+    teardown(): Promise<void>;
+    getValue<T>(key: GGConfigKey<T>): T;
+}
+export {};
+//# sourceMappingURL=GGConfigStoreLocal.d.ts.map

package/dist/src/stores/GGConfigStoreLocal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigStoreLocal.d.ts","sourceRoot":"","sources":["../../../src/stores/GGConfigStoreLocal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAE,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAGlD;;;GAGG;AACH,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,KAAK,GAAG;KACrE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,GAC1C,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,GAC7B,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,KAAK,GACzB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK;CACrG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAC1C,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,KAAK,GACzB,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GACrC,CAAC,SAAS,MAAM,GAAG,CACf,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG;KAAG,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;CAAE,CACpG,GAAG,KAAK,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAGxG;AAED;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,MAAM,SAAS,MAAM,EAAE,GAAG,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC;;gBAKxG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;IAKjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAK5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;CAI7C"}

package/dist/src/stores/GGConfigStoreLocal.js

@@ -0,0 +1,76 @@
+import { GGConfigStore } from "../GGConfigStore.js";
+import { GGConfigKey } from "../GGConfigKey.js";
+import { deepFreeze } from "@grest-ts/common";
+/**
+ * Type-checks a local config values object against a config definition.
+ * Returns the values object as-is — this is a compile-time helper, not a store.
+ *
+ * Use with GGConfigStoreLocal in your runtime's compose():
+ * @example
+ * ```typescript
+ * // config/local.ts — just data:
+ * export default createLocalConfig(MyConfig, {
+ *     mysql: {
+ *         host: { host: "localhost", port: 3306, database: "mydb" },
+ *         user: { username: "root", password: "root" },
+ *     },
+ *     jwtSecret: "dev-secret",
+ * })
+ *
+ * // runtime.ts — fresh store per compose():
+ * import localConfig from "./config/local.js";
+ * new GGConfigLocator(MyConfig)
+ *     .add([GGResource, GGSecret], new GGConfigStoreLocal(MyConfig, localConfig))
+ * ```
+ */
+export function createLocalConfig(_config, values) {
+    deepFreeze(values);
+    return values;
+}
+/**
+ * Type-safe local development config store.
+ * Refuses to start in production — crashes immediately if NODE_ENV is "production".
+ * Use createLocalConfig() for the best DX, or .set() for manual control.
+ */
+export class GGConfigStoreLocal extends GGConfigStore {
+    #values = new Map();
+    #valuesCache = new Map();
+    constructor(config, values) {
+        super();
+        walkAndSet(this, config, values);
+    }
+    set(key, value) {
+        this.#values.set(key, value);
+        return this;
+    }
+    async start() {
+        if (process.env.NODE_ENV === "production") {
+            throw new Error("GGConfigStoreLocal cannot be used in production. " +
+                "Use GGConfigStoreAwsSecretsManager or another production-safe store.");
+        }
+        this.keys.forEach(key => {
+            this.#valuesCache.set(key, this.resolveValue(key, this.#values.get(key), true));
+        });
+        await super.start();
+    }
+    async teardown() {
+        this.#valuesCache.clear();
+        await super.teardown();
+    }
+    getValue(key) {
+        return this.#valuesCache.get(key);
+    }
+}
+function walkAndSet(store, config, values) {
+    for (const prop of Object.keys(values)) {
+        const configEntry = config[prop];
+        const value = values[prop];
+        if (configEntry instanceof GGConfigKey) {
+            store.set(configEntry, value);
+        }
+        else if (configEntry != null && typeof configEntry === 'object' && value != null && typeof value === 'object') {
+            walkAndSet(store, configEntry, value);
+        }
+    }
+}
+//# sourceMappingURL=GGConfigStoreLocal.js.map

package/dist/src/stores/GGConfigStoreLocal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigStoreLocal.js","sourceRoot":"","sources":["../../../src/stores/GGConfigStoreLocal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAQ,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAwB5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAAmB,OAAU,EAAE,MAAuB;IACnF,UAAU,CAAC,MAAM,CAAC,CAAA;IAClB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAiF,SAAQ,aAAkB;IAE3G,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC1C,YAAY,GAAG,IAAI,GAAG,EAAwB,CAAC;IAExD,YAAY,MAAc,EAAE,MAA4B;QACpD,KAAK,EAAE,CAAC;QACR,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAEM,GAAG,CAAI,GAAmB,EAAE,KAAQ;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAEe,KAAK,CAAC,KAAK;QACvB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACX,mDAAmD;gBACnD,sEAAsE,CACzE,CAAC;QACN,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACpB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEe,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAEM,QAAQ,CAAI,GAAmB;QAClC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;IAC3C,CAAC;CAEJ;AAED,SAAS,UAAU,CAAC,KAA8B,EAAE,MAAW,EAAE,MAAW;IACxE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,WAAW,YAAY,WAAW,EAAE,CAAC;YACrC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9G,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/src/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "//": "THIS FILE IS GENERATED - DO NOT EDIT",
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "lib": [
+      "ES2022"
+    ],
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "**/*"
+  ]
+}

package/dist/testkit/GGConfigCommands.d.ts

@@ -0,0 +1,18 @@
+export interface ConfigUpdatePayload {
+    storeName: string;
+    keyName: string;
+    value: unknown;
+}
+export interface ConfigGetPayload {
+    storeName: string;
+    keyName: string;
+}
+export declare const GGConfigIPC: {
+    worker: {
+        update: import("@grest-ts/ipc").IPCClientRequest<ConfigUpdatePayload, void>;
+        replace: import("@grest-ts/ipc").IPCClientRequest<ConfigUpdatePayload, void>;
+        get: import("@grest-ts/ipc").IPCClientRequest<ConfigGetPayload, unknown>;
+        resetAfterTest: import("@grest-ts/ipc").IPCClientRequest<void, void>;
+    };
+};
+//# sourceMappingURL=GGConfigCommands.d.ts.map

package/dist/testkit/GGConfigCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigCommands.d.ts","sourceRoot":"","sources":["../../testkit/GGConfigCommands.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,WAAW;;;;;;;CAOvB,CAAA"}

package/dist/testkit/GGConfigCommands.js

@@ -0,0 +1,42 @@
+import { GG_TEST_RUNTIME_WORKER, GGTestRuntimeWorker } from "@grest-ts/testkit";
+import { IPCClient } from "@grest-ts/ipc";
+import { GGConfigTestStore } from "./GGConfigTestStore.js";
+import { GGConfigKey } from "../src/GGConfigKey.js";
+import { GG_CONFIG } from "../src/GG_CONFIG.js";
+export const GGConfigIPC = {
+    worker: {
+        update: IPCClient.defineRequest("config.update"),
+        replace: IPCClient.defineRequest("config.replace"),
+        get: IPCClient.defineRequest("config.get"),
+        resetAfterTest: IPCClient.defineRequest("config.resetAfterTest"),
+    }
+};
+// Register handler - safe at module load time, executed during worker.start()
+GGTestRuntimeWorker.onBeforeRuntimeStart(() => {
+    const worker = GG_TEST_RUNTIME_WORKER.get();
+    const getStore = (storeName) => {
+        const store = GG_CONFIG.get().getStoreByConfigKeyName(storeName);
+        if (!(store instanceof GGConfigTestStore))
+            throw new Error("Store is not wrapped with GGConfigTestStore");
+        return store;
+    };
+    worker.ipcClient.onFrameworkRequest(GGConfigIPC.worker.get, async (payload) => {
+        worker.runtime.scope.enter();
+        return getStore(payload.storeName).getValue(GGConfigKey.getKey(payload.keyName));
+    });
+    worker.ipcClient.onFrameworkRequest(GGConfigIPC.worker.update, async (payload) => {
+        worker.runtime.scope.enter();
+        await getStore(payload.storeName).updateValueOverride(GGConfigKey.getKey(payload.keyName), payload.value);
+    });
+    worker.ipcClient.onFrameworkRequest(GGConfigIPC.worker.replace, async (payload) => {
+        worker.runtime.scope.enter();
+        await getStore(payload.storeName).replaceValueOverride(GGConfigKey.getKey(payload.keyName), payload.value);
+    });
+    worker.ipcClient.onFrameworkRequest(GGConfigIPC.worker.resetAfterTest, async () => {
+        worker.runtime.scope.enter();
+        for (const store of GG_CONFIG.get().getStores().values()) {
+            await store.resetAfterTest();
+        }
+    });
+});
+//# sourceMappingURL=GGConfigCommands.js.map

package/dist/testkit/GGConfigCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigCommands.js","sourceRoot":"","sources":["../../testkit/GGConfigCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAa3C,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,MAAM,EAAE;QACJ,MAAM,EAAE,SAAS,CAAC,aAAa,CAA4B,eAAe,CAAC;QAC3E,OAAO,EAAE,SAAS,CAAC,aAAa,CAA4B,gBAAgB,CAAC;QAC7E,GAAG,EAAE,SAAS,CAAC,aAAa,CAA4B,YAAY,CAAC;QACrE,cAAc,EAAE,SAAS,CAAC,aAAa,CAAa,uBAAuB,CAAC;KAC/E;CACJ,CAAA;AAED,8EAA8E;AAC9E,mBAAmB,CAAC,oBAAoB,CAAC,GAAG,EAAE;IAC1C,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,CAAC;IAE5C,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAqB,EAAE;QACtD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC,KAAK,YAAY,iBAAiB,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC1G,OAAO,KAAK,CAAC;IACjB,CAAC,CAAA;IAED,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC1E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC7E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9G,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC9E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;YACvD,MAAO,KAA2B,CAAC,cAAc,EAAE,CAAC;QACxD,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/testkit/GGConfigTestComponent.d.ts

@@ -0,0 +1,9 @@
+import { GGTestComponent, GGTestRunner } from "@grest-ts/testkit";
+export declare class GGConfigTestComponent implements GGTestComponent {
+    private readonly runner;
+    private configModifiedInTest;
+    constructor(runner: GGTestRunner);
+    markConfigModified(): void;
+    afterEach(): Promise<void>;
+}
+//# sourceMappingURL=GGConfigTestComponent.d.ts.map

package/dist/testkit/GGConfigTestComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigTestComponent.d.ts","sourceRoot":"","sources":["../../testkit/GGConfigTestComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAGhE,qBAAa,qBAAsB,YAAW,eAAe;IAEzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,MAAM,EAAE,YAAY;IAIhC,kBAAkB,IAAI,IAAI;IAIpB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAKnC"}

package/dist/testkit/GGConfigTestComponent.js

@@ -0,0 +1,20 @@
+import { GGTestRunner } from "@grest-ts/testkit";
+import { GGConfigIPC } from "./GGConfigCommands.js";
+export class GGConfigTestComponent {
+    runner;
+    configModifiedInTest = false;
+    constructor(runner) {
+        this.runner = runner;
+    }
+    markConfigModified() {
+        this.configModifiedInTest = true;
+    }
+    async afterEach() {
+        if (!this.configModifiedInTest)
+            return;
+        await this.runner.sendCommand(GGConfigIPC.worker.resetAfterTest, undefined);
+        this.configModifiedInTest = false;
+    }
+}
+GGTestRunner.registerExtension(GGConfigTestComponent);
+//# sourceMappingURL=GGConfigTestComponent.js.map

package/dist/testkit/GGConfigTestComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigTestComponent.js","sourceRoot":"","sources":["../../testkit/GGConfigTestComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAE/C,MAAM,OAAO,qBAAqB;IAEb,MAAM,CAAe;IAC9B,oBAAoB,GAAG,KAAK,CAAC;IAErC,YAAY,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,kBAAkB;QACd,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAAS;QACX,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAAE,OAAO;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAC5E,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACtC,CAAC;CACJ;AAED,YAAY,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/testkit/GGConfigTestStore.d.ts

@@ -0,0 +1,23 @@
+import { GGConfigKey } from "../src/GGConfigKey";
+import { ConfigUpdateCallback, GGConfigStore } from "../src/GGConfigStore";
+import { GGTestCommand } from "@grest-ts/testkit";
+import { ConfigUpdatePayload } from "./GGConfigCommands";
+/**
+ * Test config store that wraps a parent store and allows overriding values.
+ * Overrides validation to always throw (fail fast in tests).
+ */
+export declare class GGConfigTestStore<Key extends GGConfigKey = GGConfigKey> extends GGConfigStore<Key> {
+    private readonly wrappedStore;
+    private readonly initialConfigOverridesMap;
+    private readonly activeConfigOverridesMap;
+    constructor(parent: GGConfigStore<Key>, initialOverrides: GGTestCommand<ConfigUpdatePayload>[]);
+    setKeys(keys: readonly Key[]): void;
+    getValue<T>(key: GGConfigKey<T>): T;
+    updateValueOverride(key: GGConfigKey, value: unknown): Promise<void>;
+    replaceValueOverride(key: GGConfigKey, value: unknown): Promise<void>;
+    resetAfterTest(): Promise<void>;
+    watch(key: GGConfigKey, callback: ConfigUpdateCallback): () => void;
+    start(): Promise<void>;
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=GGConfigTestStore.d.ts.map

package/dist/testkit/GGConfigTestStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGConfigTestStore.d.ts","sourceRoot":"","sources":["../../testkit/GGConfigTestStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAyB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAC,oBAAoB,EAAE,aAAa,EAAC,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAyB,aAAa,EAAC,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAC,mBAAmB,EAAc,MAAM,oBAAoB,CAAC;AAEpE;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,GAAG,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,aAAa,CAAC,GAAG,CAAC;IAE5F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAwC;IAClF,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAwC;gBAErE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,gBAAgB,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE;IAe9E,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI;IAKnC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAItC,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAU7D,KAAK;IAKL,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlD"}

package/dist/testkit/GGConfigTestStore.js

@@ -0,0 +1,85 @@
+import { GGConfigKey } from "../src/GGConfigKey.js";
+import { GGConfigStore } from "../src/GGConfigStore.js";
+import { GGConfigLocator } from "../src/GGConfigLocator.js";
+import { GG_TEST_RUNTIME_WORKER } from "@grest-ts/testkit";
+import { GGConfigIPC } from "./GGConfigCommands.js";
+/**
+ * Test config store that wraps a parent store and allows overriding values.
+ * Overrides validation to always throw (fail fast in tests).
+ */
+export class GGConfigTestStore extends GGConfigStore {
+    wrappedStore;
+    initialConfigOverridesMap = new Map();
+    activeConfigOverridesMap = new Map();
+    constructor(parent, initialOverrides) {
+        super();
+        this.wrappedStore = parent;
+        for (const command of initialOverrides) {
+            if (GGConfigKey.hasKey(command.payload.keyName)) {
+                const key = GGConfigKey.getKey(command.payload.keyName);
+                const value = this.resolveValue(key, command.payload.value, true);
+                this.initialConfigOverridesMap.set(key, value);
+                this.activeConfigOverridesMap.set(key, value);
+            }
+            else {
+                // To throw here, we would need to let the test runner know what config keys each service uses so it can target config updates better.
+            }
+        }
+    }
+    setKeys(keys) {
+        super.setKeys(keys);
+        this.wrappedStore.setKeys(keys);
+    }
+    getValue(key) {
+        return this.activeConfigOverridesMap.has(key) ? this.activeConfigOverridesMap.get(key) : this.wrappedStore.getValue(key);
+    }
+    async updateValueOverride(key, value) {
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            const existingValue = this.activeConfigOverridesMap.get(key) ?? this.wrappedStore.getValue(key);
+            if (existingValue !== null && typeof existingValue === 'object' && !Array.isArray(existingValue)) {
+                value = { ...existingValue, ...value };
+            }
+        }
+        return this.replaceValueOverride(key, value);
+    }
+    async replaceValueOverride(key, value) {
+        this.activeConfigOverridesMap.set(key, this.resolveValue(key, value, false));
+        await this.notify(key);
+    }
+    async resetAfterTest() {
+        this.activeConfigOverridesMap.clear();
+        for (const [key, value] of this.initialConfigOverridesMap) {
+            await this.replaceValueOverride(key, value);
+        }
+    }
+    watch(key, callback) {
+        this.wrappedStore.watch(key, async () => {
+            // We only notify of the change if we don't have overrides. If we have override, then for watcher config value doesn't change.
+            if (!this.activeConfigOverridesMap.has(key)) {
+                return this.notify(key);
+            }
+        });
+        return super.watch(key, callback);
+    }
+    async start() {
+        await this.wrappedStore.start();
+        await super.start();
+    }
+    async teardown() {
+        await this.wrappedStore.teardown();
+        await super.teardown();
+    }
+}
+const wrapperMap = new WeakMap();
+GGConfigLocator.prototype.add = function (key, store) {
+    store = this._useLocalStoreIfNeeded(store);
+    const initialOverrides = GG_TEST_RUNTIME_WORKER.get().getInitialCommandsFor(GGConfigIPC.worker.update);
+    let wrapped = wrapperMap.get(store);
+    if (!wrapped) {
+        wrapped = new GGConfigTestStore(store, initialOverrides);
+        wrapperMap.set(store, wrapped);
+    }
+    this._add(key, wrapped);
+    return this;
+};
+//# sourceMappingURL=GGConfigTestStore.js.map

package/dist/testkit/GGConfigTestStore.js.map

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