@metriport/shared 0.33.1 → 0.33.4-alpha.0

package/dist/src/domain/__tests__/pagination-schema.test.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const faker_1 = require("@faker-js/faker");
+const cursor_utils_1 = require("../cursor-utils");
+const pagination_v2_1 = require("../pagination-v2");
+beforeEach(() => {
+    jest.restoreAllMocks();
+});
+describe("pagination schema", () => {
+    const schema = (0, pagination_v2_1.createQueryMetaSchemaV2)();
+    describe("sort parameter validation", () => {
+        it("accepts valid sort string with multiple fields", () => {
+            const query = {
+                sort: "createdAt=desc,name=asc,id=asc",
+                count: 25,
+            };
+            const result = schema.parse(query);
+            expect(result.sort).toEqual([
+                { col: "createdAt", order: "desc" },
+                { col: "name", order: "asc" },
+                { col: "id", order: "asc" },
+            ]);
+        });
+        it("validates sort parameter formats", () => {
+            // Invalid sort order
+            expect(() => schema.parse({ sort: "name=invalid", count: 10 })).toThrow("Invalid sort order: invalid. Must be 'asc' or 'desc'");
+            // Missing column
+            expect(() => schema.parse({ sort: "=asc", count: 10 })).toThrow("Invalid sort format: =asc. Expected: column=order");
+            // Missing order
+            expect(() => schema.parse({ sort: "name=", count: 10 })).toThrow("Invalid sort format: name=. Expected: column=order");
+            // Wrong separator
+            expect(() => schema.parse({ sort: "name:asc", count: 10 })).toThrow("Invalid sort format: name:asc. Expected: column=order");
+        });
+        it("auto-adds id sort only to final sort, not originalSort", () => {
+            const query = {
+                sort: "name=asc,priority=desc",
+                count: 25,
+            };
+            const result = schema.parse(query);
+            // originalSort should contain exactly what user provided (no auto-added ID)
+            expect(result.originalSort).toEqual([
+                { col: "name", order: "asc" },
+                { col: "priority", order: "desc" },
+            ]);
+            // sort should contain auto-added ID sort
+            expect(result.sort).toEqual([
+                { col: "name", order: "asc" },
+                { col: "priority", order: "desc" },
+                { col: "id", order: "desc" },
+            ]);
+        });
+        it("preserves user-provided id sort in both originalSort and sort", () => {
+            const query = {
+                sort: "name=asc,id=asc",
+                count: 25,
+            };
+            const result = schema.parse(query);
+            // Both should contain the user-provided ID sort
+            expect(result.originalSort).toEqual([
+                { col: "name", order: "asc" },
+                { col: "id", order: "asc" },
+            ]);
+            expect(result.sort).toEqual([
+                { col: "name", order: "asc" },
+                { col: "id", order: "asc" },
+            ]);
+        });
+    });
+    describe("cursor parameter validation and transformation", () => {
+        it("transforms complex cursor with multiple string values", () => {
+            const cursorData = {
+                name: faker_1.faker.person.fullName(),
+                priority: faker_1.faker.number.int().toString(),
+                timestamp: faker_1.faker.date.recent().toISOString(),
+                category: "active",
+                id: faker_1.faker.string.uuid(),
+            };
+            const encodedCursor = (0, cursor_utils_1.encodeCursor)(cursorData);
+            const query = {
+                fromItem: encodedCursor,
+                sort: "name=asc,priority=desc,timestamp=desc,category=asc,id=desc",
+                count: 10,
+            };
+            const result = schema.parse(query);
+            expect(result.fromItem).toEqual(cursorData);
+            expect(result.sort).toEqual([
+                { col: "name", order: "asc" },
+                { col: "priority", order: "desc" },
+                { col: "timestamp", order: "desc" },
+                { col: "category", order: "asc" },
+                { col: "id", order: "desc" },
+            ]);
+        });
+        it("rejects invalid base64 cursor", () => {
+            const query = {
+                fromItem: "invalid-base64!!!",
+                count: 10,
+            };
+            expect(() => schema.parse(query)).toThrow("Invalid cursor: unable to decode cursor");
+        });
+        it("rejects valid base64 but invalid JSON cursor", () => {
+            const invalidJson = Buffer.from("not valid json", "utf8").toString("base64");
+            const query = {
+                fromItem: invalidJson,
+                count: 10,
+            };
+            expect(() => schema.parse(query)).toThrow();
+        });
+    });
+    describe("complete query validation", () => {
+        it("validates complete query with sort and fromItem", () => {
+            const cursorData = {
+                name: "john",
+                createdAt: "2023-12-01T10:00:00Z",
+                id: faker_1.faker.string.uuid(),
+            };
+            const encodedCursor = (0, cursor_utils_1.encodeCursor)(cursorData);
+            const query = {
+                sort: "name=asc,createdAt=desc,id=asc",
+                fromItem: encodedCursor,
+                count: 25,
+            };
+            const result = schema.parse(query);
+            expect(result).toEqual({
+                sort: [
+                    { col: "name", order: "asc" },
+                    { col: "createdAt", order: "desc" },
+                    { col: "id", order: "asc" },
+                ],
+                originalSort: [
+                    { col: "name", order: "asc" },
+                    { col: "createdAt", order: "desc" },
+                    { col: "id", order: "asc" },
+                ],
+                fromItem: cursorData,
+                count: 25,
+            });
+        });
+        it("validates complete query with sort and toItem", () => {
+            const cursorData = { priority: "5", name: "test", id: faker_1.faker.string.uuid() };
+            const encodedCursor = (0, cursor_utils_1.encodeCursor)(cursorData);
+            const query = {
+                sort: "priority=desc,name=asc,id=asc",
+                toItem: encodedCursor,
+                count: 50,
+            };
+            const result = schema.parse(query);
+            expect(result).toEqual({
+                sort: [
+                    { col: "priority", order: "asc" },
+                    { col: "name", order: "desc" },
+                    { col: "id", order: "desc" },
+                ],
+                originalSort: [
+                    { col: "priority", order: "desc" },
+                    { col: "name", order: "asc" },
+                    { col: "id", order: "asc" },
+                ],
+                toItem: cursorData,
+                count: 50,
+            });
+        });
+    });
+});
+//# sourceMappingURL=pagination-schema.test.js.map

