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

package/dist/common/time-value-resolver.test.js

@@ -0,0 +1,268 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const extraction_1 = require("../types/extraction");
+const constants_1 = require("./constants");
+const time_value_resolver_1 = require("./time-value-resolver");
+describe('time-value-resolver', () => {
+    describe('parseDuration', () => {
+        it('should parse nanoseconds', () => {
+            expect((0, time_value_resolver_1.parseDuration)('100ns')).toEqual({ value: 100, unit: 'ns' });
+            expect((0, time_value_resolver_1.parseDuration)('1ns')).toEqual({ value: 1, unit: 'ns' });
+        });
+        it('should parse microseconds', () => {
+            expect((0, time_value_resolver_1.parseDuration)('500us')).toEqual({ value: 500, unit: 'us' });
+            expect((0, time_value_resolver_1.parseDuration)('500µs')).toEqual({ value: 500, unit: 'µs' });
+        });
+        it('should parse milliseconds', () => {
+            expect((0, time_value_resolver_1.parseDuration)('250ms')).toEqual({ value: 250, unit: 'ms' });
+            expect((0, time_value_resolver_1.parseDuration)('1ms')).toEqual({ value: 1, unit: 'ms' });
+        });
+        it('should parse seconds', () => {
+            expect((0, time_value_resolver_1.parseDuration)('30s')).toEqual({ value: 30, unit: 's' });
+            expect((0, time_value_resolver_1.parseDuration)('1s')).toEqual({ value: 1, unit: 's' });
+            expect((0, time_value_resolver_1.parseDuration)('3600s')).toEqual({ value: 3600, unit: 's' });
+        });
+        it('should parse minutes', () => {
+            expect((0, time_value_resolver_1.parseDuration)('5m')).toEqual({ value: 5, unit: 'm' });
+            expect((0, time_value_resolver_1.parseDuration)('1m')).toEqual({ value: 1, unit: 'm' });
+            expect((0, time_value_resolver_1.parseDuration)('60m')).toEqual({ value: 60, unit: 'm' });
+        });
+        it('should parse hours', () => {
+            expect((0, time_value_resolver_1.parseDuration)('2h')).toEqual({ value: 2, unit: 'h' });
+            expect((0, time_value_resolver_1.parseDuration)('24h')).toEqual({ value: 24, unit: 'h' });
+            expect((0, time_value_resolver_1.parseDuration)('168h')).toEqual({ value: 168, unit: 'h' });
+        });
+        it('should parse fractional values', () => {
+            expect((0, time_value_resolver_1.parseDuration)('1.5h')).toEqual({ value: 1.5, unit: 'h' });
+            expect((0, time_value_resolver_1.parseDuration)('0.5s')).toEqual({ value: 0.5, unit: 's' });
+            expect((0, time_value_resolver_1.parseDuration)('2.5m')).toEqual({ value: 2.5, unit: 'm' });
+        });
+        it('should throw on invalid format', () => {
+            expect(() => (0, time_value_resolver_1.parseDuration)('')).toThrow('Invalid duration format');
+            expect(() => (0, time_value_resolver_1.parseDuration)('7')).toThrow('Invalid duration format');
+            expect(() => (0, time_value_resolver_1.parseDuration)('s')).toThrow('Invalid duration format');
+            expect(() => (0, time_value_resolver_1.parseDuration)('7d')).toThrow('Invalid duration format');
+            expect(() => (0, time_value_resolver_1.parseDuration)('7y')).toThrow('Invalid duration format');
+            expect(() => (0, time_value_resolver_1.parseDuration)('abc')).toThrow('Invalid duration format');
+        });
+    });
+    describe('applyDuration', () => {
+        describe('subtract', () => {
+            it('should subtract seconds', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:30.000Z', '30s', 'subtract');
+                expect(result).toBe('2024-01-15T00:00:00.000Z');
+            });
+            it('should subtract minutes', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:05:00.000Z', '5m', 'subtract');
+                expect(result).toBe('2024-01-15T00:00:00.000Z');
+            });
+            it('should subtract hours', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T02:00:00.000Z', '2h', 'subtract');
+                expect(result).toBe('2024-01-15T00:00:00.000Z');
+            });
+            it('should subtract milliseconds', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.500Z', '500ms', 'subtract');
+                expect(result).toBe('2024-01-15T00:00:00.000Z');
+            });
+            it('should handle crossing day boundary', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T01:00:00.000Z', '2h', 'subtract');
+                expect(result).toBe('2024-01-14T23:00:00.000Z');
+            });
+            it('should subtract 168 hours (7 days equivalent)', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.000Z', '168h', 'subtract');
+                expect(result).toBe('2024-01-08T00:00:00.000Z');
+            });
+        });
+        describe('add', () => {
+            it('should add seconds', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.000Z', '30s', 'add');
+                expect(result).toBe('2024-01-15T00:00:30.000Z');
+            });
+            it('should add minutes', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.000Z', '5m', 'add');
+                expect(result).toBe('2024-01-15T00:05:00.000Z');
+            });
+            it('should add hours', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.000Z', '2h', 'add');
+                expect(result).toBe('2024-01-15T02:00:00.000Z');
+            });
+            it('should add milliseconds', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.000Z', '500ms', 'add');
+                expect(result).toBe('2024-01-15T00:00:00.500Z');
+            });
+            it('should handle crossing day boundary', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T23:00:00.000Z', '2h', 'add');
+                expect(result).toBe('2024-01-16T01:00:00.000Z');
+            });
+            it('should add 168 hours (7 days equivalent)', () => {
+                const result = (0, time_value_resolver_1.applyDuration)('2024-01-15T00:00:00.000Z', '168h', 'add');
+                expect(result).toBe('2024-01-22T00:00:00.000Z');
+            });
+        });
+    });
+    describe('resolveTimeValue', () => {
+        const baseState = {
+            workersOldest: '2024-01-01T00:00:00.000Z',
+            workersNewest: '2024-06-01T00:00:00.000Z',
+        };
+        describe('ABSOLUTE_TIME type', () => {
+            it('should return the value normalized to ISO 8601', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME, value: '2024-03-15T12:00:00Z' }, baseState);
+                expect(result).toBe('2024-03-15T12:00:00.000Z');
+            });
+            it('should normalize timestamps without milliseconds', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME, value: '2024-01-01T00:00:00Z' }, baseState);
+                expect(result).toBe('2024-01-01T00:00:00.000Z');
+            });
+            it('should preserve timestamps already in normalized format', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.ABSOLUTE_TIME,
+                    value: '2024-06-15T10:30:00.000Z',
+                }, baseState);
+                expect(result).toBe('2024-06-15T10:30:00.000Z');
+            });
+            it('should throw if value is missing', () => {
+                expect(() => (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME }, baseState)).toThrow('must have a value');
+            });
+            it('should throw a descriptive error if value is an invalid timestamp', () => {
+                expect(() => (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME, value: 'not-a-date' }, baseState)).toThrow("invalid ISO 8601 timestamp: 'not-a-date'");
+            });
+        });
+        describe('CURRENT_TIME type', () => {
+            it('should return current time as ISO string', () => {
+                const before = new Date().toISOString();
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.CURRENT_TIME }, baseState);
+                const after = new Date().toISOString();
+                expect(result >= before).toBe(true);
+                expect(result <= after).toBe(true);
+            });
+        });
+        describe('UNBOUNDED type', () => {
+            it('should return UNBOUNDED_DATE_TIME_VALUE', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.UNBOUNDED }, baseState);
+                expect(result).toBe(constants_1.UNBOUNDED_DATE_TIME_VALUE);
+            });
+        });
+        describe('WORKERS_OLDEST type', () => {
+            it('should return workersOldest from state', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_OLDEST }, baseState);
+                expect(result).toBe('2024-01-01T00:00:00.000Z');
+            });
+            it('should return UNBOUNDED_DATE_TIME_VALUE if workersOldest is not set', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_OLDEST }, { workersOldest: '' });
+                expect(result).toBe(constants_1.UNBOUNDED_DATE_TIME_VALUE);
+            });
+        });
+        describe('WORKERS_NEWEST type', () => {
+            it('should return workersNewest from state', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_NEWEST }, baseState);
+                expect(result).toBe('2024-06-01T00:00:00.000Z');
+            });
+            it('should throw if workersNewest is not set', () => {
+                expect(() => (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_NEWEST }, { workersNewest: '' })).toThrow('workersNewest is not set in state');
+            });
+        });
+        describe('WORKERS_OLDEST_MINUS_WINDOW type', () => {
+            it('should subtract duration from workersOldest', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW,
+                    value: '168h',
+                }, baseState);
+                expect(result).toBe('2023-12-25T00:00:00.000Z');
+            });
+            it('should subtract minutes from workersOldest', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW,
+                    value: '30m',
+                }, baseState);
+                expect(result).toBe('2023-12-31T23:30:00.000Z');
+            });
+            it('should return UNBOUNDED_DATE_TIME_VALUE if workersOldest is not set', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW,
+                    value: '2h',
+                }, { workersOldest: '' });
+                expect(result).toBe(constants_1.UNBOUNDED_DATE_TIME_VALUE);
+            });
+            it('should throw if value (duration) is missing', () => {
+                expect(() => (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW }, baseState)).toThrow('must have a value');
+            });
+        });
+        describe('WORKERS_NEWEST_PLUS_WINDOW type', () => {
+            it('should add duration to workersNewest', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.WORKERS_NEWEST_PLUS_WINDOW,
+                    value: '168h',
+                }, baseState);
+                expect(result).toBe('2024-06-08T00:00:00.000Z');
+            });
+            it('should add minutes to workersNewest', () => {
+                const result = (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.WORKERS_NEWEST_PLUS_WINDOW,
+                    value: '30m',
+                }, baseState);
+                expect(result).toBe('2024-06-01T00:30:00.000Z');
+            });
+            it('should throw if workersNewest is not set', () => {
+                expect(() => (0, time_value_resolver_1.resolveTimeValue)({
+                    type: extraction_1.TimeValueType.WORKERS_NEWEST_PLUS_WINDOW,
+                    value: '2h',
+                }, { workersNewest: '' })).toThrow('workersNewest is not set in state');
+            });
+            it('should throw if value (duration) is missing', () => {
+                expect(() => (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_NEWEST_PLUS_WINDOW }, baseState)).toThrow('must have a value');
+            });
+        });
+        describe('Unknown type', () => {
+            it('should throw for unknown type', () => {
+                expect(() => 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                (0, time_value_resolver_1.resolveTimeValue)({ type: 'unknown' }, baseState)).toThrow('Unknown TimeValueType');
+            });
+        });
+        describe('Real-world scenarios', () => {
+            const FIXED_NOW = '2026-02-26T15:30:00.000Z';
+            const scenarioState = {
+                workersOldest: '2024-01-01T00:00:00.000Z',
+                workersNewest: '2024-06-01T00:00:00.000Z',
+            };
+            beforeEach(() => {
+                jest.useFakeTimers();
+                jest.setSystemTime(new Date(FIXED_NOW));
+            });
+            afterEach(() => {
+                jest.useRealTimers();
+            });
+            it('Initial Import: UNBOUNDED start, CURRENT_TIME end', () => {
+                const start = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.UNBOUNDED }, scenarioState);
+                const end = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.CURRENT_TIME }, scenarioState);
+                expect(start).toBe(constants_1.UNBOUNDED_DATE_TIME_VALUE);
+                expect(end).toBe(FIXED_NOW);
+            });
+            it('Normal Import: WORKERS_NEWEST start, CURRENT_TIME end', () => {
+                const start = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_NEWEST }, scenarioState);
+                const end = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.CURRENT_TIME }, scenarioState);
+                expect(start).toBe('2024-06-01T00:00:00.000Z');
+                expect(end).toBe(FIXED_NOW);
+            });
+            it('POC Import: ABSOLUTE_TIME start, CURRENT_TIME end', () => {
+                const start = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME, value: '2024-01-01T00:00:00Z' }, scenarioState);
+                const end = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.CURRENT_TIME }, scenarioState);
+                expect(start).toBe('2024-01-01T00:00:00.000Z');
+                expect(end).toBe(FIXED_NOW);
+            });
+            it('Computer Import: WORKERS_OLDEST_MINUS_WINDOW start, WORKERS_OLDEST end', () => {
+                const start = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW, value: '168h' }, scenarioState);
+                const end = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.WORKERS_OLDEST }, scenarioState);
+                expect(start).toBe('2023-12-25T00:00:00.000Z');
+                expect(end).toBe('2024-01-01T00:00:00.000Z');
+            });
+            it('Reconciliation: ABSOLUTE_TIME start, ABSOLUTE_TIME end', () => {
+                const start = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME, value: '2026-01-01T00:00:00Z' }, scenarioState);
+                const end = (0, time_value_resolver_1.resolveTimeValue)({ type: extraction_1.TimeValueType.ABSOLUTE_TIME, value: '2026-03-31T23:59:59Z' }, scenarioState);
+                expect(start).toBe('2026-01-01T00:00:00.000Z');
+                expect(end).toBe('2026-03-31T23:59:59.000Z');
+            });
+        });
+    });
+});

