@ddunigma/node 5.0.0 → 6.0.0

package/dist/ObfuscationLayer-4rCOCRWH.d.cts

@@ -0,0 +1,89 @@
+import { O as ObfuscationLayer } from './core-BsIwjJK-.cjs';
+
+/**
+ * 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;
+
+/**
+ * 한글 음절 난독화 레이어 구현.
+ *
+ * 암호화된 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;
+}
+/**
+ * Ddu64 인코더 출력과 호환되는 ObfuscationLayer를 생성합니다.
+ *
+ * charset/패딩 외에 footer 마커(ELYSIA/GRISEO/ENC/V3/V4)와 숫자(0-9)까지 알파벳에
+ * 포함하므로, 압축/암호화/파이프라인 마커가 붙은 실제 인코더 출력도 안전하게
+ * deobfuscate할 수 있습니다.
+ *
+ * 일반적으로는 `Ddu64`의 `obfuscate` 옵션을 쓰는 것으로 충분하며, 이 헬퍼는 인코더와
+ * 동일한 난독화 매핑을 외부에서 재현해야 할 때 사용합니다.
+ *
+ * @param charSet - 인코딩에 사용되는 charset 문자
+ * @param paddingChar - 패딩 문자
+ * @returns 인코더 호환 ObfuscationLayer 인스턴스
+ */
+declare function createEncoderObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
+
+export { HangulObfuscationLayer as H, createEncoderObfuscationLayer as c, detectRuntime as d };

package/dist/ObfuscationLayer-DTlA723P.d.ts

@@ -0,0 +1,89 @@
+import { O as ObfuscationLayer } from './core-BsIwjJK-.js';
+
+/**
+ * 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;
+
+/**
+ * 한글 음절 난독화 레이어 구현.
+ *
+ * 암호화된 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;
+}
+/**
+ * Ddu64 인코더 출력과 호환되는 ObfuscationLayer를 생성합니다.
+ *
+ * charset/패딩 외에 footer 마커(ELYSIA/GRISEO/ENC/V3/V4)와 숫자(0-9)까지 알파벳에
+ * 포함하므로, 압축/암호화/파이프라인 마커가 붙은 실제 인코더 출력도 안전하게
+ * deobfuscate할 수 있습니다.
+ *
+ * 일반적으로는 `Ddu64`의 `obfuscate` 옵션을 쓰는 것으로 충분하며, 이 헬퍼는 인코더와
+ * 동일한 난독화 매핑을 외부에서 재현해야 할 때 사용합니다.
+ *
+ * @param charSet - 인코딩에 사용되는 charset 문자
+ * @param paddingChar - 패딩 문자
+ * @returns 인코더 호환 ObfuscationLayer 인스턴스
+ */
+declare function createEncoderObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
+
+export { HangulObfuscationLayer as H, createEncoderObfuscationLayer as c, detectRuntime as d };

package/dist/{ObfuscationLayer-BDr-0s1M.d.ts → WebStreams-C16QV2Dz.d.ts}

@@ -1,4 +1,4 @@
-import { P as PlatformAdapter, y as KeyDerivationOptions, D as Ddu64Core, u as DduOptions, O as ObfuscationLayer } from './errors-DNICpo4L.js';
+import { P as PlatformAdapter, I as KeyDerivationOptions, D as Ddu64Core, F as DduSecureConstructorOptions, H as DduStreamOptions } from './core-BsIwjJK-.js';
 
 /**
  * 브라우저 플랫폼 어댑터 구현.
@@ -19,11 +19,8 @@ import { P as PlatformAdapter, y as KeyDerivationOptions, D as Ddu64Core, u as D
  * - 런타임이 지원하는 경우 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', ...)를 사용합니다.
@@ -77,18 +74,37 @@ declare class BrowserAdapter implements PlatformAdapter {
 }
 
 /**
- * Runtime detection helpers with no platform-specific imports.
+ * Browser 전용 secure Ddu64 래퍼.
  *
- * @module adapters/runtime
+ * Ddu64Core를 확장하여 압축/암호화/체크섬(배터리 포함)을 지원합니다:
+ * - BrowserAdapter 자동 주입 (WebCrypto/CompressionStream) → 비동기 압축/암호화/체크섬
+ * - HangulObfuscationLayer 자동 주입 → 한글 난독화 사용 가능
+ *
+ * Node.js 내장 모듈을 정적으로 import하지 않으므로 브라우저 번들에 crypto/zlib가
+ * 끌려오지 않습니다. 구 `Ddu64Browser`의 배터리 동작을 계승합니다.
+ *
+ * @module Ddu64SecureBrowser
  */
