@danalpay/javascript-sdk 1.0.1

package/README.md

@@ -0,0 +1,41 @@
+# Danal SDK
+
+다날 결제창 연동을 위한 JavaScript SDK 입니다.
+
+---
+
+## Install
+
+```bash
+# npm
+npm install @danalpay/javascript-sdk
+
+# yarn
+yarn add @danalpay/javascript-sdk
+
+# pnpm
+pnpm add @danalpay/javascript-sdk
+```
+
+## Quick Start
+
+```js
+import { loadDanalPayemntsSDK } from "@danalpay/javascript-sdk";
+
+// async/await
+const danal = await loadDanalPayemntsSDK({ clientKey: "YOUR_KEY" });
+await danal.requestPayment({...});
+```
+
+## TypeScript
+
+TypeScript 타입 정의 파일(.d.ts)을 포함하고 있어, 타입 안전성과 자동완성을 지원합니다.
+
+## OUR Site
+
+더 자세한 가이드 문서, API 레퍼런스, 샘플 코드는 개발자 사이트에서 확인하세요.<br/>
+[➡️ Danal 개발자 사이트](https://developers.danalpay.com)
+
+## License
+
+MIT © Danal

package/dist/index.cjs.js

@@ -0,0 +1,63 @@
+'use strict';
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __rest(s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+const RESOURCE_URL = 'https://static.danalpay.com/d1/sdk/index.js';
+const NAMESPACE = 'DanalPayments';
+
+function appendScript(src, options) {
+    return new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = src;
+        if (options) {
+            const { onload, onerror } = options, attrs = __rest(options, ["onload", "onerror"]);
+            Object.assign(script, attrs);
+        }
+        script.onload = () => resolve(window[NAMESPACE]);
+        script.onerror = (e) => reject(e);
+        document.head.appendChild(script);
+    });
+}
+
+function loadDanalPayemntsSDK(params, scriptOption) {
+    if (typeof window === 'undefined') {
+        return Promise.reject('window is undefined');
+    }
+    return appendScript(RESOURCE_URL, scriptOption).then((danalPayments) => {
+        return danalPayments(params);
+    });
+}
+
+exports.loadDanalPayemntsSDK = loadDanalPayemntsSDK;

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+type Paymethod = 'CARD' | 'NAVERPAY' | 'KAKAOPAY' | 'PAYCO' | 'MOBILE' | 'TRANSFER' | 'VACCOUNT' | 'CULTURELAND' | 'BOOK_AND_LIFE';
+
+/** PayMethod를 `CARD`로 설정하면 카드/간편결제 통합결제창, 카드・간편결제 자체창을 사용할 수 있어요. */
+type CardPaymentsRequest = {
+    /** 결제 금액 부가세입니다. */
+    taxAmount?: number;
+    /** 카드코드값입니다. 어떤 카드로 결제할지 카드사코드값을 입력합니다. */
+    cardCodes?: CardCode[];
+    /** 할부개월 수입니다. 카드 할부개월 수를 입력합니다. */
+    installmentMonths?: string[];
+    /** 간편결제 코드값입니다. CARDCODE값이 있으면 무시됩니다. */
+    easyPayProvider?: string;
+    /** 면세금액입니다다. */
+    taxFreeAmount?: number;
+    /** 봉사료입니다. */
+    serviceAmount?: number;
+};
+type CardCode = '0100' | '0200' | '0201' | '0203' | '0204' | '0205' | '0206' | '0207' | '0208' | '0209' | '0210' | '0300' | '0400' | '0500' | '0701' | '0600' | '0601' | '0700' | '0800' | '0906' | '0907' | '0908' | '0909' | '0910' | '0911' | '0912' | '0913' | '0914' | '0915' | '0916' | '0917' | '0918' | '0919' | '0921' | '0922' | '0923' | '0924' | '0925' | '0926' | '0927' | '0928' | '0929' | '0930' | '0931' | '0932' | '0933' | '0934' | '1100' | '1200' | '1300';
+
+/** PayMethod를 `MOBILE`로 설정하면 휴대폰결제 통합결제창, 휴대폰결제 자체창을 사용할 수 있어요. */
+type MobilePaymentRequest = {
+    /** 휴대폰 타입입니다. */
+    itemType: string;
+    /** 아이템 코드값입니다. */
+    itemCode: string;
+    /** 사용자의 통신사 코드입니다 */
+    carriers?: Carrier[];
+};
+type Carrier = "SKT" | "KTF" | "LGT" | "SKL" | "KCT" | "CJH";
+
+/** PayMethod를 `TRANSFER`로 설정하면 계좌이체 결제수단이 열립니다. */
+type TransferPaymentsRequest = {
+    /** 사용자 이름입니다. */
+    userName?: string;
+    /** 사용자 이메일 입니다 */
+    userEmail?: string;
+    /** 현금영수증 사용여부입니다. */
+    useCashReceipt?: 'Y' | 'N';
+    /** 안심결제 사용여부입니다. */
+    useEscrow?: 'Y' | 'N';
+};
+
+/** PayMethod를 `VACCOUNT`로 설정하면 가상계좌 결제수단이 열립니다. */
+type VirtualAccountPaymentsRequest = {
+    /** 예금주명 입니다. */
+    accountHolder?: string;
+    /** 은행 코드입니다. */
+    bankCodes?: BankCode[];
+    /** 현금영수증 사용여부입니다. */
+    useCashReceipt?: 'Y' | 'N';
+    /** 안심결제 사용여부입니다. */
+    useEscrow?: 'Y' | 'N';
+};
+type BankCode = '012' | '004' | '088' | '020' | '081' | '003' | '031' | '071' | '032' | '034' | '039' | '045';
+
+/** PayMethod를 `BOOK_AND_LIFE`로 설정하면 도서문화상품권 결제창을 사용할 수 있어요. */
+type BookAndLifePaymentsRequest = {
+    /** 사용자 이메일입니다. */
+    userEmail?: string;
+};
+
+/** PayMethod를 `CULTURELAND`로 설정하면 컬쳐랜드 결제창을 사용할 수 있어요. */
+type CulturelandPaymentsRequest = {
+    /** 사용자 이메일입니다. */
+    userEmail: string;
+};
+
+type CommonBaseParams = {
+    /** 결제수단입니다. 결제수단을 구분하는 값입니다. */
+    paymentsMethod: Paymethod;
+    /** 상품명입니다. */
+    orderName: string;
+    /** 가맹점 주문번호입니다. */
+    orderId: string;
+    /** 구매하는 사용자의 아이디 입니다. */
+    userId: string;
+    /** 상품금액입니다. */
+    amount: number;
+    /** 가맹점 번호입니다. */
+    merchantId: string;
+    /** 결제 성공시 리다이렉트 될 URL 입니다. */
+    successUrl: string;
+    /** 결제 종료 시 리다이렉트 될 URL 입니다. */
+    failUrl: string;
+    /** 할인금액 입니다. */
+    discountAmount?: number;
+    /** 컵 보증금 입니다. */
+    depositAmount?: number;
+    /** 통화 입니다. */
+    currency?: string;
+    /** 부가세 입니다. */
+    vatAmount?: number;
+    /** 인코딩타입 입니다. */
+    charset?: string;
+    /** 결제통지 받을 가맹점 측 URL입니다 */
+    notiUrl?: string;
+};
+
+type OptionParams = {
+    customWidth?: string;
+    customHeight?: string;
+};
+type PaymentRequestMap = {
+    MOBILE: MobilePaymentRequest;
+    TRANSFER: TransferPaymentsRequest;
+    CARD: CardPaymentsRequest;
+    BOOK_AND_LIFE: BookAndLifePaymentsRequest;
+    CULTURELAND: CulturelandPaymentsRequest;
+    VACCOUNT: VirtualAccountPaymentsRequest;
+    NAVERPAY: CardPaymentsRequest;
+    KAKAOPAY: CardPaymentsRequest;
+    PAYCO: CardPaymentsRequest;
+};
+type RequestPaymentParam<T extends keyof PaymentRequestMap> = CommonBaseParams & OptionParams & PaymentRequestMap[T];
+interface DanalPayments {
+    requestPayment<T extends Paymethod>(args: {
+        paymentsMethod: T;
+    } & RequestPaymentParam<T>): Promise<void>;
+}
+type InitialParams = {
+    clientKey: string;
+} | string;
+
+declare function loadDanalPayemntsSDK(params: InitialParams, scriptOption?: Partial<Omit<HTMLScriptElement, 'src'>>): Promise<DanalPayments>;
+
+export { loadDanalPayemntsSDK };
+export type { DanalPayments, Paymethod, RequestPaymentParam };

