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

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

@@ -1 +1 @@
-{"version":3,"file":"state.interfaces.d.ts","sourceRoot":"","sources":["../../src/state/state.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB;gHAC4G;IAC5G,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;gHAC4G;IAC5G,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,cAAc;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,mBAAmB,EAAE;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,+BAA+B,CAAC,EAAE,mBAAmB,EAAE,CAAC;KACzD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,cAAc;IAC5C,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,cAAc,CAAC;IAC7B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAa9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAKhD,CAAC"}
+{"version":3,"file":"state.interfaces.d.ts","sourceRoot":"","sources":["../../src/state/state.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,QAAQ;IAGvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB,CAAC,cAAc;IAClD,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,mBAAmB,EAAE;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,+BAA+B,CAAC,EAAE,mBAAmB,EAAE,CAAC;KACzD,CAAC;CACH;AAED,oBAAY,yBAAyB;IACnC,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,cAAc;IAC5C,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,cAAc,CAAC;IAC7B,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAa9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAKhD,CAAC"}

package/dist/state/state.interfaces.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1_SDK_STATE_KEYS = exports.loadingSdkState = exports.extractionSdkState = void 0;
+exports.V1_SDK_STATE_KEYS = exports.loadingSdkState = exports.extractionSdkState = exports.ProcessedAttachmentStatus = void 0;
+var ProcessedAttachmentStatus;
+(function (ProcessedAttachmentStatus) {
+    ProcessedAttachmentStatus["Success"] = "success";
+    ProcessedAttachmentStatus["Failed"] = "failed";
+})(ProcessedAttachmentStatus || (exports.ProcessedAttachmentStatus = ProcessedAttachmentStatus = {}));
 exports.extractionSdkState = {
     pendingWorkersOldest: '',
     pendingWorkersNewest: '',
@@ -22,16 +27,9 @@ exports.loadingSdkState = {
     },
 };
 /**
- * The set of top-level state keys owned by the SDK. Derived from the initial
- * SDK state constants so it auto-updates whenever a new SDK field is added.
- * Used by the migration shim to split a flat v1 state blob into the
- * `{ connectorState, sdkState }` envelope: keys in this set go to `sdkState`,
- * everything else is connector state.
- *
- * `lastSyncStarted` / `lastSuccessfulSyncStarted` are retained here even though
- * they are no longer fields on `SdkState`: a flat v1 blob may still carry them,
- * and they must be recognized as SDK-owned so they are stripped out rather than
- * leaking into connector state during migration.
+ * SDK-owned top-level state keys, used to split a flat v1 blob during migration.
+ * `lastSyncStarted` / `lastSuccessfulSyncStarted` are no longer on `SdkState` but
+ * stay listed so v1 blobs carrying them don't leak them into connector state.
  */
 exports.V1_SDK_STATE_KEYS = new Set([
     ...Object.keys(exports.extractionSdkState),

package/dist/state/state.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createLoadingState = exports.LoadingState = exports.createExtractionState = exports.ExtractionState = exports.BaseState = void 0;
+exports.LoadingState = exports.createLoadingState = exports.ExtractionState = exports.createExtractionState = exports.BaseState = void 0;
 var base_state_1 = require("./base-state");
 Object.defineProperty(exports, "BaseState", { enumerable: true, get: function () { return base_state_1.BaseState; } });
 var extraction_state_1 = require("./extraction-state");
-Object.defineProperty(exports, "ExtractionState", { enumerable: true, get: function () { return extraction_state_1.ExtractionState; } });
 Object.defineProperty(exports, "createExtractionState", { enumerable: true, get: function () { return extraction_state_1.createExtractionState; } });
+Object.defineProperty(exports, "ExtractionState", { enumerable: true, get: function () { return extraction_state_1.ExtractionState; } });
 var loading_state_1 = require("./loading-state");
-Object.defineProperty(exports, "LoadingState", { enumerable: true, get: function () { return loading_state_1.LoadingState; } });
 Object.defineProperty(exports, "createLoadingState", { enumerable: true, get: function () { return loading_state_1.createLoadingState; } });
+Object.defineProperty(exports, "LoadingState", { enumerable: true, get: function () { return loading_state_1.LoadingState; } });

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

@@ -1,46 +1,17 @@
-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
- */
+import { TimeUnit, TimeValue } from '../types/extraction';
+/** Parses a shorthand duration (e.g. '100ns', '500ms', '5m', '2h'); units are the `TimeUnit` values. */
 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
- */
+/** Adds/subtracts a shorthand duration to/from an ISO 8601 timestamp. */
 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 UNBOUNDED if not set
- * - WORKERS_NEWEST: Returns workersNewest from state, or UNBOUNDED if not set
- * - WORKERS_OLDEST_MINUS_WINDOW: Subtracts duration from workersOldest, or UNBOUNDED if not set
- * - WORKERS_NEWEST_PLUS_WINDOW: Adds duration to workersNewest, or UNBOUNDED 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
+ * Resolves a TimeValue into a concrete ISO 8601 timestamp. WORKERS_* types
+ * read the boundaries from state and fall back to UNBOUNDED when unset
+ * (backwards compatibility with old state); *_WINDOW types apply the duration
+ * in `timeValue.value` to the boundary.
  */
 export declare function resolveTimeValue(timeValue: TimeValue, state: SdkState): string;
 //# sourceMappingURL=time-value-resolver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"time-value-resolver.d.ts","sourceRoot":"","sources":["../../src/state/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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,QAAQ,GACd,MAAM,CAyER"}
+{"version":3,"file":"time-value-resolver.d.ts","sourceRoot":"","sources":["../../src/state/time-value-resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAEzE,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,CAcA;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,KAAK,GAAG,UAAU,GAC5B,MAAM,CA6BR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,QAAQ,GACd,MAAM,CAqER"}

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

@@ -3,20 +3,9 @@ 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("../common/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
- */
+const extraction_1 = require("../types/extraction");
+/** Parses a shorthand duration (e.g. '100ns', '500ms', '5m', '2h'); units are the `TimeUnit` values. */
 function parseDuration(shorthand) {
     const validUnits = Object.values(extraction_1.TimeUnit).join('|');
     const match = shorthand.match(new RegExp(`^(\\d+(?:\\.\\d+)?)(${validUnits})$`));
@@ -28,14 +17,7 @@ function parseDuration(shorthand) {
         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
- */
+/** Adds/subtracts a shorthand duration to/from an ISO 8601 timestamp. */
 function applyDuration(baseTimestamp, duration, operation) {
     const { value, unit } = parseDuration(duration);
     const date = new Date(baseTimestamp);
@@ -65,21 +47,10 @@ function applyDuration(baseTimestamp, duration, operation) {
     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 UNBOUNDED if not set
- * - WORKERS_NEWEST: Returns workersNewest from state, or UNBOUNDED if not set
- * - WORKERS_OLDEST_MINUS_WINDOW: Subtracts duration from workersOldest, or UNBOUNDED if not set
- * - WORKERS_NEWEST_PLUS_WINDOW: Adds duration to workersNewest, or UNBOUNDED 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
+ * Resolves a TimeValue into a concrete ISO 8601 timestamp. WORKERS_* types
+ * read the boundaries from state and fall back to UNBOUNDED when unset
+ * (backwards compatibility with old state); *_WINDOW types apply the duration
+ * in `timeValue.value` to the boundary.
  */
 function resolveTimeValue(timeValue, state) {
     switch (timeValue.type) {
@@ -103,14 +74,12 @@ function resolveTimeValue(timeValue, state) {
         }
         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
                 return constants_1.UNBOUNDED_DATE_TIME_VALUE;
             }
             return state.workersNewest;
@@ -120,7 +89,6 @@ function resolveTimeValue(timeValue, state) {
                 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');
@@ -130,7 +98,6 @@ function resolveTimeValue(timeValue, state) {
                 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
                 return constants_1.UNBOUNDED_DATE_TIME_VALUE;
             }
             return applyDuration(state.workersNewest, timeValue.value, 'add');

package/dist/testing/mock-event.d.ts

@@ -1,18 +1,10 @@
 import { AirSyncEvent } from '../types/extraction';
-/**
- * Recursively makes all properties of T optional.
- */
 export type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 /**
- * Creates a mock AirSyncEvent for testing.
- *
- * @param mockServerUrl - Base URL for the mock server. Defaults to {@link MOCK_SERVER_DEFAULT_URL}.
- *   The `callback_url`, `worker_data_url`, and `devrev_endpoint` fields are
- *   derived from this value unless explicitly overridden.
- * @param overrides - Deep partial of AirSyncEvent. Any provided fields are
- *   deep-merged on top of the defaults.
+ * Creates a mock AirSyncEvent for testing. `callback_url`, `worker_data_url`,
+ * and `devrev_endpoint` derive from `mockServerUrl` unless explicitly overridden.
  */
 export declare function createMockEvent(mockServerUrl?: string, overrides?: DeepPartial<AirSyncEvent>): AirSyncEvent;
 //# sourceMappingURL=mock-event.d.ts.map

package/dist/testing/mock-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-event.d.ts","sourceRoot":"","sources":["../../src/testing/mock-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,qBAAqB,CAAC;AAI9D;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAoCF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,aAAa,GAAE,MAAgC,EAC/C,SAAS,GAAE,WAAW,CAAC,YAAY,CAAM,GACxC,YAAY,CA+Ed"}
+{"version":3,"file":"mock-event.d.ts","sourceRoot":"","sources":["../../src/testing/mock-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,qBAAqB,CAAC;AAI9D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAiCF;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,aAAa,GAAE,MAAgC,EAC/C,SAAS,GAAE,WAAW,CAAC,YAAY,CAAM,GACxC,YAAY,CA+Ed"}

package/dist/testing/mock-event.js

@@ -3,10 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMockEvent = createMockEvent;
 const extraction_1 = require("../types/extraction");
 const mock_server_1 = require("./mock-server");
-/**
- * Deep merges source into target. Arrays and primitives from source replace
- * those in target; plain objects are merged recursively.
- */
+/** Arrays and primitives from source replace target's; plain objects merge recursively. */
 function deepMerge(target, source) {
     const result = Object.assign({}, target);
     for (const key of Object.keys(source)) {
@@ -27,13 +24,8 @@ function deepMerge(target, source) {
     return result;
 }
 /**
- * Creates a mock AirSyncEvent for testing.
- *
- * @param mockServerUrl - Base URL for the mock server. Defaults to {@link MOCK_SERVER_DEFAULT_URL}.
- *   The `callback_url`, `worker_data_url`, and `devrev_endpoint` fields are
- *   derived from this value unless explicitly overridden.
- * @param overrides - Deep partial of AirSyncEvent. Any provided fields are
- *   deep-merged on top of the defaults.
+ * Creates a mock AirSyncEvent for testing. `callback_url`, `worker_data_url`,
+ * and `devrev_endpoint` derive from `mockServerUrl` unless explicitly overridden.
  */
 function createMockEvent(mockServerUrl = mock_server_1.MOCK_SERVER_DEFAULT_URL, overrides = {}) {
     var _a, _b, _c, _d;

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

@@ -1,13 +1,8 @@
 import { RequestInfo, RouteConfig } from './mock-server.interfaces';
-/**
- * Default base URL for the mock server. The port `0` lets the OS assign a free
- * port at listen time; tests read the resolved URL from `mockServer.baseUrl`.
- */
 export declare const MOCK_SERVER_DEFAULT_URL = "http://localhost:0";
 /**
- * MockServer used in tests to mock internal AirSync endpoints.
- * This is a simple mock server that listens on a port and responds to requests.
- * Supports per-test route configuration to simulate different response scenarios.
+ * Mocks internal AirSync endpoints in tests, with per-test route
+ * configuration to simulate different response scenarios.
  */
 export declare class MockServer {
     private server;
@@ -21,32 +16,14 @@ export declare class MockServer {
     start(): Promise<void>;
     stop(): Promise<void>;
     private handleRequest;
-    /**
-     * Default route handler for the mock server. Returns { success: true } for
-     * routes that are not explicitly set.
-     */
+    /** Falls back to { success: true } for routes not explicitly set. */
     private defaultRouteHandler;
     private getRouteKey;
-    /**
-     * Configures a route to return a specific status code and optional response body.
-     */
     setRoute(config: RouteConfig): void;
-    /**
-     * Resets all custom route handlers, restoring all default handlers.
-     * Also clears request tracking data.
-     */
+    /** Restores default handlers and clears request tracking data. */
     resetRoutes(): void;
-    /**
-     * Returns the most recent request or undefined if no requests exist.
-     */
     getLastRequest(): RequestInfo | undefined;
-    /**
-     * Gets the number of requests made to a specific endpoint.
-     */
     getRequestCount(method: string, path: string): number;
-    /**
-     * Gets all requests made to a specific endpoint.
-     */
     getRequests(method: string, path: string): RequestInfo[];
 }
 //# sourceMappingURL=mock-server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../src/testing/mock-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,WAAW,EACX,WAAW,EAEZ,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAuE5D;;;;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"}
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../src/testing/mock-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,WAAW,EACX,WAAW,EAEZ,MAAM,0BAA0B,CAAC;AAIlC,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAsE5D;;;GAGG;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,qEAAqE;IACrE,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,WAAW;IAIZ,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA8E1C,kEAAkE;IAC3D,WAAW,IAAI,IAAI;IAMnB,cAAc,IAAI,WAAW,GAAG,SAAS;IAOzC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;CAQhE"}

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

@@ -1,73 +1,48 @@
 import { IncomingMessage, ServerResponse } from 'http';
 export declare const DEFAULT_MOCK_SERVER_PORT = 3001;
 export interface ParsedRequest extends IncomingMessage {
-    /** Parsed URL path (without query string) */
+    /** 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 */
+    buffer(data: Buffer): void;
     send(): void;
 }
-/**
- * Configuration for retry simulation behavior.
- */
+/** Simulates failures before succeeding. */
 export interface RetryConfig {
-    /** Number of times to return error before succeeding (default: 4) */
+    /** Failures before success (default: 4) */
     failureCount?: number;
-    /** 5xx status code to return during failures (default: 500) */
+    /** Status code during failures (default: 500) */
     errorStatus?: number;
-    /** Optional error response body to send as JSON during failures */
     errorBody?: unknown;
-    /** Optional headers to send with the error response */
     headers?: Record<string, string>;
-    /** Optional delay in milliseconds before sending each failure response */
+    /** Delay in ms before each failure response */
     delay?: number;
 }
-/**
- * Configuration object for setting up a route response.
- */
 export interface RouteConfig {
-    /** The path of the route (e.g., '/callback_url', '/worker_data_url.get') */
     path: string;
-    /** The HTTP method (e.g., 'GET', 'POST', 'PUT', 'DELETE') */
     method: string;
-    /** The HTTP status code to return (e.g., 200, 401, 500) */
     status: number;
-    /** Optional response body to send as JSON */
     body?: unknown;
-    /** Optional headers to send with the response */
+    /** Raw binary body, e.g. gzipped JSONL (takes precedence over `body`) */
+    bodyBuffer?: Buffer;
     headers?: Record<string, string>;
-    /** Optional retry configuration for simulating failures before success */
     retry?: RetryConfig;
-    /** Optional delay in milliseconds before sending the response */
+    /** Delay in ms before sending the response */
     delay?: number;
 }
-/**
- * Type for custom route handler functions.
- */
 export type RouteHandler = (req: ParsedRequest, res: MockResponse) => unknown;
-/**
- * Information about a request received by the mock server.
- */
 export interface RequestInfo {
-    /** The HTTP method (e.g., 'GET', 'POST') */
     method: string;
-    /** The full URL path of the request */
     url: string;
-    /** Optional request body (for POST/PUT requests) */
     body?: unknown;
 }
 export type RouteHandlers = Map<string, RouteHandler>;
-/**
- * Type for tracking request counts per route.
- */
+/** Request counts per route. */
 export type RequestCounts = Map<string, number>;
 //# sourceMappingURL=mock-server.interfaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mock-server.interfaces.d.ts","sourceRoot":"","sources":["../../src/testing/mock-server.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAEvD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,yCAAyC;IACzC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;IACnD,+BAA+B;IAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IACnC,2BAA2B;IAC3B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,6BAA6B;IAC7B,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}
+{"version":3,"file":"mock-server.interfaces.d.ts","sourceRoot":"","sources":["../../src/testing/mock-server.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAEvD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IACnC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEtD,gCAAgC;AAChC,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/testing/mock-server.js

@@ -3,15 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MockServer = exports.MOCK_SERVER_DEFAULT_URL = void 0;
 const http_1 = require("http");
 const mock_server_interfaces_1 = require("./mock-server.interfaces");
-/**
- * Default base URL for the mock server. The port `0` lets the OS assign a free
- * port at listen time; tests read the resolved URL from `mockServer.baseUrl`.
- */
+// Port 0 lets the OS assign a free port at listen time; tests read the
+// resolved URL from `mockServer.baseUrl`.
 exports.MOCK_SERVER_DEFAULT_URL = 'http://localhost:0';
 const MAX_BODY_SIZE = 10 * 1024 * 1024; // 10mb
-/**
- * Parses the JSON body from an incoming request.
- */
 async function parseJsonBody(req) {
     return new Promise((resolve, reject) => {
         const chunks = [];
@@ -41,9 +36,6 @@ async function parseJsonBody(req) {
         req.on('error', reject);
     });
 }
-/**
- * Wraps a ServerResponse with helper methods (status, json, set, send).
- */
 function wrapResponse(res) {
     const mock = res;
     let statusCode = 200;
@@ -61,6 +53,10 @@ function wrapResponse(res) {
         res.writeHead(statusCode, { 'Content-Type': 'application/json' });
         res.end(JSON.stringify(data));
     };
+    mock.buffer = (data) => {
+        res.writeHead(statusCode, { 'Content-Type': 'application/octet-stream' });
+        res.end(data);
+    };
     mock.send = () => {
         res.writeHead(statusCode);
         res.end();
@@ -68,9 +64,8 @@ function wrapResponse(res) {
     return mock;
 }
 /**
- * MockServer used in tests to mock internal AirSync endpoints.
- * This is a simple mock server that listens on a port and responds to requests.
- * Supports per-test route configuration to simulate different response scenarios.
+ * Mocks internal AirSync endpoints in tests, with per-test route
+ * configuration to simulate different response scenarios.
  */
 class MockServer {
     constructor(port = mock_server_interfaces_1.DEFAULT_MOCK_SERVER_PORT) {
@@ -139,10 +134,7 @@ class MockServer {
             this.defaultRouteHandler(req, res);
         }
     }
-    /**
-     * Default route handler for the mock server. Returns { success: true } for
-     * routes that are not explicitly set.
-     */
+    /** Falls back to { success: true } for routes not explicitly set. */
     defaultRouteHandler(req, res) {
         if (req.method === 'GET' && req.path === '/worker_data_url.get') {
             res.status(200).json({
@@ -175,11 +167,8 @@ class MockServer {
     getRouteKey(method, path) {
         return `${method.toUpperCase()}:${path}`;
     }
-    /**
-     * Configures a route to return a specific status code and optional response body.
-     */
     setRoute(config) {
-        const { path, method, status, body, retry, headers, delay } = config;
+        const { path, method, status, body, bodyBuffer, retry, headers, delay } = config;
         const key = this.getRouteKey(method, path);
         if (retry) {
             this.requestCounts.set(key, 0);
@@ -217,7 +206,10 @@ class MockServer {
                             if (headers) {
                                 res.set(headers);
                             }
-                            if (body !== undefined) {
+                            if (bodyBuffer !== undefined) {
+                                res.status(status).buffer(bodyBuffer);
+                            }
+                            else if (body !== undefined) {
                                 res.status(status).json(body);
                             }
                             else {
@@ -229,7 +221,10 @@ class MockServer {
                         if (headers) {
                             res.set(headers);
                         }
-                        if (body !== undefined) {
+                        if (bodyBuffer !== undefined) {
+                            res.status(status).buffer(bodyBuffer);
+                        }
+                        else if (body !== undefined) {
                             res.status(status).json(body);
                         }
                         else {
@@ -247,33 +242,21 @@ class MockServer {
             sendResponse(delay);
         });
     }
-    /**
-     * Resets all custom route handlers, restoring all default handlers.
-     * Also clears request tracking data.
-     */
+    /** Restores default handlers and clears request tracking data. */
     resetRoutes() {
         this.routeHandlers.clear();
         this.requestCounts.clear();
         this.requests = [];
     }
-    /**
-     * Returns the most recent request or undefined if no requests exist.
-     */
     getLastRequest() {
         if (this.requests.length === 0) {
             return undefined;
         }
         return this.requests[this.requests.length - 1];
     }
-    /**
-     * Gets the number of requests made to a specific endpoint.
-     */
     getRequestCount(method, path) {
         return this.getRequests(method, path).length;
     }
-    /**
-     * Gets all requests made to a specific endpoint.
-     */
     getRequests(method, path) {
         const pathWithoutQuery = path.split('?')[0];
         return this.requests.filter((req) => req.method.toUpperCase() === method.toUpperCase() &&

package/dist/types/common.d.ts

@@ -1,22 +1,11 @@
-/**
- * ErrorRecord is an interface that defines the structure of an error record.
- */
 export interface ErrorRecord {
     message: string;
 }
-/**
- * InitialDomainMapping is an interface that defines the structure of the initial domain mapping.
- */
 export interface InitialDomainMapping {
     starting_recipe_blueprint?: object;
     additional_mappings?: object;
 }
-/**
- * SyncMode is an enum that defines the different modes of sync that can be used by the external extractor.
- * It can be either INITIAL, INCREMENTAL or LOADING. INITIAL mode is used for
- * the first/initial import, while INCREMENTAL mode is used for doing syncs. LOADING mode is used for
- * loading data from DevRev to the external system.
- */
+/** INITIAL = first import, INCREMENTAL = subsequent syncs, LOADING = DevRev -> external system. */
 export declare enum SyncMode {
     INITIAL = "INITIAL",
     INCREMENTAL = "INCREMENTAL",

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

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;CACpB"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mGAAmG;AACnG,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;CACpB"}

package/dist/types/common.js

@@ -1,12 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncMode = void 0;
-/**
- * SyncMode is an enum that defines the different modes of sync that can be used by the external extractor.
- * It can be either INITIAL, INCREMENTAL or LOADING. INITIAL mode is used for
- * the first/initial import, while INCREMENTAL mode is used for doing syncs. LOADING mode is used for
- * loading data from DevRev to the external system.
- */
+/** INITIAL = first import, INCREMENTAL = subsequent syncs, LOADING = DevRev -> external system. */
 var SyncMode;
 (function (SyncMode) {
     SyncMode["INITIAL"] = "INITIAL";