package/dist/src/domain/__tests__/pagination-schema.test.js.map

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

package/dist/src/domain/address/__tests__/country.test.d.ts

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

package/dist/src/domain/address/__tests__/country.test.d.ts.map

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

package/dist/src/domain/address/__tests__/country.test.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const country_1 = require("../country");
+describe("country", () => {
+    describe("normalizeCountrySafe", () => {
+        it("should return undefined when it gets empty string", () => {
+            const input = "";
+            expect((0, country_1.normalizeCountrySafe)(input)).toBeUndefined();
+        });
+        it("should return undefined when it gets space", () => {
+            const input = " ";
+            expect((0, country_1.normalizeCountrySafe)(input)).toBeUndefined();
+        });
+        const countries = [
+            country_1.normalizedCountryUsa,
+            "US",
+            "U.S",
+            "U.S.",
+            "U.S.A",
+            "UNITED STATES",
+            "UNITED STATES OF AMERICA",
+        ];
+        for (const country of countries) {
+            it(`valid - ${country}`, () => {
+                const result = (0, country_1.normalizeCountrySafe)(country);
+                expect(result).toBe(country_1.normalizedCountryUsa);
+            });
+        }
+        for (const country of countries.map(c => c.toLowerCase())) {
+            it(`valid - ${country}`, () => {
+                const result = (0, country_1.normalizeCountrySafe)(country);
+                expect(result).toBe(country_1.normalizedCountryUsa);
+            });
+        }
+        it("should trim input prefix", () => {
+            const expectedOutput = country_1.normalizedCountryUsa;
+            const input = " " + expectedOutput;
+            expect((0, country_1.normalizeCountrySafe)(input)).toBe(expectedOutput);
+        });
+        it("should trim input suffix", () => {
+            const expectedOutput = country_1.normalizedCountryUsa;
+            const input = expectedOutput + " ";
+            expect((0, country_1.normalizeCountrySafe)(input)).toBe(expectedOutput);
+        });
+        it("should return undefined when it gets invalid country", () => {
+            const input = "germany";
+            expect((0, country_1.normalizeCountrySafe)(input)).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=country.test.js.map

package/dist/src/domain/address/__tests__/country.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country.test.js","sourceRoot":"","sources":["../../../../../src/domain/address/__tests__/country.test.ts"],"names":[],"mappings":";;AAAA,wCAAwE;AAExE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,IAAA,8BAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,KAAK,GAAG,GAAG,CAAC;YAClB,MAAM,CAAC,IAAA,8BAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG;YAChB,8BAAoB;YACpB,IAAI;YACJ,KAAK;YACL,MAAM;YACN,OAAO;YACP,eAAe;YACf,0BAA0B;SAC3B,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,EAAE,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,EAAE;gBAC5B,MAAM,MAAM,GAAG,IAAA,8BAAoB,EAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAAoB,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC1D,EAAE,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,EAAE;gBAC5B,MAAM,MAAM,GAAG,IAAA,8BAAoB,EAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAAoB,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,cAAc,GAAG,8BAAoB,CAAC;YAC5C,MAAM,KAAK,GAAG,GAAG,GAAG,cAAc,CAAC;YACnC,MAAM,CAAC,IAAA,8BAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,cAAc,GAAG,8BAAoB,CAAC;YAC5C,MAAM,KAAK,GAAG,cAAc,GAAG,GAAG,CAAC;YACnC,MAAM,CAAC,IAAA,8BAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,KAAK,GAAG,SAAS,CAAC;YACxB,MAAM,CAAC,IAAA,8BAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/domain/address/__tests__/state.test.d.ts

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

package/dist/src/domain/address/__tests__/state.test.d.ts.map

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

package/dist/src/domain/address/__tests__/state.test.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const state_1 = require("../state");
+describe("state", () => {
+    describe("normalizeStateSafe", () => {
+        it("should convert long name to USState", () => {
+            const input = "Arizona";
+            const expectedOutput = state_1.USState.AZ;
+            expect((0, state_1.normalizeStateSafe)(input)).toEqual(expectedOutput);
+        });
+        it("should convert long name case insentitive to USState", () => {
+            const input = "aRiZonA";
+            const expectedOutput = state_1.USState.AZ;
+            expect((0, state_1.normalizeStateSafe)(input)).toEqual(expectedOutput);
+        });
+        it("should convert District of Columbia to DC", () => {
+            const input = "District of Columbia";
+            const expectedOutput = state_1.USState.DC;
+            expect((0, state_1.normalizeStateSafe)(input)).toEqual(expectedOutput);
+        });
+        describe(`should convert to USState`, () => {
+            for (const usState of Object.values(state_1.USState)) {
+                it(usState, () => {
+                    const input = usState;
+                    const expectedOutput = usState;
+                    expect((0, state_1.normalizeStateSafe)(input)).toEqual(expectedOutput);
+                });
+            }
+        });
+        it("should return undefined if can't match a US state", () => {
+            const input = "Ariz";
+            expect((0, state_1.normalizeStateSafe)(input)).toBeUndefined();
+        });
+        it("should return undefined if gets an empty string", () => {
+            const input = "";
+            expect((0, state_1.normalizeStateSafe)(input)).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/src/domain/address/__tests__/state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../../../../src/domain/address/__tests__/state.test.ts"],"names":[],"mappings":";;AAAA,oCAAuD;AAEvD,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,KAAK,GAAG,SAAS,CAAC;YACxB,MAAM,cAAc,GAAG,eAAO,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,KAAK,GAAG,SAAS,CAAC;YACxB,MAAM,cAAc,GAAG,eAAO,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAG,sBAAsB,CAAC;YACrC,MAAM,cAAc,GAAG,eAAO,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACzC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,eAAO,CAAC,EAAE,CAAC;gBAC7C,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;oBACf,MAAM,KAAK,GAAG,OAAO,CAAC;oBACtB,MAAM,cAAc,GAAG,OAAO,CAAC;oBAC/B,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;gBAC5D,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/domain/address/__tests__/territory.test.d.ts

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

package/dist/src/domain/address/__tests__/territory.test.d.ts.map

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

package/dist/src/domain/address/__tests__/territory.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const territory_1 = require("../territory");
+describe("territory", () => {
+    describe("normalizeTerritorySafe", () => {
+        it("should convert long name to USTerritory", () => {
+            const input = "Guam";
+            const expectedOutput = territory_1.USTerritory.GU;
+            expect((0, territory_1.normalizeTerritorySafe)(input)).toEqual(expectedOutput);
+        });
+        it("should convert long name case insentitive to USTerritory", () => {
+            const input = "GuAm";
+            const expectedOutput = territory_1.USTerritory.GU;
+            expect((0, territory_1.normalizeTerritorySafe)(input)).toEqual(expectedOutput);
+        });
+        describe(`should convert to USTerritory`, () => {
+            for (const usTerritory of Object.values(territory_1.USTerritory)) {
+                it(usTerritory, () => {
+                    const input = usTerritory;
+                    const expectedOutput = usTerritory;
+                    expect((0, territory_1.normalizeTerritorySafe)(input)).toEqual(expectedOutput);
+                });
+            }
+        });
+        it("should return undefined if can't match a US territory", () => {
+            const input = "Gua";
+            expect((0, territory_1.normalizeTerritorySafe)(input)).toBeUndefined();
+        });
+        it("should return undefined if gets an empty string", () => {
+            const input = "";
+            expect((0, territory_1.normalizeTerritorySafe)(input)).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=territory.test.js.map

package/dist/src/domain/address/__tests__/territory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"territory.test.js","sourceRoot":"","sources":["../../../../../src/domain/address/__tests__/territory.test.ts"],"names":[],"mappings":";;AAAA,4CAAmE;AAEnE,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,cAAc,GAAG,uBAAW,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,cAAc,GAAG,uBAAW,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;YAC7C,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,uBAAW,CAAC,EAAE,CAAC;gBACrD,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;oBACnB,MAAM,KAAK,GAAG,WAAW,CAAC;oBAC1B,MAAM,cAAc,GAAG,WAAW,CAAC;oBACnC,MAAM,CAAC,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;gBAChE,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,KAAK,GAAG,KAAK,CAAC;YACpB,MAAM,CAAC,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/domain/address/__tests__/zip.test.d.ts

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

package/dist/src/domain/address/__tests__/zip.test.d.ts.map

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

package/dist/src/domain/address/__tests__/zip.test.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const faker_1 = require("@faker-js/faker");
+const zip_1 = require("../zip");
+const knownInvalidZipCodes = [
+    "00000",
+    "99999",
+    "10000",
+    "20000",
+    "30000",
+    "40000",
+    "50000",
+    "60000",
+    "70000",
+    "80000",
+    "90000",
+    "12345",
+    "54321",
+];
+describe("zip", () => {
+    describe("normalizeZipCodeNew", () => {
+        it("returns the result of the normalizeFn param", () => {
+            const expectedOutput = getFiveDigitZip();
+            const normalizeFn = jest.fn(() => expectedOutput);
+            expect((0, zip_1.normalizeZipCodeNew)("54321", normalizeFn)).toBe(expectedOutput);
+        });
+        it("should throw an error if zip is an empty string", () => {
+            const normalizeFn = jest.fn(() => undefined);
+            expect(() => (0, zip_1.normalizeZipCodeNew)("54321", normalizeFn)).toThrow();
+        });
+    });
+    describe("safe normalizeZipCodeNewSafe", () => {
+        it("should return undefined when it gets empty string", () => {
+            const input = "";
+            const expectedOutput = undefined;
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should return undefined when it gets space", () => {
+            const input = " ";
+            const expectedOutput = undefined;
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should handle 5 digits", () => {
+            const input = getFiveDigitZip();
+            const expectedOutput = input;
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should trim input prefix", () => {
+            const expectedOutput = getFiveDigitZip();
+            const input = " " + expectedOutput;
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should trim input suffix", () => {
+            const expectedOutput = getFiveDigitZip();
+            const input = expectedOutput + " ";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should return undefined for zip codes that are too short", () => {
+            const input = "12";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBeUndefined();
+        });
+        it("should handle short zip codes", () => {
+            const input = "123";
+            const expectedOutput = "00123";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should return padded first 4 characters when contains dash at position 4", () => {
+            const input = "1234-6677";
+            const expectedOutput = "01234";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should return first 5 characters when zip code length is 10", () => {
+            const input = "12345-6677";
+            const expectedOutput = "12345";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+        });
+        it("should return undefined if zip contains non-digit and non-dash characters (length 9)", () => {
+            const input = "12345-667a";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBeUndefined();
+        });
+        it("should return undefined if zip contains non-digit and non-dash characters (length 5)", () => {
+            const input = "1234a";
+            expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBeUndefined();
+        });
+        describe("examples from the wild", () => {
+            const tests = [{ input: "2468", expectedOutput: "02468" }];
+            for (const { input, expectedOutput } of tests) {
+                it(`should return ${expectedOutput} when input is ${input}`, () => {
+                    expect((0, zip_1.normalizeZipCodeNewSafe)(input)).toBe(expectedOutput);
+                });
+            }
+        });
+    });
+    describe("isValidZipCode", () => {
+        it("should return true for valid zip codes", () => {
+            const validZipCodes = [
+                "90210", // Beverly Hills
+                "10001", // New York
+                "60601", // Chicago
+                "33101", // Miami
+                "98101", // Seattle
+                ...Array.from({ length: 5 }, () => getValidZipCode()),
+            ];
+            validZipCodes.forEach(zipCode => {
+                expect((0, zip_1.isValidZipCode)(zipCode)).toBe(true);
+            });
+        });
+        it("should return false for known invalid zip codes", () => {
+            knownInvalidZipCodes.forEach((zipCode) => {
+                expect((0, zip_1.isValidZipCode)(zipCode)).toBe(false);
+            });
+        });
+        it("should return false for invalid formats", () => {
+            const invalidFormats = ["", "12345-667a", "1234a", "abcde"];
+            invalidFormats.forEach(zipCode => {
+                expect((0, zip_1.isValidZipCode)(zipCode)).toBe(false);
+            });
+        });
+        it("should return true for valid zip+4 format", () => {
+            const validZipPlus4 = ["12345-6789", "90210-1234", "10001-0001"];
+            validZipPlus4.forEach(zipCode => {
+                expect((0, zip_1.isValidZipCode)(zipCode)).toBe(true);
+            });
+        });
+        it("should return true for zip codes of any length (current behavior)", () => {
+            // Note: isValidZipCode doesn't validate length - this documents current behavior
+            const anyLengthZipCodes = ["1", "12", "123", "1234", "123456", "1234567"];
+            anyLengthZipCodes.forEach(zipCode => {
+                expect((0, zip_1.isValidZipCode)(zipCode)).toBe(true);
+            });
+        });
+        it("should return true for various dash formats (current behavior)", () => {
+            // Note: isValidZipCode accepts any format with digits and dashes - this documents current behavior
+            const dashFormatZipCodes = [
+                "123-45",
+                "12-345",
+                "1-2345",
+                "12345-6",
+                "12345-67",
+                "12345-678",
+                "12345-",
+                "-12345",
+                "12345-12345",
+                "12345-123",
+            ];
+            dashFormatZipCodes.forEach(zipCode => {
+                expect((0, zip_1.isValidZipCode)(zipCode)).toBe(true);
+            });
+        });
+    });
+});
+function getFiveDigitZip() {
+    return faker_1.faker.number.int({ min: 10000, max: 99999 }).toString();
+}
+function getValidZipCode() {
+    let zipCode;
+    do {
+        zipCode = faker_1.faker.number.int({ min: 10000, max: 99999 }).toString();
+    } while (knownInvalidZipCodes.includes(zipCode));
+    return zipCode;
+}
+//# sourceMappingURL=zip.test.js.map

package/dist/src/domain/address/__tests__/zip.test.js.map

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

package/dist/src/domain/address/city.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeCity(city: string): string;
+//# sourceMappingURL=city.d.ts.map

package/dist/src/domain/address/city.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"city.d.ts","sourceRoot":"","sources":["../../../../src/domain/address/city.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/src/domain/address/city.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeCity = normalizeCity;
+const title_case_1 = require("../../common/title-case");
+function normalizeCity(city) {
+    return (0, title_case_1.toTitleCase)(city).trim();
+}
+//# sourceMappingURL=city.js.map

package/dist/src/domain/address/city.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"city.js","sourceRoot":"","sources":["../../../../src/domain/address/city.ts"],"names":[],"mappings":";;AAEA,sCAEC;AAJD,wDAAsD;AAEtD,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAA,wBAAW,EAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/src/domain/address/country.d.ts

@@ -0,0 +1,4 @@
+export declare const normalizedCountryUsa = "USA";
+export declare function normalizeCountrySafe(country: string, normalizeBase?: (country: string) => string): string | undefined;
+export declare function normalizeCountry(country: string): string;
+//# sourceMappingURL=country.d.ts.map

package/dist/src/domain/address/country.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"country.d.ts","sourceRoot":"","sources":["../../../../src/domain/address/country.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAW1C,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAA6B,GAChE,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/src/domain/address/country.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizedCountryUsa = void 0;
+exports.normalizeCountrySafe = normalizeCountrySafe;
+exports.normalizeCountry = normalizeCountry;
+const string_1 = require("../../common/string");
+const bad_request_1 = require("../../error/bad-request");
+const validCountryStrings = ["US", "USA", "UNITED STATES", "UNITED STATES OF AMERICA"];
+exports.normalizedCountryUsa = "USA";
+function isValidCountry(country) {
+    if (!validCountryStrings.includes(country))
+        return false;
+    return true;
+}
+function normalizeCountryBase(country) {
+    return (0, string_1.stripPeriods)(country.trim().toUpperCase());
+}
+function normalizeCountrySafe(country, normalizeBase = normalizeCountryBase) {
+    const baseCountry = normalizeBase(country);
+    if (!isValidCountry(baseCountry))
+        return undefined;
+    return exports.normalizedCountryUsa;
+}
+function normalizeCountry(country) {
+    const countryOrUndefined = normalizeCountrySafe(country);
+    if (!countryOrUndefined) {
+        throw new bad_request_1.BadRequestError("Invalid country", undefined, { country });
+    }
+    return countryOrUndefined;
+}
+//# sourceMappingURL=country.js.map

package/dist/src/domain/address/country.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country.js","sourceRoot":"","sources":["../../../../src/domain/address/country.ts"],"names":[],"mappings":";;;AAgBA,oDAOC;AAED,4CAMC;AA/BD,gDAAmD;AACnD,yDAA0D;AAE1D,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,0BAA0B,CAAC,CAAC;AAE1E,QAAA,oBAAoB,GAAG,KAAK,CAAC;AAE1C,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,OAAO,IAAA,qBAAY,EAAC,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,oBAAoB,CAClC,OAAe,EACf,gBAA6C,oBAAoB;IAEjE,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,4BAAoB,CAAC;AAC9B,CAAC;AAED,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAI,6BAAe,CAAC,iBAAiB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/src/domain/address/index.d.ts

@@ -0,0 +1,6 @@
+import { USState } from "./state";
+import { USTerritory } from "./territory";
+export type USStateForAddress = USState | USTerritory;
+export declare function normalizeUSStateForAddressSafe(value: string): USStateForAddress | undefined;
+export declare function normalizeUSStateForAddress(value: string): USStateForAddress;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/domain/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/address/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,OAAO,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAA0B,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,WAAW,CAAC;AAEtD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAQ3E"}

package/dist/src/domain/address/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeUSStateForAddressSafe = normalizeUSStateForAddressSafe;
+exports.normalizeUSStateForAddress = normalizeUSStateForAddress;
+const bad_request_1 = require("../../error/bad-request");
+const state_1 = require("./state");
+const territory_1 = require("./territory");
+function normalizeUSStateForAddressSafe(value) {
+    return (0, state_1.normalizeStateSafe)(value) ?? (0, territory_1.normalizeTerritorySafe)(value);
+}
+function normalizeUSStateForAddress(value) {
+    const state = (0, state_1.normalizeStateSafe)(value) ?? (0, territory_1.normalizeTerritorySafe)(value);
+    if (!state) {
+        throw new bad_request_1.BadRequestError("Invalid US state or territory", undefined, {
+            stateOrTerritory: value,
+        });
+    }
+    return state;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/domain/address/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/address/index.ts"],"names":[],"mappings":";;AAMA,wEAEC;AAED,gEAQC;AAlBD,yDAA0D;AAC1D,mCAAsD;AACtD,2CAAkE;AAIlE,SAAgB,8BAA8B,CAAC,KAAa;IAC1D,OAAO,IAAA,0BAAkB,EAAC,KAAK,CAAC,IAAI,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,0BAA0B,CAAC,KAAa;IACtD,MAAM,KAAK,GAAG,IAAA,0BAAkB,EAAC,KAAK,CAAC,IAAI,IAAA,kCAAsB,EAAC,KAAK,CAAC,CAAC;IACzE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,6BAAe,CAAC,+BAA+B,EAAE,SAAS,EAAE;YACpE,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}