@devrev/ts-adaas 1.17.1-beta.5 → 1.17.1-beta.7

package/dist/attachments-streaming/attachments-streaming-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments-streaming-pool.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAGzF,qBAAa,wBAAwB,CAAC,cAAc;IAClD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAA4C;IAE1D,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAM;gBAEnC,EACV,OAAO,EACP,WAAW,EACX,SAAc,EACd,MAAM,GACP,EAAE,8BAA8B,CAAC,cAAc,CAAC;YAQnC,cAAc;IAS5B;;;;;OAKG;IAEH,OAAO,CAAC,2BAA2B;IAsB7B,SAAS,IAAI,OAAO,CAAC,2BAA2B,CAAC;IA8CjD,kBAAkB;CA0FzB"}
+{"version":3,"file":"attachments-streaming-pool.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,qBAAa,wBAAwB,CAAC,cAAc;IAClD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAA4C;IAE1D,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAM;gBAEnC,EACV,OAAO,EACP,WAAW,EACX,SAAc,EACd,MAAM,GACP,EAAE,8BAA8B,CAAC,cAAc,CAAC;YAQnC,cAAc;IAS5B;;;;;OAKG;IAEH,OAAO,CAAC,2BAA2B;IAsB7B,SAAS,IAAI,OAAO,CAAC,2BAA2B,CAAC;IA8CjD,kBAAkB;CA0FzB"}

package/dist/common/constants.d.ts

@@ -25,4 +25,12 @@ export declare const DEFAULT_LAMBDA_TIMEOUT: number;
 export declare const HARD_TIMEOUT_MULTIPLIER = 1.3;
 export declare const MEMORY_LOG_INTERVAL: number;
 export declare const DEFAULT_SLEEP_DELAY_MS: number;
+/**
+ * Sentinel value representing an unbounded (no limit) extraction timestamp.
+ * Used as the resolved value for TimeValueType.UNBOUNDED, stored as workersOldest
+ * when the initial import has no lower time bound. The Unix epoch ensures that
+ * no real extraction timestamp can be earlier, preventing accidental overwrites
+ * of the boundary by subsequent syncs (e.g. reconciliation with absolute dates).
+ */
+export declare const UNBOUNDED_DATE_TIME_VALUE = "1970-01-01T00:00:00.000Z";
 //# sourceMappingURL=constants.d.ts.map

package/dist/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,eAAO,MAAM,8BAA8B,aAS1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,aAKvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAG/B,CAAC;AAEF,eAAO,MAAM,gCAAgC,aAI5C,CAAC;AAEF,eAAO,MAAM,6BAA6B,aAGzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,aAGjC,CAAC;AAEF,eAAO,MAAM,+BAA+B,aAGzC,CAAC;AAEJ,eAAO,MAAM,4BAA4B,aAExC,CAAC;AAEF,eAAO,MAAM,oBAAoB,aAGhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAGvD,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAA0B,CAAC;AAEzD,oBAAY,uBAAuB;IACjC,wBAAwB,6BAA6B;IACrD,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,eAAe,KAAsB,CAAC;AAEnD,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AACrD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAE7C,eAAO,MAAM,sBAAsB,QAAgB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,eAAO,MAAM,8BAA8B,aAS1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,aAKvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAG/B,CAAC;AAEF,eAAO,MAAM,gCAAgC,aAI5C,CAAC;AAEF,eAAO,MAAM,6BAA6B,aAGzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,aAGjC,CAAC;AAEF,eAAO,MAAM,+BAA+B,aAGzC,CAAC;AAEJ,eAAO,MAAM,4BAA4B,aAExC,CAAC;AAEF,eAAO,MAAM,oBAAoB,aAGhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAGvD,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAA0B,CAAC;AAEzD,oBAAY,uBAAuB;IACjC,wBAAwB,6BAA6B;IACrD,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,eAAe,KAAsB,CAAC;AAEnD,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AACrD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAE7C,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,6BAA6B,CAAC"}

