@metriport/shared 0.9.7 → 0.9.8-alpha.0

package/dist/common/__tests__/retry.test.js

@@ -2,30 +2,201 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const faker_1 = require("@faker-js/faker");
 const retry_1 = require("../retry");
-describe("executeWithRetries", () => {
-    it("returns the first successful execution", async () => {
+describe("retry", () => {
+    describe("executeWithRetries", () => {
         const fn = jest.fn();
-        await (0, retry_1.executeWithRetriesOrFail)(fn, undefined, 1);
-        expect(fn).toHaveBeenCalledTimes(1);
+        beforeEach(() => {
+            fn.mockImplementation(() => {
+                throw new Error("error");
+            });
+        });
+        afterEach(() => {
+            jest.resetAllMocks();
+        });
+        it("returns the first successful execution", async () => {
+            const expectedResult = faker_1.faker.lorem.word();
+            fn.mockImplementationOnce(() => expectedResult);
+            const resp = await (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 2,
+            });
+            expect(resp).toEqual(expectedResult);
+            expect(fn).toHaveBeenCalledTimes(1);
+        });
+        it("keeps trying on error and returns the first successful execution", async () => {
+            const expectedResult = faker_1.faker.lorem.sentence();
+            fn.mockImplementationOnce(() => {
+                throw new Error("test error");
+            });
+            fn.mockImplementationOnce(() => expectedResult);
+            const resp = await (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 3,
+            });
+            expect(resp).toBeTruthy();
+            expect(resp).toEqual(expectedResult);
+            expect(fn).toHaveBeenCalledTimes(2);
+        });
+        it("throws after maxxed out attempts", async () => {
+            await expect(async () => (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 3,
+            })).rejects.toThrow();
+            expect(fn).toHaveBeenCalledTimes(3);
+        });
+        it("uses custom shouldRetry when provided", async () => {
+            const shouldRetry = (_r, _e, attempt) => {
+                return attempt !== 2;
+            };
+            await expect(async () => (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 3,
+                shouldRetry,
+            })).rejects.toThrow();
+            expect(fn).toHaveBeenCalledTimes(2);
+        });
+        test("initial values to getTimeToWait", async () => {
+            const getTimeToWait = jest.fn(() => 1);
+            await expect(async () => (0, retry_1.executeWithRetries)(fn, {
+                maxAttempts: 2,
+                getTimeToWait,
+            })).rejects.toThrow();
+            expect(getTimeToWait).toHaveBeenCalledWith({
+                initialDelay: 10,
+                backoffMultiplier: 2,
+                attempt: 1,
+                maxDelay: Infinity,
+            });
+        });
+        test("uses provided initialDelay", async () => {
+            const initialDelay = faker_1.faker.number.int({ min: 10, max: 30 });
+            const getTimeToWait = jest.fn(() => 1);
+            await expect(async () => (0, retry_1.executeWithRetries)(fn, {
+                maxAttempts: 2,
+                initialDelay,
+                getTimeToWait,
+            })).rejects.toThrow();
+            expect(getTimeToWait).toHaveBeenCalledWith(expect.objectContaining({
+                initialDelay,
+            }));
+        });
+        test("uses provided maxDelay", async () => {
+            const maxDelay = faker_1.faker.number.int({ min: 10, max: 30 });
+            const getTimeToWait = jest.fn(() => 1);
+            await expect(async () => (0, retry_1.executeWithRetries)(fn, {
+                maxAttempts: 2,
+                initialDelay: 1,
+                maxDelay,
+                getTimeToWait,
+            })).rejects.toThrow();
+            expect(getTimeToWait).toHaveBeenCalledWith(expect.objectContaining({
+                maxDelay,
+            }));
+        });
     });
-    it("keeps trying on error and returns the first successful execution", async () => {
-        const expectedResponse = faker_1.faker.lorem.sentence();
-        const fn = jest.fn(async () => expectedResponse);
-        fn.mockImplementationOnce(() => {
-            throw new Error("test error");
-        });
-        const resp = await (0, retry_1.executeWithRetriesOrFail)(fn, undefined, 1);
-        expect(resp).toBeTruthy();
-        expect(resp).toEqual(expectedResponse);
-        expect(fn).toHaveBeenCalledTimes(2);
+    describe("executeWithRetriesOnResult", () => {
+        const fn = jest.fn();
+        beforeEach(() => {
+            fn.mockImplementation(() => {
+                throw new Error("error");
+            });
+        });
+        afterEach(() => {
+            jest.resetAllMocks();
+        });
+        it("returns the first successful execution", async () => {
+            const expectedResult = faker_1.faker.lorem.word();
+            fn.mockImplementationOnce(() => expectedResult);
+            const resp = await (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 2,
+            });
+            expect(resp).toEqual(expectedResult);
+            expect(fn).toHaveBeenCalledTimes(1);
+        });
+        it("keeps trying on retryable result and returns the first non-retryable result", async () => {
+            const retryableResult = faker_1.faker.lorem.word();
+            const expectedResult = faker_1.faker.lorem.sentence();
+            fn.mockImplementationOnce(() => retryableResult);
+            fn.mockImplementationOnce(() => expectedResult);
+            const resp = await (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 3,
+                shouldRetry: result => result === retryableResult,
+            });
+            expect(resp).toEqual(expectedResult);
+            expect(fn).toHaveBeenCalledTimes(2);
+        });
+        it("returns the last retryable result after max attempts", async () => {
+            const retryableResult = faker_1.faker.lorem.word();
+            fn.mockImplementation(() => retryableResult);
+            const resp = await (0, retry_1.executeWithRetries)(fn, {
+                initialDelay: 1,
+                maxAttempts: 3,
+                shouldRetry: result => result === retryableResult,
+            });
+            expect(resp).toEqual(retryableResult);
+            expect(fn).toHaveBeenCalledTimes(3);
+        });
+    });
+    describe("defaultGetTimeToWait", () => {
+        it("returns initialDelay when backoffMultiplier is lower than 1", async () => {
+            const initialDelay = faker_1.faker.number.int({ min: 10, max: 30 });
+            const resp = (0, retry_1.defaultGetTimeToWait)({
+                initialDelay,
+                backoffMultiplier: 0,
+                attempt: 5,
+                maxDelay: 5,
+            });
+            expect(resp).toEqual(initialDelay);
+        });
+        it("does not return lower than initialDelay", async () => {
+            const initialDelayArray = new Array(20)
+                .fill(1)
+                .map(() => faker_1.faker.number.int({ min: 10, max: 30 }));
+            for (const initialDelay of initialDelayArray) {
+                const resp = (0, retry_1.defaultGetTimeToWait)({
+                    initialDelay,
+                    backoffMultiplier: 2,
+                    attempt: 1,
+                    maxDelay: 100,
+                });
+                expect(resp).toBeGreaterThanOrEqual(initialDelay);
+            }
+        });
+        it("does not return higher than 2x initialDelay", async () => {
+            const initialDelayArray = new Array(20)
+                .fill(1)
+                .map(() => faker_1.faker.number.int({ min: 10, max: 30 }));
+            for (const initialDelay of initialDelayArray) {
+                const resp = (0, retry_1.defaultGetTimeToWait)({
+                    initialDelay,
+                    backoffMultiplier: 2,
+                    attempt: 1,
+                    maxDelay: 100,
+                });
+                expect(resp).toBeLessThanOrEqual(initialDelay * 2);
+            }
+        });
     });
-    it("throws after maxxed out retries", async () => {
+    describe("executeWithRetriesSafe", () => {
         const fn = jest.fn();
-        const errorMsg = "test error";
-        fn.mockImplementation(() => {
-            throw new Error(errorMsg);
+        beforeEach(() => {
+            fn.mockImplementation(() => {
+                throw new Error("error");
+            });
+        });
+        afterEach(() => {
+            jest.resetAllMocks();
+        });
+        it("returns undefined when it fails", async () => {
+            const resp = await (0, retry_1.executeWithRetriesSafe)(fn, {
+                initialDelay: 1,
+                maxAttempts: 2,
+            });
+            expect(fn).toHaveBeenCalledTimes(2);
+            expect(resp).toBeUndefined();
         });
-        await expect((0, retry_1.executeWithRetriesOrFail)(fn, undefined, 1)).rejects.toThrow(errorMsg);
     });
 });
 //# sourceMappingURL=retry.test.js.map

package/dist/common/__tests__/retry.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.test.js","sourceRoot":"","sources":["../../../src/common/__tests__/retry.test.ts"],"names":[],"mappings":";;AAAA,2CAAwC;AACxC,oCAAoD;AAEpD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrB,MAAM,IAAA,gCAAwB,EAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,gBAAgB,GAAG,aAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,gBAAgB,CAAC,CAAC;QACjD,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE;YAC7B,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAA,gCAAwB,EAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,YAAY,CAAC;QAC9B,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACzB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAA,gCAAwB,EAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"retry.test.js","sourceRoot":"","sources":["../../../src/common/__tests__/retry.test.ts"],"names":[],"mappings":"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"}

package/dist/common/array.d.ts

@@ -1,2 +1,2 @@
-export declare function toArray<T>(input: T | T[]): T[];
+export declare function toArray<T>(input: T | T[] | "" | undefined): T[];
 //# sourceMappingURL=array.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/common/array.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAE9C"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/common/array.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,CAK/D"}

package/dist/common/array.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toArray = void 0;
 function toArray(input) {
+    if (input == undefined || input === "") {
+        return [];
+    }
     return Array.isArray(input) ? input : [input];
 }
 exports.toArray = toArray;

package/dist/common/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/common/array.ts"],"names":[],"mappings":";;;AAAA,SAAgB,OAAO,CAAI,KAAc;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAFD,0BAEC"}
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/common/array.ts"],"names":[],"mappings":";;;AAAA,SAAgB,OAAO,CAAI,KAA+B;IACxD,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE;QACtC,OAAO,EAAE,CAAC;KACX;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AALD,0BAKC"}

package/dist/common/file-downloader.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as stream from "stream";
+export type DownloadFileParams = {
+    url: string;
+    outputStream: stream.Writable;
+    headers?: {
+        [index: string]: string;
+    };
+    timeout?: number;
+};
+export declare function downloadFileToMemory(params: Omit<DownloadFileParams, "outputStream">): Promise<Buffer>;
+export declare function downloadFileToStream({ url, outputStream, headers, timeout, }: DownloadFileParams): Promise<boolean>;
+//# sourceMappingURL=file-downloader.d.ts.map

package/dist/common/file-downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-downloader.d.ts","sourceRoot":"","sources":["../../src/common/file-downloader.ts"],"names":[],"mappings":";;AACA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAKjC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC9B,OAAO,CAAC,EAAE;QACR,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;KACzB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,oBAAoB,CAAC,EACzC,GAAG,EACH,YAAY,EACZ,OAAO,EACP,OAAO,GACR,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvC"}

package/dist/common/file-downloader.js

@@ -0,0 +1,63 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadFileToStream = exports.downloadFileToMemory = void 0;
+const axios_1 = __importDefault(require("axios"));
+const stream = __importStar(require("stream"));
+const util = __importStar(require("util"));
+const pipeline = util.promisify(stream.pipeline);
+async function downloadFileToMemory(params) {
+    const buffers = Array();
+    const writableStream = new stream.Writable();
+    const buffer = streamToBuffer(writableStream);
+    writableStream.on("data", (chunk) => buffers.push(Buffer.from(chunk)));
+    writableStream.on("error", (err) => {
+        throw err;
+    });
+    writableStream.on("end", () => {
+        return Buffer.concat(buffers);
+    });
+    await downloadFileToStream({ ...params, outputStream: writableStream });
+    return Buffer.concat(buffers);
+}
+exports.downloadFileToMemory = downloadFileToMemory;
+async function downloadFileToStream({ url, outputStream, headers, timeout, }) {
+    const requestConfig = {
+        responseType: "stream",
+        ...(timeout ? { timeout } : undefined),
+        transitional: {
+            clarifyTimeoutError: true,
+        },
+        ...(headers && { headers }),
+    };
+    const response = await axios_1.default.get(url, requestConfig);
+    await pipeline(response.data, outputStream);
+    return true;
+}
+exports.downloadFileToStream = downloadFileToStream;
+//# sourceMappingURL=file-downloader.js.map

package/dist/common/file-downloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-downloader.js","sourceRoot":"","sources":["../../src/common/file-downloader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,+CAAiC;AACjC,2CAA6B;AAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAW1C,KAAK,UAAU,oBAAoB,CACxC,MAAgD;IAEhD,MAAM,OAAO,GAAG,KAAK,EAAO,CAAC;IAC7B,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACjC,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,MAAM,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAfD,oDAeC;AAEM,KAAK,UAAU,oBAAoB,CAAC,EACzC,GAAG,EACH,YAAY,EACZ,OAAO,EACP,OAAO,GACY;IACnB,MAAM,aAAa,GAAuB;QACxC,YAAY,EAAE,QAAQ;QACtB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACtC,YAAY,EAAE;YACZ,mBAAmB,EAAE,IAAI;SAC1B;QACD,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;KAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAjBD,oDAiBC"}

package/dist/common/http.d.ts

@@ -0,0 +1,42 @@
+export type ExecuteWithRetriesOptions = {
+    /** The intitial delay in milliseconds. Defaults to 100ms. */
+    initialDelay: number;
+    /** The maximum delay in milliseconds, optional. Defaults to Infinity. */
+    maxDelay: number;
+    /**
+     * Determines how the backoff is determined.
+     * It's unlikely that you would change that.
+     * Defaults to 2 (each retry waits double of what the previous one did).
+     */
+    backoffMultiplier: number;
+    /** The maximum number of retries. Defaults to 10. */
+    maxAttempts: number;
+    shouldRetry: (error: unknown, attempt: number) => boolean | Promise<boolean>;
+};
+/**
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ *
+ * @param fn
+ * @param options
+ * @returns
+ */
+export declare function executeWithRetries<T>(fn: () => Promise<T>, options?: Partial<ExecuteWithRetriesOptions>): Promise<T>;
+export type ExecuteWithHttpRetriesOptions = ExecuteWithRetriesOptions & {
+    /** The HTTP status codes to retry. See `defaultOptions` for defaults. */
+    httpStatusToRetry: number[];
+};
+/**
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ *
+ * @param fn
+ * @param options
+ * @returns
+ */
+export declare function executeWithHttpRetries<T>(fn: () => Promise<T>, options?: Partial<ExecuteWithHttpRetriesOptions>): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/common/http.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,yBAAyB,GAAG;IACtC,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E,CAAC;AAUF;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAkB,GAC3D,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,GAAG;IACtE,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAYF;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,OAAO,CAAC,6BAA6B,CAAkB,GAC/D,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/common/http.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeWithHttpRetries = exports.executeWithRetries = void 0;
+const shared_1 = require("@metriport/shared");
+const axios_1 = __importDefault(require("axios"));
+const http_status_1 = __importDefault(require("http-status"));
+const lodash_1 = require("lodash");
+const defaultOptions = {
+    initialDelay: 100,
+    maxDelay: Infinity,
+    backoffMultiplier: 2,
+    maxAttempts: 10,
+    shouldRetry: (_error, _attempt) => true,
+};
+/**
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ *
+ * @param fn
+ * @param options
+ * @returns
+ */
+async function executeWithRetries(fn, options = defaultOptions) {
+    const actualOptions = { ...defaultOptions, ...options };
+    const { initialDelay, maxDelay, backoffMultiplier, maxAttempts: _maxAttempts, shouldRetry, } = actualOptions;
+    const maxAttempts = Math.max(_maxAttempts, 1);
+    let attempt = 0;
+    while (++attempt <= maxAttempts + 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt >= maxAttempts) {
+                throw error;
+            }
+            if (!(await shouldRetry(error, attempt))) {
+                throw error;
+            }
+            const temp = Math.min(initialDelay * backoffMultiplier * attempt, maxDelay);
+            const timeToWait = temp / 2 + (0, lodash_1.random)(0, temp / 2);
+            await (0, shared_1.sleep)(timeToWait);
+        }
+    }
+    throw new shared_1.MetriportError("Unreachable code", undefined, { attempt, maxRetries: maxAttempts });
+}
+exports.executeWithRetries = executeWithRetries;
+const defaultHttpRetryOptions = {
+    ...defaultOptions,
+    httpStatusToRetry: [
+        http_status_1.default.INTERNAL_SERVER_ERROR,
+        http_status_1.default.BAD_GATEWAY,
+        http_status_1.default.SERVICE_UNAVAILABLE,
+        http_status_1.default.GATEWAY_TIMEOUT,
+    ],
+};
+/**
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ *
+ * @param fn
+ * @param options
+ * @returns
+ */
+async function executeWithHttpRetries(fn, options = defaultOptions) {
+    const actualOptions = { ...defaultHttpRetryOptions, ...options };
+    const { httpStatusToRetry } = actualOptions;
+    return executeWithRetries(fn, {
+        ...actualOptions,
+        shouldRetry: (error, _attempt) => {
+            const responseStatus = axios_1.default.isAxiosError(error) && error.response?.status ? error.response.status : 500;
+            return httpStatusToRetry.includes(responseStatus);
+        },
+    });
+}
+exports.executeWithHttpRetries = executeWithHttpRetries;
+//# sourceMappingURL=http.js.map

package/dist/common/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/common/http.ts"],"names":[],"mappings":";;;;;;AAAA,8CAA0D;AAC1D,kDAA0B;AAC1B,8DAAqC;AACrC,mCAAgC;AAkBhC,MAAM,cAAc,GAA8B;IAChD,YAAY,EAAE,GAAG;IACjB,QAAQ,EAAE,QAAQ;IAClB,iBAAiB,EAAE,CAAC;IACpB,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI;CACxC,CAAC;AAEF;;;;;;;;;GASG;AACI,KAAK,UAAU,kBAAkB,CACtC,EAAoB,EACpB,UAA8C,cAAc;IAE5D,MAAM,aAAa,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IACxD,MAAM,EACJ,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,WAAW,EAAE,YAAY,EACzB,WAAW,GACZ,GAAG,aAAa,CAAC;IAClB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,EAAE,OAAO,IAAI,WAAW,GAAG,CAAC,EAAE;QACnC,IAAI;YACF,OAAO,MAAM,EAAE,EAAE,CAAC;SACnB;QAAC,OAAO,KAAU,EAAE;YACnB,IAAI,OAAO,IAAI,WAAW,EAAE;gBAC1B,MAAM,KAAK,CAAC;aACb;YACD,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE;gBACxC,MAAM,KAAK,CAAC;aACb;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,iBAAiB,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,IAAA,eAAM,EAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YAClD,MAAM,IAAA,cAAK,EAAC,UAAU,CAAC,CAAC;SACzB;KACF;IACD,MAAM,IAAI,uBAAc,CAAC,kBAAkB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;AAChG,CAAC;AA9BD,gDA8BC;AAOD,MAAM,uBAAuB,GAAkC;IAC7D,GAAG,cAAc;IACjB,iBAAiB,EAAE;QACjB,qBAAU,CAAC,qBAAqB;QAChC,qBAAU,CAAC,WAAW;QACtB,qBAAU,CAAC,mBAAmB;QAC9B,qBAAU,CAAC,eAAe;KAC3B;CACF,CAAC;AAEF;;;;;;;;;GASG;AACI,KAAK,UAAU,sBAAsB,CAC1C,EAAoB,EACpB,UAAkD,cAAc;IAEhE,MAAM,aAAa,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,OAAO,EAAE,CAAC;IACjE,MAAM,EAAE,iBAAiB,EAAE,GAAG,aAAa,CAAC;IAC5C,OAAO,kBAAkB,CAAC,EAAE,EAAE;QAC5B,GAAG,aAAa;QAChB,WAAW,EAAE,CAAC,KAAc,EAAE,QAAgB,EAAE,EAAE;YAChD,MAAM,cAAc,GAClB,eAAK,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YACpF,OAAO,iBAAiB,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAdD,wDAcC"}

package/dist/common/retry-with-backoff.d.ts

@@ -0,0 +1,27 @@
+export type ExecuteWithRetriesOptions = {
+    /** The intitial delay in milliseconds. Defaults to 100ms. */
+    initialDelay: number;
+    /** The maximum delay in milliseconds, optional. Defaults to Infinity. */
+    maxDelay: number;
+    /**
+     * Determines how the backoff is determined.
+     * It's unlikely that you would change that.
+     * Defaults to 2 (each retry waits double of what the previous one did).
+     */
+    backoffMultiplier: number;
+    /** The maximum number of retries. Defaults to 10. */
+    maxAttempts: number;
+    shouldRetry: (error: unknown, attempt: number) => boolean | Promise<boolean>;
+};
+/**
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ *
+ * @param fn
+ * @param options
+ * @returns
+ */
+export declare function executeWithRetries<T>(fn: () => Promise<T>, options?: Partial<ExecuteWithRetriesOptions>): Promise<T>;
+//# sourceMappingURL=retry-with-backoff.d.ts.map

package/dist/common/retry-with-backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-with-backoff.d.ts","sourceRoot":"","sources":["../../src/common/retry-with-backoff.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,yBAAyB,GAAG;IACtC,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E,CAAC;AAUF;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAkB,GAC3D,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/common/retry-with-backoff.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeWithRetries = void 0;
+const shared_1 = require("@metriport/shared");
+const lodash_1 = require("lodash");
+const defaultOptions = {
+    initialDelay: 100,
+    maxDelay: Infinity,
+    backoffMultiplier: 2,
+    maxAttempts: 10,
+    shouldRetry: (_error, _attempt) => true,
+};
+/**
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ * TODO WIP
+ *
+ * @param fn
+ * @param options
+ * @returns
+ */
+async function executeWithRetries(fn, options = defaultOptions) {
+    const actualOptions = { ...defaultOptions, ...options };
+    const { initialDelay, maxDelay, backoffMultiplier, maxAttempts: _maxAttempts, shouldRetry, } = actualOptions;
+    const maxAttempts = Math.max(_maxAttempts, 1);
+    let attempt = 0;
+    while (++attempt <= maxAttempts + 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt >= maxAttempts) {
+                throw error;
+            }
+            if (!(await shouldRetry(error, attempt))) {
+                throw error;
+            }
+            const temp = Math.min(initialDelay * backoffMultiplier * attempt, maxDelay);
+            const timeToWait = temp / 2 + (0, lodash_1.random)(0, temp / 2);
+            await (0, shared_1.sleep)(timeToWait);
+        }
+    }
+    throw new shared_1.MetriportError("Unreachable code", undefined, { attempt, maxRetries: maxAttempts });
+}
+exports.executeWithRetries = executeWithRetries;
+//# sourceMappingURL=retry-with-backoff.js.map

