@didim365/agent-cli-core 0.1.0

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

@@ -0,0 +1,229 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { z } from 'zod';
+import { getToolCallDataSchema, generateCheckpointFileName, formatCheckpointDisplayList, getTruncatedCheckpointNames, processRestorableToolCalls, getCheckpointInfoList, } from './checkpointUtils.js';
+describe('checkpoint utils', () => {
+    describe('getToolCallDataSchema', () => {
+        it('should return a schema that validates a basic tool call data object', () => {
+            const schema = getToolCallDataSchema();
+            const validData = {
+                toolCall: { name: 'test-tool', args: { foo: 'bar' } },
+            };
+            const result = schema.safeParse(validData);
+            expect(result.success).toBe(true);
+        });
+        it('should validate with an optional history schema', () => {
+            const historyItemSchema = z.object({ id: z.number(), event: z.string() });
+            const schema = getToolCallDataSchema(historyItemSchema);
+            const validData = {
+                history: [{ id: 1, event: 'start' }],
+                toolCall: { name: 'test-tool', args: {} },
+            };
+            const result = schema.safeParse(validData);
+            expect(result.success).toBe(true);
+        });
+        it('should fail validation if history items do not match the schema', () => {
+            const historyItemSchema = z.object({ id: z.number(), event: z.string() });
+            const schema = getToolCallDataSchema(historyItemSchema);
+            const invalidData = {
+                history: [{ id: '1', event: 'start' }], // id should be a number
+                toolCall: { name: 'test-tool', args: {} },
+            };
+            const result = schema.safeParse(invalidData);
+            expect(result.success).toBe(false);
+        });
+        it('should validate clientHistory with the correct schema', () => {
+            const schema = getToolCallDataSchema();
+            const validData = {
+                clientHistory: [{ role: 'user', parts: [{ text: 'Hello' }] }],
+                toolCall: { name: 'test-tool', args: {} },
+            };
+            const result = schema.safeParse(validData);
+            expect(result.success).toBe(true);
+        });
+    });
+    describe('generateCheckpointFileName', () => {
+        it('should generate a filename with timestamp, basename, and tool name', () => {
+            vi.useFakeTimers();
+            vi.setSystemTime(new Date('2025-01-01T12:00:00.000Z'));
+            const toolCall = {
+                callId: '1',
+                name: 'replace',
+                args: { file_path: '/path/to/my-file.txt' },
+                isClientInitiated: false,
+                prompt_id: 'p1',
+            };
+            const expected = '2025-01-01T12-00-00_000Z-my-file.txt-replace';
+            const actual = generateCheckpointFileName(toolCall);
+            expect(actual).toBe(expected);
+            vi.useRealTimers();
+        });
+        it('should return null if file_path is not in the tool arguments', () => {
+            const toolCall = {
+                callId: '1',
+                name: 'replace',
+                args: { some_other_arg: 'value' },
+                isClientInitiated: false,
+                prompt_id: 'p1',
+            };
+            const actual = generateCheckpointFileName(toolCall);
+            expect(actual).toBeNull();
+        });
+    });
+    describe('formatCheckpointDisplayList and getTruncatedCheckpointNames', () => {
+        const filenames = [
+            '2025-01-01T12-00-00_000Z-my-file.txt-replace.json',
+            '2025-01-01T13-00-00_000Z-another.js-write_file.json',
+            'no-extension-file',
+        ];
+        it('getTruncatedCheckpointNames should remove the .json extension', () => {
+            const expected = [
+                '2025-01-01T12-00-00_000Z-my-file.txt-replace',
+                '2025-01-01T13-00-00_000Z-another.js-write_file',
+                'no-extension-file',
+            ];
+            const actual = getTruncatedCheckpointNames(filenames);
+            expect(actual).toEqual(expected);
+        });
+        it('formatCheckpointDisplayList should return a newline-separated string of truncated names', () => {
+            const expected = [
+                '2025-01-01T12-00-00_000Z-my-file.txt-replace',
+                '2025-01-01T13-00-00_000Z-another.js-write_file',
+                'no-extension-file',
+            ].join('\n');
+            const actual = formatCheckpointDisplayList(filenames);
+            expect(actual).toEqual(expected);
+        });
+    });
+    describe('processRestorableToolCalls', () => {
+        const mockGitService = {
+            createFileSnapshot: vi.fn(),
+            getCurrentCommitHash: vi.fn(),
+        };
+        const mockGeminiClient = {
+            getHistory: vi.fn(),
+        };
+        beforeEach(() => {
+            vi.clearAllMocks();
+        });
+        it('should create checkpoints for restorable tool calls', async () => {
+            const toolCalls = [
+                {
+                    callId: '1',
+                    name: 'replace',
+                    args: { file_path: 'a.txt' },
+                    prompt_id: 'p1',
+                    isClientInitiated: false,
+                },
+            ];
+            mockGitService.createFileSnapshot.mockResolvedValue('hash123');
+            mockGeminiClient.getHistory.mockReturnValue([
+                { role: 'user', parts: [] },
+            ]);
+            const { checkpointsToWrite, toolCallToCheckpointMap, errors } = await processRestorableToolCalls(toolCalls, mockGitService, mockGeminiClient, 'history-data');
+            expect(errors).toHaveLength(0);
+            expect(checkpointsToWrite.size).toBe(1);
+            expect(toolCallToCheckpointMap.get('1')).toBeDefined();
+            const fileName = checkpointsToWrite.values().next().value;
+            expect(fileName).toBeDefined();
+            const fileContent = JSON.parse(fileName);
+            expect(fileContent.commitHash).toBe('hash123');
+            expect(fileContent.history).toBe('history-data');
+            expect(fileContent.clientHistory).toEqual([{ role: 'user', parts: [] }]);
+            expect(fileContent.toolCall.name).toBe('replace');
+            expect(fileContent.messageId).toBe('p1');
+        });
+        it('should handle git snapshot failure by using current commit hash', async () => {
+            const toolCalls = [
+                {
+                    callId: '1',
+                    name: 'replace',
+                    args: { file_path: 'a.txt' },
+                    prompt_id: 'p1',
+                    isClientInitiated: false,
+                },
+            ];
+            mockGitService.createFileSnapshot.mockRejectedValue(new Error('Snapshot failed'));
+            mockGitService.getCurrentCommitHash.mockResolvedValue('fallback-hash');
+            const { checkpointsToWrite, errors } = await processRestorableToolCalls(toolCalls, mockGitService, mockGeminiClient);
+            expect(errors).toHaveLength(1);
+            expect(errors[0]).toContain('Failed to create new snapshot');
+            expect(checkpointsToWrite.size).toBe(1);
+            const value = checkpointsToWrite.values().next().value;
+            expect(value).toBeDefined();
+            const fileContent = JSON.parse(value);
+            expect(fileContent.commitHash).toBe('fallback-hash');
+        });
+        it('should skip tool calls with no file_path', async () => {
+            const toolCalls = [
+                {
+                    callId: '1',
+                    name: 'replace',
+                    args: { not_a_path: 'a.txt' },
+                    prompt_id: 'p1',
+                    isClientInitiated: false,
+                },
+            ];
+            mockGitService.createFileSnapshot.mockResolvedValue('hash123');
+            const { checkpointsToWrite, errors } = await processRestorableToolCalls(toolCalls, mockGitService, mockGeminiClient);
+            expect(errors).toHaveLength(1);
+            expect(errors[0]).toContain('Skipping restorable tool call due to missing file_path');
+            expect(checkpointsToWrite.size).toBe(0);
+        });
+        it('should log an error if git snapshot fails and then skip the tool call', async () => {
+            const toolCalls = [
+                {
+                    callId: '1',
+                    name: 'replace',
+                    args: { file_path: 'a.txt' },
+                    prompt_id: 'p1',
+                    isClientInitiated: false,
+                },
+            ];
+            mockGitService.createFileSnapshot.mockRejectedValue(new Error('Snapshot failed'));
+            mockGitService.getCurrentCommitHash.mockResolvedValue(undefined);
+            const { checkpointsToWrite, errors } = await processRestorableToolCalls(toolCalls, mockGitService, mockGeminiClient);
+            expect(errors).toHaveLength(2);
+            expect(errors[0]).toContain('Failed to create new snapshot');
+            expect(errors[1]).toContain('Failed to create snapshot for replace');
+            expect(checkpointsToWrite.size).toBe(0);
+        });
+    });
+    describe('getCheckpointInfoList', () => {
+        it('should parse valid checkpoint files and return a list of info', () => {
+            const checkpointFiles = new Map([
+                ['checkpoint1.json', JSON.stringify({ messageId: 'msg1' })],
+                ['checkpoint2.json', JSON.stringify({ messageId: 'msg2' })],
+            ]);
+            const expected = [
+                { messageId: 'msg1', checkpoint: 'checkpoint1' },
+                { messageId: 'msg2', checkpoint: 'checkpoint2' },
+            ];
+            const actual = getCheckpointInfoList(checkpointFiles);
+            expect(actual).toEqual(expected);
+        });
+        it('should ignore files with invalid JSON', () => {
+            const checkpointFiles = new Map([
+                ['checkpoint1.json', JSON.stringify({ messageId: 'msg1' })],
+                ['invalid.json', 'not-json'],
+            ]);
+            const expected = [{ messageId: 'msg1', checkpoint: 'checkpoint1' }];
+            const actual = getCheckpointInfoList(checkpointFiles);
+            expect(actual).toEqual(expected);
+        });
+        it('should ignore files that are missing a messageId', () => {
+            const checkpointFiles = new Map([
+                ['checkpoint1.json', JSON.stringify({ messageId: 'msg1' })],
+                ['no-msg-id.json', JSON.stringify({ other_prop: 'value' })],
+            ]);
+            const expected = [{ messageId: 'msg1', checkpoint: 'checkpoint1' }];
+            const actual = getCheckpointInfoList(checkpointFiles);
+            expect(actual).toEqual(expected);
+        });
+    });
+});
+//# sourceMappingURL=checkpointUtils.test.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const REFERENCE_CONTENT_START = "--- Content from referenced files ---";
+export declare const REFERENCE_CONTENT_END = "--- End of content ---";

