@neus/sdk 1.1.0 → 1.1.2

package/client.js

@@ -1,4 +1,5 @@
 import { ApiError, ValidationError, NetworkError, ConfigurationError } from './errors.js';
+import { fetchSponsorGrant } from './sponsor.js';
 import {
   PORTABLE_PROOF_SIGNER_HEADER,
   constructVerificationMessage,
@@ -396,6 +397,77 @@ export class NeusClient {
     } catch {
       void 0;
     }
+
+    /** @type {{ token: string, expMs: number, key: string } | null} */
+    this._sponsorGrantCache = null;
+  }
+
+  _getBillingWallet() {
+    const raw =
+      this.config.billingWallet ||
+      this.config.sponsorOrgWallet ||
+      this.config.orgWallet ||
+      null;
+    if (typeof raw !== 'string') return null;
+    const trimmed = raw.trim().toLowerCase();
+    return /^0x[a-f0-9]{40}$/.test(trimmed) ? trimmed : null;
+  }
+
+  _resolveIntegratorOrigin() {
+    if (typeof this.config.appOrigin === 'string' && this.config.appOrigin.trim()) {
+      return this.config.appOrigin.trim();
+    }
+    try {
+      if (typeof window !== 'undefined' && window.location?.origin) {
+        return window.location.origin;
+      }
+    } catch {
+      void 0;
+    }
+    return null;
+  }
+
+  async _resolveSponsorGrantHeaders(verifierIds = []) {
+    const appId = typeof this.config.appId === 'string' ? this.config.appId.trim() : '';
+    const orgWallet = this._getBillingWallet();
+    if (!appId || !orgWallet) {
+      return {};
+    }
+
+    const normalizedVerifierIds = Array.isArray(verifierIds)
+      ? verifierIds.map((v) => String(v || '').trim()).filter(Boolean).slice(0, 25)
+      : [];
+    const cacheKey = `${appId}:${orgWallet}:${normalizedVerifierIds.join(',')}`;
+    const now = Date.now();
+    if (
+      this._sponsorGrantCache &&
+      this._sponsorGrantCache.key === cacheKey &&
+      this._sponsorGrantCache.expMs > now + 30_000
+    ) {
+      return { 'X-Sponsor-Grant': this._sponsorGrantCache.token };
+    }
+
+    const origin = this._resolveIntegratorOrigin();
+    const grant = await fetchSponsorGrant({
+      apiUrl: this.baseUrl,
+      appId,
+      orgWallet,
+      verifierIds: normalizedVerifierIds,
+      origin
+    });
+
+    const expSeconds = Number(grant?.exp);
+    const expMs = Number.isFinite(expSeconds) && expSeconds > 0
+      ? expSeconds * 1000
+      : now + 15 * 60 * 1000;
+
+    this._sponsorGrantCache = {
+      key: cacheKey,
+      token: grant.sponsorGrant,
+      expMs
+    };
+
+    return { 'X-Sponsor-Grant': grant.sponsorGrant };
   }
 
   _getHubChainId() {
@@ -980,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] });
@@ -1147,7 +1218,8 @@ export class NeusClient {
       options: optionsPayload
     };
 
-    const response = await this._makeRequest('POST', '/api/v1/verification', requestData);
+    const sponsorHeaders = await this._resolveSponsorGrantHeaders(normalizedVerifierIds);
+    const response = await this._makeRequest('POST', '/api/v1/verification', requestData, sponsorHeaders);
 
     if (!response.success) {
       throw new ApiError(`Verification failed: ${response.error?.message || 'Unknown error'}`, response.error);
@@ -1409,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('&')}` : '';
@@ -1428,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
     };
   }
 
@@ -1493,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('&')}` : '';
 
@@ -1514,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
     };
   }
 
@@ -1524,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);
 
@@ -1549,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);
@@ -1619,7 +1707,23 @@ export class NeusClient {
       }
     }
 
-    const response = await this._makeRequest('GET', `/api/v1/proofs/check?${qs.toString()}`, null, headersOverride);
+    let mergedHeaders = headersOverride;
+    if (!mergedHeaders && !gateIdParam) {
+      try {
+        const sponsorHeaders = await this._resolveSponsorGrantHeaders(
+          Array.isArray(verifierIds)
+            ? verifierIds
+            : (verifierIds ? [verifierIds] : [])
+        );
+        if (sponsorHeaders && Object.keys(sponsorHeaders).length > 0) {
+          mergedHeaders = sponsorHeaders;
+        }
+      } catch (error) {
+        this._log('Sponsor grant unavailable for gateCheck (continuing without)', error?.message || String(error));
+      }
+    }
+
+    const response = await this._makeRequest('GET', `/api/v1/proofs/check?${qs.toString()}`, null, mergedHeaders);
     if (!response.success) {
       throw new ApiError(`Gate check failed: ${response.error?.message || 'Unknown error'}`, response.error);
     }

