@stellar-snaps/sdk 0.3.0 → 0.3.2

package/README.md

@@ -14,6 +14,22 @@ npm install @stellar-snaps/sdk
 pnpm add @stellar-snaps/sdk
 ```
 
+**Peer dependencies** (install if you use transaction building or Freighter):  
+`@stellar/freighter-api`, `@stellar/stellar-sdk`
+
+## How it works
+
+- **Shareable Snap API** (`createSnap`, `getSnap`, `listSnaps`, `deleteSnap`)  
+  Calls the Stellar Snaps web app at `https://stellar-snaps.vercel.app` by default. Snaps are stored there; you get back shareable URLs (e.g. `https://stellar-snaps.vercel.app/s/abc123`). Works in **Node.js** and **browser** (CORS is enabled on the API). Use `baseUrl` to point at your own deployment.
+
+- **SEP-0007 URIs** (`createPaymentSnap`, `createTransactionSnap`, `parseSnapUri`)  
+  Pure logic, no network. Build or parse `web+stellar:...` payment/transaction links.
+
+- **Transactions & Freighter** (`buildPaymentTransaction`, `signWithFreighter`, `submitTransaction`, etc.)  
+  Run in a **browser** with the [Freighter](https://www.freighter.app/) extension installed. Uses `@stellar/freighter-api` and `@stellar/stellar-sdk`.
+
+So: install the package, use the Shareable Snap API from any environment; use Freighter-related APIs only in a browser with Freighter installed.
+
 ## Quick Start
 
 ### 1. Create a Payment Link
@@ -79,7 +95,60 @@ if (result.successful) {
 }
 ```
 
-### 4. Host Your Own Snap Endpoints
+### 4. Create Shareable Snaps (Web App API)
+
+Create, fetch, list, and delete database-backed snaps—same behavior as the web dashboard. Uses `https://stellar-snaps.vercel.app` by default.
+
+```typescript
+import { createSnap, getSnap, listSnaps, deleteSnap } from '@stellar-snaps/sdk';
+
+// Create a snap (stores on server, returns shareable URL)
+const { url, snap } = await createSnap({
+  creator: 'GCNZMNUTQ5UMQ5QL0FUAW3CUADWB...',
+  title: 'Buy me a coffee',
+  destination: 'GCNZMNUTQ5UMQ5QL0FUAW3CUADWB...',
+  amount: '5',
+  network: 'testnet',
+});
+console.log(url);
+// => https://stellar-snaps.vercel.app/s/u8oYHLhl
+
+// Fetch a snap by ID
+const fetchedSnap = await getSnap('u8oYHLhl');
+
+// List all snaps for a creator
+const snaps = await listSnaps('GCNZMNUTQ5UMQ5QL0FUAW3CUADWB...');
+
+// Delete a snap (requires creator address)
+await deleteSnap('u8oYHLhl', 'GCNZMNUTQ5UMQ5QL0FUAW3CUADWB...');
+```
+
+Use `baseUrl` to point at your own Stellar Snaps instance:
+
+```typescript
+const { url } = await createSnap({
+  creator: 'G...',
+  title: 'Test',
+  destination: 'G...',
+  baseUrl: 'https://your-stellar-snaps.vercel.app',
+});
+```
+
+**Show the same modal overlay as the web app** (browser only): open the snap URL in a modal so users can pay without leaving your page:
+
+```typescript
+import { createSnap, openSnapModal, closeSnapModal } from '@stellar-snaps/sdk';
+
+const { url } = await createSnap({ creator: 'G...', title: 'Tip', destination: 'G...' });
+openSnapModal(url, {
+  width: 420,
+  height: 560,
+  onClose: () => console.log('Modal closed'),
+});
+// User sees the same payment UI as stellar-snaps.vercel.app/s/xxx in an overlay
+```
+
+### 5. Host Your Own Snap Endpoints
 
 Create a discovery file to enable the browser extension to find your snaps:
 
@@ -99,6 +168,93 @@ const discovery = createDiscoveryFile({
 
 ## API Reference
 
+### Shareable Snap API (Web App)
+
+These functions mirror the Stellar Snaps web app API. Use them to create and manage snaps that are stored on a server and get shareable URLs.
+
+#### `createSnap(options)`
+
+Creates a snap on the server and returns the shareable URL.
+
+```typescript
+interface CreateSnapOptions {
+  creator: string;              // Creator's Stellar address (required)
+  title: string;                // Display title (required)
+  destination: string;          // Payment destination (required)
+  description?: string;
+  amount?: string;              // Omit for open amount
+  assetCode?: string;           // Default: 'XLM'
+  assetIssuer?: string;         // Required for non-XLM
+  memo?: string;
+  memoType?: MemoType;
+  network?: 'public' | 'testnet'; // Default: 'testnet'
+  imageUrl?: string;
+  baseUrl?: string;             // Default: 'https://stellar-snaps.vercel.app'
+}
+
+interface CreateSnapResult {
+  id: string;
+  url: string;                  // Full shareable URL
+  snap: Snap;
+}
+```
+
+#### `getSnap(id, options?)`
+
+Fetches a snap by ID. Uses `GET /api/snap/[id]`.
+
+- **Throws** `SnapNotFoundError` if the snap does not exist.
+- **Throws** `SnapApiError` on other API errors.
+
+#### `listSnaps(creator, options?)`
+
+Lists all snaps for a creator. Uses `GET /api/snaps?creator=...`.
+
+#### `deleteSnap(id, creator, options?)`
+
+Deletes a snap. Requires the creator's address (ownership). Uses `DELETE /api/snaps?id=...&creator=...`.
+
+- **Throws** `SnapNotFoundError` if the snap does not exist.
+- **Throws** `SnapUnauthorizedError` if the creator does not own the snap.
+- **Throws** `SnapApiError` on other API errors.
+
+#### `Snap` type
+
+```typescript
+interface Snap {
+  id: string;
+  creator?: string;             // Omitted in GET /api/snap/[id] response
+  title: string;
+  description?: string | null;
+  destination: string;
+  amount?: string | null;
+  assetCode: string;
+  assetIssuer?: string | null;
+  memo?: string | null;
+  memoType?: string;
+  network: string;
+  imageUrl?: string | null;
+  createdAt?: string;
+  updatedAt?: string;
+}
+```
+
+#### `openSnapModal(snapUrl, options?)`
+
+Opens a snap URL in a full-screen modal overlay (iframe). Same payment UI as opening the link on the Stellar Snaps web app. **Browser only**; no-op in Node.
+
+```typescript
+interface OpenSnapModalOptions {
+  width?: number;   // Default: 420
+  height?: number;  // Default: 560
+  onClose?: () => void;
+}
+```
+
+#### `closeSnapModal()`
+
+Closes the snap modal if one is open. Safe to call anytime.
+
 ### SEP-0007 URI Functions
 
 #### `createPaymentSnap(options)`
@@ -260,6 +416,9 @@ All errors extend `StellarSnapError` with a `code` property for programmatic han
 - `InvalidAmountError` - Invalid amount
 - `InvalidAssetError` - Invalid asset configuration
 - `InvalidUriError` - Invalid SEP-0007 URI
+- `SnapNotFoundError` - Snap not found (404 from API)
+- `SnapUnauthorizedError` - Not authorized to perform action (e.g. delete another user's snap)
+- `SnapApiError` - Stellar Snaps API returned an error (includes optional `statusCode`)
 
 ```typescript
 try {
@@ -269,6 +428,14 @@ try {
     console.log(error.code); // 'INVALID_ADDRESS'
   }
 }
+
+try {
+  const snap = await getSnap('missing-id');
+} catch (error) {
+  if (error instanceof SnapNotFoundError) {
+    console.log(error.code); // 'SNAP_NOT_FOUND'
+  }
+}
 ```
 
 ### Constants

package/dist/index.d.mts

@@ -1,11 +1,29 @@
 import * as StellarSdk from '@stellar/stellar-sdk';
 
 /**
- * Create Shareable Snap
+ * Shareable Snap API
  *
- * Creates a snap on a Stellar Snaps server and returns the shareable URL.
- * This is different from createPaymentSnap which only creates SEP-0007 URIs.
+ * Functions that mirror the Stellar Snaps web app API. Create, fetch, list,
+ * and delete database-backed snaps so developers get the same behavior as
+ * the dashboard. Uses https://stellar-snaps.vercel.app by default.
  */
+/** Snap as returned by the web app API (GET /api/snap/[id] omits creator; list/create include it). */
+interface Snap$1 {
+    id: string;
+    creator?: string;
+    title: string;
+    description?: string | null;
+    destination: string;
+    amount?: string | null;
+    assetCode: string;
+    assetIssuer?: string | null;
+    memo?: string | null;
+    memoType?: string;
+    network: string;
+    imageUrl?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
 interface CreateSnapOptions {
     /** Creator's Stellar address (required) */
     creator: string;
@@ -29,30 +47,16 @@ interface CreateSnapOptions {
     network?: 'public' | 'testnet';
     /** Optional image URL for the snap */
     imageUrl?: string;
-    /** Stellar Snaps server URL (default: 'https://stellarsnaps.com') */
-    serverUrl?: string;
+    /** Stellar Snaps server base URL (default: 'https://stellar-snaps.vercel.app') */
+    baseUrl?: string;
 }
 interface CreateSnapResult {
     /** The created snap ID */
     id: string;
-    /** Full shareable URL */
+    /** Full shareable URL (e.g. https://stellar-snaps.vercel.app/s/abc123) */
     url: string;
-    /** The snap data as stored */
-    snap: {
-        id: string;
-        creator: string;
-        title: string;
-        description?: string;
-        destination: string;
-        amount?: string;
-        assetCode: string;
-        assetIssuer?: string;
-        memo?: string;
-        memoType: string;
-        network: string;
-        imageUrl?: string;
-        createdAt: string;
-    };
+    /** The snap data as returned by the API */
+    snap: Snap$1;
 }
 /**
  * Creates a shareable snap on a Stellar Snaps server.
@@ -64,53 +68,73 @@ interface CreateSnapResult {
  *   title: 'Coffee Payment',
  *   destination: 'GDEST...',
  *   amount: '5',
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
+ *   baseUrl: 'https://stellar-snaps.vercel.app'
  * });
- *
  * console.log(result.url);
- * // https://your-stellar-snaps-instance.com/s/nk1VNcxo
+ * // https://stellar-snaps.vercel.app/s/abc12345
  * ```
  */
 declare function createSnap(options: CreateSnapOptions): Promise<CreateSnapResult>;
 /**
- * Fetches an existing snap by ID from a Stellar Snaps server.
+ * Fetches a snap by ID from the Stellar Snaps server.
+ * Uses GET /api/snap/[id] (singular path, same as web app).
  *
- * @example
- * ```typescript
- * const snap = await getSnap('nk1VNcxo', {
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
- * });
- * ```
+ * @throws SnapNotFoundError if the snap does not exist
+ * @throws SnapApiError if the request fails
  */
 declare function getSnap(id: string, options?: {
-    serverUrl?: string;
-}): Promise<CreateSnapResult['snap'] | null>;
+    baseUrl?: string;
+}): Promise<Snap$1>;
 /**
- * Lists snaps created by a specific address.
- *
- * @example
- * ```typescript
- * const snaps = await listSnaps('GCREATOR...', {
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
- * });
- * ```
+ * Lists snaps created by a specific address (GET /api/snaps?creator=...).
  */
 declare function listSnaps(creator: string, options?: {
-    serverUrl?: string;
-}): Promise<CreateSnapResult['snap'][]>;
+    baseUrl?: string;
+}): Promise<Snap$1[]>;
 /**
- * Deletes a snap by ID.
+ * Deletes a snap by ID. Requires the creator's address (same as web app: DELETE /api/snaps?id=...&creator=...).
+ *
+ * @throws SnapNotFoundError if the snap does not exist
+ * @throws SnapUnauthorizedError if the creator does not own the snap
+ * @throws SnapApiError if the request fails
+ */
+declare function deleteSnap(id: string, creator: string, options?: {
+    baseUrl?: string;
+}): Promise<void>;
+
+/**
+ * Snap Modal Overlay
+ *
+ * Opens a snap URL (e.g. from createSnap) in a modal overlay so users can pay
+ * without leaving the page. Same payment UI as the web app, loaded in an iframe.
+ * Browser-only; no-op in Node.
+ */
+interface OpenSnapModalOptions {
+    /** Width of the iframe content area (default: 420) */
+    width?: number;
+    /** Height of the iframe (default: 560) */
+    height?: number;
+    /** Called when the user closes the modal */
+    onClose?: () => void;
+}
+/**
+ * Opens a snap URL in a modal overlay (iframe). Same experience as opening
+ * the link on the Stellar Snaps web app—payment form, Freighter, etc.
+ * Use the URL returned from createSnap(), e.g. result.url.
+ *
+ * Browser-only; does nothing in Node.
  *
  * @example
  * ```typescript
- * await deleteSnap('nk1VNcxo', {
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
- * });
+ * const { url } = await createSnap({ ... });
+ * openSnapModal(url, { onClose: () => console.log('Closed') });
  * ```
  */
-declare function deleteSnap(id: string, options?: {
-    serverUrl?: string;
-}): Promise<void>;
+declare function openSnapModal(snapUrl: string, options?: OpenSnapModalOptions): void;
+/**
+ * Closes the snap modal if one is open. Safe to call anytime.
+ */
+declare function closeSnapModal(): void;
 
 /**
  * Snap ID Generation
@@ -1169,5 +1193,24 @@ declare class InvalidAssetError extends StellarSnapError {
 declare class InvalidUriError extends StellarSnapError {
     constructor(message: string);
 }
+/**
+ * Thrown when a snap is not found (404 from API).
+ */
+declare class SnapNotFoundError extends StellarSnapError {
+    constructor(snapId: string);
+}
+/**
+ * Thrown when the caller is not authorized to perform the action (e.g. delete another user's snap).
+ */
+declare class SnapUnauthorizedError extends StellarSnapError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the Stellar Snaps API returns an error.
+ */
+declare class SnapApiError extends StellarSnapError {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
 
-export { type ApiResponse, type BuildPaymentOptions, CACHE_HEADERS, CORS_HEADERS, type CreateDiscoveryFileOptions, type CreateSnapInput, type CreateSnapOptions, type CreateSnapResult, type DiscoveryFile, type DiscoveryRule, type DomainEntry, type DomainStatus, EXPLORER_URLS, type ExplorerType, type FreighterConnectionResult, HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, type MemoType, type MetaTags, NETWORK_PASSPHRASES, type Network, POSTGRES_SCHEMA, type ParsedSnap, type PaymentSnapOptions, type PaymentSnapResult, type RateLimitBucket, type Registry, type ResolvedUrl, SHORTENER_DOMAINS, SQLITE_SCHEMA, type Snap, type SnapMetadata, StellarSnapError, type TransactionSnapOptions, type TransactionSnapResult, type TransactionSubmitResult, type UpdateSnapInput, addDomain, buildPaymentTransaction, buildUrl, connectFreighter, createAsset, createDiscoveryFile, createPaymentSnap, createRateLimiter, createRegistry, createSnap, createSnapObject, createTransactionSnap, deleteSnap, errorResponse, extractDomain, extractPath, extractSnapId, generateJsonLd, generateMetaTags, generateSnapId, getAccountUrl, getAssetUrl, getBlockedDomains, getDomainStatus, getFreighterNetwork, getOperationUrl, getSnap, getTransactionUrl, getVerifiedDomains, isDomainBlocked, isDomainVerified, isFreighterConnected, isShortenerUrl, isValidAmount, isValidAssetCode, isValidSnapId, isValidStellarAddress, listSnaps, matchUrlToRule, metaTagsToHtml, parseAddress, parseQueryParams, parseSnapUri, removeDomain, resolveUrl, resolveUrls, signWithFreighter, submitTransaction, successResponse, validateDiscoveryFile, validateRegistry, validateRequired, validateSnapInput };
+export { type ApiResponse, type BuildPaymentOptions, CACHE_HEADERS, CORS_HEADERS, type CreateDiscoveryFileOptions, type CreateSnapInput, type CreateSnapOptions, type CreateSnapResult, type DiscoveryFile, type DiscoveryRule, type DomainEntry, type DomainStatus, EXPLORER_URLS, type ExplorerType, type FreighterConnectionResult, HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, type MemoType, type MetaTags, NETWORK_PASSPHRASES, type Network, type OpenSnapModalOptions, POSTGRES_SCHEMA, type ParsedSnap, type PaymentSnapOptions, type PaymentSnapResult, type RateLimitBucket, type Registry, type ResolvedUrl, SHORTENER_DOMAINS, SQLITE_SCHEMA, type Snap$1 as Snap, SnapApiError, type SnapMetadata, SnapNotFoundError, type Snap as SnapRecord, SnapUnauthorizedError, StellarSnapError, type TransactionSnapOptions, type TransactionSnapResult, type TransactionSubmitResult, type UpdateSnapInput, addDomain, buildPaymentTransaction, buildUrl, closeSnapModal, connectFreighter, createAsset, createDiscoveryFile, createPaymentSnap, createRateLimiter, createRegistry, createSnap, createSnapObject, createTransactionSnap, deleteSnap, errorResponse, extractDomain, extractPath, extractSnapId, generateJsonLd, generateMetaTags, generateSnapId, getAccountUrl, getAssetUrl, getBlockedDomains, getDomainStatus, getFreighterNetwork, getOperationUrl, getSnap, getTransactionUrl, getVerifiedDomains, isDomainBlocked, isDomainVerified, isFreighterConnected, isShortenerUrl, isValidAmount, isValidAssetCode, isValidSnapId, isValidStellarAddress, listSnaps, matchUrlToRule, metaTagsToHtml, openSnapModal, parseAddress, parseQueryParams, parseSnapUri, removeDomain, resolveUrl, resolveUrls, signWithFreighter, submitTransaction, successResponse, validateDiscoveryFile, validateRegistry, validateRequired, validateSnapInput };

package/dist/index.d.ts

@@ -1,11 +1,29 @@
 import * as StellarSdk from '@stellar/stellar-sdk';
 
 /**
- * Create Shareable Snap
+ * Shareable Snap API
  *
- * Creates a snap on a Stellar Snaps server and returns the shareable URL.
- * This is different from createPaymentSnap which only creates SEP-0007 URIs.
+ * Functions that mirror the Stellar Snaps web app API. Create, fetch, list,
+ * and delete database-backed snaps so developers get the same behavior as
+ * the dashboard. Uses https://stellar-snaps.vercel.app by default.
  */
+/** Snap as returned by the web app API (GET /api/snap/[id] omits creator; list/create include it). */
+interface Snap$1 {
+    id: string;
+    creator?: string;
+    title: string;
+    description?: string | null;
+    destination: string;
+    amount?: string | null;
+    assetCode: string;
+    assetIssuer?: string | null;
+    memo?: string | null;
+    memoType?: string;
+    network: string;
+    imageUrl?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
 interface CreateSnapOptions {
     /** Creator's Stellar address (required) */
     creator: string;
@@ -29,30 +47,16 @@ interface CreateSnapOptions {
     network?: 'public' | 'testnet';
     /** Optional image URL for the snap */
     imageUrl?: string;
-    /** Stellar Snaps server URL (default: 'https://stellarsnaps.com') */
-    serverUrl?: string;
+    /** Stellar Snaps server base URL (default: 'https://stellar-snaps.vercel.app') */
+    baseUrl?: string;
 }
 interface CreateSnapResult {
     /** The created snap ID */
     id: string;
-    /** Full shareable URL */
+    /** Full shareable URL (e.g. https://stellar-snaps.vercel.app/s/abc123) */
     url: string;
-    /** The snap data as stored */
-    snap: {
-        id: string;
-        creator: string;
-        title: string;
-        description?: string;
-        destination: string;
-        amount?: string;
-        assetCode: string;
-        assetIssuer?: string;
-        memo?: string;
-        memoType: string;
-        network: string;
-        imageUrl?: string;
-        createdAt: string;
-    };
+    /** The snap data as returned by the API */
+    snap: Snap$1;
 }
 /**
  * Creates a shareable snap on a Stellar Snaps server.
@@ -64,53 +68,73 @@ interface CreateSnapResult {
  *   title: 'Coffee Payment',
  *   destination: 'GDEST...',
  *   amount: '5',
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
+ *   baseUrl: 'https://stellar-snaps.vercel.app'
  * });
- *
  * console.log(result.url);
- * // https://your-stellar-snaps-instance.com/s/nk1VNcxo
+ * // https://stellar-snaps.vercel.app/s/abc12345
  * ```
  */
 declare function createSnap(options: CreateSnapOptions): Promise<CreateSnapResult>;
 /**
- * Fetches an existing snap by ID from a Stellar Snaps server.
+ * Fetches a snap by ID from the Stellar Snaps server.
+ * Uses GET /api/snap/[id] (singular path, same as web app).
  *
- * @example
- * ```typescript
- * const snap = await getSnap('nk1VNcxo', {
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
- * });
- * ```
+ * @throws SnapNotFoundError if the snap does not exist
+ * @throws SnapApiError if the request fails
  */
 declare function getSnap(id: string, options?: {
-    serverUrl?: string;
-}): Promise<CreateSnapResult['snap'] | null>;
+    baseUrl?: string;
+}): Promise<Snap$1>;
 /**
- * Lists snaps created by a specific address.
- *
- * @example
- * ```typescript
- * const snaps = await listSnaps('GCREATOR...', {
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
- * });
- * ```
+ * Lists snaps created by a specific address (GET /api/snaps?creator=...).
  */
 declare function listSnaps(creator: string, options?: {
-    serverUrl?: string;
-}): Promise<CreateSnapResult['snap'][]>;
+    baseUrl?: string;
+}): Promise<Snap$1[]>;
 /**
- * Deletes a snap by ID.
+ * Deletes a snap by ID. Requires the creator's address (same as web app: DELETE /api/snaps?id=...&creator=...).
+ *
+ * @throws SnapNotFoundError if the snap does not exist
+ * @throws SnapUnauthorizedError if the creator does not own the snap
+ * @throws SnapApiError if the request fails
+ */
+declare function deleteSnap(id: string, creator: string, options?: {
+    baseUrl?: string;
+}): Promise<void>;
+
+/**
+ * Snap Modal Overlay
+ *
+ * Opens a snap URL (e.g. from createSnap) in a modal overlay so users can pay
+ * without leaving the page. Same payment UI as the web app, loaded in an iframe.
+ * Browser-only; no-op in Node.
+ */
+interface OpenSnapModalOptions {
+    /** Width of the iframe content area (default: 420) */
+    width?: number;
+    /** Height of the iframe (default: 560) */
+    height?: number;
+    /** Called when the user closes the modal */
+    onClose?: () => void;
+}
+/**
+ * Opens a snap URL in a modal overlay (iframe). Same experience as opening
+ * the link on the Stellar Snaps web app—payment form, Freighter, etc.
+ * Use the URL returned from createSnap(), e.g. result.url.
+ *
+ * Browser-only; does nothing in Node.
  *
  * @example
  * ```typescript
- * await deleteSnap('nk1VNcxo', {
- *   serverUrl: 'https://your-stellar-snaps-instance.com'
- * });
+ * const { url } = await createSnap({ ... });
+ * openSnapModal(url, { onClose: () => console.log('Closed') });
  * ```
  */
-declare function deleteSnap(id: string, options?: {
-    serverUrl?: string;
-}): Promise<void>;
+declare function openSnapModal(snapUrl: string, options?: OpenSnapModalOptions): void;
+/**
+ * Closes the snap modal if one is open. Safe to call anytime.
+ */
+declare function closeSnapModal(): void;
 
 /**
  * Snap ID Generation
@@ -1169,5 +1193,24 @@ declare class InvalidAssetError extends StellarSnapError {
 declare class InvalidUriError extends StellarSnapError {
     constructor(message: string);
 }
+/**
+ * Thrown when a snap is not found (404 from API).
+ */
+declare class SnapNotFoundError extends StellarSnapError {
+    constructor(snapId: string);
+}
+/**
+ * Thrown when the caller is not authorized to perform the action (e.g. delete another user's snap).
+ */
+declare class SnapUnauthorizedError extends StellarSnapError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the Stellar Snaps API returns an error.
+ */
+declare class SnapApiError extends StellarSnapError {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
 
-export { type ApiResponse, type BuildPaymentOptions, CACHE_HEADERS, CORS_HEADERS, type CreateDiscoveryFileOptions, type CreateSnapInput, type CreateSnapOptions, type CreateSnapResult, type DiscoveryFile, type DiscoveryRule, type DomainEntry, type DomainStatus, EXPLORER_URLS, type ExplorerType, type FreighterConnectionResult, HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, type MemoType, type MetaTags, NETWORK_PASSPHRASES, type Network, POSTGRES_SCHEMA, type ParsedSnap, type PaymentSnapOptions, type PaymentSnapResult, type RateLimitBucket, type Registry, type ResolvedUrl, SHORTENER_DOMAINS, SQLITE_SCHEMA, type Snap, type SnapMetadata, StellarSnapError, type TransactionSnapOptions, type TransactionSnapResult, type TransactionSubmitResult, type UpdateSnapInput, addDomain, buildPaymentTransaction, buildUrl, connectFreighter, createAsset, createDiscoveryFile, createPaymentSnap, createRateLimiter, createRegistry, createSnap, createSnapObject, createTransactionSnap, deleteSnap, errorResponse, extractDomain, extractPath, extractSnapId, generateJsonLd, generateMetaTags, generateSnapId, getAccountUrl, getAssetUrl, getBlockedDomains, getDomainStatus, getFreighterNetwork, getOperationUrl, getSnap, getTransactionUrl, getVerifiedDomains, isDomainBlocked, isDomainVerified, isFreighterConnected, isShortenerUrl, isValidAmount, isValidAssetCode, isValidSnapId, isValidStellarAddress, listSnaps, matchUrlToRule, metaTagsToHtml, parseAddress, parseQueryParams, parseSnapUri, removeDomain, resolveUrl, resolveUrls, signWithFreighter, submitTransaction, successResponse, validateDiscoveryFile, validateRegistry, validateRequired, validateSnapInput };
+export { type ApiResponse, type BuildPaymentOptions, CACHE_HEADERS, CORS_HEADERS, type CreateDiscoveryFileOptions, type CreateSnapInput, type CreateSnapOptions, type CreateSnapResult, type DiscoveryFile, type DiscoveryRule, type DomainEntry, type DomainStatus, EXPLORER_URLS, type ExplorerType, type FreighterConnectionResult, HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, type MemoType, type MetaTags, NETWORK_PASSPHRASES, type Network, type OpenSnapModalOptions, POSTGRES_SCHEMA, type ParsedSnap, type PaymentSnapOptions, type PaymentSnapResult, type RateLimitBucket, type Registry, type ResolvedUrl, SHORTENER_DOMAINS, SQLITE_SCHEMA, type Snap$1 as Snap, SnapApiError, type SnapMetadata, SnapNotFoundError, type Snap as SnapRecord, SnapUnauthorizedError, StellarSnapError, type TransactionSnapOptions, type TransactionSnapResult, type TransactionSubmitResult, type UpdateSnapInput, addDomain, buildPaymentTransaction, buildUrl, closeSnapModal, connectFreighter, createAsset, createDiscoveryFile, createPaymentSnap, createRateLimiter, createRegistry, createSnap, createSnapObject, createTransactionSnap, deleteSnap, errorResponse, extractDomain, extractPath, extractSnapId, generateJsonLd, generateMetaTags, generateSnapId, getAccountUrl, getAssetUrl, getBlockedDomains, getDomainStatus, getFreighterNetwork, getOperationUrl, getSnap, getTransactionUrl, getVerifiedDomains, isDomainBlocked, isDomainVerified, isFreighterConnected, isShortenerUrl, isValidAmount, isValidAssetCode, isValidSnapId, isValidStellarAddress, listSnaps, matchUrlToRule, metaTagsToHtml, openSnapModal, parseAddress, parseQueryParams, parseSnapUri, removeDomain, resolveUrl, resolveUrls, signWithFreighter, submitTransaction, successResponse, validateDiscoveryFile, validateRegistry, validateRequired, validateSnapInput };