@devrev/airsync-sdk 2.0.0-beta.3 → 2.0.0-beta.5

package/dist/state/state.pending-boundaries.test.js

@@ -1,189 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const jest_setup_1 = require("../tests/jest.setup");
-const test_utils_1 = require("../common/test-utils");
-const extraction_1 = require("../types/extraction");
-const extraction_state_1 = require("./extraction-state");
-/* eslint-disable @typescript-eslint/no-require-imports */
-const FIXED_NOW = '2026-03-26T10:00:00.000Z';
-describe('State — pending extraction boundaries', () => {
-    let postStateSpy;
-    let fetchStateSpy;
-    let installInitialDomainMappingSpy;
-    beforeEach(() => {
-        jest.clearAllMocks();
-        jest.restoreAllMocks();
-        postStateSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'postState');
-        fetchStateSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'fetchState');
-        installInitialDomainMappingSpy = jest.spyOn(require('../common/install-initial-domain-mapping'), 'installInitialDomainMapping');
-        jest.spyOn(process, 'exit').mockImplementation(() => {
-            throw new Error('process.exit called');
-        });
-        jest.useFakeTimers();
-        jest.setSystemTime(new Date(FIXED_NOW));
-    });
-    afterEach(() => {
-        jest.useRealTimers();
-    });
-    it('should store resolved values in pendingWorkersOldest/pendingWorkersNewest on StartExtractingMetadata', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '',
-            },
-            payload: {
-                event_type: extraction_1.EventType.StartExtractingMetadata,
-                event_context: {
-                    extraction_start_time: {
-                        type: extraction_1.TimeValueType.UNBOUNDED,
-                    },
-                    extraction_end_time: {
-                        type: extraction_1.TimeValueType.CURRENT_TIME,
-                    },
-                },
-            },
-        });
-        fetchStateSpy.mockRejectedValue({
-            isAxiosError: true,
-            response: { status: 404 },
-        });
-        installInitialDomainMappingSpy.mockResolvedValue({ success: true });
-        postStateSpy.mockResolvedValue({ success: true });
-        // Act
-        const state = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(state.sdkState.pendingWorkersOldest).toBe('1970-01-01T00:00:00.000Z');
-        expect(state.sdkState.pendingWorkersNewest).toBe(FIXED_NOW);
-        expect(event.payload.event_context.extract_from).toBe('1970-01-01T00:00:00.000Z');
-        expect(event.payload.event_context.extract_to).toBe(FIXED_NOW);
-    });
-    it('should overwrite pending values on a retry (new StartExtractingMetadata after failure)', async () => {
-        // Arrange: state has stale pending values from a previous failed attempt
-        const staleOldest = '2026-03-25T08:00:00.000Z';
-        const staleNewest = '2026-03-25T09:00:00.000Z';
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: 'test_snap_in_version_id',
-            },
-            payload: {
-                event_type: extraction_1.EventType.StartExtractingMetadata,
-                event_context: {
-                    extraction_start_time: {
-                        type: extraction_1.TimeValueType.UNBOUNDED,
-                    },
-                    extraction_end_time: {
-                        type: extraction_1.TimeValueType.CURRENT_TIME,
-                    },
-                },
-            },
-        });
-        const stringifiedState = JSON.stringify({
-            snapInVersionId: 'test_snap_in_version_id',
-            pendingWorkersOldest: staleOldest,
-            pendingWorkersNewest: staleNewest,
-        });
-        fetchStateSpy.mockResolvedValue({ state: stringifiedState });
-        // Act
-        const state = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert: pending values are overwritten with fresh resolution, not stale values
-        expect(state.sdkState.pendingWorkersOldest).toBe('1970-01-01T00:00:00.000Z');
-        expect(state.sdkState.pendingWorkersNewest).toBe(FIXED_NOW);
-        expect(state.sdkState.pendingWorkersNewest).not.toBe(staleNewest);
-    });
-    it('should reuse pending values from state on ContinueExtractingData instead of re-resolving', async () => {
-        // Arrange: state has pending values from a prior StartExtractingMetadata phase
-        const pendingOldest = '1970-01-01T00:00:00.000Z';
-        const pendingNewest = '2026-03-26T08:00:00.000Z'; // Earlier than FIXED_NOW
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: 'test_snap_in_version_id',
-            },
-            payload: {
-                event_type: extraction_1.EventType.ContinueExtractingData,
-                event_context: {
-                    // Platform still sends TimeValue objects, but they should be ignored
-                    extraction_start_time: {
-                        type: extraction_1.TimeValueType.CURRENT_TIME,
-                    },
-                    extraction_end_time: {
-                        type: extraction_1.TimeValueType.CURRENT_TIME,
-                    },
-                },
-            },
-        });
-        const stringifiedState = JSON.stringify({
-            snapInVersionId: 'test_snap_in_version_id',
-            pendingWorkersOldest: pendingOldest,
-            pendingWorkersNewest: pendingNewest,
-        });
-        fetchStateSpy.mockResolvedValue({ state: stringifiedState });
-        // Act
-        const state = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert: uses cached pending values, NOT new Date() resolution
-        expect(event.payload.event_context.extract_from).toBe(pendingOldest);
-        expect(event.payload.event_context.extract_to).toBe(pendingNewest);
-        // Pending values in state remain unchanged
-        expect(state.sdkState.pendingWorkersOldest).toBe(pendingOldest);
-        expect(state.sdkState.pendingWorkersNewest).toBe(pendingNewest);
-    });
-    it('should not set extract_from/extract_to on ContinueExtractingData if no pending values exist', async () => {
-        // Arrange: state has no pending values (e.g. old state from before this feature)
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: 'test_snap_in_version_id',
-            },
-            payload: { event_type: extraction_1.EventType.ContinueExtractingData },
-        });
-        const stringifiedState = JSON.stringify({
-            snapInVersionId: 'test_snap_in_version_id',
-        });
-        fetchStateSpy.mockResolvedValue({ state: stringifiedState });
-        // Act
-        await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert: no extraction timestamps are set
-        expect(event.payload.event_context.extract_from).toBeUndefined();
-        expect(event.payload.event_context.extract_to).toBeUndefined();
-    });
-    it('should reuse pending values on StartExtractingAttachments', async () => {
-        // Arrange: state has pending values from the StartExtractingMetadata phase
-        const pendingOldest = '1970-01-01T00:00:00.000Z';
-        const pendingNewest = '2026-03-26T08:00:00.000Z';
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: 'test_snap_in_version_id',
-            },
-            payload: { event_type: extraction_1.EventType.StartExtractingAttachments },
-        });
-        const stringifiedState = JSON.stringify({
-            snapInVersionId: 'test_snap_in_version_id',
-            pendingWorkersOldest: pendingOldest,
-            pendingWorkersNewest: pendingNewest,
-        });
-        fetchStateSpy.mockResolvedValue({ state: stringifiedState });
-        // Act
-        await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert: pending values are reused
-        expect(event.payload.event_context.extract_from).toBe(pendingOldest);
-        expect(event.payload.event_context.extract_to).toBe(pendingNewest);
-    });
-});