package/errors.js

@@ -1,189 +1,154 @@
-export class SDKError extends Error {
-  constructor(message, code = 'SDK_ERROR', details = {}) {
-    super(message);
-    this.name = 'SDKError';
-    this.code = code;
-    this.details = details;
-    this.timestamp = Date.now();
-
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, SDKError);
-    }
-  }
-
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message,
-      code: this.code,
-      details: this.details,
-      timestamp: this.timestamp
-    };
-  }
-}
-
-export class ApiError extends SDKError {
-  constructor(message, statusCode = 500, code = 'API_ERROR', response = null) {
-    super(message, code);
-    this.name = 'ApiError';
-    this.statusCode = statusCode;
-    this.response = response;
-
-    this.isClientError = statusCode >= 400 && statusCode < 500;
-    this.isServerError = statusCode >= 500;
-    this.isRetryable = this.isServerError || statusCode === 429; // Server errors or rate limit
-  }
-
-  static fromResponse(response, responseData) {
-    const statusCode = response.status;
-    const message = responseData?.error?.message ||
-                   responseData?.message ||
-                   `API request failed with status ${statusCode}`;
-    const code = responseData?.error?.code || 'API_ERROR';
-
-    return new ApiError(message, statusCode, code, responseData);
-  }
-
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      statusCode: this.statusCode,
-      isClientError: this.isClientError,
-      isServerError: this.isServerError,
-      isRetryable: this.isRetryable
-    };
-  }
-}
-
-export class ValidationError extends SDKError {
-  constructor(message, field = null, value = null) {
-    super(message, 'VALIDATION_ERROR');
-    this.name = 'ValidationError';
-    this.field = field;
-    this.value = value;
-    this.isRetryable = false; // Validation errors are not retryable
-  }
-
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      field: this.field,
-      value: this.value,
-      isRetryable: this.isRetryable
-    };
-  }
-}
-
-export class NetworkError extends SDKError {
-  constructor(message, code = 'NETWORK_ERROR', originalError = null) {
-    super(message, code);
-    this.name = 'NetworkError';
-    this.originalError = originalError;
-    this.isRetryable = true; // Network errors are retryable
-  }
-
-  static isNetworkError(error) {
-    return error instanceof NetworkError ||
-           error.name === 'TypeError' && error.message.includes('fetch') ||
-           error.name === 'AbortError' ||
-           error.code === 'ENOTFOUND' ||
-           error.code === 'ECONNREFUSED' ||
-           error.code === 'ETIMEDOUT';
-  }
-
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      isRetryable: this.isRetryable,
-      originalError: this.originalError ? {
-        name: this.originalError.name,
-        message: this.originalError.message,
-        code: this.originalError.code
-      } : null
-    };
-  }
-}
-
-export class ConfigurationError extends SDKError {
-  constructor(message, configKey = null) {
-    super(message, 'CONFIGURATION_ERROR');
-    this.name = 'ConfigurationError';
-    this.configKey = configKey;
-    this.isRetryable = false; // Config errors require user intervention
-  }
-
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      configKey: this.configKey,
-      isRetryable: this.isRetryable
-    };
-  }
-}
-
-export class VerificationError extends SDKError {
-  constructor(message, verifierId = null, code = 'VERIFICATION_ERROR') {
-    super(message, code);
-    this.name = 'VerificationError';
-    this.verifierId = verifierId;
-    this.isRetryable = true; // Some verification errors might be retryable
-  }
-
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      verifierId: this.verifierId,
-      isRetryable: this.isRetryable
-    };
-  }
-}
-
-export class AuthenticationError extends SDKError {
-  constructor(message, code = 'AUTHENTICATION_ERROR') {
-    super(message, code);
-    this.name = 'AuthenticationError';
-    this.isRetryable = false; // Auth errors require user intervention
-  }
-
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      isRetryable: this.isRetryable
-    };
-  }
-}
-
-export function createErrorFromGeneric(error, context = {}) {
-  if (error instanceof SDKError) {
-    return error;
-  }
-
-  if (NetworkError.isNetworkError(error)) {
-    return new NetworkError(
-      error.message || 'Network error occurred',
-      error.code || 'NETWORK_ERROR',
-      error
-    );
-  }
-
-  if (error.name === 'AbortError' || error.message.includes('timeout')) {
-    return new NetworkError('Request timeout', 'TIMEOUT', error);
-  }
-
-  return new SDKError(
-    error.message || 'Unknown error occurred',
-    error.code || 'UNKNOWN_ERROR',
-    { originalError: error, context }
-  );
-}
-
-export default {
-  SDKError,
-  ApiError,
-  ValidationError,
-  NetworkError,
-  ConfigurationError,
-  VerificationError,
-  AuthenticationError,
-  createErrorFromGeneric
-};
+export class SDKError extends Error {
+  constructor(message, code = 'SDK_ERROR', details = {}) {
+    super(message);
+    this.name = 'SDKError';
+    this.code = code;
+    this.details = details;
+    this.timestamp = Date.now();
+
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, SDKError);
+    }
+  }
+
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      details: this.details,
+      timestamp: this.timestamp
+    };
+  }
+}
+
+export class ApiError extends SDKError {
+  constructor(message, statusCode = 500, code = 'API_ERROR', response = null) {
+    super(message, code);
+    this.name = 'ApiError';
+    this.statusCode = statusCode;
+    this.response = response;
+
+    this.isClientError = statusCode >= 400 && statusCode < 500;
+    this.isServerError = statusCode >= 500;
+    this.isRetryable = this.isServerError || statusCode === 429; // Server errors or rate limit
+  }
+
+  static fromResponse(response, responseData) {
+    const statusCode = response.status;
+    const message = responseData?.error?.message ||
+                   responseData?.message ||
+                   `API request failed with status ${statusCode}`;
+    const code = responseData?.error?.code || 'API_ERROR';
+
+    return new ApiError(message, statusCode, code, responseData);
+  }
+
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      statusCode: this.statusCode,
+      isClientError: this.isClientError,
+      isServerError: this.isServerError,
+      isRetryable: this.isRetryable
+    };
+  }
+}
+
+export class ValidationError extends SDKError {
+  constructor(message, field = null, value = null) {
+    super(message, 'VALIDATION_ERROR');
+    this.name = 'ValidationError';
+    this.field = field;
+    this.value = value;
+    this.isRetryable = false; // Validation errors are not retryable
+  }
+
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      field: this.field,
+      value: this.value,
+      isRetryable: this.isRetryable
+    };
+  }
+}
+
+export class NetworkError extends SDKError {
+  constructor(message, code = 'NETWORK_ERROR', originalError = null) {
+    super(message, code);
+    this.name = 'NetworkError';
+    this.originalError = originalError;
+    this.isRetryable = true; // Network errors are retryable
+  }
+
+  static isNetworkError(error) {
+    return error instanceof NetworkError ||
+           error.name === 'TypeError' && error.message.includes('fetch') ||
+           error.name === 'AbortError' ||
+           error.code === 'ENOTFOUND' ||
+           error.code === 'ECONNREFUSED' ||
+           error.code === 'ETIMEDOUT';
+  }
+
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      isRetryable: this.isRetryable,
+      originalError: this.originalError ? {
+        name: this.originalError.name,
+        message: this.originalError.message,
+        code: this.originalError.code
+      } : null
+    };
+  }
+}
+
+export class ConfigurationError extends SDKError {
+  constructor(message, configKey = null) {
+    super(message, 'CONFIGURATION_ERROR');
+    this.name = 'ConfigurationError';
+    this.configKey = configKey;
+    this.isRetryable = false; // Config errors require user intervention
+  }
+
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      configKey: this.configKey,
+      isRetryable: this.isRetryable
+    };
+  }
+}
+
+export class VerificationError extends SDKError {
+  constructor(message, verifierId = null, code = 'VERIFICATION_ERROR') {
+    super(message, code);
+    this.name = 'VerificationError';
+    this.verifierId = verifierId;
+    this.isRetryable = true; // Some verification errors might be retryable
+  }
+
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      verifierId: this.verifierId,
+      isRetryable: this.isRetryable
+    };
+  }
+}
+
+export class AuthenticationError extends SDKError {
+  constructor(message, code = 'AUTHENTICATION_ERROR') {
+    super(message, code);
+    this.name = 'AuthenticationError';
+    this.isRetryable = false; // Auth errors require user intervention
+  }
+
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      isRetryable: this.isRetryable
+    };
+  }
+}

package/gates.js

@@ -51,23 +51,3 @@ export function combineGates(...gates) {
 
   return combined;
 }
-
-export default {
-  HOUR,
-  DAY,
-  WEEK,
-  MONTH,
-  YEAR,
-  GATE_NFT_HOLDER,
-  GATE_TOKEN_HOLDER,
-  GATE_CONTRACT_ADMIN,
-  GATE_DOMAIN_OWNER,
-  GATE_LINKED_WALLETS,
-  GATE_AGENT_IDENTITY,
-  GATE_AGENT_DELEGATION,
-  GATE_CONTENT_MODERATION,
-  GATE_WALLET_RISK,
-  GATE_PSEUDONYM,
-  createGate,
-  combineGates
-};

package/index.js

@@ -55,6 +55,8 @@ export {
   combineGates
 } from './gates.js';
 
+export { fetchSponsorGrant } from './sponsor.js';
+
 export {
   SDKError,
   ApiError,