@metriport/shared 0.33.1 → 0.33.4-alpha.0

package/dist/src/common/__tests__/title-case.test.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const title_case_1 = require("../title-case");
+describe("toTitleCase", () => {
+    it("returns empty string when input is empty", () => {
+        const input = "";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("");
+    });
+    it("capitalizes first letter of single word", () => {
+        const input = "hello";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello");
+    });
+    it("capitalizes first letter of each word with spaces", () => {
+        const input = "hello world";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello World");
+    });
+    it("capitalizes first letter of each word with spaces and punctuation", () => {
+        const input = "hello world, d'angelo";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello World, D'Angelo");
+    });
+    it("does not capitalize first letter of each word with dashes", () => {
+        const input = "hello-world";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello-world");
+    });
+    it("does not capitalize first letter of each word with underscores", () => {
+        const input = "hello_world";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello_world");
+    });
+    it("handles camelCase input", () => {
+        const input = "helloWorld";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Helloworld");
+    });
+    it("handles PascalCase input", () => {
+        const input = "HelloWorld";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Helloworld");
+    });
+    it("trims whitespace from input", () => {
+        const input = "  hello  world  ";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello World");
+    });
+    it("converts input to lowercase before processing", () => {
+        const input = "HELLO WORLD";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello World");
+    });
+    it("handles words with numbers", () => {
+        const input = "hello123 world456";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("Hello123 World456");
+    });
+    it("handles words that start with numbers", () => {
+        const input = "1st 2nd 3rd";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("1st 2nd 3rd");
+    });
+    it("handles alphanumeric camelCase", () => {
+        const input = "user123Name";
+        const result = (0, title_case_1.toTitleCase)(input);
+        expect(result).toBe("User123name");
+    });
+});
+//# sourceMappingURL=title-case.test.js.map

package/dist/src/common/__tests__/title-case.test.js.map

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

package/dist/src/common/__tests__/validate-npi.test.d.ts

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

package/dist/src/common/__tests__/validate-npi.test.d.ts.map

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

package/dist/src/common/__tests__/validate-npi.test.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validate_npi_1 = require("../validate-npi");
+const npi_1 = require("./npi");
+describe("validate-npi", () => {
+    describe("returns true when it gets valid NPI number", () => {
+        for (let i = 0; i < 10; i++) {
+            const npi = (0, npi_1.makeNPI)();
+            it(npi, async () => {
+                expect((0, validate_npi_1.validateNPI)(npi)).toBeTruthy();
+            });
+        }
+    });
+    it("returns false when it gets empty string", async () => {
+        expect((0, validate_npi_1.validateNPI)("")).toBeFalsy();
+    });
+    it("returns false when it gets undefined", async () => {
+        expect((0, validate_npi_1.validateNPI)(undefined)).toBeFalsy();
+    });
+    it("returns false when it gets invalid 10 digit string", async () => {
+        expect((0, validate_npi_1.validateNPI)(String(1123123123))).toBeFalsy();
+    });
+});
+//# sourceMappingURL=validate-npi.test.js.map

package/dist/src/common/__tests__/validate-npi.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-npi.test.js","sourceRoot":"","sources":["../../../../src/common/__tests__/validate-npi.test.ts"],"names":[],"mappings":";;AAAA,kDAA8C;AAC9C,+BAAgC;AAEhC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAA,aAAO,GAAE,CAAC;YACtB,EAAE,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;gBACjB,MAAM,CAAC,IAAA,0BAAW,EAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,CAAC,IAAA,0BAAW,EAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,CAAC,IAAA,0BAAW,EAAC,SAA8B,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,CAAC,IAAA,0BAAW,EAAC,MAAM,CAAC,UAAa,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

@@ -0,0 +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,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,CAK/D"}

package/dist/src/common/array.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toArray = toArray;
+function toArray(input) {
+    if (input == undefined || input === "") {
+        return [];
+    }
+    return Array.isArray(input) ? input : [input];
+}
+//# sourceMappingURL=array.js.map

