@xmz-ai/coin 0.1.1

package/README.md

@@ -0,0 +1,66 @@
+# coin merchant sdk (typescript)
+
+面向商户 App 的 TypeScript SDK，封装 coin HTTP API 的商户业务能力。
+
+## Scope (v1)
+
+支持：
+- `GET /api/v1/merchants/me`
+- `POST /api/v1/transactions/credit`
+- `POST /api/v1/transactions/debit`
+- `POST /api/v1/transactions/transfer`
+- `POST /api/v1/transactions/refund`
+- `GET /api/v1/transactions/{txn_no}`
+- `GET /api/v1/transactions/by-out-trade-no/{out_trade_no}`
+- `GET /api/v1/transactions`
+
+不支持（平台后台能力）：
+- `POST /api/v1/merchants`
+- `POST /api/v1/merchants/{merchant_no}/secret:rotate`
+- `PUT /api/v1/webhooks/config`
+
+## Install
+
+```bash
+npm install @xmz-ai/coin
+```
+
+## Quick Start
+
+```typescript
+import { CoinClient, CoinAPIError } from "@xmz-ai/coin";
+
+const client = new CoinClient({
+  baseURL: "https://api.example.com",
+  merchantNo: "1000123456789012",
+  merchantSecret: "msk_xxx",
+});
+
+const resp = await client.transactions.credit({
+  out_trade_no: "ord_issue_001",
+  user_id: "u_90001",
+  amount: 1000,
+});
+
+console.log(`txn=${resp.txn_no} status=${resp.status}`);
+```
+
+## Error Handling
+
+```typescript
+try {
+  await client.transactions.credit({ ... });
+} catch (err) {
+  if (err instanceof CoinAPIError) {
+    console.error(`api failed: code=${err.code} request_id=${err.requestId}`);
+  }
+  throw err;
+}
+```
+
+## Notes
+
+- SDK 只提供原子接口，不内置自动轮询或业务重试。
+- 所有请求自动签名（HMAC-SHA256），签名串和服务端一致。
+- 错误统一返回 `CoinAPIError`（包含 HTTP 状态、业务错误码、request_id）。
+- 需要 Node.js >= 18（使用 `node:crypto` 和全局 `fetch`）。

package/VERSION

@@ -0,0 +1 @@
+0.1.1

package/dist/client.d.ts

