@nakanoaas/uuid58 1.2.1 → 1.2.3

package/esm/encode.js

@@ -1,78 +0,0 @@
-var _a;
-import { UUID58_ALPHABET, UUID58_LENGTH } from "./alphabet.js";
-/**
- * Error thrown when an invalid UUID string is provided for encoding.
- * This includes strings that don't match the standard UUID format (32 hexadecimal characters with optional hyphens).
- */
-export class Uuid58EncodeError extends Error {
-}
-_a = Uuid58EncodeError;
-(() => {
-    _a.prototype.name = "Uuid58EncodeError";
-})();
-/**
- * Converts a standard UUID string to a 22-character Base58-encoded format, but instead of
- * throwing an error for invalid input, it returns an `Uuid58EncodeError` instance.
- *
- * @param uuid - The UUID string to encode (with or without hyphens)
- * @returns A 22-character Base58-encoded string, or an `Uuid58EncodeError` if the input is
- *   not a valid UUID
- * @note This function does not throw; it returns the error object instead.
- *
- * @example
- * ```typescript
- * // With hyphens
- * const base58 = uuid58EncodeSafe("f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Without hyphens
- * const base58 = uuid58EncodeSafe("f4b247fd1f8745d4aa061c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Uppercase UUID is also accepted
- * const base58 = uuid58EncodeSafe("F4B247FD-1F87-45D4-AA06-1C6FC0A8DFAF"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Invalid UUID format
- * const error = uuid58EncodeSafe("invalid"); // returns Uuid58EncodeError
- * ```
- */
-export function uuid58EncodeSafe(uuid) {
-    const hex = uuid.replace(/-/g, "");
-    if (hex.length !== 32) {
-        return new Uuid58EncodeError(`Invalid UUID length: expected 32 characters (excluding hyphens), got ${hex.length} characters in "${uuid}"`);
-    }
-    let num;
-    try {
-        num = BigInt("0x" + hex);
-    }
-    catch {
-        return new Uuid58EncodeError(`Invalid UUID format: "${uuid}" contains non-hexadecimal characters`);
-    }
-    let encoded = "";
-    do {
-        encoded = UUID58_ALPHABET[Number(num % UUID58_LENGTH)] + encoded;
-        num /= UUID58_LENGTH;
-    } while (num > 0n);
-    return encoded.padStart(22, UUID58_ALPHABET[0]);
-}
-/**
- * Converts a standard UUID string to a 22-character Base58-encoded format.
- *
- * @param uuid - The UUID string to encode. Can be provided with or without hyphens
- *              (format: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" or "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").
- *              The input is case-insensitive, so both uppercase and lowercase hexadecimal characters are accepted.
- * @returns A 22-character Base58-encoded string representation of the UUID
- * @throws {Uuid58EncodeError} If the input string is not a valid UUID format
- *
- * @example
- * ```typescript
- * // With hyphens
- * const base58 = uuid58Encode("f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Without hyphens
- * const base58 = uuid58Encode("f4b247fd1f8745d4aa061c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Uppercase UUID is also accepted
- * const base58 = uuid58Encode("F4B247FD-1F87-45D4-AA06-1C6FC0A8DFAF"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-export function uuid58Encode(uuid) {
-    const result = uuid58EncodeSafe(uuid);
-    if (result instanceof Uuid58EncodeError) {
-        throw result;
-    }
-    return result;
-}

package/esm/generate.d.ts

@@ -1,15 +0,0 @@
-/**
- * Generates a new Base58-encoded UUID (always 22 characters).
- *
- * This function combines the standard UUID generation (using crypto.getRandomValues())
- * with Base58 encoding to create a shorter, URL-safe identifier.
- *
- * @returns A 22-character Base58-encoded string representing a newly generated UUID
- *
- * @example
- * ```typescript
- * const id = uuid58(); // returns a 22-character string like "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-export declare function uuid58(): string;
-//# sourceMappingURL=generate.d.ts.map

package/esm/generate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAe/B"}

package/esm/generate.js

@@ -1,26 +0,0 @@
-import { UUID58_ALPHABET, UUID58_LENGTH } from "./alphabet.js";
-/**
- * Generates a new Base58-encoded UUID (always 22 characters).
- *
- * This function combines the standard UUID generation (using crypto.getRandomValues())
- * with Base58 encoding to create a shorter, URL-safe identifier.
- *
- * @returns A 22-character Base58-encoded string representing a newly generated UUID
- *
- * @example
- * ```typescript
- * const id = uuid58(); // returns a 22-character string like "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-export function uuid58() {
-    const bytes = crypto.getRandomValues(new BigUint64Array(2));
-    bytes[0] = (bytes[0] & 0xffffffffffff0fffn) | 0x0000000000004000n;
-    bytes[1] = (bytes[1] & 0x3fffffffffffffffn) | 0x8000000000000000n;
-    let num = bytes[0] << 64n | bytes[1];
-    let encoded = "";
-    do {
-        encoded = UUID58_ALPHABET[Number(num % UUID58_LENGTH)] + encoded;
-        num /= UUID58_LENGTH;
-    } while (num > 0n);
-    return encoded.padStart(22, UUID58_ALPHABET[0]);
-}

package/esm/index.d.ts

@@ -1,6 +0,0 @@
-export { UUID58_ALPHABET } from "./alphabet.js";
-export * from "./check.js";
-export * from "./decode.js";
-export * from "./encode.js";
-export * from "./generate.js";
-//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/esm/index.js

@@ -1,5 +0,0 @@
-export { UUID58_ALPHABET } from "./alphabet.js";
-export * from "./check.js";
-export * from "./decode.js";
-export * from "./encode.js";
-export * from "./generate.js";

package/esm/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}

package/script/alphabet.d.ts

@@ -1,24 +0,0 @@
-/**
- * Character set for Base58 encoding (Bitcoin compatible).
- *
- * This alphabet excludes characters that can be easily confused:
- * - `0` (zero) and `O` (capital O)
- * - `I` (capital i) and `l` (lowercase L)
- *
- * The alphabet consists of 58 characters: digits 1-9 and letters A-Z, a-z
- * (excluding the ambiguous characters mentioned above).
- *
- * @example
- * ```typescript
- * const char = UUID58_ALPHABET[0]; // "1"
- * const char = UUID58_ALPHABET[9]; // "A"
- * ```
- */
-export declare const UUID58_ALPHABET: string;
-/**
- * @internal
- * The length of the Base58 alphabet as BigInt for encoding/decoding operations.
- * This is exported for internal use but not part of the public API.
- */
-export declare const UUID58_LENGTH: bigint;
-//# sourceMappingURL=alphabet.d.ts.map

