@gravito/core 2.0.6 → 3.0.1

package/dist/ffi/cbor-fallback.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/ffi/types.ts", "../src/ffi/cbor-fallback.ts"],
   "sourcesContent": [
-    "/**\n * FFI (Foreign Function Interface) 類型定義\n * 支持 bun:ffi 的原生加速層\n */\n\n/**\n * CBOR 編碼/解碼加速器介面\n * 可由原生 C 實現或 JavaScript 回退實現\n */\nexport interface CborAccelerator {\n  /**\n   * 將任意 JavaScript 物件編碼為 CBOR 二進制格式\n   * @param data - 要編碼的物件（支援：map、string、uint、float64、bytes、null、boolean）\n   * @returns CBOR 編碼的二進制資料\n   */\n  encode(data: Record<string, unknown>): Uint8Array\n\n  /**\n   * 將 CBOR 二進制格式解碼為 JavaScript 物件\n   * @param bytes - CBOR 編碼的二進制資料\n   * @returns 解碼後的物件\n   */\n  decode(bytes: Uint8Array): Record<string, unknown>\n}\n\n/**\n * FFI 加速層狀態報告\n */\nexport interface NativeAcceleratorStatus {\n  /**\n   * 原生 FFI 加速是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-ffi': Bun C 編譯器（bun:ffi 的 cc()）\n   * - 'js-fallback': 手寫 JavaScript CBOR 實現\n   * - 'cborg': npm 的 cborg 套件（已棄用，僅用於向後相容）\n   */\n  readonly runtime: 'bun-ffi' | 'js-fallback' | 'cborg'\n\n  /**\n   * 運行時版本或詳細資訊\n   */\n  readonly version: string\n}\n\n/**\n * FFI 層配置選項\n */\nexport interface FfiConfig {\n  /**\n   * 啟用調試日誌\n   * @default false\n   */\n  readonly debug?: boolean\n\n  /**\n   * 最大 buffer 大小（位元組）\n   * @default 1048576 (1MB)\n   */\n  readonly maxBufferSize?: number\n\n  /**\n   * 強制使用特定的加速器實現\n   * - undefined: 自動選擇（優先 bun-ffi，降級到 js-fallback）\n   * - 'bun-ffi': 只使用原生 C 實現\n   * - 'js-fallback': 只使用 JavaScript 實現\n   */\n  readonly forceImplementation?: 'bun-ffi' | 'js-fallback'\n}\n\n/**\n * CBOR Major Type 常數\n * 符合 RFC 7049 規範\n */\nexport const CBOR_MAJOR_TYPES = {\n  UINT: 0, // 正整數 (0 to 2^64-1)\n  NEGINT: 1, // 負整數 (-1 to -2^64)\n  BYTES: 2, // 位元組字串\n  TEXT: 3, // 文字字串\n  ARRAY: 4, // 陣列\n  MAP: 5, // Map 物件\n  TAG: 6, // 語意 tag\n  SIMPLE: 7, // 簡單值與浮點數\n} as const\n\n/**\n * CBOR 簡單值常數\n */\nexport const CBOR_SIMPLE_VALUES = {\n  FALSE: 20, // Boolean false\n  TRUE: 21, // Boolean true\n  NULL: 22, // null\n  UNDEFINED: 23, // undefined (不常用)\n} as const\n\n/**\n * CBOR 長度編碼的附加資訊\n */\nexport const CBOR_LENGTH_ENCODING = {\n  SMALL_RANGE_END: 23, // 0-23: 直接作為值\n  UINT8: 24, // 24: 接下來 1 byte 為 uint8_t\n  UINT16: 25, // 25: 接下來 2 bytes 為 uint16_t (大端序)\n  UINT32: 26, // 26: 接下來 4 bytes 為 uint32_t (大端序)\n  UINT64: 27, // 27: 接下來 8 bytes 為 uint64_t (大端序)\n  FLOAT16: 25, // 25: IEEE 754 半精度浮點數 (special case for SIMPLE)\n  FLOAT32: 26, // 26: IEEE 754 單精度浮點數\n  FLOAT64: 27, // 27: IEEE 754 雙精度浮點數\n  INDEFINITE: 31, // 31: 無限長度編碼\n} as const\n\n/**\n * 雜湊加速器介面\n * 可由 Bun 原生實現或 Node.js 回退實現\n */\nexport interface HashAccelerator {\n  /**\n   * SHA-256 雜湊計算\n   * @param input - 輸入（字串或二進制）\n   * @returns 十六進制編碼的 SHA-256 雜湊值（64 字元）\n   */\n  sha256(input: string | Uint8Array): string\n\n  /**\n   * HMAC-SHA256 計算\n   * @param key - 密鑰\n   * @param data - 要雜湊的數據\n   * @returns 十六進制編碼的 HMAC-SHA256 值（64 字元）\n   */\n  hmacSha256(key: string, data: string): string\n}\n\n/**\n * 雜湊加速器狀態報告\n */\nexport interface NativeHasherStatus {\n  /**\n   * 雜湊加速層是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-crypto-hasher': Bun 原生 CryptoHasher（C 實現，推薦）\n   * - 'node-crypto': node:crypto 回退實現\n   */\n  readonly runtime: 'bun-crypto-hasher' | 'node-crypto'\n}\n",
+    "/**\n * FFI (Foreign Function Interface) 類型定義\n * 支持 bun:ffi 的原生加速層\n */\n\n/**\n * CBOR 編碼/解碼加速器介面\n * 可由原生 C 實現或 JavaScript 回退實現\n */\nexport interface CborAccelerator {\n  /**\n   * 將任意 JavaScript 物件編碼為 CBOR 二進制格式\n   * @param data - 要編碼的物件（支援：map、string、uint、float64、bytes、null、boolean）\n   * @returns CBOR 編碼的二進制資料\n   */\n  encode(data: Record<string, unknown>): Uint8Array\n\n  /**\n   * 將 CBOR 二進制格式解碼為 JavaScript 物件\n   * @param bytes - CBOR 編碼的二進制資料\n   * @returns 解碼後的物件\n   */\n  decode(bytes: Uint8Array): Record<string, unknown>\n}\n\n/**\n * FFI 加速層狀態報告\n */\nexport interface NativeAcceleratorStatus {\n  /**\n   * 原生 FFI 加速是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-ffi': Bun C 編譯器（bun:ffi 的 cc()）\n   * - 'js-fallback': 手寫 JavaScript CBOR 實現\n   * - 'cborg': npm 的 cborg 套件（已棄用，僅用於向後相容）\n   */\n  readonly runtime: 'bun-ffi' | 'js-fallback' | 'cborg'\n\n  /**\n   * 運行時版本或詳細資訊\n   */\n  readonly version: string\n}\n\n/**\n * FFI 層配置選項\n */\nexport interface FfiConfig {\n  /**\n   * 啟用調試日誌\n   * @default false\n   */\n  readonly debug?: boolean\n\n  /**\n   * 最大 buffer 大小（位元組）\n   * @default 1048576 (1MB)\n   */\n  readonly maxBufferSize?: number\n\n  /**\n   * 強制使用特定的加速器實現\n   * - undefined: 自動選擇（優先 bun-ffi，降級到 js-fallback）\n   * - 'bun-ffi': 只使用原生 C 實現\n   * - 'js-fallback': 只使用 JavaScript 實現\n   */\n  readonly forceImplementation?: 'bun-ffi' | 'js-fallback'\n}\n\n/**\n * CBOR Major Type 常數\n * 符合 RFC 7049 規範\n */\nexport const CBOR_MAJOR_TYPES = {\n  UINT: 0, // 正整數 (0 to 2^64-1)\n  NEGINT: 1, // 負整數 (-1 to -2^64)\n  BYTES: 2, // 位元組字串\n  TEXT: 3, // 文字字串\n  ARRAY: 4, // 陣列\n  MAP: 5, // Map 物件\n  TAG: 6, // 語意 tag\n  SIMPLE: 7, // 簡單值與浮點數\n} as const\n\n/**\n * CBOR 簡單值常數\n */\nexport const CBOR_SIMPLE_VALUES = {\n  FALSE: 20, // Boolean false\n  TRUE: 21, // Boolean true\n  NULL: 22, // null\n  UNDEFINED: 23, // undefined (不常用)\n} as const\n\n/**\n * CBOR 長度編碼的附加資訊\n */\nexport const CBOR_LENGTH_ENCODING = {\n  SMALL_RANGE_END: 23, // 0-23: 直接作為值\n  UINT8: 24, // 24: 接下來 1 byte 為 uint8_t\n  UINT16: 25, // 25: 接下來 2 bytes 為 uint16_t (大端序)\n  UINT32: 26, // 26: 接下來 4 bytes 為 uint32_t (大端序)\n  UINT64: 27, // 27: 接下來 8 bytes 為 uint64_t (大端序)\n  FLOAT16: 25, // 25: IEEE 754 半精度浮點數 (special case for SIMPLE)\n  FLOAT32: 26, // 26: IEEE 754 單精度浮點數\n  FLOAT64: 27, // 27: IEEE 754 雙精度浮點數\n  INDEFINITE: 31, // 31: 無限長度編碼\n} as const\n\n/**\n * 雜湊加速器介面\n * 可由 Bun 原生實現或 Node.js 回退實現\n */\nexport interface HashAccelerator {\n  /**\n   * SHA-256 雜湊計算\n   * @param input - 輸入（字串或二進制）\n   * @returns 十六進制編碼的 SHA-256 雜湊值（64 字元）\n   */\n  sha256(input: string | Uint8Array): string\n\n  /**\n   * HMAC-SHA256 計算\n   * @param key - 密鑰\n   * @param data - 要雜湊的數據\n   * @returns 十六進制編碼的 HMAC-SHA256 值（64 字元）\n   */\n  hmacSha256(key: string, data: string): string\n\n  /**\n   * SHA-512 hash computation\n   * @param input - Input (string or binary)\n   * @returns Hex-encoded SHA-512 hash (128 characters)\n   */\n  sha512(input: string | Uint8Array): string\n\n  /**\n   * BLAKE2b-256 hash computation\n   * On non-Bun runtimes, falls back to SHA-256 with a console warning\n   * @param input - Input (string or binary)\n   * @returns Hex-encoded hash (64 characters)\n   */\n  blake2b(input: string | Uint8Array): string\n}\n\n/**\n * 雜湊加速器狀態報告\n */\nexport interface NativeHasherStatus {\n  /**\n   * 雜湊加速層是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-crypto-hasher': Bun 原生 CryptoHasher（C 實現，推薦）\n   * - 'node-crypto': node:crypto 回退實現\n   */\n  readonly runtime: 'bun-crypto-hasher' | 'node-crypto'\n}\n",
     "/**\n * JavaScript CBOR 回退實現\n * 用於非 Bun 環境或 FFI 不可用的情況\n * 符合 RFC 7049 規範\n */\n\nimport type { CborAccelerator } from './types'\nimport { CBOR_LENGTH_ENCODING, CBOR_MAJOR_TYPES, CBOR_SIMPLE_VALUES } from './types'\n\n/**\n * CBOR 編碼器\n * 將 JavaScript 物件編碼為 CBOR 二進制格式\n */\nexport class CborFallbackEncoder implements CborAccelerator {\n  private static readonly DEFAULT_BUFFER_SIZE = 4096\n  private static readonly MAX_DEPTH = 16\n  private static readonly MAX_BUFFER_SIZE = 1024 * 1024 // 1MB\n\n  private buffer: Uint8Array\n  private offset: number\n\n  constructor() {\n    this.buffer = new Uint8Array(CborFallbackEncoder.DEFAULT_BUFFER_SIZE)\n    this.offset = 0\n  }\n\n  /**\n   * 編碼 JavaScript 物件為 CBOR 格式\n   */\n  encode(data: Record<string, unknown>): Uint8Array {\n    this.buffer = new Uint8Array(CborFallbackEncoder.DEFAULT_BUFFER_SIZE)\n    this.offset = 0\n    this.encodeValue(data, 0)\n    return this.buffer.slice(0, this.offset)\n  }\n\n  /**\n   * 解碼 CBOR 二進制為 JavaScript 物件\n   */\n  decode(bytes: Uint8Array): Record<string, unknown> {\n    const decoder = new CborFallbackDecoder(bytes)\n    const value = decoder.decode()\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n      throw new Error('CBOR 根值必須是物件')\n    }\n    return value as Record<string, unknown>\n  }\n\n  /**\n   * 確保 buffer 有足夠空間\n   */\n  private ensureCapacity(required: number): void {\n    let newCapacity = this.buffer.length\n    while (this.offset + required > newCapacity) {\n      newCapacity *= 2\n      if (newCapacity > CborFallbackEncoder.MAX_BUFFER_SIZE) {\n        throw new Error(\n          `CBOR 編碼超過最大 buffer 大小 ${CborFallbackEncoder.MAX_BUFFER_SIZE} 位元組`\n        )\n      }\n    }\n    if (newCapacity !== this.buffer.length) {\n      const newBuffer = new Uint8Array(newCapacity)\n      newBuffer.set(this.buffer)\n      this.buffer = newBuffer\n    }\n  }\n\n  /**\n   * 編寫一個位元組\n   */\n  private writeByte(byte: number): void {\n    this.ensureCapacity(1)\n    this.buffer[this.offset++] = byte & 0xff\n  }\n\n  /**\n   * 編寫多個位元組\n   */\n  private writeBytes(bytes: ArrayLike<number>): void {\n    this.ensureCapacity(bytes.length)\n    this.buffer.set(bytes, this.offset)\n    this.offset += bytes.length\n  }\n\n  /**\n   * 編寫 CBOR 長度（Major Type + Additional Info）\n   */\n  private writeLength(majorType: number, length: number): void {\n    const type = majorType << 5\n\n    if (length < 24) {\n      this.writeByte(type | length)\n    } else if (length <= 0xff) {\n      this.writeByte(type | CBOR_LENGTH_ENCODING.UINT8)\n      this.writeByte(length)\n    } else if (length <= 0xffff) {\n      this.writeByte(type | CBOR_LENGTH_ENCODING.UINT16)\n      this.writeByte((length >> 8) & 0xff)\n      this.writeByte(length & 0xff)\n    } else if (length <= 0xffffffff) {\n      this.writeByte(type | CBOR_LENGTH_ENCODING.UINT32)\n      this.writeByte((length >> 24) & 0xff)\n      this.writeByte((length >> 16) & 0xff)\n      this.writeByte((length >> 8) & 0xff)\n      this.writeByte(length & 0xff)\n    } else {\n      throw new Error(`CBOR 不支援 > 2^32 的長度: ${length}`)\n    }\n  }\n\n  /**\n   * 遞迴編碼值\n   */\n  private encodeValue(value: unknown, depth: number): void {\n    if (depth > CborFallbackEncoder.MAX_DEPTH) {\n      throw new Error(`CBOR 編碼深度超過限制 ${CborFallbackEncoder.MAX_DEPTH}`)\n    }\n\n    if (value === null) {\n      this.writeByte((CBOR_MAJOR_TYPES.SIMPLE << 5) | CBOR_SIMPLE_VALUES.NULL)\n    } else if (value === true) {\n      this.writeByte((CBOR_MAJOR_TYPES.SIMPLE << 5) | CBOR_SIMPLE_VALUES.TRUE)\n    } else if (value === false) {\n      this.writeByte((CBOR_MAJOR_TYPES.SIMPLE << 5) | CBOR_SIMPLE_VALUES.FALSE)\n    } else if (typeof value === 'number') {\n      this.encodeNumber(value)\n    } else if (typeof value === 'string') {\n      this.encodeString(value)\n    } else if (value instanceof Uint8Array) {\n      this.encodeBytes(value)\n    } else if (Array.isArray(value)) {\n      this.encodeArray(value, depth)\n    } else if (typeof value === 'object') {\n      this.encodeMap(value as Record<string, unknown>, depth)\n    } else {\n      throw new Error(`CBOR 不支援類型: ${typeof value}`)\n    }\n  }\n\n  /**\n   * 編碼整數或浮點數\n   * 對於超過 uint32 範圍的整數，使用 float64 編碼（JavaScript 精度限制）\n   */\n  private encodeNumber(num: number): void {\n    // 檢查是否為整數且在 uint32/negint32 範圍內\n    if (Number.isInteger(num) && !Object.is(num, -0)) {\n      if (num >= 0 && num <= 0xffffffff) {\n        this.writeLength(CBOR_MAJOR_TYPES.UINT, num)\n        return\n      }\n      if (num < 0 && -1 - num <= 0xffffffff) {\n        this.writeLength(CBOR_MAJOR_TYPES.NEGINT, -1 - num)\n        return\n      }\n      // 超過 32-bit 範圍的整數，降級為 float64\n    }\n    {\n      // 浮點數（float64）\n      const bytes = new Uint8Array(9)\n      bytes[0] = (CBOR_MAJOR_TYPES.SIMPLE << 5) | CBOR_LENGTH_ENCODING.FLOAT64\n\n      // IEEE 754 雙精度大端序\n      const view = new DataView(new ArrayBuffer(8))\n      view.setFloat64(0, num, false)\n      for (let i = 0; i < 8; i++) {\n        bytes[i + 1] = view.getUint8(i)\n      }\n      this.writeBytes(bytes)\n    }\n  }\n\n  /**\n   * 編碼字串\n   */\n  private encodeString(str: string): void {\n    const encoder = new TextEncoder()\n    const bytes = encoder.encode(str)\n    this.writeLength(CBOR_MAJOR_TYPES.TEXT, bytes.length)\n    this.writeBytes(bytes)\n  }\n\n  /**\n   * 編碼位元組陣列\n   */\n  private encodeBytes(bytes: Uint8Array): void {\n    this.writeLength(CBOR_MAJOR_TYPES.BYTES, bytes.length)\n    this.writeBytes(bytes)\n  }\n\n  /**\n   * 編碼陣列\n   */\n  private encodeArray(arr: unknown[], depth: number): void {\n    this.writeLength(CBOR_MAJOR_TYPES.ARRAY, arr.length)\n    for (const item of arr) {\n      this.encodeValue(item, depth + 1)\n    }\n  }\n\n  /**\n   * 編碼物件（Map）\n   */\n  private encodeMap(obj: Record<string, unknown>, depth: number): void {\n    const keys = Object.keys(obj)\n    this.writeLength(CBOR_MAJOR_TYPES.MAP, keys.length)\n    for (const key of keys) {\n      this.encodeString(key)\n      this.encodeValue(obj[key], depth + 1)\n    }\n  }\n}\n\n/**\n * CBOR 解碼器\n */\nexport class CborFallbackDecoder {\n  private static readonly MAX_DEPTH = 16\n  private data: Uint8Array\n  private offset: number\n\n  constructor(data: Uint8Array) {\n    this.data = data\n    this.offset = 0\n  }\n\n  /**\n   * 解碼 CBOR 資料\n   */\n  decode(): unknown {\n    return this.decodeValue(0)\n  }\n\n  /**\n   * 讀取一個位元組\n   */\n  private readByte(): number {\n    if (this.offset >= this.data.length) {\n      throw new Error('CBOR 資料不足')\n    }\n    return this.data[this.offset++]\n  }\n\n  /**\n   * 讀取固定長度的位元組\n   */\n  private readBytes(length: number): Uint8Array {\n    if (this.offset + length > this.data.length) {\n      throw new Error('CBOR 資料不足')\n    }\n    const result = this.data.slice(this.offset, this.offset + length)\n    this.offset += length\n    return result\n  }\n\n  /**\n   * 讀取 CBOR 長度\n   */\n  private readLength(additionalInfo: number): number {\n    if (additionalInfo < 24) {\n      return additionalInfo\n    }\n    if (additionalInfo === 24) {\n      return this.readByte()\n    }\n    if (additionalInfo === 25) {\n      const b1 = this.readByte()\n      const b2 = this.readByte()\n      return (b1 << 8) | b2\n    }\n    if (additionalInfo === 26) {\n      const b1 = this.readByte()\n      const b2 = this.readByte()\n      const b3 = this.readByte()\n      const b4 = this.readByte()\n      return (b1 << 24) | (b2 << 16) | (b3 << 8) | b4\n    }\n    if (additionalInfo === 27) {\n      // 64-bit，但 JavaScript 無法精確表示，只支援到 2^53\n      const high =\n        (this.readByte() << 24) | (this.readByte() << 16) | (this.readByte() << 8) | this.readByte()\n      const low =\n        (this.readByte() << 24) | (this.readByte() << 16) | (this.readByte() << 8) | this.readByte()\n      return high * 0x100000000 + low\n    }\n    throw new Error(`CBOR 無效的長度編碼: ${additionalInfo}`)\n  }\n\n  /**\n   * 遞迴解碼值\n   */\n  private decodeValue(depth: number): unknown {\n    if (depth > CborFallbackDecoder.MAX_DEPTH) {\n      throw new Error(`CBOR 解碼深度超過限制 ${CborFallbackDecoder.MAX_DEPTH}`)\n    }\n\n    const byte = this.readByte()\n    const majorType = (byte >> 5) & 0x07\n    const additionalInfo = byte & 0x1f\n\n    switch (majorType) {\n      case CBOR_MAJOR_TYPES.UINT:\n        return this.readLength(additionalInfo)\n\n      case CBOR_MAJOR_TYPES.NEGINT:\n        return -1 - this.readLength(additionalInfo)\n\n      case CBOR_MAJOR_TYPES.BYTES: {\n        const length = this.readLength(additionalInfo)\n        return this.readBytes(length)\n      }\n\n      case CBOR_MAJOR_TYPES.TEXT: {\n        const length = this.readLength(additionalInfo)\n        const bytes = this.readBytes(length)\n        const decoder = new TextDecoder()\n        return decoder.decode(bytes)\n      }\n\n      case CBOR_MAJOR_TYPES.ARRAY: {\n        const length = this.readLength(additionalInfo)\n        const result: unknown[] = []\n        for (let i = 0; i < length; i++) {\n          result.push(this.decodeValue(depth + 1))\n        }\n        return result\n      }\n\n      case CBOR_MAJOR_TYPES.MAP: {\n        const length = this.readLength(additionalInfo)\n        const result: Record<string, unknown> = {}\n        for (let i = 0; i < length; i++) {\n          const key = this.decodeValue(depth + 1)\n          if (typeof key !== 'string') {\n            throw new Error(`CBOR Map 的 key 必須是字串，得到: ${typeof key}`)\n          }\n          result[key] = this.decodeValue(depth + 1)\n        }\n        return result\n      }\n\n      case CBOR_MAJOR_TYPES.SIMPLE:\n        if (additionalInfo === CBOR_SIMPLE_VALUES.FALSE) {\n          return false\n        }\n        if (additionalInfo === CBOR_SIMPLE_VALUES.TRUE) {\n          return true\n        }\n        if (additionalInfo === CBOR_SIMPLE_VALUES.NULL) {\n          return null\n        }\n\n        // 浮點數\n        if (additionalInfo === CBOR_LENGTH_ENCODING.FLOAT32) {\n          const bytes = this.readBytes(4)\n          const view = new DataView(bytes.buffer, bytes.byteOffset)\n          return view.getFloat32(0, false)\n        }\n        if (additionalInfo === CBOR_LENGTH_ENCODING.FLOAT64) {\n          const bytes = this.readBytes(8)\n          const view = new DataView(bytes.buffer, bytes.byteOffset)\n          return view.getFloat64(0, false)\n        }\n\n        throw new Error(`CBOR 不支援的 simple value: ${additionalInfo}`)\n\n      case CBOR_MAJOR_TYPES.TAG:\n        // TAG 類型在此實現中跳過\n        return this.decodeValue(depth)\n\n      default:\n        throw new Error(`CBOR 無效的 major type: ${majorType}`)\n    }\n  }\n}\n"
   ],
   "mappings": "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",

