@stellar-snaps/sdk 0.3.0 → 0.3.1

package/dist/index.mjs

@@ -1,8 +1,62 @@
 import * as StellarSdk from '@stellar/stellar-sdk';
 import { isConnected, isAllowed, getNetwork, setAllowed, getAddress, signTransaction } from '@stellar/freighter-api';
 
+// src/errors.ts
+var StellarSnapError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "StellarSnapError";
+  }
+};
+var InvalidAddressError = class extends StellarSnapError {
+  constructor(address) {
+    super(`Invalid Stellar address: ${address}`, "INVALID_ADDRESS");
+    this.name = "InvalidAddressError";
+  }
+};
+var InvalidAmountError = class extends StellarSnapError {
+  constructor(amount) {
+    super(`Invalid amount: ${amount}. Must be a positive number.`, "INVALID_AMOUNT");
+    this.name = "InvalidAmountError";
+  }
+};
+var InvalidAssetError = class extends StellarSnapError {
+  constructor(message) {
+    super(message, "INVALID_ASSET");
+    this.name = "InvalidAssetError";
+  }
+};
+var InvalidUriError = class extends StellarSnapError {
+  constructor(message) {
+    super(message, "INVALID_URI");
+    this.name = "InvalidUriError";
+  }
+};
+var SnapNotFoundError = class extends StellarSnapError {
+  constructor(snapId) {
+    super(`Snap not found: ${snapId}`, "SNAP_NOT_FOUND");
+    this.name = "SnapNotFoundError";
+  }
+};
+var SnapUnauthorizedError = class extends StellarSnapError {
+  constructor(message = "Unauthorized") {
+    super(message, "SNAP_UNAUTHORIZED");
+    this.name = "SnapUnauthorizedError";
+  }
+};
+var SnapApiError = class extends StellarSnapError {
+  constructor(message, statusCode) {
+    super(message, "SNAP_API_ERROR");
+    this.statusCode = statusCode;
+    this.name = "SnapApiError";
+  }
+};
+
 // src/create-snap.ts