package/dist/http/axios-client-internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axios-client-internal.d.ts","sourceRoot":"","sources":["../../src/http/axios-client-internal.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,WAAW,+BAEf,CAAC;AAiFH,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"axios-client-internal.d.ts","sourceRoot":"","sources":["../../src/http/axios-client-internal.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,WAAW,+BAEf,CAAC;AAyFH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/http/axios-client-internal.js

@@ -51,6 +51,13 @@ exports.axiosClient = axiosClient;
             ((_g = error.response) === null || _g === void 0 ? void 0 : _g.status) !== 429) {
             return true;
         }
+        // Request timeout errors (ECONNABORTED) — axios-retry explicitly excludes
+        // ECONNABORTED from isNetworkError, so we handle it here separately.
+        // Axios only produces ECONNABORTED on client-side timeouts and browser
+        // cancellations, never on server responses, so no response guard is needed.
+        else if (error.code === 'ECONNABORTED') {
+            return true;
+        }
         // all other errors
         else {
             return false;

package/dist/http/axios-client-internal.test.js

@@ -151,4 +151,25 @@ describe('Internal Axios Client', () => {
         await expect(axios_client_internal_1.axiosClient.get(jest_setup_1.mockServer.baseUrl + '/test-endpoint')).rejects.toThrow();
         expect(jest_setup_1.mockServer.getRequestCount('GET', '/test-endpoint')).toBe(1);
     });
+    it('should retry on request timeout (ECONNABORTED)', async () => {
+        // The mock server delays the first response by 500ms, but we set a per-request
+        // timeout of 150ms so the first request times out with ECONNABORTED.
+        // After the 1 timed-out failure, the server responds immediately (no delay),
+        // so the retry succeeds quickly without waiting for full exponential backoff.
+        jest_setup_1.mockServer.setRoute({
+            path: '/test-endpoint',
+            method: 'GET',
+            status: 200,
+            retry: {
+                failureCount: 1,
+                errorStatus: 200,
+                delay: 500,
+            },
+        });
+        await axios_client_internal_1.axiosClient.get(jest_setup_1.mockServer.baseUrl + '/test-endpoint', {
+            timeout: 150,
+        });
+        // Should have made 2 requests: 1 that timed out + 1 successful retry
+        expect(jest_setup_1.mockServer.getRequestCount('GET', '/test-endpoint')).toBe(2);
+    });
 });

