@ddunigma/node 3.0.2 → 3.1.0

package/README.md

@@ -10,7 +10,7 @@ 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)
@@ -36,7 +36,7 @@ ddu.encode("안녕하세요"); // "뎯땩잇땨뎪뎨잇잉뎯욱잇우뎯땨읶
 ddu.decode("뎯땩잇땨뎪뎨잇잉뎯욱잇우뎯땨읶뎨뎯땩듂잊"); // "안녕하세요"
 
 // V1 (구버전 호환, 8개 문자 쌍 방식)
-const dduV1 = new Ddu64(undefined, undefined, { dduSetSymbol: DduSetSymbol.DDU_V1 });
+const dduV1 = new Ddu64({ dduSetSymbol: DduSetSymbol.DDU_V1 });
 dduV1.encode("안녕하세요"); // ".우땨땨이?땨뜌.이.뜌이?이!.우우땨이?우뜌.우땨뜌이이.뜌.우땨땨!이이야"
 dduV1.decode(".우땨땨이?땨뜌.이.뜌이?이!.우우땨이?우뜌.우땨뜌이이.뜌.우땨땨!이이야"); // "안녕하세요"
 ```
@@ -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
@@ -62,10 +62,12 @@ import { Ddu64, DduSetSymbol } from "@ddunigma/node";
 // 기본값 - 한글 종성 결합 64문자
 new Ddu64();
 
-// 구버전 호환 8문자
+// 구버전 호환 8문자 (아래 두 방법 모두 사용가능)
+new Ddu64({ dduSetSymbol: DduSetSymbol.DDU_V1 });
 new Ddu64(undefined, undefined, { dduSetSymbol: DduSetSymbol.DDU_V1 });
 
-// 영문+숫자 64문자
+// 영문+숫자 64문자 (아래 두 방법 모두 사용가능)
+new Ddu64({ dduSetSymbol: DduSetSymbol.ONECHARSET });
 new Ddu64(undefined, undefined, { dduSetSymbol: DduSetSymbol.ONECHARSET });
 ```
 
@@ -114,7 +116,7 @@ const chars = CharsetBuilder.fromUnicodeRange(0x4e00, 0x4e3f)
 ## Compression
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   compress: true, // 압축 활성화
   compressionAlgorithm: "deflate", // "deflate" | "brotli"
   compressionLevel: 6, // deflate: 0-9, brotli: 0-11
@@ -125,12 +127,14 @@ const decoded = ddu.decode(encoded);
 ```
 
 압축은 원본보다 작아질 때만 적용됩니다. 압축 결과가 더 크면 비압축으로 저장됩니다.
+브라우저 진입점은 `deflate-raw`를 지원하는 CompressionStream/DecompressionStream 런타임에서 압축을 사용합니다.
+브라우저 Brotli는 런타임 지원 여부를 feature detection으로 확인하며, Web API 특성상 `compressionLevel`은 적용되지 않을 수 있습니다.
 
 ## Encryption
 
 ```typescript
 // SHA-256 키 파생 (기본)
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   encryptionKey: "my-secret-key",
 });
 
@@ -138,7 +142,7 @@ const encoded = ddu.encode("secret message");
 const decoded = ddu.decode(encoded); // 같은 키로만 복호화 가능
 
 // PBKDF2 키 파생
