@devrev/airsync-sdk 2.0.0-beta.1 → 2.0.0-beta.11

package/dist/logger/logger.js

@@ -1,94 +1,72 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = void 0;
+exports.Logger = exports.INSPECT_OPTIONS = exports.MAX_LOG_STRING_LENGTH = void 0;
+exports.truncateMessage = truncateMessage;
 exports.getPrintableState = getPrintableState;
 exports.serializeError = serializeError;
 exports.serializeAxiosError = serializeAxiosError;
-exports.formatAxiosError = formatAxiosError;
-const axios_1 = require("axios");
 const node_console_1 = require("node:console");
 const node_util_1 = require("node:util");
 const node_worker_threads_1 = require("node:worker_threads");
+const axios_1 = require("axios");
 const constants_1 = require("../common/constants");
 const workers_1 = require("../types/workers");
-const logger_constants_1 = require("./logger.constants");
-const logger_context_1 = require("./logger.context");
 const logger_interfaces_1 = require("./logger.interfaces");
+// ── Log formatting ──
+exports.MAX_LOG_STRING_LENGTH = 10000;
+const MAX_LOG_DEPTH = 10;
+const MAX_LOG_ARRAY_LENGTH = 100;
+exports.INSPECT_OPTIONS = {
+    compact: false,
+    breakLength: Infinity,
+    depth: MAX_LOG_DEPTH,
+    maxArrayLength: MAX_LOG_ARRAY_LENGTH,
+    maxStringLength: exports.MAX_LOG_STRING_LENGTH,
+};
+function truncateMessage(message) {
+    if (message.length > exports.MAX_LOG_STRING_LENGTH) {
+        return `${message.substring(0, exports.MAX_LOG_STRING_LENGTH)}... ${message.length - exports.MAX_LOG_STRING_LENGTH} more characters`;
+    }
+    return message;
+}
 /**
- * Custom logger that extends Node.js Console with context-aware logging.
- * Handles local development, main thread, and worker thread logging differently.
+ * Console replacement that tags every log line with the event context. Worker
+ * threads forward log lines to the main thread, because the snap-in platform
+ * only captures logs written through the main thread's console.
  */
 class Logger extends node_console_1.Console {
     constructor({ event, options }) {
         super(process.stdout, process.stderr);
         this.originalConsole = console;
         this.options = options;
-        this.tags = Object.assign(Object.assign({}, event.payload.event_context), { sdk_version: constants_1.LIBRARY_VERSION, is_sdk_log: true });
-    }
-    /**
-     * Converts any value to a string using `util.inspect()` for complex types.
-     *
-     * @param value - The value to convert
-     * @returns String representation of the value
-     */
+        this.tags = Object.assign(Object.assign({}, event.payload.event_context), { sdk_version: constants_1.LIBRARY_VERSION });
+    }
     valueToString(value) {
         if (typeof value === 'string') {
             return value;
         }
-        return (0, node_util_1.inspect)(value, logger_constants_1.INSPECT_OPTIONS);
-    }
-    /**
-     * Truncates a message if it exceeds the maximum allowed length.
-     * Adds a suffix indicating how many characters were omitted.
-     *
-     * @param message - The message to truncate
-     * @returns Truncated message or original if within limits
-     */
-    truncateMessage(message) {
-        if (message.length > logger_constants_1.MAX_LOG_STRING_LENGTH) {
-            return `${message.substring(0, logger_constants_1.MAX_LOG_STRING_LENGTH)}... ${message.length - logger_constants_1.MAX_LOG_STRING_LENGTH} more characters`;
-        }
-        return message;
-    }
-    /**
-     * Logs a pre-formatted message string to the console.
-     * In production mode, wraps the message with JSON formatting and event context tags.
-     * In local development mode, logs the message directly without JSON wrapping.
-     * This is useful when you need to log already-stringified content.
-     *
-     * @param message - The pre-formatted message string to log
-     * @param level - Log level (info, warn, error)
-     * @param isSdkLog - Flag indicating if the log originated from the SDK
-     */
-    logFn(message, level, isSdkLog = (0, logger_context_1.getSdkLogContextValue)(true)) {
+        return (0, node_util_1.inspect)(value, exports.INSPECT_OPTIONS);
+    }
+    /** In production wraps the message in JSON with event context tags; in local development logs as-is. */
+    logFn(message, level) {
         var _a;
         if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.isLocalDevelopment) {
             this.originalConsole[level](message);
             return;
         }
