@metriport/shared 0.26.2 → 0.26.3

package/dist/common/__tests__/normalize-oid.test.js

@@ -10,6 +10,7 @@ const invalidOid = "notAnOid";
 const consecutiveDotsInvalidOid = "1.22.333..444";
 const validOidWithTrailingString = "1.22.333.444SomeJunk";
 const oidWithLeadingAndTrailingJunk = "SomeJunk1.22.333.444SomeJunk";
+const oidAsPartOfUrl = "https://org-address.org/v1/org/1.22.333.444";
 const oidWithLeadingZeros = "1.02.003.0004";
 const emptyString = "";
 const onlyDots = "...";
@@ -51,4 +52,17 @@ describe("normalizeOid", () => {
         expect((0, normalize_oid_1.normalizeOid)(rootBoundaryTwo)).toBe(rootBoundaryTwo);
     });
 });
+describe("parseOid", () => {
+    it("should return the same oid if it is already valid", () => {
+        expect((0, normalize_oid_1.parseOid)(validOid)).toBe(validOid);
+        expect((0, normalize_oid_1.parseOid)(shorterValidOid)).toBe(shorterValidOid);
+        expect((0, normalize_oid_1.parseOid)(longerValidOid)).toBe(longerValidOid);
+    });
+    it("should return the oid from a url", () => {
+        expect((0, normalize_oid_1.parseOid)(oidAsPartOfUrl)).toBe(validOid);
+    });
+    it("should return the oid without leading and trailing junk", () => {
+        expect((0, normalize_oid_1.parseOid)(oidWithLeadingAndTrailingJunk)).toBe(validOid);
+    });
+});
 //# sourceMappingURL=normalize-oid.test.js.map

package/dist/common/__tests__/normalize-oid.test.js.map

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

package/dist/common/normalize-oid.d.ts

@@ -1,2 +1,9 @@
 export declare function normalizeOid(input: string): string;
+/**
+ * Parses an OID from a string, handling various formats and extracting the valid OID portion
+ * @param input - String that may contain an OID
+ * @returns The parsed and normalized OID string
+ * @throws Error if no valid OID can be found in the input
+ */
+export declare function parseOid(input: string): string;
 //# sourceMappingURL=normalize-oid.d.ts.map

