raffel 0.1.2

package/dist/utils/id/entropy.js

@@ -0,0 +1,154 @@
+/**
+ * Entropy Pool and Random Generation
+ *
+ * Provides cryptographically secure random generation with:
+ * - Pre-allocated entropy pool for performance
+ * - Rejection sampling for zero modulo bias
+ * - Efficient batch generation
+ */
+import { randomFillSync } from 'node:crypto';
+const DEFAULT_POOL_SIZE = 2048;
+const MIN_POOL_SIZE = 256;
+let pool;
+let poolOffset = 0;
+/**
+ * Initialize or resize the entropy pool.
+ * Uses a pre-allocated buffer to reduce GC pressure and improve performance.
+ */
+export function initPool(size = DEFAULT_POOL_SIZE) {
+    const actualSize = Math.max(size, MIN_POOL_SIZE);
+    pool = new Uint8Array(actualSize);
+    randomFillSync(pool);
+    poolOffset = 0;
+}
+/**
+ * Get cryptographically secure random bytes from the pool.
+ * Automatically refills the pool when exhausted.
+ */
+export function getRandomBytes(count) {
+    if (!pool) {
+        initPool();
+    }
+    if (count > pool.length) {
+        const bytes = new Uint8Array(count);
+        randomFillSync(bytes);
+        return bytes;
+    }
+    if (poolOffset + count > pool.length) {
+        randomFillSync(pool);
+        poolOffset = 0;
+    }
+    const bytes = pool.slice(poolOffset, poolOffset + count);
+    poolOffset += count;
+    return bytes;
+}
+/**
+ * Fill a pre-allocated buffer with random bytes.
+ * More efficient than getRandomBytes when you already have a buffer.
+ */
+export function fillRandomBytes(buffer) {
+    if (!pool) {
+        initPool();
+    }
+    const needed = buffer.length;
+    if (poolOffset + needed <= pool.length) {
+        buffer.set(pool.subarray(poolOffset, poolOffset + needed));
+        poolOffset += needed;
+    }
+    else {
+        const remaining = pool.length - poolOffset;
+        if (remaining > 0) {
+            buffer.set(pool.subarray(poolOffset, pool.length), 0);
+        }
+        randomFillSync(pool);
+        poolOffset = 0;
+        buffer.set(pool.subarray(0, needed - remaining), remaining);
+        poolOffset = needed - remaining;
+    }
+    return buffer;
+}
+/**
+ * Generate multiple unbiased random indices efficiently.
+ * Pre-calculates rejection threshold and batches random byte generation.
+ *
+ * Uses rejection sampling to eliminate modulo bias for non-power-of-2
+ * alphabet sizes.
+ */
+export function randomIndicesUnbiased(alphabetSize, count) {
+    if (alphabetSize <= 0 || alphabetSize > 65536) {
+        throw new Error(`Invalid alphabet size: ${alphabetSize}. Must be 1-65536.`);
+    }
+    const result = new Uint16Array(count);
+    if (alphabetSize === 1) {
+        return result;
+    }
+    if (alphabetSize <= 256) {
+        const threshold = 256 - (256 % alphabetSize);
+        const estimatedBytes = Math.ceil(count * (256 / threshold) * 1.1);
+        let bytes = getRandomBytes(Math.max(estimatedBytes, count * 2));
+        let byteIndex = 0;
+        let resultIndex = 0;
+        while (resultIndex < count) {
+            if (byteIndex >= bytes.length) {
+                const extraBytes = getRandomBytes(Math.max(16, (count - resultIndex) * 2));
+                const newBytes = new Uint8Array(bytes.length + extraBytes.length);
+                newBytes.set(bytes);
+                newBytes.set(extraBytes, bytes.length);
+                bytes = newBytes;
+                byteIndex = 0;
+            }
+            const byte = bytes[byteIndex++];
+            if (byte < threshold) {
+                result[resultIndex++] = byte % alphabetSize;
+            }
+        }
+        return result;
+    }
+    const threshold = 65536 - (65536 % alphabetSize);
+    const estimatedBytes = Math.ceil(count * 2 * (65536 / threshold) * 1.1);
+    let bytes = getRandomBytes(Math.max(estimatedBytes, count * 4));
+    let byteIndex = 0;
+    let resultIndex = 0;
+    while (resultIndex < count) {
+        if (byteIndex + 1 >= bytes.length) {
+            const extraBytes = getRandomBytes(Math.max(32, (count - resultIndex) * 4));
+            const newBytes = new Uint8Array(bytes.length + extraBytes.length);
+            newBytes.set(bytes);
+            newBytes.set(extraBytes, bytes.length);
+            bytes = newBytes;
+        }
+        const value = (bytes[byteIndex] << 8) | bytes[byteIndex + 1];
+        byteIndex += 2;
+        if (value < threshold) {
+            result[resultIndex++] = value % alphabetSize;
+        }
+    }
+    return result;
+}
+/**
+ * Generate a string from an alphabet using unbiased random selection.
+ * This is the core function for generating IDs.
+ */
+export function randomString(alphabet, length) {
+    const alphabetSize = alphabet.length;
+    const indices = randomIndicesUnbiased(alphabetSize, length);
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += alphabet[indices[i]];
+    }
+    return result;
+}
+/**
+ * Calculate the entropy bits for a given alphabet size and ID length.
+ */
+export function calculateEntropyBits(alphabetSize, length) {
+    return Math.log2(alphabetSize) * length;
+}
+/**
+ * Reset the entropy pool (useful for testing).
+ */
+export function resetPool() {
+    pool = undefined;
+    poolOffset = 0;
+}
+//# sourceMappingURL=entropy.js.map

