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

package/README.md

@@ -1,16 +1,14 @@
-# AirSync SDK
+# Airdrop SDK
 
-[![Coverage Status](https://coveralls.io/repos/github/devrev/adaas-sdk/badge.svg?branch=v2&t=s4Otlm)](https://coveralls.io/github/devrev/adaas-sdk?branch=v2)
-
-> **Note:** This is the v2 beta of the AirSync SDK (formerly Airdrop SDK). The package has been renamed from `@devrev/ts-adaas` to `@devrev/airsync-sdk`.
+[![Coverage Status](https://coveralls.io/repos/github/devrev/adaas-sdk/badge.svg?branch=main&t=s4Otlm)](https://coveralls.io/github/devrev/adaas-sdk?branch=main)
 
 ## Overview
 
-The AirSync SDK for TypeScript helps developers build snap-ins that integrate with DevRev's AirSync platform. This SDK simplifies the workflow for handling data extraction and loading, event-driven actions, state management, and artifact handling.
+The Airdrop SDK for TypeScript helps developers build snap-ins that integrate with DevRev’s Airdrop platform. This SDK simplifies the workflow for handling data extraction and loading, event-driven actions, state management, and artifact handling.
 
 It provides features such as:
 
-- Type Definitions: Structured types for AirSync control protocol
+- Type Definitions: Structured types for Airdrop control protocol
 - Event Management: Easily emit events for different extraction or loading phases
 - State Handling: Update and access state in real-time within tasks
 - Artifact Management: Supports batched storage of artifacts
@@ -19,9 +17,5 @@ It provides features such as:
 ## Installation
 
 ```bash
-npm install @devrev/airsync-sdk@beta
+npm install @devrev/airsync-sdk
 ```
-
-## Changelog
-
-See [CHANGELOG.md](./CHANGELOG.md) for release notes and migration guides.

package/dist/attachments-streaming/attachments-streaming-pool.d.ts

@@ -1,4 +1,4 @@
-import { ProcessAttachmentReturnType } from '../types';
+import { ProcessAttachmentReturnType } from '../types/extraction';
 import { AttachmentsStreamingPoolParams } from './attachments-streaming-pool.interfaces';
 export declare class AttachmentsStreamingPool<ConnectorState> {
     private adapter;
@@ -10,13 +10,6 @@ export declare class AttachmentsStreamingPool<ConnectorState> {
     private readonly PROGRESS_REPORT_INTERVAL;
     constructor({ adapter, attachments, batchSize, stream, }: AttachmentsStreamingPoolParams<ConnectorState>);
     private updateProgress;
-    /**
-     * Migrates processed attachments from the legacy string[] format to the new ProcessedAttachment[] format.
-     *
-     * @param attachments - The attachments list to migrate (either string[] or ProcessedAttachment[])
-     * @returns Migrated array of ProcessedAttachment objects, or empty array if input is invalid
-     */
-    private migrateProcessedAttachments;
     streamAll(): Promise<ProcessAttachmentReturnType>;
     startPoolStreaming(): Promise<void>;
 }

package/dist/attachments-streaming/attachments-streaming-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments-streaming-pool.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,qBAAa,wBAAwB,CAAC,cAAc;IAClD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAA4C;IAE1D,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAM;gBAEnC,EACV,OAAO,EACP,WAAW,EACX,SAAc,EACd,MAAM,GACP,EAAE,8BAA8B,CAAC,cAAc,CAAC;YAQnC,cAAc;IAS5B;;;;;OAKG;IAEH,OAAO,CAAC,2BAA2B;IAsB7B,SAAS,IAAI,OAAO,CAAC,2BAA2B,CAAC;IA8CjD,kBAAkB;CA0FzB"}
+{"version":3,"file":"attachments-streaming-pool.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,qBAAa,wBAAwB,CAAC,cAAc;IAClD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAA4C;IAE1D,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAM;gBAEnC,EACV,OAAO,EACP,WAAW,EACX,SAAc,EACd,MAAM,GACP,EAAE,8BAA8B,CAAC,cAAc,CAAC;YAQnC,cAAc;IAWtB,SAAS,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAuCjD,kBAAkB;CA0FzB"}

package/dist/attachments-streaming/attachments-streaming-pool.interfaces.d.ts

@@ -1,7 +1,8 @@
-import { ExternalSystemAttachmentStreamingFunction, NormalizedAttachment } from '../types';
-import { WorkerAdapter } from '../multithreading/worker-adapter/worker-adapter';
+import { ExternalSystemAttachmentStreamingFunction } from '../types/extraction';
+import { NormalizedAttachment } from '../repo/repo.interfaces';
+import { ExtractionAdapter } from '../multithreading/adapters/extraction-adapter';
 export interface AttachmentsStreamingPoolParams<ConnectorState> {
-    adapter: WorkerAdapter<ConnectorState>;
+    adapter: ExtractionAdapter<ConnectorState>;
     attachments: NormalizedAttachment[];
     batchSize?: number;
     stream: ExternalSystemAttachmentStreamingFunction;

package/dist/attachments-streaming/attachments-streaming-pool.interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments-streaming-pool.interfaces.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,EACzC,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAEhF,MAAM,WAAW,8BAA8B,CAAC,cAAc;IAC5D,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,yCAAyC,CAAC;CACnD"}
+{"version":3,"file":"attachments-streaming-pool.interfaces.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yCAAyC,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAElF,MAAM,WAAW,8BAA8B,CAAC,cAAc;IAC5D,OAAO,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC3C,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,yCAAyC,CAAC;CACnD"}

package/dist/attachments-streaming/attachments-streaming-pool.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttachmentsStreamingPool = void 0;
-const helpers_1 = require("../common/helpers");
 class AttachmentsStreamingPool {
     constructor({ adapter, attachments, batchSize = 10, stream, }) {
         this.totalProcessedCount = 0;
@@ -16,53 +15,26 @@ class AttachmentsStreamingPool {
         this.totalProcessedCount++;
         if (this.totalProcessedCount % this.PROGRESS_REPORT_INTERVAL === 0) {
             console.info(`Processed ${this.totalProcessedCount} attachments so far.`);
-            // Sleep for 100ms to avoid blocking the event loop
-            await (0, helpers_1.sleep)(100);
+            // Yield once to the event loop so a pending soft-timeout message
+            // (WorkerMessageExit) can be delivered and adapter.isTimeout can flip
+            // before the next batch of attachments is processed.
+            await new Promise((resolve) => setImmediate(resolve));
         }
     }
-    /**
-     * Migrates processed attachments from the legacy string[] format to the new ProcessedAttachment[] format.
-     *
-     * @param attachments - The attachments list to migrate (either string[] or ProcessedAttachment[])
-     * @returns Migrated array of ProcessedAttachment objects, or empty array if input is invalid
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    migrateProcessedAttachments(attachments) {
-        // Handle null/undefined
-        if (!attachments || !Array.isArray(attachments)) {
-            return [];
-        }
-        // If already migrated (first element is an object), return as-is
-        if (attachments.length > 0 && typeof attachments[0] === 'object') {
-            return attachments;
-        }
-        // Migrate old string[] format
-        if (attachments.length > 0 && typeof attachments[0] === 'string') {
-            return attachments.map((it) => ({
-                id: it,
-                parent_id: '',
-            }));
-        }
-        return [];
-    }
     async streamAll() {
         console.log(`Starting download of ${this.attachments.length} attachments, streaming ${this.batchSize} at once.`);
-        if (!this.adapter.state.toDevRev) {
+        if (!this.adapter.sdkState.toDevRev) {
             const error = new Error('toDevRev state is not initialized');
             console.error(error);
             return { error };
         }
         // Get the list of successfully processed attachments in previous (possibly incomplete) batch extraction.
         // If no such list exists, create an empty one.
-        if (!this.adapter.state.toDevRev.attachmentsMetadata
+        if (!this.adapter.sdkState.toDevRev.attachmentsMetadata
             .lastProcessedAttachmentsIdsList) {
-            this.adapter.state.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList =
+            this.adapter.sdkState.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList =
                 [];
         }
-        // Migrate old processed attachments to the new format.
-        this.adapter.state.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList =
-            this.migrateProcessedAttachments(this.adapter.state.toDevRev.attachmentsMetadata
-                .lastProcessedAttachmentsIdsList);
         // Start initial batch of promises up to batchSize limit
         const initialBatchSize = Math.min(this.batchSize, this.attachments.length);
         const initialPromises = [];
@@ -94,8 +66,8 @@ class AttachmentsStreamingPool {
             if (!attachment) {
                 break; // Exit if no more attachments
             }
-            if (this.adapter.state.toDevRev &&
-                ((_a = this.adapter.state.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList) === null || _a === void 0 ? void 0 : _a.some((it) => it.id == attachment.id && it.parent_id == attachment.parent_id))) {
+            if (this.adapter.sdkState.toDevRev &&
+                ((_a = this.adapter.sdkState.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList) === null || _a === void 0 ? void 0 : _a.some((it) => it.id == attachment.id && it.parent_id == attachment.parent_id))) {
                 continue; // Skip if the attachment ID is already processed
             }
             try {
@@ -118,8 +90,8 @@ class AttachmentsStreamingPool {
                     continue;
                 }
                 // No rate limiting, process normally
-                if ((_c = (_b = this.adapter.state.toDevRev) === null || _b === void 0 ? void 0 : _b.attachmentsMetadata) === null || _c === void 0 ? void 0 : _c.lastProcessedAttachmentsIdsList) {
-                    (_d = this.adapter.state.toDevRev) === null || _d === void 0 ? void 0 : _d.attachmentsMetadata.lastProcessedAttachmentsIdsList.push({ id: attachment.id, parent_id: attachment.parent_id });
+                if ((_c = (_b = this.adapter.sdkState.toDevRev) === null || _b === void 0 ? void 0 : _b.attachmentsMetadata) === null || _c === void 0 ? void 0 : _c.lastProcessedAttachmentsIdsList) {
+                    (_d = this.adapter.sdkState.toDevRev) === null || _d === void 0 ? void 0 : _d.attachmentsMetadata.lastProcessedAttachmentsIdsList.push({ id: attachment.id, parent_id: attachment.parent_id });
                 }
                 await this.updateProgress();
             }

package/dist/common/constants.d.ts

@@ -15,6 +15,7 @@ export declare const MAX_DEVREV_FILENAME_EXTENSION_LENGTH = 20;
 export declare const MAX_EVENT_SIZE_BYTES = 200000;
 export declare const EVENT_SIZE_THRESHOLD_BYTES: number;
 export declare const SSOR_ATTACHMENT: string;
+export declare const UNKNOWN_EVENT_TYPE = "UNKNOWN_EVENT_TYPE";
 export declare enum AirSyncDefaultItemTypes {
     EXTERNAL_DOMAIN_METADATA = "external_domain_metadata",
     ATTACHMENTS = "attachments",

package/dist/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,eAAO,MAAM,8BAA8B,aAS1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,aAKvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAG/B,CAAC;AAEF,eAAO,MAAM,gCAAgC,aAI5C,CAAC;AAEF,eAAO,MAAM,6BAA6B,aAGzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,aAGjC,CAAC;AAEF,eAAO,MAAM,+BAA+B,aAGzC,CAAC;AAEJ,eAAO,MAAM,4BAA4B,aAExC,CAAC;AAEF,eAAO,MAAM,oBAAoB,aAGhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAGvD,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAA0B,CAAC;AAEzD,oBAAY,uBAAuB;IACjC,wBAAwB,6BAA6B;IACrD,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,eAAe,KAAsB,CAAC;AAEnD,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AACrD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAE7C,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,6BAA6B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,eAAO,MAAM,8BAA8B,aAS1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,aAKvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAG/B,CAAC;AAEF,eAAO,MAAM,gCAAgC,aAI5C,CAAC;AAEF,eAAO,MAAM,6BAA6B,aAGzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,aAGjC,CAAC;AAEF,eAAO,MAAM,+BAA+B,aAGzC,CAAC;AAEJ,eAAO,MAAM,4BAA4B,aAExC,CAAC;AAEF,eAAO,MAAM,oBAAoB,aAGhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAGvD,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAA0B,CAAC;AACzD,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,oBAAY,uBAAuB;IACjC,wBAAwB,6BAA6B;IACrD,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,eAAe,KAAsB,CAAC;AAEnD,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AACrD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAE7C,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,6BAA6B,CAAC"}

package/dist/common/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNBOUNDED_DATE_TIME_VALUE = exports.DEFAULT_SLEEP_DELAY_MS = exports.MEMORY_LOG_INTERVAL = exports.HARD_TIMEOUT_MULTIPLIER = exports.DEFAULT_LAMBDA_TIMEOUT = exports.LIBRARY_VERSION = exports.AirSyncDefaultItemTypes = exports.SSOR_ATTACHMENT = exports.EVENT_SIZE_THRESHOLD_BYTES = exports.MAX_EVENT_SIZE_BYTES = exports.MAX_DEVREV_FILENAME_EXTENSION_LENGTH = exports.MAX_DEVREV_FILENAME_LENGTH = exports.MAX_DEVREV_ARTIFACT_SIZE = exports.ARTIFACT_BATCH_SIZE = exports.STATEFUL_EVENT_TYPES = exports.STATEFUL_LOADING_EVENT_TYPES = exports.STATEFUL_EXTRACTION_EVENT_TYPES = exports.STATELESS_EVENT_TYPES = exports.STATELESS_LOADING_EVENT_TYPES = exports.STATELESS_EXTRACTION_EVENT_TYPES = exports.ALLOWED_EVENT_TYPES = exports.ALLOWED_LOADING_EVENT_TYPES = exports.ALLOWED_EXTRACTION_EVENT_TYPES = void 0;
+exports.UNBOUNDED_DATE_TIME_VALUE = exports.DEFAULT_SLEEP_DELAY_MS = exports.MEMORY_LOG_INTERVAL = exports.HARD_TIMEOUT_MULTIPLIER = exports.DEFAULT_LAMBDA_TIMEOUT = exports.LIBRARY_VERSION = exports.AirSyncDefaultItemTypes = exports.UNKNOWN_EVENT_TYPE = exports.SSOR_ATTACHMENT = exports.EVENT_SIZE_THRESHOLD_BYTES = exports.MAX_EVENT_SIZE_BYTES = exports.MAX_DEVREV_FILENAME_EXTENSION_LENGTH = exports.MAX_DEVREV_FILENAME_LENGTH = exports.MAX_DEVREV_ARTIFACT_SIZE = exports.ARTIFACT_BATCH_SIZE = exports.STATEFUL_EVENT_TYPES = exports.STATEFUL_LOADING_EVENT_TYPES = exports.STATEFUL_EXTRACTION_EVENT_TYPES = exports.STATELESS_EVENT_TYPES = exports.STATELESS_LOADING_EVENT_TYPES = exports.STATELESS_EXTRACTION_EVENT_TYPES = exports.ALLOWED_EVENT_TYPES = exports.ALLOWED_LOADING_EVENT_TYPES = exports.ALLOWED_EXTRACTION_EVENT_TYPES = void 0;
 const extraction_1 = require("../types/extraction");
 const helpers_1 = require("./helpers");
 exports.ALLOWED_EXTRACTION_EVENT_TYPES = [
@@ -51,6 +51,7 @@ exports.MAX_EVENT_SIZE_BYTES = 200000;
 // We want to leave some room for the other data in the message and process the rest of queued messages
 exports.EVENT_SIZE_THRESHOLD_BYTES = Math.floor(exports.MAX_EVENT_SIZE_BYTES * 0.8);
 exports.SSOR_ATTACHMENT = 'ssor_attachment';
+exports.UNKNOWN_EVENT_TYPE = 'UNKNOWN_EVENT_TYPE';
 var AirSyncDefaultItemTypes;
 (function (AirSyncDefaultItemTypes) {
     AirSyncDefaultItemTypes["EXTERNAL_DOMAIN_METADATA"] = "external_domain_metadata";

package/dist/common/helpers.d.ts

@@ -9,12 +9,6 @@ export declare function getLibraryVersion(): any;
  * @returns {Promise<void>} A promise that resolves after the given number of milliseconds
  */
 export declare function sleep(ms: number): Promise<unknown>;
-/**
- * Truncates a filename if it exceeds the maximum allowed length.
- * @param {string} filename - The filename to truncate
- * @returns {string} The truncated filename
- */
-export declare function truncateFilename(filename: string): string;
 /**
  * MemoryInfo is an interface that represents the memory usage information.
  * @interface MemoryInfo
@@ -38,12 +32,4 @@ export interface MemoryInfo {
  * @returns {MemoryInfo} The memory usage information
  */
 export declare function getMemoryUsage(): MemoryInfo;
-/**
- * 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
- */
-export declare function truncateMessage(message: string): string;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/common/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/common/helpers.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,iBAAiB,QAiBhC;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,oBAGrC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBzD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAmD3C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOvD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/common/helpers.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,iBAAiB,QAiBhC;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,oBAErC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAmD3C"}

package/dist/common/helpers.js

@@ -35,14 +35,10 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLibraryVersion = getLibraryVersion;
 exports.sleep = sleep;
-exports.truncateFilename = truncateFilename;
 exports.getMemoryUsage = getMemoryUsage;
-exports.truncateMessage = truncateMessage;
 const fs_1 = require("fs");
 const path = __importStar(require("path"));
 const v8 = __importStar(require("v8"));
-const constants_1 = require("./constants");
-const logger_constants_1 = require("../logger/logger.constants");
 /**
  * Gets the library version from the package.json file.
  * @returns {string} The library version
@@ -67,27 +63,8 @@ function getLibraryVersion() {
  * @returns {Promise<void>} A promise that resolves after the given number of milliseconds
  */
 async function sleep(ms) {
-    console.log(`Sleeping for ${ms}ms.`);
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-/**
- * Truncates a filename if it exceeds the maximum allowed length.
- * @param {string} filename - The filename to truncate
- * @returns {string} The truncated filename
- */
-function truncateFilename(filename) {
-    // If the filename is already within the limit, return it as is.
-    if (filename.length <= constants_1.MAX_DEVREV_FILENAME_LENGTH) {
-        return filename;
-    }
-    console.warn(`Filename length exceeds the maximum limit of ${constants_1.MAX_DEVREV_FILENAME_LENGTH} characters. Truncating filename.`);
-    const extension = filename.slice(-constants_1.MAX_DEVREV_FILENAME_EXTENSION_LENGTH);
-    // Calculate how many characters are available for the name part after accounting for the extension and "..."
-    const availableNameLength = constants_1.MAX_DEVREV_FILENAME_LENGTH - constants_1.MAX_DEVREV_FILENAME_EXTENSION_LENGTH - 3; // -3 for "..."
-    // Truncate the name part and add an ellipsis
-    const truncatedFilename = filename.slice(0, availableNameLength);
-    return `${truncatedFilename}...${extension}`;
-}
 /**
  * Gets the memory usage information.
  * @returns {MemoryInfo} The memory usage information
@@ -124,16 +101,3 @@ function getMemoryUsage() {
         throw err;
     }
 }
-/**
- * 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
- */
-function 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;
-}

package/dist/http/{axios-client-internal.d.ts → client.d.ts}

@@ -1,3 +1,3 @@
 declare const axiosClient: import("axios").AxiosInstance;
 export { axiosClient };
-//# sourceMappingURL=axios-client-internal.d.ts.map
+//# sourceMappingURL=client.d.ts.map

package/dist/http/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,WAAW,+BAEf,CAAC;AAyFH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,15 +1,27 @@
-export { AirSyncDefaultItemTypes } from './common/constants';
-export { ExtractionCommonError } from './common/errors';
-export * from './common/install-initial-domain-mapping';
-export * from './http';
-export { serializeAxiosError } from './logger/logger';
-export { MockServer } from './mock-server/mock-server';
-export type { RequestInfo, RetryConfig, RouteConfig, } from './mock-server/mock-server.interfaces';
-export { processTask } from './multithreading/process-task';
+export { processExtractionTask, processLoadingTask, } from './multithreading/process-task';
 export { spawn } from './multithreading/spawn/spawn';
-export { WorkerAdapter } from './multithreading/worker-adapter/worker-adapter';
-export { createMockEvent, MOCK_SERVER_DEFAULT_URL } from './common/test-utils';
-export type { DeepPartial } from './common/test-utils';
-export * from './types';
-export * from './types/workers';
+export { ExtractionAdapter } from './multithreading/adapters/extraction-adapter';
+export { LoadingAdapter } from './multithreading/adapters/loading-adapter';
+export type { ProcessTaskInterface, TaskAdapterInterface, TaskResult, TaskStatus, WorkerAdapterInterface, WorkerAdapterOptions, SpawnFactoryInterface, SpawnInterface, ExtractionScope, WorkerPathOverrides, } from './types/workers';
+export { AirSyncDefaultItemTypes } from './common/constants';
+export { UNBOUNDED_DATE_TIME_VALUE } from './common/constants';
+export { ExtractionCommonError } from './types/errors';
+export { installInitialDomainMapping } from './state/install-initial-domain-mapping';
+export { serializeError } from './logger/logger';
+export { SyncMode } from './types/common';
+export type { ErrorRecord, InitialDomainMapping } from './types/common';
+export { EventType, ExtractorEventType, InitialSyncScope, TimeUnit, TimeValueType, } from './types/extraction';
+export type { AirSyncEvent, AirSyncMessage, ConnectionData, EventContext, EventData, ExternalProcessAttachmentFunction, ExternalSyncUnit, ExternalSystemAttachmentIteratorFunction, ExternalSystemAttachmentReducerFunction, ExternalSystemAttachmentStreamingFunction, ExternalSystemAttachmentStreamingParams, ExternalSystemAttachmentStreamingResponse, ExtractorEvent, HttpStreamResponse, ProcessAttachmentReturnType, TimeValue, } from './types/extraction';
+export { LoaderEventType } from './types/loading';
+export type { ExternalSystemAttachment, ExternalSystemItem, ExternalSystemItemLoadingParams, ExternalSystemItemLoadingResponse, ItemTypeToLoad, } from './types/loading';
+export type { Item, NormalizedAttachment, NormalizedItem, RepoInterface, } from './repo/repo.interfaces';
+export { Mappers } from './mappers/mappers';
+export { SyncMapperRecordStatus, SyncMapperRecordTargetType, } from './mappers/mappers.interfaces';
+export type { MappersCreateParams, MappersGetByExternalIdParams, MappersGetByTargetIdParams, MappersUpdateParams, } from './mappers/mappers.interfaces';
+export type { Artifact, ArtifactsPrepareResponse, SsorAttachment, StreamAttachmentsResponse, StreamResponse, UploadResponse, } from './uploader/uploader.interfaces';
+export type { CollectionData, ConditionalPrivilegeData, CustomLinkData, CustomLinkNames, CustomStage, CustomState, EnumData, EnumValue, EnumValueKey, ExternalDomainMetadata, Field, FieldCondition, FieldConditionComparator, FieldConditionEffect, FieldConditions, FieldKey, FieldPrivilegeData, FieldReferenceData, FieldType, FloatData, IntData, PermissionData, RecordType, RecordTypeCategory, RecordTypeCategoryKey, RecordTypeKey, RecordTypePrivilegeData, RecordTypeScope, ReferenceData, ReferenceDetail, ReferenceType, SchemaVersion, StageKey, StageDiagram, StateKey, StructData, StructTypeKey, StructType, TargetTypeKeyData, TextData, TypedReferenceData, } from './types/external-domain-metadata';
+export { MockServer, MOCK_SERVER_DEFAULT_URL } from './testing/mock-server';
+export type { RequestInfo, RetryConfig, RouteConfig, } from './testing/mock-server.interfaces';
+export { createMockEvent } from './testing/mock-event';
+export type { DeepPartial } from './testing/mock-event';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,36 +1,57 @@
 "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.
+//
+// This is the SINGLE source of the public surface — every exported symbol is
+// named explicitly (no `export *`), so any change to the public API shows up as
+// a diff here. Adding a symbol to the package's public contract means adding it
+// to this file.
+// ────────────────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MOCK_SERVER_DEFAULT_URL = exports.createMockEvent = exports.WorkerAdapter = exports.spawn = exports.processTask = exports.MockServer = exports.serializeAxiosError = exports.AirSyncDefaultItemTypes = void 0;
+exports.createMockEvent = exports.MOCK_SERVER_DEFAULT_URL = exports.MockServer = 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.LoadingAdapter = exports.ExtractionAdapter = exports.spawn = exports.processLoadingTask = exports.processExtractionTask = void 0;
+// ── Entry points & adapters ──
+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; } });
+// ── Constants & enums ──
 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 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, "serializeAxiosError", { enumerable: true, get: function () { return logger_1.serializeAxiosError; } });
-var mock_server_1 = require("./mock-server/mock-server");
+Object.defineProperty(exports, "serializeError", { enumerable: true, get: function () { return logger_1.serializeError; } });
+// ── Common types ──
+var common_1 = require("./types/common");
+Object.defineProperty(exports, "SyncMode", { enumerable: true, get: function () { return common_1.SyncMode; } });
+// ── Extraction types ──
+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; } });
+// ── Loading types ──
+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; } });
+// ── Testing utilities (public test-support surface) ──
+var mock_server_1 = require("./testing/mock-server");
 Object.defineProperty(exports, "MockServer", { enumerable: true, get: function () { return mock_server_1.MockServer; } });
