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

package/dist/state/loading-state.js

@@ -5,26 +5,15 @@ exports.createLoadingState = createLoadingState;
 const constants_1 = require("../common/constants");
 const base_state_1 = require("./base-state");
 const state_interfaces_1 = require("./state.interfaces");
-/**
- * LoadingState is the per-mode state for loading workers. It narrows `sdkState`
- * to `LoadingSdkState` (files-to-load bookkeeping) on top of the shared
- * lifecycle provided by `BaseState`.
- */
+/** State for loading workers: seeds loading SDK state; no extraction-window resolution. */
 class LoadingState extends base_state_1.BaseState {
     constructor(params) {
-        super(params, state_interfaces_1.initialLoadingSdkState);
+        super(params, state_interfaces_1.loadingSdkState);
     }
 }
 exports.LoadingState = LoadingState;
-/**
- * Creates and initializes a `LoadingState` for a loading worker.
- *
- * For non-stateless events this fetches/migrates persisted state and installs
- * the initial domain mapping if the snap-in version changed. Loading has no
- * extraction-window resolution, so the factory is otherwise minimal.
- */
 async function createLoadingState({ event, initialState, initialDomainMapping, options, }) {
-    // Deep clone the initial state to avoid mutating the original state
+    // Clone so the caller's initialState is never mutated.
     const deepCloneInitialState = structuredClone(initialState);
     const state = new LoadingState({
         event,

package/dist/state/state.d.ts

@@ -0,0 +1,4 @@
+export { BaseState } from './base-state';
+export { createExtractionState, ExtractionState } from './extraction-state';
+export { createLoadingState, LoadingState } from './loading-state';
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -2,40 +2,17 @@ import { InitialDomainMapping } from '../types/common';
 import { AirSyncEvent } from '../types/extraction';
 import { FileToLoad } from '../types/loading';
 import { WorkerAdapterOptions } from '../types/workers';
-/**
- * BaseSdkState holds SDK bookkeeping common to every sync mode.
- */
-export interface BaseSdkState {
-    snapInVersionId?: string;
-}
-/**
- * ExtractionSdkState holds SDK bookkeeping owned by the extraction modes.
- */
-export interface ExtractionSdkState extends BaseSdkState {
-    /** The pending (not yet committed) oldest extraction boundary (ISO 8601 timestamp).
-     *  Set on StartExtractingMetadata, reused across subsequent phases, cleared on AttachmentExtractionDone. */
+export interface SdkState {
     pendingWorkersOldest?: string;
-    /** The pending (not yet committed) newest extraction boundary (ISO 8601 timestamp).
-     *  Set on StartExtractingMetadata, reused across subsequent phases, cleared on AttachmentExtractionDone. */
     pendingWorkersNewest?: string;
-    /** The oldest point of extraction (ISO 8601 timestamp). */
     workersOldest?: string;
-    /** The newest point of extraction (ISO 8601 timestamp). */
     workersNewest?: string;
     toDevRev?: ToDevRev;
-}
-/**
- * LoadingSdkState holds SDK bookkeeping owned by the loading modes.
- */
-export interface LoadingSdkState extends BaseSdkState {
     fromDevRev?: FromDevRev;
+    snapInVersionId?: string;
 }
-/**
- * AdapterStateEnvelope is the v2 on-disk state shape: connector state and SDK
- * bookkeeping are stored as disjoint sub-objects so SDK internals stay
- * encapsulated and never collide with connector keys.
- */
-export interface AdapterStateEnvelope<ConnectorState, SdkState extends BaseSdkState> {
+/** v2 on-disk state shape: SDK bookkeeping kept disjoint from connector keys. */
+export interface AdapterStateEnvelope<ConnectorState> {
     connectorState: ConnectorState;
     sdkState: SdkState;
 }
@@ -46,12 +23,15 @@ export interface ToDevRev {
         lastProcessedAttachmentsIdsList?: ProcessedAttachment[];
     };
 }
-/**
- * Attachment structure, that stores both attachment id and its parent_id for deduplication on the SDK side.
- */
+export declare enum ProcessedAttachmentStatus {
+    Success = "success",
+    Failed = "failed"
+}
+/** id + parent_id identify an attachment for SDK-side deduplication. */
 export interface ProcessedAttachment {
     id: string;
     parent_id: string;
+    status: ProcessedAttachmentStatus;
 }
 export interface FromDevRev {
     filesToLoad: FileToLoad[];
@@ -62,14 +42,30 @@ export interface StateInterface<ConnectorState> {
     initialDomainMapping?: InitialDomainMapping;
     options?: WorkerAdapterOptions;
 }
-export declare const initialExtractionSdkState: ExtractionSdkState;
-export declare const initialLoadingSdkState: LoadingSdkState;
+export declare const extractionSdkState: {
+    pendingWorkersOldest: string;
+    pendingWorkersNewest: string;
+    workersOldest: string;
+    workersNewest: string;
+    snapInVersionId: string;
+    toDevRev: {
+        attachmentsMetadata: {
+            artifactIds: never[];
+            lastProcessed: number;
+            lastProcessedAttachmentsIdsList: never[];
+        };
+    };
+};
+export declare const loadingSdkState: {
+    snapInVersionId: string;
+    fromDevRev: {
+        filesToLoad: never[];
+    };
+};
 /**
- * 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.
+ * 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.
  */
 export declare const V1_SDK_STATE_KEYS: ReadonlySet<string>;
 //# sourceMappingURL=state.interfaces.d.ts.map

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;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;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;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CACnC,cAAc,EACd,QAAQ,SAAS,YAAY;IAE7B,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,yBAAyB,EAAE,kBAavC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAKpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAGhD,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,12 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1_SDK_STATE_KEYS = exports.initialLoadingSdkState = exports.initialExtractionSdkState = void 0;
-exports.initialExtractionSdkState = {
-    snapInVersionId: '',
+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: '',
     workersOldest: '',
     workersNewest: '',
+    snapInVersionId: '',
     toDevRev: {
         attachmentsMetadata: {
             artifactIds: [],
@@ -15,20 +20,20 @@ exports.initialExtractionSdkState = {
         },
     },
 };
-exports.initialLoadingSdkState = {
+exports.loadingSdkState = {
     snapInVersionId: '',
     fromDevRev: {
         filesToLoad: [],
     },
 };
 /**
- * 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.
+ * 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.initialExtractionSdkState),
-    ...Object.keys(exports.initialLoadingSdkState),
+    ...Object.keys(exports.extractionSdkState),
+    ...Object.keys(exports.loadingSdkState),
+    'lastSyncStarted',
+    'lastSuccessfulSyncStarted',
 ]);

package/dist/state/state.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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, "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, "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

@@ -0,0 +1,17 @@
+import { SdkState } from '../state/state.interfaces';
+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;
+};
+/** 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. 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

@@ -0,0 +1 @@
+{"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/{common → 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 constants_1 = require("../common/constants");
 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
- */
+/** 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,22 +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 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
+ * 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) {
@@ -104,14 +74,13 @@ 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) {
-                throw new Error('Field workersNewest is not set in state. Cannot resolve TimeValue of type WORKERS_NEWEST without a prior extraction boundary.');
+                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,7 @@ 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) {
-                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 constants_1.UNBOUNDED_DATE_TIME_VALUE;
             }
             return applyDuration(state.workersNewest, timeValue.value, 'add');
         }

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

@@ -0,0 +1,10 @@
+import { AirSyncEvent } from '../types/extraction';
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * 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

@@ -0,0 +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,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/{common/test-utils.js → testing/mock-event.js}

@@ -1,13 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MOCK_SERVER_DEFAULT_URL = void 0;
 exports.createMockEvent = createMockEvent;
 const extraction_1 = require("../types/extraction");
-exports.MOCK_SERVER_DEFAULT_URL = 'http://localhost:0';
-/**
- * Deep merges source into target. Arrays and primitives from source replace
- * those in target; plain objects are merged recursively.
- */
+const mock_server_1 = require("./mock-server");
+/** 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)) {
@@ -28,15 +24,10 @@ 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 = exports.MOCK_SERVER_DEFAULT_URL, overrides = {}) {
+function createMockEvent(mockServerUrl = mock_server_1.MOCK_SERVER_DEFAULT_URL, overrides = {}) {
     var _a, _b, _c, _d;
     const base = {
         context: {
@@ -45,6 +36,10 @@ function createMockEvent(mockServerUrl = exports.MOCK_SERVER_DEFAULT_URL, overri
             },
             snap_in_version_id: 'test_snap_in_version_id',
             snap_in_id: 'test_snap_in_id',
+            user_id: 'test_user_id',
+            dev_oid: 'test_dev_oid',
+            source_id: 'test_source_id',
+            service_account_id: 'test_service_account_id',
         },
         payload: {
             connection_data: {
@@ -55,12 +50,17 @@ function createMockEvent(mockServerUrl = exports.MOCK_SERVER_DEFAULT_URL, overri
             },
             event_context: {
                 callback_url: `${mockServerUrl}/callback_url`,
+                dev_org: 'test_dev_org',
                 dev_oid: 'test_dev_oid',
                 dev_org_id: 'test_dev_org_id',
+                dev_user: 'test_dev_user',
+                dev_user_id: 'test_dev_user_id',
                 dev_uid: 'test_dev_uid',
                 event_type_adaas: 'test_event_type_adaas',
+                external_sync_unit: 'test_external_sync_unit',
                 external_sync_unit_id: 'test_external_sync_unit_id',
                 external_sync_unit_name: 'test_external_sync_unit_name',
+                external_system: 'test_external_system',
                 external_system_id: 'test_external_system_id',
                 external_system_name: 'test_external_system_name',
                 external_system_type: 'test_external_system_type',
@@ -72,9 +72,12 @@ function createMockEvent(mockServerUrl = exports.MOCK_SERVER_DEFAULT_URL, overri
                 sequence_version: 'test_sequence_version',
                 snap_in_slug: 'test_snap_in_slug',
                 snap_in_version_id: 'test_snap_in_version_id',
+                sync_run: 'test_sync_run',
+                sync_run_id: 'test_sync_run_id',
                 sync_tier: 'test_sync_tier',
                 sync_unit: 'test_sync_unit',
                 sync_unit_id: 'test_sync_unit_id',
+                uuid: 'test_uuid',
                 worker_data_url: `${mockServerUrl}/worker_data_url`,
             },
             event_type: extraction_1.EventType.StartExtractingData,

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

@@ -0,0 +1,29 @@
+import { RequestInfo, RouteConfig } from './mock-server.interfaces';
+export declare const MOCK_SERVER_DEFAULT_URL = "http://localhost:0";
+/**
+ * Mocks internal AirSync endpoints in tests, with per-test route
+ * configuration to simulate different response scenarios.
+ */
+export declare class MockServer {
+    private server;
+    private internalPort;
+    port: number;
+    baseUrl: string;
+    private routeHandlers;
+    private requests;
+    private requestCounts;
+    constructor(port?: number);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleRequest;
+    /** Falls back to { success: true } for routes not explicitly set. */
+    private defaultRouteHandler;
+    private getRouteKey;
+    setRoute(config: RouteConfig): void;
+    /** Restores default handlers and clears request tracking data. */
+    resetRoutes(): void;
+    getLastRequest(): RequestInfo | undefined;
+    getRequestCount(method: string, path: string): number;
+    getRequests(method: string, path: string): RequestInfo[];
+}
+//# sourceMappingURL=mock-server.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,48 @@
+import { IncomingMessage, ServerResponse } from 'http';
+export declare const DEFAULT_MOCK_SERVER_PORT = 3001;
+export interface ParsedRequest extends IncomingMessage {
+    /** URL path without query string */
+    path: string;
+    /** Parsed JSON body (if any) */
+    body?: unknown;
+}
+export interface MockResponse extends ServerResponse {
+    set(headers: Record<string, string>): MockResponse;
+    status(code: number): MockResponse;
+    json(data: unknown): void;
+    buffer(data: Buffer): void;
+    send(): void;
+}
+/** Simulates failures before succeeding. */
+export interface RetryConfig {
+    /** Failures before success (default: 4) */
+    failureCount?: number;
+    /** Status code during failures (default: 500) */
+    errorStatus?: number;
+    errorBody?: unknown;
+    headers?: Record<string, string>;
+    /** Delay in ms before each failure response */
+    delay?: number;
+}
+export interface RouteConfig {
+    path: string;
+    method: string;
+    status: number;
+    body?: unknown;
+    /** Raw binary body, e.g. gzipped JSONL (takes precedence over `body`) */
+    bodyBuffer?: Buffer;
+    headers?: Record<string, string>;
+    retry?: RetryConfig;
+    /** Delay in ms before sending the response */
+    delay?: number;
+}
+export type RouteHandler = (req: ParsedRequest, res: MockResponse) => unknown;
+export interface RequestInfo {
+    method: string;
+    url: string;
+    body?: unknown;
+}
+export type RouteHandlers = Map<string, RouteHandler>;
+/** 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

@@ -0,0 +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,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/{mock-server → testing}/mock-server.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MockServer = void 0;
+exports.MockServer = exports.MOCK_SERVER_DEFAULT_URL = void 0;
 const http_1 = require("http");
 const mock_server_interfaces_1 = require("./mock-server.interfaces");
+// 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 = [];
@@ -36,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;
@@ -56,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();
@@ -63,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) {
@@ -134,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({
@@ -170,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);
@@ -212,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 {
@@ -224,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 {
@@ -242,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() &&