@hamjimin/xplat-back 0.2.0 → 0.4.0

package/dist/cli/index.js

@@ -73,6 +73,5 @@ Examples:
   `);
 }
 // CLI 실행
-if (require.main === module) {
-    main();
-}
+// bin 파일에서 require로 불러올 때도 실행되도록 main() 직접 호출
+main();

package/dist/core/XplatSystem.d.ts

@@ -6,6 +6,8 @@ import { MiddlewareModule } from '../modules/middleware';
 import { ConstantsModule } from '../modules/constants';
 import { StorageModule } from '../modules/storage';
 import { ORMModule } from '../modules/orm';
+import { PaymentModule } from '../modules/payment';
+import { ShippingModule } from '../modules/shipping';
 /**
  * XplatSystem - Singleton 패턴 기반 Framework 인스턴스
  *
@@ -21,6 +23,8 @@ export declare class XplatSystem {
     readonly constants: ConstantsModule;
     readonly storage: StorageModule;
     readonly orm: ORMModule;
+    readonly payment: PaymentModule;
+    readonly shipping: ShippingModule;
     /**
      * Private constructor (Singleton 패턴)
      */

package/dist/core/XplatSystem.js

@@ -9,6 +9,8 @@ const middleware_1 = require("../modules/middleware");
 const constants_1 = require("../modules/constants");
 const storage_1 = require("../modules/storage");
 const orm_1 = require("../modules/orm");
+const payment_1 = require("../modules/payment");
+const shipping_1 = require("../modules/shipping");
 /**
  * XplatSystem - Singleton 패턴 기반 Framework 인스턴스
  *
@@ -27,6 +29,8 @@ class XplatSystem {
         this.constants = new constants_1.ConstantsModule();
         this.storage = new storage_1.StorageModule();
         this.orm = new orm_1.ORMModule();
+        this.payment = new payment_1.PaymentModule();
+        this.shipping = new shipping_1.ShippingModule();
     }
     /**
      * Singleton 인스턴스 반환

package/dist/index.d.ts

@@ -21,5 +21,11 @@ export { MiddlewareModule } from './modules/middleware';
 export { ConstantsModule } from './modules/constants';
 export { StorageModule } from './modules/storage';
 export { ORMModule } from './modules/orm';
+export { PaymentModule } from './modules/payment';
+export { ShippingModule } from './modules/shipping';
 export type { DetailSearch, SortQueryData, SearchDataItem, SortDataItem, ColumnMapper, } from './modules/orm/query-builder';
 export type { S3Config } from './modules/storage/s3';
+export type { PaymentRequestParams, PaymentResponse, PaymentConfirmParams, PaymentCancelParams, PaymentDetails, } from './modules/payment/types';
+export { TossPaymentProvider, KakaoPayProvider } from './modules/payment';
+export type { ShippingFeeParams, ShippingFee, CreateLabelParams, ShippingLabel, TrackingInfo, } from './modules/shipping/types';
+export { CJLogisticsProvider, LogenProvider, CvsProvider } from './modules/shipping';

package/dist/index.js

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.CvsProvider = exports.LogenProvider = exports.CJLogisticsProvider = exports.KakaoPayProvider = exports.TossPaymentProvider = exports.ShippingModule = exports.PaymentModule = 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; } });
@@ -38,3 +38,14 @@ 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; } });
+var payment_1 = require("./modules/payment");
+Object.defineProperty(exports, "PaymentModule", { enumerable: true, get: function () { return payment_1.PaymentModule; } });
+var shipping_1 = require("./modules/shipping");
+Object.defineProperty(exports, "ShippingModule", { enumerable: true, get: function () { return shipping_1.ShippingModule; } });
+var payment_2 = require("./modules/payment");
+Object.defineProperty(exports, "TossPaymentProvider", { enumerable: true, get: function () { return payment_2.TossPaymentProvider; } });
+Object.defineProperty(exports, "KakaoPayProvider", { enumerable: true, get: function () { return payment_2.KakaoPayProvider; } });
+var shipping_2 = require("./modules/shipping");
+Object.defineProperty(exports, "CJLogisticsProvider", { enumerable: true, get: function () { return shipping_2.CJLogisticsProvider; } });
+Object.defineProperty(exports, "LogenProvider", { enumerable: true, get: function () { return shipping_2.LogenProvider; } });
+Object.defineProperty(exports, "CvsProvider", { enumerable: true, get: function () { return shipping_2.CvsProvider; } });

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

@@ -0,0 +1,43 @@
+import { PaymentProvider, PaymentRequestParams, PaymentConfirmParams, PaymentCancelParams, PaymentDetails } from './types';
+/**
+ * PaymentModule - 결제 프로바이더 레지스트리
+ */
+export declare class PaymentModule {
+    private providers;
+    private defaultProvider;
+    /**
+     * 프로바이더 등록
+     */
+    registerProvider(provider: PaymentProvider, setAsDefault?: boolean): void;
+    /**
+     * 프로바이더 목록
+     */
+    listProviders(): string[];
+    /**
+     * 기본 프로바이더 설정
+     */
+    setDefaultProvider(name: string): void;
+    /**
+     * 프로바이더 가져오기
+     */
+    private getProvider;
+    /**
+     * 결제 요청
+     */
+    requestPayment(params: PaymentRequestParams, providerName?: string): Promise<import("./types").PaymentResponse>;
+    /**
+     * 결제 확인
+     */
+    confirmPayment(params: PaymentConfirmParams, providerName?: string): Promise<PaymentDetails>;
+    /**
+     * 결제 취소
+     */
+    cancelPayment(params: PaymentCancelParams, providerName?: string): Promise<PaymentDetails>;
+    /**
+     * 결제 조회
+     */
+    getPayment(paymentKey: string, providerName?: string): Promise<PaymentDetails>;
+}
+export * from './types';
+export * from './providers/toss';
+export * from './providers/kakaopay';

package/dist/modules/payment/index.js

@@ -0,0 +1,92 @@
+"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.PaymentModule = void 0;
+/**
+ * PaymentModule - 결제 프로바이더 레지스트리
+ */
+class PaymentModule {
+    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(`Payment provider "${name}" not registered`);
+        }
+        this.defaultProvider = name;
+    }
+    /**
+     * 프로바이더 가져오기
+     */
+    getProvider(name) {
+        const target = name || this.defaultProvider;
+        if (!target) {
+            throw new Error('No payment provider registered');
+        }
+        const provider = this.providers.get(target);
+        if (!provider) {
+            throw new Error(`Payment provider "${target}" not found`);
+        }
+        return provider;
+    }
+    /**
+     * 결제 요청
+     */
+    async requestPayment(params, providerName) {
+        return this.getProvider(providerName).requestPayment(params);
+    }
+    /**
+     * 결제 확인
+     */
+    async confirmPayment(params, providerName) {
+        return this.getProvider(providerName).confirmPayment(params);
+    }
+    /**
+     * 결제 취소
+     */
+    async cancelPayment(params, providerName) {
+        return this.getProvider(providerName).cancelPayment(params);
+    }
+    /**
+     * 결제 조회
+     */
+    async getPayment(paymentKey, providerName) {
+        return this.getProvider(providerName).getPayment(paymentKey);
+    }
+}
+exports.PaymentModule = PaymentModule;
+__exportStar(require("./types"), exports);
+__exportStar(require("./providers/toss"), exports);
+__exportStar(require("./providers/kakaopay"), exports);

package/dist/modules/payment/providers/kakaopay.d.ts

@@ -0,0 +1,17 @@
+import { PaymentProvider, PaymentRequestParams, PaymentResponse, PaymentConfirmParams, PaymentCancelParams, PaymentDetails } from '../types';
+export interface KakaoPayConfig {
+    cid: string;
+    secretKey?: string;
+    approvalUrl?: string;
+    cancelUrl?: string;
+    failUrl?: string;
+}
+export declare class KakaoPayProvider implements PaymentProvider {
+    readonly name = "kakaopay";
+    private readonly config;
+    constructor(config: KakaoPayConfig);
+    requestPayment(params: PaymentRequestParams): Promise<PaymentResponse>;
+    confirmPayment(params: PaymentConfirmParams): Promise<PaymentDetails>;
+    cancelPayment(params: PaymentCancelParams): Promise<PaymentDetails>;
+    getPayment(paymentKey: string): Promise<PaymentDetails>;
+}

package/dist/modules/payment/providers/kakaopay.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KakaoPayProvider = void 0;
+class KakaoPayProvider {
+    constructor(config) {
+        this.name = 'kakaopay';
+        this.config = config;
+    }
+    async requestPayment(params) {
+        return {
+            provider: this.name,
+            paymentKey: `kakao_${params.orderId}`,
+            checkoutUrl: this.config.approvalUrl || params.successUrl || '',
+            raw: {
+                amount: params.amount,
+                cid: this.config.cid,
+            },
+        };
+    }
+    async confirmPayment(params) {
+        return {
+            provider: this.name,
+            paymentKey: params.paymentKey,
+            status: 'paid',
+            amount: params.amount,
+            raw: {
+                orderId: params.orderId,
+            },
+        };
+    }
+    async cancelPayment(params) {
+        return {
+            provider: this.name,
+            paymentKey: params.paymentKey,
+            status: 'canceled',
+            amount: params.cancelAmount ?? 0,
+            raw: {
+                reason: params.cancelReason,
+            },
+        };
+    }
+    async getPayment(paymentKey) {
+        return {
+            provider: this.name,
+            paymentKey,
+            status: 'paid',
+            amount: 0,
+        };
+    }
+}
+exports.KakaoPayProvider = KakaoPayProvider;

package/dist/modules/payment/providers/toss.d.ts

@@ -0,0 +1,15 @@
+import { PaymentProvider, PaymentRequestParams, PaymentResponse, PaymentConfirmParams, PaymentCancelParams, PaymentDetails } from '../types';
+export interface TossConfig {
+    secretKey: string;
+    testMode?: boolean;
+    defaultCurrency?: string;
+}
+export declare class TossPaymentProvider implements PaymentProvider {
+    readonly name = "toss";
+    private readonly config;
+    constructor(config: TossConfig);
+    requestPayment(params: PaymentRequestParams): Promise<PaymentResponse>;
+    confirmPayment(params: PaymentConfirmParams): Promise<PaymentDetails>;
+    cancelPayment(params: PaymentCancelParams): Promise<PaymentDetails>;
+    getPayment(paymentKey: string): Promise<PaymentDetails>;
+}

package/dist/modules/payment/providers/toss.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TossPaymentProvider = void 0;
+class TossPaymentProvider {
+    constructor(config) {
+        this.name = 'toss';
+        this.config = config;
+    }
+    async requestPayment(params) {
+        // 실제 API 연동은 프로젝트에서 구현하도록 남겨둡니다.
+        // 여기서는 기본적인 형식만 반환합니다.
+        return {
+            provider: this.name,
+            paymentKey: `toss_${params.orderId}`,
+            checkoutUrl: params.successUrl || '',
+            raw: {
+                amount: params.amount,
+                currency: params.currency || this.config.defaultCurrency || 'KRW',
+                testMode: this.config.testMode ?? true,
+            },
+        };
+    }
+    async confirmPayment(params) {
+        return {
+            provider: this.name,
+            paymentKey: params.paymentKey,
+            status: 'paid',
+            amount: params.amount,
+            raw: {
+                orderId: params.orderId,
+            },
+        };
+    }
+    async cancelPayment(params) {
+        return {
+            provider: this.name,
+            paymentKey: params.paymentKey,
+            status: 'canceled',
+            amount: params.cancelAmount ?? 0,
+            raw: {
+                reason: params.cancelReason,
+            },
+        };
+    }
+    async getPayment(paymentKey) {
+        return {
+            provider: this.name,
+            paymentKey,
+            status: 'paid',
+            amount: 0,
+        };
+    }
+}
+exports.TossPaymentProvider = TossPaymentProvider;

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamjimin/xplat-back",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Express + TypeScript 백엔드 스캐폴딩 도구 (zium-backend 기반)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",