@adtrackify/at-service-common 3.19.10 → 3.19.11

package/dist/cjs/types/shopify-rest-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=shopify-rest-types.js.map

package/dist/cjs/types/shopify-rest-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopify-rest-types.js","sourceRoot":"","sources":["../../../src/types/shopify-rest-types.ts"],"names":[],"mappings":""}

package/dist/cjs/utils/compression.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { CompressionAlgorithm } from '../clients/generic/sqs-bundled-client.types.js';
+export declare function getZstdUncompressedSize(buffer: Buffer): number | undefined;
+export declare function getGzipUncompressedSize(buffer: Buffer): number | undefined;
+export declare enum CompressionOperation {
+    COMPRESS = "compress",
+    DECOMPRESS = "decompress"
+}
+export declare function compress(data: Buffer, algorithm: CompressionAlgorithm, level?: number): Promise<Buffer>;
+export declare function decompress(data: Buffer, algorithm: CompressionAlgorithm): Promise<Buffer>;
+export declare function compressToBase64(data: unknown, algorithm: CompressionAlgorithm, level?: number): Promise<{
+    base64: string;
+    originalSize: number;
+    compressedSize: number;
+}>;
+export declare const DECOMPRESSION_LIMITS: {
+    readonly MAX_DECOMPRESSED_SIZE_BYTES: number;
+    readonly MAX_COMPRESSION_RATIO: 100;
+    readonly DEFAULT_TIMEOUT_MS: 30000;
+};
+export declare class DecompressionBombError extends Error {
+    readonly compressedSize: number;
+    readonly decompressedSize: number;
+    readonly limit: number;
+    constructor(compressedSize: number, decompressedSize: number, limit: number);
+}
+export declare class CompressionTimeoutError extends Error {
+    readonly operation: CompressionOperation;
+    readonly timeoutMs: number;
+    constructor(operation: CompressionOperation, timeoutMs: number);
+}
+export declare function decompressFromBase64<T>(base64: string, algorithm: CompressionAlgorithm, options?: {
+    maxDecompressedSizeBytes?: number;
+    timeoutMs?: number;
+}): Promise<T>;

