@astrasyncai/verification-gateway 5.16.0 → 5.17.1

package/dist/adapters/express.mjs

@@ -442,7 +442,7 @@ function routePolicyOf(route) {
 }
 
 // src/version.ts
-var SDK_VERSION = "5.16.0";
+var SDK_VERSION = "5.17.1";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -744,6 +744,7 @@ function getCacheKey(request, counterpartyId) {
     request.enableRuntimeChallenge ? "1" : "0",
     // 5.16.0: route policy changes the verdict (owners / challenge).
     request.routePolicy ? JSON.stringify(request.routePolicy) : "",
+    request.approvalHeldByRoute ? "1" : "0",
     // callerMetadata fields contribute to risk model; include the ones
     // backend reads. sourceIp/userAgent/forwardedFor change per-request
     // so their inclusion effectively forces a re-check for any varying
@@ -951,6 +952,7 @@ async function callVerifyAccessAPI(config, request) {
   if (requestData.enableRuntimeChallenge)
     body.enableRuntimeChallenge = requestData.enableRuntimeChallenge;
   if (requestData.routePolicy) body.routePolicy = requestData.routePolicy;
+  if (requestData.approvalHeldByRoute) body.approvalHeldByRoute = true;
   if (requestData.createSession) body.createSession = requestData.createSession;
   if (requestData.durationRequired) body.durationRequired = requestData.durationRequired;
   if (requestData.counterpartyType) body.counterpartyType = requestData.counterpartyType;
@@ -1282,6 +1284,8 @@ async function verify(config, request, options) {
   } else if (result.recommendation === "step_up_required" && result.identityVerified) {
     result.requiresStepUp = true;
     result.denialReasons = serverDenialReasons ?? result.recommendationReasons ?? ["Step-up verification required"];
+    const stepUpFailures = apiResponse.access?.failures;
+    if (stepUpFailures?.length) result.failures = stepUpFailures;
   }
   const escalates = result.requiresStepUp === true || result.requiresApproval === true || result.recommendation === "step_up_required";
   if (mergedConfig.cacheTtl !== 0 && result.recommendation !== "deny" && !escalates) {
@@ -1516,12 +1520,31 @@ function requiresHumanApproval(result) {
   return result.requiresStepUp === true || result.requiresApproval === true;
 }
 function annotateApprovalRequired(result) {
-  result.failures = [
-    ...result.failures ?? [],
-    { dimension: "commerce.intent.approval_required", message: APPROVAL_REASON }
-  ];
+  if (isDimensionApproval(result)) {
+    result.denialReasons = [DIMENSION_APPROVAL_REASON, ...result.denialReasons ?? []];
+    return;
+  }
+  const named = (result.failures ?? []).some(
+    (f) => f.dimension === "commerce.intent.approval_required"
+  );
+  if (!named) {
+    result.failures = [
+      ...result.failures ?? [],
+      { dimension: "commerce.intent.approval_required", message: APPROVAL_REASON }
+    ];
+  }
   result.denialReasons = [APPROVAL_REASON, ...result.denialReasons ?? []];
 }
+var DIMENSION_APPROVAL_REASON = "The agent's owner asked to approve this kind of request. The owner can approve or deny it in the AstraSync dashboard.";
+var DIMENSION_APPROVAL = /^pdlss\.[a-z_]+\.approval_required$/;
+function isDimensionApproval(result) {
+  const f = result.failures ?? [];
+  return f.some((x) => DIMENSION_APPROVAL.test(x.dimension)) && !f.some((x) => x.dimension === "commerce.intent.approval_required");
+}
+function onlyNeedsApproval(result) {
+  if (!result.policyAllowed || !requiresHumanApproval(result)) return false;
+  return (result.failures ?? []).every((f) => /\.approval_required$/.test(f.dimension));
+}
 
 // src/pdlss-pre-check.ts
 function performCounterpartyPreCheck(routeConfig, astraCreds, purpose) {
@@ -2485,6 +2508,7 @@ function createMiddleware(options) {
       const attemptHeader = req.headers["x-astra-attempt-id"];
       const inboundAttemptId = typeof attemptHeader === "string" && /^att_[0-9a-f]{32}$/.test(attemptHeader) ? attemptHeader : void 0;
       const commerceArtifacts = detectExpressCommerce(req);
+      const heldByRoute = options.approvalHeldByRoute?.(req) === true;
       const verificationRequest = {
         credentials,
         ...commerceArtifacts && { commerceArtifacts },
@@ -2496,6 +2520,7 @@ function createMiddleware(options) {
         counterpartyType: config.counterpartyType || "api",
         enableRuntimeChallenge,
         ...routePolicyOf(routeConfig) && { routePolicy: routePolicyOf(routeConfig) },
+        ...heldByRoute && { approvalHeldByRoute: true },
         durationRequired: astraCreds?.pdlss?.duration?.maxSessionDuration,
         ...txValue !== void 0 && { transactionValue: txValue },
         ...txCurrency && { currency: txCurrency },
@@ -2552,6 +2577,9 @@ function createMiddleware(options) {
         onDenied(result, req, res);
         return;
       }
+      if (heldByRoute && !result.stepUpApproval && onlyNeedsApproval(result)) {
+        return next();
+      }
       if (requiresHumanApproval(result)) {
         annotateApprovalRequired(result);
         if (shouldRecordDecisions && sessionId) {