@delopay/sdk 0.47.0 → 0.49.0

package/dist/index.d.cts

@@ -1142,6 +1142,27 @@ interface PlatformFeeRuleRecord {
     created_at: number;
     modified_at: number;
 }
+/** Sample transaction + candidate program for `POST /admin/fees/rules/preview`. */
+interface FeeRulePreviewRequest {
+    algorithm: PlatformFeeProgram;
+    /** Amount in minor units. */
+    amount: number;
+    currency: Currency;
+    payment_method?: PaymentMethod | null;
+    connector?: Connector | null;
+    card_network?: string | null;
+    /** USD minor units (previous-month volume snapshot). */
+    merchant_volume?: number | null;
+}
+interface FeeRulePreviewResponse {
+    /** Matched rule name, or null when only the default selection matched. */
+    matched_rule: string | null;
+    /** True when the matched branch sets no concrete fee (engine falls through to the legacy schedule/tier chain). */
+    fell_through: boolean;
+    /** Computed fee in minor units, or null when fell_through. */
+    fee_amount: number | null;
+    fee_currency: string | null;
+}
 interface ProjectCreateRequest {
     project_name: string;
     description?: string | null;
@@ -3026,6 +3047,15 @@ declare class FeeRulesManager {
      *   (other shops' programs are left intact).
      */
     delete(merchantId: string, profileId?: string): Promise<void>;
+    /**
+     * Dry-run a candidate fee-rule program against a sample transaction.
+     * Returns the matched rule name, whether it fell through, and the computed fee.
+     * Does not persist anything.
+     *
+     * @param input - Candidate program + sample transaction fields.
+     * @param merchantId - The merchant account ID.
+     */
+    preview(input: FeeRulePreviewRequest, merchantId: string): Promise<FeeRulePreviewResponse>;
 }
 
 /** View and revoke recurring payment mandates. */
@@ -4591,6 +4621,29 @@ declare const Webhooks: {
     verify(rawBody: string | Uint8Array, signatureHeader: string, secret: string): Promise<WebhookEvent>;
 };
 
+/** A single condition leaf in the builder's condition tree. */
+interface LeafNode {
+    kind: 'leaf';
+    lhs: string;
+    comparison: EuclidComparisonType;
+    value: EuclidValue;
+}
+/** An AND (`all`) or OR (`any`) group of condition nodes. */
+interface GroupNode {
+    kind: 'all' | 'any';
+    children: ConditionNode[];
+}
+type ConditionNode = LeafNode | GroupNode;
+/**
+ * A condition leaf. Numeric values (amount, merchant_volume) tag as `number`;
+ * string values (payment_method, connector, currency, card_network) tag as
+ * `enum_variant`.
+ */
+declare function leaf(lhs: string, comparison: EuclidComparisonType, value: string | number): LeafNode;
+/** AND group — all children must match. */
+declare function allOf(...children: ConditionNode[]): GroupNode;
+/** OR group — any child matching is enough. */
+declare function anyOf(...children: ConditionNode[]): GroupNode;
 /**
  * How a rule (or the default) prices a transaction. `fee_type` is inferred:
  * percentage-only → `percentage`, flat-only → `flat`, both → `combined`.
@@ -4617,12 +4670,29 @@ interface FeeRuleConditions {
     connector?: Connector;
     currency?: Currency;
     cardNetwork?: string;
+    /**
+     * Customer billing-address country. Must be the exact backend `Country` enum
+     * variant (PascalCase full name, e.g. `Germany`/`UnitedStatesOfAmerica`), not
+     * an ISO code — the engine lowers `billing_country` via case-sensitive
+     * `from_str`.
+     */
+    billingCountry?: string;
     /** `amount == n` (minor units). */
     amountEquals?: number;
     /** `amount > n` (minor units). */
     amountGreaterThan?: number;
     /** `amount < n` (minor units). */
     amountLessThan?: number;
+    /**
+     * `merchant_volume == n` — the merchant's previous-month volume snapshot
+     * (USD minor units). Combine with any other condition, e.g.
+     * `{ paymentMethod: 'crypto', merchantVolumeGreaterThan: 1_000_000 }`.
+     */
+    merchantVolumeEquals?: number;
+    /** `merchant_volume > n` (USD minor units). */
+    merchantVolumeGreaterThan?: number;
+    /** `merchant_volume < n` (USD minor units). */
+    merchantVolumeLessThan?: number;
 }
 interface FeeRuleInput {
     name: string;
@@ -4630,8 +4700,35 @@ interface FeeRuleInput {
     when?: FeeRuleConditions;
     /** Extra raw conditions ANDed in, for dimensions `when` does not cover. */
     rawConditions?: EuclidComparison[];
+    /** Nested AND/OR condition tree. Mutually exclusive with `when`/`rawConditions`. */
+    match?: ConditionNode;
     fee: FeeSpecInput;
 }
+/**
+ * Decode a rule's `statements[]` back into a condition tree.
+ *
+ * Returns a tree that is **logically equivalent** to the source. It is
+ * deep-equal to `normalizeNode(input)` only when no `all` group contains two
+ * or more `any` groups; where the encoder distributed AND over OR, the decoded
+ * shape differs (still equivalent).
+ */
+declare function ruleMatchToTree(statements: EuclidIfStatement[]): ConditionNode;
+/**
+ * Decode a stored program into the builder's editable model.
+ *
+ * Returns a tree that is **logically equivalent** to the source. It is
+ * deep-equal to `normalizeNode(input)` only when no `all` group contains two
+ * or more `any` groups; where the encoder distributed AND over OR, the decoded
+ * shape differs (still equivalent).
+ */
+declare function programToTree(program: PlatformFeeProgram): {
+    rules: {
+        name: string;
+        match: ConditionNode;
+        fee: PlatformFeeOutput | null;
+    }[];
+    otherwise: PlatformFeeOutput | null;
+};
 /**
  * Fluent builder for a platform fee-rule program. Emits the exact Euclid wire
  * shape (camelCase tree, tagged values, `metadata: {}` everywhere) so callers
@@ -4804,4 +4901,4 @@ declare function parseImportedBranding(raw: unknown): CheckoutBranding;
 declare function applyBrandingVariables(el: HTMLElement, b: CheckoutBranding): void;
 declare function shadowFor(style: SurfaceStyle): string;
 
-export { type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AuthResponse, type AuthenticationCreateRequest, type AuthenticationResponse, type AuthenticationStatus, type AuthenticationType, type AutoRechargeConfig, type AutoRechargeUpdateRequest, type AvailabilityOverrideCreateRequest, type AvailabilityOverrideResponse, AvailabilityOverrides, type AvailabilityPreviewMethod, type AvailabilityPreviewParams, type AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, type BillingCompleteSetupRequest, type BillingProfileResponse, type BillingSetupRequest, type BillingSetupResponse, type BlockedAttempt, type BlockedAttemptListParams, type BlockedAttemptListResponse, type BlocklistAddRequest, type BlocklistDataKind, type BlocklistResponse, type BrandingExport, type BrandingSource, type BuiltInRegionGroupResponse, type BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, Cards, type ChangePasswordRequest, type CheckoutBranding, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorResponse, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceRequest, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EphemeralKeyCreateRequest, type EphemeralKeyCreateResponse, type EuclidComparison, type EuclidComparisonType, type EuclidIfStatement, type EuclidValue, type EventClass, type EventDeliveryAttemptResponse, type EventDetailResponse, type EventListParams, type EventListResponse, type EventResponse, type EventType, Export, FeatureMatrix, type FeeOwner, FeeProgramBuilder, type FeeRuleConditions, type FeeRuleInput, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeType, Files, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type LoginHistoryEntry, type LoginHistoryParams, type LoginHistoryResponse, type LogoShape, type LogoSize, type MandateListParams, type MandateResponse, type MandateRevokedResponse, type MandateStatus, type MandateType, type MerchantAccountCreateRequest, type MerchantAccountResponse, type MerchantAccountType, type MerchantAccountUpdateRequest, type MerchantOverviewResponse, type MerchantOverviewStat, type MerchantRoutingAlgorithm, type MethodSurcharge, type NonPillRadius, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodListParams, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentUpdateRequest, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PerMethodSurchargeItem, type PermissionScope, type PhoneDetails, type PhoneOtpRequest, type PhoneOtpResponse, type PhoneOtpVerifyRequest, type PhoneOtpVerifyResponse, type PlatformFeeKind, type PlatformFeeOutput, type PlatformFeeProgram, type PlatformFeeRule, type PlatformFeeRuleInput, type PlatformFeeRuleOutput, type PlatformFeeRuleRecord, type PlatformFeeRuleRequest, type PollStatus, type PollStatusResponse, type ProfileAcquirerCreateRequest, type ProfileAcquirerResponse, type ProfileAcquirerUpdateRequest, type ProfileCreateRequest, type ProfileDefaultRoutingConfig, type ProfileDeniedConnectorsResponse, type ProfileLogoUploadResponse, type ProfileResponse, type ProfileUpdateRequest, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type RecoveryCodesResponse, type RefundCreateRequest, type RefundListParams, type RefundListResponse, type RefundResponse, type RefundStatus, type RefundType, type RefundUpdateRequest, type RegionCountriesResponse, type RegionCreateRequest, type RegionResponse, type RegionSetCountriesRequest, type RegionUpdateRequest, Regions, type RelayRequest, type RelayResponse, type RelayStatus, type RelayType, type RequestExtras, type RequestFn, type RequestOptions, type ResetPasswordRequest, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, type ShopCreateRequest, type ShopResponse, type ShopStats, type ShopUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StaticRoutingAlgorithm, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeRuleRequest, type SurchargeRuleResponse, type SurfaceStyle, type SwitchMerchantRequest, type SwitchProfileRequest, type Terminate2faQueryParams, type ThreeDSDecision, type ThreeDsRuleExecuteRequest, type ThreeDsRuleResponse, type TierSummary, type TokenPurpose, type TokenResponse, type TopupRequest, type TopupResponse, type TotpResponse, type TransactionType, type TrustBadge, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, Webhooks, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, feeProgram, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, logoDimensions, parseImportedBranding, radiusValue, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue };
+export { type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AuthResponse, type AuthenticationCreateRequest, type AuthenticationResponse, type AuthenticationStatus, type AuthenticationType, type AutoRechargeConfig, type AutoRechargeUpdateRequest, type AvailabilityOverrideCreateRequest, type AvailabilityOverrideResponse, AvailabilityOverrides, type AvailabilityPreviewMethod, type AvailabilityPreviewParams, type AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, type BillingCompleteSetupRequest, type BillingProfileResponse, type BillingSetupRequest, type BillingSetupResponse, type BlockedAttempt, type BlockedAttemptListParams, type BlockedAttemptListResponse, type BlocklistAddRequest, type BlocklistDataKind, type BlocklistResponse, type BrandingExport, type BrandingSource, type BuiltInRegionGroupResponse, type BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, Cards, type ChangePasswordRequest, type CheckoutBranding, type ConditionNode, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorResponse, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceRequest, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EphemeralKeyCreateRequest, type EphemeralKeyCreateResponse, type EuclidComparison, type EuclidComparisonType, type EuclidIfStatement, type EuclidValue, type EventClass, type EventDeliveryAttemptResponse, type EventDetailResponse, type EventListParams, type EventListResponse, type EventResponse, type EventType, Export, FeatureMatrix, type FeeOwner, FeeProgramBuilder, type FeeRuleConditions, type FeeRuleInput, type FeeRulePreviewRequest, type FeeRulePreviewResponse, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeType, Files, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type GroupNode, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LeafNode, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type LoginHistoryEntry, type LoginHistoryParams, type LoginHistoryResponse, type LogoShape, type LogoSize, type MandateListParams, type MandateResponse, type MandateRevokedResponse, type MandateStatus, type MandateType, type MerchantAccountCreateRequest, type MerchantAccountResponse, type MerchantAccountType, type MerchantAccountUpdateRequest, type MerchantOverviewResponse, type MerchantOverviewStat, type MerchantRoutingAlgorithm, type MethodSurcharge, type NonPillRadius, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodListParams, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentUpdateRequest, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PerMethodSurchargeItem, type PermissionScope, type PhoneDetails, type PhoneOtpRequest, type PhoneOtpResponse, type PhoneOtpVerifyRequest, type PhoneOtpVerifyResponse, type PlatformFeeKind, type PlatformFeeOutput, type PlatformFeeProgram, type PlatformFeeRule, type PlatformFeeRuleInput, type PlatformFeeRuleOutput, type PlatformFeeRuleRecord, type PlatformFeeRuleRequest, type PollStatus, type PollStatusResponse, type ProfileAcquirerCreateRequest, type ProfileAcquirerResponse, type ProfileAcquirerUpdateRequest, type ProfileCreateRequest, type ProfileDefaultRoutingConfig, type ProfileDeniedConnectorsResponse, type ProfileLogoUploadResponse, type ProfileResponse, type ProfileUpdateRequest, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type RecoveryCodesResponse, type RefundCreateRequest, type RefundListParams, type RefundListResponse, type RefundResponse, type RefundStatus, type RefundType, type RefundUpdateRequest, type RegionCountriesResponse, type RegionCreateRequest, type RegionResponse, type RegionSetCountriesRequest, type RegionUpdateRequest, Regions, type RelayRequest, type RelayResponse, type RelayStatus, type RelayType, type RequestExtras, type RequestFn, type RequestOptions, type ResetPasswordRequest, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, type ShopCreateRequest, type ShopResponse, type ShopStats, type ShopUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StaticRoutingAlgorithm, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeRuleRequest, type SurchargeRuleResponse, type SurfaceStyle, type SwitchMerchantRequest, type SwitchProfileRequest, type Terminate2faQueryParams, type ThreeDSDecision, type ThreeDsRuleExecuteRequest, type ThreeDsRuleResponse, type TierSummary, type TokenPurpose, type TokenResponse, type TopupRequest, type TopupResponse, type TotpResponse, type TransactionType, type TrustBadge, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, feeProgram, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, leaf, logoDimensions, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue };

package/dist/index.d.ts

@@ -1142,6 +1142,27 @@ interface PlatformFeeRuleRecord {
     created_at: number;
     modified_at: number;
 }
+/** Sample transaction + candidate program for `POST /admin/fees/rules/preview`. */
+interface FeeRulePreviewRequest {
+    algorithm: PlatformFeeProgram;
+    /** Amount in minor units. */
+    amount: number;
+    currency: Currency;
+    payment_method?: PaymentMethod | null;
+    connector?: Connector | null;
+    card_network?: string | null;
+    /** USD minor units (previous-month volume snapshot). */
+    merchant_volume?: number | null;
+}
+interface FeeRulePreviewResponse {
+    /** Matched rule name, or null when only the default selection matched. */
+    matched_rule: string | null;
+    /** True when the matched branch sets no concrete fee (engine falls through to the legacy schedule/tier chain). */
+    fell_through: boolean;
+    /** Computed fee in minor units, or null when fell_through. */
+    fee_amount: number | null;
+    fee_currency: string | null;
+}
 interface ProjectCreateRequest {
     project_name: string;
     description?: string | null;
@@ -3026,6 +3047,15 @@ declare class FeeRulesManager {
      *   (other shops' programs are left intact).
      */
     delete(merchantId: string, profileId?: string): Promise<void>;
+    /**
+     * Dry-run a candidate fee-rule program against a sample transaction.
+     * Returns the matched rule name, whether it fell through, and the computed fee.
+     * Does not persist anything.
+     *
+     * @param input - Candidate program + sample transaction fields.
+     * @param merchantId - The merchant account ID.
+     */
+    preview(input: FeeRulePreviewRequest, merchantId: string): Promise<FeeRulePreviewResponse>;
 }
 
 /** View and revoke recurring payment mandates. */
@@ -4591,6 +4621,29 @@ declare const Webhooks: {
     verify(rawBody: string | Uint8Array, signatureHeader: string, secret: string): Promise<WebhookEvent>;
 };
 
+/** A single condition leaf in the builder's condition tree. */
+interface LeafNode {
+    kind: 'leaf';
+    lhs: string;
+    comparison: EuclidComparisonType;
+    value: EuclidValue;
+}
+/** An AND (`all`) or OR (`any`) group of condition nodes. */
+interface GroupNode {
+    kind: 'all' | 'any';
+    children: ConditionNode[];
+}
+type ConditionNode = LeafNode | GroupNode;
+/**
+ * A condition leaf. Numeric values (amount, merchant_volume) tag as `number`;
+ * string values (payment_method, connector, currency, card_network) tag as
+ * `enum_variant`.
+ */
+declare function leaf(lhs: string, comparison: EuclidComparisonType, value: string | number): LeafNode;
+/** AND group — all children must match. */
+declare function allOf(...children: ConditionNode[]): GroupNode;
+/** OR group — any child matching is enough. */
+declare function anyOf(...children: ConditionNode[]): GroupNode;
 /**
  * How a rule (or the default) prices a transaction. `fee_type` is inferred:
  * percentage-only → `percentage`, flat-only → `flat`, both → `combined`.
@@ -4617,12 +4670,29 @@ interface FeeRuleConditions {
     connector?: Connector;
     currency?: Currency;
     cardNetwork?: string;
+    /**
+     * Customer billing-address country. Must be the exact backend `Country` enum
+     * variant (PascalCase full name, e.g. `Germany`/`UnitedStatesOfAmerica`), not
+     * an ISO code — the engine lowers `billing_country` via case-sensitive
+     * `from_str`.
+     */
+    billingCountry?: string;
     /** `amount == n` (minor units). */
     amountEquals?: number;
     /** `amount > n` (minor units). */
     amountGreaterThan?: number;
     /** `amount < n` (minor units). */
     amountLessThan?: number;
+    /**
+     * `merchant_volume == n` — the merchant's previous-month volume snapshot
+     * (USD minor units). Combine with any other condition, e.g.
+     * `{ paymentMethod: 'crypto', merchantVolumeGreaterThan: 1_000_000 }`.
+     */
+    merchantVolumeEquals?: number;
+    /** `merchant_volume > n` (USD minor units). */
+    merchantVolumeGreaterThan?: number;
+    /** `merchant_volume < n` (USD minor units). */
+    merchantVolumeLessThan?: number;
 }
 interface FeeRuleInput {
     name: string;
@@ -4630,8 +4700,35 @@ interface FeeRuleInput {
     when?: FeeRuleConditions;
     /** Extra raw conditions ANDed in, for dimensions `when` does not cover. */
     rawConditions?: EuclidComparison[];
+    /** Nested AND/OR condition tree. Mutually exclusive with `when`/`rawConditions`. */
+    match?: ConditionNode;
     fee: FeeSpecInput;
 }
+/**
+ * Decode a rule's `statements[]` back into a condition tree.
+ *
+ * Returns a tree that is **logically equivalent** to the source. It is
+ * deep-equal to `normalizeNode(input)` only when no `all` group contains two
+ * or more `any` groups; where the encoder distributed AND over OR, the decoded
+ * shape differs (still equivalent).
+ */
+declare function ruleMatchToTree(statements: EuclidIfStatement[]): ConditionNode;
+/**
+ * Decode a stored program into the builder's editable model.
+ *
+ * Returns a tree that is **logically equivalent** to the source. It is
+ * deep-equal to `normalizeNode(input)` only when no `all` group contains two
+ * or more `any` groups; where the encoder distributed AND over OR, the decoded
+ * shape differs (still equivalent).
+ */
+declare function programToTree(program: PlatformFeeProgram): {
+    rules: {
+        name: string;
+        match: ConditionNode;
+        fee: PlatformFeeOutput | null;
+    }[];
+    otherwise: PlatformFeeOutput | null;
+};
 /**
  * Fluent builder for a platform fee-rule program. Emits the exact Euclid wire
  * shape (camelCase tree, tagged values, `metadata: {}` everywhere) so callers
@@ -4804,4 +4901,4 @@ declare function parseImportedBranding(raw: unknown): CheckoutBranding;
 declare function applyBrandingVariables(el: HTMLElement, b: CheckoutBranding): void;
 declare function shadowFor(style: SurfaceStyle): string;
 
-export { type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AuthResponse, type AuthenticationCreateRequest, type AuthenticationResponse, type AuthenticationStatus, type AuthenticationType, type AutoRechargeConfig, type AutoRechargeUpdateRequest, type AvailabilityOverrideCreateRequest, type AvailabilityOverrideResponse, AvailabilityOverrides, type AvailabilityPreviewMethod, type AvailabilityPreviewParams, type AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, type BillingCompleteSetupRequest, type BillingProfileResponse, type BillingSetupRequest, type BillingSetupResponse, type BlockedAttempt, type BlockedAttemptListParams, type BlockedAttemptListResponse, type BlocklistAddRequest, type BlocklistDataKind, type BlocklistResponse, type BrandingExport, type BrandingSource, type BuiltInRegionGroupResponse, type BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, Cards, type ChangePasswordRequest, type CheckoutBranding, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorResponse, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceRequest, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EphemeralKeyCreateRequest, type EphemeralKeyCreateResponse, type EuclidComparison, type EuclidComparisonType, type EuclidIfStatement, type EuclidValue, type EventClass, type EventDeliveryAttemptResponse, type EventDetailResponse, type EventListParams, type EventListResponse, type EventResponse, type EventType, Export, FeatureMatrix, type FeeOwner, FeeProgramBuilder, type FeeRuleConditions, type FeeRuleInput, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeType, Files, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type LoginHistoryEntry, type LoginHistoryParams, type LoginHistoryResponse, type LogoShape, type LogoSize, type MandateListParams, type MandateResponse, type MandateRevokedResponse, type MandateStatus, type MandateType, type MerchantAccountCreateRequest, type MerchantAccountResponse, type MerchantAccountType, type MerchantAccountUpdateRequest, type MerchantOverviewResponse, type MerchantOverviewStat, type MerchantRoutingAlgorithm, type MethodSurcharge, type NonPillRadius, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodListParams, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentUpdateRequest, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PerMethodSurchargeItem, type PermissionScope, type PhoneDetails, type PhoneOtpRequest, type PhoneOtpResponse, type PhoneOtpVerifyRequest, type PhoneOtpVerifyResponse, type PlatformFeeKind, type PlatformFeeOutput, type PlatformFeeProgram, type PlatformFeeRule, type PlatformFeeRuleInput, type PlatformFeeRuleOutput, type PlatformFeeRuleRecord, type PlatformFeeRuleRequest, type PollStatus, type PollStatusResponse, type ProfileAcquirerCreateRequest, type ProfileAcquirerResponse, type ProfileAcquirerUpdateRequest, type ProfileCreateRequest, type ProfileDefaultRoutingConfig, type ProfileDeniedConnectorsResponse, type ProfileLogoUploadResponse, type ProfileResponse, type ProfileUpdateRequest, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type RecoveryCodesResponse, type RefundCreateRequest, type RefundListParams, type RefundListResponse, type RefundResponse, type RefundStatus, type RefundType, type RefundUpdateRequest, type RegionCountriesResponse, type RegionCreateRequest, type RegionResponse, type RegionSetCountriesRequest, type RegionUpdateRequest, Regions, type RelayRequest, type RelayResponse, type RelayStatus, type RelayType, type RequestExtras, type RequestFn, type RequestOptions, type ResetPasswordRequest, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, type ShopCreateRequest, type ShopResponse, type ShopStats, type ShopUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StaticRoutingAlgorithm, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeRuleRequest, type SurchargeRuleResponse, type SurfaceStyle, type SwitchMerchantRequest, type SwitchProfileRequest, type Terminate2faQueryParams, type ThreeDSDecision, type ThreeDsRuleExecuteRequest, type ThreeDsRuleResponse, type TierSummary, type TokenPurpose, type TokenResponse, type TopupRequest, type TopupResponse, type TotpResponse, type TransactionType, type TrustBadge, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, Webhooks, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, feeProgram, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, logoDimensions, parseImportedBranding, radiusValue, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue };
+export { type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AuthResponse, type AuthenticationCreateRequest, type AuthenticationResponse, type AuthenticationStatus, type AuthenticationType, type AutoRechargeConfig, type AutoRechargeUpdateRequest, type AvailabilityOverrideCreateRequest, type AvailabilityOverrideResponse, AvailabilityOverrides, type AvailabilityPreviewMethod, type AvailabilityPreviewParams, type AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, type BillingCompleteSetupRequest, type BillingProfileResponse, type BillingSetupRequest, type BillingSetupResponse, type BlockedAttempt, type BlockedAttemptListParams, type BlockedAttemptListResponse, type BlocklistAddRequest, type BlocklistDataKind, type BlocklistResponse, type BrandingExport, type BrandingSource, type BuiltInRegionGroupResponse, type BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, Cards, type ChangePasswordRequest, type CheckoutBranding, type ConditionNode, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorResponse, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceRequest, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EphemeralKeyCreateRequest, type EphemeralKeyCreateResponse, type EuclidComparison, type EuclidComparisonType, type EuclidIfStatement, type EuclidValue, type EventClass, type EventDeliveryAttemptResponse, type EventDetailResponse, type EventListParams, type EventListResponse, type EventResponse, type EventType, Export, FeatureMatrix, type FeeOwner, FeeProgramBuilder, type FeeRuleConditions, type FeeRuleInput, type FeeRulePreviewRequest, type FeeRulePreviewResponse, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeType, Files, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type GroupNode, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LeafNode, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type LoginHistoryEntry, type LoginHistoryParams, type LoginHistoryResponse, type LogoShape, type LogoSize, type MandateListParams, type MandateResponse, type MandateRevokedResponse, type MandateStatus, type MandateType, type MerchantAccountCreateRequest, type MerchantAccountResponse, type MerchantAccountType, type MerchantAccountUpdateRequest, type MerchantOverviewResponse, type MerchantOverviewStat, type MerchantRoutingAlgorithm, type MethodSurcharge, type NonPillRadius, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodListParams, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentUpdateRequest, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PerMethodSurchargeItem, type PermissionScope, type PhoneDetails, type PhoneOtpRequest, type PhoneOtpResponse, type PhoneOtpVerifyRequest, type PhoneOtpVerifyResponse, type PlatformFeeKind, type PlatformFeeOutput, type PlatformFeeProgram, type PlatformFeeRule, type PlatformFeeRuleInput, type PlatformFeeRuleOutput, type PlatformFeeRuleRecord, type PlatformFeeRuleRequest, type PollStatus, type PollStatusResponse, type ProfileAcquirerCreateRequest, type ProfileAcquirerResponse, type ProfileAcquirerUpdateRequest, type ProfileCreateRequest, type ProfileDefaultRoutingConfig, type ProfileDeniedConnectorsResponse, type ProfileLogoUploadResponse, type ProfileResponse, type ProfileUpdateRequest, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type RecoveryCodesResponse, type RefundCreateRequest, type RefundListParams, type RefundListResponse, type RefundResponse, type RefundStatus, type RefundType, type RefundUpdateRequest, type RegionCountriesResponse, type RegionCreateRequest, type RegionResponse, type RegionSetCountriesRequest, type RegionUpdateRequest, Regions, type RelayRequest, type RelayResponse, type RelayStatus, type RelayType, type RequestExtras, type RequestFn, type RequestOptions, type ResetPasswordRequest, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, type ShopCreateRequest, type ShopResponse, type ShopStats, type ShopUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StaticRoutingAlgorithm, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeRuleRequest, type SurchargeRuleResponse, type SurfaceStyle, type SwitchMerchantRequest, type SwitchProfileRequest, type Terminate2faQueryParams, type ThreeDSDecision, type ThreeDsRuleExecuteRequest, type ThreeDsRuleResponse, type TierSummary, type TokenPurpose, type TokenResponse, type TopupRequest, type TopupResponse, type TotpResponse, type TransactionType, type TrustBadge, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, feeProgram, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, leaf, logoDimensions, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue };

package/dist/index.js

@@ -22,6 +22,8 @@ import {
   Search,
   Subscriptions,
   Webhooks,
+  allOf,
+  anyOf,
   applyBrandingVariables,
   buildBrandingExport,
   buttonPadValue,
@@ -37,14 +39,17 @@ import {
   inputPadValue,
   isDarkSurface,
   isHexColor,
+  leaf,
   logoDimensions,
   parseImportedBranding,
+  programToTree,
   radiusValue,
+  ruleMatchToTree,
   sanitizeCustomCss,
   shadowFor,
   surfacePadValue,
   verticalGapValue
-} from "./chunk-NNSPBDYP.js";
+} from "./chunk-ABYAZHZC.js";
 export {
   Analytics,
   AnalyticsDashboard,
@@ -69,6 +74,8 @@ export {
   Search,
   Subscriptions,
   Webhooks,
+  allOf,
+  anyOf,
   applyBrandingVariables,
   buildBrandingExport,
   buttonPadValue,
@@ -84,9 +91,12 @@ export {
   inputPadValue,
   isDarkSurface,
   isHexColor,
+  leaf,
   logoDimensions,
   parseImportedBranding,
+  programToTree,
   radiusValue,
+  ruleMatchToTree,
   sanitizeCustomCss,
   shadowFor,
   surfacePadValue,

package/dist/internal.cjs

@@ -55,6 +55,8 @@ __export(internal_exports, {
   Search: () => Search,
   Subscriptions: () => Subscriptions,
   Webhooks: () => Webhooks,
+  allOf: () => allOf,
+  anyOf: () => anyOf,
   applyBrandingVariables: () => applyBrandingVariables,
   buildBrandingExport: () => buildBrandingExport,
   buttonPadValue: () => buttonPadValue,
@@ -70,9 +72,12 @@ __export(internal_exports, {
   inputPadValue: () => inputPadValue,
   isDarkSurface: () => isDarkSurface,
   isHexColor: () => isHexColor,
+  leaf: () => leaf,
   logoDimensions: () => logoDimensions,
   parseImportedBranding: () => parseImportedBranding,
+  programToTree: () => programToTree,
   radiusValue: () => radiusValue,
+  ruleMatchToTree: () => ruleMatchToTree,
   sanitizeCustomCss: () => sanitizeCustomCss,
   shadowFor: () => shadowFor,
   surfacePadValue: () => surfacePadValue,
@@ -809,6 +814,20 @@ var FeeRulesManager = class {
       query: { merchant_id: merchantId, profile_id: profileId }
     });
   }
+  /**
+   * Dry-run a candidate fee-rule program against a sample transaction.
+   * Returns the matched rule name, whether it fell through, and the computed fee.
+   * Does not persist anything.
+   *
+   * @param input - Candidate program + sample transaction fields.
+   * @param merchantId - The merchant account ID.
+   */
+  async preview(input, merchantId) {
+    return this.request("POST", "/merchant-fees/rules/preview", {
+      body: input,
+      query: { merchant_id: merchantId }
+    });
+  }
 };
 
 // src/resources/mandates.ts
@@ -3255,6 +3274,16 @@ var Delopay = class {
 Delopay.webhooks = Webhooks;
 
 // src/feeProgram.ts
+function leaf(lhs, comparison, value) {
+  const tagged = typeof value === "number" ? { type: "number", value } : { type: "enum_variant", value };
+  return { kind: "leaf", lhs, comparison, value: tagged };
+}
+function allOf(...children) {
+  return { kind: "all", children };
+}
+function anyOf(...children) {
+  return { kind: "any", children };
+}
 function toFeeOutput(spec) {
   const hasPct = spec.percentage != null;
   const hasFlat = spec.flat != null;
@@ -3280,6 +3309,7 @@ function buildConditions(when = {}, raw = []) {
   if (when.connector != null) out.push(enumCondition("connector", when.connector));
   if (when.currency != null) out.push(enumCondition("currency", when.currency));
   if (when.cardNetwork != null) out.push(enumCondition("card_network", when.cardNetwork));
+  if (when.billingCountry != null) out.push(enumCondition("billing_country", when.billingCountry));
   if (when.amountEquals != null) out.push(numberCondition("amount", "equal", when.amountEquals));
   if (when.amountGreaterThan != null) {
     out.push(numberCondition("amount", "greater_than", when.amountGreaterThan));
@@ -3287,9 +3317,83 @@ function buildConditions(when = {}, raw = []) {
   if (when.amountLessThan != null) {
     out.push(numberCondition("amount", "less_than", when.amountLessThan));
   }
+  if (when.merchantVolumeEquals != null) {
+    out.push(numberCondition("merchant_volume", "equal", when.merchantVolumeEquals));
+  }
+  if (when.merchantVolumeGreaterThan != null) {
+    out.push(numberCondition("merchant_volume", "greater_than", when.merchantVolumeGreaterThan));
+  }
+  if (when.merchantVolumeLessThan != null) {
+    out.push(numberCondition("merchant_volume", "less_than", when.merchantVolumeLessThan));
+  }
   out.push(...raw);
   return out;
 }
+function leafToComparison(node) {
+  return { lhs: node.lhs, comparison: node.comparison, value: node.value, metadata: {} };
+}
+function normalizeNode(node) {
+  if (node.kind === "leaf") return node;
+  const children = node.children.map(normalizeNode);
+  const flat = [];
+  for (const c of children) {
+    if (c.kind === node.kind) flat.push(...c.children);
+    else flat.push(c);
+  }
+  if (flat.length === 1) return flat[0];
+  return { kind: node.kind, children: flat };
+}
+function toStatement(node) {
+  if (node.kind === "leaf") return { condition: [leafToComparison(node)], nested: null };
+  if (node.kind === "any") {
+    return { condition: [], nested: node.children.map(toStatement) };
+  }
+  const leaves = node.children.filter((c) => c.kind === "leaf");
+  const groups = node.children.filter((c) => c.kind !== "leaf");
+  const condition = leaves.map(leafToComparison);
+  if (groups.length === 0) return { condition, nested: null };
+  const [first, ...rest] = groups;
+  const nested = first.children.map((branch) => toStatement(normalizeNode(allOf(branch, ...rest))));
+  return { condition, nested };
+}
+function assertNoEmptyAnyOf(node) {
+  if (node.kind === "leaf") return;
+  if (node.kind === "any" && node.children.length === 0) {
+    throw new Error("feeProgram: an anyOf() group must have at least one condition");
+  }
+  node.children.forEach(assertNoEmptyAnyOf);
+}
+function encodeStatements(match) {
+  const m = normalizeNode(match);
+  if (m.kind === "any") return m.children.map(toStatement);
+  return [toStatement(m)];
+}
+function comparisonToLeaf(c) {
+  return { kind: "leaf", lhs: c.lhs, comparison: c.comparison, value: c.value };
+}
+function statementToNode(stmt) {
+  const leaves = stmt.condition.map(comparisonToLeaf);
+  if (stmt.nested && stmt.nested.length > 0) {
+    const orNode = anyOf(...stmt.nested.map(statementToNode));
+    if (leaves.length === 0) return orNode;
+    return allOf(...leaves, orNode);
+  }
+  return leaves.length === 1 ? leaves[0] : allOf(...leaves);
+}
+function ruleMatchToTree(statements) {
+  if (statements.length === 1) return normalizeNode(statementToNode(statements[0]));
+  return normalizeNode(anyOf(...statements.map(statementToNode)));
+}
+function programToTree(program) {
+  return {
+    rules: program.rules.map((r) => ({
+      name: r.name,
+      match: ruleMatchToTree(r.statements),
+      fee: r.connectorSelection.fee ?? null
+    })),
+    otherwise: program.defaultSelection.fee ?? null
+  };
+}
 var FeeProgramBuilder = class {
   constructor() {
     this.rules = [];
@@ -3297,10 +3401,12 @@ var FeeProgramBuilder = class {
   }
   /** Append a rule. Provided `when`/`rawConditions` are ANDed. */
   rule(input) {
+    if (input.match) assertNoEmptyAnyOf(input.match);
+    const statements = input.match ? encodeStatements(input.match) : [{ condition: buildConditions(input.when, input.rawConditions) }];
     this.rules.push({
       name: input.name,
       connectorSelection: { fee: toFeeOutput(input.fee) },
-      statements: [{ condition: buildConditions(input.when, input.rawConditions) }]
+      statements
     });
     return this;
   }
@@ -4399,6 +4505,17 @@ var PlatformFeeRulesManager = class {
       query: { merchant_id: merchantId, profile_id: profileId }
     });
   }
+  /**
+   * Dry-run a candidate fee-rule program against a sample transaction.
+   * Returns the matched rule name, whether it fell through, and the computed fee.
+   * Does not persist anything.
+   */
+  async preview(input, merchantId) {
+    return this.request("POST", "/admin/fees/rules/preview", {
+      body: input,
+      query: { merchant_id: merchantId }
+    });
+  }
 };
 
 // src/internal/client.ts
@@ -4456,6 +4573,8 @@ var DelopayInternal = class extends Delopay {
   Search,
   Subscriptions,
   Webhooks,
+  allOf,
+  anyOf,
   applyBrandingVariables,
   buildBrandingExport,
   buttonPadValue,
@@ -4471,9 +4590,12 @@ var DelopayInternal = class extends Delopay {
   inputPadValue,
   isDarkSurface,
   isHexColor,
+  leaf,
   logoDimensions,
   parseImportedBranding,
+  programToTree,
   radiusValue,
+  ruleMatchToTree,
   sanitizeCustomCss,
   shadowFor,
   surfacePadValue,