@ddunigma/node 2.1.1 → 2.2.0

package/dist/mjs/encoders/index.d.ts

@@ -1 +0,0 @@
-export { Ddu64 } from "./Ddu64";

package/dist/mjs/encoders/index.js

@@ -1 +0,0 @@
-export { Ddu64 } from "./Ddu64.js";

package/dist/mjs/index.d.ts

@@ -1,5 +0,0 @@
-export type { DduOptions, DduConstructorOptions, DduEncodeStats, DduProgressInfo, CharSetConfig, } from "./types";
-export { DduSetSymbol } from "./types";
-export { BaseDdu } from "./base";
-export { Ddu64 } from "./encoders";
-export { CharsetBuilder, DduPipeline, DduEncodeStream, DduDecodeStream, createEncodeStream, createDecodeStream, } from "./utils";

package/dist/mjs/index.js

@@ -1,4 +0,0 @@
-export { DduSetSymbol } from "./types/index.js";
-export { BaseDdu } from "./base/index.js";
-export { Ddu64 } from "./encoders/index.js";
-export { CharsetBuilder, DduPipeline, DduEncodeStream, DduDecodeStream, createEncodeStream, createDecodeStream, } from "./utils/index.js";

package/dist/mjs/package.json

@@ -1,3 +0,0 @@
-{
-    "type": "module"
-}

package/dist/mjs/types/DduDefaultTypes.d.ts

@@ -1,3 +0,0 @@
-import { DduConstructorOptions } from "./DduInterface";
-declare const dduDefaultConstructorOptions: DduConstructorOptions;
-export { dduDefaultConstructorOptions };

package/dist/mjs/types/DduDefaultTypes.js

@@ -1,14 +0,0 @@
-import { DduSetSymbol } from "./DduEnums.js";
-const dduDefaultConstructorOptions = {
-    /** 기본 charset: DDU (한글 + 특수문자) */
-    dduSetSymbol: DduSetSymbol.DDU,
-    /** 2의 제곱수 강제 */
-    usePowerOfTwo: true,
-    /** 필요 문자 수: 8개 */
-    requiredLength: 8,
-    /** 비트 길이: 3 (2^3 = 8) */
-    bitLength: 3,
-    /** 빌드 에러 시 throw하지 않음 */
-    useBuildErrorReturn: false,
-};
-export { dduDefaultConstructorOptions };

package/dist/mjs/types/DduEnums.d.ts

@@ -1,6 +0,0 @@
-export declare enum DduSetSymbol {
-    DDU = "ddu",
-    ONECHARSET = "oneCharSet",
-    TWOCHARSET = "twoCharSet",
-    THREECHARSET = "threeCharSet"
-}

package/dist/mjs/types/DduEnums.js

@@ -1,7 +0,0 @@
-export var DduSetSymbol;
-(function (DduSetSymbol) {
-    DduSetSymbol["DDU"] = "ddu";
-    DduSetSymbol["ONECHARSET"] = "oneCharSet";
-    DduSetSymbol["TWOCHARSET"] = "twoCharSet";
-    DduSetSymbol["THREECHARSET"] = "threeCharSet";
-})(DduSetSymbol || (DduSetSymbol = {}));

package/dist/mjs/types/DduInterface.d.ts