package/dist/src/common/array.js.map

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

package/dist/src/common/boolean.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns true if the value is true. It doesn't check for "truthyness"!
+ * - if value is a string, it will normalized and compared agains "true";
+ * - if value is a boolean, it will return the value;
+ * - otherwise, it will return false.
+ */
+export declare function isTrue(value: unknown): boolean;
+export declare function isTrueString(value: string): boolean;
+//# sourceMappingURL=boolean.d.ts.map

package/dist/src/common/boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.d.ts","sourceRoot":"","sources":["../../../src/common/boolean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInD"}

package/dist/src/common/boolean.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTrue = isTrue;
+exports.isTrueString = isTrueString;
+/**
+ * Returns true if the value is true. It doesn't check for "truthyness"!
+ * - if value is a string, it will normalized and compared agains "true";
+ * - if value is a boolean, it will return the value;
+ * - otherwise, it will return false.
+ */
+function isTrue(value) {
+    if (!value)
+        return false;
+    if (typeof value === "string")
+        return isTrueString(value);
+    if (typeof value === "boolean")
+        return value;
+    return false;
+}
+function isTrueString(value) {
+    if (!value)
+        return false;
+    const parsed = typeof value === "string" ? value.trim().toLowerCase() : value;
+    return parsed === "true";
+}
+//# sourceMappingURL=boolean.js.map

package/dist/src/common/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../src/common/boolean.ts"],"names":[],"mappings":";;AAMA,wBAKC;AAED,oCAIC;AAjBD;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9E,OAAO,MAAM,KAAK,MAAM,CAAC;AAC3B,CAAC"}

package/dist/src/common/date.d.ts

@@ -0,0 +1,68 @@
+import dayjs, { ConfigType } from "dayjs";
+import { z } from "zod";
+export declare const ISO_DATE = "YYYY-MM-DD";
+export declare const ISO_DATE_TIME = "YYYY-MM-DDTHH:mm:ss.SSSZ";
+/** @see https://day.js.org/docs/en/parse/is-valid  */
+export declare function isValidISODate(date: string): boolean;
+export declare function isValidISODateTime(date: string): boolean;
+export type ValidateDobFn = (date: string) => boolean;
+/**
+ * Validates if a date is a valid date of birth.
+ *
+ * @param date The date to validate
+ * @param options just for testing purposes, so we can pass mock functions
+ * @returns true if the date is valid, false otherwise
+ */
+export declare function validateDateOfBirth(date: string, options?: {
+    validateDateIsAfter1900?: ValidateDobFn;
+    validateIsPastOrPresent?: ValidateDobFn;
+}): boolean;
+export declare function validateIsPastOrPresent(date: string): true;
+export declare function validateIsPastOrPresentSafe(date: string): boolean;
+export declare function validateDateIsAfter1900(date: string): boolean;
+export declare function validateDateRange(start: string, end: string): true;
+export declare const optionalDateSchema: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | null | undefined, string | null | undefined>;
+export declare const dateSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare function elapsedTimeFromNow(date?: Date, format?: dayjs.UnitTypeLong): number;
+export declare function buildDayjs(date?: ConfigType, format?: string, strict?: boolean): dayjs.Dayjs;
+export declare function buildDayjsTz(date: ConfigType, tz: string): dayjs.Dayjs;
+export declare function buildDayjsFromCompactDate(date?: ConfigType, format?: string, strict?: boolean): dayjs.Dayjs;
+export declare function sortDate(date1: ConfigType, date2: ConfigType, sortingOrder?: "asc" | "desc"): number;
+/**
+ * Convert to YYYYMMDD or YYYY-MM-DD format
+ * @param date - The date to convert
+ * @param separator - The separator to use between the date components
+ * @returns The date in YYYYMMDD or YYYY-MM-DD format (if separator is "-")
+ */
+export declare function convertDateToString(date: Date, { separator, useUtc }?: {
+    separator?: string;
+    useUtc?: boolean;
+}): string;
+/**
+ * Convert to HHMMSS or HHMMSSCC format. Dayjs does not support CC
+ * @param date - The date to convert
+ * @param includeCentisecond - Whether to include the centisecond in the time string
+ * @returns The date in HHMMSS or HHMMSSCC format (if includeCentisecond is true)
+ */
+export declare function convertDateToTimeString(date: Date, { useUtc, includeCentisecond, }?: {
+    useUtc?: boolean;
+    includeCentisecond?: boolean;
+}): string;
+/**
+ * Validates if timestamp adheres to YYYYMMDDHHMMSS format
+ * and is a valid date.
+ *
+ * @param input The HL7 timestamp to validate
+ * @throws {BadRequestError} If the HL7 timestamp is invalid
+ * @returns True if the HL7 timestamp is valid
+ */
+export declare function throwIfInvalidBasicIso8601(input: string): boolean;
+/**
+ * Converts an HL7 timestamp to an ISO 8601 formatted date string.
+ *
+ * @param hl7DateString The HL7 timestamp to convert
+ * @returns ISO 8601 formatted date string
+ */
+export declare function basicToExtendedIso8601(basicIso8601: string): string;
+export declare function buildTtlForXDays(days: number): number;
+//# sourceMappingURL=date.d.ts.map