package/script/alphabet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alphabet.d.ts","sourceRoot":"","sources":["../src/alphabet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,EAAE,MACgC,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAuC,CAAC"}

package/script/alphabet.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UUID58_LENGTH = exports.UUID58_ALPHABET = void 0;
-/**
- * Character set for Base58 encoding (Bitcoin compatible).
- *
- * This alphabet excludes characters that can be easily confused:
- * - `0` (zero) and `O` (capital O)
- * - `I` (capital i) and `l` (lowercase L)
- *
- * The alphabet consists of 58 characters: digits 1-9 and letters A-Z, a-z
- * (excluding the ambiguous characters mentioned above).
- *
- * @example
- * ```typescript
- * const char = UUID58_ALPHABET[0]; // "1"
- * const char = UUID58_ALPHABET[9]; // "A"
- * ```
- */
-exports.UUID58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
-/**
- * @internal
- * The length of the Base58 alphabet as BigInt for encoding/decoding operations.
- * This is exported for internal use but not part of the public API.
- */
-exports.UUID58_LENGTH = BigInt(exports.UUID58_ALPHABET.length);

package/script/check.d.ts

@@ -1,40 +0,0 @@
-/**
- * Regular expression pattern for validating UUID58 strings.
- *
- * This regex ensures that a string:
- * - Contains exactly 22 characters
- * - Uses only characters from the Base58 alphabet
- *
- * **Note:** This regex does NOT validate that the decoded value fits within
- * 128 bits (UUID size). For complete validation including 128-bit range
- * checking, use {@link isUuid58} instead.
- *
- * @example
- * ```typescript
- * const isValid = UUID58_REGEX.test("XDY9dmBbcMBXqcRvYw8xJ2"); // true
- * const isValid = UUID58_REGEX.test("invalid"); // false
- * const isValid = UUID58_REGEX.test("123"); // false (too short)
- * ```
- */
-export declare const UUID58_REGEX: RegExp;
-/**
- * Checks if a given string is a valid UUID58-encodable string.
- * This function efficiently validates without performing full decoding.
- *
- * A valid UUID58 string must:
- * - Be exactly 22 characters long
- * - Contain only characters from the Base58 alphabet
- * - Decode to a value that fits within 128 bits (UUID size)
- *
- * @param uuid58 - The string to check
- * @returns `true` if the string is a valid UUID58 string, `false` otherwise
- *
- * @example
- * ```typescript
- * isUuid58("XDY9dmBbcMBXqcRvYw8xJ2"); // true
- * isUuid58("invalid"); // false
- * isUuid58("O0lI"); // false (contains invalid characters)
- * ```
- */
-export declare function isUuid58(uuid58: string): boolean;
-//# sourceMappingURL=check.d.ts.map