package/dist/index.esm.js

@@ -0,0 +1,61 @@
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __rest(s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+const RESOURCE_URL = 'https://static.danalpay.com/d1/sdk/index.js';
+const NAMESPACE = 'DanalPayments';
+
+function appendScript(src, options) {
+    return new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = src;
+        if (options) {
+            const { onload, onerror } = options, attrs = __rest(options, ["onload", "onerror"]);
+            Object.assign(script, attrs);
+        }
+        script.onload = () => resolve(window[NAMESPACE]);
+        script.onerror = (e) => reject(e);
+        document.head.appendChild(script);
+    });
+}
+
+function loadDanalPayemntsSDK(params, scriptOption) {
+    if (typeof window === 'undefined') {
+        return Promise.reject('window is undefined');
+    }
+    return appendScript(RESOURCE_URL, scriptOption).then((danalPayments) => {
+        return danalPayments(params);
+    });
+}
+
+export { loadDanalPayemntsSDK };

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@danalpay/javascript-sdk",
+  "description": "Danal ONE API javascript SDK",
+  "version": "1.0.1",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "author": "Danal",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://developers.danalpay.com",
+  "scripts": {
+    "build": "rollup -c",
+    "prepack": "pnpm build"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@babel/core": "^7.26.0",
+    "@babel/preset-env": "^7.26.0",
+    "@babel/preset-typescript": "^7.26.0",
+    "@danalpay/shared": "workspace:*",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-typescript": "^12.1.1",
+    "@types/node": "^22.13.14",
+    "prettier": "^3.3.3",
+    "rollup": "^4.27.3",
+    "rollup-plugin-dts": "^6.1.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=12.*"
+  },
+  "files": [
+    "dist",
+    "types"
+  ],
+  "keywords": [
+    "danal",
+    "payments",
+    "sdk"
+  ]
+}