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

package/dist/index.js

@@ -1,39 +1,50 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
+// ────────────────────────────────────────────────────────────────────────────
+// Public API barrel for @devrev/airsync-sdk. Single source of the public
+// surface: every export is named explicitly (no `export *`), so any public API
+// change shows up as a diff here.
+// ────────────────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MOCK_SERVER_DEFAULT_URL = exports.createMockEvent = exports.LoadingAdapter = exports.ExtractionAdapter = exports.spawn = exports.processLoadingTask = exports.processExtractionTask = exports.MockServer = exports.serializeAxiosError = exports.AirSyncDefaultItemTypes = void 0;
-var constants_1 = require("./common/constants");
-Object.defineProperty(exports, "AirSyncDefaultItemTypes", { enumerable: true, get: function () { return constants_1.AirSyncDefaultItemTypes; } });
-__exportStar(require("./common/install-initial-domain-mapping"), exports);
-__exportStar(require("./http"), exports);
-var logger_1 = require("./logger/logger");
-Object.defineProperty(exports, "serializeAxiosError", { enumerable: true, get: function () { return logger_1.serializeAxiosError; } });
-var mock_server_1 = require("./mock-server/mock-server");
-Object.defineProperty(exports, "MockServer", { enumerable: true, get: function () { return mock_server_1.MockServer; } });
+exports.MockServer = exports.MOCK_SERVER_DEFAULT_URL = exports.createMockEvent = exports.SyncMapperRecordTargetType = exports.SyncMapperRecordStatus = exports.Mappers = exports.LoaderEventType = exports.TimeValueType = exports.TimeUnit = exports.InitialSyncScope = exports.ExtractorEventType = exports.EventType = exports.SyncMode = exports.serializeError = exports.installInitialDomainMapping = exports.UNBOUNDED_DATE_TIME_VALUE = exports.AirSyncDefaultItemTypes = exports.spawn = exports.processLoadingTask = exports.processExtractionTask = exports.LoadingAdapter = exports.ExtractionAdapter = void 0;
+// ── Entry points & adapters ──
+var extraction_adapter_1 = require("./multithreading/adapters/extraction-adapter");
+Object.defineProperty(exports, "ExtractionAdapter", { enumerable: true, get: function () { return extraction_adapter_1.ExtractionAdapter; } });
+var loading_adapter_1 = require("./multithreading/adapters/loading-adapter");
+Object.defineProperty(exports, "LoadingAdapter", { enumerable: true, get: function () { return loading_adapter_1.LoadingAdapter; } });
 var process_task_1 = require("./multithreading/process-task");
 Object.defineProperty(exports, "processExtractionTask", { enumerable: true, get: function () { return process_task_1.processExtractionTask; } });
 Object.defineProperty(exports, "processLoadingTask", { enumerable: true, get: function () { return process_task_1.processLoadingTask; } });
 var spawn_1 = require("./multithreading/spawn/spawn");
 Object.defineProperty(exports, "spawn", { enumerable: true, get: function () { return spawn_1.spawn; } });
