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

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

@@ -1,8 +1,11 @@
 import { InitialDomainMapping } from '../types/common';
 import { AirSyncEvent } from '../types/extraction';
 import { FileToLoad } from '../types/loading';
-import { WorkerAdapterOptions } from '../types/workers';
+import { RuntimeOptions } from '../types/workers';
+import { Artifact } from '../uploader/uploader.interfaces';
 export interface SdkState {
+    lastSyncStarted?: string;
+    lastSuccessfulSyncStarted?: string;
     pendingWorkersOldest?: string;
     pendingWorkersNewest?: string;
     workersOldest?: string;
@@ -11,12 +14,16 @@ export interface SdkState {
     fromDevRev?: FromDevRev;
     snapInVersionId?: string;
 }
+export declare const STATE_VERSION = 2;
 /** v2 on-disk state shape: SDK bookkeeping kept disjoint from connector keys. */
 export interface AdapterStateEnvelope<ConnectorState> {
+    stateVersion: typeof STATE_VERSION;
     connectorState: ConnectorState;
     sdkState: SdkState;
 }
 export interface ToDevRev {
+    /** SSOR artifacts from earlier phases, reported with ATTACHMENT_EXTRACTION_DONE. */
+    deferredSsorArtifacts?: Artifact[];
     attachmentsMetadata: {
         artifactIds: string[];
         lastProcessed: number;
@@ -40,15 +47,18 @@ export interface StateInterface<ConnectorState> {
     event: AirSyncEvent;
     initialState: ConnectorState;
     initialDomainMapping?: InitialDomainMapping;
-    options?: WorkerAdapterOptions;
+    options?: RuntimeOptions;
 }
 export declare const extractionSdkState: {
+    lastSyncStarted: string;
+    lastSuccessfulSyncStarted: string;
     pendingWorkersOldest: string;
     pendingWorkersNewest: string;
     workersOldest: string;
     workersNewest: string;
     snapInVersionId: string;
     toDevRev: {
+        deferredSsorArtifacts: never[];
         attachmentsMetadata: {
             artifactIds: never[];
             lastProcessed: number;
@@ -62,10 +72,6 @@ export declare const loadingSdkState: {
         filesToLoad: never[];
     };
 };
-/**
- * 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.
- */
+/** SDK-owned top-level state keys, used to split a flat v1 blob during migration. */
 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,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"}
+{"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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,MAAM,WAAW,QAAQ;IAGvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,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,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,iFAAiF;AACjF,MAAM,WAAW,oBAAoB,CAAC,cAAc;IAClD,YAAY,EAAE,OAAO,aAAa,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnC,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,cAAc,CAAC;CAC1B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAgB9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAGhD,CAAC"}

package/dist/state/state.interfaces.js

@@ -1,18 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1_SDK_STATE_KEYS = exports.loadingSdkState = exports.extractionSdkState = exports.ProcessedAttachmentStatus = void 0;
+exports.V1_SDK_STATE_KEYS = exports.loadingSdkState = exports.extractionSdkState = exports.ProcessedAttachmentStatus = exports.STATE_VERSION = void 0;
+exports.STATE_VERSION = 2;
 var ProcessedAttachmentStatus;
 (function (ProcessedAttachmentStatus) {
     ProcessedAttachmentStatus["Success"] = "success";
     ProcessedAttachmentStatus["Failed"] = "failed";
 })(ProcessedAttachmentStatus || (exports.ProcessedAttachmentStatus = ProcessedAttachmentStatus = {}));
 exports.extractionSdkState = {
+    lastSyncStarted: '',
+    lastSuccessfulSyncStarted: '',
     pendingWorkersOldest: '',
     pendingWorkersNewest: '',
     workersOldest: '',
     workersNewest: '',
     snapInVersionId: '',
     toDevRev: {
+        deferredSsorArtifacts: [],
         attachmentsMetadata: {
             artifactIds: [],
             lastProcessed: 0,
@@ -26,14 +30,8 @@ exports.loadingSdkState = {
         filesToLoad: [],
     },
 };
-/**
- * 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.
- */
+/** SDK-owned top-level state keys, used to split a flat v1 blob during migration. */
 exports.V1_SDK_STATE_KEYS = new Set([
     ...Object.keys(exports.extractionSdkState),
     ...Object.keys(exports.loadingSdkState),
-    'lastSyncStarted',
-    'lastSuccessfulSyncStarted',
 ]);

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":"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"}
+{"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,CAsER"}

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

@@ -80,7 +80,8 @@ function resolveTimeValue(timeValue, state) {
         }
         case extraction_1.TimeValueType.WORKERS_NEWEST: {
             if (!state.workersNewest) {
-                return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+                // State from before workers boundaries existed only has the sync start.
+                return state.lastSuccessfulSyncStarted || constants_1.UNBOUNDED_DATE_TIME_VALUE;
             }
             return state.workersNewest;
         }
@@ -98,7 +99,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) {
-                return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+                return state.lastSuccessfulSyncStarted || constants_1.UNBOUNDED_DATE_TIME_VALUE;
             }
             return applyDuration(state.workersNewest, timeValue.value, 'add');
         }

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,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"}
+{"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,CAuEd"}

package/dist/testing/mock-event.js

@@ -50,17 +50,12 @@ function createMockEvent(mockServerUrl = mock_server_1.MOCK_SERVER_DEFAULT_URL,
             },
             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,12 +67,9 @@ function createMockEvent(mockServerUrl = mock_server_1.MOCK_SERVER_DEFAULT_URL,
                 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

@@ -23,6 +23,8 @@ export declare class MockServer {
     /** Restores default handlers and clears request tracking data. */
     resetRoutes(): void;
     getLastRequest(): RequestInfo | undefined;
+    /** POST requests to the platform callback URL, i.e. emitted events. */
+    getCallbackRequests(): RequestInfo[];
     getRequestCount(method: string, path: string): number;
     getRequests(method: string, path: string): RequestInfo[];
 }

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;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"}
+{"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;IA+G1C,kEAAkE;IAC3D,WAAW,IAAI,IAAI;IAMnB,cAAc,IAAI,WAAW,GAAG,SAAS;IAOhD,uEAAuE;IAChE,mBAAmB,IAAI,WAAW,EAAE;IAOpC,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

@@ -33,6 +33,12 @@ export interface RouteConfig {
     bodyBuffer?: Buffer;
     headers?: Record<string, string>;
     retry?: RetryConfig;
+    /** Succeed for the first `successCount` requests, then fail (partial-upload scenarios). */
+    succeedThenFail?: {
+        successCount: number;
+        errorStatus?: number;
+        errorBody?: unknown;
+    };
     /** Delay in ms before sending the response */
     delay?: number;
 }

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,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"}
+{"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,2FAA2F;IAC3F,eAAe,CAAC,EAAE;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,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

@@ -168,19 +168,46 @@ class MockServer {
         return `${method.toUpperCase()}:${path}`;
     }
     setRoute(config) {
-        const { path, method, status, body, bodyBuffer, retry, headers, delay } = config;
+        const { path, method, status, body, bodyBuffer, retry, succeedThenFail, headers, delay, } = config;
         const key = this.getRouteKey(method, path);
-        if (retry) {
+        if (retry || succeedThenFail) {
             this.requestCounts.set(key, 0);
         }
         this.routeHandlers.set(key, (req, res) => {
             const sendResponse = (responseDelay) => {
                 const send = () => {
-                    var _a, _b;
-                    if (retry) {
+                    var _a, _b, _c;
+                    if (succeedThenFail) {
                         const currentCount = this.requestCounts.get(key) || 0;
-                        const failureCount = (_a = retry.failureCount) !== null && _a !== void 0 ? _a : 4;
-                        const errorStatus = (_b = retry.errorStatus) !== null && _b !== void 0 ? _b : 500;
+                        this.requestCounts.set(key, currentCount + 1);
+                        if (currentCount < succeedThenFail.successCount) {
+                            if (headers) {
+                                res.set(headers);
+                            }
+                            if (bodyBuffer !== undefined) {
+                                res.status(status).buffer(bodyBuffer);
+                            }
+                            else if (body !== undefined) {
+                                res.status(status).json(body);
+                            }
+                            else {
+                                this.defaultRouteHandler(req, res);
+                            }
+                        }
+                        else {
+                            const errorStatus = (_a = succeedThenFail.errorStatus) !== null && _a !== void 0 ? _a : 400;
+                            if (succeedThenFail.errorBody !== undefined) {
+                                res.status(errorStatus).json(succeedThenFail.errorBody);
+                            }
+                            else {
+                                res.status(errorStatus).send();
+                            }
+                        }
+                    }
+                    else if (retry) {
+                        const currentCount = this.requestCounts.get(key) || 0;
+                        const failureCount = (_b = retry.failureCount) !== null && _b !== void 0 ? _b : 4;
+                        const errorStatus = (_c = retry.errorStatus) !== null && _c !== void 0 ? _c : 500;
                         if (currentCount < failureCount) {
                             this.requestCounts.set(key, currentCount + 1);
                             const sendFailure = () => {
@@ -254,6 +281,10 @@ class MockServer {
         }
         return this.requests[this.requests.length - 1];
     }
+    /** POST requests to the platform callback URL, i.e. emitted events. */
+    getCallbackRequests() {
+        return this.requests.filter((req) => req.method.toUpperCase() === 'POST' && req.url.includes('callback_url'));
+    }
     getRequestCount(method, path) {
         return this.getRequests(method, path).length;
     }

package/dist/testing/test-adapters.d.ts

@@ -0,0 +1,22 @@
+import { ExtractionAdapter } from '../multithreading/adapters/extraction-adapter';
+import { LoadingAdapter } from '../multithreading/adapters/loading-adapter';
+import { AirSyncEvent } from '../types/extraction';
+import { FileToLoad } from '../types/loading';
+import { SpawnOptions } from '../types/workers';
+export interface TestAdapterParams<ConnectorState> {
+    event: AirSyncEvent;
+    initialState: ConnectorState;
+    options?: SpawnOptions;
+}
+export interface TestLoadingAdapterParams<ConnectorState> extends TestAdapterParams<ConnectorState> {
+    /** Transformer files to resume from, as if a START_* event had set them. */
+    filesToLoad?: FileToLoad[];
+}
+/**
+ * Builds an extraction adapter for connector tests without fetching state.
+ * Platform calls still go to the event's URLs; point them at a MockServer.
+ */
+export declare function createTestExtractionAdapter<ConnectorState>({ event, initialState, options, }: TestAdapterParams<ConnectorState>): ExtractionAdapter<ConnectorState>;
+/** Loading counterpart of {@link createTestExtractionAdapter}. */
+export declare function createTestLoadingAdapter<ConnectorState>({ event, initialState, filesToLoad, options, }: TestLoadingAdapterParams<ConnectorState>): LoadingAdapter<ConnectorState>;
+//# sourceMappingURL=test-adapters.d.ts.map

package/dist/testing/test-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-adapters.d.ts","sourceRoot":"","sources":["../../src/testing/test-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,WAAW,iBAAiB,CAAC,cAAc;IAC/C,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,cAAc,CAAC;IAC7B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB,CAAC,cAAc,CACtD,SAAQ,iBAAiB,CAAC,cAAc,CAAC;IACzC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,EAC1D,KAAK,EACL,YAAY,EACZ,OAAO,GACR,EAAE,iBAAiB,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAOvE;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,EACvD,KAAK,EACL,YAAY,EACZ,WAAW,EACX,OAAO,GACR,EAAE,wBAAwB,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC,cAAc,CAAC,CAU3E"}

package/dist/testing/test-adapters.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestExtractionAdapter = createTestExtractionAdapter;
+exports.createTestLoadingAdapter = createTestLoadingAdapter;
+const extraction_adapter_1 = require("../multithreading/adapters/extraction-adapter");
+const loading_adapter_1 = require("../multithreading/adapters/loading-adapter");
+const extraction_state_1 = require("../state/extraction-state");
+const loading_state_1 = require("../state/loading-state");
+/**
+ * Builds an extraction adapter for connector tests without fetching state.
+ * Platform calls still go to the event's URLs; point them at a MockServer.
+ */
+function createTestExtractionAdapter({ event, initialState, options, }) {
+    const adapterState = new extraction_state_1.ExtractionState({
+        event,
+        initialState,
+        options,
+    });
+    return new extraction_adapter_1.ExtractionAdapter({ event, adapterState, options });
+}
+/** Loading counterpart of {@link createTestExtractionAdapter}. */
+function createTestLoadingAdapter({ event, initialState, filesToLoad, options, }) {
+    const adapterState = new loading_state_1.LoadingState({
+        event,
+        initialState,
+        options,
+    });
+    if (filesToLoad) {
+        adapterState.sdkState.fromDevRev = { filesToLoad };
+    }
+    return new loading_adapter_1.LoadingAdapter({ event, adapterState, options });
+}

package/dist/types/common.d.ts

@@ -1,11 +1,14 @@
+import { AirSyncErrorCode } from './errors';
 export interface ErrorRecord {
     message: string;
+    /** Platform-recognized condition; when set, it replaces the wire message. */
+    code?: AirSyncErrorCode;
 }
 export interface InitialDomainMapping {
     starting_recipe_blueprint?: object;
     additional_mappings?: object;
 }
-/** INITIAL = first import, INCREMENTAL = subsequent syncs, LOADING = DevRev -> external system. */
+/** INITIAL = first import, INCREMENTAL = subsequent syncs, LOADING = DevRev to 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,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"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;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,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncMode = void 0;
-/** INITIAL = first import, INCREMENTAL = subsequent syncs, LOADING = DevRev -> external system. */
+/** INITIAL = first import, INCREMENTAL = subsequent syncs, LOADING = DevRev to external system. */
 var SyncMode;
 (function (SyncMode) {
     SyncMode["INITIAL"] = "INITIAL";

package/dist/types/errors.d.ts

@@ -1,9 +1,15 @@
-export declare const enum ExtractionCommonError {
-    EXTERNAL_SYNC_UNIT_DELETED = "ERROR_CODE=EXTERNAL_SYNC_UNIT_DELETED",
-    EXTERNAL_SYNC_UNIT_DEACTIVATED = "ERROR_CODE=EXTERNAL_SYNC_UNIT_DEACTIVATED",
-    USER_DELETED = "ERROR_CODE=USER_DELETED",
-    EXTERNAL_SYSTEM_NO_ACCESS = "ERROR_CODE=EXTERNAL_SYSTEM_NO_ACCESS",
-    EXTERNAL_SYSTEM_NO_PERMISSION = "ERROR_CODE=EXTERNAL_SYSTEM_NO_PERMISSION",
-    HISTORICAL_DATA_EXTRACTION_DONE = "ERROR_CODE=HISTORICAL_DATA_EXTRACTION_DONE"
+/**
+ * Error codes the platform reacts to (e.g. stopping periodic syncs). Set them
+ * on `ErrorRecord.code`; the platform matches the code exactly, so the SDK
+ * sends it as the whole wire message.
+ */
+export declare enum AirSyncErrorCode {
+    EXTERNAL_SYNC_UNIT_DELETED = "EXTERNAL_SYNC_UNIT_DELETED",
+    EXTERNAL_SYNC_UNIT_DEACTIVATED = "EXTERNAL_SYNC_UNIT_DEACTIVATED",
+    USER_DELETED = "USER_DELETED",
+    EXTERNAL_SYSTEM_NO_ACCESS = "EXTERNAL_SYSTEM_NO_ACCESS",
+    EXTERNAL_SYSTEM_NO_PERMISSION = "EXTERNAL_SYSTEM_NO_PERMISSION",
+    HISTORICAL_DATA_EXTRACTION_DONE = "HISTORICAL_DATA_EXTRACTION_DONE"
 }
+export declare function formatErrorCode(code: AirSyncErrorCode): string;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAGA,0BAAkB,qBAAqB;IAIrC,0BAA0B,0CAAgE;IAC1F,8BAA8B,8CAAoE;IAClG,YAAY,4BAAkD;IAG9D,yBAAyB,yCAA+D;IAExF,6BAA6B,6CAAmE;IAEhG,+BAA+B,+CAAqE;CACrG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,oBAAY,gBAAgB;IAG1B,0BAA0B,+BAA+B;IACzD,8BAA8B,mCAAmC;IACjE,YAAY,iBAAiB;IAG7B,yBAAyB,8BAA8B;IAEvD,6BAA6B,kCAAkC;IAE/D,+BAA+B,oCAAoC;CACpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAE9D"}

package/dist/types/errors.js

@@ -1,4 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirSyncErrorCode = void 0;
+exports.formatErrorCode = formatErrorCode;
 const ERROR_PREFIX = 'ERROR_CODE';
 const ERROR_DELIMITER = '=';
+/**
+ * Error codes the platform reacts to (e.g. stopping periodic syncs). Set them
+ * on `ErrorRecord.code`; the platform matches the code exactly, so the SDK
+ * sends it as the whole wire message.
+ */
+var AirSyncErrorCode;
+(function (AirSyncErrorCode) {
+    // Persistent conditions (system deleted, deactivated, access permanently
+    // revoked) that require stopping periodic syncs, not transient failures.
+    AirSyncErrorCode["EXTERNAL_SYNC_UNIT_DELETED"] = "EXTERNAL_SYNC_UNIT_DELETED";
+    AirSyncErrorCode["EXTERNAL_SYNC_UNIT_DEACTIVATED"] = "EXTERNAL_SYNC_UNIT_DEACTIVATED";
+    AirSyncErrorCode["USER_DELETED"] = "USER_DELETED";
+    // Could not find an accessible resource in the source system.
+    AirSyncErrorCode["EXTERNAL_SYSTEM_NO_ACCESS"] = "EXTERNAL_SYSTEM_NO_ACCESS";
+    // The user is missing a required permission.
+    AirSyncErrorCode["EXTERNAL_SYSTEM_NO_PERMISSION"] = "EXTERNAL_SYSTEM_NO_PERMISSION";
+    // The historical periodic sync reached the end; nothing left to extract.
+    AirSyncErrorCode["HISTORICAL_DATA_EXTRACTION_DONE"] = "HISTORICAL_DATA_EXTRACTION_DONE";
+})(AirSyncErrorCode || (exports.AirSyncErrorCode = AirSyncErrorCode = {}));
+function formatErrorCode(code) {
+    return `${ERROR_PREFIX}${ERROR_DELIMITER}${code}`;
+}

package/dist/types/extraction.d.ts

@@ -1,13 +1,13 @@
-import { InputData } from '@devrev/typescript-sdk/dist/snap-ins';
 import { ExtractionAdapter } from '../multithreading/adapters/extraction-adapter';
 import { NormalizedAttachment } from '../repo/repo.interfaces';
 import { Artifact } from '../uploader/uploader.interfaces';
 import { ErrorRecord } from './common';
-import { DonV2, LoaderReport, RateLimited } from './loading';
+import { DonV2, LoaderReport } from './loading';
 /** Events sent from AirSync to the connector. */
 export declare enum EventType {
     StartExtractingExternalSyncUnits = "START_EXTRACTING_EXTERNAL_SYNC_UNITS",
     StartExtractingMetadata = "START_EXTRACTING_METADATA",
+    ContinueExtractingMetadata = "CONTINUE_EXTRACTING_METADATA",
     StartExtractingData = "START_EXTRACTING_DATA",
     ContinueExtractingData = "CONTINUE_EXTRACTING_DATA",
     StartDeletingExtractorState = "START_DELETING_EXTRACTOR_STATE",
@@ -25,6 +25,8 @@ export declare enum EventType {
 export declare enum ExtractorEventType {
     ExternalSyncUnitExtractionDone = "EXTERNAL_SYNC_UNIT_EXTRACTION_DONE",
     ExternalSyncUnitExtractionError = "EXTERNAL_SYNC_UNIT_EXTRACTION_ERROR",
+    MetadataExtractionProgress = "METADATA_EXTRACTION_PROGRESS",
+    MetadataExtractionDelayed = "METADATA_EXTRACTION_DELAYED",
     MetadataExtractionDone = "METADATA_EXTRACTION_DONE",
     MetadataExtractionError = "METADATA_EXTRACTION_ERROR",
     DataExtractionProgress = "DATA_EXTRACTION_PROGRESS",
@@ -85,33 +87,29 @@ export interface TimeValue {
 }
 export interface EventContext {
     callback_url: string;
-    /** @deprecated Use dev_oid instead. */
-    dev_org: string;
     dev_oid: string;
     dev_org_id: string;
-    /** @deprecated Use dev_uid instead. */
-    dev_user: string;
-    /** @deprecated Use dev_uid instead. */
-    dev_user_id: string;
     dev_uid: string;
     event_type_adaas: string;
-    /** @deprecated Use external_sync_unit_id instead. */
-    external_sync_unit: string;
     external_sync_unit_id: string;
     external_sync_unit_name: string;
-    /** @deprecated Use external_system_id instead. */
-    external_system: string;
     external_system_id: string;
     external_system_name: string;
     external_system_type: string;
-    /** Start of extraction (ISO 8601), resolved by the SDK from extraction_start_time and worker state. */
+    /**
+     * Start of extraction (ISO 8601): resolved by the SDK from
+     * extraction_start_time and worker state, or on platforms that don't send it,
+     * the last successful sync start / the platform-supplied value.
+     */
     extract_from?: string;
+    /** The platform-supplied extract_from, kept when the SDK overrides it. */
+    original_extract_from?: string;
     import_slug: string;
     initial_sync_scope?: InitialSyncScope;
     mode: string;
     request_id: string;
     request_id_adaas: string;
-    /** @deprecated */
+    /** @deprecated Never read by the SDK; kept because connectors still branch on it. */
     reset_extraction?: boolean;
     /** @deprecated Use extraction_start_time/extraction_end_time (resolved into extract_from/extract_to). */
     reset_extract_from?: boolean;
@@ -119,15 +117,9 @@ export interface EventContext {
     sequence_version: string;
     snap_in_slug: string;
     snap_in_version_id: string;
-    /** @deprecated Use run_id instead. */
-    sync_run: string;
-    /** @deprecated Use run_id instead. */
-    sync_run_id: string;
     sync_tier: string;
     sync_unit: DonV2;
     sync_unit_id: string;
-    /** @deprecated Use request_id_adaas instead. */
-    uuid: string;
     worker_data_url: string;
     /** Platform-sent start time; the SDK resolves it into extract_from. */
     extraction_start_time?: TimeValue;
@@ -142,6 +134,17 @@ export interface ConnectionData {
     key: string;
     key_type: string;
 }
+/** Sync-duration-estimation model input that a counted record type feeds into. */
+export declare enum ItemInputType {
+    MAIN = "main",
+    USERS = "users"
+}
+/** Per-record-type count reported during the metadata phase, used for sync-duration estimation. */
+export interface ItemTypeCount {
+    record_type: string;
+    count: number;
+    model_input_type: ItemInputType;
+}
 export interface EventData {
     error?: ErrorRecord;
     delay?: number;
@@ -154,6 +157,11 @@ export interface EventData {
     reports?: LoaderReport[];
     processed_files?: string[];
     stats_file?: string;
+    /**
+     * Per-record-type counts attached to the metadata-done event by the SDK when
+     * the connector sets ExtractionAdapter.preExtractionItemCounts.
+     */
+    pre_extraction_item_counts?: ItemTypeCount[];
 }
 export interface WorkerMetadata {
     adaas_library_version?: string;
@@ -188,6 +196,14 @@ export interface AirSyncEvent {
     };
     input_data: InputData;
 }
+/** Snap-in inputs passed with every event. */
+export interface InputData {
+    /** Snap-in globals; values arrive as strings. */
+    global_values: Record<string, string>;
+    event_sources: Record<string, string>;
+    /** Keyrings, tags and other manifest resources, keyed by resource name. */
+    resources?: Record<string, any>;
+}
 export interface AirSyncMessage {
     connection_data: ConnectionData;
     event_context: EventContext;
@@ -201,12 +217,6 @@ export interface ExtractorEvent {
     event_data?: EventData;
     worker_metadata?: WorkerMetadata;
 }
-export interface LoaderEvent {
-    event_type: string;
-    event_context: EventContext;
-    event_data?: EventData;
-    worker_metadata?: WorkerMetadata;
-}
 export type ExternalSystemAttachmentStreamingFunction = ({ item, event, }: ExternalSystemAttachmentStreamingParams) => Promise<ExternalSystemAttachmentStreamingResponse>;
 export interface ExternalSystemAttachmentStreamingParams {
     item: NormalizedAttachment;
@@ -216,27 +226,33 @@ export interface HttpStreamResponse {
     data: any;
     headers: Record<string, any>;
 }
-export interface ExternalSystemAttachmentStreamingResponse {
-    httpStream?: HttpStreamResponse;
-    error?: ErrorRecord;
-    delay?: number;
-}
-export interface StreamAttachmentsResponse {
-    error?: ErrorRecord;
-    report?: LoaderReport;
-    rateLimit?: RateLimited;
-}
+/** Returned by the connector's attachment `stream` function. */
+export type ExternalSystemAttachmentStreamingResponse = {
+    status: 'success';
+    httpStream: HttpStreamResponse;
+} | {
+    status: 'delay';
+    delaySeconds: number;
+} | {
+    status: 'error';
+    error: ErrorRecord;
+};
+/**
+ * Outcome of streaming one attachment. `success` is also returned when the
+ * soft timeout cut the upload short; the attachment is then retried in the
+ * next invocation, so check `adapter.isTimeout` before recording it as done.
+ */
 export type ProcessAttachmentReturnType = {
-    delay?: number;
-    error?: {
-        message: string;
+    status: 'success';
+} | {
+    status: 'delay';
+    delaySeconds: number;
+} | {
+    status: 'error';
+    error: ErrorRecord & {
         fileSize?: number;
     };
-} | undefined;
-export type StreamAttachmentsReturnType = {
-    delay?: number;
-    error?: ErrorRecord;
-} | undefined;
+};
 export type ExternalSystemAttachmentReducerFunction<Batch, NewBatch, ConnectorState> = ({ attachments, adapter, batchSize, }: {
     attachments: Batch;
     adapter: ExtractionAdapter<ConnectorState>;