@hamjimin/xplat-back 0.1.0 → 0.2.0

package/README.md

@@ -23,7 +23,6 @@ yarn add xplat-back
 ## 빠른 시작
 
 ### CLI를 통한 프로젝트 초기화
-
 ```bash
 npx xplat-back [project-name]
 ```

package/dist/cli/init.js

@@ -73,6 +73,8 @@ async function initializeProject(config = {}) {
     await createEnvFile(projectRoot, port, corsOrigins);
     // 예시 라우트 파일 생성
     await createExampleRouteFile(restapiDir);
+    // 상수 파일 생성 (src/const 디렉토리)
+    await createConstantsFiles(srcDir);
     console.log('\n✅ 프로젝트 초기화가 완료되었습니다!');
     console.log(`\n생성된 파일:`);
     console.log(`  - src/app.ts`);
@@ -81,6 +83,8 @@ async function initializeProject(config = {}) {
     console.log(`  - package.json (없던 경우만)`);
     console.log(`  - .env`);
     console.log(`  - ${routerDirectory}/health.ts`);
+    console.log(`  - src/const/api_code.ts`);
+    console.log(`  - src/const/constants.ts`);
     console.log(`\n다음 단계:`);
     console.log(`  1. npm install (또는 yarn install)`);
     console.log(`  2. npm run dev (또는 yarn dev)로 서버 실행`);
@@ -262,3 +266,35 @@ async function createExampleRouteFile(restapiDir) {
     fs.writeFileSync(healthPath, templateContent, 'utf-8');
     console.log(`✅ health.ts 파일이 생성되었습니다.`);
 }
+/**
+ * 상수 파일 생성 (api_code.ts, constants.ts)
+ */
+async function createConstantsFiles(srcDir) {
+    const constDir = path.join(srcDir, 'const');
+    // const 디렉토리 생성
+    if (!fs.existsSync(constDir)) {
+        fs.mkdirSync(constDir, { recursive: true });
+    }
+    // api_code.ts 파일 생성
+    const apiCodePath = path.join(constDir, 'api_code.ts');
+    if (!fs.existsSync(apiCodePath)) {
+        const templatePath = path.join(__dirname, 'templates', 'api_code.ts.example');
+        const templateContent = fs.readFileSync(templatePath, 'utf-8');
+        fs.writeFileSync(apiCodePath, templateContent, 'utf-8');
+        console.log(`✅ src/const/api_code.ts 파일이 생성되었습니다.`);
+    }
+    else {
+        console.log(`⚠️  src/const/api_code.ts 파일이 이미 존재합니다. 건너뜁니다.`);
+    }
+    // constants.ts 파일 생성
+    const constantsPath = path.join(constDir, 'constants.ts');
+    if (!fs.existsSync(constantsPath)) {
+        const templatePath = path.join(__dirname, 'templates', 'constants.ts.example');
+        const templateContent = fs.readFileSync(templatePath, 'utf-8');
+        fs.writeFileSync(constantsPath, templateContent, 'utf-8');
+        console.log(`✅ src/const/constants.ts 파일이 생성되었습니다.`);
+    }
+    else {
+        console.log(`⚠️  src/const/constants.ts 파일이 이미 존재합니다. 건너뜁니다.`);
+    }
+}

package/dist/cli/templates/api_code.ts.example

@@ -0,0 +1,70 @@
+/**
+ * API 응답 코드 정의
+ * 
+ * 프로젝트에서 사용할 API 응답 코드를 정의합니다.
+ * xplat-back의 기본 코드를 포함하며, 프로젝트에 맞게 확장 가능합니다.
+ */
+
+export interface ApiCode {
+  code: number;
+  msg: string;
+  message?: string;
+}
+
+export const API_CODE: Record<number, ApiCode> = {
+  // 성공
+  200: { code: 200, msg: "성공" },
+  
+  // Not Found
+  404: { code: 404, msg: "요청 사항을 찾을 수 없습니다" },
+  
+  // 권한 (1000~1999)
+  1000: { code: 1000, msg: "권한이 없습니다" },
+  
+  // 사용자 (2000~2999)
+  2000: { code: 2000, msg: "아이디 또는 비밀번호를 확인해주세요" },
+  2001: { code: 2001, msg: "중복된 아이디 입니다" },
+  2002: { code: 2002, msg: "유효한 EMAIL이 아닙니다" },
+  2003: { code: 2003, msg: "유효한 회원이 아닙니다" },
+  2004: { code: 2004, msg: "비밀번호를 재설정 해주세요" },
+  2005: { code: 2005, msg: "비밀번호가 초기화 되었습니다 EMAIL 확인해주세요" },
+  2006: { code: 2006, msg: "탈퇴한 회원입니다" },
+  2007: { code: 2007, msg: "유효한 이메일이 아닙니다" },
+  2008: { code: 2008, msg: "유효한 비밀번호가 아닙니다" },
+  2009: { code: 2009, msg: "유효한 휴대폰 번호가 아닙니다" },
+  2010: { code: 2010, msg: "카카오 로그인 오류" },
+  2011: { code: 2011, msg: "비밀번호가 틀렸습니다" },
+  2012: { code: 2012, msg: "회원가입 시 문제가 발생했습니다. 관리자에게 문의 해주세요" },
+  2013: { code: 2013, msg: "사용되지 않는 회원(고객)입니다. - 전화번호 중복 -" },
+  
+  // 관리자 (3000 ~ 3999)
+  3000: { code: 3000, msg: "기존 회원입니다." },
+  3001: { code: 3001, msg: "비 회원입니다." },
+  3002: { code: 3002, msg: "중복된데이터 입니다." },
+  3003: { code: 3003, msg: "등록된 상품이 아닙니다." },
+  
+  // 결제 실패 (4000~4999)
+  4000: { code: 4000, msg: "결제 실패" },
+  
+  // 공용사항 (9000~9999)
+  9000: { code: 9000, msg: "오류가 발생했습니다. 관리자에게 문의 해주세요" },
+  9001: { code: 9001, msg: "유효하지 않은 데이터입니다." },
+  9002: { code: 9002, msg: "유효하지 않은 컬럼입니다." },
+  9003: { code: 9003, msg: "잘못된 요청입니다." },
+  
+  // 프로젝트별 추가 코드는 아래에 추가하세요
+  // 예:
+  // 5000: { code: 5000, msg: "프로젝트별 에러 메시지" },
+};
+
+/**
+ * API 코드 가져오기
+ */
+export function getApiCode(code: number): ApiCode {
+  return API_CODE[code] || API_CODE[9000];
+}
+
+/**
+ * API 코드 타입
+ */
+export type ApiCodeType = keyof typeof API_CODE;

package/dist/cli/templates/constants.ts.example

@@ -0,0 +1,113 @@
+/**
+ * 프로젝트 공통 상수 및 설정
+ * 
+ * 이 파일은 프로젝트에 필요한 공통 변수들을 정의하는 곳입니다.
+ * 프로젝트에 맞게 수정하여 사용하세요.
+ */
+
+// 기본 불리언 문자열 상수
+export const strTrue = "T";
+export const strFalse = "F";
+
+// 날짜 상수
+export const toDay = new Date();
+export const yesterDay = new Date(toDay.getTime() - 24 * 60 * 60 * 1000);
+export const tomorrow = new Date(toDay.getTime() + 24 * 60 * 60 * 1000);
+
+// S3 설정
+export const bucketName = process.env.S3_BUCKET || "your-bucket-name";
+export const region = process.env.AWS_REGION || "ap-northeast-2"; // 서울 리전
+
+// 예외 메시지
+export const exceptionMessage = {
+  requiredData: "선행 데이터가 입력(선택)되지 않았습니다.",
+  notFoundData: "조회된 데이터가 없습니다. - 잘못된 정보 -",
+  failedInsert: "데이터 저장에 실패했습니다.",
+  invalidType: "유효하지 않은 타입입니다.",
+  duplicateData: "중복된 데이터입니다.",
+  alreadyExists: "이미 존재하는 데이터입니다.",
+  haveAPayment: "결제중인 결제건이 있습니다.",
+  paymentAmount: "결제 금액이 0원 이하입니다.",
+  paymentAmountOver: "결제 금액이 총 결제 금액보다 높습니다.",
+  retryData: "데이터 저장에 실패했습니다. 다시 시도해주세요.",
+};
+
+// 시스템 메시지
+export const systemMessage = {
+  updateData: "데이터 수정과 같이 진행되었습니다.",
+};
+
+// 빈 문자열
+export const emptyString = "";
+
+// 메시지 타입
+export const messageType = {
+  SMS: "단문",
+  LMS: "장문",
+  MMS: "사진문자",
+  CTA: "카카오 친구톡",
+  ATA: "카카오 알림톡",
+  CTI: "친구 이미지 톡",
+} as const;
+
+// 사용자 역할
+export const memberRole = {
+  none: "none", // 비회원
+  customer: "customer", // 회원
+  employee: "employee", // 직원
+  admin: "admin", // 관리자
+  manager: "manager", // 지점장
+};
+
+// 기본 정렬
+export const DEFAULT_ORDER = "ORDER BY (SELECT NULL)";
+
+// 상태 값 (프로젝트에 맞게 수정)
+export const status: Record<string, string> = {
+  Pending: "pending", // 대기
+  Confirm: "confirm", // 확정
+  serviceComplete: "serviceComplete", // 서비스 완료
+  duplication: "duplication", // 중복
+  cancleRetry: "cancleRetry", // 취소 후 결제 재시도
+  nonProcess: "nonProcess", // 미진행
+  reservation: "reservation", // 예약
+  delteStatus: "delete", // 삭제
+  updateStatus: "update", // 수정
+  inProcess: "inProcess", // 진행 중
+  callConsult: "callConsult", // 상담 완료
+  Emergency: "emergency", // 긴급
+  Discussion: "discussion", // 협의
+  Completed: "complete", // 완료
+  Cancelled: "cancel", // 취소
+  temporarySave: "temporarySave", // 임시저장
+  issued: "issued", // 발행
+  used: "used", // 사용
+  expired: "expired", // 만료
+  paymenting: "paymenting", // 결제 중
+  paymentComplete: "paymentComplete", // 결제 완료
+  paymentPending: "paymentPending", // 결제 대기
+  refund: "refund", // 환불
+};
+
+// 결제 방법
+export const paymebtMethod = {
+  Card: "card",
+  Bank: "bank",
+  Cash: "cash",
+  ETC: "etc",
+};
+
+// 메시지 타입 (상세)
+export const messageTypes = {
+  alarm: "alarm",
+  ba: "BA",
+  ex: "EX",
+  lms: "LMS",
+  sms: "SMS",
+  mms: "MMS",
+  cta: "CTA",
+  cti: "CTI",
+  ati: "ATI",
+  ata: "ATA",
+  friend: "friend",
+};

package/dist/core/XplatSystem.d.ts

@@ -0,0 +1,40 @@
+import { AppModule } from '../modules/app';
+import { RouterModule } from '../modules/router';
+import { AuthModule } from '../modules/auth';
+import { UtilsModule } from '../modules/utils';
+import { MiddlewareModule } from '../modules/middleware';
+import { ConstantsModule } from '../modules/constants';
+import { StorageModule } from '../modules/storage';
+import { ORMModule } from '../modules/orm';
+/**
+ * XplatSystem - Singleton 패턴 기반 Framework 인스턴스
+ *
+ * 모든 framework 기능을 하나의 인스턴스를 통해 접근할 수 있도록 합니다.
+ */
+export declare class XplatSystem {
+    private static instance;
+    readonly app: AppModule;
+    readonly router: RouterModule;
+    readonly auth: AuthModule;
+    readonly utils: UtilsModule;
+    readonly middleware: MiddlewareModule;
+    readonly constants: ConstantsModule;
+    readonly storage: StorageModule;
+    readonly orm: ORMModule;
+    /**
+     * Private constructor (Singleton 패턴)
+     */
+    private constructor();
+    /**
+     * Singleton 인스턴스 반환
+     */
+    static getInstance(): XplatSystem;
+    /**
+     * 인스턴스 리셋 (테스트용)
+     */
+    static resetInstance(): void;
+}
+/**
+ * Singleton 인스턴스 export
+ */
+export declare const xplatSystem: XplatSystem;

package/dist/core/XplatSystem.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xplatSystem = exports.XplatSystem = void 0;
+const app_1 = require("../modules/app");
+const router_1 = require("../modules/router");
+const auth_1 = require("../modules/auth");
+const utils_1 = require("../modules/utils");
+const middleware_1 = require("../modules/middleware");
+const constants_1 = require("../modules/constants");
+const storage_1 = require("../modules/storage");
+const orm_1 = require("../modules/orm");
+/**
+ * XplatSystem - Singleton 패턴 기반 Framework 인스턴스
+ *
+ * 모든 framework 기능을 하나의 인스턴스를 통해 접근할 수 있도록 합니다.
+ */
+class XplatSystem {
+    /**
+     * Private constructor (Singleton 패턴)
+     */
+    constructor() {
+        this.app = new app_1.AppModule();
+        this.router = new router_1.RouterModule();
+        this.auth = new auth_1.AuthModule();
+        this.utils = new utils_1.UtilsModule();
+        this.middleware = new middleware_1.MiddlewareModule();
+        this.constants = new constants_1.ConstantsModule();
+        this.storage = new storage_1.StorageModule();
+        this.orm = new orm_1.ORMModule();
+    }
+    /**
+     * Singleton 인스턴스 반환
+     */
+    static getInstance() {
+        if (!XplatSystem.instance) {
+            XplatSystem.instance = new XplatSystem();
+        }
+        return XplatSystem.instance;
+    }
+    /**
+     * 인스턴스 리셋 (테스트용)
+     */
+    static resetInstance() {
+        XplatSystem.instance = null;
+    }
+}
+exports.XplatSystem = XplatSystem;
+/**
+ * Singleton 인스턴스 export
+ */
+exports.xplatSystem = XplatSystem.getInstance();

package/dist/index.d.ts

@@ -4,9 +4,22 @@
  * Express + TypeScript 백엔드 스캐폴딩 도구 (zium-backend 기반)
  *
  * 파일명과 API endpoint가 자동으로 일치하는 라우팅 시스템을 제공합니다.
+ * Singleton 패턴 기반 framework로 모든 기능을 xplatSystem 인스턴스를 통해 접근할 수 있습니다.
  *
  * @packageDocumentation
  */
-export { createRouter } from './util/route';
-export { createApp } from './createApp';
-export type { AppConfig, ExtendedRequest, ExtendedResponse, } from './types';
+export { xplatSystem, XplatSystem } from './core/XplatSystem';
+export { createRouter } from './modules/router/route-factory';
+export { createApp } from './modules/app/app-factory';
+export type { AppConfig, ExtendedRequest, ExtendedResponse, AuthenticatedRequest, XplatSystemInstance, } from './types';
+export type { TokenPayload, TokenOptions, TokenPair, } from './modules/auth/jwt';
+export { AppModule } from './modules/app';
+export { RouterModule } from './modules/router';
+export { AuthModule } from './modules/auth';
+export { UtilsModule } from './modules/utils';
+export { MiddlewareModule } from './modules/middleware';
+export { ConstantsModule } from './modules/constants';
+export { StorageModule } from './modules/storage';
+export { ORMModule } from './modules/orm';
+export type { DetailSearch, SortQueryData, SearchDataItem, SortDataItem, ColumnMapper, } from './modules/orm/query-builder';
+export type { S3Config } from './modules/storage/s3';

package/dist/index.js

@@ -5,14 +5,36 @@
  * Express + TypeScript 백엔드 스캐폴딩 도구 (zium-backend 기반)
  *
  * 파일명과 API endpoint가 자동으로 일치하는 라우팅 시스템을 제공합니다.
+ * Singleton 패턴 기반 framework로 모든 기능을 xplatSystem 인스턴스를 통해 접근할 수 있습니다.
  *
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createApp = exports.createRouter = void 0;
-// 라우팅 유틸리티
-var route_1 = require("./util/route");
-Object.defineProperty(exports, "createRouter", { enumerable: true, get: function () { return route_1.createRouter; } });
-// Express 앱 생성 함수
-var createApp_1 = require("./createApp");
-Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return createApp_1.createApp; } });
+exports.ORMModule = exports.StorageModule = exports.ConstantsModule = exports.MiddlewareModule = exports.UtilsModule = exports.AuthModule = exports.RouterModule = exports.AppModule = exports.createApp = exports.createRouter = exports.XplatSystem = exports.xplatSystem = void 0;
+// Singleton 인스턴스 및 클래스
+var XplatSystem_1 = require("./core/XplatSystem");
+Object.defineProperty(exports, "xplatSystem", { enumerable: true, get: function () { return XplatSystem_1.xplatSystem; } });
+Object.defineProperty(exports, "XplatSystem", { enumerable: true, get: function () { return XplatSystem_1.XplatSystem; } });
+// 라우팅 유틸리티 (하위 호환성)
+var route_factory_1 = require("./modules/router/route-factory");
+Object.defineProperty(exports, "createRouter", { enumerable: true, get: function () { return route_factory_1.createRouter; } });
+// Express 앱 생성 함수 (하위 호환성)
+var app_factory_1 = require("./modules/app/app-factory");
+Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return app_factory_1.createApp; } });
+// 모듈들 (선택적 export)
+var app_1 = require("./modules/app");
+Object.defineProperty(exports, "AppModule", { enumerable: true, get: function () { return app_1.AppModule; } });
+var router_1 = require("./modules/router");
+Object.defineProperty(exports, "RouterModule", { enumerable: true, get: function () { return router_1.RouterModule; } });
+var auth_1 = require("./modules/auth");
+Object.defineProperty(exports, "AuthModule", { enumerable: true, get: function () { return auth_1.AuthModule; } });
+var utils_1 = require("./modules/utils");
+Object.defineProperty(exports, "UtilsModule", { enumerable: true, get: function () { return utils_1.UtilsModule; } });
+var middleware_1 = require("./modules/middleware");
+Object.defineProperty(exports, "MiddlewareModule", { enumerable: true, get: function () { return middleware_1.MiddlewareModule; } });
+var constants_1 = require("./modules/constants");
+Object.defineProperty(exports, "ConstantsModule", { enumerable: true, get: function () { return constants_1.ConstantsModule; } });
+var storage_1 = require("./modules/storage");
+Object.defineProperty(exports, "StorageModule", { enumerable: true, get: function () { return storage_1.StorageModule; } });
+var orm_1 = require("./modules/orm");
+Object.defineProperty(exports, "ORMModule", { enumerable: true, get: function () { return orm_1.ORMModule; } });

