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

package/dist/repo/repo.d.ts

@@ -10,6 +10,16 @@ export declare class Repo {
     private onUpload;
     private options?;
     uploadedArtifacts: Artifact[];
+    dateRanges: {
+        creationDate: {
+            oldest?: number;
+            newest?: number;
+        };
+        modifiedDate: {
+            oldest?: number;
+            newest?: number;
+        };
+    };
     constructor({ event, itemType, normalize, onUpload, options, }: RepoFactoryInterface);
     getItems(): (NormalizedItem | NormalizedAttachment | Item)[];
     upload(batch?: (NormalizedItem | NormalizedAttachment | Item)[]): Promise<void | ErrorRecord>;

package/dist/repo/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/repo/repo.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAI3D,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,IAAI;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,SAAS,CAAC,CAAwD;IAC1E,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,OAAO,CAAC,CAAuB;IAChC,iBAAiB,EAAE,QAAQ,EAAE,CAAC;gBAEzB,EACV,KAAK,EACL,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,GACR,EAAE,oBAAoB;IAUvB,QAAQ,IAAI,CAAC,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAAC,EAAE;IAItD,MAAM,CACV,KAAK,CAAC,EAAE,CAAC,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAAC,EAAE,GACvD,OAAO,CAAC,IAAI,GAAG,WAAW,CAAC;IAqCxB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAyC5C"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/repo/repo.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,IAAI;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,SAAS,CAAC,CAAwD;IAC1E,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,OAAO,CAAC,CAAuB;IAChC,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAC9B,UAAU,EAAE;QACjB,YAAY,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnD,YAAY,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD,CAGC;gBAEU,EACV,KAAK,EACL,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,GACR,EAAE,oBAAoB;IAUvB,QAAQ,IAAI,CAAC,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAAC,EAAE;IAItD,MAAM,CACV,KAAK,CAAC,EAAE,CAAC,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAAC,EAAE,GACvD,OAAO,CAAC,IAAI,GAAG,WAAW,CAAC;IAsDxB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAkC5C"}

package/dist/repo/repo.helpers.d.ts

@@ -0,0 +1,6 @@
+export declare function updateRange(range: {
+    oldest?: number;
+    newest?: number;
+}, ms: number): void;
+export declare function toValidTimestamp(value: string): number | undefined;
+//# sourceMappingURL=repo.helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo.helpers.d.ts","sourceRoot":"","sources":["../../src/repo/repo.helpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CACzB,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,EAAE,EAAE,MAAM,GACT,IAAI,CAON;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlE"}

package/dist/repo/repo.helpers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateRange = updateRange;
+exports.toValidTimestamp = toValidTimestamp;
+function updateRange(range, ms) {
+    if (range.oldest === undefined || ms < range.oldest) {
+        range.oldest = ms;
+    }
+    if (range.newest === undefined || ms > range.newest) {
+        range.newest = ms;
+    }
+}
+function toValidTimestamp(value) {
+    const ms = new Date(value).getTime();
+    return Number.isFinite(ms) ? ms : undefined;
+}

package/dist/repo/repo.interfaces.d.ts

@@ -1,17 +1,12 @@
-import { Artifact } from '../uploader/uploader.interfaces';
 import { AirSyncEvent } from '../types/extraction';
 import { WorkerAdapterOptions } from '../types/workers';
-/**
- * RepoInterface is an interface that defines the structure of a repo which is used to store and upload extracted data.
- */
+import { Artifact } from '../uploader/uploader.interfaces';
+/** Stores and uploads extracted data. */
 export interface RepoInterface {
     itemType: string;
     normalize?: (record: object) => NormalizedItem | NormalizedAttachment;
     overridenOptions?: WorkerAdapterOptions;
 }
