@agent-cards/sdk 0.23.19 → 0.23.21

package/dist/client.js

@@ -2,7 +2,11 @@ import { BUILTIN_REGISTRY, cardUrlPatterns as deriveCardUrlPatterns, LOOPBACK_UR
 import { armServedProfiles, classifyProfileRequest, declareSandboxMerchant, merchantProfileEnvironment, merchantProfileFor, merchantProfileUrlPatterns, } from './merchant-hosted.js';
 import { merchantAmountExchanges, merchantAmountFromResponses, merchantProfilePricedBySource, merchantTotalWire, MerchantTotalWait, } from './merchant-total.js';
 import { ACI_CAPABILITY, ACI_PSP, aciCardLegAnswer } from './aci.js';
+import { PRZELEWY24_CAPABILITY, PRZELEWY24_PSP } from './przelewy24.js';
 import { EPROTECT_CAPABILITY, EPROTECT_PSP, eprotectCheckoutRefusal, eprotectScriptAnswer, isEprotectRegistration } from './eprotect.js';
+import { COMGATE_CAPABILITY, COMGATE_PSP } from './comgate.js';
+import { isHostedGetEntry } from './hosted-entry.js';
+import { TRANSBANK_CAPABILITY, TRANSBANK_PSP } from './transbank.js';
 import { isMercadoTokenRequest, parseMercadoCheckoutContext, validateMercadoProcessorContext } from './mercado-checkout.generated.js';
 import { matchesPreparation, preparationMode, validPreparationEnvironment } from './prepared-processor.js';
 import { fiservKeyPinById, isFiservSubstitution, requiresFiservPreparation } from './fiserv.js';
@@ -16,7 +20,9 @@ import { SHIJI_STS_CAPABILITY, SHIJI_STS_PSP, isShijiStsServedCompanion, isShiji
 import { AMADEUS_CHECKOUT_CAPABILITY, AMADEUS_CHECKOUT_PSP } from './amadeus-checkout.generated.js';
 import { PADDLE_VGS_CAPABILITY, PADDLE_VGS_PSP, paddleVgsCardFactsOf } from './paddle-vgs.generated.js';
 import { PADDLE_TOKENEX_CAPABILITY, PADDLE_TOKENEX_PSP, isPaddleTokenexServedFacts, isPaddleTokenexServedSubstitution } from './paddle-tokenex.js';
+import { TWOC2P_CAPABILITY, TWOC2P_PSP } from './twoc2p.js';
 import { WIX_PAYMENTS_CAPABILITY, WIX_PAYMENTS_PSP } from './wix-payments.generated.js';
+import { HIPAY_CAPABILITY, HIPAY_PSP } from './hipay.generated.js';
 import { classifyStripeCheckoutRequest, encodeStripeCheckoutContext, hasStripeCheckoutMarker, parseStripeCheckoutContext, parseStripeCheckoutResponse, STRIPE_CHECKOUT_CONTEXT_HEADER, } from './stripe-checkout.generated.js';
 import { VoiceModule } from './voice.js';
 import { BuyModule } from './buy.js';
@@ -30,6 +36,7 @@ import { JUSPAY_CAPABILITY, JUSPAY_PSP, juspayPageAnswer } from './juspay-gate.j
 import { CARD_ENDPOINT_MODE, CARD_ENDPOINT_PSP, CardEndpointRefusedError, cardEndpointById, cardEndpointLive, cardEndpointSessionRefusal, } from './card-endpoint.js';
 import { merchantCardEndpointFactsRefusal as sharedFactsRefusal, readMerchantCardEndpointFacts as sharedReadFacts, } from './merchant-card-endpoints.generated.js';
 import { DATATRANS_CAPABILITY } from './datatrans.js';
+import { TOKENEX_IFRAME_CAPABILITY, TOKENEX_IFRAME_PSP, tokenexIframePageAnswer, tokenexIframePlaceholderFits } from './tokenex-iframe.js';
 import { PELECARD_CAPABILITY, PELECARD_PSP } from './pelecard.js';
 import { PRIMER_CAPABILITY, PRIMER_PSP, primerTokenAnswer } from './primer.js';
 import { PAYRAILS_CAPABILITY, isPayrailsPaymentUrl, payrailsAnswer } from './payrails.js';
@@ -226,6 +233,13 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * checkout relay. Served on the same terms: only to a build that lists it, for a company
  * Agentcard turned Payfast on for.
  *
+ * `przelewy24_hosted_payment_page`: Przelewy24's pay wall, whose card-free link
+ * (secure.przelewy24.pl/trnRequest/<token>, a plain GET the merchant's redirect or script sends
+ * the buyer to) this build pauses for the cardholder's device by its exact link (hosted-entry.ts),
+ * and whose card method post, card form post and Saferpay resolver this build never lets the
+ * agent's browser send (pre-claim.ts, przelewy24.ts). Served on the same terms as NMI's and
+ * Redsys's: only to a build that lists it, for a company Agentcard turned Przelewy24 on for.
+ *
  * `wix_payments_tokenize`: the card request Wix Cashier's card frame sends to Wix's
  * tokenizer (cashier-pci.wixapps.net), only through a prepared checkout: Wix's payment
  * widget fails the payment 30 seconds after it asks the frame for a token. The
@@ -241,9 +255,120 @@ export const SUPPORTED_REGISTRY_FEATURES = ['card_fields', 'checkout_sessions'];
  * that the page then runs in the agent's browser. The cardholder's device sends the card through
  * the checkout relay. Served on the same terms: only to a build that lists it, for a company
  * Agentcard turned PayMongo on for.
+ *
+ * `gopay_card_form`: the card post GoPay's card frame sends to its own URL
+ * (secure.gopay.com/gp-card-comm/h/<token>) inside the GoPay gateway a shop opens. This build pauses
+ * only the frame's own card post and answers it with GoPay's answer as the API recorded it, the
+ * empty JSON object the frame reads; the gateway then reads the payment's end from GoPay and runs
+ * 3-D Secure in the agent's browser when the bank asks for it. The cardholder's device sends the card
+ * through the checkout relay. Served only to a build that lists it, and only for Agentcard's proof
+ * company until a reviewed change binds GoPay's payee and amount to the approval: the post names
+ * neither. The API takes it only at a shop Agentcard reviewed.
+ *
+ * `hipay_vault_token`: the token create HiPay's hosted fields send to HiPay's Secure Vault
+ * (secure2-vault.hipay-tpp.com, stage-secure2-vault for a test row), only through a prepared
+ * checkout: the merchant's page gives the frame 20 seconds after Pay. The cardholder's device
+ * sends the card to HiPay directly and the frame gets back HiPay's token. The number-only post
+ * the frame sends while the number is typed, and its /update once it holds a token, fail in the
+ * browser (pre-claim.ts hipayPreClaim). Served on the same terms: only to a build that lists it,
+ * for a company Agentcard turned HiPay on for.
+ *
+ * `twoc2p_secure_pay`: the Payment 2C2P's hosted payment page posts to its payment API
+ * (pgwv4.2c2p.com), carrying the card only as one field the page encrypts under 2C2P's static
+ * key. This build pauses it and writes over the placeholder's field the one the cardholder's
+ * device wrote under the key payment-core pins (twoc2p.ts), into that Payment alone; 3-D Secure
+ * then runs in the agent's browser. Served only to a build that lists it, and only for Agentcard's
+ * proof company, whatever the API's processor lists name: the field is the card under 2C2P's one
+ * static key, which any 2C2P merchant could charge.
+ *
+ * `quickpay_hosted_payment_page`: QuickPay's hosted payment window, whose card-free signed entry
+ * this build pauses for the cardholder's device and whose card post, fee lookup, wallet post, 3-D
+ * Secure step and card lookup this build never lets the agent's browser send (pre-claim.ts,
+ * quickpay.ts). Served on the same terms as NMI's and Redsys's: only to a build that lists it, for a
+ * company Agentcard turned QuickPay on for.
+ *
+ * `revolut_card_field`: the card payment Revolut Business's card field or card popup sends from
+ * its frame to /api/public/orders/<order token>/payments on merchant.revolut.com, on a merchant's
+ * own page or Revolut's hosted checkout. This build pauses only the frame's card payment and
+ * answers it with Revolut's answer as the API recorded it: the payment Revolut created, which the
+ * frame then follows, through any 3-D Secure step, in the agent's browser. A payment by Apple Pay,
+ * Google Pay or Revolut Pay on the same URL carries no card and continues untouched. Revolut's
+ * host answers the Vault's origin, so the cardholder's device sends the card itself, with no relay.
+ * Served on the same terms: only to a build that lists it, for a company Agentcard turned Revolut
+ * on for.
+ *
+ * `pay_nl_card_token`: the card token request a shop's card form sends to Pay. (pay.nl),
+ * Weeztix's sandboxed frame posting its FormData to payment.pay.nl/v1/Payment/getCardToken/json.
+ * This build pauses only the form's own multipart body at that exact URL; the cardholder's
+ * device sends the card through the checkout relay, and the frame gets the token answer
+ * payment-core's judge rebuilt, with the CORS answer for the frame's own origin, null. The
+ * request names no amount, so the agent's pair, above zero, is the one the cardholder approves
+ * (PAY_NL_PSP below). Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned Pay. on for.
+ *
+ * `paypal_card_fields`: PayPal Card Fields' confirm, the POST its v5 frame sends to
+ * www.paypal.com and its v6 frame to api-m.paypal.com. This build pauses it only in
+ * the frames' own shape, refuses one that asks PayPal to keep the card or forces
+ * 3-D Secure in the browser with a `blocked` event, and answers the frame with the
+ * order's id and status as the API recorded them. The device sends a v5 confirm
+ * through the checkout relay and a v6 one directly. Served on the same terms: only
+ * to a build that lists it, for a company Agentcard turned PayPal Card Fields on
+ * for. Every other company keeps the checkout guard's refusal (paypal-card-forms.ts).
+ *
+ * `comgate_hosted_payment_page`: ComGate's payment gateway, whose card-free gateway link
+ * (payN.comgate.cz/init?id=<transaction id>, a plain GET) this build pauses for the
+ * cardholder's device by its exact link (hosted-entry.ts), in the page, in a frame of it or
+ * in a window it opened, and whose card hosts this build never lets the agent's browser post
+ * to (pre-claim.ts, comgate.ts). Served on the same terms as NMI's and Redsys's: only to a
+ * build that lists it, for a company Agentcard turned ComGate on for.
+ *
+ * `makecommerce_card_frame`: the card post MakeCommerce's card frame sends to its own card endpoint
+ * (cc.maksekeskus.ee/card-payment) under the shop's publishable key. This build pauses only the
+ * frame's own one-time card payment and answers it with MakeCommerce's answer as the API recorded
+ * it: the URL of MakeCommerce's 3-D Secure page, which the frame then opens in the agent's browser.
+ * The cardholder's device sends the card through the checkout relay. Served on the same terms: only
+ * to a build that lists it, for a company Agentcard turned MakeCommerce on for.
+ *
+ * `poynt_collect_nonce`: GoDaddy Payments' card request, the POST Poynt Collect's
+ * card frame sends to a store's generate-nonce on services.poynt.net. This build
+ * pauses it only as the frame writes it, refuses a body that asks Poynt to keep the
+ * card in the browser with a `blocked` event, and answers the frame with the nonce as
+ * the API recorded it. The device sends the card through the checkout relay. Served
+ * on the same terms: only to a build that lists it, for a company Agentcard turned
+ * GoDaddy Payments on for.
+ *
+ * `tokenex_iframe_tokenize`: the card post TokenEx's hosted iframe v3 sends from its card-number frame
+ * to its own document URL on htp.tokenex.com (JetBlue's card form). This build pauses only the PCI frame's
+ * own card post with its CVV frame, refuses in the browser every other post on that path that carries a
+ * card (tokenex-iframe.ts), answers it with TokenEx's token as the API recorded it, rebuilt from
+ * payment-core's allow-list, and answers the same frame's byte-identical repeat from that answer while the
+ * approval is being handed off. Served on the same terms: only to a build that lists it, for a company
+ * Agentcard turned the TokenEx iframe on for.
+ *
+ * `transbank_webpay_hosted_payment_page`: Transbank's Webpay Plus, whose card-free entry
+ * (webpay3g.transbank.cl/webpayserver/initTransaction?token_ws=<token>, the merchant's
+ * redirect, a plain GET) this build pauses for the cardholder's device by its exact link
+ * (hosted-entry.ts) in the page or a frame of it, and with attachToCdp also in a window the
+ * page opened, and whose hosts this build never lets the agent's browser post to (pre-claim.ts,
+ * transbank.ts), so the token is never spent there. attachToPlaywright covers the page it is
+ * attached to and that page's frames only, and pauses only a direct or scripted navigation to
+ * the entry: its page.route sees no HTTP redirect hop, so a merchant's redirect needs attachToCdp.
+ * Served on the same terms as NMI's and Redsys's: only to a build that lists it, for a company
+ * Agentcard turned Webpay on for.
+ *
+ * `sumup_checkout_process`: the card request SumUp's Payment Widget sends from its hidden form frame
+ * on gateway.sumup.com, a PUT to https://api.sumup.com/v0.2/checkouts/<checkout id>. This build pauses
+ * that PUT as it pauses Gravy's, so only the CDP and Playwright adapters see it (the form frame is
+ * cross-origin to the page), and answers the frame with SumUp's own answer as the API recorded it: the
+ * paid checkout, or the 3-D Secure step the widget then runs in the agent's browser. The cardholder's
+ * device sends the card itself, and the API holds the payment to a merchant Agentcard reviewed, at the
+ * amount SumUp holds for the checkout. Served on the same terms: only to a build that lists it, for a
+ * company Agentcard turned SumUp on for.
  */
 export const SUPPORTED_CAPABILITIES = ['fiserv_card_capture', GMO_CAPABILITY, CYBERSOURCE_FLEX_CAPABILITY, JUSPAY_CAPABILITY, DATATRANS_CAPABILITY, 'authorize_net_dpm_form', PELECARD_CAPABILITY, ACI_CAPABILITY, 'creditguard_pps_process', PRIMER_CAPABILITY, PAYRAILS_CAPABILITY, CONVERGE_CAPABILITY, EPROTECT_CAPABILITY, WSPAY_CAPABILITY, SHIJI_STS_CAPABILITY, AMADEUS_CHECKOUT_CAPABILITY, 'worldline_mycheckout_form', 'verifone_card_capture', 'ekashu_hosted_payment_page', SECURE_ACCEPTANCE_CAPABILITY, 'gravy_session_fields_put', 'moneris_hosted_tokenization', PADDLE_VGS_CAPABILITY, PADDLE_TOKENEX_CAPABILITY,
-    'redsys_hosted_payment_page', 'lyra_krypton_payment', 'payfast_card_pay', WIX_PAYMENTS_CAPABILITY, 'paymongo_checkout_pay'];
+    'redsys_hosted_payment_page', 'lyra_krypton_payment', 'payfast_card_pay', WIX_PAYMENTS_CAPABILITY, 'paymongo_checkout_pay', 'pay_nl_card_token', HIPAY_CAPABILITY, TWOC2P_CAPABILITY, 'quickpay_hosted_payment_page', 'revolut_card_field', 'paypal_card_fields', 'gopay_card_form', COMGATE_CAPABILITY, PRZELEWY24_CAPABILITY, 'makecommerce_card_frame', 'poynt_collect_nonce',
+    TOKENEX_IFRAME_CAPABILITY, TRANSBANK_CAPABILITY,
+    'sumup_checkout_process'];
 /**
  * Processors whose paused request names no amount at all, so the pair the
  * agent passes is the amount the cardholder approves: authorize() refuses one
@@ -275,15 +400,68 @@ export const SUPPORTED_CAPABILITIES = ['fiserv_card_capture', GMO_CAPABILITY, CY
  * PayMongo's card attach carries none either: the merchant bound the total, always in
  * Philippine pesos, to the checkout session when it created it, so the agent sends that
  * total, above zero (PAYMONGO_PSP below), and the API holds it to the session PayMongo's
- * own page shows.
+ * own page shows. GoPay's card post carries none either: the shop's server set the amount
+ * when it created the payment at GoPay, and GoPay's gateway shows it only inside its own
+ * session, so the agent sends the total the gateway shows, above zero (GOPAY_PSP below).
+ * 2C2P's Payment carries none either: the merchant bound the total to the
+ * payment token when it created it, so the agent sends the total 2C2P's page shows, above
+ * zero (TWOC2P_PSP), and the API holds it to the amount 2C2P's own PaymentOption answer names.
+ * Przelewy24's pay wall link carries none either: the merchant's server registered the amount
+ * with Przelewy24 under the link's token, so the agent sends the amount the pay wall shows, above
+ * zero (PRZELEWY24_PSP below), and the cardholder's device holds the pay wall to it.
+ * HiPay's token create carries none either: the merchant's server charges
+ * HiPay's token for its own order, so the agent's pair, which the prepared checkout carries,
+ * is the total the cardholder approves, above zero as Moneris's is. Revolut's card payment
+ * names the order's amount in minor units but not its currency, which only the order holds,
+ * so the number alone is no price the cardholder can approve: the agent sends the pair, above
+ * zero (REVOLUT_PSP below), and the API holds its amount to the body's and its currency to
+ * one that Revolut and the API both count in hundredths.
+ * Pay.'s card token request carries none either: the shop's server charges the token later for
+ * its own order total, so the agent's pair, above zero (PAY_NL_PSP below), is the one figure the
+ * approval shows.
+ * PayPal Card Fields' confirm carries none either: the merchant's server fixed the
+ * amount when it created the order, so the agent's pair, above zero (PAYPAL_PSP
+ * below), is the one figure the approval shows.
+ * ComGate's gateway link carries none either: the merchant's server set
+ * the amount when it created the payment at ComGate, so the agent's pair, above zero
+ * (COMGATE_PSP below), is the figure the cardholder approves, and the cardholder's device
+ * holds ComGate's own figure to it before any card leaves.
+ * MakeCommerce's card post carries none either: MakeCommerce's transaction holds the total, in
+ * euros, so the agent sends the total the shop's order page shows, above zero (MAKECOMMERCE_PSP
+ * below), and the API refuses any other currency.
+ * GoDaddy Payments' generate-nonce carries none either: GoDaddy's server charges
+ * the nonce later, so its pair must be above zero too (POYNT_PSP below).
+ * The TokenEx iframe's card post carries none either: it mints a token into the merchant's TokenEx
+ * vault, which the merchant's server charges later for its own order, so the agent sends the total
+ * the merchant's page shows, above zero (TOKENEX_IFRAME_PSP), and the API refuses a create without it.
+ * Webpay's entry carries none either: the merchant's server bound the total, in Chilean pesos,
+ * to the transaction when it created it, so the agent's pair, above zero (TRANSBANK_PSP below),
+ * is the figure the cardholder approves, and the cardholder's device holds Webpay's own
+ * transaction to it before any card leaves.
+ * SumUp's card request carries none either: the merchant's server bound the
+ * total and its currency to the checkout when it created it, so the agent sends the total the
+ * payment page shows, above zero (SUMUP_PSP below), and the API holds it to the checkout SumUp
+ * itself reports.
  */
 const MONERIS_PSP = 'moneris';
 const PAYFAST_PSP = 'payfast';
 const PAYMONGO_PSP = 'paymongo';
