@vobs/payment 0.3.0 → 1.2.0

package/dist/wechat/payment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/wechat/response.ts","../../src/wechat/payment.ts"],"names":["Formatter","Rsa"],"mappings":"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","file":"payment.cjs","sourcesContent":["/**\n * 微信支付 APIv3 错误归一化。\n *\n * v3 接口没有\"业务体 code\"约定：HTTP 2xx 即成功，失败以\n * 非 2xx 状态码 + JSON body {code, message} 表达（axios 会抛错）。\n * 本模块把 axios 错误统一转换为 WechatApiError。\n */\nexport class WechatApiError extends Error {\n  /** HTTP 状态码（网络层错误时为 undefined） */\n  readonly status?: number\n  /** 错误码，如 PARAM_ERROR / RESOURCE_NOT_EXISTS / NETWORK_ERROR */\n  readonly code: string\n\n  constructor(message: string, status: number | undefined, code: string) {\n    super(message)\n    this.name = 'WechatApiError'\n    this.status = status\n    this.code = code\n  }\n}\n\n/** 将任意请求异常归一化为 WechatApiError */\nexport function toWechatApiError(error: unknown): WechatApiError {\n  if (error instanceof WechatApiError) return error\n  const axiosError = error as {\n    response?: { status?: number; data?: { code?: string; message?: string } }\n    code?: string\n    message?: string\n  }\n  const status = axiosError?.response?.status\n  const bizCode = axiosError?.response?.data?.code\n  const bizMessage = axiosError?.response?.data?.message\n  if (status !== undefined) {\n    return new WechatApiError(\n      `微信支付接口调用失败: ${bizMessage ?? axiosError?.message ?? '未知错误'} (${status}${bizCode ? `, ${bizCode}` : ''})`,\n      status,\n      bizCode ?? String(status)\n    )\n  }\n  return new WechatApiError(\n    `微信支付请求失败: ${axiosError?.message ?? '未知错误'}${axiosError?.code ? ` (${axiosError.code})` : ''}`,\n    undefined,\n    axiosError?.code ?? 'NETWORK_ERROR'\n  )\n}\n\n/** 包装请求 promise：失败时抛出 WechatApiError */\nexport async function unwrapV3<T>(promise: PromiseLike<T>): Promise<T> {\n  try {\n    return await promise\n  } catch (error) {\n    throw toWechatApiError(error)\n  }\n}\n","import { Formatter, Rsa } from 'wechatpay-axios-plugin'\nimport type { WechatClient } from './client'\nimport { unwrapV3 } from './response'\nimport type {\n  WechatAppPayResult,\n  WechatH5PayParams,\n  WechatH5PayResult,\n  WechatJsapiPayResult,\n  WechatNativePayResult,\n  WechatPayParams,\n  WechatQueryParams,\n  WechatQueryResult,\n  WechatTradeState\n} from './types'\n\n/**\n * 微信支付下单（APIv3）\n *\n * 覆盖四种收款场景：\n * - jsapiPay：公众号网页 / 小程序（wx.requestPayment）\n * - appPay：APP 拉起微信支付\n * - nativePay：PC 扫码支付（返回二维码链接）\n * - h5Pay：微信外浏览器 H5 支付（返回收银台跳转链接）\n *\n * ⚠️ 支付结果以异步通知或 query() 为准。\n */\nexport function createPayment(client: WechatClient) {\n  return {\n    /**\n     * 公众号 / 小程序支付下单（POST /v3/pay/transactions/jsapi）\n     * @param params 下单参数，openid 必填\n     * @returns 调起 wx.requestPayment 所需的签名参数\n     */\n    async jsapiPay(params: WechatPayParams & { openid: string }): Promise<WechatJsapiPayResult> {\n      const { data } = await postTransaction(client, 'jsapi', params)\n      return buildInvokeParams(client, data.prepay_id ?? '')\n    },\n\n    /**\n     * APP 支付下单（POST /v3/pay/transactions/app）\n     * @param params 下单参数\n     * @returns 传给客户端 SDK 调起微信支付的签名参数\n     */\n    async appPay(params: WechatPayParams): Promise<WechatAppPayResult> {\n      const { data } = await postTransaction(client, 'app', params)\n      return buildInvokeParams(client, data.prepay_id ?? '')\n    },\n\n    /**\n     * Native 扫码支付下单（POST /v3/pay/transactions/native）\n     * @returns 二维码链接（前端渲染二维码，用户扫码支付）\n     */\n    async nativePay(params: WechatPayParams): Promise<WechatNativePayResult> {\n      const { data } = await postTransaction(client, 'native', params)\n      if (!data.code_url) {\n        throw new Error('WechatClient: 下单响应缺少 code_url')\n      }\n      return { codeUrl: data.code_url }\n    },\n\n    /**\n     * H5 支付下单（POST /v3/pay/transactions/h5）\n     * @param params 下单参数，payerClientIp 必填\n     * @returns 收银台跳转链接（302 重定向即可拉起微信支付）\n     */\n    async h5Pay(params: WechatH5PayParams): Promise<WechatH5PayResult> {\n      const body = buildTransactionBody(client, params)\n      body.scene_info = {\n        payer_client_ip: params.payerClientIp,\n        ...(params.sceneInfo?.deviceType ? { device_type: params.sceneInfo.deviceType } : {})\n      }\n      const { data } = await unwrapV3(client.sdk.v3.pay.transactions.h5.post(body))\n      return { h5Url: data.h5_url }\n    },\n\n    /**\n     * 交易查询（GET /v3/pay/transactions/out-trade-no/{no} 或 .../id/{id}）\n     * @throws {WechatApiError} 订单不存在等失败（RESOURCE_NOT_EXISTS）\n     */\n    async query(params: WechatQueryParams): Promise<WechatQueryResult> {\n      const mchid = client.config.mchid\n      const response = params.transactionId\n        ? await unwrapV3(\n            client.sdk.client.request(\n              `/v3/pay/transactions/id/${encodeURIComponent(params.transactionId)}`,\n              'GET',\n              undefined,\n              { params: { mchid } }\n            )\n          )\n        : await unwrapV3(\n            client.sdk.client.request(\n              `/v3/pay/transactions/out-trade-no/${encodeURIComponent(params.outTradeNo ?? '')}`,\n              'GET',\n              undefined,\n              { params: { mchid } }\n            )\n          )\n      return mapTransaction((response as { data: Record<string, any> }).data)\n    }\n  }\n}\n\ntype TransactionChain = 'jsapi' | 'app' | 'native'\n\nasync function postTransaction(\n  client: WechatClient,\n  chain: TransactionChain,\n  params: WechatPayParams\n): Promise<{ data: { prepay_id?: string; code_url?: string } }> {\n  const body = buildTransactionBody(client, params)\n  return unwrapV3(client.sdk.v3.pay.transactions[chain].post(body))\n}\n\n/** 构造下单请求体（camelCase -> snake_case，注入 appid/mchid/notify_url） */\nfunction buildTransactionBody(\n  client: WechatClient,\n  params: WechatPayParams\n): Record<string, any> {\n  const body: Record<string, any> = {\n    appid: client.config.appid,\n    mchid: client.config.mchid,\n    description: params.description,\n    out_trade_no: params.outTradeNo,\n    time_expire: params.timeExpire,\n    attach: params.attach,\n    goods_tag: params.goodsTag,\n    notify_url: client.config.notifyUrl,\n    amount: {\n      total: params.amount.total,\n      currency: params.amount.currency ?? 'CNY'\n    }\n  }\n  if (params.openid) {\n    body.payer = { openid: params.openid }\n  }\n  // 移除 undefined 字段\n  for (const key of Object.keys(body)) {\n    if (body[key] === undefined) delete body[key]\n  }\n  return body\n}\n\n/**\n * 生成拉起支付的签名参数。\n * 签名串：appid\\ntimeStamp\\nnonceStr\\nprepay_id=xxx\\n（SHA256withRSA，商户 API 私钥）\n */\nfunction buildInvokeParams(client: WechatClient, prepayId: string): WechatJsapiPayResult {\n  if (!prepayId) {\n    throw new Error('WechatClient: 下单响应缺少 prepay_id')\n  }\n  const appId = client.config.appid\n  const timeStamp = `${Formatter.timestamp()}`\n  const nonceStr = Formatter.nonce(32)\n  const pkg = `prepay_id=${prepayId}`\n  const message = `${appId}\\n${timeStamp}\\n${nonceStr}\\n${pkg}\\n`\n  const paySign = Rsa.sign(message, client.config.options.privateKey)\n  return { appId, timeStamp, nonceStr, package: pkg, signType: 'RSA', paySign }\n}\n\n/** snake_case 响应映射 */\nfunction mapTransaction(data: Record<string, any>): WechatQueryResult {\n  return {\n    appid: data.appid,\n    mchid: data.mchid,\n    outTradeNo: data.out_trade_no,\n    transactionId: data.transaction_id,\n    tradeType: data.trade_type,\n    tradeState: data.trade_state as WechatTradeState,\n    tradeStateDesc: data.trade_state_desc,\n    bankType: data.bank_type,\n    attach: data.attach,\n    successTime: data.success_time,\n    total: data.amount?.total,\n    payerTotal: data.amount?.payer_total\n  }\n}\n"]}

package/dist/wechat/payment.d.cts

@@ -0,0 +1,50 @@
+import { WechatClient } from './client.cjs';
+import { WechatPayParams, WechatJsapiPayResult, WechatAppPayResult, WechatNativePayResult, WechatH5PayParams, WechatH5PayResult, WechatQueryParams, WechatQueryResult } from './types.cjs';
+import 'wechatpay-axios-plugin';
+import './config.cjs';
+
+/**
+ * 微信支付下单（APIv3）
+ *
+ * 覆盖四种收款场景：
+ * - jsapiPay：公众号网页 / 小程序（wx.requestPayment）
+ * - appPay：APP 拉起微信支付
+ * - nativePay：PC 扫码支付（返回二维码链接）
+ * - h5Pay：微信外浏览器 H5 支付（返回收银台跳转链接）
+ *
+ * ⚠️ 支付结果以异步通知或 query() 为准。
+ */
+declare function createPayment(client: WechatClient): {
+    /**
+     * 公众号 / 小程序支付下单（POST /v3/pay/transactions/jsapi）
+     * @param params 下单参数，openid 必填
+     * @returns 调起 wx.requestPayment 所需的签名参数
+     */
+    jsapiPay(params: WechatPayParams & {
+        openid: string;
+    }): Promise<WechatJsapiPayResult>;
+    /**
+     * APP 支付下单（POST /v3/pay/transactions/app）
+     * @param params 下单参数
+     * @returns 传给客户端 SDK 调起微信支付的签名参数
+     */
+    appPay(params: WechatPayParams): Promise<WechatAppPayResult>;
+    /**
+     * Native 扫码支付下单（POST /v3/pay/transactions/native）
+     * @returns 二维码链接（前端渲染二维码，用户扫码支付）
+     */
+    nativePay(params: WechatPayParams): Promise<WechatNativePayResult>;
+    /**
+     * H5 支付下单（POST /v3/pay/transactions/h5）
+     * @param params 下单参数，payerClientIp 必填
+     * @returns 收银台跳转链接（302 重定向即可拉起微信支付）
+     */
+    h5Pay(params: WechatH5PayParams): Promise<WechatH5PayResult>;
+    /**
+     * 交易查询（GET /v3/pay/transactions/out-trade-no/{no} 或 .../id/{id}）
+     * @throws {WechatApiError} 订单不存在等失败（RESOURCE_NOT_EXISTS）
+     */
+    query(params: WechatQueryParams): Promise<WechatQueryResult>;
+};
+
+export { createPayment };

package/dist/wechat/payment.d.ts

@@ -0,0 +1,50 @@
+import { WechatClient } from './client.js';
+import { WechatPayParams, WechatJsapiPayResult, WechatAppPayResult, WechatNativePayResult, WechatH5PayParams, WechatH5PayResult, WechatQueryParams, WechatQueryResult } from './types.js';
+import 'wechatpay-axios-plugin';
+import './config.js';
+
+/**
+ * 微信支付下单（APIv3）
+ *
+ * 覆盖四种收款场景：
+ * - jsapiPay：公众号网页 / 小程序（wx.requestPayment）
+ * - appPay：APP 拉起微信支付
+ * - nativePay：PC 扫码支付（返回二维码链接）
+ * - h5Pay：微信外浏览器 H5 支付（返回收银台跳转链接）
+ *
+ * ⚠️ 支付结果以异步通知或 query() 为准。
+ */
+declare function createPayment(client: WechatClient): {
+    /**
+     * 公众号 / 小程序支付下单（POST /v3/pay/transactions/jsapi）
+     * @param params 下单参数，openid 必填
+     * @returns 调起 wx.requestPayment 所需的签名参数
+     */
+    jsapiPay(params: WechatPayParams & {
+        openid: string;
+    }): Promise<WechatJsapiPayResult>;
+    /**
+     * APP 支付下单（POST /v3/pay/transactions/app）
+     * @param params 下单参数
+     * @returns 传给客户端 SDK 调起微信支付的签名参数
+     */
+    appPay(params: WechatPayParams): Promise<WechatAppPayResult>;
+    /**
+     * Native 扫码支付下单（POST /v3/pay/transactions/native）
+     * @returns 二维码链接（前端渲染二维码，用户扫码支付）
+     */
+    nativePay(params: WechatPayParams): Promise<WechatNativePayResult>;
+    /**
+     * H5 支付下单（POST /v3/pay/transactions/h5）
+     * @param params 下单参数，payerClientIp 必填
+     * @returns 收银台跳转链接（302 重定向即可拉起微信支付）
+     */
+    h5Pay(params: WechatH5PayParams): Promise<WechatH5PayResult>;
+    /**
+     * 交易查询（GET /v3/pay/transactions/out-trade-no/{no} 或 .../id/{id}）
+     * @throws {WechatApiError} 订单不存在等失败（RESOURCE_NOT_EXISTS）
+     */
+    query(params: WechatQueryParams): Promise<WechatQueryResult>;
+};
+
+export { createPayment };

package/dist/wechat/payment.js

@@ -0,0 +1,184 @@
+import { Formatter, Rsa } from 'wechatpay-axios-plugin';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// packages/payment/src/wechat/response.ts
+var _WechatApiError = class _WechatApiError extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.name = "WechatApiError";
+    this.status = status;
+    this.code = code;
+  }
+};
+__name(_WechatApiError, "WechatApiError");
+var WechatApiError = _WechatApiError;
+function toWechatApiError(error) {
+  if (error instanceof WechatApiError) return error;
+  const axiosError = error;
+  const status = axiosError?.response?.status;
+  const bizCode = axiosError?.response?.data?.code;
+  const bizMessage = axiosError?.response?.data?.message;
+  if (status !== void 0) {
+    return new WechatApiError(
+      `\u5FAE\u4FE1\u652F\u4ED8\u63A5\u53E3\u8C03\u7528\u5931\u8D25: ${bizMessage ?? axiosError?.message ?? "\u672A\u77E5\u9519\u8BEF"} (${status}${bizCode ? `, ${bizCode}` : ""})`,
+      status,
+      bizCode ?? String(status)
+    );
+  }
+  return new WechatApiError(
+    `\u5FAE\u4FE1\u652F\u4ED8\u8BF7\u6C42\u5931\u8D25: ${axiosError?.message ?? "\u672A\u77E5\u9519\u8BEF"}${axiosError?.code ? ` (${axiosError.code})` : ""}`,
+    void 0,
+    axiosError?.code ?? "NETWORK_ERROR"
+  );
+}
+__name(toWechatApiError, "toWechatApiError");
+async function unwrapV3(promise) {
+  try {
+    return await promise;
+  } catch (error) {
+    throw toWechatApiError(error);
+  }
+}
+__name(unwrapV3, "unwrapV3");
+
+// packages/payment/src/wechat/payment.ts
+function createPayment(client) {
+  return {
+    /**
+     * 公众号 / 小程序支付下单（POST /v3/pay/transactions/jsapi）
+     * @param params 下单参数，openid 必填
+     * @returns 调起 wx.requestPayment 所需的签名参数
+     */
+    async jsapiPay(params) {
+      const { data } = await postTransaction(client, "jsapi", params);
+      return buildInvokeParams(client, data.prepay_id ?? "");
+    },
+    /**
+     * APP 支付下单（POST /v3/pay/transactions/app）
+     * @param params 下单参数
+     * @returns 传给客户端 SDK 调起微信支付的签名参数
+     */
+    async appPay(params) {
+      const { data } = await postTransaction(client, "app", params);
+      return buildInvokeParams(client, data.prepay_id ?? "");
+    },
+    /**
+     * Native 扫码支付下单（POST /v3/pay/transactions/native）
+     * @returns 二维码链接（前端渲染二维码，用户扫码支付）
+     */
+    async nativePay(params) {
+      const { data } = await postTransaction(client, "native", params);
+      if (!data.code_url) {
+        throw new Error("WechatClient: \u4E0B\u5355\u54CD\u5E94\u7F3A\u5C11 code_url");
+      }
+      return { codeUrl: data.code_url };
+    },
+    /**
+     * H5 支付下单（POST /v3/pay/transactions/h5）
+     * @param params 下单参数，payerClientIp 必填
+     * @returns 收银台跳转链接（302 重定向即可拉起微信支付）
+     */
+    async h5Pay(params) {
+      const body = buildTransactionBody(client, params);
+      body.scene_info = {
+        payer_client_ip: params.payerClientIp,
+        ...params.sceneInfo?.deviceType ? { device_type: params.sceneInfo.deviceType } : {}
+      };
+      const { data } = await unwrapV3(client.sdk.v3.pay.transactions.h5.post(body));
+      return { h5Url: data.h5_url };
+    },
+    /**
+     * 交易查询（GET /v3/pay/transactions/out-trade-no/{no} 或 .../id/{id}）
+     * @throws {WechatApiError} 订单不存在等失败（RESOURCE_NOT_EXISTS）
+     */
+    async query(params) {
+      const mchid = client.config.mchid;
+      const response = params.transactionId ? await unwrapV3(
+        client.sdk.client.request(
+          `/v3/pay/transactions/id/${encodeURIComponent(params.transactionId)}`,
+          "GET",
+          void 0,
+          { params: { mchid } }
+        )
+      ) : await unwrapV3(
+        client.sdk.client.request(
+          `/v3/pay/transactions/out-trade-no/${encodeURIComponent(params.outTradeNo ?? "")}`,
+          "GET",
+          void 0,
+          { params: { mchid } }
+        )
+      );
+      return mapTransaction(response.data);
+    }
+  };
+}
+__name(createPayment, "createPayment");
+async function postTransaction(client, chain, params) {
+  const body = buildTransactionBody(client, params);
+  return unwrapV3(client.sdk.v3.pay.transactions[chain].post(body));
+}
+__name(postTransaction, "postTransaction");
+function buildTransactionBody(client, params) {
+  const body = {
+    appid: client.config.appid,
+    mchid: client.config.mchid,
+    description: params.description,
+    out_trade_no: params.outTradeNo,
+    time_expire: params.timeExpire,
+    attach: params.attach,
+    goods_tag: params.goodsTag,
+    notify_url: client.config.notifyUrl,
+    amount: {
+      total: params.amount.total,
+      currency: params.amount.currency ?? "CNY"
+    }
+  };
+  if (params.openid) {
+    body.payer = { openid: params.openid };
+  }
+  for (const key of Object.keys(body)) {
+    if (body[key] === void 0) delete body[key];
+  }
+  return body;
+}
+__name(buildTransactionBody, "buildTransactionBody");
+function buildInvokeParams(client, prepayId) {
+  if (!prepayId) {
+    throw new Error("WechatClient: \u4E0B\u5355\u54CD\u5E94\u7F3A\u5C11 prepay_id");
+  }
+  const appId = client.config.appid;
+  const timeStamp = `${Formatter.timestamp()}`;
+  const nonceStr = Formatter.nonce(32);
+  const pkg = `prepay_id=${prepayId}`;
+  const message = `${appId}
+${timeStamp}
+${nonceStr}
+${pkg}
+`;
+  const paySign = Rsa.sign(message, client.config.options.privateKey);
+  return { appId, timeStamp, nonceStr, package: pkg, signType: "RSA", paySign };
+}
+__name(buildInvokeParams, "buildInvokeParams");
+function mapTransaction(data) {
+  return {
+    appid: data.appid,
+    mchid: data.mchid,
+    outTradeNo: data.out_trade_no,
+    transactionId: data.transaction_id,
+    tradeType: data.trade_type,
+    tradeState: data.trade_state,
+    tradeStateDesc: data.trade_state_desc,
+    bankType: data.bank_type,
+    attach: data.attach,
+    successTime: data.success_time,
+    total: data.amount?.total,
+    payerTotal: data.amount?.payer_total
+  };
+}
+__name(mapTransaction, "mapTransaction");
+
+export { createPayment };
+//# sourceMappingURL=payment.js.map
+//# sourceMappingURL=payment.js.map