-var process_task_1 = require("./multithreading/process-task");
-Object.defineProperty(exports, "processTask", { enumerable: true, get: function () { return process_task_1.processTask; } });
-var spawn_1 = require("./multithreading/spawn/spawn");
-Object.defineProperty(exports, "spawn", { enumerable: true, get: function () { return spawn_1.spawn; } });
-var worker_adapter_1 = require("./multithreading/worker-adapter/worker-adapter");
-Object.defineProperty(exports, "WorkerAdapter", { enumerable: true, get: function () { return worker_adapter_1.WorkerAdapter; } });
-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);
+Object.defineProperty(exports, "MOCK_SERVER_DEFAULT_URL", { enumerable: true, get: function () { return mock_server_1.MOCK_SERVER_DEFAULT_URL; } });
+var mock_event_1 = require("./testing/mock-event");
+Object.defineProperty(exports, "createMockEvent", { enumerable: true, get: function () { return mock_event_1.createMockEvent; } });

package/dist/logger/logger.d.ts

@@ -1,6 +1,20 @@
 import { AxiosError } from 'axios';
 import { Console } from 'node:console';
+import { InspectOptions } from 'node:util';
 import { AxiosErrorResponse, LoggerFactoryInterface, LogLevel, PrintableState } from './logger.interfaces';
