@neus/sdk 1.1.1 → 1.1.4

package/client.js

@@ -1052,23 +1052,22 @@ export class NeusClient {
           }
         };
 
-        const isFarcasterWallet = (() => {
+        const isBaseMiniAppWallet = (() => {
           if (typeof window === 'undefined') return false;
           try {
             const w = window;
-            const fc = w.farcaster;
-            if (!fc || !fc.context) return false;
-            const fcProvider = fc.provider || fc.walletProvider || (fc.context && fc.context.walletProvider);
-            if (fcProvider === provider) return true;
-            if (w.mini && w.mini.wallet === provider && fc && fc.context) return true;
-            if (w.ethereum === provider && fc && fc.context) return true;
+            const mini = w.mini;
+            if (!mini) return false;
+            const miniProvider = mini.wallet || mini.provider;
+            if (miniProvider === provider) return true;
+            if (w.ethereum === provider && mini) return true;
           } catch {
             void 0;
           }
           return false;
         })();
 
-        if (isFarcasterWallet) {
+        if (isBaseMiniAppWallet) {
           try {
             const hexMsg = toHexUtf8(message);
             signature = await provider.request({ method: 'personal_sign', params: [hexMsg, walletAddress] });
@@ -1482,7 +1481,9 @@ export class NeusClient {
 
     const qs = [];
     if (options.limit) qs.push(`limit=${encodeURIComponent(String(options.limit))}`);
-    if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
+    const cursorRaw = options.cursor !== null && options.cursor !== undefined ? String(options.cursor).trim() : '';
+    if (cursorRaw) qs.push(`cursor=${encodeURIComponent(cursorRaw)}`);
+    else if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
     if (options.qHash) qs.push(`qHash=${encodeURIComponent(options.qHash.toLowerCase())}`);
 
     const query = qs.length ? `?${qs.join('&')}` : '';
@@ -1501,7 +1502,11 @@ export class NeusClient {
       proofs: Array.isArray(proofs) ? proofs : [],
       totalCount: response.data?.totalCount ?? proofs.length,
       hasMore: Boolean(response.data?.hasMore),
-      nextOffset: response.data?.nextOffset ?? null
+      nextOffset: response.data?.nextOffset ?? null,
+      nextCursor:
+        typeof response.data?.nextCursor === 'string' && response.data.nextCursor.trim()
+          ? response.data.nextCursor.trim()
+          : null
     };
   }
 
@@ -1566,7 +1571,9 @@ export class NeusClient {
 
     const qs = [];
     if (options.limit) qs.push(`limit=${encodeURIComponent(String(options.limit))}`);
-    if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
+    const cursorRaw = options.cursor !== null && options.cursor !== undefined ? String(options.cursor).trim() : '';
+    if (cursorRaw) qs.push(`cursor=${encodeURIComponent(cursorRaw)}`);
+    else if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
     if (options.qHash) qs.push(`qHash=${encodeURIComponent(options.qHash.toLowerCase())}`);
     const query = qs.length ? `?${qs.join('&')}` : '';
 
@@ -1587,7 +1594,11 @@ export class NeusClient {
       proofs: Array.isArray(proofs) ? proofs : [],
       totalCount: response.data?.totalCount ?? proofs.length,
       hasMore: Boolean(response.data?.hasMore),
-      nextOffset: response.data?.nextOffset ?? null
+      nextOffset: response.data?.nextOffset ?? null,
+      nextCursor:
+        typeof response.data?.nextCursor === 'string' && response.data.nextCursor.trim()
+          ? response.data.nextCursor.trim()
+          : null
     };
   }
 
@@ -1597,6 +1608,9 @@ export class NeusClient {
       throw new ValidationError('Valid address is required');
     }
 
+    const gateIdParam = typeof params.gateId === 'string' ? params.gateId.trim() : '';
+    const verifierIds = gateIdParam ? undefined : params.verifierIds;
+
     const qs = new URLSearchParams();
     qs.set('address', address);
 
@@ -1622,7 +1636,8 @@ export class NeusClient {
       setIfPresent(key, value);
     };
 
-    setCsvIfPresent('verifierIds', params.verifierIds);
+    setIfPresent('gateId', gateIdParam);
+    setCsvIfPresent('verifierIds', verifierIds);
     setBoolIfPresent('requireAll', params.requireAll);
     setIfPresent('minCount', params.minCount);
     setIfPresent('sinceDays', params.sinceDays);
@@ -1693,12 +1708,12 @@ export class NeusClient {
     }
 
     let mergedHeaders = headersOverride;
-    if (!mergedHeaders) {
+    if (!mergedHeaders && !gateIdParam) {
       try {
         const sponsorHeaders = await this._resolveSponsorGrantHeaders(
-          Array.isArray(params.verifierIds)
-            ? params.verifierIds
-            : (params.verifierIds ? [params.verifierIds] : [])
+          Array.isArray(verifierIds)
+            ? verifierIds
+            : (verifierIds ? [verifierIds] : [])
         );
         if (sponsorHeaders && Object.keys(sponsorHeaders).length > 0) {
           mergedHeaders = sponsorHeaders;

package/mcp-hosts.js

@@ -0,0 +1,121 @@
+/**
+ * MCP host install constants shared by the `neus` CLI and product UI.
+ * Browser-safe: no Node-only APIs except the Buffer fallback for non-browser tests.
+ */
+
+export const NEUS_MCP_SERVER_NAME = 'neus';
+export const NEUS_MCP_URL = 'https://mcp.neus.network/mcp';
+export const NEUS_SETUP_CLI = 'npx -y -p @neus/sdk neus setup';
+export const NEUS_AUTH_CLI = 'npx -y -p @neus/sdk neus auth';
+export const NEUS_MCP_SETUP_DOCS_URL = 'https://docs.neus.network/mcp/ide-plugin';
+
+/** CLI `neus setup --client` values. */
+export const MCP_INSTALL_CLIENTS = ['claude', 'codex', 'cursor', 'vscode'];
+
+/** Product Profile "Open in" hosts. */
+export const MCP_INSTALL_HOSTS = ['cursor', 'claude', 'codex'];
+
+export const IDE_HOST_LABELS = {
+  cursor: 'Cursor',
+  claude: 'Claude Code',
+  codex: 'Codex'
+};
+
+export const IDE_HOST_BRAND_LOGOS = {
+  cursor: '/images/brandLogos/cursor.svg',
+  claude: '/images/brandLogos/anthropic.svg',
+  codex: '/images/brandLogos/openai.svg'
+};
+
+/**
+ * @param {string | null | undefined} accessKey
+ * @returns {{ type: 'http'; url: string; headers?: { Authorization: string } }}
+ */
+export function buildNeusMcpHttpConfig(accessKey) {
+  const key = String(accessKey || '').trim();
+  return {
+    type: 'http',
+    url: NEUS_MCP_URL,
+    ...(key ? { headers: { Authorization: `Bearer ${key}` } } : {})
+  };
+}
+
+/**
+ * @param {unknown} value
+ * @returns {string}
+ */
+function encodeBase64Json(value) {
+  const json = JSON.stringify(value);
+  if (typeof globalThis.btoa === 'function') {
+    return globalThis.btoa(json);
+  }
+  return Buffer.from(json, 'utf8').toString('base64');
+}
+
+/**
+ * @param {string | null | undefined} accessKey
+ * @returns {string}
+ */
+export function buildCursorMcpInstallUrl(accessKey) {
+  const config = buildNeusMcpHttpConfig(accessKey);
+  const encoded = encodeBase64Json(config);
+  return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(NEUS_MCP_SERVER_NAME)}&config=${encodeURIComponent(encoded)}`;
+}
+
+/**
+ * @param {string | null | undefined} accessKey
+ * @returns {string}
+ */
+export function buildVsCodeMcpInstallUrl(accessKey) {
+  const payload = {
+    name: NEUS_MCP_SERVER_NAME,
+    ...buildNeusMcpHttpConfig(accessKey)
+  };
+  return `vscode:mcp/install?${encodeURIComponent(JSON.stringify(payload))}`;
+}
+
+/**
+ * @param {'claude' | 'codex' | 'cursor' | 'vscode'} client
+ * @returns {string}
+ */
+export function buildAuthCommandForClient(client) {
+  if (client === 'codex') {
+    return `${NEUS_AUTH_CLI} --client codex`;
+  }
+  return NEUS_AUTH_CLI;
+}
+
+/**
+ * @param {'claude' | 'codex' | 'cursor' | 'vscode'} client
+ * @param {string | null | undefined} accessKey
+ * @returns {string}
+ */
+export function buildSetupCommandForClient(client, accessKey) {
+  const key = String(accessKey || '').trim();
+  const setup = key
+    ? `${NEUS_SETUP_CLI} --client ${client} --access-key ${key}`
+    : `${NEUS_SETUP_CLI} --client ${client}`;
+  if (key) return setup;
+  return `${setup}\n${buildAuthCommandForClient(client)}`;
+}
+
+/**
+ * @param {'cursor' | 'claude' | 'codex'} host
+ * @param {string | null | undefined} accessKey
+ * @returns {string}
+ */
+export function buildSetupCommandForHost(host, accessKey) {
+  return buildSetupCommandForClient(host, accessKey);
+}
+
+/**
+ * Cursor supports MCP install deeplinks; Codex uses CLI, not VS Code deeplinks.
+ * @param {'cursor' | 'claude' | 'codex'} host
+ * @returns {boolean}
+ */
+export function supportsMcpInstallDeeplink(host) {
+  if (host !== 'cursor') return false;
+  if (typeof navigator === 'undefined') return false;
+  const ua = navigator.userAgent || '';
+  return !/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(ua);
+}

package/package.json

@@ -1,142 +1,147 @@
-{
-  "name": "@neus/sdk",
-  "version": "1.1.1",
-  "description": "NEUS makes trust portable across the internet — so people, apps, and AI agents can prove what is real before access, payout, or execution.",
-  "bin": {
-    "neus": "cli/neus.mjs"
-  },
-  "main": "index.js",
-  "type": "module",
-  "types": "types.d.ts",
-  "exports": {
-    ".": {
-      "types": "./types.d.ts",
-      "import": "./index.js",
-      "require": "./cjs/index.cjs"
-    },
-    "./client": {
-      "types": "./types.d.ts",
-      "import": "./client.js",
-      "require": "./cjs/client.cjs"
-    },
-    "./utils": {
-      "import": "./utils.js",
-      "require": "./cjs/utils.cjs"
-    },
-    "./errors": {
-      "import": "./errors.js",
-      "require": "./cjs/errors.cjs"
-    },
-    "./gates": {
-      "import": "./gates.js",
-      "require": "./cjs/gates.cjs"
-    },
-    "./widgets": {
-      "types": "./types.d.ts",
-      "import": "./widgets/index.js",
-      "require": "./widgets.cjs"
-    },
-    "./widgets/verify-gate": {
-      "types": "./types.d.ts",
-      "import": "./widgets/verify-gate/index.js",
-      "require": "./widgets.cjs"
-    }
-  },
-  "sideEffects": false,
-  "scripts": {
-    "test": "npm run build:cjs && vitest run",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint . --ignore-pattern widgets/verify-gate/dist/**",
-    "format": "prettier --write \"**/*.js\"",
-    "build": "npm run build:widgets && npm run build:cjs",
-    "build:widgets": "npx esbuild widgets/verify-gate/VerifyGate.jsx widgets/verify-gate/ProofBadge.jsx --bundle --platform=browser --format=esm --outdir=widgets/verify-gate/dist --jsx=automatic --legal-comments=none --loader:.svg=dataurl --external:react --external:react-dom --external:react/jsx-runtime --external:@neus/sdk/client",
-    "build:cjs": "npx esbuild index.js client.js utils.js errors.js gates.js --bundle --platform=node --format=cjs --outdir=cjs --out-extension:.js=.cjs --legal-comments=none --external:ethers --external:@zkpassport/sdk --external:react --external:react-dom --external:react/jsx-runtime",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run lint && npm test && npm run build"
-  },
-  "keywords": [
-    "neus",
-    "verification",
-    "cryptographic-proofs",
-    "identity",
-    "authentication",
-    "blockchain",
-    "cross-chain",
-    "web3",
-    "passwordless",
-    "universal-protocol",
-    "proof",
-    "ownership",
-    "sdk",
-    "mcp",
-    "model-context-protocol",
-    "oauth"
-  ],
-  "author": "NEUS Network",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/neus/network.git",
-    "directory": "sdk"
-  },
-  "bugs": {
-    "url": "https://github.com/neus/network/issues"
-  },
-  "homepage": "https://neus.network",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "peerDependencies": {
-    "ethers": "^6.0.0",
-    "react": ">=17.0.0",
-    "react-dom": ">=17.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@zkpassport/sdk": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    }
-  },
-  "optionalDependencies": {
-    "@zkpassport/sdk": "^0.14.0"
-  },
-  "dependencies": {
-    "bs58": "^6.0.0"
-  },
-  "devDependencies": {
-    "@vitest/coverage-v8": "^4.1.3",
-    "esbuild": "^0.28.0",
-    "eslint": "^8.56.0",
-    "eslint-plugin-react": "^7.37.2",
-    "prettier": "^3.2.0",
-    "vitest": "^4.1.3"
-  },
-  "files": [
-    "cli/neus.mjs",
-    "index.js",
-    "client.js",
-    "utils.js",
-    "errors.js",
-    "gates.js",
-    "sponsor.js",
-    "cjs/**",
-    "widgets.cjs",
-    "types.d.ts",
-    "README.md",
-    "SECURITY.md",
-    "LICENSE",
-    "widgets/index.js",
-    "widgets/verify-gate/index.js",
-    "widgets/verify-gate/dist/VerifyGate.js",
-    "widgets/verify-gate/dist/ProofBadge.js"
-  ]
-}
+{
+  "name": "@neus/sdk",
+  "version": "1.1.4",
+  "description": "NEUS makes trust portable across the internet — so people, apps, and AI agents can prove what is real before access, payout, or execution.",
+  "bin": {
+    "neus": "cli/neus.mjs"
+  },
+  "main": "index.js",
+  "type": "module",
+  "types": "types.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types.d.ts",
+      "import": "./index.js",
+      "require": "./cjs/index.cjs"
+    },
+    "./client": {
+      "types": "./types.d.ts",
+      "import": "./client.js",
+      "require": "./cjs/client.cjs"
+    },
+    "./utils": {
+      "import": "./utils.js",
+      "require": "./cjs/utils.cjs"
+    },
+    "./errors": {
+      "import": "./errors.js",
+      "require": "./cjs/errors.cjs"
+    },
+    "./gates": {
+      "import": "./gates.js",
+      "require": "./cjs/gates.cjs"
+    },
+    "./mcp-hosts": {
+      "import": "./mcp-hosts.js",
+      "require": "./cjs/mcp-hosts.cjs"
+    },
+    "./widgets": {
+      "types": "./types.d.ts",
+      "import": "./widgets/index.js",
+      "require": "./widgets.cjs"
+    },
+    "./widgets/verify-gate": {
+      "types": "./types.d.ts",
+      "import": "./widgets/verify-gate/index.js",
+      "require": "./widgets.cjs"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "test": "npm run build:cjs && vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . --ignore-pattern widgets/verify-gate/dist/**",
+    "format": "prettier --write \"**/*.js\"",
+    "build": "npm run build:widgets && npm run build:cjs",
+    "build:widgets": "npx esbuild widgets/verify-gate/VerifyGate.jsx widgets/verify-gate/ProofBadge.jsx --bundle --platform=browser --format=esm --outdir=widgets/verify-gate/dist --jsx=automatic --legal-comments=none --external:react --external:react-dom --external:react/jsx-runtime --external:@neus/sdk/client",
+    "build:cjs": "npx esbuild index.js client.js utils.js errors.js gates.js mcp-hosts.js --bundle --platform=node --format=cjs --outdir=cjs --out-extension:.js=.cjs --legal-comments=none --external:ethers --external:@zkpassport/sdk --external:react --external:react-dom --external:react/jsx-runtime",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run lint && npm test && npm run build"
+  },
+  "keywords": [
+    "neus",
+    "verification",
+    "cryptographic-proofs",
+    "identity",
+    "authentication",
+    "blockchain",
+    "cross-chain",
+    "web3",
+    "passwordless",
+    "universal-protocol",
+    "proof",
+    "ownership",
+    "sdk",
+    "mcp",
+    "model-context-protocol",
+    "oauth"
+  ],
+  "author": "NEUS Network",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neus/network.git",
+    "directory": "sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/neus/network/issues"
+  },
+  "homepage": "https://neus.network",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0",
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@zkpassport/sdk": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@zkpassport/sdk": "^0.14.0"
+  },
+  "dependencies": {
+    "bs58": "^6.0.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.3",
+    "esbuild": "^0.28.0",
+    "eslint": "^8.56.0",
+    "eslint-plugin-react": "^7.37.2",
+    "prettier": "^3.2.0",
+    "vitest": "^4.1.3"
+  },
+  "files": [
+    "cli/neus.mjs",
+    "mcp-hosts.js",
+    "index.js",
+    "client.js",
+    "utils.js",
+    "errors.js",
+    "gates.js",
+    "sponsor.js",
+    "cjs/**",
+    "widgets.cjs",
+    "types.d.ts",
+    "README.md",
+    "SECURITY.md",
+    "LICENSE",
+    "widgets/index.js",
+    "widgets/verify-gate/index.js",
+    "widgets/verify-gate/dist/VerifyGate.js",
+    "widgets/verify-gate/dist/ProofBadge.js"
+  ]
+}

package/types.d.ts

@@ -1,4 +1,4 @@
-declare module '@neus/sdk' {
+declare module '@neus/sdk' {
   export interface Eip1193Provider {
     request(args: { method: string; params?: unknown[] | Record<string, unknown> }): Promise<unknown>;
   }
@@ -57,18 +57,18 @@ declare module '@neus/sdk' {
 
   export interface NeusClientConfig {
     apiUrl?: string;
-    /** Optional server profile key — MCP/CI only; not required for VerifyGate or gateCheck. */
+    /** Optional server profile key; MCP/CI only. Not required for VerifyGate or gateCheck. */
     apiKey?: string;
     /** Public app attribution id (non-secret). */
     appId?: string;
-    /** Hub wallet that pays for user verification checks (your NEUS account). */
+    /** Advanced server/app sponsor wallet. Published gate checkout resolves billing from gateId. */
     billingWallet?: string;
     /** Alias for billingWallet. */
     sponsorOrgWallet?: string;
     orgWallet?: string;
     /** Site origin used when issuing billing authorization (defaults to browser origin). */
     appOrigin?: string;
-    /** @deprecated Advanced server path only — use appId + billingWallet for the default app flow. */
+    /** Advanced server path only; not required for published gate checkout. */
     appLinkQHash?: string;
     paymentSignature?: string;
     extraHeaders?: Record<string, string>;
@@ -479,6 +479,7 @@ declare module '@neus/sdk' {
   export interface GetProofsOptions {
     limit?: number;
     offset?: number;
+    cursor?: string;
     chain?: string;
     signatureMethod?: string;
   }
@@ -489,6 +490,8 @@ declare module '@neus/sdk' {
     totalCount: number;
     hasMore: boolean;
     nextOffset?: number | null;
+    /** Keyset continuation when the API returns cursor paging (preferred over deep offsets). */
+    nextCursor?: string | null;
   }
 
   export interface GateRequirement {
@@ -514,6 +517,8 @@ declare module '@neus/sdk' {
 
   export interface GateCheckApiParams {
     address: string;
+    /** Published gate handle; resolves checks server-side (preferred public path). */
+    gateId?: string;
     verifierIds?: string[] | string;
     requireAll?: boolean;
     minCount?: number;
@@ -879,6 +884,8 @@ declare module '@neus/sdk' {
 
 declare module '@neus/sdk/widgets' {
   export interface VerifyGateProps {
+    /** Published gate checkout handle (default integration path). */
+    gateId?: string;
     requiredVerifiers?: string[];
     onVerified?: (result: {
       qHash: string;
@@ -910,12 +917,8 @@ declare module '@neus/sdk/widgets' {
     oauthProvider?: string;
     style?: Record<string, any>;
     children?: any;
-    verifierOptions?: Record<string, any>;
-    verifierData?: Record<string, any>;
-    proofOptions?: Record<string, any>;
     strategy?: 'reuse-or-create' | 'reuse' | 'fresh';
     checkExisting?: boolean;
-    maxProofAgeMs?: number;
     allowPrivateReuse?: boolean;
     showBrand?: boolean;
     disabled?: boolean;
@@ -996,3 +999,31 @@ declare module '@neus/sdk/widgets/verify-gate' {
 declare module '@neus/sdk/client' {
   export { NeusClient } from '@neus/sdk';
 }
+
+declare module '@neus/sdk/mcp-hosts' {
+  export type McpInstallClient = 'claude' | 'codex' | 'cursor' | 'vscode';
+  export type McpInstallHost = 'cursor' | 'claude' | 'codex';
+
+  export const NEUS_MCP_SERVER_NAME: string;
+  export const NEUS_MCP_URL: string;
+  export const NEUS_SETUP_CLI: string;
+  export const NEUS_AUTH_CLI: string;
+  export const NEUS_MCP_SETUP_DOCS_URL: string;
+  export const MCP_INSTALL_CLIENTS: McpInstallClient[];
+  export const MCP_INSTALL_HOSTS: McpInstallHost[];
+  export const IDE_HOST_LABELS: Record<McpInstallHost, string>;
+  export const IDE_HOST_BRAND_LOGOS: Record<McpInstallHost, string>;
+
+  export function buildNeusMcpHttpConfig(accessKey?: string | null): {
+    type: 'http';
+    url: string;
+    headers?: { Authorization: string };
+  };
+
+  export function buildCursorMcpInstallUrl(accessKey?: string | null): string;
+  export function buildVsCodeMcpInstallUrl(accessKey?: string | null): string;
+  export function buildAuthCommandForClient(client: McpInstallClient): string;
+  export function buildSetupCommandForClient(client: McpInstallClient, accessKey?: string | null): string;
+  export function buildSetupCommandForHost(host: McpInstallHost, accessKey?: string | null): string;
+  export function supportsMcpInstallDeeplink(host: McpInstallHost): boolean;
+}