@agent-cards/sdk 0.23.22 → 0.23.24

package/dist/tap-payments.d.ts

@@ -0,0 +1,43 @@
+/** The PSP id the API and the recognizer name this lane, re-exported so the client dispatches by it. */
+export { TAP_PAYMENTS_PSP } from './tap-payments.generated.js';
+/** The dark-launch capability a build declares when it fills a Tap token request with the device's ciphertext. */
+export declare const TAP_PAYMENTS_CAPABILITY = "tap_card_sdk_token";
+/** A cse substitution as the API serves it (substitute.ts Substitutions): here the one ciphertext. */
+interface TapPaymentsServedSubstitution {
+    encoding: string;
+    at: string;
+    fields: Record<string, string>;
+    remove?: string[];
+}
+/**
+ * Whether an approved Tap authorization's served substitution is one this SDK can continue: JSON at the body root (`at`
+ * is ''), no sibling to remove, and exactly the one ciphertext, a non-empty string. substituteTapPayments checks its
+ * size and range against the pin for the request's publishable key; this is the shape gate the client runs first.
+ */
+export declare function isTapPaymentsServedSubstitution(sub: unknown): sub is TapPaymentsServedSubstitution;
+/** The paused request an approval was created from: the URL and body the API reviewed at create, and its headers. */
+export interface TapPaymentsApprovedRequest {
+    url: string;
+    body: string;
+    headers?: Record<string, string>;
+}
+/**
+ * The continuation of an approved Tap token request: the paused body with the device's ciphertext written over the
+ * placeholder's at encryptedData (payment-core substituteTapPayments, which runs the frame's request rule again on the
+ * headers of the request that continues, and refuses a ciphertext that does not have the size and range of one under
+ * the pin for its publishable key, or one already in the paused body).
+ *
+ * Only into `approved`, the paused request the approval was created from: `url` and `body` must equal it byte for byte.
+ * A ciphertext under the merchant's key would ask Tap for a token in any later request of the same shape; binding it
+ * to the one request keeps this lane from ever writing one checkout's card into another. `headers` are those of the
+ * request that continues, the paused one or the page's retry of it, and the browser sends them as they are: they
+ * must name the publishable key the approved request named, so a retry under another merchant's key never carries the
+ * card.
+ *
+ * Null when neither URL is Tap's token URL, so every other processor keeps its own swap. Throws for any other body,
+ * URL or key, and for a substitution the shape gate or the swap refuses, in each case before anything continues. The
+ * approval is not retired on a refusal: the runtime already read the ciphertext, so the API keeps the row and its hold.
+ */
+export declare function tapPaymentsContinuation(url: string, body: string, headers: Record<string, string> | undefined, sub: unknown, approved: TapPaymentsApprovedRequest): {
+    body: string;
+} | null;

package/dist/tap-payments.generated.d.ts

@@ -0,0 +1,59 @@
+declare var TAP_PAYMENTS_PSP: string;
+declare var TAP_PAYMENTS_CAPABILITY: string;
+declare var TAP_PAYMENTS_OPERATION: string;
+declare var TAP_PAYMENTS_SCHEME: string;
+declare var TAP_PAYMENTS_HOST: string;
+declare var TAP_PAYMENTS_TOKEN_URL: string;
+declare var TAP_PAYMENTS_FIELD: string;
+declare var TAP_PAYMENTS_PURPOSES: readonly string[];
+declare var TAP_PAYMENTS_REFUSAL_CODES: readonly string[];
+declare function tapPaymentsRefusalMessage(code: any): any;
+declare var TapPaymentsError: {
+    new (code: any): {
+        name: string;
+        message: string;
+        stack?: string;
+        cause?: unknown;
+    };
+};
+declare function isTapPaymentsTokenUrl(url: any): boolean;
+declare function tapPaymentsKeyEnvironment(publishableKey: any): "production" | "sandbox" | null;
+declare var TAP_PAYMENTS_MERCHANT_PINS: readonly any[];
+declare function tapPaymentsMerchantPin(publishableKey: any, pins?: readonly any[]): any;
+declare function tapPaymentsMerchantRefusal(environment: any, publishableKey: any, merchantOrigin: any, pins?: readonly any[]): "tap_payments_merchant_unreviewed" | null;
+declare function isTapPaymentsCiphertext(value: any): boolean;
+declare function tapPaymentsBodyVerdict(body: any): Readonly<{
+    verdict: "refuse";
+    code: any;
+}> | Readonly<{
+    verdict: "card";
+}>;
+declare function tapPaymentsOrderAmount(body: any): Readonly<{
+    amount: any;
+    currency: any;
+}> | null;
+declare function tapPaymentsRequestKey(request: any): any;
+declare function tapPaymentsRequestRefusal(request: any): any;
+declare function tapPaymentsPlaintext(card: any): string;
+declare function encryptTapPaymentsCard(card: any, publishableKey: any, facilities?: {}): Readonly<{
+    encryptedData: string;
+}>;
+declare function isTapPaymentsCiphertextUnderPin(value: any, merchantPin: any): boolean;
+declare function substituteTapPayments(request: any, substitution: any): string;
+declare function tapPaymentsSubstitutionsRefusal(template: any, substitution: any): {
+    code: string;
+    message: any;
+} | null;
+declare function tapPaymentsKeyUsable(authorization: any): boolean;
+declare function tapPaymentsRefusalCode(text: any): string | null;
+declare function tapPaymentsAnswerOutcome(status: any, text: any, card: any): {
+    outcome: string;
+    reason: any;
+} | {
+    outcome: string;
+    code: string;
+} | {
+    outcome: string;
+    code?: undefined;
+};
+export { TAP_PAYMENTS_CAPABILITY, TAP_PAYMENTS_FIELD, TAP_PAYMENTS_HOST, TAP_PAYMENTS_MERCHANT_PINS, TAP_PAYMENTS_OPERATION, TAP_PAYMENTS_PSP, TAP_PAYMENTS_PURPOSES, TAP_PAYMENTS_REFUSAL_CODES, TAP_PAYMENTS_SCHEME, TAP_PAYMENTS_TOKEN_URL, TapPaymentsError, encryptTapPaymentsCard, isTapPaymentsCiphertext, isTapPaymentsCiphertextUnderPin, isTapPaymentsTokenUrl, substituteTapPayments, tapPaymentsAnswerOutcome, tapPaymentsBodyVerdict, tapPaymentsKeyEnvironment, tapPaymentsKeyUsable, tapPaymentsMerchantPin, tapPaymentsMerchantRefusal, tapPaymentsOrderAmount, tapPaymentsPlaintext, tapPaymentsRefusalCode, tapPaymentsRefusalMessage, tapPaymentsRequestKey, tapPaymentsRequestRefusal, tapPaymentsSubstitutionsRefusal };