@ddunigma/node 2.0.2 → 2.2.0

package/LICENCE

@@ -1,4 +1,4 @@
-Copyright 2025 i3l3
+Copyright 2025 junhypar
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
 

package/README.md

@@ -6,6 +6,14 @@
 
 Node.js implementation of [ddunigma](https://github.com/i3l3/ddunigma) (Python original)
 
+커스텀 charset을 사용하는 Base64 스타일 인코더/디코더 라이브러리입니다.
+
+## Documents
+
+- `README.md`: 설치, 사용법, 공개 API 요약
+- `CHANGELOG.md`: 공개 변경 이력
+- `RELEASE.md`: 배포 체크리스트와 릴리즈 기준
+
 ### Credits
 
 - Original Python Implementation by:
@@ -15,7 +23,8 @@ Node.js implementation of [ddunigma](https://github.com/i3l3/ddunigma) (Python o
 
 ## Requirements
 
-- **Node.js >= 14.0.0**
+- **Node.js >= 18.0.0**
+- 라이브러리는 `ES2022` 타깃으로 빌드되며, 현재 스트림 암호화/압축 조합은 Node 18+ 기준으로 검증됩니다.
 
 ## Install
 
@@ -25,7 +34,7 @@ npm install @ddunigma/node
 
 ## Usage
 
-### 간단한 문자열 인코딩/디코딩
+### 기본 인코딩/디코딩
 
 ```typescript
 import { Ddu64 } from "@ddunigma/node";
@@ -69,64 +78,271 @@ const encoder4 = new Ddu64(undefined, undefined, {
 const text = "안녕하세요";
 const encoded = encoder1.encode(text);
 const decoded = encoder1.decode(encoded);
-const decodedBuffer = encoder1.decodeToBuffer(encoded);
 ```
 
-### 커스텀 Charset 사용
+### 압축 인코딩
 
 ```typescript
 import { Ddu64 } from "@ddunigma/node";
 
-const koreanChars = [
-  "뜌", "뜍", "뜎", "뜏", "뜐", "뜑", "뜒", "뜓",
-  "뜔", "뜕", "뜖", "뜗", "뜘", "뜙", "뜚", "뜛",
-  "뜜", "뜝", "뜞", "뜟", "뜠", "뜡", "뜢", "뜣",
-  "뜨", "뜩", "뜪", "뜫",
-  // ... 256개 문자
-];
+// 생성자에서 기본 압축 활성화
+const encoder = new Ddu64(undefined, undefined, {
+  compress: true,
+});
 
-const encoder = new Ddu64(koreanChars, "뭐");
+// 또는 encode 호출 시 압축 옵션 지정
+const text = "반복되는 긴 텍스트...".repeat(100);
+const encoded = encoder.encode(text, { compress: true });
+const decoded = encoder.decode(encoded); // 자동으로 압축 해제
+```
 
-const text = "안녕하세요12";
-const encoded = encoder.encode(text);
-const decoded = encoder.decode(encoded);
-const decodedBuffer = encoder.decodeToBuffer(encoded);
+### URL-Safe 인코딩
+
+```typescript
+import { CharsetBuilder, Ddu64 } from "@ddunigma/node";
+
+const { charset, padding } = CharsetBuilder.base64().buildWithPadding("=");
+
+const encoder = new Ddu64(charset, padding, {
+  urlSafe: true, // +, /, = 를 URL 안전 문자로 변환
+});
+
+const encoded = encoder.encode("Hello World!");
+// URL에서 안전하게 사용 가능한 문자열 반환
 ```
 
-### 압축 인코딩 사용
+`urlSafe` 는 charset/padding이 `-`, `_`, `.` 를 포함하지 않을 때만 활성화됩니다. 또한 chunk 정규화를 위해 custom charset/padding에는 `\r`, `\n` 을 사용할 수 없습니다.
+
+### 체크섬 (무결성 검증)
 
 ```typescript
 import { Ddu64 } from "@ddunigma/node";
 
-// 생성자에서 기본 압축 활성화
 const encoder = new Ddu64(undefined, undefined, {
-  compress: true,
+  checksum: true, // CRC32 체크섬 활성화
 });
 
-// 또는 encode 호출 시 압축 옵션 지정
-const text = "반복되는 긴 텍스트...".repeat(100);
-const encoded = encoder.encode(text, { compress: true });
-const decoded = encoder.decode(encoded); // 자동으로 압축 해제
+const encoded = encoder.encode("Important data", { checksum: true });
+const decoded = encoder.decode(encoded); // 자동으로 체크섬 검증
+// 체크섬 불일치 시 에러 발생
+```
+
+### 암호화
+
+```typescript
+import { Ddu64 } from "@ddunigma/node";
+
+const encoder = new Ddu64(undefined, undefined, {
+  encryptionKey: "my-secret-key-123", // AES-256-GCM 암호화
+});
+
+const encoded = encoder.encode("Secret message!");
+const decoded = encoder.decode(encoded); // 자동으로 복호화
+```
+
+### 청크 분할
+
+```typescript
+import { Ddu64 } from "@ddunigma/node";
+
+const encoder = new Ddu64();
+
+const encoded = encoder.encode(longData, {
+  chunkSize: 76, // 76자마다 분할
+  chunkSeparator: "\n", // 줄바꿈으로 구분
+});
+// 결과: "ABCDxyz...\nEFGHijk...\n..."
+
+const decoded = encoder.decode(encoded); // 자동으로 줄바꿈 제거
 ```
 
-### Zip Bomb 방어 설정
+### 비동기 인코딩/디코딩
+
+```typescript
+import { Ddu64 } from "@ddunigma/node";
+
+const encoder = new Ddu64();
+
+// 비동기 인코딩
+const encoded = await encoder.encodeAsync(largeData);
+const decoded = await encoder.decodeAsync(encoded);
+const buffer = await encoder.decodeToBufferAsync(encoded);
+```
+
+큰 입력에서 기본 경로는 이벤트 루프에 양보하면서 처리합니다. 다만 압축, 암호화, 체크섬, URL-safe 같은 옵션이 함께 켜진 복합 경로는 안전성을 위해 전체 payload 기준 fallback을 사용할 수 있습니다.
+
+### 진행률 콜백
+
+```typescript
+import { Ddu64 } from "@ddunigma/node";
+
+const encoder = new Ddu64();
+
+encoder.encode(largeData, {
+  onProgress: (info) => {
+    console.log(`진행률: ${info.percent}%`);
+    console.log(`처리됨: ${info.processedBytes}/${info.totalBytes}`);
+  },
+});
+```
+
+### 통계/분석
+
+```typescript
+import { Ddu64 } from "@ddunigma/node";
+
+const encoder = new Ddu64();
+
+const stats = encoder.getStats("Test data", { compress: true });
+console.log(stats);
+// {
+//   originalSize: 9,
+//   encodedSize: 12,
+//   compressedSize: 17,
+//   compressionRatio: 1.89,
+//   expansionRatio: 1.33,
+//   charsetSize: 64,
+//   bitLength: 6
+// }
+```
+
+### Zip Bomb 방어
 
 ```typescript
 import { Ddu64 } from "@ddunigma/node";
 
-// 디코딩/압축해제 크기 제한 설정 (기본값: 64MB)
 const encoder = new Ddu64(undefined, undefined, {
   maxDecodedBytes: 10 * 1024 * 1024, // 10MB
   maxDecompressedBytes: 50 * 1024 * 1024, // 50MB
 });
 
-// 또는 decode 호출 시 옵션 지정
-const decoded = encoder.decode(encoded, {
-  maxDecodedBytes: 1024 * 1024, // 1MB
+// 제한 초과 시 에러 발생
+```
+
+---
+
+## CharsetBuilder
+
+커스텀 charset을 쉽게 생성할 수 있는 빌더 유틸리티입니다.
+
+```typescript
+import { CharsetBuilder } from "@ddunigma/node";
+
+// 유니코드 범위에서 생성
+const chars1 = CharsetBuilder.fromUnicodeRange(0x4e00, 0x4e3f).build();
+
+// Base64 문자셋
+const chars2 = CharsetBuilder.base64().build();
+
+// 혼동 문자 제외 (0, O, 1, l, I 등)
+const chars3 = CharsetBuilder.base64().excludeConfusing().build();
+
+// 2의 제곱수로 제한
+const chars4 = CharsetBuilder.fromString("ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789")
+  .limitToPowerOfTwo()
+  .build(); // 32자
+
+// URL 안전 문자만
+const chars5 = CharsetBuilder.base64().excludeUrlUnsafe().build();
+
+// 시드 기반 셔플
+const chars6 = CharsetBuilder.base64().shuffle(12345).build();
+
+// 패딩 문자와 함께 빌드
+const { charset, padding } = CharsetBuilder.base64().buildWithPadding();
+```
+
+---
+
+## DduPipeline
+
+다단계 인코딩/암호화/압축을 조합할 수 있는 파이프라인 빌더입니다.
+
+```typescript
+import { DduPipeline, Ddu64 } from "@ddunigma/node";
+
+const encoder = new Ddu64();
+
+// 압축 → 암호화 → 인코딩 파이프라인
+const pipeline = new DduPipeline()
+  .compress(6, "brotli")
+  .encrypt("my-secret-key")
+  .encode(encoder);
+
+const encoded = pipeline.processToString("Hello World!");
+
+// 역순 파이프라인으로 복원
+const decoded = pipeline.reverse().processToString(encoded);
+```
+
+---
+
+## 스트림 지원
+
+대용량 파일 처리를 위한 스트림 인코딩/디코딩을 지원합니다.
+
+```typescript
+import { Ddu64, createEncodeStream, createDecodeStream } from "@ddunigma/node";
+import fs from "fs";
+
+const encoder = new Ddu64();
+
+// 인코딩 스트림
+fs.createReadStream("input.bin")
+  .pipe(createEncodeStream(encoder))
+  .pipe(fs.createWriteStream("output.txt"));
+
+// 디코딩 스트림
+fs.createReadStream("output.txt")
+  .pipe(createDecodeStream(encoder))
+  .pipe(fs.createWriteStream("restored.bin"));
+```
+
+압축과 암호화를 함께 사용하는 스트림도 바로 연결할 수 있습니다.
+
+```typescript
+import { Ddu64, DduSetSymbol, createEncodeStream, createDecodeStream } from "@ddunigma/node";
+import fs from "fs";
+
+const encoder = new Ddu64(undefined, undefined, {
+  dduSetSymbol: DduSetSymbol.ONECHARSET,
+  compress: true,
+  compressionAlgorithm: "brotli",
+  encryptionKey: "stream-secret-key",
 });
+
+fs.createReadStream("input.log")
+  .pipe(createEncodeStream(encoder))
+  .pipe(fs.createWriteStream("input.log.ddu"));
+
+fs.createReadStream("input.log.ddu")
+  .pipe(createDecodeStream(encoder))
+  .pipe(fs.createWriteStream("input-restored.log"));
+```
+
+기본 `createEncodeStream()` 은 작은 스트림 헤더를 함께 기록하고, 기본 `createDecodeStream()` 은 이 헤더를 읽어 압축/암호화 설정을 초기에 auto-detect 합니다. 그래서 기본 경로도 조기 스트리밍 복원이 가능합니다. 암호화된 payload는 동일한 `encryptionKey`가 필요합니다.
+
+기존 footer-only 스트림 payload도 계속 디코드됩니다. 다만 과거 포맷은 디코드 쪽에서 전체 payload를 버퍼링할 수 있습니다.
+
+헤더 없이 명시적 설정만으로 encode/decode 하려면 양쪽 모두에서 `streamAutoDetect: false` 와 함께 동일한 `compress`, `compressionAlgorithm`, `encryptionKey` 설정을 맞춰 주세요.
+
+---
+
+## Benchmark
+
+대표 시나리오 기준으로 인코딩/디코딩 시간과 샘플링 기반 peak heap 변화를 확인할 수 있습니다.
+
+```bash
+pnpm bench
 ```
 
-## API
+벤치마크는 `--expose-gc`로 실행되며, 일반 인코딩, 청크 인코딩, 압축, 암호화 비동기 경로, 공개 스트림 API 조합을 함께 측정합니다.
+
+샘플링 기반 측정이므로 profiler 수준의 정확한 peak memory는 아니며, 긴 동기 CPU 구간에서는 실제 피크보다 낮게 보일 수 있습니다.
+
+---
+
+## API Reference
 
 ### `new Ddu64(dduChar?, paddingChar?, options?)`
 
@@ -134,84 +350,132 @@ const decoded = encoder.decode(encoded, {
 
 **Parameters:**
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `dduChar` | `string \| string[]` | charset 문자열 또는 배열 |
-| `paddingChar` | `string` | 패딩 문자 |
-| `options` | `DduConstructorOptions` | 옵션 객체 |
+| Parameter     | Type                    | Description              |
+| ------------- | ----------------------- | ------------------------ |
+| `dduChar`     | `string \| string[]`    | charset 문자열 또는 배열 |
+| `paddingChar` | `string`                | 패딩 문자                |
+| `options`     | `DduConstructorOptions` | 옵션 객체                |
 
 **DduConstructorOptions:**
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `dduSetSymbol` | `DduSetSymbol` | `DDU` | 미리 정의된 charset 심볼 |
-| `encoding` | `BufferEncoding` | `'utf-8'` | 문자열 인코딩 |
-| `usePowerOfTwo` | `boolean` | `true` | 2의 제곱수 강제 여부 |
-| `useBuildErrorReturn` | `boolean` | `false` | 에러 발생 시 throw 여부 |
-| `compress` | `boolean` | `false` | 기본 압축 활성화 |
-| `maxDecodedBytes` | `number` | `67108864` | 최대 디코딩 바이트 (64MB) |
-| `maxDecompressedBytes` | `number` | `67108864` | 최대 압축해제 바이트 (64MB) |
+| Option                 | Type             | Default     | Description                 |
+| ---------------------- | ---------------- | ----------- | --------------------------- |
+| `dduSetSymbol`         | `DduSetSymbol`   | `DDU`       | 미리 정의된 charset 심볼    |
+| `encoding`             | `BufferEncoding` | `'utf-8'`   | 문자열 인코딩               |
+| `usePowerOfTwo`        | `boolean`        | `true`      | 2의 제곱수 강제 여부        |
+| `useBuildErrorReturn`  | `boolean`        | `false`     | 에러 발생 시 throw 여부     |
+| `throwOnError`         | `boolean`        | `false`     | 초기화 오류 시 throw 여부   |
+| `compress`             | `boolean`        | `false`     | 기본 압축 활성화            |
+| `compressionAlgorithm` | `"deflate" \| "brotli"` | `'deflate'` | 기본 압축 알고리즘 |
+| `compressionLevel`     | `number`         | `6`         | 압축 레벨                   |
+| `maxDecodedBytes`      | `number`         | `67108864`  | 최대 디코딩 바이트 (64MB)   |
+| `maxDecompressedBytes` | `number`         | `67108864`  | 최대 압축해제 바이트 (64MB) |
+| `urlSafe`              | `boolean`        | `false`     | URL-Safe 모드               |
+| `encryptionKey`        | `string`         | `undefined` | AES-256-GCM 암호화 키       |
+| `checksum`             | `boolean`        | `false`     | CRC32 체크섬 활성화         |
+| `chunkSize`            | `number`         | `undefined` | 청크 분할 크기              |
+| `chunkSeparator`       | `string`         | `'\n'`      | 청크 구분자                 |
+
+`urlSafe` 는 charset/padding이 `-`, `_`, `.` 를 포함하지 않을 때만 켜집니다. 기본 chunk 정규화와 충돌하므로 custom `charset` 과 `paddingChar` 에는 `\r`, `\n` 을 사용할 수 없습니다.
 
 ### `encode(data, options?): string`
 
 데이터를 인코딩합니다.
 
-**Parameters:**
+**DduOptions:**
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `data` | `string \| Buffer` | 인코딩할 데이터 |
-| `options.compress` | `boolean` | 압축 사용 여부 |
+| Option | Type | Description |
+| ------ | ---- | ----------- |
+| `compress` | `boolean` | 압축 사용 여부 |
+| `streamAutoDetect` | `boolean` | 기본 스트림 헤더 기반 auto-detect 사용 여부 (`false`이면 footer-only 명시 설정 모드) |
+| `compressionAlgorithm` | `"deflate" \| "brotli"` | 압축 알고리즘 |
+| `compressionLevel` | `number` | 압축 레벨 |
+| `checksum` | `boolean` | 체크섬 추가 여부 |
+| `maxDecodedBytes` | `number` | 최대 디코딩 바이트 |
+| `maxDecompressedBytes` | `number` | 최대 압축해제 바이트 |
+| `chunkSize` | `number` | 청크 분할 크기 |
+| `chunkSeparator` | `string`   | 청크 구분자      |
+| `onProgress`     | `function` | 진행률 콜백      |
 
-**Returns:** 인코딩된 문자열
+`encrypt` 와 `omitFooter` 는 스트림 내부 파이프라인 제어용 옵션이며 일반적인 공개 사용 시에는 직접 지정할 필요가 없습니다.
 
 ### `decode(encoded, options?): string`
 
 인코딩된 문자열을 디코딩합니다.
 
-**Parameters:**
+### `decodeToBuffer(encoded, options?): Buffer`
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `encoded` | `string` | 인코딩된 문자열 |
-| `options.maxDecodedBytes` | `number` | 최대 디코딩 바이트 |
-| `options.maxDecompressedBytes` | `number` | 최대 압축해제 바이트 |
+인코딩된 문자열을 Buffer로 직접 디코딩합니다.
 
-**Returns:** 디코딩된 문자열
+### `encodeAsync(data, options?): Promise<string>`
 
-### `decodeToBuffer(encoded, options?): Buffer`
+비동기로 데이터를 인코딩합니다.
 
-인코딩된 문자열을 Buffer로 직접 디코딩합니다.
+### `decodeAsync(encoded, options?): Promise<string>`
 
-**Parameters:** `decode`와 동일
+비동기로 데이터를 디코딩합니다.
 
-**Returns:** 디코딩된 Buffer
+### `decodeToBufferAsync(encoded, options?): Promise<Buffer>`
 
-### `getCharSetInfo(): CharSetInfo`
+비동기로 Buffer로 디코딩합니다.
 
-현재 인코더의 charset 정보를 반환합니다.
+### `getStats(data, options?): DduEncodeStats`
 
-**Returns:**
+인코딩 통계 정보를 반환합니다.
 
 ```typescript
 {
-  charSet: string[];
-  paddingChar: string;
-  charLength: number;
-  bitLength: number;
-  usePowerOfTwo: boolean;
-  encoding: BufferEncoding;
-  defaultCompress: boolean;
-  defaultMaxDecodedBytes: number;
-  defaultMaxDecompressedBytes: number;
+  originalSize: number;      // 원본 데이터 크기
+  encodedSize: number;       // 인코딩된 문자열 길이
+  compressedSize?: number;   // 압축된 크기
+  compressionRatio?: number; // 압축률 (0-1)
+  expansionRatio: number;    // 인코딩 확장 비율
+  charsetSize: number;       // charset 크기
+  bitLength: number;         // 비트 길이
 }
 ```
 
+### `getCharSetInfo(): CharSetInfo`
+
+현재 인코더의 charset 정보를 반환합니다.
+
+---
+
 ## DduSetSymbol
 
-| Symbol | 문자 수 | 비트 길이 | 설명 |
-|--------|---------|-----------|------|
-| `DDU` | 8 | 3 | 한글 + 특수문자 기본 세트 |
-| `ONECHARSET` | 64 | 6 | 영문 + 숫자 + 특수문자 |
-| `TWOCHARSET` | 1024 | 10 | 2글자 조합 세트 |
-| `THREECHARSET` | 32768 | 15 | 3글자 조합 세트 |
+| Symbol         | 문자 수 | 비트 길이 | 설명                      |
+| -------------- | ------- | --------- | ------------------------- |
+| `DDU`          | 8       | 3         | 한글 + 특수문자 기본 세트 |
+| `ONECHARSET`   | 64      | 6         | 영문 + 숫자 + 특수문자    |
+| `TWOCHARSET`   | 1024    | 10        | 2글자 조합 세트           |
+| `THREECHARSET` | 32768   | 15        | 3글자 조합 세트           |
+
+---
+
+## Testing
+
+This project uses [Vitest](https://vitest.dev/) for testing.
+
+```bash
+# Run all tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
+```
+
+## Verification
+
+```bash
+pnpm lint
+pnpm build
+pnpm test
+pnpm pack:check
+pnpm bench
+```
+
+---
+
+## License
+
+BSD-2-Clause

package/dist/DduStream-KO75MEEM.js

@@ -0,0 +1,2 @@
+export{m as DduDecodeStream,l as DduEncodeStream,o as createDecodeStream,n as createEncodeStream}from'./chunk-CZMUPXSK.js';//# sourceMappingURL=DduStream-KO75MEEM.js.map
+//# sourceMappingURL=DduStream-KO75MEEM.js.map

package/dist/chunk-CZMUPXSK.js

@@ -0,0 +1,5 @@
+import {Transform,PassThrough}from'stream';import {createBrotliCompress,constants,createDeflate,createBrotliDecompress,createInflate}from'zlib';var R={"-":"+",_:"/",".":"="},T=(()=>{let n=new Uint32Array(256);for(let e=0;e<256;e++){let r=e;for(let t=0;t<8;t++)r=r>>>1^(r&1?3988292384:0);n[e]=r;}return n})(),_="ELYSIA",P="GRISEO",b="CHK",N="ENC";function W(n){if(n.length===0)return n;let e=new Array(n.length);for(let r=0;r<n.length;r++){let t=n[r];t==="+"?e[r]="-":t==="/"?e[r]="_":t==="="?e[r]=".":e[r]=t;}return e.join("")}function H(n){if(n.length===0)return n;let e=new Array(n.length);for(let r=0;r<n.length;r++){let t=n[r];t==="-"?e[r]="+":t==="_"?e[r]="/":t==="."?e[r]="=":e[r]=t;}return e.join("")}function K(n,e,r){if(e<=0||n.length<=e)return n;let t=Math.ceil(n.length/e),i=new Array(t*2-1),s=0;for(let o=0;o<n.length;o+=e)i[s++]=n.slice(o,o+e),o+e<n.length&&(i[s++]=r);return i.join("")}function h(n,e){if(n.length===0)return n;let r=e&&e!==`
+`&&e!==`\r
+`&&e!=="\r"?e:"",t=r.length,i="";for(let s=0;s<n.length;s++){let o=n[s];if(!(o===`
+`||o==="\r")){if(t>0&&o===r[0]&&n.startsWith(r,s)){s+=t-1;continue}i+=o;}}return i}function j(n){let e=4294967295;for(let r=0;r<n.length;r++)e=e>>>8^T[(e^n[r])&255];return ((e^4294967295)>>>0).toString(16).padStart(8,"0")}function F(n){let e=n.lastIndexOf(b);if(e===-1)return {data:n,checksum:null};let r=n.slice(e+b.length);return r.length!==8||!/^[0-9a-f]+$/i.test(r)?{data:n,checksum:null}:{data:n.slice(0,e),checksum:r.toLowerCase()}}var c="DDS1";function I(n,e){let t=n===void 0||!Number.isFinite(n)?6:Math.floor(n);return Math.min(e==="brotli"?11:9,Math.max(0,t))}function C(n){return n.length*2+c.length+2}function k(n,e){let r=e.compressionAlgorithm==="brotli"?"B":e.compressionAlgorithm==="deflate"?"D":"N",t=e.encrypted?"1":"0";return `${n}${c}${r}${t}${n}`}function D(n,e){let r=C(e);if(n.length<r||!n.startsWith(e))return null;let t=e.length;if(n.slice(t,t+c.length)!==c)throw new Error("[DduStream decode] Invalid stream header magic");let s=n[t+c.length],o=n[t+c.length+1];if(n.slice(r-e.length,r)!==e)throw new Error("[DduStream decode] Invalid stream header terminator");let a=s==="B"?"brotli":s==="D"?"deflate":s==="N"?void 0:null;if(a===null)throw new Error("[DduStream decode] Invalid stream header compression flag");if(o!=="0"&&o!=="1")throw new Error("[DduStream decode] Invalid stream header encryption flag");return {compressionAlgorithm:a,encrypted:o==="1"}}var m=class extends Transform{prefix;emittedPrefix=false;constructor(e){super(),this.prefix=e;}_transform(e,r,t){try{this.emittedPrefix||(this.push(this.prefix),this.emittedPrefix=!0),this.push(e),t();}catch(i){t(i);}}};function L(n,e){let r=new PassThrough,t=r.write.bind(r);return r.write=function(i,s,o){return typeof s=="function"?n.write(i,s):n.write(i,s,o)},r.end=function(i,s,o){return typeof i=="function"?n.end(i):typeof s=="function"?n.end(i,s):n.end(i,s,o)},e.on("data",i=>t(i)),e.on("end",()=>r.push(null)),e.on("error",i=>r.destroy(i)),n.on("error",i=>r.destroy(i)),r}function v(n){if(n.length===0)return new PassThrough;for(let r=0;r<n.length-1;r++)n[r].pipe(n[r+1]);let e=L(n[0],n[n.length-1]);for(let r of n)r.on("error",t=>{e.destroy(t);});return e}var p=class extends Transform{encoder;buffers;bufferOffset;totalLength;chunkSize;footerCompressionAlgorithm;footerEncrypted;constructor(e,r){super({...r,readableObjectMode:false,writableObjectMode:false}),this.encoder=e;let t=e.getCharSetInfo();this.buffers=[],this.bufferOffset=0,this.totalLength=0,this.footerCompressionAlgorithm=r?.compress??t.defaultCompress?r?.compressionAlgorithm??t.defaultCompressionAlgorithm:void 0,this.footerEncrypted=(r?.encrypt??true)&&t.hasEncryptionKey,this.chunkSize=this.calculateChunkSize(t.bitLength);}calculateChunkSize(e){let r=(s,o)=>o===0?s:r(o,s%o),t=8*e/r(8,e),i=Math.max(1,Math.floor(4096/t));return t*i}_transform(e,r,t){try{for(this.buffers.push(e),this.totalLength+=e.length;this.totalLength>=this.chunkSize;){let i=this.readBytes(this.chunkSize),s=this.encodeChunk(i,!1);this.push(s);}t();}catch(i){t(i);}}_flush(e){try{if(this.totalLength>0){let r=this.readBytes(this.totalLength),t=this.encodeChunk(r,!0);this.push(t);}e();}catch(r){e(r);}}encodeChunk(e,r){return this.encoder.encodeRawBuffer(e,{compressionAlgorithm:r?this.footerCompressionAlgorithm:void 0,encrypted:r?this.footerEncrypted:false,omitFooter:!r})}readBytes(e){if(e<=0||this.totalLength<e)return Buffer.alloc(0);let r=this.buffers[0];if(this.buffers.length===1&&r&&this.bufferOffset===0&&r.length===e)return this.buffers=[],this.totalLength=0,r;let t=Buffer.allocUnsafe(e),i=0;for(;i<e&&this.buffers.length>0;){let s=this.buffers[0],o=s.length-this.bufferOffset,f=Math.min(e-i,o);s.copy(t,i,this.bufferOffset,this.bufferOffset+f),i+=f,this.bufferOffset+=f,this.bufferOffset>=s.length&&(this.buffers.shift(),this.bufferOffset=0);}return this.totalLength-=e,t}},g=class extends Transform{encoder;options;normalizedBuffer;charLength;chunkSize;chunkSeparator;separatorTail;constructor(e,r){super({...r,readableObjectMode:false,writableObjectMode:false}),this.encoder=e,this.options={...r,compress:false,checksum:false,encrypt:false},this.normalizedBuffer="";let t=e.getCharSetInfo();this.charLength=t.charLength,this.chunkSeparator=r?.chunkSeparator??t.defaultChunkSeparator,this.separatorTail="",this.chunkSize=this.calculateChunkSize(t.charLength);}calculateChunkSize(e){return e*1024}_transform(e,r,t){try{this.appendNormalizedChunk(e.toString("utf-8"));let i=100;for(;this.normalizedBuffer.length>=this.chunkSize+i;){let s=this.normalizedBuffer.slice(0,this.chunkSize);this.normalizedBuffer=this.normalizedBuffer.slice(this.chunkSize);let o=this.encoder.decodeToBuffer(s,this.options);this.push(o);}t();}catch(i){t(i);}}_flush(e){try{if(this.separatorTail.length>0&&(this.normalizedBuffer+=h(this.separatorTail,this.chunkSeparator),this.separatorTail=""),this.normalizedBuffer.length>0){let r=this.encoder.decodeStreamToBuffer(this.normalizedBuffer,this.options);this.push(r),this.normalizedBuffer="";}e();}catch(r){e(r);}}appendNormalizedChunk(e){if(e.length===0)return;let r=Math.max(0,this.chunkSeparator.length-1);if(r===0){this.normalizedBuffer+=h(e,this.chunkSeparator);return}let t=this.separatorTail+e;if(t.length<=r){this.separatorTail=t;return}let i=t.length-r,s=t.slice(0,i);this.separatorTail=t.slice(i),this.normalizedBuffer+=h(s,this.chunkSeparator);}},y=class extends Transform{encoder;options;normalizedBuffer;chunkSeparator;separatorTail;paddingChar;headerLength;mode;innerStream;constructor(e,r){super({...r,readableObjectMode:false,writableObjectMode:false}),this.encoder=e,this.options={...r},this.normalizedBuffer="";let t=e.getCharSetInfo();this.paddingChar=t.paddingChar,this.headerLength=C(t.paddingChar),this.chunkSeparator=r?.chunkSeparator??t.defaultChunkSeparator,this.separatorTail="",this.mode="pending",this.innerStream=null;}_transform(e,r,t){try{if(this.appendNormalizedChunk(e.toString("utf-8")),this.maybeInitializeMode(!1),this.mode==="pipeline"){this.flushBufferedToInner(t);return}t();}catch(i){t(i);}}_flush(e){try{if(this.separatorTail.length>0&&(this.normalizedBuffer+=h(this.separatorTail,this.chunkSeparator),this.separatorTail=""),this.maybeInitializeMode(!0),this.mode==="pipeline"){this.finishInnerPipeline(e);return}if(this.normalizedBuffer.length>0){let r=this.encoder.decodeStreamToBuffer(this.normalizedBuffer,this.options);this.push(r),this.normalizedBuffer="";}e();}catch(r){e(r);}}appendNormalizedChunk(e){if(e.length===0)return;let r=Math.max(0,this.chunkSeparator.length-1);if(r===0){this.normalizedBuffer+=h(e,this.chunkSeparator);return}let t=this.separatorTail+e;if(t.length<=r){this.separatorTail=t;return}let i=t.length-r,s=t.slice(0,i);this.separatorTail=t.slice(i),this.normalizedBuffer+=h(s,this.chunkSeparator);}maybeInitializeMode(e){if(this.mode!=="pending")return;let r=this.paddingChar.length;if(this.normalizedBuffer.length<r){e&&this.normalizedBuffer.length>0&&(this.mode="legacy");return}if(!this.normalizedBuffer.startsWith(this.paddingChar)){this.mode="legacy";return}if(this.normalizedBuffer.length<this.headerLength){if(e)throw new Error("[DduStream decode] Incomplete stream header");return}let t=this.normalizedBuffer.slice(0,this.headerLength),i=D(t,this.paddingChar);if(!i){this.mode="legacy";return}this.mode="pipeline",this.normalizedBuffer=this.normalizedBuffer.slice(this.headerLength),this.initializeInnerPipeline(i);}initializeInnerPipeline(e){if(e.encrypted&&!this.encoder.getCharSetInfo().hasEncryptionKey)throw new Error("[DduStream decode] Encrypted stream requires an encryptionKey");let r=O(this.encoder,{...this.options,streamAutoDetect:false,compress:!!e.compressionAlgorithm,compressionAlgorithm:e.compressionAlgorithm,encrypt:e.encrypted});r.on("data",t=>{this.push(t);}),r.on("error",t=>{this.destroy(t);}),this.innerStream=r;}flushBufferedToInner(e){if(!this.innerStream||this.normalizedBuffer.length===0){e();return}let r=this.normalizedBuffer;if(this.normalizedBuffer="",!this.innerStream.write(Buffer.from(r,"utf-8"))){this.innerStream.once("drain",()=>e());return}e();}finishInnerPipeline(e){if(!this.innerStream){e();return}let r=this.innerStream,t=()=>{r.once("end",()=>e()),r.end();};if(this.normalizedBuffer.length>0){let i=this.normalizedBuffer;if(this.normalizedBuffer="",!r.write(Buffer.from(i,"utf-8"))){r.once("drain",t);return}}t();}};function Q(n,e){let r=n.getCharSetInfo(),t=e?.compress??r.defaultCompress,i=(e?.encrypt??true)&&r.hasEncryptionKey,s=e?.streamAutoDetect!==false,o=t?e?.compressionAlgorithm??r.defaultCompressionAlgorithm:void 0,f=new p(n,e),a=[];if(t){let l=o??r.defaultCompressionAlgorithm,u=l==="brotli",S=I(e?.compressionLevel??r.defaultCompressionLevel,l),E=u?createBrotliCompress({params:{[constants.BROTLI_PARAM_QUALITY]:Math.min(11,Math.max(0,S))}}):createDeflate({level:Math.min(9,Math.max(0,S))});a.push(E);}if(i){let l=n.createEncryptionStream();l&&a.push(l);}return a.push(f),s&&a.push(new m(k(r.paddingChar,{compressionAlgorithm:o,encrypted:i}))),a.length===1?f:v(a)}function O(n,e){if(e?.streamAutoDetect??true)return new y(n,e);let t=n.getCharSetInfo(),i=e?.compress??t.defaultCompress,s=(e?.encrypt??true)&&t.hasEncryptionKey,o=new g(n,e),f=[o];if(s){let a=n.createDecryptionStream();a&&f.push(a);}if(i){let u=(e?.compressionAlgorithm??t.defaultCompressionAlgorithm)==="brotli"?createBrotliDecompress():createInflate();f.push(u);}return f.length===1?o:v(f)}export{R as a,_ as b,P as c,b as d,N as e,W as f,H as g,K as h,h as i,j,F as k,p as l,g as m,Q as n,O as o};//# sourceMappingURL=chunk-CZMUPXSK.js.map
+//# sourceMappingURL=chunk-CZMUPXSK.js.map