package/script/check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,EAAE,MAAsC,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/script/check.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UUID58_REGEX = void 0;
-exports.isUuid58 = isUuid58;
-// UUID max value encoded in Base58 (length 22)
-const MAX_UUID58 = "YcVfxkQb6JRzqk5kF2tNLv"; // cspell:disable-line
-/**
- * Regular expression pattern for validating UUID58 strings.
- *
- * This regex ensures that a string:
- * - Contains exactly 22 characters
- * - Uses only characters from the Base58 alphabet
- *
- * **Note:** This regex does NOT validate that the decoded value fits within
- * 128 bits (UUID size). For complete validation including 128-bit range
- * checking, use {@link isUuid58} instead.
- *
- * @example
- * ```typescript
- * const isValid = UUID58_REGEX.test("XDY9dmBbcMBXqcRvYw8xJ2"); // true
- * const isValid = UUID58_REGEX.test("invalid"); // false
- * const isValid = UUID58_REGEX.test("123"); // false (too short)
- * ```
- */
-exports.UUID58_REGEX = /^[1-9A-HJ-NP-Za-km-z]{22}$/u;
-/**
- * Checks if a given string is a valid UUID58-encodable string.
- * This function efficiently validates without performing full decoding.
- *
- * A valid UUID58 string must:
- * - Be exactly 22 characters long
- * - Contain only characters from the Base58 alphabet
- * - Decode to a value that fits within 128 bits (UUID size)
- *
- * @param uuid58 - The string to check
- * @returns `true` if the string is a valid UUID58 string, `false` otherwise
- *
- * @example
- * ```typescript
- * isUuid58("XDY9dmBbcMBXqcRvYw8xJ2"); // true
- * isUuid58("invalid"); // false
- * isUuid58("O0lI"); // false (contains invalid characters)
- * ```
- */
-function isUuid58(uuid58) {
-    return exports.UUID58_REGEX.test(uuid58) && uuid58 <= MAX_UUID58;
-}

package/script/decode.d.ts

@@ -1,37 +0,0 @@
-/**
- * Error thrown when an invalid Base58 string is provided for decoding.
- * This includes strings containing characters not in the Base58 alphabet.
- */
-export declare class Uuid58DecodeError extends Error {
-}
-/**
- * Converts a 22-character Base58-encoded string back to a standard UUID format, but instead of
- * throwing an error for invalid input, it returns an `Uuid58DecodeError`
- * instance.
- *
- * @param uuid58 - The 22-character Base58-encoded UUID string to decode
- * @returns A standard UUID string (lowercase, with hyphens), or an
- *   `Uuid58DecodeError` if the input is not a valid 22-character Base58 string
- * @note This function does not throw; it returns the error object instead.
- *
- * @example
- * ```typescript
- * const uuid = uuid58DecodeSafe("XDY9dmBbcMBXqcRvYw8xJ2"); // returns "f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"
- * const error = uuid58DecodeSafe("invalid"); // returns Uuid58DecodeError
- * ```
- */
-export declare function uuid58DecodeSafe(uuid58: string): string | Uuid58DecodeError;
-/**
- * Converts a 22-character Base58-encoded string back to a standard UUID string format.
- *
- * @param uuid58 - The 22-character Base58-encoded string to decode
- * @returns A standard UUID string in the format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (always in lowercase)
- * @throws {Uuid58DecodeError} If the input string is not a valid 22-character Base58 string
- *
- * @example
- * ```typescript
- * const uuid = uuid58Decode("XDY9dmBbcMBXqcRvYw8xJ2"); // returns "f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"
- * ```
- */
-export declare function uuid58Decode(uuid58: string): string;
-//# sourceMappingURL=decode.d.ts.map

