@acosmi/sdk-ts 1.3.1 → 1.3.2

package/dist/node/index.cjs

@@ -1441,6 +1441,7 @@ var ScopeComplianceSealApprovalRequest = "compliance:seal_approval:request";
 var ScopeComplianceSealApprovalApprove = "compliance:seal_approval:approve";
 var ScopeComplianceSealUseExecute = "compliance:seal_use:execute";
 var ScopeComplianceReportsRead = "compliance:reports:read";
+var ScopeComplianceReportsWrite = "compliance:reports:write";
 var ScopeComplianceReportsPublish = "compliance:reports:publish";
 function allScopes() {
   return [ScopeAI, ScopeSkills, ScopeAccount];
@@ -1458,6 +1459,7 @@ function complianceScopes() {
     ScopeComplianceSealApprovalApprove,
     ScopeComplianceSealUseExecute,
     ScopeComplianceReportsRead,
+    ScopeComplianceReportsWrite,
     ScopeComplianceReportsPublish
   ];
 }
@@ -3328,17 +3330,20 @@ var ComplianceClient = class {
   }
   /**
    * 公开 verify。隐私边界：返回字段不含 PII / 合同原文 / storage / provider raw。
-   * 服务端不要求 compliance scope（公开端点）；但 SDK 仍带上 token 以便审计。
+   *
+   * 匿名可调用：未 login 时走匿名请求，不会抛 `not authorized, call login() first`。
+   * 已 login / 已持有 token 时附带 `Authorization` 以保留审计上下文。public 端点不
+   * 应要求认证 — 收到 401 直接抛 HTTPError，不触发 `forceRefresh`，也不做 refresh
+   * replay。
    */
   verifyEvidencePublic(params, signal) {
     const q = new URLSearchParams();
     if (params.evidenceNo) q.set("evidenceNo", params.evidenceNo);
     if (params.publicVerifyCode) q.set("publicVerifyCode", params.publicVerifyCode);
     const qs = q.toString();
-    return this.read(
+    return this.publicRead(
       "GET",
       `/compliance/evidence/verify${qs ? "?" + qs : ""}`,
-      null,
       signal
     );
   }
@@ -3422,9 +3427,10 @@ var ComplianceClient = class {
   /**
    * 发布报告（写，step-up 必须）。
    *
-   * 缺少 step-up 时服务端会返回 `COMPLIANCE_STEP_UP_REQUIRED`（数值码
-   * 1031000013）。SDK 不会自动重试；调用方需要引导用户重新做 OAuth introspection 或
-   * 重新登录后再次调用本方法（使用同一 idempotency-key）。
+   * `@status gated` — step-up 闸门未闭合前服务端会一致返回
+   * `COMPLIANCE_STEP_UP_REQUIRED`（数值码 1031000013）。SDK 不会自动重试、不伪成功；
+   * 调用方需要引导用户重新做 OAuth introspection 或重新登录后再次调用本方法
+   *（使用同一 idempotency-key）。方法状态分级见 `docs/compliance.md` Method Status。
    */
   publishReport(id, opts = {}) {
     return this.write(
@@ -3471,7 +3477,7 @@ var ComplianceClient = class {
   /**
    * 正式签署（写，step-up 必须）。
    *
-   * 服务端闸门关闭时会一致返回 `ENVELOPE_GATE_CLOSED` (1031004004)。
+   * `@status gated` — 服务端闸门关闭时会一致返回 `ENVELOPE_GATE_CLOSED` (1031004004)。
    * SDK 不重试、不伪成功；调用方应该将该错误展示为"功能未开放"。
    */
   signEnvelope(envelopeId, req, opts = {}) {
@@ -3485,7 +3491,7 @@ var ComplianceClient = class {
   /**
    * 创建 H5 签署短链（写，step-up 必须）。
    *
-   * 同上：服务端闸门关闭时 SDK 不重试。
+   * `@status gated` — 同 {@link signEnvelope}：服务端闸门关闭时 SDK 不重试、不伪成功。
    */
   createH5SigningUrl(envelopeId, req, opts = {}) {
     return this.write(
@@ -3507,6 +3513,13 @@ var ComplianceClient = class {
   // =========================================================================
   // Seal Approval
   // =========================================================================
+  /**
+   * 提交用印审批申请（写）。
+   *
+   * `@status production-ready` — 服务端以 `Idempotency-Key` + 业务请求指纹做重放保护：
+   * 同 key + 同请求 → 返回原审批 id；同 key + 不同请求 → 拒绝复用幂等键。强烈建议调用方
+   * 持久化 `idempotencyKey`，网络重试 / 任务恢复时复用，避免重复创建审批单。
+   */
   submitSealApproval(req, opts = {}) {
     return this.write(
       "POST",
@@ -3515,6 +3528,12 @@ var ComplianceClient = class {
       writeCtx(opts)
     );
   }
+  /**
+   * 审批通过用印申请（写，step-up 必须）。
+   *
+   * `@status gated` — step-up 未闭合前服务端会返回 `COMPLIANCE_STEP_UP_REQUIRED`。
+   * SDK 不重试、不伪成功。方法状态分级见 `docs/compliance.md` Method Status。
+   */
   approveSealApproval(id, query, opts = {}) {
     const q = new URLSearchParams();
     if (query.expiresAt) q.set("expiresAt", query.expiresAt);
@@ -3612,6 +3631,38 @@ var ComplianceClient = class {
       extraHeaders
     });
   }
+  /**
+   * 公开读路径：public verify。
+   *
+   * 与 {@link read} 的区别 — public 端点不应要求认证：
+   *   - 无 token 时匿名请求：ensureToken 抛 `not authorized` 会被吞掉，继续匿名发送。
+   *   - 有 token 时附带 `Authorization`，保留后端审计上下文。
+   *   - 不做 401 refresh replay：401 直接抛 HTTPError，不触发 `forceRefresh`。
+   *
+   * URL 仍走 `client.complianceURL(path)`，不复用 `/api/v4`；底层复用
+   * `client.doRequest`，不新增 fetch/axios 直连。
+   */
+  async publicRead(method, path, signal) {
+    let token = "";
+    try {
+      token = await this.client.ensureToken(signal);
+    } catch {
+    }
+    const url = this.client.complianceURL(path);
+    const headers = { Accept: "application/json" };
+    if (token) headers.Authorization = `Bearer ${token}`;
+    const resp = await this.client.doRequest({ method, url, headers }, signal);
+    if (resp.status < 200 || resp.status >= 300) {
+      const bodyBytes = resp.body ? await readLimited(resp.body, maxErrorBodySize) : new Uint8Array();
+      throw parseHTTPErrorWithHeader(resp.status, bodyBytes, resp.headers);
+    }
+    const text = await resp.text();
+    if (!text) return void 0;
+    const parsed = JSON.parse(text);
+    const bizErr = apiResponseBusinessError(parsed);
+    if (bizErr) throw bizErr;
+    return parsed.data;
+  }
   /**
    * 写路径：POST。
    * - 发送前 ensureToken 一次确保 token fresh。
@@ -5371,6 +5422,7 @@ exports.ScopeComplianceEvidenceRead = ScopeComplianceEvidenceRead;
 exports.ScopeComplianceEvidenceWrite = ScopeComplianceEvidenceWrite;
 exports.ScopeComplianceReportsPublish = ScopeComplianceReportsPublish;
 exports.ScopeComplianceReportsRead = ScopeComplianceReportsRead;
+exports.ScopeComplianceReportsWrite = ScopeComplianceReportsWrite;
 exports.ScopeComplianceSealApprovalApprove = ScopeComplianceSealApprovalApprove;
 exports.ScopeComplianceSealApprovalRequest = ScopeComplianceSealApprovalRequest;
 exports.ScopeComplianceSealManage = ScopeComplianceSealManage;