@metriport/shared 0.32.3 → 0.32.4

package/dist/common/demographics.d.ts

@@ -16,7 +16,7 @@ export declare const SUFFIXES: readonly ["jr", "junior", "sr", "senior", "ii", "
 export type Prefix = (typeof PREFIXES)[number];
 export type Suffix = (typeof SUFFIXES)[number];
 export declare const PREFIX_SET: Set<"ms" | "mr" | "mrs" | "dr" | "prof" | "rev" | "st" | "hon" | "senator" | "sen" | "rep" | "congressman" | "congresswoman" | "gov">;
-export declare const SUFFIX_SET: Set<"jr" | "junior" | "sr" | "senior" | "ii" | "iii" | "iv" | "v" | "vi" | "vii" | "viii" | "ix" | "x" | "2nd" | "3rd" | "4th" | "5th" | "6th" | "7th" | "8th" | "9th" | "10th">;
+export declare const SUFFIX_SET: Set<"v" | "jr" | "junior" | "sr" | "senior" | "ii" | "iii" | "iv" | "vi" | "vii" | "viii" | "ix" | "x" | "2nd" | "3rd" | "4th" | "5th" | "6th" | "7th" | "8th" | "9th" | "10th">;
 export declare function isPrefix(prefix: string): prefix is Prefix;
 export declare function isSuffix(suffix: string): suffix is Suffix;
 export declare function genderMapperFromDomain<G extends string>(mapFromDomain: Record<GenderAtBirth, G>, unknownGender: G): (gender: GenderAtBirth) => G;

package/dist/external/hl7v2/constants.d.ts

@@ -1,10 +1,32 @@
-export declare const BAMBOO_HIE_NAME = "Bamboo";
-export declare const KONZA_HIE_NAME = "Konza";
-export declare const HEALTH_CONNECT_TEXAS_HIE_NAME = "HealthConnectTexas";
-export declare const HIXNY_HIE_NAME = "Hixny";
-export declare const HIE_TEXAS_PCC = "HieTexasPcc";
-export declare const ALOHR_HIE_NAME = "Alohr";
-export declare const LAHIE_HIE_NAME = "Lahie";
-export declare const FLHIE_HIE_NAME = "Flhie";
-export declare const NUMBER_OF_HIEs = 8;
+export declare enum HieName {
+    Bamboo = "Bamboo",
+    Konza = "Konza",
+    HealthConnectTexas = "HealthConnectTexas",
+    Hixny = "Hixny",
+    HieTexasPcc = "HieTexasPcc",
+    Alohr = "Alohr",
+    Lahie = "Lahie",
+    Flhie = "Flhie",
+    Riqi = "Riqi"
+}
+export declare const ALL_HIES: HieName[];
+export declare const NUMBER_OF_HIEs: number;
+/** @deprecated Use HieName.Bamboo */
+export declare const BAMBOO_HIE_NAME = HieName.Bamboo;
+/** @deprecated Use HieName.Konza */
+export declare const KONZA_HIE_NAME = HieName.Konza;
+/** @deprecated Use HieName.HealthConnectTexas */
+export declare const HEALTH_CONNECT_TEXAS_HIE_NAME = HieName.HealthConnectTexas;
+/** @deprecated Use HieName.Hixny */
+export declare const HIXNY_HIE_NAME = HieName.Hixny;
+/** @deprecated Use HieName.HieTexasPcc */
+export declare const HIE_TEXAS_PCC = HieName.HieTexasPcc;
+/** @deprecated Use HieName.Alohr */
+export declare const ALOHR_HIE_NAME = HieName.Alohr;
+/** @deprecated Use HieName.Lahie */
+export declare const LAHIE_HIE_NAME = HieName.Lahie;
+/** @deprecated Use HieName.Flhie */
+export declare const FLHIE_HIE_NAME = HieName.Flhie;
+/** @deprecated Use HieName.Riqi */
+export declare const RIQI_HIE_NAME = HieName.Riqi;
 //# sourceMappingURL=constants.d.ts.map

package/dist/external/hl7v2/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/external/hl7v2/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAC3C,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,cAAc,IAAI,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/external/hl7v2/constants.ts"],"names":[],"mappings":"AAAA,oBAAY,OAAO;IACjB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,kBAAkB,uBAAuB;IACzC,KAAK,UAAU;IACf,WAAW,gBAAgB;IAC3B,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,eAAO,MAAM,QAAQ,WAAyB,CAAC;AAC/C,eAAO,MAAM,cAAc,QAAkB,CAAC;AAE9C,qCAAqC;AACrC,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAC9C,oCAAoC;AACpC,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AACxE,oCAAoC;AACpC,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,0CAA0C;AAC1C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,oCAAoC;AACpC,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,oCAAoC;AACpC,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,oCAAoC;AACpC,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,mCAAmC;AACnC,eAAO,MAAM,aAAa,eAAe,CAAC"}

package/dist/external/hl7v2/constants.js

@@ -1,13 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NUMBER_OF_HIEs = exports.FLHIE_HIE_NAME = exports.LAHIE_HIE_NAME = exports.ALOHR_HIE_NAME = exports.HIE_TEXAS_PCC = exports.HIXNY_HIE_NAME = exports.HEALTH_CONNECT_TEXAS_HIE_NAME = exports.KONZA_HIE_NAME = exports.BAMBOO_HIE_NAME = void 0;
-exports.BAMBOO_HIE_NAME = "Bamboo";
-exports.KONZA_HIE_NAME = "Konza";
-exports.HEALTH_CONNECT_TEXAS_HIE_NAME = "HealthConnectTexas";
-exports.HIXNY_HIE_NAME = "Hixny";
-exports.HIE_TEXAS_PCC = "HieTexasPcc";
-exports.ALOHR_HIE_NAME = "Alohr";
-exports.LAHIE_HIE_NAME = "Lahie";
-exports.FLHIE_HIE_NAME = "Flhie";
-exports.NUMBER_OF_HIEs = 8;
+exports.RIQI_HIE_NAME = exports.FLHIE_HIE_NAME = exports.LAHIE_HIE_NAME = exports.ALOHR_HIE_NAME = exports.HIE_TEXAS_PCC = exports.HIXNY_HIE_NAME = exports.HEALTH_CONNECT_TEXAS_HIE_NAME = exports.KONZA_HIE_NAME = exports.BAMBOO_HIE_NAME = exports.NUMBER_OF_HIEs = exports.ALL_HIES = exports.HieName = void 0;
+var HieName;
+(function (HieName) {
+    HieName["Bamboo"] = "Bamboo";
+    HieName["Konza"] = "Konza";
+    HieName["HealthConnectTexas"] = "HealthConnectTexas";
+    HieName["Hixny"] = "Hixny";
+    HieName["HieTexasPcc"] = "HieTexasPcc";
+    HieName["Alohr"] = "Alohr";
+    HieName["Lahie"] = "Lahie";
+    HieName["Flhie"] = "Flhie";
+    HieName["Riqi"] = "Riqi";
+})(HieName = exports.HieName || (exports.HieName = {}));
+exports.ALL_HIES = Object.values(HieName);
+exports.NUMBER_OF_HIEs = exports.ALL_HIES.length;
+/** @deprecated Use HieName.Bamboo */
+exports.BAMBOO_HIE_NAME = HieName.Bamboo;
+/** @deprecated Use HieName.Konza */
+exports.KONZA_HIE_NAME = HieName.Konza;
+/** @deprecated Use HieName.HealthConnectTexas */
+exports.HEALTH_CONNECT_TEXAS_HIE_NAME = HieName.HealthConnectTexas;
+/** @deprecated Use HieName.Hixny */
+exports.HIXNY_HIE_NAME = HieName.Hixny;
+/** @deprecated Use HieName.HieTexasPcc */
+exports.HIE_TEXAS_PCC = HieName.HieTexasPcc;
+/** @deprecated Use HieName.Alohr */
+exports.ALOHR_HIE_NAME = HieName.Alohr;
+/** @deprecated Use HieName.Lahie */
+exports.LAHIE_HIE_NAME = HieName.Lahie;
+/** @deprecated Use HieName.Flhie */
+exports.FLHIE_HIE_NAME = HieName.Flhie;
+/** @deprecated Use HieName.Riqi */
+exports.RIQI_HIE_NAME = HieName.Riqi;
 //# sourceMappingURL=constants.js.map

package/dist/external/hl7v2/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/external/hl7v2/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,QAAQ,CAAC;AAC3B,QAAA,cAAc,GAAG,OAAO,CAAC;AACzB,QAAA,6BAA6B,GAAG,oBAAoB,CAAC;AACrD,QAAA,cAAc,GAAG,OAAO,CAAC;AACzB,QAAA,aAAa,GAAG,aAAa,CAAC;AAC9B,QAAA,cAAc,GAAG,OAAO,CAAC;AACzB,QAAA,cAAc,GAAG,OAAO,CAAC;AACzB,QAAA,cAAc,GAAG,OAAO,CAAC;AACzB,QAAA,cAAc,GAAG,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/external/hl7v2/constants.ts"],"names":[],"mappings":";;;AAAA,IAAY,OAUX;AAVD,WAAY,OAAO;IACjB,4BAAiB,CAAA;IACjB,0BAAe,CAAA;IACf,oDAAyC,CAAA;IACzC,0BAAe,CAAA;IACf,sCAA2B,CAAA;IAC3B,0BAAe,CAAA;IACf,0BAAe,CAAA;IACf,0BAAe,CAAA;IACf,wBAAa,CAAA;AACf,CAAC,EAVW,OAAO,GAAP,eAAO,KAAP,eAAO,QAUlB;AAEY,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAClC,QAAA,cAAc,GAAG,gBAAQ,CAAC,MAAM,CAAC;AAE9C,qCAAqC;AACxB,QAAA,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;AAC9C,oCAAoC;AACvB,QAAA,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;AAC5C,iDAAiD;AACpC,QAAA,6BAA6B,GAAG,OAAO,CAAC,kBAAkB,CAAC;AACxE,oCAAoC;AACvB,QAAA,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;AAC5C,0CAA0C;AAC7B,QAAA,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;AACjD,oCAAoC;AACvB,QAAA,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;AAC5C,oCAAoC;AACvB,QAAA,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;AAC5C,oCAAoC;AACvB,QAAA,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;AAC5C,mCAAmC;AACtB,QAAA,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC"}

package/dist/util/__tests__/concurrency.test.d.ts

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

package/dist/util/__tests__/concurrency.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.test.d.ts","sourceRoot":"","sources":["../../../src/util/__tests__/concurrency.test.ts"],"names":[],"mappings":""}

package/dist/util/__tests__/concurrency.test.js

@@ -0,0 +1,162 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable @typescript-eslint/no-empty-function */
+const faker_1 = require("@faker-js/faker");
+const sleep_1 = require("../../common/sleep");
+const sleepModule = __importStar(require("../../common/sleep"));
+const concurrency_1 = require("../concurrency");
+const anyNumber = expect.any(Number);
+beforeEach(() => {
+    jest.restoreAllMocks();
+});
+afterAll(() => {
+    jest.restoreAllMocks();
+});
+describe("executeAsynchronously", () => {
+    it("fails if minJitter is lower than zero", async () => {
+        const list = ["a", "b", "c", "d", "e"];
+        const fn = jest.fn(async () => { });
+        await expect((0, concurrency_1.executeAsynchronously)(list, fn, {
+            numberOfParallelExecutions: 2,
+            minJitterMillis: faker_1.faker.number.int({ min: 1 }) * -1,
+        })).rejects.toThrow();
+    });
+    it("fails if maxJitter is lower than zero", async () => {
+        const list = ["a", "b", "c", "d", "e"];
+        const fn = jest.fn(async () => { });
+        await expect((0, concurrency_1.executeAsynchronously)(list, fn, {
+            numberOfParallelExecutions: 2,
+            maxJitterMillis: faker_1.faker.number.int({ min: 1 }) * -1,
+        })).rejects.toThrow();
+    });
+    it("fails if minJitter is higer than maxJitter", async () => {
+        const list = ["a", "b", "c", "d", "e"];
+        const fn = jest.fn(async () => { });
+        await expect((0, concurrency_1.executeAsynchronously)(list, fn, {
+            numberOfParallelExecutions: 2,
+            maxJitterMillis: faker_1.faker.number.int({ min: 0, max: 10 }),
+            minJitterMillis: faker_1.faker.number.int({ min: 11 }),
+        })).rejects.toThrow();
+    });
+    // TODO fix this test, likely need to build a "shift" function so we can mock it (or mock
+    // Array.prototype.shift)
+    // it("runs splits list and runs it asynchronously", async () => {
+    //   const list = ["a", "b", "c", "d", "e"];
+    //   const fn = jest.fn(async () => {
+    //     await sleep(20);
+    //   });
+    //   await executeAsynchronously(list, fn, {
+    //     numberOfParallelExecutions: 2,
+    //     maxJitterMillis: 10,
+    //     minJitterMillis: 10,
+    //   });
+    //   expect(fn).toHaveBeenNthCalledWith(1, "a", 0, 0, 2);
+    //   expect(fn).toHaveBeenNthCalledWith(2, "d", 0, 1, 2);
+    //   expect(fn).toHaveBeenNthCalledWith(3, "b", 1, 0, 2);
+    //   expect(fn).toHaveBeenNthCalledWith(4, "e", 1, 1, 2);
+    //   expect(fn).toHaveBeenNthCalledWith(5, "c", 2, 0, 2);
+    // });
+    it("defaults async runs to to number of items on list", async () => {
+        const list = new Array(21).fill(666);
+        const fn = jest.fn();
+        await (0, concurrency_1.executeAsynchronously)(list, fn);
+        expect(fn).toHaveBeenCalledTimes(list.length);
+    });
+    it("sends correct item ", async () => {
+        const list = [1, 2, 3];
+        const fn = jest.fn();
+        await (0, concurrency_1.executeAsynchronously)(list, fn);
+        expect(fn).toHaveBeenNthCalledWith(1, list[0], anyNumber, anyNumber, anyNumber);
+        expect(fn).toHaveBeenNthCalledWith(2, list[1], anyNumber, anyNumber, anyNumber);
+        expect(fn).toHaveBeenNthCalledWith(3, list[2], anyNumber, anyNumber, anyNumber);
+    });
+    it("sends correct index item ", async () => {
+        const list = [1, 2, 3];
+        const fn = jest.fn();
+        await (0, concurrency_1.executeAsynchronously)(list, fn);
+        expect(fn).toHaveBeenNthCalledWith(1, anyNumber, 0, anyNumber, anyNumber);
+        expect(fn).toHaveBeenNthCalledWith(2, anyNumber, 1, anyNumber, anyNumber);
+        expect(fn).toHaveBeenNthCalledWith(3, anyNumber, 2, anyNumber, anyNumber);
+    });
+    it("jitters before runs", async () => {
+        const sleep_mock = jest.spyOn(sleepModule, "sleep").mockImplementation(async () => { });
+        const randomNumbers = [0.1, 0.2];
+        let lastRandom = 0;
+        const random_mock = jest
+            .spyOn(Math, "random")
+            .mockImplementation(() => randomNumbers[lastRandom++] ?? 0);
+        const list = [1, 2, 3, 4];
+        const fn = jest.fn();
+        await (0, concurrency_1.executeAsynchronously)(list, fn, {
+            numberOfParallelExecutions: 2,
+            maxJitterMillis: 1000,
+        });
+        expect(random_mock).toHaveBeenCalledTimes(2);
+        expect(sleep_mock).toHaveBeenCalledTimes(2);
+        expect(sleep_mock).toHaveBeenNthCalledWith(1, 100);
+        expect(sleep_mock).toHaveBeenNthCalledWith(2, 200);
+    });
+    it("defaults jitter before run to zero", async () => {
+        const sleep_mock = jest.spyOn(sleepModule, "sleep").mockImplementation(async () => { });
+        const list = [1, 2, 3, 4];
+        const fn = jest.fn();
+        await (0, concurrency_1.executeAsynchronously)(list, fn, { numberOfParallelExecutions: 2 });
+        expect(sleep_mock).toHaveBeenCalledTimes(2);
+        expect(sleep_mock).toHaveBeenNthCalledWith(1, 0);
+        expect(sleep_mock).toHaveBeenNthCalledWith(2, 0);
+    });
+});
+describe("threadsafe set operations", () => {
+    it("should add numbers to a set in a thread-safe manner", async () => {
+        const set = new Set();
+        const list = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20];
+        const shuffleArray = (array) => {
+            for (let i = array.length - 1; i > 0; i--) {
+                const j = Math.floor(Math.random() * (i + 1));
+                //eslint-disable-next-line
+                [array[i], array[j]] = [array[j], array[i]];
+            }
+            return array;
+        };
+        const combinedList = [list, ...Array.from({ length: 9 }, () => shuffleArray([...list]))];
+        const addToSet = async (nums) => {
+            for (const num of nums) {
+                await (0, sleep_1.sleep)(10);
+                if (!set.has(num)) {
+                    set.add(num);
+                }
+            }
+        };
+        await (0, concurrency_1.executeAsynchronously)(combinedList, addToSet, {
+            numberOfParallelExecutions: 20,
+        });
+        expect(set.size).toBe(20);
+        for (let i = 1; i <= 20; i++) {
+            expect(set.has(i)).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=concurrency.test.js.map

package/dist/util/__tests__/concurrency.test.js.map

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

package/dist/util/__tests__/null-to-undefined.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=null-to-undefined.test.d.ts.map

package/dist/util/__tests__/null-to-undefined.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-to-undefined.test.d.ts","sourceRoot":"","sources":["../../../src/util/__tests__/null-to-undefined.test.ts"],"names":[],"mappings":""}

package/dist/util/__tests__/null-to-undefined.test.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const null_to_undefined_1 = require("../null-to-undefined");
+const metriport_error_1 = require("../../error/metriport-error");
+describe("nullToUndefined", () => {
+    it("converts top-level null to undefined", () => {
+        expect((0, null_to_undefined_1.nullToUndefined)(null)).toBeUndefined();
+    });
+    it("leaves primitives unchanged", () => {
+        expect((0, null_to_undefined_1.nullToUndefined)("a")).toBe("a");
+        expect((0, null_to_undefined_1.nullToUndefined)(0)).toBe(0);
+        expect((0, null_to_undefined_1.nullToUndefined)(true)).toBe(true);
+    });
+    it("converts null values inside a plain object to undefined", () => {
+        const input = { a: "x", b: null, c: 1 };
+        expect((0, null_to_undefined_1.nullToUndefined)(input)).toEqual({ a: "x", b: undefined, c: 1 });
+    });
+    it("converts null elements inside an array to undefined", () => {
+        const input = ["x", null, 1];
+        expect((0, null_to_undefined_1.nullToUndefined)(input)).toEqual(["x", undefined, 1]);
+    });
+    it("recurses into nested objects and arrays", () => {
+        const input = { rows: [{ code: "x", display: null }] };
+        expect((0, null_to_undefined_1.nullToUndefined)(input)).toEqual({
+            rows: [{ code: "x", display: undefined }],
+        });
+    });
+    it("handles array of row-like objects (select result shape)", () => {
+        const rows = [
+            { code: "10004002", display: "First", property_code: null, property_value: "1" },
+            { code: "1002007", display: null, property_code: "parent", property_value: null },
+        ];
+        expect((0, null_to_undefined_1.nullToUndefined)(rows)).toEqual([
+            { code: "10004002", display: "First", property_code: undefined, property_value: "1" },
+            { code: "1002007", display: undefined, property_code: "parent", property_value: undefined },
+        ]);
+    });
+    it("handles single row (selectOne result shape)", () => {
+        const row = { id: 1, system: "http://snomed.info/sct", name: null };
+        expect((0, null_to_undefined_1.nullToUndefined)(row)).toEqual({
+            id: 1,
+            system: "http://snomed.info/sct",
+            name: undefined,
+        });
+    });
+    it("returns non-plain objects (Date, RegExp, Buffer) unchanged", () => {
+        const d = new Date("2025-01-01");
+        expect((0, null_to_undefined_1.nullToUndefined)(d)).toBe(d);
+        const r = /foo/;
+        expect((0, null_to_undefined_1.nullToUndefined)(r)).toBe(r);
+    });
+    it("throws MetriportError when exceeding maxDepth", () => {
+        let nested = null;
+        for (let i = 0; i < 10; i++)
+            nested = { inner: nested };
+        expect(() => (0, null_to_undefined_1.nullToUndefined)(nested, 5)).toThrow(metriport_error_1.MetriportError);
+        expect(() => (0, null_to_undefined_1.nullToUndefined)(nested, 5)).toThrow("max recursion depth reached in nullToUndefined");
+    });
+});
+//# sourceMappingURL=null-to-undefined.test.js.map

package/dist/util/__tests__/null-to-undefined.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-to-undefined.test.js","sourceRoot":"","sources":["../../../src/util/__tests__/null-to-undefined.test.ts"],"names":[],"mappings":"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"}

package/dist/util/concurrency.d.ts

@@ -0,0 +1,72 @@
+export type ExecuteInChunksOptions = {
+    /**
+     * How many promises should execute at the same time. Defaults to `collection.length` (all promises to run at the same time).
+     */
+    numberOfParallelExecutions?: number;
+    /**
+     * Explict delay between runs. Defaults to 0, no delay.
+     */
+    delay?: number;
+    /**
+     * Maximum jitter in milliseconds before each run. Makes promises
+     * start at slight different times. Defaults to 0, no jitter.
+     */
+    maxJitterMillis?: number;
+    /**
+     * Minimum jitter in milliseconds before each run. Makes promises
+     * start at slight different times. Defaults to 0.
+     */
+    minJitterMillis?: number;
+    /**
+     * Whether to keep executing when an error occurs. Defaults to false, which
+     * means some might finish execution when the error happens - non-deterministic.
+     */
+    keepExecutingOnError?: boolean;
+    /**
+     * Where to log. Defaults to no logging.
+     */
+    log?: typeof console.log;
+};
+/**
+ * Function type that should be passed to `executeAsynchronously`.
+ * It receives the item to be processed, the index of the item in the array,
+ * the index of the promise that is processing the item, and the total amount
+ * of promises that are running in parallel.
+ * It should return a promise that resolves when the processing is done.
+ * It should handle errors internally.
+ * @param item the item to be processed
+ * @param itemIndex the index of the item in the array
+ * @param promiseIndex the index of the promise ("thread") that is processing the item
+ * @param promiseCount the total amount of promises that are running in parallel
+ */
+export type FunctionType<T> = (item: T, itemIndex: number, promiseIndex: number, promiseCount: number) => Promise<void>;
+/**
+ * TODO #ENG-170 Set default `numberOfParallelExecutions` to 5-10 max.
+ *
+ * Process an array or items asynchronously. It doesn't throw if one of the promises fails
+ * (error handling should be done within the promise/function).
+ *
+ * For example, with an array of 19 elements and 4 parallel executions,
+ * we would have something like this being executed, where:
+ * - each row is a promise, like a thread running in parallel to the other promises;
+ * - each column is a function call with the respective item of the array, it runs in sequence
+ *   to other calls on the same row;
+ *
+ * promise
+ * idx| items being executed
+ *   -|---------------------------------------> time
+ *   1| item1 | item2 | item3 | item4 | item5 |
+ *   -|---------------------------------------|
+ *   2| item1 | item2 | item3 | item4 | item5 |
+ *   -|---------------------------------------|
+ *   3| item1 | item2 | item3 | item4 | item5 |
+ *   -|---------------------------------------|
+ *   4| item1 | item2 | item3 | item4 |
+ *   -|---------------------------------------> time
+ *
+ * @param collection array of elements to be processed
+ * @param fn the function to be executed asynchronously
+ * @param options additional settings
+ */
+export declare function executeAsynchronously<T>(collection: T[], fn: FunctionType<T>, { numberOfParallelExecutions, delay, maxJitterMillis, minJitterMillis, keepExecutingOnError, log, }?: ExecuteInChunksOptions): Promise<PromiseSettledResult<void>[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/util/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/util/concurrency.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAC5B,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;AAInB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,UAAU,EAAE,CAAC,EAAE,EACf,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,EACnB,EACE,0BAA8C,EAC9C,KAAS,EACT,eAAmB,EACnB,eAAmB,EACnB,oBAA4B,EAC5B,GAAG,GACJ,GAAE,sBAA2B,GAC7B,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAoCvC"}

package/dist/util/concurrency.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeAsynchronously = void 0;
+const shared_1 = require("../error/shared");
+const sleep_1 = require("../common/sleep");
+const emptyString = "";
+/**
+ * TODO #ENG-170 Set default `numberOfParallelExecutions` to 5-10 max.
+ *
+ * Process an array or items asynchronously. It doesn't throw if one of the promises fails
+ * (error handling should be done within the promise/function).
+ *
+ * For example, with an array of 19 elements and 4 parallel executions,
+ * we would have something like this being executed, where:
+ * - each row is a promise, like a thread running in parallel to the other promises;
+ * - each column is a function call with the respective item of the array, it runs in sequence
+ *   to other calls on the same row;
+ *
+ * promise
+ * idx| items being executed
+ *   -|---------------------------------------> time
+ *   1| item1 | item2 | item3 | item4 | item5 |
+ *   -|---------------------------------------|
+ *   2| item1 | item2 | item3 | item4 | item5 |
+ *   -|---------------------------------------|
+ *   3| item1 | item2 | item3 | item4 | item5 |
+ *   -|---------------------------------------|
+ *   4| item1 | item2 | item3 | item4 |
+ *   -|---------------------------------------> time
+ *
+ * @param collection array of elements to be processed
+ * @param fn the function to be executed asynchronously
+ * @param options additional settings
+ */
+async function executeAsynchronously(collection, fn, { numberOfParallelExecutions = collection.length, delay = 0, maxJitterMillis = 0, minJitterMillis = 0, keepExecutingOnError = false, log, } = {}) {
+    if (delay < 0)
+        throw new Error("delay must be >= 0");
+    if (minJitterMillis < 0)
+        throw new Error("minJitterMillis must be >= 0");
+    if (maxJitterMillis < 0)
+        throw new Error("maxJitterMillis must be >= 0");
+    if (minJitterMillis > maxJitterMillis) {
+        throw new Error("minJitterMillis must be <= maxJitterMillis");
+    }
+    // Copy the array so that we don't mutate the original (this only copies the references)
+    const itemsToProcess = collection.slice();
+    const amountOfPromises = Math.max(Math.min(itemsToProcess.length, numberOfParallelExecutions), 1);
+    const indexControl = { currentIndex: 0 };
+    const promises = new Array(amountOfPromises).fill(0).map(async (_, promiseIndex) => {
+        // possible jitter before each run so that they don't start at the same time
+        const jitter = Math.max(minJitterMillis, Math.random() * maxJitterMillis);
+        await (0, sleep_1.sleep)(jitter);
+        if (delay > 0)
+            await (0, sleep_1.sleep)(delay);
+        await executeSynchronously(itemsToProcess, fn, promiseIndex, amountOfPromises, indexControl, keepExecutingOnError, log);
+    });
+    if (keepExecutingOnError) {
+        return await Promise.allSettled(promises);
+    }
+    return (await Promise.all(promises)).map(p => ({ status: "fulfilled", value: p }));
+}
+exports.executeAsynchronously = executeAsynchronously;
+/**
+ * Document properly before exposing this
+ */
+async function executeSynchronously(itemsToProcess, fn, promiseIndex, amountOfPromises, indexControl, keepExecutingOnError, log) {
+    const tabs = log ? "\t".repeat(promiseIndex) : emptyString;
+    let item;
+    while ((item = itemsToProcess.shift())) {
+        log &&
+            log(`... ${tabs}... promise ${promiseIndex} item ${indexControl.currentIndex} remaining ${itemsToProcess.length}...`);
+        try {
+            await fn(item, indexControl.currentIndex, promiseIndex, amountOfPromises);
+            indexControl.currentIndex = indexControl.currentIndex + 1;
+        }
+        catch (error) {
+            if (keepExecutingOnError) {
+                log &&
+                    log(`Error on item ${indexControl.currentIndex} of promise ${promiseIndex}: ${(0, shared_1.errorToString)(error)}`);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/util/concurrency.js.map

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

package/dist/util/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./base64";
+export * from "./concurrency";
 export * from "./duration";
+export * from "./null-to-undefined";
 export * from "./sqs-delay-from-uuid";
 export * from "./uuid-v7";
 //# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}

package/dist/util/index.js

@@ -15,7 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base64"), exports);
+__exportStar(require("./concurrency"), exports);
 __exportStar(require("./duration"), exports);
+__exportStar(require("./null-to-undefined"), exports);
 __exportStar(require("./sqs-delay-from-uuid"), exports);
 __exportStar(require("./uuid-v7"), exports);
 //# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6CAA2B;AAC3B,wDAAsC;AACtC,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,gDAA8B;AAC9B,6CAA2B;AAC3B,sDAAoC;AACpC,wDAAsC;AACtC,4CAA0B"}

package/dist/util/null-to-undefined.d.ts

@@ -0,0 +1,2 @@
+export declare function nullToUndefined<T>(value: T, maxDepth?: number): T;
+//# sourceMappingURL=null-to-undefined.d.ts.map

package/dist/util/null-to-undefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-to-undefined.d.ts","sourceRoot":"","sources":["../../src/util/null-to-undefined.ts"],"names":[],"mappings":"AAwBA,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,SAAkB,GAAG,CAAC,CAE1E"}

package/dist/util/null-to-undefined.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullToUndefined = void 0;
+const metriport_error_1 = require("../error/metriport-error");
+const defaultMaxDepth = 100;
+function nullToUndefinedAtDepth(value, depth, maxDepth) {
+    if (depth > maxDepth)
+        throw new metriport_error_1.MetriportError("max recursion depth reached in nullToUndefined", undefined, {
+            maxDepth,
+        });
+    if (value === null)
+        return undefined;
+    if (Array.isArray(value)) {
+        return value.map(item => nullToUndefinedAtDepth(item, depth + 1, maxDepth));
+    }
+    if (typeof value === "object") {
+        if (value.constructor !== Object)
+            return value;
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = nullToUndefinedAtDepth(v, depth + 1, maxDepth);
+        }
+        return out;
+    }
+    return value;
+}
+function nullToUndefined(value, maxDepth = defaultMaxDepth) {
+    return nullToUndefinedAtDepth(value, 0, maxDepth);
+}
+exports.nullToUndefined = nullToUndefined;
+//# sourceMappingURL=null-to-undefined.js.map

package/dist/util/null-to-undefined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-to-undefined.js","sourceRoot":"","sources":["../../src/util/null-to-undefined.ts"],"names":[],"mappings":";;;AAAA,8DAA0D;AAE1D,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,SAAS,sBAAsB,CAAI,KAAQ,EAAE,KAAa,EAAE,QAAgB;IAC1E,IAAI,KAAK,GAAG,QAAQ;QAClB,MAAM,IAAI,gCAAc,CAAC,gDAAgD,EAAE,SAAS,EAAE;YACpF,QAAQ;SACT,CAAC,CAAC;IACL,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAc,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAM,CAAC;KAClF;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;SACzD;QACD,OAAO,GAAQ,CAAC;KACjB;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,eAAe,CAAI,KAAQ,EAAE,QAAQ,GAAG,eAAe;IACrE,OAAO,sBAAsB,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC;AAFD,0CAEC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metriport/shared",
-  "version": "0.32.3",
+  "version": "0.32.4",
   "description": "Common code shared across packages - by Metriport Inc.",
   "author": "Metriport Inc. <contact@metriport.com>",
   "homepage": "https://metriport.com/",
@@ -131,5 +131,5 @@
     "ts-jest": "29.1.1",
     "typescript": "^4.9.5"
   },
-  "gitHead": "457d31061f19c1d12ca3f1f1f6c843b1e62a8eb4"
+  "gitHead": "464886060a6adeec1616edd43d5edc8cf4ac4f41"
 }