-const AGENT_AMOUNT_PROCESSORS = [GMO_PSP, PELECARD_PSP, WSPAY_PSP, SECURE_ACCEPTANCE_PSP, MONERIS_PSP, PADDLE_VGS_PSP, PAYFAST_PSP, WIX_PAYMENTS_PSP, PAYMONGO_PSP];
+const REVOLUT_PSP = 'revolut';
+const PAY_NL_PSP = 'pay_nl';
+const PAYPAL_PSP = 'paypal';
+const GOPAY_PSP = 'gopay';
+const MAKECOMMERCE_PSP = 'makecommerce';
+const POYNT_PSP = 'poynt';
+const SUMUP_PSP = 'sumup';
+const AGENT_AMOUNT_PROCESSORS = [GMO_PSP, PELECARD_PSP, WSPAY_PSP, SECURE_ACCEPTANCE_PSP, MONERIS_PSP, PADDLE_VGS_PSP, PAYFAST_PSP, WIX_PAYMENTS_PSP, PAYMONGO_PSP, PAY_NL_PSP, HIPAY_PSP, TWOC2P_PSP, REVOLUT_PSP, PAYPAL_PSP, GOPAY_PSP, COMGATE_PSP,
+    PRZELEWY24_PSP, MAKECOMMERCE_PSP, POYNT_PSP, TOKENEX_IFRAME_PSP, TRANSBANK_PSP, SUMUP_PSP];
 /** How AmountRequiredError names a processor. */
 const PROCESSOR_NAMES = { [GMO_PSP]: 'GMO', [PELECARD_PSP]: 'Pelecard', [WSPAY_PSP]: 'WSPay',
-    [SECURE_ACCEPTANCE_PSP]: 'CyberSource Secure Acceptance', [MONERIS_PSP]: 'Moneris', [PADDLE_VGS_PSP]: 'Paddle', [PAYFAST_PSP]: 'Payfast', [WIX_PAYMENTS_PSP]: 'Wix', [PAYMONGO_PSP]: 'PayMongo' };
+    [SECURE_ACCEPTANCE_PSP]: 'CyberSource Secure Acceptance', [MONERIS_PSP]: 'Moneris', [PADDLE_VGS_PSP]: 'Paddle', [PAYFAST_PSP]: 'Payfast', [WIX_PAYMENTS_PSP]: 'Wix', [PAYMONGO_PSP]: 'PayMongo', [PAY_NL_PSP]: 'Pay.', [HIPAY_PSP]: 'HiPay', [TWOC2P_PSP]: '2C2P',
+    [REVOLUT_PSP]: 'Revolut', [PAYPAL_PSP]: 'PayPal', [GOPAY_PSP]: 'GoPay',
+    [COMGATE_PSP]: 'ComGate', [PRZELEWY24_PSP]: 'Przelewy24',
+    [MAKECOMMERCE_PSP]: 'MakeCommerce', [POYNT_PSP]: 'GoDaddy Payments', [TOKENEX_IFRAME_PSP]: 'TokenEx', [TRANSBANK_PSP]: 'Webpay',
+    [SUMUP_PSP]: 'SumUp' };
 /**
  * Processors whose request and answer name no amount at all, so the total the
  * payment page shows (`pageAmount`) is the one figure that ties the agent's pair
@@ -514,13 +692,18 @@ const PROCESSOR_PLACEHOLDER_NUMBERS = Object.freeze({});
 /**
  * The placeholder number for a network (lowercase, as GET /api/v2/vault_cards names it) on a
  * processor's page: the processor's own number for that network when `overrides` names one, else
- * the network's default, else undefined for a network with no placeholder.
+ * the network's default, else undefined for a network with no placeholder. On a TokenEx iframe
+ * (`tokenex_iframe`) the number must also be one TokenEx's frame reads as that network, since the frame
+ * names the brand to the page from the typed digits and the cardholder's device refuses a mismatch: the
+ * frame's table takes Visa, Mastercard and American Express, so every other network gets undefined.
  */
 export function placeholderNumber(brand, psp, overrides = PROCESSOR_PLACEHOLDER_NUMBERS) {
     const own = psp !== undefined && Object.prototype.hasOwnProperty.call(overrides, psp) ? overrides[psp] : undefined;
-    if (own && Object.prototype.hasOwnProperty.call(own, brand))
-        return own[brand];
-    return Object.prototype.hasOwnProperty.call(PLACEHOLDER_NUMBERS, brand) ? PLACEHOLDER_NUMBERS[brand] : undefined;
+    const number = own && Object.prototype.hasOwnProperty.call(own, brand) ? own[brand]
+        : Object.prototype.hasOwnProperty.call(PLACEHOLDER_NUMBERS, brand) ? PLACEHOLDER_NUMBERS[brand] : undefined;
+    if (number !== undefined && psp === TOKENEX_IFRAME_PSP && !tokenexIframePlaceholderFits(brand, number))
+        return undefined;
+    return number;
 }
 /**
  * The recognizer says this processor is preparation-required, and no preparation
@@ -546,7 +729,9 @@ export class PreparationRequiredError extends Error {
  * when the merchant's server created the payment), so the `amount` and
  * `currency` you pass are what the cardholder approves, and for WSPay the
  * figure the API compares with WSPay's answer when that answer names one (a
- * 3-D Secure step names none). Thrown locally before any create or
+ * 3-D Secure step names none). A Revolut card payment names the order's
+ * amount but not its currency, so it takes the same pair, above zero.
+ * Thrown locally before any create or
  * prompt, and terminal: the same request without an amount fails the same
  * way. The API answers 400 amount_required for the same case. A page total
  * (`pageAmount`) does not count.
@@ -556,7 +741,8 @@ export class AmountRequiredError extends Error {
     code = 'amount_required';
     constructor(psp) {
         const processor = PROCESSOR_NAMES[psp] ?? psp;
-        super(`A ${processor} payment request names no amount, so pass amount and currency: that is the amount the cardholder approves. Nothing was created and nothing was charged.`);
+        const lacks = psp === REVOLUT_PSP ? 'names its amount but not its currency' : 'names no amount';
+        super(`A ${processor} payment request ${lacks}, so pass amount and currency: that is the amount the cardholder approves. Nothing was created and nothing was charged.`);
         this.psp = psp;
         this.name = 'AmountRequiredError';
     }
@@ -1154,12 +1340,19 @@ function maskPaymongoSession(path) {
  * https://secure.gopay.com/gp-card-comm/h/<hex token>?lang=..&ver=..&SG=<64 hex> (payment-core gopay.js). The
  * token names that payment's card form, and with the SG, which redactUrl drops with the query, anyone who holds
  * the URL can open the form and post a card to it. On GoPay's two card frame hosts the segment after /h/, in any
- * case or after an escaped slash, reads {token}: https://secure.gopay.com/gp-card-comm/h/{token}.
+ * case or after an escaped slash, reads {token}: https://secure.gopay.com/gp-card-comm/h/{token}. Then every run of
+ * 16 or more hex digits left reads {token} too, so a token after a path the frame never writes (an escaped h, a
+ * path parameter) is masked as well; the token is 16 hex digits or more, and no other path the card frame uses holds
+ * such a run. The pattern reads a percent escape as one unit: an escaped hex digit (%61, %2561) counts toward a run,
+ * so escaping some of a token's digits never splits it into runs that show, and any other escape (%2F, %252F, %68)
+ * is kept whole, so its own hex digits never start a run and leave part of a token showing.
  */
 const GOPAY_CARD_FORM_HOST = /^secure(?:\.sandbox)?\.gopay\.com\.?$/i;
 const GOPAY_CARD_FORM_TOKEN = new RegExp(`(${SLASH}h${SLASH}+)[^/?#]*`, 'gi');
