@nr1e/commons 0.3.4 → 0.4.0

package/dist/encryption/api-key.d.mts

@@ -0,0 +1,59 @@
+/**
+ * A generated API key.
+ */
+export interface GeneratedApiKey {
+    /**
+     * The raw key to give to the user. Do not store.
+     */
+    readonly rawKey: string;
+    /**
+     * The ID of the key. This should be used for lookup.
+     */
+    readonly keyId: string;
+    /**
+     * The SHA256 hash of the secret. This should be stored with the keyId.
+     */
+    readonly secretHash: string;
+}
+/**
+ * Generates a new API key with a random ID and secret using SHA256.
+ *
+ * @param prefix - A prefix to add to the key ID and secret. Must be lowercase letters. Default is 'ak'.
+ * @param idLength - Length of the key ID. Default is 12.
+ * @param secretLength - Length of the secret. Default is 32.
+ */
+export declare function generateApiKey(prefix?: string, idLength?: number, secretLength?: number): GeneratedApiKey;
+export interface ParsedApiKey {
+    readonly prefix: string;
+    readonly keyId: string;
+    readonly secret: string;
+}
+/**
+ * Parse and validate raw API key format.
+ */
+export declare function parseApiKey(rawKey: string): ParsedApiKey;
+/**
+ * A stored API key.
+ */
+export interface StoredApiKeyRecord {
+    /**
+     * The ID of the key.
+     */
+    keyId: string;
+    /**
+     * The SHA256 hash of the secret. This should be stored with the keyId.
+     */
+    secretHash: string;
+}
+/**
+ * A function that looks up a stored API key record by key ID.
+ */
+export type ApiKeyLookupFn = (keyId: string) => Promise<StoredApiKeyRecord | null>;
+/**
+ * Verifies an API key secret against a stored hash.
+ *
+ * @param rawKey - The raw API key to verify.
+ * @param lookupFn - The function to use to lookup the stored hash.
+ */
+export declare function verifyApiKey(rawKey: string, lookupFn: ApiKeyLookupFn): Promise<StoredApiKeyRecord | null>;
+//# sourceMappingURL=api-key.d.mts.map

package/dist/encryption/api-key.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.mts","sourceRoot":"","sources":["../../src/encryption/api-key.mts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,MAAa,EACrB,QAAQ,GAAE,MAAW,EACrB,YAAY,GAAE,MAAW,GACxB,eAAe,CAejB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAkBxD;AAkBD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;AAExC;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgBpC"}

package/dist/encryption/api-key.mjs

@@ -0,0 +1,78 @@
+import { nanoid, customAlphabet } from 'nanoid';
+import { createHash, timingSafeEqual } from 'crypto';
+const PREFIX_REGEX = /^[a-z]+$/;
+const ALPHABET = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+/**
+ * Generates a new API key with a random ID and secret using SHA256.
+ *
+ * @param prefix - A prefix to add to the key ID and secret. Must be lowercase letters. Default is 'ak'.
+ * @param idLength - Length of the key ID. Default is 12.
+ * @param secretLength - Length of the secret. Default is 32.
+ */
+export function generateApiKey(prefix = 'ak', idLength = 12, secretLength = 32) {
+    if (!PREFIX_REGEX.test(prefix)) {
+        throw new Error('Prefix must contain only lowercase letters (a-z) and no other characters.');
+    }
+    const keyId = customAlphabet(ALPHABET, idLength)();
+    const secret = nanoid(secretLength);
+    const fullKey = `${prefix}_${keyId}_${secret}`;
+    const secretHash = createHash('sha256').update(secret).digest('hex');
+    return {
+        rawKey: fullKey,
+        keyId,
+        secretHash,
+    };
+}
+/**
+ * Parse and validate raw API key format.
+ */
+export function parseApiKey(rawKey) {
+    const parts = rawKey.split('_');
+    if (parts.length < 3) {
+        throw new Error('Invalid API key format.');
+    }
+    const prefix = parts[0];
+    const keyId = parts[1];
+    const secret = rawKey.substring(prefix.length + keyId.length + 2);
+    if (!PREFIX_REGEX.test(prefix)) {
+        throw new Error('Invalid API key prefix.');
+    }
+    if (!keyId || !secret) {
+        throw new Error('Malformed API key.');
+    }
+    return { prefix, keyId, secret };
+}
+function verifySecret(providedSecret, storedSecretHash) {
+    const providedHash = createHash('sha256').update(providedSecret).digest();
+    const storedHashBuffer = Buffer.from(storedSecretHash, 'hex');
+    // Prevent length mismatch timing leaks
+    if (providedHash.length !== storedHashBuffer.length) {
+        return false;
+    }
+    return timingSafeEqual(providedHash, storedHashBuffer);
+}
+/**
+ * Verifies an API key secret against a stored hash.
+ *
+ * @param rawKey - The raw API key to verify.
+ * @param lookupFn - The function to use to lookup the stored hash.
+ */
+export async function verifyApiKey(rawKey, lookupFn) {
+    let parsed;
+    try {
+        parsed = parseApiKey(rawKey);
+    }
+    catch {
+        return null;
+    }
+    const record = await lookupFn(parsed.keyId);
+    if (!record) {
+        return null;
+    }
+    const valid = verifySecret(parsed.secret, record.secretHash);
+    if (!valid) {
+        return null;
+    }
+    return record;
+}
+//# sourceMappingURL=api-key.mjs.map