package/dist/modules/app/app-factory.d.ts

@@ -0,0 +1,12 @@
+import { Application } from 'express';
+import { AppConfig } from '../../types';
+/**
+ * Express 앱 생성 함수
+ *
+ * zium-backend의 app.ts 구조를 기반으로 한 Express 애플리케이션을 생성합니다.
+ * 파일명과 API endpoint가 자동으로 일치하도록 라우팅 시스템을 포함합니다.
+ *
+ * @param config - 앱 설정 옵션
+ * @returns Express Application 인스턴스
+ */
+export declare function createApp(config?: AppConfig): Application;

package/dist/modules/app/app-factory.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApp = createApp;
+const express_1 = __importDefault(require("express"));
+const cookie_parser_1 = __importDefault(require("cookie-parser"));
+const cors_1 = __importDefault(require("cors"));
+const path = __importStar(require("path"));
+const route_1 = require("../../util/route");
+/**
+ * Express 앱 생성 함수
+ *
+ * zium-backend의 app.ts 구조를 기반으로 한 Express 애플리케이션을 생성합니다.
+ * 파일명과 API endpoint가 자동으로 일치하도록 라우팅 시스템을 포함합니다.
+ *
+ * @param config - 앱 설정 옵션
+ * @returns Express Application 인스턴스
+ */
+function createApp(config = {}) {
+    const app = (0, express_1.default)();
+    // Trust proxy 설정 (실제 IP를 얻기 위해)
+    if (config.trustProxy !== false) {
+        app.set('trust proxy', true);
+    }
+    // CORS 설정
+    app.use((req, res, next) => {
+        res.vary('Origin');
+        next();
+    });
+    const corsOrigin = config.cors?.origin ||
+        (process.env.CORS_ALLOW_ORIGINS
+            ? process.env.CORS_ALLOW_ORIGINS.split(',').map(s => s.trim())
+            : ['*']);
+    app.use((0, cors_1.default)({
+        origin: typeof corsOrigin === 'function'
+            ? corsOrigin
+            : corsOrigin,
+        credentials: config.cors?.credentials !== false,
+    }));
+    // Body parser 설정
+    app.use(express_1.default.json({ limit: config.json?.limit || '1mb' }));
+    app.use(express_1.default.urlencoded({
+        extended: config.urlencoded?.extended !== false
+    }));
+    // Cookie parser 설정
+    app.use((0, cookie_parser_1.default)());
+    // 커스텀 미들웨어 적용
+    if (config.middleware && config.middleware.length > 0) {
+        config.middleware.forEach(middleware => {
+            app.use(middleware);
+        });
+    }
+    // 라우터 등록
+    if (config.router?.directory) {
+        const routerDirectory = config.router.directory;
+        const basePath = config.router.basePath || '/restapi';
+        // 절대 경로가 아니면 현재 작업 디렉토리를 기준으로 해석
+        const absoluteRouterDirectory = path.isAbsolute(routerDirectory)
+            ? routerDirectory
+            : path.join(process.cwd(), routerDirectory);
+        try {
+            const router = (0, route_1.createRouter)(absoluteRouterDirectory);
+            app.use(basePath, router);
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to load router from directory "${absoluteRouterDirectory}". ` +
+                `Make sure the directory exists and contains route files.`);
+        }
+    }
+    // 404 핸들러
+    app.use((req, res) => {
+        res.status(404).json({
+            success: false,
+            message: 'Not Found',
+            path: req.path,
+        });
+    });
+    // 에러 핸들러
+    app.use((err, req, res, next) => {
+        console.error('Error:', err);
+        res.status(500).json({
+            success: false,
+            message: process.env.NODE_ENV === 'production'
+                ? 'Internal Server Error'
+                : err.message,
+            ...(process.env.NODE_ENV !== 'production' && { stack: err.stack }),
+        });
+    });
+    return app;
+}

package/dist/modules/app/index.d.ts

@@ -0,0 +1,11 @@
+import { Application } from 'express';
+import { AppConfig } from '../../types';
+/**
+ * AppModule - Express 앱 생성 모듈
+ */
+export declare class AppModule {
+    /**
+     * Express 앱 생성
+     */
+    create(config?: AppConfig): Application;
+}

package/dist/modules/app/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const app_factory_1 = require("./app-factory");
+/**
+ * AppModule - Express 앱 생성 모듈
+ */
+class AppModule {
+    /**
+     * Express 앱 생성
+     */
+    create(config = {}) {
+        return (0, app_factory_1.createApp)(config);
+    }
+}
+exports.AppModule = AppModule;

package/dist/modules/auth/index.d.ts

@@ -0,0 +1,36 @@
+import { TokenPayload, TokenOptions, TokenPair } from './jwt';
+import { AuthMiddlewareOptions } from './middleware';
+import { Request, Response, NextFunction } from 'express';
+/**
+ * AuthModule - 인증/인가 모듈
+ */
+export declare class AuthModule {
+    /**
+     * JWT 토큰 생성
+     */
+    generateToken(payload: TokenPayload, options: TokenOptions): string;
+    /**
+     * JWT 토큰 검증
+     */
+    verifyToken(token: string, secret: string): TokenPayload | null;
+    /**
+     * Access Token과 Refresh Token 쌍 생성
+     */
+    createTokenPair(payload: TokenPayload, accessTokenOptions: TokenOptions, refreshTokenOptions: TokenOptions): TokenPair;
+    /**
+     * 인증 미들웨어 생성
+     */
+    createMiddleware(options: AuthMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void | Response<any, Record<string, any>>;
+    /**
+     * 선택적 인증 미들웨어 생성 (토큰이 있으면 검증, 없으면 통과)
+     */
+    createOptionalMiddleware(options: AuthMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+    /**
+     * 환경변수 기반 토큰 생성 (편의 메서드)
+     */
+    createTokenFromEnv(payload: TokenPayload): TokenPair;
+    /**
+     * 환경변수 기반 인증 미들웨어 생성 (편의 메서드)
+     */
+    createMiddlewareFromEnv(onSuccess?: (req: Request, payload: TokenPayload) => void, onError?: (req: Request, res: Response, error: Error) => void): (req: Request, res: Response, next: NextFunction) => void | Response<any, Record<string, any>>;
+}