@delopay/sdk 0.85.0 → 0.87.0

package/dist/index.d.ts

@@ -149,6 +149,13 @@ interface PaymentCreateRequest {
     description?: string | null;
     /** URL to redirect the customer to after payment (required for redirect-based methods). */
     return_url?: string | null;
+    /**
+     * How long the client secret / hosted checkout link stays usable, in
+     * seconds from creation. Omit to inherit the shop's default
+     * (`business_profile.session_expiry`, itself defaulting to 15 minutes).
+     * The backend rejects values outside its accepted window with a 400.
+     */
+    session_expiry?: number | null;
     /** Descriptor shown on the customer's bank statement (name portion). */
     statement_descriptor_name?: string | null;
     /** Descriptor shown on the customer's bank statement (suffix portion). */
@@ -211,6 +218,8 @@ interface PaymentCreateRequest {
 interface PaymentUpdateRequest {
     amount?: number | null;
     currency?: Currency | null;
+    /** See {@link PaymentCreateRequest.session_expiry}. */
+    session_expiry?: number | null;
     order_tax_amount?: number | null;
     amount_to_capture?: number | null;
     shipping_cost?: number | null;
@@ -346,6 +355,14 @@ interface PaymentResponse {
     client_secret?: string | null;
     /** ISO 8601 timestamp when the payment was created. */
     created?: string | null;
+    /**
+     * ISO 8601 timestamp when the payment (its client secret / hosted
+     * checkout link) expires — the backend's resolved `session_expiry`, which
+     * may differ from the requested one if it was omitted or clamped.
+     * Backends predating the field omit the key entirely (`undefined` here);
+     * backends that expose it may still send `null` when no expiry applies.
+     */
+    expires_on?: string | null;
     /** ISO 8601 timestamp of the last status update. */
     last_updated?: string | null;
     /** Whether the payment method is saved for future use. */
@@ -2280,6 +2297,16 @@ interface UserResponse {
     verification_days_left?: number | null;
     recovery_codes_left?: number | null;
     theme_id?: string | null;
+    /**
+     * The caller's user-scoped metadata bucket (free-form JSON), as updated by
+     * `users.updateMetadata`. Absent/null = bucket unused.
+     */
+    user_metadata?: Record<string, unknown> | null;
+    /**
+     * The merchant-scoped metadata bucket shared by every dashboard user of
+     * the merchant, as updated by `users.updateMerchantMetadata`.
+     */
+    merchant_metadata?: Record<string, unknown> | null;
 }
 interface ChangePasswordRequest {
     old_password: string;
@@ -3846,11 +3873,15 @@ interface OperationLimitRule {
     merchant_id: string;
     operation: LimitedOperation;
     scope: OperationLimitScope;
-    scope_id?: string | null;
-    max_amount_per_operation?: number | null;
-    max_total_amount_per_window?: number | null;
-    max_count_per_window?: number | null;
-    max_payment_age_days?: number | null;
+    /**
+     * Always present on the wire (nullable, never omitted) — as are the four
+     * limit fields below: the backend serializes every `Option` key.
+     */
+    scope_id: string | null;
+    max_amount_per_operation: number | null;
+    max_total_amount_per_window: number | null;
+    max_count_per_window: number | null;
+    max_payment_age_days: number | null;
     window_hours: number;
     /** ISO currency code of the amount fields. */
     currency: string;
@@ -4108,6 +4139,138 @@ interface CheckoutBrandingUpdate {
     /** Applied as a whole-object replace of `payment_link_config`. */
     payment_link_config?: BusinessPaymentLinkConfig | null;
 }
+/** A VGS vault environment. */
+type VaultEnvironment = 'sandbox' | 'live';
+/** What a VGS route is for: inbound card capture or outbound reveal. */
+type VaultRoutePurpose = 'collect' | 'reveal';
+type VaultRouteChangeKind = 'create' | 'update' | 'unchanged';
+interface VaultRouteFieldChange {
+    path: string;
+    from?: string | null;
+    to?: string | null;
+}
+type VaultRouteWarningCode = 'templated_connector_base_url' | 'applier_reported';
+/** A non-fatal finding from a vault-route preview or apply. */
+interface VaultRouteWarning {
+    code: VaultRouteWarningCode;
+    connector?: string | null;
+    detail?: string | null;
+}
+interface VaultRouteChange {
+    route_id: string;
+    purpose: VaultRoutePurpose;
+    change: VaultRouteChangeKind;
+    field_changes: VaultRouteFieldChange[];
+}
+type VaultCheckId = 'collect_credentials_valid' | 'collect_write_only' | 'management_scopes' | 'vault_reachable' | 'environment_coherent' | 'reveal_route_covers_processors' | 'collect_route_exists' | 'ca_certificate_configured';
+type VaultCheckStatus = 'pass' | 'fail' | 'unknown';
+interface VaultCheck {
+    id: VaultCheckId;
+    status: VaultCheckStatus;
+    /** Always present on the wire (nullable, never omitted). */
+    detail: string | null;
+}
+interface VaultVerifyRequest {
+    profile_id: string;
+}
+/** Result of `POST .../vault/verify` — configuration checks for a vault MCA. */
+interface VaultVerificationResponse {
+    passed: boolean;
+    checks: VaultCheck[];
+    /** Vault egress IPs the merchant's processors may need to allowlist. */
+    egress_ips_to_allowlist: string[];
+}
+interface VaultRoutesPreviewRequest {
+    profile_id: string;
+    /** `sandbox` or `live`; omitted = derived from the credentials. */
+    environment?: VaultEnvironment;
+}
+/**
+ * Fingerprint of the vault's current routes. `null` is a real value meaning
+ * "no routes exist" (the wire is an untagged enum), and must be sent back
+ * as `null` on apply rather than omitted.
+ */
+type VaultRoutesFingerprint = string | null;
+interface VaultRoutesPreviewResponse {
+    vault_id: string;
+    environment: VaultEnvironment;
+    /** Opaque token covering the desired route document; echo on apply. */
+    desired_fingerprint: string;
+    desired_upstream_hosts: string[];
+    /** Opaque token covering what exists now; echo on apply. See {@link VaultRoutesFingerprint}. */
+    current_fingerprint: VaultRoutesFingerprint;
+    changes: VaultRouteChange[];
+    warnings: VaultRouteWarning[];
+}
+interface VaultRoutesApplyRequest {
+    profile_id: string;
+    environment?: VaultEnvironment;
+    /**
+     * From the preview, byte for byte. `null` means the preview found no
+     * routes and is a real value — an absent key is refused by the router.
+     */
+    expected_current_fingerprint: VaultRoutesFingerprint;
+    /** From the same preview, byte for byte. */
+    expected_desired_fingerprint: string;
+}
+interface VaultRouteIds {
+    collect: string;
+    reveal: string;
+}
+interface VaultRouteApplyVerification {
+    established: string[];
+    not_established: string[];
+    routes_appeared: string[];
+}
+interface VaultRoutesApplyResponse {
+    applied: boolean;
+    route_ids: VaultRouteIds;
+    collect_route_id_stored: boolean;
+    warnings: VaultRouteWarning[];
+    verification?: VaultRouteApplyVerification | null;
+}
+/**
+ * Body of `PATCH /user/metadata` and `PATCH /user/merchant/metadata` — an
+ * RFC 7396 merge patch over the metadata bucket. An object merges key by
+ * key (a `null` value removes that key); a root-level `null` clears the
+ * whole bucket. Anything else is rejected with a 400.
+ */
+interface UpdateMetadataRequest {
+    patch: Record<string, unknown> | null;
+}
+/** How a catalog entry's country coverage is interpreted. */
+type EpayoutsLocality = 'country_locked' | 'regional' | 'universal';
+/** Which processing rail a catalog entry mints codes for. */
+type EpayoutsRail = {
+    kind: 'local_bank_redirect';
+} | {
+    kind: 'credit_card_redirect';
+} | {
+    kind: 'bank_redirect';
+    pmt: string;
+    data_variant: string;
+};
+interface EpayoutsCatalogEntry {
+    vendor_code: string;
+    family: string;
+    display_name?: string | null;
+    category?: string | null;
+    /** Sanitised inline SVG for the tile icon, when set. */
+    icon_svg?: string | null;
+    /** ISO 3166-1 alpha-2 codes (lowercase) the entry covers. */
+    coverage: string[];
+    pmin?: number | null;
+    pmax?: number | null;
+    enabled: boolean;
+    locality: EpayoutsLocality;
+    rail: EpayoutsRail;
+}
+interface EpayoutsCatalogResponse {
+    entries: EpayoutsCatalogEntry[];
+    /** Set by a sync sweep: how many countries were probed / answered. */
+    countries_probed?: number | null;
+    countries_ok?: number | null;
+}
 
 /** Create and manage API keys for a merchant account. */
 declare class ApiKeys {
@@ -4368,6 +4531,27 @@ declare class Connectors {
     create(accountId: string, params: ConnectorCreateRequest): Promise<ConnectorResponse>;
     retrieve(accountId: string, connectorId: string): Promise<ConnectorResponse>;
     list(accountId: string): Promise<ConnectorResponse[]>;
+    /**
+     * The profile-scoped connector list. The merchant-wide `list()` is
+     * merchant-gated and 403s for a profile-entity (shop user) JWT; this
+     * variant is scoped server-side to the caller's own profile.
+     *
+     * `GET /account/{accountId}/profile/connectors`
+     */
+    listByProfile(accountId: string): Promise<ConnectorResponse[]>;
+    /**
+     * The built-in e-Payouts reference catalog — the "Restore defaults" source.
+     * `GET /account/{accountId}/connectors/epayouts/catalog/defaults`
+     */
+    getEpayoutsCatalogDefaults(accountId: string): Promise<EpayoutsCatalogResponse>;
+    /**
+     * Sweep the merchant's own e-Payouts module and return the rails it
+     * actually has enabled. Server-side this makes many upstream calls, so it
+     * can take several seconds — show progress.
+     *
+     * `POST /account/{accountId}/connectors/{connectorId}/epayouts/catalog/sync`
+     */
+    syncEpayoutsCatalog(accountId: string, connectorId: string): Promise<EpayoutsCatalogResponse>;
     update(accountId: string, connectorId: string, params: ConnectorUpdateRequest): Promise<ConnectorResponse>;
     delete(accountId: string, connectorId: string): Promise<ConnectorResponse>;
     /**
@@ -4380,6 +4564,37 @@ declare class Connectors {
      * the target shop.
      */
     clone(accountId: string, connectorId: string, params: ConnectorCloneRequest): Promise<ConnectorResponse>;
+    /**
+     * Run the configuration checks for a vault (VGS) connector account:
+     * credential validity, write-only Collect scope, reachability, environment
+     * coherence, route coverage. Read-only but not cheap — it decrypts the
+     * vault's management credential and talks to VGS.
+     *
+     * `POST /account/{accountId}/connectors/{connectorId}/vault/verify`
+     */
+    verifyVault(accountId: string, connectorId: string, params: VaultVerifyRequest): Promise<VaultVerificationResponse>;
+    /**
+     * Compute the route document the vault SHOULD have and diff it against
+     * what exists, without writing anything. The returned fingerprints must be
+     * echoed byte for byte on {@link Connectors.applyVaultRoutes}.
+     *
+     * A router without these endpoints answers 404 — render that as "this
+     * build cannot configure routes", never as "there is nothing to change".
+     *
+     * `POST /account/{accountId}/connectors/{connectorId}/vault/routes/preview`
+     */
+    previewVaultRoutes(accountId: string, connectorId: string, params: VaultRoutesPreviewRequest): Promise<VaultRoutesPreviewResponse>;
+    /**
+     * Write the routes the merchant just previewed. Both fingerprints come
+     * from the preview and are opaque: `expected_current_fingerprint` says the
+     * vault has not moved (`null` = "the preview found no routes" and is sent
+     * as `null`, never omitted), `expected_desired_fingerprint` says the
+     * document is still the one on screen. A 409 (`DE_04`) means the vault
+     * changed since the preview — nothing was written; preview again.
+     *
+     * `POST /account/{accountId}/connectors/{connectorId}/vault/routes/apply`
+     */
+    applyVaultRoutes(accountId: string, connectorId: string, params: VaultRoutesApplyRequest): Promise<VaultRoutesApplyResponse>;
     /** Verify connector credentials. `POST /account/connectors/verify` */
     verify(params: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
@@ -5870,6 +6085,22 @@ declare class Users {
     revokeSession(sessionId: string): Promise<UserSessionRevokeResponse>;
     getDetails(): Promise<UserResponse>;
     update(params: UpdateUserDetailsRequest): Promise<UserResponse>;
+    /**
+     * RFC 7396 merge-patch the caller's own user-scoped metadata bucket.
+     * Returns the full user details, so callers can refresh their context
+     * without a second fetch.
+     *
+     * `PATCH /user/metadata`
+     */
+    updateMetadata(params: UpdateMetadataRequest): Promise<UserResponse>;
+    /**
+     * RFC 7396 merge-patch the merchant-scoped metadata bucket shared by
+     * every dashboard user of the merchant. Same response contract as
+     * {@link Users.updateMetadata}.
+     *
+     * `PATCH /user/merchant/metadata`
+     */
+    updateMerchantMetadata(params: UpdateMetadataRequest): Promise<UserResponse>;
     /**
      * Permanently delete the caller's account. Requires a fresh password
      * (and a current 6-digit TOTP code if the user has TOTP enrolled). On
@@ -7600,4 +7831,4 @@ declare function focusedCheckoutUrl(params: FocusedCheckoutUrlParams): string;
 declare const CHECKOUT_EVENT_KINDS: readonly ["native_pane_selected", "native_pane_tab_opened", "native_pane_tab_blocked", "native_pane_abandoned", "native_pane_returned"];
 type CheckoutEventKind = (typeof CHECKOUT_EVENT_KINDS)[number];
 
-export { ALL_CUSTOM_FIELD_CONDITION_SOURCES, ALL_CUSTOM_FIELD_OPERATORS, ALL_CUSTOM_FIELD_TYPES, type AddUserRequest, type AddUserResponse, type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, type AmountFilter, type AmountRange, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsMethodSlice, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyListConstraints, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AttemptStatus, 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 BankCodeResponse, type BankDebitTypes, type BankTransferTypes, 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, CHECKBOX_CHECKED, CHECKBOX_UNCHECKED, CHECKOUT_EVENT_KINDS, CUSTOM_CSS_MAX_LENGTH, CUSTOM_FIELDS_MAX, CUSTOM_FIELD_CONDITIONS_MAX, CUSTOM_FIELD_KEY_PATTERN, CUSTOM_FIELD_OPERATORS_BY_SOURCE, CUSTOM_FIELD_VALUELESS_OPERATORS, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, type CardNetworkTypes, Cards, type ChangePasswordRequest, type CheckoutBranding, type CheckoutBrandingUpdate, type CheckoutCustomField, type CheckoutEventKind, CheckoutSession, type CheckoutSessionOptions, type ConditionNode, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCloneRequest, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorOwnership, type ConnectorResponse, type ConnectorSelection, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type ConnectorWebhookSyncResponse, type ConnectorWebhookSyncResult, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CurrencyRevenue, type CustomFieldCondition, type CustomFieldConditionSource, type CustomFieldContext, type CustomFieldOperator, type CustomFieldOption, type CustomFieldTranslations, type CustomFieldType, type CustomFieldVisibility, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, type DeleteUserRoleRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceBlock, type DisputeEvidenceRequest, type DisputeEvidenceType, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EpayoutsMethod, type EpayoutsMethodsResponse, 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 FeeRuleDefaultPrecedence, type FeeRuleInput, type FeeRulePreviewRequest, type FeeRulePreviewResponse, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeStatementDetail, type FeeStatementSummary, type FeeType, Files, type FocusedCheckoutUrlParams, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type GroupNode, type ImpersonateEmployeeRequest, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LeafNode, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LimitedOperation, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type ListUsersInLineageParams, 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 MinimalRoleInfo, NATIVE_PANES_MAX, NATIVE_PANE_CATEGORY_KEYS, NATIVE_PANE_ICON_KEYS, type NativePaneMethodInfo, type NativePaneOpenTarget, type NativePaneRail, type NativePaneView, type NativePaneVisibility, type NonPillRadius, type OperationLimitOnExceeded, type OperationLimitRule, type OperationLimitRuleDeleteResponse, type OperationLimitRuleListParams, type OperationLimitScope, type OperationLimitSettings, type OperationLimitWindowMode, OperationLimits, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentAttemptResponse, type PaymentAttemptsListResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentClientContextEntry, type PaymentClientContextListResponse, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentErrorDetails, type PaymentExperience, type PaymentExperienceTypes, type PaymentIdFormatConfig, type PaymentIdStyle, type PaymentIntentStateMetadata, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListFilterConstraints, type PaymentListFilteredResponse, type PaymentListOrder, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodAmountLimits, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodDisplayInfo, type PaymentMethodListInstallmentAmountDetails, type PaymentMethodListInstallmentOption, type PaymentMethodListInstallmentPlan, type PaymentMethodListIntentData, type PaymentMethodListParams, type PaymentMethodListResponse, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentStatusHistoryEntityType, type PaymentStatusHistoryEvent, type PaymentStatusHistoryResponse, type PaymentUpdateRequest, type PaymentsDeletePolicyResponse, type PaymentsDeleteResponse, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PayseproMethod, type PayseproMethodsResponse, 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 ProgramConnectorSelection, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type PublishableKey, type RecordCheckoutEventRequest, type RecordCheckoutEventResponse, type RecoveryCodesResponse, type RefundAggregateResponse, 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 RequiredFieldInfo, type ResetPasswordRequest, type ResponsePaymentMethodTypes, type ResponsePaymentMethodsEnabled, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, type RuleConnectorSelection, STRIPE_NATIVE_PANE_METHODS, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, Settlement, type SettlementBackfillRequest, type SettlementBackfillResponse, type SettlementBucket, type SettlementCurrentParams, type SettlementCurrentResponse, type SettlementLine, type SettlementLineListParams, type SettlementLineListResponse, type SettlementOverviewParams, type SettlementOverviewResponse, type SettlementPayoutStatus, type SettlementStatementListParams, type SettlementStatementListResponse, type ShopCreateRequest, type ShopFeeConfigEntry, type ShopFeeConfigParams, type ShopFeeConfigResponse, type ShopResponse, type ShopSettlementOverview, type ShopStats, type ShopStatsResponse, type ShopUpdateRequest, type ShopVisibilityResponse, type ShopVisibilityUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StatementAdjustment, type StatementAdjustmentCreateRequest, type StatementAdjustmentListResponse, type StatementGenerateRequest, type StatementPayoutUpdateRequest, type StatementPdfParams, type StaticRoutingAlgorithm, type StatsPeriod, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type StripeNativePane, type StripePaymentMethodDomainResult, type StripePaymentMethodDomainStatus, type StripePaymentMethodDomainsRegisterRequest, type StripePaymentMethodDomainsRegisterResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPaymentLink, type SubscriptionPaymentLookupRequest, type SubscriptionPaymentLookupResponse, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeDetailsResponse, type SurchargeResponse, 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 UpdateOperationLimitSettingsRequest, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UpdateUserRoleRequest, type UpsertOperationLimitRuleRequest, type UserInLineage, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VaultCollectSessionResponse, type VaultPaymentMethodRequest, type VaultPaymentMethodResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, type WebhookRegistrationEnvironment, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, cloneCustomField, cloneNativePane, customFieldContextFromMetadata, customFieldIsTextLike, customFieldOperatorTakesValue, customFieldOptionLabel, customFieldText, decodeBadges, decodeBranding, decodeCustomFields, decodeNativePanes, defaultBranding, defaultCustomFieldVisibility, defaultNativePane, defaultOperatorForSource, encodeBadges, encodeBranding, encodeCustomFields, encodeNativePanes, evaluateCustomFieldCondition, evaluateCustomFieldVisibility, feeProgram, focusedCheckoutUrl, fontStack, fontWeightValue, inputPadValue, isCheckboxChecked, isDarkSurface, isHexColor, leaf, logoDimensions, nativePaneMethodInfo, parseCustomFieldsLoose, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue, visibleCustomFields };
+export { ALL_CUSTOM_FIELD_CONDITION_SOURCES, ALL_CUSTOM_FIELD_OPERATORS, ALL_CUSTOM_FIELD_TYPES, type AddUserRequest, type AddUserResponse, type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, type AmountFilter, type AmountRange, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsMethodSlice, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyListConstraints, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AttemptStatus, 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 BankCodeResponse, type BankDebitTypes, type BankTransferTypes, 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, CHECKBOX_CHECKED, CHECKBOX_UNCHECKED, CHECKOUT_EVENT_KINDS, CUSTOM_CSS_MAX_LENGTH, CUSTOM_FIELDS_MAX, CUSTOM_FIELD_CONDITIONS_MAX, CUSTOM_FIELD_KEY_PATTERN, CUSTOM_FIELD_OPERATORS_BY_SOURCE, CUSTOM_FIELD_VALUELESS_OPERATORS, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, type CardNetworkTypes, Cards, type ChangePasswordRequest, type CheckoutBranding, type CheckoutBrandingUpdate, type CheckoutCustomField, type CheckoutEventKind, CheckoutSession, type CheckoutSessionOptions, type ConditionNode, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCloneRequest, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorOwnership, type ConnectorResponse, type ConnectorSelection, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type ConnectorWebhookSyncResponse, type ConnectorWebhookSyncResult, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CurrencyRevenue, type CustomFieldCondition, type CustomFieldConditionSource, type CustomFieldContext, type CustomFieldOperator, type CustomFieldOption, type CustomFieldTranslations, type CustomFieldType, type CustomFieldVisibility, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, type DeleteUserRoleRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceBlock, type DisputeEvidenceRequest, type DisputeEvidenceType, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EpayoutsCatalogEntry, type EpayoutsCatalogResponse, type EpayoutsLocality, type EpayoutsMethod, type EpayoutsMethodsResponse, type EpayoutsRail, 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 FeeRuleDefaultPrecedence, type FeeRuleInput, type FeeRulePreviewRequest, type FeeRulePreviewResponse, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeStatementDetail, type FeeStatementSummary, type FeeType, Files, type FocusedCheckoutUrlParams, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type GroupNode, type ImpersonateEmployeeRequest, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LeafNode, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LimitedOperation, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type ListUsersInLineageParams, 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 MinimalRoleInfo, NATIVE_PANES_MAX, NATIVE_PANE_CATEGORY_KEYS, NATIVE_PANE_ICON_KEYS, type NativePaneMethodInfo, type NativePaneOpenTarget, type NativePaneRail, type NativePaneView, type NativePaneVisibility, type NonPillRadius, type OperationLimitOnExceeded, type OperationLimitRule, type OperationLimitRuleDeleteResponse, type OperationLimitRuleListParams, type OperationLimitScope, type OperationLimitSettings, type OperationLimitWindowMode, OperationLimits, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentAttemptResponse, type PaymentAttemptsListResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentClientContextEntry, type PaymentClientContextListResponse, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentErrorDetails, type PaymentExperience, type PaymentExperienceTypes, type PaymentIdFormatConfig, type PaymentIdStyle, type PaymentIntentStateMetadata, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListFilterConstraints, type PaymentListFilteredResponse, type PaymentListOrder, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodAmountLimits, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodDisplayInfo, type PaymentMethodListInstallmentAmountDetails, type PaymentMethodListInstallmentOption, type PaymentMethodListInstallmentPlan, type PaymentMethodListIntentData, type PaymentMethodListParams, type PaymentMethodListResponse, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentStatusHistoryEntityType, type PaymentStatusHistoryEvent, type PaymentStatusHistoryResponse, type PaymentUpdateRequest, type PaymentsDeletePolicyResponse, type PaymentsDeleteResponse, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PayseproMethod, type PayseproMethodsResponse, 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 ProgramConnectorSelection, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type PublishableKey, type RecordCheckoutEventRequest, type RecordCheckoutEventResponse, type RecoveryCodesResponse, type RefundAggregateResponse, 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 RequiredFieldInfo, type ResetPasswordRequest, type ResponsePaymentMethodTypes, type ResponsePaymentMethodsEnabled, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, type RuleConnectorSelection, STRIPE_NATIVE_PANE_METHODS, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, Settlement, type SettlementBackfillRequest, type SettlementBackfillResponse, type SettlementBucket, type SettlementCurrentParams, type SettlementCurrentResponse, type SettlementLine, type SettlementLineListParams, type SettlementLineListResponse, type SettlementOverviewParams, type SettlementOverviewResponse, type SettlementPayoutStatus, type SettlementStatementListParams, type SettlementStatementListResponse, type ShopCreateRequest, type ShopFeeConfigEntry, type ShopFeeConfigParams, type ShopFeeConfigResponse, type ShopResponse, type ShopSettlementOverview, type ShopStats, type ShopStatsResponse, type ShopUpdateRequest, type ShopVisibilityResponse, type ShopVisibilityUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StatementAdjustment, type StatementAdjustmentCreateRequest, type StatementAdjustmentListResponse, type StatementGenerateRequest, type StatementPayoutUpdateRequest, type StatementPdfParams, type StaticRoutingAlgorithm, type StatsPeriod, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type StripeNativePane, type StripePaymentMethodDomainResult, type StripePaymentMethodDomainStatus, type StripePaymentMethodDomainsRegisterRequest, type StripePaymentMethodDomainsRegisterResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPaymentLink, type SubscriptionPaymentLookupRequest, type SubscriptionPaymentLookupResponse, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeDetailsResponse, type SurchargeResponse, 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 UpdateMetadataRequest, type UpdateOperationLimitSettingsRequest, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UpdateUserRoleRequest, type UpsertOperationLimitRuleRequest, type UserInLineage, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VaultCheck, type VaultCheckId, type VaultCheckStatus, type VaultCollectSessionResponse, type VaultEnvironment, type VaultPaymentMethodRequest, type VaultPaymentMethodResponse, type VaultRouteApplyVerification, type VaultRouteChange, type VaultRouteChangeKind, type VaultRouteFieldChange, type VaultRouteIds, type VaultRoutePurpose, type VaultRouteWarning, type VaultRouteWarningCode, type VaultRoutesApplyRequest, type VaultRoutesApplyResponse, type VaultRoutesFingerprint, type VaultRoutesPreviewRequest, type VaultRoutesPreviewResponse, type VaultVerificationResponse, type VaultVerifyRequest, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, type WebhookRegistrationEnvironment, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, cloneCustomField, cloneNativePane, customFieldContextFromMetadata, customFieldIsTextLike, customFieldOperatorTakesValue, customFieldOptionLabel, customFieldText, decodeBadges, decodeBranding, decodeCustomFields, decodeNativePanes, defaultBranding, defaultCustomFieldVisibility, defaultNativePane, defaultOperatorForSource, encodeBadges, encodeBranding, encodeCustomFields, encodeNativePanes, evaluateCustomFieldCondition, evaluateCustomFieldVisibility, feeProgram, focusedCheckoutUrl, fontStack, fontWeightValue, inputPadValue, isCheckboxChecked, isDarkSurface, isHexColor, leaf, logoDimensions, nativePaneMethodInfo, parseCustomFieldsLoose, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue, visibleCustomFields };

package/dist/index.js

@@ -88,7 +88,7 @@ import {
   surfacePadValue,
   verticalGapValue,
   visibleCustomFields
-} from "./chunk-HSUVEFKO.js";
+} from "./chunk-DQ36QCU7.js";
 export {
   ALL_CUSTOM_FIELD_CONDITION_SOURCES,
   ALL_CUSTOM_FIELD_OPERATORS,

package/dist/internal.cjs

@@ -560,6 +560,39 @@ var Connectors = class {
   async list(accountId) {
     return this.request("GET", `/account/${encodeURIComponent(accountId)}/connectors`);
   }
+  /**
+   * The profile-scoped connector list. The merchant-wide `list()` is
+   * merchant-gated and 403s for a profile-entity (shop user) JWT; this
+   * variant is scoped server-side to the caller's own profile.
+   *
+   * `GET /account/{accountId}/profile/connectors`
+   */
+  async listByProfile(accountId) {
+    return this.request("GET", `/account/${encodeURIComponent(accountId)}/profile/connectors`);
+  }
+  /**
+   * The built-in e-Payouts reference catalog — the "Restore defaults" source.
+   * `GET /account/{accountId}/connectors/epayouts/catalog/defaults`
+   */
+  async getEpayoutsCatalogDefaults(accountId) {
+    return this.request(
+      "GET",
+      `/account/${encodeURIComponent(accountId)}/connectors/epayouts/catalog/defaults`
+    );
+  }
+  /**
+   * Sweep the merchant's own e-Payouts module and return the rails it
+   * actually has enabled. Server-side this makes many upstream calls, so it
+   * can take several seconds — show progress.
+   *
+   * `POST /account/{accountId}/connectors/{connectorId}/epayouts/catalog/sync`
+   */
+  async syncEpayoutsCatalog(accountId, connectorId) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/epayouts/catalog/sync`
+    );
+  }
   async update(accountId, connectorId, params) {
     return this.request(
       "POST",
@@ -592,6 +625,55 @@ var Connectors = class {
     );
   }
   // --- Advanced operations (Task 4.8) ---
+  /**
+   * Run the configuration checks for a vault (VGS) connector account:
+   * credential validity, write-only Collect scope, reachability, environment
+   * coherence, route coverage. Read-only but not cheap — it decrypts the
+   * vault's management credential and talks to VGS.
+   *
+   * `POST /account/{accountId}/connectors/{connectorId}/vault/verify`
+   */
+  async verifyVault(accountId, connectorId, params) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/vault/verify`,
+      { body: params }
+    );
+  }
+  /**
+   * Compute the route document the vault SHOULD have and diff it against
+   * what exists, without writing anything. The returned fingerprints must be
+   * echoed byte for byte on {@link Connectors.applyVaultRoutes}.
+   *
+   * A router without these endpoints answers 404 — render that as "this
+   * build cannot configure routes", never as "there is nothing to change".
+   *
+   * `POST /account/{accountId}/connectors/{connectorId}/vault/routes/preview`
+   */
+  async previewVaultRoutes(accountId, connectorId, params) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/vault/routes/preview`,
+      { body: params }
+    );
+  }
+  /**
+   * Write the routes the merchant just previewed. Both fingerprints come
+   * from the preview and are opaque: `expected_current_fingerprint` says the
+   * vault has not moved (`null` = "the preview found no routes" and is sent
+   * as `null`, never omitted), `expected_desired_fingerprint` says the
+   * document is still the one on screen. A 409 (`DE_04`) means the vault
+   * changed since the preview — nothing was written; preview again.
+   *
+   * `POST /account/{accountId}/connectors/{connectorId}/vault/routes/apply`
+   */
+  async applyVaultRoutes(accountId, connectorId, params) {
+    return this.request(
+      "POST",
+      `/account/${encodeURIComponent(accountId)}/connectors/${encodeURIComponent(connectorId)}/vault/routes/apply`,
+      { body: params }
+    );
+  }
   /** Verify connector credentials. `POST /account/connectors/verify` */
   async verify(params) {
     return this.request("POST", "/account/connectors/verify", { body: params });
@@ -2690,6 +2772,26 @@ var Users = class {
   async update(params) {
     return this.request("POST", "/user/update", { body: params });
   }
+  /**
+   * RFC 7396 merge-patch the caller's own user-scoped metadata bucket.
+   * Returns the full user details, so callers can refresh their context
+   * without a second fetch.
+   *
+   * `PATCH /user/metadata`
+   */
+  async updateMetadata(params) {
+    return this.request("PATCH", "/user/metadata", { body: params });
+  }
+  /**
+   * RFC 7396 merge-patch the merchant-scoped metadata bucket shared by
+   * every dashboard user of the merchant. Same response contract as
+   * {@link Users.updateMetadata}.
+   *
+   * `PATCH /user/merchant/metadata`
+   */
+  async updateMerchantMetadata(params) {
+    return this.request("PATCH", "/user/merchant/metadata", { body: params });
+  }
   /**
    * Permanently delete the caller's account. Requires a fresh password
    * (and a current 6-digit TOTP code if the user has TOTP enrolled). On