package/dist/encryption/api-key.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.mjs","sourceRoot":"","sources":["../../src/encryption/api-key.mts"],"names":[],"mappings":"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"}

package/dist/encryption/api-key.test.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-key.test.d.mts.map

package/dist/encryption/api-key.test.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.test.d.mts","sourceRoot":"","sources":["../../src/encryption/api-key.test.mts"],"names":[],"mappings":""}

package/dist/encryption/api-key.test.mjs

@@ -0,0 +1,75 @@
+import { expect, test } from 'vitest';
+import { generateApiKey, parseApiKey, verifyApiKey, } from './api-key.mjs';
+test('generateApiKey creates valid API key with defaults', () => {
+    const result = generateApiKey();
+    expect(result.rawKey).toMatch(/^ak_[\w-]+_[\w-]+$/);
+    expect(result.keyId).toHaveLength(12);
+    expect(result.secretHash).toMatch(/^[a-f0-9]{64}$/);
+});
+test('generateApiKey accepts custom parameters', () => {
+    const result = generateApiKey('custom', 16, 40);
+    expect(result.rawKey.startsWith('custom_')).toBe(true);
+    expect(result.keyId).toHaveLength(16);
+});
+test('generateApiKey throws error for invalid prefix', () => {
+    expect(() => generateApiKey('AK')).toThrow('Prefix must contain only lowercase letters');
+    expect(() => generateApiKey('ak1')).toThrow('Prefix must contain only lowercase letters');
+});
+test('parseApiKey parses valid API key', () => {
+    const generated = generateApiKey('test', 12, 32);
+    const parsed = parseApiKey(generated.rawKey);
+    expect(parsed.prefix).toBe('test');
+    expect(parsed.keyId).toBe(generated.keyId);
+    expect(parsed.secret).toHaveLength(32);
+});
+test('parseApiKey throws error for invalid format', () => {
+    expect(() => parseApiKey('invalid_format')).toThrow('Invalid API key format.');
+    expect(() => parseApiKey('AK_keyid_secret')).toThrow('Invalid API key prefix.');
+    expect(() => parseApiKey('ak__secret')).toThrow('Malformed API key');
+});
+test('verifyApiKey verifies valid key successfully', async () => {
+    const generated = generateApiKey();
+    const storedRecord = {
+        keyId: generated.keyId,
+        secretHash: generated.secretHash,
+    };
+    const lookupFn = async (keyId) => {
+        return keyId === storedRecord.keyId ? storedRecord : null;
+    };
+    const result = await verifyApiKey(generated.rawKey, lookupFn);
+    expect(result).toEqual(storedRecord);
+});
+test('verifyApiKey returns null for invalid key', async () => {
+    const lookupFn = async () => null;
+    const result = await verifyApiKey('invalid_key_format', lookupFn);
+    expect(result).toBeNull();
+});
+test('verifyApiKey returns null when secret does not match', async () => {
+    const generated = generateApiKey();
+    const storedRecord = {
+        keyId: generated.keyId,
+        secretHash: 'wronghash123456789012345678901234567890123456789012345678901234',
+    };
+    const lookupFn = async () => storedRecord;
+    const result = await verifyApiKey(generated.rawKey, lookupFn);
+    expect(result).toBeNull();
+});
+test('full flow: generate, store, and verify', async () => {
+    // Generate key
+    const generated = generateApiKey('api', 12, 32);
+    console.log(generated.rawKey);
+    // Simulate storage
+    const database = new Map();
+    database.set(generated.keyId, {
+        keyId: generated.keyId,
+        secretHash: generated.secretHash,
+    });
+    // Verify
+    const lookupFn = async (keyId) => {
+        return database.get(keyId) || null;
+    };
+    const verified = await verifyApiKey(generated.rawKey, lookupFn);
+    expect(verified).not.toBeNull();
+    expect(verified?.keyId).toBe(generated.keyId);
+});
+//# sourceMappingURL=api-key.test.mjs.map

