@ddunigma/node 3.1.0 → 4.0.1

package/dist/chunk-RHVBUC4T.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkNY4FGVF3_cjs=require('./chunk-NY4FGVF3.cjs'),crypto=require('crypto'),zlib=require('zlib'),util=require('util');var N=util.promisify(zlib.deflateRaw),w=util.promisify(zlib.inflateRaw),v=util.promisify(zlib.brotliCompress),h=util.promisify(zlib.brotliDecompress),E=util.promisify(crypto.pbkdf2);function _(e){let n=e,r=String(n?.message??"").toLowerCase();return String(n?.code??"")==="ERR_BUFFER_TOO_LARGE"||r.includes("output length")||r.includes("buffer too large")||r.includes("cannot create a buffer larger")}function f(e,n,r){throw _(e)?new Error(`[Ddu64 ${r}] Decompressed data exceeds limit. Limit: ${n} bytes`,{cause:e}):e}function s(e){return Buffer.isBuffer(e)?e:e.buffer instanceof SharedArrayBuffer?Buffer.from(e):Buffer.from(e.buffer,e.byteOffset,e.byteLength)}var g=class{supportsSyncCrypto=true;supportsSyncCompression=true;supportsBrotli=true;runtime="node";async deriveKey(n,r){if(r?.algorithm==="pbkdf2"){let t=await E(n,chunkNY4FGVF3_cjs.d(r.salt),chunkNY4FGVF3_cjs.a(r.iterations),32,chunkNY4FGVF3_cjs.b(r.hash));return new Uint8Array(t)}return this.deriveKeySync(n,r)}deriveKeySync(n,r){return r?.algorithm==="pbkdf2"?new Uint8Array(crypto.pbkdf2Sync(n,chunkNY4FGVF3_cjs.d(r.salt),chunkNY4FGVF3_cjs.a(r.iterations),32,chunkNY4FGVF3_cjs.b(r.hash))):new Uint8Array(crypto.createHash("sha256").update(n).digest())}async encrypt(n,r,t){return this.encryptSync(n,r,t)}encryptSync(n,r,t){let i=crypto.randomBytes(12),o=crypto.createCipheriv("aes-256-gcm",r,i);t&&t.length>0&&o.setAAD(s(t));let u=Buffer.concat([o.update(n),o.final()]),a=o.getAuthTag(),c=new Uint8Array(28+u.length);return c.set(i,0),c.set(a,12),c.set(u,28),c}async decrypt(n,r,t){return this.decryptSync(n,r,t)}decryptSync(n,r,t){if(n.length<28)throw new Error("[Ddu64 decrypt] Invalid encrypted data: too short");let i=n.subarray(0,12),o=n.subarray(12,28),u=n.subarray(28),a=crypto.createDecipheriv("aes-256-gcm",r,i);t&&t.length>0&&a.setAAD(s(t)),a.setAuthTag(o);let c=Buffer.concat([a.update(u),a.final()]);return new Uint8Array(c)}randomBytes(n){return new Uint8Array(crypto.randomBytes(n))}async deflate(n,r){let t={};r!==void 0&&(t.level=r);let i=await N(s(n),t);return new Uint8Array(i)}deflateSync(n,r){let t={};return r!==void 0&&(t.level=r),new Uint8Array(zlib.deflateRawSync(s(n),t))}async inflate(n,r){if(r===void 0||r===Number.POSITIVE_INFINITY){let i=await w(s(n));return new Uint8Array(i)}let t={maxOutputLength:r};try{let i=await w(s(n),t);return new Uint8Array(i)}catch(i){f(i,r,"inflate");}}inflateSync(n,r){if(r===void 0||r===Number.POSITIVE_INFINITY)return new Uint8Array(zlib.inflateRawSync(s(n)));try{return new Uint8Array(zlib.inflateRawSync(s(n),{maxOutputLength:r}))}catch(t){f(t,r,"inflate");}}async brotliCompress(n,r){let t={};r!==void 0&&(t.params={[zlib.constants.BROTLI_PARAM_QUALITY]:Math.max(0,Math.min(11,r))});let i=await v(s(n),t);return new Uint8Array(i)}brotliCompressSync(n,r){let t={};return r!==void 0&&(t.params={[zlib.constants.BROTLI_PARAM_QUALITY]:Math.max(0,Math.min(11,r))}),new Uint8Array(zlib.brotliCompressSync(s(n),t))}async brotliDecompress(n,r){if(r===void 0||r===Number.POSITIVE_INFINITY){let t=await h(s(n));return new Uint8Array(t)}try{let t=await h(s(n),{maxOutputLength:r});return new Uint8Array(t)}catch(t){f(t,r,"brotli");}}brotliDecompressSync(n,r){if(r===void 0||r===Number.POSITIVE_INFINITY)return new Uint8Array(zlib.brotliDecompressSync(s(n)));try{return new Uint8Array(zlib.brotliDecompressSync(s(n),{maxOutputLength:r}))}catch(t){f(t,r,"brotli");}}};exports.a=g;//# sourceMappingURL=chunk-RHVBUC4T.cjs.map
+//# sourceMappingURL=chunk-RHVBUC4T.cjs.map