+var DEFAULT_BASE_URL = "https://stellar-snaps.vercel.app";
 async function createSnap(options) {
+  const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
   const {
     creator,
     title,
@@ -14,20 +68,19 @@ async function createSnap(options) {
     memo,
     memoType = "MEMO_TEXT",
     network = "testnet",
-    imageUrl,
-    serverUrl = "https://stellarsnaps.com"
+    imageUrl
   } = options;
   if (!creator || creator.length !== 56 || !creator.startsWith("G")) {
-    throw new Error("Invalid creator address");
+    throw new InvalidAddressError(creator || "");
   }
   if (!title || title.trim().length === 0) {
-    throw new Error("Title is required");
+    throw new SnapApiError("Title is required");
   }
   if (!destination || destination.length !== 56 || !destination.startsWith("G")) {
-    throw new Error("Invalid destination address");
+    throw new InvalidAddressError(destination || "");
   }
   if (assetCode !== "XLM" && !assetIssuer) {
-    throw new Error("Asset issuer is required for non-XLM assets");
+    throw new SnapApiError("Asset issuer is required for non-XLM assets");
   }
   const body = {
     creator,
@@ -42,50 +95,62 @@ async function createSnap(options) {
     network,
     imageUrl
   };
-  const response = await fetch(`${serverUrl}/api/snaps`, {
+  const response = await fetch(`${baseUrl}/api/snaps`, {
     method: "POST",
-    headers: {
-      "Content-Type": "application/json"
-    },
+    headers: { "Content-Type": "application/json" },
     body: JSON.stringify(body)
   });
   if (!response.ok) {
-    const error = await response.json().catch(() => ({ error: "Unknown error" }));
-    throw new Error(error.error || `Failed to create snap: ${response.status}`);
+    const data = await response.json().catch(() => ({ error: "Unknown error" }));
+    const message = data.error || `Failed to create snap: ${response.status}`;
+    throw new SnapApiError(message, response.status);
   }
   const snap = await response.json();
   return {
     id: snap.id,
-    url: `${serverUrl}/s/${snap.id}`,
+    url: `${baseUrl}/s/${snap.id}`,
     snap
   };
 }
 async function getSnap(id, options = {}) {
-  const { serverUrl = "https://stellarsnaps.com" } = options;
-  const response = await fetch(`${serverUrl}/api/snaps/${id}`);
+  const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+  const response = await fetch(`${baseUrl}/api/snap/${id}`);
   if (response.status === 404) {
-    return null;
+    throw new SnapNotFoundError(id);
   }
   if (!response.ok) {
-    throw new Error(`Failed to fetch snap: ${response.status}`);
+    const data = await response.json().catch(() => ({}));
+    const message = data.error || `Failed to fetch snap: ${response.status}`;
+    throw new SnapApiError(message, response.status);
   }
   return response.json();
 }
 async function listSnaps(creator, options = {}) {
-  const { serverUrl = "https://stellarsnaps.com" } = options;
-  const response = await fetch(`${serverUrl}/api/snaps?creator=${encodeURIComponent(creator)}`);
+  const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+  const response = await fetch(
+    `${baseUrl}/api/snaps?creator=${encodeURIComponent(creator)}`
+  );
   if (!response.ok) {
-    throw new Error(`Failed to list snaps: ${response.status}`);
+    const data = await response.json().catch(() => ({}));
+    const message = data.error || `Failed to list snaps: ${response.status}`;
+    throw new SnapApiError(message, response.status);
   }
   return response.json();
 }
-async function deleteSnap(id, options = {}) {
-  const { serverUrl = "https://stellarsnaps.com" } = options;
-  const response = await fetch(`${serverUrl}/api/snaps/${id}`, {
-    method: "DELETE"
-  });
-  if (!response.ok && response.status !== 404) {
-    throw new Error(`Failed to delete snap: ${response.status}`);
+async function deleteSnap(id, creator, options = {}) {
+  const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+  const url = `${baseUrl}/api/snaps?id=${encodeURIComponent(id)}&creator=${encodeURIComponent(creator)}`;
+  const response = await fetch(url, { method: "DELETE" });
+  if (response.status === 404) {
+    throw new SnapNotFoundError(id);
+  }
+  if (response.status === 403) {
+    throw new SnapUnauthorizedError("You do not have permission to delete this snap");
+  }
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    const message = data.error || `Failed to delete snap: ${response.status}`;
+    throw new SnapApiError(message, response.status);
   }
 }
 
@@ -295,39 +360,6 @@ var HORIZON_URLS = {
   testnet: "https://horizon-testnet.stellar.org"
 };
 
-// src/errors.ts
-var StellarSnapError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "StellarSnapError";
-  }
-};
-var InvalidAddressError = class extends StellarSnapError {
-  constructor(address) {
-    super(`Invalid Stellar address: ${address}`, "INVALID_ADDRESS");
-    this.name = "InvalidAddressError";
-  }
-};
-var InvalidAmountError = class extends StellarSnapError {
-  constructor(amount) {
-    super(`Invalid amount: ${amount}. Must be a positive number.`, "INVALID_AMOUNT");
-    this.name = "InvalidAmountError";
-  }
-};
-var InvalidAssetError = class extends StellarSnapError {
-  constructor(message) {
-    super(message, "INVALID_ASSET");
-    this.name = "InvalidAssetError";
-  }
-};
-var InvalidUriError = class extends StellarSnapError {
-  constructor(message) {
-    super(message, "INVALID_URI");
-    this.name = "InvalidUriError";
-  }
-};
-
 // src/create-transaction-snap.ts
 function createTransactionSnap(options) {
   const { xdr, network = "public", message, callback, pubkey } = options;
@@ -1132,6 +1164,6 @@ function parseAddress(input) {
   throw new Error("Invalid address format");
 }
 
-export { CACHE_HEADERS, CORS_HEADERS, EXPLORER_URLS, HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, NETWORK_PASSPHRASES2 as NETWORK_PASSPHRASES, POSTGRES_SCHEMA, SHORTENER_DOMAINS, SQLITE_SCHEMA, StellarSnapError, 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 { CACHE_HEADERS, CORS_HEADERS, EXPLORER_URLS, HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, NETWORK_PASSPHRASES2 as NETWORK_PASSPHRASES, POSTGRES_SCHEMA, SHORTENER_DOMAINS, SQLITE_SCHEMA, SnapApiError, SnapNotFoundError, SnapUnauthorizedError, StellarSnapError, 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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map