@soltech/fluid-common 1.9.2-sc23265.3 → 1.10.0-beta.0

package/lib/index.d.ts

@@ -118,7 +118,6 @@ export type TransactionStatusSource = 'gateway' | 'fluid';
 export interface TransactionStatusCheck {
     url: string;
     intervalSeconds: number;
-    /** Who answers the poll. Absent on wallets served by an API that predates this field. */
     source?: TransactionStatusSource;
 }
 export interface AllPaymentMethods {
@@ -162,12 +161,12 @@ export interface EncryptionSettings {
     expiryDateEncryptionMode: ExpiryDateEncryptionMode;
     encryptCardholderName: boolean;
 }
-export type HostedFieldsSettings = EncryptedFieldsSettings | CardTokenSettings;
+export type HostedFieldsSettings = CardValuesSettings | CardTokenSettings;
 interface HostedFieldsBase {
     url: string;
 }
-export interface EncryptedFieldsSettings extends HostedFieldsBase {
-    protocol?: HostedFieldsProtocol.ENCRYPTED_FIELDS;
+export interface CardValuesSettings extends HostedFieldsBase {
+    protocol?: HostedFieldsProtocol.CARD_VALUES;
 }
 export interface CardTokenSettings extends HostedFieldsBase {
     protocol: HostedFieldsProtocol.CARD_TOKEN;
@@ -178,7 +177,7 @@ export interface CardTokenParams {
     env: string;
 }
 export declare enum HostedFieldsProtocol {
-    ENCRYPTED_FIELDS = "EncryptedFields",
+    CARD_VALUES = "CardValues",
     CARD_TOKEN = "CardToken"
 }
 export declare enum EncryptionType {
@@ -254,15 +253,36 @@ export interface CreditcardTransactionParams extends TransactionParams {
     protectionHeaders?: Record<string, string>;
 }
 /**
- * Transaction params for any payment method whose payload is keyed dynamically:
- * - CMS-defined input fields (bank transfer, crypto, e-wallet, voucher).
- * - Native flows like Apple Pay where the gateway-bound `token` is the only
- *   extra key beyond the base TransactionParams.
+ * Transaction params for any payment method whose payload is keyed dynamically by
+ * CMS-defined input fields (bank transfer, crypto, e-wallet, voucher).
  * Field keys typically come from `PaymentMethod.inputFields[].paramName`.
  */
 export interface DynamicTransactionParams extends TransactionParams {
     [key: string]: string | number | undefined;
 }
+export interface ApplePayTransactionParams extends TransactionParams {
+    /** The authorised `ApplePayPaymentToken`, serialised, opaque to everything but the gateway. */
+    token: string;
+    billingContact?: ApplePayBillingContact;
+}
+/**
+ * Apple's own `ApplePayPaymentContact` shape, carried through unchanged: a gateway that wants
+ * it expects the field names Apple uses. Only present when the method asks the sheet for it.
+ */
+export interface ApplePayBillingContact {
+    addressLines?: string[];
+    administrativeArea?: string;
+    country?: string;
+    countryCode?: string;
+    emailAddress?: string;
+    familyName?: string;
+    givenName?: string;
+    locality?: string;
+    phoneNumber?: string;
+    postalCode?: string;
+    subAdministrativeArea?: string;
+    subLocality?: string;
+}
 export interface TransactionOptions {
     bonusCode?: string;
     activityId?: string;

package/lib/index.js

@@ -36,7 +36,7 @@ export var WindowRedirectType;
 // is behind them — the gateway's identity stays server-side.
 export var HostedFieldsProtocol;
 (function (HostedFieldsProtocol) {
-    HostedFieldsProtocol["ENCRYPTED_FIELDS"] = "EncryptedFields";
+    HostedFieldsProtocol["CARD_VALUES"] = "CardValues";
     HostedFieldsProtocol["CARD_TOKEN"] = "CardToken";
 })(HostedFieldsProtocol || (HostedFieldsProtocol = {}));
 export var EncryptionType;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@soltech/fluid-common",
-	"version": "1.9.2-sc23265.3",
+	"version": "1.10.0-beta.0",
 	"type": "module",
 	"description": "Fluid frontend, API and AI common interfaces & enums",
 	"main": "lib/index.js",

package/src/index.ts

@@ -134,7 +134,6 @@ export type TransactionStatusSource = 'gateway' | 'fluid';
 export interface TransactionStatusCheck {
 	url: string;
 	intervalSeconds: number;
-	/** Who answers the poll. Absent on wallets served by an API that predates this field. */
 	source?: TransactionStatusSource;
 }
 
@@ -183,21 +182,20 @@ export interface EncryptionSettings {
 	encryptCardholderName: boolean;
 }
 
-export type HostedFieldsSettings = EncryptedFieldsSettings | CardTokenSettings;
+export type HostedFieldsSettings = CardValuesSettings | CardTokenSettings;
 
 interface HostedFieldsBase {
 	// Its presence is also how the client decides a method uses hosted fields at all.
 	url: string;
 }
 
-export interface EncryptedFieldsSettings extends HostedFieldsBase {
-	// Absent means EncryptedFields, so responses composed before this field existed keep working.
-	protocol?: HostedFieldsProtocol.ENCRYPTED_FIELDS;
+export interface CardValuesSettings extends HostedFieldsBase {
+	// Absent selects this protocol, so responses composed before the field existed keep working.
+	protocol?: HostedFieldsProtocol.CARD_VALUES;
 }
 
 export interface CardTokenSettings extends HostedFieldsBase {
 	protocol: HostedFieldsProtocol.CARD_TOKEN;
-	// Handed straight to the gateway's own component, uninterpreted.
 	params: CardTokenParams;
 }
 
@@ -209,7 +207,7 @@ export interface CardTokenParams {
 // Which message contract the client must speak to the hosted fields, not which gateway
 // is behind them — the gateway's identity stays server-side.
 export enum HostedFieldsProtocol {
-	ENCRYPTED_FIELDS = 'EncryptedFields',
+	CARD_VALUES = 'CardValues',
 	CARD_TOKEN = 'CardToken'
 }
 
@@ -291,24 +289,44 @@ export interface CreditcardTransactionParams extends TransactionParams {
 	expiryMonth?: string;
 	expiryYear?: string;
 	expiryDate?: string;
-	// Set instead of cardNumber when the gateway tokenised the card in the browser.
 	cardToken?: string;
-	// Device and session signals the gateway's own form collected, which its fraud scoring
-	// needs on the charge. Opaque: the client passes them through and never interprets them.
 	protectionHeaders?: Record<string, string>;
 }
 
 /**
- * Transaction params for any payment method whose payload is keyed dynamically:
- * - CMS-defined input fields (bank transfer, crypto, e-wallet, voucher).
- * - Native flows like Apple Pay where the gateway-bound `token` is the only
- *   extra key beyond the base TransactionParams.
+ * Transaction params for any payment method whose payload is keyed dynamically by
+ * CMS-defined input fields (bank transfer, crypto, e-wallet, voucher).
  * Field keys typically come from `PaymentMethod.inputFields[].paramName`.
  */
 export interface DynamicTransactionParams extends TransactionParams {
 	[key: string]: string | number | undefined;
 }
 
+export interface ApplePayTransactionParams extends TransactionParams {
+	/** The authorised `ApplePayPaymentToken`, serialised, opaque to everything but the gateway. */
+	token: string;
+	billingContact?: ApplePayBillingContact;
+}
+
+/**
+ * Apple's own `ApplePayPaymentContact` shape, carried through unchanged: a gateway that wants
+ * it expects the field names Apple uses. Only present when the method asks the sheet for it.
+ */
+export interface ApplePayBillingContact {
+	addressLines?: string[];
+	administrativeArea?: string;
+	country?: string;
+	countryCode?: string;
+	emailAddress?: string;
+	familyName?: string;
+	givenName?: string;
+	locality?: string;
+	phoneNumber?: string;
+	postalCode?: string;
+	subAdministrativeArea?: string;
+	subLocality?: string;
+}
+
 export interface TransactionOptions {
 	bonusCode?: string;
 	activityId?: string;

package/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "enabledMcpjsonServers": [
-    "shortcut",
-    "playwright"
-  ],
-  "enableAllProjectMcpServers": true
-}