package/dist/ffi/hash-fallback.d.ts

@@ -17,6 +17,8 @@ import type { HashAccelerator } from './types';
  * 適用於非 Bun 環境
  */
 export declare class HashFallback implements HashAccelerator {
+    /** @internal */
+    private blake2bWarned;
     /**
      * SHA-256 計算（回退實現）
      * @param input - 輸入（字串或 Uint8Array）
@@ -30,4 +32,17 @@ export declare class HashFallback implements HashAccelerator {
      * @returns 十六進制編碼的 HMAC-SHA256 值
      */
     hmacSha256(key: string, data: string): string;
+    /**
+     * SHA-512 計算（回退實現）
+     * @param input - 輸入（字串或 Uint8Array）
+     * @returns 十六進制編碼的 SHA-512 雜湊值（128 字元）
+     */
+    sha512(input: string | Uint8Array): string;
+    /**
+     * BLAKE2b-256 計算（回退實現）
+     * BLAKE2b-256 在 node:crypto 中不普遍可用，回退至 SHA-256 並發出警告。
+     * @param input - 輸入（字串或 Uint8Array）
+     * @returns 十六進制編碼的雜湊值（64 字元）
+     */
+    blake2b(input: string | Uint8Array): string;
 }

package/dist/ffi/hash-fallback.js