package/dist/state/state.post-state.test.d.ts

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

package/dist/state/state.post-state.test.d.ts.map

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

package/dist/state/state.post-state.test.js

@@ -1,78 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const jest_setup_1 = require("../tests/jest.setup");
-const test_utils_1 = require("../common/test-utils");
-const extraction_1 = require("../types/extraction");
-const extraction_state_1 = require("./extraction-state");
-/* eslint-disable @typescript-eslint/no-require-imports */
-describe('State.postState', () => {
-    let postStateSpy;
-    let fetchStateSpy;
-    let processExitSpy;
-    beforeEach(() => {
-        jest.clearAllMocks();
-        jest.restoreAllMocks();
-        postStateSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'postState');
-        fetchStateSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'fetchState');
-        processExitSpy = jest.spyOn(process, 'exit').mockImplementation(() => {
-            throw new Error('process.exit called');
-        });
-    });
-    it('should POST the stringified state to the update endpoint', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '1.0.0',
-                secrets: { service_account_token: 'test_token' },
-            },
-            payload: { event_type: extraction_1.EventType.StartExtractingData },
-        });
-        const stateToPost = { snapInVersionId: '1.0.0', foo: 'bar' };
-        fetchStateSpy.mockResolvedValue({
-            state: JSON.stringify({ snapInVersionId: '1.0.0' }),
-        });
-        postStateSpy.mockRestore();
-        const adapterState = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Act
-        await adapterState.postState(stateToPost);
-        // Assert: the mock server records all incoming requests — inspect what was sent
-        const requests = jest_setup_1.mockServer.getRequests('POST', '/worker_data_url.update');
-        expect(requests).toHaveLength(1);
-        const body = requests[0].body;
-        // Body must contain the stringified v2 envelope: connector state and SDK
-        // bookkeeping stored as disjoint sub-objects.
-        expect(typeof body.state).toBe('string');
-        const parsed = JSON.parse(body.state);
-        expect(parsed.connectorState.foo).toBe('bar');
-        expect(parsed.sdkState.snapInVersionId).toBe('1.0.0');
-    });
-    it('should exit(1) when postState HTTP request fails', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: { snap_in_version_id: '1.0.0' },
-            payload: { event_type: extraction_1.EventType.StartExtractingData },
-        });
-        fetchStateSpy.mockResolvedValue({
-            state: JSON.stringify({ snapInVersionId: '1.0.0' }),
-        });
-        postStateSpy.mockRestore();
-        const adapterState = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Mock axiosClient.post directly to bypass the retry backoff
-        const axiosClientModule = require('../http/axios-client-internal');
-        const axiosPostSpy = jest
-            .spyOn(axiosClientModule.axiosClient, 'post')
-            .mockRejectedValue(new Error('network error'));
-        // Act & Assert
-        await expect(adapterState.postState()).rejects.toThrow('process.exit called');
-        expect(processExitSpy).toHaveBeenCalledWith(1);
-        axiosPostSpy.mockRestore();
-    });
-});