-        const logObject = Object.assign(Object.assign({ message }, this.tags), { is_sdk_log: isSdkLog });
+        const logObject = Object.assign({ message }, this.tags);
         this.originalConsole[level](JSON.stringify(logObject));
     }
-    /**
-     * Stringifies and logs arguments to the appropriate destination.
-     * On main thread, converts arguments to strings and calls logFn.
-     * In worker threads, forwards stringified arguments to the main thread for processing.
-     * All arguments are converted to strings using util.inspect and joined with spaces.
-     *
-     * @param args - Values to log (will be stringified and truncated if needed)
-     * @param level - Log level (info, warn, error)
-     */
     stringifyAndLog(args, level) {
         let stringifiedArgs = args.map((arg) => this.valueToString(arg)).join(' ');
-        stringifiedArgs = this.truncateMessage(stringifiedArgs);
-        const isSdkLog = (0, logger_context_1.getSdkLogContextValue)(true);
+        stringifiedArgs = truncateMessage(stringifiedArgs);
         if (node_worker_threads_1.isMainThread) {
-            this.logFn(stringifiedArgs, level, isSdkLog);
+            this.logFn(stringifiedArgs, level);
         }
         else {
             node_worker_threads_1.parentPort === null || node_worker_threads_1.parentPort === void 0 ? void 0 : node_worker_threads_1.parentPort.postMessage({
                 subject: workers_1.WorkerMessageSubject.WorkerMessageLog,
-                payload: { stringifiedArgs, level, isSdkLog },
+                payload: { stringifiedArgs, level },
             });
         }
     }
@@ -106,14 +84,7 @@ class Logger extends node_console_1.Console {
     }
 }
 exports.Logger = Logger;
-/**
- * Converts a state object into a printable format where arrays are summarized.
- * Arrays show their length, first item, and last item instead of all elements.
- * Objects are recursively processed and primitives are returned as-is.
- *
- * @param state - State object to convert
- * @returns Printable representation with summarized arrays
- */
+/** Summarizes arrays as `{ length, firstItem, lastItem }` instead of listing all elements. */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function getPrintableState(state) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -137,28 +108,43 @@ function getPrintableState(state) {
     }
     return processValue(state);
 }
-/**
- * Serializes an error into a structured format.
- * Automatically detects and formats Axios errors with HTTP details.
- * Returns other error types as-is.
- *
- * @param error - Error to serialize
- * @returns Serialized error or original if not an Axios error
- */
+/** Serializes any error into a loggable string; Axios errors get HTTP details. */
 function serializeError(error) {
     if ((0, axios_1.isAxiosError)(error)) {
-        return serializeAxiosError(error);
+        return JSON.stringify(serializeAxiosError(error));
+    }
+    if (error instanceof Error) {
+        // Include non-default error name (e.g. TypeError) for easier debugging
+        return error.name !== 'Error'
+            ? `${error.name}: ${error.message}`
+            : error.message;
     }
-    return error;
+    if (typeof error === 'string') {
+        return error;
+    }
+    // JSON.stringify returns '{}' for objects with only non-enumerable properties
+    // Fall back to extracting own property names or String() coercion.
+    const stringified = JSON.stringify(error);
+    if (!stringified || stringified === '{}') {
+        if (error !== null && typeof error === 'object') {
+            const props = {};
+            for (const key of Object.getOwnPropertyNames(error)) {
+                props[key] = error[key];
+            }
+            const extracted = JSON.stringify(props);
+            if (extracted && extracted !== '{}') {
+                return extracted;
+            }
+        }
+        try {
+            return String(error);
+        }
+        catch (_a) {
+            return '[Unserializable error]';
+        }
+    }
+    return stringified;
 }