@@ -1,91 +0,0 @@
-import { DduSetSymbol } from "./DduEnums";
-export interface CharSetConfig {
-    /** charset 식별 심볼 */
-    symbol: DduSetSymbol;
-    /** 인코딩에 사용할 문자 배열 */
-    charSet: string[];
-    /** 최대 필요 문자 수 */
-    maxRequiredLength: number;
-    /** 비트 길이 (log2) */
-    bitLength: number;
-    /** 패딩 문자 */
-    paddingChar: string;
-}
-/** 진행률 콜백 정보 */
-export interface DduProgressInfo {
-    /** 현재 처리된 바이트 수 (근사값) */
-    processedBytes: number;
-    /** 전체 바이트 수 */
-    totalBytes: number;
-    /** 진행률 (0-100, 단계별 근사값) */
-    percent: number;
-    /** 현재 처리 단계 */
-    stage?: "start" | "encrypt" | "compress" | "encode" | "decode" | "decompress" | "checksum" | "decrypt" | "done";
-}
-/** 인코딩 통계 정보 */
-export interface DduEncodeStats {
-    /** 원본 데이터 크기 (바이트) */
-    originalSize: number;
-    /** 인코딩된 문자열 길이 */
-    encodedSize: number;
-    /** 압축된 크기 (압축 사용시) */
-    compressedSize?: number;
-    /** 압축률 (0-1, 낮을수록 효율적) */
-    compressionRatio?: number;
-    /** 인코딩 확장 비율 */
-    expansionRatio: number;
-    /** 사용된 charset 크기 */
-    charsetSize: number;
-    /** 비트 길이 */
-    bitLength: number;
-}
-export interface DduOptions {
-    /** 압축 사용 여부 (zlib deflate) */
-    compress?: boolean;
-    /** 압축 레벨 (1~9, 기본값: 6). 1=빠름/낮은압축, 9=느림/최대압축 */
-    compressionLevel?: number;
-    /** 최대 디코딩 바이트 수 (Zip Bomb 방어) */
-    maxDecodedBytes?: number;
-    /** 최대 압축해제 바이트 수 (Zip Bomb 방어) */
-    maxDecompressedBytes?: number;
-    /** 체크섬 추가 여부 (CRC32) */
-    checksum?: boolean;
-    /** 청크 분할 크기 */
-    chunkSize?: number;
-    /** 청크 구분자 (기본값: '\n') */
-    chunkSeparator?: string;
-    /** 진행률 콜백 */
-    onProgress?: (info: DduProgressInfo) => void;
-}
-export interface DduConstructorOptions extends DduOptions {
-    /** 미리 정의된 charset 심볼 */
-    dduSetSymbol?: DduSetSymbol;
-    /** 커스텀 charset 문자 배열 또는 문자열 */
-    dduChar?: string[] | string;
-    /** 패딩 문자 */
-    paddingChar?: string;
-    /** 필요 문자 수 */
-    requiredLength?: number;
-    /** 비트 길이 */
-    bitLength?: number;
-    /** 2의 제곱수 강제 여부 */
-    usePowerOfTwo?: boolean;
-    /**
-     * true이면 초기화 오류 시 throw합니다. false이면 fallback charset으로 대체합니다.
-     * @default false
-     * @deprecated throwOnError를 사용하세요. 이 옵션은 하위 호환성을 위해 유지됩니다.
-     */
-    useBuildErrorReturn?: boolean;
-    /**
-     * true이면 초기화 오류 시 throw합니다. false이면 fallback charset으로 대체합니다.
-     * useBuildErrorReturn과 동일한 동작이며, 둘 다 지정 시 throwOnError가 우선합니다.
-     * @default false
-     */
-    throwOnError?: boolean;
-    /** Buffer 인코딩 방식 */
-    encoding?: BufferEncoding;
-    /** URL-Safe 모드 (특수문자를 URL 안전 문자로 변환) */
-    urlSafe?: boolean;
-    /** 암호화 키 (AES-256-GCM) */
-    encryptionKey?: string;
-}

package/dist/mjs/types/DduInterface.js

@@ -1 +0,0 @@
-export {};

package/dist/mjs/types/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./DduEnums";
-export * from "./DduInterface";
-export * from "./DduDefaultTypes";

package/dist/mjs/types/index.js

@@ -1,3 +0,0 @@
-export * from "./DduEnums.js";
-export * from "./DduInterface.js";
-export * from "./DduDefaultTypes.js";

package/dist/mjs/utils/CharsetBuilder.d.ts