package/dist/src/common/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/common/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,EAAqB,CAAC,EAAE,MAAM,KAAK,CAAC;AAM3C,eAAO,MAAM,QAAQ,eAAe,CAAC;AACrC,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAMD,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,uBAAuB,CAAC,EAAE,aAAa,CAAC;IACxC,uBAAuB,CAAC,EAAE,aAAa,CAAC;CACzC,GACA,OAAO,CAaT;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK1D;AACD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQlE;AAID,eAAO,MAAM,kBAAkB,+GAIiB,CAAC;AAEjD,eAAO,MAAM,UAAU,2CAA0D,CAAC;AAElF,wBAAgB,kBAAkB,CAChC,IAAI,CAAC,EAAE,IAAI,EACX,MAAM,GAAE,KAAK,CAAC,YAA4B,GACzC,MAAM,CAER;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,KAAK,CAE5F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAEtE;AAkBD,wBAAgB,yBAAyB,CACvC,IAAI,CAAC,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,GACf,KAAK,CAAC,KAAK,CAMb;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,EACjB,YAAY,GAAE,KAAK,GAAG,MAAc,GACnC,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,EAAE,SAAc,EAAE,MAAa,EAAE,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,UAGjF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,EACE,MAAa,EACb,kBAA0B,GAC3B,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,UAO3D;AACD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA0CjE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAWnE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/src/common/date.js

