test-gstable-sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,604 @@
+'use strict';
+
+// src/errors.ts
+var GStableError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "GStableError";
+    this.code = code;
+  }
+};
+function isGStableError(e) {
+  return e instanceof GStableError;
+}
+
+// src/errors/common-platform.ts
+var CommonErrorCodes = {
+  INVALID_FIELD_FORMAT: 400101,
+  UNSUPPORTED_CURRENCY: 400201,
+  UNSUPPORTED_CHANNEL: 400202,
+  SETTLEMENT_CAPABILITIES_NOT_FOUND: 400203,
+  STAT_NOT_FOUND: 400301
+};
+var COMMON_ERROR_CODE_SET = new Set(
+  Object.values(CommonErrorCodes)
+);
+var CommonErrorMessages = {
+  [CommonErrorCodes.INVALID_FIELD_FORMAT]: "Invalid field format",
+  [CommonErrorCodes.UNSUPPORTED_CURRENCY]: "Unsupported currency",
+  [CommonErrorCodes.UNSUPPORTED_CHANNEL]: "Unsupported channel",
+  [CommonErrorCodes.SETTLEMENT_CAPABILITIES_NOT_FOUND]: "Settlement capabilities not found",
+  [CommonErrorCodes.STAT_NOT_FOUND]: "Stat not found"
+};
+function isCommonErrorCode(code) {
+  return COMMON_ERROR_CODE_SET.has(code);
+}
+var GStableCommonError = class extends GStableError {
+  commonErrorCode;
+  constructor(code, message) {
+    super(code, message);
+    this.name = "GStableCommonError";
+    this.commonErrorCode = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+function isGStableCommonError(e) {
+  return e instanceof GStableCommonError;
+}
+var PlatformErrorCodes = {
+  TOO_MANY_REQUESTS: 900101,
+  FAILED_TO_CREATE_RECORD: 900201,
+  FAILED_TO_UPDATE_RECORD: 900202,
+  FAILED_TO_QUERY_RECORD: 900203,
+  IMAGE_PROCESSING_FAILED: 900301,
+  INTERNAL_SYSTEM_ERROR: 999999
+};
+var PLATFORM_ERROR_CODE_SET = new Set(
+  Object.values(PlatformErrorCodes)
+);
+var PlatformErrorMessages = {
+  [PlatformErrorCodes.TOO_MANY_REQUESTS]: "Too many requests",
+  [PlatformErrorCodes.FAILED_TO_CREATE_RECORD]: "Failed to create record",
+  [PlatformErrorCodes.FAILED_TO_UPDATE_RECORD]: "Failed to update record",
+  [PlatformErrorCodes.FAILED_TO_QUERY_RECORD]: "Failed to query record",
+  [PlatformErrorCodes.IMAGE_PROCESSING_FAILED]: "Image processing failed",
+  [PlatformErrorCodes.INTERNAL_SYSTEM_ERROR]: "Internal system error"
+};
+function isPlatformErrorCode(code) {
+  return PLATFORM_ERROR_CODE_SET.has(code);
+}
+var GStablePlatformError = class extends GStableError {
+  platformErrorCode;
+  constructor(code, message) {
+    super(code, message);
+    this.name = "GStablePlatformError";
+    this.platformErrorCode = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+function isGStablePlatformError(e) {
+  return e instanceof GStablePlatformError;
+}
+
+// src/errors/product.ts
+var ProductErrorCodes = {
+  /** 指定的 Product ID 不存在 */
+  NOT_FOUND: 100301,
+  /** 批量操作中部分商品 ID 不存在 */
+  PARTIAL_MISSING: 100302,
+  /** 批量操作中部分商品状态不可用 */
+  PARTIALLY_UNAVAILABLE: 100303,
+  /** 商品未处于激活状态，无法用于创建链接或会话 */
+  NOT_ACTIVE: 100304,
+  /** 商品已被关联使用，无法执行某些特定修改 */
+  HAS_BEEN_USED: 100305,
+  /** 商品已被逻辑删除 */
+  HAS_BEEN_REMOVED: 100306
+};
+var PRODUCT_ERROR_CODE_SET = new Set(
+  Object.values(ProductErrorCodes)
+);
+var ProductErrorMessages = {
+  [ProductErrorCodes.NOT_FOUND]: "Product not found",
+  [ProductErrorCodes.PARTIAL_MISSING]: "Product partial missing",
+  [ProductErrorCodes.PARTIALLY_UNAVAILABLE]: "Product partially unavailable",
+  [ProductErrorCodes.NOT_ACTIVE]: "Product is not active",
+  [ProductErrorCodes.HAS_BEEN_USED]: "Product has been used",
+  [ProductErrorCodes.HAS_BEEN_REMOVED]: "Product has been removed"
+};
+function isProductErrorCode(code) {
+  return PRODUCT_ERROR_CODE_SET.has(code);
+}
+var GStableProductError = class extends GStableError {
+  productErrorCode;
+  constructor(code, message) {
+    super(code, message);
+    this.name = "GStableProductError";
+    this.productErrorCode = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+function isGStableProductError(e) {
+  return e instanceof GStableProductError;
+}
+function rewriteProductBusinessError(error) {
+  if (error instanceof GStableProductError) {
+    return error;
+  }
+  if (error instanceof GStableError && isProductErrorCode(error.code)) {
+    return new GStableProductError(error.code, error.message);
+  }
+  return error;
+}
+
+// src/errors/api-error.ts
+function createTypedApiError(code, message) {
+  if (isProductErrorCode(code)) {
+    return new GStableProductError(code, message);
+  }
+  if (isCommonErrorCode(code)) {
+    return new GStableCommonError(code, message);
+  }
+  if (isPlatformErrorCode(code)) {
+    return new GStablePlatformError(code, message);
+  }
+  return new GStableError(code, message);
+}
+
+// src/http.ts
+var DEFAULT_BASE_URL = "https://api.gstable.io/api/v1/";
+var DEFAULT_PUBLIC_BASE_URL = "https://api.gstable.io/public/api/v1";
+function isApiEnvelope(v) {
+  return v !== null && typeof v === "object" && "code" in v && typeof v.code === "number";
+}
+function messageForNonJsonBody(status, bodyPreview) {
+  const trimmed = bodyPreview.trim().slice(0, 280).replace(/\s+/g, " ");
+  if (status === 403) {
+    return [
+      "HTTP 403: The server rejected the request and the response body is not typical API JSON.",
+      "Common causes: invalid API key or insufficient permissions, WAF blocking, or base URL mismatch with https://docs.gstable.io.",
+      "Verify GSTABLE_API_KEY and endpoint URLs; retry from a server or trusted network.",
+      trimmed ? `(response snippet) ${trimmed}` : ""
+    ].filter(Boolean).join(" ");
+  }
+  if (status === 401) {
+    return `HTTP 401: Authentication failed. Check the Authorization header / API key.${trimmed ? ` ${trimmed}` : ""}`;
+  }
+  return `HTTP ${status}${trimmed ? `: ${trimmed}` : " (response is not JSON or is empty)"}`;
+}
+function isGStableHttpDebug() {
+  if (typeof process === "undefined" || process.env == null) return false;
+  const v = process.env.GSTABLE_DEBUG;
+  return v === "1" || v === "true";
+}
+function logOutgoingRequest(method, url, headers) {
+  if (!isGStableHttpDebug()) return;
+  console.error("[GStable SDK debug]", JSON.stringify({ method, url, headers }, null, 2));
+}
+var GStableHttp = class {
+  baseUrl;
+  publicBaseUrl;
+  authHeader;
+  fetchFn;
+  constructor(options) {
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.publicBaseUrl = (options.publicBaseUrl ?? DEFAULT_PUBLIC_BASE_URL).replace(/\/$/, "");
+    const key = options.apiKey.trim();
+    this.authHeader = key.startsWith("Bearer ") ? key : `Bearer ${key}`;
+    this.fetchFn = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
+  }
+  extractEnvelopeData(res, rawText, parsed) {
+    if (!isApiEnvelope(parsed)) {
+      throw new GStableError(
+        res.status || -1,
+        !res.ok ? messageForNonJsonBody(res.status, rawText) : "Unexpected response: not a valid API envelope JSON"
+      );
+    }
+    const envelope = parsed;
+    if (!res.ok) {
+      throw createTypedApiError(
+        envelope.code ?? res.status,
+        envelope.message || `HTTP ${res.status}`
+      );
+    }
+    if (envelope.code !== 0) {
+      throw createTypedApiError(envelope.code, envelope.message ?? "API error");
+    }
+    return envelope.data;
+  }
+  /**
+   * 调用公共 API（不携带 Authorization），响应格式与私有 API 相同。
+   */
+  async requestPublicJson(method, path, body) {
+    const url = `${this.publicBaseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const headers = {
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    };
+    logOutgoingRequest(method, url, headers);
+    const init = { method, headers };
+    if (method === "POST" && body !== void 0) {
+      init.body = JSON.stringify(body);
+    }
+    let res;
+    try {
+      res = await this.fetchFn(url, init);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      throw new GStableError(-1, `Network error: ${msg}`);
+    }
+    const rawText = await res.text().catch(() => "");
+    let parsed;
+    try {
+      parsed = rawText.length > 0 ? JSON.parse(rawText) : void 0;
+    } catch {
+      throw new GStableError(
+        res.status || -1,
+        messageForNonJsonBody(res.status, rawText)
+      );
+    }
+    return this.extractEnvelopeData(res, rawText, parsed);
+  }
+  async requestJson(method, path, body) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const headers = {
+      Accept: "application/json",
+      Authorization: this.authHeader,
+      "Content-Type": "application/json"
+    };
+    logOutgoingRequest(method, url, headers);
+    const init = { method, headers };
+    if (method === "POST" && body !== void 0) {
+      init.body = JSON.stringify(body);
+    }
+    let res;
+    try {
+      res = await this.fetchFn(url, init);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      throw new GStableError(-1, `Network error: ${msg}`);
+    }
+    const rawText = await res.text().catch(() => "");
+    let parsed;
+    try {
+      parsed = rawText.length > 0 ? JSON.parse(rawText) : void 0;
+    } catch {
+      throw new GStableError(
+        res.status || -1,
+        messageForNonJsonBody(res.status, rawText)
+      );
+    }
+    return this.extractEnvelopeData(res, rawText, parsed);
+  }
+};
+
+// src/resources/account.ts
+var AccountResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** GET /account/detail/:accountId */
+  detail(accountId) {
+    const id = encodeURIComponent(accountId);
+    return this.http.requestJson("GET", `/account/detail/${id}`);
+  }
+  /** GET /account/list — 全量返回，无分页（单商户最多 20 个账户） */
+  list() {
+    return this.http.requestJson("GET", "/account/list");
+  }
+};
+
+// src/resources/capability.ts
+var CapabilityResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** GET /capabilities/all */
+  all() {
+    return this.http.requestPublicJson("GET", "/capabilities/all");
+  }
+};
+
+// src/resources/checkout-session.ts
+var CheckoutSessionResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** POST /session/checkout/create */
+  create(body) {
+    return this.http.requestJson("POST", "/session/checkout/create", body);
+  }
+  /** POST /session/checkout/cancel（仅 initialized 且 signedOnce = 0） */
+  cancel(sessionId) {
+    return this.http.requestJson("POST", "/session/checkout/cancel", {
+      sessionId
+    });
+  }
+  /** GET /session/:sessionId — Checkout 与 Payment Link 会话均可查 */
+  detail(sessionId) {
+    const id = encodeURIComponent(sessionId);
+    return this.http.requestJson("GET", `/session/${id}`);
+  }
+  listByPath(path, page, size) {
+    const p = encodeURIComponent(String(page));
+    const s = encodeURIComponent(String(size));
+    return this.http.requestJson("GET", `${path}/${p}/${s}`);
+  }
+  /** GET /session/list/all/:page/:size */
+  listAll(page, size) {
+    return this.listByPath("/session/list/all", page, size);
+  }
+  /** GET /session/list/paid/:page/:size */
+  listPaid(page, size) {
+    return this.listByPath("/session/list/paid", page, size);
+  }
+  /** GET /session/list/settling/:page/:size */
+  listSettling(page, size) {
+    return this.listByPath("/session/list/settling", page, size);
+  }
+  /** GET /session/list/completed/:page/:size */
+  listCompleted(page, size) {
+    return this.listByPath("/session/list/completed", page, size);
+  }
+  /** GET /session/list/cancelled/:page/:size */
+  listCancelled(page, size) {
+    return this.listByPath("/session/list/cancelled", page, size);
+  }
+  /** GET /session/list/settlement/pending/:page/:size */
+  listSettlementPending(page, size) {
+    return this.listByPath("/session/list/settlement/pending", page, size);
+  }
+};
+
+// src/resources/payment-link.ts
+var PaymentLinkResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** POST /payment/link/create */
+  create(body) {
+    return this.http.requestJson("POST", "/payment/link/create", body);
+  }
+  /** POST /payment/link/update（全量替换） */
+  update(body) {
+    return this.http.requestJson("POST", "/payment/link/update", body);
+  }
+  /** POST /payment/link/disable */
+  disable(linkId) {
+    return this.http.requestJson("POST", "/payment/link/disable", {
+      linkId
+    });
+  }
+  /** POST /payment/link/enable */
+  enable(linkId) {
+    return this.http.requestJson("POST", "/payment/link/enable", {
+      linkId
+    });
+  }
+  /** GET /payment/link/:linkId */
+  detail(linkId) {
+    const id = encodeURIComponent(linkId);
+    return this.http.requestJson("GET", `/payment/link/${id}`);
+  }
+  /**
+   * GET /payment/link/list/:page/:size
+   * @param page 从 1 开始
+   */
+  list(page, size) {
+    const p = encodeURIComponent(String(page));
+    const s = encodeURIComponent(String(size));
+    return this.http.requestJson(
+      "GET",
+      `/payment/link/list/${p}/${s}`
+    );
+  }
+};
+
+// src/resources/product.ts
+var ProductResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  async invoke(operation) {
+    try {
+      return await operation();
+    } catch (e) {
+      throw rewriteProductBusinessError(e);
+    }
+  }
+  /** POST /product/create */
+  create(body) {
+    return this.invoke(
+      () => this.http.requestJson("POST", "/product/create", body)
+    );
+  }
+  /** POST /product/update（全量替换） */
+  update(body) {
+    return this.invoke(
+      () => this.http.requestJson("POST", "/product/update", body)
+    );
+  }
+  /**
+   * GET /product/list/:page/:size
+   * @param page 从 1 开始
+   * @param size 每页条数，最大 100
+   */
+  list(page, size) {
+    const p = encodeURIComponent(String(page));
+    const s = encodeURIComponent(String(size));
+    return this.invoke(
+      () => this.http.requestJson("GET", `/product/list/${p}/${s}`)
+    );
+  }
+  /** POST /product/list/by/ids — 不存在的 id 会被静默忽略 */
+  listByIds(body) {
+    return this.invoke(
+      () => this.http.requestJson("POST", "/product/list/by/ids", body)
+    );
+  }
+  /** POST /product/archive */
+  archive(productId) {
+    return this.invoke(
+      () => this.http.requestJson("POST", "/product/archive", {
+        productId
+      })
+    );
+  }
+  /** POST /product/unarchive */
+  unarchive(productId) {
+    return this.invoke(
+      () => this.http.requestJson("POST", "/product/unarchive", {
+        productId
+      })
+    );
+  }
+  /** POST /product/remove — 仅未被任何 Payment Link 引用过的商品可删 */
+  remove(productId) {
+    return this.invoke(
+      () => this.http.requestJson("POST", "/product/remove", {
+        productId
+      })
+    );
+  }
+};
+
+// src/resources/webhook.ts
+var WebhookResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** POST /webhook/create */
+  create(body) {
+    return this.http.requestJson("POST", "/webhook/create", body);
+  }
+  /** POST /webhook/update（全量替换） */
+  update(body) {
+    return this.http.requestJson("POST", "/webhook/update", body);
+  }
+  /** GET /webhook/list — 全量，无分页 */
+  list() {
+    return this.http.requestJson("GET", "/webhook/list");
+  }
+  /** GET /webhook/detail/:webhookId */
+  detail(webhookId) {
+    const id = encodeURIComponent(webhookId);
+    return this.http.requestJson("GET", `/webhook/detail/${id}`);
+  }
+  /** POST /webhook/disable */
+  disable(webhookId) {
+    return this.http.requestJson("POST", "/webhook/disable", {
+      webhookId
+    });
+  }
+  /** POST /webhook/enable（含从 paused 恢复） */
+  enable(webhookId) {
+    return this.http.requestJson("POST", "/webhook/enable", {
+      webhookId
+    });
+  }
+  /** POST /webhook/key/refresh — 旧 key 立即失效 */
+  refreshKey(webhookId) {
+    return this.http.requestJson("POST", "/webhook/key/refresh", {
+      webhookId
+    });
+  }
+  /** POST /webhook/remove */
+  remove(webhookId) {
+    return this.http.requestJson("POST", "/webhook/remove", {
+      webhookId
+    });
+  }
+};
+
+// src/client.ts
+var GStableClient = class {
+  http;
+  product;
+  account;
+  paymentLink;
+  capability;
+  checkoutSession;
+  /** AI Payment Protocol（创建会话 / 查询 / 准备支付） */
+  // readonly aiPayment: AiPaymentResource
+  webhook;
+  constructor(options) {
+    if (!options.apiKey?.trim()) {
+      throw new Error("GStableClient: apiKey is required");
+    }
+    this.http = new GStableHttp(options);
+    this.product = new ProductResource(this.http);
+    this.account = new AccountResource(this.http);
+    this.paymentLink = new PaymentLinkResource(this.http);
+    this.capability = new CapabilityResource(this.http);
+    this.checkoutSession = new CheckoutSessionResource(this.http);
+    this.webhook = new WebhookResource(this.http);
+  }
+};
+
+// src/resources/ai-payment.ts
+var AiPaymentResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** POST /payment/session/create */
+  createSession(body) {
+    return this.http.requestJson(
+      "POST",
+      "/payment/session/create",
+      body
+    );
+  }
+  /**
+   * GET /session/:sessionId
+   * 与核心 `checkoutSession.detail` 同路径；本方法按 AI 文档将 data 解析为含 `aiView` 的扁平结构。
+   */
+  getSession(sessionId) {
+    const id = encodeURIComponent(sessionId);
+    return this.http.requestJson("GET", `/session/${id}`);
+  }
+  /** POST /payment/prepare */
+  preparePayment(body) {
+    return this.http.requestJson("POST", "/payment/prepare", body);
+  }
+};
+
+exports.AccountResource = AccountResource;
+exports.AiPaymentResource = AiPaymentResource;
+exports.CapabilityResource = CapabilityResource;
+exports.CheckoutSessionResource = CheckoutSessionResource;
+exports.CommonErrorCodes = CommonErrorCodes;
+exports.CommonErrorMessages = CommonErrorMessages;
+exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
+exports.DEFAULT_PUBLIC_BASE_URL = DEFAULT_PUBLIC_BASE_URL;
+exports.GStableClient = GStableClient;
+exports.GStableCommonError = GStableCommonError;
+exports.GStableError = GStableError;
+exports.GStableHttp = GStableHttp;
+exports.GStablePlatformError = GStablePlatformError;
+exports.GStableProductError = GStableProductError;
+exports.PaymentLinkResource = PaymentLinkResource;
+exports.PlatformErrorCodes = PlatformErrorCodes;
+exports.PlatformErrorMessages = PlatformErrorMessages;
+exports.ProductErrorCodes = ProductErrorCodes;
+exports.ProductErrorMessages = ProductErrorMessages;
+exports.ProductResource = ProductResource;
+exports.WebhookResource = WebhookResource;
+exports.createTypedApiError = createTypedApiError;
+exports.isCommonErrorCode = isCommonErrorCode;
+exports.isGStableCommonError = isGStableCommonError;
+exports.isGStableError = isGStableError;
+exports.isGStablePlatformError = isGStablePlatformError;
+exports.isGStableProductError = isGStableProductError;
+exports.isPlatformErrorCode = isPlatformErrorCode;
+exports.isProductErrorCode = isProductErrorCode;
+exports.rewriteProductBusinessError = rewriteProductBusinessError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map