package/dist/src/utils/constants.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const REFERENCE_CONTENT_START = '--- Content from referenced files ---';
+export const REFERENCE_CONTENT_END = '--- End of content ---';
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,uCAAuC,CAAC;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Parses custom headers and returns a map of key and vallues
+ */
+export declare function parseCustomHeaders(envValue: string | undefined): Record<string, string>;

package/dist/src/utils/customHeaderUtils.js

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Parses custom headers and returns a map of key and vallues
+ */
+export function parseCustomHeaders(envValue) {
+    const headers = {};
+    if (!envValue) {
+        return headers;
+    }
+    // Split the string on commas that are followed by a header key (key:),
+    // but ignore commas that are part of a header value (including values with colons or commas)
+    for (const entry of envValue.split(/,(?=\s*[^,:]+:)/)) {
+        const trimmedEntry = entry.trim();
+        if (!trimmedEntry) {
+            continue;
+        }
+        const separatorIndex = trimmedEntry.indexOf(':');
+        if (separatorIndex === -1) {
+            continue;
+        }
+        const name = trimmedEntry.slice(0, separatorIndex).trim();
+        const value = trimmedEntry.slice(separatorIndex + 1).trim();
+        if (!name) {
+            continue;
+        }
+        headers[name] = value;
+    }
+    return headers;
+}
+//# sourceMappingURL=customHeaderUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customHeaderUtils.js","sourceRoot":"","sources":["../../../src/utils/customHeaderUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA4B;IAE5B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uEAAuE;IACvE,6FAA6F;IAC7F,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { parseCustomHeaders } from './customHeaderUtils.js';
+describe('parseCustomHeaders', () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should return an empty object if input is undefined', () => {
+        expect(parseCustomHeaders(undefined)).toEqual({});
+    });
+    it('should return an empty object if input is empty string', () => {
+        expect(parseCustomHeaders('')).toEqual({});
+    });
+    it('should parse a single header correctly', () => {
+        const input = 'Authorization: Bearer abc123';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc123',
+        });
+    });
+    it('should parse multiple headers separated by commas', () => {
+        const input = 'Authorization: Bearer abc123, Content-Type: application/json';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc123',
+            'Content-Type': 'application/json',
+        });
+    });
+    it('should ignore entries without colon', () => {
+        const input = 'Authorization Bearer abc123, Content-Type: application/json';
+        expect(parseCustomHeaders(input)).toEqual({
+            'Content-Type': 'application/json',
+        });
+    });
+    it('should trim whitespace around names and values', () => {
+        const input = '  Authorization  :   Bearer abc123  ,  Content-Type : application/json  ';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc123',
+            'Content-Type': 'application/json',
+        });
+    });
+    it('should handle headers with colons in the value', () => {
+        const input = 'X-Custom: value:with:colons, Authorization: Bearer xyz';
+        expect(parseCustomHeaders(input)).toEqual({
+            'X-Custom': 'value:with:colons',
+            Authorization: 'Bearer xyz',
+        });
+    });
+    it('should skip headers with empty name', () => {
+        const input = ': no-name, Authorization: Bearer abc';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc',
+        });
+    });
+    it('should skip completely empty entries', () => {
+        const input = ', , Authorization: Bearer abc';
+        expect(parseCustomHeaders(input)).toEqual({
+            Authorization: 'Bearer abc',
+        });
+    });
+    it('should handle Authorization Bearer with different casing', () => {
+        const input = 'authorization: Bearer token123';
+        expect(parseCustomHeaders(input)).toEqual({
+            authorization: 'Bearer token123',
+        });
+    });
+    it('should handle values with commas correctly', () => {
+        const input = 'X-Header: value,with,commas, Authorization: Bearer abc';
+        expect(parseCustomHeaders(input)).toEqual({
+            'X-Header': 'value,with,commas',
+            Authorization: 'Bearer abc',
+        });
+    });
+});
+//# sourceMappingURL=customHeaderUtils.test.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A simple, centralized logger for developer-facing debug messages.
+ *
+ * WHY USE THIS?
+ * - It makes the INTENT of the log clear (it's for developers, not users).
+ * - It provides a single point of control for debug logging behavior.
+ * - We can lint against direct `console.*` usage to enforce this pattern.
+ *
+ * HOW IT WORKS:
+ * This is a thin wrapper around the native `console` object. The `ConsolePatcher`
+ * will intercept these calls and route them to the debug drawer UI.
+ */
+declare class DebugLogger {
+    private logStream;
+    constructor();
+    private writeToFile;
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+export declare const debugLogger: DebugLogger;
+export {};

package/dist/src/utils/debugLogger.js

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable no-console */
+import * as fs from 'node:fs';
+import * as util from 'node:util';
+/**
+ * A simple, centralized logger for developer-facing debug messages.
+ *
+ * WHY USE THIS?
+ * - It makes the INTENT of the log clear (it's for developers, not users).
+ * - It provides a single point of control for debug logging behavior.
+ * - We can lint against direct `console.*` usage to enforce this pattern.
+ *
+ * HOW IT WORKS:
+ * This is a thin wrapper around the native `console` object. The `ConsolePatcher`
+ * will intercept these calls and route them to the debug drawer UI.
+ */
+class DebugLogger {
+    logStream;
+    constructor() {
+        this.logStream = process.env['GEMINI_DEBUG_LOG_FILE']
+            ? fs.createWriteStream(process.env['GEMINI_DEBUG_LOG_FILE'], {
+                flags: 'a',
+            })
+            : undefined;
+        // Handle potential errors with the stream
+        this.logStream?.on('error', (err) => {
+            // Log to console as a fallback, but don't crash the app
+            console.error('Error writing to debug log stream:', err);
+        });
+    }
+    writeToFile(level, args) {
+        if (this.logStream) {
+            const message = util.format(...args);
+            const timestamp = new Date().toISOString();
+            const logEntry = `[${timestamp}] [${level}] ${message}\n`;
+            this.logStream.write(logEntry);
+        }
+    }
+    log(...args) {
+        this.writeToFile('LOG', args);
+        console.log(...args);
+    }
+    warn(...args) {
+        this.writeToFile('WARN', args);
+        console.warn(...args);
+    }
+    error(...args) {
+        this.writeToFile('ERROR', args);
+        console.error(...args);
+    }
+    debug(...args) {
+        this.writeToFile('DEBUG', args);
+        console.debug(...args);
+    }
+}
+export const debugLogger = new DebugLogger();
+//# sourceMappingURL=debugLogger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debugLogger.js","sourceRoot":"","sources":["../../../src/utils/debugLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+BAA+B;AAC/B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW;IACP,SAAS,CAA6B;IAE9C;QACE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;YACnD,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE;gBACzD,KAAK,EAAE,GAAG;aACX,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QACd,0CAA0C;QAC1C,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAClC,wDAAwD;YACxD,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,KAAa,EAAE,IAAe;QAChD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,SAAS,MAAM,KAAK,KAAK,OAAO,IAAI,CAAC;YAC1D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAG,IAAe;QACpB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { debugLogger } from './debugLogger.js';
+describe('DebugLogger', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should call console.log with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const message = 'This is a log message';
+        const data = { key: 'value' };
+        debugLogger.log(message, data);
+        expect(spy).toHaveBeenCalledWith(message, data);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should call console.warn with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const message = 'This is a warning message';
+        const data = [1, 2, 3];
+        debugLogger.warn(message, data);
+        expect(spy).toHaveBeenCalledWith(message, data);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should call console.error with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const message = 'This is an error message';
+        const error = new Error('Something went wrong');
+        debugLogger.error(message, error);
+        expect(spy).toHaveBeenCalledWith(message, error);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should call console.debug with the correct arguments', () => {
+        const spy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        const message = 'This is a debug message';
+        const obj = { a: { b: 'c' } };
+        debugLogger.debug(message, obj);
+        expect(spy).toHaveBeenCalledWith(message, obj);
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+    it('should handle multiple arguments correctly for all methods', () => {
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const debugSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        debugLogger.log('one', 2, true);
+        expect(logSpy).toHaveBeenCalledWith('one', 2, true);
+        debugLogger.warn('one', 2, false);
+        expect(warnSpy).toHaveBeenCalledWith('one', 2, false);
+        debugLogger.error('one', 2, null);
+        expect(errorSpy).toHaveBeenCalledWith('one', 2, null);
+        debugLogger.debug('one', 2, undefined);
+        expect(debugSpy).toHaveBeenCalledWith('one', 2, undefined);
+    });
+    it('should handle calls with no arguments', () => {
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        debugLogger.log();
+        expect(logSpy).toHaveBeenCalledWith();
+        expect(logSpy).toHaveBeenCalledTimes(1);
+        debugLogger.warn();
+        expect(warnSpy).toHaveBeenCalledWith();
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=debugLogger.test.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Factory to create a standard abort error for delay helpers.
+ */
+export declare function createAbortError(): Error;
+/**
+ * Returns a promise that resolves after the provided duration unless aborted.
+ *
+ * @param ms Delay duration in milliseconds.
+ * @param signal Optional abort signal to cancel the wait early.
+ */
+export declare function delay(ms: number, signal?: AbortSignal): Promise<void>;