package/dist/http/axios-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axios-client.d.ts","sourceRoot":"","sources":["../../src/http/axios-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAG1C,QAAA,MAAM,WAAW,+BAAiB,CAAC;AAiCnC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"axios-client.d.ts","sourceRoot":"","sources":["../../src/http/axios-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAI1C,QAAA,MAAM,WAAW,+BAAiB,CAAC;AAuCnC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC"}

package/dist/http/axios-client.js

@@ -30,15 +30,18 @@ exports.axiosClient = exports.axios = void 0;
 const axios_1 = __importDefault(require("axios"));
 exports.axios = axios_1.default;
 const axios_retry_1 = __importDefault(require("axios-retry"));
+const logger_context_1 = require("../logger/logger.context");
 const axiosClient = axios_1.default.create();
 exports.axiosClient = axiosClient;
 (0, axios_retry_1.default)(axiosClient, {
     retries: 5,
     retryDelay: (retryCount, error) => {
-        var _a, _b, _c;
         // exponential backoff algorithm: 1 * 2 ^ retryCount * 1000ms
         const delay = axios_retry_1.default.exponentialDelay(retryCount, error, 1000);
-        console.warn(`Request to ${(_a = error.config) === null || _a === void 0 ? void 0 : _a.url} failed with response status code ${(_b = error.response) === null || _b === void 0 ? void 0 : _b.status}. Method ${(_c = error.config) === null || _c === void 0 ? void 0 : _c.method}. Retry count: ${retryCount}. Retrying in ${Math.round(delay / 1000)}s.`);
+        (0, logger_context_1.runWithUserLogContext)(() => {
+            var _a, _b, _c;
+            return console.warn(`Request to ${(_a = error.config) === null || _a === void 0 ? void 0 : _a.url} failed with response status code ${(_b = error.response) === null || _b === void 0 ? void 0 : _b.status}. Method ${(_c = error.config) === null || _c === void 0 ? void 0 : _c.method}. Retry count: ${retryCount}. Retrying in ${Math.round(delay / 1000)}s.`);
+        });
         return delay;
     },
     retryCondition: (error) => {
@@ -52,6 +55,6 @@ exports.axiosClient = axiosClient;
         (_b = (_a = error.config) === null || _a === void 0 ? void 0 : _a.headers) === null || _b === void 0 ? true : delete _b.authorization;
         (_d = (_c = error.config) === null || _c === void 0 ? void 0 : _c.headers) === null || _d === void 0 ? true : delete _d.Authorization;
         delete error.request._header;
-        console.warn('Max retry times exceeded. Error', error);
+        (0, logger_context_1.runWithUserLogContext)(() => console.warn('Max retry times exceeded. Error', error));
     },
 });