@@ -49,15 +49,26 @@ var __require = import.meta.require;
 import { createHash, createHmac } from "crypto";
 
 class HashFallback {
+  blake2bWarned = false;
   sha256(input) {
     return createHash("sha256").update(input).digest("hex");
   }
   hmacSha256(key, data) {
     return createHmac("sha256", key).update(data).digest("hex");
   }
+  sha512(input) {
+    return createHash("sha512").update(input).digest("hex");
+  }
+  blake2b(input) {
+    if (!this.blake2bWarned) {
+      console.warn("[gravito] BLAKE2b not available in node:crypto \u2014 using SHA-256 fallback");
+      this.blake2bWarned = true;
+    }
+    return createHash("sha256").update(input).digest("hex");
+  }
 }
 export {
   HashFallback
 };
 
-//# debugId=3459244799B7D36C64756E2164756E21
+//# debugId=8F3B1B97286D438A64756E2164756E21

package/dist/ffi/hash-fallback.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/ffi/hash-fallback.ts"],
   "sourcesContent": [
-    "/**\n * 雜湊加速器 JavaScript 回退實現\n * 基於 node:crypto 標準庫\n *\n * 使用場景：\n * - 非 Bun 環境（Node.js、Deno 等）\n * - Bun CryptoHasher 不可用的情況\n *\n * 性能特性：\n * - 短 key (<100 bytes)：~1-2x 慢於 Bun.CryptoHasher（N-API 橋接開銷）\n * - 長 payload：差異較小（主要計算時間）\n * - 一致性：與 node:crypto 標準行為完全相同\n */\n\nimport { createHash, createHmac } from 'node:crypto'\nimport type { HashAccelerator } from './types'\n\n/**\n * Node.js crypto 回退實現\n * 適用於非 Bun 環境\n */\nexport class HashFallback implements HashAccelerator {\n  /**\n   * SHA-256 計算（回退實現）\n   * @param input - 輸入（字串或 Uint8Array）\n   * @returns 十六進制編碼的 SHA-256 雜湊值\n   */\n  sha256(input: string | Uint8Array): string {\n    return createHash('sha256').update(input).digest('hex')\n  }\n\n  /**\n   * HMAC-SHA256 計算（回退實現）\n   * @param key - 密鑰\n   * @param data - 要雜湊的數據\n   * @returns 十六進制編碼的 HMAC-SHA256 值\n   */\n  hmacSha256(key: string, data: string): string {\n    return createHmac('sha256', key).update(data).digest('hex')\n  }\n}\n"
+    "/**\n * 雜湊加速器 JavaScript 回退實現\n * 基於 node:crypto 標準庫\n *\n * 使用場景：\n * - 非 Bun 環境（Node.js、Deno 等）\n * - Bun CryptoHasher 不可用的情況\n *\n * 性能特性：\n * - 短 key (<100 bytes)：~1-2x 慢於 Bun.CryptoHasher（N-API 橋接開銷）\n * - 長 payload：差異較小（主要計算時間）\n * - 一致性：與 node:crypto 標準行為完全相同\n */\n\nimport { createHash, createHmac } from 'node:crypto'\nimport type { HashAccelerator } from './types'\n\n/**\n * Node.js crypto 回退實現\n * 適用於非 Bun 環境\n */\nexport class HashFallback implements HashAccelerator {\n  /** @internal */\n  private blake2bWarned = false\n\n  /**\n   * SHA-256 計算（回退實現）\n   * @param input - 輸入（字串或 Uint8Array）\n   * @returns 十六進制編碼的 SHA-256 雜湊值\n   */\n  sha256(input: string | Uint8Array): string {\n    return createHash('sha256').update(input).digest('hex')\n  }\n\n  /**\n   * HMAC-SHA256 計算（回退實現）\n   * @param key - 密鑰\n   * @param data - 要雜湊的數據\n   * @returns 十六進制編碼的 HMAC-SHA256 值\n   */\n  hmacSha256(key: string, data: string): string {\n    return createHmac('sha256', key).update(data).digest('hex')\n  }\n\n  /**\n   * SHA-512 計算（回退實現）\n   * @param input - 輸入（字串或 Uint8Array）\n   * @returns 十六進制編碼的 SHA-512 雜湊值（128 字元）\n   */\n  sha512(input: string | Uint8Array): string {\n    return createHash('sha512').update(input).digest('hex')\n  }\n\n  /**\n   * BLAKE2b-256 計算（回退實現）\n   * BLAKE2b-256 在 node:crypto 中不普遍可用，回退至 SHA-256 並發出警告。\n   * @param input - 輸入（字串或 Uint8Array）\n   * @returns 十六進制編碼的雜湊值（64 字元）\n   */\n  blake2b(input: string | Uint8Array): string {\n    // BLAKE2b-256 not universally available in Node.js node:crypto\n    // Fallback to SHA-256 with warning\n    if (!this.blake2bWarned) {\n      console.warn('[gravito] BLAKE2b not available in node:crypto — using SHA-256 fallback')\n      this.blake2bWarned = true\n    }\n    return createHash('sha256').update(input).digest('hex')\n  }\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA;AAAA;AAOO,MAAM,aAAwC;AAAA,EAMnD,MAAM,CAAC,OAAoC;AAAA,IACzC,OAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AAAA;AAAA,EASxD,UAAU,CAAC,KAAa,MAAsB;AAAA,IAC5C,OAAO,WAAW,UAAU,GAAG,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AAAA;AAE9D;",
-  "debugId": "3459244799B7D36C64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA;AAAA;AAOO,MAAM,aAAwC;AAAA,EAE3C,gBAAgB;AAAA,EAOxB,MAAM,CAAC,OAAoC;AAAA,IACzC,OAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AAAA;AAAA,EASxD,UAAU,CAAC,KAAa,MAAsB;AAAA,IAC5C,OAAO,WAAW,UAAU,GAAG,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AAAA;AAAA,EAQ5D,MAAM,CAAC,OAAoC;AAAA,IACzC,OAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AAAA;AAAA,EASxD,OAAO,CAAC,OAAoC;AAAA,IAG1C,IAAI,CAAC,KAAK,eAAe;AAAA,MACvB,QAAQ,KAAK,8EAAwE;AAAA,MACrF,KAAK,gBAAgB;AAAA,IACvB;AAAA,IACA,OAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AAAA;AAE1D;",
+  "debugId": "8F3B1B97286D438A64756E2164756E21",
   "names": []
 }

