@deciosfernandes/uuidv7-timestamp 0.1.0 → 0.1.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 deciosfernandes
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2025 deciosfernandes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,43 +1,50 @@
-# @deciosfernandes/uuidv7-timestamp
-
-Extract epoch timestamp from UUID v7 strings (TypeScript).
-
-This tiny library extracts the timestamp encoded in UUID v7 values (the first 48 bits / first 12 hex chars) and returns it as milliseconds, a Date, or an ISO string.
-
-## Installation
-
-npm:
-```bash
-npm install @deciosfernandes/uuidv7-timestamp
-```
-
-yarn:
-```bash
-yarn add @deciosfernandes/uuidv7-timestamp
-```
-
-## Usage
-
-```ts
-import { extractTimestampFromUuidV7, extractTimestampAsDate } from '@deciosfernandes/uuidv7-timestamp';
-
-const uuid = '017f7f58-89ab-7000-8123-0123456789ab';
-const millis = extractTimestampFromUuidV7(uuid);
-const date = extractTimestampAsDate(uuid);
-console.log(millis, date.toISOString());
-```
-
-## API
-
-- extractTimestampFromUuidV7(uuid: string): number — returns epoch milliseconds encoded in the UUID v7.
-- extractTimestampAsDate(uuid: string): Date — returns a Date instance.
-- extractTimestampAsISOString(uuid: string): string — returns an ISO 8601 string.
-
-## Notes
-
-- The function validates the UUID format and ensures the version nibble is `7`. If the UUID is not v7, an Error is thrown.
-- The timestamp is assumed to be the first 48 bits of the UUID per the v7 draft layout.
-
-## License
-
+# @deciosfernandes/uuidv7-timestamp
+
+Extract epoch timestamp from UUID v7 strings (TypeScript).
+
+This tiny library extracts the timestamp encoded in UUID v7 values (the first 48 bits / first 12 hex chars) and returns it as milliseconds, a Date, or an ISO string.
+
+## Installation
+
+npm:
+```bash
+npm install @deciosfernandes/uuidv7-timestamp
+```
+
+yarn:
+```bash
+yarn add @deciosfernandes/uuidv7-timestamp
+```
+
+## Usage
+
+```ts
+import { extractTimestampFromUuidV7, extractTimestampAsDate } from '@deciosfernandes/uuidv7-timestamp';
+
+const uuid = '017f7f58-89ab-7000-8123-0123456789ab';
+const millis = extractTimestampFromUuidV7(uuid);
+const date = extractTimestampAsDate(uuid);
+console.log(millis, date.toISOString());
+```
+
+## API
+
+```ts
+// Returns epoch milliseconds encoded in the UUID v7
+extractTimestampFromUuidV7(uuid: string): number
+
+// Returns a Date instance
+extractTimestampAsDate(uuid: string): Date
+
+// Returns an ISO 8601 string (UTC)
+extractTimestampAsISOString(uuid: string): string
+```
+
+## Notes
+
+- The function validates the UUID format and ensures the version nibble is `7`. If the UUID is not v7, an Error is thrown.
+- The timestamp is assumed to be the first 48 bits of the UUID per the v7 draft layout.
+
+## License
+
 MIT

package/dist/index.cjs.js

@@ -37,12 +37,8 @@ function extractTimestampFromUuidV7(uuid) {
     }
     // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars
     const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits
