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

package/dist/mappers/mappers.d.ts

@@ -1,5 +1,4 @@
-import { AxiosResponse } from 'axios';
-import { MappersCreateParams, MappersCreateResponse, MappersFactoryInterface, MappersGetByExternalIdParams, MappersGetByExternalIdResponse, MappersGetByTargetIdParams, MappersGetByTargetIdResponse, MappersUpdateParams, MappersUpdateResponse } from './mappers.interface';
+import { MappersCreateParams, MappersCreateResponse, MappersFactoryInterface, MappersGetByExternalIdParams, MappersGetByExternalIdResponse, MappersGetByTargetIdParams, MappersGetByTargetIdResponse, MappersUpdateParams, MappersUpdateResponse } from './mappers.interfaces';
 /**
  * Manages sync mapper records that link external system items to DevRev items.
  *
@@ -15,18 +14,18 @@ export declare class Mappers {
      * Used to find the mapping when you know the DevRev ID and want to find the external system ID.
      *
      * @param params - Query parameters of type MappersGetByTargetIdParams
-     * @returns Promise with response data containing the sync mapper record
+     * @returns Promise resolving to the sync mapper record
      */
-    getByTargetId(params: MappersGetByTargetIdParams): Promise<AxiosResponse<MappersGetByTargetIdResponse>>;
+    getByTargetId(params: MappersGetByTargetIdParams): Promise<MappersGetByTargetIdResponse>;
     /**
      * Retrieves a sync mapper record by external system ID.
      *
      * Used to find the mapping when you know the external system ID and want to find the DevRev ID.
      *
      * @param params - Query parameters of type MappersGetByExternalIdParams
-     * @returns Promise with response data containing the sync mapper record
+     * @returns Promise resolving to the sync mapper record
      */
-    getByExternalId(params: MappersGetByExternalIdParams): Promise<AxiosResponse<MappersGetByExternalIdResponse>>;
+    getByExternalId(params: MappersGetByExternalIdParams): Promise<MappersGetByExternalIdResponse>;
     /**
      * Creates a new sync mapper record to establish a relationship between external system
      * entities and DevRev entities.
@@ -35,9 +34,9 @@ export declare class Mappers {
      * the mapping for future synchronization operations.
      *
      * @param params - Creation parameters of type MappersCreateParams
-     * @returns Promise with response data containing the created sync mapper record
+     * @returns Promise resolving to the created sync mapper record
      */
-    create(params: MappersCreateParams): Promise<AxiosResponse<MappersCreateResponse>>;
+    create(params: MappersCreateParams): Promise<MappersCreateResponse>;
     /**
      * Updates an existing sync mapper record.
      *
@@ -45,8 +44,8 @@ export declare class Mappers {
      * additional DevRev entities need to be associated.
      *
      * @param params - Update parameters of type MappersUpdateParams
-     * @returns Promise with response data containing the updated sync mapper record
+     * @returns Promise resolving to the updated sync mapper record
      */
-    update(params: MappersUpdateParams): Promise<AxiosResponse<MappersUpdateResponse>>;
+    update(params: MappersUpdateParams): Promise<MappersUpdateResponse>;
 }
 //# sourceMappingURL=mappers.d.ts.map

package/dist/mappers/mappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../../src/mappers/mappers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAS;gBAEnB,EAAE,KAAK,EAAE,EAAE,uBAAuB;IAK9C;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC;IAavD;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,aAAa,CAAC,8BAA8B,CAAC,CAAC;IAazD;;;;;;;;;OASG;IACG,MAAM,CACV,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAYhD;;;;;;;;OAQG;IACG,MAAM,CACV,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;CAWjD"}
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../../src/mappers/mappers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAS;gBAEnB,EAAE,KAAK,EAAE,EAAE,uBAAuB;IAK9C;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,4BAA4B,CAAC;IAcxC;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,8BAA8B,CAAC;IAc1C;;;;;;;;;OASG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAazE;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAY1E"}

package/dist/mappers/{mappers.interface.d.ts → mappers.interfaces.d.ts}

