@grest-ts/common 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,81 @@
+# @grest-ts/common
+
+Common utility functions and types shared across all GG packages.
+
+## Purpose
+
+This package contains utility functions and types that are used across multiple packages in the Grest framework. By consolidating them here, we:
+- Eliminate code duplication
+- Ensure consistency across packages
+- Make maintenance easier
+- Reduce package dependencies
+
+## Utilities
+
+### `deepFreeze<T>(obj: T): T`
+
+Recursively freezes an object and all its nested properties, making it immutable.
+
+```typescript
+import { deepFreeze } from '@grest-ts/common';
+
+const config = deepFreeze({
+  name: 'app',
+  settings: {
+    debug: true
+  }
+});
+
+// This will throw an error in strict mode
+config.settings.debug = false;
+```
+
+### `withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage: string): Promise<T>`
+
+Wraps a promise with a timeout. If the promise doesn't resolve/reject within the specified timeout, the returned promise will reject with an error.
+
+```typescript
+import { withTimeout } from '@grest-ts/common';
+
+const result = await withTimeout(
+  fetch('https://api.example.com'),
+  5000,
+  'API request timed out'
+);
+```
+
+## Types
+
+### `DeepPartial<T>`
+
+Recursively makes all properties of an object optional. Useful for partial matching in tests and validation.
+
+```typescript
+import { DeepPartial } from '@grest-ts/common';
+
+interface User {
+  id: string;
+  profile: {
+    name: string;
+    email: string;
+  };
+}
+
+// All properties are optional
+const partialUser: DeepPartial<User> = {
+  profile: {
+    name: 'Alice'
+    // email is optional
+  }
+};
+```
+
+## Adding New Utilities
+
+When adding new utilities to this package:
+
+1. Create a new file in `src/` for the utility
+2. Export it from `src/index.ts`
+3. Add JSDoc comments explaining usage
+4. Update this README with examples
+5. Ensure the utility is truly reusable across multiple packages

package/dist/src/GGAsyncStorage.d.ts

@@ -0,0 +1,12 @@
+export interface IAsyncStorage<T> {
+    getStore(): T | undefined;
+    run<R>(store: T, fn: () => R): R;
+    enterWith(store: T): void;
+}
+export declare class BrowserAsyncStorage<T> implements IAsyncStorage<T> {
+    private store;
+    getStore(): T | undefined;
+    run<R>(store: T, fn: () => R): R;
+    enterWith(store: T): void;
+}
+//# sourceMappingURL=GGAsyncStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GGAsyncStorage.d.ts","sourceRoot":"","sources":["../../src/GGAsyncStorage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC5B,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,mBAAmB,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAgB;IAE7B,QAAQ,IAAI,CAAC,GAAG,SAAS;IAIzB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAUhC,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;CAG5B"}

package/dist/src/GGAsyncStorage.js

@@ -0,0 +1,20 @@
+export class BrowserAsyncStorage {
+    store;
+    getStore() {
+        return this.store;
+    }
+    run(store, fn) {
+        const prev = this.store;
+        this.store = store;
+        try {
+            return fn();
+        }
+        finally {
+            this.store = prev;
+        }
+    }
+    enterWith(store) {
+        this.store = store;
+    }
+}
+//# sourceMappingURL=GGAsyncStorage.js.map

package/dist/src/GGAsyncStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGAsyncStorage.js","sourceRoot":"","sources":["../../src/GGAsyncStorage.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,mBAAmB;IACpB,KAAK,CAAgB;IAE7B,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,GAAG,CAAI,KAAQ,EAAE,EAAW;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACD,OAAO,EAAE,EAAE,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAQ;QACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;CACJ"}

package/dist/src/GGError.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Context for constructing GGError instances
+ * This is ONLY an input parameter - not stored on the error object
+ * All fields become direct readonly properties on GGError
+ */
+export interface GGErrorContext {
+    displayMessage?: string;
+    debugMessage?: string;
+    debugData?: any;
+    originalError?: GGError | Error | string | unknown;
+    refId?: string;
+    timestamp?: number;
+}
+/**
+ * These values are only returned when running tests or locally.
+ */
+export interface GGErrorDebugMessage {
+    debugMessage?: string;
+    debugData?: any;
+    originalError?: GGErrorDebugMessage | Error | string | unknown;
+}
+export declare class GGError extends Error {
+    readonly refId: string;
+    readonly timestamp: number;
+    readonly displayMessage?: string;
+    readonly debugMessage?: string;
+    readonly debugData?: any;
+    readonly originalError?: GGError | Error | string | unknown;
+    constructor(message: string, context?: GGErrorContext | Error);
+    static fromUnknown(error: unknown): GGError;
+}
+//# sourceMappingURL=GGError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GGError.d.ts","sourceRoot":"","sources":["../../src/GGError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,GAAG,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAGnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,GAAG,CAAA;IACf,aAAa,CAAC,EAAE,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;CAClE;AAED,qBAAa,OAAQ,SAAQ,KAAK;IAE9B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChC,SAAgB,aAAa,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;gBAEvD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,KAAK;WA6B/C,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CASrD"}

