@ddunigma/node 3.0.3 → 4.0.1

package/README.md

@@ -10,14 +10,14 @@ V2 추가사항
 
 ### Credits
 
-- Original Python Implementation by:
+- Origin implementation by:
   - [@i3ls](https://github.com/i3l3)
   - [@gunu3371](https://github.com/gunu3371)
 - Original Repository: [ddunigma](https://github.com/i3l3/ddunigma)
 
 ## Requirements
 
-- **Node.js >= 18.0.0**
+- **Node.js >= 22.0.0**
 
 ## Install
 
@@ -51,7 +51,7 @@ const input = new Uint8Array([0, 1, 127, 128, 255]);
 
 const encoded = ddu.encode(input);
 const bytes = ddu.decodeToUint8Array(encoded);
-const buffer = ddu.decodeToBuffer(encoded); // Node.js Buffer
+const buffer = ddu.decodeToBuffer(encoded); // Node.js entry only
 ```
 
 ## Presets
@@ -93,6 +93,9 @@ const hangulCoda = new Ddu64(["가", "나", "다", "라"], "뭐", {
 // → 가, 각, 갂, 갇, 나, 낙, 낚, 낟, 다, 닥, 닦, 닫, 라, 락, 랔, 랗 (16문자)
 ```
 
+커스텀 charset의 각 심볼과 `paddingChar`는 단일 UTF-16 코드 유닛 문자여야 합니다.
+이모지처럼 surrogate pair가 필요한 문자나 여러 문자로 이루어진 심볼은 지원하지 않습니다.
+
 ## CharsetBuilder
 
 ```typescript
@@ -127,6 +130,8 @@ const decoded = ddu.decode(encoded);
 ```
 
 압축은 원본보다 작아질 때만 적용됩니다. 압축 결과가 더 크면 비압축으로 저장됩니다.
+브라우저 진입점은 `deflate-raw`를 지원하는 CompressionStream/DecompressionStream 런타임에서 압축을 사용합니다.
+브라우저 Brotli는 런타임 지원 여부를 feature detection으로 확인하며, Web API 특성상 `compressionLevel`은 적용되지 않을 수 있습니다.
 
 ## Encryption
 
@@ -151,6 +156,9 @@ const dduPbkdf2 = new Ddu64({
 });
 ```
 
+PBKDF2 `iterations`는 기본값이 `210_000`이며, `10_000` 미만의 양수는 `10_000`으로 보정됩니다.
+0 이하 또는 유한하지 않은 값은 기본값으로 대체됩니다.
+
 ## Checksum
 
 ```typescript
@@ -206,7 +214,8 @@ const encoded = await ddu.encodeAsync("browser text");
 const decoded = await ddu.decodeAsync(encoded);
 ```
 
-Node.js에서도 async 메서드를 사용할 수 있습니다. 브라우저 진입점(`@ddunigma/node/browser`)은 Node.js 내장 모듈을 임포트하지 않습니다.
+Node.js에서도 async 메서드를 사용할 수 있습니다. v4부터 루트 진입점(`@ddunigma/node`)은 런타임 조건형 export를 사용하므로 브라우저 번들러와 Workers 계열 런타임에서는 BrowserAdapter 경로로 해석됩니다. 명시적인 브라우저 경로가 필요하면 `@ddunigma/node/browser`를 사용하세요.
+코어 진입점(`@ddunigma/node/core`)은 기본 인코딩/디코딩만 포함하며, 압축/암호화가 필요하면 명시적으로 어댑터를 전달하세요.
 
 ## Web Streams
 
@@ -225,21 +234,26 @@ const encodedStream = readableByteStream.pipeThrough(
 const decodedStream = encodedStream.pipeThrough(createReadableDecodeStream(ddu));
 ```
 
+인코딩 스트림은 압축/암호화/체크섬이 꺼져 있고 2의 제곱수 charset일 때 청크 단위로 즉시 출력합니다.
+디코딩 스트림은 footer의 압축/암호화 메타데이터를 최종 신뢰하므로 payload를 모아 `flush`에서 처리합니다.
+
 ## WASM Acceleration
 
 ```typescript
 import { Ddu64, preloadWasm } from "@ddunigma/node";
 
-await preloadWasm(); // 선택적 사전 로드
+await preloadWasm(); // 동기 encode/decode hot path에서 WASM을 쓰려면 먼저 완료되어야 함
 
 const ddu = new Ddu64({
   wasmThreshold: 4096, // 이 크기 이상일 때 WASM 사용
+  // wasmThreshold: Infinity, // WASM hot path 비활성화
 });
 
 const encoded = ddu.encode(new Uint8Array(1024 * 1024));
 ```
 
-WASM을 사용할 수 없으면 JavaScript로 자동 폴백됩니다.
+`encode()`/`decode()`의 동기 hot path는 이미 로드된 WASM만 사용합니다.
+`preloadWasm()`이 완료되지 않았거나 WASM을 사용할 수 없으면 JavaScript로 폴백됩니다.
 
 ## Progress Callback
 
@@ -272,10 +286,33 @@ const ddu = new Ddu64({
 });
 ```
 
+## Custom Errors
+
+```typescript
+import { Ddu64, Ddu64ErrorCode, isDdu64Error } from "@ddunigma/node";
+
+const ddu = new Ddu64({ checksum: true });
+
+try {
+  ddu.decode(tamperedInput);
+} catch (err) {
+  if (isDdu64Error(err) && err.code === Ddu64ErrorCode.ChecksumMismatch) {
+    // 체크섬 불일치 처리
+  }
+}
+```
+
+인코딩, 디코딩, 압축, 암호화, 체크섬, charset, 크기 제한, adapter, stream 실패는
+`Ddu64Error` 계열로 래핑됩니다. 모든 공개 진입점(`@ddunigma/node`,
+`@ddunigma/node/browser`, `@ddunigma/node/core`)에서 같은 에러 타입과
+`Ddu64ErrorCode`를 export합니다.
+
 ---
 
 ## API
 
+### Node Entry
+
 ```typescript
 class Ddu64 {
   encode(data: string | Uint8Array, options?: DduOptions): string;
@@ -290,11 +327,48 @@ class Ddu64 {
 
   getStats(data: string | Uint8Array, options?: DduOptions): DduEncodeStats;
   getCharSetInfo(): CharSetInfo;
+}
+```
+
+### Browser Entry
+
+```typescript
+class Ddu64 {
+  encode(data: string | Uint8Array, options?: DduOptions): string;
+  decode(encoded: string, options?: DduOptions): string;
+  decodeToUint8Array(encoded: string, options?: DduOptions): Uint8Array;
 
-  static setWorkerPoolSize(n: number): void;
+  encodeAsync(data: string | Uint8Array, options?: DduOptions): Promise<string>;
+  decodeAsync(encoded: string, options?: DduOptions): Promise<string>;
+  decodeToUint8ArrayAsync(encoded: string, options?: DduOptions): Promise<Uint8Array>;
+
+  getStats(data: string | Uint8Array, options?: DduOptions): DduEncodeStats;
+  getCharSetInfo(): CharSetInfo;
 }
 ```
 
+브라우저 진입점(`@ddunigma/node/browser`)은 `Buffer` API를 노출하지 않습니다.
+
+### Core Entry
+
+```typescript
+class Ddu64 {
+  encode(data: string | Uint8Array, options?: DduOptions): string;
+  decode(encoded: string, options?: DduOptions): string;
+  decodeToUint8Array(encoded: string, options?: DduOptions): Uint8Array;
+
+  encodeAsync(data: string | Uint8Array, options?: DduOptions): Promise<string>;
+  decodeAsync(encoded: string, options?: DduOptions): Promise<string>;
+  decodeToUint8ArrayAsync(encoded: string, options?: DduOptions): Promise<Uint8Array>;
+
+  getStats(data: string | Uint8Array, options?: DduOptions): DduEncodeStats;
+  getCharSetInfo(): CharSetInfo;
+}
+```
+
+코어 진입점(`@ddunigma/node/core`)은 플랫폼 어댑터를 자동 로드하지 않습니다.
+압축 또는 암호화가 필요한 async 호출에는 `adapter`를 명시적으로 전달하세요.
+
 ## Constructor Options
 
 ```typescript
@@ -323,7 +397,7 @@ new Ddu64(dduChar, paddingChar, options?);
 | `chunkSeparator`       | `string`                | `"\n"`      | 청크 구분자           |
 | `maxDecodedBytes`      | `number`                | `67108864`  | 디코딩 크기 제한      |
 | `maxDecompressedBytes` | `number`                | `67108864`  | 압축해제 크기 제한    |
-| `wasmThreshold`        | `number`                | `4096`      | WASM 사용 임계값      |
+| `wasmThreshold`        | `number`                | `4096`      | WASM 사용 임계값 (`Infinity`면 비활성화) |
 | `throwOnError`         | `boolean`               | `false`     | 초기화 에러 시 throw  |
 
 ## Per-Call Options
@@ -345,18 +419,24 @@ new Ddu64(dduChar, paddingChar, options?);
 
 ## Entry Points
 
-| Import Path              | 용도                                  |
-| ------------------------ | ------------------------------------- |
-| `@ddunigma/node`         | Node.js 전체 기능 (동기+비동기)       |
-| `@ddunigma/node/browser` | 브라우저 최적화 (Node.js 모듈 미포함) |
-| `@ddunigma/node/core`    | 최소 코어 (인코딩/디코딩만)           |
+| Runtime / Target                | Import Path                         | 용도                                  |
+| ------------------------------- | ----------------------------------- | ------------------------------------- |
+| Node.js server/CLI              | `@ddunigma/node`                    | Node.js 전체 기능 (동기+비동기)       |
+| Browser / Vite / webpack        | `@ddunigma/node` 또는 `/browser`    | 브라우저 최적화 (BrowserAdapter 기본) |
+| Cloudflare Workers / Deno / Bun | `@ddunigma/node` 또는 `/browser`    | Node.js 내장 모듈 없는 Web API 경로   |
+| Adapter 직접 주입 최소 번들     | `@ddunigma/node/core`               | 최소 코어 (인코딩/디코딩만)           |
+
+루트 진입점은 v4부터 `browser`/`worker`/`workerd`/`deno`/`bun`/`node` 조건을 가진 conditional export입니다. Node.js에서는 기존처럼 `Buffer` API와 NodeAdapter를 노출하고, 브라우저 및 Workers 계열 번들러에서는 Node.js 내장 모듈 없는 BrowserAdapter 경로로 해석됩니다. 런타임 조건을 알 수 없는 ESM 환경의 기본 fallback도 browser 번들을 사용합니다.
+Node.js 런타임에서는 `node` 조건이 `index.js`/`index.cjs`를 선택하므로 기본 import로 NodeAdapter와 `decodeToBuffer()`를 사용할 수 있습니다.
 
 ## Build & Test
 
 ```bash
 pnpm test
+pnpm typecheck
 pnpm build
 pnpm lint
+pnpm pack:check
 pnpm bench
 ```
 

package/dist/BrowserAdapter-G4XORUQJ.js

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,2 @@
+'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

package/dist/NodeAdapter-AHALQ4DQ.js

@@ -0,0 +1,2 @@
+export{a as NodeAdapter}from'./chunk-342X2QEY.js';import'./chunk-QR43FNIY.js';//# sourceMappingURL=NodeAdapter-AHALQ4DQ.js.map
+//# sourceMappingURL=NodeAdapter-AHALQ4DQ.js.map

package/dist/NodeAdapter-DS44MI5D.cjs

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

package/dist/ObfuscationLayer-BRiyE5xu.d.cts

@@ -0,0 +1,203 @@
+import { P as PlatformAdapter, y as KeyDerivationOptions, D as Ddu64Core, u as DduOptions, O as ObfuscationLayer } from './errors-DxOlTuHc.cjs';
+
+/**
+ * 브라우저 플랫폼 어댑터 구현.
+ * 암호화 연산에 Web Crypto API(SubtleCrypto)를 사용하고
+ * 압축에 CompressionStream/DecompressionStream을 사용합니다.
+ *
+ * 이 어댑터는 동기 암호화 또는 압축 연산을 지원하지 않습니다.
+ * Brotli는 CompressionStream/DecompressionStream에서 지원되는 런타임에서만 사용할 수 있습니다.
+ *
+ * @module adapters/BrowserAdapter
+ */
+
+/**
+ * Web API를 사용하여 PlatformAdapter를 구현하는 BrowserAdapter:
+ * - AES-256-GCM 및 SHA-256을 위한 Web Crypto API(SubtleCrypto)
+ * - 안전한 랜덤 바이트를 위한 crypto.getRandomValues
+ * - deflate-raw 압축을 위한 CompressionStream/DecompressionStream
+ * - 런타임이 지원하는 경우 Brotli 압축
+ */
+declare class BrowserAdapter implements PlatformAdapter {
+    readonly supportsSyncCrypto = false;
+    readonly supportsSyncCompression = false;
+    readonly runtime: "browser" | "edge" | "deno" | "bun";
+    constructor(runtime?: "browser" | "edge" | "deno" | "bun");
+    get supportsBrotli(): boolean;
+    /**
+     * UTF-8 키 문자열에서 SHA-256을 통해 256비트 키를 파생합니다.
+     * UTF-8 인코딩된 키에 SubtleCrypto.digest('SHA-256', ...)를 사용합니다.
+     */
+    deriveKey(key: string, options?: KeyDerivationOptions): Promise<Uint8Array>;
+    /**
+     * 12바이트 IV를 사용하여 AES-256-GCM으로 데이터를 암호화합니다.
+     * 와이어 포맷 반환: IV(12바이트) + authTag(16바이트) + 암호문.
+     *
+     * 참고: Web Crypto는 authTag를 암호문에 추가하므로,
+     * 마지막 16바이트를 authTag로 추출하고 와이어 포맷에 맞게 재배치합니다.
+     */
+    encrypt(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Promise<Uint8Array>;
+    /**
+     * AES-256-GCM 페이로드를 복호화합니다.
+     * 와이어 포맷 기대: IV(12바이트) + authTag(16바이트) + 암호문.
+     * 복호화 전에 Web Crypto 형식(암호문 + authTag)으로 재구성합니다.
+     */
+    decrypt(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Promise<Uint8Array>;
+    /**
+     * 암호학적으로 안전한 랜덤 바이트를 생성합니다.
+     */
+    randomBytes(length: number): Uint8Array;
+    /**
+     * CompressionStream을 통해 deflate로 데이터를 압축합니다.
+     * Node.js zlib.deflateRaw와의 상호운용성을 위해 'deflate-raw' 형식만 사용합니다.
+     */
+    deflate(data: Uint8Array, _level?: number): Promise<Uint8Array>;
+    /**
+     * DecompressionStream을 통해 deflate 데이터를 압축 해제합니다.
+     * Node.js zlib.inflateRaw와의 상호운용성을 위해 'deflate-raw' 형식만 사용합니다.
+     * maxBytes가 지정되면 제한을 적용합니다.
+     */
+    inflate(data: Uint8Array, maxBytes?: number): Promise<Uint8Array>;
+    /**
+     * CompressionStream을 통해 Brotli로 데이터를 압축합니다.
+     * 브라우저 Web API는 Brotli 품질 레벨을 받지 않으므로 level 값은 무시됩니다.
+     */
+    brotliCompress(data: Uint8Array, _level?: number): Promise<Uint8Array>;
+    /**
+     * DecompressionStream을 통해 Brotli 데이터를 압축 해제합니다.
+     */
+    brotliDecompress(data: Uint8Array, maxBytes?: number): Promise<Uint8Array>;
+    /**
+     * CompressionStream에 적합한 deflate 형식을 결정합니다.
+     * Node.js zlib.deflateRaw와의 상호운용성을 위해 'deflate-raw'만 사용합니다.
+     */
+    private getDeflateFormat;
+    private writeAndReadStream;
+    private readAllChunks;
+}
+
+/**
+ * Runtime detection helpers with no platform-specific imports.
+ *
+ * @module adapters/runtime
+ */
+/** 감지된 런타임 환경 식별자 */
+type RuntimeId = "node" | "browser" | "edge" | "deno" | "bun" | "unknown";
+/**
+ * 현재 JavaScript 런타임 환경을 감지합니다.
+ *
+ * 감지는 순수하게 globalThis 검사에 기반하며 Node.js 내장 모듈을 임포트하지 않습니다.
+ */
+declare function detectRuntime(): RuntimeId;
+
+/**
+ * ddunigma Web Streams API 구현.
+ *
+ * Web Streams API(globalThis.TransformStream)를 사용하는
+ * TransformStream 기반 인코딩/디코딩 파이프라인을 제공합니다.
+ * 모든 최신 브라우저와 Node.js에서 사용 가능합니다.
+ *
+ * 스트리밍 모드:
+ * - 인코딩: 압축/암호화/체크섬 비활성화 + 2의 제곱수 charset에서 청크 단위 출력
+ * - 디코딩: footer의 압축/암호화 마커를 최종 신뢰하기 위해 payload를 축적 후 처리
+ *
+ * 스트림 헤더 형식: [pad]DDS1[D|B|N][1|0][pad]
+ * D=deflate, B=brotli, N=없음 (압축), 1/0 (암호화).
+ *
+ * @module streams/WebStreams
+ */
+
+/**
+ * 바이너리 데이터를 charset 인코딩 문자열로 변환하는
+ * Web Streams API TransformStream을 생성합니다.
+ *
+ * 압축/암호화/체크섬이 비활성화되고 charset이 2의 제곱수일 때 각 청크를 즉시 인코딩합니다.
+ * 그 외에는 전체 데이터를 축적한 후 flush에서 처리합니다.
+ *
+ * @param encoder - 인코딩에 사용할 Ddu64Core 인스턴스
+ * @param options - 인코딩 옵션 (compress, encrypt, compressionAlgorithm 등)
+ * @returns TransformStream<Uint8Array, string>
+ */
+declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduOptions): TransformStream<Uint8Array, string>;
+/**
+ * charset 인코딩 문자열을 바이너리 데이터로 역변환하는
+ * Web Streams API TransformStream을 생성합니다.
+ *
+ * 스트림은 DDS1 스트림 헤더를 조기 검증하되, 헤더만으로 복호화/압축해제를 비활성화하지 않습니다.
+ * footer가 최종 wire metadata이므로 전체 페이로드를 축적 후 일괄 디코딩합니다.
+ *
+ * @param encoder - 디코딩에 사용할 Ddu64Core 인스턴스
+ * @param options - 디코딩 옵션
+ * @returns TransformStream<string, Uint8Array>
+ */
+declare function createReadableDecodeStream(encoder: Ddu64Core, options?: DduOptions): TransformStream<string, Uint8Array>;
+
+/**
+ * 한글 음절 난독화 레이어 구현.
+ *
+ * 암호화된 charset 인코딩 문자열을 결정론적 전단사 매핑을 사용하여
+ * 자연스러운 한국어 음절 블록으로 변환합니다. 매핑은 다음을 보장합니다:
+ * - 모든 출력 문자가 유효한 한국어 음절 블록 (U+AC00–U+D7A3)
+ * - 단일 문자 빈도가 기대 균등 빈도의 3배를 초과하지 않음
+ * - 출력 길이 <= 입력 길이의 1.5배 (실제로는 1:1 매핑)
+ *
+ * 플랫폼 독립적: Node.js 임포트 없음.
+ *
+ * @module obfuscation/ObfuscationLayer
+ */
+
+/**
+ * 한글 음절 매핑을 사용하여 ObfuscationLayer 인터페이스를 구현합니다.
+ *
+ * 입력 알파벳(인코더가 사용하는 charset 문자)이 주어지면,
+ * 이 레이어는 각 문자를 결정론적으로 한글 음절에 매핑합니다.
+ * 매핑은 전단사(가역적)이며 위치에 따라 각 문자의 할당된 음절 범위를
+ * 순환하여 출력 빈도를 균등하게 분배합니다.
+ */
+declare class HangulObfuscationLayer implements ObfuscationLayer {
+    private readonly config;
+    /**
+     * 새 HangulObfuscationLayer를 생성합니다.
+     *
+     * @param alphabet - 완전한 입력 알파벳 (charset 문자 + 패딩 문자).
+     *   인코딩된 문자열에 나타날 수 있는 모든 고유 문자.
+     */
+    constructor(alphabet: string[]);
+    /**
+     * 암호화된 charset 인코딩 문자열을 한글 음절로 변환합니다.
+     *
+     * 각 입력 문자는 할당된 범위의 한글 음절에 매핑됩니다.
+     * 문자열 내 위치가 범위 내 어떤 음절을 사용할지 결정하여
+     * 균등한 빈도 분포를 보장합니다.
+     *
+     * @param input - 암호화된 charset 인코딩 문자열
+     * @returns 한글 음절 블록 문자열 (U+AC00–U+D7A3)
+     * @throws 입력에 알파벳에 없는 문자가 포함된 경우 에러
+     */
+    obfuscate(input: string): string;
+    /**
+     * 난독화를 역변환하여 원본 charset 인코딩 문자열을 복원합니다.
+     *
+     * 각 한글 음절이 어떤 문자의 범위에 속하는지 판별하여
+     * 원래 문자로 매핑합니다.
+     *
+     * @param input - 난독화된 한글 음절 문자열
+     * @returns 원본 charset 인코딩 문자열
+     * @throws 입력에 유효한 한글 음절 범위 밖의 문자가 포함되거나
+     *   알파벳 문자에 매핑되지 않는 문자가 포함된 경우 에러
+     */
+    deobfuscate(input: string): string;
+}
+/**
+ * 주어진 charset 설정에 대한 ObfuscationLayer를 생성합니다.
+ *
+ * charset 문자와 패딩 문자로부터 완전한 알파벳을 구성한 후
+ * 한글 난독화 레이어를 생성합니다.
+ *
+ * @param charSet - 인코딩에 사용되는 charset 문자
+ * @param paddingChar - 패딩 문자
+ * @returns ObfuscationLayer 인스턴스
+ */
+declare function createObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
+
+export { BrowserAdapter as B, HangulObfuscationLayer as H, createReadableDecodeStream as a, createReadableEncodeStream as b, createObfuscationLayer as c, detectRuntime as d };

package/dist/ObfuscationLayer-DZiQGHMw.d.ts

@@ -0,0 +1,203 @@
+import { P as PlatformAdapter, y as KeyDerivationOptions, D as Ddu64Core, u as DduOptions, O as ObfuscationLayer } from './errors-DxOlTuHc.js';
+
+/**
+ * 브라우저 플랫폼 어댑터 구현.
+ * 암호화 연산에 Web Crypto API(SubtleCrypto)를 사용하고
+ * 압축에 CompressionStream/DecompressionStream을 사용합니다.
+ *
+ * 이 어댑터는 동기 암호화 또는 압축 연산을 지원하지 않습니다.
+ * Brotli는 CompressionStream/DecompressionStream에서 지원되는 런타임에서만 사용할 수 있습니다.
+ *
+ * @module adapters/BrowserAdapter
+ */
+
+/**
+ * Web API를 사용하여 PlatformAdapter를 구현하는 BrowserAdapter:
+ * - AES-256-GCM 및 SHA-256을 위한 Web Crypto API(SubtleCrypto)
+ * - 안전한 랜덤 바이트를 위한 crypto.getRandomValues
+ * - deflate-raw 압축을 위한 CompressionStream/DecompressionStream
+ * - 런타임이 지원하는 경우 Brotli 압축
+ */
+declare class BrowserAdapter implements PlatformAdapter {
+    readonly supportsSyncCrypto = false;
+    readonly supportsSyncCompression = false;
+    readonly runtime: "browser" | "edge" | "deno" | "bun";
+    constructor(runtime?: "browser" | "edge" | "deno" | "bun");
+    get supportsBrotli(): boolean;
+    /**
+     * UTF-8 키 문자열에서 SHA-256을 통해 256비트 키를 파생합니다.
+     * UTF-8 인코딩된 키에 SubtleCrypto.digest('SHA-256', ...)를 사용합니다.
+     */
+    deriveKey(key: string, options?: KeyDerivationOptions): Promise<Uint8Array>;
+    /**
+     * 12바이트 IV를 사용하여 AES-256-GCM으로 데이터를 암호화합니다.
+     * 와이어 포맷 반환: IV(12바이트) + authTag(16바이트) + 암호문.
+     *
+     * 참고: Web Crypto는 authTag를 암호문에 추가하므로,
+     * 마지막 16바이트를 authTag로 추출하고 와이어 포맷에 맞게 재배치합니다.
+     */
+    encrypt(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Promise<Uint8Array>;
+    /**
+     * AES-256-GCM 페이로드를 복호화합니다.
+     * 와이어 포맷 기대: IV(12바이트) + authTag(16바이트) + 암호문.
+     * 복호화 전에 Web Crypto 형식(암호문 + authTag)으로 재구성합니다.
+     */
+    decrypt(data: Uint8Array, keyHash: Uint8Array, aad?: Uint8Array): Promise<Uint8Array>;
+    /**
+     * 암호학적으로 안전한 랜덤 바이트를 생성합니다.
+     */
+    randomBytes(length: number): Uint8Array;
+    /**
+     * CompressionStream을 통해 deflate로 데이터를 압축합니다.
+     * Node.js zlib.deflateRaw와의 상호운용성을 위해 'deflate-raw' 형식만 사용합니다.
+     */
+    deflate(data: Uint8Array, _level?: number): Promise<Uint8Array>;
+    /**
+     * DecompressionStream을 통해 deflate 데이터를 압축 해제합니다.
+     * Node.js zlib.inflateRaw와의 상호운용성을 위해 'deflate-raw' 형식만 사용합니다.
+     * maxBytes가 지정되면 제한을 적용합니다.
+     */
+    inflate(data: Uint8Array, maxBytes?: number): Promise<Uint8Array>;
+    /**
+     * CompressionStream을 통해 Brotli로 데이터를 압축합니다.
+     * 브라우저 Web API는 Brotli 품질 레벨을 받지 않으므로 level 값은 무시됩니다.
+     */
+    brotliCompress(data: Uint8Array, _level?: number): Promise<Uint8Array>;
+    /**
+     * DecompressionStream을 통해 Brotli 데이터를 압축 해제합니다.
+     */
+    brotliDecompress(data: Uint8Array, maxBytes?: number): Promise<Uint8Array>;
+    /**
+     * CompressionStream에 적합한 deflate 형식을 결정합니다.
+     * Node.js zlib.deflateRaw와의 상호운용성을 위해 'deflate-raw'만 사용합니다.
+     */
+    private getDeflateFormat;
+    private writeAndReadStream;
+    private readAllChunks;
+}
+
+/**
+ * Runtime detection helpers with no platform-specific imports.
+ *
+ * @module adapters/runtime
+ */
+/** 감지된 런타임 환경 식별자 */
+type RuntimeId = "node" | "browser" | "edge" | "deno" | "bun" | "unknown";
+/**
+ * 현재 JavaScript 런타임 환경을 감지합니다.
+ *
+ * 감지는 순수하게 globalThis 검사에 기반하며 Node.js 내장 모듈을 임포트하지 않습니다.
+ */
+declare function detectRuntime(): RuntimeId;
+
+/**
+ * ddunigma Web Streams API 구현.
+ *
+ * Web Streams API(globalThis.TransformStream)를 사용하는
+ * TransformStream 기반 인코딩/디코딩 파이프라인을 제공합니다.
+ * 모든 최신 브라우저와 Node.js에서 사용 가능합니다.
+ *
+ * 스트리밍 모드:
+ * - 인코딩: 압축/암호화/체크섬 비활성화 + 2의 제곱수 charset에서 청크 단위 출력
+ * - 디코딩: footer의 압축/암호화 마커를 최종 신뢰하기 위해 payload를 축적 후 처리
+ *
+ * 스트림 헤더 형식: [pad]DDS1[D|B|N][1|0][pad]
+ * D=deflate, B=brotli, N=없음 (압축), 1/0 (암호화).
+ *
+ * @module streams/WebStreams
+ */
+
+/**
+ * 바이너리 데이터를 charset 인코딩 문자열로 변환하는
+ * Web Streams API TransformStream을 생성합니다.
+ *
+ * 압축/암호화/체크섬이 비활성화되고 charset이 2의 제곱수일 때 각 청크를 즉시 인코딩합니다.
+ * 그 외에는 전체 데이터를 축적한 후 flush에서 처리합니다.
+ *
+ * @param encoder - 인코딩에 사용할 Ddu64Core 인스턴스
+ * @param options - 인코딩 옵션 (compress, encrypt, compressionAlgorithm 등)
+ * @returns TransformStream<Uint8Array, string>
+ */
+declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduOptions): TransformStream<Uint8Array, string>;
+/**
+ * charset 인코딩 문자열을 바이너리 데이터로 역변환하는
+ * Web Streams API TransformStream을 생성합니다.
+ *
+ * 스트림은 DDS1 스트림 헤더를 조기 검증하되, 헤더만으로 복호화/압축해제를 비활성화하지 않습니다.
+ * footer가 최종 wire metadata이므로 전체 페이로드를 축적 후 일괄 디코딩합니다.
+ *
+ * @param encoder - 디코딩에 사용할 Ddu64Core 인스턴스
+ * @param options - 디코딩 옵션
+ * @returns TransformStream<string, Uint8Array>
+ */
+declare function createReadableDecodeStream(encoder: Ddu64Core, options?: DduOptions): TransformStream<string, Uint8Array>;
+
+/**
+ * 한글 음절 난독화 레이어 구현.
+ *
+ * 암호화된 charset 인코딩 문자열을 결정론적 전단사 매핑을 사용하여
+ * 자연스러운 한국어 음절 블록으로 변환합니다. 매핑은 다음을 보장합니다:
+ * - 모든 출력 문자가 유효한 한국어 음절 블록 (U+AC00–U+D7A3)
+ * - 단일 문자 빈도가 기대 균등 빈도의 3배를 초과하지 않음
+ * - 출력 길이 <= 입력 길이의 1.5배 (실제로는 1:1 매핑)
+ *
+ * 플랫폼 독립적: Node.js 임포트 없음.
+ *
+ * @module obfuscation/ObfuscationLayer
+ */
+
+/**
+ * 한글 음절 매핑을 사용하여 ObfuscationLayer 인터페이스를 구현합니다.
+ *
+ * 입력 알파벳(인코더가 사용하는 charset 문자)이 주어지면,
+ * 이 레이어는 각 문자를 결정론적으로 한글 음절에 매핑합니다.
+ * 매핑은 전단사(가역적)이며 위치에 따라 각 문자의 할당된 음절 범위를
+ * 순환하여 출력 빈도를 균등하게 분배합니다.
+ */
+declare class HangulObfuscationLayer implements ObfuscationLayer {
+    private readonly config;
+    /**
+     * 새 HangulObfuscationLayer를 생성합니다.
+     *
+     * @param alphabet - 완전한 입력 알파벳 (charset 문자 + 패딩 문자).
+     *   인코딩된 문자열에 나타날 수 있는 모든 고유 문자.
+     */
+    constructor(alphabet: string[]);
+    /**
+     * 암호화된 charset 인코딩 문자열을 한글 음절로 변환합니다.
+     *
+     * 각 입력 문자는 할당된 범위의 한글 음절에 매핑됩니다.
+     * 문자열 내 위치가 범위 내 어떤 음절을 사용할지 결정하여
+     * 균등한 빈도 분포를 보장합니다.
+     *
+     * @param input - 암호화된 charset 인코딩 문자열
+     * @returns 한글 음절 블록 문자열 (U+AC00–U+D7A3)
+     * @throws 입력에 알파벳에 없는 문자가 포함된 경우 에러
+     */
+    obfuscate(input: string): string;
+    /**
+     * 난독화를 역변환하여 원본 charset 인코딩 문자열을 복원합니다.
+     *
+     * 각 한글 음절이 어떤 문자의 범위에 속하는지 판별하여
+     * 원래 문자로 매핑합니다.
+     *
+     * @param input - 난독화된 한글 음절 문자열
+     * @returns 원본 charset 인코딩 문자열
+     * @throws 입력에 유효한 한글 음절 범위 밖의 문자가 포함되거나
+     *   알파벳 문자에 매핑되지 않는 문자가 포함된 경우 에러
+     */
+    deobfuscate(input: string): string;
+}
+/**
+ * 주어진 charset 설정에 대한 ObfuscationLayer를 생성합니다.
+ *
+ * charset 문자와 패딩 문자로부터 완전한 알파벳을 구성한 후
+ * 한글 난독화 레이어를 생성합니다.
+ *
+ * @param charSet - 인코딩에 사용되는 charset 문자
+ * @param paddingChar - 패딩 문자
+ * @returns ObfuscationLayer 인스턴스
+ */
+declare function createObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
+
+export { BrowserAdapter as B, HangulObfuscationLayer as H, createReadableDecodeStream as a, createReadableEncodeStream as b, createObfuscationLayer as c, detectRuntime as d };