package/dist/encryption/api-key.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.test.mjs","sourceRoot":"","sources":["../../src/encryption/api-key.test.mts"],"names":[],"mappings":"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"}

package/dist/encryption/crypto-generator.d.mts

@@ -1,3 +1,2 @@
 export declare function generateId(length?: number): string;
-export declare function generateApiKey(length?: number): string;
 //# sourceMappingURL=crypto-generator.d.mts.map

package/dist/encryption/crypto-generator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-generator.d.mts","sourceRoot":"","sources":["../../src/encryption/crypto-generator.mts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAEtD;AAED,wBAAgB,cAAc,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAE1D"}
+{"version":3,"file":"crypto-generator.d.mts","sourceRoot":"","sources":["../../src/encryption/crypto-generator.mts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAEtD"}

package/dist/encryption/crypto-generator.mjs

@@ -2,7 +2,4 @@ import { randomBytes } from 'crypto';
 export function generateId(length = 16) {
     return randomBytes(length).toString('base64url');
 }
-export function generateApiKey(length = 32) {
-    return randomBytes(length).toString('base64url');
-}
 //# sourceMappingURL=crypto-generator.mjs.map

package/dist/encryption/crypto-generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-generator.mjs","sourceRoot":"","sources":["../../src/encryption/crypto-generator.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,QAAQ,CAAC;AAEnC,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE;IAC5C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE;IAChD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"crypto-generator.mjs","sourceRoot":"","sources":["../../src/encryption/crypto-generator.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,QAAQ,CAAC;AAEnC,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE;IAC5C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC"}

package/dist/encryption/crypto-generator.test.mjs

@@ -1,13 +1,8 @@
 import { test, expect } from 'vitest';
-import { generateApiKey, generateId } from './crypto-generator.mjs';
+import { generateId } from './crypto-generator.mjs';
 test('generateId', () => {
     const id = generateId();
     console.log(id);
     expect(id.length).toBe(22);
 });
-test('Test generateApiKey', () => {
-    const apiKey = generateApiKey();
-    console.log(apiKey);
-    expect(apiKey).toBeDefined();
-}, 10000);
 //# sourceMappingURL=crypto-generator.test.mjs.map

package/dist/encryption/crypto-generator.test.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-generator.test.mjs","sourceRoot":"","sources":["../../src/encryption/crypto-generator.test.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,MAAM,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAC,cAAc,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAElE,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;IACtB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;IAC/B,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/B,CAAC,EAAE,KAAK,CAAC,CAAC"}
+{"version":3,"file":"crypto-generator.test.mjs","sourceRoot":"","sources":["../../src/encryption/crypto-generator.test.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,MAAM,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAElD,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;IACtB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC"}

package/dist/encryption/encryption.d.mts

@@ -1,11 +1,9 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 export declare function localEncrypt(val: object, key: Buffer | string): string;
 export declare function localDecrypt(encrypted: string, key: Buffer | string): any;
-export declare function generateKey(size?: number): Buffer;
+export declare function generateKey(size?: number): NonSharedBuffer;
 export declare function generateEncodedKey(size?: number): string;
-export declare function generateIV(size?: number): Buffer;
+export declare function generateIV(size?: number): NonSharedBuffer;
 export declare function generateEncodedIV(size?: number): string;
-export declare function decodeKey(encodedKey: string): Buffer;
-export declare function decodeIV(encodedIV: string): Buffer;
+export declare function decodeKey(encodedKey: string): Buffer<ArrayBuffer>;
+export declare function decodeIV(encodedIV: string): Buffer<ArrayBuffer>;
 //# sourceMappingURL=encryption.d.mts.map

package/dist/encryption/encryption.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"encryption.d.mts","sourceRoot":"","sources":["../../src/encryption/encryption.mts"],"names":[],"mappings":";;AAMA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,UAS7D;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,OAanE;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,UAExC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,UAE/C;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,UAEvC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,UAE9C;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,UAE3C;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,UAEzC"}
+{"version":3,"file":"encryption.d.mts","sourceRoot":"","sources":["../../src/encryption/encryption.mts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,UAS7D;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,OAanE;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,mBAExC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,UAE/C;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,mBAEvC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,UAE9C;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,uBAE3C;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,uBAEzC"}

package/dist/encryption/index.d.mts

@@ -1,3 +1,4 @@
+export * from './api-key.mjs';
 export * from './crypto-generator.mjs';
 export * from './encryption.mjs';
 export * from './rsa-encryption.mjs';

package/dist/encryption/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/encryption/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/encryption/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/encryption/index.mjs

@@ -1,3 +1,4 @@
+export * from './api-key.mjs';
 export * from './crypto-generator.mjs';
 export * from './encryption.mjs';
 export * from './rsa-encryption.mjs';

package/dist/encryption/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/encryption/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/encryption/index.mts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/encryption/rsa-encryption.browser.d.mts

@@ -2,7 +2,6 @@
  * Browser-compatible RSA encryption using Web Crypto API
  * This module provides RSA encryption functionality that works in browsers
  */
-/// <reference types="node" resolution-mode="require"/>
 export type KeyFormat = 'pem' | 'base64';
 export interface EncryptionOptions {
     encoding?: BufferEncoding;

package/dist/encryption/rsa-encryption.browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"rsa-encryption.browser.d.mts","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.browser.mts"],"names":[],"mappings":"AAAA;;;GAGG;;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0DD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EAEjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,QAAQ,GAAG,SAAoB,GACpC,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C"}
+{"version":3,"file":"rsa-encryption.browser.d.mts","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.browser.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0DD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EAEjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,QAAQ,GAAG,SAAoB,GACpC,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C"}

package/dist/encryption/rsa-encryption.d.mts

@@ -1,5 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import { KeyObject } from 'crypto';
 export type KeySize = 2048 | 3072 | 4096;
 export type KeyFormat = 'pem' | 'base64';

package/dist/encryption/rsa-encryption.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"rsa-encryption.d.mts","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.mts"],"names":[],"mappings":";;AAAA,OAAO,EAML,SAAS,EAGV,MAAM,QAAQ,CAAC;AAKhB,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAoDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,sBAA2B,GACnC,UAAU,CAuBZ;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAqBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,GAAG,MAAM,CA8BjB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAiB7E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsB9C"}
+{"version":3,"file":"rsa-encryption.d.mts","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.mts"],"names":[],"mappings":"AAAA,OAAO,EAML,SAAS,EAGV,MAAM,QAAQ,CAAC;AAKhB,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAoDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,sBAA2B,GACnC,UAAU,CAuBZ;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAqBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,GAAG,MAAM,CA8BjB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAiB7E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsB9C"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nr1e/commons",
   "description": "Common utilities for TypeScript projects",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "type": "module",
   "author": "NR1E, Inc.",
   "publishConfig": {
@@ -16,19 +16,18 @@
     "dist"
   ],
   "devDependencies": {
-    "@eslint/js": "latest",
-    "@types/node": "^25.2.0",
-    "@types/uuid": "^10.0.0",
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^24.10.13",
     "eslint": "9.39.2",
     "prettier": "3.8.1",
-    "typescript": "5.4.5",
-    "typescript-eslint": "8.38.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.56.0",
     "vitest": "4.0.18"
   },
   "dependencies": {
-    "tslib": "^2.8.1",
-    "uuid": "^11.0.5",
-    "ksuid": "3.0.0"
+    "ksuid": "3.0.0",
+    "nanoid": "^5.1.6",
+    "uuid": "^13.0.0"
   },
   "exports": {
     "./bitsnbytes": {