package/dist/src/GGError.js

@@ -0,0 +1,47 @@
+export class GGError extends Error {
+    refId;
+    timestamp;
+    displayMessage;
+    debugMessage;
+    debugData;
+    originalError;
+    constructor(message, context) {
+        if (context instanceof Error) {
+            context = {
+                originalError: context
+            };
+        }
+        else if (!context) {
+            context = {};
+        }
+        let refId;
+        let timestamp;
+        if (context.originalError instanceof GGError) {
+            refId = context.originalError.refId;
+            timestamp = context.originalError.timestamp;
+        }
+        else {
+            refId = context.refId ?? "ERR_REF_" + Math.random().toString(36).substring(2, 10) + Date.now().toString(36);
+            timestamp = context.timestamp ?? Date.now();
+        }
+        super(message + " {" + refId + "} " + (context?.displayMessage ? ": " + context?.displayMessage : ""));
+        this.refId = refId;
+        this.timestamp = timestamp;
+        this.displayMessage = context.displayMessage;
+        this.debugMessage = context.debugMessage;
+        this.debugData = context.debugData;
+        this.originalError = context.originalError;
+    }
+    static fromUnknown(error) {
+        if (error instanceof GGError) {
+            return error;
+        }
+        else if (error instanceof Error) {
+            return new GGError(error.message, error);
+        }
+        else {
+            return new GGError("Unknown", { debugData: error });
+        }
+    }
+}
+//# sourceMappingURL=GGError.js.map

package/dist/src/GGError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGError.js","sourceRoot":"","sources":["../../src/GGError.ts"],"names":[],"mappings":"AAyBA,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAEd,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,cAAc,CAAU;IACxB,YAAY,CAAU;IACtB,SAAS,CAAO;IAChB,aAAa,CAAsC;IAEnE,YAAY,OAAe,EAAE,OAAgC;QAEzD,IAAI,OAAO,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,GAAG;gBACN,aAAa,EAAE,OAAO;aACzB,CAAA;QACL,CAAC;aAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;QAED,IAAI,KAAa,CAAC;QAClB,IAAI,SAAiB,CAAC;QACtB,IAAI,OAAO,CAAC,aAAa,YAAY,OAAO,EAAE,CAAC;YAC3C,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC;YACpC,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC;QAChD,CAAC;aAAM,CAAC;YACJ,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5G,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC/C,CAAC;IAEM,MAAM,CAAC,WAAW,CAAC,KAAc;QACpC,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACjB,CAAC;aAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAChC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,KAAK,EAAC,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACJ"}