@@ -1,4 +1,4 @@
-import { AirSyncEvent } from '../types';
+import { AirSyncEvent } from '../types/extraction';
 import { DonV2 } from '../types/loading';
 import { WorkerAdapterOptions } from '../types/workers';
 /**
@@ -262,9 +262,9 @@ export interface MappersGetByExternalIdParams {
 export declare enum SyncMapperRecordTargetType {
     ACCESS_CONTROL_ENTRY = "access_control_entry",
     ACCOUNT = "account",
-    AIRSYNC_AUTHORIZATION_POLICY = "airdrop_authorization_policy",
-    AIRSYNC_FIELD_AUTHORIZATION_POLICY = "airdrop_field_authorization_policy",
-    AIRSYNC_PLATFORM_GROUP = "airdrop_platform_group",
+    AIRDROP_AUTHORIZATION_POLICY = "airdrop_authorization_policy",
+    AIRDROP_FIELD_AUTHORIZATION_POLICY = "airdrop_field_authorization_policy",
+    AIRDROP_PLATFORM_GROUP = "airdrop_platform_group",
     ARTICLE = "article",
     ARTIFACT = "artifact",
     CHAT = "chat",
@@ -291,4 +291,4 @@ export declare enum SyncMapperRecordTargetType {
 export interface MappersGetByExternalIdResponse {
     sync_mapper_record: SyncMapperRecord;
 }
-//# sourceMappingURL=mappers.interface.d.ts.map
+//# sourceMappingURL=mappers.interfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.interfaces.d.ts","sourceRoot":"","sources":["../../src/mappers/mappers.interfaces.ts"],"names":[],"mappings":"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"}

package/dist/mappers/{mappers.interface.js → mappers.interfaces.js}

@@ -23,9 +23,9 @@ var SyncMapperRecordTargetType;
 (function (SyncMapperRecordTargetType) {
     SyncMapperRecordTargetType["ACCESS_CONTROL_ENTRY"] = "access_control_entry";
     SyncMapperRecordTargetType["ACCOUNT"] = "account";
-    SyncMapperRecordTargetType["AIRSYNC_AUTHORIZATION_POLICY"] = "airdrop_authorization_policy";
-    SyncMapperRecordTargetType["AIRSYNC_FIELD_AUTHORIZATION_POLICY"] = "airdrop_field_authorization_policy";
-    SyncMapperRecordTargetType["AIRSYNC_PLATFORM_GROUP"] = "airdrop_platform_group";
+    SyncMapperRecordTargetType["AIRDROP_AUTHORIZATION_POLICY"] = "airdrop_authorization_policy";
+    SyncMapperRecordTargetType["AIRDROP_FIELD_AUTHORIZATION_POLICY"] = "airdrop_field_authorization_policy";
+    SyncMapperRecordTargetType["AIRDROP_PLATFORM_GROUP"] = "airdrop_platform_group";
     SyncMapperRecordTargetType["ARTICLE"] = "article";
     SyncMapperRecordTargetType["ARTIFACT"] = "artifact";
     SyncMapperRecordTargetType["CHAT"] = "chat";

package/dist/mappers/mappers.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Mappers = void 0;
-const axios_client_internal_1 = require("../http/axios-client-internal");
+const client_1 = require("../http/client");
 /**
  * Manages sync mapper records that link external system items to DevRev items.
  *
@@ -18,16 +18,17 @@ class Mappers {
      * Used to find the mapping when you know the DevRev ID and want to find the external system ID.
      *
      * @param params - Query parameters of type MappersGetByTargetIdParams
-     * @returns Promise with response data containing the sync mapper record
+     * @returns Promise resolving to the sync mapper record
      */
     async getByTargetId(params) {
         const { sync_unit, target } = params;
-        return axios_client_internal_1.axiosClient.get(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.get-by-target`, {
+        const response = await client_1.axiosClient.get(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.get-by-target`, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
             params: { sync_unit, target },
         });
+        return response.data;
     }
     /**
      * Retrieves a sync mapper record by external system ID.
@@ -35,16 +36,17 @@ class Mappers {
      * Used to find the mapping when you know the external system ID and want to find the DevRev ID.
      *
      * @param params - Query parameters of type MappersGetByExternalIdParams
-     * @returns Promise with response data containing the sync mapper record
+     * @returns Promise resolving to the sync mapper record
      */
     async getByExternalId(params) {
         const { sync_unit, external_id, target_type } = params;
-        return axios_client_internal_1.axiosClient.get(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.get-by-external-id`, {
+        const response = await client_1.axiosClient.get(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.get-by-external-id`, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
             params: { sync_unit, external_id, target_type },
         });
+        return response.data;
     }
     /**
      * Creates a new sync mapper record to establish a relationship between external system
@@ -54,14 +56,15 @@ class Mappers {
      * the mapping for future synchronization operations.
      *
      * @param params - Creation parameters of type MappersCreateParams
-     * @returns Promise with response data containing the created sync mapper record
+     * @returns Promise resolving to the created sync mapper record
      */
     async create(params) {
-        return axios_client_internal_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.create`, params, {
+        const response = await client_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.create`, params, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
         });
+        return response.data;
     }
     /**
      * Updates an existing sync mapper record.
@@ -70,14 +73,15 @@ class Mappers {
      * additional DevRev entities need to be associated.
      *
      * @param params - Update parameters of type MappersUpdateParams
-     * @returns Promise with response data containing the updated sync mapper record
+     * @returns Promise resolving to the updated sync mapper record
      */
     async update(params) {
-        return axios_client_internal_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.update`, params, {
+        const response = await client_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.update`, params, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
         });