package/dist/cjs/utils/compression.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decompressFromBase64 = exports.CompressionTimeoutError = exports.DecompressionBombError = exports.DECOMPRESSION_LIMITS = exports.compressToBase64 = exports.decompress = exports.compress = exports.CompressionOperation = exports.getGzipUncompressedSize = exports.getZstdUncompressedSize = void 0;
+const node_util_1 = require("node:util");
+const node_zlib_1 = require("node:zlib");
+const sqs_bundled_client_types_js_1 = require("../clients/generic/sqs-bundled-client.types.js");
+const zstdCompressNative = (0, node_util_1.promisify)(node_zlib_1.zstdCompress);
+const zstdDecompressNative = (0, node_util_1.promisify)(node_zlib_1.zstdDecompress);
+const gunzipNative = (0, node_util_1.promisify)(node_zlib_1.gunzip);
+const ZSTD_MAGIC = 0xfd2fb528;
+const GZIP_MAGIC_BYTE_0 = 0x1f;
+const GZIP_MAGIC_BYTE_1 = 0x8b;
+const GZIP_MIN_SIZE = 18;
+function getZstdUncompressedSize(buffer) {
+    if (buffer.length < 5) {
+        return undefined;
+    }
+    const magic = buffer.readUInt32LE(0);
+    if (magic !== ZSTD_MAGIC) {
+        return undefined;
+    }
+    const frameHeaderDescriptor = buffer[4];
+    if (frameHeaderDescriptor === undefined) {
+        return undefined;
+    }
+    const singleSegmentFlag = (frameHeaderDescriptor >> 5) & 0x01;
+    const contentSizeFlag = (frameHeaderDescriptor >> 6) & 0x03;
+    const dictionaryIdFlag = frameHeaderDescriptor & 0x03;
+    const dictIdSizes = [0, 1, 2, 4];
+    const dictIdSize = dictIdSizes[dictionaryIdFlag];
+    let fcsSize;
+    if (contentSizeFlag === 0) {
+        fcsSize = singleSegmentFlag === 1 ? 1 : 0;
+    }
+    else if (contentSizeFlag === 1) {
+        fcsSize = 2;
+    }
+    else if (contentSizeFlag === 2) {
+        fcsSize = 4;
+    }
+    else {
+        fcsSize = 8;
+    }
+    if (fcsSize === 0) {
+        return undefined;
+    }
+    const windowDescriptorSize = singleSegmentFlag === 1 ? 0 : 1;
+    const fcsOffset = 5 + windowDescriptorSize + dictIdSize;
+    if (buffer.length < fcsOffset + fcsSize) {
+        return undefined;
+    }
+    if (fcsSize === 1) {
+        return buffer.readUInt8(fcsOffset);
+    }
+    else if (fcsSize === 2) {
+        return buffer.readUInt16LE(fcsOffset) + 256;
+    }
+    else if (fcsSize === 4) {
+        return buffer.readUInt32LE(fcsOffset);
+    }
+    else {
+        const bigValue = buffer.readBigUInt64LE(fcsOffset);
+        if (bigValue > BigInt(Number.MAX_SAFE_INTEGER)) {
+            return Number.MAX_SAFE_INTEGER;
+        }
+        return Number(bigValue);
+    }
+}
+exports.getZstdUncompressedSize = getZstdUncompressedSize;
+function getGzipUncompressedSize(buffer) {
+    if (buffer.length < GZIP_MIN_SIZE) {
+        return undefined;
+    }
+    if (buffer[0] !== GZIP_MAGIC_BYTE_0 || buffer[1] !== GZIP_MAGIC_BYTE_1) {
+        return undefined;
+    }
+    return buffer.readUInt32LE(buffer.length - 4);
+}
+exports.getGzipUncompressedSize = getGzipUncompressedSize;
+var CompressionOperation;
+(function (CompressionOperation) {
+    CompressionOperation["COMPRESS"] = "compress";
+    CompressionOperation["DECOMPRESS"] = "decompress";
+})(CompressionOperation = exports.CompressionOperation || (exports.CompressionOperation = {}));
+async function compress(data, algorithm, level = 3) {
+    switch (algorithm) {
+        case sqs_bundled_client_types_js_1.CompressionAlgorithm.NONE:
+            return data;
+        case sqs_bundled_client_types_js_1.CompressionAlgorithm.ZSTD:
+            return await zstdCompressNative(data, {
+                params: {
+                    [node_zlib_1.constants.ZSTD_c_compressionLevel]: level,
+                },
+            });
+        default:
+            throw new Error(`Unsupported compression algorithm: ${algorithm}`);
+    }
+}
+exports.compress = compress;
+async function decompress(data, algorithm) {
+    switch (algorithm) {
+        case sqs_bundled_client_types_js_1.CompressionAlgorithm.NONE:
+            return data;
+        case sqs_bundled_client_types_js_1.CompressionAlgorithm.ZSTD:
+            return await zstdDecompressNative(data);
+        case sqs_bundled_client_types_js_1.CompressionAlgorithm.GZIP:
+            return await gunzipNative(data);
+        default:
+            throw new Error(`Unsupported compression algorithm: ${algorithm}`);
+    }
+}
+exports.decompress = decompress;
+async function compressToBase64(data, algorithm, level = 3) {
+    const json = JSON.stringify(data);
+    const originalSize = Buffer.byteLength(json, 'utf8');
+    if (algorithm === sqs_bundled_client_types_js_1.CompressionAlgorithm.NONE) {
+        return { base64: '', originalSize, compressedSize: originalSize };
+    }
+    const compressed = await compress(Buffer.from(json, 'utf8'), algorithm, level);
+    const base64 = compressed.toString('base64');
+    return {
+        base64,
+        originalSize,
+        compressedSize: Buffer.byteLength(base64, 'utf8'),
+    };
+}
+exports.compressToBase64 = compressToBase64;
+exports.DECOMPRESSION_LIMITS = {
+    MAX_DECOMPRESSED_SIZE_BYTES: 10 * 1024 * 1024,
+    MAX_COMPRESSION_RATIO: 100,
+    DEFAULT_TIMEOUT_MS: 30000,
+};
+class DecompressionBombError extends Error {
+    compressedSize;
+    decompressedSize;
+    limit;
+    constructor(compressedSize, decompressedSize, limit) {
+        super(`Decompression bomb detected: ${decompressedSize} bytes exceeds limit of ${limit} bytes ` +
+            `(compression ratio: ${(decompressedSize / compressedSize).toFixed(1)}x)`);
+        this.compressedSize = compressedSize;
+        this.decompressedSize = decompressedSize;
+        this.limit = limit;
+        this.name = 'DecompressionBombError';
+    }
+}
+exports.DecompressionBombError = DecompressionBombError;
+class CompressionTimeoutError extends Error {
+    operation;
+    timeoutMs;
+    constructor(operation, timeoutMs) {
+        super(`${operation} operation timed out after ${timeoutMs}ms`);
+        this.operation = operation;
+        this.timeoutMs = timeoutMs;
+        this.name = 'CompressionTimeoutError';
+    }
+}
+exports.CompressionTimeoutError = CompressionTimeoutError;
+async function withTimeout(operation, timeoutMs, operationName) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new CompressionTimeoutError(operationName, timeoutMs));
+        }, timeoutMs);
+    });
+    try {
+        return await Promise.race([operation, timeoutPromise]);
+    }
+    finally {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+    }
+}
+async function decompressFromBase64(base64, algorithm, options) {
+    if (algorithm === sqs_bundled_client_types_js_1.CompressionAlgorithm.NONE) {
+        throw new Error('Cannot decompress NONE algorithm from base64');
+    }
+    const maxSize = options?.maxDecompressedSizeBytes ?? exports.DECOMPRESSION_LIMITS.MAX_DECOMPRESSED_SIZE_BYTES;
+    const timeoutMs = options?.timeoutMs ?? exports.DECOMPRESSION_LIMITS.DEFAULT_TIMEOUT_MS;
+    const compressed = Buffer.from(base64, 'base64');
+    if (algorithm === sqs_bundled_client_types_js_1.CompressionAlgorithm.ZSTD) {
+        const headerSize = getZstdUncompressedSize(compressed);
+        if (headerSize !== undefined && headerSize > maxSize) {
+            throw new DecompressionBombError(compressed.length, headerSize, maxSize);
+        }
+    }
+    if (algorithm === sqs_bundled_client_types_js_1.CompressionAlgorithm.GZIP) {
+        const headerSize = getGzipUncompressedSize(compressed);
+        if (headerSize !== undefined && headerSize > maxSize) {
+            throw new DecompressionBombError(compressed.length, headerSize, maxSize);
+        }
+    }
+    const decompressed = await withTimeout(decompress(compressed, algorithm), timeoutMs, CompressionOperation.DECOMPRESS);
+    if (decompressed.length > maxSize) {
+        throw new DecompressionBombError(compressed.length, decompressed.length, maxSize);
+    }
+    return JSON.parse(decompressed.toString('utf8'));
+}
+exports.decompressFromBase64 = decompressFromBase64;
+//# sourceMappingURL=compression.js.map