-var extraction_adapter_1 = require("./multithreading/adapters/extraction-adapter");
-Object.defineProperty(exports, "ExtractionAdapter", { enumerable: true, get: function () { return extraction_adapter_1.ExtractionAdapter; } });
-var loading_adapter_1 = require("./multithreading/adapters/loading-adapter");
-Object.defineProperty(exports, "LoadingAdapter", { enumerable: true, get: function () { return loading_adapter_1.LoadingAdapter; } });
-var test_utils_1 = require("./common/test-utils");
-Object.defineProperty(exports, "createMockEvent", { enumerable: true, get: function () { return test_utils_1.createMockEvent; } });
-Object.defineProperty(exports, "MOCK_SERVER_DEFAULT_URL", { enumerable: true, get: function () { return test_utils_1.MOCK_SERVER_DEFAULT_URL; } });
-__exportStar(require("./types"), exports);
-__exportStar(require("./types/workers"), exports);
+// ── Constants & enums ──
+var constants_1 = require("./common/constants");
+Object.defineProperty(exports, "AirSyncDefaultItemTypes", { enumerable: true, get: function () { return constants_1.AirSyncDefaultItemTypes; } });
+var constants_2 = require("./common/constants");
+Object.defineProperty(exports, "UNBOUNDED_DATE_TIME_VALUE", { enumerable: true, get: function () { return constants_2.UNBOUNDED_DATE_TIME_VALUE; } });
+// ── Domain mapping install ──
+var install_initial_domain_mapping_1 = require("./state/install-initial-domain-mapping");
+Object.defineProperty(exports, "installInitialDomainMapping", { enumerable: true, get: function () { return install_initial_domain_mapping_1.installInitialDomainMapping; } });
+// ── Error formatting ──
+var logger_1 = require("./logger/logger");
+Object.defineProperty(exports, "serializeError", { enumerable: true, get: function () { return logger_1.serializeError; } });
+var common_1 = require("./types/common");
+Object.defineProperty(exports, "SyncMode", { enumerable: true, get: function () { return common_1.SyncMode; } });
+var extraction_1 = require("./types/extraction");
+Object.defineProperty(exports, "EventType", { enumerable: true, get: function () { return extraction_1.EventType; } });
+Object.defineProperty(exports, "ExtractorEventType", { enumerable: true, get: function () { return extraction_1.ExtractorEventType; } });
+Object.defineProperty(exports, "InitialSyncScope", { enumerable: true, get: function () { return extraction_1.InitialSyncScope; } });
+Object.defineProperty(exports, "TimeUnit", { enumerable: true, get: function () { return extraction_1.TimeUnit; } });
+Object.defineProperty(exports, "TimeValueType", { enumerable: true, get: function () { return extraction_1.TimeValueType; } });
+var loading_1 = require("./types/loading");
+Object.defineProperty(exports, "LoaderEventType", { enumerable: true, get: function () { return loading_1.LoaderEventType; } });
+// ── Mappers ──
+var mappers_1 = require("./mappers/mappers");
+Object.defineProperty(exports, "Mappers", { enumerable: true, get: function () { return mappers_1.Mappers; } });
+var mappers_interfaces_1 = require("./mappers/mappers.interfaces");
+Object.defineProperty(exports, "SyncMapperRecordStatus", { enumerable: true, get: function () { return mappers_interfaces_1.SyncMapperRecordStatus; } });
+Object.defineProperty(exports, "SyncMapperRecordTargetType", { enumerable: true, get: function () { return mappers_interfaces_1.SyncMapperRecordTargetType; } });
+var mock_event_1 = require("./testing/mock-event");
+Object.defineProperty(exports, "createMockEvent", { enumerable: true, get: function () { return mock_event_1.createMockEvent; } });
+var mock_server_1 = require("./testing/mock-server");
+Object.defineProperty(exports, "MOCK_SERVER_DEFAULT_URL", { enumerable: true, get: function () { return mock_server_1.MOCK_SERVER_DEFAULT_URL; } });
+Object.defineProperty(exports, "MockServer", { enumerable: true, get: function () { return mock_server_1.MockServer; } });

package/dist/logger/logger.d.ts

@@ -1,73 +1,32 @@
-import { AxiosError } from 'axios';
 import { Console } from 'node:console';
+import { InspectOptions } from 'node:util';
+import { AxiosError } from 'axios';
 import { AxiosErrorResponse, LoggerFactoryInterface, LogLevel, PrintableState } from './logger.interfaces';
+export declare const MAX_LOG_STRING_LENGTH = 10000;
+export declare const INSPECT_OPTIONS: InspectOptions;
+export declare function truncateMessage(message: string): string;
 /**
- * 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.
  */
 export declare class Logger extends Console {
     private originalConsole;
     private options?;
     private tags;
     constructor({ event, options }: LoggerFactoryInterface);
-    /**
-     * Converts any value to a string using `util.inspect()` for complex types.
-     *
-     * @param value - The value to convert
-     * @returns String representation of the value
-     */
     private valueToString;
-    /**
-     * 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: string, level: LogLevel, isSdkLog?: boolean): void;
-    /**
-     * 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)
-     */
+    /** In production wraps the message in JSON with event context tags; in local development logs as-is. */
+    logFn(message: string, level: LogLevel): void;
     private stringifyAndLog;
     log(...args: unknown[]): void;
     info(...args: unknown[]): void;
     warn(...args: unknown[]): void;
     error(...args: unknown[]): void;
 }