@@ -0,0 +1,218 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateSchema = exports.optionalDateSchema = exports.ISO_DATE_TIME = exports.ISO_DATE = void 0;
+exports.isValidISODate = isValidISODate;
+exports.isValidISODateTime = isValidISODateTime;
+exports.validateDateOfBirth = validateDateOfBirth;
+exports.validateIsPastOrPresent = validateIsPastOrPresent;
+exports.validateIsPastOrPresentSafe = validateIsPastOrPresentSafe;
+exports.validateDateIsAfter1900 = validateDateIsAfter1900;
+exports.validateDateRange = validateDateRange;
+exports.elapsedTimeFromNow = elapsedTimeFromNow;
+exports.buildDayjs = buildDayjs;
+exports.buildDayjsTz = buildDayjsTz;
+exports.buildDayjsFromCompactDate = buildDayjsFromCompactDate;
+exports.sortDate = sortDate;
+exports.convertDateToString = convertDateToString;
+exports.convertDateToTimeString = convertDateToTimeString;
+exports.throwIfInvalidBasicIso8601 = throwIfInvalidBasicIso8601;
+exports.basicToExtendedIso8601 = basicToExtendedIso8601;
+exports.buildTtlForXDays = buildTtlForXDays;
+const dayjs_1 = __importDefault(require("dayjs"));
+const timezone_1 = __importDefault(require("dayjs/plugin/timezone"));
+const utc_1 = __importDefault(require("dayjs/plugin/utc"));
+const zod_1 = require("zod");
+const bad_request_1 = require("../error/bad-request");
+dayjs_1.default.extend(utc_1.default);
+dayjs_1.default.extend(timezone_1.default);
+exports.ISO_DATE = "YYYY-MM-DD";
+exports.ISO_DATE_TIME = "YYYY-MM-DDTHH:mm:ss.SSSZ";
+/** @see https://day.js.org/docs/en/parse/is-valid  */
+function isValidISODate(date) {
+    return buildDayjs(date, exports.ISO_DATE, true).isValid();
+}
+function isValidISODateTime(date) {
+    return buildDayjs(date, exports.ISO_DATE_TIME, true).isValid();
+}
+function isValidISODateOptional(date) {
+    return date ? isValidISODate(date) : true;
+}
+/**
+ * Validates if a date is a valid date of birth.
+ *
+ * @param date The date to validate
+ * @param options just for testing purposes, so we can pass mock functions
+ * @returns true if the date is valid, false otherwise
+ */
+function validateDateOfBirth(date, options) {
+    if (!date || typeof date !== "string")
+        return false;
+    if (date.length < 10)
+        return false;
+    const parsedDate = buildDayjs(date);
+    if (!parsedDate.isValid())
+        return false;
+    const { validateDateIsAfter1900: _validateDateIsAfter1900 = validateDateIsAfter1900, validateIsPastOrPresent: _validateIsPastOrPresent = validateIsPastOrPresent, } = options || {};
+    return (_validateDateIsAfter1900(parsedDate.toISOString()) &&
+        _validateIsPastOrPresent(parsedDate.toISOString()));
+}
+function validateIsPastOrPresent(date) {
+    if (!validateIsPastOrPresentSafe(date)) {
+        throw new bad_request_1.BadRequestError(`Date can't be in the future`, undefined, { date });
+    }
+    return true;
+}
+function validateIsPastOrPresentSafe(date) {
+    if (buildDayjs(date).isAfter(buildDayjs()))
+        return false;
+    return true;
+}
+function validateDateIsAfter1900(date) {
+    if (!isValidISODate(date))
+        return false;
+    const yearStr = date.substring(0, 4);
+    const year = Number(yearStr);
+    return year >= 1900;
+}
+function validateDateRange(start, end) {
+    if (buildDayjs(start).isAfter(end)) {
+        throw new bad_request_1.BadRequestError(`Invalid date range: 'start' must be before 'end'`, undefined, {
+            start,
+            end,
+        });
+    }
+    return true;
+}
+const invalidIsoMsg = { message: "Invalid ISO date" };
+exports.optionalDateSchema = zod_1.z
+    .string()
+    .trim()
+    .nullish()
+    .refine(isValidISODateOptional, invalidIsoMsg);
+exports.dateSchema = zod_1.z.string().trim().refine(isValidISODate, invalidIsoMsg);
+function elapsedTimeFromNow(date, format = "millisecond") {
+    return buildDayjs().diff(buildDayjs(date), format);
+}
+function buildDayjs(date, format, strict) {
+    return dayjs_1.default.utc(date, format, strict);
+}
+function buildDayjsTz(date, tz) {
+    return dayjs_1.default.tz(date, tz).utc();
+}
+/**
+ * Tries to parse a compact date string in the format YYYYMMDDhhmmss±hhmm
+ * (year, month, day, hour, minute, second, timezone)
+ * and converts it to ISO 8601 format.
+ *
+ * @param input The compact date string to parse
+ * @returns ISO 8601 formatted date string or undefined if input doesn't match expected format
+ */
+function tryParseCompactDate(input) {
+    const match = input.match(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})([+-])(\d{2})(\d{2})$/);
+    if (!match)
+        return undefined;
+    const [, year, month, day, hour, minute, second, sign, tzHour, tzMinute] = match;
+    return `${year}-${month}-${day}T${hour}:${minute}:${second}${sign}${tzHour}:${tzMinute}`;
+}
+function buildDayjsFromCompactDate(date, format, strict) {
+    if (typeof date === "string") {
+        const parsed = tryParseCompactDate(date);
+        if (parsed)
+            return buildDayjs(parsed, format, strict);
+    }
+    return buildDayjs(date, format, strict);
+}
+function sortDate(date1, date2, sortingOrder = "asc") {
+    return sortingOrder === "desc"
+        ? buildDayjs(date1).diff(buildDayjs(date2))
+        : buildDayjs(date2).diff(buildDayjs(date1));
+}
+/**
+ * Convert to YYYYMMDD or YYYY-MM-DD format
+ * @param date - The date to convert
+ * @param separator - The separator to use between the date components
+ * @returns The date in YYYYMMDD or YYYY-MM-DD format (if separator is "-")
+ */
+function convertDateToString(date, { separator = "", useUtc = true } = {}) {
+    return (useUtc ? (0, dayjs_1.default)(date).utc() : (0, dayjs_1.default)(date)).format(["YYYY", "MM", "DD"].join(separator));
+}
+/**
+ * Convert to HHMMSS or HHMMSSCC format. Dayjs does not support CC
+ * @param date - The date to convert
+ * @param includeCentisecond - Whether to include the centisecond in the time string
+ * @returns The date in HHMMSS or HHMMSSCC format (if includeCentisecond is true)
+ */
+function convertDateToTimeString(date, { useUtc = true, includeCentisecond = false, } = {}) {
+    const dayjsDate = useUtc ? (0, dayjs_1.default)(date).utc() : (0, dayjs_1.default)(date);
+    if (includeCentisecond) {
+        return dayjsDate.format("HHmmssSSS").substring(0, 8);
+    }
+    return dayjsDate.format("HHmmss");
+}
+/**
+ * Validates if timestamp adheres to YYYYMMDDHHMMSS format
+ * and is a valid date.
+ *
+ * @param input The HL7 timestamp to validate
+ * @throws {BadRequestError} If the HL7 timestamp is invalid
+ * @returns True if the HL7 timestamp is valid
+ */
+function throwIfInvalidBasicIso8601(input) {
+    if (!input || input.length !== 14) {
+        throw new bad_request_1.BadRequestError("Invalid HL7 date string format: expected YYYYMMDDHHMMSS");
+    }
+    if (!/^\d{14}$/.test(input)) {
+        throw new bad_request_1.BadRequestError("Invalid HL7 date string: must contain only digits");
+    }
+    // Parse YYYYMMDDHHMMSS format
+    const year = input.substring(0, 4);
+    const month = input.substring(4, 6);
+    const day = input.substring(6, 8);
+    const hour = input.substring(8, 10);
+    const minute = input.substring(10, 12);
+    const second = input.substring(12, 14);
+    // Validate date components
+    const monthNum = parseInt(month);
+    const dayNum = parseInt(day);
+    const hourNum = parseInt(hour);
+    const minuteNum = parseInt(minute);
+    const secondNum = parseInt(second);
+    if (monthNum < 1 || monthNum > 12) {
+        throw new bad_request_1.BadRequestError("Invalid month in HL7 date string");
+    }
+    if (dayNum < 1 || dayNum > 31) {
+        throw new bad_request_1.BadRequestError("Invalid day in HL7 date string");
+    }
+    if (hourNum > 23 || minuteNum > 59 || secondNum > 59) {
+        throw new bad_request_1.BadRequestError("Invalid time in HL7 date string");
+    }
+    const dateStr = `${year}-${month}-${day}T${hour}:${minute}:${second}Z`;
+    const parsedDate = buildDayjs(dateStr);
+    if (!parsedDate.isValid()) {
+        throw new bad_request_1.BadRequestError("Invalid HL7 timestamp");
+    }
+    return true;
+}
+/**
+ * Converts an HL7 timestamp to an ISO 8601 formatted date string.
+ *
+ * @param hl7DateString The HL7 timestamp to convert
+ * @returns ISO 8601 formatted date string
+ */
+function basicToExtendedIso8601(basicIso8601) {
+    throwIfInvalidBasicIso8601(basicIso8601);
+    const year = basicIso8601.substring(0, 4);
+    const month = basicIso8601.substring(4, 6);
+    const day = basicIso8601.substring(6, 8);
+    const hour = basicIso8601.substring(8, 10);
+    const minute = basicIso8601.substring(10, 12);
+    const second = basicIso8601.substring(12, 14);
+    return `${year}-${month}-${day}T${hour}:${minute}:${second}`;
+}
+function buildTtlForXDays(days) {
+    return Math.floor(Date.now() / 1000) + days * 24 * 60 * 60;
+}
+//# sourceMappingURL=date.js.map