-/** 감지된 런타임 환경 식별자 */
-type RuntimeId = "node" | "browser" | "edge" | "deno" | "bun" | "unknown";
+
 /**
- * 현재 JavaScript 런타임 환경을 감지합니다.
+ * Browser 전용 secure Ddu64 인코더/디코더.
+ *
+ * Ddu64Core를 래핑하여 자동 BrowserAdapter 주입(WebCrypto/CompressionStream 기반
+ * 압축/암호화/체크섬)을 제공합니다. 동기 압축/암호화 메서드는 지원하지 않으며
+ * `encodeAsync`/`decodeAsync` 계열을 사용해야 합니다.
+ *
+ * @example
+ * ```ts
+ * import { Ddu64SecureBrowser } from '@ddunigma/node/secure';
  *
- * 감지는 순수하게 globalThis 검사에 기반하며 Node.js 내장 모듈을 임포트하지 않습니다.
+ * const encoder = new Ddu64SecureBrowser(undefined, undefined, { encryptionKey: 'key' });
+ * const encoded = await encoder.encodeAsync('Hello', { compress: true });
+ * const decoded = await encoder.decodeAsync(encoded);
+ * ```
  */
-declare function detectRuntime(): RuntimeId;
+declare class Ddu64SecureBrowser extends Ddu64Core {
+    constructor(dduChar?: string[] | string | DduSecureConstructorOptions, paddingChar?: string, dduOptions?: DduSecureConstructorOptions);
+}
 
 /**
  * ddunigma Web Streams API 구현.
@@ -101,6 +117,13 @@ declare function detectRuntime(): RuntimeId;
  * - 인코딩: 압축/암호화/체크섬 비활성화 + 2의 제곱수 charset에서 청크 단위 출력
  * - 디코딩: footer의 압축/암호화 마커를 최종 신뢰하기 위해 payload를 축적 후 처리
  *
+ * 메타데이터 의미 주의:
+ * 스트림 헤더의 압축 플래그(D/B/N)는 압축이 "요청"되었는지를 기록하고, 페이로드 footer는
+ * 실제로 압축이 "적용"되었는지를 기록합니다. 작은/비압축성 데이터는 압축 결과가 원본보다
+ * 커서 적용되지 않을 수 있으므로 헤더가 D/B여도 footer엔 압축 마커가 없을 수 있습니다.
+ * 디코더는 항상 footer를 권위 있는 소스로 신뢰하므로 라운드트립은 정상이며, 헤더 플래그는
+ * 어디까지나 "요청" 힌트로만 해석해야 합니다.
+ *
  * 스트림 헤더 형식: [pad]DDS1[D|B|N][1|0][pad]
  * D=deflate, B=brotli, N=없음 (압축), 1/0 (암호화).
  *
@@ -114,11 +137,16 @@ declare function detectRuntime(): RuntimeId;
  * 압축/암호화/체크섬이 비활성화되고 charset이 2의 제곱수일 때 각 청크를 즉시 인코딩합니다.
  * 그 외에는 전체 데이터를 축적한 후 flush에서 처리합니다.
  *
+ * 암호화 정책: 스트림 암호화 여부는 **인코더가 키를 보유했는지로만** 결정됩니다
+ * (`encryptionKey` 설정 시 항상 암호화). 스트림 옵션 타입(`DduStreamOptions`)에는 `encrypt`가
+ * 노출되지 않으며, 내부 옵션으로 `encrypt: false`를 주더라도 키가 있으면 무시되고 암호화됩니다.
+ * 평문 스트림이 필요하면 키 없는 인코더 인스턴스를 사용하세요.
+ *
  * @param encoder - 인코딩에 사용할 Ddu64Core 인스턴스
- * @param options - 인코딩 옵션 (compress, encrypt, compressionAlgorithm 등)
+ * @param options - 인코딩 옵션 (compress, compressionAlgorithm 등)
  * @returns TransformStream<Uint8Array, string>
  */
-declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduOptions): TransformStream<Uint8Array, string>;
+declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduStreamOptions): TransformStream<Uint8Array, string>;
 /**
  * charset 인코딩 문자열을 바이너리 데이터로 역변환하는
  * Web Streams API TransformStream을 생성합니다.
@@ -130,92 +158,6 @@ declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduOpt
  * @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를 생성합니다.
- *
- * @deprecated 인코더 출력과 호환되지 않습니다(charset/패딩만 포함, footer 마커·숫자 미포함).
- * 인코더 출력을 deobfuscate하려면 `createEncoderObfuscationLayer`를, 일반 난독화는 `Ddu64`의
- * `obfuscate` 옵션을 사용하세요. 이 함수는 다음 메이저에서 제거될 수 있습니다.
- *
- * charset 문자와 패딩 문자로부터 알파벳을 구성한 후 한글 난독화 레이어를 생성합니다.
- *
- * @param charSet - 인코딩에 사용되는 charset 문자
- * @param paddingChar - 패딩 문자
- * @returns ObfuscationLayer 인스턴스
- */
-declare function createObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
-/**
- * Ddu64 인코더 출력과 호환되는 ObfuscationLayer를 생성합니다.
- *
- * `createObfuscationLayer`와 달리 charset/패딩 외에 footer 마커
- * (ELYSIA/GRISEO/ENC/V3/V4)와 숫자(0-9)까지 알파벳에 포함하므로, 압축/암호화/파이프라인
- * 마커가 붙은 실제 인코더 출력도 안전하게 deobfuscate할 수 있습니다.
- *
- * 일반적으로는 `Ddu64`의 `obfuscate` 옵션을 쓰는 것으로 충분하며, 이 헬퍼는 인코더와
- * 동일한 난독화 매핑을 외부에서 재현해야 할 때 사용합니다.
- *
- * @param charSet - 인코딩에 사용되는 charset 문자
- * @param paddingChar - 패딩 문자
- * @returns 인코더 호환 ObfuscationLayer 인스턴스
- */
-declare function createEncoderObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
+declare function createReadableDecodeStream(encoder: Ddu64Core, options?: DduStreamOptions): TransformStream<string, Uint8Array>;
 
-export { BrowserAdapter as B, HangulObfuscationLayer as H, createObfuscationLayer as a, createReadableDecodeStream as b, createEncoderObfuscationLayer as c, createReadableEncodeStream as d, detectRuntime as e };
+export { BrowserAdapter as B, Ddu64SecureBrowser as D, createReadableEncodeStream as a, createReadableDecodeStream as c };

package/dist/{ObfuscationLayer-BgL73E5F.d.cts → WebStreams-CY9E19f5.d.cts}

@@ -1,4 +1,4 @@
-import { P as PlatformAdapter, y as KeyDerivationOptions, D as Ddu64Core, u as DduOptions, O as ObfuscationLayer } from './errors-DNICpo4L.cjs';
+import { P as PlatformAdapter, I as KeyDerivationOptions, D as Ddu64Core, F as DduSecureConstructorOptions, H as DduStreamOptions } from './core-BsIwjJK-.cjs';
 
 /**
  * 브라우저 플랫폼 어댑터 구현.
@@ -19,11 +19,8 @@ import { P as PlatformAdapter, y as KeyDerivationOptions, D as Ddu64Core, u as D
  * - 런타임이 지원하는 경우 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', ...)를 사용합니다.
@@ -77,18 +74,37 @@ declare class BrowserAdapter implements PlatformAdapter {
 }
 
 /**
- * Runtime detection helpers with no platform-specific imports.
+ * Browser 전용 secure Ddu64 래퍼.
  *
- * @module adapters/runtime
+ * Ddu64Core를 확장하여 압축/암호화/체크섬(배터리 포함)을 지원합니다:
+ * - BrowserAdapter 자동 주입 (WebCrypto/CompressionStream) → 비동기 압축/암호화/체크섬
+ * - HangulObfuscationLayer 자동 주입 → 한글 난독화 사용 가능
+ *
+ * Node.js 내장 모듈을 정적으로 import하지 않으므로 브라우저 번들에 crypto/zlib가
+ * 끌려오지 않습니다. 구 `Ddu64Browser`의 배터리 동작을 계승합니다.
+ *
+ * @module Ddu64SecureBrowser
  */
