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

package/dist/common/time-value-resolver.d.ts

@@ -0,0 +1,47 @@
+import { TimeUnit, TimeValue } from '../types/extraction';
+import { SdkState } from '../state/state.interfaces';
+/**
+ * Parses a shorthand duration string into its numeric value and unit.
+ * Supported units:
+ * - 'ns' for nanoseconds
+ * - 'us' or 'µs' for microseconds
+ * - 'ms' for milliseconds
+ * - 's' for seconds
+ * - 'm' for minutes
+ * - 'h' for hours
+ *
+ * @throws Error if the format is invalid
+ */
+export declare function parseDuration(shorthand: string): {
+    value: number;
+    unit: TimeUnit;
+};
+/**
+ * Applies a shorthand duration to a base ISO 8601 timestamp.
+ *
+ * @param baseTimestamp - ISO 8601 timestamp to apply duration to
+ * @param duration - Shorthand duration string (e.g. '100ns', '500ms', '30s', '5m', '2h')
+ * @param operation - Whether to 'add' or 'subtract' the duration
+ * @returns ISO 8601 timestamp with the duration applied
+ */
+export declare function applyDuration(baseTimestamp: string, duration: string, operation: 'add' | 'subtract'): string;
+/**
+ * Resolves a TimeValue into a concrete ISO 8601 timestamp string.
+ *
+ * Resolution rules:
+ * - ABSOLUTE: Returns the value directly (must be an ISO 8601 timestamp)
+ * - NOW: Returns the current time as ISO 8601
+ * - UNBOUNDED: Returns UNBOUNDED_DATE_TIME_VALUE ('1970-01-01T00:00:00.000Z')
+ * - WORKERS_OLDEST: Returns workersOldest from state, or throws if not set
+ * - WORKERS_NEWEST: Returns workersNewest from state, or throws if not set
+ * - WORKERS_OLDEST_MINUS_WINDOW: Subtracts duration from workersOldest, or throws if not set
+ * - WORKERS_NEWEST_PLUS_WINDOW: Adds duration to workersNewest, or throws if not set
+ *
+ * @param timeValue - The TimeValue to resolve
+ * @param state - The current SDK state containing workersOldest and workersNewest
+ * @returns Resolved ISO 8601 timestamp string
+ * @throws Error if required TimeValue.value is missing for ABSOLUTE or *_WINDOW types
+ * @throws Error if workersOldest/workersNewest is not set in state for WORKERS_* types
+ */
+export declare function resolveTimeValue(timeValue: TimeValue, state: SdkState): string;
+//# sourceMappingURL=time-value-resolver.d.ts.map