@@ -1,129 +0,0 @@
-/**
- * 커스텀 Charset을 쉽게 생성하기 위한 빌더 클래스
- *
- * @example
- * const chars = CharsetBuilder
- *   .fromUnicodeRange(0x4E00, 0x4E3F)
- *   .excludeConfusing()
- *   .shuffle()
- *   .build();
- */
-export declare class CharsetBuilder {
-    private chars;
-    private constructor();
-    /**
-     * 빈 빌더를 생성합니다.
-     */
-    static create(): CharsetBuilder;
-    /**
-     * 유니코드 범위에서 문자들을 추가합니다.
-     *
-     * @param start - 시작 유니코드 코드포인트
-     * @param end - 끝 유니코드 코드포인트 (포함)
-     */
-    static fromUnicodeRange(start: number, end: number): CharsetBuilder;
-    /**
-     * 문자열에서 문자들을 추가합니다.
-     *
-     * @param chars - 문자열 또는 문자 배열
-     */
-    static fromString(chars: string | string[]): CharsetBuilder;
-    /**
-     * Base64 표준 문자셋으로 시작합니다.
-     */
-    static base64(): CharsetBuilder;
-    /**
-     * Base32 표준 문자셋으로 시작합니다.
-     */
-    static base32(): CharsetBuilder;
-    /**
-     * 영문 대문자만 포함합니다.
-     */
-    static uppercase(): CharsetBuilder;
-    /**
-     * 영문 소문자만 포함합니다.
-     */
-    static lowercase(): CharsetBuilder;
-    /**
-     * 숫자만 포함합니다.
-     */
-    static digits(): CharsetBuilder;
-    /**
-     * 한글 자모를 포함합니다.
-     */
-    static hangulJamo(): CharsetBuilder;
-    /**
-     * 유니코드 범위에서 문자들을 추가합니다.
-     */
-    addUnicodeRange(start: number, end: number): CharsetBuilder;
-    /**
-     * 문자열에서 문자들을 추가합니다.
-     */
-    addString(chars: string | string[]): CharsetBuilder;
-    /**
-     * 특정 문자들을 추가합니다.
-     */
-    add(...chars: string[]): CharsetBuilder;
-    /**
-     * 혼동하기 쉬운 문자들을 제거합니다.
-     * (0, O, o, 1, l, I, i 등)
-     */
-    excludeConfusing(): CharsetBuilder;
-    /**
-     * 특정 문자들을 제거합니다.
-     */
-    exclude(...chars: string[]): CharsetBuilder;
-    /**
-     * URL에서 안전하지 않은 문자들을 제거합니다.
-     */
-    excludeUrlUnsafe(): CharsetBuilder;
-    /**
-     * 중복 문자를 제거합니다.
-     */
-    unique(): CharsetBuilder;
-    /**
-     * 문자셋을 무작위로 섞습니다.
-     */
-    shuffle(seed?: number): CharsetBuilder;
-    /**
-     * 시드 기반 난수 생성기 (xorshift32)
-     */
-    private seededRandom;
-    /**
-     * 특정 길이로 자릅니다.
-     */
-    limit(length: number): CharsetBuilder;
-    /**
-     * 2의 제곱수 길이로 자릅니다.
-     */
-    limitToPowerOfTwo(): CharsetBuilder;
-    /**
-     * 문자셋을 정렬합니다.
-     */
-    sort(): CharsetBuilder;
-    /**
-     * 역순으로 정렬합니다.
-     */
-    reverse(): CharsetBuilder;
-    /**
-     * 현재 문자 수를 반환합니다.
-     */
-    get length(): number;
-    /**
-     * 문자셋을 문자열로 빌드합니다.
-     */
-    buildString(): string;
-    /**
-     * 문자셋을 배열로 빌드합니다.
-     */
-    build(): string[];
-    /**
-     * 문자셋과 패딩 문자를 함께 빌드합니다.
-     *
-     * @param paddingChar - 패딩 문자 (기본값: charset에서 제외된 첫 번째 문자)
-     */
-    buildWithPadding(paddingChar?: string): {
-        charset: string[];
-        padding: string;
-    };
-}

