@astrasyncai/verification-gateway 5.13.0 → 5.15.0

package/dist/edge-core/index.mjs

@@ -1,5 +1,5 @@
 // src/version.ts
-var SDK_VERSION = "5.13.0";
+var SDK_VERSION = "5.15.0";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -19,6 +19,29 @@ function withUserAgent(initHeaders) {
 }
 var sdkFetch = (input, init) => fetch(input, { ...init, headers: withUserAgent(init?.headers) });
 
+// src/route-pattern.ts
+function routePatternToRegExp(pattern, opts = {}) {
+  let source = "";
+  for (let i = 0; i < pattern.length; i++) {
+    const ch = pattern[i];
+    if (ch === "*") {
+      source += ".*";
+    } else if (ch === ":" && /[A-Za-z_]/.test(pattern[i + 1] ?? "") && (i === 0 || pattern[i - 1] === "/")) {
+      let j = i + 1;
+      while (j < pattern.length && /[A-Za-z0-9_]/.test(pattern[j])) j++;
+      source += "[^/]+";
+      i = j - 1;
+    } else {
+      source += ch.replace(/[.+?^${}()|[\]\\/]/g, "\\$&");
+    }
+  }
+  try {
+    return new RegExp(`^${source}$`, opts.caseInsensitive ? "i" : "");
+  } catch {
+    return null;
+  }
+}
+
 // src/edge-config.ts
 var DEFAULT_EDGE_CONFIG = Object.freeze({
   version: 1,
@@ -37,8 +60,7 @@ function matchEdgePathRule(rules, path) {
   return void 0;
 }
 function globToRegExp(pattern) {
-  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
-  return new RegExp(`^${escaped}$`, "i");
+  return routePatternToRegExp(pattern, { caseInsensitive: true }) ?? /$^/;
 }
 
 // src/metadata-capture.ts
@@ -683,6 +705,7 @@ async function callVerifyAccessAPI(config, request) {
   if (requestData.invocationProtocol) body.invocationProtocol = requestData.invocationProtocol;
   if (requestData.commercePhase) body.commercePhase = requestData.commercePhase;
   if (requestData.checkoutSessionId) body.checkoutSessionId = requestData.checkoutSessionId;
+  if (requestData.checkoutJwt) body.checkoutJwt = requestData.checkoutJwt;
   if (requestData.checkoutItems) body.checkoutItems = requestData.checkoutItems;
   if (requestData.buyerEmail) body.buyerEmail = requestData.buyerEmail;
   if (requestData.commerceArtifacts) body.commerceArtifacts = requestData.commerceArtifacts;
@@ -833,7 +856,8 @@ 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."
     );
   }
-  if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache) {
+  const uncacheable = Boolean(request.commerceArtifacts);
+  if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
     const cached = getCachedResult(request, mergedConfig.counterpartyId);
     if (cached) {
       if (mergedConfig.debug) {
@@ -914,7 +938,10 @@ async function verify(config, request, options) {
       // MERCHANT caller only (bridge callers strip it before the agent plane).
       settlementToken: apiResponse.settlementToken,
       // 5.6.0: fulfilment contact — merchant-only lane, same strip rule.
-      fulfilment: apiResponse.fulfilment
+      fulfilment: apiResponse.fulfilment,
+      mandates: apiResponse.mandates,
+      kyaToken: apiResponse.kyaToken,
+      aep: apiResponse.aep
     };
     return result2;
   }
@@ -924,7 +951,10 @@ async function verify(config, request, options) {
     trustScore: apiResponse.agent.trustScore,
     trustLevel: getTrustLevel(apiResponse.agent.trustScore),
     blockchainAnchored: apiResponse.agent.blockchainStatus === "anchored",
-    status: apiResponse.agent.agentStatus
+    status: apiResponse.agent.agentStatus,
+    ...apiResponse.agent.protocolIdentities && {
+      protocolIdentities: apiResponse.agent.protocolIdentities
+    }
   } : void 0;
   const developer = apiResponse.developer ? {
     astradId: apiResponse.developer.kyaOwnerId,
@@ -975,7 +1005,11 @@ async function verify(config, request, options) {
     settlementOutcome: apiResponse.settlementOutcome,
     settlementToken: apiResponse.settlementToken,
     // 5.6.0: fulfilment contact — merchant-only lane, same strip rule.
-    fulfilment: apiResponse.fulfilment
+    fulfilment: apiResponse.fulfilment,
+    // 5.15.0: merchant-lane AP2 mandates + KYAPay identity token.
+    mandates: apiResponse.mandates,
+    kyaToken: apiResponse.kyaToken,
+    aep: apiResponse.aep
   };
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
@@ -995,7 +1029,9 @@ async function verify(config, request, options) {
   }
   const escalates = result.requiresStepUp === true || result.requiresApproval === true || result.recommendation === "step_up_required";
   if (mergedConfig.cacheTtl !== 0 && result.recommendation !== "deny" && !escalates) {
-    cacheResult(request, result, mergedConfig.cacheTtl, mergedConfig.counterpartyId);
+    if (!uncacheable) {
+      cacheResult(request, result, mergedConfig.cacheTtl, mergedConfig.counterpartyId);
+    }
   }
   return result;
 }
@@ -1194,7 +1230,7 @@ function detectCommerce(req, host) {
       };
     }
   }