-/**
- * Serializes an Axios error into a structured format with HTTP request/response details.
- * Extracts method, URL, parameters, status code, headers, and data.
- * Includes CORS/network failure indicator when no response is available.
- *
- * @param error - Axios error to serialize
- * @returns Structured object with error details
- */
 function serializeAxiosError(error) {
     var _a, _b, _c;
     const serializedAxiosError = {
@@ -173,7 +159,6 @@ function serializeAxiosError(error) {
     if (error.response) {
         serializedAxiosError.response = {
             data: error.response.data,
-            headers: error.response.headers,
             status: error.response.status,
             statusText: error.response.statusText,
         };
@@ -184,13 +169,3 @@ function serializeAxiosError(error) {
     }
     return serializedAxiosError;
 }
-/**
- * Formats an Axios error to a printable format.
- *
- * @param error - Axios error to format
- * @returns Formatted error object
- * @deprecated Use {@link serializeAxiosError} instead
- */
-function formatAxiosError(error) {
-    return serializeAxiosError(error);
-}

package/dist/mappers/mappers.d.ts

@@ -1,52 +1,19 @@
-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.
- *
- * Used for tracking relationships between external and DevRev entities during sync operations.
+ * Lookups resolve to `null` when no record exists; every other failure rejects
+ * with an {@link AirSyncHttpError}.
  */
 export declare class Mappers {
     private devrevApiEndpoint;
     private devrevApiToken;
     constructor({ event }: MappersFactoryInterface);
-    /**
-     * Retrieves a sync mapper record by DevRev ID.
-     *
-     * 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
-     */
-    getByTargetId(params: MappersGetByTargetIdParams): Promise<AxiosResponse<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
-     */
-    getByExternalId(params: MappersGetByExternalIdParams): Promise<AxiosResponse<MappersGetByExternalIdResponse>>;
-    /**
-     * Creates a new sync mapper record to establish a relationship between external system
-     * entities and DevRev entities.
-     *
-     * This is called after importing an item from external system to DevRev to record
-     * the mapping for future synchronization operations.
-     *
-     * @param params - Creation parameters of type MappersCreateParams
-     * @returns Promise with response data containing the created sync mapper record
-     */
-    create(params: MappersCreateParams): Promise<AxiosResponse<MappersCreateResponse>>;
-    /**
-     * Updates an existing sync mapper record.
-     *
-     * Used to modify existing mappings when external system entities change or when
-     * 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
-     */
-    update(params: MappersUpdateParams): Promise<AxiosResponse<MappersUpdateResponse>>;
+    getByTargetId(params: MappersGetByTargetIdParams): Promise<MappersGetByTargetIdResponse | null>;
+    getByExternalId(params: MappersGetByExternalIdParams): Promise<MappersGetByExternalIdResponse | null>;
+    /** Called after importing an item to DevRev to record the mapping for future syncs. */
+    create(params: MappersCreateParams): Promise<MappersCreateResponse>;
+    update(params: MappersUpdateParams): Promise<MappersUpdateResponse>;
+    private call;
+    private lookup;
 }
 //# 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":"AAGA,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;IAKxC,aAAa,CACjB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAezC,eAAe,CACnB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC;IAejD,uFAAuF;IACjF,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAcnE,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAc3D,IAAI;YAQJ,MAAM;CAYrB"}

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

@@ -0,0 +1,173 @@
+import { AirSyncEvent } from '../types/extraction';
+import { DonV2 } from '../types/loading';
+export interface MappersFactoryInterface {
+    event: AirSyncEvent;
+}
+export interface UpdateSyncMapperRecordParams {
+    external_ids: {
+        add: string[];
+    };
+    /**
+     * Labels values in `external_ids` with their usage context (e.g. a UUID for
+     * one API call, a login username for another). Not indexed: to look up by a
+     * secondary value it must also be present in `external_ids`.
+     */
+    secondary_ids?: Record<string, string>;
+    targets: {
+        add: DonV2[];
+    };
+    status: SyncMapperRecordStatus;
+    /** Input file name(s) containing the object data; helps later debugging. */
+    input_files?: {
+        add: string[];
+    };
+    /**
+     * Prevents update loops: after writing the object to the external system,
+     * add its modified_date here. The Loader skips extracted updates whose
+     * modified_date is listed (the change originated in DevRev).
+     */
+    external_versions?: {
+        add: SyncMapperRecordExternalVersion[];
+    };
+    /** Free-form storage; opaque to the platform. */
+    extra_data?: string;
+}
+/** Links external system entities to DevRev entities. */
+export interface SyncMapperRecord {
+    id: DonV2;
+    external_ids: string[];
+    /**
+     * Labels values in `external_ids` with their usage context (e.g. a UUID for
+     * one API call, a login username for another). Not indexed: to look up by a
+     * secondary value it must also be present in `external_ids`.
+     */
+    secondary_ids?: Record<string, string>;
+    targets: DonV2[];
+    status: SyncMapperRecordStatus;
+    /** Input file name(s) containing the object data; helps later debugging. */
+    input_files?: string[];
+    /**
+     * Prevents update loops: after writing the object to the external system,
+     * its modified_date is stored here. The Loader skips extracted updates whose
+     * modified_date is listed (the change originated in DevRev).
+     */
+    external_versions?: SyncMapperRecordExternalVersion[];
+    /** Free-form storage; opaque to the platform. */
+    extra_data?: string;
+}
+export interface MappersGetByTargetIdParams {
+    sync_unit: DonV2;
+    target: DonV2;
+}
+export interface MappersGetByTargetIdResponse {
+    sync_mapper_record: SyncMapperRecord;
+}
+export interface MappersCreateParams {
+    sync_unit: DonV2;
+    external_ids: string[];
+    /**
+     * Labels values in `external_ids` with their usage context (e.g. a UUID for
+     * one API call, a login username for another). Not indexed: to look up by a
+     * secondary value it must also be present in `external_ids`.
+     */
+    secondary_ids?: Record<string, string>;
+    targets: DonV2[];
+    status: SyncMapperRecordStatus;
+    /** Input file name(s) containing the object data; helps later debugging. */
+    input_files?: string[];
+    /**
+     * Prevents update loops: after writing the object to the external system,
+     * add its modified_date here. The Loader skips extracted updates whose
+     * modified_date is listed (the change originated in DevRev).
+     */
+    external_versions?: SyncMapperRecordExternalVersion[];
+    /** Free-form storage; opaque to the platform. */
+    extra_data?: string;
+}
+export interface MappersCreateResponse {
+    sync_mapper_record: SyncMapperRecord;
+}
+export interface MappersUpdateParams {
+    id: DonV2;
+    sync_unit: DonV2;
+    external_ids: {
+        add: string[];
+    };
+    /**
+     * Labels values in `external_ids` with their usage context (e.g. a UUID for
+     * one API call, a login username for another). Not indexed: to look up by a
+     * secondary value it must also be present in `external_ids`.
+     */
+    secondary_ids?: Record<string, string>;
+    targets: {
+        add: DonV2[];
+    };
+    status: SyncMapperRecordStatus;
+    /** Input file name(s) containing the object data; helps later debugging. */
+    input_files?: {
+        add: string[];
+    };
+    /**
+     * Prevents update loops: after writing the object to the external system,
+     * add its modified_date here. The Loader skips extracted updates whose
+     * modified_date is listed (the change originated in DevRev).
+     */
+    external_versions?: {
+        add: SyncMapperRecordExternalVersion[];
+    };
+    /** Free-form storage; opaque to the platform. */
+    extra_data?: string;
+}
+export interface MappersUpdateResponse {
+    sync_mapper_record: SyncMapperRecord;
+}
+export declare enum SyncMapperRecordStatus {
+    /** The mapping is active and operational (default) */
+    OPERATIONAL = "operational",
+    /** The mapping was filtered out by user filter settings */
+    FILTERED = "filtered",
+    /** Ignore the external object in sync; prevents create/update in DevRev. */
+    IGNORED = "ignored"
+}
+/** Marks external changes as DevRev-originated to prevent update loops. */
+export interface SyncMapperRecordExternalVersion {
+    /** Sync recipe version at the time the external change was written */
+    recipe_version: number;
+    /** External system modified timestamp (ISO 8601 string) used for loop detection */
+    modified_date: string;
+}
+export interface MappersGetByExternalIdParams {
+    sync_unit: DonV2;
+    external_id: string;
+    target_type: SyncMapperRecordTargetType;
+}
+export declare enum SyncMapperRecordTargetType {
+    ACCESS_CONTROL_ENTRY = "access_control_entry",
+    ACCOUNT = "account",
+    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",
+    CONVERSATION = "conversation",
+    CUSTOM_OBJECT = "custom_object",
+    DIRECTORY = "directory",
+    GROUP = "group",
+    INCIDENT = "incident",
+    LINK = "link",
+    MEETING = "meeting",
+    OBJECT_MEMBER = "object_member",
+    PART = "part",
+    REV_ORG = "rev_org",
+    ROLE = "role",
+    ROLE_SET = "role_set",
+    TAG = "tag",
+    TIMELINE_COMMENT = "timeline_comment",
+    USER = "user",
+    WORK = "work"
+}
+export interface MappersGetByExternalIdResponse {
+    sync_mapper_record: SyncMapperRecord;
+}
+//# 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}

@@ -1,24 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncMapperRecordTargetType = exports.SyncMapperRecordStatus = void 0;
-/**
- * Status of a sync mapper record indicating its operational state.
- */
 var SyncMapperRecordStatus;
 (function (SyncMapperRecordStatus) {
     /** The mapping is active and operational (default) */
     SyncMapperRecordStatus["OPERATIONAL"] = "operational";
     /** The mapping was filtered out by user filter settings */
     SyncMapperRecordStatus["FILTERED"] = "filtered";
-    /**
-     * The external object should be ignored in sync operations.
-     * Use to prevent objects from being created or updated in DevRev.
-     */
+    /** Ignore the external object in sync; prevents create/update in DevRev. */
     SyncMapperRecordStatus["IGNORED"] = "ignored";
 })(SyncMapperRecordStatus || (exports.SyncMapperRecordStatus = SyncMapperRecordStatus = {}));
-/**
- * Types of DevRev entities that can be targets in sync mapper records.
- */
 var SyncMapperRecordTargetType;
 (function (SyncMapperRecordTargetType) {
     SyncMapperRecordTargetType["ACCESS_CONTROL_ENTRY"] = "access_control_entry";

package/dist/mappers/mappers.js

@@ -1,83 +1,69 @@
 "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");
+const errors_1 = require("../http/errors");
 /**
  * Manages sync mapper records that link external system items to DevRev items.
- *
- * Used for tracking relationships between external and DevRev entities during sync operations.
+ * Lookups resolve to `null` when no record exists; every other failure rejects
+ * with an {@link AirSyncHttpError}.
  */
 class Mappers {
     constructor({ event }) {
         this.devrevApiEndpoint = event.execution_metadata.devrev_endpoint;
         this.devrevApiToken = event.context.secrets.service_account_token;
     }
-    /**
-     * Retrieves a sync mapper record by DevRev ID.
-     *
-     * 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
-     */
     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`, {
+        return this.lookup(async () => client_1.axiosClient.get(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.get-by-target`, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
             params: { sync_unit, target },
-        });
+        }));
     }