package/dist/http/index.d.ts

@@ -1,3 +1,2 @@
 export * from './axios-client';
-export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/http/index.js

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./axios-client"), exports);
-__exportStar(require("./types"), exports);

package/dist/index.d.ts

@@ -1,14 +1,16 @@
-export * from './deprecated/adapter';
-export * from './deprecated/demo-extractor';
-export * from './deprecated/http/client';
-export * from './deprecated/uploader';
-export * from './http';
-export * from './types';
-export * from './common/install-initial-domain-mapping';
+export { AirSyncDefaultItemTypes } from './common/constants';
 export { ExtractionCommonError } from './common/errors';
-export { processTask } from './multithreading/process-task';
+export * from './common/install-initial-domain-mapping';
+export * from './http';
+export { serializeAxiosError } from './logger/logger';
+export { MockServer } from './mock-server/mock-server';
+export type { RequestInfo, RetryConfig, RouteConfig, } from './mock-server/mock-server.interfaces';
+export { processExtractionTask, processLoadingTask, } from './multithreading/process-task';
 export { spawn } from './multithreading/spawn/spawn';
-export { WorkerAdapter } from './multithreading/worker-adapter/worker-adapter';
+export { ExtractionAdapter } from './multithreading/adapters/extraction-adapter';
+export { LoadingAdapter } from './multithreading/adapters/loading-adapter';
+export { createMockEvent, MOCK_SERVER_DEFAULT_URL } from './common/test-utils';
+export type { DeepPartial } from './common/test-utils';
+export * from './types';
 export * from './types/workers';