package/dist/mjs/utils/CharsetBuilder.js

@@ -1,241 +0,0 @@
-/**
- * 커스텀 Charset을 쉽게 생성하기 위한 빌더 클래스
- *
- * @example
- * const chars = CharsetBuilder
- *   .fromUnicodeRange(0x4E00, 0x4E3F)
- *   .excludeConfusing()
- *   .shuffle()
- *   .build();
- */
-export class CharsetBuilder {
-    chars = [];
-    constructor() { }
-    /**
-     * 빈 빌더를 생성합니다.
-     */
-    static create() {
-        return new CharsetBuilder();
-    }
-    /**
-     * 유니코드 범위에서 문자들을 추가합니다.
-     *
-     * @param start - 시작 유니코드 코드포인트
-     * @param end - 끝 유니코드 코드포인트 (포함)
-     */
-    static fromUnicodeRange(start, end) {
-        const builder = new CharsetBuilder();
-        return builder.addUnicodeRange(start, end);
-    }
-    /**
-     * 문자열에서 문자들을 추가합니다.
-     *
-     * @param chars - 문자열 또는 문자 배열
-     */
-    static fromString(chars) {
-        const builder = new CharsetBuilder();
-        return builder.addString(chars);
-    }
-    /**
-     * Base64 표준 문자셋으로 시작합니다.
-     */
-    static base64() {
-        const builder = new CharsetBuilder();
-        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-        return builder.addString(chars);
-    }
-    /**
-     * Base32 표준 문자셋으로 시작합니다.
-     */
-    static base32() {
-        const builder = new CharsetBuilder();
-        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
-        return builder.addString(chars);
-    }
-    /**
-     * 영문 대문자만 포함합니다.
-     */
-    static uppercase() {
-        return CharsetBuilder.fromUnicodeRange(65, 90); // A-Z
-    }
-    /**
-     * 영문 소문자만 포함합니다.
-     */
-    static lowercase() {
-        return CharsetBuilder.fromUnicodeRange(97, 122); // a-z
-    }
-    /**
-     * 숫자만 포함합니다.
-     */
-    static digits() {
-        return CharsetBuilder.fromUnicodeRange(48, 57); // 0-9
-    }
-    /**
-     * 한글 자모를 포함합니다.
-     */
-    static hangulJamo() {
-        const builder = new CharsetBuilder();
-        // 초성 19자 + 중성 21자 + 종성 27자
-        return builder
-            .addUnicodeRange(0x1100, 0x1112) // 초성
-            .addUnicodeRange(0x1161, 0x1175) // 중성
-            .addUnicodeRange(0x11A8, 0x11C2); // 종성
-    }
-    /**
-     * 유니코드 범위에서 문자들을 추가합니다.
-     */
-    addUnicodeRange(start, end) {
-        for (let i = start; i <= end; i++) {
-            this.chars.push(String.fromCodePoint(i));
-        }
-        return this;
-    }
-    /**
-     * 문자열에서 문자들을 추가합니다.
-     */
-    addString(chars) {
-        if (typeof chars === "string") {
-            this.chars.push(...[...chars]);
-        }
-        else {
-            this.chars.push(...chars);
-        }
-        return this;
-    }
-    /**
-     * 특정 문자들을 추가합니다.
-     */
-    add(...chars) {
-        this.chars.push(...chars);
-        return this;
-    }
-    /**
-     * 혼동하기 쉬운 문자들을 제거합니다.
-     * (0, O, o, 1, l, I, i 등)
-     */
-    excludeConfusing() {
-        const confusing = new Set(["0", "O", "o", "1", "l", "I", "i", "|", "L"]);
-        this.chars = this.chars.filter((c) => !confusing.has(c));
-        return this;
-    }
-    /**
-     * 특정 문자들을 제거합니다.
-     */
-    exclude(...chars) {
-        const excludeSet = new Set(chars);
-        this.chars = this.chars.filter((c) => !excludeSet.has(c));
-        return this;
-    }
-    /**
-     * URL에서 안전하지 않은 문자들을 제거합니다.
-     */
-    excludeUrlUnsafe() {
-        const unsafe = new Set(["+", "/", "=", "?", "&", "#", "%", " "]);
-        this.chars = this.chars.filter((c) => !unsafe.has(c));
-        return this;
-    }
-    /**
-     * 중복 문자를 제거합니다.
-     */
-    unique() {
-        this.chars = [...new Set(this.chars)];
-        return this;
-    }
-    /**
-     * 문자셋을 무작위로 섞습니다.
-     */
-    shuffle(seed) {
-        const random = seed !== undefined ? this.seededRandom(seed) : Math.random;
-        for (let i = this.chars.length - 1; i > 0; i--) {
-            const j = Math.floor(random() * (i + 1));
-            [this.chars[i], this.chars[j]] = [this.chars[j], this.chars[i]];
-        }
-        return this;
-    }
-    /**
-     * 시드 기반 난수 생성기 (xorshift32)
-     */
-    seededRandom(seed) {
-        let s = seed | 0 || 1; // 0 방지
-        return () => {
-            s ^= s << 13;
-            s ^= s >> 17;
-            s ^= s << 5;
-            return ((s >>> 0) / 0x100000000);
-        };
-    }
-    /**
-     * 특정 길이로 자릅니다.
-     */
-    limit(length) {
-        this.chars = this.chars.slice(0, length);
-        return this;
-    }
-    /**
-     * 2의 제곱수 길이로 자릅니다.
-     */
-    limitToPowerOfTwo() {
-        const len = this.chars.length;
-        if (len === 0)
-            return this;
-        const pow2 = 1 << Math.floor(Math.log2(len));
-        this.chars = this.chars.slice(0, pow2);
-        return this;
-    }
-    /**
-     * 문자셋을 정렬합니다.
-     */
-    sort() {
-        this.chars.sort();
-        return this;
-    }
-    /**
-     * 역순으로 정렬합니다.
-     */
-    reverse() {
-        this.chars.reverse();
-        return this;
-    }
-    /**
-     * 현재 문자 수를 반환합니다.
-     */
-    get length() {
-        return this.chars.length;
-    }
-    /**
-     * 문자셋을 문자열로 빌드합니다.
-     */
-    buildString() {
-        return this.chars.join("");
-    }
-    /**
-     * 문자셋을 배열로 빌드합니다.
-     */
-    build() {
-        return [...this.chars];
-    }
-    /**
-     * 문자셋과 패딩 문자를 함께 빌드합니다.
-     *
-     * @param paddingChar - 패딩 문자 (기본값: charset에서 제외된 첫 번째 문자)
-     */
-    buildWithPadding(paddingChar) {
-        const charset = [...this.chars];
-        let padding = paddingChar;
-        if (!padding) {
-            // 패딩 문자로 사용할 수 있는 문자 찾기
-            const commonPaddings = ["=", ".", "_", "-", "~", "!"];
-            for (const p of commonPaddings) {
-                if (!charset.includes(p)) {
-                    padding = p;
-                    break;
-                }
-            }
-            // 적절한 패딩을 찾지 못한 경우
-            if (!padding) {
-                throw new Error("Cannot find suitable padding character");
-            }
-        }
-        return { charset, padding };
-    }
-}