+const GOPAY_TOKEN_RUN = /(?:[0-9a-f]|%(?:25)*(?:3[0-9]|[46][1-6])){16,}|%(?:25)*[0-9a-f]{2}/gi;
+const GOPAY_LONE_ESCAPE = /^%(?:25)*[0-9a-f]{2}$/i;
 function maskGopayToken(path) {
-    return path.replace(GOPAY_CARD_FORM_TOKEN, '$1{token}');
+    return path.replace(GOPAY_CARD_FORM_TOKEN, '$1{token}').replace(GOPAY_TOKEN_RUN, (run) => (GOPAY_LONE_ESCAPE.test(run) ? run : '{token}'));
 }
 /**
  * KOMOJU's Hosted Fields frame pays a session with POST /api/v1/sessions/<id>/pay on komoju.com under
@@ -1244,6 +1437,18 @@ const REVOLUT_HOST = /^(?:sandbox-)?(?:merchant|checkout|merchant-mgmt)\.revolut
 function maskRevolutToken(path) {
     return maskUuids(path, '{token}');
 }
+/**
+ * ComGate's gateway pages name the payment by its transaction id in their paths (pay1.comgate.cz/<id>,
+ * /specify/card2/<id>, payment-core processors/comgate.js), and the id alone opens that payment's gateway page, its
+ * amount and its merchant. Its entry link names the id in the query, which redactUrl drops. On every host ComGate
+ * owns, any id of its shape, in any case and with each hyphen in any spelling HYPHEN reads, reads {payment}. The
+ * pattern reads a percent escape as one unit and keeps it, as maskUuids does.
+ */
+const COMGATE_HOST = /(?:^|\.)comgate\.cz\.?$/i;
+const COMGATE_ID = new RegExp(`%(?:25)*[0-9a-f]{2}|[a-z0-9]{4}${HYPHEN}[a-z0-9]{4}${HYPHEN}[a-z0-9]{4}`, 'gi');
+function maskComgateId(path) {
+    return path.replace(COMGATE_ID, (token) => (token.startsWith('%') ? token : '{payment}'));
+}
 /**
  * Paytrail names its payment in the path of every route of its card method
  * (/payments/<transaction>/click-to-pay/loading-and-redirect, and its success and cancel routes), and the same id
@@ -1268,6 +1473,68 @@ function maskPaytrailTransaction(path) {
 function maskPaymentHighwaySession(path) {
     return maskPaytrailId(path, '{session}');
 }
+/**
+ * 2C2P's hosted payment page names its payment token in its hash routes (pgw-ui.2c2p.com/payment/<build>/#/token/
+ * <token>, #/info/<token>, #/mobile/process/<token>), and the token is all a browser needs to open that payment's page
+ * (payment-core twoc2p.js). redactUrl drops a fragment, but a URL whose `#` was escaped carries the route in its path,
+ * and then in any spelling: escaped or doubled separators, escaped letters, parameters. Nothing past the build's folder
+ * on 2C2P's page hosts is worth a log line, so everything after `/payment/<build>/`, its separators in any spelling
+ * SLASH reads, reads {token}, and on any other path everything after its first separator. A string that is not a URL
+ * is cut the same way after a whole page-host authority it names (at the start, or after a space, a quote, a bracket,
+ * a colon such as a `see:` before it, a comma, a semicolon, an equals sign or `//`, and followed by a path, a port or
+ * the end), and only up to the end of that URL, so the message's own words,
+ * another site's path naming the host and a lookalike host stay; a text naming several such URLs has each one cut.
+ * Anchored matches and cuts in one pass: no input makes it backtrack.
+ */
+const TWOC2P_PAGE_HOST = /^(?:sandbox-)?pgw-ui\.2c2p\.com\.?$/i;
+const TWOC2P_PAGE_FOLDER = new RegExp(`^${SLASH}payment${SLASH}4\\.[0-9]{1,2}${SLASH}`, 'i');
+const TWOC2P_FIRST_SEPARATOR = new RegExp(`^${SLASH}`, 'i');
+const TWOC2P_PAGE_AUTHORITY = `(?:^|[\\s"'(<\\[:,;=]|//)(?:sandbox-)?pgw-ui\\.2c2p\\.com\\.?(?::[0-9]{1,5})?(?=${SLASH}|$)`;
+/** One page path, from its first separator: the build's folder stays and the rest reads {token}. */
+function maskTwoC2pPath(path) {
+    const kept = TWOC2P_PAGE_FOLDER.exec(path) ?? TWOC2P_FIRST_SEPARATOR.exec(path);
+    const end = kept ? kept[0].length : 0;
+    return path.length > end ? `${path.slice(0, end)}{token}` : path;
+}
+/**
+ * Text that is not a URL: every whole page-host authority it names, each URL cut only to its own end (the first
+ * space, quote or bracket), so the words between and after them stay. A text that starts with a slash is read the
+ * same way, so another site's protocol-relative URL that names the host keeps its own host and path.
+ */
+function maskTwoC2pToken(path) {
+    const authority = new RegExp(TWOC2P_PAGE_AUTHORITY, 'gi');
+    // A closing bracket or parenthesis ends the URL only when no path or token character follows it, so a URL
+    // a message wraps in [] or () keeps the words after it, and a bracket inside the path still cannot end the cut early.
+    const urlEnd = /[\s"'<>]|[\])](?![A-Za-z0-9+/=%\\])/g;
+    let out = '';
+    let done = 0;
+    for (let host = authority.exec(path); host !== null; host = authority.exec(path)) {
+        const start = host.index + host[0].length;
+        urlEnd.lastIndex = start;
+        const stop = urlEnd.exec(path);
+        const end = stop ? stop.index : path.length;
+        out += path.slice(done, start) + maskTwoC2pPath(path.slice(start, end));
+        done = end;
+        authority.lastIndex = end;
+    }
+    return out + path.slice(done);
+}
+/**
+ * QuickPay's window names its session as the first segment of its own path (/<32 hex>, then /3ds_auth or
+ * /poll-response), and that id is what carries a card post into the payment the merchant's signed entry
+ * opened; a payment link's id (/payments/<64 hex>) opens one the same way. On QuickPay's host a run of 32 hex
+ * digits or more after a slash, in any case or escaped, reads {session} whatever follows it: a URL parser drops a
+ * newline after the URL, so words after it can run on into the id. The entry, the host's root, carries none.
+ */
+const QUICKPAY_HOST = /^payment\.quickpay\.net\.?$/i;
+const QUICKPAY_SESSION = /(\/|%2f)[0-9a-f]{32,}/gi;
+function maskQuickpaySession(path) {
+    return path.replace(QUICKPAY_SESSION, '$1{session}');
+}
+/**
+ * `mask` reads a text that names the processor's host; `pathMask`, where a processor has one, reads the path of a
+ * URL already parsed on that host, which `mask` reads otherwise.
+ */
 const PATH_CREDENTIALS = [
     { host: PATH_SECRET_HOST, named: /(?:wspay\.biz|monri\.com)/i, mask: maskPathSecret },
     { host: CREDITGUARD_HOST, named: /creditguard\.co\.il/i, mask: maskCreditguardTxId },
@@ -1286,8 +1553,11 @@ const PATH_CREDENTIALS = [
     { host: PRZELEWY24_HOST, named: /przelewy24\.pl/i, mask: maskPrzelewy24Token },
     { host: REVOLUT_HOST, named: /(?:merchant|checkout|merchant-mgmt)\.revolut\.com/i, mask: maskRevolutToken },
     { host: SUMUP_API_HOST, named: /api\.sumup\.com/i, mask: maskSumupCheckout },
+    { host: COMGATE_HOST, named: /comgate\.cz/i, mask: maskComgateId },
     { host: PAYTRAIL_HOST, named: /paytrail\.com/i, mask: maskPaytrailTransaction },
     { host: PAYMENT_HIGHWAY_HOST, named: /(?:paymenthighway\.io|sph-test-solinor\.com)/i, mask: maskPaymentHighwaySession },
+    { host: TWOC2P_PAGE_HOST, named: /pgw-ui\.2c2p\.com/i, mask: maskTwoC2pToken, pathMask: maskTwoC2pPath },
+    { host: QUICKPAY_HOST, named: /quickpay\.net/i, mask: maskQuickpaySession },
 ];
 /**
  * A URL as it may appear in an error message: origin + path only. A paused
@@ -1321,6 +1591,10 @@ const PATH_CREDENTIALS = [
  * On Paytrail's hosts a payment's id reads `{transaction}`:
  * https://services.paytrail.com/payments/{transaction}/click-to-pay/loading-and-redirect, and on Payment
  * Highway's a card page's session reads `{session}`.
+ * On 2C2P's page hosts everything after the build's folder reads `{token}`:
+ * https://pgw-ui.2c2p.com/payment/4.1/{token}.
+ * On QuickPay's host the window's session reads `{session}`:
+ * https://payment.quickpay.net/{session}/3ds_auth.
  * A string that is not a URL keeps the part before any `?` or `#`, with the
  * same segments masked for every processor whose host it names.
  * A URL is read by its host only when the parser finds one. Text before a URL
@@ -1345,7 +1619,7 @@ export function redactUrl(raw) {
     let path = url.pathname;
     for (const rule of PATH_CREDENTIALS)
         if (rule.host.test(url.hostname))
-            path = rule.mask(path);
+            path = (rule.pathMask ?? rule.mask)(path);
     return maskNamed(`${url.origin}${path}`, url.pathname);
 }
 /**
@@ -1429,6 +1703,16 @@ const PADDLE_VGS_PREPARATION_REFUSALS = [
  * `unsupported_checkout`, which PREPARATION_REFUSALS names for every checkout. Only for a Wix checkout.
  */
 const WIX_PAYMENTS_PREPARATION_REFUSALS = ['processor_unavailable', 'live_host_on_sandbox_row', 'merchant_profile_mismatch'];
+/**
+ * The API's refusals of a HiPay preparation, before any preparation exists, that prepareCheckout surfaces by name:
+ * the company is not turned on for HiPay (`processor_unavailable`), the environment is not the caller's key mode's
+ * (`live_host_on_sandbox_row`, `sandbox_host_on_live_row`), a checkout's merchant is not the name the reviewed pin
+ * carries (`merchant_profile_mismatch`), and the price is zero (`amount_required`), since every create after it would be
+ * refused. An unreviewed origin answers `unsupported_checkout`, which PREPARATION_REFUSALS names for every checkout.
+ * Only for a HiPay checkout.
+ */
+const HIPAY_PREPARATION_REFUSALS = ['processor_unavailable', 'live_host_on_sandbox_row', 'sandbox_host_on_live_row', 'merchant_profile_mismatch',
+    'amount_required'];
 /**
  * The reason the cardholder's device declines a bound prepared row with, per processor, when its own
  * send boundary passed before the card left it (the Vault's sendWindow, 12 seconds after it last saw
@@ -1441,6 +1725,7 @@ const PREPARED_SEND_WINDOW_DECLINES = Object.freeze({
     amadeus_checkout: 'amadeus_send_window_closed',
     [SECURE_ACCEPTANCE_PSP]: 'secure_acceptance_send_window_closed',
     [WIX_PAYMENTS_PSP]: 'wix_payments_send_window_closed',
+    [HIPAY_PSP]: 'hipay_send_window_closed',
 });
 /**
  * Refusals a CyberSource Flex preparation that tokenizes before Pay answers (4xx) before any
@@ -1529,8 +1814,8 @@ export class VaultClient {
     /**
      * Approve purchases by voice inside your own product: connect a person once,
      * create the purchase, ask for the key word, read the result. Same
-     * credentials, same token as the checkout calls. Needs `voice: { approval }`
-     * at construction; without it every verb throws `missing_approval_posture`.
+     * credentials, same token as the checkout calls. Approves on Agentcard's
+     * page unless `voice: { approval: 'in_app' }` was named at construction.
      */
     voice;
     /**
@@ -1644,7 +1929,9 @@ export class VaultClient {
         // wspay_confirm, shiji_sts_pinned_key, amadeus_checkout_actions.v1,
         // worldline_mycheckout_form, verifone_card_capture, ekashu_hosted_payment_page,
         // cybersource_sa_token_create, gravy_session_fields_put,
-        // moneris_hosted_tokenization, paddle_vgs_cards, redsys_hosted_payment_page) and
+        // moneris_hosted_tokenization, paddle_vgs_cards, paddle_tokenex_pay,
+        // redsys_hosted_payment_page, lyra_krypton_payment, payfast_card_pay,
+        // quickpay_hosted_payment_page, tokenex_iframe_tokenize, among others) and
         // the caller's company is one Agentcard turned that processor on for, so this
         // build arms Fiserv's card capture, GMO's getToken, CyberSource Flex's card
         // fields, Juspay's card flow, Datatrans's Secure Fields card post, the
@@ -1838,7 +2125,9 @@ export class VaultClient {
      * The facts hold only while the cardholder pays with that card. `psp` names the processor
      * whose card form the agent types into (the recognizer's name, `worldline_mycheckout`): a
      * processor that needs its own number for the card's network gets it, and every other gets the
-     * network's default. Throws PlaceholderCardError when there is no such card, its network has no
+     * network's default. On a TokenEx iframe (`tokenex_iframe`, JetBlue) the number is one TokenEx's frame
+     * reads as the card's own network, Visa, Mastercard or American Express, and any other network has no
+     * placeholder there. Throws PlaceholderCardError when there is no such card, its network has no
      * placeholder, or it carries no expiry.
      */
     async placeholderCard(input) {
@@ -2123,6 +2412,7 @@ export class VaultClient {
                     || (input.psp === EPROTECT_PSP && EPROTECT_PREPARATION_REFUSALS.includes(error.code))
                     || (input.psp === PADDLE_VGS_PSP && PADDLE_VGS_PREPARATION_REFUSALS.includes(error.code))
                     || (input.psp === WIX_PAYMENTS_PSP && WIX_PAYMENTS_PREPARATION_REFUSALS.includes(error.code))
+                    || (input.psp === HIPAY_PSP && HIPAY_PREPARATION_REFUSALS.includes(error.code))
                     || (!!flexContext && CYBERSOURCE_FLEX_PREPARATION_REFUSALS.includes(error.code))))
                     || (input.psp === 'fiserv' && error.status === 502 && error.code === 'cse_key_unavailable')))
                 throw fail(error.code);
