@nibgate/sdk 0.2.5 → 0.2.7

package/SKILL.md

@@ -44,35 +44,30 @@ If the widget loads after app code, the SDK queues events and flushes them when
 
 ---
 
-## 2. Resource Shape
+## 2. Resource Shape (Minimal)
 
-Define one stable resource per paid route, CMS row, media item, file, or API product:
+The SDK auto-derives most fields from meta tags and defaults. You only need:
 
 ```ts
 const resource = {
   id: post.id,
-  title: post.title,
-  description: post.excerpt,
-  type: 'article',
-  price: '0.01',
-  currency: 'USDC',
-  recipient: post.creatorWallet,
+  title: post.title,       // auto-fallsback to og:title → document.title
   path: `/posts/${post.slug}`,
-  url: `https://creator.example/posts/${post.slug}`,
-  tags: ['essay', 'research'],
-  access: { humans: 'paid', agents: 'paid' },
-  unlock: { mode: 'one_time' }
+  price: '0.01'            // sets access: { humans: 'paid', agents: 'paid' } automatically
 }
 ```
 
-Allowed types: `article`, `image`, `music`, `video` (aliases like `audio→music`, `photo→image` are normalized). Use stable IDs — changing IDs breaks continuity for Explore, receipts, and reputation.
-
-**Auto-derived fields:** When running in a browser, the SDK auto-fills:
-- `url` from `window.location.origin + path` if `path` is provided but `url` is not
-- `imageUrl` from `<meta property="og:image">` if not explicitly set
-- `recipient` is **not required client-side** — the server's 402 payment challenge provides the canonical wallet address. Missing it generates a warning, not an error.
+The rest fills in automatically from your page's HTML:
+- `url` from `window.location.origin + path`
+- `type` from `<meta property="og:type">` (defaults to `article`)
+- `imageUrl` from `<meta property="og:image">`
+- `description` from `<meta property="og:description">` → `<meta name="description">`
+- `tags` from `<meta name="keywords">`
+- `currency` defaults to `USDC`
+- `access` defaults to `paid` when `price > 0`, otherwise `free`
+- `recipient` is optional (server's 402 challenge provides the real wallet)
 
-So a minimal client-side resource only needs `id`, `title`, `path`, and `price` — the rest is filled in automatically.
+Allowed types: `article`, `image`, `music`, `video` (aliases like `audio→music`, `photo→image` are normalized). Use stable IDs — changing IDs breaks continuity for Explore, receipts, and reputation.
 
 **Important:** The `image`, `description`, and `title` fields become the public thumbnail and card copy on the Explore page. Use a teaser preview, not the actual paid file.
 

package/dist/nibgate.js

@@ -38,6 +38,27 @@ var Nibgate = (() => {
   __export(gateway_exports, {
     createCircleGatewayBrowserAdapter: () => createCircleGatewayBrowserAdapter
   });
+  async function getCircleClient(options = {}) {
+    if (cachedCircleModule) return cachedCircleModule;
+    if (options.clientModule) {
+      cachedCircleModule = options.clientModule;
+      return cachedCircleModule;
+    }
+    const moduleUrl = options.clientModuleUrl || "@circle-fin/x402-batching/client";
+    try {
+      cachedCircleModule = await import(moduleUrl);
+      return cachedCircleModule;
+    } catch (error) {
+      if (!options.clientModuleUrl) {
+        throw new Error(
+          `Could not load @circle-fin/x402-batching/client from node_modules. Provide a clientModuleUrl option (e.g. "https://esm.sh/@circle-fin/x402-batching@3.2.0/client?bundle") to load from CDN. Original error: ${error.message}`
+        );
+      }
+      throw new Error(
+        `Could not load Circle Gateway client from CDN: ${error.message}. Check that ${options.clientModuleUrl} is reachable.`
+      );
+    }
+  }
   function encodeBase64(value) {
     const text = typeof value === "string" ? value : stringifyJson(value);
     if (typeof Buffer !== "undefined") return Buffer.from(text).toString("base64");
@@ -52,7 +73,7 @@ var Nibgate = (() => {
     if (!signer?.address || typeof signer.signTypedData !== "function") {
       throw new Error("Circle Gateway browser adapter requires an EVM signer with address and signTypedData.");
     }
-    const circleClientModule = options.clientModule || (options.clientModuleUrl ? await runtimeImport(options.clientModuleUrl) : await runtimeImport("@circle-fin/x402-batching/client"));
+    const circleClientModule = await getCircleClient(options);
     const { BatchEvmScheme } = circleClientModule;
     const scheme = new BatchEvmScheme(signer);
     const network = options.network || options.chainId && `eip155:${options.chainId}` || "eip155:5042002";
@@ -110,11 +131,11 @@ var Nibgate = (() => {
       }
     };
   }
-  var runtimeImport;
+  var cachedCircleModule;
   var init_gateway = __esm({
     "src/browser/gateway.js"() {
       init_json();
-      runtimeImport = new Function("specifier", "return import(specifier)");
+      cachedCircleModule = null;
     }
   });
 
@@ -233,6 +254,33 @@ var Nibgate = (() => {
   function autoDeriveImage() {
     return metaContent("og:image") || void 0;
   }
+  function autoDeriveDescription() {
+    return metaContent("og:description") || metaContent("description") || void 0;
+  }
+  function autoDeriveTitle() {
+    const win = browserEnv();
+    return metaContent("og:title") || metaContent("twitter:title") || (win ? win.document.title : "") || void 0;
+  }
+  function autoDeriveType() {
+    const ogType = metaContent("og:type").toLowerCase();
+    if (ogType.includes("music") || ogType.includes("audio") || ogType.includes("song")) return "music";
+    if (ogType.includes("video") || ogType.includes("movie")) return "video";
+    if (ogType.includes("image") || ogType.includes("photo")) return "image";
+    return "article";
+  }
+  function autoDeriveTags() {
+    const kw = metaContent("keywords");
+    if (!kw) return void 0;
+    return kw.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean).slice(0, 8);
+  }
+  function accessForPrice(price, explicitAccess) {
+    if (explicitAccess && typeof explicitAccess === "object" && Object.keys(explicitAccess).length > 0) {
+      return normalizeAccessPolicy(explicitAccess);
+    }
+    const hasPrice = price !== void 0 && price !== null && price !== "" && Number.parseFloat(price) > 0;
+    if (hasPrice) return { humans: "paid", agents: "paid" };
+    return { humans: "free", agents: "free" };
+  }
   function normalizeResource(resource = {}) {
     const input = typeof resource === "string" ? { id: resource } : resource || {};
     const {
@@ -249,20 +297,24 @@ var Nibgate = (() => {
     } = input;
     const path = input.path || input.route || void 0;
     const url = input.url || autoDeriveUrl(path) || void 0;
+    const explicitAccess = input.access;
+    const price = input.price ?? input.amount ?? "";
     return {
       ...v1Input,
       id: String(input.id || input.contentId || input.slug || "").trim(),
-      title: String(input.title || input.name || "").trim(),
-      type: normalizeContentType(input.type || input.contentType),
-      price: input.price ?? input.amount ?? "",
+      title: String(input.title || input.name || autoDeriveTitle() || "Untitled").trim(),
+      type: normalizeContentType(input.type || input.contentType || autoDeriveType()),
+      price,
+      currency: input.currency || "USDC",
       paymentRail: normalizePaymentRail(input.paymentRail || input.paymentMode || input.rail),
       recipient: input.recipient || input.receiver || input.receiverAddress || input.payTo || input.creatorWallet || void 0,
       payTo: input.payTo || input.recipient || input.receiver || input.receiverAddress || input.creatorWallet || void 0,
       path,
       url,
       imageUrl: input.imageUrl || input.image || autoDeriveImage() || void 0,
-      tags: input.tags || void 0,
-      access: normalizeAccessPolicy(input.access),
+      description: input.description || input.summary || autoDeriveDescription() || void 0,
+      tags: input.tags || autoDeriveTags() || void 0,
+      access: accessForPrice(price, explicitAccess),
       unlock: normalizeUnlockPolicy(input.unlock),
       ratingsEnabled: input.ratingsEnabled ?? input.enableRatings ?? input.reputation?.ratingsEnabled ?? true,
       reputation: {
@@ -283,8 +335,8 @@ var Nibgate = (() => {
     const normalized = normalizeResource(resource);
     const warnings = [];
     const errors = [];
-    const required = options.required || ["id", "title", "url", "type"];
-    const recommended = options.recommended || ["description", "imageUrl", "tags"];
+    const required = options.required || ["id", "type"];
+    const recommended = options.recommended || ["title", "url", "description", "imageUrl", "tags"];
     for (const field of required) {
       if (!hasValue(normalized[field])) errors.push(`Missing required content metadata: ${field}`);
     }
@@ -751,6 +803,7 @@ var Nibgate = (() => {
     const gateway = await Promise.resolve().then(() => (init_gateway(), gateway_exports));
     return gateway.createCircleGatewayBrowserAdapter(options);
   }
+  var DEFAULT_CIRCLE_CDN = "https://esm.sh/@circle-fin/x402-batching@3.2.0/client?bundle";
   function createEvmGatewayUnlock(resource, options = {}) {
     const item = createGate(resource, options.gateOptions || {});
     const win = browserWindow();
@@ -845,7 +898,7 @@ var Nibgate = (() => {
           signTypedData: (typedData) => evm.request({ method: "eth_signTypedData_v4", params: [walletAddress, stringifyJson(typedData)] })
         },
         clientModule: options.circleClientModule,
-        clientModuleUrl: options.circleClientModuleUrl
+        clientModuleUrl: options.circleClientModuleUrl || DEFAULT_CIRCLE_CDN
       });
       return gatewayWallet.pay(input);
     }