package/dist/cjs/utils/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../../src/utils/compression.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/custom-measure-formula-utils.d.ts

@@ -0,0 +1,6 @@
+import { FormulaAst, FormulaToken, FormulaValidationOptions, FormulaValidationResult } from '@adtrackify/at-tracking-event-types';
+export declare const tokenizeFormula: (formula: string) => FormulaToken[];
+export declare const parseFormula: (formula: string) => FormulaAst;
+export declare const collectFormulaMeasures: (ast: FormulaAst) => string[];
+export declare const evaluateFormulaAst: (ast: FormulaAst, operandValues: ReadonlyMap<string, number | null | undefined>) => number;
+export declare const validateFormula: (formula: string, options?: FormulaValidationOptions) => FormulaValidationResult;

package/dist/cjs/utils/custom-measure-formula-utils.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFormula = exports.evaluateFormulaAst = exports.collectFormulaMeasures = exports.parseFormula = exports.tokenizeFormula = void 0;
+const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
+const NUMBER_PATTERN = /^[0-9]+(\.[0-9]+)?$/;
+const MEASURE_PATTERN = /^[a-z][a-z0-9_]*(\.[a-z0-9_]+)+$/;
+const ALLOWED_CHARS_PATTERN = /[^a-z0-9_.+\-*/()\s]/;
+const tokenizeFormula = (formula) => {
+    if (!formula || formula.trim().length === 0) {
+        throw new Error('Formula is empty');
+    }
+    const invalidChar = formula.match(ALLOWED_CHARS_PATTERN);
+    if (invalidChar) {
+        throw new Error(`Invalid character in formula: '${invalidChar[0]}'`);
+    }
+    const tokens = [];
+    let i = 0;
+    while (i < formula.length) {
+        const char = formula[i];
+        if (/\s/.test(char)) {
+            i += 1;
+            continue;
+        }
+        if (char === '(' || char === ')') {
+            tokens.push({ type: char === '(' ? at_tracking_event_types_1.FORMULA_TOKEN_TYPE.LPAREN : at_tracking_event_types_1.FORMULA_TOKEN_TYPE.RPAREN, value: char });
+            i += 1;
+            continue;
+        }
+        if (char === '+' || char === '-' || char === '*' || char === '/') {
+            tokens.push({ type: at_tracking_event_types_1.FORMULA_TOKEN_TYPE.OPERATOR, value: char });
+            i += 1;
+            continue;
+        }
+        if (char >= '0' && char <= '9') {
+            let value = '';
+            while (i < formula.length && /[0-9.]/.test(formula[i])) {
+                value += formula[i];
+                i += 1;
+            }
+            if (!NUMBER_PATTERN.test(value)) {
+                throw new Error(`Invalid number in formula: '${value}'`);
+            }
+            tokens.push({ type: at_tracking_event_types_1.FORMULA_TOKEN_TYPE.NUMBER, value });
+            continue;
+        }
+        if (char >= 'a' && char <= 'z') {
+            let value = '';
+            while (i < formula.length && /[a-z0-9_.]/.test(formula[i])) {
+                value += formula[i];
+                i += 1;
+            }
+            if (!MEASURE_PATTERN.test(value)) {
+                throw new Error(`Invalid measure reference in formula: '${value}'`);
+            }
+            tokens.push({ type: at_tracking_event_types_1.FORMULA_TOKEN_TYPE.MEASURE, value });
+            continue;
+        }
+        throw new Error(`Invalid character in formula: '${char}'`);
+    }
+    return tokens;
+};
+exports.tokenizeFormula = tokenizeFormula;
+const parseFormula = (formula) => {
+    const tokens = (0, exports.tokenizeFormula)(formula);
+    let pos = 0;
+    const peek = () => tokens[pos];
+    const parseExpression = () => {
+        let left = parseTerm();
+        while (peek()?.type === at_tracking_event_types_1.FORMULA_TOKEN_TYPE.OPERATOR && (peek()?.value === '+' || peek()?.value === '-')) {
+            const operator = tokens[pos].value;
+            pos += 1;
+            const right = parseTerm();
+            left = { type: at_tracking_event_types_1.FORMULA_NODE_TYPE.BINARY, operator, left, right };
+        }
+        return left;
+    };
+    const parseTerm = () => {
+        let left = parseFactor();
+        while (peek()?.type === at_tracking_event_types_1.FORMULA_TOKEN_TYPE.OPERATOR && (peek()?.value === '*' || peek()?.value === '/')) {
+            const operator = tokens[pos].value;
+            pos += 1;
+            const right = parseFactor();
+            left = { type: at_tracking_event_types_1.FORMULA_NODE_TYPE.BINARY, operator, left, right };
+        }
+        return left;
+    };
+    const parseFactor = () => {
+        const token = peek();
+        if (!token) {
+            throw new Error('Unexpected end of formula');
+        }
+        if (token.type === at_tracking_event_types_1.FORMULA_TOKEN_TYPE.OPERATOR && token.value === '-') {
+            pos += 1;
+            return { type: at_tracking_event_types_1.FORMULA_NODE_TYPE.UNARY, operator: at_tracking_event_types_1.FORMULA_OPERATOR.SUBTRACT, operand: parseFactor() };
+        }
+        if (token.type === at_tracking_event_types_1.FORMULA_TOKEN_TYPE.NUMBER) {
+            pos += 1;
+            return { type: at_tracking_event_types_1.FORMULA_NODE_TYPE.NUMBER, value: Number(token.value) };
+        }
+        if (token.type === at_tracking_event_types_1.FORMULA_TOKEN_TYPE.MEASURE) {
+            pos += 1;
+            return { type: at_tracking_event_types_1.FORMULA_NODE_TYPE.MEASURE, measure: token.value };
+        }
+        if (token.type === at_tracking_event_types_1.FORMULA_TOKEN_TYPE.LPAREN) {
+            pos += 1;
+            const expression = parseExpression();
+            if (peek()?.type !== at_tracking_event_types_1.FORMULA_TOKEN_TYPE.RPAREN) {
+                throw new Error('Unbalanced parentheses in formula');
+            }
+            pos += 1;
+            return expression;
+        }
+        throw new Error(`Unexpected token in formula: '${token.value}'`);
+    };
+    const ast = parseExpression();
+    if (pos !== tokens.length) {
+        throw new Error(`Unexpected token in formula: '${tokens[pos].value}'`);
+    }
+    return ast;
+};
+exports.parseFormula = parseFormula;
+const collectFormulaMeasures = (ast) => {
+    const measures = [];
+    const walk = (node) => {
+        switch (node.type) {
+            case at_tracking_event_types_1.FORMULA_NODE_TYPE.MEASURE:
+                if (!measures.includes(node.measure)) {
+                    measures.push(node.measure);
+                }
+                break;
+            case at_tracking_event_types_1.FORMULA_NODE_TYPE.UNARY:
+                walk(node.operand);
+                break;
+            case at_tracking_event_types_1.FORMULA_NODE_TYPE.BINARY:
+                walk(node.left);
+                walk(node.right);
+                break;
+        }
+    };
+    walk(ast);
+    return measures;
+};
+exports.collectFormulaMeasures = collectFormulaMeasures;
+const evaluateFormulaAst = (ast, operandValues) => {
+    switch (ast.type) {
+        case at_tracking_event_types_1.FORMULA_NODE_TYPE.NUMBER:
+            return ast.value;
+        case at_tracking_event_types_1.FORMULA_NODE_TYPE.MEASURE: {
+            const value = Number(operandValues.get(ast.measure));
+            return Number.isFinite(value) ? value : 0;
+        }
+        case at_tracking_event_types_1.FORMULA_NODE_TYPE.UNARY:
+            return -(0, exports.evaluateFormulaAst)(ast.operand, operandValues);
+        case at_tracking_event_types_1.FORMULA_NODE_TYPE.BINARY: {
+            const left = (0, exports.evaluateFormulaAst)(ast.left, operandValues);
+            const right = (0, exports.evaluateFormulaAst)(ast.right, operandValues);
+            switch (ast.operator) {
+                case at_tracking_event_types_1.FORMULA_OPERATOR.ADD:
+                    return left + right;
+                case at_tracking_event_types_1.FORMULA_OPERATOR.SUBTRACT:
+                    return left - right;
+                case at_tracking_event_types_1.FORMULA_OPERATOR.MULTIPLY:
+                    return left * right;
+                case at_tracking_event_types_1.FORMULA_OPERATOR.DIVIDE:
+                    return right === 0 ? 0 : left / right;
+            }
+        }
+    }
+};
+exports.evaluateFormulaAst = evaluateFormulaAst;
+const hasConstantZeroDivisor = (ast) => {
+    switch (ast.type) {
+        case at_tracking_event_types_1.FORMULA_NODE_TYPE.UNARY:
+            return hasConstantZeroDivisor(ast.operand);
+        case at_tracking_event_types_1.FORMULA_NODE_TYPE.BINARY: {
+            const divisorIsConstantZero = ast.operator === at_tracking_event_types_1.FORMULA_OPERATOR.DIVIDE &&
+                (0, exports.collectFormulaMeasures)(ast.right).length === 0 &&
+                (0, exports.evaluateFormulaAst)(ast.right, EMPTY_OPERAND_VALUES) === 0;
+            return divisorIsConstantZero || hasConstantZeroDivisor(ast.left) || hasConstantZeroDivisor(ast.right);
+        }
+        default:
+            return false;
+    }
+};
+const EMPTY_OPERAND_VALUES = new Map();
+const validateFormula = (formula, options) => {
+    let ast;
+    try {
+        ast = (0, exports.parseFormula)(formula);
+    }
+    catch (error) {
+        return { valid: false, errors: [error.message] };
+    }
+    const errors = [];
+    const measures = (0, exports.collectFormulaMeasures)(ast);
+    if (measures.length === 0) {
+        errors.push('Formula must reference at least one measure');
+    }
+    measures.forEach((measure) => {
+        if (options?.knownOperands && !options.knownOperands.has(measure)) {
+            errors.push(`Unknown or unsupported measure: '${measure}'`);
+        }
+    });
+    if (hasConstantZeroDivisor(ast)) {
+        errors.push('Division by zero is not allowed');
+    }
+    return errors.length > 0 ? { valid: false, errors } : { valid: true, errors: [], ast };
+};
+exports.validateFormula = validateFormula;
+//# sourceMappingURL=custom-measure-formula-utils.js.map

