@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.71

package/dist/__tests__/session-touch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-touch.test.d.ts.map

package/dist/__tests__/session-touch.test.d.ts.map

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

package/dist/__tests__/session-touch.test.js

@@ -0,0 +1,134 @@
+/**
+ * session-touch — verify convexCallWithSession auto-renews the session TTL.
+ * BET-181 Slice 1: Session Auto-Renew on Write.
+ *
+ * Done-when criteria tested:
+ * 1. After a successful convexCallWithSession, agent.touchSession is called with the current session ID
+ * 2. Touch happens in exactly ONE place (convexCallWithSession) — not per-command
+ * 3. Touch is fire-and-forget (does not block the write response)
+ * 4. When no session is active (session.json absent), no touch is attempted
+ * 5. When convexCallWithSession fails (write error), touch is NOT called
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// We need to control what readSession() returns per test.
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfig: vi.fn(() => ({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+// Import the module under test AFTER setting up mocks.
+import { convexCallWithSession } from '../lib/client.js';
+// Helper: build a fetch mock that returns different responses based on `fn`.
+function makeFetch({ writeOk = true, writeData = { ok: true }, } = {}) {
+    return vi.fn(async (_input, init) => {
+        const body = JSON.parse(String(init?.body ?? '{}'));
+        if (body.fn === 'agent.touchSession') {
+            return {
+                ok: true,
+                json: async () => ({ data: {} }),
+            };
+        }
+        // Default: the write call
+        return {
+            ok: writeOk,
+            statusText: writeOk ? 'OK' : 'Internal Server Error',
+            json: async () => (writeOk ? { data: writeData } : { error: 'Server error' }),
+        };
+    });
+}
+async function flushMicrotasks() {
+    // Two rounds of microtask flushing to allow the fire-and-forget .catch chain to settle.
+    await Promise.resolve();
+    await Promise.resolve();
+}
+describe('convexCallWithSession — session touch on write', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSession = {
+            sessionId: 'sess-abc123',
+            workspaceId: 'ws-1',
+            workspaceName: 'Product Brain',
+            startedAt: '2026-03-23T12:00:00Z',
+            entriesCaptured: [],
+        };
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('calls agent.touchSession with the current session ID after a successful write', async () => {
+        global.fetch = makeFetch({ writeOk: true, writeData: { entryId: 'BET-181' } });
+        await convexCallWithSession('chain.updateEntry', { entryId: 'BET-181', name: 'New name' });
+        await flushMicrotasks();
+        const calls = global.fetch.mock.calls;
+        // Expect exactly 2 fetch calls: the write + the touch
+        expect(calls).toHaveLength(2);
+        // First call: the actual write
+        const writeBody = JSON.parse(String(calls[0][1]?.body ?? '{}'));
+        expect(writeBody.fn).toBe('chain.updateEntry');
+        // Second call: the touch
+        const touchBody = JSON.parse(String(calls[1][1]?.body ?? '{}'));
+        expect(touchBody.fn).toBe('agent.touchSession');
+        expect(touchBody.args.sessionId).toBe('sess-abc123');
+    });
+    it('does NOT call agent.touchSession when no session is active', async () => {
+        mockSession = null;
+        global.fetch = makeFetch({ writeOk: true });
+        await convexCallWithSession('chain.updateEntry', { entryId: 'BET-100' });
+        await flushMicrotasks();
+        const calls = global.fetch.mock.calls;
+        // Only the write call — no touch
+        expect(calls).toHaveLength(1);
+        const body = JSON.parse(String(calls[0][1]?.body ?? '{}'));
+        expect(body.fn).toBe('chain.updateEntry');
+    });
+    it('does NOT call agent.touchSession when the write fails', async () => {
+        global.fetch = makeFetch({ writeOk: false });
+        await expect(convexCallWithSession('chain.updateEntry', { entryId: 'BET-100' })).rejects.toThrow('Server error');
+        await flushMicrotasks();
+        const calls = global.fetch.mock.calls;
+        // Only the write call — no touch because write threw
+        expect(calls).toHaveLength(1);
+        const body = JSON.parse(String(calls[0][1]?.body ?? '{}'));
+        expect(body.fn).toBe('chain.updateEntry');
+    });
+    it('touch errors are silently swallowed — write result is returned regardless', async () => {
+        // Touch call throws a network error
+        global.fetch = vi.fn(async (_input, init) => {
+            const body = JSON.parse(String(init?.body ?? '{}'));
+            if (body.fn === 'agent.touchSession') {
+                throw new Error('Network error');
+            }
+            return {
+                ok: true,
+                json: async () => ({ data: { entryId: 'BET-181' } }),
+            };
+        });
+        // Should resolve successfully despite touch throwing
+        const result = await convexCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
+        await flushMicrotasks();
+        expect(result).toEqual({ entryId: 'BET-181' });
+    });
+    it('touch is non-blocking — write resolves before touch completes', async () => {
+        const order = [];
+        global.fetch = vi.fn(async (_input, init) => {
+            const body = JSON.parse(String(init?.body ?? '{}'));
+            if (body.fn === 'agent.touchSession') {
+                // Simulate a slow touch
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                order.push('touch-complete');
+                return { ok: true, json: async () => ({ data: {} }) };
+            }
+            order.push('write-complete');
+            return { ok: true, json: async () => ({ data: { entryId: 'BET-181' } }) };
+        });
+        await convexCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
+        // Write has resolved — touch has NOT yet completed (it's still pending)
+        expect(order).toEqual(['write-complete']);
+        // After waiting for the touch to finish
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        expect(order).toEqual(['write-complete', 'touch-complete']);
+    });
+});
+//# sourceMappingURL=session-touch.test.js.map

package/dist/__tests__/session-touch.test.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.test.d.ts.map

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

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

package/dist/__tests__/session.test.js

@@ -0,0 +1,46 @@
+/**
+ * pb session id — verify local session read behavior.
+ * TEN-341 test contract: has session → prints ID, no session → exits 1.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runSessionId } from '../commands/session.js';
+vi.mock('../lib/client.js', () => ({
+    convexCall: vi.fn(),
+    convexCallWithSession: vi.fn(),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(),
+}));
+describe('runSessionId', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('prints session ID bare to stdout when session exists', () => {
+        mockSession = {
+            sessionId: 'rd79ppnrs9k8d4vtak39pzfmex8378f3',
+            workspaceId: 'ws-1',
+            workspaceName: 'Product Brain',
+            startedAt: '2026-03-19T12:00:00Z',
+            entriesCaptured: [],
+        };
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        runSessionId();
+        expect(writeSpy).toHaveBeenCalledWith('rd79ppnrs9k8d4vtak39pzfmex8378f3\n');
+        writeSpy.mockRestore();
+    });
+    it('throws CLIError when no session', () => {
+        mockSession = null;
+        expect(() => runSessionId()).toThrow('No active session');
+    });
+});
+//# sourceMappingURL=session.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../src/__tests__/session.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;IACnB,qBAAqB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC/B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAC3B,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAC/E;CACF,CAAC,CAAC,CAAC;AAEJ,IAAI,WAAW,GAA2H,IAAI,CAAC;AAC/I,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW;IAC9B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC1B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;CACtB,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,WAAW,GAAG;YACZ,SAAS,EAAE,kCAAkC;YAC7C,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,eAAe;YAC9B,SAAS,EAAE,sBAAsB;YACjC,eAAe,EAAE,EAAE;SACpB,CAAC;QACF,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAElF,YAAY,EAAE,CAAC;QAEf,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,oCAAoC,CAAC,CAAC;QAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.test.d.ts.map

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

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

package/dist/__tests__/setup.test.js

@@ -0,0 +1,141 @@
+/**
+ * pb setup — guided onboarding tests.
+ * WP-301 Slice 3, WP-304 (LLM onboarding). Verifies:
+ *   - setup with valid existing config goes to onboarding conversation
+ *   - setup with no config triggers login prompt
+ *   - setup tracks telemetry events
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// Track telemetry calls in order
+const telemetryEvents = [];
+vi.mock('../lib/telemetry.js', () => ({
+    trackEvent: (event) => {
+        telemetryEvents.push(event);
+    },
+    initTelemetry: vi.fn(),
+}));
+const convexCallMock = vi.fn();
+const convexCallWithSessionMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    convexCall: (...args) => convexCallMock(...args),
+    convexCallWithSession: (...args) => convexCallWithSessionMock(...args),
+}));
+let mockConfig = {
+    apiKey: 'pb_sk_test_key_1234',
+    siteUrl: 'https://test.convex.site',
+};
+vi.mock('../lib/config.js', () => ({
+    getConfig: () => {
+        if (!mockConfig)
+            throw new Error('No API key.');
+        return mockConfig;
+    },
+    getConfigOrGuide: vi.fn(() => mockConfig
+        ? Promise.resolve(mockConfig)
+        : Promise.reject(new Error('No API key.'))),
+    HOME_CONFIG_DIR: '/tmp/test-config',
+    HOME_ENV_PATH: '/tmp/test-config/.env',
+}));
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+const runLoginMock = vi.fn();
+vi.mock('../commands/login.js', () => ({
+    runLogin: () => runLoginMock(),
+}));
+// Mock both onboarding paths — they have their own test files
+const runOnboardingMock = vi.fn();
+vi.mock('../lib/onboarding.js', () => ({
+    runOnboardingConversation: (...args) => runOnboardingMock(...args),
+}));
+const runOnboardingPathBMock = vi.fn();
+vi.mock('../lib/onboarding-path-b.js', () => ({
+    runOnboardingPathB: (...args) => runOnboardingPathBMock(...args),
+}));
+vi.mock('../lib/experiment.js', () => ({
+    isExperimentActive: () => false,
+    assignOnboardingPath: () => 'B',
+}));
+let confirmAnswers = [];
+let confirmIndex = 0;
+vi.mock('../lib/prompts.js', () => ({
+    confirm: () => {
+        const answer = confirmAnswers[confirmIndex] ?? false;
+        confirmIndex++;
+        return Promise.resolve(answer);
+    },
+    ask: () => Promise.resolve(''),
+    password: () => Promise.resolve(''),
+    select: () => Promise.resolve(''),
+    isInteractive: () => true,
+}));
+import { runSetup } from '../commands/setup.js';
+describe('runSetup', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        runOnboardingPathBMock.mockReset();
+        telemetryEvents.length = 0;
+        confirmAnswers = [];
+        confirmIndex = 0;
+        mockConfig = { apiKey: 'pb_sk_test_key_1234', siteUrl: 'https://test.convex.site' };
+        mockSession = null;
+    });
+    it('skips login when valid config exists and runs onboarding', async () => {
+        convexCallMock.mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }); // resolveWorkspace
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should NOT call runLogin
+        expect(runLoginMock).not.toHaveBeenCalled();
+        // Should show masked key
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('pb_sk_'));
+        // Should show workspace name
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Test Workspace'));
+        // Should call onboarding path B (default path)
+        expect(runOnboardingPathBMock).toHaveBeenCalledWith('Test Workspace');
+        logSpy.mockRestore();
+    });
+    it('triggers login prompt when no valid config exists', async () => {
+        mockConfig = null;
+        // User answers: false to "Do you have an account?"
+        confirmAnswers = [false];
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should show signup guidance
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('productbrain.io'));
+        // Should NOT call runLogin since user said no account
+        expect(runLoginMock).not.toHaveBeenCalled();
+        logSpy.mockRestore();
+    });
+    it('calls runLogin when user has account but no config', async () => {
+        mockConfig = null;
+        // User answers: true to "have account?"
+        confirmAnswers = [true];
+        // After login, config becomes valid
+        runLoginMock.mockImplementation(() => {
+            mockConfig = { apiKey: 'pb_sk_new_key', siteUrl: 'https://test.convex.site' };
+        });
+        convexCallMock.mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }); // resolveWorkspace
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        expect(runLoginMock).toHaveBeenCalledOnce();
+        expect(telemetryEvents).toContain('key_validated');
+        // Should call onboarding path B after login (default path)
+        expect(runOnboardingPathBMock).toHaveBeenCalledWith('Test Workspace');
+        logSpy.mockRestore();
+    });
+    it('handles workspace verification failure gracefully', async () => {
+        convexCallMock.mockRejectedValueOnce(new Error('Network error')); // resolveWorkspace fails
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should warn about connection
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Could not verify'));
+        // Should NOT call onboarding
+        expect(runOnboardingMock).not.toHaveBeenCalled();
+        logSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=setup.test.js.map

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

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

package/dist/__tests__/spinner-labels.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spinner-labels.test.d.ts.map

package/dist/__tests__/spinner-labels.test.d.ts.map

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

package/dist/__tests__/spinner-labels.test.js

@@ -0,0 +1,23 @@
+/**
+ * spinnerLabel — unit tests.
+ * WP-303 Slice 2: Ambient Feedback (Spinners).
+ *
+ * Verifies the MCP function name -> friendly label mapping.
+ */
+import { describe, expect, it } from 'vitest';
+import { spinnerLabel } from '../lib/client.js';
+describe('spinnerLabel', () => {
+    it('maps known MCP functions to friendly labels', () => {
+        expect(spinnerLabel('orient')).toBe('Loading workspace overview');
+        expect(spinnerLabel('entries.get')).toBe('Loading entry');
+        expect(spinnerLabel('capture-quick')).toBe('Capturing to Chain');
+        expect(spinnerLabel('agent.startSession')).toBe('Starting session');
+    });
+    it('generates a fallback label for unknown functions', () => {
+        expect(spinnerLabel('some.unknown.tool')).toBe('Loading some unknown tool');
+    });
+    it('handles simple function names in fallback', () => {
+        expect(spinnerLabel('foobar')).toBe('Loading foobar');
+    });
+});
+//# sourceMappingURL=spinner-labels.test.js.map