package/dist/src/GGExtensionDiscovery.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Discovers extensions by scanning node_modules for packages
+ * that follow the convention of having a {name}/index-{name}.ts file.
+ *
+ * For example, with name="testkit":
+ * - Scans for: testkit/index-testkit.ts
+ * - Types dir: node_modules/@types/grest-ts-testkits
+ *
+ * Generates:
+ * - node_modules/@types/grest-ts-{name}s/index.d.ts - For IDE type completion (triple-slash references)
+ *
+ * Runtime loading is done via dynamic imports of discovered extensions.
+ */
+export declare class GGExtensionDiscovery {
+    private static loadedExtensions;
+    private readonly name;
+    private readonly typesDir;
+    private readonly filePattern;
+    /**
+     * Create a new extension discovery instance.
+     * @param name The extension name (e.g., "testkit", "codegen")
+     */
+    constructor(name: string);
+    /**
+     * Generate types file for IDE support without loading extensions.
+     * Use this during build/check steps to ensure IDE has proper type completion.
+     */
+    generateTypes(): Promise<void>;
+    /**
+     * Discover and load all extensions.
+     * - Scans for extension packages
+     * - Generates .d.ts file for IDE support
+     * - Dynamically imports extensions for runtime
+     */
+    load(): Promise<void>;
+    private acquireLock;
+    private releaseLock;
+    private waitForLock;
+    private discoverAndLoad;
+    private loadFromCache;
+    scan(cwd: string): Promise<string[]>;
+    /**
+     * Resolve a package's install directory by walking up node_modules directories from cwd.
+     * Mimics Node.js module resolution: checks cwd/node_modules/<pkg>, ../node_modules/<pkg>, etc.
+     */
+    private resolvePackageDir;
+    private readDependencyNames;
+    findMonorepoRoot(startDir: string): string | null;
+    private getLockfileMtime;
+    private readCache;
+    private writeTypesFile;
+    private capitalize;
+}
+//# sourceMappingURL=GGExtensionDiscovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GGExtensionDiscovery.d.ts","sourceRoot":"","sources":["../../src/GGExtensionDiscovery.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAqB;IAEpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;OAGG;gBACS,IAAI,EAAE,MAAM;IAMxB;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3C;;;;;OAKG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBlC,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;YAQL,WAAW;YAYX,eAAe;YAqBf,aAAa;IAUd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4CjD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,mBAAmB;IAYpB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoBxD,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,UAAU;CAGrB"}

package/dist/src/GGExtensionDiscovery.js