package/dist/mjs/utils/DduPipeline.d.ts

@@ -1,114 +0,0 @@
-import { Ddu64 } from "../encoders/Ddu64";
-import { DduConstructorOptions } from "../types";
-/**
- * 다중 인코딩/암호화/압축을 파이프라인으로 조합할 수 있는 빌더 클래스
- *
- * @example
- * const pipeline = new DduPipeline()
- *   .compress()
- *   .encrypt('secret-key')
- *   .encode(new Ddu64(chars, pad));
- *
- * const encoded = pipeline.process('Hello World');
- * const decoded = pipeline.reverse().process(encoded);
- */
-export declare class DduPipeline {
-    private steps;
-    /**
-     * 압축 단계를 추가합니다.
-     *
-     * @param level - 압축 레벨 (0-9, 기본값: 9)
-     */
-    compress(level?: number): DduPipeline;
-    /**
-     * 압축 해제 단계를 추가합니다.
-     *
-     * @param maxDecompressedBytes - 최대 압축해제 바이트 수 (Zip Bomb 방어용)
-     */
-    decompress(maxDecompressedBytes?: number): DduPipeline;
-    /**
-     * AES-256-GCM 암호화 단계를 추가합니다.
-     *
-     * @param key - 암호화 키
-     */
-    encrypt(key: string): DduPipeline;
-    /**
-     * AES-256-GCM 복호화 단계를 추가합니다.
-     *
-     * @param key - 복호화 키
-     */
-    decrypt(key: string): DduPipeline;
-    /**
-     * Ddu64 인코딩 단계를 추가합니다.
-     *
-     * @param encoder - Ddu64 인코더 인스턴스
-     */
-    encode(encoder: Ddu64): DduPipeline;
-    /**
-     * Ddu64 디코딩 단계를 추가합니다.
-     *
-     * @param encoder - Ddu64 인코더 인스턴스
-     */
-    decode(encoder: Ddu64): DduPipeline;
-    /**
-     * 새 인코더를 생성하여 인코딩 단계를 추가합니다.
-     *
-     * @param dduChar - charset 문자열 또는 배열
-     * @param paddingChar - 패딩 문자
-     * @param options - 인코더 옵션
-     */
-    encodeWith(dduChar?: string[] | string, paddingChar?: string, options?: DduConstructorOptions): DduPipeline;
-    /**
-     * 커스텀 Buffer 변환 단계를 추가합니다.
-     *
-     * @param fn - 변환 함수
-     */
-    transform(fn: (data: Buffer) => Buffer): DduPipeline;
-    /**
-     * 커스텀 문자열 변환 단계를 추가합니다.
-     *
-     * @param fn - 변환 함수
-     */
-    transformString(fn: (data: string) => string): DduPipeline;
-    /**
-     * 파이프라인을 역순으로 실행할 새 파이프라인을 생성합니다.
-     */
-    reverse(): DduPipeline;
-    /**
-     * 파이프라인을 실행합니다.
-     *
-     * @param input - 입력 데이터 (문자열 또는 Buffer)
-     * @returns 처리된 결과 (문자열 또는 Buffer)
-     */
-    process(input: string | Buffer): string | Buffer;
-    /**
-     * 파이프라인을 실행하고 문자열로 반환합니다.
-     */
-    processToString(input: string | Buffer, encoding?: BufferEncoding): string;
-    /**
-     * 파이프라인을 실행하고 Buffer로 반환합니다.
-     */
-    processToBuffer(input: string | Buffer, encoding?: BufferEncoding): Buffer;
-    /**
-     * 개별 단계를 실행합니다.
-     */
-    private executeStep;
-    private toBuffer;
-    private toString;
-    private compressData;
-    private decompressData;
-    private encryptData;
-    private decryptData;
-    /**
-     * 현재 파이프라인의 단계 수를 반환합니다.
-     */
-    get stepCount(): number;
-    /**
-     * 파이프라인을 복제합니다.
-     */
-    clone(): DduPipeline;
-    /**
-     * 파이프라인을 초기화합니다.
-     */
-    clear(): DduPipeline;
-}