package/script/decode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;CAI3C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAoC3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/script/decode.js

@@ -1,84 +0,0 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Uuid58DecodeError = void 0;
-exports.uuid58DecodeSafe = uuid58DecodeSafe;
-exports.uuid58Decode = uuid58Decode;
-const alphabet_js_1 = require("./alphabet.js");
-// Fast lookup map from alphabet characters to their indices
-const BASE58_MAP = {};
-for (let i = 0; i < alphabet_js_1.UUID58_ALPHABET.length; i++) {
-    BASE58_MAP[alphabet_js_1.UUID58_ALPHABET[i]] = BigInt(i);
-}
-/**
- * Error thrown when an invalid Base58 string is provided for decoding.
- * This includes strings containing characters not in the Base58 alphabet.
- */
-class Uuid58DecodeError extends Error {
-}
-exports.Uuid58DecodeError = Uuid58DecodeError;
-_a = Uuid58DecodeError;
-(() => {
-    _a.prototype.name = "Uuid58DecodeError";
-})();
-/**
- * Converts a 22-character Base58-encoded string back to a standard UUID format, but instead of
- * throwing an error for invalid input, it returns an `Uuid58DecodeError`
- * instance.
- *
- * @param uuid58 - The 22-character Base58-encoded UUID string to decode
- * @returns A standard UUID string (lowercase, with hyphens), or an
- *   `Uuid58DecodeError` if the input is not a valid 22-character Base58 string
- * @note This function does not throw; it returns the error object instead.
- *
- * @example
- * ```typescript
- * const uuid = uuid58DecodeSafe("XDY9dmBbcMBXqcRvYw8xJ2"); // returns "f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"
- * const error = uuid58DecodeSafe("invalid"); // returns Uuid58DecodeError
- * ```
- */
-function uuid58DecodeSafe(uuid58) {
-    if (uuid58.length !== 22) {
-        return new Uuid58DecodeError(`Expected Base58 string of length 22, but received string of length ${uuid58.length}: ${uuid58}`);
-    }
-    let num = 0n;
-    for (const char of uuid58) {
-        const index = BASE58_MAP[char];
-        if (index === undefined) {
-            return new Uuid58DecodeError(`Invalid Base58 character '${char}' found in input: ${uuid58}`);
-        }
-        num = num * alphabet_js_1.UUID58_LENGTH + index;
-    }
-    const hex = num.toString(16).padStart(32, "0");
-    if (hex.length !== 32) {
-        return new Uuid58DecodeError(`Decoded value exceeds 128 bits of UUID: ${uuid58}`);
-    }
-    return (hex.slice(0, 8) +
-        "-" +
-        hex.slice(8, 12) +
-        "-" +
-        hex.slice(12, 16) +
-        "-" +
-        hex.slice(16, 20) +
-        "-" +
-        hex.slice(20));
-}
-/**
- * Converts a 22-character Base58-encoded string back to a standard UUID string format.
- *
- * @param uuid58 - The 22-character Base58-encoded string to decode
- * @returns A standard UUID string in the format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (always in lowercase)
- * @throws {Uuid58DecodeError} If the input string is not a valid 22-character Base58 string
- *
- * @example
- * ```typescript
- * const uuid = uuid58Decode("XDY9dmBbcMBXqcRvYw8xJ2"); // returns "f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"
- * ```
- */
-function uuid58Decode(uuid58) {
-    const result = uuid58DecodeSafe(uuid58);
-    if (result instanceof Uuid58DecodeError) {
-        throw result;
-    }
-    return result;
-}

package/script/encode.d.ts