-export { formatAxiosError, serializeAxiosError } from './logger/logger';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AAExB,cAAc,yCAAyC,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAE/E,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -14,21 +14,26 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeAxiosError = exports.formatAxiosError = exports.WorkerAdapter = exports.spawn = exports.processTask = void 0;
-__exportStar(require("./deprecated/adapter"), exports);
-__exportStar(require("./deprecated/demo-extractor"), exports);
-__exportStar(require("./deprecated/http/client"), exports);
-__exportStar(require("./deprecated/uploader"), exports);
-__exportStar(require("./http"), exports);
-__exportStar(require("./types"), exports);
+exports.MOCK_SERVER_DEFAULT_URL = exports.createMockEvent = exports.LoadingAdapter = exports.ExtractionAdapter = exports.spawn = exports.processLoadingTask = exports.processExtractionTask = exports.MockServer = exports.serializeAxiosError = exports.AirSyncDefaultItemTypes = void 0;
+var constants_1 = require("./common/constants");
+Object.defineProperty(exports, "AirSyncDefaultItemTypes", { enumerable: true, get: function () { return constants_1.AirSyncDefaultItemTypes; } });
 __exportStar(require("./common/install-initial-domain-mapping"), exports);
+__exportStar(require("./http"), exports);
+var logger_1 = require("./logger/logger");
+Object.defineProperty(exports, "serializeAxiosError", { enumerable: true, get: function () { return logger_1.serializeAxiosError; } });
+var mock_server_1 = require("./mock-server/mock-server");
+Object.defineProperty(exports, "MockServer", { enumerable: true, get: function () { return mock_server_1.MockServer; } });
 var process_task_1 = require("./multithreading/process-task");