package/dist/chunk-WS6GB27C.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkFACJ5LAG_cjs=require('./chunk-FACJ5LAG.cjs');function R(){let e=globalThis;return e.Deno?.version?.deno?"deno":e.Bun?.version?"bun":e.process?.versions?.node?"node":typeof e.EdgeRuntime=="string"||typeof e.WebSocketPair<"u"&&e.crypto?.subtle?"edge":typeof e.crypto<"u"&&e.crypto?.subtle?"browser":"unknown"}function W(e,n){let r=e.getCharSetInfo(),d=n?.compress??r.defaultCompress,p=(n?.encrypt??true)&&r.hasEncryptionKey,y=n?.checksum??r.defaultChecksum,t=d?n?.compressionAlgorithm??r.defaultCompressionAlgorithm:void 0,m=r.paddingChar,f=D(r,{compressed:d,encrypted:p,checksum:y}),c=false,s=[],h=0,o=null;return new TransformStream({async transform(a,u){if(f){if(!c){let k=chunkFACJ5LAG_cjs.z(m,{compressionAlgorithm:void 0,encrypted:false});u.enqueue(k),c=true;}let i;o&&o.length>0?(i=new Uint8Array(o.length+a.length),i.set(o,0),i.set(a,o.length)):i=a;let g=r.bitLength,S=U(g,8)/8,l=Math.floor(i.length/S)*S;if(l>0){let k=i.subarray(0,l),E=await e.encodeAsync(k,{compress:false,encrypt:false,checksum:false,chunkSize:void 0,chunkSeparator:void 0,omitFooter:true});u.enqueue(E);}l<i.length?o=i.slice(l):o=null;}else s.push(a),h+=a.length;},async flush(a){try{if(f){if(!c){let u=chunkFACJ5LAG_cjs.z(m,{compressionAlgorithm:void 0,encrypted:!1});a.enqueue(u);}if(o&&o.length>0){let u=await e.encodeAsync(o,{compress:!1,encrypt:!1,checksum:!1,chunkSize:void 0,chunkSeparator:void 0});a.enqueue(u);}o=null;}else {let u=chunkFACJ5LAG_cjs.z(m,{compressionAlgorithm:t,encrypted:p});if(a.enqueue(u),h>0){let i=new Uint8Array(h),g=0;for(let l of s)i.set(l,g),g+=l.length;let S=await e.encodeAsync(i,{...n,compress:d,encrypt:p,checksum:y,chunkSize:void 0,chunkSeparator:void 0});a.enqueue(S);}s=[],h=0;}}catch(u){a.error(chunkFACJ5LAG_cjs.w(u,"stream"));}}})}function L(e,n){let r=e.getCharSetInfo(),d=r.paddingChar,p=chunkFACJ5LAG_cjs.y(d),y=n?.checksum??r.defaultChecksum,t="",m=false,f=null;return new TransformStream({async transform(c,s){if(t+=c,!m&&t.length>=p){if(!t.startsWith(d)){s.error(new Error("[WebStreams decode] Invalid or missing stream header"));return}if(f=chunkFACJ5LAG_cjs.A(t,d),f===null){s.error(new Error("[WebStreams decode] Invalid or missing stream header"));return}if(f.encrypted&&!r.hasEncryptionKey){s.error(new Error("[WebStreams decode] Encrypted stream requires an encryptionKey"));return}m=true,t=t.slice(p);}},async flush(c){try{if(!m){if(t.length===0)return;c.error(new Error("[WebStreams decode] Incomplete stream header"));return}if(t.length===0)return;let s=f.compressionAlgorithm,h=await e.decodeToUint8ArrayAsync(t,{...n,compress:n?.compress,compressionAlgorithm:s,encrypt:n?.encrypt,checksum:y,chunkSize:void 0,chunkSeparator:void 0});h.length>0&&c.enqueue(h),t="";}catch(s){c.error(chunkFACJ5LAG_cjs.w(s,"stream"));}}})}function D(e,n){return e.usePowerOfTwo&&!n.compressed&&!n.encrypted&&!n.checksum}function U(e,n){return e*n/I(e,n)}function I(e,n){for(;n!==0;){let r=n;n=e%n,e=r;}return e}exports.a=R;exports.b=W;exports.c=L;//# sourceMappingURL=chunk-WS6GB27C.cjs.map
+//# sourceMappingURL=chunk-WS6GB27C.cjs.map