package/dist/cjs/utils/custom-measure-formula-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-measure-formula-utils.js","sourceRoot":"","sources":["../../../src/utils/custom-measure-formula-utils.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './size.js';
+export * from './compression.js';
+export * from './retry-envelope.js';
+export * from './custom-measure-formula-utils.js';

package/dist/cjs/utils/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./size.js"), exports);
+__exportStar(require("./compression.js"), exports);
+__exportStar(require("./retry-envelope.js"), exports);
+__exportStar(require("./custom-measure-formula-utils.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,mDAAiC;AACjC,sDAAoC;AACpC,oEAAkD"}

package/dist/cjs/utils/retry-envelope.d.ts

@@ -0,0 +1,12 @@
+export interface RetryEnvelope<T> {
+    item: T;
+    retryCount: number;
+    firstFailedAt: string;
+    lastError: string;
+}
+export declare function isRetryEnvelope<T>(payload: unknown): payload is RetryEnvelope<T>;
+export declare function unwrapItem<T>(payload: T | RetryEnvelope<T>): {
+    item: T;
+    retryCount: number;
+};
+export declare function createRetryEnvelope<T>(item: T, currentRetryCount: number, originalPayload: T | RetryEnvelope<T>, error: unknown): RetryEnvelope<T>;

package/dist/cjs/utils/retry-envelope.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetryEnvelope = exports.unwrapItem = exports.isRetryEnvelope = void 0;
+function isRetryEnvelope(payload) {
+    return (typeof payload === 'object' &&
+        payload !== null &&
+        'item' in payload &&
+        'retryCount' in payload &&
+        typeof payload.retryCount === 'number');
+}
+exports.isRetryEnvelope = isRetryEnvelope;
+function unwrapItem(payload) {
+    if (isRetryEnvelope(payload)) {
+        return { item: payload.item, retryCount: payload.retryCount };
+    }
+    return { item: payload, retryCount: 0 };
+}
+exports.unwrapItem = unwrapItem;
+function createRetryEnvelope(item, currentRetryCount, originalPayload, error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+        item,
+        retryCount: currentRetryCount + 1,
+        firstFailedAt: isRetryEnvelope(originalPayload) ? originalPayload.firstFailedAt : new Date().toISOString(),
+        lastError: errorMessage,
+    };
+}
+exports.createRetryEnvelope = createRetryEnvelope;
+//# sourceMappingURL=retry-envelope.js.map

