@hamjimin/xplat-back 0.1.0 → 0.3.0

package/dist/modules/payment/types.d.ts

@@ -0,0 +1,46 @@
+export interface PaymentRequestParams {
+    orderId: string;
+    amount: number;
+    customerName: string;
+    customerEmail?: string;
+    customerPhone?: string;
+    successUrl?: string;
+    failUrl?: string;
+    description?: string;
+    currency?: string;
+    method?: string;
+    metadata?: Record<string, any>;
+}
+export interface PaymentResponse {
+    provider: string;
+    paymentKey?: string;
+    checkoutUrl?: string;
+    raw?: any;
+}
+export interface PaymentConfirmParams {
+    paymentKey: string;
+    orderId: string;
+    amount: number;
+}
+export interface PaymentCancelParams {
+    paymentKey: string;
+    cancelReason: string;
+    cancelAmount?: number;
+}
+export interface PaymentDetails {
+    provider: string;
+    paymentKey: string;
+    status: 'requested' | 'authorized' | 'paid' | 'failed' | 'canceled';
+    amount: number;
+    raw?: any;
+}
+export interface PaymentProviderConfig {
+    name: string;
+}
+export interface PaymentProvider {
+    name: string;
+    requestPayment(params: PaymentRequestParams): Promise<PaymentResponse>;
+    confirmPayment(params: PaymentConfirmParams): Promise<PaymentDetails>;
+    cancelPayment(params: PaymentCancelParams): Promise<PaymentDetails>;
+    getPayment(paymentKey: string): Promise<PaymentDetails>;
+}

package/dist/modules/payment/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,10 @@
+import { Router } from 'express';
+/**
+ * RouterModule - 라우터 생성 모듈
+ */
+export declare class RouterModule {
+    /**
+     * 파일 기반 라우터 생성
+     */
+    create(directory: string): Router;
+}

package/dist/modules/router/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterModule = void 0;
+const route_factory_1 = require("./route-factory");
+/**
+ * RouterModule - 라우터 생성 모듈
+ */
+class RouterModule {
+    /**
+     * 파일 기반 라우터 생성
+     */
+    create(directory) {
+        return (0, route_factory_1.createRouter)(directory);
+    }
+}
+exports.RouterModule = RouterModule;

package/dist/modules/router/route-factory.d.ts

@@ -0,0 +1,10 @@
+import express from 'express';
+/**
+ * 파일 경로 기준 동적 라우터 생성
+ *
+ * 디렉토리 구조를 API endpoint로 자동 매핑합니다.
+ *
+ * @param directory - 라우트 파일들이 위치한 루트 디렉토리
+ * @returns Express Router 인스턴스
+ */
+export declare function createRouter(directory: string): express.Router;

package/dist/modules/router/route-factory.js