@@ -2377,10 +2667,14 @@ export class VaultClient {
                     : `checkout authorization is POST-only; got ${method} for ${redactUrl(input.request.url)}. ` +
                         'A non-POST tokenizer needs recognizer support before it can be intercepted.');
         }
-        // A GET card request is its URL alone. This build completes one: Worldpay
-        // eProtect's registration exactly as payment-core admits it, with no body.
+        // A GET card request is its URL alone. This build completes two kinds: Worldpay
+        // eProtect's registration exactly as payment-core admits it, with no body, and a
+        // hosted page's entry link exactly as its rule admits it (hosted-entry.ts), with no
+        // body, which the cardholder's device takes over.
         const eprotect = rec?.psp === EPROTECT_PSP;
-        if (cardMethod === 'GET' && !(eprotect && isEprotectRegistration(input.request))) {
+        const hostedGetEntry = mode === 'hosted_form' && !!rec && isHostedGetEntry(rec.psp, input.request.url)
+            && (input.request.body === undefined || input.request.body === null || input.request.body === '');
+        if (cardMethod === 'GET' && !(eprotect && isEprotectRegistration(input.request)) && !hostedGetEntry) {
             throw new Error(`this ${rec?.psp} GET is not a card registration this version of @agent-cards/checkout can complete: ${redactUrl(input.request.url)}.`);
         }
         // A CyberSource Secure Acceptance token create (always prepared: its recognizer requires it). The
@@ -2406,10 +2700,26 @@ export class VaultClient {
         // amount_required.
         if (!hasAmount && rec && AGENT_AMOUNT_PROCESSORS.includes(rec.psp))
             throw new AmountRequiredError(rec.psp);
-        // A Moneris token is charged later for whatever the merchant's server decides, and a Payfast pay or a
-        // PayMongo attach charges the total its payment or checkout session already holds, so a zero pair
-        // would show the cardholder no price at all: it is refused like a missing one.
-        if (hasAmount && rec && (rec.psp === MONERIS_PSP || rec.psp === PAYFAST_PSP || rec.psp === PAYMONGO_PSP) && Number(input.amount) <= 0)
+        // A Przelewy24 pay wall charges the amount the merchant's server registered with Przelewy24 under the link's
+        // token, so a zero pair would show the cardholder no price at all: it is refused like a missing one.
+        // A Moneris, a HiPay or a Pay. token, or a GoDaddy Payments nonce, is charged later for whatever the merchant's
+        // server decides, a Payfast pay, a PayMongo attach, a 2C2P Payment, a Revolut card payment or a SumUp card request
+        // charges the total its payment, checkout session, payment token, order or checkout already holds, and a PayPal
+        // order's amount was fixed by the merchant's server and never shown in the confirm, and a GoPay card post charges
+        // the total GoPay's payment already holds, so a zero pair would show the cardholder no price at all: it is refused
+        // like a missing one.
+        // A ComGate payment charges the total ComGate already holds for it, the same way, and a Webpay transaction the
+        // total the merchant's server bound to it.
+        // A Moneris token is charged later for whatever the merchant's server decides, and a Payfast pay, a
+        // PayMongo attach or a MakeCommerce card post charges the total its payment, checkout session or
+        // transaction already holds, so a zero pair would show the cardholder no price at all: it is refused
+        // like a missing one. So is a TokenEx iframe token, which the merchant's server charges later for its own order.
+        if (hasAmount && rec && rec.psp === PRZELEWY24_PSP && Number(input.amount) <= 0)
+            throw new AmountRequiredError(rec.psp);
+        if (hasAmount && rec && (rec.psp === MONERIS_PSP || rec.psp === PAYFAST_PSP || rec.psp === PAYMONGO_PSP || rec.psp === HIPAY_PSP || rec.psp === TWOC2P_PSP
+            || rec.psp === REVOLUT_PSP || rec.psp === PAY_NL_PSP || rec.psp === PAYPAL_PSP
+            || rec.psp === GOPAY_PSP || rec.psp === COMGATE_PSP || rec.psp === MAKECOMMERCE_PSP
+            || rec.psp === POYNT_PSP || rec.psp === TOKENEX_IFRAME_PSP || rec.psp === TRANSBANK_PSP || rec.psp === SUMUP_PSP) && Number(input.amount) <= 0)
             throw new AmountRequiredError(rec.psp);
         // Nor is the agent's pair tied to the page by anything but the total the
         // page shows: without it the cardholder could approve one figure while the
@@ -2555,8 +2865,11 @@ export class VaultClient {
         // and the API names 500 ms as such a row's poll interval.
         // A prepared Paddle VGS card request too, for 20 seconds: Paddle's frame aborts it 10 seconds after
         // Pay and sends it once more, and the API names 500 ms as such a row's poll interval.
+        // A prepared HiPay token create too, for 20 seconds: HiPay's hosted fields give it 20 seconds from Pay, so
+        // an answer the cardholder's device records late in that span still reaches the frame before it gives up,
+        // and the API names 500 ms as such a row's poll interval.
         const preparedFastPollUntil = preparation?.psp === 'mercado_pago' ? Date.now() + 10_000
-            : preparation?.psp === PADDLE_VGS_PSP ? Date.now() + 20_000
+            : preparation?.psp === PADDLE_VGS_PSP || preparation?.psp === HIPAY_PSP ? Date.now() + 20_000
                 : preparation?.psp === EPROTECT_PSP ? Date.now() + 15_000
                     : preparation?.psp === SECURE_ACCEPTANCE_PSP ? Date.now() + SECURE_ACCEPTANCE_FAST_POLL_MS : 0;
         // A preparation that tokenized before Pay: the cardholder's device already holds CyberSource's
@@ -2924,6 +3237,18 @@ export class VaultClient {
                         response.headers = answer.headers;
                         response.body = answer.body;
                     }
+                    if (rec?.psp === TOKENEX_IFRAME_PSP) {
+                        // TokenEx's answer enters the frame only as TokenEx's 200 with a sound token, rebuilt from payment-core's
+                        // allow-list under a JSON content type (tokenex-iframe.ts tokenexIframePageAnswer); the frame adds its own
+                        // cardType. Anything else is never handed over: the device may already have sent the card, so the
+                        // outcome is unknown rather than declined.
+                        const answer = tokenexIframePageAnswer(response.status, response.body);
+                        if (!answer)
+                            throw new PaymentOutcomeUnknownError(authorizationId, 'tokenex_iframe_token_unconfirmed');
+                        response.status = answer.status;
+                        response.headers = answer.headers;
+                        response.body = answer.body;
+                    }
                     let processorContext;
                     if (mercadoContext) {
                         try {

package/dist/comgate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ComGate's payment gateway (pay1 to pay4.comgate.cz, where most Czech and Slovak e-shops send the buyer), as this
+ * SDK reads it.
+ *
+ * The merchant's server creates the payment at ComGate and sends the buyer's browser to the gateway link ComGate
+ * answered with, https://payN.comgate.cz/init?id=<transaction id>, by a redirect or by setting the page's or a
+ * frame's location. That GET carries no card and nothing but the payment's id, and it is the one request a build
+ * that declares ComGate's capability pauses for ComGate (hosted-entry.ts): the cardholder's device then makes the
+ * gateway's own calls for that payment over the end-to-end TLS relay (payment-core processors/comgate.js). Only the
+ * link exactly as ComGate writes it is the entry; any other parameter would be handed on to the gateway's own
+ * route, which these rules never see.
+ *
+ * COMGATE_GATEWAY_HOSTS is payment-core's COMGATE_GATEWAY_HOSTS, and isComgateEntryUrl is payment-core's rule of
+ * the same name; hosted-entry.test.mjs pins both to payment-core on every case payment-core's own tests list.
+ */
+export declare const COMGATE_PSP = "comgate";
+/** The dark-launch capability the API serves ComGate's recognizer behind (payment-core definitions.js). */
+export declare const COMGATE_CAPABILITY = "comgate_hosted_payment_page";
+/** The four gateway hosts ComGate's create answer names, each a host of its own entry. */
+export declare const COMGATE_GATEWAY_HOSTS: readonly string[];
+/**
+ * The hosts that take a card, or part of one, for ComGate: the gateway's API (payments.comgate.cz behind pay1 and pay2,
+ * payments-gcp.comgate.cz behind pay3 and pay4), where the gateway posts the card (/client/instructions/card-process,
+ * check-card) and ComGate's Web Checkout SDK posts its own (/checkout/provider/*, /checkout/card/check-card), and the
+ * card frames' hosts (sec.comgate.cz, sec-gcp.comgate.cz), which post the card's first digits to their /bin-checker.
+ * The card is already encrypted in ComGate's frame by then, so no body rule could see it: once ComGate is served, this
+ * build fails every request to these hosts but a GET, so the card the agent typed never reaches ComGate.
+ */
+export declare const COMGATE_CARD_HOSTS: readonly string[];
+/** The Fetch.enable globs attachToCdp arms for the card hosts, only while ComGate is served (cdp.ts). */
+export declare const COMGATE_CARD_PATTERNS: readonly string[];
+/** Whether this URL is on one of ComGate's card hosts (https, no credentials, any port, a trailing dot or not). */
+export declare function isComgateCardHost(url: string): boolean;
+/** Whether this build's registry serves ComGate's entry: a company Agentcard turned ComGate on for, on a build that declares it. */
+export declare function servesComgate(vault: {
+    isCardRequest(url: string, method?: string): boolean;
+} | undefined): boolean;
+/**
+ * Whether an adapter must hand this request to the pre-claim gates: it is on one of ComGate's card hosts and this
+ * build's registry serves ComGate. attachToPlaywright's route predicate asks this, as attachToCdp arms the hosts.
+ */
+export declare function isArmedComgateUrl(vault: {
+    isCardRequest(url: string, method?: string): boolean;
+} | undefined, url: string): boolean;
+/**
+ * Whether a URL is ComGate's gateway link exactly as ComGate's create answer writes it: https, one of the four
+ * gateway hosts in lowercase, the default port, no credentials or fragment, the path /init, and a query of the one
+ * `id` parameter holding a transaction id. A string that parses to another spelling is not it.
+ */
+export declare function isComgateEntryUrl(raw: unknown): boolean;