@@ -0,0 +1,22 @@
+import { CustomersAPI } from "./customers.js";
+import { MerchantAPI } from "./merchant.js";
+import { TransactionsAPI } from "./transactions.js";
+import type { ClientOptions } from "./types.js";
+export declare class CoinClient {
+    /** @internal */ readonly _baseURL: URL;
+    /** @internal */ readonly _merchantNo: string;
+    /** @internal */ readonly _merchantSecret: string;
+    /** @internal */ readonly _fetch: typeof globalThis.fetch;
+    /** @internal */ readonly _timeout: number;
+    /** @internal */ readonly _now: () => Date;
+    /** @internal */ readonly _nonce: () => string;
+    /** @internal */ readonly _userAgent: string;
+    readonly customers: CustomersAPI;
+    readonly merchant: MerchantAPI;
+    readonly transactions: TransactionsAPI;
+    constructor(opts: ClientOptions);
+    /** @internal */
+    _do<T>(method: string, path: string, query?: Record<string, string>, payload?: unknown): Promise<T>;
+}
+export declare function signature(method: string, path: string, merchantNo: string, timestamp: string, nonce: string, body: Uint8Array, secret: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAYhD,qBAAa,UAAU;IACrB,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;IACxC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9C,gBAAgB,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAClD,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC1D,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC3C,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC3C,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC/C,gBAAgB,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE7C,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;gBAE3B,IAAI,EAAE,aAAa;IAgC/B,gBAAgB;IACV,GAAG,CAAC,CAAC,EACT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC;CAqFd;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAWR"}

package/dist/client.js

@@ -0,0 +1,152 @@
+import { createHmac, createHash, randomBytes } from "node:crypto";
+import { CoinAPIError } from "./error.js";
+import { CustomersAPI } from "./customers.js";
+import { MerchantAPI } from "./merchant.js";
+import { TransactionsAPI } from "./transactions.js";
+const SUCCESS_CODE = "SUCCESS";
+const MAX_RESPONSE_BODY_BYTES = 4 * 1024 * 1024;
+export class CoinClient {
+    /** @internal */ _baseURL;
+    /** @internal */ _merchantNo;
+    /** @internal */ _merchantSecret;
+    /** @internal */ _fetch;
+    /** @internal */ _timeout;
+    /** @internal */ _now;
+    /** @internal */ _nonce;
+    /** @internal */ _userAgent;
+    customers;
+    merchant;
+    transactions;
+    constructor(opts) {
+        const base = (opts.baseURL ?? "").trim();
+        if (!base)
+            throw new Error("base_url is required");
+        let parsed;
+        try {
+            parsed = new URL(base);
+        }
+        catch {
+            throw new Error(`parse base_url: invalid URL: ${base}`);
+        }
+        if (!parsed.protocol || !parsed.host) {
+            throw new Error("base_url must include scheme and host");
+        }
+        const merchantNo = (opts.merchantNo ?? "").trim();
+        if (!merchantNo)
+            throw new Error("merchant_no is required");
+        if (!(opts.merchantSecret ?? "").trim())
+            throw new Error("merchant_secret is required");
+        this._baseURL = parsed;
+        this._merchantNo = merchantNo;
+        this._merchantSecret = opts.merchantSecret;
+        this._fetch = opts.fetch ?? globalThis.fetch;
+        this._timeout = opts.timeout && opts.timeout > 0 ? opts.timeout : 10_000;
+        this._now = opts.now ?? (() => new Date());
+        this._nonce = opts.nonceGenerator ?? (() => randomBytes(16).toString("hex"));
+        this._userAgent = (opts.userAgent ?? "").trim();
+        this.customers = new CustomersAPI(this);
+        this.merchant = new MerchantAPI(this);
+        this.transactions = new TransactionsAPI(this);
+    }
+    /** @internal */
+    async _do(method, path, query, payload) {
+        if (!path || path[0] !== "/") {
+            throw new Error("path must start with /");
+        }
+        const body = payload != null ? JSON.stringify(payload) : "";
+        const bodyBytes = new TextEncoder().encode(body);
+        const fullPath = joinURLPath(this._baseURL.pathname, path);
+        const url = new URL(fullPath, this._baseURL);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                url.searchParams.set(k, v);
+            }
+        }
+        const timestamp = String(this._now().getTime());
+        const nonce = this._nonce().trim();
+        if (!nonce)
+            throw new Error("nonce generator returned empty value");
+        const sig = signature(method, fullPath, this._merchantNo, timestamp, nonce, bodyBytes, this._merchantSecret);
+        const headers = {
+            "X-Merchant-No": this._merchantNo,
+            "X-Timestamp": timestamp,
+            "X-Nonce": nonce,
+            "X-Signature": sig,
+        };
+        if (payload != null) {
+            headers["Content-Type"] = "application/json";
+        }
+        if (this._userAgent) {
+            headers["User-Agent"] = this._userAgent;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this._timeout);
+        let resp;
+        try {
+            resp = await this._fetch(url.toString(), {
+                method: method.toUpperCase(),
+                headers,
+                body: payload != null ? body : undefined,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const respBody = await resp.text();
+        if (new TextEncoder().encode(respBody).byteLength > MAX_RESPONSE_BODY_BYTES) {
+            throw new CoinAPIError({
+                httpStatus: resp.status,
+                code: "RESPONSE_TOO_LARGE",
+                message: `response body exceeds ${MAX_RESPONSE_BODY_BYTES} bytes`,
+                rawBody: respBody.slice(0, MAX_RESPONSE_BODY_BYTES),
+            });
+        }
+        let env;
+        try {
+            env = JSON.parse(respBody);
+        }
+        catch {
+            throw new CoinAPIError({
+                httpStatus: resp.status,
+                code: "INVALID_RESPONSE",
+                message: respBody,
+                rawBody: respBody,
+            });
+        }
+        if (!env.code)
+            env.code = "INVALID_RESPONSE";
+        if (env.code !== SUCCESS_CODE || resp.status >= 400) {
+            throw new CoinAPIError({
+                httpStatus: resp.status,
+                code: env.code,
+                message: env.message,
+                requestId: env.request_id,
+                rawBody: respBody,
+            });
+        }
+        return (env.data ?? null);
+    }
+}
+export function signature(method, path, merchantNo, timestamp, nonce, body, secret) {
+    const bodyHash = createHash("sha256").update(body).digest("hex");
+    const signingString = [
+        method.toUpperCase().trim(),
+        path,
+        merchantNo,
+        timestamp,
+        nonce,
+        bodyHash,
+    ].join("\n");
+    return createHmac("sha256", secret).update(signingString).digest("hex");
+}
+function joinURLPath(basePath, p) {
+    let left = (basePath ?? "").trim().replace(/\/+$/, "");
+    const right = (p ?? "").trim().replace(/^\/+/, "");
+    if (!left)
+        return "/" + right;
+    if (!left.startsWith("/"))
+        left = "/" + left;
+    return left + "/" + right;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/customers.d.ts

@@ -0,0 +1,10 @@
+import type { CoinClient } from "./client.js";
+import type { CustomerBalance } from "./types.js";
+export declare class CustomersAPI {
+    /** @internal */
+    private readonly client;
+    /** @internal */
+    constructor(client: CoinClient);
+    getBalance(outUserID: string): Promise<CustomerBalance>;
+}
+//# sourceMappingURL=customers.d.ts.map

package/dist/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../src/customers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,YAAY;IACvB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAEpC,gBAAgB;gBACJ,MAAM,EAAE,UAAU;IAIxB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAS9D"}

package/dist/customers.js

@@ -0,0 +1,15 @@
+export class CustomersAPI {
+    /** @internal */
+    client;
+    /** @internal */
+    constructor(client) {
+        this.client = client;
+    }
+    async getBalance(outUserID) {
+        outUserID = (outUserID ?? "").trim();
+        if (!outUserID)
+            throw new Error("out_user_id is required");
+        return this.client._do("GET", "/api/v1/customers/balance", { out_user_id: outUserID });
+    }
+}
+//# sourceMappingURL=customers.js.map

package/dist/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../src/customers.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACvB,gBAAgB;IACC,MAAM,CAAa;IAEpC,gBAAgB;IAChB,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,SAAS,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACpB,KAAK,EACL,2BAA2B,EAC3B,EAAE,WAAW,EAAE,SAAS,EAAE,CAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/error.d.ts

@@ -0,0 +1,14 @@
+export declare class CoinAPIError extends Error {
+    readonly httpStatus: number;
+    readonly code: string;
+    readonly requestId: string;
+    readonly rawBody: string;
+    constructor(opts: {
+        httpStatus: number;
+        code: string;
+        message: string;
+        requestId?: string;
+        rawBody?: string;
+    });
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAYF"}

package/dist/error.js

@@ -0,0 +1,19 @@
+export class CoinAPIError extends Error {
+    httpStatus;
+    code;
+    requestId;
+    rawBody;
+    constructor(opts) {
+        const parts = [`api error: http=${opts.httpStatus} code=${opts.code} message=${opts.message}`];
+        if (opts.requestId) {
+            parts.push(`request_id=${opts.requestId}`);
+        }
+        super(parts.join(" "));
+        this.name = "CoinAPIError";
+        this.httpStatus = opts.httpStatus;
+        this.code = opts.code;
+        this.requestId = opts.requestId ?? "";
+        this.rawBody = opts.rawBody ?? "";
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,UAAU,CAAS;IACnB,IAAI,CAAS;IACb,SAAS,CAAS;IAClB,OAAO,CAAS;IAEzB,YAAY,IAMX;QACC,MAAM,KAAK,GAAG,CAAC,mBAAmB,IAAI,CAAC,UAAU,SAAS,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { CoinClient, signature } from "./client.js";
+export { CustomersAPI } from "./customers.js";
+export { CoinAPIError } from "./error.js";
+export { MerchantAPI } from "./merchant.js";
+export { TransactionsAPI } from "./transactions.js";
+export type { ClientOptions, CreditRequest, CustomerBalance, DebitRequest, TransferRequest, RefundRequest, ListTransactionsRequest, TxnSubmitResponse, Txn, ListTransactionsResponse, MerchantProfile, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,GAAG,EACH,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { CoinClient, signature } from "./client.js";
+export { CustomersAPI } from "./customers.js";
+export { CoinAPIError } from "./error.js";
+export { MerchantAPI } from "./merchant.js";
+export { TransactionsAPI } from "./transactions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/merchant.d.ts

@@ -0,0 +1,10 @@
+import type { CoinClient } from "./client.js";
+import type { MerchantProfile } from "./types.js";
+export declare class MerchantAPI {
+    /** @internal */
+    private readonly client;
+    /** @internal */
+    constructor(client: CoinClient);
+    me(): Promise<MerchantProfile>;
+}
+//# sourceMappingURL=merchant.d.ts.map

package/dist/merchant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchant.d.ts","sourceRoot":"","sources":["../src/merchant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,WAAW;IACtB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAEpC,gBAAgB;gBACJ,MAAM,EAAE,UAAU;IAIxB,EAAE,IAAI,OAAO,CAAC,eAAe,CAAC;CAGrC"}

package/dist/merchant.js

@@ -0,0 +1,12 @@
+export class MerchantAPI {
+    /** @internal */
+    client;
+    /** @internal */
+    constructor(client) {
+        this.client = client;
+    }
+    async me() {
+        return this.client._do("GET", "/api/v1/merchants/me");
+    }
+}
+//# sourceMappingURL=merchant.js.map

package/dist/merchant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchant.js","sourceRoot":"","sources":["../src/merchant.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,WAAW;IACtB,gBAAgB;IACC,MAAM,CAAa;IAEpC,gBAAgB;IAChB,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,EAAE;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAkB,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/transactions.d.ts

@@ -0,0 +1,16 @@
+import type { CoinClient } from "./client.js";
+import type { CreditRequest, DebitRequest, TransferRequest, RefundRequest, ListTransactionsRequest, TxnSubmitResponse, Txn, ListTransactionsResponse } from "./types.js";
+export declare class TransactionsAPI {
+    /** @internal */
+    private readonly client;
+    /** @internal */
+    constructor(client: CoinClient);
+    credit(req: CreditRequest): Promise<TxnSubmitResponse>;
+    debit(req: DebitRequest): Promise<TxnSubmitResponse>;
+    transfer(req: TransferRequest): Promise<TxnSubmitResponse>;
+    refund(req: RefundRequest): Promise<TxnSubmitResponse>;
+    getByTxnNo(txnNo: string): Promise<Txn>;
+    getByOutTradeNo(outTradeNo: string): Promise<Txn>;
+    list(req: ListTransactionsRequest): Promise<ListTransactionsResponse>;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,GAAG,EACH,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAIpB,qBAAa,eAAe;IAC1B,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAEpC,gBAAgB;gBACJ,MAAM,EAAE,UAAU;IAIxB,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWtD,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQpD,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc1D,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQtD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMvC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMjD,IAAI,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAiB5E"}

package/dist/transactions.js

@@ -0,0 +1,89 @@
+const OUT_TRADE_NO_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+export class TransactionsAPI {
+    /** @internal */
+    client;
+    /** @internal */
+    constructor(client) {
+        this.client = client;
+    }
+    async credit(req) {
+        req = { ...req, out_trade_no: validateOutTradeNoAndAmount(req.out_trade_no, req.amount) };
+        if (!(req.credit_account_no ?? "").trim() && !(req.user_id ?? "").trim()) {
+            throw new Error("credit_account_no or user_id is required");
+        }
+        if ((req.expire_in_days ?? 0) < 0) {
+            throw new Error("expire_in_days must be >= 0");
+        }
+        return this.client._do("POST", "/api/v1/transactions/credit", undefined, req);
+    }
+    async debit(req) {
+        req = { ...req, out_trade_no: validateOutTradeNoAndAmount(req.out_trade_no, req.amount) };
+        if (!(req.debit_account_no ?? "").trim() && !(req.debit_out_user_id ?? "").trim()) {
+            throw new Error("debit_account_no or debit_out_user_id is required");
+        }
+        return this.client._do("POST", "/api/v1/transactions/debit", undefined, req);
+    }
+    async transfer(req) {
+        req = { ...req, out_trade_no: validateOutTradeNoAndAmount(req.out_trade_no, req.amount) };
+        if (!(req.from_account_no ?? "").trim() && !(req.from_out_user_id ?? "").trim()) {
+            throw new Error("from_account_no or from_out_user_id is required");
+        }
+        if (!(req.to_account_no ?? "").trim() && !(req.to_out_user_id ?? "").trim()) {
+            throw new Error("to_account_no or to_out_user_id is required");
+        }
+        if ((req.to_expire_in_days ?? 0) < 0) {
+            throw new Error("to_expire_in_days must be >= 0");
+        }
+        return this.client._do("POST", "/api/v1/transactions/transfer", undefined, req);
+    }
+    async refund(req) {
+        req = { ...req, out_trade_no: validateOutTradeNoAndAmount(req.out_trade_no, req.amount) };
+        const refundOfTxnNo = (req.refund_of_txn_no ?? "").trim();
+        if (!refundOfTxnNo)
+            throw new Error("refund_of_txn_no is required");
+        req = { ...req, refund_of_txn_no: refundOfTxnNo };
+        return this.client._do("POST", "/api/v1/transactions/refund", undefined, req);
+    }
+    async getByTxnNo(txnNo) {
+        txnNo = (txnNo ?? "").trim();
+        if (!txnNo)
+            throw new Error("txn_no is required");
+        return this.client._do("GET", `/api/v1/transactions/${encodeURIComponent(txnNo)}`);
+    }
+    async getByOutTradeNo(outTradeNo) {
+        outTradeNo = (outTradeNo ?? "").trim();
+        if (!outTradeNo)
+            throw new Error("out_trade_no is required");
+        return this.client._do("GET", `/api/v1/transactions/by-out-trade-no/${encodeURIComponent(outTradeNo)}`);
+    }
+    async list(req) {
+        const query = {};
+        if (req.startTime)
+            query.start_time = req.startTime.toISOString();
+        if (req.endTime)
+            query.end_time = req.endTime.toISOString();
+        if ((req.status ?? "").trim())
+            query.status = req.status.trim().toUpperCase();
+        if ((req.transferScene ?? "").trim())
+            query.transfer_scene = req.transferScene.trim().toUpperCase();
+        if ((req.outUserID ?? "").trim())
+            query.out_user_id = req.outUserID.trim();
+        if (req.pageSize && req.pageSize > 0)
+            query.page_size = String(req.pageSize);
+        if ((req.pageToken ?? "").trim())
+            query.page_token = req.pageToken.trim();
+        const resp = await this.client._do("GET", "/api/v1/transactions", Object.keys(query).length > 0 ? query : undefined);
+        return { ...resp, items: resp.items ?? [] };
+    }
+}
+function validateOutTradeNoAndAmount(outTradeNo, amount) {
+    const trimmed = (outTradeNo ?? "").trim();
+    if (!trimmed)
+        throw new Error("out_trade_no is required");
+    if (!OUT_TRADE_NO_PATTERN.test(trimmed))
+        throw new Error("invalid out_trade_no");
+    if (!amount || amount <= 0)
+        throw new Error("amount must be > 0");
+    return trimmed;
+}
+//# sourceMappingURL=transactions.js.map

package/dist/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../src/transactions.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+export interface ClientOptions {
+    baseURL: string;
+    merchantNo: string;
+    merchantSecret: string;
+    timeout?: number;
+    fetch?: typeof globalThis.fetch;
+    userAgent?: string;
+    /** Injected for testing. Returns current UTC time. */
+    now?: () => Date;
+    /** Injected for testing. Returns a nonce string. */
+    nonceGenerator?: () => string;
+}
+export interface CreditRequest {
+    out_trade_no: string;
+    debit_account_no?: string;
+    credit_account_no?: string;
+    user_id?: string;
+    expire_in_days?: number;
+    amount: number;
+}
+export interface DebitRequest {
+    out_trade_no: string;
+    biz_type?: string;
+    transfer_scene?: string;
+    debit_account_no?: string;
+    debit_out_user_id?: string;
+    credit_account_no?: string;
+    credit_out_user_id?: string;
+    amount: number;
+}
+export interface TransferRequest {
+    out_trade_no: string;
+    biz_type?: string;
+    transfer_scene?: string;
+    from_account_no?: string;
+    from_out_user_id?: string;
+    to_account_no?: string;
+    to_out_user_id?: string;
+    to_expire_in_days?: number;
+    amount: number;
+}
+export interface RefundRequest {
+    out_trade_no: string;
+    biz_type?: string;
+    refund_of_txn_no: string;
+    amount: number;
+}
+export interface ListTransactionsRequest {
+    startTime?: Date;
+    endTime?: Date;
+    status?: string;
+    transferScene?: string;
+    outUserID?: string;
+    pageSize?: number;
+    pageToken?: string;
+}
+export interface TxnSubmitResponse {
+    txn_no: string;
+    status: string;
+}
+export interface Txn {
+    txn_no: string;
+    out_trade_no: string;
+    transfer_scene: string;
+    status: string;
+    amount: number;
+    refundable_amount: number;
+    debit_account_no: string;
+    credit_account_no: string;
+    error_code: string;
+    error_msg: string;
+    created_at: string;
+}
+export interface ListTransactionsResponse {
+    items: Txn[];
+    next_page_token: string;
+}
+export interface CustomerBalance {
+    out_user_id: string;
+    account_no: string;
+    balance: number;
+    book_enabled: boolean;
+}
+export interface MerchantProfile {
+    merchant_no: string;
+    name: string;
+    status: string;
+    budget_account_no: string;
+    receivable_account_no: string;
+    secret_version: number;
+    auto_create_account_on_customer_create: boolean;
+    auto_create_customer_on_credit: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@xmz-ai/coin",
+  "version": "0.1.1",
+  "description": "Coin merchant SDK for Node.js / TypeScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "VERSION",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xmz-ai/coin.git",
+    "directory": "sdk/ts/coin"
+  },
+  "license": "MIT"
+}