@@ -0,0 +1,281 @@
+import fg from 'fast-glob';
+import * as fs from 'fs';
+import * as path from 'path';
+import { pathToFileURL } from 'url';
+const TYPES_FILE = 'index.d.ts';
+const LOCK_FILE = 'index.d.ts.lock';
+const CACHE_START = '/* @cache-start ';
+const CACHE_END = ' @cache-end */';
+/**
+ * Discovers extensions by scanning node_modules for packages
+ * that follow the convention of having a {name}/index-{name}.ts file.
+ *
+ * For example, with name="testkit":
+ * - Scans for: testkit/index-testkit.ts
+ * - Types dir: node_modules/@types/grest-ts-testkits
+ *
+ * Generates:
+ * - node_modules/@types/grest-ts-{name}s/index.d.ts - For IDE type completion (triple-slash references)
+ *
+ * Runtime loading is done via dynamic imports of discovered extensions.
+ */
+export class GGExtensionDiscovery {
+    static loadedExtensions = new Set();
+    name;
+    typesDir;
+    filePattern;
+    /**
+     * Create a new extension discovery instance.
+     * @param name The extension name (e.g., "testkit", "codegen")
+     */
+    constructor(name) {
+        this.name = name;
+        this.typesDir = `node_modules/@types/grest-ts-${name}s`;
+        this.filePattern = `${name}/index-${name}.ts`;
+    }
+    /**
+     * Generate types file for IDE support without loading extensions.
+     * Use this during build/check steps to ensure IDE has proper type completion.
+     */
+    async generateTypes() {
+        const cwd = process.cwd();
+        const typesDir = path.join(cwd, this.typesDir);
+        const typesFile = path.join(typesDir, TYPES_FILE);
+        const lockfileMtime = this.getLockfileMtime(cwd);
+        const extensions = await this.scan(cwd);
+        this.writeTypesFile(typesFile, extensions, typesDir, lockfileMtime);
+        console.log(`[GG${this.capitalize(this.name)}] Generated types for ${extensions.length} ${this.name}(s)`);
+    }
+    /**
+     * Discover and load all extensions.
+     * - Scans for extension packages
+     * - Generates .d.ts file for IDE support
+     * - Dynamically imports extensions for runtime
+     */
+    async load() {
+        if (GGExtensionDiscovery.loadedExtensions.has(this.name)) {
+            return;
+        }
+        GGExtensionDiscovery.loadedExtensions.add(this.name);
+        const cwd = process.cwd();
+        const typesDir = path.join(cwd, this.typesDir);
+        const typesFile = path.join(typesDir, TYPES_FILE);
+        const lockFile = path.join(typesDir, LOCK_FILE);
+        // Try to acquire lock
+        if (this.acquireLock(lockFile)) {
+            try {
+                await this.discoverAndLoad(cwd, typesFile, typesDir);
+            }
+            finally {
+                this.releaseLock(lockFile);
+            }
+        }
+        else {
+            // Wait for lock to be released, then load from cache
+            await this.waitForLock(lockFile);
+            await this.loadFromCache(typesFile);
+        }
+    }
+    acquireLock(lockFile) {
+        try {
+            fs.mkdirSync(path.dirname(lockFile), { recursive: true });
+            fs.writeFileSync(lockFile, String(process.pid), { flag: 'wx' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    releaseLock(lockFile) {
+        try {
+            fs.unlinkSync(lockFile);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    async waitForLock(lockFile, timeout = 30000) {
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            if (!fs.existsSync(lockFile)) {
+                return;
+            }
+            await new Promise(r => setTimeout(r, 50));
+        }
+        // Timeout - try to clean up stale lock
+        this.releaseLock(lockFile);
+    }
+    async discoverAndLoad(cwd, typesFile, typesDir) {
+        const lockfileMtime = this.getLockfileMtime(cwd);
+        // Check cache embedded in types file
+        const cached = this.readCache(typesFile);
+        let extensions;
+        if (cached && cached.lockfileMtime === lockfileMtime) {
+            extensions = cached.extensions;
+        }
+        else {
+            extensions = await this.scan(cwd);
+            this.writeTypesFile(typesFile, extensions, typesDir, lockfileMtime);
+            console.log(`[GG${this.capitalize(this.name)}] Discovered ${extensions.length} ${this.name}(s)`);
+        }
+        // Dynamically import all extensions
+        for (const extension of extensions) {
+            await import(pathToFileURL(extension).href);
+        }
+    }
+    async loadFromCache(typesFile) {
+        const cached = this.readCache(typesFile);
+        if (cached) {
+            for (const extension of cached.extensions) {
+                await import(pathToFileURL(extension).href);
+            }
+        }
+    }
+    async scan(cwd) {
+        const extensions = [];
+        // Resolve extensions by reading package.json dependencies and walking up
+        // node_modules directories (like Node.js module resolution).
+        // This works regardless of hoisting, workspaces, pnpm, etc.
+        const depNames = this.readDependencyNames(cwd);
+        for (const dep of depNames) {
+            const pkgDir = this.resolvePackageDir(dep, cwd);
+            if (pkgDir) {
+                // Check source path first (local dev with tsx), then compiled dist path (published packages)
+                const sourceFile = path.join(pkgDir, this.filePattern);
+                const distFile = path.join(pkgDir, 'dist', this.filePattern.replace(/\.ts$/, '.js'));
+                if (fs.existsSync(sourceFile)) {
+                    extensions.push(sourceFile);
+                }
+                else if (fs.existsSync(distFile)) {
+                    extensions.push(distFile);
+                }
+            }
+        }
+        // Also scan monorepo packages/ directories (for framework development)
+        const monorepoRoot = this.findMonorepoRoot(cwd);
+        if (monorepoRoot) {
+            const monorepoExtensions = await fg([
+                `packages/*/${this.filePattern}`,
+                `packages/*/*/${this.filePattern}`,
+                `packages-*/*/${this.filePattern}`,
+                `packages-*/*/*/${this.filePattern}`,
+            ], {
+                cwd: monorepoRoot,
+                absolute: true,
+                onlyFiles: true
+            });
+            extensions.push(...monorepoExtensions);
+        }
+        // Resolve symlinks to real paths before deduping to avoid loading same file twice
+        // (e.g., node_modules/@grest-ts/foo -> packages/foo would otherwise be seen as different)
+        const resolvedExtensions = extensions.map(ext => fs.realpathSync(ext));
+        return [...new Set(resolvedExtensions)].sort();
+    }
+    /**
+     * Resolve a package's install directory by walking up node_modules directories from cwd.
+     * Mimics Node.js module resolution: checks cwd/node_modules/<pkg>, ../node_modules/<pkg>, etc.
+     */
+    resolvePackageDir(dep, cwd) {
+        let dir = cwd;
+        const root = path.parse(dir).root;
+        while (dir !== root) {
+            const pkgDir = path.join(dir, 'node_modules', dep);
+            if (fs.existsSync(path.join(pkgDir, 'package.json'))) {
+                return pkgDir;
+            }
+            dir = path.dirname(dir);
+        }
+        return null;
+    }
+    readDependencyNames(cwd) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf-8'));
+            return [
+                ...Object.keys(pkg.dependencies || {}),
+                ...Object.keys(pkg.devDependencies || {}),
+            ];
+        }
+        catch {
+            return [];
+        }
+    }
+    findMonorepoRoot(startDir) {
+        let currentDir = startDir;
+        const root = path.parse(currentDir).root;
+        while (currentDir !== root) {
+            const packagesPath = path.join(currentDir, 'packages');
+            try {
+                const stat = fs.statSync(packagesPath);
+                if (stat.isDirectory()) {
+                    return currentDir;
+                }
+            }
+            catch {
+                // Directory doesn't exist, continue up
+            }
+            currentDir = path.dirname(currentDir);
+        }
+        return null;
+    }
+    getLockfileMtime(cwd) {
+        const lockfiles = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock'];
+        // Walk up directories to find lockfile (handles workspaces where lockfile is at root)
+        let dir = cwd;
+        const root = path.parse(dir).root;
+        while (dir !== root) {
+            for (const lockfile of lockfiles) {
+                try {
+                    return fs.statSync(path.join(dir, lockfile)).mtimeMs;
+                }
+                catch {
+                    // File doesn't exist, try next
+                }
+            }
+            dir = path.dirname(dir);
+        }
+        return 0;
+    }
+    readCache(typesFile) {
+        try {
+            const content = fs.readFileSync(typesFile, 'utf-8');
+            const startIdx = content.indexOf(CACHE_START);
+            const endIdx = content.indexOf(CACHE_END);
+            if (startIdx === -1 || endIdx === -1) {
+                return null;
+            }
+            const jsonStr = content.slice(startIdx + CACHE_START.length, endIdx).trim();
+            return JSON.parse(jsonStr);
+        }
+        catch {
+            return null;
+        }
+    }
+    writeTypesFile(typesFile, extensions, typesDir, lockfileMtime) {
+        const lines = [
+            `// Auto-generated by GGExtensionDiscovery (${this.name}) - DO NOT EDIT`,
+            '// TypeScript automatically includes @types/* packages, so no tsconfig changes needed.',
+            ''
+        ];
+        for (const extension of extensions) {
+            const relativePath = path.relative(typesDir, extension).replace(/\\/g, '/');
+            lines.push(`/// <reference path="${relativePath}" />`);
+        }
+        // Embed cache as JSON block comment at end of file (single line so TypeScript ignores it)
+        lines.push('');
+        lines.push(CACHE_START + JSON.stringify({ lockfileMtime, extensions }) + CACHE_END);
+        lines.push('');
+        fs.mkdirSync(typesDir, { recursive: true });
+        fs.writeFileSync(typesFile, lines.join('\n'));
+        // Write package.json to make it a proper @types package
+        const packageJson = {
+            name: `@types/grest-ts-${this.name}s`,
+            version: '1.0.0',
+            types: 'index.d.ts'
+        };
+        fs.writeFileSync(path.join(typesDir, 'package.json'), JSON.stringify(packageJson, null, 2));
+    }
+    capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+}
+//# sourceMappingURL=GGExtensionDiscovery.js.map

package/dist/src/GGExtensionDiscovery.js.map

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

package/dist/src/Secret.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Secret - A wrapper for sensitive values that prevents accidental logging.
+ *
+ * Secrets are automatically redacted when:
+ * - Converted to string (toString)
+ * - Serialized to JSON (toJSON)
+ * - Logged with console.log or util.inspect
+ *
+ * To access the actual value, you must explicitly call unwrap().
+ *
+ * @example
+ * ```typescript
+ * const dbPassword = new Secret('super-secret-password');
+ *
+ * console.log(dbPassword);           // "[REDACTED]"
+ * console.log(JSON.stringify(dbPassword)); // "[REDACTED]"
+ *
+ * // Explicit unwrap required to get value
+ * const password = dbPassword.unwrap();
+ * ```
+ */
+export declare class Secret {
+    #private;
+    constructor(value: string);
+    /**
+     * Get the actual secret value.
+     * Use with care - avoid logging the result.
+     */
+    unwrap(): string;
+    /**
+     * Check if the secret has a non-empty value.
+     */
+    hasValue(): boolean;
+    /**
+     * Compare with another secret without exposing either value.
+     */
+    equals(other: Secret): boolean;
+    toString(): string;
+    toJSON(): string;
+    valueOf(): string;
+}
+/**
+ * Type guard to check if a value is a Secret.
+ */
+export declare function isSecret(value: unknown): value is Secret;
+//# sourceMappingURL=Secret.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Secret.d.ts","sourceRoot":"","sources":["../../src/Secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,MAAM;;gBAEH,KAAK,EAAE,MAAM;IAIzB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAM9B,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAUhB,OAAO,IAAI,MAAM;CAGpB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}