-/**
- * 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. */
 export declare function getPrintableState(state: Record<string, any>): PrintableState;
-/**
- * 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. */
 export declare function serializeError(error: unknown): string;
-/**
- * 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
- */
 export declare function serializeAxiosError(error: AxiosError): AxiosErrorResponse;
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EAEtB,QAAQ,EAER,cAAc,EACf,MAAM,qBAAqB,CAAC;AAG7B;;;GAGG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;gBAEb,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,sBAAsB;IAWtD;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;;;;;OASG;IACH,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,OAAqC,GAC9C,IAAI;IAcP;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAgBd,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGzC;AACD;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAqB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoCrD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAwBzE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAW,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAAE,UAAU,EAAyC,MAAM,OAAO,CAAC;AAK1E,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EAEtB,QAAQ,EAER,cAAc,EACf,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAI3C,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,IAAI,CAAa;gBAEb,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,sBAAsB;IAUtD,OAAO,CAAC,aAAa;IAOrB,wGAAwG;IACxG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAa7C,OAAO,CAAC,eAAe;IAcd,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGzC;AAED,8FAA8F;AAE9F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAqB5E;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmCrD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAwBzE"}

package/dist/logger/logger.interfaces.d.ts

@@ -38,6 +38,5 @@ export interface AxiosErrorResponse {
 }
 export interface LoggerTags extends EventContext {
     sdk_version: string;
-    is_sdk_log: boolean;
 }
 //# sourceMappingURL=logger.interfaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.interfaces.d.ts","sourceRoot":"","sources":["../../src/logger/logger.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,GAAG,CAAC;IAEhB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAE7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,cAAc,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAE3B,MAAM,EAAE,GAAG,CAAC;QACZ,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,uBAAuB,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"logger.interfaces.d.ts","sourceRoot":"","sources":["../../src/logger/logger.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,GAAG,CAAC;IAEhB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAE7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,cAAc,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAE3B,MAAM,EAAE,GAAG,CAAC;QACZ,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,uBAAuB,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/logger/logger.js

@@ -1,81 +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;
-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");
-const helpers_1 = require("../common/helpers");
+// ── 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);
-    }
-    /**
-     * 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 = (0, helpers_1.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 },
             });
         }
     }
@@ -93,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
@@ -124,21 +108,13 @@ 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 JSON.stringify(serializeAxiosError(error));
     }
     if (error instanceof Error) {
-        // Include error name (e.g. TypeError, RangeError) alongside message
-        // for easier debugging
+        // Include non-default error name (e.g. TypeError) for easier debugging
         return error.name !== 'Error'
             ? `${error.name}: ${error.message}`
             : error.message;
@@ -169,14 +145,6 @@ function serializeError(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 = {

package/dist/mappers/mappers.d.ts

@@ -1,52 +1,13 @@
-import { AxiosResponse } from 'axios';
-import { MappersCreateParams, MappersCreateResponse, MappersFactoryInterface, MappersGetByExternalIdParams, MappersGetByExternalIdResponse, MappersGetByTargetIdParams, MappersGetByTargetIdResponse, MappersUpdateParams, MappersUpdateResponse } from './mappers.interface';
-/**
- * Manages sync mapper records that link external system items to DevRev items.
- *
- * Used for tracking relationships between external and DevRev entities during sync operations.
- */
+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. */
 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>;
+    getByExternalId(params: MappersGetByExternalIdParams): Promise<MappersGetByExternalIdResponse>;
+    /** Called after importing an item to DevRev to record the mapping for future syncs. */
+    create(params: MappersCreateParams): Promise<MappersCreateResponse>;
+    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,mFAAmF;AACnF,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,CAAC;IAclC,eAAe,CACnB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,8BAA8B,CAAC;IAc1C,uFAAuF;IACjF,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAanE,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAY1E"}

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

@@ -0,0 +1,175 @@
+import { AirSyncEvent } from '../types/extraction';
+import { DonV2 } from '../types/loading';
+import { WorkerAdapterOptions } from '../types/workers';
+export interface MappersFactoryInterface {
+    event: AirSyncEvent;
+    options?: WorkerAdapterOptions;
+}
+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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"}