-/** 감지된 런타임 환경 식별자 */
-type RuntimeId = "node" | "browser" | "edge" | "deno" | "bun" | "unknown";
+
 /**
- * 현재 JavaScript 런타임 환경을 감지합니다.
+ * Browser 전용 secure Ddu64 인코더/디코더.
+ *
+ * Ddu64Core를 래핑하여 자동 BrowserAdapter 주입(WebCrypto/CompressionStream 기반
+ * 압축/암호화/체크섬)을 제공합니다. 동기 압축/암호화 메서드는 지원하지 않으며
+ * `encodeAsync`/`decodeAsync` 계열을 사용해야 합니다.
+ *
+ * @example
+ * ```ts
+ * import { Ddu64SecureBrowser } from '@ddunigma/node/secure';
  *
- * 감지는 순수하게 globalThis 검사에 기반하며 Node.js 내장 모듈을 임포트하지 않습니다.
+ * const encoder = new Ddu64SecureBrowser(undefined, undefined, { encryptionKey: 'key' });
+ * const encoded = await encoder.encodeAsync('Hello', { compress: true });
+ * const decoded = await encoder.decodeAsync(encoded);
+ * ```
  */
-declare function detectRuntime(): RuntimeId;
+declare class Ddu64SecureBrowser extends Ddu64Core {
+    constructor(dduChar?: string[] | string | DduSecureConstructorOptions, paddingChar?: string, dduOptions?: DduSecureConstructorOptions);
+}
 
 /**
  * ddunigma Web Streams API 구현.
@@ -101,6 +117,13 @@ declare function detectRuntime(): RuntimeId;
  * - 인코딩: 압축/암호화/체크섬 비활성화 + 2의 제곱수 charset에서 청크 단위 출력
  * - 디코딩: footer의 압축/암호화 마커를 최종 신뢰하기 위해 payload를 축적 후 처리
  *
+ * 메타데이터 의미 주의:
+ * 스트림 헤더의 압축 플래그(D/B/N)는 압축이 "요청"되었는지를 기록하고, 페이로드 footer는
+ * 실제로 압축이 "적용"되었는지를 기록합니다. 작은/비압축성 데이터는 압축 결과가 원본보다
+ * 커서 적용되지 않을 수 있으므로 헤더가 D/B여도 footer엔 압축 마커가 없을 수 있습니다.
+ * 디코더는 항상 footer를 권위 있는 소스로 신뢰하므로 라운드트립은 정상이며, 헤더 플래그는
+ * 어디까지나 "요청" 힌트로만 해석해야 합니다.
+ *
  * 스트림 헤더 형식: [pad]DDS1[D|B|N][1|0][pad]
  * D=deflate, B=brotli, N=없음 (압축), 1/0 (암호화).
  *
@@ -114,11 +137,16 @@ declare function detectRuntime(): RuntimeId;
  * 압축/암호화/체크섬이 비활성화되고 charset이 2의 제곱수일 때 각 청크를 즉시 인코딩합니다.
  * 그 외에는 전체 데이터를 축적한 후 flush에서 처리합니다.
  *
+ * 암호화 정책: 스트림 암호화 여부는 **인코더가 키를 보유했는지로만** 결정됩니다
+ * (`encryptionKey` 설정 시 항상 암호화). 스트림 옵션 타입(`DduStreamOptions`)에는 `encrypt`가
+ * 노출되지 않으며, 내부 옵션으로 `encrypt: false`를 주더라도 키가 있으면 무시되고 암호화됩니다.
+ * 평문 스트림이 필요하면 키 없는 인코더 인스턴스를 사용하세요.
+ *
  * @param encoder - 인코딩에 사용할 Ddu64Core 인스턴스
- * @param options - 인코딩 옵션 (compress, encrypt, compressionAlgorithm 등)
+ * @param options - 인코딩 옵션 (compress, compressionAlgorithm 등)
  * @returns TransformStream<Uint8Array, string>
  */
-declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduOptions): TransformStream<Uint8Array, string>;
+declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduStreamOptions): TransformStream<Uint8Array, string>;
 /**
  * charset 인코딩 문자열을 바이너리 데이터로 역변환하는
  * Web Streams API TransformStream을 생성합니다.
@@ -130,92 +158,6 @@ declare function createReadableEncodeStream(encoder: Ddu64Core, options?: DduOpt
  * @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를 생성합니다.
- *
- * @deprecated 인코더 출력과 호환되지 않습니다(charset/패딩만 포함, footer 마커·숫자 미포함).
- * 인코더 출력을 deobfuscate하려면 `createEncoderObfuscationLayer`를, 일반 난독화는 `Ddu64`의
- * `obfuscate` 옵션을 사용하세요. 이 함수는 다음 메이저에서 제거될 수 있습니다.
- *
- * charset 문자와 패딩 문자로부터 알파벳을 구성한 후 한글 난독화 레이어를 생성합니다.
- *
- * @param charSet - 인코딩에 사용되는 charset 문자
- * @param paddingChar - 패딩 문자
- * @returns ObfuscationLayer 인스턴스
- */
-declare function createObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
-/**
- * Ddu64 인코더 출력과 호환되는 ObfuscationLayer를 생성합니다.
- *
- * `createObfuscationLayer`와 달리 charset/패딩 외에 footer 마커
- * (ELYSIA/GRISEO/ENC/V3/V4)와 숫자(0-9)까지 알파벳에 포함하므로, 압축/암호화/파이프라인
- * 마커가 붙은 실제 인코더 출력도 안전하게 deobfuscate할 수 있습니다.
- *
- * 일반적으로는 `Ddu64`의 `obfuscate` 옵션을 쓰는 것으로 충분하며, 이 헬퍼는 인코더와
- * 동일한 난독화 매핑을 외부에서 재현해야 할 때 사용합니다.
- *
- * @param charSet - 인코딩에 사용되는 charset 문자
- * @param paddingChar - 패딩 문자
- * @returns 인코더 호환 ObfuscationLayer 인스턴스
- */
-declare function createEncoderObfuscationLayer(charSet: string[], paddingChar: string): ObfuscationLayer;
+declare function createReadableDecodeStream(encoder: Ddu64Core, options?: DduStreamOptions): TransformStream<string, Uint8Array>;
 
-export { BrowserAdapter as B, HangulObfuscationLayer as H, createObfuscationLayer as a, createReadableDecodeStream as b, createEncoderObfuscationLayer as c, createReadableEncodeStream as d, detectRuntime as e };
+export { BrowserAdapter as B, Ddu64SecureBrowser as D, createReadableEncodeStream as a, createReadableDecodeStream as c };

package/dist/browser.cjs

