@doist/comms-sdk 2.0.2 → 3.0.1

package/dist/cjs/utils/uuidv7.js

@@ -1,182 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UuidV7Error = void 0;
-exports.encodeUuidToBase58 = encodeUuidToBase58;
-exports.decodeBase58ToUuidBytes = decodeBase58ToUuidBytes;
-exports.generateId = generateId;
-exports.resolveReferenceId = resolveReferenceId;
-exports.resolveCreateId = resolveCreateId;
-exports.isValidUuidV7Base58 = isValidUuidV7Base58;
-exports.base58FromUuidString = base58FromUuidString;
-exports.uuidStringFromBase58 = uuidStringFromBase58;
-const uuid_1 = require("uuid");
-/**
- * ID utilities for entities that use opaque string identifiers (channels,
- * threads, comments, conversations, messages, groups).
- *
- * Use {@link generateId} to mint a new ID locally and pass it to a creation
- * endpoint. {@link encodeUuidToBase58} / {@link decodeBase58ToUuidBytes}
- * expose the underlying encoding for callers that need to round-trip raw
- * UUID bytes themselves.
- */
-const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
-const BASE58_MAP = (() => {
-    const map = {};
-    for (let i = 0; i < BASE58_ALPHABET.length; i++) {
-        map[BASE58_ALPHABET[i]] = i;
-    }
-    return map;
-})();
-const UUID_BYTES_LEN = 16;
-const UUID_BASE58_MAX_LEN = 22;
-const HEX_RE = /^[0-9a-f]+$/;
-class UuidV7Error extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'UuidV7Error';
-    }
-}
-exports.UuidV7Error = UuidV7Error;
-/** Encode a 16-byte UUID as a base58 string. */
-function encodeUuidToBase58(bytes) {
-    if (bytes.length !== UUID_BYTES_LEN) {
-        throw new UuidV7Error(`id must be ${UUID_BYTES_LEN} bytes`);
-    }
-    let zeros = 0;
-    while (zeros < bytes.length && bytes[zeros] === 0) {
-        zeros++;
-    }
-    let n = 0n;
-    for (const b of bytes) {
-        n = (n << 8n) | BigInt(b);
-    }
-    let out = '';
-    while (n > 0n) {
-        const rem = Number(n % 58n);
-        out = BASE58_ALPHABET[rem] + out;
-        n /= 58n;
-    }
-    return '1'.repeat(zeros) + out;
-}
-/**
- * Decode a base58 string back into 16 UUID bytes. Throws {@link UuidV7Error}
- * if the input is malformed or doesn't decode to exactly 16 bytes.
- */
-function decodeBase58ToUuidBytes(value) {
-    if (typeof value !== 'string') {
-        throw new UuidV7Error('id must be a base58 string');
-    }
-    if (value.length === 0) {
-        throw new UuidV7Error('id is empty');
-    }
-    if (value.length > UUID_BASE58_MAX_LEN) {
-        throw new UuidV7Error('id is too long');
-    }
-    let zeros = 0;
-    while (zeros < value.length && value[zeros] === '1') {
-        zeros++;
-    }
-    let n = 0n;
-    for (let i = 0; i < value.length; i++) {
-        const ch = value[i];
-        const v = BASE58_MAP[ch];
-        if (v === undefined) {
-            throw new UuidV7Error(`invalid base58 character: '${ch}'`);
-        }
-        n = n * 58n + BigInt(v);
-    }
-    const raw = [];
-    while (n > 0n) {
-        raw.unshift(Number(n & 0xffn));
-        n >>= 8n;
-    }
-    const padded = new Uint8Array(zeros + raw.length);
-    padded.set(raw, zeros);
-    if (padded.length !== UUID_BYTES_LEN) {
-        throw new UuidV7Error(`id must decode to ${UUID_BYTES_LEN} bytes`);
-    }
-    return padded;
-}
-function hexToBytes(hex) {
-    const out = new Uint8Array(hex.length / 2);
-    for (let i = 0; i < out.length; i++) {
-        out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-    }
-    return out;
-}
-/**
- * Mint a fresh ID. Callers should generate one of these locally when
- * creating a new channel / thread / comment / conversation / message /
- * group — the backend requires the client to supply the ID on create.
- */
-function generateId() {
-    const hex = (0, uuid_1.v7)().replace(/-/g, '');
-    return encodeUuidToBase58(hexToBytes(hex));
-}
-/** Validate an existing entity ID without minting a replacement. */
-function resolveReferenceId(id, fieldName) {
-    if (!isValidUuidV7Base58(id)) {
-        throw new UuidV7Error(`invalid ${fieldName} ${JSON.stringify(id)} — use a base58 UUIDv7 value for \`${fieldName}\`.`);
-    }
-    return id;
-}
-/**
- * Resolve the `id` for a create-style API call: validate the caller-supplied
- * value (throwing {@link UuidV7Error} before the request leaves the SDK) or
- * mint a fresh one via {@link generateId}.
- */
-function resolveCreateId(id) {
-    if (id === undefined)
-        return generateId();
-    if (!isValidUuidV7Base58(id)) {
-        throw new UuidV7Error(`invalid id ${JSON.stringify(id)} — use generateId() or omit \`id\` and let the SDK mint one.`);
-    }
-    return id;
-}
-/**
- * Validate that a value matches the expected ID format (the decoded bytes
- * have the v7 version nibble + RFC 4122/9562 variant bits). Does NOT
- * validate the embedded timestamp — the backend may still reject a value
- * that is too far in the future or past.
- */
-function isValidUuidV7Base58(value) {
-    if (typeof value !== 'string')
-        return false;
-    let bytes;
-    try {
-        bytes = decodeBase58ToUuidBytes(value);
-    }
-    catch {
-        return false;
-    }
-    const versionNibble = bytes[6] & 0xf0;
-    const variantBits = bytes[8] & 0xc0;
-    return versionNibble === 0x70 && variantBits === 0x80;
-}
-/**
- * Encode a canonical UUID string (hyphenated or not, any case) as a
- * wire-format ID. Useful when interoperating with systems that hand you
- * UUIDs in canonical form.
- */
-function base58FromUuidString(uuid) {
-    const stripped = uuid.replace(/-/g, '').toLowerCase();
-    if (stripped.length !== 32 || !HEX_RE.test(stripped)) {
-        throw new UuidV7Error('not a valid UUID string');
-    }
-    return encodeUuidToBase58(hexToBytes(stripped));
-}
-/**
- * Inverse of {@link base58FromUuidString}: takes a wire-format ID and
- * returns the canonical hyphenated UUID string.
- */
-function uuidStringFromBase58(value) {
-    const bytes = decodeBase58ToUuidBytes(value);
-    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
-    return [
-        hex.slice(0, 8),
-        hex.slice(8, 12),
-        hex.slice(12, 16),
-        hex.slice(16, 20),
-        hex.slice(20, 32),
-    ].join('-');
-}