@nibgate/sdk 0.2.6 → 0.2.8

package/src/browser/evm-gateway.js

@@ -11,10 +11,18 @@ export async function createCircleGatewayBrowserAdapter(options = {}) {
   return gateway.createCircleGatewayBrowserAdapter(options);
 }
 
+const DEFAULT_CIRCLE_CDN = 'https://esm.sh/@circle-fin/x402-batching@3.2.0/client?bundle';
+const HOSTED_PAY_URL = 'https://api.nibgate.xyz/api/hub/pay';
+
+function resolveAccessPath(resource, options) {
+  if (options.hosted || options.accessPath === 'hosted') return HOSTED_PAY_URL;
+  return options.accessPath || resource.accessPath || '/api/nibgate/access';
+}
+
 export function createEvmGatewayUnlock(resource, options = {}) {
   const item = createGate(resource, options.gateOptions || {});
   const win = browserWindow();
-  const accessPath = options.accessPath || item.resource.accessPath || '/api/nibgate/access';
+  const accessPath = resolveAccessPath(item.resource, options);
   const source = options.source || 'nibgate-evm-gateway';
   const network = options.network || 'eip155:5042002';
   const statusTarget = typeof options.status === 'string' ? win?.document.querySelector(options.status) : options.status;
@@ -114,7 +122,7 @@ export function createEvmGatewayUnlock(resource, options = {}) {
         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);
   }
@@ -178,3 +186,12 @@ export function createEvmGatewayUnlock(resource, options = {}) {
   if (options.autoMount !== false) mount();
   return controller;
 }
+
+export function createHostedUnlock(resource, options = {}) {
+  return createEvmGatewayUnlock(resource, {
+    ...options,
+    hosted: true,
+    circleClientModuleUrl: options.circleClientModuleUrl || DEFAULT_CIRCLE_CDN,
+    noWalletMessage: options.noWalletMessage || 'Install MetaMask or another EVM wallet to unlock premium content.',
+  });
+}

package/src/browser/gateway.js

@@ -1,6 +1,34 @@
 import { stringifyJson } from './json.js';
 
-const runtimeImport = new Function('specifier', 'return import(specifier)');
+let cachedCircleModule = null;
+
+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);
@@ -19,9 +47,7 @@ export async function createCircleGatewayBrowserAdapter(options = {}) {
     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';

package/src/browser/index.js

@@ -2,7 +2,7 @@ export { createGate } from './gate.js';
 export { checkResourceAccess, payWithPaymentSignature, payAndUnlockResource } from './access.js';
 export { createWalletCheckout } from './checkout.js';
 export { createNibgate, nibgate } from './client.js';
-export { createEvmGatewayUnlock, createCircleGatewayBrowserAdapter } from './evm-gateway.js';
+export { createEvmGatewayUnlock, createHostedUnlock, createCircleGatewayBrowserAdapter } from './evm-gateway.js';
 export { rateResource, createOnchainRating, mountRatingUI } from './rating-ui.js';
 export { trackResourcePage, setupResourcePage } from './track.js';
 export { createTransferCheckout, payWithTransfer } from './transfer.js';

package/src/core/resource.js

@@ -161,7 +161,7 @@ export function validateResourceMetadata(resource = {}, options = {}) {
   const normalized = normalizeResource(resource);
   const warnings = [];
   const errors = [];
-  const required = options.required || ['id'];
+  const required = options.required || ['id', 'type'];
   const recommended = options.recommended || ['title', 'url', 'description', 'imageUrl', 'tags'];
 
   for (const field of required) {

package/src/index.d.ts

@@ -112,6 +112,7 @@ export type NibgateClient = {
   createTransferCheckout(resource: NibgateResource | string, options: NibgateTransferCheckoutOptions): NibgateTransferCheckout;
   payWithTransfer(resource: NibgateResource | string, options: NibgateTransferCheckoutOptions & NibgateAccessCheckOptions): Promise<NibgateAccessCheckResult>;
   createEvmGatewayUnlock(resource: NibgateResource | string, options?: NibgateEvmGatewayUnlockOptions): NibgateEvmGatewayUnlockController;
+  createHostedUnlock(resource: NibgateResource | string, options?: NibgateEvmGatewayUnlockOptions): NibgateEvmGatewayUnlockController;
   rateContentOnchain(resource: NibgateResource | string, options: NibgateOnchainRatingOptions): Promise<NibgateOnchainRatingResult>;
   createOnchainRating(resource: NibgateResource | string, options?: NibgateOnchainRatingUiOptions): NibgateOnchainRatingController;
   mountRatingUI(resource: NibgateResource | string, options?: NibgateRatingUiOptions): NibgateRatingUiController | null;
@@ -227,6 +228,7 @@ export type NibgateCircleGatewayBrowserAdapter = {
 
 export type NibgateEvmGatewayUnlockOptions = {
   source?: string;
+  hosted?: boolean;
   accessPath?: string;
   network?: string;
   paymentProvider?: string;
@@ -414,6 +416,7 @@ export declare function payWithPaymentSignature(resource: NibgateResource | stri
 export declare function createWalletCheckout(resource: NibgateResource | string, options: NibgateWalletCheckoutOptions): NibgateWalletCheckoutController;
 export declare function createCircleGatewayBrowserAdapter(options: NibgateCircleGatewayBrowserAdapterOptions): Promise<NibgateCircleGatewayBrowserAdapter>;
 export declare function createEvmGatewayUnlock(resource: NibgateResource | string, options?: NibgateEvmGatewayUnlockOptions): NibgateEvmGatewayUnlockController;
+export declare function createHostedUnlock(resource: NibgateResource | string, options?: NibgateEvmGatewayUnlockOptions): NibgateEvmGatewayUnlockController;
 export declare function payAndUnlockResource(resource: NibgateResource | string, options?: NibgatePaymentOptions): Promise<NibgatePaymentResult>;
 export declare function setupResourcePage(resource: NibgateResource | string, options?: NibgatePageSetupOptions): NibgateGate;
 export declare function rateResource(resource: NibgateResource | string, rating?: NibgateRating | number, extra?: Record<string, unknown>): boolean;