package/dist/core.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkJZSHJ6KN_cjs=require('./chunk-JZSHJ6KN.cjs');Object.defineProperty(exports,"CharsetBuilder",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.l}});Object.defineProperty(exports,"Ddu64",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.k}});Object.defineProperty(exports,"Ddu64Core",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.k}});Object.defineProperty(exports,"DduSetSymbol",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.d}});Object.defineProperty(exports,"getWasmCodec",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.h}});Object.defineProperty(exports,"getWasmCodecSync",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.i}});Object.defineProperty(exports,"preloadWasm",{enumerable:true,get:function(){return chunkJZSHJ6KN_cjs.g}});//# sourceMappingURL=core.cjs.map
+'use strict';var chunkFACJ5LAG_cjs=require('./chunk-FACJ5LAG.cjs');Object.defineProperty(exports,"CharsetBuilder",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.C}});Object.defineProperty(exports,"Ddu64",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.B}});Object.defineProperty(exports,"Ddu64AdapterError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.s}});Object.defineProperty(exports,"Ddu64CharsetError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.q}});Object.defineProperty(exports,"Ddu64ChecksumError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.p}});Object.defineProperty(exports,"Ddu64CompressionError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.l}});Object.defineProperty(exports,"Ddu64Core",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.B}});Object.defineProperty(exports,"Ddu64DecodeError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.k}});Object.defineProperty(exports,"Ddu64DecompressionError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.m}});Object.defineProperty(exports,"Ddu64DecryptionError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.o}});Object.defineProperty(exports,"Ddu64EncodeError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.j}});Object.defineProperty(exports,"Ddu64EncryptionError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.n}});Object.defineProperty(exports,"Ddu64Error",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.i}});Object.defineProperty(exports,"Ddu64ErrorCode",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.h}});Object.defineProperty(exports,"Ddu64LimitError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.r}});Object.defineProperty(exports,"Ddu64ObfuscationError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.t}});Object.defineProperty(exports,"Ddu64StreamError",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.u}});Object.defineProperty(exports,"DduSetSymbol",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.a}});Object.defineProperty(exports,"getWasmCodec",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.e}});Object.defineProperty(exports,"getWasmCodecSync",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.f}});Object.defineProperty(exports,"isDdu64Error",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.v}});Object.defineProperty(exports,"preloadWasm",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.d}});//# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/core.d.cts

@@ -1 +1,40 @@
-export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, D as Ddu64, D as Ddu64Core, a as DduConstructorOptions, d as DduEncodeStats, e as DduOptions, f as DduProgressInfo, g as DduSetSymbol, h as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, i as KeyDerivationOptions, O as ObfuscationLayer, P as PlatformAdapter, W as WasmCodec, j as getWasmCodec, k as getWasmCodecSync, p as preloadWasm } from './core-DYSnygnp.cjs';
+import { W as WasmCodec } from './errors-DxOlTuHc.cjs';
+export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, D as Ddu64, d as Ddu64AdapterError, e as Ddu64CharsetError, f as Ddu64ChecksumError, g as Ddu64CompressionError, D as Ddu64Core, h as Ddu64DecodeError, i as Ddu64DecompressionError, j as Ddu64DecryptionError, k as Ddu64EncodeError, l as Ddu64EncryptionError, m as Ddu64Error, n as Ddu64ErrorCode, o as Ddu64ErrorOptions, p as Ddu64LimitError, q as Ddu64ObfuscationError, r as Ddu64Operation, s as Ddu64StreamError, a as DduConstructorOptions, t as DduEncodeStats, u as DduOptions, v as DduProgressInfo, w as DduSetSymbol, x as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, y as KeyDerivationOptions, O as ObfuscationLayer, P as PlatformAdapter, z as isDdu64Error } from './errors-DxOlTuHc.cjs';
+
+/**
+ * ddunigma 비트 패킹 가속을 위한 WASM 로더 및 통합.
+ *
+ * 순수 JavaScript 구현과 바이트 단위로 동일한 선택적 WASM 가속
+ * 인코딩/디코딩을 제공합니다. WASM을 사용할 수 없거나 실패하면
+ * 조용히 JS로 폴백합니다.
+ *
+ * @module wasm/WasmCodec
+ */
+
+/**
+ * WASM 모듈을 사전 로드하고 초기화합니다.
+ *
+ * 첫 번째 인코딩/디코딩 연산 전에 WASM이 준비되도록 애플리케이션 초기에
+ * 호출하세요. WASM이 초기화되면 resolve되고, 10초 내에 초기화에 실패하면
+ * reject됩니다.
+ *
+ * @throws WASM 초기화가 실패하거나 타임아웃(10초)된 경우 에러
+ */
+declare function preloadWasm(): Promise<void>;
+/**
+ * WASM 코덱이 준비되었으면 반환하거나, 온디맨드 초기화를 시도합니다.
+ *
+ * `preloadWasm()`이 호출되지 않았으면 5초 타임아웃으로 초기화를 시도합니다.
+ * WASM을 사용할 수 없으면 null을 반환합니다.
+ *
+ * 이 함수는 throw하지 않음 — 실패 시 null을 반환합니다.
+ */
+declare function getWasmCodec(): WasmCodec | null;
+/**
+ * WASM 코덱이 이미 초기화된 경우에만 반환합니다.
+ * 온디맨드 초기화를 트리거하지 않습니다.
+ * WASM이 준비되지 않았으면 null을 반환합니다.
+ */
+declare function getWasmCodecSync(): WasmCodec | null;
+
+export { WasmCodec, getWasmCodec, getWasmCodecSync, preloadWasm };