package/dist/wechat/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/wechat/response.ts","../../src/wechat/payment.ts"],"names":[],"mappings":"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","file":"payment.js","sourcesContent":["/**\n * 微信支付 APIv3 错误归一化。\n *\n * v3 接口没有\"业务体 code\"约定：HTTP 2xx 即成功，失败以\n * 非 2xx 状态码 + JSON body {code, message} 表达（axios 会抛错）。\n * 本模块把 axios 错误统一转换为 WechatApiError。\n */\nexport class WechatApiError extends Error {\n  /** HTTP 状态码（网络层错误时为 undefined） */\n  readonly status?: number\n  /** 错误码，如 PARAM_ERROR / RESOURCE_NOT_EXISTS / NETWORK_ERROR */\n  readonly code: string\n\n  constructor(message: string, status: number | undefined, code: string) {\n    super(message)\n    this.name = 'WechatApiError'\n    this.status = status\n    this.code = code\n  }\n}\n\n/** 将任意请求异常归一化为 WechatApiError */\nexport function toWechatApiError(error: unknown): WechatApiError {\n  if (error instanceof WechatApiError) return error\n  const axiosError = error as {\n    response?: { status?: number; data?: { code?: string; message?: string } }\n    code?: string\n    message?: string\n  }\n  const status = axiosError?.response?.status\n  const bizCode = axiosError?.response?.data?.code\n  const bizMessage = axiosError?.response?.data?.message\n  if (status !== undefined) {\n    return new WechatApiError(\n      `微信支付接口调用失败: ${bizMessage ?? axiosError?.message ?? '未知错误'} (${status}${bizCode ? `, ${bizCode}` : ''})`,\n      status,\n      bizCode ?? String(status)\n    )\n  }\n  return new WechatApiError(\n    `微信支付请求失败: ${axiosError?.message ?? '未知错误'}${axiosError?.code ? ` (${axiosError.code})` : ''}`,\n    undefined,\n    axiosError?.code ?? 'NETWORK_ERROR'\n  )\n}\n\n/** 包装请求 promise：失败时抛出 WechatApiError */\nexport async function unwrapV3<T>(promise: PromiseLike<T>): Promise<T> {\n  try {\n    return await promise\n  } catch (error) {\n    throw toWechatApiError(error)\n  }\n}\n","import { Formatter, Rsa } from 'wechatpay-axios-plugin'\nimport type { WechatClient } from './client'\nimport { unwrapV3 } from './response'\nimport type {\n  WechatAppPayResult,\n  WechatH5PayParams,\n  WechatH5PayResult,\n  WechatJsapiPayResult,\n  WechatNativePayResult,\n  WechatPayParams,\n  WechatQueryParams,\n  WechatQueryResult,\n  WechatTradeState\n} from './types'\n\n/**\n * 微信支付下单（APIv3）\n *\n * 覆盖四种收款场景：\n * - jsapiPay：公众号网页 / 小程序（wx.requestPayment）\n * - appPay：APP 拉起微信支付\n * - nativePay：PC 扫码支付（返回二维码链接）\n * - h5Pay：微信外浏览器 H5 支付（返回收银台跳转链接）\n *\n * ⚠️ 支付结果以异步通知或 query() 为准。\n */\nexport function createPayment(client: WechatClient) {\n  return {\n    /**\n     * 公众号 / 小程序支付下单（POST /v3/pay/transactions/jsapi）\n     * @param params 下单参数，openid 必填\n     * @returns 调起 wx.requestPayment 所需的签名参数\n     */\n    async jsapiPay(params: WechatPayParams & { openid: string }): Promise<WechatJsapiPayResult> {\n      const { data } = await postTransaction(client, 'jsapi', params)\n      return buildInvokeParams(client, data.prepay_id ?? '')\n    },\n\n    /**\n     * APP 支付下单（POST /v3/pay/transactions/app）\n     * @param params 下单参数\n     * @returns 传给客户端 SDK 调起微信支付的签名参数\n     */\n    async appPay(params: WechatPayParams): Promise<WechatAppPayResult> {\n      const { data } = await postTransaction(client, 'app', params)\n      return buildInvokeParams(client, data.prepay_id ?? '')\n    },\n\n    /**\n     * Native 扫码支付下单（POST /v3/pay/transactions/native）\n     * @returns 二维码链接（前端渲染二维码，用户扫码支付）\n     */\n    async nativePay(params: WechatPayParams): Promise<WechatNativePayResult> {\n      const { data } = await postTransaction(client, 'native', params)\n      if (!data.code_url) {\n        throw new Error('WechatClient: 下单响应缺少 code_url')\n      }\n      return { codeUrl: data.code_url }\n    },\n\n    /**\n     * H5 支付下单（POST /v3/pay/transactions/h5）\n     * @param params 下单参数，payerClientIp 必填\n     * @returns 收银台跳转链接（302 重定向即可拉起微信支付）\n     */\n    async h5Pay(params: WechatH5PayParams): Promise<WechatH5PayResult> {\n      const body = buildTransactionBody(client, params)\n      body.scene_info = {\n        payer_client_ip: params.payerClientIp,\n        ...(params.sceneInfo?.deviceType ? { device_type: params.sceneInfo.deviceType } : {})\n      }\n      const { data } = await unwrapV3(client.sdk.v3.pay.transactions.h5.post(body))\n      return { h5Url: data.h5_url }\n    },\n\n    /**\n     * 交易查询（GET /v3/pay/transactions/out-trade-no/{no} 或 .../id/{id}）\n     * @throws {WechatApiError} 订单不存在等失败（RESOURCE_NOT_EXISTS）\n     */\n    async query(params: WechatQueryParams): Promise<WechatQueryResult> {\n      const mchid = client.config.mchid\n      const response = params.transactionId\n        ? await unwrapV3(\n            client.sdk.client.request(\n              `/v3/pay/transactions/id/${encodeURIComponent(params.transactionId)}`,\n              'GET',\n              undefined,\n              { params: { mchid } }\n            )\n          )\n        : await unwrapV3(\n            client.sdk.client.request(\n              `/v3/pay/transactions/out-trade-no/${encodeURIComponent(params.outTradeNo ?? '')}`,\n              'GET',\n              undefined,\n              { params: { mchid } }\n            )\n          )\n      return mapTransaction((response as { data: Record<string, any> }).data)\n    }\n  }\n}\n\ntype TransactionChain = 'jsapi' | 'app' | 'native'\n\nasync function postTransaction(\n  client: WechatClient,\n  chain: TransactionChain,\n  params: WechatPayParams\n): Promise<{ data: { prepay_id?: string; code_url?: string } }> {\n  const body = buildTransactionBody(client, params)\n  return unwrapV3(client.sdk.v3.pay.transactions[chain].post(body))\n}\n\n/** 构造下单请求体（camelCase -> snake_case，注入 appid/mchid/notify_url） */\nfunction buildTransactionBody(\n  client: WechatClient,\n  params: WechatPayParams\n): Record<string, any> {\n  const body: Record<string, any> = {\n    appid: client.config.appid,\n    mchid: client.config.mchid,\n    description: params.description,\n    out_trade_no: params.outTradeNo,\n    time_expire: params.timeExpire,\n    attach: params.attach,\n    goods_tag: params.goodsTag,\n    notify_url: client.config.notifyUrl,\n    amount: {\n      total: params.amount.total,\n      currency: params.amount.currency ?? 'CNY'\n    }\n  }\n  if (params.openid) {\n    body.payer = { openid: params.openid }\n  }\n  // 移除 undefined 字段\n  for (const key of Object.keys(body)) {\n    if (body[key] === undefined) delete body[key]\n  }\n  return body\n}\n\n/**\n * 生成拉起支付的签名参数。\n * 签名串：appid\\ntimeStamp\\nnonceStr\\nprepay_id=xxx\\n（SHA256withRSA，商户 API 私钥）\n */\nfunction buildInvokeParams(client: WechatClient, prepayId: string): WechatJsapiPayResult {\n  if (!prepayId) {\n    throw new Error('WechatClient: 下单响应缺少 prepay_id')\n  }\n  const appId = client.config.appid\n  const timeStamp = `${Formatter.timestamp()}`\n  const nonceStr = Formatter.nonce(32)\n  const pkg = `prepay_id=${prepayId}`\n  const message = `${appId}\\n${timeStamp}\\n${nonceStr}\\n${pkg}\\n`\n  const paySign = Rsa.sign(message, client.config.options.privateKey)\n  return { appId, timeStamp, nonceStr, package: pkg, signType: 'RSA', paySign }\n}\n\n/** snake_case 响应映射 */\nfunction mapTransaction(data: Record<string, any>): WechatQueryResult {\n  return {\n    appid: data.appid,\n    mchid: data.mchid,\n    outTradeNo: data.out_trade_no,\n    transactionId: data.transaction_id,\n    tradeType: data.trade_type,\n    tradeState: data.trade_state as WechatTradeState,\n    tradeStateDesc: data.trade_state_desc,\n    bankType: data.bank_type,\n    attach: data.attach,\n    successTime: data.success_time,\n    total: data.amount?.total,\n    payerTotal: data.amount?.payer_total\n  }\n}\n"]}

package/dist/wechat/plugin.cjs

@@ -0,0 +1,305 @@
+'use strict';
+
+var wechatpayAxiosPlugin = require('wechatpay-axios-plugin');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// packages/reactivity/src/debug.ts
+var activeDebugHooks = null;
+function hasDebugHooks() {
+  return activeDebugHooks !== null;
+}
+__name(hasDebugHooks, "hasDebugHooks");
+function invokeDebug(name, ...args) {
+  return;
+}
+__name(invokeDebug, "invokeDebug");
+
+// packages/reactivity/src/owner.ts
+var currentOwner = null;
+function getCurrentOwner() {
+  return currentOwner;
+}
+__name(getCurrentOwner, "getCurrentOwner");
+
+// packages/reactivity/src/scheduler.ts
+var _Scheduler = class _Scheduler {
+  constructor() {
+    this.dirtyEffects = /* @__PURE__ */ new Set();
+    this.lowPriorityEffects = /* @__PURE__ */ new Set();
+    // flush 不可重入（flushing 标志保证），缓冲数组可在轮次间安全复用，避免每轮分配。
+    this.normalBuffer = [];
+    this.lowBuffer = [];
+    this.flushing = false;
+    this.scheduled = false;
+    this.batchDepth = 0;
+  }
+  schedule(effect2) {
+    if (effect2.disposed) return;
+    this.dirtyEffects.add(effect2);
+    this.lowPriorityEffects.delete(effect2);
+    this.ensureScheduled();
+  }
+  /** Queue an effect behind normal updates while preserving deterministic order. */
+  scheduleLow(effect2) {
+    if (effect2.disposed) return;
+    if (!this.dirtyEffects.has(effect2)) this.lowPriorityEffects.add(effect2);
+    this.ensureScheduled();
+  }
+  ensureScheduled() {
+    if (this.batchDepth === 0 && !this.flushing && !this.scheduled) {
+      this.scheduled = true;
+      queueMicrotask(() => {
+        this.scheduled = false;
+        this.flush();
+      });
+    }
+  }
+  remove(effect2) {
+    this.dirtyEffects.delete(effect2);
+    this.lowPriorityEffects.delete(effect2);
+  }
+  batch(fn) {
+    this.batchDepth++;
+    try {
+      return fn();
+    } finally {
+      this.batchDepth--;
+      if (this.batchDepth === 0) this.flush();
+    }
+  }
+  flush() {
+    if (this.flushing || this.batchDepth > 0) return;
+    this.flushing = true;
+    let rounds = 0;
+    let firstError;
+    let hasError = false;
+    try {
+      while (this.dirtyEffects.size > 0 || this.lowPriorityEffects.size > 0) {
+        if (++rounds > 100) {
+          this.dirtyEffects.clear();
+          this.lowPriorityEffects.clear();
+          throw new Error("Vobs: \u54CD\u5E94\u5F0F\u66F4\u65B0\u8D85\u8FC7 100 \u8F6E\uFF0C\u53EF\u80FD\u5B58\u5728\u5FAA\u73AF\u4F9D\u8D56");
+        }
+        this.collectRunnable(this.dirtyEffects, this.normalBuffer);
+        this.collectRunnable(this.lowPriorityEffects, this.lowBuffer);
+        sortEffects(this.normalBuffer);
+        sortEffects(this.lowBuffer);
+        for (const effect2 of this.normalBuffer) {
+          try {
+            effect2.run();
+          } catch (error) {
+            if (!hasError) {
+              firstError = error;
+              hasError = true;
+            }
+          }
+        }
+        for (const effect2 of this.lowBuffer) {
+          try {
+            effect2.run();
+          } catch (error) {
+            if (!hasError) {
+              firstError = error;
+              hasError = true;
+            }
+          }
+        }
+        this.normalBuffer.length = 0;
+        this.lowBuffer.length = 0;
+      }
+    } finally {
+      this.normalBuffer.length = 0;
+      this.lowBuffer.length = 0;
+      this.flushing = false;
+    }
+    if (hasError) throw firstError;
+  }
+  /** 收集未 disposed 的 effect 并清空源集合；run() 期间新调度的 effect 留给下一轮。 */
+  collectRunnable(source, target) {
+    for (const effect2 of source) {
+      if (!effect2.disposed) target.push(effect2);
+    }
+    source.clear();
+  }
+};
+__name(_Scheduler, "Scheduler");
+function sortEffects(effects) {
+  if (effects.length > 1) {
+    effects.sort((a, b) => b.depth - a.depth || a.order - b.order);
+  }
+}
+__name(sortEffects, "sortEffects");
+
+// packages/runtime/src/hmr.ts
+var globalTarget = globalThis;
+var hmrGlobal = globalTarget.__VOBS_HMR__ ?? { modules: /* @__PURE__ */ new Map() };
+globalTarget.__VOBS_HMR__ = hmrGlobal;
+
+// packages/vobs/src/context.ts
+var ownerProviders = /* @__PURE__ */ new WeakMap();
+function inject(key, fallback) {
+  const owner = getCurrentOwner();
+  const value = owner ? injectFromOwner(owner, key) : void 0;
+  return value === void 0 ? fallback : value;
+}
+__name(inject, "inject");
+function injectFromOwner(owner, key) {
+  let current = owner;
+  while (current) {
+    const providers = ownerProviders.get(current);
+    if (providers?.has(key)) return providers.get(key);
+    current = current.parent;
+  }
+  return void 0;
+}
+__name(injectFromOwner, "injectFromOwner");
+
+// packages/vobs/src/app.ts
+function createInjectionKey(description) {
+  return Symbol(description);
+}
+__name(createInjectionKey, "createInjectionKey");
+
+// packages/payment/src/wechat/config.ts
+var _WechatConfig = class _WechatConfig {
+  constructor(options) {
+    this.validate(options);
+    this._options = { ...options };
+  }
+  /** 获取完整配置 */
+  get options() {
+    return this._options;
+  }
+  /** 商户号 */
+  get mchid() {
+    return this._options.mchid;
+  }
+  /** 应用 ID（公众号 / 小程序 / APP） */
+  get appid() {
+    return this._options.appid;
+  }
+  /** 商户 API 证书序列号 */
+  get serial() {
+    return this._options.serial;
+  }
+  /** APIv3 密钥（回调解密用） */
+  get apiv3Key() {
+    return this._options.apiv3Key;
+  }
+  /** 异步通知地址 */
+  get notifyUrl() {
+    return this._options.notifyUrl;
+  }
+  /** 更新配置（部分更新） */
+  update(patch) {
+    const merged = { ...this._options, ...patch };
+    this.validate(merged);
+    this._options = merged;
+  }
+  /** 替换配置 */
+  replace(options) {
+    this.validate(options);
+    this._options = { ...options };
+  }
+  validate(options) {
+    if (!options.mchid) {
+      throw new Error("WechatConfig: mchid \u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (!options.serial) {
+      throw new Error("WechatConfig: serial\uFF08\u5546\u6237 API \u8BC1\u4E66\u5E8F\u5217\u53F7\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (!options.privateKey) {
+      throw new Error("WechatConfig: privateKey\uFF08\u5546\u6237 API \u79C1\u94A5 PEM\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (!options.certs || Object.keys(options.certs).length === 0) {
+      throw new Error("WechatConfig: certs\uFF08\u5E73\u53F0\u8BC1\u4E66/\u5FAE\u4FE1\u652F\u4ED8\u516C\u94A5 {\u5E8F\u5217\u53F7: PEM}\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (!options.appid) {
+      throw new Error("WechatConfig: appid \u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (!options.apiv3Key) {
+      throw new Error("WechatConfig: apiv3Key \u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    if (options.apiv3Key.length !== 32) {
+      throw new Error("WechatConfig: apiv3Key \u5FC5\u987B\u4E3A 32 \u5B57\u8282\u5B57\u7B26\u4E32");
+    }
+  }
+};
+__name(_WechatConfig, "WechatConfig");
+var WechatConfig = _WechatConfig;
+
+// packages/payment/src/wechat/client.ts
+var _WechatClient = class _WechatClient {
+  constructor(options) {
+    this._disposed = false;
+    this.config = new WechatConfig(options);
+    this._sdk = this.createSdk(options);
+  }
+  /** 获取底层 Wechatpay 实例（链式 API：client.sdk.v3.pay.transactions.jsapi.post(...)） */
+  get sdk() {
+    this.ensureActive();
+    return this._sdk;
+  }
+  /** 更新配置并重建 SDK 实例 */
+  updateConfig(patch) {
+    this.ensureActive();
+    this.config.update(patch);
+    this._sdk = this.createSdk(this.config.options);
+  }
+  /** 销毁客户端 */
+  dispose() {
+    this._disposed = true;
+    this._sdk = null;
+  }
+  createSdk(options) {
+    return new wechatpayAxiosPlugin.Wechatpay({
+      mchid: options.mchid,
+      serial: options.serial,
+      privateKey: options.privateKey,
+      certs: options.certs,
+      timeout: options.timeout ?? 5e3
+    });
+  }
+  ensureActive() {
+    if (this._disposed) {
+      throw new Error("WechatClient: \u5BA2\u6237\u7AEF\u5DF2\u9500\u6BC1");
+    }
+  }
+};
+__name(_WechatClient, "WechatClient");
+var WechatClient = _WechatClient;
+
+// packages/payment/src/wechat/plugin.ts
+var WECHAT_KEY = createInjectionKey("vobs.payment.wechat");
+function useWechat() {
+  const client = inject(WECHAT_KEY);
+  if (!client) {
+    throw new Error("Vobs Payment: \u627E\u4E0D\u5230 WechatClient\uFF0C\u8BF7\u5B89\u88C5 wechatPlugin");
+  }
+  return client;
+}
+__name(useWechat, "useWechat");
+function wechatPlugin(options) {
+  return {
+    name: "@vobs/payment/wechat",
+    version: "0.1.0",
+    install(context) {
+      if (!options.client && !options.config) {
+        throw new Error("Vobs Payment: wechatPlugin \u9700\u8981\u63D0\u4F9B config \u6216 client \u4E4B\u4E00");
+      }
+      const ownClient = !options.client;
+      const client = options.client ?? new WechatClient(options.config);
+      context.provide(WECHAT_KEY, client);
+      return ownClient ? () => client.dispose() : void 0;
+    }
+  };
+}
+__name(wechatPlugin, "wechatPlugin");
+
+exports.WECHAT_KEY = WECHAT_KEY;
+exports.useWechat = useWechat;
+exports.wechatPlugin = wechatPlugin;
+//# sourceMappingURL=plugin.cjs.map
+//# sourceMappingURL=plugin.cjs.map