-/**
- * RepoFactoryInterface is an interface that defines the structure of a repo factory which is used to create a repo.
- */
 export interface RepoFactoryInterface {
     event: AirSyncEvent;
     itemType: string;
@@ -19,18 +14,12 @@ export interface RepoFactoryInterface {
     onUpload: (artifact: Artifact) => void;
     options?: WorkerAdapterOptions;
 }
-/**
- * NormalizedItem is an interface of item after normalization.
- */
 export interface NormalizedItem {
     id: string;
     created_date: string;
     modified_date: string;
     data: object;
 }
-/**
- * NormalizedAttachment is an interface of attachment after normalization.
- */
 export interface NormalizedAttachment {
     url: string;
     id: string;
@@ -39,10 +28,9 @@ export interface NormalizedAttachment {
     author_id?: string;
     inline?: boolean;
     content_type?: string;
+    created_date?: string;
+    modified_date?: string;
     grand_parent_id?: number | string;
 }
-/**
- * Item is an interface that defines the structure of an item.
- */
 export type Item = Record<string, any>;
 //# sourceMappingURL=repo.interfaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"repo.interfaces.d.ts","sourceRoot":"","sources":["../../src/repo/repo.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,oBAAoB,CAAC;IACtE,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,oBAAoB,CAAC;IACtE,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAItB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED;;GAEG;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"repo.interfaces.d.ts","sourceRoot":"","sources":["../../src/repo/repo.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,oBAAoB,CAAC;IACtE,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,oBAAoB,CAAC;IACtE,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAGD,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}

package/dist/repo/repo.js

@@ -3,9 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Repo = void 0;
 const constants_1 = require("../common/constants");
 const uploader_1 = require("../uploader/uploader");
-const logger_context_1 = require("../logger/logger.context");
+const repo_helpers_1 = require("./repo.helpers");
 class Repo {
     constructor({ event, itemType, normalize, onUpload, options, }) {
+        this.dateRanges = {
+            creationDate: {},
+            modifiedDate: {},
+        };
         this.items = [];
         this.itemType = itemType;
         this.normalize = normalize;
@@ -20,6 +24,22 @@ class Repo {
     async upload(batch) {
         const itemsToUpload = batch || this.items;
         if (itemsToUpload.length > 0) {
+            for (const item of itemsToUpload) {
+                const createdDate = item === null || item === void 0 ? void 0 : item.created_date;
+                if (createdDate != null) {
+                    const createdMs = (0, repo_helpers_1.toValidTimestamp)(createdDate);
+                    if (createdMs !== undefined) {
+                        (0, repo_helpers_1.updateRange)(this.dateRanges.creationDate, createdMs);
+                    }
+                }
+                const modifiedDate = item === null || item === void 0 ? void 0 : item.modified_date;
+                if (modifiedDate != null && modifiedDate !== '') {
+                    const modifiedMs = (0, repo_helpers_1.toValidTimestamp)(modifiedDate);
+                    if (modifiedMs !== undefined) {
+                        (0, repo_helpers_1.updateRange)(this.dateRanges.modifiedDate, modifiedMs);
+                    }
+                }
+            }
             console.log(`Uploading ${itemsToUpload.length} items of type ${this.itemType}. `);
             const { artifact, error } = await this.uploader.upload(this.itemType, itemsToUpload);
             if (error || !artifact) {
@@ -28,7 +48,7 @@ class Repo {
             }
             this.onUpload(artifact);
             this.uploadedArtifacts.push(artifact);
-            // Clear the uploaded items from the main items array if no batch was specified
+            // An explicit batch was already spliced out of this.items by the caller
             if (!batch) {
                 this.items = [];
             }
@@ -45,24 +65,19 @@ class Repo {
             console.log(`No items to push for type ${this.itemType}. Skipping push.`);
             return true;
         }
-        // Normalize items if needed
         if (this.normalize &&
             this.itemType != constants_1.AirSyncDefaultItemTypes.EXTERNAL_DOMAIN_METADATA &&
             this.itemType != constants_1.SSOR_ATTACHMENT) {
-            recordsToPush = (0, logger_context_1.runWithUserLogContext)(() => items.map((item) => this.normalize(item)));
+            recordsToPush = items.map((item) => this.normalize(item));
         }
         else {
             recordsToPush = items;
         }
-        // Add the new records to the items array
         this.items.push(...recordsToPush);
-        // Upload in batches while the number of items exceeds the batch size
         const batchSize = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.batchSize) || constants_1.ARTIFACT_BATCH_SIZE;
         while (this.items.length >= batchSize) {
-            // Slice out a batch of batchSize items to upload
             const batch = this.items.splice(0, batchSize);
             try {
-                // Upload the batch
                 await this.upload(batch);
             }
             catch (error) {

package/dist/state/base-state.d.ts

@@ -1,19 +1,13 @@
 import { InitialDomainMapping } from '../types/common';
 import { AirSyncEvent } from '../types/extraction';
 import { ExtractionScope } from '../types/workers';
-import { BaseSdkState, StateInterface } from './state.interfaces';
+import { SdkState, StateInterface } from './state.interfaces';
 /**
- * BaseState owns the state lifecycle shared by every sync mode: connector vs.
- * SDK state separation, fetch/init/post against the platform, the v1->v2
- * migration shim, and the snap-in-version-gated initial domain mapping install.
- *
- * Mode-specific subclasses (`ExtractionState`, `LoadingState`) narrow `sdkState`
- * to their own SDK state shape and add mode-specific setup in their factories.
- *
- * @typeParam ConnectorState - the connector-owned state shape
- * @typeParam SdkState - the SDK bookkeeping shape for this mode
+ * State lifecycle shared by all sync modes: connector/SDK state separation,
+ * fetch/init/post, the v1->v2 migration shim, and the snap-in-version-gated
+ * initial domain mapping install. Subclasses seed the SDK-owned state.
  */
-export declare abstract class BaseState<ConnectorState, SdkState extends BaseSdkState> {
+export declare abstract class BaseState<ConnectorState> {
     protected _connectorState: ConnectorState;
     protected _sdkState: SdkState;
     protected _extractionScope: ExtractionScope;
@@ -24,7 +18,7 @@ export declare abstract class BaseState<ConnectorState, SdkState extends BaseSdk
     private syncUnitId;
     private requestId;
     constructor({ event, initialState }: StateInterface<ConnectorState>, initialSdkState: SdkState);
-    /** Connector-owned state. This is what `adapter.state` exposes to snap-in code. */
+    /** Connector-owned state; what `adapter.state` exposes to snap-in code. */
     get state(): ConnectorState;
     set state(value: ConnectorState);
     /** SDK-internal bookkeeping state. Never exposed to connector code. */
@@ -32,41 +26,25 @@ export declare abstract class BaseState<ConnectorState, SdkState extends BaseSdk
     set sdkState(value: SdkState);
     get extractionScope(): ExtractionScope;
     /**
-     * Installs the initial domain mapping when the snap-in version in state does
-     * not match the version in the event context. Shared by all modes so that a
-     * loading run still installs the mapping if extraction has not done so.
+     * Installs the initial domain mapping when the snap-in version in state
+     * differs from the event context. Shared by all modes so a loading run still
+     * installs the mapping if extraction has not done so.
      */
     installInitialDomainMappingIfNeeded(initialDomainMapping?: InitialDomainMapping): Promise<void>;
     /**
-     * Initializes the state for this adapter instance by fetching from API
-     * or creating an initial state if none exists (404).
-     *
-     * Reads both the v2 `{ connectorState, sdkState }` envelope and a legacy flat
-     * v1 blob (connector keys merged with SDK keys), migrating the latter on read.
-     * Always persists the v2 envelope going forward.
-     * @param initialState The initial connector state provided by the spawn function
+     * Fetches state from API, or creates the initial state on 404. Reads both
+     * the v2 envelope and a legacy flat v1 blob (migrated on read); always
+     * persists the v2 envelope going forward.
      */
     init(initialState: ConnectorState): Promise<void>;
     /**
-     * Normalizes a parsed on-disk state into the `{ connectorState, sdkState }`
-     * envelope, migrating a legacy flat v1 blob if needed.
-     *
-     * - v2 envelope (`{ connectorState, sdkState }`): used as-is.
-     * - v1 flat blob: SDK-owned keys (`V1_SDK_STATE_KEYS`) split into `sdkState`,
-     *   everything else becomes connector state.
-     * - Malformed envelope (one side present, the other missing) fails loud.
+     * Normalizes fetched state into the `{ connectorState, sdkState }` envelope.
+     * A flat v1 blob is split by `V1_SDK_STATE_KEYS`; an envelope with only one
+     * side present fails loud.
      */
     private normalizeFetchedState;
-    /**
-     *  Updates the state of the adapter by posting to API.
-     *  Persists the v2 `{ connectorState, sdkState }` envelope.
-     * @param {object} state - The connector state to be updated
-     */
+    /** Posts the v2 `{ connectorState, sdkState }` envelope to the API. */
     postState(state?: ConnectorState): Promise<void>;
-    /**
-     *  Fetches the state of the adapter from API.
-     * @return  The raw state data from API
-     */
     fetchState(): Promise<{
         state: string;
         objects?: string;

package/dist/state/base-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-state.d.ts","sourceRoot":"","sources":["../../src/state/base-state.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAEL,YAAY,EACZ,cAAc,EAEf,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,8BAAsB,SAAS,CAAC,cAAc,EAAE,QAAQ,SAAS,YAAY;IAC3E,SAAS,CAAC,eAAe,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC9B,SAAS,CAAC,gBAAgB,EAAE,eAAe,CAAM;IACjD,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAGxB,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,CAAC,cAAc,CAAC,EACvD,eAAe,EAAE,QAAQ;IAY3B,mFAAmF;IACnF,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,cAAc,EAE9B;IAED,uEAAuE;IACvE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAE3B;IAED,IAAI,eAAe,IAAI,eAAe,CAErC;IAED;;;;OAIG;IACG,mCAAmC,CACvC,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;;;;OAQG;IACG,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDvD;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAyC7B;;;;OAIG;IACG,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc;IA4DtC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAqBjE"}
+{"version":3,"file":"base-state.d.ts","sourceRoot":"","sources":["../../src/state/base-state.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAEL,QAAQ,EACR,cAAc,EAEf,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,8BAAsB,SAAS,CAAC,cAAc;IAC5C,SAAS,CAAC,eAAe,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC9B,SAAS,CAAC,gBAAgB,EAAE,eAAe,CAAM;IACjD,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAGxB,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,CAAC,cAAc,CAAC,EACvD,eAAe,EAAE,QAAQ;IAY3B,2EAA2E;IAC3E,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,cAAc,EAE9B;IAED,uEAAuE;IACvE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAE3B;IAED,IAAI,eAAe,IAAI,eAAe,CAErC;IAED;;;;OAIG;IACG,mCAAmC,CACvC,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;OAIG;IACG,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDvD;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAyC7B,uEAAuE;IACjE,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc;IA4DhC,UAAU,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAqBjE"}

package/dist/state/base-state.js

@@ -4,23 +4,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseState = void 0;
-const axios_1 = __importDefault(require("axios"));
 const node_worker_threads_1 = require("node:worker_threads");
-const install_initial_domain_mapping_1 = require("../common/install-initial-domain-mapping");
-const axios_client_internal_1 = require("../http/axios-client-internal");
+const axios_1 = __importDefault(require("axios"));
+const client_1 = require("../http/client");
 const logger_1 = require("../logger/logger");
 const workers_1 = require("../types/workers");
+const install_initial_domain_mapping_1 = require("./install-initial-domain-mapping");
 const state_interfaces_1 = require("./state.interfaces");
 /**
- * BaseState owns the state lifecycle shared by every sync mode: connector vs.
- * SDK state separation, fetch/init/post against the platform, the v1->v2
- * migration shim, and the snap-in-version-gated initial domain mapping install.
- *
- * Mode-specific subclasses (`ExtractionState`, `LoadingState`) narrow `sdkState`
- * to their own SDK state shape and add mode-specific setup in their factories.
- *
- * @typeParam ConnectorState - the connector-owned state shape
- * @typeParam SdkState - the SDK bookkeeping shape for this mode
+ * State lifecycle shared by all sync modes: connector/SDK state separation,
+ * fetch/init/post, the v1->v2 migration shim, and the snap-in-version-gated
+ * initial domain mapping install. Subclasses seed the SDK-owned state.
  */
 class BaseState {
     constructor({ event, initialState }, initialSdkState) {
@@ -34,7 +28,7 @@ class BaseState {
         this.syncUnitId = event.payload.event_context.sync_unit_id;
         this.requestId = event.payload.event_context.request_id_adaas;
     }
-    /** Connector-owned state. This is what `adapter.state` exposes to snap-in code. */
+    /** Connector-owned state; what `adapter.state` exposes to snap-in code. */
     get state() {
         return this._connectorState;
     }
@@ -52,9 +46,9 @@ class BaseState {
         return this._extractionScope;
     }
     /**
-     * Installs the initial domain mapping when the snap-in version in state does
-     * not match the version in the event context. Shared by all modes so that a
-     * loading run still installs the mapping if extraction has not done so.
+     * Installs the initial domain mapping when the snap-in version in state
+     * differs from the event context. Shared by all modes so a loading run still
+     * installs the mapping if extraction has not done so.
      */
     async installInitialDomainMappingIfNeeded(initialDomainMapping) {
         const snapInVersionId = this.event.context.snap_in_version_id;
@@ -86,13 +80,9 @@ class BaseState {
         }
     }
     /**
-     * Initializes the state for this adapter instance by fetching from API
-     * or creating an initial state if none exists (404).
-     *
-     * Reads both the v2 `{ connectorState, sdkState }` envelope and a legacy flat
-     * v1 blob (connector keys merged with SDK keys), migrating the latter on read.
-     * Always persists the v2 envelope going forward.
-     * @param initialState The initial connector state provided by the spawn function
+     * Fetches state from API, or creates the initial state on 404. Reads both
+     * the v2 envelope and a legacy flat v1 blob (migrated on read); always
+     * persists the v2 envelope going forward.
      */
     async init(initialState) {
         var _a;
@@ -143,13 +133,9 @@ class BaseState {
         }
     }
     /**
-     * Normalizes a parsed on-disk state into the `{ connectorState, sdkState }`
-     * envelope, migrating a legacy flat v1 blob if needed.
-     *
-     * - v2 envelope (`{ connectorState, sdkState }`): used as-is.
-     * - v1 flat blob: SDK-owned keys (`V1_SDK_STATE_KEYS`) split into `sdkState`,
-     *   everything else becomes connector state.
-     * - Malformed envelope (one side present, the other missing) fails loud.
+     * Normalizes fetched state into the `{ connectorState, sdkState }` envelope.
+     * A flat v1 blob is split by `V1_SDK_STATE_KEYS`; an envelope with only one
+     * side present fails loud.
      */
     normalizeFetchedState(parsed) {
         if (parsed === null || typeof parsed !== 'object') {
@@ -183,11 +169,7 @@ class BaseState {
             sdkState: Object.assign(Object.assign({}, this.initialSdkState), sdkState),
         };
     }
-    /**
-     *  Updates the state of the adapter by posting to API.
-     *  Persists the v2 `{ connectorState, sdkState }` envelope.
-     * @param {object} state - The connector state to be updated
-     */
+    /** Posts the v2 `{ connectorState, sdkState }` envelope to the API. */
     async postState(state) {
         const url = this.workerUrl + '.update';
         this.state = state || this.state;
@@ -209,7 +191,7 @@ class BaseState {
             process.exit(1);
         }
         try {
-            await axios_client_internal_1.axiosClient.post(url, {
+            await client_1.axiosClient.post(url, {
                 state: stringifiedState,
             }, {
                 headers: {
@@ -235,15 +217,11 @@ class BaseState {
             process.exit(1);
         }
     }
-    /**
-     *  Fetches the state of the adapter from API.
-     * @return  The raw state data from API
-     */
     async fetchState() {
         var _a, _b;
         console.log(`Fetching state with sync unit id ${this.syncUnitId} and request id ${this.requestId}.`);
         const url = this.workerUrl + '.get';
-        const response = await axios_client_internal_1.axiosClient.get(url, {
+        const response = await client_1.axiosClient.get(url, {
             headers: {
                 Authorization: this.devrevToken,
             },

package/dist/state/extraction-state.d.ts

@@ -1,29 +1,14 @@
 import { BaseState } from './base-state';
-import { ExtractionSdkState, StateInterface } from './state.interfaces';
-/**
- * ExtractionState is the per-mode state for extraction workers. It narrows
- * `sdkState` to `ExtractionSdkState` (extraction boundaries + attachments
- * bookkeeping) on top of the shared lifecycle provided by `BaseState`.
- */
-export declare class ExtractionState<ConnectorState> extends BaseState<ConnectorState, ExtractionSdkState> {
+import { StateInterface } from './state.interfaces';
+/** State for extraction workers: seeds extraction SDK state and adds extraction-window resolution. */
+export declare class ExtractionState<ConnectorState> extends BaseState<ConnectorState> {
     constructor(params: StateInterface<ConnectorState>);
     /**
-     * Resolves the extraction window onto the event context.
-     *
-     * On StartExtractingMetadata: resolve fresh from the TimeValue objects in the
-     * event context and cache them as pending boundaries (always overwrite).
-     * On all other events: reuse the pending boundaries cached during
-     * StartExtractingMetadata. Finally, validate that extract_from < extract_to.
+     * Resolves the extraction window onto the event context. StartExtractingMetadata
+     * resolves fresh from the event's TimeValues and overwrites the pending boundaries;
+     * all other events reuse those cached boundaries. Validates extract_from < extract_to.
      */
     resolveExtractionWindow(): void;
 }
-/**
- * Creates and initializes an `ExtractionState` for an extraction worker.
- *
- * For non-stateless events this fetches/migrates persisted state, installs the
- * initial domain mapping if the snap-in version changed, then resolves the
- * extraction window (time-value resolution + pending boundary reuse) and
- * validates it.
- */
 export declare function createExtractionState<ConnectorState>({ event, initialState, initialDomainMapping, options, }: StateInterface<ConnectorState>): Promise<ExtractionState<ConnectorState>>;
 //# sourceMappingURL=extraction-state.d.ts.map

package/dist/state/extraction-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-state.d.ts","sourceRoot":"","sources":["../../src/state/extraction-state.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,kBAAkB,EAElB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,qBAAa,eAAe,CAAC,cAAc,CAAE,SAAQ,SAAS,CAC5D,cAAc,EACd,kBAAkB,CACnB;gBACa,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC;IAIlD;;;;;;;OAOG;IACH,uBAAuB,IAAI,IAAI;CA8EhC;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,cAAc,EAAE,EAC1D,KAAK,EACL,YAAY,EACZ,oBAAoB,EACpB,OAAO,GACR,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAkB3E"}
+{"version":3,"file":"extraction-state.d.ts","sourceRoot":"","sources":["../../src/state/extraction-state.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAsB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGxE,sGAAsG;AACtG,qBAAa,eAAe,CAAC,cAAc,CAAE,SAAQ,SAAS,CAAC,cAAc,CAAC;gBAChE,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC;IAIlD;;;;OAIG;IACH,uBAAuB,IAAI,IAAI;CA6EhC;AAED,wBAAsB,qBAAqB,CAAC,cAAc,EAAE,EAC1D,KAAK,EACL,YAAY,EACZ,oBAAoB,EACpB,OAAO,GACR,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAkB3E"}

package/dist/state/extraction-state.js

@@ -4,32 +4,25 @@ exports.ExtractionState = void 0;
 exports.createExtractionState = createExtractionState;
 const node_worker_threads_1 = require("node:worker_threads");
 const constants_1 = require("../common/constants");
-const time_value_resolver_1 = require("../common/time-value-resolver");
 const logger_1 = require("../logger/logger");
 const extraction_1 = require("../types/extraction");
 const workers_1 = require("../types/workers");
 const base_state_1 = require("./base-state");
 const state_interfaces_1 = require("./state.interfaces");
-/**
- * ExtractionState is the per-mode state for extraction workers. It narrows
- * `sdkState` to `ExtractionSdkState` (extraction boundaries + attachments
- * bookkeeping) on top of the shared lifecycle provided by `BaseState`.
- */
+const time_value_resolver_1 = require("./time-value-resolver");
+/** State for extraction workers: seeds extraction SDK state and adds extraction-window resolution. */
 class ExtractionState extends base_state_1.BaseState {
     constructor(params) {
-        super(params, state_interfaces_1.initialExtractionSdkState);
+        super(params, state_interfaces_1.extractionSdkState);
     }
     /**
-     * Resolves the extraction window onto the event context.
-     *
-     * On StartExtractingMetadata: resolve fresh from the TimeValue objects in the
-     * event context and cache them as pending boundaries (always overwrite).
-     * On all other events: reuse the pending boundaries cached during
-     * StartExtractingMetadata. Finally, validate that extract_from < extract_to.
+     * Resolves the extraction window onto the event context. StartExtractingMetadata
+     * resolves fresh from the event's TimeValues and overwrites the pending boundaries;
+     * all other events reuse those cached boundaries. Validates extract_from < extract_to.
      */
     resolveExtractionWindow() {
-        const eventContext = this.event.payload.event_context;
         const sdkState = this.sdkState;
+        const eventContext = this.event.payload.event_context;
         if (this.event.payload.event_type === extraction_1.EventType.StartExtractingMetadata) {
             const timeFields = [
                 {
@@ -65,7 +58,6 @@ class ExtractionState extends base_state_1.BaseState {
             }
         }
         else {
-            // Non-StartExtractingMetadata events: reuse pending values from state
             if (sdkState.pendingWorkersOldest) {
                 eventContext.extract_from = sdkState.pendingWorkersOldest;
                 console.log(`Reusing pendingWorkersOldest as extract_from: ${sdkState.pendingWorkersOldest}.`);
@@ -81,7 +73,6 @@ class ExtractionState extends base_state_1.BaseState {
                 console.log('pendingWorkersNewest is not set in state. extract_to will not be populated for this invocation.');
             }
         }
-        // Validate that extract_from is before extract_to
         if (eventContext.extract_from && eventContext.extract_to) {
             if (eventContext.extract_from >= eventContext.extract_to) {
                 const errorMessage = `Invalid extraction window: extract_from (${eventContext.extract_from}) must be older than extract_to (${eventContext.extract_to}). This indicates an error in the platform.`;
@@ -96,16 +87,8 @@ class ExtractionState extends base_state_1.BaseState {
     }
 }
 exports.ExtractionState = ExtractionState;
-/**
- * Creates and initializes an `ExtractionState` for an extraction worker.
- *
- * For non-stateless events this fetches/migrates persisted state, installs the
- * initial domain mapping if the snap-in version changed, then resolves the
- * extraction window (time-value resolution + pending boundary reuse) and
- * validates it.
- */
 async function createExtractionState({ event, initialState, initialDomainMapping, options, }) {
-    // Deep clone the initial state to avoid mutating the original state
+    // Clone so the caller's initialState is never mutated.
     const deepCloneInitialState = structuredClone(initialState);
     const state = new ExtractionState({
         event,

package/dist/{common → state}/install-initial-domain-mapping.d.ts

@@ -1,4 +1,4 @@
-import { AirSyncEvent } from '../types/extraction';
 import { InitialDomainMapping } from '../types/common';
+import { AirSyncEvent } from '../types/extraction';
 export declare function installInitialDomainMapping(event: AirSyncEvent, initialDomainMappingJson: InitialDomainMapping): Promise<void>;
 //# sourceMappingURL=install-initial-domain-mapping.d.ts.map

package/dist/state/install-initial-domain-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-initial-domain-mapping.d.ts","sourceRoot":"","sources":["../../src/state/install-initial-domain-mapping.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,YAAY,EACnB,wBAAwB,EAAE,oBAAoB,GAC7C,OAAO,CAAC,IAAI,CAAC,CAwFf"}

package/dist/{common → state}/install-initial-domain-mapping.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.installInitialDomainMapping = installInitialDomainMapping;
-const axios_client_internal_1 = require("../http/axios-client-internal");
+const client_1 = require("../http/client");
 const logger_1 = require("../logger/logger");
 async function installInitialDomainMapping(event, initialDomainMappingJson) {
     var _a, _b, _c, _d, _e, _f, _g;
@@ -12,8 +12,7 @@ async function installInitialDomainMapping(event, initialDomainMappingJson) {
         console.warn('No initial domain mapping found.');
         return;
     }
-    // Get snap-in details
-    const snapInResponse = await axios_client_internal_1.axiosClient.get(devrevEndpoint + '/internal/snap-ins.get', {
+    const snapInResponse = await client_1.axiosClient.get(devrevEndpoint + '/internal/snap-ins.get', {
         headers: {
             Authorization: devrevToken,
         },
@@ -28,12 +27,12 @@ async function installInitialDomainMapping(event, initialDomainMappingJson) {
         throw new Error(errorMessage);
     }
     const startingRecipeBlueprint = initialDomainMappingJson === null || initialDomainMappingJson === void 0 ? void 0 : initialDomainMappingJson.starting_recipe_blueprint;
-    // Try to create a recipe blueprint
+    // Recipe blueprint creation is best-effort; install proceeds without it.
     let recipeBlueprintId;
     if (startingRecipeBlueprint &&
         Object.keys(startingRecipeBlueprint).length !== 0) {
         try {
-            const recipeBlueprintResponse = await axios_client_internal_1.axiosClient.post(`${devrevEndpoint}/internal/airdrop.recipe.blueprints.create`, Object.assign({}, startingRecipeBlueprint), {
+            const recipeBlueprintResponse = await client_1.axiosClient.post(`${devrevEndpoint}/internal/airdrop.recipe.blueprints.create`, Object.assign({}, startingRecipeBlueprint), {
                 headers: {
                     Authorization: devrevToken,
                 },
@@ -45,9 +44,8 @@ async function installInitialDomainMapping(event, initialDomainMappingJson) {
             console.warn('Error while creating recipe blueprint. Continuing without it.', (0, logger_1.serializeError)(error));
         }
     }
-    // Install the initial domain mappings
     const additionalMappings = initialDomainMappingJson.additional_mappings || {};
-    const initialDomainMappingInstallResponse = await axios_client_internal_1.axiosClient.post(`${devrevEndpoint}/internal/airdrop.recipe.initial-domain-mappings.install`, Object.assign(Object.assign({ external_system_type: 'ADaaS', import_slug: importSlug, snap_in_slug: snapInSlug }, (recipeBlueprintId && {
+    const initialDomainMappingInstallResponse = await client_1.axiosClient.post(`${devrevEndpoint}/internal/airdrop.recipe.initial-domain-mappings.install`, Object.assign(Object.assign({ external_system_type: 'ADaaS', import_slug: importSlug, snap_in_slug: snapInSlug }, (recipeBlueprintId && {
         starting_recipe_blueprint: recipeBlueprintId,
     })), additionalMappings), {
         headers: {

package/dist/state/loading-state.d.ts

@@ -1,19 +1,8 @@
 import { BaseState } from './base-state';
-import { LoadingSdkState, StateInterface } from './state.interfaces';
-/**
- * LoadingState is the per-mode state for loading workers. It narrows `sdkState`
- * to `LoadingSdkState` (files-to-load bookkeeping) on top of the shared
- * lifecycle provided by `BaseState`.
- */
-export declare class LoadingState<ConnectorState> extends BaseState<ConnectorState, LoadingSdkState> {
+import { StateInterface } from './state.interfaces';
+/** State for loading workers: seeds loading SDK state; no extraction-window resolution. */
+export declare class LoadingState<ConnectorState> extends BaseState<ConnectorState> {
     constructor(params: StateInterface<ConnectorState>);
 }
-/**
- * Creates and initializes a `LoadingState` for a loading worker.
- *
- * For non-stateless events this fetches/migrates persisted state and installs
- * the initial domain mapping if the snap-in version changed. Loading has no
- * extraction-window resolution, so the factory is otherwise minimal.
- */
 export declare function createLoadingState<ConnectorState>({ event, initialState, initialDomainMapping, options, }: StateInterface<ConnectorState>): Promise<LoadingState<ConnectorState>>;
 //# sourceMappingURL=loading-state.d.ts.map

package/dist/state/loading-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-state.d.ts","sourceRoot":"","sources":["../../src/state/loading-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAEL,eAAe,EACf,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,qBAAa,YAAY,CAAC,cAAc,CAAE,SAAQ,SAAS,CACzD,cAAc,EACd,eAAe,CAChB;gBACa,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC;CAGnD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,EACvD,KAAK,EACL,YAAY,EACZ,oBAAoB,EACpB,OAAO,GACR,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAiBxE"}
+{"version":3,"file":"loading-state.d.ts","sourceRoot":"","sources":["../../src/state/loading-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErE,2FAA2F;AAC3F,qBAAa,YAAY,CAAC,cAAc,CAAE,SAAQ,SAAS,CAAC,cAAc,CAAC;gBAC7D,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC;CAGnD;AAED,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,EACvD,KAAK,EACL,YAAY,EACZ,oBAAoB,EACpB,OAAO,GACR,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAiBxE"}