package/dist/common/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SLEEP_DELAY_MS = exports.MEMORY_LOG_INTERVAL = exports.HARD_TIMEOUT_MULTIPLIER = exports.DEFAULT_LAMBDA_TIMEOUT = exports.LIBRARY_VERSION = exports.AirSyncDefaultItemTypes = exports.SSOR_ATTACHMENT = exports.EVENT_SIZE_THRESHOLD_BYTES = exports.MAX_EVENT_SIZE_BYTES = exports.MAX_DEVREV_FILENAME_EXTENSION_LENGTH = exports.MAX_DEVREV_FILENAME_LENGTH = exports.MAX_DEVREV_ARTIFACT_SIZE = exports.ARTIFACT_BATCH_SIZE = exports.STATEFUL_EVENT_TYPES = exports.STATEFUL_LOADING_EVENT_TYPES = exports.STATEFUL_EXTRACTION_EVENT_TYPES = exports.STATELESS_EVENT_TYPES = exports.STATELESS_LOADING_EVENT_TYPES = exports.STATELESS_EXTRACTION_EVENT_TYPES = exports.ALLOWED_EVENT_TYPES = exports.ALLOWED_LOADING_EVENT_TYPES = exports.ALLOWED_EXTRACTION_EVENT_TYPES = void 0;
+exports.UNBOUNDED_DATE_TIME_VALUE = exports.DEFAULT_SLEEP_DELAY_MS = exports.MEMORY_LOG_INTERVAL = exports.HARD_TIMEOUT_MULTIPLIER = exports.DEFAULT_LAMBDA_TIMEOUT = exports.LIBRARY_VERSION = exports.AirSyncDefaultItemTypes = exports.SSOR_ATTACHMENT = exports.EVENT_SIZE_THRESHOLD_BYTES = exports.MAX_EVENT_SIZE_BYTES = exports.MAX_DEVREV_FILENAME_EXTENSION_LENGTH = exports.MAX_DEVREV_FILENAME_LENGTH = exports.MAX_DEVREV_ARTIFACT_SIZE = exports.ARTIFACT_BATCH_SIZE = exports.STATEFUL_EVENT_TYPES = exports.STATEFUL_LOADING_EVENT_TYPES = exports.STATEFUL_EXTRACTION_EVENT_TYPES = exports.STATELESS_EVENT_TYPES = exports.STATELESS_LOADING_EVENT_TYPES = exports.STATELESS_EXTRACTION_EVENT_TYPES = exports.ALLOWED_EVENT_TYPES = exports.ALLOWED_LOADING_EVENT_TYPES = exports.ALLOWED_EXTRACTION_EVENT_TYPES = void 0;
 const extraction_1 = require("../types/extraction");
 const helpers_1 = require("./helpers");
 exports.ALLOWED_EXTRACTION_EVENT_TYPES = [
@@ -62,3 +62,11 @@ exports.DEFAULT_LAMBDA_TIMEOUT = 10 * 60 * 1000; // 10 minutes
 exports.HARD_TIMEOUT_MULTIPLIER = 1.3;
 exports.MEMORY_LOG_INTERVAL = 30 * 1000; // 30 seconds
 exports.DEFAULT_SLEEP_DELAY_MS = 3 * 60 * 1000; // 3 minutes
+/**
+ * Sentinel value representing an unbounded (no limit) extraction timestamp.
+ * Used as the resolved value for TimeValueType.UNBOUNDED, stored as workersOldest
+ * when the initial import has no lower time bound. The Unix epoch ensures that
+ * no real extraction timestamp can be earlier, preventing accidental overwrites
+ * of the boundary by subsequent syncs (e.g. reconciliation with absolute dates).
+ */
+exports.UNBOUNDED_DATE_TIME_VALUE = '1970-01-01T00:00:00.000Z';

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,CAqFR"}

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

@@ -0,0 +1,149 @@
+"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) {
+                // To support backwards-compatibility for the old state
+                if (state.lastSuccessfulSyncStarted) {
+                    return state.lastSuccessfulSyncStarted;
+                }
+                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) {
+                // To support backwards-compatibility for the old state
+                if (state.lastSuccessfulSyncStarted) {
+                    return state.lastSuccessfulSyncStarted;
+                }
+                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,273 @@
+"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 = {
+            lastSyncStarted: '',
+            lastSuccessfulSyncStarted: '',
+            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).toBeDefined();
+                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 = {
+                lastSyncStarted: '',
+                lastSuccessfulSyncStarted: '',
+                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/mock-server/mock-server.d.ts

@@ -5,7 +5,6 @@ import { RequestInfo, RouteConfig } from './mock-server.interfaces';
  * Supports per-test route configuration to simulate different response scenarios.
  */
 export declare class MockServer {
-    private app;
     private server;
     private internalPort;
     port: number;
@@ -16,40 +15,15 @@ export declare class MockServer {
     constructor(port?: number);
     start(): Promise<void>;
     stop(): Promise<void>;
-    /**
-     * Sets up routes for the mock server.
-     */
-    private setupRoutes;
-    /**
-     * Creates a route handler that checks for custom handlers before using the default.
-     * @param method - The HTTP method
-     * @param path - The route path
-     * @returns A route handler function
-     */
-    private routeHandler;
+    private handleRequest;
     /**
      * Default route handler for the mock server. Returns { success: true } for
      * routes that are not explicitly set.
-     * @param req - The request object
-     * @param res - The response object
-     * @returns void
      */
     private defaultRouteHandler;
-    /**
-     * Gets the route key for a given method and path.
-     * @param method - The HTTP method
-     * @param path - The route path
-     * @returns The route key in the format 'METHOD:path'
-     */
     private getRouteKey;
     /**
      * Configures a route to return a specific status code and optional response body.
-     * @param config - The route configuration object
-     * @param config.path - The path of the route (e.g., '/callback_url')
-     * @param config.method - The HTTP method (e.g., 'GET', 'POST')
-     * @param config.status - The HTTP status code to return (e.g., 200, 401, 500)
-     * @param config.body - Optional response body to send as JSON
-     * @param config.retry - Optional retry configuration for simulating failures before success
      */
     setRoute(config: RouteConfig): void;
     /**
@@ -59,21 +33,14 @@ export declare class MockServer {
     resetRoutes(): void;
     /**
      * Returns the most recent request or undefined if no requests exist.
-     * @returns The last RequestInfo object or undefined
      */
     getLastRequest(): RequestInfo | undefined;
     /**
      * Gets the number of requests made to a specific endpoint.
-     * @param method - The HTTP method (e.g., 'GET', 'POST')
-     * @param path - The route path (e.g., '/test-endpoint', '/callback_url')
-     * @returns The number of requests made to the endpoint
      */
     getRequestCount(method: string, path: string): number;
     /**
      * Gets all requests made to a specific endpoint.
-     * @param method - The HTTP method (e.g., 'GET', 'POST')
-     * @param path - The route path (e.g., '/test-endpoint', '/callback_url')
-     * @returns An array of RequestInfo objects for the endpoint
      */
     getRequests(method: string, path: string): RequestInfo[];
 }

package/dist/mock-server/mock-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../src/mock-server/mock-server.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,WAAW,EACX,WAAW,EAGZ,MAAM,0BAA0B,CAAC;AAElC;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAA4B;gBAErC,IAAI,GAAE,MAAiC;IAWtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBlC;;OAEG;IACH,OAAO,CAAC,WAAW;IAsDnB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAsBpB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;;OAQG;IACI,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA2E1C;;;OAGG;IACI,WAAW,IAAI,IAAI;IAM1B;;;OAGG;IACI,cAAc,IAAI,WAAW,GAAG,SAAS;IAOhD;;;;;OAKG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5D;;;;;OAKG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;CAShE"}
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../src/mock-server/mock-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,WAAW,EACX,WAAW,EAEZ,MAAM,0BAA0B,CAAC;AAuElC;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAA4B;gBAErC,IAAI,GAAE,MAAiC;IAMtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBpB,aAAa;IA+B3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,WAAW;IAInB;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAyE1C;;;OAGG;IACI,WAAW,IAAI,IAAI;IAM1B;;OAEG;IACI,cAAc,IAAI,WAAW,GAAG,SAAS;IAOhD;;OAEG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5D;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;CAQhE"}

package/dist/mock-server/mock-server.interfaces.d.ts

@@ -1,5 +1,21 @@
-import { Request, Response } from 'express';
+import { IncomingMessage, ServerResponse } from 'http';
 export declare const DEFAULT_MOCK_SERVER_PORT = 3001;
+export interface ParsedRequest extends IncomingMessage {
+    /** Parsed URL path (without query string) */
+    path: string;
+    /** Parsed JSON body (if any) */
+    body?: unknown;
+}
+export interface MockResponse extends ServerResponse {
+    /** Set response headers from a record */
+    set(headers: Record<string, string>): MockResponse;
+    /** Set the HTTP status code */
+    status(code: number): MockResponse;
+    /** Send a JSON response */
+    json(data: unknown): void;
+    /** Send an empty response */
+    send(): void;
+}
 /**
  * Configuration for retry simulation behavior.
  */
@@ -37,7 +53,7 @@ export interface RouteConfig {
 /**
  * Type for custom route handler functions.
  */
-export type RouteHandler = (req: Request, res: Response) => unknown;
+export type RouteHandler = (req: ParsedRequest, res: MockResponse) => unknown;
 /**
  * Information about a request received by the mock server.
  */