@@ -0,0 +1,72 @@
+"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.createRouter = createRouter;
+const express_1 = __importDefault(require("express"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 파일 경로 기준 동적 라우터 생성
+ *
+ * 디렉토리 구조를 API endpoint로 자동 매핑합니다.
+ *
+ * @param directory - 라우트 파일들이 위치한 루트 디렉토리
+ * @returns Express Router 인스턴스
+ */
+function createRouter(directory) {
+    const router = express_1.default.Router();
+    const files = fs.readdirSync(directory);
+    for (const file of files) {
+        const filePath = path.join(directory, file);
+        if (fs.statSync(filePath).isDirectory()) {
+            // 디렉토리인 경우 재귀적으로 라우터 생성
+            const subRouter = createRouter(filePath);
+            router.use(`/${file}`, subRouter);
+        }
+        else {
+            // 파일인 경우 라우터 생성
+            if (file.endsWith('.ts') || file.endsWith('.js')) {
+                const routePath = `/${file.replace('.ts', '').replace('.js', '')}`;
+                const required = require(filePath);
+                const routeModule = required.default || required;
+                router.use(routePath, routeModule);
+            }
+        }
+    }
+    return router;
+}

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

@@ -0,0 +1,19 @@
+import { ShippingProvider, ShippingFeeParams, ShippingFee, CreateLabelParams, ShippingLabel, TrackingInfo } from './types';
+/**
+ * ShippingModule - 배송 프로바이더 레지스트리
+ */
+export declare class ShippingModule {
+    private providers;
+    private defaultProvider;
+    registerProvider(provider: ShippingProvider, setAsDefault?: boolean): void;
+    listProviders(): string[];
+    setDefaultProvider(name: string): void;
+    private getProvider;
+    calculateFee(params: ShippingFeeParams, providerName?: string): Promise<ShippingFee>;
+    createLabel(params: CreateLabelParams, providerName?: string): Promise<ShippingLabel>;
+    track(trackingNumber: string, providerName?: string): Promise<TrackingInfo>;
+}
+export * from './types';
+export * from './providers/cj';
+export * from './providers/logen';
+export * from './providers/cvs';

package/dist/modules/shipping/index.js

@@ -0,0 +1,66 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShippingModule = void 0;
+/**
+ * ShippingModule - 배송 프로바이더 레지스트리
+ */
+class ShippingModule {
+    constructor() {
+        this.providers = new Map();
+        this.defaultProvider = null;
+    }
+    registerProvider(provider, setAsDefault = false) {
+        this.providers.set(provider.name, provider);
+        if (setAsDefault || !this.defaultProvider) {
+            this.defaultProvider = provider.name;
+        }
+    }
+    listProviders() {
+        return Array.from(this.providers.keys());
+    }
+    setDefaultProvider(name) {
+        if (!this.providers.has(name)) {
+            throw new Error(`Shipping provider "${name}" not registered`);
+        }
+        this.defaultProvider = name;
+    }
+    getProvider(name) {
+        const target = name || this.defaultProvider;
+        if (!target) {
+            throw new Error('No shipping provider registered');
+        }
+        const provider = this.providers.get(target);
+        if (!provider) {
+            throw new Error(`Shipping provider "${target}" not found`);
+        }
+        return provider;
+    }
+    async calculateFee(params, providerName) {
+        return this.getProvider(providerName).calculateFee(params);
+    }
+    async createLabel(params, providerName) {
+        return this.getProvider(providerName).createLabel(params);
+    }
+    async track(trackingNumber, providerName) {
+        return this.getProvider(providerName).track(trackingNumber);
+    }
+}
+exports.ShippingModule = ShippingModule;
+__exportStar(require("./types"), exports);
+__exportStar(require("./providers/cj"), exports);
+__exportStar(require("./providers/logen"), exports);
+__exportStar(require("./providers/cvs"), exports);

package/dist/modules/shipping/providers/cj.d.ts

@@ -0,0 +1,14 @@
+import { ShippingProvider, ShippingFeeParams, ShippingFee, CreateLabelParams, ShippingLabel, TrackingInfo } from '../types';
+export interface CJConfig {
+    apiKey: string;
+    customerCode?: string;
+    defaultCurrency?: string;
+}
+export declare class CJLogisticsProvider implements ShippingProvider {
+    readonly name = "cj";
+    private readonly config;
+    constructor(config: CJConfig);
+    calculateFee(params: ShippingFeeParams): Promise<ShippingFee>;
+    createLabel(params: CreateLabelParams): Promise<ShippingLabel>;
+    track(trackingNumber: string): Promise<TrackingInfo>;
+}

package/dist/modules/shipping/providers/cj.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CJLogisticsProvider = void 0;
+class CJLogisticsProvider {
+    constructor(config) {
+        this.name = 'cj';
+        this.config = config;
+    }
+    async calculateFee(params) {
+        return {
+            provider: this.name,
+            amount: 3500,
+            currency: this.config.defaultCurrency || 'KRW',
+            estimatedDays: 2,
+            raw: params,
+        };
+    }
+    async createLabel(params) {
+        return {
+            provider: this.name,
+            trackingNumber: `CJ-${params.orderId}`,
+            labelUrl: '',
+            raw: params,
+        };
+    }
+    async track(trackingNumber) {
+        return {
+            provider: this.name,
+            trackingNumber,
+            status: 'in_transit',
+            history: [],
+        };
+    }
+}
+exports.CJLogisticsProvider = CJLogisticsProvider;

package/dist/modules/shipping/providers/cvs.d.ts

@@ -0,0 +1,14 @@
+import { ShippingProvider, ShippingFeeParams, ShippingFee, CreateLabelParams, ShippingLabel, TrackingInfo } from '../types';
+export interface CvsConfig {
+    apiKey: string;
+    carrier?: 'cvsnet' | 'easycv';
+    defaultCurrency?: string;
+}
+export declare class CvsProvider implements ShippingProvider {
+    readonly name = "cvs";
+    private readonly config;
+    constructor(config: CvsConfig);
+    calculateFee(params: ShippingFeeParams): Promise<ShippingFee>;
+    createLabel(params: CreateLabelParams): Promise<ShippingLabel>;
+    track(trackingNumber: string): Promise<TrackingInfo>;
+}

package/dist/modules/shipping/providers/cvs.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CvsProvider = void 0;
+class CvsProvider {
+    constructor(config) {
+        this.name = 'cvs';
+        this.config = config;
+    }
+    async calculateFee(params) {
+        return {
+            provider: this.name,
+            amount: 2700,
+            currency: this.config.defaultCurrency || 'KRW',
+            estimatedDays: 3,
+            raw: params,
+        };
+    }
+    async createLabel(params) {
+        return {
+            provider: this.name,
+            trackingNumber: `CVS-${params.orderId}`,
+            labelUrl: '',
+            raw: params,
+        };
+    }
+    async track(trackingNumber) {
+        return {
+            provider: this.name,
+            trackingNumber,
+            status: 'in_transit',
+            history: [],
+        };
+    }
+}
+exports.CvsProvider = CvsProvider;

package/dist/modules/shipping/providers/logen.d.ts

@@ -0,0 +1,13 @@
+import { ShippingProvider, ShippingFeeParams, ShippingFee, CreateLabelParams, ShippingLabel, TrackingInfo } from '../types';
+export interface LogenConfig {
+    apiKey: string;
+    defaultCurrency?: string;
+}
+export declare class LogenProvider implements ShippingProvider {
+    readonly name = "logen";
+    private readonly config;
+    constructor(config: LogenConfig);
+    calculateFee(params: ShippingFeeParams): Promise<ShippingFee>;
+    createLabel(params: CreateLabelParams): Promise<ShippingLabel>;
+    track(trackingNumber: string): Promise<TrackingInfo>;
+}

package/dist/modules/shipping/providers/logen.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogenProvider = void 0;
+class LogenProvider {
+    constructor(config) {
+        this.name = 'logen';
+        this.config = config;
+    }
+    async calculateFee(params) {
+        return {
+            provider: this.name,
+            amount: 3200,
+            currency: this.config.defaultCurrency || 'KRW',
+            estimatedDays: 2,
+            raw: params,
+        };
+    }
+    async createLabel(params) {
+        return {
+            provider: this.name,
+            trackingNumber: `LOGEN-${params.orderId}`,
+            labelUrl: '',
+            raw: params,
+        };
+    }
+    async track(trackingNumber) {
+        return {
+            provider: this.name,
+            trackingNumber,
+            status: 'in_transit',
+            history: [],
+        };
+    }
+}
+exports.LogenProvider = LogenProvider;

package/dist/modules/shipping/types.d.ts

@@ -0,0 +1,54 @@
+export interface ShippingFeeParams {
+    destinationZip: string;
+    weight?: number;
+    volumeWeight?: number;
+    quantity?: number;
+    options?: Record<string, any>;
+}
+export interface ShippingFee {
+    provider: string;
+    amount: number;
+    currency?: string;
+    estimatedDays?: number;
+    raw?: any;
+}
+export interface CreateLabelParams {
+    orderId: string;
+    toName: string;
+    toPhone: string;
+    toAddress: string;
+    toZip: string;
+    fromName?: string;
+    fromPhone?: string;
+    fromAddress?: string;
+    fromZip?: string;
+    items?: Array<{
+        name: string;
+        quantity: number;
+        weight?: number;
+    }>;
+    memo?: string;
+}
+export interface ShippingLabel {
+    provider: string;
+    trackingNumber: string;
+    labelUrl?: string;
+    raw?: any;
+}
+export interface TrackingInfo {
+    provider: string;
+    trackingNumber: string;
+    status: string;
+    history?: Array<{
+        status: string;
+        timestamp: string;
+        location?: string;
+    }>;
+    raw?: any;
+}
+export interface ShippingProvider {
+    name: string;
+    calculateFee(params: ShippingFeeParams): Promise<ShippingFee>;
+    createLabel(params: CreateLabelParams): Promise<ShippingLabel>;
+    track(trackingNumber: string): Promise<TrackingInfo>;
+}

package/dist/modules/shipping/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,81 @@
+import { S3Config } from './s3';
+/**
+ * StorageModule - 스토리지 관리 모듈
+ */
+export declare class StorageModule {
+    private s3Client;
+    private config;
+    constructor(config?: S3Config);
+    /**
+     * S3 클라이언트 가져오기 (싱글톤)
+     */
+    private getS3Client;
+    /**
+     * S3 클라이언트 재설정
+     */
+    setConfig(config: S3Config): void;
+    /**
+     * 날짜 기반 접두사 생성
+     */
+    getDatePrefix(date?: Date): string;
+    /**
+     * S3 키 생성
+     */
+    buildKey(basePrefix: string, fileName: string, date?: Date): string;
+    /**
+     * 파일 업로드
+     */
+    upload(params: {
+        key: string;
+        body: Buffer | string;
+        bucket: string;
+        contentType?: string;
+    }): Promise<{
+        bucket: string;
+        key: string;
+    }>;
+    /**
+     * PDF 버퍼 업로드
+     */
+    uploadPdf(params: {
+        basePrefix: string;
+        fileName: string;
+        body: Buffer;
+        bucket: string;
+    }): Promise<{
+        bucket: string;
+        key: string;
+    }>;
+    /**
+     * 파일 다운로드
+     */
+    download(params: {
+        key: string;
+        bucket: string;
+        downloadFileName?: string;
+    }): Promise<import("@aws-sdk/client-s3").GetObjectCommandOutput>;
+    /**
+     * Presigned 다운로드 URL 생성
+     */
+    getDownloadUrl(params: {
+        key: string;
+        bucket: string;
+        expiresInSec?: number;
+        downloadFileName?: string;
+    }): Promise<string>;
+    /**
+     * 파일 삭제
+     */
+    delete(params: {
+        key: string;
+        bucket: string;
+    }): Promise<void>;
+    /**
+     * URL에서 키 추출
+     */
+    extractKey(urlOrKey: string, bucket?: string): string;
+    /**
+     * 객체 URL 생성
+     */
+    buildUrl(key: string, bucket?: string, region?: string): string;
+}

package/dist/modules/storage/index.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageModule = void 0;
+const s3_1 = require("./s3");
+/**
+ * StorageModule - 스토리지 관리 모듈
+ */
+class StorageModule {
+    constructor(config = {}) {
+        this.s3Client = null;
+        this.config = config;
+    }
+    /**
+     * S3 클라이언트 가져오기 (싱글톤)
+     */
+    getS3Client() {
+        if (!this.s3Client) {
+            this.s3Client = (0, s3_1.createS3Client)(this.config);
+        }
+        return this.s3Client;
+    }
+    /**
+     * S3 클라이언트 재설정
+     */
+    setConfig(config) {
+        this.config = config;
+        this.s3Client = null;
+    }
+    /**
+     * 날짜 기반 접두사 생성
+     */
+    getDatePrefix(date) {
+        return (0, s3_1.getDatePrefix)(date);
+    }
+    /**
+     * S3 키 생성
+     */
+    buildKey(basePrefix, fileName, date) {
+        return (0, s3_1.buildS3Key)(basePrefix, fileName, date);
+    }
+    /**
+     * 파일 업로드
+     */
+    async upload(params) {
+        return (0, s3_1.uploadFile)(this.getS3Client(), params);
+    }
+    /**
+     * PDF 버퍼 업로드
+     */
+    async uploadPdf(params) {
+        return (0, s3_1.uploadPdfBuffer)(this.getS3Client(), params);
+    }
+    /**
+     * 파일 다운로드
+     */
+    async download(params) {
+        return (0, s3_1.getObject)(this.getS3Client(), params);
+    }
+    /**
+     * Presigned 다운로드 URL 생성
+     */
+    async getDownloadUrl(params) {
+        return (0, s3_1.getPresignedDownloadUrl)(this.getS3Client(), params);
+    }
+    /**
+     * 파일 삭제
+     */
+    async delete(params) {
+        return (0, s3_1.deleteObjectByKey)(this.getS3Client(), params);
+    }
+    /**
+     * URL에서 키 추출
+     */
+    extractKey(urlOrKey, bucket) {
+        const b = bucket || this.config.bucket || process.env.S3_BUCKET || '';
+        return (0, s3_1.extractKeyFromUrl)(urlOrKey, b);
+    }
+    /**
+     * 객체 URL 생성
+     */
+    buildUrl(key, bucket, region) {
+        const b = bucket || this.config.bucket || process.env.S3_BUCKET || '';
+        return (0, s3_1.buildObjectUrl)(key, b, region);
+    }
+}
+exports.StorageModule = StorageModule;