-    const millisBig = BigInt(`0x${timeHex}`);
-    const millis = Number(millisBig);
-    if (!Number.isFinite(millis)) {
-        throw new Error('extracted timestamp is not a finite number');
-    }
-    return millis;
+    // 48-bit integer is always within Number.MAX_SAFE_INTEGER (2^53 - 1), so parseInt is safe
+    return parseInt(timeHex, 16);
 }
 /**
  * Same as extractTimestampFromUuidV7 but returns a Date instance.
@@ -66,7 +62,7 @@ function extractTimestampAsISOString(uuid) {
 var index = {
     extractTimestampFromUuidV7,
     extractTimestampAsDate,
-    extractTimestampAsISOString
+    extractTimestampAsISOString,
 };
 
 exports.default = index;

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Extract timestamp from UUID v7 strings.\n *\n * The timestamp for UUID v7 is encoded in the first 48 bits (12 hex chars) of the UUID.\n * This module exposes three helpers:\n * - extractTimestampFromUuidV7(uuid): number (epoch millis)\n * - extractTimestampAsDate(uuid): Date\n * - extractTimestampAsISOString(uuid): string\n */\n\nconst HEX_32_RE = /^[0-9a-fA-F]{32}$/;\n\n/**\n * Extracts the epoch milliseconds timestamp from a UUID v7 string.\n * Caller must pass a UUID v7 (validation is performed and an error thrown if it's not v7).\n *\n * @param uuid - UUID string (hyphenated or not)\n * @returns epoch milliseconds (number)\n * @throws Error if input is not a valid UUID string or not version 7\n */\nexport function extractTimestampFromUuidV7(uuid: string): number {\n  if (typeof uuid !== 'string' || uuid.length === 0) {\n    throw new Error('uuid must be a non-empty string');\n  }\n\n  // Normalize: remove hyphens\n  const normalized = uuid.replace(/-/g, '');\n\n  if (!HEX_32_RE.test(normalized)) {\n    throw new Error('invalid UUID format');\n  }\n\n  // Version nibble is the first hex char of the 3rd UUID segment.\n  // In the normalized string it's at index 12 (0-based).\n  const versionChar = normalized[12];\n  if (versionChar !== '7') {\n    throw new Error(`expected UUID v7 (version nibble = 7), got version nibble = ${versionChar}`);\n  }\n\n  // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars\n  const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits\n  const millisBig = BigInt(`0x${timeHex}`);\n  const millis = Number(millisBig);\n\n  if (!Number.isFinite(millis)) {\n    throw new Error('extracted timestamp is not a finite number');\n  }\n\n  return millis;\n}\n\n/**\n * Same as extractTimestampFromUuidV7 but returns a Date instance.\n *\n * @param uuid - UUID v7 string\n * @returns Date representing the timestamp encoded in the UUID\n */\nexport function extractTimestampAsDate(uuid: string): Date {\n  const ms = extractTimestampFromUuidV7(uuid);\n  return new Date(ms);\n}\n\n/**\n * Convenience: returns an ISO string for the timestamp contained in the UUID v7.\n *\n * @param uuid - UUID v7 string\n * @returns ISO 8601 string (UTC)\n */\nexport function extractTimestampAsISOString(uuid: string): string {\n  return extractTimestampAsDate(uuid).toISOString();\n}\n\nexport default {\n  extractTimestampFromUuidV7,\n  extractTimestampAsDate,\n  extractTimestampAsISOString\n};"],"names":[],"mappings":";;;;AAAA;;;;;;;;AAQG;AAEH,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAEtC;;;;;;;AAOG;AACG,SAAU,0BAA0B,CAAC,IAAY,EAAA;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACjD,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;KACpD;;IAGD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE1C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;AAC/B,QAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;KACxC;;;AAID,IAAA,MAAM,WAAW,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;AACnC,IAAA,IAAI,WAAW,KAAK,GAAG,EAAE;AACvB,QAAA,MAAM,IAAI,KAAK,CAAC,+DAA+D,WAAW,CAAA,CAAE,CAAC,CAAC;KAC/F;;AAGD,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,OAAO,CAAA,CAAE,CAAC,CAAC;AACzC,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC5B,QAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;KAC/D;AAED,IAAA,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;AAKG;AACG,SAAU,sBAAsB,CAAC,IAAY,EAAA;AACjD,IAAA,MAAM,EAAE,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC5C,IAAA,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;;;AAKG;AACG,SAAU,2BAA2B,CAAC,IAAY,EAAA;AACtD,IAAA,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,YAAe;IACb,0BAA0B;IAC1B,sBAAsB;IACtB,2BAA2B;CAC5B;;;;;;;"}
+{"version":3,"file":"index.cjs.js","sources":["../src/index.ts"],"sourcesContent":["/**\r\n * Extract timestamp from UUID v7 strings.\r\n *\r\n * The timestamp for UUID v7 is encoded in the first 48 bits (12 hex chars) of the UUID.\r\n * This module exposes three helpers:\r\n * - extractTimestampFromUuidV7(uuid): number (epoch millis)\r\n * - extractTimestampAsDate(uuid): Date\r\n * - extractTimestampAsISOString(uuid): string\r\n */\r\n\r\nconst HEX_32_RE = /^[0-9a-fA-F]{32}$/;\r\n\r\n/**\r\n * Extracts the epoch milliseconds timestamp from a UUID v7 string.\r\n * Caller must pass a UUID v7 (validation is performed and an error thrown if it's not v7).\r\n *\r\n * @param uuid - UUID string (hyphenated or not)\r\n * @returns epoch milliseconds (number)\r\n * @throws Error if input is not a valid UUID string or not version 7\r\n */\r\nexport function extractTimestampFromUuidV7(uuid: string): number {\r\n    if (typeof uuid !== 'string' || uuid.length === 0) {\r\n        throw new Error('uuid must be a non-empty string');\r\n    }\r\n\r\n    // Normalize: remove hyphens\r\n    const normalized = uuid.replace(/-/g, '');\r\n\r\n    if (!HEX_32_RE.test(normalized)) {\r\n        throw new Error('invalid UUID format');\r\n    }\r\n\r\n    // Version nibble is the first hex char of the 3rd UUID segment.\r\n    // In the normalized string it's at index 12 (0-based).\r\n    const versionChar = normalized[12];\r\n    if (versionChar !== '7') {\r\n        throw new Error(`expected UUID v7 (version nibble = 7), got version nibble = ${versionChar}`);\r\n    }\r\n\r\n    // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars\r\n    const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits\r\n    // 48-bit integer is always within Number.MAX_SAFE_INTEGER (2^53 - 1), so parseInt is safe\r\n    return parseInt(timeHex, 16);\r\n}\r\n\r\n/**\r\n * Same as extractTimestampFromUuidV7 but returns a Date instance.\r\n *\r\n * @param uuid - UUID v7 string\r\n * @returns Date representing the timestamp encoded in the UUID\r\n */\r\nexport function extractTimestampAsDate(uuid: string): Date {\r\n    const ms = extractTimestampFromUuidV7(uuid);\r\n    return new Date(ms);\r\n}\r\n\r\n/**\r\n * Convenience: returns an ISO string for the timestamp contained in the UUID v7.\r\n *\r\n * @param uuid - UUID v7 string\r\n * @returns ISO 8601 string (UTC)\r\n */\r\nexport function extractTimestampAsISOString(uuid: string): string {\r\n    return extractTimestampAsDate(uuid).toISOString();\r\n}\r\n\r\nexport default {\r\n    extractTimestampFromUuidV7,\r\n    extractTimestampAsDate,\r\n    extractTimestampAsISOString,\r\n};\r\n"],"names":[],"mappings":";;;;AAAA;;;;;;;;AAQG;AAEH,MAAM,SAAS,GAAG,mBAAmB;AAErC;;;;;;;AAOG;AACG,SAAU,0BAA0B,CAAC,IAAY,EAAA;IACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AAC/C,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IACtD;;IAGA,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IAEzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;AAC7B,QAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC;IAC1C;;;AAIA,IAAA,MAAM,WAAW,GAAG,UAAU,CAAC,EAAE,CAAC;AAClC,IAAA,IAAI,WAAW,KAAK,GAAG,EAAE;AACrB,QAAA,MAAM,IAAI,KAAK,CAAC,+DAA+D,WAAW,CAAA,CAAE,CAAC;IACjG;;AAGA,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;;AAExC,IAAA,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;AAChC;AAEA;;;;;AAKG;AACG,SAAU,sBAAsB,CAAC,IAAY,EAAA;AAC/C,IAAA,MAAM,EAAE,GAAG,0BAA0B,CAAC,IAAI,CAAC;AAC3C,IAAA,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;AACvB;AAEA;;;;;AAKG;AACG,SAAU,2BAA2B,CAAC,IAAY,EAAA;AACpD,IAAA,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;AACrD;AAEA,YAAe;IACX,0BAA0B;IAC1B,sBAAsB;IACtB,2BAA2B;CAC9B;;;;;;;"}

package/dist/index.esm.js

@@ -33,12 +33,8 @@ function extractTimestampFromUuidV7(uuid) {
     }
     // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars
     const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits
-    const millisBig = BigInt(`0x${timeHex}`);
-    const millis = Number(millisBig);
-    if (!Number.isFinite(millis)) {
-        throw new Error('extracted timestamp is not a finite number');
-    }
-    return millis;
+    // 48-bit integer is always within Number.MAX_SAFE_INTEGER (2^53 - 1), so parseInt is safe
+    return parseInt(timeHex, 16);
 }
 /**
  * Same as extractTimestampFromUuidV7 but returns a Date instance.
@@ -62,7 +58,7 @@ function extractTimestampAsISOString(uuid) {
 var index = {
     extractTimestampFromUuidV7,
     extractTimestampAsDate,
-    extractTimestampAsISOString
+    extractTimestampAsISOString,
 };
 
 export { index as default, extractTimestampAsDate, extractTimestampAsISOString, extractTimestampFromUuidV7 };

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Extract timestamp from UUID v7 strings.\n *\n * The timestamp for UUID v7 is encoded in the first 48 bits (12 hex chars) of the UUID.\n * This module exposes three helpers:\n * - extractTimestampFromUuidV7(uuid): number (epoch millis)\n * - extractTimestampAsDate(uuid): Date\n * - extractTimestampAsISOString(uuid): string\n */\n\nconst HEX_32_RE = /^[0-9a-fA-F]{32}$/;\n\n/**\n * Extracts the epoch milliseconds timestamp from a UUID v7 string.\n * Caller must pass a UUID v7 (validation is performed and an error thrown if it's not v7).\n *\n * @param uuid - UUID string (hyphenated or not)\n * @returns epoch milliseconds (number)\n * @throws Error if input is not a valid UUID string or not version 7\n */\nexport function extractTimestampFromUuidV7(uuid: string): number {\n  if (typeof uuid !== 'string' || uuid.length === 0) {\n    throw new Error('uuid must be a non-empty string');\n  }\n\n  // Normalize: remove hyphens\n  const normalized = uuid.replace(/-/g, '');\n\n  if (!HEX_32_RE.test(normalized)) {\n    throw new Error('invalid UUID format');\n  }\n\n  // Version nibble is the first hex char of the 3rd UUID segment.\n  // In the normalized string it's at index 12 (0-based).\n  const versionChar = normalized[12];\n  if (versionChar !== '7') {\n    throw new Error(`expected UUID v7 (version nibble = 7), got version nibble = ${versionChar}`);\n  }\n\n  // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars\n  const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits\n  const millisBig = BigInt(`0x${timeHex}`);\n  const millis = Number(millisBig);\n\n  if (!Number.isFinite(millis)) {\n    throw new Error('extracted timestamp is not a finite number');\n  }\n\n  return millis;\n}\n\n/**\n * Same as extractTimestampFromUuidV7 but returns a Date instance.\n *\n * @param uuid - UUID v7 string\n * @returns Date representing the timestamp encoded in the UUID\n */\nexport function extractTimestampAsDate(uuid: string): Date {\n  const ms = extractTimestampFromUuidV7(uuid);\n  return new Date(ms);\n}\n\n/**\n * Convenience: returns an ISO string for the timestamp contained in the UUID v7.\n *\n * @param uuid - UUID v7 string\n * @returns ISO 8601 string (UTC)\n */\nexport function extractTimestampAsISOString(uuid: string): string {\n  return extractTimestampAsDate(uuid).toISOString();\n}\n\nexport default {\n  extractTimestampFromUuidV7,\n  extractTimestampAsDate,\n  extractTimestampAsISOString\n};"],"names":[],"mappings":"AAAA;;;;;;;;AAQG;AAEH,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAEtC;;;;;;;AAOG;AACG,SAAU,0BAA0B,CAAC,IAAY,EAAA;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACjD,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;KACpD;;IAGD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE1C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;AAC/B,QAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;KACxC;;;AAID,IAAA,MAAM,WAAW,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;AACnC,IAAA,IAAI,WAAW,KAAK,GAAG,EAAE;AACvB,QAAA,MAAM,IAAI,KAAK,CAAC,+DAA+D,WAAW,CAAA,CAAE,CAAC,CAAC;KAC/F;;AAGD,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,OAAO,CAAA,CAAE,CAAC,CAAC;AACzC,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC5B,QAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;KAC/D;AAED,IAAA,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;AAKG;AACG,SAAU,sBAAsB,CAAC,IAAY,EAAA;AACjD,IAAA,MAAM,EAAE,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC5C,IAAA,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;;;AAKG;AACG,SAAU,2BAA2B,CAAC,IAAY,EAAA;AACtD,IAAA,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,YAAe;IACb,0BAA0B;IAC1B,sBAAsB;IACtB,2BAA2B;CAC5B;;;;"}
+{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":["/**\r\n * Extract timestamp from UUID v7 strings.\r\n *\r\n * The timestamp for UUID v7 is encoded in the first 48 bits (12 hex chars) of the UUID.\r\n * This module exposes three helpers:\r\n * - extractTimestampFromUuidV7(uuid): number (epoch millis)\r\n * - extractTimestampAsDate(uuid): Date\r\n * - extractTimestampAsISOString(uuid): string\r\n */\r\n\r\nconst HEX_32_RE = /^[0-9a-fA-F]{32}$/;\r\n\r\n/**\r\n * Extracts the epoch milliseconds timestamp from a UUID v7 string.\r\n * Caller must pass a UUID v7 (validation is performed and an error thrown if it's not v7).\r\n *\r\n * @param uuid - UUID string (hyphenated or not)\r\n * @returns epoch milliseconds (number)\r\n * @throws Error if input is not a valid UUID string or not version 7\r\n */\r\nexport function extractTimestampFromUuidV7(uuid: string): number {\r\n    if (typeof uuid !== 'string' || uuid.length === 0) {\r\n        throw new Error('uuid must be a non-empty string');\r\n    }\r\n\r\n    // Normalize: remove hyphens\r\n    const normalized = uuid.replace(/-/g, '');\r\n\r\n    if (!HEX_32_RE.test(normalized)) {\r\n        throw new Error('invalid UUID format');\r\n    }\r\n\r\n    // Version nibble is the first hex char of the 3rd UUID segment.\r\n    // In the normalized string it's at index 12 (0-based).\r\n    const versionChar = normalized[12];\r\n    if (versionChar !== '7') {\r\n        throw new Error(`expected UUID v7 (version nibble = 7), got version nibble = ${versionChar}`);\r\n    }\r\n\r\n    // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars\r\n    const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits\r\n    // 48-bit integer is always within Number.MAX_SAFE_INTEGER (2^53 - 1), so parseInt is safe\r\n    return parseInt(timeHex, 16);\r\n}\r\n\r\n/**\r\n * Same as extractTimestampFromUuidV7 but returns a Date instance.\r\n *\r\n * @param uuid - UUID v7 string\r\n * @returns Date representing the timestamp encoded in the UUID\r\n */\r\nexport function extractTimestampAsDate(uuid: string): Date {\r\n    const ms = extractTimestampFromUuidV7(uuid);\r\n    return new Date(ms);\r\n}\r\n\r\n/**\r\n * Convenience: returns an ISO string for the timestamp contained in the UUID v7.\r\n *\r\n * @param uuid - UUID v7 string\r\n * @returns ISO 8601 string (UTC)\r\n */\r\nexport function extractTimestampAsISOString(uuid: string): string {\r\n    return extractTimestampAsDate(uuid).toISOString();\r\n}\r\n\r\nexport default {\r\n    extractTimestampFromUuidV7,\r\n    extractTimestampAsDate,\r\n    extractTimestampAsISOString,\r\n};\r\n"],"names":[],"mappings":"AAAA;;;;;;;;AAQG;AAEH,MAAM,SAAS,GAAG,mBAAmB;AAErC;;;;;;;AAOG;AACG,SAAU,0BAA0B,CAAC,IAAY,EAAA;IACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AAC/C,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IACtD;;IAGA,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IAEzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;AAC7B,QAAA,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC;IAC1C;;;AAIA,IAAA,MAAM,WAAW,GAAG,UAAU,CAAC,EAAE,CAAC;AAClC,IAAA,IAAI,WAAW,KAAK,GAAG,EAAE;AACrB,QAAA,MAAM,IAAI,KAAK,CAAC,+DAA+D,WAAW,CAAA,CAAE,CAAC;IACjG;;AAGA,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;;AAExC,IAAA,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;AAChC;AAEA;;;;;AAKG;AACG,SAAU,sBAAsB,CAAC,IAAY,EAAA;AAC/C,IAAA,MAAM,EAAE,GAAG,0BAA0B,CAAC,IAAI,CAAC;AAC3C,IAAA,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;AACvB;AAEA;;;;;AAKG;AACG,SAAU,2BAA2B,CAAC,IAAY,EAAA;AACpD,IAAA,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;AACrD;AAEA,YAAe;IACX,0BAA0B;IAC1B,sBAAsB;IACtB,2BAA2B;CAC9B;;;;"}

package/package.json

@@ -1,47 +1,63 @@
-{
-  "name": "@deciosfernandes/uuidv7-timestamp",
-  "version": "0.1.0",
-  "description": "Extract epoch timestamp from UUID v7 strings (millis, Date, ISO) for TypeScript/Angular apps.",
-  "main": "dist/index.cjs.js",
-  "module": "dist/index.esm.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc && rollup -c",
-    "clean": "rm -rf dist .turbo cache",
-    "test": "vitest",
-    "lint": "eslint . --ext .ts",
-    "prepare": "npm run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/deciosfernandes/uuidv7-timestamp.git"
-  },
-  "keywords": [
-    "uuid",
-    "uuidv7",
-    "timestamp",
-    "typescript",
-    "angular"
-  ],
-  "author": "deciosfernandes",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^24.0.0",
-    "@rollup/plugin-node-resolve": "^15.0.0",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^5.0.0",
-    "@typescript-eslint/parser": "^5.0.0",
-    "eslint": "^8.0.0",
-    "rollup": "^3.0.0",
-    "rollup-plugin-dts": "^5.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^1.3.0"
-  }
-}
+{
+    "name": "@deciosfernandes/uuidv7-timestamp",
+    "version": "0.1.2",
+    "description": "Extract epoch timestamp from UUID v7 strings (millis, Date, ISO) — works with any TypeScript or JavaScript project.",
+    "type": "module",
+    "main": "dist/index.cjs.js",
+    "module": "dist/index.esm.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.esm.js",
+            "require": "./dist/index.cjs.js"
+        }
+    },
+    "sideEffects": false,
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "rollup -c",
+        "clean": "rimraf dist .turbo cache",
+        "test": "vitest",
+        "lint": "eslint src test",
+        "prepare": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/deciosfernandes/uuidv7-timestamp.git"
+    },
+    "keywords": [
+        "uuid",
+        "uuid-v7",
+        "uuidv7",
+        "timestamp",
+        "extract",
+        "epoch",
+        "date",
+        "iso",
+        "typescript",
+        "javascript"
+    ],
+    "author": "deciosfernandes",
+    "license": "MIT",
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "devDependencies": {
+        "@rollup/plugin-typescript": "^12.3.0",
+        "@types/node": "^22.0.0",
+        "eslint": "^9.0.0",
+        "rimraf": "^6.0.0",
+        "rollup": "^4.0.0",
+        "rollup-plugin-dts": "^6.0.0",
+        "tslib": "^2.8.0",
+        "typescript": "^5.0.0",
+        "typescript-eslint": "^8.0.0",
+        "vitest": "^3.0.0"
+    }
+}

