@ddunigma/node 2.2.0 → 3.0.1

package/dist/index.d.cts

@@ -2,22 +2,24 @@ import { Transform, TransformCallback, TransformOptions } from 'stream';
 
 declare enum DduSetSymbol {
     DDU = "ddu",
-    ONECHARSET = "oneCharSet",
-    TWOCHARSET = "twoCharSet",
-    THREECHARSET = "threeCharSet"
+    DDU_V1 = "ddu_v1",
+    ONECHARSET = "oneCharSet"
 }
-
 interface CharSetConfig {
     /** charset 식별 심볼 */
     symbol: DduSetSymbol;
-    /** 인코딩에 사용할 문자 배열 */
+    /** 인코딩에 사용할 문자 배열 (codaChar가 있으면 기본 문자 배열) */
     charSet: string[];
+    /** 종성 문자 배열 (charSet × codaChar 조합으로 최종 charset 생성) */
+    codaChar?: string[];
     /** 최대 필요 문자 수 */
     maxRequiredLength: number;
     /** 비트 길이 (log2) */
     bitLength: number;
     /** 패딩 문자 */
     paddingChar: string;
+    /** 패딩 문자 반복 방식 사용 여부 */
+    useRepeatPadding?: boolean;
 }
 /** 진행률 콜백 정보 */
 interface DduProgressInfo {
@@ -47,6 +49,38 @@ interface DduEncodeStats {
     /** 비트 길이 */
     bitLength: number;
 }
+interface CharSetInfo {
+    /** 인코딩에 사용할 문자 배열 */
+    charSet: string[];
+    /** 패딩 문자 */
+    paddingChar: string;
+    /** 비트 길이 */
+    bitLength: number;
+    /** 2의 제곱수 charset 여부 */
+    usePowerOfTwo: boolean;
+    /** 문자열 인코딩 방식 */
+    encoding: BufferEncoding;
+    /** 기본 압축 사용 여부 */
+    defaultCompress: boolean;
+    /** 기본 최대 디코딩 바이트 수 */
+    defaultMaxDecodedBytes: number;
+    /** 기본 최대 압축해제 바이트 수 */
+    defaultMaxDecompressedBytes: number;
+    /** URL-Safe 모드 여부 */
+    urlSafe: boolean;
+    /** 암호화 키 보유 여부 */
+    hasEncryptionKey: boolean;
+    /** 기본 체크섬 사용 여부 */
+    defaultChecksum: boolean;
+    /** 기본 청크 크기 */
+    defaultChunkSize: number | undefined;
+    /** 기본 청크 구분자 */
+    defaultChunkSeparator: string;
+    /** 기본 압축 레벨 */
+    defaultCompressionLevel: number;
+    /** 기본 압축 알고리즘 */
+    defaultCompressionAlgorithm: "deflate" | "brotli";
+}
 interface DduOptions {
     /** 압축 사용 여부 (zlib deflate 또는 brotli) */
     compress?: boolean;
@@ -78,6 +112,8 @@ interface DduConstructorOptions extends DduOptions {
     dduSetSymbol?: DduSetSymbol;
     /** 커스텀 charset 문자 배열 또는 문자열 */
     dduChar?: string[] | string;
+    /** 종성 문자 배열 (dduChar × codaChar 조합으로 최종 charset 동적 생성) */
+    codaChar?: string[];
     /** 패딩 문자 */
     paddingChar?: string;
     /** 필요 문자 수 */
@@ -104,59 +140,8 @@ interface DduConstructorOptions extends DduOptions {
     urlSafe?: boolean;
     /** 암호화 키 (AES-256-GCM) */
     encryptionKey?: string;
-}
-
-declare abstract class BaseDdu {
-    protected readonly defaultEncoding: BufferEncoding;
-    /**
-     * 주어진 숫자보다 작거나 같은 가장 큰 2의 제곱수의 지수를 반환합니다.
-     * @param n - 대상 숫자
-     * @returns 2의 제곱수 지수 (예: n=8 → 3, n=64 → 6)
-     * @example getLargestPowerOfTwoExponent(8) // 3
-     * @example getLargestPowerOfTwoExponent(100) // 6
-     */
-    protected getLargestPowerOfTwoExponent(n: number): number;
-    /**
-     * charset 크기에 필요한 비트 길이를 계산합니다.
-     * @param setLength - charset 문자 수
-     * @returns 필요한 비트 수
-     * @example getBitLength(64) // 6
-     * @example getBitLength(100) // 7
-     */
-    protected getBitLength(setLength: number): number;
-    /**
-     * 입력 데이터를 인코딩합니다.
-     * @param input - 인코딩할 문자열 또는 Buffer
-     * @param options - 인코딩 옵션
-     * @returns 인코딩된 문자열
-     */
-    abstract encode(input: Buffer | string, options?: DduOptions): string;
-    /**
-     * 인코딩된 문자열을 Buffer로 디코딩합니다.
-     * @param input - 인코딩된 문자열
-     * @param options - 디코딩 옵션
-     * @returns 디코딩된 Buffer
-     */
-    abstract decodeToBuffer(input: string, options?: DduOptions): Buffer;
-    /**
-     * 인코딩된 문자열을 원본 문자열로 디코딩합니다.
-     * @param input - 인코딩된 문자열
-     * @param options - 디코딩 옵션
-     * @returns 디코딩된 문자열
-     */
-    abstract decode(input: string, options?: DduOptions): string;
-    /**
-     * 현재 인코더의 charset 정보를 반환합니다.
-     * @returns charset 설정 정보 객체
-     */
-    abstract getCharSetInfo(): {
-        charSet: string[];
-        paddingChar: string;
-        charLength: number;
-        bitLength: number;
-        usePowerOfTwo: boolean;
-        encoding: BufferEncoding;
-    };
+    /** 패딩 문자 반복 방식 사용 여부 */
+    useRepeatPadding?: boolean;
 }
 
 /**
@@ -200,13 +185,12 @@ declare class GcmDecryptStream extends Transform {
  * const encoder = new Ddu64(undefined, undefined, { compress: true });
  * const encoded = encoder.encode(longText);
  */
-declare class Ddu64 extends BaseDdu {
+declare class Ddu64 {
+    protected readonly defaultEncoding: BufferEncoding;
     /** 인코딩에 사용할 문자 배열 */
     protected readonly dduChar: string[];
     /** 패딩 문자 */
     protected readonly paddingChar: string;
-    /** 각 charset 문자의 길이 */
-    protected readonly charLength: number;
     /** 비트 길이 (log2) */
     protected readonly bitLength: number;
     /** 2의 제곱수 charset 여부 */
@@ -245,6 +229,8 @@ declare class Ddu64 extends BaseDdu {
     private readonly defaultCompressionLevel;
     /** 기본 압축 알고리즘 */
     private readonly defaultCompressionAlgorithm;
+    /** 패딩 문자 반복 방식 사용 여부 */
+    private readonly useRepeatPadding;
     /**
      * Ddu64 인코더 인스턴스를 생성합니다.
      *
@@ -314,35 +300,24 @@ declare class Ddu64 extends BaseDdu {
      */
     decode(input: string, options?: DduOptions): string;
     /**
+     * @internal
      * 공개 스트림 API의 auto-detect 경로에서 사용하는 전용 디코더입니다.
      * 스트림 인코딩은 compress -> encrypt -> encode 순서를 사용하므로,
      * 복원은 decode -> decrypt -> decompress 순서로 수행합니다.
      */
     decodeStreamToBuffer(input: string, options?: DduOptions): Buffer;
+    /**
+     * 공통 디코딩 로직: footer 파싱 → 정렬 검증 → 크기 검증 → decodeFast
+     */
+    private decodeRaw;
     /**
      * 현재 인코더의 charset 정보를 반환합니다.
      *
      * @returns charset 설정 정보 객체
      */
-    getCharSetInfo(): {
-        charSet: string[];
-        paddingChar: string;
-        charLength: number;
-        bitLength: number;
-        usePowerOfTwo: boolean;
-        encoding: BufferEncoding;
-        defaultCompress: boolean;
-        defaultMaxDecodedBytes: number;
-        defaultMaxDecompressedBytes: number;
-        urlSafe: boolean;
-        hasEncryptionKey: boolean;
-        defaultChecksum: boolean;
-        defaultChunkSize: number | undefined;
-        defaultChunkSeparator: string;
-        defaultCompressionLevel: number;
-        defaultCompressionAlgorithm: "deflate" | "brotli";
-    };
+    getCharSetInfo(): CharSetInfo;
     /**
+     * @internal
      * 외부 스트림 파이프라인에서 전처리된 Buffer를 그대로 인코딩합니다.
      * 압축/암호화는 수행하지 않고, 마지막 푸터에만 메타데이터를 반영합니다.
      */
@@ -406,21 +381,27 @@ declare class Ddu64 extends BaseDdu {
      */
     private decryptStreamData;
     /**
+     * @internal
      * 공개 스트림 API에서 사용할 암호화 Transform을 생성합니다.
      */
     createEncryptionStream(): GcmEncryptStream | undefined;
     /**
+     * @internal
      * 공개 스트림 API에서 사용할 복호화 Transform을 생성합니다.
      */
     createDecryptionStream(): GcmDecryptStream | undefined;
     /**
-     * 옵션 값을 정규화합니다.
+     * 주어진 숫자보다 작거나 같은 가장 큰 2의 제곱수의 지수를 반환합니다.
      */
-    private normalizeLimit;
+    private getLargestPowerOfTwoExponent;
+    /**
+     * charset 크기에 필요한 비트 길이를 계산합니다.
+     */
+    private getBitLength;
     /**
-     * 압축 레벨을 알고리즘별 지원 범위에 맞춰 정규화합니다.
+     * 옵션 값을 정규화합니다.
      */
-    private normalizeCompressionLevel;
+    private normalizeLimit;
     /**
      * 디코딩 결과 바이트 수를 추정합니다.
      */
@@ -448,19 +429,11 @@ declare class Ddu64 extends BaseDdu {
      * 일반 정수 연산을 사용한 빠른 디코딩
      */
     private decodeFast;
-    /**
-     * BigInt를 사용한 대형 비트 인코딩
-     */
-    private encodeBigInt;
     /**
      * 인코딩 파트 배열을 최종 문자열로 직렬화합니다.
      * 청크 옵션이 있으면 join 후 split하는 대신 한 번에 separator를 삽입합니다.
      */
     private serializeEncodedParts;
-    /**
-     * BigInt를 사용한 대형 비트 디코딩
-     */
-    private decodeBigInt;
     /**
      * Charset을 정규화합니다.
      */
@@ -786,12 +759,10 @@ declare class DduDecodeStream extends Transform {
     private encoder;
     private options;
     private normalizedBuffer;
-    private charLength;
     private chunkSize;
     private chunkSeparator;
     private separatorTail;
     constructor(encoder: Ddu64, options?: DduOptions & TransformOptions);
-    private calculateChunkSize;
     _transform(chunk: Buffer, _encoding: BufferEncoding, callback: TransformCallback): void;
     _flush(callback: TransformCallback): void;
     private appendNormalizedChunk;
@@ -810,4 +781,4 @@ declare function createEncodeStream(encoder: Ddu64, options?: DduOptions & Trans
  */
 declare function createDecodeStream(encoder: Ddu64, options?: DduOptions & TransformOptions): NodeJS.ReadWriteStream;
 
-export { BaseDdu, type CharSetConfig, CharsetBuilder, Ddu64, type DduConstructorOptions, DduDecodeStream, type DduEncodeStats, DduEncodeStream, type DduOptions, DduPipeline, type DduProgressInfo, DduSetSymbol, createDecodeStream, createEncodeStream };
+export { type CharSetConfig, type CharSetInfo, CharsetBuilder, Ddu64, type DduConstructorOptions, DduDecodeStream, type DduEncodeStats, DduEncodeStream, type DduOptions, DduPipeline, type DduProgressInfo, DduSetSymbol, createDecodeStream, createEncodeStream };

package/dist/index.d.ts

@@ -2,22 +2,24 @@ import { Transform, TransformCallback, TransformOptions } from 'stream';
 
 declare enum DduSetSymbol {
     DDU = "ddu",
-    ONECHARSET = "oneCharSet",
-    TWOCHARSET = "twoCharSet",
-    THREECHARSET = "threeCharSet"
+    DDU_V1 = "ddu_v1",
+    ONECHARSET = "oneCharSet"
 }
-
 interface CharSetConfig {
     /** charset 식별 심볼 */
     symbol: DduSetSymbol;
-    /** 인코딩에 사용할 문자 배열 */
+    /** 인코딩에 사용할 문자 배열 (codaChar가 있으면 기본 문자 배열) */
     charSet: string[];
+    /** 종성 문자 배열 (charSet × codaChar 조합으로 최종 charset 생성) */
+    codaChar?: string[];
     /** 최대 필요 문자 수 */
     maxRequiredLength: number;
     /** 비트 길이 (log2) */
     bitLength: number;
     /** 패딩 문자 */
     paddingChar: string;
+    /** 패딩 문자 반복 방식 사용 여부 */
+    useRepeatPadding?: boolean;
 }
 /** 진행률 콜백 정보 */
 interface DduProgressInfo {
@@ -47,6 +49,38 @@ interface DduEncodeStats {
     /** 비트 길이 */
     bitLength: number;
 }
+interface CharSetInfo {
+    /** 인코딩에 사용할 문자 배열 */
+    charSet: string[];
+    /** 패딩 문자 */
+    paddingChar: string;
+    /** 비트 길이 */
+    bitLength: number;
+    /** 2의 제곱수 charset 여부 */
+    usePowerOfTwo: boolean;
+    /** 문자열 인코딩 방식 */
+    encoding: BufferEncoding;
+    /** 기본 압축 사용 여부 */
+    defaultCompress: boolean;
+    /** 기본 최대 디코딩 바이트 수 */
+    defaultMaxDecodedBytes: number;
+    /** 기본 최대 압축해제 바이트 수 */
+    defaultMaxDecompressedBytes: number;
+    /** URL-Safe 모드 여부 */
+    urlSafe: boolean;
+    /** 암호화 키 보유 여부 */
+    hasEncryptionKey: boolean;
+    /** 기본 체크섬 사용 여부 */
+    defaultChecksum: boolean;
+    /** 기본 청크 크기 */
+    defaultChunkSize: number | undefined;
+    /** 기본 청크 구분자 */
+    defaultChunkSeparator: string;
+    /** 기본 압축 레벨 */
+    defaultCompressionLevel: number;
+    /** 기본 압축 알고리즘 */
+    defaultCompressionAlgorithm: "deflate" | "brotli";
+}
 interface DduOptions {
     /** 압축 사용 여부 (zlib deflate 또는 brotli) */
     compress?: boolean;
@@ -78,6 +112,8 @@ interface DduConstructorOptions extends DduOptions {
     dduSetSymbol?: DduSetSymbol;
     /** 커스텀 charset 문자 배열 또는 문자열 */
     dduChar?: string[] | string;
+    /** 종성 문자 배열 (dduChar × codaChar 조합으로 최종 charset 동적 생성) */
+    codaChar?: string[];
     /** 패딩 문자 */
     paddingChar?: string;
     /** 필요 문자 수 */
@@ -104,59 +140,8 @@ interface DduConstructorOptions extends DduOptions {
     urlSafe?: boolean;
     /** 암호화 키 (AES-256-GCM) */
     encryptionKey?: string;
-}
-
-declare abstract class BaseDdu {
-    protected readonly defaultEncoding: BufferEncoding;
-    /**
-     * 주어진 숫자보다 작거나 같은 가장 큰 2의 제곱수의 지수를 반환합니다.
-     * @param n - 대상 숫자
-     * @returns 2의 제곱수 지수 (예: n=8 → 3, n=64 → 6)
-     * @example getLargestPowerOfTwoExponent(8) // 3
-     * @example getLargestPowerOfTwoExponent(100) // 6
-     */
-    protected getLargestPowerOfTwoExponent(n: number): number;
-    /**
-     * charset 크기에 필요한 비트 길이를 계산합니다.
-     * @param setLength - charset 문자 수
-     * @returns 필요한 비트 수
-     * @example getBitLength(64) // 6
-     * @example getBitLength(100) // 7
-     */
-    protected getBitLength(setLength: number): number;
-    /**
-     * 입력 데이터를 인코딩합니다.
-     * @param input - 인코딩할 문자열 또는 Buffer
-     * @param options - 인코딩 옵션
-     * @returns 인코딩된 문자열
-     */
-    abstract encode(input: Buffer | string, options?: DduOptions): string;
-    /**
-     * 인코딩된 문자열을 Buffer로 디코딩합니다.
-     * @param input - 인코딩된 문자열
-     * @param options - 디코딩 옵션
-     * @returns 디코딩된 Buffer
-     */
-    abstract decodeToBuffer(input: string, options?: DduOptions): Buffer;
-    /**
-     * 인코딩된 문자열을 원본 문자열로 디코딩합니다.
-     * @param input - 인코딩된 문자열
-     * @param options - 디코딩 옵션
-     * @returns 디코딩된 문자열
-     */
-    abstract decode(input: string, options?: DduOptions): string;
-    /**
-     * 현재 인코더의 charset 정보를 반환합니다.
-     * @returns charset 설정 정보 객체
-     */
-    abstract getCharSetInfo(): {
-        charSet: string[];
-        paddingChar: string;
-        charLength: number;
-        bitLength: number;
-        usePowerOfTwo: boolean;
-        encoding: BufferEncoding;
-    };
+    /** 패딩 문자 반복 방식 사용 여부 */
+    useRepeatPadding?: boolean;
 }
 
 /**
@@ -200,13 +185,12 @@ declare class GcmDecryptStream extends Transform {
  * const encoder = new Ddu64(undefined, undefined, { compress: true });
  * const encoded = encoder.encode(longText);
  */
-declare class Ddu64 extends BaseDdu {
+declare class Ddu64 {
+    protected readonly defaultEncoding: BufferEncoding;
     /** 인코딩에 사용할 문자 배열 */
     protected readonly dduChar: string[];
     /** 패딩 문자 */
     protected readonly paddingChar: string;
-    /** 각 charset 문자의 길이 */
-    protected readonly charLength: number;
     /** 비트 길이 (log2) */
     protected readonly bitLength: number;
     /** 2의 제곱수 charset 여부 */
@@ -245,6 +229,8 @@ declare class Ddu64 extends BaseDdu {
     private readonly defaultCompressionLevel;
     /** 기본 압축 알고리즘 */
     private readonly defaultCompressionAlgorithm;
+    /** 패딩 문자 반복 방식 사용 여부 */
+    private readonly useRepeatPadding;
     /**
      * Ddu64 인코더 인스턴스를 생성합니다.
      *
@@ -314,35 +300,24 @@ declare class Ddu64 extends BaseDdu {
      */
     decode(input: string, options?: DduOptions): string;
     /**
+     * @internal
      * 공개 스트림 API의 auto-detect 경로에서 사용하는 전용 디코더입니다.
      * 스트림 인코딩은 compress -> encrypt -> encode 순서를 사용하므로,
      * 복원은 decode -> decrypt -> decompress 순서로 수행합니다.
      */
     decodeStreamToBuffer(input: string, options?: DduOptions): Buffer;
+    /**
+     * 공통 디코딩 로직: footer 파싱 → 정렬 검증 → 크기 검증 → decodeFast
+     */
+    private decodeRaw;
     /**
      * 현재 인코더의 charset 정보를 반환합니다.
      *
      * @returns charset 설정 정보 객체
      */
-    getCharSetInfo(): {
-        charSet: string[];
-        paddingChar: string;
-        charLength: number;
-        bitLength: number;
-        usePowerOfTwo: boolean;
-        encoding: BufferEncoding;
-        defaultCompress: boolean;
-        defaultMaxDecodedBytes: number;
-        defaultMaxDecompressedBytes: number;
-        urlSafe: boolean;
-        hasEncryptionKey: boolean;
-        defaultChecksum: boolean;
-        defaultChunkSize: number | undefined;
-        defaultChunkSeparator: string;
-        defaultCompressionLevel: number;
-        defaultCompressionAlgorithm: "deflate" | "brotli";
-    };
+    getCharSetInfo(): CharSetInfo;
     /**
+     * @internal
      * 외부 스트림 파이프라인에서 전처리된 Buffer를 그대로 인코딩합니다.
      * 압축/암호화는 수행하지 않고, 마지막 푸터에만 메타데이터를 반영합니다.
      */
@@ -406,21 +381,27 @@ declare class Ddu64 extends BaseDdu {
      */
     private decryptStreamData;
     /**
+     * @internal
      * 공개 스트림 API에서 사용할 암호화 Transform을 생성합니다.
      */
     createEncryptionStream(): GcmEncryptStream | undefined;
     /**
+     * @internal
      * 공개 스트림 API에서 사용할 복호화 Transform을 생성합니다.
      */
     createDecryptionStream(): GcmDecryptStream | undefined;
     /**
-     * 옵션 값을 정규화합니다.
+     * 주어진 숫자보다 작거나 같은 가장 큰 2의 제곱수의 지수를 반환합니다.
      */
-    private normalizeLimit;
+    private getLargestPowerOfTwoExponent;
+    /**
+     * charset 크기에 필요한 비트 길이를 계산합니다.
+     */
+    private getBitLength;
     /**
-     * 압축 레벨을 알고리즘별 지원 범위에 맞춰 정규화합니다.
+     * 옵션 값을 정규화합니다.
      */
-    private normalizeCompressionLevel;
+    private normalizeLimit;
     /**
      * 디코딩 결과 바이트 수를 추정합니다.
      */
@@ -448,19 +429,11 @@ declare class Ddu64 extends BaseDdu {
      * 일반 정수 연산을 사용한 빠른 디코딩
      */
     private decodeFast;
-    /**
-     * BigInt를 사용한 대형 비트 인코딩
-     */
-    private encodeBigInt;
     /**
      * 인코딩 파트 배열을 최종 문자열로 직렬화합니다.
      * 청크 옵션이 있으면 join 후 split하는 대신 한 번에 separator를 삽입합니다.
      */
     private serializeEncodedParts;
-    /**
-     * BigInt를 사용한 대형 비트 디코딩
-     */
-    private decodeBigInt;
     /**
      * Charset을 정규화합니다.
      */
@@ -786,12 +759,10 @@ declare class DduDecodeStream extends Transform {
     private encoder;
     private options;
     private normalizedBuffer;
-    private charLength;
     private chunkSize;
     private chunkSeparator;
     private separatorTail;
     constructor(encoder: Ddu64, options?: DduOptions & TransformOptions);
-    private calculateChunkSize;
     _transform(chunk: Buffer, _encoding: BufferEncoding, callback: TransformCallback): void;
     _flush(callback: TransformCallback): void;
     private appendNormalizedChunk;
@@ -810,4 +781,4 @@ declare function createEncodeStream(encoder: Ddu64, options?: DduOptions & Trans
  */
 declare function createDecodeStream(encoder: Ddu64, options?: DduOptions & TransformOptions): NodeJS.ReadWriteStream;
 
-export { BaseDdu, type CharSetConfig, CharsetBuilder, Ddu64, type DduConstructorOptions, DduDecodeStream, type DduEncodeStats, DduEncodeStream, type DduOptions, DduPipeline, type DduProgressInfo, DduSetSymbol, createDecodeStream, createEncodeStream };
+export { type CharSetConfig, type CharSetInfo, CharsetBuilder, Ddu64, type DduConstructorOptions, DduDecodeStream, type DduEncodeStats, DduEncodeStream, type DduOptions, DduPipeline, type DduProgressInfo, DduSetSymbol, createDecodeStream, createEncodeStream };