package/dist/src/common/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/common/date.ts"],"names":[],"mappings":";;;;;;AAaA,wCAEC;AAED,gDAEC;AAeD,kDAmBC;AAED,0DAKC;AACD,kEAGC;AAED,0DAKC;AAED,8CAQC;AAYD,gDAKC;AAED,gCAEC;AAED,oCAEC;AAkBD,8DAUC;AAED,4BAQC;AAQD,kDAKC;AAQD,0DAYC;AASD,gEA0CC;AAQD,wDAWC;AAED,4CAEC;AA3PD,kDAA0C;AAC1C,qEAA6C;AAC7C,2DAAmC;AACnC,6BAA2C;AAC3C,sDAAuD;AAEvD,eAAK,CAAC,MAAM,CAAC,aAAG,CAAC,CAAC;AAClB,eAAK,CAAC,MAAM,CAAC,kBAAQ,CAAC,CAAC;AAEV,QAAA,QAAQ,GAAG,YAAY,CAAC;AACxB,QAAA,aAAa,GAAG,0BAA0B,CAAC;AAExD,sDAAsD;AACtD,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,UAAU,CAAC,IAAI,EAAE,gBAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,OAAO,UAAU,CAAC,IAAI,EAAE,qBAAa,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,sBAAsB,CAAC,IAA+B;IAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAID;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,IAAY,EACZ,OAGC;IAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,EACJ,uBAAuB,EAAE,wBAAwB,GAAG,uBAAuB,EAC3E,uBAAuB,EAAE,wBAAwB,GAAG,uBAAuB,GAC5E,GAAG,OAAO,IAAI,EAAE,CAAC;IAClB,OAAO,CACL,wBAAwB,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAClD,wBAAwB,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CACnD,CAAC;AACJ,CAAC;AAED,SAAgB,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,6BAAe,CAAC,6BAA6B,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,SAAgB,2BAA2B,CAAC,IAAY;IACtD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAa,EAAE,GAAW;IAC1D,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,6BAAe,CAAC,kDAAkD,EAAE,SAAS,EAAE;YACvF,KAAK;YACL,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,aAAa,GAAsB,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE5D,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,EAAE;KACR,IAAI,EAAE;KACN,OAAO,EAAE;KACT,MAAM,CAAC,sBAAsB,EAAE,aAAa,CAAC,CAAC;AAEpC,QAAA,UAAU,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;AAElF,SAAgB,kBAAkB,CAChC,IAAW,EACX,SAA6B,aAAa;IAE1C,OAAO,UAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,UAAU,CAAC,IAAiB,EAAE,MAAe,EAAE,MAAgB;IAC7E,OAAO,eAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,YAAY,CAAC,IAAgB,EAAE,EAAU;IACvD,OAAO,eAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAC9F,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;IACjF,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;AAC3F,CAAC;AAED,SAAgB,yBAAyB,CACvC,IAAiB,EACjB,MAAe,EACf,MAAgB;IAEhB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,QAAQ,CACtB,KAAiB,EACjB,KAAiB,EACjB,eAA+B,KAAK;IAEpC,OAAO,YAAY,KAAK,MAAM;QAC5B,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,IAAU,EACV,EAAE,SAAS,GAAG,EAAE,EAAE,MAAM,GAAG,IAAI,KAA+C,EAAE;IAEhF,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,eAAK,EAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAA,eAAK,EAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AACjG,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CACrC,IAAU,EACV,EACE,MAAM,GAAG,IAAI,EACb,kBAAkB,GAAG,KAAK,MAC4B,EAAE;IAE1D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,eAAK,EAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAA,eAAK,EAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AACD;;;;;;;GAOG;AACH,SAAgB,0BAA0B,CAAC,KAAa;IACtD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,6BAAe,CAAC,yDAAyD,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,6BAAe,CAAC,mDAAmD,CAAC,CAAC;IACjF,CAAC;IAED,8BAA8B;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAEvC,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEnC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,6BAAe,CAAC,kCAAkC,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,6BAAe,CAAC,gCAAgC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,GAAG,EAAE,IAAI,SAAS,GAAG,EAAE,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,6BAAe,CAAC,iCAAiC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC;IACvE,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,6BAAe,CAAC,uBAAuB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,YAAoB;IACzD,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAEzC,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAE9C,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC7D,CAAC"}