package/dist/ffi/types.d.ts

@@ -117,6 +117,19 @@ export interface HashAccelerator {
      * @returns 十六進制編碼的 HMAC-SHA256 值（64 字元）
      */
     hmacSha256(key: string, data: string): string;
+    /**
+     * SHA-512 hash computation
+     * @param input - Input (string or binary)
+     * @returns Hex-encoded SHA-512 hash (128 characters)
+     */
+    sha512(input: string | Uint8Array): string;
+    /**
+     * BLAKE2b-256 hash computation
+     * On non-Bun runtimes, falls back to SHA-256 with a console warning
+     * @param input - Input (string or binary)
+     * @returns Hex-encoded hash (64 characters)
+     */
+    blake2b(input: string | Uint8Array): string;
 }
 /**
  * 雜湊加速器狀態報告

package/dist/ffi/types.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["../src/ffi/types.ts"],
   "sourcesContent": [
-    "/**\n * FFI (Foreign Function Interface) 類型定義\n * 支持 bun:ffi 的原生加速層\n */\n\n/**\n * CBOR 編碼/解碼加速器介面\n * 可由原生 C 實現或 JavaScript 回退實現\n */\nexport interface CborAccelerator {\n  /**\n   * 將任意 JavaScript 物件編碼為 CBOR 二進制格式\n   * @param data - 要編碼的物件（支援：map、string、uint、float64、bytes、null、boolean）\n   * @returns CBOR 編碼的二進制資料\n   */\n  encode(data: Record<string, unknown>): Uint8Array\n\n  /**\n   * 將 CBOR 二進制格式解碼為 JavaScript 物件\n   * @param bytes - CBOR 編碼的二進制資料\n   * @returns 解碼後的物件\n   */\n  decode(bytes: Uint8Array): Record<string, unknown>\n}\n\n/**\n * FFI 加速層狀態報告\n */\nexport interface NativeAcceleratorStatus {\n  /**\n   * 原生 FFI 加速是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-ffi': Bun C 編譯器（bun:ffi 的 cc()）\n   * - 'js-fallback': 手寫 JavaScript CBOR 實現\n   * - 'cborg': npm 的 cborg 套件（已棄用，僅用於向後相容）\n   */\n  readonly runtime: 'bun-ffi' | 'js-fallback' | 'cborg'\n\n  /**\n   * 運行時版本或詳細資訊\n   */\n  readonly version: string\n}\n\n/**\n * FFI 層配置選項\n */\nexport interface FfiConfig {\n  /**\n   * 啟用調試日誌\n   * @default false\n   */\n  readonly debug?: boolean\n\n  /**\n   * 最大 buffer 大小（位元組）\n   * @default 1048576 (1MB)\n   */\n  readonly maxBufferSize?: number\n\n  /**\n   * 強制使用特定的加速器實現\n   * - undefined: 自動選擇（優先 bun-ffi，降級到 js-fallback）\n   * - 'bun-ffi': 只使用原生 C 實現\n   * - 'js-fallback': 只使用 JavaScript 實現\n   */\n  readonly forceImplementation?: 'bun-ffi' | 'js-fallback'\n}\n\n/**\n * CBOR Major Type 常數\n * 符合 RFC 7049 規範\n */\nexport const CBOR_MAJOR_TYPES = {\n  UINT: 0, // 正整數 (0 to 2^64-1)\n  NEGINT: 1, // 負整數 (-1 to -2^64)\n  BYTES: 2, // 位元組字串\n  TEXT: 3, // 文字字串\n  ARRAY: 4, // 陣列\n  MAP: 5, // Map 物件\n  TAG: 6, // 語意 tag\n  SIMPLE: 7, // 簡單值與浮點數\n} as const\n\n/**\n * CBOR 簡單值常數\n */\nexport const CBOR_SIMPLE_VALUES = {\n  FALSE: 20, // Boolean false\n  TRUE: 21, // Boolean true\n  NULL: 22, // null\n  UNDEFINED: 23, // undefined (不常用)\n} as const\n\n/**\n * CBOR 長度編碼的附加資訊\n */\nexport const CBOR_LENGTH_ENCODING = {\n  SMALL_RANGE_END: 23, // 0-23: 直接作為值\n  UINT8: 24, // 24: 接下來 1 byte 為 uint8_t\n  UINT16: 25, // 25: 接下來 2 bytes 為 uint16_t (大端序)\n  UINT32: 26, // 26: 接下來 4 bytes 為 uint32_t (大端序)\n  UINT64: 27, // 27: 接下來 8 bytes 為 uint64_t (大端序)\n  FLOAT16: 25, // 25: IEEE 754 半精度浮點數 (special case for SIMPLE)\n  FLOAT32: 26, // 26: IEEE 754 單精度浮點數\n  FLOAT64: 27, // 27: IEEE 754 雙精度浮點數\n  INDEFINITE: 31, // 31: 無限長度編碼\n} as const\n\n/**\n * 雜湊加速器介面\n * 可由 Bun 原生實現或 Node.js 回退實現\n */\nexport interface HashAccelerator {\n  /**\n   * SHA-256 雜湊計算\n   * @param input - 輸入（字串或二進制）\n   * @returns 十六進制編碼的 SHA-256 雜湊值（64 字元）\n   */\n  sha256(input: string | Uint8Array): string\n\n  /**\n   * HMAC-SHA256 計算\n   * @param key - 密鑰\n   * @param data - 要雜湊的數據\n   * @returns 十六進制編碼的 HMAC-SHA256 值（64 字元）\n   */\n  hmacSha256(key: string, data: string): string\n}\n\n/**\n * 雜湊加速器狀態報告\n */\nexport interface NativeHasherStatus {\n  /**\n   * 雜湊加速層是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-crypto-hasher': Bun 原生 CryptoHasher（C 實現，推薦）\n   * - 'node-crypto': node:crypto 回退實現\n   */\n  readonly runtime: 'bun-crypto-hasher' | 'node-crypto'\n}\n"
+    "/**\n * FFI (Foreign Function Interface) 類型定義\n * 支持 bun:ffi 的原生加速層\n */\n\n/**\n * CBOR 編碼/解碼加速器介面\n * 可由原生 C 實現或 JavaScript 回退實現\n */\nexport interface CborAccelerator {\n  /**\n   * 將任意 JavaScript 物件編碼為 CBOR 二進制格式\n   * @param data - 要編碼的物件（支援：map、string、uint、float64、bytes、null、boolean）\n   * @returns CBOR 編碼的二進制資料\n   */\n  encode(data: Record<string, unknown>): Uint8Array\n\n  /**\n   * 將 CBOR 二進制格式解碼為 JavaScript 物件\n   * @param bytes - CBOR 編碼的二進制資料\n   * @returns 解碼後的物件\n   */\n  decode(bytes: Uint8Array): Record<string, unknown>\n}\n\n/**\n * FFI 加速層狀態報告\n */\nexport interface NativeAcceleratorStatus {\n  /**\n   * 原生 FFI 加速是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-ffi': Bun C 編譯器（bun:ffi 的 cc()）\n   * - 'js-fallback': 手寫 JavaScript CBOR 實現\n   * - 'cborg': npm 的 cborg 套件（已棄用，僅用於向後相容）\n   */\n  readonly runtime: 'bun-ffi' | 'js-fallback' | 'cborg'\n\n  /**\n   * 運行時版本或詳細資訊\n   */\n  readonly version: string\n}\n\n/**\n * FFI 層配置選項\n */\nexport interface FfiConfig {\n  /**\n   * 啟用調試日誌\n   * @default false\n   */\n  readonly debug?: boolean\n\n  /**\n   * 最大 buffer 大小（位元組）\n   * @default 1048576 (1MB)\n   */\n  readonly maxBufferSize?: number\n\n  /**\n   * 強制使用特定的加速器實現\n   * - undefined: 自動選擇（優先 bun-ffi，降級到 js-fallback）\n   * - 'bun-ffi': 只使用原生 C 實現\n   * - 'js-fallback': 只使用 JavaScript 實現\n   */\n  readonly forceImplementation?: 'bun-ffi' | 'js-fallback'\n}\n\n/**\n * CBOR Major Type 常數\n * 符合 RFC 7049 規範\n */\nexport const CBOR_MAJOR_TYPES = {\n  UINT: 0, // 正整數 (0 to 2^64-1)\n  NEGINT: 1, // 負整數 (-1 to -2^64)\n  BYTES: 2, // 位元組字串\n  TEXT: 3, // 文字字串\n  ARRAY: 4, // 陣列\n  MAP: 5, // Map 物件\n  TAG: 6, // 語意 tag\n  SIMPLE: 7, // 簡單值與浮點數\n} as const\n\n/**\n * CBOR 簡單值常數\n */\nexport const CBOR_SIMPLE_VALUES = {\n  FALSE: 20, // Boolean false\n  TRUE: 21, // Boolean true\n  NULL: 22, // null\n  UNDEFINED: 23, // undefined (不常用)\n} as const\n\n/**\n * CBOR 長度編碼的附加資訊\n */\nexport const CBOR_LENGTH_ENCODING = {\n  SMALL_RANGE_END: 23, // 0-23: 直接作為值\n  UINT8: 24, // 24: 接下來 1 byte 為 uint8_t\n  UINT16: 25, // 25: 接下來 2 bytes 為 uint16_t (大端序)\n  UINT32: 26, // 26: 接下來 4 bytes 為 uint32_t (大端序)\n  UINT64: 27, // 27: 接下來 8 bytes 為 uint64_t (大端序)\n  FLOAT16: 25, // 25: IEEE 754 半精度浮點數 (special case for SIMPLE)\n  FLOAT32: 26, // 26: IEEE 754 單精度浮點數\n  FLOAT64: 27, // 27: IEEE 754 雙精度浮點數\n  INDEFINITE: 31, // 31: 無限長度編碼\n} as const\n\n/**\n * 雜湊加速器介面\n * 可由 Bun 原生實現或 Node.js 回退實現\n */\nexport interface HashAccelerator {\n  /**\n   * SHA-256 雜湊計算\n   * @param input - 輸入（字串或二進制）\n   * @returns 十六進制編碼的 SHA-256 雜湊值（64 字元）\n   */\n  sha256(input: string | Uint8Array): string\n\n  /**\n   * HMAC-SHA256 計算\n   * @param key - 密鑰\n   * @param data - 要雜湊的數據\n   * @returns 十六進制編碼的 HMAC-SHA256 值（64 字元）\n   */\n  hmacSha256(key: string, data: string): string\n\n  /**\n   * SHA-512 hash computation\n   * @param input - Input (string or binary)\n   * @returns Hex-encoded SHA-512 hash (128 characters)\n   */\n  sha512(input: string | Uint8Array): string\n\n  /**\n   * BLAKE2b-256 hash computation\n   * On non-Bun runtimes, falls back to SHA-256 with a console warning\n   * @param input - Input (string or binary)\n   * @returns Hex-encoded hash (64 characters)\n   */\n  blake2b(input: string | Uint8Array): string\n}\n\n/**\n * 雜湊加速器狀態報告\n */\nexport interface NativeHasherStatus {\n  /**\n   * 雜湊加速層是否可用\n   */\n  readonly available: boolean\n\n  /**\n   * 當前使用的運行時實現\n   * - 'bun-crypto-hasher': Bun 原生 CryptoHasher（C 實現，推薦）\n   * - 'node-crypto': node:crypto 回退實現\n   */\n  readonly runtime: 'bun-crypto-hasher' | 'node-crypto'\n}\n"
   ],
   "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EO,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,KAAK;AAAA,EACL,QAAQ;AACV;AAKO,IAAM,qBAAqB;AAAA,EAChC,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,WAAW;AACb;AAKO,IAAM,uBAAuB;AAAA,EAClC,iBAAiB;AAAA,EACjB,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,YAAY;AACd;",
   "debugId": "3722FA7EE113FE4A64756E2164756E21",