-    /**
-     * 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
-     */
     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`, {
+        return this.lookup(async () => 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 },
-        });
+        }));
     }
-    /**
-     * Creates a new sync mapper record to establish a relationship between external system
-     * entities and DevRev entities.
-     *
-     * This is called after importing an item from external system to DevRev to record
-     * the mapping for future synchronization operations.
-     *
-     * @param params - Creation parameters of type MappersCreateParams
-     * @returns Promise with response data containing the created sync mapper record
-     */
+    /** Called after importing an item to DevRev to record the mapping for future syncs. */
     async create(params) {
-        return axios_client_internal_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.create`, params, {
+        return this.call(async () => client_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.create`, params, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
-        });
+        }));
     }
-    /**
-     * Updates an existing sync mapper record.
-     *
-     * Used to modify existing mappings when external system entities change or when
-     * 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
-     */
     async update(params) {
-        return axios_client_internal_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.update`, params, {
+        return this.call(async () => client_1.axiosClient.post(`${this.devrevApiEndpoint}/internal/airdrop.sync-mapper-record.update`, params, {
             headers: {
                 Authorization: this.devrevApiToken,
             },
-        });
+        }));
+    }
+    async call(request) {
+        try {
+            return (await request()).data;
+        }
+        catch (error) {
+            throw (0, errors_1.toAirSyncHttpError)(error);
+        }
+    }
+    async lookup(request) {
+        try {
+            return (await request()).data;
+        }
+        catch (error) {
+            if ((0, errors_1.isNotFound)(error)) {
+                return null;
+            }
+            throw (0, errors_1.toAirSyncHttpError)(error);
+        }
     }
 }
 exports.Mappers = Mappers;

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