+        return response.data;
     }
 }
 exports.Mappers = Mappers;

package/dist/multithreading/adapters/base-adapter.d.ts

@@ -1,8 +1,8 @@
-import { BaseState } from '../../state/base-state';
-import { BaseSdkState } from '../../state/state.interfaces';
+import { BaseState } from '../../state/state';
+import { SdkState } from '../../state/state.interfaces';
 import { AirSyncEvent, EventData, ExtractorEventType } from '../../types/extraction';
 import { LoaderEventType } from '../../types/loading';
-import { WorkerAdapterOptions } from '../../types/workers';
+import { TaskResult, WorkerAdapterOptions } from '../../types/workers';
 import { Uploader } from '../../uploader/uploader';
 /**
  * BaseAdapter holds the state and behavior shared by both sync modes and owns
@@ -11,22 +11,25 @@ import { Uploader } from '../../uploader/uploader';
  * their own pre-emit work and event payload shaping.
  *
  * @typeParam ConnectorState - the connector-owned state shape
- * @typeParam StateClass - the mode's `BaseState` subclass
  */
-export declare abstract class BaseAdapter<ConnectorState, StateClass extends BaseState<ConnectorState, BaseSdkState>> {
+export declare abstract class BaseAdapter<ConnectorState> {
     readonly event: AirSyncEvent;
     readonly options?: WorkerAdapterOptions;
     isTimeout: boolean;
     hasWorkerEmitted: boolean;
-    protected adapterState: StateClass;
+    protected adapterState: BaseState<ConnectorState>;
     protected uploader: Uploader;
     constructor({ event, adapterState, options, }: {
         event: AirSyncEvent;
-        adapterState: StateClass;
+        adapterState: BaseState<ConnectorState>;
         options?: WorkerAdapterOptions;
     });
+    /** Connector-owned state exposed to snap-in code. */
     get state(): ConnectorState;
     set state(value: ConnectorState);
+    /** SDK-internal bookkeeping state. Used by SDK internals; not for connector use. */
+    get sdkState(): SdkState;
+    get extractionScope(): import("../../types/workers").ExtractionScope;
     postState(): Promise<void>;
     /**
      * Pre-emit hook run before any state is persisted or the event is sent.
@@ -45,12 +48,24 @@ export declare abstract class BaseAdapter<ConnectorState, StateClass extends Bas
      * clears its accumulated artifacts here; loading has nothing to do.
      */
     protected abstract afterEmit(newEventType: ExtractorEventType | LoaderEventType): void;
+    /**
+     * Maps a {@link TaskResult} returned by a worker's task/onTimeout callback to
+     * the phase-appropriate platform event and emits it exactly once.
+     *
+     * This is the SDK-internal bridge between the return-based connector contract
+     * and the control protocol; it is invoked by the worker driver, not by
+     * connectors. Connectors signal outcomes by returning a `TaskResult`, never by
+     * calling `emit` directly.
+     *
+     * @param result - The status the worker reported for the current phase.
+     */
+    emitFromResult(result: TaskResult): Promise<void>;
     /**
      *  Emits an event to the platform.
      *
      * @param newEventType - The event type to be emitted
      * @param data - The data to be sent with the event
      */
-    emit(newEventType: ExtractorEventType | LoaderEventType, data?: EventData): Promise<void>;
+    protected emit(newEventType: ExtractorEventType | LoaderEventType, data?: EventData): Promise<void>;
 }
 //# sourceMappingURL=base-adapter.d.ts.map

package/dist/multithreading/adapters/base-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/base-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EACL,YAAY,EACZ,SAAS,EACT,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,oBAAoB,EAGrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;;;;;;;GAQG;AACH,8BAAsB,WAAW,CAC/B,cAAc,EACd,UAAU,SAAS,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC;IAE1D,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAE1B,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC;IACnC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEjB,EACV,KAAK,EACL,YAAY,EACZ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,UAAU,CAAC;QACzB,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAYD,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,cAAc,EAE9B;IAEK,SAAS;IAMf;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAC3B,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,OAAO,CAAC,IAAI,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CACjC,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,SAAS;IAEZ;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,IAAI;IAEP;;;;;OAKG;IACG,IAAI,CACR,YAAY,EAAE,kBAAkB,GAAG,eAAe,EAClD,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC;CAkEjB"}
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/base-adapter.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,SAAS,EACT,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,UAAU,EACV,oBAAoB,EAGrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD;;;;;;;GAOG;AACH,8BAAsB,WAAW,CAAC,cAAc;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAE1B,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAClD,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEjB,EACV,KAAK,EACL,YAAY,EACZ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAYD,qDAAqD;IACrD,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,cAAc,EAE9B;IAED,oFAAoF;IACpF,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,eAAe,kDAElB;IAEK,SAAS;IAMf;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAC3B,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,OAAO,CAAC,IAAI,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CACjC,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,SAAS;IAEZ;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,IAAI;IAEP;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvD;;;;;OAKG;cACa,IAAI,CAClB,YAAY,EAAE,kBAAkB,GAAG,eAAe,EAClD,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC;CAkEjB"}

package/dist/multithreading/adapters/base-adapter.js

@@ -3,12 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseAdapter = void 0;
 const node_worker_threads_1 = require("node:worker_threads");
 const constants_1 = require("../../common/constants");
-const control_protocol_1 = require("../../common/control-protocol");
-const helpers_1 = require("../../common/helpers");
+const emit_1 = require("../emit");
 const logger_1 = require("../../logger/logger");
-const logger_context_1 = require("../../logger/logger.context");
 const workers_1 = require("../../types/workers");
 const uploader_1 = require("../../uploader/uploader");
+const spawn_helpers_1 = require("../spawn/spawn.helpers");
 /**
  * BaseAdapter holds the state and behavior shared by both sync modes and owns
  * the `emit` control-protocol flow as a template method. Mode-specific adapters
@@ -16,7 +15,6 @@ const uploader_1 = require("../../uploader/uploader");
  * their own pre-emit work and event payload shaping.
  *
  * @typeParam ConnectorState - the connector-owned state shape
- * @typeParam StateClass - the mode's `BaseState` subclass
  */
 class BaseAdapter {
     constructor({ event, adapterState, options, }) {
@@ -30,17 +28,52 @@ class BaseAdapter {
             options,
         });
     }
+    /** Connector-owned state exposed to snap-in code. */
     get state() {
         return this.adapterState.state;
     }
     set state(value) {
         this.adapterState.state = value;
     }
+    /** SDK-internal bookkeeping state. Used by SDK internals; not for connector use. */
+    get sdkState() {
+        return this.adapterState.sdkState;
+    }
+    get extractionScope() {
+        return this.adapterState.extractionScope;
+    }
     async postState() {
-        return (0, logger_context_1.runWithSdkLogContext)(async () => {
+        return (0, logger_1.runWithSdkLogContext)(async () => {
             await this.adapterState.postState();
         });
     }
+    /**
+     * Maps a {@link TaskResult} returned by a worker's task/onTimeout callback to
+     * the phase-appropriate platform event and emits it exactly once.
+     *
+     * This is the SDK-internal bridge between the return-based connector contract
+     * and the control protocol; it is invoked by the worker driver, not by
+     * connectors. Connectors signal outcomes by returning a `TaskResult`, never by
+     * calling `emit` directly.
+     *
+     * @param result - The status the worker reported for the current phase.
+     */
+    async emitFromResult(result) {
+        const { eventType, illegal } = (0, spawn_helpers_1.getEventTypeForResult)(this.event.payload.event_type, result.status);
+        const data = {};
+        if (result.status === 'delay') {
+            data.delay = result.delaySeconds;
+        }
+        else if (result.status === 'error') {
+            data.error = result.error;
+        }
+        else if (illegal) {
+            data.error = {
+                message: `Worker returned status '${result.status}' for a non-resumable phase (${this.event.payload.event_type}), which is not allowed. Emitting an error event instead.`,
+            };
+        }
+        await this.emit(eventType, data);
+    }
     /**
      *  Emits an event to the platform.
      *
@@ -48,7 +81,7 @@ class BaseAdapter {
      * @param data - The data to be sent with the event
      */
     async emit(newEventType, data) {
-        return (0, logger_context_1.runWithSdkLogContext)(async () => {
+        return (0, logger_1.runWithSdkLogContext)(async () => {
             var _a;
             if (this.hasWorkerEmitted) {
                 console.warn(`Trying to emit event with event type: ${newEventType}. Ignoring emit request because it has already been emitted.`);
@@ -79,9 +112,9 @@ class BaseAdapter {
             try {
                 // Always prune error messages to make them shorter before emit
                 if ((_a = data === null || data === void 0 ? void 0 : data.error) === null || _a === void 0 ? void 0 : _a.message) {
-                    data.error.message = (0, helpers_1.truncateMessage)(data.error.message);
+                    data.error.message = (0, logger_1.truncateMessage)(data.error.message);
                 }
-                await (0, control_protocol_1.emit)({
+                await (0, emit_1.emit)({
                     eventType: newEventType,
                     event: this.event,
                     data: Object.assign(Object.assign({}, data), this.buildEmitPayload(newEventType)),

package/dist/multithreading/adapters/extraction-adapter.d.ts

@@ -1,28 +1,27 @@
 import { Repo } from '../../repo/repo';
 import { NormalizedAttachment, RepoInterface } from '../../repo/repo.interfaces';
-import { ExtractionState } from '../../state/extraction-state';
-import { AirSyncEvent, ExternalSystemAttachmentProcessors, ExternalSystemAttachmentStreamingFunction, ExtractorEventType, EventData, ProcessAttachmentReturnType, StreamAttachmentsReturnType } from '../../types/extraction';
+import { AirSyncEvent, EventData, ExternalSystemAttachmentProcessors, ExternalSystemAttachmentStreamingFunction, ExtractorEventType, ProcessAttachmentReturnType } from '../../types/extraction';
 import { LoaderEventType } from '../../types/loading';
-import { WorkerAdapterOptions } from '../../types/workers';
+import { BaseState } from '../../state/state';
+import { TaskResult, WorkerAdapterOptions } from '../../types/workers';
 import { Artifact } from '../../uploader/uploader.interfaces';
 import { BaseAdapter } from './base-adapter';
 /**
  * ExtractionAdapter is the adapter passed to extraction tasks. It exposes the
- * extraction surface (repos, artifacts, attachment streaming) and updates the
- * extraction boundaries before emitting.
+ * extraction surface (repos, artifacts, attachment streaming) and uploads
+ * pending repos and updates the extraction boundaries before emitting.
  *
  * @public
  */
-export declare class ExtractionAdapter<ConnectorState> extends BaseAdapter<ConnectorState, ExtractionState<ConnectorState>> {
+export declare class ExtractionAdapter<ConnectorState> extends BaseAdapter<ConnectorState> {
     private _artifacts;
     private repos;
     private currentEventDataLength;
     constructor(params: {
         event: AirSyncEvent;
-        adapterState: ExtractionState<ConnectorState>;
+        adapterState: BaseState<ConnectorState>;
         options?: WorkerAdapterOptions;
     });
-    get extractionScope(): import("../../types/workers").ExtractionScope;
     /**
      * Returns whether the given item type should be extracted.
      * Defaults to true if the scope is empty or the item type is not listed.
@@ -53,6 +52,6 @@ export declare class ExtractionAdapter<ConnectorState> extends BaseAdapter<Conne
         stream: ExternalSystemAttachmentStreamingFunction;
         processors?: ExternalSystemAttachmentProcessors<ConnectorState, NormalizedAttachment[], NewBatch>;
         batchSize?: number;
-    }): Promise<StreamAttachmentsReturnType>;
+    }): Promise<TaskResult>;
 }
 //# sourceMappingURL=extraction-adapter.d.ts.map

package/dist/multithreading/adapters/extraction-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/extraction-adapter.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,kCAAkC,EAClC,yCAAyC,EACzC,kBAAkB,EAClB,SAAS,EACT,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAkB,MAAM,oCAAoC,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;GAMG;AACH,qBAAa,iBAAiB,CAAC,cAAc,CAAE,SAAQ,WAAW,CAChE,cAAc,EACd,eAAe,CAAC,cAAc,CAAC,CAChC;IACC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,sBAAsB,CAAa;gBAE/B,MAAM,EAAE;QAClB,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;QAC9C,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAKD,IAAI,eAAe,kDAElB;IAED;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOxC,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE;IAuCtC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAa3C,IAAI,SAAS,IAAI,QAAQ,EAAE,CAE1B;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,EAIlC;cAEe,UAAU,CACxB,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,OAAO,CAAC,IAAI,CAAC;IAyChB,SAAS,CAAC,gBAAgB,CACxB,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,SAAS;IAOZ,SAAS,CAAC,SAAS,IAAI,IAAI;IAIrB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,iBAAiB,CACrB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,yCAAyC,GAChD,OAAO,CAAC,2BAA2B,CAAC;IA+GvC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,EAChC,MAAM,EACN,UAAU,EACV,SAAa,GACd,EAAE;QACD,MAAM,EAAE,yCAAyC,CAAC;QAClD,UAAU,CAAC,EAAE,kCAAkC,CAC7C,cAAc,EACd,oBAAoB,EAAE,EACtB,QAAQ,CACT,CAAC;QACF,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAyIzC"}
+{"version":3,"file":"extraction-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/extraction-adapter.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,kCAAkC,EAClC,yCAAyC,EACzC,kBAAkB,EAElB,2BAA2B,EAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAkB,MAAM,oCAAoC,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;GAMG;AACH,qBAAa,iBAAiB,CAC5B,cAAc,CACd,SAAQ,WAAW,CAAC,cAAc,CAAC;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,sBAAsB,CAAa;gBAE/B,MAAM,EAAE;QAClB,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAKD;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOxC,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE;IAuCtC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAa3C,IAAI,SAAS,IAAI,QAAQ,EAAE,CAE1B;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,EAIlC;cAEe,UAAU,CACxB,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,OAAO,CAAC,IAAI,CAAC;IA2ChB,SAAS,CAAC,gBAAgB,CACxB,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,SAAS;IAOZ,SAAS,CAAC,SAAS,IAAI,IAAI;IAIrB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,iBAAiB,CACrB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,yCAAyC,GAChD,OAAO,CAAC,2BAA2B,CAAC;IA+GvC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,EAChC,MAAM,EACN,UAAU,EACV,SAAa,GACd,EAAE;QACD,MAAM,EAAE,yCAAyC,CAAC;QAClD,UAAU,CAAC,EAAE,kCAAkC,CAC7C,cAAc,EACd,oBAAoB,EAAE,EACtB,QAAQ,CACT,CAAC;QACF,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,UAAU,CAAC;CAyIxB"}

package/dist/multithreading/adapters/extraction-adapter.js

@@ -4,14 +4,13 @@ exports.ExtractionAdapter = void 0;
 const attachments_streaming_pool_1 = require("../../attachments-streaming/attachments-streaming-pool");
 const constants_1 = require("../../common/constants");
 const logger_1 = require("../../logger/logger");
-const logger_context_1 = require("../../logger/logger.context");
 const repo_1 = require("../../repo/repo");
 const extraction_1 = require("../../types/extraction");
 const base_adapter_1 = require("./base-adapter");
 /**
  * ExtractionAdapter is the adapter passed to extraction tasks. It exposes the
- * extraction surface (repos, artifacts, attachment streaming) and updates the
- * extraction boundaries before emitting.
+ * extraction surface (repos, artifacts, attachment streaming) and uploads
+ * pending repos and updates the extraction boundaries before emitting.
  *
  * @public
  */
@@ -22,9 +21,6 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
         this.currentEventDataLength = 0;
         this._artifacts = [];
     }
-    get extractionScope() {
-        return this.adapterState.extractionScope;
-    }
     /**
      * Returns whether the given item type should be extracted.
      * Defaults to true if the scope is empty or the item type is not listed.
@@ -45,7 +41,7 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
                     var _a;
                     // We need to store artifacts ids in state for later use when streaming attachments
                     if (repo.itemType === constants_1.AirSyncDefaultItemTypes.ATTACHMENTS) {
-                        (_a = this.adapterState.sdkState.toDevRev) === null || _a === void 0 ? void 0 : _a.attachmentsMetadata.artifactIds.push(artifact.id);
+                        (_a = this.sdkState.toDevRev) === null || _a === void 0 ? void 0 : _a.attachmentsMetadata.artifactIds.push(artifact.id);
                     }
                     // Calculate size of the entire artifact object that goes in the SQS message
                     this.currentEventDataLength += Buffer.byteLength(JSON.stringify(artifact), 'utf8');
@@ -57,7 +53,7 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
         });
     }
     getRepo(itemType) {
-        return (0, logger_context_1.runWithSdkLogContext)(() => {
+        return (0, logger_1.runWithSdkLogContext)(() => {
             const repo = this.repos.find((repo) => repo.itemType === itemType);
             if (!repo) {
                 console.error(`Repo for item type ${itemType} not found.`);
@@ -78,8 +74,10 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
         // Upload all repos before emitting the event
         console.log(`Uploading all repos before emitting event with event type: ${newEventType}.`);
         await this.uploadAllRepos();
+        // When the full extraction cycle completes, commit the extraction window
+        // boundaries so subsequent incremental syncs can resume from them.
         if (newEventType === extraction_1.ExtractorEventType.AttachmentExtractionDone) {
-            const sdkState = this.adapterState.sdkState;
+            const sdkState = this.sdkState;
             // Clear pending extraction boundaries now that the cycle is complete
             sdkState.pendingWorkersOldest = '';
             sdkState.pendingWorkersNewest = '';
@@ -116,9 +114,9 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
         }
     }
     async processAttachment(attachment, stream) {
-        return (0, logger_context_1.runWithSdkLogContext)(async () => {
+        return (0, logger_1.runWithSdkLogContext)(async () => {
             var _a, _b, _c;
-            const { httpStream, delay, error } = await (0, logger_context_1.runWithUserLogContext)(async () => stream({
+            const { httpStream, delay, error } = await (0, logger_1.runWithUserLogContext)(async () => stream({
                 item: attachment,
                 event: this.event,
             }));
@@ -228,7 +226,7 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
      */
     async streamAttachments({ stream, processors, batchSize = 1, // By default, we want to stream one attachment at a time
      }) {
-        return (0, logger_context_1.runWithSdkLogContext)(async () => {
+        return (0, logger_1.runWithSdkLogContext)(async () => {
             var _a, _b;
             if (batchSize <= 0) {
                 console.warn(`The specified batch size (${batchSize}) is invalid. Using 1 instead.`);
@@ -244,11 +242,11 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
                 },
             ];
             this.initializeRepos(repos);
-            const attachmentsMetadata = (_a = this.adapterState.sdkState.toDevRev) === null || _a === void 0 ? void 0 : _a.attachmentsMetadata;
+            const attachmentsMetadata = (_a = this.sdkState.toDevRev) === null || _a === void 0 ? void 0 : _a.attachmentsMetadata;
             // If there are no attachments metadata artifact IDs in state, finish here
             if (!((_b = attachmentsMetadata === null || attachmentsMetadata === void 0 ? void 0 : attachmentsMetadata.artifactIds) === null || _b === void 0 ? void 0 : _b.length)) {
                 console.log(`No attachments metadata artifact IDs found in state.`);
-                return;
+                return { status: 'success' };
             }
             else {
                 console.log(`Found ${attachmentsMetadata.artifactIds.length} attachments metadata artifact IDs in state.`);
@@ -262,7 +260,7 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
                 });
                 if (error) {
                     console.error(`Failed to get attachments for artifact ID: ${attachmentsMetadataArtifactId}.`);
-                    return { error };
+                    return { status: 'error', error };
                 }
                 if (!attachments || attachments.length === 0) {
                     console.warn(`No attachments found for artifact ID: ${attachmentsMetadataArtifactId}.`);
@@ -277,12 +275,12 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
                     console.log(`Using custom processors for attachments.`);
                     const reducer = processors.reducer;
                     const iterator = processors.iterator;
-                    const reducedAttachments = (0, logger_context_1.runWithUserLogContext)(() => reducer({
+                    const reducedAttachments = (0, logger_1.runWithUserLogContext)(() => reducer({
                         attachments,
                         adapter: this,
                         batchSize,
                     }));
-                    response = await (0, logger_context_1.runWithUserLogContext)(async () => {
+                    response = await (0, logger_1.runWithUserLogContext)(async () => {
                         return await iterator({
                             reducedAttachments,
                             adapter: this,
@@ -295,21 +293,21 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
                     const attachmentsPool = new attachments_streaming_pool_1.AttachmentsStreamingPool({
                         adapter: this,
                         attachments,
-                        attachmentsMetadata,
                         batchSize,
                         stream,
                     });
                     response = await attachmentsPool.streamAll();
                 }
-                if ((response === null || response === void 0 ? void 0 : response.delay) || (response === null || response === void 0 ? void 0 : response.error)) {
-                    return response;
+                if (response === null || response === void 0 ? void 0 : response.error) {
+                    return { status: 'error', error: response.error };
+                }
+                if (response === null || response === void 0 ? void 0 : response.delay) {
+                    return { status: 'delay', delaySeconds: response.delay };
                 }
-                // On timeout, emit progress and exit to allow continuation.
+                // On timeout, return progress to allow continuation in a fresh invocation.
                 if (this.isTimeout) {
-                    console.log(`Timeout detected after processing attachments for artifact ID: ${attachmentsMetadataArtifactId}. Emitting progress to allow continuation.`);
-                    await this.emit(extraction_1.ExtractorEventType.AttachmentExtractionProgress);
-                    process.exit(0);
-                    return;
+                    console.log(`Timeout detected after processing attachments for artifact ID: ${attachmentsMetadataArtifactId}. Returning progress to allow continuation.`);
+                    return { status: 'progress' };
                 }
                 console.log(`Finished processing all attachments for artifact ID: ${attachmentsMetadataArtifactId}.`);
                 attachmentsMetadata.artifactIds.shift();
@@ -318,7 +316,7 @@ class ExtractionAdapter extends base_adapter_1.BaseAdapter {
                     attachmentsMetadata.lastProcessedAttachmentsIdsList.length = 0;
                 }
             }
-            return;
+            return { status: 'success' };
         });
     }
 }

package/dist/multithreading/adapters/loading-adapter.d.ts

@@ -1,8 +1,8 @@
 import { Mappers } from '../../mappers/mappers';
-import { LoadingState } from '../../state/loading-state';
+import { BaseState } from '../../state/state';
 import { AirSyncEvent, EventData, ExtractorEventType } from '../../types/extraction';
-import { ExternalSystemAttachment, ExternalSystemItem, ExternalSystemLoadingFunction, FileToLoad, ItemTypesToLoadParams, ItemTypeToLoad, LoaderEventType, LoaderReport, LoadItemResponse, LoadItemTypesResponse } from '../../types/loading';
-import { WorkerAdapterOptions } from '../../types/workers';
+import { ExternalSystemAttachment, ExternalSystemItem, ExternalSystemLoadingFunction, FileToLoad, ItemTypesToLoadParams, ItemTypeToLoad, LoaderEventType, LoaderReport, LoadItemResponse } from '../../types/loading';
+import { TaskResult, WorkerAdapterOptions } from '../../types/workers';
 import { BaseAdapter } from './base-adapter';
 /**
  * LoadingAdapter is the adapter passed to loading tasks. It exposes the loading
@@ -10,13 +10,13 @@ import { BaseAdapter } from './base-adapter';
  *
  * @public
  */
-export declare class LoadingAdapter<ConnectorState> extends BaseAdapter<ConnectorState, LoadingState<ConnectorState>> {
+export declare class LoadingAdapter<ConnectorState> extends BaseAdapter<ConnectorState> {
     private loaderReports;
     private _processedFiles;
     private _mappers;
     constructor(params: {
         event: AirSyncEvent;
-        adapterState: LoadingState<ConnectorState>;
+        adapterState: BaseState<ConnectorState>;
         options?: WorkerAdapterOptions;
     });
     get reports(): LoaderReport[];
@@ -25,13 +25,13 @@ export declare class LoadingAdapter<ConnectorState> extends BaseAdapter<Connecto
     protected beforeEmit(): Promise<void>;
     protected buildEmitPayload(newEventType: ExtractorEventType | LoaderEventType): EventData;
     protected afterEmit(): void;
-    loadItemTypes({ itemTypesToLoad, }: ItemTypesToLoadParams): Promise<LoadItemTypesResponse>;
+    loadItemTypes({ itemTypesToLoad, }: ItemTypesToLoadParams): Promise<TaskResult>;
     getLoaderBatches({ supportedItemTypes, }: {
         supportedItemTypes: string[];
     }): Promise<FileToLoad[]>;
     loadAttachments({ create, }: {
         create: ExternalSystemLoadingFunction<ExternalSystemAttachment>;
-    }): Promise<LoadItemTypesResponse>;
+    }): Promise<TaskResult>;
     loadItem({ item, itemTypeToLoad, }: {
         item: ExternalSystemItem;
         itemTypeToLoad: ItemTypeToLoad;

package/dist/multithreading/adapters/loading-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/loading-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,SAAS,EAET,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,wBAAwB,EACxB,kBAAkB,EAClB,6BAA6B,EAC7B,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;;;;GAKG;AACH,qBAAa,cAAc,CAAC,cAAc,CAAE,SAAQ,WAAW,CAC7D,cAAc,EACd,YAAY,CAAC,cAAc,CAAC,CAC7B;IACC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAU;gBAEd,MAAM,EAAE;QAClB,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;QAC3C,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAUD,IAAI,OAAO,IAAI,YAAY,EAAE,CAE5B;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,CAE7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;cAEe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,SAAS,CAAC,gBAAgB,CACxB,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,SAAS;IAYZ,SAAS,CAAC,SAAS,IAAI,IAAI;IAIrB,aAAa,CAAC,EAClB,eAAe,GAChB,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwInD,gBAAgB,CAAC,EACrB,kBAAkB,GACnB,EAAE;QACD,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B;IA4BK,eAAe,CAAC,EACpB,MAAM,GACP,EAAE;QACD,MAAM,EAAE,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;KACjE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyG5B,QAAQ,CAAC,EACb,IAAI,EACJ,cAAc,GACf,EAAE;QACD,IAAI,EAAE,kBAAkB,CAAC;QACzB,cAAc,EAAE,cAAc,CAAC;KAChC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwMvB,cAAc,CAAC,EACnB,IAAI,EACJ,MAAM,GACP,EAAE;QACD,IAAI,EAAE,wBAAwB,CAAC;QAC/B,MAAM,EAAE,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;KACjE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAsD9B"}
+{"version":3,"file":"loading-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/loading-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,SAAS,EAET,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,wBAAwB,EACxB,kBAAkB,EAClB,6BAA6B,EAC7B,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,gBAAgB,EAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;;;;GAKG;AACH,qBAAa,cAAc,CACzB,cAAc,CACd,SAAQ,WAAW,CAAC,cAAc,CAAC;IACnC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAU;gBAEd,MAAM,EAAE;QAClB,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAUD,IAAI,OAAO,IAAI,YAAY,EAAE,CAE5B;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,CAE7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;cAEe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,SAAS,CAAC,gBAAgB,CACxB,YAAY,EAAE,kBAAkB,GAAG,eAAe,GACjD,SAAS;IAYZ,SAAS,CAAC,SAAS,IAAI,IAAI;IAIrB,aAAa,CAAC,EAClB,eAAe,GAChB,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsHxC,gBAAgB,CAAC,EACrB,kBAAkB,GACnB,EAAE;QACD,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B;IA4BK,eAAe,CAAC,EACpB,MAAM,GACP,EAAE;QACD,MAAM,EAAE,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;KACjE,GAAG,OAAO,CAAC,UAAU,CAAC;IA4FjB,QAAQ,CAAC,EACb,IAAI,EACJ,cAAc,GACf,EAAE;QACD,IAAI,EAAE,kBAAkB,CAAC;QACzB,cAAc,EAAE,cAAc,CAAC;KAChC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsMvB,cAAc,CAAC,EACnB,IAAI,EACJ,MAAM,GACP,EAAE;QACD,IAAI,EAAE,wBAAwB,CAAC;QAC/B,MAAM,EAAE,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;KACjE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAsD9B"}