package/dist/common/normalize-oid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-oid.d.ts","sourceRoot":"","sources":["../../src/common/normalize-oid.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYlD"}
+{"version":3,"file":"normalize-oid.d.ts","sourceRoot":"","sources":["../../src/common/normalize-oid.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwC9C"}

package/dist/common/normalize-oid.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeOid = void 0;
+exports.parseOid = exports.normalizeOid = void 0;
 const OID_REGEX = /(?:[^.\d]*)((([0-9]*)(?:\.*))*)*(?:[^.\d]*)/;
 function normalizeOid(input) {
     const match = input.match(OID_REGEX);
@@ -15,6 +15,65 @@ function normalizeOid(input) {
     throw new Error("OID is not valid");
 }
 exports.normalizeOid = normalizeOid;
+/**
+ * Parses an OID from a string, handling various formats and extracting the valid OID portion
+ * @param input - String that may contain an OID
+ * @returns The parsed and normalized OID string
+ * @throws Error if no valid OID can be found in the input
+ */
+function parseOid(input) {
+    if (!input || typeof input !== "string") {
+        throw new Error("Input must be a non-empty string");
+    }
+    // Enhanced regex to find OID patterns in various contexts
+    // Matches: 1.2.3.4, urn:oid:1.2.3.4, /path/1.2.3.4, ?oid=1.2.3.4, etc.
+    const oidPatterns = [
+        /urn:oid:([0-9]+(?:\.[0-9]+)*)/i,
+        /[?&]oid=([0-9]+(?:\.[0-9]+)*)/i,
+        /[?&]id=([0-9]+(?:\.[0-9]+)*)/i,
+        /[\s]([0-9]+(?:\.[0-9]+)*)[\s]/,
+        /^([0-9]+(?:\.[0-9]+)*)$/,
+        /([0-9]+(?:\.[0-9]+)*)/g,
+    ];
+    // Try each pattern to find a valid OID
+    for (const pattern of oidPatterns) {
+        const matches = input.match(pattern);
+        if (matches) {
+            // For patterns with capture groups, use the first capture group
+            const oidCandidate = matches[1] || matches[0];
+            if (isValidOid(oidCandidate)) {
+                return oidCandidate;
+            }
+        }
+    }
+    // If no pattern matched, try to extract any sequence of numbers and dots
+    const allMatches = input.match(/([0-9]+(?:\.[0-9]+)*)/g);
+    if (allMatches) {
+        for (const match of allMatches) {
+            if (isValidOid(match)) {
+                return match;
+            }
+        }
+    }
+    throw new Error("No valid OID found in input string");
+}
+exports.parseOid = parseOid;
+/**
+ * Validates if a string is a valid OID
+ * @param oid - The OID string to validate
+ * @returns True if the OID is valid, false otherwise
+ */
+function isValidOid(oid) {
+    if (!oid || typeof oid !== "string") {
+        return false;
+    }
+    // Check for consecutive dots
+    if (oid.includes("..")) {
+        return false;
+    }
+    // Check if it starts with valid root code (0, 1, or 2)
+    return startsWithRootCode(oid);
+}
 function startsWithRootCode(oid) {
     if (oid.includes(".")) {
         const root = oid.split(".")[0];

package/dist/common/normalize-oid.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-oid.js","sourceRoot":"","sources":["../../src/common/normalize-oid.ts"],"names":[],"mappings":";;;AAAA,MAAM,SAAS,GAAG,6CAA6C,CAAC;AAEhE,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrC,sEAAsE;IACtE,2GAA2G;IAC3G,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE;QACrB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE;YACpE,OAAO,YAAY,CAAC;SACrB;KACF;IAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAZD,oCAYC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,IAAI,EAAE;YACR,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;SAC7C;KACF;SAAM;QACL,OAAO,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;KAC1C;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"normalize-oid.js","sourceRoot":"","sources":["../../src/common/normalize-oid.ts"],"names":[],"mappings":";;;AAAA,MAAM,SAAS,GAAG,6CAA6C,CAAC;AAEhE,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrC,sEAAsE;IACtE,2GAA2G;IAC3G,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE;QACrB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE;YACpE,OAAO,YAAY,CAAC;SACrB;KACF;IAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAZD,oCAYC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,KAAa;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;KACrD;IAED,0DAA0D;IAC1D,uEAAuE;IACvE,MAAM,WAAW,GAAG;QAClB,gCAAgC;QAChC,gCAAgC;QAChC,+BAA+B;QAC/B,+BAA+B;QAC/B,yBAAyB;QACzB,wBAAwB;KACzB,CAAC;IAEF,uCAAuC;IACvC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,OAAO,EAAE;YACX,gEAAgE;YAChE,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YAE9C,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE;gBAC5B,OAAO,YAAY,CAAC;aACrB;SACF;KACF;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACzD,IAAI,UAAU,EAAE;QACd,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE;YAC9B,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE;gBACrB,OAAO,KAAK,CAAC;aACd;SACF;KACF;IAED,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAxCD,4BAwCC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QACnC,OAAO,KAAK,CAAC;KACd;IAED,6BAA6B;IAC7B,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACtB,OAAO,KAAK,CAAC;KACd;IAED,uDAAuD;IACvD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,IAAI,EAAE;YACR,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;SAC7C;KACF;SAAM;QACL,OAAO,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;KAC1C;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/common/numbers.d.ts

@@ -3,6 +3,19 @@ export declare function getFloatValue(value: string | number): number;
  * Truncate the number to 2 decimal places
  */
 export declare function formatNumber(num: number): number;
+/**
+ * Format a number to a human readable string, with optional decimal places and thousand separator.
+ */
+export declare function abbreviateNumber(num: number): string;
+/**
+ * Format a number to a string, with optional decimal places and thousand separator.
+ *
+ * @param num the number to format
+ * @param digits number of decimal places, only used if `thousandSeparator` is true
+ * @param thousandSeparator if true (default), use Intl.NumberFormat to format the number; otherwise,
+ *                          return the number without formatting.
+ */
+export declare function numberToString(num: number, digits?: number, thousandSeparator?: boolean): string;
 export declare function randomInt(maxDigits?: number): number;
 export declare function randomIntBetween(min: number, max: number): number;
 //# sourceMappingURL=numbers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/common/numbers.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,SAAS,CAAC,SAAS,SAAI,GAAG,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjE"}
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/common/numbers.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,iBAAiB,UAAO,GAAG,MAAM,CAWxF;AAED,wBAAgB,SAAS,CAAC,SAAS,SAAI,GAAG,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjE"}

package/dist/common/numbers.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomIntBetween = exports.randomInt = exports.formatNumber = exports.getFloatValue = void 0;
+exports.randomIntBetween = exports.randomInt = exports.numberToString = exports.abbreviateNumber = exports.formatNumber = exports.getFloatValue = void 0;
 function getFloatValue(value) {
     return typeof value === "string" ? parseFloat(value) : value;
 }
@@ -12,6 +12,45 @@ function formatNumber(num) {
     return Math.floor(num * 100) / 100;
 }
 exports.formatNumber = formatNumber;
+/**
+ * Format a number to a human readable string, with optional decimal places and thousand separator.
+ */
+function abbreviateNumber(num) {
+    if (num < 1000) {
+        return numberToString(num, 1);
+    }
+    if (num < 1000000) {
+        return `${numberToString(num / 1000, 1)}K`;
+    }
+    if (num < 1000000000) {
+        return `${numberToString(num / 1000000, 1)}M`;
+    }
+    return `${numberToString(num / 1000000000, 1)}G`;
+}
+exports.abbreviateNumber = abbreviateNumber;
+/**
+ * Format a number to a string, with optional decimal places and thousand separator.
+ *
+ * @param num the number to format
+ * @param digits number of decimal places, only used if `thousandSeparator` is true
+ * @param thousandSeparator if true (default), use Intl.NumberFormat to format the number; otherwise,
+ *                          return the number without formatting.
+ */
+function numberToString(num, digits = 2, thousandSeparator = true) {
+    const asString = num.toFixed(digits);
+    if (!thousandSeparator)
+        return asString;
+    const parts = asString.split(".");
+    const integerPart = parts[0] ?? 0;
+    const decimalPart = parts[1];
+    const integerPartWithSeparator = integerPart
+        ? Intl.NumberFormat("en-US").format(Number(integerPart))
+        : integerPart;
+    if (decimalPart == undefined)
+        return integerPartWithSeparator.toString();
+    return `${integerPartWithSeparator}.${decimalPart}`;
+}
+exports.numberToString = numberToString;
 function randomInt(maxDigits = 2) {
     return Math.floor(Math.random() * Math.pow(10, maxDigits));
 }

package/dist/common/numbers.js.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../src/common/numbers.ts"],"names":[],"mappings":";;;AAAA,SAAgB,aAAa,CAAC,KAAsB;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAFD,sCAEC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC;AAFD,oCAEC;AAED,SAAgB,SAAS,CAAC,SAAS,GAAG,CAAC;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7D,CAAC;AAFD,8BAEC;AAED,SAAgB,gBAAgB,CAAC,GAAW,EAAE,GAAW;IACvD,IAAI,GAAG,GAAG,GAAG,EAAE;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;KAC9C;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;KAChD;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC;AARD,4CAQC"}
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../src/common/numbers.ts"],"names":[],"mappings":";;;AAAA,SAAgB,aAAa,CAAC,KAAsB;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAFD,sCAEC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC;AAFD,oCAEC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,IAAI,GAAG,GAAG,IAAK,EAAE;QACf,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;KAC/B;IACD,IAAI,GAAG,GAAG,OAAS,EAAE;QACnB,OAAO,GAAG,cAAc,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;KAC5C;IACD,IAAI,GAAG,GAAG,UAAa,EAAE;QACvB,OAAO,GAAG,cAAc,CAAC,GAAG,GAAG,OAAS,EAAE,CAAC,CAAC,GAAG,CAAC;KACjD;IACD,OAAO,GAAG,cAAc,CAAC,GAAG,GAAG,UAAa,EAAE,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC;AAXD,4CAWC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,GAAW,EAAE,MAAM,GAAG,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAC9E,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,iBAAiB;QAAE,OAAO,QAAQ,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,wBAAwB,GAAG,WAAW;QAC1C,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACxD,CAAC,CAAC,WAAW,CAAC;IAChB,IAAI,WAAW,IAAI,SAAS;QAAE,OAAO,wBAAwB,CAAC,QAAQ,EAAE,CAAC;IACzE,OAAO,GAAG,wBAAwB,IAAI,WAAW,EAAE,CAAC;AACtD,CAAC;AAXD,wCAWC;AAED,SAAgB,SAAS,CAAC,SAAS,GAAG,CAAC;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7D,CAAC;AAFD,8BAEC;AAED,SAAgB,gBAAgB,CAAC,GAAW,EAAE,GAAW;IACvD,IAAI,GAAG,GAAG,GAAG,EAAE;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;KAC9C;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;KAChD;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC;AARD,4CAQC"}

package/dist/domain/__tests__/cursor-utils.test.d.ts

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

package/dist/domain/__tests__/cursor-utils.test.d.ts.map

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

package/dist/domain/__tests__/cursor-utils.test.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const faker_1 = require("@faker-js/faker");
+const cursor_utils_1 = require("../cursor-utils");
+beforeEach(() => {
+    jest.restoreAllMocks();
+});
+describe("cursor-utils", () => {
+    describe("encodeCursor", () => {
+        it("returns encoded string when given empty object", () => {
+            const cursor = {};
+            const encoded = (0, cursor_utils_1.encodeCursor)(cursor);
+            expect(encoded).toBe("e30="); // base64 for '{}'
+        });
+        it("encodes simple cursor object", () => {
+            const cursor = { id: "123" };
+            const encoded = (0, cursor_utils_1.encodeCursor)(cursor);
+            const decoded = JSON.parse(Buffer.from(encoded, "base64").toString("utf8"));
+            expect(decoded).toEqual(cursor);
+        });
+        it("encodes complex cursor with multiple fields and types", () => {
+            const cursor = {
+                name: "john doe",
+                createdAt: "2023-12-01T10:00:00Z",
+                priority: 5,
+                isActive: true,
+                id: "uuid-123",
+            };
+            const encoded = (0, cursor_utils_1.encodeCursor)(cursor);
+            const decoded = JSON.parse(Buffer.from(encoded, "base64").toString("utf8"));
+            expect(decoded).toEqual(cursor);
+        });
+        it("handles special characters in cursor values", () => {
+            const cursor = {
+                name: "João da Silva & Co.",
+                notes: "Test with 🦄 emojis and\nnewlines",
+            };
+            const encoded = (0, cursor_utils_1.encodeCursor)(cursor);
+            const decoded = JSON.parse(Buffer.from(encoded, "base64").toString("utf8"));
+            expect(decoded).toEqual(cursor);
+        });
+        it("handles null and undefined values", () => {
+            const cursor = {
+                name: null,
+                description: undefined,
+                id: "123",
+            };
+            const encoded = (0, cursor_utils_1.encodeCursor)(cursor);
+            const decoded = JSON.parse(Buffer.from(encoded, "base64").toString("utf8"));
+            expect(decoded).toEqual({ name: null, id: "123" }); // undefined gets removed by JSON
+        });
+    });
+    describe("decodeCursor", () => {
+        it("decodes empty object cursor", () => {
+            const encoded = "e30="; // base64 for '{}'
+            const decoded = (0, cursor_utils_1.decodeCursor)(encoded);
+            expect(decoded).toEqual({});
+        });
+        it("decodes simple cursor", () => {
+            const original = { id: "123" };
+            const encoded = (0, cursor_utils_1.encodeCursor)(original);
+            const decoded = (0, cursor_utils_1.decodeCursor)(encoded);
+            expect(decoded).toEqual(original);
+        });
+        it("decodes complex cursor with multiple types", () => {
+            const original = {
+                name: "test user",
+                timestamp: "2023-12-01T10:00:00Z",
+                count: 42,
+                isEnabled: false,
+            };
+            const encoded = (0, cursor_utils_1.encodeCursor)(original);
+            const decoded = (0, cursor_utils_1.decodeCursor)(encoded);
+            expect(decoded).toEqual(original);
+        });
+        it("throws error for invalid base64", () => {
+            const invalidBase64 = "not-valid-base64!!!";
+            expect(() => (0, cursor_utils_1.decodeCursor)(invalidBase64)).toThrow();
+        });
+        it("throws error for valid base64 but invalid JSON", () => {
+            const validBase64 = Buffer.from("invalid json", "utf8").toString("base64");
+            expect(() => (0, cursor_utils_1.decodeCursor)(validBase64)).toThrow();
+        });
+        it("throws error for empty string", () => {
+            expect(() => (0, cursor_utils_1.decodeCursor)("")).toThrow();
+        });
+    });
+    describe("encode and decode together", () => {
+        it("roundtrip preserves empty object", () => {
+            const original = {};
+            const roundtrip = (0, cursor_utils_1.decodeCursor)((0, cursor_utils_1.encodeCursor)(original));
+            expect(roundtrip).toEqual(original);
+        });
+        it("roundtrip preserves simple object", () => {
+            const original = { id: faker_1.faker.string.uuid() };
+            const roundtrip = (0, cursor_utils_1.decodeCursor)((0, cursor_utils_1.encodeCursor)(original));
+            expect(roundtrip).toEqual(original);
+        });
+        it("roundtrip preserves complex object", () => {
+            const original = {
+                id: faker_1.faker.string.uuid(),
+                name: faker_1.faker.person.fullName(),
+                email: faker_1.faker.internet.email(),
+                age: faker_1.faker.number.int({ min: 18, max: 100 }),
+                createdAt: faker_1.faker.date.recent().toISOString(),
+                isActive: faker_1.faker.datatype.boolean(),
+            };
+            const roundtrip = (0, cursor_utils_1.decodeCursor)((0, cursor_utils_1.encodeCursor)(original));
+            expect(roundtrip).toEqual(original);
+        });
+        it("roundtrip handles special characters", () => {
+            const original = {
+                unicode: "🦄🌟⭐",
+                multiline: "line1\nline2\r\nline3",
+                quotes: 'single "double" quotes',
+                special: "& < > ' \"",
+            };
+            const roundtrip = (0, cursor_utils_1.decodeCursor)((0, cursor_utils_1.encodeCursor)(original));
+            expect(roundtrip).toEqual(original);
+        });
+    });
+    describe("createCompositeCursor", () => {
+        const mockSortFields = [
+            { col: "name", order: "asc" },
+            { col: "createdAt", order: "desc" },
+            { col: "id", order: "asc" },
+        ];
+        it("creates cursor with all sort fields from item", () => {
+            const item = {
+                id: faker_1.faker.string.uuid(),
+                name: faker_1.faker.person.fullName(),
+                createdAt: faker_1.faker.date.recent().toISOString(),
+                email: faker_1.faker.internet.email(),
+                age: faker_1.faker.number.int(),
+            };
+            const cursor = (0, cursor_utils_1.createCompositeCursor)(item, mockSortFields);
+            expect(cursor).toEqual({
+                name: item.name,
+                createdAt: item.createdAt,
+                id: item.id,
+            });
+            expect(cursor).not.toHaveProperty("email");
+            expect(cursor).not.toHaveProperty("age");
+        });
+        it("creates cursor with subset of fields when item missing some sort fields", () => {
+            const item = {
+                id: faker_1.faker.string.uuid(),
+                name: faker_1.faker.person.fullName(),
+                // missing createdAt
+                email: faker_1.faker.internet.email(),
+            };
+            const cursor = (0, cursor_utils_1.createCompositeCursor)(item, mockSortFields);
+            expect(cursor).toEqual({
+                name: item.name,
+                createdAt: undefined,
+                id: item.id,
+            });
+        });
+        it("creates empty cursor for empty sort fields", () => {
+            const item = {
+                id: faker_1.faker.string.uuid(),
+                name: faker_1.faker.person.fullName(),
+            };
+            const cursor = (0, cursor_utils_1.createCompositeCursor)(item, []);
+            expect(cursor).toEqual({});
+        });
+        it("handles null and undefined values in item", () => {
+            const item = {
+                id: faker_1.faker.string.uuid(),
+                name: null,
+                createdAt: undefined,
+                status: "active",
+            };
+            const cursor = (0, cursor_utils_1.createCompositeCursor)(item, mockSortFields);
+            expect(cursor).toEqual({
+                name: null,
+                createdAt: undefined,
+                id: item.id,
+            });
+        });
+        it("works with single sort field", () => {
+            const item = {
+                id: faker_1.faker.string.uuid(),
+                name: faker_1.faker.person.fullName(),
+            };
+            const singleSortField = [{ col: "name", order: "asc" }];
+            const cursor = (0, cursor_utils_1.createCompositeCursor)(item, singleSortField);
+            expect(cursor).toEqual({
+                name: item.name,
+            });
+        });
+        it("preserves different data types in cursor", () => {
+            const item = {
+                id: faker_1.faker.string.uuid(),
+                count: faker_1.faker.number.int(),
+                price: faker_1.faker.number.float(),
+                isActive: faker_1.faker.datatype.boolean(),
+                createdAt: faker_1.faker.date.recent(),
+            };
+            const sortFields = [
+                { col: "count", order: "desc" },
+                { col: "price", order: "asc" },
+                { col: "isActive", order: "desc" },
+                { col: "createdAt", order: "asc" },
+            ];
+            const cursor = (0, cursor_utils_1.createCompositeCursor)(item, sortFields);
+            expect(cursor).toEqual({
+                count: item.count,
+                price: item.price,
+                isActive: item.isActive,
+                createdAt: item.createdAt,
+            });
+        });
+    });
+});
+//# sourceMappingURL=cursor-utils.test.js.map

package/dist/domain/__tests__/cursor-utils.test.js.map

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

package/dist/domain/__tests__/pagination-schema.test.d.ts

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

package/dist/domain/__tests__/pagination-schema.test.d.ts.map

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

package/dist/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