@ddunigma/node 4.0.1 → 5.0.0

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

@@ -9,6 +9,11 @@ declare enum DduSetSymbol {
     DDU_V1 = "ddu_v1",
     ONECHARSET = "oneCharSet"
 }
+/**
+ * @deprecated ddunigma runtime string encode/decode paths are UTF-8 based.
+ * This union remains for legacy type compatibility and `CharSetInfo.encoding`
+ * metadata only; non-UTF-8 values do not change runtime text conversion.
+ */
 type DduTextEncoding = "utf-8" | "utf8" | "latin1" | "ascii" | "base64" | "base64url" | "hex" | "binary" | "ucs2" | "ucs-2" | "utf16le" | "utf-16le";
 interface EncodingProfile {
     /** 논리 심볼당 비트 수 */
@@ -63,6 +68,12 @@ interface CharSetInfo {
     hasEncryptionKey: boolean;
     /** 기본 체크섬 사용 여부 */
     defaultChecksum: boolean;
+    /** 기본 체크섬 계산 범위 (5.0: "output") */
+    defaultChecksumScope: "plaintext" | "output";
+    /** 기본 난독화 사용 여부 */
+    defaultObfuscate: boolean;
+    /** WASM 사용 임계값 (바이트) */
+    wasmThreshold: number;
     /** 기본 청크 크기 */
     defaultChunkSize: number | undefined;
     /** 기본 청크 구분자 */
@@ -103,12 +114,13 @@ interface DduEncodeStats {
 type KeyDerivationAlgorithm = "sha256" | "pbkdf2";
 interface KeyDerivationOptions {
     /**
-     * Key derivation algorithm. Defaults to `sha256` for legacy compatibility.
+     * Key derivation algorithm. Defaults to `pbkdf2` (5.0).
      *
-     * ⚠️ Security: the default `sha256` is a single, unsalted hash and is fast to
-     * brute-force. For low-entropy keys (human passwords) protecting production
-     * data, use `pbkdf2` with an application-specific `salt`. Keep `sha256` only
-     * for high-entropy keys (e.g. 32 random bytes) or legacy data compatibility.
+     * ⚠️ Migration: 4.x defaulted to `sha256`. Data encrypted with 4.x defaults must be decrypted with
+     * `algorithm: "sha256"` explicitly (key derivation is NOT self-described in the wire format).
+     * For low-entropy keys (human passwords), keep the `pbkdf2` default and provide an
+     * application-specific `salt`. Use `sha256` only for high-entropy keys (e.g. 32 random bytes) or
+     * legacy data compatibility.
      */
     algorithm?: KeyDerivationAlgorithm;
     /**
@@ -125,7 +137,11 @@ interface KeyDerivationOptions {
 interface DduOptions {
     /** 압축 사용 여부 (zlib deflate 또는 brotli) */
     compress?: boolean;
-    /** 내부 암/복호화 사용 여부 (기본값: true, 스트림 파이프라인 내부 제어용) */
+    /**
+     * 내부 암/복호화 사용 여부 (기본값: true, 스트림 파이프라인 내부 제어용).
+     * @internal 일반 사용자는 `encryptionKey`로 암호화를 제어하세요. 이 플래그는
+     * 스트림/내부 파이프라인 전용이며 향후 공개 옵션에서 분리될 수 있습니다.
+     */
     encrypt?: boolean;
     /** 압축 알고리즘 (기본값: "deflate") */
     compressionAlgorithm?: "deflate" | "brotli";
@@ -137,11 +153,23 @@ interface DduOptions {
     maxDecompressedBytes?: number;
     /** 체크섬 추가 여부 (CRC32) */
     checksum?: boolean;
+    /**
+     * 체크섬 계산 범위 (기본값: "output").
+     * - `"plaintext"`: 원본 입력 바이트의 CRC32 (레거시 범위). 암호화와 함께 쓰면 평문 CRC가 출력에 노출됩니다.
+     * - `"output"`: 인코딩 파이프라인 최종 바이트(압축/암호화 후, 와이어에 실리는 바이트)의 CRC32.
+     *   암호화 시 평문 CRC를 노출하지 않고, 복호화 이전에 전송 손상을 감지합니다.
+     *
+     * `checksum`과 마찬가지로 와이어에 자기기술 플래그가 없으므로 인코딩/디코딩에서 동일하게 지정해야 합니다.
+     */
+    checksumScope?: "plaintext" | "output";
     /** 청크 분할 크기 */
     chunkSize?: number;
     /** 청크 구분자 (기본값: '\n') */
     chunkSeparator?: string;
-    /** 중간 스트림 청크처럼 푸터를 생략해야 할 때 사용 */
+    /**
+     * 중간 스트림 청크처럼 푸터를 생략해야 할 때 사용.
+     * @internal 스트림 인코딩 내부 전용 플래그이며 향후 공개 옵션에서 분리될 수 있습니다.
+     */
     omitFooter?: boolean;
     /** 진행률 콜백 */
     onProgress?: (info: DduProgressInfo) => void;
@@ -151,6 +179,12 @@ interface DduOptions {
 interface DduConstructorOptions extends DduOptions {
     /** 미리 정의된 charset 심볼 */
     dduSetSymbol?: DduSetSymbol;
+    /**
+     * @deprecated Runtime string encode/decode paths are always UTF-8 based.
+     * This option is accepted for legacy type compatibility only and has no
+     * runtime effect.
+     */
+    encoding?: DduTextEncoding;
     /** 커스텀 charset 문자 배열 또는 문자열 */
     dduChar?: string[] | string;
     /** 종성 문자 배열 (dduChar × codaChar 조합으로 최종 charset 동적 생성) */
@@ -163,7 +197,10 @@ interface DduConstructorOptions extends DduOptions {
     usePowerOfTwo?: boolean;
     /**
      * true이면 초기화 오류 시 throw합니다. false이면 fallback charset으로 대체합니다.
-     * @default false
+     *
+     * ⚠️ 5.0 변경: 기본값이 `false` → `true`로 전환되었습니다. 잘못된 커스텀 charset에
+     * 더 엄격하게 동작하며, 레거시의 묵시적 fallback 동작이 필요하면 `false`를 명시하세요.
+     * @default true
      */
     throwOnError?: boolean;
     /** URL-Safe 모드 (특수문자를 URL 안전 문자로 변환) */
@@ -176,7 +213,7 @@ interface DduConstructorOptions extends DduOptions {
     useRepeatPadding?: boolean;
     /** 명시적 플랫폼 어댑터 (자동 감지 대신 사용) */
     adapter?: PlatformAdapter;
-    /** WASM 임계값 (바이트 단위, 기본값: 4096, 범위: 1024-1048576, Infinity면 비활성화) */
+    /** WASM 임계값 (바이트 단위, 기본값: 16384, 범위: 1024-1048576, Infinity면 비활성화) */
     wasmThreshold?: number;
 }
 /**
@@ -257,54 +294,6 @@ interface ObfuscationLayer {
      */
     deobfuscate(input: string): string;
 }
-/**
- * 크로스 플랫폼 인코딩 호환성 및 와이어 포맷 적합성을 검증하기 위한
- * 표준화된 테스트 벡터 형식.
- */
-interface TestVector {
-    /** 이 테스트 벡터의 고유 식별자 */
-    id: string;
-    /** 이 벡터가 테스트하는 내용에 대한 설명 */
-    description: string;
-    /** 입력 데이터 명세 */
-    input: {
-        /** 16진수 인코딩된 입력 바이트 */
-        raw: string;
-        /** 원시 데이터의 인코딩 */
-        encoding: "utf-8" | "binary";
-    };
-    /** 이 벡터의 charset 설정 */
-    charset: {
-        /** 프리셋 심볼 (내장 charset 사용 시) */
-        preset?: DduSetSymbol;
-        /** 커스텀 charset 문자 (프리셋 미사용 시) */
-        dduChar?: string[];
-        /** 조합 charset용 종성 문자 */
-        codaChar?: string[];
-        /** 패딩 문자 */
-        paddingChar: string;
-    };
-    /** 인코딩 옵션 */
-    options: {
-        compress?: boolean;
-        compressionAlgorithm?: "deflate" | "brotli";
-        encrypt?: boolean;
-        encryptionKey?: string;
-        checksum?: boolean;
-        urlSafe?: boolean;
-        chunkSize?: number;
-        useRepeatPadding?: boolean;
-    };
-    /** 기대 출력 */
-    expected: {
-        /** 기대되는 인코딩 문자열 */
-        encoded: string;
-        /** 바이너리 비교를 위한 16진수 표현 */
-        encodedHex?: string;
-    };
-    /** 테스트 벡터 분류 태그 */
-    tags: string[];
-}
 
 /**
  * 플랫폼 독립 Ddu64 인코더/디코더 코어.
@@ -331,8 +320,6 @@ declare class Ddu64Core {
     protected readonly usePowerOfTwo: boolean;
     /** UTF-16 코드 유닛 → 인덱스 direct lookup (단일 BMP 심볼 전용) */
     private readonly dduCharCodeLookup;
-    /** 미리 정의된 charset 사용 여부 */
-    private readonly isPredefinedCharSet;
     /** 기본 압축 활성화 */
     protected readonly defaultCompress: boolean;
     /** 기본 최대 디코딩 바이트 수 */
@@ -347,8 +334,12 @@ declare class Ddu64Core {
     private readonly keyDerivation;
     /** 캐시된 암호화 키 해시 */
     private encryptionKeyHash;
+    /** 캐시된 어댑터 게이트웨이 컨텍스트 (호출당 재할당 방지, 해시는 getter로 라이브 조회) */
+    private syncGatewayContext;
     /** 기본 체크섬 활성화 */
     private readonly defaultChecksum;
+    /** 기본 체크섬 계산 범위 */
+    private readonly defaultChecksumScope;
     /** 기본 청크 크기 */
     private readonly defaultChunkSize;
     /** 기본 청크 구분자 */
@@ -375,6 +366,19 @@ declare class Ddu64Core {
     private readonly defaultObfuscate;
     /** 지연 초기화되는 난독화 레이어 */
     private obfuscationLayer;
+    /**
+     * Ddu64 인코더/디코더를 생성합니다.
+     *
+     * 권장: 옵션 객체 단일 인자 형태 — `new Ddu64({ dduSetSymbol, compress, ... })`.
+     *
+     * 위치 인자 형태 `new Ddu64(dduChar, paddingChar, options)`는 커스텀 charset
+     * 지정용으로 계속 지원되지만, 가독성을 위해 옵션 객체 형태를 우선 권장합니다.
+     * (`new Ddu64(charset, padding, options)` 또는 `new Ddu64({ dduChar, paddingChar, ...options })`)
+     *
+     * @param dduChar - 커스텀 charset(문자열/배열) 또는 옵션 객체
+     * @param paddingChar - 패딩 문자 (커스텀 charset 사용 시 필수)
+     * @param dduOptions - 추가 옵션
+     */
     constructor(dduChar?: string[] | string | DduConstructorOptions, paddingChar?: string, dduOptions?: DduConstructorOptions);
     /**
      * 입력 데이터를 charset 인코딩 문자열로 인코딩합니다.
@@ -425,6 +429,11 @@ declare class Ddu64Core {
      */
     decodeToUint8ArrayAsync(input: string, options?: DduOptions): Promise<Uint8Array>;
     private decodeToUint8ArrayAsyncInternal;
+    /**
+     * 동기/비동기 디코딩 파이프라인이 공유하는 기본 컨텍스트를 구성합니다.
+     * decrypt/decompress만 동기/비동기 구현에서 각각 덧붙입니다.
+     */
+    private buildDecodeBaseContext;
     /**
      * charset 정보를 가져옵니다.
      *
@@ -437,10 +446,37 @@ declare class Ddu64Core {
      * @group Introspection
      */
     getStats(input: Uint8Array | string, options?: DduOptions): DduEncodeStats;
+    /**
+     * 비동기 인코딩 통계를 가져옵니다.
+     *
+     * 브라우저/Workers처럼 압축이 비동기 API로만 제공되는 런타임에서는 `compress: true`
+     * 통계 계산에 이 메서드를 사용하세요.
+     *
+     * @group Introspection
+     */
+    getStatsAsync(input: Uint8Array | string, options?: DduOptions): Promise<DduEncodeStats>;
+    private buildEncodeStats;
     /**
      * 통계를 위한 메타데이터 포함 내부 인코딩.
      */
     private encodeInternal;
+    /**
+     * getStats 전용 인코딩: 실제 AES-GCM 연산을 생략하고 길이만 정확한 더미 암호화를 사용합니다.
+     *
+     * 암호화 출력 길이는 `평문 + AEAD_OVERHEAD_BYTES`로 결정적이고, 비트팩/푸터/체크섬/난독화/
+     * URL-safe/청킹은 모두 입력 바이트 "길이"에만 의존(바이트 "값"과 무관)하므로, 더미 암호문(0으로 채운
+     * 동일 길이 버퍼)으로 마무리해도 `encoded.length`는 실제 `encode()` 출력과 바이트 단위로 일치합니다.
+     * 압축은 결과 크기와 적용 여부 판단에 필요하므로 실제로 수행합니다.
+     *
+     * 이 등식(통계 길이 === 실제 encode 길이)은 property test로 고정됩니다.
+     */
+    private encodeStatsInternal;
+    private encodeStatsAsyncInternal;
+    /**
+     * 동기/비동기 인코딩 파이프라인이 공유하는 기본 컨텍스트를 구성합니다.
+     * compress/encrypt만 동기/비동기 구현에서 각각 덧붙입니다.
+     */
+    private buildEncodeBaseContext;
     /**
      * 인코딩 마무리: 비트팩 인코딩 + 후처리(난독화/체크섬/URL-safe/청킹).
      * 동기/비동기 인코딩에서 공유하는 순수 동기 단계입니다.
@@ -682,4 +718,4 @@ declare class Ddu64StreamError extends Ddu64Error {
 }
 declare function isDdu64Error(error: unknown): error is Ddu64Error;
 
-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 };
+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 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 };

package/dist/{errors-DxOlTuHc.d.ts → errors-DNICpo4L.d.ts}

@@ -9,6 +9,11 @@ declare enum DduSetSymbol {
     DDU_V1 = "ddu_v1",
     ONECHARSET = "oneCharSet"
 }
+/**
+ * @deprecated ddunigma runtime string encode/decode paths are UTF-8 based.
+ * This union remains for legacy type compatibility and `CharSetInfo.encoding`
+ * metadata only; non-UTF-8 values do not change runtime text conversion.
+ */
 type DduTextEncoding = "utf-8" | "utf8" | "latin1" | "ascii" | "base64" | "base64url" | "hex" | "binary" | "ucs2" | "ucs-2" | "utf16le" | "utf-16le";
 interface EncodingProfile {
     /** 논리 심볼당 비트 수 */
@@ -63,6 +68,12 @@ interface CharSetInfo {
     hasEncryptionKey: boolean;
     /** 기본 체크섬 사용 여부 */
     defaultChecksum: boolean;
+    /** 기본 체크섬 계산 범위 (5.0: "output") */
+    defaultChecksumScope: "plaintext" | "output";
+    /** 기본 난독화 사용 여부 */
+    defaultObfuscate: boolean;
+    /** WASM 사용 임계값 (바이트) */
+    wasmThreshold: number;
     /** 기본 청크 크기 */
     defaultChunkSize: number | undefined;
     /** 기본 청크 구분자 */
@@ -103,12 +114,13 @@ interface DduEncodeStats {
 type KeyDerivationAlgorithm = "sha256" | "pbkdf2";
 interface KeyDerivationOptions {
     /**
-     * Key derivation algorithm. Defaults to `sha256` for legacy compatibility.
+     * Key derivation algorithm. Defaults to `pbkdf2` (5.0).
      *
-     * ⚠️ Security: the default `sha256` is a single, unsalted hash and is fast to
-     * brute-force. For low-entropy keys (human passwords) protecting production
-     * data, use `pbkdf2` with an application-specific `salt`. Keep `sha256` only
-     * for high-entropy keys (e.g. 32 random bytes) or legacy data compatibility.
+     * ⚠️ Migration: 4.x defaulted to `sha256`. Data encrypted with 4.x defaults must be decrypted with
+     * `algorithm: "sha256"` explicitly (key derivation is NOT self-described in the wire format).
+     * For low-entropy keys (human passwords), keep the `pbkdf2` default and provide an
+     * application-specific `salt`. Use `sha256` only for high-entropy keys (e.g. 32 random bytes) or
+     * legacy data compatibility.
      */
     algorithm?: KeyDerivationAlgorithm;
     /**
@@ -125,7 +137,11 @@ interface KeyDerivationOptions {
 interface DduOptions {
     /** 압축 사용 여부 (zlib deflate 또는 brotli) */
     compress?: boolean;
-    /** 내부 암/복호화 사용 여부 (기본값: true, 스트림 파이프라인 내부 제어용) */
+    /**
+     * 내부 암/복호화 사용 여부 (기본값: true, 스트림 파이프라인 내부 제어용).
+     * @internal 일반 사용자는 `encryptionKey`로 암호화를 제어하세요. 이 플래그는
+     * 스트림/내부 파이프라인 전용이며 향후 공개 옵션에서 분리될 수 있습니다.
+     */
     encrypt?: boolean;
     /** 압축 알고리즘 (기본값: "deflate") */
     compressionAlgorithm?: "deflate" | "brotli";
@@ -137,11 +153,23 @@ interface DduOptions {
     maxDecompressedBytes?: number;
     /** 체크섬 추가 여부 (CRC32) */
     checksum?: boolean;
+    /**
+     * 체크섬 계산 범위 (기본값: "output").
+     * - `"plaintext"`: 원본 입력 바이트의 CRC32 (레거시 범위). 암호화와 함께 쓰면 평문 CRC가 출력에 노출됩니다.
+     * - `"output"`: 인코딩 파이프라인 최종 바이트(압축/암호화 후, 와이어에 실리는 바이트)의 CRC32.
+     *   암호화 시 평문 CRC를 노출하지 않고, 복호화 이전에 전송 손상을 감지합니다.
+     *
+     * `checksum`과 마찬가지로 와이어에 자기기술 플래그가 없으므로 인코딩/디코딩에서 동일하게 지정해야 합니다.
+     */
+    checksumScope?: "plaintext" | "output";
     /** 청크 분할 크기 */
     chunkSize?: number;
     /** 청크 구분자 (기본값: '\n') */
     chunkSeparator?: string;
-    /** 중간 스트림 청크처럼 푸터를 생략해야 할 때 사용 */
+    /**
+     * 중간 스트림 청크처럼 푸터를 생략해야 할 때 사용.
+     * @internal 스트림 인코딩 내부 전용 플래그이며 향후 공개 옵션에서 분리될 수 있습니다.
+     */
     omitFooter?: boolean;
     /** 진행률 콜백 */
     onProgress?: (info: DduProgressInfo) => void;
@@ -151,6 +179,12 @@ interface DduOptions {
 interface DduConstructorOptions extends DduOptions {
     /** 미리 정의된 charset 심볼 */
     dduSetSymbol?: DduSetSymbol;
+    /**
+     * @deprecated Runtime string encode/decode paths are always UTF-8 based.
+     * This option is accepted for legacy type compatibility only and has no
+     * runtime effect.
+     */
+    encoding?: DduTextEncoding;
     /** 커스텀 charset 문자 배열 또는 문자열 */
     dduChar?: string[] | string;
     /** 종성 문자 배열 (dduChar × codaChar 조합으로 최종 charset 동적 생성) */
@@ -163,7 +197,10 @@ interface DduConstructorOptions extends DduOptions {
     usePowerOfTwo?: boolean;
     /**
      * true이면 초기화 오류 시 throw합니다. false이면 fallback charset으로 대체합니다.
-     * @default false
+     *
+     * ⚠️ 5.0 변경: 기본값이 `false` → `true`로 전환되었습니다. 잘못된 커스텀 charset에
+     * 더 엄격하게 동작하며, 레거시의 묵시적 fallback 동작이 필요하면 `false`를 명시하세요.
+     * @default true
      */
     throwOnError?: boolean;
     /** URL-Safe 모드 (특수문자를 URL 안전 문자로 변환) */
@@ -176,7 +213,7 @@ interface DduConstructorOptions extends DduOptions {
     useRepeatPadding?: boolean;
     /** 명시적 플랫폼 어댑터 (자동 감지 대신 사용) */
     adapter?: PlatformAdapter;
-    /** WASM 임계값 (바이트 단위, 기본값: 4096, 범위: 1024-1048576, Infinity면 비활성화) */
+    /** WASM 임계값 (바이트 단위, 기본값: 16384, 범위: 1024-1048576, Infinity면 비활성화) */
     wasmThreshold?: number;
 }
 /**
@@ -257,54 +294,6 @@ interface ObfuscationLayer {
      */
     deobfuscate(input: string): string;
 }
-/**
- * 크로스 플랫폼 인코딩 호환성 및 와이어 포맷 적합성을 검증하기 위한
- * 표준화된 테스트 벡터 형식.
- */
-interface TestVector {
-    /** 이 테스트 벡터의 고유 식별자 */
-    id: string;
-    /** 이 벡터가 테스트하는 내용에 대한 설명 */
-    description: string;
-    /** 입력 데이터 명세 */
-    input: {
-        /** 16진수 인코딩된 입력 바이트 */
-        raw: string;
-        /** 원시 데이터의 인코딩 */
-        encoding: "utf-8" | "binary";
-    };
-    /** 이 벡터의 charset 설정 */
-    charset: {
-        /** 프리셋 심볼 (내장 charset 사용 시) */
-        preset?: DduSetSymbol;
-        /** 커스텀 charset 문자 (프리셋 미사용 시) */
-        dduChar?: string[];
-        /** 조합 charset용 종성 문자 */
-        codaChar?: string[];
-        /** 패딩 문자 */
-        paddingChar: string;
-    };
-    /** 인코딩 옵션 */
-    options: {
-        compress?: boolean;
-        compressionAlgorithm?: "deflate" | "brotli";
-        encrypt?: boolean;
-        encryptionKey?: string;
-        checksum?: boolean;
-        urlSafe?: boolean;
-        chunkSize?: number;
-        useRepeatPadding?: boolean;
-    };
-    /** 기대 출력 */
-    expected: {
-        /** 기대되는 인코딩 문자열 */
-        encoded: string;
-        /** 바이너리 비교를 위한 16진수 표현 */
-        encodedHex?: string;
-    };
-    /** 테스트 벡터 분류 태그 */
-    tags: string[];
-}
 
 /**
  * 플랫폼 독립 Ddu64 인코더/디코더 코어.
@@ -331,8 +320,6 @@ declare class Ddu64Core {
     protected readonly usePowerOfTwo: boolean;
     /** UTF-16 코드 유닛 → 인덱스 direct lookup (단일 BMP 심볼 전용) */
     private readonly dduCharCodeLookup;
-    /** 미리 정의된 charset 사용 여부 */
-    private readonly isPredefinedCharSet;
     /** 기본 압축 활성화 */
     protected readonly defaultCompress: boolean;
     /** 기본 최대 디코딩 바이트 수 */
@@ -347,8 +334,12 @@ declare class Ddu64Core {
     private readonly keyDerivation;
     /** 캐시된 암호화 키 해시 */
     private encryptionKeyHash;
+    /** 캐시된 어댑터 게이트웨이 컨텍스트 (호출당 재할당 방지, 해시는 getter로 라이브 조회) */
+    private syncGatewayContext;
     /** 기본 체크섬 활성화 */
     private readonly defaultChecksum;
+    /** 기본 체크섬 계산 범위 */
+    private readonly defaultChecksumScope;
     /** 기본 청크 크기 */
     private readonly defaultChunkSize;
     /** 기본 청크 구분자 */
@@ -375,6 +366,19 @@ declare class Ddu64Core {
     private readonly defaultObfuscate;
     /** 지연 초기화되는 난독화 레이어 */
     private obfuscationLayer;
+    /**
+     * Ddu64 인코더/디코더를 생성합니다.
+     *
+     * 권장: 옵션 객체 단일 인자 형태 — `new Ddu64({ dduSetSymbol, compress, ... })`.
+     *
+     * 위치 인자 형태 `new Ddu64(dduChar, paddingChar, options)`는 커스텀 charset
+     * 지정용으로 계속 지원되지만, 가독성을 위해 옵션 객체 형태를 우선 권장합니다.
+     * (`new Ddu64(charset, padding, options)` 또는 `new Ddu64({ dduChar, paddingChar, ...options })`)
+     *
+     * @param dduChar - 커스텀 charset(문자열/배열) 또는 옵션 객체
+     * @param paddingChar - 패딩 문자 (커스텀 charset 사용 시 필수)
+     * @param dduOptions - 추가 옵션
+     */
     constructor(dduChar?: string[] | string | DduConstructorOptions, paddingChar?: string, dduOptions?: DduConstructorOptions);
     /**
      * 입력 데이터를 charset 인코딩 문자열로 인코딩합니다.
@@ -425,6 +429,11 @@ declare class Ddu64Core {
      */
     decodeToUint8ArrayAsync(input: string, options?: DduOptions): Promise<Uint8Array>;
     private decodeToUint8ArrayAsyncInternal;
+    /**
+     * 동기/비동기 디코딩 파이프라인이 공유하는 기본 컨텍스트를 구성합니다.
+     * decrypt/decompress만 동기/비동기 구현에서 각각 덧붙입니다.
+     */
+    private buildDecodeBaseContext;
     /**
      * charset 정보를 가져옵니다.
      *
@@ -437,10 +446,37 @@ declare class Ddu64Core {
      * @group Introspection
      */
     getStats(input: Uint8Array | string, options?: DduOptions): DduEncodeStats;
+    /**
+     * 비동기 인코딩 통계를 가져옵니다.
+     *
+     * 브라우저/Workers처럼 압축이 비동기 API로만 제공되는 런타임에서는 `compress: true`
+     * 통계 계산에 이 메서드를 사용하세요.
+     *
+     * @group Introspection
+     */
+    getStatsAsync(input: Uint8Array | string, options?: DduOptions): Promise<DduEncodeStats>;
+    private buildEncodeStats;
     /**
      * 통계를 위한 메타데이터 포함 내부 인코딩.
      */
     private encodeInternal;
+    /**
+     * getStats 전용 인코딩: 실제 AES-GCM 연산을 생략하고 길이만 정확한 더미 암호화를 사용합니다.
+     *
+     * 암호화 출력 길이는 `평문 + AEAD_OVERHEAD_BYTES`로 결정적이고, 비트팩/푸터/체크섬/난독화/
+     * URL-safe/청킹은 모두 입력 바이트 "길이"에만 의존(바이트 "값"과 무관)하므로, 더미 암호문(0으로 채운
+     * 동일 길이 버퍼)으로 마무리해도 `encoded.length`는 실제 `encode()` 출력과 바이트 단위로 일치합니다.
+     * 압축은 결과 크기와 적용 여부 판단에 필요하므로 실제로 수행합니다.
+     *
+     * 이 등식(통계 길이 === 실제 encode 길이)은 property test로 고정됩니다.
+     */
+    private encodeStatsInternal;
+    private encodeStatsAsyncInternal;
+    /**
+     * 동기/비동기 인코딩 파이프라인이 공유하는 기본 컨텍스트를 구성합니다.
+     * compress/encrypt만 동기/비동기 구현에서 각각 덧붙입니다.
+     */
+    private buildEncodeBaseContext;
     /**
      * 인코딩 마무리: 비트팩 인코딩 + 후처리(난독화/체크섬/URL-safe/청킹).
      * 동기/비동기 인코딩에서 공유하는 순수 동기 단계입니다.
@@ -682,4 +718,4 @@ declare class Ddu64StreamError extends Ddu64Error {
 }
 declare function isDdu64Error(error: unknown): error is Ddu64Error;
 
-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 };
+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 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 };

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkWS6GB27C_cjs=require('./chunk-WS6GB27C.cjs'),chunkFACJ5LAG_cjs=require('./chunk-FACJ5LAG.cjs'),chunkRFBXQWSA_cjs=require('./chunk-RFBXQWSA.cjs'),chunkRHVBUC4T_cjs=require('./chunk-RHVBUC4T.cjs');require('./chunk-NY4FGVF3.cjs');var promises=require('fs/promises'),path=require('path'),url=require('url');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;var d=class extends chunkFACJ5LAG_cjs.B{constructor(r,t,e){let s=chunkFACJ5LAG_cjs.x(r,t,e),C={...s.dduOptions,adapter:s.dduOptions?.adapter??new chunkRHVBUC4T_cjs.a};super(s.dduChar,s.paddingChar,C);}decodeToBuffer(r,t){let e=this.decodeToUint8Array(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}async decodeToBufferAsync(r,t){let e=await this.decodeToUint8ArrayAsync(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}};async function M(){let o=chunkWS6GB27C_cjs.a();switch(o){case "node":{let{NodeAdapter:r}=await import('./NodeAdapter-DS44MI5D.cjs');return new r}case "deno":case "bun":case "browser":case "edge":{let{BrowserAdapter:r}=await import('./BrowserAdapter-LIUL744V.cjs');return new r(o)}default:throw new Error("[ddunigma] No suitable crypto provider found. Detected runtime lacks both Node.js crypto module and Web Crypto API (SubtleCrypto).")}}var D=false;async function V(o){try{let r=await promises.readFile(o);return r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength)}catch{return null}}async function X(){let o=path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))),r=[path.join(o,"wasm","codec.wasm"),path.join(o,"codec.wasm"),path.join(o,"..","wasm","codec.wasm")];for(let t of r){let e=await V(t);if(e)return e}return null}function i(){D||(chunkFACJ5LAG_cjs.g(X),D=true);}async function q(){return i(),chunkFACJ5LAG_cjs.d()}function z(){return i(),chunkFACJ5LAG_cjs.e()}function G(){return i(),chunkFACJ5LAG_cjs.f()}Object.defineProperty(exports,"createReadableDecodeStream",{enumerable:true,get:function(){return chunkWS6GB27C_cjs.c}});Object.defineProperty(exports,"createReadableEncodeStream",{enumerable:true,get:function(){return chunkWS6GB27C_cjs.b}});Object.defineProperty(exports,"detectRuntime",{enumerable:true,get:function(){return chunkWS6GB27C_cjs.a}});Object.defineProperty(exports,"CharsetBuilder",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.C}});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,"HangulObfuscationLayer",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.b}});Object.defineProperty(exports,"createObfuscationLayer",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.c}});Object.defineProperty(exports,"isDdu64Error",{enumerable:true,get:function(){return chunkFACJ5LAG_cjs.v}});Object.defineProperty(exports,"BrowserAdapter",{enumerable:true,get:function(){return chunkRFBXQWSA_cjs.a}});Object.defineProperty(exports,"NodeAdapter",{enumerable:true,get:function(){return chunkRHVBUC4T_cjs.a}});exports.Ddu64=d;exports.Ddu64Node=d;exports.getAdapter=M;exports.getWasmCodec=z;exports.getWasmCodecSync=G;exports.preloadWasm=q;//# sourceMappingURL=index.cjs.map
+'use strict';var chunkWCXD5LRF_cjs=require('./chunk-WCXD5LRF.cjs'),chunkUMA4JEN4_cjs=require('./chunk-UMA4JEN4.cjs'),chunkAMOZHHMB_cjs=require('./chunk-AMOZHHMB.cjs'),chunkHZJ7PU7X_cjs=require('./chunk-HZJ7PU7X.cjs');require('./chunk-5NSHXTMN.cjs');var promises=require('fs/promises'),path=require('path'),url=require('url');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;var s=class extends chunkUMA4JEN4_cjs.C{constructor(r,t,e){let d=chunkUMA4JEN4_cjs.B(r,t,e),C={...d.dduOptions,...d.dduChar!==void 0?{dduChar:d.dduChar}:{},...d.paddingChar!==void 0?{paddingChar:d.paddingChar}:{},adapter:d.dduOptions?.adapter??new chunkHZJ7PU7X_cjs.a};super(C);}decodeToBuffer(r,t){let e=this.decodeToUint8Array(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}async decodeToBufferAsync(r,t){let e=await this.decodeToUint8ArrayAsync(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}};async function U(){let o=chunkWCXD5LRF_cjs.a();switch(o){case "node":{let{NodeAdapter:r}=await import('./NodeAdapter-EQ73FGEJ.cjs');return new r}case "deno":case "bun":case "browser":case "edge":{let{BrowserAdapter:r}=await import('./BrowserAdapter-PB4J6FHX.cjs');return new r(o)}default:throw new Error("[ddunigma] No suitable crypto provider found. Detected runtime lacks both Node.js crypto module and Web Crypto API (SubtleCrypto).")}}var D=false;async function q(o){try{let r=await promises.readFile(o);return r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength)}catch{return null}}async function z(){let o=path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))),r=[path.join(o,"wasm","codec.wasm"),path.join(o,"codec.wasm"),path.join(o,"..","wasm","codec.wasm")];for(let t of r){let e=await q(t);if(e)return e}return null}function c(){D||(chunkUMA4JEN4_cjs.k(z),D=true);}async function G(){return c(),chunkUMA4JEN4_cjs.h()}function J(){return c(),chunkUMA4JEN4_cjs.i()}function Q(){return c(),chunkUMA4JEN4_cjs.j()}Object.defineProperty(exports,"createReadableDecodeStream",{enumerable:true,get:function(){return chunkWCXD5LRF_cjs.c}});Object.defineProperty(exports,"createReadableEncodeStream",{enumerable:true,get:function(){return chunkWCXD5LRF_cjs.b}});Object.defineProperty(exports,"detectRuntime",{enumerable:true,get:function(){return chunkWCXD5LRF_cjs.a}});Object.defineProperty(exports,"CharsetBuilder",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.D}});Object.defineProperty(exports,"Ddu64AdapterError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.w}});Object.defineProperty(exports,"Ddu64CharsetError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.u}});Object.defineProperty(exports,"Ddu64ChecksumError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.t}});Object.defineProperty(exports,"Ddu64CompressionError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.p}});Object.defineProperty(exports,"Ddu64Core",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.C}});Object.defineProperty(exports,"Ddu64DecodeError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.o}});Object.defineProperty(exports,"Ddu64DecompressionError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.q}});Object.defineProperty(exports,"Ddu64DecryptionError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.s}});Object.defineProperty(exports,"Ddu64EncodeError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.n}});Object.defineProperty(exports,"Ddu64EncryptionError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.r}});Object.defineProperty(exports,"Ddu64Error",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.m}});Object.defineProperty(exports,"Ddu64ErrorCode",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.l}});Object.defineProperty(exports,"Ddu64LimitError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.v}});Object.defineProperty(exports,"Ddu64ObfuscationError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.x}});Object.defineProperty(exports,"Ddu64StreamError",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.y}});Object.defineProperty(exports,"DduSetSymbol",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.a}});Object.defineProperty(exports,"HangulObfuscationLayer",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.e}});Object.defineProperty(exports,"createEncoderObfuscationLayer",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.g}});Object.defineProperty(exports,"createObfuscationLayer",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.f}});Object.defineProperty(exports,"isDdu64Error",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.z}});Object.defineProperty(exports,"BrowserAdapter",{enumerable:true,get:function(){return chunkAMOZHHMB_cjs.a}});Object.defineProperty(exports,"NodeAdapter",{enumerable:true,get:function(){return chunkHZJ7PU7X_cjs.a}});exports.Ddu64=s;exports.Ddu64Node=s;exports.getAdapter=U;exports.getWasmCodec=J;exports.getWasmCodecSync=Q;exports.preloadWasm=G;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { D as Ddu64Core, a as DduConstructorOptions, u as DduOptions, P as PlatformAdapter, y as KeyDerivationOptions, W as WasmCodec } from './errors-DxOlTuHc.cjs';
-export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, d as Ddu64AdapterError, e as Ddu64CharsetError, f as Ddu64ChecksumError, g as Ddu64CompressionError, 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, t as DduEncodeStats, v as DduProgressInfo, w as DduSetSymbol, x as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, O as ObfuscationLayer, T as TestVector, z as isDdu64Error } from './errors-DxOlTuHc.cjs';
-export { B as BrowserAdapter, H as HangulObfuscationLayer, c as createObfuscationLayer, a as createReadableDecodeStream, b as createReadableEncodeStream, d as detectRuntime } from './ObfuscationLayer-BRiyE5xu.cjs';
+import { D as Ddu64Core, a as DduConstructorOptions, u as DduOptions, P as PlatformAdapter, y as KeyDerivationOptions, W as WasmCodec } from './errors-DNICpo4L.cjs';
+export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, d as Ddu64AdapterError, e as Ddu64CharsetError, f as Ddu64ChecksumError, g as Ddu64CompressionError, 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, t as DduEncodeStats, v as DduProgressInfo, w as DduSetSymbol, x as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, O as ObfuscationLayer, z as isDdu64Error } from './errors-DNICpo4L.cjs';
+export { B as BrowserAdapter, H as HangulObfuscationLayer, c as createEncoderObfuscationLayer, a as createObfuscationLayer, b as createReadableDecodeStream, d as createReadableEncodeStream, e as detectRuntime } from './ObfuscationLayer-BgL73E5F.cjs';
 
 /**
  * Node.js 전용 Ddu64 래퍼.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { D as Ddu64Core, a as DduConstructorOptions, u as DduOptions, P as PlatformAdapter, y as KeyDerivationOptions, W as WasmCodec } from './errors-DxOlTuHc.js';
-export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, d as Ddu64AdapterError, e as Ddu64CharsetError, f as Ddu64ChecksumError, g as Ddu64CompressionError, 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, t as DduEncodeStats, v as DduProgressInfo, w as DduSetSymbol, x as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, O as ObfuscationLayer, T as TestVector, z as isDdu64Error } from './errors-DxOlTuHc.js';
-export { B as BrowserAdapter, H as HangulObfuscationLayer, c as createObfuscationLayer, a as createReadableDecodeStream, b as createReadableEncodeStream, d as detectRuntime } from './ObfuscationLayer-DZiQGHMw.js';
+import { D as Ddu64Core, a as DduConstructorOptions, u as DduOptions, P as PlatformAdapter, y as KeyDerivationOptions, W as WasmCodec } from './errors-DNICpo4L.js';
+export { C as CharSetConfig, b as CharSetInfo, c as CharsetBuilder, d as Ddu64AdapterError, e as Ddu64CharsetError, f as Ddu64ChecksumError, g as Ddu64CompressionError, 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, t as DduEncodeStats, v as DduProgressInfo, w as DduSetSymbol, x as DduTextEncoding, E as EncodingProfile, K as KeyDerivationAlgorithm, O as ObfuscationLayer, z as isDdu64Error } from './errors-DNICpo4L.js';
+export { B as BrowserAdapter, H as HangulObfuscationLayer, c as createEncoderObfuscationLayer, a as createObfuscationLayer, b as createReadableDecodeStream, d as createReadableEncodeStream, e as detectRuntime } from './ObfuscationLayer-BDr-0s1M.js';
 
 /**
  * Node.js 전용 Ddu64 래퍼.

package/dist/index.js

@@ -1,2 +1,2 @@
-import {a as a$1}from'./chunk-M7526IW7.js';export{c as createReadableDecodeStream,b as createReadableEncodeStream,a as detectRuntime}from'./chunk-M7526IW7.js';import {B,x,d as d$1,e,f,g}from'./chunk-65RDFQV7.js';export{C as CharsetBuilder,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,b as HangulObfuscationLayer,c as createObfuscationLayer,v as isDdu64Error}from'./chunk-65RDFQV7.js';export{a as BrowserAdapter}from'./chunk-P7WJ2LOQ.js';import {a}from'./chunk-342X2QEY.js';export{a as NodeAdapter}from'./chunk-342X2QEY.js';import'./chunk-QR43FNIY.js';import {readFile}from'fs/promises';import {dirname,join}from'path';import {fileURLToPath}from'url';var d=class extends B{constructor(r,t,e){let s=x(r,t,e),C={...s.dduOptions,adapter:s.dduOptions?.adapter??new a};super(s.dduChar,s.paddingChar,C);}decodeToBuffer(r,t){let e=this.decodeToUint8Array(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}async decodeToBufferAsync(r,t){let e=await this.decodeToUint8ArrayAsync(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}};async function M(){let o=a$1();switch(o){case "node":{let{NodeAdapter:r}=await import('./NodeAdapter-AHALQ4DQ.js');return new r}case "deno":case "bun":case "browser":case "edge":{let{BrowserAdapter:r}=await import('./BrowserAdapter-G4XORUQJ.js');return new r(o)}default:throw new Error("[ddunigma] No suitable crypto provider found. Detected runtime lacks both Node.js crypto module and Web Crypto API (SubtleCrypto).")}}var D=false;async function V(o){try{let r=await readFile(o);return r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength)}catch{return null}}async function X(){let o=dirname(fileURLToPath(import.meta.url)),r=[join(o,"wasm","codec.wasm"),join(o,"codec.wasm"),join(o,"..","wasm","codec.wasm")];for(let t of r){let e=await V(t);if(e)return e}return null}function i(){D||(g(X),D=true);}async function q(){return i(),d$1()}function z(){return i(),e()}function G(){return i(),f()}export{d as Ddu64,d as Ddu64Node,M as getAdapter,z as getWasmCodec,G as getWasmCodecSync,q as preloadWasm};//# sourceMappingURL=index.js.map
+import {a as a$1}from'./chunk-KS6PRP5Y.js';export{c as createReadableDecodeStream,b as createReadableEncodeStream,a as detectRuntime}from'./chunk-KS6PRP5Y.js';import {C,B,h,i,j,k}from'./chunk-HTZT725P.js';export{D as CharsetBuilder,w as Ddu64AdapterError,u as Ddu64CharsetError,t as Ddu64ChecksumError,p as Ddu64CompressionError,C as Ddu64Core,o as Ddu64DecodeError,q as Ddu64DecompressionError,s as Ddu64DecryptionError,n as Ddu64EncodeError,r as Ddu64EncryptionError,m as Ddu64Error,l as Ddu64ErrorCode,v as Ddu64LimitError,x as Ddu64ObfuscationError,y as Ddu64StreamError,a as DduSetSymbol,e as HangulObfuscationLayer,g as createEncoderObfuscationLayer,f as createObfuscationLayer,z as isDdu64Error}from'./chunk-HTZT725P.js';export{a as BrowserAdapter}from'./chunk-CQATQOBZ.js';import {a}from'./chunk-7RWUNW5S.js';export{a as NodeAdapter}from'./chunk-7RWUNW5S.js';import'./chunk-OQXMQIE3.js';import {readFile}from'fs/promises';import {dirname,join}from'path';import {fileURLToPath}from'url';var s=class extends C{constructor(r,t,e){let d=B(r,t,e),C={...d.dduOptions,...d.dduChar!==void 0?{dduChar:d.dduChar}:{},...d.paddingChar!==void 0?{paddingChar:d.paddingChar}:{},adapter:d.dduOptions?.adapter??new a};super(C);}decodeToBuffer(r,t){let e=this.decodeToUint8Array(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}async decodeToBufferAsync(r,t){let e=await this.decodeToUint8ArrayAsync(r,t);return Buffer.from(e.buffer,e.byteOffset,e.byteLength)}};async function U(){let o=a$1();switch(o){case "node":{let{NodeAdapter:r}=await import('./NodeAdapter-5FBNCJSG.js');return new r}case "deno":case "bun":case "browser":case "edge":{let{BrowserAdapter:r}=await import('./BrowserAdapter-HORDDCOE.js');return new r(o)}default:throw new Error("[ddunigma] No suitable crypto provider found. Detected runtime lacks both Node.js crypto module and Web Crypto API (SubtleCrypto).")}}var D=false;async function q(o){try{let r=await readFile(o);return r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength)}catch{return null}}async function z(){let o=dirname(fileURLToPath(import.meta.url)),r=[join(o,"wasm","codec.wasm"),join(o,"codec.wasm"),join(o,"..","wasm","codec.wasm")];for(let t of r){let e=await q(t);if(e)return e}return null}function c(){D||(k(z),D=true);}async function G(){return c(),h()}function J(){return c(),i()}function Q(){return c(),j()}export{s as Ddu64,s as Ddu64Node,U as getAdapter,J as getWasmCodec,Q as getWasmCodecSync,G as preloadWasm};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddunigma/node",
-  "version": "4.0.1",
+  "version": "5.0.0",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,12 +13,16 @@
   "scripts": {
     "build": "tsup",
     "bench": "node --expose-gc --import tsx benchmarks/encoding-benchmark.ts",
+    "bench:micro": "node --expose-gc --import tsx benchmarks/micro-benchmark.ts",
+    "bench:threshold": "node --expose-gc --import tsx benchmarks/wasm-threshold-benchmark.ts",
+    "bench:guard": "node --expose-gc --import tsx benchmarks/perf-guard.ts",
+    "gen:v5-vectors": "node --import tsx scripts/gen-v5-vectors.ts",
     "pack:check": "node scripts/verify-pack.mjs",
-    "prepublishOnly": "pnpm test && pnpm build && pnpm pack:check",
+    "prepublishOnly": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm pack:check",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
     "lint": "eslint src eslint.config.mjs tsup.config.ts",
     "lint:fix": "eslint src eslint.config.mjs tsup.config.ts --fix",
     "format": "prettier --write src/",

package/dist/BrowserAdapter-G4XORUQJ.js

@@ -1,2 +0,0 @@
-export{a as BrowserAdapter}from'./chunk-P7WJ2LOQ.js';import'./chunk-QR43FNIY.js';//# sourceMappingURL=BrowserAdapter-G4XORUQJ.js.map
-//# sourceMappingURL=BrowserAdapter-G4XORUQJ.js.map

package/dist/BrowserAdapter-LIUL744V.cjs

@@ -1,2 +0,0 @@
-'use strict';var chunkRFBXQWSA_cjs=require('./chunk-RFBXQWSA.cjs');require('./chunk-NY4FGVF3.cjs');Object.defineProperty(exports,"BrowserAdapter",{enumerable:true,get:function(){return chunkRFBXQWSA_cjs.a}});//# sourceMappingURL=BrowserAdapter-LIUL744V.cjs.map
-//# sourceMappingURL=BrowserAdapter-LIUL744V.cjs.map