@alloy-framework/core 0.3.0 → 0.14.0

package/src/index.d.ts

@@ -1,345 +0,0 @@
-// Type definitions for @alloy/core
-// Provides IDE autocompletion and type checking for the Alloy Framework SDK
-
-import Joi from 'joi';
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// App
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export interface AlloyPlugin {
-    name: string;
-    onRequest?(req: any, res: any): void | Promise<void>;
-}
-
-export class AlloyApp {
-    readonly native: any;
-    readonly appDir: string;
-    readonly router: AlloyRouter;
-    readonly wsClients: Map<string, AlloyWebSocket>;
-
-    constructor(meta: ImportMeta);
-
-    /** 플러그인 등록 */
-    use(plugin: AlloyPlugin): this;
-
-    /** 등록된 플러그인 조회 */
-    getPlugin(name: string): AlloyPlugin | undefined;
-
-    /** WebSocket 이벤트 핸들러 등록 */
-    ws(handlers: {
-        onConnect?(socket: AlloyWebSocket): void | Promise<void>;
-        onMessage?(socket: AlloyWebSocket, message: string): void | Promise<void>;
-        onDisconnect?(socket: AlloyWebSocket): void | Promise<void>;
-    }): void;
-
-    /** 앱 부트스트래핑 (오버라이드용) */
-    boot(): Promise<void>;
-
-    /** 미들웨어 등록 훅 (오버라이드용) */
-    middleware?(router: AlloyRouter): void;
-
-    /** 앱 시작 (오버라이드용) */
-    start(): Promise<void>;
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Config
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export class AlloyConfig {
-    /** 설정 전체 로드 */
-    static load(): Record<string, any>;
-
-    /** 캐시 무효화 후 재로드 */
-    static reload(): Record<string, any>;
-
-    /** dot-notation 키로 설정값 조회 */
-    static get<T = any>(key: string, defaultValue?: T): T;
-
-    /** 데이터베이스 설정 조회 */
-    static getDatabase(name: string): {
-        name: string;
-        driver: string;
-        url: string;
-        max_pool_size?: number;
-    } | undefined;
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// HTTP
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
-
-export class AlloyController {
-    readonly req: any;
-
-    /** 요청 URL */
-    get url(): string;
-    /** HTTP 메서드 */
-    get method(): string;
-    /** 클라이언트 IP */
-    get ip(): string;
-    /** URL 파라미터 */
-    get params(): Record<string, string>;
-    /** 쿼리 파라미터 */
-    get query(): Record<string, string>;
-    /** 요청 헤더 */
-    get headers(): Record<string, string>;
-    /** 파싱된 요청 바디 */
-    get body(): any;
-
-    /** 세션 데이터 설정 */
-    setSession(key: string, value: string): void;
-    /** 세션 데이터 조회 */
-    getSession(key: string): string | null;
-
-    /** 응답 상태 코드 설정 */
-    status(code: number): this;
-    /** 응답 헤더 설정 */
-    setHeader(name: string, value: string): this;
-    /** 특정 헤더 조회 */
-    header(name: string): string | undefined;
-
-    /** JSON 응답 */
-    json(data: any): void;
-    /** HTML 응답 */
-    html(content: string): void;
-    /** Tera 템플릿 렌더링 */
-    render(template: string, context?: Record<string, any>): void;
-    /** 리다이렉트 */
-    redirect(url: string, statusCode?: number): void;
-
-    /** 표준 성공 응답 */
-    success(data?: any, message?: string): void;
-    /** 표준 에러 응답 */
-    error(code: string, message?: string, statusCode?: number): void;
-}
-
-/** Controller 클래스를 라우트 디스크립터로 변환 */
-export function createController(ControllerClass: typeof AlloyController): any;
-
-export class AlloyRouter {
-    /** GET 라우트 등록 */
-    get(path: string, ...args: any[]): void;
-    /** POST 라우트 등록 */
-    post(path: string, ...args: any[]): void;
-    /** PUT 라우트 등록 */
-    put(path: string, ...args: any[]): void;
-    /** DELETE 라우트 등록 */
-    delete(path: string, ...args: any[]): void;
-    /** 미들웨어 등록 */
-    use(...middleware: Function[]): void;
-    /** 라우트 그룹 */
-    group(prefix: string, callback: (router: AlloyRouter) => void): void;
-}
-
-export class Validator {
-    static validate<T = any>(schema: Joi.Schema, data: any, partial?: boolean): T;
-}
-
-export { Joi };
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Data
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export class AlloyModel {
-    /** 스키마 정의 (서브클래스에서 오버라이드) */
-    static schema?: any;
-    /** 스토어 이름 */
-    static store?: string;
-    /** 테이블/컬렉션 이름 */
-    static table?: string;
-
-    /** SELECT 필드 지정 */
-    select(...fields: string[]): this;
-    /** WHERE 조건 */
-    where(field: string, op: string, value: any): this;
-    /** OR WHERE 조건 */
-    orWhere(field: string, op: string, value: any): this;
-    /** WHERE IN 조건 */
-    whereIn(field: string, values: any[]): this;
-    /** WHERE NULL 조건 */
-    whereNull(field: string): this;
-    /** WHERE NOT NULL 조건 */
-    whereNotNull(field: string): this;
-    /** 결과 행 수 제한 */
-    limit(n: number): this;
-    /** 시작 오프셋 */
-    offset(n: number): this;
-    /** 정렬 */
-    orderBy(field: string, direction?: 'asc' | 'desc'): this;
-    /** GROUP BY */
-    groupBy(field: string): this;
-
-    /** 조건에 맞는 행 조회 */
-    get(): Promise<any[]>;
-    /** 첫 번째 행 조회 */
-    first(): Promise<any | null>;
-    /** 데이터 삽입 */
-    save(data: Record<string, any>): Promise<any>;
-    /** 데이터 수정 */
-    update(data: Record<string, any>): Promise<any>;
-    /** 데이터 삭제 */
-    delete(): Promise<any>;
-
-    /** 행 수 카운트 */
-    count(): Promise<number>;
-    /** SUM 집계 */
-    sum(field: string): Promise<number>;
-    /** AVG 집계 */
-    avg(field: string): Promise<number>;
-    /** MIN 집계 */
-    min(field: string): Promise<number>;
-    /** MAX 집계 */
-    max(field: string): Promise<number>;
-
-    /** Raw SQL 실행 */
-    query(sql: string, params?: any[]): Promise<any[]>;
-    /** 스토어드 프로시저 호출 */
-    callProcedure(name: string, params?: any[]): Promise<any[]>;
-}
-
-/** AlloyModel 별칭 */
-export const AlloyMariaModel: typeof AlloyModel;
-
-export class AlloyMongoModel extends AlloyModel {
-    /** MongoDB find */
-    find(filter?: object, options?: { projection?: object; sort?: object; limit?: number; skip?: number }): Promise<any[]>;
-    /** MongoDB findOne */
-    findOne(filter?: object, options?: { projection?: object }): Promise<any | null>;
-    /** 단일 문서 삽입 */
-    insertOne(doc: Record<string, any>): Promise<{ ok: boolean; n: number }>;
-    /** 다중 문서 삽입 */
-    insertMany(docs: Record<string, any>[], options?: { ordered?: boolean }): Promise<{ ok: boolean; n: number }>;
-    /** 단일 문서 수정 */
-    updateOne(filter: object, update: object, options?: { upsert?: boolean; arrayFilters?: any[]; hint?: object; collation?: object }): Promise<{ ok: boolean; nModified: number; upserted?: any }>;
-    /** 다중 문서 수정 */
-    updateMany(filter: object, update: object, options?: { upsert?: boolean; arrayFilters?: any[] }): Promise<{ ok: boolean; nModified: number }>;
-    /** 단일 문서 삭제 */
-    deleteOne(filter: object): Promise<{ ok: boolean; n: number }>;
-    /** 다중 문서 삭제 */
-    deleteMany(filter: object): Promise<{ ok: boolean; n: number }>;
-    /** Aggregation Pipeline */
-    aggregate(pipeline: object[]): Promise<any[]>;
-}
-
-export class AlloyRedisModel {
-    /** String SET */
-    set(key: string, value: string, ttl?: number): Promise<void>;
-    /** String GET */
-    get(key: string): Promise<string | null>;
-    /** DEL */
-    del(key: string): Promise<void>;
-    /** EXISTS */
-    exists(key: string): Promise<boolean>;
-
-    /** Hash SET */
-    hset(key: string, field: string, value: string): Promise<void>;
-    /** Hash GET */
-    hget(key: string, field: string): Promise<string | null>;
-    /** Hash DEL */
-    hdel(key: string, field: string): Promise<void>;
-    /** Hash GETALL */
-    hgetall(key: string): Promise<Record<string, string>>;
-
-    /** List LPUSH */
-    lpush(key: string, value: string): Promise<void>;
-    /** List RPUSH */
-    rpush(key: string, value: string): Promise<void>;
-    /** List LRANGE */
-    lrange(key: string, start: number, stop: number): Promise<string[]>;
-
-    /** Raw Redis command */
-    command(cmd: string, args?: string[]): Promise<any>;
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Service
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export class AlloyService {
-    /** 에코 테스트 */
-    echo(msg: string): string;
-    /** CPU 집약적 작업 실행 */
-    runTask(name: string, difficulty: number): Promise<string>;
-    /** 병렬 실행 */
-    runParallel<T>(items: T[], fn?: (item: T, index: number) => Promise<any>, options?: { settled?: boolean }): Promise<any[]>;
-
-    /** 캐시 저장 */
-    setCache(key: string, value: string, ttlSeconds: number): Promise<void>;
-    /** 캐시 조회 */
-    getCache(key: string): Promise<string | null>;
-    /** 캐시 래퍼 (miss 시 fetcher 호출) */
-    withCache<T>(key: string, ttlSeconds: number, fetcher: () => Promise<T>): Promise<T>;
-
-    /** 네트워크 분산 락 획득 */
-    acquireNetworkLock(resource: string, ttlMs?: number): Promise<boolean>;
-    /** 네트워크 분산 락 해제 */
-    releaseNetworkLock(resource: string): Promise<void>;
-    /** 로컬 프로세스 락 획득 */
-    acquireLocalLock(resource: string, ttlMs?: number): boolean;
-    /** 로컬 프로세스 락 해제 */
-    releaseLocalLock(resource: string): void;
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Security
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export class AlloyCrypto {
-    uuid(): string;
-    md5(input: string): string;
-    sha256(input: string): string;
-    encryptAes(key: string, plainText: string): string;
-    decryptAes(key: string, encryptedBase64: string): string;
-    encryptCustom(key: string, plainText: string): string;
-    decryptCustom(key: string, encryptedBase64: string): string;
-}
-
-export class AlloySession {
-    static plugin(options?: { cookieName?: string; ttl?: number }): AlloyPlugin;
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// WebSocket
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export class AlloyWebSocket {
-    readonly id: string;
-    readonly connectionType: string;
-    readonly clientIp: string;
-    readonly connectedAt: string;
-    readonly server: string | null;
-    readonly cookies: Record<string, string>;
-
-    send(msg: string | object): void;
-    broadcast(msg: string | object): void;
-    sendTo(targetId: string, msg: string | object): void;
-    sendToMany(ids: string[], msg: string | object): void;
-    getOnlineClients(): string[];
-    getOnlineClientsDetail(): Array<{ id: string; connectionType: string }>;
-    getOnlineCount(): number;
-    disconnectClient(targetId: string): boolean;
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Util
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-export class AlloyError extends Error {
-    readonly code: string;
-    readonly statusCode: number;
-    constructor(code: string, message?: string, statusCode?: number);
-}
-
-export function paginate(page?: number, size?: number): { offset: number; limit: number };
-export function buildResponse(items: any[], total: number, page: number, size: number): {
-    items: any[];
-    total: number;
-    page: number;
-    size: number;
-    totalPages: number;
-};

package/src/index.js

@@ -1,43 +0,0 @@
-/**
- * 🚀 @alloy/core — Alloy Framework SDK
- *
- * Rust N-API 네이티브 엔진(@alloy/rust) 위에 구축된 고성능 Node.js 프레임워크 SDK입니다.
- *
- * @example
- * import { AlloyApp, AlloyModel, AlloyService, AlloyCrypto } from '@alloy-framework/core';
- */
-
-// ── Config (설정값 접근) ──
-export { AlloyConfig } from './config/AlloyConfig.js';
-
-// ── App (부트스트래퍼) ──
-export { AlloyApp } from './app/AlloyApp.js';
-
-// ── HTTP (컨트롤러/라우터/검증) ──
-export { AlloyController, createController } from './http/AlloyController.js';
-export { AlloyRouter } from './http/AlloyRouter.js';
-export { Validator, Joi } from './http/Validator.js';
-
-// ── Data (모델) ──
-export { AlloyModel, AlloyMariaModel } from './data/AlloyModel.js';
-export { AlloyMongoModel } from './data/AlloyMongoModel.js';
-export { AlloyRedisModel } from './data/AlloyRedisModel.js';
-
-// ── WebSocket ──
-export { AlloyWebSocket } from './ws/AlloyWebSocket.js';
-
-// ── Service ──
-export { AlloyService } from './service/AlloyService.js';
-
-// ── Security ──
-export { AlloyCrypto } from './security/AlloyCrypto.js';
-export { AlloySession } from './security/AlloySession.js';
-
-// ── Util ──
-export { AlloyError } from './util/AlloyError.js';
-export { paginate, buildResponse } from './util/Pagination.js';
-
-// ── Native re-export (직접 접근 필요 시) ──
-import native from '@alloy-framework/rust';
-export const { NativeCache, NativeLock } = native;
-export default native;

package/src/security/AlloyCrypto.js

@@ -1,96 +0,0 @@
-import native from '@alloy-framework/rust';
-
-/**
- * 🔐 Alloy 암호화 래퍼
- * Rust N-API의 NativeCrypto를 직관적인 JS API로 제공합니다.
- *
- * @example
- * const crypto = new AlloyCrypto();
- * const uuid = crypto.uuid();
- * const hash = crypto.sha256('hello');
- * const encrypted = crypto.encryptAes('secret-key', 'plain text');
- */
-export class AlloyCrypto {
-    constructor() {
-        /** @type {import('@alloy/rust').NativeCrypto} 네이티브 암호화 인스턴스 */
-        this._native = new native.NativeCrypto();
-    }
-
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    // 🆔 UUID
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-    /**
-     * UUID v4 생성
-     * @returns {string} UUID 문자열
-     */
-    uuid() {
-        return this._native.uuid();
-    }
-
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    // 🔍 해싱
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-    /**
-     * MD5 해시 (hex 출력)
-     * @param {string} input - 입력 문자열
-     * @returns {string} hex 해시
-     */
-    md5(input) {
-        return this._native.md5(input);
-    }
-
-    /**
-     * SHA-256 해시 (hex 출력)
-     * @param {string} input - 입력 문자열
-     * @returns {string} hex 해시
-     */
-    sha256(input) {
-        return this._native.sha256(input);
-    }
-
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    // 🔒 AES-256-GCM 암호화
-    // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-    /**
-     * AES-256-GCM 암호화 (표준)
-     * @param {string} key - 암호화 키 (SHA256으로 32바이트 변환)
-     * @param {string} plainText - 평문
-     * @returns {string} Base64 인코딩된 암호문
-     */
-    encryptAes(key, plainText) {
-        return this._native.encryptAes(key, plainText);
-    }
-
-    /**
-     * AES-256-GCM 복호화 (표준)
-     * @param {string} key - 복호화 키
-     * @param {string} encryptedBase64 - Base64 암호문
-     * @returns {string} 평문
-     */
-    decryptAes(key, encryptedBase64) {
-        return this._native.decryptAes(key, encryptedBase64);
-    }
-
-    /**
-     * AES-256-GCM + 비트 셔플링 암호화 (커스텀 난독화)
-     * @param {string} key - 암호화 키
-     * @param {string} plainText - 평문
-     * @returns {string} 난독화된 Base64 암호문
-     */
-    encryptCustom(key, plainText) {
-        return this._native.encryptCustom(key, plainText);
-    }
-
-    /**
-     * AES-256-GCM + 비트 셔플링 복호화 (커스텀 난독화)
-     * @param {string} key - 복호화 키
-     * @param {string} encryptedBase64 - 난독화된 Base64 암호문
-     * @returns {string} 평문
-     */
-    decryptCustom(key, encryptedBase64) {
-        return this._native.decryptCustom(key, encryptedBase64);
-    }
-}

package/src/security/AlloySession.js

@@ -1,81 +0,0 @@
-import native from '@alloy-framework/rust';
-
-/**
- * 🔒 Alloy 세션 미들웨어
- * Rust N-API의 sessionRead/sessionWrite를 활용한 Redis 세션 관리입니다.
- *
- * 요청마다 쿠키에서 세션 ID를 추출하고, Redis에서 세션 데이터를 복원합니다.
- * 응답 시 변경된 세션을 Redis에 자동 저장합니다.
- *
- * @example
- * // AlloyApp 플러그인으로 등록
- * app.use(AlloySession.plugin({ cookieName: 'alloy_sid', ttl: 3600 }));
- */
-export class AlloySession {
-    /**
-     * 세션 플러그인 생성 (AlloyApp.use() 호환)
-     * @param {object} [options] - 세션 옵션
-     * @param {string} [options.cookieName='alloy_sid'] - 쿠키 이름
-     * @param {number} [options.ttl=3600] - TTL (초)
-     * @returns {object} 플러그인 객체 { name, onRequest }
-     */
-    static plugin(options = {}) {
-        const cookieName = options.cookieName || 'alloy_sid';
-        const ttl = options.ttl || 3600;
-
-        return {
-            name: 'session',
-
-            /**
-             * 요청 전처리 — 세션 복원
-             * @param {object} req - 요청 객체
-             * @param {object} res - 응답 객체
-             */
-            async onRequest(req, res) {
-                // 쿠키에서 세션 ID 추출
-                const cookies = AlloySession._parseCookies(req.headers?.cookie || '');
-                const sessionId = cookies[cookieName];
-
-                /** @type {object} 세션 데이터 */
-                req.session = {};
-                /** @type {string|null} 세션 ID */
-                req.sessionId = sessionId || null;
-
-                if (sessionId) {
-                    try {
-                        // Rust N-API를 통해 Redis에서 세션 읽기
-                        const json = await native.sessionRead(sessionId);
-                        if (json) {
-                            req.session = JSON.parse(json);
-                        }
-                    } catch (e) {
-                        console.warn('⚠️ [AlloySession] 세션 읽기 실패:', e.message);
-                    }
-                }
-            },
-
-            // 💡 세션 Write-Back은 Rust handler.rs에서 자동 처리됩니다.
-            // AlloyController.send()가 completer.done({ session }) 으로 변경된 세션을
-            // Rust에 전달하면, Rust가 Redis에 자동 저장합니다.
-            // JS 측에서 별도의 onResponse 훅이 필요하지 않습니다.
-        };
-    }
-
-    /**
-     * 쿠키 문자열 파싱
-     * @param {string} cookieStr - raw Cookie 헤더 문자열
-     * @returns {object} 키-값 쌍
-     * @private
-     */
-    static _parseCookies(cookieStr) {
-        const cookies = {};
-        for (const pair of cookieStr.split(';')) {
-            const trimmed = pair.trim();
-            const [key, ...rest] = trimmed.split('=');
-            if (key) {
-                cookies[key.trim()] = rest.join('=').trim(); // 값에 = 포함될 수 있음
-            }
-        }
-        return cookies;
-    }
-}

package/src/security/index.js

@@ -1,5 +0,0 @@
-/**
- * 🔐 보안 모듈 통합 export
- */
-export { AlloyCrypto } from './AlloyCrypto.js';
-export { AlloySession } from './AlloySession.js';