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

package/dist/common/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SLEEP_DELAY_MS = exports.MEMORY_LOG_INTERVAL = exports.HARD_TIMEOUT_MULTIPLIER = exports.DEFAULT_LAMBDA_TIMEOUT = exports.LIBRARY_VERSION = exports.AIRDROP_DEFAULT_ITEM_TYPES = 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.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 = [
@@ -46,13 +46,27 @@ 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.AIRDROP_DEFAULT_ITEM_TYPES = {
-    EXTERNAL_DOMAIN_METADATA: 'external_domain_metadata',
-    ATTACHMENTS: 'attachments',
-    SSOR_ATTACHMENT: 'ssor_attachment',
-};
+// 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
+exports.EVENT_SIZE_THRESHOLD_BYTES = Math.floor(exports.MAX_EVENT_SIZE_BYTES * 0.8);
+exports.SSOR_ATTACHMENT = 'ssor_attachment';
+var AirSyncDefaultItemTypes;
+(function (AirSyncDefaultItemTypes) {
+    AirSyncDefaultItemTypes["EXTERNAL_DOMAIN_METADATA"] = "external_domain_metadata";
+    AirSyncDefaultItemTypes["ATTACHMENTS"] = "attachments";
+    AirSyncDefaultItemTypes["EXTERNAL_SYNC_UNITS"] = "external_sync_units";
+})(AirSyncDefaultItemTypes || (exports.AirSyncDefaultItemTypes = AirSyncDefaultItemTypes = {}));
 exports.LIBRARY_VERSION = (0, helpers_1.getLibraryVersion)();
 exports.DEFAULT_LAMBDA_TIMEOUT = 10 * 60 * 1000; // 10 minutes
 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).
+ */
+exports.UNBOUNDED_DATE_TIME_VALUE = '1970-01-01T00:00:00.000Z';

package/dist/common/control-protocol.d.ts

@@ -1,8 +1,8 @@
 import { AxiosResponse } from 'axios';
-import { AirdropEvent, EventData, ExtractorEventType } from '../types/extraction';
+import { AirSyncEvent, EventData, ExtractorEventType } from '../types/extraction';
 import { LoaderEventType } from '../types/loading';
 export interface EmitInterface {
-    event: AirdropEvent;
+    event: AirSyncEvent;
     eventType: ExtractorEventType | LoaderEventType;
     data?: EventData;
 }