package/dist/hooks/types.d.ts

@@ -1,6 +1,8 @@
 import type { CircuitBreakerOptions } from '../events/CircuitBreaker';
 import type { EventBackend } from '../events/EventBackend';
+import type { MessageQueueBridge } from '../events/MessageQueueBridge';
 import type { EventQueueConfig } from '../events/EventPriorityQueue';
+import type { AggregationConfig } from '../events/aggregation/types';
 /**
  * Callback function for filters (transforms values).
  * @public
@@ -87,8 +89,10 @@ export interface HookManagerConfig {
     /**
      * Database connection for persistent DLQ (optional).
      * If provided, failed events after max retries will be persisted to database.
+     * Typed as `unknown` since core does not depend on @gravito/atlas or any specific DB type.
+     * The consuming code (DeadLetterQueueManager) accepts and narrows this to its internal type.
      */
-    db?: any;
+    db?: unknown;
     /**
      * Enable persistent DLQ for failed events (requires db).
      * @default false
@@ -98,10 +102,10 @@ export interface HookManagerConfig {
      * Message Queue Bridge for distributed event processing via Bull Queue.
      * When provided, enables dispatchQueued() method for routing events to Redis-backed queue.
      */
-    messageQueueBridge?: any;
+    messageQueueBridge?: MessageQueueBridge;
     /**
      * Event aggregation configuration (FS-102).
      * Enables deduplication and micro-batching for improved throughput.
      */
