@fuzionx/core 0.1.43 → 0.1.45

package/types/index.d.ts

@@ -1,164 +1,164 @@
-// TypeScript 타입 정의 — fuzionx framework
-
-export interface FuzionXOptions {
-    config: string;
-    port?: number;
-}
-
-export interface UploadedFile {
-    fieldName: string;
-    originalName: string;
-    mimeType: string;
-    size: number;
-    tempPath: string;
-}
-
-export interface FuzionXRequest {
-    method: string;
-    url: string;
-    path: string;
-    query: Record<string, string>;
-    params: Record<string, string>;
-    headers: Record<string, string>;
-    ip: string;
-    body: string;
-    json: any;
-    handlerId: number;
-    requestId: number;
-    sessionId: string | null;
-    files: UploadedFile[] | null;
-    session: SessionHelper;
-    t: (key: string, defaultValue?: string) => string;
-}
-
-export interface FuzionXResponse {
-    status(code: number): FuzionXResponse;
-    json(data: any): FuzionXResponse;
-    send(text: string): FuzionXResponse;
-    html(content: string): FuzionXResponse;
-    redirect(url: string, code?: number): FuzionXResponse;
-    header(key: string, value: string): FuzionXResponse;
-}
-
-export type NextFunction = (err?: Error) => void;
-export type RequestHandler = (req: FuzionXRequest, res: FuzionXResponse, next: NextFunction) => void;
-export type ErrorHandler = (err: Error, req: FuzionXRequest, res: FuzionXResponse, next: NextFunction) => void;
-
-export interface SessionHelper {
-    get(key?: string): any;
-    set(key: string, value: string): void;
-    destroy(): void;
-    renew(): string | null;
-}
-
-export interface I18nHelper {
-    translate(locale: string, key: string): string | null;
-    readonly locales: string[];
-    setLocale(locale: string): void;
-    updateMissing(key: string, value: string): void;
-    readonly autoComplete: boolean;
-    render(template: string, context?: Record<string, any>, locale?: string): string;
-}
-
-export interface WsHelper {
-    broadcast(data: any): void;
-    sendTo(sessionId: string, data: any): void;
-    sendToMany(sessionIds: string[], data: any): void;
-    broadcastExcluding(excludeId: string, data: any): void;
-    sendToMatch(key: string, value: string, data: any): void;
-    readonly onlineCount: number;
-    readonly sessionIds: string[];
-    disconnect(sessionId: string): void;
-    setMetadata(sessionId: string, key: string, value: string): void;
-    getMetadata(sessionId: string, key: string): string | null;
-    removeInactive(seconds: number): number;
-}
-
-export interface CryptoHelper {
-    uuid(): string;
-    md5(input: string): string;
-    sha256(input: string): string;
-    encrypt(key: string, plaintext: string): string;
-    decrypt(key: string, ciphertext: string): string;
-    encryptCustom(plaintext: string, key: string): string;
-    decryptCustom(ciphertext: string, key: string): string;
-    getUaSlice(userAgent: string): string;
-    deriveTransportKey(sessionKey: string, uaSlice: string): string;
-}
-
-export interface FileHelper {
-    move(src: string, dst: string): void;
-    copy(src: string, dst: string): number;
-    ensureDir(dirPath: string): void;
-    size(filePath: string): number;
-    exists(filePath: string): boolean;
-    remove(filePath: string): boolean;
-    tempPath(prefix?: string): string;
-    extension(filePath: string): string | null;
-}
-
-export interface HashHelper {
-    bcrypt(password: string, cost?: number): string;
-    bcryptVerify(password: string, hash: string): boolean;
-    argon2(password: string): string;
-    argon2Verify(password: string, hash: string): boolean;
-}
-
-export interface ResizeSpec {
-    width: number;
-    height: number;
-    format?: string;
-    quality?: number;
-    suffix: string;
-}
-
-export interface ImageInfo {
-    width: number;
-    height: number;
-    format: string;
-}
-
-export interface VideoInfo {
-    duration: number;
-    width: number;
-    height: number;
-    codec: string;
-    fps: number;
-}
-
-export interface MediaHelper {
-    resize(input: string, output: string, width: number, height: number, format?: string, quality?: number): string;
-    resizeMultiple(input: string, outputDir: string, baseName: string, specs: ResizeSpec[]): string[];
-    imageInfo(filePath: string): ImageInfo;
-    toWebp(input: string, output: string, quality?: number): string;
-    videoThumbnail(input: string, output: string, atSeconds?: number, width?: number, format?: string): string;
-    videoInfo(filePath: string): VideoInfo;
-}
-
-export declare class FuzionXApp {
-    constructor(options?: FuzionXOptions);
-
-    readonly config: Record<string, any>;
-    readonly appConfig: Record<string, any>;
-    readonly crypto: CryptoHelper;
-    readonly file: FileHelper;
-    readonly hash: HashHelper;
-    readonly media: MediaHelper;
-    readonly ws: WsHelper | null;
-    readonly i18n: I18nHelper | null;
-
-    get(path: string, ...handlers: RequestHandler[]): this;
-    post(path: string, ...handlers: RequestHandler[]): this;
-    put(path: string, ...handlers: RequestHandler[]): this;
-    delete(path: string, ...handlers: RequestHandler[]): this;
-    patch(path: string, ...handlers: RequestHandler[]): this;
-
-    use(handler: RequestHandler | ErrorHandler): this;
-    use(path: string, ...handlers: (RequestHandler | ErrorHandler)[]): this;
-
-    listen(port?: number, callback?: () => void): this;
-    listen(callback: () => void): this;
-}
-
-export declare function createApp(options?: FuzionXOptions): FuzionXApp;
-
+// TypeScript 타입 정의 — fuzionx framework
+
+export interface FuzionXOptions {
+    config: string;
+    port?: number;
+}
+
+export interface UploadedFile {
+    fieldName: string;
+    originalName: string;
+    mimeType: string;
+    size: number;
+    tempPath: string;
+}
+
+export interface FuzionXRequest {
+    method: string;
+    url: string;
+    path: string;
+    query: Record<string, string>;
+    params: Record<string, string>;
+    headers: Record<string, string>;
+    ip: string;
+    body: string;
+    json: any;
+    handlerId: number;
+    requestId: number;
+    sessionId: string | null;
+    files: UploadedFile[] | null;
+    session: SessionHelper;
+    t: (key: string, defaultValue?: string) => string;
+}
+
+export interface FuzionXResponse {
+    status(code: number): FuzionXResponse;
+    json(data: any): FuzionXResponse;
+    send(text: string): FuzionXResponse;
+    html(content: string): FuzionXResponse;
+    redirect(url: string, code?: number): FuzionXResponse;
+    header(key: string, value: string): FuzionXResponse;
+}
+
+export type NextFunction = (err?: Error) => void;
+export type RequestHandler = (req: FuzionXRequest, res: FuzionXResponse, next: NextFunction) => void;
+export type ErrorHandler = (err: Error, req: FuzionXRequest, res: FuzionXResponse, next: NextFunction) => void;
+
+export interface SessionHelper {
+    get(key?: string): any;
+    set(key: string, value: string): void;
+    destroy(): void;
+    renew(): string | null;
+}
+
+export interface I18nHelper {
+    translate(locale: string, key: string): string | null;
+    readonly locales: string[];
+    setLocale(locale: string): void;
+    updateMissing(key: string, value: string): void;
+    readonly autoComplete: boolean;
+    render(template: string, context?: Record<string, any>, locale?: string): string;
+}
+
+export interface WsHelper {
+    broadcast(data: any): void;
+    sendTo(sessionId: string, data: any): void;
+    sendToMany(sessionIds: string[], data: any): void;
+    broadcastExcluding(excludeId: string, data: any): void;
+    sendToMatch(key: string, value: string, data: any): void;
+    readonly onlineCount: number;
+    readonly sessionIds: string[];
+    disconnect(sessionId: string): void;
+    setMetadata(sessionId: string, key: string, value: string): void;
+    getMetadata(sessionId: string, key: string): string | null;
+    removeInactive(seconds: number): number;
+}
+
+export interface CryptoHelper {
+    uuid(): string;
+    md5(input: string): string;
+    sha256(input: string): string;
+    encrypt(key: string, plaintext: string): string;
+    decrypt(key: string, ciphertext: string): string;
+    encryptCustom(plaintext: string, key: string): string;
+    decryptCustom(ciphertext: string, key: string): string;
+    getUaSlice(userAgent: string): string;
+    deriveTransportKey(sessionKey: string, uaSlice: string): string;
+}
+
+export interface FileHelper {
+    move(src: string, dst: string): void;
+    copy(src: string, dst: string): number;
+    ensureDir(dirPath: string): void;
+    size(filePath: string): number;
+    exists(filePath: string): boolean;
+    remove(filePath: string): boolean;
+    tempPath(prefix?: string): string;
+    extension(filePath: string): string | null;
+}
+
+export interface HashHelper {
+    bcrypt(password: string, cost?: number): string;
+    bcryptVerify(password: string, hash: string): boolean;
+    argon2(password: string): string;
+    argon2Verify(password: string, hash: string): boolean;
+}
+
+export interface ResizeSpec {
+    width: number;
+    height: number;
+    format?: string;
+    quality?: number;
+    suffix: string;
+}
+
+export interface ImageInfo {
+    width: number;
+    height: number;
+    format: string;
+}
+
+export interface VideoInfo {
+    duration: number;
+    width: number;
+    height: number;
+    codec: string;
+    fps: number;
+}
+
+export interface MediaHelper {
+    resize(input: string, output: string, width: number, height: number, format?: string, quality?: number): string;
+    resizeMultiple(input: string, outputDir: string, baseName: string, specs: ResizeSpec[]): string[];
+    imageInfo(filePath: string): ImageInfo;
+    toWebp(input: string, output: string, quality?: number): string;
+    videoThumbnail(input: string, output: string, atSeconds?: number, width?: number, format?: string): string;
+    videoInfo(filePath: string): VideoInfo;
+}
+
+export declare class FuzionXApp {
+    constructor(options?: FuzionXOptions);
+
+    readonly config: Record<string, any>;
+    readonly appConfig: Record<string, any>;
+    readonly crypto: CryptoHelper;
+    readonly file: FileHelper;
+    readonly hash: HashHelper;
+    readonly media: MediaHelper;
+    readonly ws: WsHelper | null;
+    readonly i18n: I18nHelper | null;
+
+    get(path: string, ...handlers: RequestHandler[]): this;
+    post(path: string, ...handlers: RequestHandler[]): this;
+    put(path: string, ...handlers: RequestHandler[]): this;
+    delete(path: string, ...handlers: RequestHandler[]): this;
+    patch(path: string, ...handlers: RequestHandler[]): this;
+
+    use(handler: RequestHandler | ErrorHandler): this;
+    use(path: string, ...handlers: (RequestHandler | ErrorHandler)[]): this;
+
+    listen(port?: number, callback?: () => void): this;
+    listen(callback: () => void): this;
+}
+
+export declare function createApp(options?: FuzionXOptions): FuzionXApp;
+