@nvwa-app/sdk-shared 6.46.0 → 6.48.0

package/dist/index.d.mts

@@ -66,4 +66,17 @@ declare function collectPaymentClientContext(options: {
     getMiniProgramIdentity?: () => Promise<MiniProgramIdentityForPayment | null>;
 }): Promise<PaymentClientContext>;
 
-export { type CreatePaymentOrderRequest, PROJECT_PLATFORM_TYPES, type PaymentClientContext, type PaymentGatewayCreateOrderResult, type PaymentOrderResult, type ProjectPlatformType, collectPaymentClientContext, isProjectPlatformType, toPaymentOrderResultFromGateway };
+type ParseCreatePaymentOrderRequestResult = {
+    ok: true;
+    request: CreatePaymentOrderRequest;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 校验并解析业务「创建支付单」请求体（与 `CreatePaymentOrderRequest` 一致）。
+ * Edge Function 可先 `parseCreatePaymentOrderRequest(await req.json())`，再 `buildCreateOrderParams`。
+ */
+declare function parseCreatePaymentOrderRequest(input: unknown): ParseCreatePaymentOrderRequestResult;
+
+export { type CreatePaymentOrderRequest, PROJECT_PLATFORM_TYPES, type ParseCreatePaymentOrderRequestResult, type PaymentClientContext, type PaymentGatewayCreateOrderResult, type PaymentOrderResult, type ProjectPlatformType, collectPaymentClientContext, isProjectPlatformType, parseCreatePaymentOrderRequest, toPaymentOrderResultFromGateway };

package/dist/index.d.ts

@@ -66,4 +66,17 @@ declare function collectPaymentClientContext(options: {
     getMiniProgramIdentity?: () => Promise<MiniProgramIdentityForPayment | null>;
 }): Promise<PaymentClientContext>;
 
-export { type CreatePaymentOrderRequest, PROJECT_PLATFORM_TYPES, type PaymentClientContext, type PaymentGatewayCreateOrderResult, type PaymentOrderResult, type ProjectPlatformType, collectPaymentClientContext, isProjectPlatformType, toPaymentOrderResultFromGateway };
+type ParseCreatePaymentOrderRequestResult = {
+    ok: true;
+    request: CreatePaymentOrderRequest;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 校验并解析业务「创建支付单」请求体（与 `CreatePaymentOrderRequest` 一致）。
+ * Edge Function 可先 `parseCreatePaymentOrderRequest(await req.json())`，再 `buildCreateOrderParams`。
+ */
+declare function parseCreatePaymentOrderRequest(input: unknown): ParseCreatePaymentOrderRequestResult;
+
+export { type CreatePaymentOrderRequest, PROJECT_PLATFORM_TYPES, type ParseCreatePaymentOrderRequestResult, type PaymentClientContext, type PaymentGatewayCreateOrderResult, type PaymentOrderResult, type ProjectPlatformType, collectPaymentClientContext, isProjectPlatformType, parseCreatePaymentOrderRequest, toPaymentOrderResultFromGateway };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   PROJECT_PLATFORM_TYPES: () => PROJECT_PLATFORM_TYPES,
   collectPaymentClientContext: () => collectPaymentClientContext,
   isProjectPlatformType: () => isProjectPlatformType,
+  parseCreatePaymentOrderRequest: () => parseCreatePaymentOrderRequest,
   toPaymentOrderResultFromGateway: () => toPaymentOrderResultFromGateway
 });
 module.exports = __toCommonJS(index_exports);
@@ -75,10 +76,78 @@ async function collectPaymentClientContext(options) {
     unionid: identity.unionid
   };
 }