-    aggregation?: any;
+    aggregation?: AggregationConfig;
 }

package/dist/http/types.d.ts

@@ -320,7 +320,7 @@ export interface GravitoContext<V extends GravitoVariables = GravitoVariables> {
      * URL generator helper.
      * Generates a URL for a named route.
      */
-    route: (name: string, params?: Record<string, any>, query?: Record<string, any>) => string;
+    route: (name: string, params?: Record<string, string | number>, query?: Record<string, string | number | boolean | null | undefined>) => string;
     /**
      * Access the native context object from the underlying HTTP engine.
      *
@@ -338,7 +338,7 @@ export interface GravitoContext<V extends GravitoVariables = GravitoVariables> {
      * Access the RequestScopeManager for this request
      * Services resolved through this manager are scoped to the HTTP request lifetime.
      */
-    requestScope(): any;
+    requestScope(): unknown;
     /**
      * Resolve or create a request-scoped service
      *

package/dist/index.browser.d.ts

@@ -23,12 +23,12 @@ export { EventManager } from './EventManager';
 export * from './events';
 export { HookManager, type HookManagerConfig } from './HookManager';
 export { HealthProvider } from './health/HealthProvider';
-export { Arr, abort, abortIf, abortUnless, app, blank, config, DumpDieError, dd, dump, env, filled, hasApp, logger, router, Str, setApp, tap, throwIf, throwUnless, value, } from './helpers';
-export * from './helpers/data';
-export * from './helpers/errors';
-export * from './helpers/response';
+export { Arr, abort, abortIf, abortUnless, app, blank, config, DumpDieError, dd, dump, env, filled, hasApp, logger, router, Str, tap, throwIf, throwUnless, value, } from './helpers';
+export { type DataPath, dataGet, dataHas, dataSet, type PathSegment } from './helpers/data';
+export { createErrorBag, type ErrorBag, errors, old } from './helpers/errors';
+export { type ApiFailure, type ApiSuccess, fail, jsonFail, jsonSuccess, ok, } from './helpers/response';
 export { CookieJar, type CookieOptions } from './http/CookieJar';
 export { deleteCookie, getCookie, setCookie } from './http/cookie';
 export { ServiceProvider } from './ServiceProvider';
 export * from './runtime/index.browser';
-export declare function defineConfig(config: any): any;
+export declare function defineConfig<T extends Record<string, unknown>>(config: T): T;