@stellar-snaps/sdk 0.1.0 → 0.3.0

package/dist/index.mjs

@@ -1,6 +1,236 @@
 import * as StellarSdk from '@stellar/stellar-sdk';
 import { isConnected, isAllowed, getNetwork, setAllowed, getAddress, signTransaction } from '@stellar/freighter-api';
 
+// src/create-snap.ts
+async function createSnap(options) {
+  const {
+    creator,
+    title,
+    destination,
+    description,
+    amount,
+    assetCode = "XLM",
+    assetIssuer,
+    memo,
+    memoType = "MEMO_TEXT",
+    network = "testnet",
+    imageUrl,
+    serverUrl = "https://stellarsnaps.com"
+  } = options;
+  if (!creator || creator.length !== 56 || !creator.startsWith("G")) {
+    throw new Error("Invalid creator address");
+  }
+  if (!title || title.trim().length === 0) {
+    throw new Error("Title is required");
+  }
+  if (!destination || destination.length !== 56 || !destination.startsWith("G")) {
+    throw new Error("Invalid destination address");
+  }
+  if (assetCode !== "XLM" && !assetIssuer) {
+    throw new Error("Asset issuer is required for non-XLM assets");
+  }
+  const body = {
+    creator,
+    title,
+    destination,
+    description,
+    amount,
+    assetCode,
+    assetIssuer,
+    memo,
+    memoType,
+    network,
+    imageUrl
+  };
+  const response = await fetch(`${serverUrl}/api/snaps`, {
+    method: "POST",
+    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 snap = await response.json();
+  return {
+    id: snap.id,
+    url: `${serverUrl}/s/${snap.id}`,
+    snap
+  };
+}
+async function getSnap(id, options = {}) {
+  const { serverUrl = "https://stellarsnaps.com" } = options;
+  const response = await fetch(`${serverUrl}/api/snaps/${id}`);
+  if (response.status === 404) {
+    return null;
+  }
+  if (!response.ok) {
+    throw new Error(`Failed to fetch snap: ${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)}`);
+  if (!response.ok) {
+    throw new Error(`Failed to list snaps: ${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}`);
+  }
+}
+
+// src/snap-id.ts
+var ALPHABET = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+function generateSnapId(length = 8) {
+  let id = "";
+  const randomValues = new Uint8Array(length);
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(randomValues);
+  } else {
+    for (let i = 0; i < length; i++) {
+      randomValues[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  for (let i = 0; i < length; i++) {
+    id += ALPHABET[randomValues[i] % ALPHABET.length];
+  }
+  return id;
+}
+function isValidSnapId(id) {
+  if (!id || typeof id !== "string") return false;
+  if (id.length < 4 || id.length > 32) return false;
+  return /^[a-zA-Z0-9_-]+$/.test(id);
+}
+function extractSnapId(url, patterns = ["/s/", "/snap/", "/pay/"]) {
+  try {
+    const parsed = new URL(url);
+    const path = parsed.pathname;
+    for (const pattern of patterns) {
+      const index = path.indexOf(pattern);
+      if (index !== -1) {
+        const idStart = index + pattern.length;
+        const remaining = path.slice(idStart);
+        const match = remaining.match(/^([a-zA-Z0-9_-]+)/);
+        if (match && isValidSnapId(match[1])) {
+          return match[1];
+        }
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/schema.ts
+function validateSnapInput(input) {
+  if (!input.creator || input.creator.length !== 56 || !input.creator.startsWith("G")) {
+    throw new Error("Invalid creator address");
+  }
+  if (!input.destination || input.destination.length !== 56 || !input.destination.startsWith("G")) {
+    throw new Error("Invalid destination address");
+  }
+  if (!input.title || input.title.trim().length === 0) {
+    throw new Error("Title is required");
+  }
+  if (input.title.length > 100) {
+    throw new Error("Title must be 100 characters or less");
+  }
+  if (input.description && input.description.length > 500) {
+    throw new Error("Description must be 500 characters or less");
+  }
+  if (input.assetCode && input.assetCode !== "XLM" && !input.assetIssuer) {
+    throw new Error("Asset issuer is required for non-XLM assets");
+  }
+  if (input.assetIssuer && (input.assetIssuer.length !== 56 || !input.assetIssuer.startsWith("G"))) {
+    throw new Error("Invalid asset issuer address");
+  }
+  if (input.amount) {
+    const amountNum = parseFloat(input.amount);
+    if (isNaN(amountNum) || amountNum <= 0) {
+      throw new Error("Amount must be a positive number");
+    }
+  }
+  if (input.network && !["public", "testnet"].includes(input.network)) {
+    throw new Error('Network must be "public" or "testnet"');
+  }
+  if (input.memoType && !["MEMO_TEXT", "MEMO_ID", "MEMO_HASH", "MEMO_RETURN"].includes(input.memoType)) {
+    throw new Error("Invalid memo type");
+  }
+}
+function createSnapObject(id, input) {
+  validateSnapInput(input);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    id,
+    creator: input.creator,
+    title: input.title.trim(),
+    description: input.description?.trim() || null,
+    imageUrl: input.imageUrl || null,
+    destination: input.destination,
+    assetCode: input.assetCode || "XLM",
+    assetIssuer: input.assetIssuer || null,
+    amount: input.amount || null,
+    memo: input.memo || null,
+    memoType: input.memoType || "MEMO_TEXT",
+    network: input.network || "testnet",
+    createdAt: now,
+    updatedAt: now
+  };
+}
+var POSTGRES_SCHEMA = `
+CREATE TABLE IF NOT EXISTS snaps (
+  id TEXT PRIMARY KEY,
+  creator TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  image_url TEXT,
+  destination TEXT NOT NULL,
+  asset_code TEXT NOT NULL DEFAULT 'XLM',
+  asset_issuer TEXT,
+  amount TEXT,
+  memo TEXT,
+  memo_type TEXT NOT NULL DEFAULT 'MEMO_TEXT',
+  network TEXT NOT NULL DEFAULT 'testnet',
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_snaps_creator ON snaps(creator);
+CREATE INDEX IF NOT EXISTS idx_snaps_destination ON snaps(destination);
+`;
+var SQLITE_SCHEMA = `
+CREATE TABLE IF NOT EXISTS snaps (
+  id TEXT PRIMARY KEY,
+  creator TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  image_url TEXT,
+  destination TEXT NOT NULL,
+  asset_code TEXT NOT NULL DEFAULT 'XLM',
+  asset_issuer TEXT,
+  amount TEXT,
+  memo TEXT,
+  memo_type TEXT NOT NULL DEFAULT 'MEMO_TEXT',
+  network TEXT NOT NULL DEFAULT 'testnet',
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_snaps_creator ON snaps(creator);
+CREATE INDEX IF NOT EXISTS idx_snaps_destination ON snaps(destination);
+`;
+
 // src/create-payment-snap.ts
 var NETWORK_PASSPHRASES = {
   public: "Public Global Stellar Network ; September 2015",
@@ -456,6 +686,452 @@ function matchUrlToRule(pathname, rules) {
   return null;
 }
 
-export { HORIZON_URLS, InvalidAddressError, InvalidAmountError, InvalidAssetError, InvalidUriError, NETWORK_PASSPHRASES2 as NETWORK_PASSPHRASES, StellarSnapError, buildPaymentTransaction, connectFreighter, createAsset, createDiscoveryFile, createPaymentSnap, createTransactionSnap, getFreighterNetwork, isFreighterConnected, isValidAmount, isValidAssetCode, isValidStellarAddress, matchUrlToRule, parseSnapUri, signWithFreighter, submitTransaction, validateDiscoveryFile };
+// src/url-resolver.ts
+var SHORTENER_DOMAINS = [
+  "t.co",
+  "bit.ly",
+  "goo.gl",
+  "tinyurl.com",
+  "ow.ly",
+  "is.gd",
+  "buff.ly",
+  "adf.ly",
+  "bit.do",
+  "mcaf.ee",
+  "su.pr",
+  "twit.ac",
+  "tiny.cc",
+  "lnkd.in",
+  "db.tt",
+  "qr.ae",
+  "cur.lv",
+  "ity.im",
+  "q.gs",
+  "po.st",
+  "bc.vc",
+  "u.to",
+  "j.mp",
+  "buzurl.com",
+  "cutt.us",
+  "u.bb",
+  "yourls.org",
+  "x.co",
+  "prettylinkpro.com",
+  "viralurl.com",
+  "twitthis.com",
+  "shorturl.at",
+  "rb.gy",
+  "shorturl.com"
+];
+function isShortenerUrl(url) {
+  try {
+    const parsed = new URL(url);
+    const domain = parsed.hostname.toLowerCase();
+    return SHORTENER_DOMAINS.some(
+      (shortener) => domain === shortener || domain.endsWith(`.${shortener}`)
+    );
+  } catch {
+    return false;
+  }
+}
+function extractDomain(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.hostname.toLowerCase();
+  } catch {
+    return "";
+  }
+}
+function extractPath(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.pathname;
+  } catch {
+    return "";
+  }
+}
+async function resolveUrl(url) {
+  const originalUrl = url;
+  const wasShortened = isShortenerUrl(url);
+  if (!wasShortened) {
+    return {
+      url,
+      domain: extractDomain(url),
+      originalUrl,
+      wasShortened: false
+    };
+  }
+  try {
+    const response = await fetch(url, {
+      method: "HEAD",
+      redirect: "follow"
+    });
+    const finalUrl = response.url;
+    return {
+      url: finalUrl,
+      domain: extractDomain(finalUrl),
+      originalUrl,
+      wasShortened: true
+    };
+  } catch (error) {
+    return {
+      url,
+      domain: extractDomain(url),
+      originalUrl,
+      wasShortened: true
+    };
+  }
+}
+async function resolveUrls(urls) {
+  return Promise.all(urls.map(resolveUrl));
+}
+
+// src/registry.ts
+function createRegistry(domains = []) {
+  return {
+    domains,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    version: "1.0.0"
+  };
+}
+function addDomain(registry, entry) {
+  const existing = registry.domains.findIndex((d) => d.domain === entry.domain);
+  const newDomains = existing >= 0 ? registry.domains.map((d, i) => i === existing ? entry : d) : [...registry.domains, entry];
+  return {
+    ...registry,
+    domains: newDomains,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function removeDomain(registry, domain) {
+  return {
+    ...registry,
+    domains: registry.domains.filter((d) => d.domain !== domain),
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function getDomainStatus(registry, domain) {
+  const normalizedDomain = domain.toLowerCase().replace(/^www\./, "");
+  const entry = registry.domains.find(
+    (d) => d.domain.toLowerCase() === normalizedDomain
+  );
+  return entry || null;
+}
+function isDomainVerified(registry, domain) {
+  const entry = getDomainStatus(registry, domain);
+  return entry?.status === "verified";
+}
+function isDomainBlocked(registry, domain) {
+  const entry = getDomainStatus(registry, domain);
+  return entry?.status === "blocked";
+}
+function getVerifiedDomains(registry) {
+  return registry.domains.filter((d) => d.status === "verified");
+}
+function getBlockedDomains(registry) {
+  return registry.domains.filter((d) => d.status === "blocked");
+}
+function validateRegistry(registry) {
+  if (!registry || typeof registry !== "object") return false;
+  const r = registry;
+  if (!Array.isArray(r.domains)) return false;
+  if (typeof r.updatedAt !== "string") return false;
+  if (typeof r.version !== "string") return false;
+  return r.domains.every((d) => {
+    if (!d || typeof d !== "object") return false;
+    const entry = d;
+    return typeof entry.domain === "string" && ["verified", "unverified", "blocked"].includes(entry.status);
+  });
+}
+
+// src/explorer.ts
+var EXPLORER_URLS = {
+  "stellar.expert": {
+    public: "https://stellar.expert/explorer/public",
+    testnet: "https://stellar.expert/explorer/testnet"
+  },
+  stellarchain: {
+    public: "https://stellarchain.io",
+    testnet: "https://testnet.stellarchain.io"
+  },
+  horizon: {
+    public: "https://horizon.stellar.org",
+    testnet: "https://horizon-testnet.stellar.org"
+  }
+};
+function getTransactionUrl(hash, network = "testnet", explorer = "stellar.expert") {
+  const baseUrl = EXPLORER_URLS[explorer][network];
+  switch (explorer) {
+    case "stellar.expert":
+      return `${baseUrl}/tx/${hash}`;
+    case "stellarchain":
+      return `${baseUrl}/transactions/${hash}`;
+    case "horizon":
+      return `${baseUrl}/transactions/${hash}`;
+    default:
+      return `${baseUrl}/tx/${hash}`;
+  }
+}
+function getAccountUrl(address, network = "testnet", explorer = "stellar.expert") {
+  const baseUrl = EXPLORER_URLS[explorer][network];
+  switch (explorer) {
+    case "stellar.expert":
+      return `${baseUrl}/account/${address}`;
+    case "stellarchain":
+      return `${baseUrl}/accounts/${address}`;
+    case "horizon":
+      return `${baseUrl}/accounts/${address}`;
+    default:
+      return `${baseUrl}/account/${address}`;
+  }
+}
+function getAssetUrl(code, issuer, network = "testnet", explorer = "stellar.expert") {
+  const baseUrl = EXPLORER_URLS[explorer][network];
+  switch (explorer) {
+    case "stellar.expert":
+      return `${baseUrl}/asset/${code}-${issuer}`;
+    case "stellarchain":
+      return `${baseUrl}/assets/${code}:${issuer}`;
+    case "horizon":
+      return `${baseUrl}/assets?asset_code=${code}&asset_issuer=${issuer}`;
+    default:
+      return `${baseUrl}/asset/${code}-${issuer}`;
+  }
+}
+function getOperationUrl(operationId, network = "testnet", explorer = "stellar.expert") {
+  const baseUrl = EXPLORER_URLS[explorer][network];
+  switch (explorer) {
+    case "stellar.expert":
+      return `${baseUrl}/op/${operationId}`;
+    case "stellarchain":
+      return `${baseUrl}/operations/${operationId}`;
+    case "horizon":
+      return `${baseUrl}/operations/${operationId}`;
+    default:
+      return `${baseUrl}/op/${operationId}`;
+  }
+}
+
+// src/meta-tags.ts
+function generateMetaTags(metadata) {
+  const {
+    title,
+    description,
+    imageUrl,
+    amount,
+    assetCode = "XLM",
+    url,
+    siteName = "Stellar Snaps"
+  } = metadata;
+  const autoDescription = description || (amount ? `Pay ${amount} ${assetCode} - ${title}` : `Make a payment - ${title}`);
+  return {
+    og: {
+      "og:title": title,
+      "og:description": autoDescription,
+      "og:url": url,
+      "og:site_name": siteName,
+      "og:type": "website",
+      ...imageUrl && { "og:image": imageUrl }
+    },
+    twitter: {
+      "twitter:card": imageUrl ? "summary_large_image" : "summary",
+      "twitter:title": title,
+      "twitter:description": autoDescription,
+      ...imageUrl && { "twitter:image": imageUrl }
+    },
+    standard: {
+      title: `${title} | ${siteName}`,
+      description: autoDescription
+    }
+  };
+}
+function metaTagsToHtml(tags) {
+  const lines = [];
+  if (tags.standard.title) {
+    lines.push(`<title>${escapeHtml(tags.standard.title)}</title>`);
+  }
+  if (tags.standard.description) {
+    lines.push(
+      `<meta name="description" content="${escapeHtml(tags.standard.description)}" />`
+    );
+  }
+  for (const [property, content] of Object.entries(tags.og)) {
+    lines.push(
+      `<meta property="${escapeHtml(property)}" content="${escapeHtml(content)}" />`
+    );
+  }
+  for (const [name, content] of Object.entries(tags.twitter)) {
+    lines.push(
+      `<meta name="${escapeHtml(name)}" content="${escapeHtml(content)}" />`
+    );
+  }
+  return lines.join("\n");
+}
+function escapeHtml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function generateJsonLd(metadata) {
+  const { title, description, amount, assetCode = "XLM", url, imageUrl } = metadata;
+  return {
+    "@context": "https://schema.org",
+    "@type": "PaymentService",
+    name: title,
+    description: description || `Pay ${amount || "any amount"} ${assetCode}`,
+    url,
+    ...imageUrl && { image: imageUrl },
+    ...amount && {
+      offers: {
+        "@type": "Offer",
+        price: amount,
+        priceCurrency: assetCode
+      }
+    }
+  };
+}
+
+// src/server.ts
+var CORS_HEADERS = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type, Authorization",
+  "Access-Control-Max-Age": "86400"
+};
+var CACHE_HEADERS = {
+  /** No caching */
+  none: {
+    "Cache-Control": "no-store, no-cache, must-revalidate"
+  },
+  /** Short cache (1 minute) */
+  short: {
+    "Cache-Control": "public, max-age=60, stale-while-revalidate=30"
+  },
+  /** Medium cache (5 minutes) */
+  medium: {
+    "Cache-Control": "public, max-age=300, stale-while-revalidate=60"
+  },
+  /** Long cache (1 hour) */
+  long: {
+    "Cache-Control": "public, max-age=3600, stale-while-revalidate=300"
+  },
+  /** Immutable (1 year) */
+  immutable: {
+    "Cache-Control": "public, max-age=31536000, immutable"
+  }
+};
+function successResponse(data) {
+  return {
+    success: true,
+    data
+  };
+}
+function errorResponse(message, code) {
+  return {
+    success: false,
+    error: message,
+    code
+  };
+}
+function validateRequired(body, fields) {
+  for (const field of fields) {
+    if (body[field] === void 0 || body[field] === null || body[field] === "") {
+      throw new Error(`Missing required field: ${field}`);
+    }
+  }
+}
+function parseQueryParams(url) {
+  try {
+    const parsed = new URL(url);
+    const params = {};
+    parsed.searchParams.forEach((value, key) => {
+      params[key] = value;
+    });
+    return params;
+  } catch {
+    return {};
+  }
+}
+function buildUrl(base, params) {
+  const url = new URL(base);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      url.searchParams.set(key, value);
+    }
+  }
+  return url.toString();
+}
+function createRateLimiter(options) {
+  const buckets = /* @__PURE__ */ new Map();
+  return {
+    /**
+     * Checks if a key is within rate limits.
+     * Returns true if allowed, false if rate limited.
+     */
+    check(key) {
+      const now = Date.now();
+      const bucket = buckets.get(key);
+      if (bucket && bucket.resetAt <= now) {
+        buckets.delete(key);
+      }
+      const current = buckets.get(key);
+      if (!current) {
+        buckets.set(key, {
+          count: 1,
+          resetAt: now + options.windowMs
+        });
+        return true;
+      }
+      if (current.count >= options.maxRequests) {
+        return false;
+      }
+      current.count++;
+      return true;
+    },
+    /**
+     * Gets remaining requests for a key.
+     */
+    remaining(key) {
+      const bucket = buckets.get(key);
+      if (!bucket || bucket.resetAt <= Date.now()) {
+        return options.maxRequests;
+      }
+      return Math.max(0, options.maxRequests - bucket.count);
+    },
+    /**
+     * Resets the limiter for a key.
+     */
+    reset(key) {
+      buckets.delete(key);
+    },
+    /**
+     * Clears all rate limit data.
+     */
+    clear() {
+      buckets.clear();
+    }
+  };
+}
+function parseAddress(input) {
+  const trimmed = input.trim();
+  if (trimmed.includes("*")) {
+    return {
+      address: trimmed,
+      federation: trimmed
+    };
+  }
+  if (trimmed.startsWith("M") && trimmed.length === 69) {
+    return {
+      address: trimmed,
+      muxedId: trimmed
+    };
+  }
+  if (trimmed.startsWith("G") && trimmed.length === 56) {
+    return {
+      address: trimmed
+    };
+  }
+  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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map