package/dist/cjs/utils/retry-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-envelope.js","sourceRoot":"","sources":["../../../src/utils/retry-envelope.ts"],"names":[],"mappings":";;;AAcA,SAAgB,eAAe,CAAI,OAAgB;IACjD,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,MAAM,IAAI,OAAO;QACjB,YAAY,IAAI,OAAO;QACvB,OAAQ,OAA4B,CAAC,UAAU,KAAK,QAAQ,CAC7D,CAAC;AACJ,CAAC;AARD,0CAQC;AAMD,SAAgB,UAAU,CAAI,OAA6B;IACzD,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE;QAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAC/D;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAC1C,CAAC;AALD,gCAKC;AAMD,SAAgB,mBAAmB,CACjC,IAAO,EACP,iBAAyB,EACzB,eAAqC,EACrC,KAAc;IAEd,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5E,OAAO;QACL,IAAI;QACJ,UAAU,EAAE,iBAAiB,GAAG,CAAC;QACjC,aAAa,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1G,SAAS,EAAE,YAAY;KACxB,CAAC;AACJ,CAAC;AAdD,kDAcC"}

package/dist/cjs/utils/size.d.ts

@@ -0,0 +1,2 @@
+export declare function sizeInBytes(obj: unknown): number;
+export declare function chunkArrayBySize<T>(array: T[], maxChunkSizeBytes: number, maxItemsPerChunk?: number): T[][];

