@synet/keys/dist/utils.js

Zero-dependency, secure key generation library. Supports ed25519, x25519, secp256k1, RSA, and WireGuard keys.

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.createId = createId;
exports.base64ToBase64Url = base64ToBase64Url;
exports.base64UrlToBase64 = base64UrlToBase64;
const node_crypto_1 = require("node:crypto");
/**
 * Generate a CUID2-like identifier using Node.js crypto
 *
 * This is a simplified, zero-dependency implementation of CUID2 concepts:
 * - Uses native Node.js crypto instead of @noble/hashes
 * - Maintains similar structure: letter + hash of (time + entropy + counter)
 * - Provides collision-resistant, sortable, URL-safe IDs
 *
 * @param length - Length of the generated ID (default: 24)
 * @returns A CUID2-like identifier string
 */
function createId(length = 24) {
    // Start with a random letter (a-z) 
    const firstLetter = String.fromCharCode(97 + Math.floor(Math.random() * 26));
    // Create entropy components
    const time = Date.now().toString(36);
    const entropy = (0, node_crypto_1.randomBytes)(8).toString('hex');
    const counter = Math.floor(Math.random() * 0xFFFFFF).toString(36);
    // Combine and hash
    const input = `${time}${entropy}${counter}`;
    const hash = (0, node_crypto_1.createHash)('sha3-512').update(input).digest('hex');
    // Convert to base36 and take required length
    const hashBigInt = BigInt(`0x${hash}`);
    const base36Hash = hashBigInt.toString(36);
    // Combine first letter with hash, ensuring we get the right length
    return (firstLetter + base36Hash).substring(0, length);
}
/**
 * Convert base64 to base64url encoding
 * base64url is the URL-safe variant of base64 used in JWTs
 *
 * @param base64 - Standard base64 encoded string
 * @returns base64url encoded string
 */
function base64ToBase64Url(base64) {
    return base64
        .replace(/\+/g, '-')
        .replace(/\//g, '_')
        .replace(/=/g, '');
}
/**
 * Convert base64url to base64 encoding
 * Converts JWT-style base64url back to standard base64
 *
 * @param base64url - base64url encoded string
 * @returns Standard base64 encoded string
 */
function base64UrlToBase64(base64url) {
    let base64 = base64url
        .replace(/-/g, '+')
        .replace(/_/g, '/');
    // Add padding if needed
    while (base64.length % 4) {
        base64 += '=';
    }
    return base64;
}