@@ -1,2 +1 @@
-'use strict';var chunkWCXD5LRF_cjs=require('./chunk-WCXD5LRF.cjs'),chunkUMA4JEN4_cjs=require('./chunk-UMA4JEN4.cjs'),chunkAMOZHHMB_cjs=require('./chunk-AMOZHHMB.cjs');require('./chunk-5NSHXTMN.cjs');var e=class extends chunkUMA4JEN4_cjs.C{constructor(n,s,a){let r=chunkUMA4JEN4_cjs.B(n,s,a),u={...r.dduOptions,...r.dduChar!==void 0?{dduChar:r.dduChar}:{},...r.paddingChar!==void 0?{paddingChar:r.paddingChar}:{},adapter:r.dduOptions?.adapter??new chunkAMOZHHMB_cjs.a};super(u);}};async function F(){return new chunkAMOZHHMB_cjs.a}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,"getWasmCodec",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.i}});Object.defineProperty(exports,"getWasmCodecSync",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.j}});Object.defineProperty(exports,"isDdu64Error",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.z}});Object.defineProperty(exports,"preloadWasm",{enumerable:true,get:function(){return chunkUMA4JEN4_cjs.h}});Object.defineProperty(exports,"BrowserAdapter",{enumerable:true,get:function(){return chunkAMOZHHMB_cjs.a}});exports.Ddu64=e;exports.Ddu64Browser=e;exports.getAdapter=F;//# sourceMappingURL=browser.cjs.map
-//# sourceMappingURL=browser.cjs.map
+'use strict';var chunkBDP7E7K3_cjs=require('./chunk-BDP7E7K3.cjs'),chunkJBUTKSCC_cjs=require('./chunk-JBUTKSCC.cjs'),chunkZTGECGM2_cjs=require('./chunk-ZTGECGM2.cjs'),chunkBCUBYE76_cjs=require('./chunk-BCUBYE76.cjs');var t=class extends chunkJBUTKSCC_cjs.i{static{chunkBCUBYE76_cjs.a(this,"Ddu64Browser");}constructor(r,o,i){let e=chunkJBUTKSCC_cjs.b(r,o,i),a={...e.dduOptions,...e.dduChar!==void 0?{dduChar:e.dduChar}:{},...e.paddingChar!==void 0?{paddingChar:e.paddingChar}:{},obfuscationLayerFactory:e.dduOptions?.obfuscationLayerFactory??(p=>new chunkBDP7E7K3_cjs.a(p))};super(a);}encode(r,o){return super.encode(r,o)}encodeAsync(r,o){return super.encodeAsync(r,o)}decode(r,o){return super.decode(r,o)}decodeAsync(r,o){return super.decodeAsync(r,o)}decodeToUint8Array(r,o){return super.decodeToUint8Array(r,o)}decodeToUint8ArrayAsync(r,o){return super.decodeToUint8ArrayAsync(r,o)}getStats(r,o){return super.getStats(r,o)}getStatsAsync(r,o){return super.getStatsAsync(r,o)}};Object.defineProperty(exports,"HangulObfuscationLayer",{enumerable:true,get:function(){return chunkBDP7E7K3_cjs.a}});Object.defineProperty(exports,"createEncoderObfuscationLayer",{enumerable:true,get:function(){return chunkBDP7E7K3_cjs.b}});Object.defineProperty(exports,"detectRuntime",{enumerable:true,get:function(){return chunkBDP7E7K3_cjs.c}});Object.defineProperty(exports,"CharsetBuilder",{enumerable:true,get:function(){return chunkJBUTKSCC_cjs.j}});Object.defineProperty(exports,"Ddu64Core",{enumerable:true,get:function(){return chunkJBUTKSCC_cjs.i}});Object.defineProperty(exports,"DduSetSymbol",{enumerable:true,get:function(){return chunkJBUTKSCC_cjs.a}});Object.defineProperty(exports,"Ddu64AdapterError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.m}});Object.defineProperty(exports,"Ddu64CharsetError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.j}});Object.defineProperty(exports,"Ddu64ChecksumError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.i}});Object.defineProperty(exports,"Ddu64CompressionError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.e}});Object.defineProperty(exports,"Ddu64DecodeError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.d}});Object.defineProperty(exports,"Ddu64DecompressionError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.f}});Object.defineProperty(exports,"Ddu64DecryptionError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.h}});Object.defineProperty(exports,"Ddu64EncodeError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.c}});Object.defineProperty(exports,"Ddu64EncryptionError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.g}});Object.defineProperty(exports,"Ddu64Error",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.b}});Object.defineProperty(exports,"Ddu64ErrorCode",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.a}});Object.defineProperty(exports,"Ddu64InvalidInputError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.k}});Object.defineProperty(exports,"Ddu64LimitError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.l}});Object.defineProperty(exports,"Ddu64ObfuscationError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.n}});Object.defineProperty(exports,"Ddu64StreamError",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.o}});Object.defineProperty(exports,"isDdu64Error",{enumerable:true,get:function(){return chunkZTGECGM2_cjs.p}});exports.Ddu64=t;exports.Ddu64Browser=t;

package/dist/browser.d.cts

