@hibanacloud/core 0.3.15

package/dist/src/utils/ripgrepUtils.js

@@ -0,0 +1,230 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFile } from 'node:child_process';
+import { fileExists } from './fileUtils.js';
+import { execCommand, isCommandAvailable } from './shell-utils.js';
+const RIPGREP_COMMAND = 'rg';
+const RIPGREP_BUFFER_LIMIT = 20_000_000; // Keep buffers aligned with the original bundle.
+const RIPGREP_TEST_TIMEOUT_MS = 5_000;
+const RIPGREP_RUN_TIMEOUT_MS = 10_000;
+const RIPGREP_WSL_TIMEOUT_MS = 60_000;
+let cachedSelection = null;
+let cachedHealth = null;
+let macSigningAttempted = false;
+function wslTimeout() {
+    return process.platform === 'linux' && process.env['WSL_INTEROP']
+        ? RIPGREP_WSL_TIMEOUT_MS
+        : RIPGREP_RUN_TIMEOUT_MS;
+}
+// Get the directory of the current module
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Maps process.platform values to vendor directory names
+ */
+function getPlatformString(platform) {
+    switch (platform) {
+        case 'darwin':
+        case 'linux':
+        case 'win32':
+            return platform;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Maps process.arch values to vendor directory names
+ */
+function getArchitectureString(arch) {
+    switch (arch) {
+        case 'x64':
+        case 'arm64':
+            return arch;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Returns the path to the bundled ripgrep binary for the current platform
+ * @returns The path to the bundled ripgrep binary, or null if not available
+ */
+export function getBuiltinRipgrep() {
+    const platform = getPlatformString(process.platform);
+    const arch = getArchitectureString(process.arch);
+    if (!platform || !arch) {
+        return null;
+    }
+    // Binary name includes .exe on Windows
+    const binaryName = platform === 'win32' ? 'rg.exe' : 'rg';
+    // Path resolution:
+    // When running from transpiled code: dist/src/utils/ripgrepUtils.js -> ../../../vendor/ripgrep/
+    // When running from bundle: dist/index.js -> vendor/ripgrep/
+    // Detect if we're running from a bundle (single file)
+    // In bundle, __filename will be something like /path/to/dist/index.js
+    // In transpiled code, __filename will be /path/to/dist/src/utils/ripgrepUtils.js
+    const isBundled = !__filename.includes(path.join('src', 'utils'));
+    const vendorPath = isBundled
+        ? path.join(__dirname, 'vendor', 'ripgrep', `${arch}-${platform}`, binaryName)
+        : path.join(__dirname, '..', '..', '..', 'vendor', 'ripgrep', `${arch}-${platform}`, binaryName);
+    return vendorPath;
+}
+/**
+ * Checks if ripgrep binary exists and returns its path
+ * @param useBuiltin If true, tries bundled ripgrep first, then falls back to system ripgrep.
+ *                   If false, only checks for system ripgrep.
+ * @returns The path to ripgrep binary ('rg' or 'rg.exe' for system ripgrep, or full path for bundled), or null if not available
+ * @throws {Error} If an error occurs while resolving the ripgrep binary.
+ */
+export async function resolveRipgrep(useBuiltin = true) {
+    if (cachedSelection)
+        return cachedSelection;
+    if (useBuiltin) {
+        // Try bundled ripgrep first
+        const rgPath = getBuiltinRipgrep();
+        if (rgPath && (await fileExists(rgPath))) {
+            cachedSelection = { mode: 'builtin', command: rgPath };
+            return cachedSelection;
+        }
+        // Fallback to system rg if bundled binary is not available
+    }
+    const { available, error } = isCommandAvailable(RIPGREP_COMMAND);
+    if (available) {
+        cachedSelection = { mode: 'system', command: RIPGREP_COMMAND };
+        return cachedSelection;
+    }
+    if (error) {
+        throw error;
+    }
+    return null;
+}
+/**
+ * Ensures that ripgrep is healthy by checking its version.
+ * @param selection The ripgrep selection to check.
+ * @throws {Error} If ripgrep is not found or is not healthy.
+ */
+export async function ensureRipgrepHealthy(selection) {
+    if (cachedHealth &&
+        cachedHealth.selection.command === selection.command &&
+        cachedHealth.working)
+        return;
+    try {
+        const { stdout, code } = await execCommand(selection.command, ['--version'], {
+            timeout: RIPGREP_TEST_TIMEOUT_MS,
+        });
+        const working = code === 0 && stdout.startsWith('ripgrep');
+        cachedHealth = { working, lastTested: Date.now(), selection };
+    }
+    catch (error) {
+        cachedHealth = { working: false, lastTested: Date.now(), selection };
+        throw error;
+    }
+}
+export async function ensureMacBinarySigned(selection) {
+    if (process.platform !== 'darwin')
+        return;
+    if (macSigningAttempted)
+        return;
+    macSigningAttempted = true;
+    if (selection.mode !== 'builtin')
+        return;
+    const binaryPath = selection.command;
+    const inspect = await execCommand('codesign', ['-vv', '-d', binaryPath], {
+        preserveOutputOnError: false,
+    });
+    const alreadySigned = inspect.stdout
+        ?.split('\n')
+        .some((line) => line.includes('linker-signed')) ?? false;
+    if (!alreadySigned)
+        return;
+    await execCommand('codesign', [
+        '--sign',
+        '-',
+        '--force',
+        '--preserve-metadata=entitlements,requirements,flags,runtime',
+        binaryPath,
+    ]);
+    await execCommand('xattr', ['-d', 'com.apple.quarantine', binaryPath]);
+}
+/**
+ * Checks if ripgrep binary is available
+ * @param useBuiltin If true, tries bundled ripgrep first, then falls back to system ripgrep.
+ *                   If false, only checks for system ripgrep.
+ * @returns True if ripgrep is available, false otherwise.
+ * @throws {Error} If an error occurs while resolving the ripgrep binary.
+ */
+export async function canUseRipgrep(useBuiltin = true) {
+    const selection = await resolveRipgrep(useBuiltin);
+    if (!selection) {
+        return false;
+    }
+    await ensureRipgrepHealthy(selection);
+    return true;
+}
+/**
+ * Runs ripgrep with the provided arguments
+ * @param args The arguments to pass to ripgrep
+ * @param signal The signal to abort the ripgrep process
+ * @returns The result of running ripgrep
+ * @throws {Error} If an error occurs while running ripgrep.
+ */
+export async function runRipgrep(args, signal) {
+    const selection = await resolveRipgrep();
+    if (!selection) {
+        throw new Error('ripgrep not found.');
+    }
+    await ensureRipgrepHealthy(selection);
+    return new Promise((resolve) => {
+        const child = execFile(selection.command, args, {
+            maxBuffer: RIPGREP_BUFFER_LIMIT,
+            timeout: wslTimeout(),
+            signal,
+        }, (error, stdout = '', stderr = '') => {
+            if (!error) {
+                // Success case
+                resolve({
+                    stdout,
+                    truncated: false,
+                });
+                return;
+            }
+            // Exit code 1 = no matches found (not an error)
+            // The error.code from execFile can be string | number | undefined | null
+            const errorCode = error.code;
+            if (errorCode === 1) {
+                resolve({ stdout: '', truncated: false });
+                return;
+            }
+            // Detect various error conditions
+            const wasKilled = error.signal === 'SIGTERM' || error.name === 'AbortError';
+            const overflow = errorCode === 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER';
+            const syntaxError = errorCode === 2;
+            const truncated = wasKilled || overflow;
+            let partialOutput = stdout;
+            // If killed or overflow with partial output, remove the last potentially incomplete line
+            if (truncated && partialOutput.length > 0) {
+                const lines = partialOutput.split('\n');
+                if (lines.length > 0) {
+                    lines.pop();
+                    partialOutput = lines.join('\n');
+                }
+            }
+            // Log warnings for abnormal exits (except syntax errors)
+            if (!syntaxError && truncated) {
+                console.warn(`ripgrep exited abnormally (signal=${error.signal} code=${error.code}) with stderr:\n${stderr.trim() || '(empty)'}`);
+            }
+            resolve({
+                stdout: partialOutput,
+                truncated,
+                error: error instanceof Error ? error : undefined,
+            });
+        });
+        // Handle spawn errors
+        child.on('error', (err) => resolve({ stdout: '', truncated: false, error: err }));
+    });
+}
+//# sourceMappingURL=ripgrepUtils.js.map

package/dist/src/utils/ripgrepUtils.js.map

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

package/dist/src/utils/ripgrepUtils.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/ripgrepUtils.test.js

@@ -0,0 +1,101 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { getBuiltinRipgrep } from './ripgrepUtils.js';
+import path from 'node:path';
+describe('ripgrepUtils', () => {
+    describe('getBuiltinRipgrep', () => {
+        it('should return path with .exe extension on Windows', () => {
+            const originalPlatform = process.platform;
+            const originalArch = process.arch;
+            // Mock Windows x64
+            Object.defineProperty(process, 'platform', { value: 'win32' });
+            Object.defineProperty(process, 'arch', { value: 'x64' });
+            const rgPath = getBuiltinRipgrep();
+            expect(rgPath).toContain('x64-win32');
+            expect(rgPath).toContain('rg.exe');
+            expect(rgPath).toContain(path.join('vendor', 'ripgrep'));
+            // Restore original values
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            Object.defineProperty(process, 'arch', { value: originalArch });
+        });
+        it('should return path without .exe extension on macOS', () => {
+            const originalPlatform = process.platform;
+            const originalArch = process.arch;
+            // Mock macOS arm64
+            Object.defineProperty(process, 'platform', { value: 'darwin' });
+            Object.defineProperty(process, 'arch', { value: 'arm64' });
+            const rgPath = getBuiltinRipgrep();
+            expect(rgPath).toContain('arm64-darwin');
+            expect(rgPath).toContain('rg');
+            expect(rgPath).not.toContain('.exe');
+            expect(rgPath).toContain(path.join('vendor', 'ripgrep'));
+            // Restore original values
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            Object.defineProperty(process, 'arch', { value: originalArch });
+        });
+        it('should return path without .exe extension on Linux', () => {
+            const originalPlatform = process.platform;
+            const originalArch = process.arch;
+            // Mock Linux x64
+            Object.defineProperty(process, 'platform', { value: 'linux' });
+            Object.defineProperty(process, 'arch', { value: 'x64' });
+            const rgPath = getBuiltinRipgrep();
+            expect(rgPath).toContain('x64-linux');
+            expect(rgPath).toContain('rg');
+            expect(rgPath).not.toContain('.exe');
+            expect(rgPath).toContain(path.join('vendor', 'ripgrep'));
+            // Restore original values
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            Object.defineProperty(process, 'arch', { value: originalArch });
+        });
+        it('should return null for unsupported platform', () => {
+            const originalPlatform = process.platform;
+            const originalArch = process.arch;
+            // Mock unsupported platform
+            Object.defineProperty(process, 'platform', { value: 'freebsd' });
+            Object.defineProperty(process, 'arch', { value: 'x64' });
+            expect(getBuiltinRipgrep()).toBeNull();
+            // Restore original values
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            Object.defineProperty(process, 'arch', { value: originalArch });
+        });
+        it('should return null for unsupported architecture', () => {
+            const originalPlatform = process.platform;
+            const originalArch = process.arch;
+            // Mock unsupported architecture
+            Object.defineProperty(process, 'platform', { value: 'darwin' });
+            Object.defineProperty(process, 'arch', { value: 'ia32' });
+            expect(getBuiltinRipgrep()).toBeNull();
+            // Restore original values
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            Object.defineProperty(process, 'arch', { value: originalArch });
+        });
+        it('should handle all supported platform/arch combinations', () => {
+            const originalPlatform = process.platform;
+            const originalArch = process.arch;
+            const combinations = [
+                { platform: 'darwin', arch: 'x64' },
+                { platform: 'darwin', arch: 'arm64' },
+                { platform: 'linux', arch: 'x64' },
+                { platform: 'linux', arch: 'arm64' },
+                { platform: 'win32', arch: 'x64' },
+            ];
+            combinations.forEach(({ platform, arch }) => {
+                Object.defineProperty(process, 'platform', { value: platform });
+                Object.defineProperty(process, 'arch', { value: arch });
+                const rgPath = getBuiltinRipgrep();
+                const binaryName = platform === 'win32' ? 'rg.exe' : 'rg';
+                const expectedPathSegment = path.join(`${arch}-${platform}`, binaryName);
+                expect(rgPath).toContain(expectedPathSegment);
+            });
+            // Restore original values
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            Object.defineProperty(process, 'arch', { value: originalArch });
+        });
+    });
+});
+//# sourceMappingURL=ripgrepUtils.test.js.map

package/dist/src/utils/ripgrepUtils.test.js.map

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

package/dist/src/utils/safeJsonParse.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely parse JSON string with jsonrepair fallback for malformed JSON.
+ * This function attempts to parse JSON normally first, and if that fails,
+ * it uses jsonrepair to fix common JSON formatting issues before parsing.
+ *
+ * @param jsonString - The JSON string to parse
+ * @param fallbackValue - The value to return if parsing fails completely
+ * @returns The parsed object or the fallback value
+ */
+export declare function safeJsonParse<T = Record<string, unknown>>(jsonString: string, fallbackValue?: T): T;

package/dist/src/utils/safeJsonParse.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { jsonrepair } from 'jsonrepair';
+/**
+ * Safely parse JSON string with jsonrepair fallback for malformed JSON.
+ * This function attempts to parse JSON normally first, and if that fails,
+ * it uses jsonrepair to fix common JSON formatting issues before parsing.
+ *
+ * @param jsonString - The JSON string to parse
+ * @param fallbackValue - The value to return if parsing fails completely
+ * @returns The parsed object or the fallback value
+ */
+export function safeJsonParse(jsonString, fallbackValue = {}) {
+    if (!jsonString || typeof jsonString !== 'string') {
+        return fallbackValue;
+    }
+    try {
+        // First attempt: try normal JSON.parse
+        return JSON.parse(jsonString);
+    }
+    catch (error) {
+        try {
+            // Second attempt: use jsonrepair to fix common JSON issues
+            const repairedJson = jsonrepair(jsonString);
+            // jsonrepair always returns a string, so we need to parse it
+            return JSON.parse(repairedJson);
+        }
+        catch (repairError) {
+            console.error('Failed to parse JSON even with jsonrepair:', {
+                originalError: error,
+                repairError,
+                jsonString,
+            });
+            return fallbackValue;
+        }
+    }
+}
+//# sourceMappingURL=safeJsonParse.js.map

package/dist/src/utils/safeJsonParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonParse.js","sourceRoot":"","sources":["../../../src/utils/safeJsonParse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,gBAAmB,EAAO;IAE1B,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,uCAAuC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAM,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,2DAA2D;YAC3D,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YAE5C,6DAA6D;YAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAM,CAAC;QACvC,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBAC1D,aAAa,EAAE,KAAK;gBACpB,WAAW;gBACX,UAAU;aACX,CAAC,CAAC;YACH,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/utils/safeJsonParse.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/safeJsonParse.test.js

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { safeJsonParse } from './safeJsonParse.js';
+describe('safeJsonParse', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('valid JSON parsing', () => {
+        it('should parse valid JSON correctly', () => {
+            const validJson = '{"name": "test", "value": 123}';
+            const result = safeJsonParse(validJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should parse valid JSON arrays', () => {
+            const validArray = '["item1", "item2", "item3"]';
+            const result = safeJsonParse(validArray);
+            expect(result).toEqual(['item1', 'item2', 'item3']);
+        });
+        it('should parse valid JSON with nested objects', () => {
+            const validNested = '{"config": {"paths": ["testlogs/*.py"], "options": {"recursive": true}}}';
+            const result = safeJsonParse(validNested);
+            expect(result).toEqual({
+                config: {
+                    paths: ['testlogs/*.py'],
+                    options: { recursive: true },
+                },
+            });
+        });
+    });
+    describe('malformed JSON with jsonrepair fallback', () => {
+        it('should handle malformed JSON with single quotes', () => {
+            const malformedJson = "{'name': 'test', 'value': 123}";
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should handle malformed JSON with unquoted keys', () => {
+            const malformedJson = '{name: "test", value: 123}';
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should handle malformed JSON with trailing commas', () => {
+            const malformedJson = '{"name": "test", "value": 123,}';
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should handle malformed JSON with comments', () => {
+            const malformedJson = '{"name": "test", // comment\n "value": 123}';
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+    });
+    describe('fallback behavior', () => {
+        it('should return fallback value for empty string', () => {
+            const emptyString = '';
+            const fallback = { default: 'value' };
+            const result = safeJsonParse(emptyString, fallback);
+            expect(result).toEqual(fallback);
+        });
+        it('should return fallback value for null input', () => {
+            const nullInput = null;
+            const fallback = { default: 'value' };
+            const result = safeJsonParse(nullInput, fallback);
+            expect(result).toEqual(fallback);
+        });
+        it('should return fallback value for undefined input', () => {
+            const undefinedInput = undefined;
+            const fallback = { default: 'value' };
+            const result = safeJsonParse(undefinedInput, fallback);
+            expect(result).toEqual(fallback);
+        });
+        it('should return empty object as default fallback', () => {
+            const invalidJson = 'invalid json';
+            const result = safeJsonParse(invalidJson);
+            // jsonrepair returns the original string for completely invalid JSON
+            expect(result).toEqual('invalid json');
+        });
+        it('should return custom fallback when parsing fails', () => {
+            const invalidJson = 'invalid json';
+            const customFallback = { error: 'parsing failed', data: null };
+            const result = safeJsonParse(invalidJson, customFallback);
+            // jsonrepair returns the original string for completely invalid JSON
+            expect(result).toEqual('invalid json');
+        });
+    });
+    describe('type safety', () => {
+        it('should preserve generic type when parsing valid JSON', () => {
+            const validJson = '{"name": "test", "value": 123}';
+            const result = safeJsonParse(validJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+            // TypeScript should infer the correct type
+            expect(typeof result.name).toBe('string');
+            expect(typeof result.value).toBe('number');
+        });
+        it('should return fallback type when parsing fails', () => {
+            const invalidJson = 'invalid json';
+            const fallback = { error: 'fallback' };
+            const result = safeJsonParse(invalidJson, fallback);
+            // jsonrepair returns the original string for completely invalid JSON
+            expect(result).toEqual('invalid json');
+            // TypeScript should preserve the fallback type
+            expect(typeof result).toBe('string');
+        });
+    });
+});
+//# sourceMappingURL=safeJsonParse.test.js.map

package/dist/src/utils/safeJsonParse.test.js.map

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

package/dist/src/utils/safeJsonStringify.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely stringifies an object to JSON, handling circular references by replacing them with [Circular].
+ *
+ * @param obj - The object to stringify
+ * @param space - Optional space parameter for formatting (defaults to no formatting)
+ * @returns JSON string with circular references replaced by [Circular]
+ */
+export declare function safeJsonStringify(obj: unknown, space?: string | number): string;

package/dist/src/utils/safeJsonStringify.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely stringifies an object to JSON, handling circular references by replacing them with [Circular].
+ *
+ * @param obj - The object to stringify
+ * @param space - Optional space parameter for formatting (defaults to no formatting)
+ * @returns JSON string with circular references replaced by [Circular]
+ */
+export function safeJsonStringify(obj, space) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    }, space);
+}
+//# sourceMappingURL=safeJsonStringify.js.map

package/dist/src/utils/safeJsonStringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonStringify.js","sourceRoot":"","sources":["../../../src/utils/safeJsonStringify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY,EACZ,KAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,EACH,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACb,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,KAAK,CACN,CAAC;AACJ,CAAC"}

package/dist/src/utils/safeJsonStringify.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};