lane-sdk 0.3.11 → 0.3.12

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { T as TokenStore, C as Credentials, L as Lane, a as LaneConfig, R as ResolvedConfig, B as BudgetConfig, b as RoutingDecision } from './lane-CATn69s2.cjs';
-export { A as APIResponse, c as Admin, d as AgentIdentity, e as AgentPolicy, f as AgentRecord, g as AgentUser, h as AgenticToken, i as Agents, j as AnalyticsParams, k as Audit, l as AuditEntry, m as AuditQueryParams, n as Auth, o as AutoReloadConfig, p as Budgets, q as Card, r as CardAttributes, s as Cards, t as Checkout, u as CheckoutConfigParams, v as CheckoutConfigResult, w as CheckoutSession, x as Commerce, y as CommerceAddress, z as CommerceCartItem, D as CommerceCatalog, E as CommerceCheckoutParams, F as CommerceLocation, G as CommerceMenuCategory, H as CommerceMenuItem, I as CommerceModifierGroup, J as CommerceModifierOption, K as CommerceOnboardingStatus, M as CommerceOrder, N as CommerceOrderResult, O as CommerceOrders, P as CommercePaymentMethod, Q as CommercePlatform, S as CommerceProfile, U as CommerceProviders, V as CommerceTimeSlot, W as ConnectProviderParams, X as ConnectedProvider, Y as CreateCheckoutParams, Z as CreateProductParams, _ as CreateSubscriptionParams, $ as CreateTeamParams, a0 as CreateTokenParams, a1 as CreateWalletParams, a2 as CredentialInjection, a3 as DepositParams, a4 as DepositResult, a5 as DeveloperProfile, a6 as DirectoryMerchant, a7 as EnhancedToken, a8 as ExecutePaymentParams, a9 as Fleet, aa as FleetAgent, ab as HierarchicalBudget, ac as Identity, ad as IdentityAttestation, ae as Instruction, af as InstructionConfirmation, ag as InstructionCredential, ah as Instructions, ai as KYCChain, aj as LaneAuthError, ak as LaneBudgetError, al as LaneClient, am as LaneConfirmationError, an as LaneError, ao as LaneNotFoundError, ap as LanePaymentError, aq as LaneRateLimitError, ar as LaneValidationError, as as Mandate, at as Merchant, au as MerchantSearchParams, av as MerchantType, aw as MerchantVerticalSummary, ax as Merchants, ay as Metering, az as MeteringConfig, aA as NetworkTokenPayload, aB as Order, aC as OrderIntentParams, aD as OrderIntentResult, aE as Organization, aF as PaginatedResponse, aG as Pay, aH as PaymentRoute, aI as PaymentSkill, aJ as Payout, aK as PayoutConfig, aL as Payouts, aM as PricingConfig, aN as Product, aO as ProductAnalytics, aP as ProductSearchParams, aQ as Products, aR as ProtocolDiscoveryResult, aS as ProvisionVICPaymentParams, aT as ProvisionVICPaymentResult, aU as Refund, aV as RefundParams, aW as RegisterAgentParams, aX as RegisterIdentityParams, aY as RequestOptions, aZ as Resource, a_ as RotateKeyResult, a$ as SCPManifest, b0 as SCPParameter, b1 as SCPPlan, b2 as SCPPricing, b3 as SCPProduct, b4 as SCPProvisioning, b5 as SCPSelectionParameters, b6 as SDKInfo, b7 as Sell, b8 as SoftwareCheckoutParams, b9 as SoftwareOrder, ba as SoftwareProductSearchParams, bb as SpendingSummary, bc as SubmitOrderParams, bd as SubmitOrderResult, be as Subscription, bf as Subscriptions, bg as Team, bh as TeamMember, bi as TeamSpending, bj as Teams, bk as Tokens, bl as Transaction, bm as Transactions, bn as UpdateSubscriptionParams, bo as UsageRecord, bp as UsageReport, bq as Users, br as VIC, bs as VICIssuanceParams, bt as VICToken, bu as VICTokenUsageEntry, bv as VerifyIdentityParams, bw as Wallet, bx as WalletBalance, by as Wallets, bz as WebhookConfig, bA as WebhookEvent, bB as WebhookPayload, bC as Webhooks, bD as createErrorFromResponse } from './lane-CATn69s2.cjs';
+import { T as TokenStore, C as Credentials, L as Lane, a as LaneConfig, R as ResolvedConfig } from './lane-BgdqOeXo.cjs';
+export { A as APIResponse, b as Admin, c as AgentIdentity, d as AgentPolicy, e as AgentRecord, f as AgentUser, g as AgenticToken, h as Agents, i as AnalyticsParams, j as Audit, k as AuditEntry, l as AuditQueryParams, m as Auth, n as AutoReloadConfig, B as BudgetConfig, o as Budgets, p as Card, q as CardAttributes, r as Cards, s as Checkout, t as CheckoutConfigParams, u as CheckoutConfigResult, v as CheckoutSession, w as Commerce, x as CommerceAddress, y as CommerceCartItem, z as CommerceCatalog, D as CommerceCheckoutParams, E as CommerceLocation, F as CommerceMenuCategory, G as CommerceMenuItem, H as CommerceModifierGroup, I as CommerceModifierOption, J as CommerceOnboardingStatus, K as CommerceOrder, M as CommerceOrderResult, N as CommerceOrders, O as CommercePaymentMethod, P as CommercePlatform, Q as CommerceProfile, S as CommerceProviders, U as CommerceTimeSlot, V as ConnectProviderParams, W as ConnectedProvider, X as CreateCheckoutParams, Y as CreateProductParams, Z as CreateSubscriptionParams, _ as CreateTeamParams, $ as CreateTokenParams, a0 as CreateWalletParams, a1 as CredentialInjection, a2 as DepositParams, a3 as DepositResult, a4 as DeveloperProfile, a5 as DirectoryMerchant, a6 as EnhancedToken, a7 as ExecutePaymentParams, a8 as Fleet, a9 as FleetAgent, aa as HierarchicalBudget, ab as Identity, ac as IdentityAttestation, ad as Instruction, ae as InstructionConfirmation, af as InstructionCredential, ag as Instructions, ah as KYCChain, ai as LaneAuthError, aj as LaneBudgetError, ak as LaneClient, al as LaneConfirmationError, am as LaneError, an as LaneNotFoundError, ao as LanePaymentError, ap as LaneRateLimitError, aq as LaneValidationError, ar as Mandate, as as Merchant, at as MerchantSearchParams, au as MerchantType, av as MerchantVerticalSummary, aw as Merchants, ax as Metering, ay as MeteringConfig, az as NetworkTokenPayload, aA as Order, aB as OrderIntentParams, aC as OrderIntentResult, aD as Organization, aE as PaginatedResponse, aF as Pay, aG as PaymentRoute, aH as PaymentSkill, aI as Payout, aJ as PayoutConfig, aK as Payouts, aL as PricingConfig, aM as Product, aN as ProductAnalytics, aO as ProductSearchParams, aP as Products, aQ as ProtocolDiscoveryResult, aR as ProvisionVICPaymentParams, aS as ProvisionVICPaymentResult, aT as Refund, aU as RefundParams, aV as RegisterAgentParams, aW as RegisterIdentityParams, aX as RequestOptions, aY as Resource, aZ as RotateKeyResult, a_ as RoutingDecision, a$ as SCPManifest, b0 as SCPParameter, b1 as SCPPlan, b2 as SCPPricing, b3 as SCPProduct, b4 as SCPProvisioning, b5 as SCPSelectionParameters, b6 as SDKInfo, b7 as Sell, b8 as SoftwareCheckoutParams, b9 as SoftwareOrder, ba as SoftwareProductSearchParams, bb as SpendingSummary, bc as SubmitOrderParams, bd as SubmitOrderResult, be as Subscription, bf as Subscriptions, bg as Team, bh as TeamMember, bi as TeamSpending, bj as Teams, bk as Tokens, bl as Transaction, bm as Transactions, bn as UpdateSubscriptionParams, bo as UsageRecord, bp as UsageReport, bq as Users, br as VIC, bs as VICIssuanceParams, bt as VICToken, bu as VICTokenUsageEntry, bv as VerifyIdentityParams, bw as Wallet, bx as WalletBalance, by as Wallets, bz as WebhookConfig, bA as WebhookEvent, bB as WebhookPayload, bC as Webhooks, bD as createErrorFromResponse } from './lane-BgdqOeXo.cjs';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import 'node:events';
 