package/dist/cjs/utils/size.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunkArrayBySize = exports.sizeInBytes = void 0;
+const logging_helper_js_1 = require("../helpers/logging-helper.js");
+function sizeInBytes(obj) {
+    try {
+        return new TextEncoder().encode(JSON.stringify(obj)).length;
+    }
+    catch (error) {
+        logging_helper_js_1.Logger.warn('sizeInBytes: failed to stringify object, returning fallback size', {
+            error,
+            objectType: typeof obj,
+        });
+        return 1024 * 1024;
+    }
+}
+exports.sizeInBytes = sizeInBytes;
+function chunkArrayBySize(array, maxChunkSizeBytes, maxItemsPerChunk) {
+    const chunks = [];
+    let currentChunk = [];
+    let currentChunkSize = 0;
+    for (const item of array) {
+        const itemSize = sizeInBytes(item);
+        const arrayOverhead = 2 + Math.max(0, currentChunk.length);
+        const wouldExceedSize = currentChunkSize + itemSize + arrayOverhead > maxChunkSizeBytes;
+        const wouldExceedCount = maxItemsPerChunk !== undefined && currentChunk.length >= maxItemsPerChunk;
+        if ((wouldExceedSize || wouldExceedCount) && currentChunk.length > 0) {
+            chunks.push(currentChunk);
+            currentChunk = [];
+            currentChunkSize = 0;
+        }
+        if (itemSize > maxChunkSizeBytes) {
+            if (currentChunk.length > 0) {
+                chunks.push(currentChunk);
+                currentChunk = [];
+                currentChunkSize = 0;
+            }
+            chunks.push([item]);
+            continue;
+        }
+        currentChunk.push(item);
+        currentChunkSize += itemSize;
+    }
+    if (currentChunk.length > 0) {
+        chunks.push(currentChunk);
+    }
+    return chunks;
+}
+exports.chunkArrayBySize = chunkArrayBySize;
+//# sourceMappingURL=size.js.map

