@rovela-ai/sdk 0.4.0 → 0.4.1

package/dist/checkout/stripe/client.js

@@ -1,175 +0,0 @@
-/**
- * @rovela/sdk/checkout/stripe/client
- *
- * Stripe SDK initialization for server-side operations.
- * Uses Direct Charges with connected accounts.
- */
-import Stripe from 'stripe';
-// =============================================================================
-// Singleton Stripe Client
-// =============================================================================
-let stripeClient = null;
-/**
- * Get the Stripe client instance (server-side).
- * Lazily initialized on first use.
- *
- * @throws Error if STRIPE_SECRET_KEY is not set
- */
-export function getStripe() {
-    if (!stripeClient) {
-        const secretKey = process.env.STRIPE_SECRET_KEY;
-        if (!secretKey) {
-            throw new Error('STRIPE_SECRET_KEY environment variable is not set. ' +
-                'Please add your Stripe secret key to .env.local:\n' +
-                'STRIPE_SECRET_KEY=sk_test_xxx');
-        }
-        stripeClient = new Stripe(secretKey, {
-            // Use the latest API version for best compatibility
-            apiVersion: '2026-01-28.clover',
-            typescript: true,
-            // Telemetry helps Stripe improve the SDK
-            telemetry: true,
-        });
-    }
-    return stripeClient;
-}
-// =============================================================================
-// Connected Account
-// =============================================================================
-/**
- * Get the connected Stripe account ID for this store.
- * Each store has its own connected account.
- *
- * @throws Error if STRIPE_CONNECTED_ACCOUNT_ID is not set
- */
-export function getConnectedAccountId() {
-    const accountId = process.env.STRIPE_CONNECTED_ACCOUNT_ID;
-    if (!accountId) {
-        throw new Error('STRIPE_CONNECTED_ACCOUNT_ID environment variable is not set. ' +
-            'The store owner must complete Stripe onboarding before accepting payments.\n' +
-            'Set STRIPE_CONNECTED_ACCOUNT_ID=acct_xxx in .env.local');
-    }
-    return accountId;
-}
-/**
- * Check if the store has a connected Stripe account.
- * Use this to conditionally show checkout UI.
- */
-export function hasConnectedAccount() {
-    return !!process.env.STRIPE_CONNECTED_ACCOUNT_ID;
-}
-// =============================================================================
-// Platform Configuration
-// =============================================================================
-/**
- * Get the platform fee percentage for transactions.
- * Default is 5% if not configured.
- */
-export function getPlatformFeePercent() {
-    const feePercent = process.env.STRIPE_PLATFORM_FEE_PERCENT;
-    if (!feePercent) {
-        return 5; // Default 5% platform fee
-    }
-    const parsed = parseFloat(feePercent);
-    if (isNaN(parsed) || parsed < 0 || parsed > 100) {
-        console.warn(`Invalid STRIPE_PLATFORM_FEE_PERCENT: ${feePercent}. Using default 5%.`);
-        return 5;
-    }
-    return parsed;
-}
-/**
- * Calculate the application fee amount in cents.
- *
- * @param amountInCents - The total transaction amount in cents
- * @returns The application fee in cents (rounded)
- */
-export function calculateApplicationFee(amountInCents) {
-    const feePercent = getPlatformFeePercent();
-    return Math.round(amountInCents * (feePercent / 100));
-}
-// =============================================================================
-// Webhook Configuration
-// =============================================================================
-/**
- * Get the primary webhook signing secret (for account events).
- * Used to verify webhook signatures from platform account.
- *
- * @throws Error if STRIPE_WEBHOOK_SECRET is not set
- */
-export function getWebhookSecret() {
-    const secret = process.env.STRIPE_WEBHOOK_SECRET;
-    if (!secret) {
-        throw new Error('STRIPE_WEBHOOK_SECRET environment variable is not set. ' +
-            'Please add your Stripe webhook signing secret to .env.local:\n' +
-            'STRIPE_WEBHOOK_SECRET=whsec_xxx');
-    }
-    return secret;
-}
-/**
- * Get the Connect webhook signing secret (for connected account events).
- * Used to verify webhook signatures from connected accounts.
- * Falls back to primary secret if not set.
- */
-export function getConnectWebhookSecret() {
-    return process.env.STRIPE_CONNECT_WEBHOOK_SECRET || null;
-}
-/**
- * Get all webhook secrets to try during verification.
- * Returns array of secrets to attempt (primary first, then connect).
- */
-export function getAllWebhookSecrets() {
-    const secrets = [];
-    const primarySecret = process.env.STRIPE_WEBHOOK_SECRET;
-    if (primarySecret) {
-        secrets.push(primarySecret);
-    }
-    const connectSecret = process.env.STRIPE_CONNECT_WEBHOOK_SECRET;
-    if (connectSecret && connectSecret !== primarySecret) {
-        secrets.push(connectSecret);
-    }
-    if (secrets.length === 0) {
-        throw new Error('No webhook secrets configured. ' +
-            'Please add STRIPE_WEBHOOK_SECRET and/or STRIPE_CONNECT_WEBHOOK_SECRET to .env.local');
-    }
-    return secrets;
-}
-// =============================================================================
-// Store Configuration
-// =============================================================================
-/**
- * Get the store's currency code.
- * Default is USD if not configured.
- */
-export function getStoreCurrency() {
-    return process.env.STORE_CURRENCY || 'usd';
-}
-/**
- * Get allowed countries for shipping from environment variable.
- * This is a synchronous fallback when database is not available.
- * Prefer using getShippingCountriesFromSettings() when possible.
- * @deprecated Use getShippingCountriesFromSettings() for dynamic configuration
- */
-export function getAllowedShippingCountries() {
-    const countries = process.env.SHIPPING_COUNTRIES;
-    if (!countries) {
-        return ['US', 'CA']; // Default to US and Canada
-    }
-    return countries.split(',').map((c) => c.trim().toUpperCase());
-}
-// =============================================================================
-// Client-side Stripe
-// =============================================================================
-/**
- * Get the publishable key for client-side Stripe.js
- * This is safe to expose to the browser.
- */
-export function getPublishableKey() {
-    const key = process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY;
-    if (!key) {
-        throw new Error('NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY environment variable is not set. ' +
-            'Please add your Stripe publishable key to .env.local:\n' +
-            'NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx');
-    }
-    return key;
-}
-//# sourceMappingURL=client.js.map

