@soltech/fluid-common 1.10.0-sc23736.2 → 1.10.1-sc23265.0

package/.claude/settings.local.json

@@ -1,12 +1,7 @@
 {
   "enabledMcpjsonServers": [
-    "handbook",
-    "webstorm",
     "shortcut",
-    "chrome-devtools",
-    "mcp-clickhouse",
-    "notion",
-    "datocms",
-    "sentry"
-  ]
+    "playwright"
+  ],
+  "enableAllProjectMcpServers": true
 }

package/lib/payment-methods.d.ts

@@ -7,9 +7,11 @@ export declare enum PaymentType {
     EWALLET = "EWallet",
     VOUCHER = "Voucher"
 }
+export type TransactionStatusSource = 'gateway' | 'fluid';
 export interface TransactionStatusCheck {
     url: string;
     intervalSeconds: number;
+    source?: TransactionStatusSource;
 }
 export interface AllPaymentMethods {
     recentPaymentMethods: RecentMethod[];
@@ -52,9 +54,25 @@ export interface EncryptionSettings {
     expiryDateEncryptionMode: ExpiryDateEncryptionMode;
     encryptCardholderName: boolean;
 }
-export interface HostedFieldsSettings {
+export type HostedFieldsSettings = CardValuesSettings | CardTokenSettings;
+interface HostedFieldsBase {
     url: string;
 }
+export interface CardValuesSettings extends HostedFieldsBase {
+    protocol?: HostedFieldsProtocol.CARD_VALUES;
+}
+export interface CardTokenSettings extends HostedFieldsBase {
+    protocol: HostedFieldsProtocol.CARD_TOKEN;
+    params: CardTokenParams;
+}
+export interface CardTokenParams {
+    merchantId: string;
+    env: string;
+}
+export declare enum HostedFieldsProtocol {
+    CARD_VALUES = "CardValues",
+    CARD_TOKEN = "CardToken"
+}
 export declare enum EncryptionType {
     NO_ENCRYPTION = "NO_ENCRYPTION",
     RSA_PKCS1 = "RSA_PKCS1",// RSA with PKCS#1 v1.5 padding (jsencrypt default)
@@ -112,3 +130,4 @@ export interface RecentMethod extends PaymentMethod {
     expiryDate?: string;
     maskedAccountFormat?: RecentMethodMaskedAccountFormat;
 }
+export {};

package/lib/payment-methods.js

@@ -7,6 +7,13 @@ export var PaymentType;
     PaymentType["EWALLET"] = "EWallet";
     PaymentType["VOUCHER"] = "Voucher";
 })(PaymentType || (PaymentType = {}));
+// 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 var HostedFieldsProtocol;
+(function (HostedFieldsProtocol) {
+    HostedFieldsProtocol["CARD_VALUES"] = "CardValues";
+    HostedFieldsProtocol["CARD_TOKEN"] = "CardToken";
+})(HostedFieldsProtocol || (HostedFieldsProtocol = {}));
 export var EncryptionType;
 (function (EncryptionType) {
     EncryptionType["NO_ENCRYPTION"] = "NO_ENCRYPTION";

package/lib/transactions.d.ts

@@ -16,6 +16,8 @@ export interface CreditcardTransactionParams extends TransactionParams {
     expiryMonth?: string;
     expiryYear?: string;
     expiryDate?: string;
+    cardToken?: string;
+    protectionHeaders?: Record<string, string>;
 }
 /**
  * Transaction params for any payment method whose payload is keyed dynamically:

package/lib/wallet.d.ts

@@ -10,6 +10,19 @@ export interface Viewport {
     innerWidth: number;
     innerHeight: number;
 }
+export interface ScreenDimensions {
+    height: number;
+    width: number;
+}
+export interface BrowserInfo {
+    userAgent: string;
+    acceptHeader: string;
+    javaEnabled: boolean;
+    colorDepth: number;
+    screen: ScreenDimensions;
+    viewport: Viewport;
+    timezoneOffset: number;
+}
 export interface WalletRequestBody {
     payload?: object | string;
     payloadOptions?: TransactionOptions;
@@ -22,8 +35,11 @@ export interface WalletInitParams {
     operatorId: number;
     sessionId: string;
     userId: string | number;
+    /** @deprecated Use browserInfo.userAgent instead */
     userAgent: string;
+    /** @deprecated Use browserInfo.viewport instead */
     viewport: Viewport;
+    browserInfo?: BrowserInfo;
     userData?: UserData;
     timestamp: string;
     buildDate: string;

package/package.json

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

package/src/payment-methods.ts

@@ -9,9 +9,12 @@ export enum PaymentType {
 	VOUCHER = 'Voucher'
 }
 
+export type TransactionStatusSource = 'gateway' | 'fluid';
+
 export interface TransactionStatusCheck {
 	url: string;
 	intervalSeconds: number;
+	source?: TransactionStatusSource;
 }
 
 export interface AllPaymentMethods {
@@ -59,10 +62,35 @@ export interface EncryptionSettings {
 	encryptCardholderName: boolean;
 }
 
-export interface HostedFieldsSettings {
+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 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;
+	params: CardTokenParams;
+}
+
+export interface CardTokenParams {
+	merchantId: string;
+	env: string;
+}
+
+// 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 {
+	CARD_VALUES = 'CardValues',
+	CARD_TOKEN = 'CardToken'
+}
+
 export enum EncryptionType {
 	NO_ENCRYPTION = 'NO_ENCRYPTION',
 	RSA_PKCS1 = 'RSA_PKCS1', // RSA with PKCS#1 v1.5 padding (jsencrypt default)

package/src/transactions.ts

@@ -19,6 +19,8 @@ export interface CreditcardTransactionParams extends TransactionParams {
 	expiryMonth?: string;
 	expiryYear?: string;
 	expiryDate?: string;
+	cardToken?: string;
+	protectionHeaders?: Record<string, string>;
 }
 /**
  * Transaction params for any payment method whose payload is keyed dynamically:

package/src/wallet.ts

@@ -13,6 +13,21 @@ export interface Viewport {
 	innerHeight: number;
 }
 
+export interface ScreenDimensions {
+	height: number;
+	width: number;
+}
+
+export interface BrowserInfo {
+	userAgent: string;
+	acceptHeader: string;
+	javaEnabled: boolean;
+	colorDepth: number;
+	screen: ScreenDimensions;
+	viewport: Viewport;
+	timezoneOffset: number;
+}
+
 export interface WalletRequestBody {
 	payload?: object | string;
 	payloadOptions?: TransactionOptions;
@@ -26,8 +41,11 @@ export interface WalletInitParams {
 	operatorId: number;
 	sessionId: string;
 	userId: string | number;
+	/** @deprecated Use browserInfo.userAgent instead */
 	userAgent: string;
+	/** @deprecated Use browserInfo.viewport instead */
 	viewport: Viewport;
+	browserInfo?: BrowserInfo;
 	userData?: UserData;
 	timestamp: string;
 	buildDate: string;