@astrasyncai/verification-gateway 5.18.1 → 5.20.0

package/dist/bin/astrasync.js

@@ -36,7 +36,7 @@ var SDK_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    SDK_VERSION = "5.18.1";
+    SDK_VERSION = "5.20.0";
   }
 });
 
@@ -5186,7 +5186,12 @@ function getCacheKey(request2, counterpartyId) {
     // its start_checkout quote was served the cached quote-leg grant (no
     // settlementOutcome) and never reached the backend. Same F-A1-07 bug class.
     request2.commercePhase || "",
-    request2.checkoutSessionId || ""
+    request2.checkoutSessionId || "",
+    // 5.19.0: a route_config purpose claim is checked server-side against
+    // the stored rule for this method + path, so it changes the verdict.
+    request2.purposeSource || "",
+    request2.requestMethod || "",
+    request2.requestPath || ""
   ].join("|");
 }
 function getCachedResult(request2, counterpartyId) {
@@ -5342,6 +5347,9 @@ async function callVerifyAccessAPI(config, request2) {
   if (requestData.enableRuntimeChallenge)
     body.enableRuntimeChallenge = requestData.enableRuntimeChallenge;
   if (requestData.routePolicy) body.routePolicy = requestData.routePolicy;
+  if (config.actingProof?.connectorToken) {
+    body.actingProof = { connectorToken: config.actingProof.connectorToken };
+  }
   if (requestData.approvalHeldByRoute) body.approvalHeldByRoute = true;
   if (requestData.createSession) body.createSession = requestData.createSession;
   if (requestData.durationRequired) body.durationRequired = requestData.durationRequired;
@@ -5358,6 +5366,11 @@ async function callVerifyAccessAPI(config, request2) {
   if (requestData.buyerEmail) body.buyerEmail = requestData.buyerEmail;
   if (requestData.commerceArtifacts) body.commerceArtifacts = requestData.commerceArtifacts;
   if (requestData.attemptId) body.attemptId = requestData.attemptId;
+  if (requestData.purposeSource) body.purposeSource = requestData.purposeSource;
+  if (requestData.agentArtifacts) body.agentArtifacts = requestData.agentArtifacts;
+  if (requestData.metadata) body.metadata = requestData.metadata;
+  if (requestData.requestMethod) body.requestMethod = requestData.requestMethod;
+  if (requestData.requestPath) body.requestPath = requestData.requestPath;
   if (requestData.considerationSet) body.considerationSet = requestData.considerationSet;
   body.sdkVersion = SDK_VERSION;
   if (requestData.callerMetadata || requestData.clientIp || requestData.userAgent) {
@@ -5504,22 +5517,41 @@ async function verify(config, request2, options) {
       "[VerificationGateway] minTrustScore / minTrustScoreForFull are deprecated in v2.3.0 and have no effect. Server is now the single source of truth for access decisions (verified ID + runtime challenge + PDLSS + trust score). To gate access to an endpoint, configure the endpoint's trust_score_requirement server-side."
     );
   }
-  const uncacheable = Boolean(request2.commerceArtifacts);
+  const uncacheable = Boolean(request2.commerceArtifacts) || Boolean(mergedConfig.actingProof);
   if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
     const cached = getCachedResult(request2, mergedConfig.counterpartyId);
     if (cached) {
       if (mergedConfig.debug) {
         console.log("[VerificationGateway] Returning cached result");
       }
-      const hit = { ...cached };
-      if (request2.attemptId) {
-        hit.attemptId = request2.attemptId;
-      } else {
-        delete hit.attemptId;
-      }
-      return hit;
+      return sharedVerdict(cached, request2);
+    }
+  }
+  if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
+    const key = getCacheKey(request2, mergedConfig.counterpartyId);
+    const pending = inflightVerifies.get(key);
+    if (pending) return sharedVerdict(await pending, request2);
+    const flight = verifyViaApi(mergedConfig, request2, urls, uncacheable);
+    inflightVerifies.set(key, flight);
+    try {
+      return await flight;
+    } finally {
+      inflightVerifies.delete(key);
     }
   }
+  return verifyViaApi(mergedConfig, request2, urls, uncacheable);
+}
+function sharedVerdict(source, request2) {
+  const hit = { ...source };
+  if (request2.attemptId) {
+    hit.attemptId = request2.attemptId;
+  } else {
+    delete hit.attemptId;
+  }
+  sharedVerdicts.add(hit);
+  return hit;
+}
+async function verifyViaApi(mergedConfig, request2, urls, uncacheable) {
   const enrichedRequest = { ...request2 };
   if (!enrichedRequest.counterpartyUrl && mergedConfig.counterpartyUrl) {
     enrichedRequest.counterpartyUrl = mergedConfig.counterpartyUrl;
@@ -5547,9 +5579,18 @@ async function verify(config, request2, options) {
   if (!apiResponse.access?.allowed) {
     const aggregatedFailures = apiResponse.access?.failures;
     const idVerifiedFromBackend = apiResponse.verificationContext?.idVerified === true && !aggregatedFailures?.some((f) => REJECTED_IDENTITY_DIMENSIONS.has(f.dimension));
+    const denyAgent = idVerifiedFromBackend && apiResponse.agent ? {
+      astraId: apiResponse.agent.astraId,
+      name: apiResponse.agent.name,
+      trustScore: apiResponse.agent.trustScore,
+      trustLevel: getTrustLevel(apiResponse.agent.trustScore),
+      blockchainAnchored: apiResponse.agent.blockchainStatus === "anchored",
+      status: apiResponse.agent.agentStatus
+    } : void 0;
     const result2 = {
       identityVerified: idVerifiedFromBackend,
       policyAllowed: false,
+      ...denyAgent && { agent: denyAgent },
       // 3.6.0: the server now emits top-level denialReasons on every deny
       // path — prefer it verbatim; the failure-message reconstruction remains
       // as the fallback for older backends.
@@ -5589,7 +5630,9 @@ async function verify(config, request2, options) {
       fulfilment: apiResponse.fulfilment,
       mandates: apiResponse.mandates,
       kyaToken: apiResponse.kyaToken,
-      aep: apiResponse.aep
+      aep: apiResponse.aep,
+      // 5.20.0 (round 29.1): non-fatal integration warnings (e.g. events_url_missing).
+      warnings: apiResponse.warnings
     };
     return result2;
   }
@@ -5657,7 +5700,9 @@ async function verify(config, request2, options) {
     // 5.15.0: merchant-lane AP2 mandates + KYAPay identity token.
     mandates: apiResponse.mandates,
     kyaToken: apiResponse.kyaToken,
-    aep: apiResponse.aep
+    aep: apiResponse.aep,
+    // 5.20.0 (round 29.1): non-fatal integration warnings (e.g. events_url_missing).
+    warnings: apiResponse.warnings
   };
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
@@ -5683,9 +5728,18 @@ async function verify(config, request2, options) {
       cacheResult(request2, result, mergedConfig.cacheTtl, mergedConfig.counterpartyId);
     }
   }
+  notifyVerificationListeners(request2, result);
   return result;
 }
-var DEFAULT_CONFIG, initCheckPerformed, deprecationWarningShown, verificationCache, DEFAULT_CACHE_TTL_SECONDS, MAX_RETRY_AFTER_MS;
+function notifyVerificationListeners(request2, result) {
+  for (const listener of verificationListeners) {
+    try {
+      listener(result, request2);
+    } catch {
+    }
+  }
+}
+var DEFAULT_CONFIG, initCheckPerformed, deprecationWarningShown, verificationCache, DEFAULT_CACHE_TTL_SECONDS, MAX_RETRY_AFTER_MS, inflightVerifies, sharedVerdicts, verificationListeners;
 var init_verify = __esm({
   "src/verify.ts"() {
     "use strict";
@@ -5708,6 +5762,9 @@ var init_verify = __esm({
     verificationCache = /* @__PURE__ */ new Map();
     DEFAULT_CACHE_TTL_SECONDS = 60;
     MAX_RETRY_AFTER_MS = 15 * 60 * 1e3;
+    inflightVerifies = /* @__PURE__ */ new Map();
+    sharedVerdicts = /* @__PURE__ */ new WeakSet();
+    verificationListeners = /* @__PURE__ */ new Set();
   }
 });
 
@@ -5772,6 +5829,16 @@ var init_commerce_detect = __esm({
   }
 });
 
+// src/adapters/routes-cache.ts
+var DEFAULT_ROUTES_REFRESH_MS;
+var init_routes_cache = __esm({
+  "src/adapters/routes-cache.ts"() {
+    "use strict";
+    init_verify();
+    DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;
+  }
+});
+
 // src/transport/http.ts
 var init_http2 = __esm({
   "src/transport/http.ts"() {
@@ -6101,7 +6168,6 @@ var init_anonymous_beacon = __esm({
 });
 
 // src/adapters/express.ts
-var DEFAULT_ROUTES_REFRESH_MS;
 var init_express = __esm({
   "src/adapters/express.ts"() {
     "use strict";
@@ -6109,6 +6175,7 @@ var init_express = __esm({
     init_types2();
     init_stepup_poll();
     init_verify();
+    init_routes_cache();
     init_http2();
     init_verified_hop();
     init_http_pdlss();
@@ -6119,7 +6186,6 @@ var init_express = __esm({
     init_anonymous_beacon();
     init_failure_posture();
     init_route_pattern();
-    DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;
   }
 });
 
@@ -6460,6 +6526,7 @@ var init_mcp2 = __esm({
     init_approval_gate();
     init_stepup_poll();
     init_well_known();
+    init_routes_cache();
     init_failure_posture();
     init_mcp_server();
   }
@@ -6648,6 +6715,7 @@ var init_report_amount = __esm({
 var init_kit_shared = __esm({
   "src/ucp/kit-shared.ts"() {
     "use strict";
+    init_sign();
   }
 });
 
@@ -6667,6 +6735,41 @@ var init_checkout_kit = __esm({
     init_signatures();
     init_report_amount();
     init_kit_shared();
+    init_errors();
+    init_stepup_poll();
+  }
+});
+
+// src/webhooks.ts
+var init_webhooks = __esm({
+  "src/webhooks.ts"() {
+    "use strict";
+  }
+});
+
+// src/ucp/approval-events.ts
+var MemorySeenEvents, defaultSeen;
+var init_approval_events = __esm({
+  "src/ucp/approval-events.ts"() {
+    "use strict";
+    init_webhooks();
+    MemorySeenEvents = class {
+      constructor(max = 1e4) {
+        this.max = max;
+        this.ids = /* @__PURE__ */ new Set();
+      }
+      async has(eventId) {
+        return this.ids.has(eventId);
+      }
+      async add(eventId) {
+        if (this.ids.size >= this.max) {
+          const first = this.ids.values().next().value;
+          if (first !== void 0) this.ids.delete(first);
+        }
+        this.ids.add(eventId);
+      }
+    };
+    defaultSeen = new MemorySeenEvents();
   }
 });
 
@@ -6681,6 +6784,7 @@ var init_ucp2 = __esm({
     init_signatures();
     init_checkout_kit();
     init_jcs();
+    init_approval_events();
   }
 });
 
@@ -6740,8 +6844,11 @@ var init_checkout_kit2 = __esm({
   "src/acp/checkout-kit.ts"() {
     "use strict";
     init_idempotency();
+    init_checkout_kit();
     init_report_amount();
     init_kit_shared();
+    init_errors();
+    init_stepup_poll();
   }
 });
 
@@ -6750,6 +6857,7 @@ var init_acp2 = __esm({
   "src/acp/index.ts"() {
     "use strict";
     init_checkout_kit2();
+    init_approval_events();
   }
 });
 
@@ -6758,6 +6866,7 @@ var init_kit_express = __esm({
   "src/adapters/kit-express.ts"() {
     "use strict";
     init_kit_shared();
+    init_approval_events();
   }
 });
 
@@ -6846,7 +6955,9 @@ function toDecision(result) {
   if (result.identityVerified && result.policyAllowed) {
     return {
       recommendation: "ALLOW",
-      reason: result.agent?.trustScore ? `Verified (trust score ${result.agent.trustScore})` : "Verified",
+      // 5.19.0: the score is on `trustScore` for the merchant; `reason` is
+      // text a merchant may relay to the agent, so it never embeds the number.
+      reason: "Verified",
       trustScore: result.agent?.trustScore,
       sessionId: "sessionId" in result ? result.sessionId : void 0
     };

package/dist/browser/background.js

@@ -3988,7 +3988,7 @@ function getTrustLevel(score) {
 }
 
 // src/version.ts
-var SDK_VERSION = "5.18.1";
+var SDK_VERSION = "5.20.0";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -4143,7 +4143,12 @@ function getCacheKey(request, counterpartyId) {
     // its start_checkout quote was served the cached quote-leg grant (no
     // settlementOutcome) and never reached the backend. Same F-A1-07 bug class.
     request.commercePhase || "",
-    request.checkoutSessionId || ""
+    request.checkoutSessionId || "",
+    // 5.19.0: a route_config purpose claim is checked server-side against
+    // the stored rule for this method + path, so it changes the verdict.
+    request.purposeSource || "",
+    request.requestMethod || "",
+    request.requestPath || ""
   ].join("|");
 }
 function getCachedResult(request, counterpartyId) {
@@ -4301,6 +4306,9 @@ async function callVerifyAccessAPI(config, request) {
   if (requestData.enableRuntimeChallenge)
     body.enableRuntimeChallenge = requestData.enableRuntimeChallenge;
   if (requestData.routePolicy) body.routePolicy = requestData.routePolicy;
+  if (config.actingProof?.connectorToken) {
+    body.actingProof = { connectorToken: config.actingProof.connectorToken };
+  }
   if (requestData.approvalHeldByRoute) body.approvalHeldByRoute = true;
   if (requestData.createSession) body.createSession = requestData.createSession;
   if (requestData.durationRequired) body.durationRequired = requestData.durationRequired;
@@ -4317,6 +4325,11 @@ async function callVerifyAccessAPI(config, request) {
   if (requestData.buyerEmail) body.buyerEmail = requestData.buyerEmail;
   if (requestData.commerceArtifacts) body.commerceArtifacts = requestData.commerceArtifacts;
   if (requestData.attemptId) body.attemptId = requestData.attemptId;
+  if (requestData.purposeSource) body.purposeSource = requestData.purposeSource;
+  if (requestData.agentArtifacts) body.agentArtifacts = requestData.agentArtifacts;
+  if (requestData.metadata) body.metadata = requestData.metadata;
+  if (requestData.requestMethod) body.requestMethod = requestData.requestMethod;
+  if (requestData.requestPath) body.requestPath = requestData.requestPath;
   if (requestData.considerationSet) body.considerationSet = requestData.considerationSet;
   body.sdkVersion = SDK_VERSION;
   if (requestData.callerMetadata || requestData.clientIp || requestData.userAgent) {
@@ -4463,22 +4476,43 @@ async function verify(config, request, options) {
       "[VerificationGateway] minTrustScore / minTrustScoreForFull are deprecated in v2.3.0 and have no effect. Server is now the single source of truth for access decisions (verified ID + runtime challenge + PDLSS + trust score). To gate access to an endpoint, configure the endpoint's trust_score_requirement server-side."
     );
   }
-  const uncacheable = Boolean(request.commerceArtifacts);
+  const uncacheable = Boolean(request.commerceArtifacts) || Boolean(mergedConfig.actingProof);
   if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
     const cached = getCachedResult(request, mergedConfig.counterpartyId);
     if (cached) {
       if (mergedConfig.debug) {
         console.log("[VerificationGateway] Returning cached result");
       }
-      const hit = { ...cached };
-      if (request.attemptId) {
-        hit.attemptId = request.attemptId;
-      } else {
-        delete hit.attemptId;
-      }
-      return hit;
+      return sharedVerdict(cached, request);
+    }
+  }
+  if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
+    const key = getCacheKey(request, mergedConfig.counterpartyId);
+    const pending = inflightVerifies.get(key);
+    if (pending) return sharedVerdict(await pending, request);
+    const flight = verifyViaApi(mergedConfig, request, urls, uncacheable);
+    inflightVerifies.set(key, flight);
+    try {
+      return await flight;
+    } finally {
+      inflightVerifies.delete(key);
     }
   }
+  return verifyViaApi(mergedConfig, request, urls, uncacheable);
+}
+var inflightVerifies = /* @__PURE__ */ new Map();
+var sharedVerdicts = /* @__PURE__ */ new WeakSet();
+function sharedVerdict(source, request) {
+  const hit = { ...source };
+  if (request.attemptId) {
+    hit.attemptId = request.attemptId;
+  } else {
+    delete hit.attemptId;
+  }
+  sharedVerdicts.add(hit);
+  return hit;
+}
+async function verifyViaApi(mergedConfig, request, urls, uncacheable) {
   const enrichedRequest = { ...request };
   if (!enrichedRequest.counterpartyUrl && mergedConfig.counterpartyUrl) {
     enrichedRequest.counterpartyUrl = mergedConfig.counterpartyUrl;
@@ -4506,9 +4540,18 @@ async function verify(config, request, options) {
   if (!apiResponse.access?.allowed) {
     const aggregatedFailures = apiResponse.access?.failures;
     const idVerifiedFromBackend = apiResponse.verificationContext?.idVerified === true && !aggregatedFailures?.some((f) => REJECTED_IDENTITY_DIMENSIONS.has(f.dimension));
+    const denyAgent = idVerifiedFromBackend && apiResponse.agent ? {
+      astraId: apiResponse.agent.astraId,
+      name: apiResponse.agent.name,
+      trustScore: apiResponse.agent.trustScore,
+      trustLevel: getTrustLevel(apiResponse.agent.trustScore),
+      blockchainAnchored: apiResponse.agent.blockchainStatus === "anchored",
+      status: apiResponse.agent.agentStatus
+    } : void 0;
     const result2 = {
       identityVerified: idVerifiedFromBackend,
       policyAllowed: false,
+      ...denyAgent && { agent: denyAgent },
       // 3.6.0: the server now emits top-level denialReasons on every deny
       // path — prefer it verbatim; the failure-message reconstruction remains
       // as the fallback for older backends.
@@ -4548,7 +4591,9 @@ async function verify(config, request, options) {
       fulfilment: apiResponse.fulfilment,
       mandates: apiResponse.mandates,
       kyaToken: apiResponse.kyaToken,
-      aep: apiResponse.aep
+      aep: apiResponse.aep,
+      // 5.20.0 (round 29.1): non-fatal integration warnings (e.g. events_url_missing).
+      warnings: apiResponse.warnings
     };
     return result2;
   }
@@ -4616,7 +4661,9 @@ async function verify(config, request, options) {
     // 5.15.0: merchant-lane AP2 mandates + KYAPay identity token.
     mandates: apiResponse.mandates,
     kyaToken: apiResponse.kyaToken,
-    aep: apiResponse.aep
+    aep: apiResponse.aep,
+    // 5.20.0 (round 29.1): non-fatal integration warnings (e.g. events_url_missing).
+    warnings: apiResponse.warnings
   };
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
@@ -4642,8 +4689,18 @@ async function verify(config, request, options) {
       cacheResult(request, result, mergedConfig.cacheTtl, mergedConfig.counterpartyId);
     }
   }
+  notifyVerificationListeners(request, result);
   return result;
 }
+var verificationListeners = /* @__PURE__ */ new Set();
+function notifyVerificationListeners(request, result) {
+  for (const listener of verificationListeners) {
+    try {
+      listener(result, request);
+    } catch {
+    }
+  }
+}
 
 // src/adapters/stepup-poll.ts
 var FALLBACK_MAX_WAIT_MS = 5 * 60 * 1e3;
@@ -4654,6 +4711,9 @@ var MAX_TOTAL_BYTES = 16 * 1024;
 // src/adapters/commerce-detect.ts
 var MAX_BODY_BYTES = 64 * 1024;
 
+// src/adapters/routes-cache.ts
+var DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;
+
 // src/edge-config.ts
 var DEFAULT_EDGE_CONFIG = Object.freeze({
   version: 1,
@@ -4895,9 +4955,6 @@ var BeaconBuffer = class {
 };
 var beaconBuffer = new BeaconBuffer();
 
-// src/adapters/express.ts
-var DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;
-
 // src/adapters/nextjs.ts
 var DEFAULT_ROUTES_REFRESH_MS2 = 5 * 60 * 1e3;
 
@@ -4983,6 +5040,25 @@ var import_jose2 = require("jose");
 // src/idempotency/index.ts
 var DEFAULT_IDEMPOTENCY_TTL_MS = 24 * 60 * 60 * 1e3;
 
+// src/ucp/approval-events.ts
+var MemorySeenEvents = class {
+  constructor(max = 1e4) {
+    this.max = max;
+    this.ids = /* @__PURE__ */ new Set();
+  }
+  async has(eventId) {
+    return this.ids.has(eventId);
+  }
+  async add(eventId) {
+    if (this.ids.size >= this.max) {
+      const first = this.ids.values().next().value;
+      if (first !== void 0) this.ids.delete(first);
+    }
+    this.ids.add(eventId);
+  }
+};
+var defaultSeen = new MemorySeenEvents();
+
 // src/payments/kyapay.ts
 var import_jose4 = require("jose");
 
@@ -5022,7 +5098,9 @@ function toDecision(result) {
   if (result.identityVerified && result.policyAllowed) {
     return {
       recommendation: "ALLOW",
-      reason: result.agent?.trustScore ? `Verified (trust score ${result.agent.trustScore})` : "Verified",
+      // 5.19.0: the score is on `trustScore` for the merchant; `reason` is
+      // text a merchant may relay to the agent, so it never embeds the number.
+      reason: "Verified",
       trustScore: result.agent?.trustScore,
       sessionId: "sessionId" in result ? result.sessionId : void 0
     };