+
+// src/parse-create-payment-order-request.ts
+function trimStr(v) {
+  return typeof v === "string" ? v.trim() : "";
+}
+function parseCreatePaymentOrderRequest(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    return { ok: false, error: "Request body must be a JSON object" };
+  }
+  const body = input;
+  const clientRaw = body.client;
+  if (!clientRaw || typeof clientRaw !== "object" || Array.isArray(clientRaw)) {
+    return {
+      ok: false,
+      error: "client is required and must be an object with platformType (use collectPaymentClientContext / nvwa.payment.collectPaymentClientContext)"
+    };
+  }
+  const cr = clientRaw;
+  const platformTypeRaw = trimStr(cr.platformType);
+  if (!platformTypeRaw) {
+    return { ok: false, error: "client.platformType is required and must be non-empty" };
+  }
+  if (!isProjectPlatformType(platformTypeRaw)) {
+    return {
+      ok: false,
+      error: "client.platformType is invalid; use a valid ProjectPlatformType (e.g. DesktopWeb, MobileWeb, WechatMiniProgram)"
+    };
+  }
+  const client = { platformType: platformTypeRaw };
+  const puid = trimStr(cr.platformUserId);
+  if (puid) client.platformUserId = puid;
+  const appId = trimStr(cr.appId);
+  if (appId) client.appId = appId;
+  const unionid = trimStr(cr.unionid);
+  if (unionid) client.unionid = unionid;
+  const providerId = trimStr(body.providerId);
+  if (!providerId) {
+    return { ok: false, error: "providerId is required" };
+  }
+  const bizOrderId = trimStr(body.bizOrderId);
+  if (!bizOrderId) {
+    return { ok: false, error: "bizOrderId is required" };
+  }
+  const amount = body.amount;
+  if (typeof amount !== "number" || !Number.isFinite(amount) || amount <= 0) {
+    return { ok: false, error: "amount must be a positive number" };
+  }
+  const currencyRaw = trimStr(body.currency);
+  const returnUrlRaw = trimStr(body.returnUrl);
+  let metadata;
+  if (body.metadata != null) {
+    if (typeof body.metadata !== "object" || Array.isArray(body.metadata)) {
+      return { ok: false, error: "metadata must be a plain object when provided" };
+    }
+    metadata = { ...body.metadata };
+  }
+  const request = {
+    client,
+    bizOrderId,
+    amount,
+    providerId,
+    ...currencyRaw ? { currency: currencyRaw } : {},
+    ...returnUrlRaw ? { returnUrl: returnUrlRaw } : {},
+    ...metadata ? { metadata } : {}
+  };
+  return { ok: true, request };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PROJECT_PLATFORM_TYPES,
   collectPaymentClientContext,
   isProjectPlatformType,
+  parseCreatePaymentOrderRequest,
   toPaymentOrderResultFromGateway
 });

package/dist/index.mjs

@@ -46,9 +46,77 @@ async function collectPaymentClientContext(options) {
     unionid: identity.unionid
   };
 }
+
+// src/parse-create-payment-order-request.ts
+function trimStr(v) {
+  return typeof v === "string" ? v.trim() : "";
+}
+function parseCreatePaymentOrderRequest(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    return { ok: false, error: "Request body must be a JSON object" };
+  }
+  const body = input;
+  const clientRaw = body.client;
+  if (!clientRaw || typeof clientRaw !== "object" || Array.isArray(clientRaw)) {
+    return {
+      ok: false,
+      error: "client is required and must be an object with platformType (use collectPaymentClientContext / nvwa.payment.collectPaymentClientContext)"
+    };
+  }
+  const cr = clientRaw;
+  const platformTypeRaw = trimStr(cr.platformType);
+  if (!platformTypeRaw) {
+    return { ok: false, error: "client.platformType is required and must be non-empty" };
+  }
+  if (!isProjectPlatformType(platformTypeRaw)) {
+    return {
+      ok: false,
+      error: "client.platformType is invalid; use a valid ProjectPlatformType (e.g. DesktopWeb, MobileWeb, WechatMiniProgram)"
+    };
+  }
+  const client = { platformType: platformTypeRaw };
+  const puid = trimStr(cr.platformUserId);
+  if (puid) client.platformUserId = puid;
+  const appId = trimStr(cr.appId);
+  if (appId) client.appId = appId;
+  const unionid = trimStr(cr.unionid);
+  if (unionid) client.unionid = unionid;
+  const providerId = trimStr(body.providerId);
+  if (!providerId) {
+    return { ok: false, error: "providerId is required" };
+  }
+  const bizOrderId = trimStr(body.bizOrderId);
+  if (!bizOrderId) {
+    return { ok: false, error: "bizOrderId is required" };
+  }
+  const amount = body.amount;
+  if (typeof amount !== "number" || !Number.isFinite(amount) || amount <= 0) {
+    return { ok: false, error: "amount must be a positive number" };
+  }
+  const currencyRaw = trimStr(body.currency);
+  const returnUrlRaw = trimStr(body.returnUrl);
+  let metadata;
+  if (body.metadata != null) {
+    if (typeof body.metadata !== "object" || Array.isArray(body.metadata)) {
+      return { ok: false, error: "metadata must be a plain object when provided" };
+    }
+    metadata = { ...body.metadata };
+  }
+  const request = {
+    client,
+    bizOrderId,
+    amount,
+    providerId,
+    ...currencyRaw ? { currency: currencyRaw } : {},
+    ...returnUrlRaw ? { returnUrl: returnUrlRaw } : {},
+    ...metadata ? { metadata } : {}
+  };
+  return { ok: true, request };
+}
 export {
   PROJECT_PLATFORM_TYPES,
   collectPaymentClientContext,
   isProjectPlatformType,
+  parseCreatePaymentOrderRequest,
   toPaymentOrderResultFromGateway
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nvwa-app/sdk-shared",
-  "version": "6.46.0",
+  "version": "6.48.0",
   "description": "NVWA SDK 共享层：跨端/Functions 共用的类型与轻量工具（无 UI、无 PostgREST）。",
   "main": "dist/index.js",
   "module": "dist/index.mjs",