@@ -1,49 +0,0 @@
-/**
- * Error thrown when an invalid UUID string is provided for encoding.
- * This includes strings that don't match the standard UUID format (32 hexadecimal characters with optional hyphens).
- */
-export declare class Uuid58EncodeError extends Error {
-}
-/**
- * Converts a standard UUID string to a 22-character Base58-encoded format, but instead of
- * throwing an error for invalid input, it returns an `Uuid58EncodeError` instance.
- *
- * @param uuid - The UUID string to encode (with or without hyphens)
- * @returns A 22-character Base58-encoded string, or an `Uuid58EncodeError` if the input is
- *   not a valid UUID
- * @note This function does not throw; it returns the error object instead.
- *
- * @example
- * ```typescript
- * // With hyphens
- * const base58 = uuid58EncodeSafe("f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Without hyphens
- * const base58 = uuid58EncodeSafe("f4b247fd1f8745d4aa061c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Uppercase UUID is also accepted
- * const base58 = uuid58EncodeSafe("F4B247FD-1F87-45D4-AA06-1C6FC0A8DFAF"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Invalid UUID format
- * const error = uuid58EncodeSafe("invalid"); // returns Uuid58EncodeError
- * ```
- */
-export declare function uuid58EncodeSafe(uuid: string): string | Uuid58EncodeError;
-/**
- * Converts a standard UUID string to a 22-character Base58-encoded format.
- *
- * @param uuid - The UUID string to encode. Can be provided with or without hyphens
- *              (format: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" or "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").
- *              The input is case-insensitive, so both uppercase and lowercase hexadecimal characters are accepted.
- * @returns A 22-character Base58-encoded string representation of the UUID
- * @throws {Uuid58EncodeError} If the input string is not a valid UUID format
- *
- * @example
- * ```typescript
- * // With hyphens
- * const base58 = uuid58Encode("f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Without hyphens
- * const base58 = uuid58Encode("f4b247fd1f8745d4aa061c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Uppercase UUID is also accepted
- * const base58 = uuid58Encode("F4B247FD-1F87-45D4-AA06-1C6FC0A8DFAF"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-export declare function uuid58Encode(uuid: string): string;
-//# sourceMappingURL=encode.d.ts.map

package/script/encode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;CAI3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAwBzE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/script/encode.js

@@ -1,84 +0,0 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Uuid58EncodeError = void 0;
-exports.uuid58EncodeSafe = uuid58EncodeSafe;
-exports.uuid58Encode = uuid58Encode;
-const alphabet_js_1 = require("./alphabet.js");
-/**
- * Error thrown when an invalid UUID string is provided for encoding.
- * This includes strings that don't match the standard UUID format (32 hexadecimal characters with optional hyphens).
- */
-class Uuid58EncodeError extends Error {
-}
-exports.Uuid58EncodeError = Uuid58EncodeError;
-_a = Uuid58EncodeError;
-(() => {
-    _a.prototype.name = "Uuid58EncodeError";
-})();
-/**
- * Converts a standard UUID string to a 22-character Base58-encoded format, but instead of
- * throwing an error for invalid input, it returns an `Uuid58EncodeError` instance.
- *
- * @param uuid - The UUID string to encode (with or without hyphens)
- * @returns A 22-character Base58-encoded string, or an `Uuid58EncodeError` if the input is
- *   not a valid UUID
- * @note This function does not throw; it returns the error object instead.
- *
- * @example
- * ```typescript
- * // With hyphens
- * const base58 = uuid58EncodeSafe("f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Without hyphens
- * const base58 = uuid58EncodeSafe("f4b247fd1f8745d4aa061c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Uppercase UUID is also accepted
- * const base58 = uuid58EncodeSafe("F4B247FD-1F87-45D4-AA06-1C6FC0A8DFAF"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Invalid UUID format
- * const error = uuid58EncodeSafe("invalid"); // returns Uuid58EncodeError
- * ```
- */
-function uuid58EncodeSafe(uuid) {
-    const hex = uuid.replace(/-/g, "");
-    if (hex.length !== 32) {
-        return new Uuid58EncodeError(`Invalid UUID length: expected 32 characters (excluding hyphens), got ${hex.length} characters in "${uuid}"`);
-    }
-    let num;
-    try {
-        num = BigInt("0x" + hex);
-    }
-    catch {
-        return new Uuid58EncodeError(`Invalid UUID format: "${uuid}" contains non-hexadecimal characters`);
-    }
-    let encoded = "";
-    do {
-        encoded = alphabet_js_1.UUID58_ALPHABET[Number(num % alphabet_js_1.UUID58_LENGTH)] + encoded;
-        num /= alphabet_js_1.UUID58_LENGTH;
-    } while (num > 0n);
-    return encoded.padStart(22, alphabet_js_1.UUID58_ALPHABET[0]);
-}
-/**
- * Converts a standard UUID string to a 22-character Base58-encoded format.
- *
- * @param uuid - The UUID string to encode. Can be provided with or without hyphens
- *              (format: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" or "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").
- *              The input is case-insensitive, so both uppercase and lowercase hexadecimal characters are accepted.
- * @returns A 22-character Base58-encoded string representation of the UUID
- * @throws {Uuid58EncodeError} If the input string is not a valid UUID format
- *
- * @example
- * ```typescript
- * // With hyphens
- * const base58 = uuid58Encode("f4b247fd-1f87-45d4-aa06-1c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Without hyphens
- * const base58 = uuid58Encode("f4b247fd1f8745d4aa061c6fc0a8dfaf"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * // Uppercase UUID is also accepted
- * const base58 = uuid58Encode("F4B247FD-1F87-45D4-AA06-1C6FC0A8DFAF"); // returns "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-function uuid58Encode(uuid) {
-    const result = uuid58EncodeSafe(uuid);
-    if (result instanceof Uuid58EncodeError) {
-        throw result;
-    }
-    return result;
-}

package/script/generate.d.ts

@@ -1,15 +0,0 @@
-/**
- * Generates a new Base58-encoded UUID (always 22 characters).
- *
- * This function combines the standard UUID generation (using crypto.getRandomValues())
- * with Base58 encoding to create a shorter, URL-safe identifier.
- *
- * @returns A 22-character Base58-encoded string representing a newly generated UUID
- *
- * @example
- * ```typescript
- * const id = uuid58(); // returns a 22-character string like "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-export declare function uuid58(): string;
-//# sourceMappingURL=generate.d.ts.map

package/script/generate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAe/B"}

package/script/generate.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uuid58 = uuid58;
-const alphabet_js_1 = require("./alphabet.js");
-/**
- * Generates a new Base58-encoded UUID (always 22 characters).
- *
- * This function combines the standard UUID generation (using crypto.getRandomValues())
- * with Base58 encoding to create a shorter, URL-safe identifier.
- *
- * @returns A 22-character Base58-encoded string representing a newly generated UUID
- *
- * @example
- * ```typescript
- * const id = uuid58(); // returns a 22-character string like "XDY9dmBbcMBXqcRvYw8xJ2"
- * ```
- */
-function uuid58() {
-    const bytes = crypto.getRandomValues(new BigUint64Array(2));
-    bytes[0] = (bytes[0] & 0xffffffffffff0fffn) | 0x0000000000004000n;
-    bytes[1] = (bytes[1] & 0x3fffffffffffffffn) | 0x8000000000000000n;
-    let num = bytes[0] << 64n | bytes[1];
-    let encoded = "";
-    do {
-        encoded = alphabet_js_1.UUID58_ALPHABET[Number(num % alphabet_js_1.UUID58_LENGTH)] + encoded;
-        num /= alphabet_js_1.UUID58_LENGTH;
-    } while (num > 0n);
-    return encoded.padStart(22, alphabet_js_1.UUID58_ALPHABET[0]);
-}

package/script/index.d.ts

@@ -1,6 +0,0 @@
-export { UUID58_ALPHABET } from "./alphabet.js";
-export * from "./check.js";
-export * from "./decode.js";
-export * from "./encode.js";
-export * from "./generate.js";
-//# sourceMappingURL=index.d.ts.map

package/script/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/script/index.js

@@ -1,23 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UUID58_ALPHABET = void 0;
-var alphabet_js_1 = require("./alphabet.js");
-Object.defineProperty(exports, "UUID58_ALPHABET", { enumerable: true, get: function () { return alphabet_js_1.UUID58_ALPHABET; } });
-__exportStar(require("./check.js"), exports);
-__exportStar(require("./decode.js"), exports);
-__exportStar(require("./encode.js"), exports);
-__exportStar(require("./generate.js"), exports);

package/script/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}