@@ -1,34 +1,38 @@
-import { B as BrowserAdapter } from './ObfuscationLayer-BgL73E5F.cjs';
-export { H as HangulObfuscationLayer, c as createEncoderObfuscationLayer, a as createObfuscationLayer, b as createReadableDecodeStream, d as createReadableEncodeStream, e as detectRuntime } from './ObfuscationLayer-BgL73E5F.cjs';
-import { D as Ddu64Core, a as DduConstructorOptions } 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, 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, W as WasmCodec, z as isDdu64Error } from './errors-DNICpo4L.cjs';
-export { getWasmCodec, getWasmCodecSync, preloadWasm } from './core.cjs';
+import { D as Ddu64Core, a as DduBaseConstructorOptions, b as DduBaseOptions, c as DduEncodeStats } from './core-BsIwjJK-.cjs';
+export { C as CharSetConfig, d as CharSetInfo, e as CharsetBuilder, f as Ddu64AdapterError, g as Ddu64CharsetError, h as Ddu64ChecksumError, i as Ddu64CompressionError, j as Ddu64DecodeError, k as Ddu64DecompressionError, l as Ddu64DecryptionError, m as Ddu64EncodeError, n as Ddu64EncryptionError, o as Ddu64Error, p as Ddu64ErrorCode, q as Ddu64ErrorOptions, r as Ddu64InvalidInputError, s as Ddu64LimitError, t as Ddu64ObfuscationError, u as Ddu64Operation, v as Ddu64StreamError, w as DduProgressInfo, x as DduSetSymbol, y as DduSetSymbolInput, E as EncodingProfile, O as ObfuscationLayer, z as isDdu64Error } from './core-BsIwjJK-.cjs';
+export { H as HangulObfuscationLayer, c as createEncoderObfuscationLayer, d as detectRuntime } from './ObfuscationLayer-4rCOCRWH.cjs';
 
 /**
- * Browser-optimized Ddu64 wrapper.
+ * Browser 전용 기본(lean) Ddu64 래퍼.
  *
- * Injects BrowserAdapter by default so async compression/encryption works
- * without importing Node.js built-ins into browser bundles.
+ * Ddu64Core를 확장하여 인코딩 + 한글 난독화(라이브러리 주목적)를 제공합니다:
+ * - HangulObfuscationLayer 자동 주입 → 키 없는 한글 난독화 사용 가능
+ *
+ * 6.0: 어댑터(BrowserAdapter)를 주입하지 않습니다. 압축/암호화/체크섬/스트림이 필요하면
+ * secure 진입점(`@ddunigma/node/secure`)의 `Ddu64SecureBrowser`를 사용하세요.
+ * Node.js 내장 모듈도, WebCrypto/CompressionStream 어댑터도 정적 import하지 않습니다.
  *
  * @module Ddu64Browser
  */
 
 declare class Ddu64Browser extends Ddu64Core {
-    constructor(dduChar?: string[] | string | DduConstructorOptions, paddingChar?: string, dduOptions?: DduConstructorOptions);
+    constructor(dduChar?: string[] | string | DduBaseConstructorOptions, paddingChar?: string, dduOptions?: DduBaseConstructorOptions);
+    /** @group Sync */
+    encode(input: Uint8Array | string, options?: DduBaseOptions): string;
+    /** @group Async */
+    encodeAsync(input: Uint8Array | string, options?: DduBaseOptions): Promise<string>;
+    /** @group Sync */
+    decode(input: string, options?: DduBaseOptions): string;
+    /** @group Async */
+    decodeAsync(input: string, options?: DduBaseOptions): Promise<string>;
+    /** @group Sync */
+    decodeToUint8Array(input: string, options?: DduBaseOptions): Uint8Array;
+    /** @group Async */
+    decodeToUint8ArrayAsync(input: string, options?: DduBaseOptions): Promise<Uint8Array>;
+    /** @group Introspection */
+    getStats(input: Uint8Array | string, options?: DduBaseOptions): DduEncodeStats;
+    /** @group Introspection */
+    getStatsAsync(input: Uint8Array | string, options?: DduBaseOptions): Promise<DduEncodeStats>;
 }
 
-/**
- * 브라우저 최적화 진입점.
- *
- * 인코딩, 디코딩, CharsetBuilder, Web Streams, BrowserAdapter를 내보냅니다.
- *
- * Node.js 내장 모듈을 직접 임포트하지 않도록 BrowserAdapter 기반 구성만
- * 포함합니다.
- *
- * @module browser
- * @packageDocumentation
- */
-
-declare function getAdapter(): Promise<BrowserAdapter>;
-
-export { BrowserAdapter, Ddu64Browser as Ddu64, Ddu64Browser, Ddu64Core, DduConstructorOptions, getAdapter };
+export { Ddu64Browser as Ddu64, Ddu64Browser, Ddu64Core, DduBaseConstructorOptions, DduBaseOptions, DduEncodeStats };