package/dist/index.js

@@ -1,66 +0,0 @@
-/**
- * Extract timestamp from UUID v7 strings.
- *
- * The timestamp for UUID v7 is encoded in the first 48 bits (12 hex chars) of the UUID.
- * This module exposes three helpers:
- * - extractTimestampFromUuidV7(uuid): number (epoch millis)
- * - extractTimestampAsDate(uuid): Date
- * - extractTimestampAsISOString(uuid): string
- */
-const HEX_32_RE = /^[0-9a-fA-F]{32}$/;
-/**
- * Extracts the epoch milliseconds timestamp from a UUID v7 string.
- * Caller must pass a UUID v7 (validation is performed and an error thrown if it's not v7).
- *
- * @param uuid - UUID string (hyphenated or not)
- * @returns epoch milliseconds (number)
- * @throws Error if input is not a valid UUID string or not version 7
- */
-export function extractTimestampFromUuidV7(uuid) {
-    if (typeof uuid !== 'string' || uuid.length === 0) {
-        throw new Error('uuid must be a non-empty string');
-    }
-    // Normalize: remove hyphens
-    const normalized = uuid.replace(/-/g, '');
-    if (!HEX_32_RE.test(normalized)) {
-        throw new Error('invalid UUID format');
-    }
-    // Version nibble is the first hex char of the 3rd UUID segment.
-    // In the normalized string it's at index 12 (0-based).
-    const versionChar = normalized[12];
-    if (versionChar !== '7') {
-        throw new Error(`expected UUID v7 (version nibble = 7), got version nibble = ${versionChar}`);
-    }
-    // Timestamp for UUID v7 is the top 48 bits: time_low (8 hex) + time_mid (4 hex) => first 12 hex chars
-    const timeHex = normalized.slice(0, 12); // 12 hex chars => 48 bits
-    const millisBig = BigInt(`0x${timeHex}`);
-    const millis = Number(millisBig);
-    if (!Number.isFinite(millis)) {
-        throw new Error('extracted timestamp is not a finite number');
-    }
-    return millis;
-}
-/**
- * Same as extractTimestampFromUuidV7 but returns a Date instance.
- *
- * @param uuid - UUID v7 string
- * @returns Date representing the timestamp encoded in the UUID
- */
-export function extractTimestampAsDate(uuid) {
-    const ms = extractTimestampFromUuidV7(uuid);
-    return new Date(ms);
-}
-/**
- * Convenience: returns an ISO string for the timestamp contained in the UUID v7.
- *
- * @param uuid - UUID v7 string
- * @returns ISO 8601 string (UTC)
- */
-export function extractTimestampAsISOString(uuid) {
-    return extractTimestampAsDate(uuid).toISOString();
-}
-export default {
-    extractTimestampFromUuidV7,
-    extractTimestampAsDate,
-    extractTimestampAsISOString
-};