package/dist/checkout/stripe/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/checkout/stripe/client.ts"],"names":[],"mappings":"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"}

package/dist/checkout/stripe/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * @rovela/sdk/checkout/stripe
- *
- * Stripe client and configuration exports
- */
-export { getStripe, getConnectedAccountId, hasConnectedAccount, getPlatformFeePercent, calculateApplicationFee, getWebhookSecret, getConnectWebhookSecret, getAllWebhookSecrets, getStoreCurrency, getAllowedShippingCountries, getPublishableKey, } from './client';
-//# sourceMappingURL=index.d.ts.map

package/dist/checkout/stripe/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/checkout/stripe/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,UAAU,CAAA"}

package/dist/checkout/stripe/index.js

@@ -1,7 +0,0 @@
-/**
- * @rovela/sdk/checkout/stripe
- *
- * Stripe client and configuration exports
- */
-export { getStripe, getConnectedAccountId, hasConnectedAccount, getPlatformFeePercent, calculateApplicationFee, getWebhookSecret, getConnectWebhookSecret, getAllWebhookSecrets, getStoreCurrency, getAllowedShippingCountries, getPublishableKey, } from './client';
-//# sourceMappingURL=index.js.map

package/dist/checkout/stripe/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/stripe/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,UAAU,CAAA"}

package/dist/checkout/types.d.ts