package/dist/utils/id/entropy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entropy.js","sourceRoot":"","sources":["../../../src/utils/id/entropy.ts"],"names":[],"mappings":"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"}

package/dist/utils/id/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ID Generation Utilities
+ *
+ * Zero-dependency ID generation with:
+ * - Cryptographically secure randomness
+ * - True uniform distribution (zero modulo bias)
+ * - Multiple alphabet support
+ * - High performance via entropy pooling
+ */
+export { sid, customAlphabet, customAlphabetByName, sidWithOptions, sidEntropyBits, urlAlphabet, } from './sid.js';
+export type { SidOptions } from './sid.js';
+export { URL_SAFE, ALPHANUMERIC, ALPHANUMERIC_LOWER, HEX_LOWER, HEX_UPPER, BASE58, NUMERIC, alphabets, getAlphabet, validateAlphabet, } from './alphabets.js';
+export type { AlphabetName } from './alphabets.js';
+export { randomString, calculateEntropyBits, getRandomBytes, resetPool, } from './entropy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/id/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,GAAG,EACH,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,SAAS,GACV,MAAM,cAAc,CAAA"}

package/dist/utils/id/index.js

@@ -0,0 +1,13 @@
+/**
+ * ID Generation Utilities
+ *
+ * Zero-dependency ID generation with:
+ * - Cryptographically secure randomness
+ * - True uniform distribution (zero modulo bias)
+ * - Multiple alphabet support
+ * - High performance via entropy pooling
+ */
+export { sid, customAlphabet, customAlphabetByName, sidWithOptions, sidEntropyBits, urlAlphabet, } from './sid.js';
+export { URL_SAFE, ALPHANUMERIC, ALPHANUMERIC_LOWER, HEX_LOWER, HEX_UPPER, BASE58, NUMERIC, alphabets, getAlphabet, validateAlphabet, } from './alphabets.js';
+export { randomString, calculateEntropyBits, getRandomBytes, resetPool, } from './entropy.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/id/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/id/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,GAAG,EACH,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AAIjB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AAIvB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,SAAS,GACV,MAAM,cAAc,CAAA"}