package/dist/common/time-value-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-value-resolver.d.ts","sourceRoot":"","sources":["../../src/common/time-value-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,CAcA;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,KAAK,GAAG,UAAU,GAC5B,MAAM,CA6BR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,QAAQ,GACd,MAAM,CA2ER"}

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

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDuration = parseDuration;
+exports.applyDuration = applyDuration;
+exports.resolveTimeValue = resolveTimeValue;
+const extraction_1 = require("../types/extraction");
+const constants_1 = require("./constants");
+/**
+ * Parses a shorthand duration string into its numeric value and unit.
+ * Supported units:
+ * - 'ns' for nanoseconds
+ * - 'us' or 'µs' for microseconds
+ * - 'ms' for milliseconds
+ * - 's' for seconds
+ * - 'm' for minutes
+ * - 'h' for hours
+ *
+ * @throws Error if the format is invalid
+ */
+function parseDuration(shorthand) {
+    const validUnits = Object.values(extraction_1.TimeUnit).join('|');
+    const match = shorthand.match(new RegExp(`^(\\d+(?:\\.\\d+)?)(${validUnits})$`));
+    if (!match) {
+        throw new Error(`Invalid duration format: '${shorthand}'. Expected format like '100ns', '500ms', '30s', '5m', or '2h'.`);
+    }
+    return {
+        value: parseFloat(match[1]),
+        unit: match[2],
+    };
+}
+/**
+ * Applies a shorthand duration to a base ISO 8601 timestamp.
+ *
+ * @param baseTimestamp - ISO 8601 timestamp to apply duration to
+ * @param duration - Shorthand duration string (e.g. '100ns', '500ms', '30s', '5m', '2h')
+ * @param operation - Whether to 'add' or 'subtract' the duration
+ * @returns ISO 8601 timestamp with the duration applied
+ */
+function applyDuration(baseTimestamp, duration, operation) {
+    const { value, unit } = parseDuration(duration);
+    const date = new Date(baseTimestamp);
+    const sign = operation === 'add' ? 1 : -1;
+    switch (unit) {
+        case extraction_1.TimeUnit.NANOSECONDS:
+            // JavaScript Date works in milliseconds, so convert nanoseconds
+            date.setTime(date.getTime() + sign * value * 0.000001);
+            break;
+        case extraction_1.TimeUnit.MICROSECONDS:
+        case extraction_1.TimeUnit.MICROSECONDS_MU:
+            date.setTime(date.getTime() + sign * value * 0.001);
+            break;
+        case extraction_1.TimeUnit.MILLISECONDS:
+            date.setTime(date.getTime() + sign * value);
+            break;
+        case extraction_1.TimeUnit.SECONDS:
+            date.setUTCSeconds(date.getUTCSeconds() + sign * value);
+            break;
+        case extraction_1.TimeUnit.MINUTES:
+            date.setUTCMinutes(date.getUTCMinutes() + sign * value);
+            break;
+        case extraction_1.TimeUnit.HOURS:
+            date.setUTCHours(date.getUTCHours() + sign * value);
+            break;
+    }
+    return date.toISOString();
+}
+/**
+ * Resolves a TimeValue into a concrete ISO 8601 timestamp string.
+ *
+ * Resolution rules:
+ * - ABSOLUTE: Returns the value directly (must be an ISO 8601 timestamp)
+ * - NOW: Returns the current time as ISO 8601
+ * - UNBOUNDED: Returns UNBOUNDED_DATE_TIME_VALUE ('1970-01-01T00:00:00.000Z')
+ * - WORKERS_OLDEST: Returns workersOldest from state, or throws if not set
+ * - WORKERS_NEWEST: Returns workersNewest from state, or throws if not set
+ * - WORKERS_OLDEST_MINUS_WINDOW: Subtracts duration from workersOldest, or throws if not set
+ * - WORKERS_NEWEST_PLUS_WINDOW: Adds duration to workersNewest, or throws if not set
+ *
+ * @param timeValue - The TimeValue to resolve
+ * @param state - The current SDK state containing workersOldest and workersNewest
+ * @returns Resolved ISO 8601 timestamp string
+ * @throws Error if required TimeValue.value is missing for ABSOLUTE or *_WINDOW types
+ * @throws Error if workersOldest/workersNewest is not set in state for WORKERS_* types
+ */
+function resolveTimeValue(timeValue, state) {
+    switch (timeValue.type) {
+        case extraction_1.TimeValueType.ABSOLUTE_TIME: {
+            if (!timeValue.value) {
+                throw new Error('TimeValue of type ABSOLUTE must have a value (ISO 8601 timestamp).');
+            }
+            // Normalize to consistent ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ)
+            // to ensure string comparisons in boundary expansion are safe.
+            const parsed = new Date(timeValue.value);
+            if (isNaN(parsed.getTime())) {
+                throw new Error(`TimeValue of type ABSOLUTE has an invalid ISO 8601 timestamp: '${timeValue.value}'.`);
+            }
+            return parsed.toISOString();
+        }
+        case extraction_1.TimeValueType.CURRENT_TIME: {
+            return new Date().toISOString();
+        }
+        case extraction_1.TimeValueType.UNBOUNDED: {
+            return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+        }
+        case extraction_1.TimeValueType.WORKERS_OLDEST: {
+            if (!state.workersOldest) {
+                // To support backwards-compatibility for the old state
+                return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+            }
+            return state.workersOldest;
+        }
+        case extraction_1.TimeValueType.WORKERS_NEWEST: {
+            if (!state.workersNewest) {
+                throw new Error('Field workersNewest is not set in state. Cannot resolve TimeValue of type WORKERS_NEWEST without a prior extraction boundary.');
+            }
+            return state.workersNewest;
+        }
+        case extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW: {
+            if (!timeValue.value) {
+                throw new Error("TimeValue of type WORKERS_OLDEST_MINUS_WINDOW must have a value (duration, e.g. '30s', '5m', '2h').");
+            }
+            if (!state.workersOldest) {
+                // To support backwards-compatibility for the old state
+                return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+            }
+            return applyDuration(state.workersOldest, timeValue.value, 'subtract');
+        }
+        case extraction_1.TimeValueType.WORKERS_NEWEST_PLUS_WINDOW: {
+            if (!timeValue.value) {
+                throw new Error("TimeValue of type WORKERS_NEWEST_PLUS_WINDOW must have a value (duration, e.g. '30s', '5m', '2h').");
+            }
+            if (!state.workersNewest) {
+                throw new Error('Field workersNewest is not set in state. Cannot resolve TimeValue of type WORKERS_NEWEST_PLUS_WINDOW without a prior extraction boundary.');
+            }
+            return applyDuration(state.workersNewest, timeValue.value, 'add');
+        }
+        default: {
+            throw new Error(`Unknown TimeValueType: '${timeValue.type}'.`);
+        }
+    }
+}

package/dist/common/time-value-resolver.test.d.ts

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

package/dist/common/time-value-resolver.test.d.ts.map

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

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,15 @@
-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 * 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 { processTask } from './multithreading/process-task';
 export { spawn } from './multithreading/spawn/spawn';
 export { WorkerAdapter } from './multithreading/worker-adapter/worker-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,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAC/E,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,23 @@ 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.WorkerAdapter = exports.spawn = exports.processTask = 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; } });
 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 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; } });