@@ -1,489 +0,0 @@
-/**
- * @rovela/sdk/checkout/types
- *
- * Type definitions for the checkout module.
- * Stripe Connect with Direct Charges and platform fees.
- */
-import type { Address } from '../core/types';
-/**
- * Line item for checkout session creation.
- * Prices are in cents (e.g., 1999 = $19.99)
- */
-export interface CheckoutLineItem {
-    /** Product ID from database */
-    productId?: string;
-    /** Variant ID if applicable */
-    variantId?: string;
-    /** Display name */
-    name: string;
-    /** Optional description */
-    description?: string;
-    /** Price in cents */
-    price: number;
-    /** Quantity */
-    quantity: number;
-    /** Product image URL */
-    image?: string;
-    /** Variant attributes */
-    attributes?: Record<string, string>;
-}
-/**
- * Request to create a Stripe Checkout session
- */
-export interface CheckoutSessionRequest {
-    /** Items to purchase */
-    items: CheckoutLineItem[];
-    /** Customer email (optional, will be collected if not provided) */
-    customerEmail?: string;
-    /** Store customer ID (if authenticated) */
-    customerId?: string;
-    /**
-     * Pre-collected shipping address from pre-checkout flow.
-     * When provided, this address is attached to the payment intent
-     * and used for order fulfillment.
-     */
-    shippingAddress?: Address;
-    /**
-     * Pre-selected shipping option from pre-checkout flow.
-     * When provided, shipping is added as a line item (not selectable by customer)
-     * and the shipping_options array is NOT shown in Stripe Checkout.
-     */
-    selectedShipping?: ShippingOption;
-    /** URL to redirect on success (must include {CHECKOUT_SESSION_ID} placeholder) */
-    successUrl: string;
-    /** URL to redirect on cancel */
-    cancelUrl: string;
-    /** Custom metadata to attach to the session */
-    metadata?: Record<string, string>;
-}
-/**
- * Response from checkout session creation
- */
-export interface CheckoutSessionResponse {
-    /** Stripe Checkout session ID */
-    sessionId: string;
-    /** URL to redirect customer to Stripe Checkout */
-    url: string;
-}
-/**
- * Error response from checkout API
- */
-export interface CheckoutApiError {
-    /** Error message */
-    error: string;
-    /** Error code for programmatic handling */
-    code: 'EMPTY_CART' | 'INVALID_REQUEST' | 'STRIPE_NOT_CONFIGURED' | 'ACCOUNT_NOT_CONNECTED' | 'CHECKOUT_ERROR' | 'WEBHOOK_ERROR' | 'SIGNATURE_INVALID' | 'GUEST_CHECKOUT_DISABLED';
-}
-/**
- * Parameters for creating an order from a completed checkout session
- */
-export interface CreateOrderParams {
-    /** Stripe Checkout session ID */
-    sessionId: string;
-    /** Customer email */
-    email: string;
-    /** Line items from the checkout */
-    items: CheckoutLineItem[];
-    /** Subtotal in cents */
-    subtotal: number;
-    /** Tax amount in cents */
-    tax: number;
-    /** Shipping amount in cents */
-    shipping: number;
-    /** Discount code applied (if any) */
-    discountCode?: string;
-    /** Discount amount in cents */
-    discountAmount?: number;
-    /** Stripe promotion code ID */
-    stripePromotionCodeId?: string;
-    /** Total amount in cents */
-    total: number;
-    /** Shipping address */
-    shippingAddress: Address;
-    /** Billing address (optional) */
-    billingAddress?: Address;
-    /** Stripe Payment Intent ID */
-    stripePaymentIntentId: string;
-    /** Stripe Customer ID (if customer was created) */
-    stripeCustomerId?: string;
-    /** Store customer ID (if authenticated) */
-    customerId?: string;
-    /** Shipping method display name (e.g., "Colissimo - Domicile") */
-    shippingMethod?: string;
-    /** Carrier code (e.g., "colissimo", "usps") */
-    carrier?: string;
-    /** Shippo rate object ID (for Shippo-sourced shipping) */
-    shippoRateId?: string;
-}
-/**
- * Result from processing a webhook
- */
-export interface WebhookResult {
-    /** Whether the webhook was received and processed */
-    received: boolean;
-    /** The event type that was processed */
-    event?: string;
-    /** Order ID if an order was created */
-    orderId?: string;
-    /** Error message if processing failed */
-    error?: string;
-}
-/**
- * Checkout flow steps
- */
-export type CheckoutStep = 'cart' | 'information' | 'shipping' | 'payment' | 'success';
-/**
- * Shipping option returned from calculation.
- * Unified interface for both manual (zones/rates) and Shippo (carrier API) modes.
- */
-export interface ShippingOption {
-    /** Unique identifier (rate ID for manual, Shippo object_id for Shippo) */
-    id: string;
-    /** Carrier ID (for manual mode grouping) */
-    carrierId?: string;
-    /** Carrier name (e.g., "USPS", "FedEx", "Local Delivery") */
-    carrierName?: string;
-    /** Carrier code (for programmatic reference) */
-    carrierCode?: string;
-    /** Display name (e.g., "Standard Shipping", "Priority Mail") */
-    name: string;
-    /** Description (e.g., "5-7 business days") */
-    description?: string;
-    /** Price in cents */
-    price: number;
-    /** Estimated delivery time */
-    estimatedDays?: string;
-    /** Source of the shipping option */
-    source: 'manual' | 'shippo';
-}
-/**
- * Shipping options grouped by carrier.
- * Used for displaying shipping options in a carrier-first UI.
- */
-export interface ShippingOptionsGroupedByCarrier {
-    carrier: {
-        id: string;
-        name: string;
-        code: string;
-    };
-    options: ShippingOption[];
-}
-/**
- * Tax calculation result from the shipping API.
- * Returned alongside shipping options for order summary display.
- */
-export interface TaxCalculation {
-    /** Tax zone ID */
-    zoneId: string;
-    /** Tax zone name for display (e.g., "US - California") */
-    zoneName: string;
-    /** Tax rate as percentage (e.g., 8.25 = 8.25%) */
-    taxRate: number;
-    /** Calculated tax amount in cents */
-    amount: number;
-    /** Whether tax is included in product prices */
-    includedInPrices: boolean;
-}
-/**
- * Shipping address for rate calculation.
- * Compatible with Address type but uses shipping-specific field names.
- */
-export interface ShippingAddress {
-    /** First name */
-    firstName: string;
-    /** Last name */
-    lastName: string;
-    /** Address line 1 */
-    line1: string;
-    /** Address line 2 (optional) */
-    line2?: string;
-    /** City */
-    city: string;
-    /** State/province */
-    state: string;
-    /** Postal/ZIP code */
-    postalCode: string;
-    /** Country code (ISO 3166-1 alpha-2, e.g., "US", "CA") */
-    country: string;
-    /** Phone number (optional) */
-    phone?: string;
-    /** Email address (optional, for Shippo notifications) */
-    email?: string;
-}
-/**
- * Request to calculate shipping options based on address.
- * Used by the pre-checkout flow to get available shipping rates.
- */
-export interface ShippingCalculationRequest {
-    /** Full shipping address for accurate rate calculation */
-    address: ShippingAddress;
-    /** Line items for order total calculation */
-    items: Array<{
-        /** Price in cents */
-        price: number;
-        /** Quantity */
-        quantity: number;
-    }>;
-}
-/**
- * Response from shipping calculation.
- * Includes tax calculation when a matching tax zone is found.
- */
-export interface ShippingCalculationResponse {
-    /** Whether calculation was successful */
-    success: boolean;
-    /** Available shipping options grouped by carrier */
-    options: ShippingOptionsGroupedByCarrier[];
-    /** Flat list of all options (convenience accessor) */
-    flatOptions: ShippingOption[];
-    /** Shipping mode used */
-    mode: 'manual' | 'shippo';
-    /** Error message if calculation failed */
-    error?: string;
-    /** Tax calculation result (null if no tax zone matches or tax rate is 0) */
-    tax?: TaxCalculation | null;
-}
-/**
- * Checkout state for the useCheckout hook
- */
-export interface CheckoutState {
-    /** Current step in checkout flow */
-    step: CheckoutStep;
-    /** Customer email */
-    email: string | null;
-    /** Shipping address */
-    shippingAddress: Address | null;
-    /** Billing address (if different from shipping) */
-    billingAddress: Address | null;
-    /** Selected shipping option */
-    selectedShipping: ShippingOption | null;
-    /** Whether checkout is processing */
-    isProcessing: boolean;
-    /** Error message if any */
-    error: string | null;
-}
-/**
- * Props for CheckoutButton component
- */
-export interface CheckoutButtonProps {
-    /** Button text (default: "Checkout") */
-    children?: React.ReactNode;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Custom className */
-    className?: string;
-    /** Callback before redirect */
-    onBeforeCheckout?: () => void | Promise<void>;
-    /** Callback on error */
-    onError?: (error: Error) => void;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Full width */
-    fullWidth?: boolean;
-    /**
-     * Skip the payment status check (for faster UX when you know payments are configured).
-     * When false (default), the button checks /api/checkout/status to verify payments are available.
-     * When true, skips the check and assumes payments are configured.
-     */
-    skipPaymentCheck?: boolean;
-}
-/**
- * Props for ShippingForm component
- */
-export interface ShippingFormProps {
-    /** Initial values */
-    defaultValues?: Partial<Address>;
-    /** Callback on valid submission */
-    onSubmit: (address: Address) => void;
-    /** Callback on cancel */
-    onCancel?: () => void;
-    /** Whether form is submitting */
-    isSubmitting?: boolean;
-    /** Custom className */
-    className?: string;
-    /** Show billing address option */
-    showBillingAddress?: boolean;
-    /** Callback when billing address is different */
-    onBillingAddressChange?: (address: Address | null) => void;
-    /**
-     * Allowed shipping countries (ISO 3166-1 alpha-2 codes), fetched from
-     * `store_settings.shippingCountries`. When provided, only these countries
-     * are shown in the dropdown. When omitted (settings fetch failed or
-     * unconfigured store), falls back to the full COMMON_COUNTRIES list.
-     */
-    allowedCountries?: string[];
-}
-/**
- * Props for OrderSummary component
- */
-export interface OrderSummaryProps {
-    /** Line items to display */
-    items?: CheckoutLineItem[];
-    /** Subtotal in cents */
-    subtotal?: number;
-    /** Shipping cost in cents */
-    shipping?: number;
-    /** Tax in cents */
-    tax?: number;
-    /** Discount in cents */
-    discount?: number;
-    /** Total in cents */
-    total?: number;
-    /** Currency code */
-    currency?: string;
-    /** Locale for formatting */
-    locale?: string;
-    /** Custom className */
-    className?: string;
-    /** Whether to show item details */
-    showItems?: boolean;
-    /** Whether to show edit link */
-    showEditLink?: boolean;
-    /** Edit link href */
-    editHref?: string;
-}
-/**
- * Props for CheckoutSuccess component
- */
-export interface CheckoutSuccessProps {
-    /** Order ID to display */
-    orderId?: string;
-    /** Customer email for order updates */
-    email?: string;
-    /** Custom className */
-    className?: string;
-    /** Continue shopping link */
-    continueShoppingHref?: string;
-    /** View order link pattern */
-    viewOrderHref?: string;
-    /** Callback on mount (useful for cart clearing) */
-    onMount?: () => void;
-}
-/**
- * Props for ShippingOptions component.
- * Displays shipping options grouped by carrier with selection.
- */
-export interface ShippingOptionsProps {
-    /** Shipping options grouped by carrier */
-    options: ShippingOptionsGroupedByCarrier[];
-    /** Currently selected option */
-    selectedOption?: ShippingOption | null;
-    /** Callback when an option is selected */
-    onSelect: (option: ShippingOption) => void;
-    /** Whether options are loading */
-    isLoading?: boolean;
-    /** Error message to display */
-    error?: string | null;
-    /** Custom className */
-    className?: string;
-    /** Currency code for price formatting (default: 'USD') */
-    currency?: string;
-    /** Locale for formatting (default: 'en-US') */
-    locale?: string;
-    /** Whether to show carrier grouping (default: true) */
-    showCarrierGroups?: boolean;
-    /** Custom empty state message */
-    emptyMessage?: string;
-}
-/**
- * Props for CheckoutFlow component.
- * Unified pre-checkout flow: Address → Shipping → Review → Payment
- */
-export interface CheckoutFlowProps {
-    /** Called when checkout flow is complete (redirects to Stripe) */
-    onComplete?: () => void;
-    /** Called when user cancels checkout */
-    onCancel?: () => void;
-    /** Initial customer email (if authenticated) */
-    customerEmail?: string;
-    /** Store customer ID (if authenticated) */
-    customerId?: string;
-    /** Custom success URL for Stripe redirect */
-    successUrl?: string;
-    /** Custom cancel URL for Stripe redirect */
-    cancelUrl?: string;
-    /** Custom className */
-    className?: string;
-    /** Whether to show order summary sidebar */
-    showOrderSummary?: boolean;
-    /** Currency code */
-    currency?: string;
-    /** Custom metadata for the checkout session */
-    metadata?: Record<string, string>;
-}
-/**
- * State for the CheckoutFlow component.
- */
-export interface CheckoutFlowState {
-    /** Current step in the pre-checkout flow */
-    step: 'address' | 'shipping' | 'review';
-    /** Customer email */
-    email: string | null;
-    /** Shipping address */
-    shippingAddress: Address | null;
-    /** Billing address (if different from shipping) */
-    billingAddress: Address | null;
-    /** Available shipping options (fetched after address is entered) */
-    availableShipping: ShippingOptionsGroupedByCarrier[];
-    /** Selected shipping option */
-    selectedShipping: ShippingOption | null;
-    /** Whether shipping options are loading */
-    isLoadingShipping: boolean;
-    /** Shipping calculation error */
-    shippingError: string | null;
-    /** Whether checkout is processing */
-    isProcessing: boolean;
-    /** General error message */
-    error: string | null;
-    /** Calculated tax amount in cents (0 if no tax zone matches) */
-    tax: number;
-    /** Tax rate as percentage (null if no tax zone) */
-    taxRate: number | null;
-    /** Tax zone name for display (null if no tax zone) */
-    taxZoneName: string | null;
-    /** Whether tax is included in product prices */
-    taxIncludedInPrices: boolean;
-}
-/**
- * Options for the useCheckout hook
- */
-export interface UseCheckoutOptions {
-    /** Customer email (if known) */
-    customerEmail?: string;
-    /** Store customer ID (if authenticated) */
-    customerId?: string;
-    /** Custom success URL */
-    successUrl?: string;
-    /** Custom cancel URL */
-    cancelUrl?: string;
-    /** Custom metadata */
-    metadata?: Record<string, string>;
-    /**
-     * Pre-collected shipping address from pre-checkout flow.
-     * When provided, Stripe Checkout will pre-fill this address.
-     */
-    shippingAddress?: Address;
-    /**
-     * Pre-selected shipping option from pre-checkout flow.
-     * When provided, creates a fixed shipping rate in Stripe instead of letting customer choose.
-     */
-    selectedShipping?: ShippingOption;
-    /** Callback on successful session creation (before redirect) */
-    onSuccess?: (session: CheckoutSessionResponse) => void;
-    /** Callback on error */
-    onError?: (error: CheckoutApiError) => void;
-}
-/**
- * Return type for the useCheckout hook
- */
-export interface UseCheckoutReturn {
-    /** Start checkout process */
-    checkout: () => Promise<void>;
-    /** Whether checkout is in progress */
-    isLoading: boolean;
-    /** Last error (if any) */
-    error: CheckoutApiError | null;
-    /** Clear error state */
-    clearError: () => void;
-}
-//# sourceMappingURL=types.d.ts.map