@neus/sdk 1.0.4 → 1.0.6

package/errors.js

@@ -1,10 +1,3 @@
-/**
- * NEUS SDK Error Classes
- */
-
-/**
- * Base SDK Error Class
- */
 export class SDKError extends Error {
   constructor(message, code = 'SDK_ERROR', details = {}) {
     super(message);
@@ -13,7 +6,6 @@ export class SDKError extends Error {
     this.details = details;
     this.timestamp = Date.now();
 
-    // Ensure proper prototype chain
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, SDKError);
     }
@@ -30,9 +22,6 @@ export class SDKError extends Error {
   }
 }
 
-/**
- * API-related errors (server responses, HTTP issues)
- */
 export class ApiError extends SDKError {
   constructor(message, statusCode = 500, code = 'API_ERROR', response = null) {
     super(message, code);
@@ -40,7 +29,6 @@ export class ApiError extends SDKError {
     this.statusCode = statusCode;
     this.response = response;
 
-    // Additional classification
     this.isClientError = statusCode >= 400 && statusCode < 500;
     this.isServerError = statusCode >= 500;
     this.isRetryable = this.isServerError || statusCode === 429; // Server errors or rate limit
@@ -67,9 +55,6 @@ export class ApiError extends SDKError {
   }
 }
 
-/**
- * Client-side validation errors (invalid parameters, missing required fields)
- */
 export class ValidationError extends SDKError {
   constructor(message, field = null, value = null) {
     super(message, 'VALIDATION_ERROR');
@@ -89,9 +74,6 @@ export class ValidationError extends SDKError {
   }
 }
 
-/**
- * Network-related errors (connectivity, timeouts, DNS issues)
- */
 export class NetworkError extends SDKError {
   constructor(message, code = 'NETWORK_ERROR', originalError = null) {
     super(message, code);
@@ -122,9 +104,6 @@ export class NetworkError extends SDKError {
   }
 }
 
-/**
- * Configuration-related errors (missing configuration, invalid settings)
- */
 export class ConfigurationError extends SDKError {
   constructor(message, configKey = null) {
     super(message, 'CONFIGURATION_ERROR');
@@ -142,9 +121,6 @@ export class ConfigurationError extends SDKError {
   }
 }
 
-/**
- * Verification-specific errors (verifier failures, invalid proofs)
- */
 export class VerificationError extends SDKError {
   constructor(message, verifierId = null, code = 'VERIFICATION_ERROR') {
     super(message, code);
@@ -162,9 +138,6 @@ export class VerificationError extends SDKError {
   }
 }
 
-/**
- * Authentication-related errors (signature validation, wallet connection)
- */
 export class AuthenticationError extends SDKError {
   constructor(message, code = 'AUTHENTICATION_ERROR') {
     super(message, code);
@@ -180,15 +153,11 @@ export class AuthenticationError extends SDKError {
   }
 }
 
-/**
- * Utility function to create appropriate error from generic error
- */
 export function createErrorFromGeneric(error, context = {}) {
   if (error instanceof SDKError) {
     return error;
   }
 
-  // Network-related errors
   if (NetworkError.isNetworkError(error)) {
     return new NetworkError(
       error.message || 'Network error occurred',
@@ -197,12 +166,10 @@ export function createErrorFromGeneric(error, context = {}) {
     );
   }
 
-  // Timeout errors
   if (error.name === 'AbortError' || error.message.includes('timeout')) {
     return new NetworkError('Request timeout', 'TIMEOUT', error);
   }
 
-  // Generic error wrapper
   return new SDKError(
     error.message || 'Unknown error occurred',
     error.code || 'UNKNOWN_ERROR',
@@ -210,7 +177,6 @@ export function createErrorFromGeneric(error, context = {}) {
   );
 }
 
-// Export all error classes as default
 export default {
   SDKError,
   ApiError,

package/gates.js

@@ -1,175 +1,73 @@
-/**
- * NEUS SDK Gate Recipes
- *
- * These are EXAMPLES, not defaults.
- * Pick or copy-paste what fits your use case.
- *
- * @license Apache-2.0
- */
-
-// Time constants (milliseconds)
-export const HOUR = 60 * 60 * 1000;
-export const DAY = 24 * HOUR;
-export const WEEK = 7 * DAY;
-export const MONTH = 30 * DAY;
-export const YEAR = 365 * DAY;
-
-// ============================================================================
-// RECIPE GATES - Use case specific examples
-// ============================================================================
-
-/**
- * NFT holder gate
- * Integrator should add match: { contractAddress: '0x...' } when using
- */
-export const GATE_NFT_HOLDER = [
-  { verifierId: 'nft-ownership' }
-];
-
-/**
- * Token holder gate
- * Integrator should add match: { contractAddress: '0x...', minBalance: '...' }
- */
-export const GATE_TOKEN_HOLDER = [
-  { verifierId: 'token-holding' }
-];
-
-/**
- * Contract admin gate: requires recent contract ownership verification
- * Short TTL (1h) because ownership can transfer (point-in-time proof)
- */
-export const GATE_CONTRACT_ADMIN = [
-  { verifierId: 'contract-ownership', maxAgeMs: HOUR }
-];
-
-/**
- * Domain owner gate: requires DNS TXT verification
- * For verified organization badges, creator platforms
- */
-export const GATE_DOMAIN_OWNER = [
-  { verifierId: 'ownership-dns-txt' }
-];
-
-/**
- * Linked wallets gate: requires wallet linking
- * For multi-wallet identity features
- */
-export const GATE_LINKED_WALLETS = [
-  { verifierId: 'wallet-link' }
-];
-
-/**
- * Agent identity gate: requires verified agent identity
- * For agent/bot verification features
- */
-export const GATE_AGENT_IDENTITY = [
-  { verifierId: 'agent-identity' }
-];
-
-/**
- * Agent delegation gate: requires delegation proof
- * With recommended 7-day TTL for security
- */
-export const GATE_AGENT_DELEGATION = [
-  { verifierId: 'agent-delegation', maxAgeMs: 7 * DAY }
-];
-
-/**
- * Content moderation gate: requires a moderation proof for the exact contentHash.
- * Proof is permanent (policy snapshot); re-run only if your policy/provider requirements change.
- */
-export const GATE_CONTENT_MODERATION = [
-  { verifierId: 'ai-content-moderation' }
-];
-
-/**
- * Wallet risk gate: requires wallet risk assessment
- * Provider-backed risk signal
- */
-export const GATE_WALLET_RISK = [
-  { verifierId: 'wallet-risk' }
-];
-
-/**
- * Pseudonym gate: requires pseudonymous identity proof
- * For anonymous reputation systems
- */
-export const GATE_PSEUDONYM = [
-  { verifierId: 'ownership-pseudonym' }
-];
-
-// ============================================================================
-// HELPER FUNCTIONS
-// ============================================================================
-
-/**
- * Create a custom gate from verifier IDs
- * @param {Array<string|Object>} requirements - Array of verifier IDs or requirement objects
- * @returns {Array} Gate requirements array
- *
- * @example
- * // Simple: just verifier IDs
- * const gate = createGate(['nft-ownership', 'token-holding']);
- *
- * // With options
- * const gate = createGate([
- *   { verifierId: 'nft-ownership', match: { contractAddress: '0x...' } },
- *   { verifierId: 'token-holding', maxAgeMs: 7 * DAY },
- * ]);
- */
-export function createGate(requirements) {
-  return requirements.map(req => {
-    if (typeof req === 'string') {
-      return { verifierId: req };
-    }
-    return req;
-  });
-}
-
-/**
- * Combine multiple gates (union of requirements)
- * @param  {...Array} gates - Gate arrays to combine
- * @returns {Array} Combined gate requirements
- *
- * @example
- * const strictGate = combineGates(GATE_NFT_HOLDER, GATE_TOKEN_HOLDER);
- */
-export function combineGates(...gates) {
-  const combined = [];
-  const seen = new Set();
-
-  for (const gate of gates) {
-    for (const req of gate) {
-      const key = req.verifierId + JSON.stringify(req.match || {});
-      if (!seen.has(key)) {
-        seen.add(key);
-        combined.push(req);
-      }
-    }
-  }
-
-  return combined;
-}
-
-export default {
-  // Time constants
-  HOUR,
-  DAY,
-  WEEK,
-  MONTH,
-  YEAR,
-  // Recipe gates
-  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,
-  // Helpers
-  createGate,
-  combineGates
-};
+// SPDX-License-Identifier: Apache-2.0
+
+export const HOUR = 60 * 60 * 1000;
+export const DAY = 24 * HOUR;
+export const WEEK = 7 * DAY;
+export const MONTH = 30 * DAY;
+export const YEAR = 365 * DAY;
+
+export const GATE_NFT_HOLDER = [{ verifierId: 'nft-ownership' }];
+
+export const GATE_TOKEN_HOLDER = [{ verifierId: 'token-holding' }];
+
+export const GATE_CONTRACT_ADMIN = [{ verifierId: 'contract-ownership', maxAgeMs: HOUR }];
+
+export const GATE_DOMAIN_OWNER = [{ verifierId: 'ownership-dns-txt' }];
+
+export const GATE_LINKED_WALLETS = [{ verifierId: 'wallet-link' }];
+
+export const GATE_AGENT_IDENTITY = [{ verifierId: 'agent-identity' }];
+
+export const GATE_AGENT_DELEGATION = [{ verifierId: 'agent-delegation', maxAgeMs: 7 * DAY }];
+
+export const GATE_CONTENT_MODERATION = [{ verifierId: 'ai-content-moderation' }];
+
+export const GATE_WALLET_RISK = [{ verifierId: 'wallet-risk' }];
+
+export const GATE_PSEUDONYM = [{ verifierId: 'ownership-pseudonym' }];
+
+export function createGate(requirements) {
+  return requirements.map((req) => {
+    if (typeof req === 'string') {
+      return { verifierId: req };
+    }
+    return req;
+  });
+}
+
+export function combineGates(...gates) {
+  const combined = [];
+  const seen = new Set();
+
+  for (const gate of gates) {
+    for (const req of gate) {
+      const key = req.verifierId + JSON.stringify(req.match || {});
+      if (!seen.has(key)) {
+        seen.add(key);
+        combined.push(req);
+      }
+    }
+  }
+
+  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

@@ -1,9 +1,6 @@
-// NEUS SDK - Create and verify cryptographic proofs
 
-// Core client
 export { NeusClient } from './client.js';
 
-// Essential utilities
 export {
   PORTABLE_PROOF_SIGNER_HEADER,
   constructVerificationMessage,
@@ -38,15 +35,12 @@ export {
   toAgentDelegationMaxSpend
 } from './utils.js';
 
-// Example gate presets (choose per product; not defaults)
 export {
-  // Time constants
   HOUR,
   DAY,
   WEEK,
   MONTH,
   YEAR,
-  // Recipe gates
   GATE_NFT_HOLDER,
   GATE_TOKEN_HOLDER,
   GATE_CONTRACT_ADMIN,
@@ -57,12 +51,10 @@ export {
   GATE_CONTENT_MODERATION,
   GATE_WALLET_RISK,
   GATE_PSEUDONYM,
-  // Helpers
   createGate,
   combineGates
 } from './gates.js';
 
-// Error classes
 export {
   SDKError,
   ApiError,
@@ -73,7 +65,6 @@ export {
   AuthenticationError
 } from './errors.js';
 
-// Default export
 export default {
   NeusClient: () => import('./client.js').then(m => m.NeusClient),
   toString: () => '[neus/sdk]'

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@neus/sdk",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Portable trust for people, apps, and agents. Store a proof ID; check gates across surfaces.",
   "bin": {
-    "neus": "./cli/neus.mjs"
+    "neus": "cli/neus.mjs"
   },
   "main": "index.js",
   "type": "module",
@@ -84,7 +84,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zkpassport/sdk": "0.12.5",
+    "@zkpassport/sdk": "0.13.1",
     "ethers": "^6.0.0",
     "react": ">=17.0.0",
     "react-dom": ">=17.0.0"
@@ -101,7 +101,7 @@
     }
   },
   "optionalDependencies": {
-    "@zkpassport/sdk": "0.12.5"
+    "@zkpassport/sdk": "0.13.1"
   },
   "dependencies": {
     "bs58": "^6.0.0"
@@ -110,6 +110,7 @@
     "@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"
   },