@@ -167,83 +167,6 @@ interface LaneInstructions {
  */
 declare function getLaneInstructions(): LaneInstructions;
 
-interface VGSTokenConfig {
-    /** VGS vault ID (e.g., tntxxxxxxxx). */
-    vaultId: string;
-    /** VGS service account client ID. */
-    clientId: string;
-    /** VGS service account client secret. */
-    clientSecret: string;
-    /** VGS environment: 'sandbox' | 'live'. */
-    environment: 'sandbox' | 'live';
-}
-/**
- * VGSTokenManager handles OAuth2 client_credentials flow for VGS vault access.
- * Tokens are cached and auto-refreshed before expiry.
- */
-declare class VGSTokenManager {
-    private readonly config;
-    private cached;
-    private clearTimer;
-    constructor(config: VGSTokenConfig);
-    /**
-     * Get a valid access token, refreshing if expired or near-expiry.
-     */
-    getAccessToken(): Promise<string>;
-    /**
-     * Force-refresh the token.
-     */
-    refresh(): Promise<string>;
-    /**
-     * Invalidate the cached token.
-     */
-    invalidate(): void;
-    /**
-     * Overwrite and release the cached token from memory.
-     */
-    private clearCachedToken;
-    private getTokenUrl;
-}
-
-interface VGSProxyConfig extends VGSTokenConfig {
-    /** Outbound route ID for PSP-bound requests. */
-    routeId: string;
-}
-interface ProxyRequest {
-    /** Target PSP endpoint URL. */
-    url: string;
-    /** HTTP method. */
-    method: 'POST' | 'PUT' | 'PATCH';
-    /** Request headers (Authorization, Content-Type, etc.). */
-    headers: Record<string, string>;
-    /** Request body containing VGS aliases that will be revealed by the proxy. */
-    body: unknown;
-}
-interface ProxyResponse {
-    status: number;
-    headers: Record<string, string>;
-    body: unknown;
-}
-/**
- * VGSOutboundProxy routes requests through VGS so that aliased card data
- * is revealed only to whitelisted PSP endpoints.
- */
-declare class VGSOutboundProxy {
-    private readonly config;
-    private readonly tokenManager;
-    constructor(config: VGSProxyConfig);
-    /**
-     * Send a request through the VGS outbound proxy.
-     * VGS aliases in the body are de-tokenized and revealed to the target PSP.
-     */
-    forward(request: ProxyRequest): Promise<ProxyResponse>;
-    /**
-     * Invalidate the cached VGS access token.
-     */
-    invalidateToken(): void;
-    private getProxyUrl;
-}
-
 type CardBrand = 'visa' | 'mastercard' | 'amex' | 'discover' | 'diners' | 'jcb' | 'unionpay' | 'unknown';
 /**
  * Detect card brand from a card number or VGS alias token.
@@ -263,208 +186,6 @@ declare function luhnCheck(cardNumber: string): boolean;
  */
 declare function maskCardNumber(cardNumber: string): string;
 
-interface VGSCollectConfig {
-    /** VGS vault ID. */
-    vaultId: string;
-    /** VGS environment. */
-    environment: 'sandbox' | 'live';
-    /** VGS route ID for inbound collection. */
-    routeId: string;
-    /** Callback URL after successful tokenization. */
-    callbackUrl: string;
-    /** Lane developer ID (for associating the card). */
-    developerId: string;
-}
-/**
- * Generate the VGS Collect HTML page for secure card entry.
- * The page:
- *   1. Loads VGS Collect.js from VGS CDN
- *   2. Creates secure iframe fields for card number, CVV, expiry
- *   3. On submit, sends card data directly to VGS vault
- *   4. VGS returns aliases (tok_xxx) — Lane stores only the alias
- *   5. Redirects to callbackUrl with the alias + last4 + brand
- */
-declare function generateCollectPage(config: VGSCollectConfig): string;
-
-type PSPName = 'stripe' | 'worldpay' | 'cybersource';
-interface PSPChargeParams {
-    /** Amount in cents. */
-    amount: number;
-    /** ISO 4217 currency code (e.g., 'USD'). */
-    currency: string;
-    /** VGS alias for the card PAN (de-tokenized by VGS outbound proxy). */
-    cardAlias: string;
-    /** VGS alias for the CVV. */
-    cvvAlias?: string;
-    /** Card expiry month (1-12). */
-    expMonth: number;
-    /** Card expiry year (4-digit). */
-    expYear: number;
-    /** Merchant descriptor. */
-    merchantDescriptor: string;
-    /** Idempotency key to prevent duplicate charges. */
-    idempotencyKey?: string;
-    /** Metadata attached to the charge. */
-    metadata?: Record<string, string>;
-}
-interface PSPChargeResult {
-    /** PSP's transaction/charge ID. */
-    pspTransactionId: string;
-    /** Charge status. */
-    status: 'succeeded' | 'pending' | 'failed';
-    /** Authorization code from the issuer. */
-    authorizationCode?: string;
-    /** Decline reason if failed. */
-    declineReason?: string;
-    /** Raw PSP response for audit logging. */
-    rawResponse: unknown;
-}
-interface PSPRefundParams {
-    /** Original PSP transaction ID. */
-    pspTransactionId: string;
-    /** Refund amount in cents. If omitted, full refund. */
-    amount?: number;
-    /** Reason for refund. */
-    reason?: string;
-    /** Idempotency key. */
-    idempotencyKey?: string;
-}
-interface PSPRefundResult {
-    /** PSP's refund ID. */
-    pspRefundId: string;
-    /** Refund status. */
-    status: 'succeeded' | 'pending' | 'failed';
-    /** Amount refunded in cents. */
-    amount: number;
-    /** Raw PSP response for audit logging. */
-    rawResponse: unknown;
-}
-/**
- * PSP Adapter interface — strategy pattern.
- *
- * Each payment processor (Stripe, Worldpay, CyberSource) implements this
- * interface. The payment engine calls charge/refund without knowing which
- * PSP is handling the request.
- */
-interface PSPAdapter {
-    /** PSP identifier. */
-    readonly name: PSPName;
-    /**
-     * Create a charge. The card data arrives as VGS aliases;
-     * the VGS outbound proxy reveals them to the PSP endpoint.
-     */
-    charge(params: PSPChargeParams): Promise<PSPChargeResult>;
-    /**
-     * Refund a previous charge (full or partial).
-     */
-    refund(params: PSPRefundParams): Promise<PSPRefundResult>;
-    /**
-     * Health check — verify PSP connectivity.
-     */
-    healthCheck(): Promise<boolean>;
-}
-
-/**
- * PSPRegistry manages available payment processor adapters.
- *
- * The payment engine queries the registry to find the best adapter
- * for a given transaction based on priority, card brand support,
- * and availability.
- */
-declare class PSPRegistry {
-    private adapters;
-    /**
-     * Register an adapter with a priority (lower = higher priority).
-     */
-    register(adapter: PSPAdapter, priority?: number): void;
-    /**
-     * Remove an adapter from the registry.
-     */
-    unregister(name: PSPName): void;
-    /**
-     * Get a specific adapter by name.
-     */
-    get(name: PSPName): PSPAdapter | undefined;
-    /**
-     * Get the highest-priority adapter (lowest priority number).
-     * Optionally exclude specific adapters (e.g., after a failure).
-     */
-    getPrimary(exclude?: Set<PSPName>): PSPAdapter | undefined;
-    /**
-     * Get all registered adapters sorted by priority.
-     */
-    getAll(): PSPAdapter[];
-    /**
-     * Run health checks on all adapters. Returns names of healthy adapters.
-     */
-    healthCheckAll(): Promise<PSPName[]>;
-}
-
-interface StripeAdapterConfig {
-    /** Stripe secret key (sk_live_... or sk_test_...). */
-    secretKey: string;
-    /** VGS outbound proxy instance. */
-    proxy: VGSOutboundProxy;
-    /** Stripe API version. */
-    apiVersion?: string;
-}
-declare class StripeAdapter implements PSPAdapter {
-    readonly name: "stripe";
-    private readonly config;
-    constructor(config: StripeAdapterConfig);
-    charge(params: PSPChargeParams): Promise<PSPChargeResult>;
-    refund(params: PSPRefundParams): Promise<PSPRefundResult>;
-    healthCheck(): Promise<boolean>;
-}
-
-interface WorldpayAdapterConfig {
-    /** Worldpay merchant ID. */
-    merchantId: string;
-    /** Worldpay API key. */
-    apiKey: string;
-    /** Worldpay API endpoint. */
-    baseUrl: string;
-    /** VGS outbound proxy instance. */
-    proxy: VGSOutboundProxy;
-}
-declare class WorldpayAdapter implements PSPAdapter {
-    readonly name: "worldpay";
-    private readonly config;
-    constructor(config: WorldpayAdapterConfig);
-    charge(params: PSPChargeParams): Promise<PSPChargeResult>;
-    refund(params: PSPRefundParams): Promise<PSPRefundResult>;
-    healthCheck(): Promise<boolean>;
-}
-
-interface CyberSourceAdapterConfig {
-    /** CyberSource merchant ID. */
-    merchantId: string;
-    /** CyberSource API key ID. */
-    apiKeyId: string;
-    /** CyberSource shared secret. */
-    sharedSecret: string;
-    /** API endpoint. */
-    baseUrl: string;
-    /** VGS outbound proxy instance. */
-    proxy: VGSOutboundProxy;
-}
-interface CyberSourceChargeParams extends PSPChargeParams {
-    /** VIC network token cryptogram (for token-based payments). */
-    cryptogram?: string;
-    /** ECI value for network token transactions. */
-    eci?: string;
-    /** Whether this is a network token (DPAN) or regular PAN. */
-    isNetworkToken?: boolean;
-}
-declare class CyberSourceAdapter implements PSPAdapter {
-    readonly name: "cybersource";
-    private readonly config;
-    constructor(config: CyberSourceAdapterConfig);
-    charge(params: PSPChargeParams): Promise<PSPChargeResult>;
-    refund(params: PSPRefundParams): Promise<PSPRefundResult>;
-    healthCheck(): Promise<boolean>;
-}
-
 /** Merchant capability data used for routing decisions. */
 interface MerchantCapabilities {
     merchantId: string;
@@ -478,78 +199,6 @@ interface MerchantCapabilities {
     acceptsMastercard: boolean;
     mccs: string[];
 }
-/** Context for a routing decision. */
-interface RoutingContext {
-    /** Amount in cents. */
-    amount: number;
-    currency: string;
-    merchantId: string;
-    /** Card brand being used. */
-    cardBrand: string;
-    /** Whether a VIC token is available (used for credential selection, not routing). */
-    hasVICToken: boolean;
-    /** Whether a Mastercard Agent Pay token is available (credential selection). */
-    hasMCAPToken?: boolean;
-    /** Current effective budget. */
-    budget?: BudgetConfig;
-    /** Current spend for the period. */
-    currentSpend?: number;
-}
-/** Registry of merchant capabilities (populated from Lane backend). */
-declare class MerchantRegistry {
-    private merchants;
-    register(capabilities: MerchantCapabilities): void;
-    get(merchantId: string): MerchantCapabilities | undefined;
-    registerBatch(merchants: MerchantCapabilities[]): void;
-    /** Create a registry pre-populated from directory capabilities. */
-    static fromDirectory(capabilities: MerchantCapabilities[]): MerchantRegistry;
-    /** Clear and repopulate with new capabilities. */
-    reload(capabilities: MerchantCapabilities[]): void;
-    /** Number of registered merchants. */
-    get size(): number;
-    /** List all registered merchant IDs. */
-    listIds(): string[];
-    /**
-     * Create a registry pre-seeded with the built-in UCP merchant directory.
-     *
-     * These merchants have verified `/.well-known/ucp` endpoints, so the
-     * routing engine can immediately route to Tier 3 (UCP) without a server
-     * round-trip for discovery. Additional merchants from the Lane backend
-     * can be merged in later via `register()` or `registerBatch()`.
-     */
-    static withUCPDirectory(): MerchantRegistry;
-    /**
-     * Create a registry pre-seeded with ALL built-in merchant directories:
-     * - Billing API merchants (Tier 1) — SaaS/API merchants with direct endpoints
-     * - UCP merchants (Tier 3) — ecommerce merchants with /.well-known/ucp
-     *
-     * This gives agents instant routing for known merchants without any server
-     * round-trip. Use this for the best out-of-the-box experience.
-     */
-    static withBuiltinDirectory(): MerchantRegistry;
-}
-/**
- * PaymentRouter determines the optimal payment path for a transaction.
- *
- * Priority order (acceptance protocols):
- *   1. Billing API — direct merchant API integration (cheapest, fastest)
- *   2. ACP — Agent Commerce Protocol checkout (Stripe-compatible, most merchant adoption)
- *   3. UCP — Universal Checkout Protocol (Google, genuinely open)
- *   4. x402 — HTTP 402 standard (requires active 402 responses)
- *   5. Fallback — Rye / browser use / VGS proxy (probe-based selection)
- *
- * VIC/MC Agent Pay are the CREDENTIAL layer, not routing tiers. They produce
- * the network tokens that flow through whatever acceptance protocol is selected.
- */
-declare class PaymentRouter {
-    private readonly registry;
-    constructor(registry: MerchantRegistry);
-    /**
-     * Decide the payment route for a transaction.
-     */
-    route(context: RoutingContext): RoutingDecision;
-    private filterFallbacks;
-}
 
 /** A merchant with a known UCP endpoint. */
 interface UCPMerchant {
@@ -634,4 +283,4 @@ declare function listUCPByVertical(vertical: string): readonly UCPMerchant[];
  */
 declare function toMerchantCapabilities(): MerchantCapabilities[];
 
-export { type InstructionConfirmation as BiometricInstructionConfirmation, type BiometricMethod, type BiometricOptions, type BiometricProof, BiometricVerifier, BudgetConfig, type CardBrand, Credentials, CyberSourceAdapter, type CyberSourceAdapterConfig, type CyberSourceChargeParams, FileTokenStore, HMACSignature, Lane, LaneConfig, type LaneInstructions, LaneMCPServer, type LaneMCPServerOptions, type MerchantCapabilities, MerchantRegistry, type PSPAdapter, type PSPChargeParams, type PSPChargeResult, type PSPName, type PSPRefundParams, type PSPRefundResult, PSPRegistry, PaymentRouter, type ProxyRequest, type ProxyResponse, ResolvedConfig, type RoutingContext, RoutingDecision, StripeAdapter, type StripeAdapterConfig, TokenStore, type UCPMerchant, type VGSCollectConfig, VGSOutboundProxy, type VGSProxyConfig, type VGSTokenConfig, VGSTokenManager, WorldpayAdapter, type WorldpayAdapterConfig, Lane as default, detectCardBrand, generateCollectPage, getLaneInstructions, listUCPByVertical, listUCPMerchants, luhnCheck, maskCardNumber, requireBiometricConfirmation, resolveConfig, resolveUCPByBrand, resolveUCPByDomain, toUCPEndpoint, toMerchantCapabilities as toUCPMerchantCapabilities, verifyWebhookSignature };
+export { type InstructionConfirmation as BiometricInstructionConfirmation, type BiometricMethod, type BiometricOptions, type BiometricProof, BiometricVerifier, type CardBrand, Credentials, FileTokenStore, HMACSignature, Lane, LaneConfig, type LaneInstructions, LaneMCPServer, type LaneMCPServerOptions, ResolvedConfig, TokenStore, type UCPMerchant, Lane as default, detectCardBrand, getLaneInstructions, listUCPByVertical, listUCPMerchants, luhnCheck, maskCardNumber, requireBiometricConfirmation, resolveConfig, resolveUCPByBrand, resolveUCPByDomain, toUCPEndpoint, toMerchantCapabilities as toUCPMerchantCapabilities, verifyWebhookSignature };