@smoothsend/sdk 1.0.2 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # SmoothSend SDK
 
-Gasless transaction SDK for Aptos. Enable gas-free transactions with just 3 lines of code.
+Multi-chain gasless transaction SDK. Enable gas-free transactions with just 3 lines of code. Supports **Aptos** and **Stellar**.
 
 [![npm version](https://badge.fury.io/js/@smoothsend/sdk.svg)](https://www.npmjs.com/package/@smoothsend/sdk)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
@@ -8,11 +8,12 @@ Gasless transaction SDK for Aptos. Enable gas-free transactions with just 3 line
 
 ## 🚀 Features
 
-- **Gasless Transactions**: Users don't need APT for gas fees
-- **3-Line Integration**: Works with Aptos Wallet Adapter out of the box
+- **Gasless Transactions**: Users don't need APT or XLM for gas fees
+- **Multi-Chain**: Aptos + Stellar (same 3-line API)
+- **3-Line Integration**: Works with Aptos Wallet Adapter and Stellar wallets (Freighter, etc.)
 - **Type-Safe**: Full TypeScript support with comprehensive type definitions
-- **Testnet & Mainnet**: Supports both networks
-- **Fee-in-Token**: On mainnet, tiny fee deducted from token (not APT)
+- **Testnet & Mainnet**: Supports both networks on each chain
+- **Fee-in-Token**: On Aptos mainnet, tiny fee deducted from token (not APT)
 
 ## 📦 Installation
 
@@ -225,7 +226,7 @@ const smoothSend = new SmoothSendSDK({
   retries: 3
 });
 
-// Execute transfer from backend
+// Execute Aptos transfer from backend
 const result = await smoothSend.executeGaslessTransfer({
   transactionBytes: signedTx.transactionBytes,
   authenticatorBytes: signedTx.authenticatorBytes,
@@ -233,15 +234,48 @@ const result = await smoothSend.executeGaslessTransfer({
   network: 'mainnet'
 });
 
+// Or Stellar - submit signed XDR
+const stellarResult = await smoothSend.submitStellarTransaction(signedXdr);
+
 console.log('Transfer successful:', result.txHash);
 ```
 
+## ⭐ Stellar - Gasless XLM & USDC
+
+Same 3-line API for Stellar. Use with Freighter, Stellar Wallets Kit, or any Stellar-compatible wallet.
+
+```typescript
+import { SmoothSendSDK } from '@smoothsend/sdk';
+
+const sdk = new SmoothSendSDK({ apiKey: 'pk_nogas_xxx', network: 'testnet' });
+
+// Option 1: Full transfer (build + sign + submit)
+const result = await sdk.transfer(
+  { from: 'G...', to: 'G...', amount: '100', token: 'XLM', chain: 'stellar-testnet' },
+  stellarWallet
+);
+
+// Option 2: Submit pre-signed XDR
+const signedXdr = await wallet.signTransaction(tx);
+const result = await sdk.submitStellarTransaction(signedXdr);
+```
+
+**Stellar wallet interface:**
+```typescript
+const stellarWallet = {
+  buildTransaction: (params) => buildPaymentTransaction(params.from, params.to, params.amount, params.token),
+  signTransaction: (tx) => walletKit.signTransaction(tx.toXDR()).then(r => r.signedTxXdr),
+};
+```
+
 ## 🔧 Supported Networks
 
 | Network | Status | Features |
 |---------|--------|----------|
 | Aptos Testnet | ✅ Active | Gasless transactions, Ed25519 signatures |
 | Aptos Mainnet | ✅ Active | Gasless transactions, Fee-in-token option |
+| Stellar Testnet | ✅ Active | Gasless XLM, USDC, EURC via Fee Bump |
+| Stellar Mainnet | ✅ Active | Gasless XLM, USDC, EURC via Fee Bump |
 
 ## 📚 API Reference
 
@@ -300,7 +334,7 @@ const result = await client.submitSignedTransaction({
 
 ### SmoothSendSDK (Classic)
 
-Direct SDK usage for more control.
+Direct SDK usage for more control. Works for both Aptos and Stellar.
 
 ```typescript
 import { SmoothSendSDK } from '@smoothsend/sdk';
@@ -312,13 +346,16 @@ const smoothSend = new SmoothSendSDK({
   retries: 3
 });
 
-// Execute gasless transfer
+// Aptos - execute gasless transfer
 const result = await smoothSend.executeGaslessTransfer({
   transactionBytes: signedTx.transactionBytes,
   authenticatorBytes: signedTx.authenticatorBytes,
   chain: 'aptos-testnet',
   network: 'testnet'
 });
+
+// Stellar - submit signed XDR
+const stellarResult = await smoothSend.submitStellarTransaction(signedXdr);
 ```
 
 ## 🔐 Security

package/dist/adapters/stellar.d.ts

@@ -0,0 +1,28 @@
+import { SupportedChain, IChainAdapter, ChainConfig, TransferRequest, FeeEstimate, SignedTransferData, TransferResult, HealthResponse } from '../types';
+/**
+ * Stellar Adapter - Gasless transactions via Fee Bump
+ * Routes through proxy.smoothsend.xyz with API key authentication
+ * Supports XLM, USDC, EURC and other Stellar assets
+ */
+export declare class StellarAdapter implements IChainAdapter {
+    readonly chain: SupportedChain;
+    readonly config: ChainConfig;
+    private httpClient;
+    private network;
+    constructor(chain: SupportedChain, config: ChainConfig, apiKey: string, network?: 'testnet' | 'mainnet', includeOrigin?: boolean);
+    setNetwork(network: 'testnet' | 'mainnet'): void;
+    getNetwork(): 'testnet' | 'mainnet';
+    /**
+     * Stellar gasless: relayer pays fee. Returns 0 for user.
+     */
+    estimateFee(_request: TransferRequest): Promise<FeeEstimate>;
+    /**
+     * Submit signed XDR to relayer for Fee Bump wrapping
+     */
+    executeGaslessTransfer(signedData: SignedTransferData): Promise<TransferResult>;
+    getTransactionStatus(txHash: string): Promise<any>;
+    getHealth(): Promise<HealthResponse>;
+    validateAddress(address: string): boolean;
+    validateAmount(amount: string): boolean;
+}
+//# sourceMappingURL=stellar.d.ts.map

package/dist/adapters/stellar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar.d.ts","sourceRoot":"","sources":["../../src/adapters/stellar.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EAKf,MAAM,UAAU,CAAC;AAMlB;;;;GAIG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,SAAgB,KAAK,EAAE,cAAc,CAAC;IACtC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAwB;gBAGrC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,SAAS,GAAG,SAAqB,EAC1C,aAAa,GAAE,OAAe;IAwBhC,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IAKhD,UAAU,IAAI,SAAS,GAAG,SAAS;IAInC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAUlE;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IA4C/E,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBlD,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAuB1C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIzC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAQxC"}

package/dist/core/SmoothSendSDK.d.ts

@@ -1,4 +1,4 @@
-import { SupportedChain, ChainEcosystem, TransferRequest, SignedTransferData, TransferResult, SmoothSendConfig, EventListener, HealthResponse, FeeEstimate, UsageMetadata } from '../types';
+import { SupportedChain, ChainEcosystem, TransferRequest, SignedTransferData, TransferResult, SmoothSendConfig, EventListener, HealthResponse, FeeEstimate, UsageMetadata, AptosWallet, StellarWallet } from '../types';
 export declare class SmoothSendSDK {
     private adapters;
     private eventListeners;
@@ -36,30 +36,29 @@ export declare class SmoothSendSDK {
     estimateFee(request: TransferRequest): Promise<FeeEstimate & {
         metadata?: UsageMetadata;
     }>;
+    /**
+     * Submit a signed Stellar transaction (XDR) for gasless relay.
+     * Use when you've already built and signed the transaction.
+     *
+     * @example
+     * const signedXdr = await stellarWallet.signTransaction(tx);
+     * const result = await sdk.submitStellarTransaction(signedXdr);
+     */
+    submitStellarTransaction(signedXdr: string): Promise<TransferResult>;
     executeGaslessTransfer(signedData: SignedTransferData): Promise<TransferResult>;
     /**
      * Convenience method for complete transfer flow
-     * Combines estimateFee and executeGaslessTransfer into a single call
+     * Works for both Aptos and Stellar - same 3-line API.
      *
      * @param request Transfer request with from, to, token, amount, chain
-     * @param wallet Wallet instance that can build and sign transactions
+     * @param wallet Aptos or Stellar wallet provider
      * @returns Transfer result with transaction hash and usage metadata
      *
-     * Note: The wallet parameter should have methods:
-     * - buildTransaction(params): Build transaction from parameters
-     * - signTransaction(transaction): Sign and serialize transaction
-     *
-     * The wallet's signTransaction should return an object with:
-     * - transactionBytes: number[] - Serialized transaction
-     * - authenticatorBytes: number[] - Serialized authenticator
+     * Aptos wallet: signTransaction returns { transactionBytes, authenticatorBytes }
+     * Stellar wallet: signTransaction returns string (signed XDR)
      */
-    transfer(request: TransferRequest, wallet: {
-        buildTransaction: (params: any) => Promise<any>;
-        signTransaction: (transaction: any) => Promise<{
-            transactionBytes: number[];
-            authenticatorBytes: number[];
-        }>;
-    }): Promise<TransferResult>;
+    transfer(request: TransferRequest, wallet: AptosWallet | StellarWallet): Promise<TransferResult>;
+    private transferStellar;
     /**
      * Get transaction status for a specific transaction
      * Routes through proxy to chain-specific status endpoint

package/dist/core/SmoothSendSDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmoothSendSDK.d.ts","sourceRoot":"","sources":["../../src/core/SmoothSendSDK.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SmoothSendSDK.d.ts","sourceRoot":"","sources":["../../src/core/SmoothSendSDK.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -225,15 +225,16 @@ declare function createNetworkError(error: any): NetworkError;
  * - `aptos-testnet`: Aptos testnet
  * - `aptos-mainnet`: Aptos mainnet
  */
-type SupportedChain = 'avalanche' | 'aptos-testnet' | 'aptos-mainnet';
+type SupportedChain = 'avalanche' | 'aptos-testnet' | 'aptos-mainnet' | 'stellar-testnet' | 'stellar-mainnet';
 /**
  * Chain ecosystem types for routing to correct relayers
  *
  * @remarks
  * - `evm`: Ethereum Virtual Machine compatible chains (Avalanche, Base, Arbitrum, etc.)
  * - `aptos`: Aptos blockchain ecosystem
+ * - `stellar`: Stellar blockchain ecosystem
  */
-type ChainEcosystem = 'evm' | 'aptos';
+type ChainEcosystem = 'evm' | 'aptos' | 'stellar';
 /**
  * Mapping of supported chains to their respective ecosystems
  * Used internally for adapter selection and routing
@@ -621,9 +622,11 @@ interface SignatureData {
  */
 interface SignedTransferData {
     /** Serialized transaction (Aptos) */
-    transactionBytes: number[];
+    transactionBytes?: number[];
     /** Serialized authenticator (Aptos) */
-    authenticatorBytes: number[];
+    authenticatorBytes?: number[];
+    /** Signed XDR transaction (Stellar) */
+    signedTransaction?: string;
     /** Target blockchain */
     chain: SupportedChain;
     /** Optional network override (testnet or mainnet) */
@@ -878,6 +881,16 @@ declare const APTOS_ERROR_CODES: {
  * Ensures type safety when using error codes
  */
 type AptosErrorCode = typeof APTOS_ERROR_CODES[keyof typeof APTOS_ERROR_CODES];
+/**
+ * Stellar adapter error codes
+ */
+declare const STELLAR_ERROR_CODES: {
+    readonly MISSING_SIGNED_TRANSACTION: "STELLAR_MISSING_SIGNED_TRANSACTION";
+    readonly GASLESS_TRANSACTION_ERROR: "STELLAR_GASLESS_TRANSACTION_ERROR";
+    readonly STATUS_ERROR: "STELLAR_STATUS_ERROR";
+    readonly HEALTH_ERROR: "STELLAR_HEALTH_ERROR";
+    readonly INVALID_ADDRESS_FORMAT: "STELLAR_INVALID_ADDRESS_FORMAT";
+};
 /**
  * Generic API response structure
  * Used for all API responses with optional data payload
@@ -982,6 +995,35 @@ interface UsageMetadata {
     /** Unique request identifier for debugging */
     requestId: string;
 }
+/**
+ * Aptos wallet interface for sdk.transfer()
+ */
+interface AptosWallet {
+    buildTransaction: (params: {
+        sender: string;
+        recipient: string;
+        amount: string;
+        coinType: string;
+        relayerFee: string;
+    }) => Promise<any>;
+    signTransaction: (transaction: any) => Promise<{
+        transactionBytes: number[];
+        authenticatorBytes: number[];
+    }>;
+}
+/**
+ * Stellar wallet interface for sdk.transfer()
+ * Use with Freighter, Stellar Wallets Kit, or any Stellar-compatible wallet
+ */
+interface StellarWallet {
+    buildTransaction: (params: {
+        from: string;
+        to: string;
+        amount: string;
+        token: string;
+    }) => Promise<any>;
+    signTransaction: (transaction: any) => Promise<string>;
+}
 /**
  * Transfer event types
  * Emitted during transfer lifecycle for monitoring and debugging
@@ -1192,30 +1234,29 @@ declare class SmoothSendSDK {
     estimateFee(request: TransferRequest): Promise<FeeEstimate & {
         metadata?: UsageMetadata;
     }>;
+    /**
+     * Submit a signed Stellar transaction (XDR) for gasless relay.
+     * Use when you've already built and signed the transaction.
+     *
+     * @example
+     * const signedXdr = await stellarWallet.signTransaction(tx);
+     * const result = await sdk.submitStellarTransaction(signedXdr);
+     */
+    submitStellarTransaction(signedXdr: string): Promise<TransferResult>;
     executeGaslessTransfer(signedData: SignedTransferData): Promise<TransferResult>;
     /**
      * Convenience method for complete transfer flow
-     * Combines estimateFee and executeGaslessTransfer into a single call
+     * Works for both Aptos and Stellar - same 3-line API.
      *
      * @param request Transfer request with from, to, token, amount, chain
-     * @param wallet Wallet instance that can build and sign transactions
+     * @param wallet Aptos or Stellar wallet provider
      * @returns Transfer result with transaction hash and usage metadata
      *
-     * Note: The wallet parameter should have methods:
-     * - buildTransaction(params): Build transaction from parameters
-     * - signTransaction(transaction): Sign and serialize transaction
-     *
-     * The wallet's signTransaction should return an object with:
-     * - transactionBytes: number[] - Serialized transaction
-     * - authenticatorBytes: number[] - Serialized authenticator
+     * Aptos wallet: signTransaction returns { transactionBytes, authenticatorBytes }
+     * Stellar wallet: signTransaction returns string (signed XDR)
      */
-    transfer(request: TransferRequest, wallet: {
-        buildTransaction: (params: any) => Promise<any>;
-        signTransaction: (transaction: any) => Promise<{
-            transactionBytes: number[];
-            authenticatorBytes: number[];
-        }>;
-    }): Promise<TransferResult>;
+    transfer(request: TransferRequest, wallet: AptosWallet | StellarWallet): Promise<TransferResult>;
+    private transferStellar;
     /**
      * Get transaction status for a specific transaction
      * Routes through proxy to chain-specific status endpoint
@@ -1898,6 +1939,33 @@ declare class AptosAdapter implements IChainAdapter {
     callMoveFunction(functionName: string, args: any[]): Promise<any>;
 }
 
+/**
+ * Stellar Adapter - Gasless transactions via Fee Bump
+ * Routes through proxy.smoothsend.xyz with API key authentication
+ * Supports XLM, USDC, EURC and other Stellar assets
+ */
+declare class StellarAdapter implements IChainAdapter {
+    readonly chain: SupportedChain;
+    readonly config: ChainConfig;
+    private httpClient;
+    private network;
+    constructor(chain: SupportedChain, config: ChainConfig, apiKey: string, network?: 'testnet' | 'mainnet', includeOrigin?: boolean);
+    setNetwork(network: 'testnet' | 'mainnet'): void;
+    getNetwork(): 'testnet' | 'mainnet';
+    /**
+     * Stellar gasless: relayer pays fee. Returns 0 for user.
+     */
+    estimateFee(_request: TransferRequest): Promise<FeeEstimate>;
+    /**
+     * Submit signed XDR to relayer for Fee Bump wrapping
+     */
+    executeGaslessTransfer(signedData: SignedTransferData): Promise<TransferResult>;
+    getTransactionStatus(txHash: string): Promise<any>;
+    getHealth(): Promise<HealthResponse>;
+    validateAddress(address: string): boolean;
+    validateAmount(amount: string): boolean;
+}
+
 /**
  * Configuration for HTTP client
  */
@@ -1986,24 +2054,17 @@ declare class HttpClient {
  * @packageDocumentation
  *
  * @example
- * Basic usage:
+ * Aptos:
  * ```typescript
- * import { SmoothSendSDK } from '@smoothsend/sdk';
- *
- * const sdk = new SmoothSendSDK({
- *   apiKey: 'no_gas_abc123...',
- *   network: 'testnet'
- * });
- *
- * const result = await sdk.transfer({
- *   from: '0x123...',
- *   to: '0x456...',
- *   token: 'USDC',
- *   amount: '1000000',
- *   chain: 'aptos-testnet'
- * }, wallet);
+ * const sdk = new SmoothSendSDK({ apiKey: 'pk_nogas_xxx', network: 'testnet' });
+ * const result = await sdk.transfer({ from, to, token: 'USDC', amount: '1000000', chain: 'aptos-testnet' }, aptosWallet);
+ * ```
  *
- * console.log('Transaction:', result.txHash);
+ * @example
+ * Stellar (same API):
+ * ```typescript
+ * const sdk = new SmoothSendSDK({ apiKey: 'pk_nogas_xxx', network: 'testnet' });
+ * const result = await sdk.transfer({ from, to, token: 'XLM', amount: '100', chain: 'stellar-testnet' }, stellarWallet);
  * ```
  */
 
@@ -2011,7 +2072,7 @@ declare class HttpClient {
  * SDK version
  * @public
  */
-declare const VERSION = "2.1.0";
+declare const VERSION = "1.1.0";
 
-export { APTOS_ERROR_CODES, AptosAdapter, AuthenticationError, CHAIN_ECOSYSTEM_MAP, HttpClient, NetworkError, RateLimitError, ScriptComposerClient, SmoothSendError, SmoothSendSDK, SmoothSendTransactionSubmitter, VERSION, ValidationError, createErrorFromResponse, createNetworkError, createScriptComposerClient, createSmoothSendSubmitter, SmoothSendSDK as default };
-export type { ApiResponse, AptosErrorCode, AptosTransferData, AvalancheTransferData, BatchRelayTransferRequest, BatchTransferRequest, BuildTransferParams, BuildTransferResult, ChainConfig, ChainEcosystem, ChainInfo, DomainSeparatorResponse, EVMTransferData, ErrorResponse, EstimateGasRequest, EventListener, FeeEstimate, FeeEstimateResult, GasEstimateResponse, HealthResponse, IChainAdapter, PermitData, PrepareSignatureRequest, PrepareSignatureResponse, RelayTransferRequest, RelayTransferResponse, ScriptComposerConfig, SignatureData, SignedTransferData, SmoothSendConfig, SmoothSendTransactionSubmitterConfig, SubmitSignedTransactionParams, SubmitTransactionResult, SuccessResponse, SupportedChain, TokenBalance, TokenInfo, TransactionSubmitter, TransferData, TransferEvent, TransferQuote, TransferQuoteRequest, TransferQuoteResponse, TransferRequest, TransferResult, TransferStatusResponse, UsageMetadata };
+export { APTOS_ERROR_CODES, AptosAdapter, AuthenticationError, CHAIN_ECOSYSTEM_MAP, HttpClient, NetworkError, RateLimitError, STELLAR_ERROR_CODES, ScriptComposerClient, SmoothSendError, SmoothSendSDK, SmoothSendTransactionSubmitter, StellarAdapter, VERSION, ValidationError, createErrorFromResponse, createNetworkError, createScriptComposerClient, createSmoothSendSubmitter, SmoothSendSDK as default };
+export type { ApiResponse, AptosErrorCode, AptosTransferData, AptosWallet, AvalancheTransferData, BatchRelayTransferRequest, BatchTransferRequest, BuildTransferParams, BuildTransferResult, ChainConfig, ChainEcosystem, ChainInfo, DomainSeparatorResponse, EVMTransferData, ErrorResponse, EstimateGasRequest, EventListener, FeeEstimate, FeeEstimateResult, GasEstimateResponse, HealthResponse, IChainAdapter, PermitData, PrepareSignatureRequest, PrepareSignatureResponse, RelayTransferRequest, RelayTransferResponse, ScriptComposerConfig, SignatureData, SignedTransferData, SmoothSendConfig, SmoothSendTransactionSubmitterConfig, StellarWallet, SubmitSignedTransactionParams, SubmitTransactionResult, SuccessResponse, SupportedChain, TokenBalance, TokenInfo, TransactionSubmitter, TransferData, TransferEvent, TransferQuote, TransferQuoteRequest, TransferQuoteResponse, TransferRequest, TransferResult, TransferStatusResponse, UsageMetadata };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,oCAAoC,EACzC,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIhD,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,oCAAoC,EACzC,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC"}