package/dist/state/state.test.d.ts

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

package/dist/state/state.test.d.ts.map

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

package/dist/state/state.test.js

@@ -1,271 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const constants_1 = require("../common/constants");
-const jest_setup_1 = require("../tests/jest.setup");
-const test_utils_1 = require("../common/test-utils");
-const extraction_1 = require("../types/extraction");
-const extraction_state_1 = require("./extraction-state");
-const state_interfaces_1 = require("./state.interfaces");
-/* eslint-disable @typescript-eslint/no-require-imports */
-describe(extraction_state_1.ExtractionState.name, () => {
-    let initSpy;
-    let postStateSpy;
-    let fetchStateSpy;
-    let installInitialDomainMappingSpy;
-    let processExitSpy;
-    beforeEach(() => {
-        jest.clearAllMocks();
-        jest.restoreAllMocks();
-        initSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'init');
-        postStateSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'postState');
-        fetchStateSpy = jest.spyOn(extraction_state_1.ExtractionState.prototype, 'fetchState');
-        installInitialDomainMappingSpy = jest.spyOn(require('../common/install-initial-domain-mapping'), 'installInitialDomainMapping');
-        processExitSpy = jest.spyOn(process, 'exit').mockImplementation(() => {
-            throw new Error('process.exit called');
-        });
-    });
-    it.each(constants_1.STATELESS_EVENT_TYPES)('should not init, fetch, post or install IDM for stateless event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            payload: { event_type: eventType },
-        });
-        // Act
-        await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(initSpy).not.toHaveBeenCalled();
-        expect(fetchStateSpy).not.toHaveBeenCalled();
-        expect(postStateSpy).not.toHaveBeenCalled();
-        expect(installInitialDomainMappingSpy).not.toHaveBeenCalled();
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES)('should exit the process if fetching the state fails for event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            payload: { event_type: eventType },
-        });
-        fetchStateSpy.mockRejectedValue({
-            isAxiosError: true,
-            response: { status: 500 },
-        });
-        // Act & Assert
-        await expect((0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        })).rejects.toThrow('process.exit called');
-        expect(processExitSpy).toHaveBeenCalledWith(1);
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES)('should exit the process if parsing the state fails for event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            payload: { event_type: eventType },
-        });
-        fetchStateSpy.mockResolvedValue({ state: 'invalid-json' });
-        // Act & Assert
-        await expect((0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        })).rejects.toThrow('process.exit called');
-        expect(processExitSpy).toHaveBeenCalledWith(1);
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES)('should exit the process if fetching is successful but there is no state in the response for event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            payload: { event_type: eventType },
-        });
-        fetchStateSpy.mockResolvedValue({ state: null });
-        // Act & Assert
-        await expect((0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        })).rejects.toThrow('process.exit called');
-        expect(processExitSpy).toHaveBeenCalledWith(1);
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES.filter((eventType) => eventType !== extraction_1.EventType.StartExtractingData))('should call post state with full adapter state if fetching returns 404 for event type %s', async (eventType) => {
-        // Arrange
-        const initialState = {
-            test: 'test',
-        };
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '',
-            },
-            payload: { event_type: eventType },
-        });
-        fetchStateSpy.mockRejectedValue({
-            isAxiosError: true,
-            response: { status: 404 },
-        });
-        installInitialDomainMappingSpy.mockResolvedValue({
-            success: true,
-        });
-        postStateSpy.mockResolvedValue({
-            success: true,
-        });
-        // Act
-        const adapterState = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState,
-            initialDomainMapping: {},
-        });
-        // On 404, init() persists the v2 envelope: connector state untouched,
-        // SDK bookkeeping seeded from defaults.
-        expect(postStateSpy).toHaveBeenCalled();
-        expect(adapterState.state).toEqual(initialState);
-        expect(adapterState.sdkState).toEqual(state_interfaces_1.initialExtractionSdkState);
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES)('should exit the process if initialDomainMapping is not provided for event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            payload: { event_type: eventType },
-        });
-        fetchStateSpy.mockResolvedValue({
-            state: JSON.stringify({
-                test: 'test',
-            }),
-        });
-        // Act & Assert
-        await expect((0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: undefined,
-        })).rejects.toThrow('process.exit called');
-        expect(processExitSpy).toHaveBeenCalledWith(1);
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES)('should not install IDM if version matches for event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '1.0.0',
-            },
-            payload: { event_type: eventType },
-        });
-        const stringifiedState = JSON.stringify({
-            test: 'test',
-            snapInVersionId: '1.0.0',
-        });
-        fetchStateSpy.mockResolvedValue({ state: stringifiedState });
-        // Act & Assert
-        await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(installInitialDomainMappingSpy).not.toHaveBeenCalled();
-    });
-    it.each(constants_1.STATEFUL_EVENT_TYPES)('should install IDM if version does not match for event type %s', async (eventType) => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '2.0.0',
-            },
-            payload: { event_type: eventType },
-        });
-        const stringifiedState = JSON.stringify({
-            test: 'test',
-            snapInVersionId: '1.0.0',
-        });
-        fetchStateSpy.mockResolvedValue({ state: stringifiedState });
-        installInitialDomainMappingSpy.mockResolvedValue({
-            success: true,
-        });
-        // Act
-        await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(installInitialDomainMappingSpy).toHaveBeenCalled();
-    });
-    it('should populate extractionScope from API response', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '1.0.0',
-            },
-            payload: { event_type: extraction_1.EventType.StartExtractingData },
-        });
-        fetchStateSpy.mockResolvedValue({
-            state: JSON.stringify({ snapInVersionId: '1.0.0' }),
-            objects: JSON.stringify({
-                tasks: { extract: true },
-                users: { extract: true },
-            }),
-        });
-        // Act
-        const result = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(result.extractionScope).toEqual({
-            tasks: { extract: true },
-            users: { extract: true },
-        });
-    });
-    it('should have empty extractionScope on 404', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: {
-                snap_in_version_id: '',
-            },
-            payload: { event_type: extraction_1.EventType.StartExtractingMetadata },
-        });
-        fetchStateSpy.mockRejectedValue({
-            isAxiosError: true,
-            response: { status: 404 },
-        });
-        installInitialDomainMappingSpy.mockResolvedValue({ success: true });
-        postStateSpy.mockResolvedValue({ success: true });
-        // Act
-        const result = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(result.extractionScope).toEqual({});
-    });
-    it('should have empty extractionScope for stateless events', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            payload: { event_type: extraction_1.EventType.StartExtractingExternalSyncUnits },
-        });
-        // Act
-        const result = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert
-        expect(result.extractionScope).toEqual({});
-    });
-    it('should continue with empty extractionScope when objects field contains invalid JSON', async () => {
-        // Arrange
-        const event = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
-            context: { snap_in_version_id: '1.0.0' },
-            payload: { event_type: extraction_1.EventType.StartExtractingData },
-        });
-        fetchStateSpy.mockResolvedValue({
-            state: JSON.stringify({ snapInVersionId: '1.0.0' }),
-            objects: 'NOT_VALID_JSON',
-        });
-        // Act
-        const result = await (0, extraction_state_1.createExtractionState)({
-            event,
-            initialState: {},
-            initialDomainMapping: {},
-        });
-        // Assert: should not crash, extractionScope is empty (default)
-        expect(result.extractionScope).toEqual({});
-        expect(processExitSpy).not.toHaveBeenCalled();
-    });
-});

package/dist/state/state.time-value-resolution.test.d.ts

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

package/dist/state/state.time-value-resolution.test.d.ts.map

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