package/dist/src/common/demographics.d.ts

@@ -0,0 +1,24 @@
+import { GenderAtBirth } from "../domain/gender";
+export interface NameDemographics {
+    firstName: string;
+    middleName: string;
+    lastName: string;
+    prefix: string;
+    suffix: string;
+}
+export declare function makeNameDemographics({ firstName: firstNameInput, lastName: lastNameInput, }: {
+    firstName: string;
+    lastName: string;
+}): NameDemographics;
+export declare function shiftMiddleNameToFirstName(patient: NameDemographics): NameDemographics;
+export declare const PREFIXES: readonly ["mr", "mrs", "ms", "dr", "prof", "rev", "st", "hon", "senator", "sen", "rep", "congressman", "congresswoman", "gov"];
+export declare const SUFFIXES: readonly ["jr", "junior", "sr", "senior", "ii", "iii", "iv", "v", "vi", "vii", "viii", "ix", "x", "2nd", "3rd", "4th", "5th", "6th", "7th", "8th", "9th", "10th"];
+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 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;
+export declare function genderMapperToDomain<G extends string>(mapToDomain: Record<G, GenderAtBirth>): (gender: G) => GenderAtBirth;
+//# sourceMappingURL=demographics.d.ts.map

package/dist/src/common/demographics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demographics.d.ts","sourceRoot":"","sources":["../../../src/common/demographics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,GACxB,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,gBAAgB,CAyBnB;AAGD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAStF;AAED,eAAO,MAAM,QAAQ,gIAeX,CAAC;AACX,eAAO,MAAM,QAAQ,mKAuBX,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,UAAU,uIAAoB,CAAC;AAC5C,eAAO,MAAM,UAAU,kLAAoB,CAAC;AAE5C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,MAAM,CAMzD;AACD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,MAAM,CAMzD;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,EACvC,aAAa,EAAE,CAAC,GACf,CAAC,MAAM,EAAE,aAAa,KAAK,CAAC,CAK9B;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACnD,WAAW,EAAE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,GACpC,CAAC,MAAM,EAAE,CAAC,KAAK,aAAa,CAK9B"}

