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

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

@@ -9,6 +9,12 @@ export declare class AttachmentsStreamingPool<ConnectorState> {
     private totalProcessedCount;
     private readonly PROGRESS_REPORT_INTERVAL;
     constructor({ adapter, attachments, batchSize, stream, }: AttachmentsStreamingPoolParams<ConnectorState>);
+    private recordProcessedAttachment;
+    /**
+     * Backfills `status` on entries recorded before the field existed (those
+     * only ever held successes); state from >= v1.15.2 needs no shape migration.
+     */
+    private backfillProcessedAttachmentStatus;
     private updateProgress;
     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":"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"}
+{"version":3,"file":"attachments-streaming-pool.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAE7B,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;IAQjD,OAAO,CAAC,yBAAyB;IAyBjC;;;OAGG;IACH,OAAO,CAAC,iCAAiC;YAS3B,cAAc;IAUtB,SAAS,IAAI,OAAO,CAAC,2BAA2B,CAAC;IA6CjD,kBAAkB;CAyFzB"}

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

@@ -1,6 +1,6 @@
-import { ExternalSystemAttachmentStreamingFunction } from '../types/extraction';
-import { NormalizedAttachment } from '../repo/repo.interfaces';
 import { ExtractionAdapter } from '../multithreading/adapters/extraction-adapter';
+import { NormalizedAttachment } from '../repo/repo.interfaces';
+import { ExternalSystemAttachmentStreamingFunction } from '../types/extraction';
 export interface AttachmentsStreamingPoolParams<ConnectorState> {
     adapter: ExtractionAdapter<ConnectorState>;
     attachments: NormalizedAttachment[];

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,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"}
+{"version":3,"file":"attachments-streaming-pool.interfaces.d.ts","sourceRoot":"","sources":["../../src/attachments-streaming/attachments-streaming-pool.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,yCAAyC,EAAE,MAAM,qBAAqB,CAAC;AAEhF,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,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttachmentsStreamingPool = void 0;
+const helpers_1 = require("../common/helpers");
+const state_interfaces_1 = require("../state/state.interfaces");
 class AttachmentsStreamingPool {
     constructor({ adapter, attachments, batchSize = 10, stream, }) {
         this.totalProcessedCount = 0;
@@ -11,14 +13,39 @@ class AttachmentsStreamingPool {
         this.delay = undefined;
         this.stream = stream;
     }
+    recordProcessedAttachment(attachment, status) {
+        var _a;
+        const attachmentsMetadata = (_a = this.adapter.sdkState.toDevRev) === null || _a === void 0 ? void 0 : _a.attachmentsMetadata;
+        if (!(attachmentsMetadata === null || attachmentsMetadata === void 0 ? void 0 : attachmentsMetadata.lastProcessedAttachmentsIdsList)) {
+            return;
+        }
+        const processedAttachmentsIdsList = attachmentsMetadata.lastProcessedAttachmentsIdsList;
+        const alreadyRecorded = processedAttachmentsIdsList.some((it) => it.id === attachment.id && it.parent_id === attachment.parent_id);
+        if (!alreadyRecorded) {
+            processedAttachmentsIdsList.push({
+                id: attachment.id,
+                parent_id: attachment.parent_id,
+                status,
+            });
+        }
+    }
+    /**
+     * Backfills `status` on entries recorded before the field existed (those
+     * only ever held successes); state from >= v1.15.2 needs no shape migration.
+     */
+    backfillProcessedAttachmentStatus(attachments) {
+        return attachments.map((it) => {
+            var _a;
+            return (Object.assign(Object.assign({}, it), { status: (_a = it.status) !== null && _a !== void 0 ? _a : state_interfaces_1.ProcessedAttachmentStatus.Success }));
+        });
+    }
     async updateProgress() {
         this.totalProcessedCount++;
         if (this.totalProcessedCount % this.PROGRESS_REPORT_INTERVAL === 0) {
             console.info(`Processed ${this.totalProcessedCount} attachments so far.`);
-            // 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));
+            // Let a pending soft-timeout message (WorkerMessageExit) be delivered so
+            // adapter.isTimeout can flip before the next batch is processed.
+            await (0, helpers_1.yieldToEventLoop)();
         }
     }
     async streamAll() {
@@ -28,53 +55,52 @@ class AttachmentsStreamingPool {
             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.
+        // Attachments processed (successfully or not) by a previous, possibly incomplete, run.
         if (!this.adapter.sdkState.toDevRev.attachmentsMetadata
             .lastProcessedAttachmentsIdsList) {
             this.adapter.sdkState.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList =
                 [];
         }
-        // Start initial batch of promises up to batchSize limit
+        this.adapter.sdkState.toDevRev.attachmentsMetadata.lastProcessedAttachmentsIdsList =
+            this.backfillProcessedAttachmentStatus(this.adapter.sdkState.toDevRev.attachmentsMetadata
+                .lastProcessedAttachmentsIdsList);
         const initialBatchSize = Math.min(this.batchSize, this.attachments.length);
         const initialPromises = [];
         for (let i = 0; i < initialBatchSize; i++) {
             initialPromises.push(this.startPoolStreaming());
         }
-        // Wait for all promises to complete
-        await Promise.all(initialPromises);
+        await Promise.race([
+            Promise.all(initialPromises),
+            this.adapter.timeoutSignal,
+        ]);
         if (this.delay) {
             return { delay: this.delay };
         }
         return {};
     }
     async startPoolStreaming() {
-        var _a, _b, _c, _d;
-        // Process attachments until the attachments array is empty
+        var _a;
         while (this.attachments.length > 0) {
-            // If delay is set, stop streaming
             if (this.delay) {
                 break;
             }
-            // If timeout is set, stop streaming
             if (this.adapter.isTimeout) {
                 console.log('Timeout detected while streaming attachments. Stopping streaming.');
                 break;
             }
-            // Check if we can process next attachment
             const attachment = this.attachments.shift();
             if (!attachment) {
-                break; // Exit if no more attachments
+                break;
             }
             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
+                continue; // Already processed in a previous run
             }
             try {
                 const response = await this.adapter.processAttachment(attachment, this.stream);
-                // Check if rate limit was hit
+                // Rate limit hit
                 if (response === null || response === void 0 ? void 0 : response.delay) {
-                    this.delay = response.delay; // Set the delay for rate limiting
+                    this.delay = response.delay;
                     return;
                 }
                 if (response === null || response === void 0 ? void 0 : response.error) {
@@ -86,12 +112,12 @@ class AttachmentsStreamingPool {
                         ? `and content_type ${attachment.content_type} `
                         : '';
                     console.warn(`Skipping attachment with ID ${attachment.id} with extension ${fileExtension} ${fileSizeInfo}${contentTypeInfo}due to error returned by the stream function`, response.error.message);
+                    this.recordProcessedAttachment(attachment, state_interfaces_1.ProcessedAttachmentStatus.Failed);
                     await this.updateProgress();
                     continue;
                 }
-                // No rate limiting, process normally
-                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 });
+                if (!this.adapter.isTimeout) {
+                    this.recordProcessedAttachment(attachment, state_interfaces_1.ProcessedAttachmentStatus.Success);
                 }
                 await this.updateProgress();
             }

package/dist/common/constants.d.ts

@@ -27,11 +27,9 @@ export declare const HARD_TIMEOUT_MULTIPLIER = 1.3;
 export declare const MEMORY_LOG_INTERVAL: number;
 export declare const DEFAULT_SLEEP_DELAY_MS: number;
 /**
- * Sentinel value representing an unbounded (no limit) extraction timestamp.
- * Used as the resolved value for TimeValueType.UNBOUNDED, stored as workersOldest
- * when the initial import has no lower time bound. The Unix epoch ensures that
- * no real extraction timestamp can be earlier, preventing accidental overwrites
- * of the boundary by subsequent syncs (e.g. reconciliation with absolute dates).
+ * Sentinel for an unbounded extraction timestamp (TimeValueType.UNBOUNDED),
+ * stored as workersOldest. The Unix epoch guarantees no real timestamp can be
+ * earlier, so subsequent syncs cannot accidentally overwrite the boundary.
  */
 export declare const UNBOUNDED_DATE_TIME_VALUE = "1970-01-01T00:00:00.000Z";
 //# sourceMappingURL=constants.d.ts.map

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;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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,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;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,6BAA6B,CAAC"}

package/dist/common/constants.js

@@ -45,7 +45,7 @@ exports.STATEFUL_EVENT_TYPES = [
 exports.ARTIFACT_BATCH_SIZE = 2000;
 exports.MAX_DEVREV_ARTIFACT_SIZE = 2 * 1024 * 1024 * 1024; // 2GB
 exports.MAX_DEVREV_FILENAME_LENGTH = 256;
-exports.MAX_DEVREV_FILENAME_EXTENSION_LENGTH = 20; // 20 characters for the file extension
+exports.MAX_DEVREV_FILENAME_EXTENSION_LENGTH = 20;
 // Max SQS message size is 250KB, we want to leave some room for the other data in the message
 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
@@ -64,10 +64,8 @@ exports.HARD_TIMEOUT_MULTIPLIER = 1.3;
 exports.MEMORY_LOG_INTERVAL = 30 * 1000; // 30 seconds
 exports.DEFAULT_SLEEP_DELAY_MS = 3 * 60 * 1000; // 3 minutes
 /**
- * Sentinel value representing an unbounded (no limit) extraction timestamp.
- * Used as the resolved value for TimeValueType.UNBOUNDED, stored as workersOldest
- * when the initial import has no lower time bound. The Unix epoch ensures that
- * no real extraction timestamp can be earlier, preventing accidental overwrites
- * of the boundary by subsequent syncs (e.g. reconciliation with absolute dates).
+ * Sentinel for an unbounded extraction timestamp (TimeValueType.UNBOUNDED),
+ * stored as workersOldest. The Unix epoch guarantees no real timestamp can be
+ * earlier, so subsequent syncs cannot accidentally overwrite the boundary.
  */
 exports.UNBOUNDED_DATE_TIME_VALUE = '1970-01-01T00:00:00.000Z';

package/dist/common/helpers.d.ts

@@ -1,24 +1,10 @@
-/**
- * Gets the library version from the package.json file.
- * @returns {string} The library version
- */
 export declare function getLibraryVersion(): any;
-/**
- * Sleeps for a given number of milliseconds.
- * @param {number} ms - The number of milliseconds to sleep
- * @returns {Promise<void>} A promise that resolves after the given number of milliseconds
- */
 export declare function sleep(ms: number): Promise<unknown>;
 /**
- * MemoryInfo is an interface that represents the memory usage information.
- * @interface MemoryInfo
- * @property {string} rssUsedMB - The RSS used in MB
- * @property {string} rssUsedPercent - The RSS used percentage
- * @property {string} heapUsedPercent - The heap used percentage
- * @property {string} externalMB - The external memory used in MB
- * @property {string} arrayBuffersMB - The array buffers memory used in MB
- * @property {string} formattedMessage - The formatted message
+ * Yields once to the event loop so pending events (e.g. worker messages) can
+ * be delivered before continuing.
  */
+export declare function yieldToEventLoop(): Promise<void>;
 export interface MemoryInfo {
     rssUsedMB: string;
     rssUsedPercent: string;
@@ -27,9 +13,5 @@ export interface MemoryInfo {
     arrayBuffersMB: string;
     formattedMessage: string;
 }
-/**
- * Gets the memory usage information.
- * @returns {MemoryInfo} The memory usage information
- */
 export declare function getMemoryUsage(): MemoryInfo;
 //# 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":"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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/common/helpers.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,QAiBhC;AAED,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,oBAErC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtD;AAED,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,wBAAgB,cAAc,IAAI,UAAU,CA+C3C"}

package/dist/common/helpers.js

@@ -35,14 +35,11 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLibraryVersion = getLibraryVersion;
 exports.sleep = sleep;
+exports.yieldToEventLoop = yieldToEventLoop;
 exports.getMemoryUsage = getMemoryUsage;
 const fs_1 = require("fs");
 const path = __importStar(require("path"));
 const v8 = __importStar(require("v8"));
-/**
- * Gets the library version from the package.json file.
- * @returns {string} The library version
- */
 function getLibraryVersion() {
     var _a;
     try {
@@ -57,18 +54,16 @@ function getLibraryVersion() {
         return '';
     }
 }
-/**
- * Sleeps for a given number of milliseconds.
- * @param {number} ms - The number of milliseconds to sleep
- * @returns {Promise<void>} A promise that resolves after the given number of milliseconds
- */
 async function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /**
- * Gets the memory usage information.
- * @returns {MemoryInfo} The memory usage information
+ * Yields once to the event loop so pending events (e.g. worker messages) can
+ * be delivered before continuing.
  */
+async function yieldToEventLoop() {
+    return new Promise((resolve) => setImmediate(resolve));
+}
 function getMemoryUsage() {
     try {
         const memUsage = process.memoryUsage();
@@ -76,16 +71,12 @@ function getMemoryUsage() {
         const rssUsedMB = memUsage.rss / 1024 / 1024;
         const heapLimitMB = heapStats.heap_size_limit / 1024 / 1024;
         const effectiveMemoryLimitMB = heapLimitMB;
-        // Calculate heap values for consistent format
         const heapUsedMB = heapStats.used_heap_size / 1024 / 1024;
         const heapTotalMB = heapStats.heap_size_limit / 1024 / 1024;
-        // Calculate external and buffer values (critical for detecting stream leaks)
         const externalMB = memUsage.external / 1024 / 1024;
         const arrayBuffersMB = memUsage.arrayBuffers / 1024 / 1024;
-        // Critical percentages for OOM detection
         const rssUsedPercent = ((rssUsedMB / effectiveMemoryLimitMB) * 100).toFixed(2) + '%';
         const heapUsedPercent = ((heapStats.used_heap_size / heapStats.heap_size_limit) * 100).toFixed(2) + '%';
-        // Detailed message showing RSS breakdown for leak detection
         const formattedMessage = `Memory: RSS ${rssUsedMB.toFixed(2)}/${effectiveMemoryLimitMB.toFixed(2)}MB (${rssUsedPercent}) [Heap ${heapUsedMB.toFixed(2)}/${heapTotalMB.toFixed(2)}MB (${heapUsedPercent}) + External ${externalMB.toFixed(2)}MB + Buffers ${arrayBuffersMB.toFixed(2)}MB].`;
         return {
             rssUsedMB: rssUsedMB.toFixed(2),

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

@@ -1 +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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,WAAW,+BAEf,CAAC;AAmFH,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/http/client.js

@@ -34,11 +34,10 @@ exports.axiosClient = axiosClient;
         var _a, _b, _c, _d, _e, _f, _g;
         const retryAfter = ((_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.headers) === null || _b === void 0 ? void 0 : _b['retry-after']) ||
             ((_d = (_c = error.response) === null || _c === void 0 ? void 0 : _c.headers) === null || _d === void 0 ? void 0 : _d['Retry-After']);
-        // 5xx errors
         if (((_e = error.response) === null || _e === void 0 ? void 0 : _e.status) && error.response.status >= 500) {
             return true;
         }
-        // 429 errors when retry-after header is present
+        // 429 only when a valid non-negative Retry-After header is present
         else if (((_f = error.response) === null || _f === void 0 ? void 0 : _f.status) &&
             error.response.status === 429 &&
             retryAfter &&
@@ -46,19 +45,16 @@ exports.axiosClient = axiosClient;
             Number(retryAfter) >= 0) {
             return true;
         }
-        // Network errors for idempotent requests if not 429, because 429 is handled above
+        // Network errors for idempotent requests; 429 already handled above
         else if (axios_retry_1.default.isNetworkOrIdempotentRequestError(error) &&
             ((_g = error.response) === null || _g === void 0 ? void 0 : _g.status) !== 429) {
             return true;
         }
-        // Request timeout errors (ECONNABORTED) — axios-retry explicitly excludes
-        // ECONNABORTED from isNetworkError, so we handle it here separately.
-        // Axios only produces ECONNABORTED on client-side timeouts and browser
-        // cancellations, never on server responses, so no response guard is needed.
+        // axios-retry excludes ECONNABORTED (client-side timeout only, never a
+        // server response) from isNetworkError, so handle it here separately.
         else if (error.code === 'ECONNABORTED') {
             return true;
         }
-        // all other errors
         else {
             return false;
         }

package/dist/index.d.ts

@@ -1,27 +1,27 @@
-export { processExtractionTask, processLoadingTask, } from './multithreading/process-task';
-export { spawn } from './multithreading/spawn/spawn';
 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 { processExtractionTask, processLoadingTask, } from './multithreading/process-task';
+export { spawn } from './multithreading/spawn/spawn';
+export type { ExtractionScope, ProcessTaskInterface, SpawnFactoryInterface, SpawnInterface, TaskAdapterInterface, TaskResult, TaskStatus, WorkerAdapterInterface, WorkerAdapterOptions, 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 { SyncMode } from './types/common';
 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 { EventType, ExtractorEventType, InitialSyncScope, TimeUnit, TimeValueType, } from './types/extraction';
 export type { ExternalSystemAttachment, ExternalSystemItem, ExternalSystemItemLoadingParams, ExternalSystemItemLoadingResponse, ItemTypeToLoad, } from './types/loading';
+export { LoaderEventType } 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 { SyncMapperRecordStatus, SyncMapperRecordTargetType, } 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 { 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, StageDiagram, StageKey, StateKey, StructData, StructType, StructTypeKey, TargetTypeKeyData, TextData, TypedReferenceData, } from './types/external-domain-metadata';
 export type { DeepPartial } from './testing/mock-event';
+export { createMockEvent } from './testing/mock-event';
+export { MOCK_SERVER_DEFAULT_URL, MockServer } from './testing/mock-server';
+export type { RequestInfo, RetryConfig, RouteConfig, } from './testing/mock-server.interfaces';
 //# 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,24 +1,21 @@
 "use strict";
 // ────────────────────────────────────────────────────────────────────────────
-// 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.
+// 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.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;
+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; } });
 // ── Constants & enums ──
 var constants_1 = require("./common/constants");
 Object.defineProperty(exports, "AirSyncDefaultItemTypes", { enumerable: true, get: function () { return constants_1.AirSyncDefaultItemTypes; } });
@@ -30,17 +27,14 @@ Object.defineProperty(exports, "installInitialDomainMapping", { enumerable: true
 // ── Error formatting ──
 var logger_1 = require("./logger/logger");
 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 ──
@@ -49,9 +43,8 @@ Object.defineProperty(exports, "Mappers", { enumerable: true, get: function () {
 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; } });
-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; } });
+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,87 +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;
-/**
- * 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.
+ * 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;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"}
+{"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"}