package/dist/common/control-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-protocol.d.ts","sourceRoot":"","sources":["../../src/common/control-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EACL,YAAY,EACZ,SAAS,EAET,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,kBAAkB,GAAG,eAAe,CAAC;IAChD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,eAAO,MAAM,IAAI,GAAU,6BAIxB,aAAa,KAAG,OAAO,CAAC,aAAa,CAgCvC,CAAC"}
+{"version":3,"file":"control-protocol.d.ts","sourceRoot":"","sources":["../../src/common/control-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EACL,YAAY,EACZ,SAAS,EAET,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,kBAAkB,GAAG,eAAe,CAAC;IAChD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,eAAO,MAAM,IAAI,GAAU,6BAIxB,aAAa,KAAG,OAAO,CAAC,aAAa,CA4BvC,CAAC"}

package/dist/common/control-protocol.js

@@ -3,13 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.emit = void 0;
 const axios_client_internal_1 = require("../http/axios-client-internal");
 const constants_1 = require("./constants");
-const event_type_translation_1 = require("./event-type-translation");
 const emit = async ({ event, eventType, data, }) => {
-    // Translate outgoing event type to ensure we always send new event types
-    // TODO: Remove when the old types are completely phased out
-    const translatedEventType = (0, event_type_translation_1.translateOutgoingEventType)(eventType);
     const newEvent = {
-        event_type: translatedEventType,
+        event_type: eventType,
         event_context: event.payload.event_context,
         event_data: Object.assign({}, data),
         worker_metadata: {

package/dist/common/helpers.d.ts

@@ -38,4 +38,12 @@ 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":"AASA;;;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"}
+{"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"}

package/dist/common/helpers.js

@@ -37,10 +37,12 @@ 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
@@ -122,3 +124,16 @@ 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/common/install-initial-domain-mapping.d.ts

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

package/dist/common/install-initial-domain-mapping.test.js

@@ -5,7 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const axios_1 = __importDefault(require("axios"));
 const axios_client_internal_1 = require("../http/axios-client-internal");
-const test_helpers_1 = require("../tests/test-helpers");
+const jest_setup_1 = require("../tests/jest.setup");
+const test_utils_1 = require("./test-utils");
 const extraction_1 = require("../types/extraction");
 const install_initial_domain_mapping_1 = require("./install-initial-domain-mapping");
 // Mock dependencies
@@ -22,7 +23,9 @@ const mockAxiosClient = axios_client_internal_1.axiosClient;
 const mockIsAxiosError = axios_1.default.isAxiosError;
 describe(install_initial_domain_mapping_1.installInitialDomainMapping.name, () => {
     // Create mock objects
-    const mockEvent = (0, test_helpers_1.createEvent)({ eventType: extraction_1.EventType.ExtractionDataStart });
+    const mockEvent = (0, test_utils_1.createMockEvent)(jest_setup_1.mockServer.baseUrl, {
+        payload: { event_type: extraction_1.EventType.StartExtractingData },
+    });
     const mockInitialDomainMapping = {
         starting_recipe_blueprint: {
             name: 'Test Recipe Blueprint',

package/dist/common/test-utils.d.ts

@@ -0,0 +1,19 @@
+import { AirSyncEvent } from '../types/extraction';
+export declare const MOCK_SERVER_DEFAULT_URL = "http://localhost:0";
+/**
+ * Recursively makes all properties of T optional.
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Creates a mock AirSyncEvent for testing.
+ *
+ * @param mockServerUrl - Base URL for the mock server. Defaults to {@link MOCK_SERVER_DEFAULT_URL}.
+ *   The `callback_url`, `worker_data_url`, and `devrev_endpoint` fields are
+ *   derived from this value unless explicitly overridden.
+ * @param overrides - Deep partial of AirSyncEvent. Any provided fields are
+ *   deep-merged on top of the defaults.
+ */
+export declare function createMockEvent(mockServerUrl?: string, overrides?: DeepPartial<AirSyncEvent>): AirSyncEvent;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/common/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/common/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,qBAAqB,CAAC;AAE9D,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAoCF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,aAAa,GAAE,MAAgC,EAC/C,SAAS,GAAE,WAAW,CAAC,YAAY,CAAM,GACxC,YAAY,CAmEd"}

package/dist/common/test-utils.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOCK_SERVER_DEFAULT_URL = void 0;
+exports.createMockEvent = createMockEvent;
+const extraction_1 = require("../types/extraction");
+exports.MOCK_SERVER_DEFAULT_URL = 'http://localhost:0';
+/**
+ * Deep merges source into target. Arrays and primitives from source replace
+ * those in target; plain objects are merged recursively.
+ */
+function deepMerge(target, source) {
+    const result = Object.assign({}, target);
+    for (const key of Object.keys(source)) {
+        const sourceVal = source[key];
+        const targetVal = target[key];
+        if (sourceVal !== null &&
+            typeof sourceVal === 'object' &&
+            !Array.isArray(sourceVal) &&
+            targetVal !== null &&
+            typeof targetVal === 'object' &&
+            !Array.isArray(targetVal)) {
+            result[key] = deepMerge(targetVal, sourceVal);
+        }
+        else {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+/**
+ * Creates a mock AirSyncEvent for testing.
+ *
+ * @param mockServerUrl - Base URL for the mock server. Defaults to {@link MOCK_SERVER_DEFAULT_URL}.
+ *   The `callback_url`, `worker_data_url`, and `devrev_endpoint` fields are
+ *   derived from this value unless explicitly overridden.
+ * @param overrides - Deep partial of AirSyncEvent. Any provided fields are
+ *   deep-merged on top of the defaults.
+ */
+function createMockEvent(mockServerUrl = exports.MOCK_SERVER_DEFAULT_URL, overrides = {}) {
+    var _a, _b, _c, _d;
+    const base = {
+        context: {
+            secrets: {
+                service_account_token: 'test_token',
+            },
+            snap_in_version_id: 'test_snap_in_version_id',
+            snap_in_id: 'test_snap_in_id',
+        },
+        payload: {
+            connection_data: {
+                org_id: 'test_org_id',
+                org_name: 'test_org_name',
+                key: 'test_key',
+                key_type: 'test_key_type',
+            },
+            event_context: {
+                callback_url: `${mockServerUrl}/callback_url`,
+                dev_oid: 'test_dev_oid',
+                dev_org_id: 'test_dev_org_id',
+                dev_uid: 'test_dev_uid',
+                event_type_adaas: 'test_event_type_adaas',
+                external_sync_unit_id: 'test_external_sync_unit_id',
+                external_sync_unit_name: 'test_external_sync_unit_name',
+                external_system_id: 'test_external_system_id',
+                external_system_name: 'test_external_system_name',
+                external_system_type: 'test_external_system_type',
+                import_slug: 'test_import_slug',
+                mode: 'INITIAL',
+                request_id: 'test_request_id',
+                request_id_adaas: 'test_request_id_adaas',
+                run_id: 'test_run_id',
+                sequence_version: 'test_sequence_version',
+                snap_in_slug: 'test_snap_in_slug',
+                snap_in_version_id: 'test_snap_in_version_id',
+                sync_tier: 'test_sync_tier',
+                sync_unit: 'test_sync_unit',
+                sync_unit_id: 'test_sync_unit_id',
+                worker_data_url: `${mockServerUrl}/worker_data_url`,
+            },
+            event_type: extraction_1.EventType.StartExtractingData,
+            event_data: {},
+        },
+        execution_metadata: {
+            devrev_endpoint: mockServerUrl,
+        },
+        input_data: {
+            global_values: {},
+            event_sources: {},
+        },
+    };
+    const merged = deepMerge(base, overrides);
+    // Ensure mock server URLs always win over overrides, unless the caller
+    // explicitly provided them.
+    if (!((_b = (_a = overrides.payload) === null || _a === void 0 ? void 0 : _a.event_context) === null || _b === void 0 ? void 0 : _b.callback_url)) {
+        merged.payload.event_context.callback_url = `${mockServerUrl}/callback_url`;
+    }
+    if (!((_d = (_c = overrides.payload) === null || _c === void 0 ? void 0 : _c.event_context) === null || _d === void 0 ? void 0 : _d.worker_data_url)) {
+        merged.payload.event_context.worker_data_url = `${mockServerUrl}/worker_data_url`;
+    }
+    return merged;
+}

package/dist/common/time-value-resolver.d.ts

@@ -0,0 +1,47 @@
+import { TimeUnit, TimeValue } from '../types/extraction';
+import { ExtractionSdkState } from '../state/state.interfaces';
+/**
+ * Parses a shorthand duration string into its numeric value and unit.
+ * Supported units:
+ * - 'ns' for nanoseconds
+ * - 'us' or 'µs' for microseconds
+ * - 'ms' for milliseconds
+ * - 's' for seconds
+ * - 'm' for minutes
+ * - 'h' for hours
+ *
+ * @throws Error if the format is invalid
+ */
+export declare function parseDuration(shorthand: string): {
+    value: number;
+    unit: TimeUnit;
+};
+/**
+ * Applies a shorthand duration to a base ISO 8601 timestamp.
+ *
+ * @param baseTimestamp - ISO 8601 timestamp to apply duration to
+ * @param duration - Shorthand duration string (e.g. '100ns', '500ms', '30s', '5m', '2h')
+ * @param operation - Whether to 'add' or 'subtract' the duration
+ * @returns ISO 8601 timestamp with the duration applied
+ */
+export declare function applyDuration(baseTimestamp: string, duration: string, operation: 'add' | 'subtract'): string;
+/**
+ * Resolves a TimeValue into a concrete ISO 8601 timestamp string.
+ *
+ * Resolution rules:
+ * - ABSOLUTE: Returns the value directly (must be an ISO 8601 timestamp)
+ * - NOW: Returns the current time as ISO 8601
+ * - UNBOUNDED: Returns UNBOUNDED_DATE_TIME_VALUE ('1970-01-01T00:00:00.000Z')
+ * - WORKERS_OLDEST: Returns workersOldest from state, or throws if not set
+ * - WORKERS_NEWEST: Returns workersNewest from state, or throws if not set
+ * - WORKERS_OLDEST_MINUS_WINDOW: Subtracts duration from workersOldest, or throws if not set
+ * - WORKERS_NEWEST_PLUS_WINDOW: Adds duration to workersNewest, or throws if not set
+ *
+ * @param timeValue - The TimeValue to resolve
+ * @param state - The current SDK state containing workersOldest and workersNewest
+ * @returns Resolved ISO 8601 timestamp string
+ * @throws Error if required TimeValue.value is missing for ABSOLUTE or *_WINDOW types
+ * @throws Error if workersOldest/workersNewest is not set in state for WORKERS_* types
+ */
+export declare function resolveTimeValue(timeValue: TimeValue, state: ExtractionSdkState): string;
+//# sourceMappingURL=time-value-resolver.d.ts.map

package/dist/common/time-value-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-value-resolver.d.ts","sourceRoot":"","sources":["../../src/common/time-value-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,CAcA;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,KAAK,GAAG,UAAU,GAC5B,MAAM,CA6BR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,kBAAkB,GACxB,MAAM,CA2ER"}

package/dist/common/time-value-resolver.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDuration = parseDuration;
+exports.applyDuration = applyDuration;
+exports.resolveTimeValue = resolveTimeValue;
+const extraction_1 = require("../types/extraction");
+const constants_1 = require("./constants");
+/**
+ * Parses a shorthand duration string into its numeric value and unit.
+ * Supported units:
+ * - 'ns' for nanoseconds
+ * - 'us' or 'µs' for microseconds
+ * - 'ms' for milliseconds
+ * - 's' for seconds
+ * - 'm' for minutes
+ * - 'h' for hours
+ *
+ * @throws Error if the format is invalid
+ */
+function parseDuration(shorthand) {
+    const validUnits = Object.values(extraction_1.TimeUnit).join('|');
+    const match = shorthand.match(new RegExp(`^(\\d+(?:\\.\\d+)?)(${validUnits})$`));
+    if (!match) {
+        throw new Error(`Invalid duration format: '${shorthand}'. Expected format like '100ns', '500ms', '30s', '5m', or '2h'.`);
+    }
+    return {
+        value: parseFloat(match[1]),
+        unit: match[2],
+    };
+}
+/**
+ * Applies a shorthand duration to a base ISO 8601 timestamp.
+ *
+ * @param baseTimestamp - ISO 8601 timestamp to apply duration to
+ * @param duration - Shorthand duration string (e.g. '100ns', '500ms', '30s', '5m', '2h')
+ * @param operation - Whether to 'add' or 'subtract' the duration
+ * @returns ISO 8601 timestamp with the duration applied
+ */
+function applyDuration(baseTimestamp, duration, operation) {
+    const { value, unit } = parseDuration(duration);
+    const date = new Date(baseTimestamp);
+    const sign = operation === 'add' ? 1 : -1;
+    switch (unit) {
+        case extraction_1.TimeUnit.NANOSECONDS:
+            // JavaScript Date works in milliseconds, so convert nanoseconds
+            date.setTime(date.getTime() + sign * value * 0.000001);
+            break;
+        case extraction_1.TimeUnit.MICROSECONDS:
+        case extraction_1.TimeUnit.MICROSECONDS_MU:
+            date.setTime(date.getTime() + sign * value * 0.001);
+            break;
+        case extraction_1.TimeUnit.MILLISECONDS:
+            date.setTime(date.getTime() + sign * value);
+            break;
+        case extraction_1.TimeUnit.SECONDS:
+            date.setUTCSeconds(date.getUTCSeconds() + sign * value);
+            break;
+        case extraction_1.TimeUnit.MINUTES:
+            date.setUTCMinutes(date.getUTCMinutes() + sign * value);
+            break;
+        case extraction_1.TimeUnit.HOURS:
+            date.setUTCHours(date.getUTCHours() + sign * value);
+            break;
+    }
+    return date.toISOString();
+}
+/**
+ * Resolves a TimeValue into a concrete ISO 8601 timestamp string.
+ *
+ * Resolution rules:
+ * - ABSOLUTE: Returns the value directly (must be an ISO 8601 timestamp)
+ * - NOW: Returns the current time as ISO 8601
+ * - UNBOUNDED: Returns UNBOUNDED_DATE_TIME_VALUE ('1970-01-01T00:00:00.000Z')
+ * - WORKERS_OLDEST: Returns workersOldest from state, or throws if not set
+ * - WORKERS_NEWEST: Returns workersNewest from state, or throws if not set
+ * - WORKERS_OLDEST_MINUS_WINDOW: Subtracts duration from workersOldest, or throws if not set
+ * - WORKERS_NEWEST_PLUS_WINDOW: Adds duration to workersNewest, or throws if not set
+ *
+ * @param timeValue - The TimeValue to resolve
+ * @param state - The current SDK state containing workersOldest and workersNewest
+ * @returns Resolved ISO 8601 timestamp string
+ * @throws Error if required TimeValue.value is missing for ABSOLUTE or *_WINDOW types
+ * @throws Error if workersOldest/workersNewest is not set in state for WORKERS_* types
+ */
+function resolveTimeValue(timeValue, state) {
+    switch (timeValue.type) {
+        case extraction_1.TimeValueType.ABSOLUTE_TIME: {
+            if (!timeValue.value) {
+                throw new Error('TimeValue of type ABSOLUTE must have a value (ISO 8601 timestamp).');
+            }
+            // Normalize to consistent ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ)
+            // to ensure string comparisons in boundary expansion are safe.
+            const parsed = new Date(timeValue.value);
+            if (isNaN(parsed.getTime())) {
+                throw new Error(`TimeValue of type ABSOLUTE has an invalid ISO 8601 timestamp: '${timeValue.value}'.`);
+            }
+            return parsed.toISOString();
+        }
+        case extraction_1.TimeValueType.CURRENT_TIME: {
+            return new Date().toISOString();
+        }
+        case extraction_1.TimeValueType.UNBOUNDED: {
+            return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+        }
+        case extraction_1.TimeValueType.WORKERS_OLDEST: {
+            if (!state.workersOldest) {
+                // To support backwards-compatibility for the old state
+                return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+            }
+            return state.workersOldest;
+        }
+        case extraction_1.TimeValueType.WORKERS_NEWEST: {
+            if (!state.workersNewest) {
+                throw new Error('Field workersNewest is not set in state. Cannot resolve TimeValue of type WORKERS_NEWEST without a prior extraction boundary.');
+            }
+            return state.workersNewest;
+        }
+        case extraction_1.TimeValueType.WORKERS_OLDEST_MINUS_WINDOW: {
+            if (!timeValue.value) {
+                throw new Error("TimeValue of type WORKERS_OLDEST_MINUS_WINDOW must have a value (duration, e.g. '30s', '5m', '2h').");
+            }
+            if (!state.workersOldest) {
+                // To support backwards-compatibility for the old state
+                return constants_1.UNBOUNDED_DATE_TIME_VALUE;
+            }
+            return applyDuration(state.workersOldest, timeValue.value, 'subtract');
+        }
+        case extraction_1.TimeValueType.WORKERS_NEWEST_PLUS_WINDOW: {
+            if (!timeValue.value) {
+                throw new Error("TimeValue of type WORKERS_NEWEST_PLUS_WINDOW must have a value (duration, e.g. '30s', '5m', '2h').");
+            }
+            if (!state.workersNewest) {
+                throw new Error('Field workersNewest is not set in state. Cannot resolve TimeValue of type WORKERS_NEWEST_PLUS_WINDOW without a prior extraction boundary.');
+            }
+            return applyDuration(state.workersNewest, timeValue.value, 'add');
+        }
+        default: {
+            throw new Error(`Unknown TimeValueType: '${timeValue.type}'.`);
+        }
+    }
+}

package/dist/common/time-value-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=time-value-resolver.test.d.ts.map

package/dist/common/time-value-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-value-resolver.test.d.ts","sourceRoot":"","sources":["../../src/common/time-value-resolver.test.ts"],"names":[],"mappings":""}