package/dist/common/retry-with-backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-with-backoff.js","sourceRoot":"","sources":["../../src/common/retry-with-backoff.ts"],"names":[],"mappings":";;;AAAA,8CAA0D;AAC1D,mCAAgC;AAkBhC,MAAM,cAAc,GAA8B;IAChD,YAAY,EAAE,GAAG;IACjB,QAAQ,EAAE,QAAQ;IAClB,iBAAiB,EAAE,CAAC;IACpB,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI;CACxC,CAAC;AAEF;;;;;;;;;GASG;AACI,KAAK,UAAU,kBAAkB,CACtC,EAAoB,EACpB,UAA8C,cAAc;IAE5D,MAAM,aAAa,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IACxD,MAAM,EACJ,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,WAAW,EAAE,YAAY,EACzB,WAAW,GACZ,GAAG,aAAa,CAAC;IAClB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,EAAE,OAAO,IAAI,WAAW,GAAG,CAAC,EAAE;QACnC,IAAI;YACF,OAAO,MAAM,EAAE,EAAE,CAAC;SACnB;QAAC,OAAO,KAAU,EAAE;YACnB,IAAI,OAAO,IAAI,WAAW,EAAE;gBAC1B,MAAM,KAAK,CAAC;aACb;YACD,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE;gBACxC,MAAM,KAAK,CAAC;aACb;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,iBAAiB,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,IAAA,eAAM,EAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YAClD,MAAM,IAAA,cAAK,EAAC,UAAU,CAAC,CAAC;SACzB;KACF;IACD,MAAM,IAAI,uBAAc,CAAC,kBAAkB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;AAChG,CAAC;AA9BD,gDA8BC"}