-  if (authHeader && /^Payment\s+/i.test(authHeader)) {
+  if (authHeader && /^Payment\s+/i.test(authHeader) || headerValue(req, "payment-authorization")) {
     return {
       protocol: "mpp",
       artifacts: {
@@ -1209,7 +1245,7 @@ function detectCommerce(req, host) {
       evidence: truncated
     };
   }
-  if (headerValue(req, "x-payment")) {
+  if (headerValue(req, "payment-signature") || headerValue(req, "x-payment")) {
     return {
       protocol: "x402",
       artifacts: {
@@ -1534,6 +1570,11 @@ async function withBudget(promise, ms) {
     if (timer) clearTimeout(timer);
   }
 }
+var CONTAINER_ID = (() => {
+  const c = globalThis.crypto;
+  if (c?.randomUUID) return c.randomUUID();
+  return `c-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
+})();
 var destKeyOf = (d) => `${d.apiBaseUrl}\0${d.apiKey ?? ""}\0${d.counterparty}\0${d.adapter ?? ""}`;
 var BeaconBuffer = class {
   constructor(options = {}) {
@@ -1541,6 +1582,7 @@ var BeaconBuffer = class {
     this.droppedSinceLast = 0;
     this.droppedTotal = 0;
     this.deliveredTotal = 0;
+    this.enqueuedTotal = 0;
     this.backoffUntil = 0;
     this.collapse = /* @__PURE__ */ new Map();
     /** Keys the backend answered 401 for — later batches go unauthenticated. */
@@ -1553,13 +1595,16 @@ var BeaconBuffer = class {
       collapseMaxKeys: options.collapseMaxKeys ?? 1e3,
       requestTimeoutMs: options.requestTimeoutMs ?? 1e4,
       retryBackoffMs: options.retryBackoffMs ?? 1e3,
+      holdRepeats: options.holdRepeats ?? false,
+      containerId: options.containerId ?? CONTAINER_ID,
       now: options.now ?? Date.now
     };
   }
   /**
    * Queue one beacon. With a `collapseKey`, a repeat inside the window is
-   * merged into a held aggregate (sent when the window closes) instead of
-   * becoming its own item.
+   * merged into this key's item while that item is still queued (not yet in
+   * flight). Once it has left, the repeat becomes a new item, sendable on
+   * this flush — nothing waits for a later invocation (round 27.6).
    */
   enqueue(dest, item, collapseKey) {
     const now = this.opts.now();
@@ -1572,12 +1617,15 @@ var BeaconBuffer = class {
             return;
           }
         }
-        const held = this.push(
-          dest,
-          { ...item, repeatCount: 1 },
-          entry.firstSeenAt + this.opts.collapseWindowMs
-        );
-        entry.held = held;
+        if (this.opts.holdRepeats) {
+          entry.held = this.push(
+            dest,
+            { ...item, repeatCount: 1 },
+            entry.firstSeenAt + this.opts.collapseWindowMs
+          );
+          return;
+        }
+        entry.first = this.push(dest, { ...item, repeatCount: 1 }, now);
         return;
       }
       this.collapse.delete(collapseKey);
@@ -1613,6 +1661,7 @@ var BeaconBuffer = class {
       droppedSinceLast: this.droppedSinceLast,
       droppedTotal: this.droppedTotal,
       deliveredTotal: this.deliveredTotal,
+      enqueuedTotal: this.enqueuedTotal,
       flushing: this.inFlight !== void 0
     };
   }
@@ -1627,6 +1676,7 @@ var BeaconBuffer = class {
       inFlight: false
     };
     this.queue.push(entry);
+    this.enqueuedTotal += 1;
     return entry;
   }
   dropOldest() {
@@ -1672,7 +1722,11 @@ var BeaconBuffer = class {
       droppedSinceLast: reportedDropped,
       queueDepth: this.queue.length,
       adapter: dest.adapter ?? "edge-core",
-      version: SDK_VERSION
+      version: SDK_VERSION,
+      containerId: this.opts.containerId,
+      enqueuedTotal: this.enqueuedTotal,
+      deliveredTotal: this.deliveredTotal,
+      droppedTotal: this.droppedTotal
     };
     const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
     const response = await withBudget(
@@ -1853,6 +1907,7 @@ function outcomeFromVerifyResult(classification, result) {
     outcome.reasons = ["step-up approval required"];
     outcome.stepUp = {
       pollUrl: result.stepUpApproval?.pollUrl,
+      approvalUrl: result.stepUpApproval?.approvalUrl,
       expiresAt: result.stepUpApproval?.expiresAt
     };
     return outcome;
@@ -1998,6 +2053,20 @@ async function evaluateEdgeRequest(options, req, config, apiKey) {
     if (classification.tier === "human" || classification.tier === "self") {
       return { policy, classification, application: passUntouched() };
     }
+    const tls = checkMinTls(req, config.minTls);
+    if (tls) {
+      if (policy.mode === "enforce") {
+        options.log?.(
+          "info",
+          `TLS ${tls.negotiated} below ${tls.minimum}: ${req.method} ${req.uri}`
+        );
+        return { policy, classification, application: tlsUpgradeRequired(tls) };
+      }
+      options.log?.(
+        "info",
+        `[OBSERVE] would have required TLS ${tls.minimum} (got ${tls.negotiated}): ${req.method} ${req.uri}`
+      );
+    }
     const outcome = await runTier(options, req, classification, policy, apiKey, {
       sampling: policy.sampling ?? config.sampling,
       queryValueAllowlist: config.queryValueAllowlist
@@ -2022,6 +2091,34 @@ async function evaluateEdgeRequest(options, req, config, apiKey) {
     return { policy, application: passUntouched() };
   }
 }
+function negotiatedTlsVersion(req) {
+  const raw = req.connection?.tlsVersion ?? headerValue(req, "cloudfront-viewer-tls");
+  const m = raw ? /^TLSv(1(?:\.\d)?)/i.exec(raw) : null;
+  return m ? m[1] === "1" ? "1.0" : m[1] : null;
+}
+function checkMinTls(req, minTls) {
+  if (!minTls) return null;
+  const negotiated = negotiatedTlsVersion(req);
+  if (!negotiated) return null;
+  return Number(negotiated) < Number(minTls) ? { minimum: minTls, negotiated } : null;
+}
+function tlsUpgradeRequired(v) {
+  return {
+    action: "respond",
+    status: 426,
+    headers: {
+      "content-type": "application/json",
+      upgrade: `TLS/${v.minimum}`,
+      connection: "Upgrade"
+    },
+    bodyJson: {
+      error: "tls_version_too_low",
+      minimum: `TLS ${v.minimum}`,
+      negotiated: `TLS ${v.negotiated}`,
+      message: `This endpoint requires TLS ${v.minimum} or later for agent requests. Reconnect with TLS ${v.minimum}.`
+    }
+  };
+}
 export {
   ASAT_HEADERS,
   BeaconBuffer,
@@ -2031,12 +2128,14 @@ export {
   buildManualReviewBody,
   buildObservedMetadata,
   buildVerificationRequest,
+  checkMinTls,
   classify,
   detectCommerce,
   emitBeacon,
   evaluateEdgeRequest,
   getBeaconBuffer,
   headerValue,
+  negotiatedTlsVersion,
   outcomeFromVerifyResult,
   passUntouched,
   requestUrl,