-Object.defineProperty(exports, "processTask", { enumerable: true, get: function () { return process_task_1.processTask; } });
+Object.defineProperty(exports, "processExtractionTask", { enumerable: true, get: function () { return process_task_1.processExtractionTask; } });
+Object.defineProperty(exports, "processLoadingTask", { enumerable: true, get: function () { return process_task_1.processLoadingTask; } });
 var spawn_1 = require("./multithreading/spawn/spawn");
 Object.defineProperty(exports, "spawn", { enumerable: true, get: function () { return spawn_1.spawn; } });
-var worker_adapter_1 = require("./multithreading/worker-adapter/worker-adapter");
-Object.defineProperty(exports, "WorkerAdapter", { enumerable: true, get: function () { return worker_adapter_1.WorkerAdapter; } });
+var extraction_adapter_1 = require("./multithreading/adapters/extraction-adapter");
+Object.defineProperty(exports, "ExtractionAdapter", { enumerable: true, get: function () { return extraction_adapter_1.ExtractionAdapter; } });
+var loading_adapter_1 = require("./multithreading/adapters/loading-adapter");
+Object.defineProperty(exports, "LoadingAdapter", { enumerable: true, get: function () { return loading_adapter_1.LoadingAdapter; } });
+var test_utils_1 = require("./common/test-utils");
+Object.defineProperty(exports, "createMockEvent", { enumerable: true, get: function () { return test_utils_1.createMockEvent; } });
+Object.defineProperty(exports, "MOCK_SERVER_DEFAULT_URL", { enumerable: true, get: function () { return test_utils_1.MOCK_SERVER_DEFAULT_URL; } });
+__exportStar(require("./types"), exports);
 __exportStar(require("./types/workers"), exports);
-var logger_1 = require("./logger/logger");
-Object.defineProperty(exports, "formatAxiosError", { enumerable: true, get: function () { return logger_1.formatAxiosError; } });
-Object.defineProperty(exports, "serializeAxiosError", { enumerable: true, get: function () { return logger_1.serializeAxiosError; } });

package/dist/logger/logger.d.ts

@@ -17,14 +17,6 @@ export declare class Logger extends Console {
      * @returns String representation of the value
      */
     private valueToString;
-    /**
-     * Truncates a message if it exceeds the maximum allowed length.
-     * Adds a suffix indicating how many characters were omitted.
-     *
-     * @param message - The message to truncate
-     * @returns Truncated message or original if within limits
-     */
-    private truncateMessage;
     /**
      * Logs a pre-formatted message string to the console.
      * In production mode, wraps the message with JSON formatting and event context tags.
@@ -68,7 +60,7 @@ export declare function getPrintableState(state: Record<string, any>): Printable
  * @param error - Error to serialize
  * @returns Serialized error or original if not an Axios error
  */
-export declare function serializeError(error: unknown): unknown;
+export declare function serializeError(error: unknown): string;
 /**
  * Serializes an Axios error into a structured format with HTTP request/response details.
  * Extracts method, URL, parameters, status code, headers, and data.
@@ -78,12 +70,4 @@ export declare function serializeError(error: unknown): unknown;
  * @returns Structured object with error details
  */
 export declare function serializeAxiosError(error: AxiosError): AxiosErrorResponse;
-/**
- * Formats an Axios error to a printable format.
- *
- * @param error - Axios error to format
- * @returns Formatted error object
- * @deprecated Use {@link serializeAxiosError} instead
- */
-export declare function formatAxiosError(error: AxiosError): object;
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EAEtB,QAAQ,EAER,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;gBAEb,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,sBAAsB;IAWtD;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;;;;;OASG;IACH,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,OAAqC,GAC9C,IAAI;IAcP;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAgBd,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGzC;AACD;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAqB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKtD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAwBzE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE1D"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EAEtB,QAAQ,EAER,cAAc,EACf,MAAM,qBAAqB,CAAC;AAG7B;;;GAGG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;gBAEb,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,sBAAsB;IAWtD;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;;OASG;IACH,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,OAAqC,GAC9C,IAAI;IAcP;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAgBd,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGzC;AACD;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAqB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoCrD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAwBzE"}

package/dist/logger/logger.interfaces.d.ts

@@ -1,8 +1,8 @@
 import type { RawAxiosResponseHeaders } from 'axios';