package/dist/utils/id/sid.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SID - Short Unique ID Generator
+ *
+ * A replacement for nanoid with:
+ * - Zero external dependencies
+ * - True uniform distribution via rejection sampling
+ * - Pre-allocated entropy pool for performance
+ * - Multiple alphabet support
+ *
+ * Default: 21 characters using URL-safe alphabet (126 bits of entropy).
+ */
+export interface SidOptions {
+    alphabet?: string;
+    size?: number;
+}
+/**
+ * Generate a short unique ID.
+ * Default: 21 characters using URL-safe alphabet (126 bits of entropy).
+ *
+ * Uses rejection sampling for true uniform distribution (zero modulo bias).
+ *
+ * @example
+ * ```typescript
+ * import { sid } from 'raffel'
+ *
+ * const id = sid()        // 'V1StGXR8_Z5jdHi6B-myT'
+ * const short = sid(10)   // 'IRFa-VaY2b'
+ * ```
+ */
+export declare function sid(size?: number): string;
+/**
+ * Create a custom sid generator with specified alphabet.
+ * Returns a function that generates IDs with that alphabet.
+ *
+ * @example
+ * ```typescript
+ * import { customAlphabet } from 'raffel'
+ *
+ * const numericId = customAlphabet('0123456789', 12)
+ * const id = numericId() // '839146257301'
+ * ```
+ */
+export declare function customAlphabet(alphabet: string, defaultSize?: number): (size?: number) => string;
+/**
+ * Create a custom sid generator with alphabet name.
+ * Supports: URL_SAFE, ALPHANUMERIC, BASE58, HEX_LOWER, etc.
+ *
+ * @example
+ * ```typescript
+ * import { customAlphabetByName } from 'raffel'
+ *
+ * const hexId = customAlphabetByName('HEX_LOWER', 32)
+ * const id = hexId() // 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4'
+ * ```
+ */
+export declare function customAlphabetByName(name: string, defaultSize?: number): (size?: number) => string;
+/**
+ * Generate a sid with options object.
+ *
+ * @example
+ * ```typescript
+ * import { sidWithOptions } from 'raffel'
+ *
+ * const id = sidWithOptions({ size: 16 })
+ * const hex = sidWithOptions({ alphabet: 'HEX_LOWER', size: 32 })
+ * ```
+ */
+export declare function sidWithOptions(options?: SidOptions): string;
+/**
+ * Calculate entropy bits for a sid configuration.
+ *
+ * @example
+ * ```typescript
+ * import { sidEntropyBits } from 'raffel'
+ *
+ * const bits = sidEntropyBits()  // 126 (default: 21 chars * 6 bits)
+ * const hexBits = sidEntropyBits('HEX_LOWER', 32)  // 128
+ * ```
+ */
+export declare function sidEntropyBits(alphabet?: string, size?: number): number;
+/**
+ * URL-safe alphabet constant.
+ */
+export declare const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+export default sid;
+//# sourceMappingURL=sid.d.ts.map

package/dist/utils/id/sid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sid.d.ts","sourceRoot":"","sources":["../../../src/utils/id/sid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAqB,GACjC,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAS3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,MAAqB,GACjC,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAG3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,UAAe,GAAG,MAAM,CAU/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,GAAE,MAAiB,EAC3B,IAAI,GAAE,MAAqB,GAC1B,MAAM,CAGR;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,qEAAW,CAAA;AAEnC,eAAe,GAAG,CAAA"}

package/dist/utils/id/sid.js