+export declare const MAX_LOG_STRING_LENGTH = 10000;
+export declare const INSPECT_OPTIONS: InspectOptions;
+/**
+ * Truncates a message that exceeds the maximum length, appending a suffix
+ * noting how many characters were omitted.
+ */
+export declare function truncateMessage(message: string): string;
+/** Runs `fn` with logs marked as user-originated (`is_sdk_log: false`). */
+export declare function runWithUserLogContext<T>(fn: () => T): T;
+/** Runs `fn` with logs marked as SDK-originated (`is_sdk_log: true`). */
+export declare function runWithSdkLogContext<T>(fn: () => T): T;
+/** Returns the current context flag, or `defaultValue` if none is set. */
+export declare function getSdkLogContextValue(defaultValue: boolean): boolean;
 /**
  * Custom logger that extends Node.js Console with context-aware logging.
  * Handles local development, main thread, and worker thread logging differently.

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,UAAU,EAAyC,MAAM,OAAO,CAAC;AAG1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAW,cAAc,EAAE,MAAM,WAAW,CAAC;AAMpD,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;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOvD;AAYD,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvD;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAMpE;AAED;;;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"}

package/dist/logger/logger.js

@@ -1,19 +1,66 @@
 "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.runWithUserLogContext = runWithUserLogContext;
+exports.runWithSdkLogContext = runWithSdkLogContext;
+exports.getSdkLogContextValue = getSdkLogContextValue;
 exports.getPrintableState = getPrintableState;
 exports.serializeError = serializeError;
 exports.serializeAxiosError = serializeAxiosError;
 const axios_1 = require("axios");
+const node_async_hooks_1 = require("node:async_hooks");
 const node_console_1 = require("node:console");
 const node_util_1 = require("node:util");
 const node_worker_threads_1 = require("node:worker_threads");
 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,
+};
+/**
+ * Truncates a message that exceeds the maximum length, appending a suffix
+ * noting how many characters were omitted.
+ */
+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;
+}
+// ── SDK log context ──
+/**
+ * Async-aware flag tracking whether code is running in SDK internals (`true`)
+ * or user-provided handlers (`false`). AsyncLocalStorage propagates the value
+ * across await/Promise/timer boundaries, so logs stay correctly attributed
+ * without threading the flag through call signatures.
+ */
+const sdkLogContext = new node_async_hooks_1.AsyncLocalStorage();
+/** Runs `fn` with logs marked as user-originated (`is_sdk_log: false`). */
+function runWithUserLogContext(fn) {
+    return sdkLogContext.run(false, fn);
+}
+/** Runs `fn` with logs marked as SDK-originated (`is_sdk_log: true`). */
+function runWithSdkLogContext(fn) {
+    return sdkLogContext.run(true, fn);
+}
+/** Returns the current context flag, or `defaultValue` if none is set. */
+function getSdkLogContextValue(defaultValue) {
+    const storeValue = sdkLogContext.getStore();
+    if (typeof storeValue === 'boolean') {
+        return storeValue;
+    }
+    return defaultValue;
+}
 /**
  * Custom logger that extends Node.js Console with context-aware logging.
  * Handles local development, main thread, and worker thread logging differently.
@@ -35,7 +82,7 @@ class Logger extends node_console_1.Console {
         if (typeof value === 'string') {
             return value;
         }
-        return (0, node_util_1.inspect)(value, logger_constants_1.INSPECT_OPTIONS);
+        return (0, node_util_1.inspect)(value, exports.INSPECT_OPTIONS);
     }
     /**
      * Logs a pre-formatted message string to the console.
@@ -47,7 +94,7 @@ class Logger extends node_console_1.Console {
      * @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)) {
+    logFn(message, level, isSdkLog = getSdkLogContextValue(true)) {
         var _a;
         if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.isLocalDevelopment) {
             this.originalConsole[level](message);
@@ -67,8 +114,8 @@ class Logger extends node_console_1.Console {
      */
     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);
+        const isSdkLog = getSdkLogContextValue(true);
         if (node_worker_threads_1.isMainThread) {
             this.logFn(stringifiedArgs, level, isSdkLog);
         }