-import type { AirdropEvent, EventContext } from '../types/extraction';
+import type { AirSyncEvent, EventContext } from '../types/extraction';
 import type { WorkerAdapterOptions } from '../types/workers';
 export interface LoggerFactoryInterface {
-    event: AirdropEvent;
+    event: AirSyncEvent;
     options?: WorkerAdapterOptions;
 }
 export declare enum LogLevel {

package/dist/logger/logger.js

@@ -4,7 +4,6 @@ exports.Logger = void 0;
 exports.getPrintableState = getPrintableState;
 exports.serializeError = serializeError;
 exports.serializeAxiosError = serializeAxiosError;
-exports.formatAxiosError = formatAxiosError;
 const axios_1 = require("axios");
 const node_console_1 = require("node:console");
 const node_util_1 = require("node:util");
@@ -14,6 +13,7 @@ const workers_1 = require("../types/workers");
 const logger_constants_1 = require("./logger.constants");
 const logger_context_1 = require("./logger.context");
 const logger_interfaces_1 = require("./logger.interfaces");
+const helpers_1 = require("../common/helpers");
 /**
  * Custom logger that extends Node.js Console with context-aware logging.
  * Handles local development, main thread, and worker thread logging differently.
@@ -37,19 +37,6 @@ class Logger extends node_console_1.Console {
         }
         return (0, node_util_1.inspect)(value, logger_constants_1.INSPECT_OPTIONS);
     }
-    /**
-     * Truncates a message if it exceeds the maximum allowed length.
-     * Adds a suffix indicating how many characters were omitted.
-     *
-     * @param message - The message to truncate
-     * @returns Truncated message or original if within limits
-     */
-    truncateMessage(message) {
-        if (message.length > logger_constants_1.MAX_LOG_STRING_LENGTH) {
-            return `${message.substring(0, logger_constants_1.MAX_LOG_STRING_LENGTH)}... ${message.length - logger_constants_1.MAX_LOG_STRING_LENGTH} more characters`;
-        }
-        return message;
-    }
     /**
      * Logs a pre-formatted message string to the console.
      * In production mode, wraps the message with JSON formatting and event context tags.
@@ -80,7 +67,7 @@ class Logger extends node_console_1.Console {
      */
     stringifyAndLog(args, level) {
         let stringifiedArgs = args.map((arg) => this.valueToString(arg)).join(' ');
-        stringifiedArgs = this.truncateMessage(stringifiedArgs);
+        stringifiedArgs = (0, helpers_1.truncateMessage)(stringifiedArgs);
         const isSdkLog = (0, logger_context_1.getSdkLogContextValue)(true);
         if (node_worker_threads_1.isMainThread) {
             this.logFn(stringifiedArgs, level, isSdkLog);
@@ -147,9 +134,40 @@ function getPrintableState(state) {
  */
 function serializeError(error) {
     if ((0, axios_1.isAxiosError)(error)) {
-        return serializeAxiosError(error);
+        return JSON.stringify(serializeAxiosError(error));
     }
-    return error;
+    if (error instanceof Error) {
+        // Include error name (e.g. TypeError, RangeError) alongside message
+        // for easier debugging
+        return error.name !== 'Error'
+            ? `${error.name}: ${error.message}`
+            : error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    // JSON.stringify returns '{}' for objects with only non-enumerable properties
+    // Fall back to extracting own property names or String() coercion.
+    const stringified = JSON.stringify(error);
+    if (!stringified || stringified === '{}') {
+        if (error !== null && typeof error === 'object') {
+            const props = {};
+            for (const key of Object.getOwnPropertyNames(error)) {
+                props[key] = error[key];
+            }
+            const extracted = JSON.stringify(props);
+            if (extracted && extracted !== '{}') {
+                return extracted;
+            }
+        }
+        try {
+            return String(error);
+        }
+        catch (_a) {
+            return '[Unserializable error]';
+        }
+    }
+    return stringified;
 }
 /**
  * Serializes an Axios error into a structured format with HTTP request/response details.
@@ -184,13 +202,3 @@ function serializeAxiosError(error) {
     }
     return serializedAxiosError;
 }
-/**
- * Formats an Axios error to a printable format.
- *
- * @param error - Axios error to format
- * @returns Formatted error object
- * @deprecated Use {@link serializeAxiosError} instead
- */
-function formatAxiosError(error) {
-    return serializeAxiosError(error);
-}