@@ -0,0 +1,109 @@
+/**
+ * SID - Short Unique ID Generator
+ *
+ * A replacement for nanoid with:
+ * - Zero external dependencies
+ * - True uniform distribution via rejection sampling
+ * - Pre-allocated entropy pool for performance
+ * - Multiple alphabet support
+ *
+ * Default: 21 characters using URL-safe alphabet (126 bits of entropy).
+ */
+import { randomString, calculateEntropyBits } from './entropy.js';
+import { URL_SAFE, getAlphabet, validateAlphabet } from './alphabets.js';
+const DEFAULT_SIZE = 21;
+/**
+ * Generate a short unique ID.
+ * Default: 21 characters using URL-safe alphabet (126 bits of entropy).
+ *
+ * Uses rejection sampling for true uniform distribution (zero modulo bias).
+ *
+ * @example
+ * ```typescript
+ * import { sid } from 'raffel'
+ *
+ * const id = sid()        // 'V1StGXR8_Z5jdHi6B-myT'
+ * const short = sid(10)   // 'IRFa-VaY2b'
+ * ```
+ */
+export function sid(size = DEFAULT_SIZE) {
+    return randomString(URL_SAFE, size);
+}
+/**
+ * Create a custom sid generator with specified alphabet.
+ * Returns a function that generates IDs with that alphabet.
+ *
+ * @example
+ * ```typescript
+ * import { customAlphabet } from 'raffel'
+ *
+ * const numericId = customAlphabet('0123456789', 12)
+ * const id = numericId() // '839146257301'
+ * ```
+ */
+export function customAlphabet(alphabet, defaultSize = DEFAULT_SIZE) {
+    const error = validateAlphabet(alphabet);
+    if (error) {
+        throw new Error(`Invalid alphabet: ${error}`);
+    }
+    return (size = defaultSize) => {
+        return randomString(alphabet, size);
+    };
+}
+/**
+ * Create a custom sid generator with alphabet name.
+ * Supports: URL_SAFE, ALPHANUMERIC, BASE58, HEX_LOWER, etc.
+ *
+ * @example
+ * ```typescript
+ * import { customAlphabetByName } from 'raffel'
+ *
+ * const hexId = customAlphabetByName('HEX_LOWER', 32)
+ * const id = hexId() // 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4'
+ * ```
+ */
+export function customAlphabetByName(name, defaultSize = DEFAULT_SIZE) {
+    const alphabet = getAlphabet(name);
+    return customAlphabet(alphabet, defaultSize);
+}
+/**
+ * Generate a sid with options object.
+ *
+ * @example
+ * ```typescript
+ * import { sidWithOptions } from 'raffel'
+ *
+ * const id = sidWithOptions({ size: 16 })
+ * const hex = sidWithOptions({ alphabet: 'HEX_LOWER', size: 32 })
+ * ```
+ */
+export function sidWithOptions(options = {}) {
+    const { alphabet = URL_SAFE, size = DEFAULT_SIZE } = options;
+    const resolvedAlphabet = getAlphabet(alphabet);
+    const error = validateAlphabet(resolvedAlphabet);
+    if (error) {
+        throw new Error(`Invalid alphabet: ${error}`);
+    }
+    return randomString(resolvedAlphabet, size);
+}
+/**
+ * Calculate entropy bits for a sid configuration.
+ *
+ * @example
+ * ```typescript
+ * import { sidEntropyBits } from 'raffel'
+ *
+ * const bits = sidEntropyBits()  // 126 (default: 21 chars * 6 bits)
+ * const hexBits = sidEntropyBits('HEX_LOWER', 32)  // 128
+ * ```
+ */
+export function sidEntropyBits(alphabet = URL_SAFE, size = DEFAULT_SIZE) {
+    const resolvedAlphabet = getAlphabet(alphabet);
+    return calculateEntropyBits(resolvedAlphabet.length, size);
+}
+/**
+ * URL-safe alphabet constant.
+ */
+export const urlAlphabet = URL_SAFE;
+export default sid;
+//# sourceMappingURL=sid.js.map