package/dist/__tests__/spinner-labels.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-labels.test.js","sourceRoot":"","sources":["../../src/__tests__/spinner-labels.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAClE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strip.test.d.ts.map

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

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

package/dist/__tests__/strip.test.js

@@ -0,0 +1,136 @@
+/**
+ * stripConvexInternals — unit tests.
+ * BET-181 Slice 0: TEN-340 (Convex internal exposure), DEC-299 (JSON-default output).
+ *
+ * Verifies: removes _id and _creationTime, preserves entryId and all other fields,
+ * handles nested objects and arrays, does not mutate input.
+ */
+import { describe, expect, it } from 'vitest';
+import { stripConvexInternals } from '../lib/strip.js';
+describe('stripConvexInternals', () => {
+    it('removes _id from a flat object', () => {
+        const input = { _id: 'j57abc', entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        expect(result).toHaveProperty('name', 'Test');
+    });
+    it('removes _creationTime from a flat object', () => {
+        const input = { _creationTime: 1700000000000, entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+    });
+    it('removes both _id and _creationTime simultaneously', () => {
+        const input = {
+            _id: 'j57abc',
+            _creationTime: 1700000000000,
+            entryId: 'BET-181',
+            name: 'Test',
+            status: 'active',
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toEqual({ entryId: 'BET-181', name: 'Test', status: 'active' });
+    });
+    it('preserves entryId (human-readable) unconditionally', () => {
+        const input = { _id: 'sys1', _creationTime: 123, entryId: 'DEC-299' };
+        const result = stripConvexInternals(input);
+        expect(result).toHaveProperty('entryId', 'DEC-299');
+    });
+    it('preserves all other fields untouched', () => {
+        const input = {
+            _id: 'sys1',
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'work-packages',
+            data: { description: 'hello' },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).toEqual({
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'work-packages',
+            data: { description: 'hello' },
+        });
+    });
+    it('recursively strips _id and _creationTime from nested objects', () => {
+        const input = {
+            entryId: 'BET-181',
+            relations: [
+                { _id: 'rel1', _creationTime: 111, type: 'part_of', otherEntryId: 'INI-1' },
+            ],
+            data: {
+                _id: 'should-be-removed',
+                description: 'keep this',
+            },
+        };
+        const result = stripConvexInternals(input);
+        // Top level
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        // Nested in array
+        const rel = result.relations[0];
+        expect(rel).not.toHaveProperty('_id');
+        expect(rel).not.toHaveProperty('_creationTime');
+        expect(rel).toHaveProperty('type', 'part_of');
+        expect(rel).toHaveProperty('otherEntryId', 'INI-1');
+        // Nested in object
+        const data = result.data;
+        expect(data).not.toHaveProperty('_id');
+        expect(data).toHaveProperty('description', 'keep this');
+    });
+    it('handles arrays of objects', () => {
+        const input = [
+            { _id: 'a', entryId: 'BET-1', name: 'Bet 1' },
+            { _id: 'b', _creationTime: 999, entryId: 'TEN-1', name: 'Tension 1' },
+        ];
+        const result = stripConvexInternals(input);
+        expect(result).toHaveLength(2);
+        expect(result[0]).not.toHaveProperty('_id');
+        expect(result[0]).toHaveProperty('entryId', 'BET-1');
+        expect(result[1]).not.toHaveProperty('_id');
+        expect(result[1]).not.toHaveProperty('_creationTime');
+        expect(result[1]).toHaveProperty('entryId', 'TEN-1');
+    });
+    it('handles null values without error', () => {
+        const result = stripConvexInternals(null);
+        expect(result).toBeNull();
+    });
+    it('handles primitive values (string, number, boolean) as pass-through', () => {
+        expect(stripConvexInternals('hello')).toBe('hello');
+        expect(stripConvexInternals(42)).toBe(42);
+        expect(stripConvexInternals(true)).toBe(true);
+    });
+    it('does not mutate the input object', () => {
+        const input = { _id: 'sys1', entryId: 'BET-1', name: 'Test' };
+        const inputCopy = { ...input };
+        stripConvexInternals(input);
+        expect(input).toEqual(inputCopy);
+    });
+    it('handles empty objects and arrays', () => {
+        expect(stripConvexInternals({})).toEqual({});
+        expect(stripConvexInternals([])).toEqual([]);
+    });
+    it('handles deeply nested structures', () => {
+        const input = {
+            _id: 'top',
+            level1: {
+                _id: 'l1',
+                level2: {
+                    _id: 'l2',
+                    _creationTime: 123,
+                    value: 'deep',
+                },
+            },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        const r = result;
+        expect(r.level1).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_creationTime');
+        expect(r.level1.level2['value']).toBe('deep');
+    });
+});
+//# sourceMappingURL=strip.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strip.test.js","sourceRoot":"","sources":["../../src/__tests__/strip.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACjF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,KAAK,GAAG;YACZ,GAAG,EAAE,QAAQ;YACb,aAAa,EAAE,aAAa;YAC5B,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ;SACjB,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACtE,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG;YACZ,GAAG,EAAE,MAAM;YACX,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,OAAO;YACf,cAAc,EAAE,eAAe;YAC/B,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;SAC/B,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,OAAO;YACf,cAAc,EAAE,eAAe;YAC/B,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE;gBACT,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE;aAC5E;YACD,IAAI,EAAE;gBACJ,GAAG,EAAE,mBAAmB;gBACxB,WAAW,EAAE,WAAW;aACzB;SACF,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAE3C,YAAY;QACZ,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAEpD,kBAAkB;QAClB,MAAM,GAAG,GAAI,MAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAEpD,mBAAmB;QACnB,MAAM,IAAI,GAAI,MAAuB,CAAC,IAAI,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,KAAK,GAAG;YACZ,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;YAC7C,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE;SACtE,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAC/B,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG;YACZ,GAAG,EAAE,KAAK;YACV,MAAM,EAAE;gBACN,GAAG,EAAE,IAAI;gBACT,MAAM,EAAE;oBACN,GAAG,EAAE,IAAI;oBACT,aAAa,EAAE,GAAG;oBAClB,KAAK,EAAE,MAAM;iBACd;aACF;SACF,CAAC;QACF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,MAAsB,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,CAAE,CAAC,CAAC,MAAM,CAAC,MAAkC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/surface-profiles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surface-profiles.test.d.ts.map

package/dist/__tests__/surface-profiles.test.d.ts.map

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