package/dist/core.d.ts

@@ -1 +1,40 @@
-export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, D as Ddu64, D as Ddu64Core, a as DduConstructorOptions, d as DduEncodeStats, e as DduOptions, f as DduProgressInfo, g as DduSetSymbol, h as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, i as KeyDerivationOptions, O as ObfuscationLayer, P as PlatformAdapter, W as WasmCodec, j as getWasmCodec, k as getWasmCodecSync, p as preloadWasm } from './core-DYSnygnp.js';
+import { W as WasmCodec } from './errors-DxOlTuHc.js';
+export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, D as Ddu64, d as Ddu64AdapterError, e as Ddu64CharsetError, f as Ddu64ChecksumError, g as Ddu64CompressionError, D as Ddu64Core, h as Ddu64DecodeError, i as Ddu64DecompressionError, j as Ddu64DecryptionError, k as Ddu64EncodeError, l as Ddu64EncryptionError, m as Ddu64Error, n as Ddu64ErrorCode, o as Ddu64ErrorOptions, p as Ddu64LimitError, q as Ddu64ObfuscationError, r as Ddu64Operation, s as Ddu64StreamError, a as DduConstructorOptions, t as DduEncodeStats, u as DduOptions, v as DduProgressInfo, w as DduSetSymbol, x as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, y as KeyDerivationOptions, O as ObfuscationLayer, P as PlatformAdapter, z as isDdu64Error } from './errors-DxOlTuHc.js';
+
+/**
+ * ddunigma 비트 패킹 가속을 위한 WASM 로더 및 통합.
+ *
+ * 순수 JavaScript 구현과 바이트 단위로 동일한 선택적 WASM 가속
+ * 인코딩/디코딩을 제공합니다. WASM을 사용할 수 없거나 실패하면
+ * 조용히 JS로 폴백합니다.
+ *
+ * @module wasm/WasmCodec
+ */
+
+/**
+ * WASM 모듈을 사전 로드하고 초기화합니다.
+ *
+ * 첫 번째 인코딩/디코딩 연산 전에 WASM이 준비되도록 애플리케이션 초기에
+ * 호출하세요. WASM이 초기화되면 resolve되고, 10초 내에 초기화에 실패하면
+ * reject됩니다.
+ *
+ * @throws WASM 초기화가 실패하거나 타임아웃(10초)된 경우 에러
+ */
+declare function preloadWasm(): Promise<void>;
+/**
+ * WASM 코덱이 준비되었으면 반환하거나, 온디맨드 초기화를 시도합니다.
+ *
+ * `preloadWasm()`이 호출되지 않았으면 5초 타임아웃으로 초기화를 시도합니다.
+ * WASM을 사용할 수 없으면 null을 반환합니다.
+ *
+ * 이 함수는 throw하지 않음 — 실패 시 null을 반환합니다.
+ */
+declare function getWasmCodec(): WasmCodec | null;
+/**
+ * WASM 코덱이 이미 초기화된 경우에만 반환합니다.
+ * 온디맨드 초기화를 트리거하지 않습니다.
+ * WASM이 준비되지 않았으면 null을 반환합니다.
+ */
+declare function getWasmCodecSync(): WasmCodec | null;
+
+export { WasmCodec, getWasmCodec, getWasmCodecSync, preloadWasm };