@@ -0,0 +1,39 @@
+import { Mappers } from '../../mappers/mappers';
+import { AirSyncEvent } from '../../types/extraction';
+/**
+ * Shared state/behavior for both sync modes; owns the `emit` control-protocol
+ * flow as a template method with mode-specific hooks.
+ */
+export declare abstract class BaseAdapter<ConnectorState> {
+    readonly event: AirSyncEvent;
+    private _hasWorkerEmitted;
+    private _isTimeout;
+    private resolveTimeoutSignal;
+    private _mappers;
+    /** Sync mapper records for this event's sync unit, in both extraction and loading. */
+    get mappers(): Mappers;
+    /** Set once the soft timeout fires; the task should wrap up and return. */
+    get isTimeout(): boolean;
+    /** Connector-owned state exposed to snap-in code. */
+    get state(): ConnectorState;
+    set state(value: ConnectorState);
+    get extractionScope(): import("../../types/workers").ExtractionScope;
+    /**
+     * Persists connector and SDK state right now. State is saved on every emit
+     * anyway; call this only to record intent before an external write that
+     * must not be repeated. Throws if the save fails.
+     */
+    postState(): Promise<void>;
+    /**
+     * Uploads connector-owned data (e.g. state too large to keep inline) as a
+     * gzipped JSONL artifact. Unlike repo uploads it is not reported in the
+     * emitted event. Throws on failure.
+     */
+    uploadArtifact(itemType: string, data: object[]): Promise<{
+        id: string;
+    }>;
+    /** Downloads an artifact written by {@link uploadArtifact}. Throws on failure. */
+    downloadArtifact<T = unknown>(artifactId: string): Promise<T[]>;
+    private send;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../src/multithreading/adapters/base-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKhD,OAAO,EACL,YAAY,EAIb,MAAM,wBAAwB,CAAC;AAYhC;;;GAGG;AACH,8BAAsB,WAAW,CAAC,cAAc;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAI7B,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,oBAAoB,CAAc;IAU1C,OAAO,CAAC,QAAQ,CAAU;IAsB1B,sFAAsF;IACtF,IAAI,OAAO,IAAI,OAAO,CAErB;IAOD,2EAA2E;IAC3E,IAAI,SAAS,IAAI,OAAO,CAEvB;IAUD,qDAAqD;IACrD,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,cAAc,EAE9B;IAOD,IAAI,eAAe,kDAElB;IAED;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;OAIG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAY1B,kFAAkF;IAC5E,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YAmIvD,IAAI;CAmCnB"}