package/dist/utils/id/sid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sid.js","sourceRoot":"","sources":["../../../src/utils/id/sid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAExE,MAAM,YAAY,GAAG,EAAE,CAAA;AAOvB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,YAAY;IAC7C,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,cAAsB,YAAY;IAElC,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACxC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,CAAC,OAAe,WAAW,EAAU,EAAE;QAC5C,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,cAAsB,YAAY;IAElC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAClC,OAAO,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;AAC9C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,UAAsB,EAAE;IACrD,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,GAAG,YAAY,EAAE,GAAG,OAAO,CAAA;IAC5D,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IAE9C,MAAM,KAAK,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAA;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,QAAQ,EAC3B,OAAe,YAAY;IAE3B,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9C,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAA;AAEnC,eAAe,GAAG,CAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Raffel Utilities
+ */
+export { sid, customAlphabet, customAlphabetByName, sidWithOptions, sidEntropyBits, urlAlphabet, URL_SAFE, ALPHANUMERIC, ALPHANUMERIC_LOWER, HEX_LOWER, HEX_UPPER, BASE58, NUMERIC, alphabets, getAlphabet, validateAlphabet, randomString, calculateEntropyBits, } from './id/index.js';
+export type { SidOptions, AlphabetName } from './id/index.js';
+export { createLogger } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,GAAG,EACH,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAA;AAEtB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Raffel Utilities
+ */
+// ID Generation
+export { sid, customAlphabet, customAlphabetByName, sidWithOptions, sidEntropyBits, urlAlphabet, URL_SAFE, ALPHANUMERIC, ALPHANUMERIC_LOWER, HEX_LOWER, HEX_UPPER, BASE58, NUMERIC, alphabets, getAlphabet, validateAlphabet, randomString, calculateEntropyBits, } from './id/index.js';
+// Logger
+export { createLogger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gBAAgB;AAChB,OAAO,EACL,GAAG,EACH,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,GACrB,MAAM,eAAe,CAAA;AAItB,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Logger Utility
+ *
+ * Simple logger using pino with pretty-print in development.
+ */
+import pino from 'pino';
+/**
+ * Create a child logger with a component name
+ */
+export declare function createLogger(component: string): pino.Logger;
+/**
+ * Get the base logger
+ */
+export declare function getLogger(): pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAA;AAqBvB;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAAC,MAAM,CAEvC"}

package/dist/utils/logger.js

@@ -0,0 +1,36 @@
+/**
+ * Logger Utility
+ *
+ * Simple logger using pino with pretty-print in development.
+ */
+import pino from 'pino';
+const isDev = process.env.NODE_ENV !== 'production';
+/**
+ * Base logger instance
+ */
+const baseLogger = pino({
+    level: process.env.LOG_LEVEL ?? (isDev ? 'debug' : 'info'),
+    transport: isDev
+        ? {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: 'SYS:standard',
+                ignore: 'pid,hostname',
+            },
+        }
+        : undefined,
+});
+/**
+ * Create a child logger with a component name
+ */
+export function createLogger(component) {
+    return baseLogger.child({ component });
+}
+/**
+ * Get the base logger
+ */
+export function getLogger() {
+    return baseLogger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;AAEnD;;GAEG;AACH,MAAM,UAAU,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,SAAS,EAAE,KAAK;QACd,CAAC,CAAC;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,cAAc;aACvB;SACF;QACH,CAAC,CAAC,SAAS;CACd,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/validation/adapters/ajv.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Ajv (JSON Schema) Validator Adapter
+ *
+ * User must install ajv as a peer dependency.
+ *
+ * Usage:
+ * ```typescript
+ * import Ajv from 'ajv'
+ * import { createAjvAdapter, registerValidator } from 'raffel'
+ *
+ * const ajv = new Ajv({ allErrors: true })
+ * registerValidator(createAjvAdapter(ajv))
+ * ```
+ */
+import type { ValidatorAdapter, ValidationErrorDetails } from '../types.js';
+interface AjvError {
+    instancePath: string;
+    message?: string;
+    keyword: string;
+    params: Record<string, unknown>;
+    schemaPath: string;
+}
+/**
+ * Convert Ajv errors to validation error details
+ */
+declare function ajvErrorToDetails(errors: AjvError[] | null | undefined): ValidationErrorDetails[];
+/**
+ * Create an Ajv (JSON Schema) validator adapter
+ *
+ * @param ajv - An Ajv instance (new Ajv({ allErrors: true }))
+ *
+ * @example
+ * ```typescript
+ * import Ajv from 'ajv'
+ * import addFormats from 'ajv-formats'
+ * import { createAjvAdapter, registerValidator } from 'raffel'
+ *
+ * const ajv = new Ajv({ allErrors: true })
+ * addFormats(ajv) // Optional: adds format validation (email, uri, etc.)
+ *
+ * registerValidator(createAjvAdapter(ajv))
+ *
+ * // Define schema (standard JSON Schema)
+ * const schema = {
+ *   type: 'object',
+ *   properties: {
+ *     name: { type: 'string', minLength: 1 },
+ *     email: { type: 'string', format: 'email' },
+ *   },
+ *   required: ['name', 'email'],
+ * }
+ * ```
+ */
+export declare function createAjvAdapter(ajv: unknown): ValidatorAdapter;
+/**
+ * Re-export error converter for users who need it
+ */
+export { ajvErrorToDetails };
+//# sourceMappingURL=ajv.d.ts.map

package/dist/validation/adapters/ajv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajv.d.ts","sourceRoot":"","sources":["../../../src/validation/adapters/ajv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAgB7F,UAAU,QAAQ;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAkCD;;GAEG;AACH,iBAAS,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,EAAE,CAU1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CA8D/D;AAED;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,CAAA"}