-const dduPbkdf2 = new Ddu64(undefined, undefined, {
+const dduPbkdf2 = new Ddu64({
   encryptionKey: "user password",
   keyDerivation: {
     algorithm: "pbkdf2",
@@ -149,10 +153,13 @@ const dduPbkdf2 = new Ddu64(undefined, undefined, {
 });
 ```
 
+PBKDF2 `iterations`는 기본값이 `210_000`이며, `10_000` 미만의 양수는 `10_000`으로 보정됩니다.
+0 이하 또는 유한하지 않은 값은 기본값으로 대체됩니다.
+
 ## Checksum
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, { checksum: true });
+const ddu = new Ddu64({ checksum: true });
 
 const encoded = ddu.encode("data"); // CRC32 체크섬 포함
 const decoded = ddu.decode(encoded); // 무결성 검증 후 반환
@@ -172,7 +179,7 @@ const encoded = ddu.encode("URL safe text");
 ## Chunking
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   chunkSize: 76,
   chunkSeparator: "\n",
 });
@@ -184,7 +191,7 @@ const encoded = ddu.encode("long data ".repeat(100));
 ## Obfuscation (한글 난독화)
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   encryptionKey: "secret",
   obfuscate: true, // 암호화 필수
 });
@@ -205,13 +212,14 @@ const decoded = await ddu.decodeAsync(encoded);
 ```
 
 Node.js에서도 async 메서드를 사용할 수 있습니다. 브라우저 진입점(`@ddunigma/node/browser`)은 Node.js 내장 모듈을 임포트하지 않습니다.
+코어 진입점(`@ddunigma/node/core`)은 기본 인코딩/디코딩만 포함하며, 압축/암호화가 필요하면 명시적으로 어댑터를 전달하세요.
 
 ## Web Streams
 
 ```typescript
 import { Ddu64, createReadableEncodeStream, createReadableDecodeStream } from "@ddunigma/node";
 
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   compress: true,
   encryptionKey: "stream-key",
 });
@@ -228,21 +236,22 @@ const decodedStream = encodedStream.pipeThrough(createReadableDecodeStream(ddu))
 ```typescript
 import { Ddu64, preloadWasm } from "@ddunigma/node";
 
-await preloadWasm(); // 선택적 사전 로드
+await preloadWasm(); // 동기 encode/decode hot path에서 WASM을 쓰려면 먼저 완료되어야 함
 
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   wasmThreshold: 4096, // 이 크기 이상일 때 WASM 사용
 });
 
 const encoded = ddu.encode(new Uint8Array(1024 * 1024));
 ```
 
-WASM을 사용할 수 없으면 JavaScript로 자동 폴백됩니다.
+`encode()`/`decode()`의 동기 hot path는 이미 로드된 WASM만 사용합니다.
+`preloadWasm()`이 완료되지 않았거나 WASM을 사용할 수 없으면 JavaScript로 폴백됩니다.
 
 ## Progress Callback
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, { compress: true });
+const ddu = new Ddu64({ compress: true });
 
 ddu.encode("data", {
   onProgress: ({ percent, stage }) => {
@@ -255,7 +264,7 @@ ddu.encode("data", {
 ## Stats
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, { compress: true });
+const ddu = new Ddu64({ compress: true });
 const stats = ddu.getStats("A".repeat(1000));
 
 // { originalSize, encodedSize, compressedSize, compressionRatio, expansionRatio, charsetSize, bitLength }
@@ -264,7 +273,7 @@ const stats = ddu.getStats("A".repeat(1000));
 ## Size Limits
 
 ```typescript
-const ddu = new Ddu64(undefined, undefined, {
+const ddu = new Ddu64({
   maxDecodedBytes: 10 * 1024 * 1024, // 디코딩 최대 크기 (기본 64MB)
   maxDecompressedBytes: 50 * 1024 * 1024, // 압축해제 최대 크기 (기본 64MB)
 });
@@ -274,6 +283,8 @@ const ddu = new Ddu64(undefined, undefined, {
 
 ## API
 
+### Node Entry
+
 ```typescript
 class Ddu64 {
   encode(data: string | Uint8Array, options?: DduOptions): string;
@@ -288,15 +299,56 @@ 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;
+
+  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>;
 
-  static setWorkerPoolSize(n: number): void;
+  getStats(data: string | Uint8Array, options?: DduOptions): DduEncodeStats;
+  getCharSetInfo(): CharSetInfo;
 }
 ```
 
+코어 진입점(`@ddunigma/node/core`)은 플랫폼 어댑터를 자동 로드하지 않습니다.
+압축 또는 암호화가 필요한 async 호출에는 `adapter`를 명시적으로 전달하세요.
+
 ## Constructor Options
 
 ```typescript
-new Ddu64(dduChar?, paddingChar?, options?);
+// 옵션만 전달 (권장)
+new Ddu64(options?);
+
+// charset 직접 지정
+new Ddu64(dduChar, paddingChar, options?);
 ```
 
 | Option                 | Type                    | Default     | 설명                  |
@@ -342,7 +394,7 @@ new Ddu64(dduChar?, paddingChar?, options?);
 | Import Path              | 용도                                  |
 | ------------------------ | ------------------------------------- |
 | `@ddunigma/node`         | Node.js 전체 기능 (동기+비동기)       |
-| `@ddunigma/node/browser` | 브라우저 최적화 (Node.js 모듈 미포함) |
+| `@ddunigma/node/browser` | 브라우저 최적화 (BrowserAdapter 기본) |
 | `@ddunigma/node/core`    | 최소 코어 (인코딩/디코딩만)           |
 
 ## Build & Test

package/dist/BrowserAdapter-BHHWPUTB.js

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

package/dist/BrowserAdapter-M7PUHVGS.cjs

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

package/dist/NodeAdapter-JB2EZ3T4.js

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

package/dist/NodeAdapter-JRRSYUJT.cjs

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

package/dist/ObfuscationLayer-D-xl5d7P.d.ts

@@ -0,0 +1,205 @@
+import { P as PlatformAdapter, i as KeyDerivationOptions, D as Ddu64Core, e as DduOptions, O as ObfuscationLayer } from './core-DYSnygnp.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 supportsBrotli: boolean;
+    readonly runtime: "browser";
+    /**
+     * 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): Promise<Uint8Array>;
+    /**
+     * AES-256-GCM 페이로드를 복호화합니다.
+     * 와이어 포맷 기대: IV(12바이트) + authTag(16바이트) + 암호문.
+     * 복호화 전에 Web Crypto 형식(암호문 + authTag)으로 재구성합니다.
+     */
+    decrypt(data: Uint8Array, keyHash: 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: 진정한 청크 단위 스트리밍
+ * - 그 외: 전체 축적 후 일괄 처리 (알고리즘/와이어 포맷 제약)
+ *
+ * 스트림 헤더 형식: [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 스트림 헤더를 파싱하여 압축 및 암호화 설정을 감지한 후
+ * 페이로드를 그에 맞게 디코딩합니다.
+ *
+ * 압축/암호화/체크섬이 없고 charset이 2의 제곱수인 스트림은 헤더 파싱 후 각 청크를 즉시 디코딩합니다.
+ * 그 외에는 전체 페이로드를 축적 후 일괄 디코딩합니다.
+ *
+ * @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-DAVKTnHf.d.cts

@@ -0,0 +1,205 @@
+import { P as PlatformAdapter, i as KeyDerivationOptions, D as Ddu64Core, e as DduOptions, O as ObfuscationLayer } from './core-DYSnygnp.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 supportsBrotli: boolean;
+    readonly runtime: "browser";
+    /**
+     * 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): Promise<Uint8Array>;
+    /**
+     * AES-256-GCM 페이로드를 복호화합니다.
+     * 와이어 포맷 기대: IV(12바이트) + authTag(16바이트) + 암호문.
+     * 복호화 전에 Web Crypto 형식(암호문 + authTag)으로 재구성합니다.
+     */
+    decrypt(data: Uint8Array, keyHash: 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: 진정한 청크 단위 스트리밍
+ * - 그 외: 전체 축적 후 일괄 처리 (알고리즘/와이어 포맷 제약)
+ *
+ * 스트림 헤더 형식: [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 스트림 헤더를 파싱하여 압축 및 암호화 설정을 감지한 후
+ * 페이로드를 그에 맞게 디코딩합니다.
+ *
+ * 압축/암호화/체크섬이 없고 charset이 2의 제곱수인 스트림은 헤더 파싱 후 각 청크를 즉시 디코딩합니다.
+ * 그 외에는 전체 페이로드를 축적 후 일괄 디코딩합니다.
+ *
+ * @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 };