package/dist/core.js

@@ -1,2 +1,2 @@
-export{l as CharsetBuilder,k as Ddu64,k as Ddu64Core,d as DduSetSymbol,h as getWasmCodec,i as getWasmCodecSync,g as preloadWasm}from'./chunk-KEWLOPEV.js';//# sourceMappingURL=core.js.map
+export{C as CharsetBuilder,B as Ddu64,s as Ddu64AdapterError,q as Ddu64CharsetError,p as Ddu64ChecksumError,l as Ddu64CompressionError,B as Ddu64Core,k as Ddu64DecodeError,m as Ddu64DecompressionError,o as Ddu64DecryptionError,j as Ddu64EncodeError,n as Ddu64EncryptionError,i as Ddu64Error,h as Ddu64ErrorCode,r as Ddu64LimitError,t as Ddu64ObfuscationError,u as Ddu64StreamError,a as DduSetSymbol,e as getWasmCodec,f as getWasmCodecSync,v as isDdu64Error,d as preloadWasm}from'./chunk-65RDFQV7.js';//# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/{core-DYSnygnp.d.cts → errors-DxOlTuHc.d.cts}

@@ -159,23 +159,11 @@ interface DduConstructorOptions extends DduOptions {
     paddingChar?: string;
     /** 필요 문자 수 */
     requiredLength?: number;
-    /**
-     * 비트 길이.
-     * @deprecated 무시되는 옵션입니다. 심볼당 비트 수는 charset 길이에서 자동 계산됩니다.
-     */
-    bitLength?: number;
     /** 2의 제곱수 강제 여부 */
     usePowerOfTwo?: boolean;
     /**
      * true이면 초기화 오류 시 throw합니다. false이면 fallback charset으로 대체합니다.
      * @default false
-     * @deprecated throwOnError를 사용하세요. 이 옵션은 하위 호환성을 위해 유지됩니다.
-     */
-    useBuildErrorReturn?: boolean;
-    /**
-     * true이면 초기화 오류 시 throw합니다. false이면 fallback charset으로 대체합니다.
-     * useBuildErrorReturn과 동일한 동작이며, 둘 다 지정 시 throwOnError가 우선합니다.
-     * @default false
      */
     throwOnError?: boolean;
     /** URL-Safe 모드 (특수문자를 URL 안전 문자로 변환) */
@@ -188,7 +176,7 @@ interface DduConstructorOptions extends DduOptions {
     useRepeatPadding?: boolean;
     /** 명시적 플랫폼 어댑터 (자동 감지 대신 사용) */
     adapter?: PlatformAdapter;
-    /** WASM 임계값 (바이트 단위, 기본값: 4096, 범위: 1024-1048576) */
+    /** WASM 임계값 (바이트 단위, 기본값: 4096, 범위: 1024-1048576, Infinity면 비활성화) */
     wasmThreshold?: number;
 }
 /**
@@ -204,13 +192,13 @@ interface PlatformAdapter {
     /** 동기적으로 256비트 키를 파생 (Node.js 전용) */
     deriveKeySync?(key: string, options?: KeyDerivationOptions): Uint8Array;
     /** AES-256-GCM으로 데이터를 암호화. IV(12) + authTag(16) + 암호문을 반환 */
-    encrypt(data: Uint8Array, keyHash: Uint8Array): Promise<Uint8Array>;
+    encrypt(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Promise<Uint8Array>;
     /** 동기적으로 데이터를 암호화 (Node.js 전용) */
-    encryptSync?(data: Uint8Array, keyHash: Uint8Array): Uint8Array;
+    encryptSync?(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Uint8Array;
     /** AES-256-GCM 페이로드를 복호화. IV(12) + authTag(16) + 암호문 형식을 기대 */
-    decrypt(data: Uint8Array, keyHash: Uint8Array): Promise<Uint8Array>;
+    decrypt(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Promise<Uint8Array>;
     /** 동기적으로 데이터를 복호화 (Node.js 전용) */
-    decryptSync?(data: Uint8Array, keyHash: Uint8Array): Uint8Array;
+    decryptSync?(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Uint8Array;
     /** 암호학적으로 안전한 랜덤 바이트를 생성 */
     randomBytes(length: number): Uint8Array;
     /** deflate 알고리즘으로 데이터를 압축 */
@@ -379,12 +367,14 @@ declare class Ddu64Core {
     private readonly wasmThreshold;
     /** 표준 Base64 charset에서 네이티브 Base64 fast path 사용 여부 */
     private readonly canUseNativeBase64;
+    /** 인코딩/디코딩 payload codec 공유 컨텍스트 */
+    private readonly payloadCodecContext;
     /** 플랫폼 어댑터 (동기용 지연 로드 또는 명시적 제공) */
     private adapter;
     /** 기본 난독화 활성화 */
     private readonly defaultObfuscate;
     /** 지연 초기화되는 난독화 레이어 */
-    private _obfuscationLayer;
+    private obfuscationLayer;
     constructor(dduChar?: string[] | string | DduConstructorOptions, paddingChar?: string, dduOptions?: DduConstructorOptions);
     /**
      * 입력 데이터를 charset 인코딩 문자열로 인코딩합니다.
@@ -393,6 +383,7 @@ declare class Ddu64Core {
      * @param options - 인코딩 옵션
      * @returns 인코딩된 문자열
      * @throws 동기 암호화/압축이 필요하지만 어댑터가 지원하지 않는 경우
+     * @group Sync
      */
     encode(input: Uint8Array | string, options?: DduOptions): string;
     /**
@@ -401,6 +392,7 @@ declare class Ddu64Core {
      * @param input - 디코딩할 인코딩된 문자열
      * @param options - 디코딩 옵션
      * @returns 디코딩된 문자열
+     * @group Sync
      */
     decode(input: string, options?: DduOptions): string;
     /**
@@ -409,33 +401,46 @@ declare class Ddu64Core {
      * @param input - 디코딩할 인코딩된 문자열
      * @param options - 디코딩 옵션
      * @returns 디코딩된 바이트
+     * @group Sync
      */
     decodeToUint8Array(input: string, options?: DduOptions): Uint8Array;
+    private decodeToUint8ArrayInternal;
     /**
      * 비동기 인코딩 - 브라우저를 포함한 모든 런타임에서 동작합니다.
+     *
+     * @group Async
      */
     encodeAsync(input: Uint8Array | string, options?: DduOptions): Promise<string>;
+    private encodeAsyncInternal;
     /**
      * 비동기 디코딩 - 브라우저를 포함한 모든 런타임에서 동작합니다.
+     *
+     * @group Async
      */
     decodeAsync(input: string, options?: DduOptions): Promise<string>;
     /**
      * 비동기 Uint8Array 디코딩 - 브라우저를 포함한 모든 런타임에서 동작합니다.
+     *
+     * @group Async
      */
     decodeToUint8ArrayAsync(input: string, options?: DduOptions): Promise<Uint8Array>;
+    private decodeToUint8ArrayAsyncInternal;
     /**
      * charset 정보를 가져옵니다.
+     *
+     * @group Introspection
      */
     getCharSetInfo(): CharSetInfo;
     /**
      * 인코딩 통계를 가져옵니다.
+     *
+     * @group Introspection
      */
     getStats(input: Uint8Array | string, options?: DduOptions): DduEncodeStats;
     /**
      * 통계를 위한 메타데이터 포함 내부 인코딩.
      */
     private encodeInternal;
-    private resolveEncodeSettings;
     /**
      * 인코딩 마무리: 비트팩 인코딩 + 후처리(난독화/체크섬/URL-safe/청킹).
      * 동기/비동기 인코딩에서 공유하는 순수 동기 단계입니다.
@@ -445,43 +450,19 @@ declare class Ddu64Core {
      * 인코딩 후처리: 난독화, 체크섬, URL-safe, 청킹을 적용합니다.
      */
     private applyPostEncoding;
-    /**
-     * BitPack + 푸터를 사용하여 바이트를 charset 문자열로 인코딩합니다.
-     */
-    private encodeBytes;
     /**
      * 디코딩 전처리: 동기/비동기 디코딩에서 공통으로 쓰는 순수 동기 단계.
      * 청크 제거 → URL-safe 역변환 → 체크섬 추출 → 역난독화 → 푸터 파싱 →
      * 검증(정렬/패딩/크기) → 비트팩 해제까지 수행합니다.
      */
     private decodePrelude;
-    /**
-     * 압축 해제 단계를 실행해야 하는지 결정합니다.
-     * (압축 마커 존재 + 내부 압축 해제 허용 + 파이프라인 단계 조건)
-     */
-    private shouldDecompress;
-    /**
-     * 추출된 체크섬이 있으면 복원된 데이터의 CRC32와 비교 검증합니다.
-     * 동기/비동기 디코딩에서 공유하는 순수 동기 단계입니다.
-     */
-    private verifyDecodedChecksum;
-    /**
-     * charset 문자열을 인덱스로 변환한 후 BitPack으로 바이트를 얻습니다.
-     */
-    private decodeChars;
-    private encodeBytesWithNativeBase64;
-    private decodeCharsWithNativeBase64;
-    private bytesToBase64;
-    private base64ToBytes;
-    private shouldUseWasm;
+    private getPayloadCodecContext;
     private reportProgress;
-    private requireSyncAdapter;
     private encryptSync;
     private decryptSync;
     private compressSync;
     private decompressSync;
-    private getAdapterAsync;
-    private getKeyHashAsync;
+    private getSyncGatewayContext;
     /**
      * 난독화 레이어를 가져오거나 생성합니다 (지연 초기화).
      * 알파벳에는 charset 문자, 패딩 문자, 모든 푸터 마커 문자가 포함됩니다.
@@ -493,12 +474,8 @@ declare class Ddu64Core {
      * 암호화 키 없이 난독화가 활성화되면 throw합니다.
      */
     private shouldObfuscate;
-    private normalizeLimit;
     private assertSafeChunkSeparator;
     private isLineBreakSeparator;
-    private estimateDecodedBytes;
-    private assertEncodedInputAligned;
-    private assertCanonicalPadding;
 }
 
 /**
@@ -634,39 +611,75 @@ declare class CharsetBuilder {
 }
 
 /**
- * ddunigma 비트 패킹 가속을 위한 WASM 로더 및 통합.
+ * ddunigma custom error hierarchy.
  *
- * 순수 JavaScript 구현과 바이트 단위로 동일한 선택적 WASM 가속
- * 인코딩/디코딩을 제공합니다. WASM을 사용할 수 없거나 실패하면
- * 조용히 JS로 폴백합니다.
+ * Public encode/decode APIs wrap internal/runtime failures in these typed
+ * errors so callers can branch on a stable code without parsing messages.
  *
- * @module wasm/WasmCodec
+ * @module core/errors
  */
+type Ddu64Operation = "construct" | "encode" | "decode" | "compress" | "decompress" | "encrypt" | "decrypt" | "checksum" | "charset" | "adapter" | "obfuscation" | "stream";
+declare enum Ddu64ErrorCode {
+    EncodeFailed = "DDU64_ENCODE_FAILED",
+    DecodeFailed = "DDU64_DECODE_FAILED",
+    CompressionFailed = "DDU64_COMPRESSION_FAILED",
+    DecompressionFailed = "DDU64_DECOMPRESSION_FAILED",
+    EncryptionFailed = "DDU64_ENCRYPTION_FAILED",
+    DecryptionFailed = "DDU64_DECRYPTION_FAILED",
+    ChecksumMismatch = "DDU64_CHECKSUM_MISMATCH",
+    InvalidCharset = "DDU64_INVALID_CHARSET",
+    InvalidInput = "DDU64_INVALID_INPUT",
+    LimitExceeded = "DDU64_LIMIT_EXCEEDED",
+    AdapterUnavailable = "DDU64_ADAPTER_UNAVAILABLE",
+    ObfuscationFailed = "DDU64_OBFUSCATION_FAILED",
+    StreamFailed = "DDU64_STREAM_FAILED"
+}
+interface Ddu64ErrorOptions {
+    code: Ddu64ErrorCode;
+    operation: Ddu64Operation;
+    cause?: unknown;
+}
+declare class Ddu64Error extends Error {
+    readonly code: Ddu64ErrorCode;
+    readonly operation: Ddu64Operation;
+    constructor(message: string, options: Ddu64ErrorOptions);
+}
+declare class Ddu64EncodeError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64DecodeError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64CompressionError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64DecompressionError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64EncryptionError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64DecryptionError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64ChecksumError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64CharsetError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64LimitError extends Ddu64Error {
+    constructor(message: string, operation: Ddu64Operation, cause?: unknown);
+}
+declare class Ddu64AdapterError extends Ddu64Error {
+    constructor(message: string, operation: Ddu64Operation, cause?: unknown);
+}
+declare class Ddu64ObfuscationError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare class Ddu64StreamError extends Ddu64Error {
+    constructor(message: string, cause?: unknown);
+}
+declare function isDdu64Error(error: unknown): error is Ddu64Error;
 
-/**
- * WASM 모듈을 사전 로드하고 초기화합니다.
- *
- * 첫 번째 인코딩/디코딩 연산 전에 WASM이 준비되도록 애플리케이션 초기에
- * 호출하세요. WASM이 초기화되면 resolve되고, 10초 내에 초기화에 실패하면
- * reject됩니다.
- *
- * @throws WASM 초기화가 실패하거나 타임아웃(10초)된 경우 에러
- */
-declare function preloadWasm(): Promise<void>;
-/**
- * WASM 코덱이 준비되었으면 반환하거나, 온디맨드 초기화를 시도합니다.
- *
- * `preloadWasm()`이 호출되지 않았으면 5초 타임아웃으로 초기화를 시도합니다.
- * WASM을 사용할 수 없으면 null을 반환합니다.
- *
- * 이 함수는 throw하지 않음 — 실패 시 null을 반환합니다.
- */
-declare function getWasmCodec(): WasmCodec | null;
-/**
- * WASM 코덱이 이미 초기화된 경우에만 반환합니다.
- * 온디맨드 초기화를 트리거하지 않습니다.
- * WASM이 준비되지 않았으면 null을 반환합니다.
- */
-declare function getWasmCodecSync(): WasmCodec | null;
-
-export { type CharSetConfig as C, Ddu64Core as D, type EncodingProfile as E, type KeyDerivationAlgorithm as K, type ObfuscationLayer as O, type PlatformAdapter as P, type TestVector as T, type WasmCodec as W, type DduConstructorOptions as a, type CharSetInfo as b, CharsetBuilder as c, type DduEncodeStats as d, type DduOptions as e, type DduProgressInfo as f, DduSetSymbol as g, type DduTextEncoding as h, type KeyDerivationOptions as i, getWasmCodec as j, getWasmCodecSync as k, preloadWasm as p };
+export { type CharSetConfig as C, Ddu64Core as D, type EncodingProfile as E, type KeyDerivationAlgorithm as K, type ObfuscationLayer as O, type PlatformAdapter as P, type TestVector as T, type WasmCodec as W, type DduConstructorOptions as a, type CharSetInfo as b, CharsetBuilder as c, Ddu64AdapterError as d, Ddu64CharsetError as e, Ddu64ChecksumError as f, Ddu64CompressionError as g, Ddu64DecodeError as h, Ddu64DecompressionError as i, Ddu64DecryptionError as j, Ddu64EncodeError as k, Ddu64EncryptionError as l, Ddu64Error as m, Ddu64ErrorCode as n, type Ddu64ErrorOptions as o, Ddu64LimitError as p, Ddu64ObfuscationError as q, type Ddu64Operation as r, Ddu64StreamError as s, type DduEncodeStats as t, type DduOptions as u, type DduProgressInfo as v, DduSetSymbol as w, type DduTextEncoding as x, type KeyDerivationOptions as y, isDdu64Error as z };