@illuma-ai/observability-core 0.1.0 → 0.2.0

package/dist/__tests__/types.test.js

@@ -0,0 +1,453 @@
+/**
+ * Unit tests for the observability type system.
+ *
+ * Validates enum values, ingestion event type constants, and structural
+ * compatibility of all parameter interfaces (TraceParams, GenerationParams,
+ * SpanParams, ScoreParams, ErrorInfo, etc.).
+ */
+import { describe, it, expect } from 'vitest';
+import { ObservationType, ObservationLevel, IngestionEventType, } from '../index.js';
+// ---------------------------------------------------------------------------
+// ObservationType enum
+// ---------------------------------------------------------------------------
+describe('ObservationType', () => {
+    it('should have exactly 10 values', () => {
+        const values = Object.values(ObservationType);
+        expect(values).toHaveLength(10);
+    });
+    it.each([
+        ['SPAN', 'SPAN'],
+        ['GENERATION', 'GENERATION'],
+        ['EVENT', 'EVENT'],
+        ['AGENT', 'AGENT'],
+        ['TOOL', 'TOOL'],
+        ['CHAIN', 'CHAIN'],
+        ['RETRIEVER', 'RETRIEVER'],
+        ['EVALUATOR', 'EVALUATOR'],
+        ['EMBEDDING', 'EMBEDDING'],
+        ['GUARDRAIL', 'GUARDRAIL'],
+    ])('should have %s = "%s"', (key, expected) => {
+        expect(ObservationType[key]).toBe(expected);
+    });
+    it('should use string values matching the key names', () => {
+        // All values should equal their keys (uppercase pattern)
+        for (const [key, value] of Object.entries(ObservationType)) {
+            expect(value).toBe(key);
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// ObservationLevel enum
+// ---------------------------------------------------------------------------
+describe('ObservationLevel', () => {
+    it('should have exactly 4 values', () => {
+        const values = Object.values(ObservationLevel);
+        expect(values).toHaveLength(4);
+    });
+    it.each([
+        ['DEBUG', 'DEBUG'],
+        ['DEFAULT', 'DEFAULT'],
+        ['WARNING', 'WARNING'],
+        ['ERROR', 'ERROR'],
+    ])('should have %s = "%s"', (key, expected) => {
+        expect(ObservationLevel[key]).toBe(expected);
+    });
+});
+// ---------------------------------------------------------------------------
+// IngestionEventType constants
+// ---------------------------------------------------------------------------
+describe('IngestionEventType', () => {
+    it('should have all core event types', () => {
+        expect(IngestionEventType.TRACE_CREATE).toBe('trace-create');
+        expect(IngestionEventType.SPAN_CREATE).toBe('span-create');
+        expect(IngestionEventType.SPAN_UPDATE).toBe('span-update');
+        expect(IngestionEventType.GENERATION_CREATE).toBe('generation-create');
+        expect(IngestionEventType.GENERATION_UPDATE).toBe('generation-update');
+        expect(IngestionEventType.EVENT_CREATE).toBe('event-create');
+        expect(IngestionEventType.SCORE_CREATE).toBe('score-create');
+        expect(IngestionEventType.SDK_LOG).toBe('sdk-log');
+    });
+    it('should have all new typed observation event types', () => {
+        expect(IngestionEventType.AGENT_CREATE).toBe('agent-create');
+        expect(IngestionEventType.TOOL_CREATE).toBe('tool-create');
+        expect(IngestionEventType.CHAIN_CREATE).toBe('chain-create');
+        expect(IngestionEventType.RETRIEVER_CREATE).toBe('retriever-create');
+        expect(IngestionEventType.EVALUATOR_CREATE).toBe('evaluator-create');
+        expect(IngestionEventType.EMBEDDING_CREATE).toBe('embedding-create');
+        expect(IngestionEventType.GUARDRAIL_CREATE).toBe('guardrail-create');
+    });
+    it('should have the dataset-run-item-create event type', () => {
+        expect(IngestionEventType.DATASET_RUN_ITEM_CREATE).toBe('dataset-run-item-create');
+    });
+    it('should have exactly 16 event type constants', () => {
+        const keys = Object.keys(IngestionEventType);
+        expect(keys).toHaveLength(16);
+    });
+    it('should use kebab-case string values', () => {
+        for (const value of Object.values(IngestionEventType)) {
+            expect(value).toMatch(/^[a-z]+-[a-z]+(-[a-z]+)*$/);
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// ErrorInfo interface
+// ---------------------------------------------------------------------------
+describe('ErrorInfo', () => {
+    it('should accept required fields (exceptionType, traceback)', () => {
+        const error = {
+            exceptionType: 'ValueError',
+            traceback: 'Traceback (most recent call last):\n  File "main.py", line 42',
+        };
+        expect(error.exceptionType).toBe('ValueError');
+        expect(error.traceback).toContain('Traceback');
+    });
+    it('should accept the optional message field', () => {
+        const error = {
+            exceptionType: 'TypeError',
+            message: 'cannot read property of undefined',
+            traceback: 'at Object.<anonymous> (index.js:1:1)',
+        };
+        expect(error.message).toBe('cannot read property of undefined');
+    });
+    it('should not require message', () => {
+        const error = {
+            exceptionType: 'RuntimeError',
+            traceback: 'stack trace here',
+        };
+        expect(error.message).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// TraceParams type compatibility
+// ---------------------------------------------------------------------------
+describe('TraceParams', () => {
+    it('should accept all base fields', () => {
+        const params = {
+            id: 'trace-1',
+            name: 'my-trace',
+            userId: 'user-1',
+            sessionId: 'session-1',
+            input: { prompt: 'hello' },
+            output: { response: 'world' },
+            metadata: { key: 'value' },
+            tags: ['tag1', 'tag2'],
+            public: true,
+            version: '1.0.0',
+            timestamp: '2024-01-01T00:00:00.000Z',
+        };
+        expect(params.name).toBe('my-trace');
+        expect(params.tags).toHaveLength(2);
+    });
+    it('should accept the new release field', () => {
+        const params = { release: 'v2.3.1' };
+        expect(params.release).toBe('v2.3.1');
+    });
+    it('should accept the new environment field', () => {
+        const params = { environment: 'production' };
+        expect(params.environment).toBe('production');
+    });
+    it('should accept the new externalId field', () => {
+        const params = { externalId: 'ext-abc-123' };
+        expect(params.externalId).toBe('ext-abc-123');
+    });
+    it('should accept the new threadId field', () => {
+        const params = { threadId: 'thread-conv-456' };
+        expect(params.threadId).toBe('thread-conv-456');
+    });
+    it('should accept the new errorInfo field', () => {
+        const params = {
+            errorInfo: {
+                exceptionType: 'TimeoutError',
+                message: 'Request timed out',
+                traceback: 'at Timer.setTimeout (node:internal/timers:1:1)',
+            },
+        };
+        expect(params.errorInfo).toBeDefined();
+        expect(params.errorInfo.exceptionType).toBe('TimeoutError');
+        expect(params.errorInfo.message).toBe('Request timed out');
+        expect(params.errorInfo.traceback).toContain('Timer');
+    });
+    it('should accept all new fields together', () => {
+        const params = {
+            name: 'full-trace',
+            release: 'abc123',
+            environment: 'staging',
+            externalId: 'jira-PROJ-999',
+            threadId: 'thread-multi-turn',
+            errorInfo: {
+                exceptionType: 'Error',
+                traceback: 'stack',
+            },
+        };
+        expect(params.release).toBe('abc123');
+        expect(params.environment).toBe('staging');
+        expect(params.externalId).toBe('jira-PROJ-999');
+        expect(params.threadId).toBe('thread-multi-turn');
+        expect(params.errorInfo).toBeDefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// GenerationParams type compatibility
+// ---------------------------------------------------------------------------
+describe('GenerationParams', () => {
+    it('should accept the provider field', () => {
+        const params = {
+            model: 'gpt-4o',
+            provider: 'openai',
+        };
+        expect(params.provider).toBe('openai');
+    });
+    it('should accept the costDetails field', () => {
+        const params = {
+            costDetails: { input: 0.015, output: 0.06, cached: 0.0075 },
+        };
+        expect(params.costDetails.input).toBe(0.015);
+        expect(params.costDetails.cached).toBe(0.0075);
+    });
+    it('should accept the usageDetails field', () => {
+        const params = {
+            usageDetails: { cachedTokens: 200, audioTokens: 50, reasoningTokens: 1024 },
+        };
+        expect(params.usageDetails.cachedTokens).toBe(200);
+        expect(params.usageDetails.reasoningTokens).toBe(1024);
+    });
+    it('should accept the errorInfo field', () => {
+        const params = {
+            errorInfo: {
+                exceptionType: 'RateLimitError',
+                message: '429 Too Many Requests',
+                traceback: 'at OpenAI.request (openai.js:100:1)',
+            },
+        };
+        expect(params.errorInfo.exceptionType).toBe('RateLimitError');
+    });
+    it('should accept the environment field', () => {
+        const params = { environment: 'development' };
+        expect(params.environment).toBe('development');
+    });
+    it('should accept all generation-specific fields together', () => {
+        const params = {
+            id: 'gen-1',
+            name: 'completion',
+            model: 'claude-sonnet-4-20250514',
+            provider: 'anthropic',
+            input: [{ role: 'user', content: 'Hi' }],
+            output: { role: 'assistant', content: 'Hello!' },
+            usage: { input: 10, output: 5, total: 15, unit: 'TOKENS' },
+            usageDetails: { cachedTokens: 3 },
+            costDetails: { input: 0.01, output: 0.02 },
+            environment: 'production',
+            errorInfo: {
+                exceptionType: 'None',
+                traceback: '',
+            },
+            level: ObservationLevel.DEFAULT,
+            promptName: 'chat-prompt',
+            promptVersion: 2,
+            modelParameters: { temperature: 0.7 },
+        };
+        expect(params.provider).toBe('anthropic');
+        expect(params.usageDetails.cachedTokens).toBe(3);
+        expect(params.costDetails.input).toBe(0.01);
+    });
+});
+// ---------------------------------------------------------------------------
+// SpanParams type compatibility
+// ---------------------------------------------------------------------------
+describe('SpanParams', () => {
+    it('should accept the type field with ObservationType values', () => {
+        const agentSpan = {
+            name: 'agent-run',
+            type: ObservationType.AGENT,
+        };
+        expect(agentSpan.type).toBe('AGENT');
+        const toolSpan = {
+            name: 'tool-call',
+            type: ObservationType.TOOL,
+        };
+        expect(toolSpan.type).toBe('TOOL');
+    });
+    it('should accept all ObservationType values for the type field', () => {
+        const allTypes = Object.values(ObservationType);
+        for (const obsType of allTypes) {
+            const params = { type: obsType };
+            expect(params.type).toBe(obsType);
+        }
+    });
+    it('should accept the model field', () => {
+        const params = { model: 'gpt-4o-mini' };
+        expect(params.model).toBe('gpt-4o-mini');
+    });
+    it('should accept the provider field', () => {
+        const params = { provider: 'aws_bedrock' };
+        expect(params.provider).toBe('aws_bedrock');
+    });
+    it('should accept the usage field', () => {
+        const params = {
+            usage: { input: 100, output: 50, total: 150, unit: 'TOKENS' },
+        };
+        expect(params.usage.total).toBe(150);
+    });
+    it('should accept the environment field', () => {
+        const params = { environment: 'staging' };
+        expect(params.environment).toBe('staging');
+    });
+    it('should accept the errorInfo field', () => {
+        const params = {
+            errorInfo: {
+                exceptionType: 'ConnectionError',
+                message: 'Vector DB unreachable',
+                traceback: 'at Retriever.search (retriever.ts:55:3)',
+            },
+        };
+        expect(params.errorInfo.exceptionType).toBe('ConnectionError');
+    });
+    it('should accept all new fields together for a retriever span', () => {
+        const params = {
+            name: 'vector-search',
+            type: ObservationType.RETRIEVER,
+            model: 'text-embedding-3-small',
+            provider: 'openai',
+            usage: { input: 50, total: 50 },
+            environment: 'production',
+            errorInfo: {
+                exceptionType: 'None',
+                traceback: '',
+            },
+        };
+        expect(params.type).toBe('RETRIEVER');
+        expect(params.model).toBe('text-embedding-3-small');
+        expect(params.provider).toBe('openai');
+    });
+});
+// ---------------------------------------------------------------------------
+// ScoreParams type compatibility
+// ---------------------------------------------------------------------------
+describe('ScoreParams', () => {
+    it('should require traceId, name, and value', () => {
+        const params = {
+            traceId: 'trace-1',
+            name: 'accuracy',
+            value: 0.95,
+        };
+        expect(params.traceId).toBe('trace-1');
+        expect(params.name).toBe('accuracy');
+        expect(params.value).toBe(0.95);
+    });
+    describe('dataType', () => {
+        it.each(['NUMERIC', 'BOOLEAN', 'CATEGORICAL', 'CORRECTION'])('should accept dataType = "%s"', (dataType) => {
+            const params = {
+                traceId: 'trace-1',
+                name: 'metric',
+                value: 1,
+                dataType,
+            };
+            expect(params.dataType).toBe(dataType);
+        });
+    });
+    describe('source', () => {
+        it.each(['API', 'EVAL', 'ANNOTATION'])('should accept source = "%s"', (source) => {
+            const params = {
+                traceId: 'trace-1',
+                name: 'metric',
+                value: 1,
+                source,
+            };
+            expect(params.source).toBe(source);
+        });
+    });
+    it('should accept the metadata field', () => {
+        const params = {
+            traceId: 'trace-1',
+            name: 'quality',
+            value: 0.8,
+            metadata: { evaluatorVersion: '2.0', runId: 'eval-run-42' },
+        };
+        expect(params.metadata.evaluatorVersion).toBe('2.0');
+    });
+    it('should accept the sessionId field', () => {
+        const params = {
+            traceId: 'trace-1',
+            name: 'session-quality',
+            value: 4,
+            sessionId: 'session-abc',
+        };
+        expect(params.sessionId).toBe('session-abc');
+    });
+    it('should accept the stringValue field', () => {
+        const params = {
+            traceId: 'trace-1',
+            name: 'sentiment',
+            value: 1,
+            dataType: 'CATEGORICAL',
+            stringValue: 'positive',
+        };
+        expect(params.stringValue).toBe('positive');
+    });
+    it('should accept the environment field', () => {
+        const params = {
+            traceId: 'trace-1',
+            name: 'metric',
+            value: 1,
+            environment: 'production',
+        };
+        expect(params.environment).toBe('production');
+    });
+    it('should accept all optional fields together', () => {
+        const params = {
+            id: 'score-1',
+            traceId: 'trace-1',
+            observationId: 'gen-1',
+            sessionId: 'session-1',
+            name: 'comprehensive-score',
+            value: 0.75,
+            stringValue: 'good',
+            comment: 'Mostly correct but missed edge case',
+            dataType: 'CATEGORICAL',
+            source: 'ANNOTATION',
+            metadata: { annotatorId: 'user-5', round: 2 },
+            configId: 'config-abc',
+            environment: 'staging',
+        };
+        expect(params.dataType).toBe('CATEGORICAL');
+        expect(params.source).toBe('ANNOTATION');
+        expect(params.stringValue).toBe('good');
+        expect(params.metadata.round).toBe(2);
+    });
+});
+// ---------------------------------------------------------------------------
+// UsageParams and UsageDetailsParams
+// ---------------------------------------------------------------------------
+describe('UsageParams', () => {
+    it('should accept all standard usage fields', () => {
+        const usage = {
+            input: 100,
+            output: 50,
+            total: 150,
+            unit: 'TOKENS',
+            inputCost: 0.01,
+            outputCost: 0.02,
+            totalCost: 0.03,
+        };
+        expect(usage.total).toBe(150);
+        expect(usage.totalCost).toBe(0.03);
+    });
+    it('should allow partial usage (all fields optional)', () => {
+        const usage = { total: 42 };
+        expect(usage.total).toBe(42);
+        expect(usage.input).toBeUndefined();
+    });
+});
+describe('UsageDetailsParams', () => {
+    it('should accept arbitrary string keys with numeric values', () => {
+        const details = {
+            cachedTokens: 200,
+            audioTokens: 50,
+            reasoningTokens: 1024,
+            imageTokens: 0,
+        };
+        expect(details.cachedTokens).toBe(200);
+        expect(Object.keys(details)).toHaveLength(4);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/__tests__/types.test.js.map

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

package/dist/__tests__/utils.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for observability SDK utility functions.
+ *
+ * Covers: generateId, currentISOTimestamp, safeStringify, encodeBasicAuth, backoffDelay.
+ */
+export {};
+//# sourceMappingURL=utils.test.d.ts.map

package/dist/__tests__/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/utils.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/utils.test.js

@@ -0,0 +1,164 @@
+/**
+ * Unit tests for observability SDK utility functions.
+ *
+ * Covers: generateId, currentISOTimestamp, safeStringify, encodeBasicAuth, backoffDelay.
+ */
+import { describe, it, expect } from 'vitest';
+import { generateId, currentISOTimestamp, safeStringify, encodeBasicAuth, backoffDelay, } from '../utils.js';
+// ---------------------------------------------------------------------------
+// generateId
+// ---------------------------------------------------------------------------
+describe('generateId', () => {
+    it('should return a string', () => {
+        expect(typeof generateId()).toBe('string');
+    });
+    it('should return unique values on consecutive calls', () => {
+        const ids = new Set(Array.from({ length: 100 }, () => generateId()));
+        expect(ids.size).toBe(100);
+    });
+    it('should return a valid UUID format', () => {
+        const id = generateId();
+        // Standard UUID v4 pattern: 8-4-4-4-12 hex chars
+        expect(id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+    });
+});
+// ---------------------------------------------------------------------------
+// currentISOTimestamp
+// ---------------------------------------------------------------------------
+describe('currentISOTimestamp', () => {
+    it('should return a valid ISO-8601 string', () => {
+        const ts = currentISOTimestamp();
+        // ISO format: YYYY-MM-DDTHH:MM:SS.sssZ
+        expect(ts).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/);
+    });
+    it('should return the current time', () => {
+        const before = Date.now();
+        const ts = currentISOTimestamp();
+        const after = Date.now();
+        const parsed = new Date(ts).getTime();
+        expect(parsed).toBeGreaterThanOrEqual(before);
+        expect(parsed).toBeLessThanOrEqual(after);
+    });
+    it('should return a parseable Date string', () => {
+        const ts = currentISOTimestamp();
+        const date = new Date(ts);
+        expect(date.toISOString()).toBe(ts);
+    });
+});
+// ---------------------------------------------------------------------------
+// safeStringify
+// ---------------------------------------------------------------------------
+describe('safeStringify', () => {
+    it('should stringify plain objects', () => {
+        const result = safeStringify({ a: 1, b: 'two' });
+        expect(JSON.parse(result)).toEqual({ a: 1, b: 'two' });
+    });
+    it('should handle circular references without throwing', () => {
+        const obj = { name: 'root' };
+        obj.self = obj;
+        const result = safeStringify(obj);
+        expect(result).toContain('"name":"root"');
+        expect(result).toContain('[Circular]');
+    });
+    it('should handle nested circular references', () => {
+        const a = { label: 'a' };
+        const b = { label: 'b', parent: a };
+        a.child = b;
+        b.grandchild = a; // circular back to a
+        const result = safeStringify(a);
+        expect(result).toContain('[Circular]');
+        expect(result).toContain('"label":"a"');
+    });
+    it('should handle BigInt values by converting to string', () => {
+        const result = safeStringify({ big: BigInt(9007199254740991) });
+        const parsed = JSON.parse(result);
+        expect(parsed.big).toBe('9007199254740991');
+    });
+    it('should handle null and undefined', () => {
+        expect(safeStringify(null)).toBe('null');
+        // undefined at top level is converted via String()
+        expect(safeStringify(undefined)).toBe(undefined);
+    });
+    it('should support indent parameter', () => {
+        const result = safeStringify({ a: 1 }, 2);
+        expect(result).toContain('\n');
+        expect(result).toContain('  ');
+    });
+    it('should stringify arrays', () => {
+        const result = safeStringify([1, 2, 3]);
+        expect(JSON.parse(result)).toEqual([1, 2, 3]);
+    });
+    it('should stringify nested objects', () => {
+        const result = safeStringify({ a: { b: { c: 42 } } });
+        expect(JSON.parse(result)).toEqual({ a: { b: { c: 42 } } });
+    });
+});
+// ---------------------------------------------------------------------------
+// encodeBasicAuth
+// ---------------------------------------------------------------------------
+describe('encodeBasicAuth', () => {
+    it('should produce a Basic auth header string', () => {
+        const result = encodeBasicAuth('public', 'secret');
+        expect(result).toMatch(/^Basic .+$/);
+    });
+    it('should encode credentials as base64', () => {
+        const result = encodeBasicAuth('pk-abc', 'sk-xyz');
+        const expected = `Basic ${Buffer.from('pk-abc:sk-xyz').toString('base64')}`;
+        expect(result).toBe(expected);
+    });
+    it('should handle special characters in keys', () => {
+        const result = encodeBasicAuth('pk+special/key=', 'sk:pass@word!');
+        const expected = `Basic ${Buffer.from('pk+special/key=:sk:pass@word!').toString('base64')}`;
+        expect(result).toBe(expected);
+    });
+    it('should handle empty strings', () => {
+        const result = encodeBasicAuth('', '');
+        const expected = `Basic ${Buffer.from(':').toString('base64')}`;
+        expect(result).toBe(expected);
+    });
+});
+// ---------------------------------------------------------------------------
+// backoffDelay
+// ---------------------------------------------------------------------------
+describe('backoffDelay', () => {
+    it('should return a number', () => {
+        expect(typeof backoffDelay(0)).toBe('number');
+    });
+    it('should increase with attempt number on average', () => {
+        // Run many samples to account for jitter
+        const samples = 50;
+        const avgAttempt0 = Array.from({ length: samples }, () => backoffDelay(0)).reduce((a, b) => a + b, 0) / samples;
+        const avgAttempt3 = Array.from({ length: samples }, () => backoffDelay(3)).reduce((a, b) => a + b, 0) / samples;
+        expect(avgAttempt3).toBeGreaterThan(avgAttempt0);
+    });
+    it('should respect the 30 second cap', () => {
+        // Very high attempt number should still be capped
+        for (let i = 0; i < 20; i++) {
+            const delay = backoffDelay(20);
+            expect(delay).toBeLessThanOrEqual(30_000);
+        }
+    });
+    it('should use exponential growth (base * 2^attempt)', () => {
+        // With jitter of up to 25%, the delay should be between base*2^n and base*2^n*1.25
+        const baseMs = 1000;
+        for (let attempt = 0; attempt < 4; attempt++) {
+            const exponential = baseMs * Math.pow(2, attempt);
+            const delay = backoffDelay(attempt, baseMs);
+            expect(delay).toBeGreaterThanOrEqual(exponential);
+            expect(delay).toBeLessThanOrEqual(exponential * 1.25);
+        }
+    });
+    it('should accept a custom base delay', () => {
+        const delay = backoffDelay(0, 500);
+        // Attempt 0 with base 500: 500 + jitter (up to 125)
+        expect(delay).toBeGreaterThanOrEqual(500);
+        expect(delay).toBeLessThanOrEqual(625);
+    });
+    it('should add jitter (non-deterministic within range)', () => {
+        // Two calls with the same attempt should very likely produce different values
+        // (only fails with probability ~1/2^52)
+        const delays = new Set(Array.from({ length: 10 }, () => backoffDelay(2)));
+        expect(delays.size).toBeGreaterThan(1);
+    });
+});
+//# sourceMappingURL=utils.test.js.map