package/dist/cjs/utils/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../../src/utils/size.ts"],"names":[],"mappings":";;;AAAA,oEAAsD;AAMtD,SAAgB,WAAW,CAAC,GAAY;IACtC,IAAI;QACF,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;KAC7D;IAAC,OAAO,KAAK,EAAE;QACd,0BAAM,CAAC,IAAI,CAAC,kEAAkE,EAAE;YAC9E,KAAK;YACL,UAAU,EAAE,OAAO,GAAG;SACvB,CAAC,CAAC;QACH,OAAO,IAAI,GAAG,IAAI,CAAC;KACpB;AACH,CAAC;AAVD,kCAUC;AAYD,SAAgB,gBAAgB,CAAI,KAAU,EAAE,iBAAyB,EAAE,gBAAyB;IAClG,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,IAAI,YAAY,GAAQ,EAAE,CAAC;IAC3B,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAInC,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAG3D,MAAM,eAAe,GAAG,gBAAgB,GAAG,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;QACxF,MAAM,gBAAgB,GAAG,gBAAgB,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,IAAI,gBAAgB,CAAC;QAEnG,IAAI,CAAC,eAAe,IAAI,gBAAgB,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;YACpE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1B,YAAY,GAAG,EAAE,CAAC;YAClB,gBAAgB,GAAG,CAAC,CAAC;SACtB;QAGD,IAAI,QAAQ,GAAG,iBAAiB,EAAE;YAEhC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC3B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC1B,YAAY,GAAG,EAAE,CAAC;gBAClB,gBAAgB,GAAG,CAAC,CAAC;aACtB;YACD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACpB,SAAS;SACV;QAED,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,gBAAgB,IAAI,QAAQ,CAAC;KAC9B;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;QAC3B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;KAC3B;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AA3CD,4CA2CC"}

package/dist/esm/__tests__/clients/acuity-client.spec.d.ts

@@ -0,0 +1 @@
+export {};