package/dist/src/common/demographics.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUFFIX_SET = exports.PREFIX_SET = exports.SUFFIXES = exports.PREFIXES = void 0;
+exports.makeNameDemographics = makeNameDemographics;
+exports.shiftMiddleNameToFirstName = shiftMiddleNameToFirstName;
+exports.isPrefix = isPrefix;
+exports.isSuffix = isSuffix;
+exports.genderMapperFromDomain = genderMapperFromDomain;
+exports.genderMapperToDomain = genderMapperToDomain;
+/** Strips any character that is not a letter, apostrophe, hyphen, or space from a name. */
+const invalidNameCharsPattern = /[^a-zA-Z'-\s]/g;
+function makeNameDemographics({ firstName: firstNameInput, lastName: lastNameInput, }) {
+    const firstNameParts = firstNameInput.trim().replace(invalidNameCharsPattern, "").split(" ");
+    const lastNameParts = lastNameInput.trim().replace(invalidNameCharsPattern, "").split(" ");
+    let prefix = "";
+    const firstNamePartLeadingName = firstNameParts[0];
+    if (firstNamePartLeadingName && isPrefix(firstNamePartLeadingName.toLowerCase())) {
+        prefix = firstNamePartLeadingName;
+        firstNameParts.shift();
+    }
+    let suffix = "";
+    const lastNamePartTrailingName = lastNameParts[lastNameParts.length - 1];
+    if (lastNamePartTrailingName && isSuffix(lastNamePartTrailingName.toLowerCase())) {
+        suffix = lastNamePartTrailingName;
+        lastNameParts.pop();
+    }
+    let middleName = "";
+    if (firstNameParts.length > 1) {
+        middleName = firstNameParts.slice(1).join(" ");
+    }
+    const firstName = firstNameParts[0] ?? firstNameInput;
+    const lastName = lastNameParts.join(" ") || lastNameInput;
+    return { firstName, middleName, lastName, prefix, suffix };
+}
+// Shifts the first part of the middle name to the first name for patients that were not found
+function shiftMiddleNameToFirstName(patient) {
+    const shiftedPatient = { ...patient };
+    if (patient.middleName.length > 0) {
+        const middleNamePart = patient.middleName.split(" ");
+        shiftedPatient.firstName = [patient.firstName, middleNamePart.shift()].join(" ");
+        shiftedPatient.middleName = middleNamePart.join(" ");
+    }
+    return shiftedPatient;
+}
+exports.PREFIXES = [
+    "mr",
+    "mrs",
+    "ms",
+    "dr",
+    "prof",
+    "rev",
+    "st",
+    "hon",
+    "senator",
+    "sen",
+    "rep",
+    "congressman",
+    "congresswoman",
+    "gov",
+];
+exports.SUFFIXES = [
+    "jr",
+    "junior",
+    "sr",
+    "senior",
+    "ii",
+    "iii",
+    "iv",
+    "v",
+    "vi",
+    "vii",
+    "viii",
+    "ix",
+    "x",
+    "2nd",
+    "3rd",
+    "4th",
+    "5th",
+    "6th",
+    "7th",
+    "8th",
+    "9th",
+    "10th",
+];
+exports.PREFIX_SET = new Set(exports.PREFIXES);
+exports.SUFFIX_SET = new Set(exports.SUFFIXES);
+function isPrefix(prefix) {
+    const normalizedPrefix = prefix
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]/g, "");
+    return exports.PREFIX_SET.has(normalizedPrefix);
+}
+function isSuffix(suffix) {
+    const normalizedSuffix = suffix
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]/g, "");
+    return exports.SUFFIX_SET.has(normalizedSuffix);
+}
+function genderMapperFromDomain(mapFromDomain, unknownGender) {
+    return function (gender) {
+        if (mapFromDomain[gender])
+            return mapFromDomain[gender];
+        return unknownGender;
+    };
+}
+function genderMapperToDomain(mapToDomain) {
+    return function (gender) {
+        if (mapToDomain[gender])
+            return mapToDomain[gender];
+        return "U";
+    };
+}
+//# sourceMappingURL=demographics.js.map

package/dist/src/common/demographics.js.map

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