@opendatalabs/vana-sdk 2.3.0 → 3.0.1

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["import type { WalletClient, PublicClient, Account, Address, Chain } from \"viem\";\nimport type { VanaChainId, VanaChain } from \"./chains\";\nimport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageListOptions,\n} from \"./storage\";\n\nimport type { RelayerConfig } from \"./relayer\";\nimport type { IOperationStore, IRelayerStateStore } from \"./operationStore\";\n\n/**\n * Marker interface to indicate that a Vana instance has storage configured.\n * Used for compile-time type safety to ensure storage-dependent methods\n * are only called on properly configured instances.\n *\n * @category Configuration\n */\nexport interface StorageRequiredMarker {\n  readonly __storageRequired: true;\n}\n\n/**\n * Configures storage providers for SDK file operations.\n *\n * @remarks\n * Supports multiple backends with automatic fallback.\n * IPFS for decentralization, Pinata for reliability,\n * Google Drive for development, custom for flexibility.\n *\n * **Provider Selection:**\n * - IPFS: Decentralized, permanent storage ideal for production\n * - Pinata: Managed IPFS with guaranteed availability\n * - Google Drive: Centralized, suitable for development/testing\n * - Custom providers: Implement StorageProvider interface\n *\n * @category Configuration\n * @example\n * ```typescript\n * const storage: StorageConfig = {\n *   providers: {\n *     ipfs: new IPFSStorage({ gateway: 'https://gateway.pinata.cloud' }),\n *     pinata: new PinataStorage({ apiKey: 'key', secretKey: 'secret' })\n *   },\n *   defaultProvider: 'ipfs'\n * };\n * ```\n */\nexport interface StorageConfig {\n  /**\n   * Map of provider name to storage provider instance.\n   *   Common provider names: \"ipfs\", \"pinata\", \"googledrive\", \"s3\".\n   *   Custom names allowed for custom provider implementations.\n   */\n  providers: Record<string, StorageProvider>;\n  /**\n   * Default provider name to use when none specified.\n   *   Must match a key in the providers map. Falls back to first provider if not specified.\n   */\n  defaultProvider?: string;\n}\n\n/**\n * Download relayer callbacks for proxying CORS-restricted downloads.\n *\n * Provides a callback to proxy download requests through your application server\n * when direct browser access fails due to CORS restrictions (e.g., Google Drive).\n *\n * IMPORTANT SECURITY REQUIREMENTS for your proxy endpoint:\n * 1. MUST block requests to private/internal IPs (SSRF protection)\n * 2. SHOULD NOT restrict domains (files can be hosted anywhere)\n *\n * @category Configuration\n * @example Client-side implementation:\n * ```typescript\n * const downloadRelayer: DownloadRelayerCallbacks = {\n *   async proxyDownload(url) {\n *     const response = await fetch('/api/proxy', {\n *       method: 'POST',\n *       headers: { 'Content-Type': 'application/json' },\n *       body: JSON.stringify({ url })\n *     });\n *     return response.blob();\n *   }\n * };\n * ```\n *\n * @example Server-side proxy endpoint (Next.js):\n * ```typescript\n * // /api/proxy/route.ts\n * import { promises as dns } from 'dns';\n * import { isIPv4 } from 'net';\n *\n * async function handleProxy(url: string) {\n *   const { hostname } = new URL(url);\n *\n *   // Resolve hostname to IP (handle localhost specially)\n *   const ip = hostname === 'localhost' ? '127.0.0.1' :\n *              isIPv4(hostname) ? hostname :\n *              await dns.lookup(hostname).then(r => r.address);\n *\n *   // SSRF Protection: Block private/internal IPs\n *   if (isIPv4(ip)) {\n *     const [a, b] = ip.split('.').map(Number);\n *     if (a === 10 || a === 127 || a === 0 ||\n *         (a === 172 && b >= 16 && b <= 31) ||\n *         (a === 192 && b === 168) ||\n *         (a === 169 && b === 254) ||\n *         a >= 224) { // Also block multicast/reserved\n *       return new Response('Private/internal addresses not allowed', { status: 403 });\n *     }\n *   }\n *\n *   // Proxy the request\n *   const response = await fetch(url, { redirect: 'manual' });\n *\n *   // Handle redirects (with recursion limit)\n *   if (response.status >= 301 && response.status <= 308) {\n *     const location = response.headers.get('location');\n *     if (location) return handleProxy(new URL(location, url).href);\n *   }\n *\n *   const data = await response.arrayBuffer();\n *   return new Response(data, {\n *     headers: {\n *       'Content-Type': response.headers.get('content-type') || 'application/octet-stream',\n *       'Access-Control-Allow-Origin': '*'\n *     }\n *   });\n * }\n * ```\n */\nexport interface DownloadRelayerCallbacks {\n  /**\n   * Proxy a download request through your application server\n   *\n   * @param url - The URL to download from\n   * @returns Promise resolving to the downloaded content as a Blob\n   */\n  proxyDownload: (url: string) => Promise<Blob>;\n}\n\n/**\n * Storage callback functions for flexible storage operations.\n *\n * Instead of hardcoding storage behavior (HTTP endpoints, etc.), users can provide\n * custom callback functions to handle storage operations in any way they choose.\n * This pattern matches the relayer callbacks approach, providing maximum flexibility.\n *\n * @category Configuration\n * @example\n * ```typescript\n * const storageCallbacks: StorageCallbacks = {\n *   async upload(blob, filename, metadata) {\n *     // Custom implementation - could be HTTP, S3, local filesystem, etc.\n *     const formData = new FormData();\n *     formData.append('file', blob, filename);\n *     const response = await fetch('/api/storage/upload', {\n *       method: 'POST',\n *       body: formData\n *     });\n *     const data = await response.json();\n *     return {\n *       url: data.url,\n *       size: blob.size,\n *       contentType: blob.type,\n *       metadata: data.metadata\n *     };\n *   },\n *\n *   async download(identifier) {\n *     const response = await fetch(`/api/storage/download/${identifier}`);\n *     return response.blob();\n *   }\n * };\n * ```\n */\nexport interface StorageCallbacks {\n  /**\n   * Upload a blob to storage\n   *\n   * @param blob - The data to upload\n   * @param filename - Optional filename hint\n   * @param metadata - Optional metadata for the upload\n   * @returns Upload result with identifier and metadata\n   */\n  upload: (\n    blob: Blob,\n    filename?: string,\n    metadata?: Record<string, unknown>,\n  ) => Promise<StorageUploadResult>;\n\n  /**\n   * Download data from storage\n   *\n   * @param identifier - The storage identifier (could be URL, hash, path, or any unique ID)\n   * @param options - Optional download options\n   * @returns The downloaded data as a Blob\n   */\n  download: (\n    identifier: string,\n    options?: StorageDownloadOptions,\n  ) => Promise<Blob>;\n\n  /**\n   * List stored items (optional)\n   *\n   * @param prefix - Optional prefix to filter results\n   * @param options - Optional listing options\n   * @returns Array of storage items with metadata\n   */\n  list?: (\n    prefix?: string,\n    options?: StorageListOptions,\n  ) => Promise<StorageListResult>;\n\n  /**\n   * Delete a stored item (optional)\n   *\n   * @param identifier - The storage identifier to delete\n   * @returns Promise that resolves to true if deletion succeeded\n   */\n  delete?: (identifier: string) => Promise<boolean>;\n\n  /**\n   * Extract identifier from a URL or return as-is (optional)\n   * Used for backward compatibility with URL-based systems\n   *\n   * @param url - The URL to extract from\n   * @returns The extracted identifier\n   */\n  extractIdentifier?: (url: string) => string;\n}\n\n/**\n * Options for storage download operations\n *\n * @category Configuration\n */\nexport interface StorageDownloadOptions {\n  /** Optional HTTP headers */\n  headers?: Record<string, string>;\n  /** Optional abort signal for cancellation */\n  signal?: AbortSignal;\n  /** Optional byte range for partial downloads */\n  range?: { start?: number; end?: number };\n}\n\n/**\n * Result from storage list operations\n *\n * @category Configuration\n */\nexport interface StorageListResult {\n  /** Array of storage items */\n  items: Array<{\n    /** Item identifier */\n    identifier: string;\n    /** Item size in bytes */\n    size?: number;\n    /** Last modified timestamp */\n    lastModified?: Date;\n    /** Item metadata */\n    metadata?: Record<string, unknown>;\n  }>;\n  /** Continuation token for pagination */\n  continuationToken?: string;\n  /** Whether more results are available */\n  hasMore?: boolean;\n}\n\n/**\n * Base configuration interface without storage requirements\n *\n * @category Configuration\n */\nexport interface BaseConfig {\n  /**\n   * Optional relayer configuration for handling gasless transactions.\n   * Can be a URL string for convenience, or a callback for full control.\n   *\n   * @example\n   * ```typescript\n   * // Simple URL (SDK handles transport)\n   * relayer: '/api/relay'\n   *\n   * // Full control with callback\n   * relayer: async (request) => {\n   *   const response = await fetch('/api/relay', {\n   *     method: 'POST',\n   *     body: JSON.stringify(request)\n   *   });\n   *   return response.json();\n   * }\n   * ```\n   */\n  relayer?: RelayerConfig;\n\n  /**\n   * Optional download relayer for proxying CORS-restricted downloads.\n   * Provides a proxy mechanism for files stored on servers with CORS restrictions.\n   */\n  downloadRelayer?: DownloadRelayerCallbacks;\n\n  /**\n   * Optional storage providers configuration for file upload/download.\n   *   Required for: upload(), grant() without pre-stored URLs, schema operations.\n   *   See StorageConfig for provider selection guidance.\n   */\n  storage?: StorageConfig;\n\n  /**\n   * Optional subgraph URL for querying user files and permissions.\n   * If not provided, defaults to the built-in subgraph URL for the current chain.\n   * Can be overridden per method call if needed.\n   * Obtain chain-specific URLs from Vana documentation or deployment info.\n   */\n  subgraphUrl?: string;\n  /**\n   * Optional default IPFS gateways to use for fetching files.\n   * These gateways will be used by default in fetchFromIPFS unless overridden per-call.\n   * If not provided, the SDK will use public gateways.\n   * Order matters: first successful gateway is used.\n   *\n   * @example ['https://gateway.pinata.cloud', 'https://ipfs.io']\n   */\n  ipfsGateways?: string[];\n  /**\n   * Default personal server base URL for server operations.\n   * Required for ServerController methods like getIdentity(), createOperation(), etc.\n   *\n   * @example 'https://my-personal-server.example.com'\n   */\n  defaultPersonalServerUrl?: string;\n\n  /**\n   * Optional operation store for tracking async relayed transactions.\n   * When provided with a relayer, enables resilient transaction management\n   * with polling support for pending operations.\n   *\n   * @example\n   * ```typescript\n   * const vana = createVana({\n   *   walletClient,\n   *   relayer: '/api/relay',\n   *   operationStore: myOperationStore\n   * });\n   * ```\n   */\n  operationStore?: IOperationStore | IRelayerStateStore;\n}\n\n/**\n * Base configuration interface that requires storage for storage-dependent operations\n *\n * @category Configuration\n */\nexport interface BaseConfigWithStorage {\n  /**\n   * Optional relayer configuration for handling gasless transactions.\n   * Can be a URL string for convenience, or a callback for full control.\n   *\n   * @example\n   * ```typescript\n   * // Simple URL (SDK handles transport)\n   * relayer: '/api/relay'\n   *\n   * // Full control with callback\n   * relayer: async (request) => {\n   *   const response = await fetch('/api/relay', {\n   *     method: 'POST',\n   *     body: JSON.stringify(request)\n   *   });\n   *   return response.json();\n   * }\n   * ```\n   */\n  relayer?: RelayerConfig;\n\n  /**\n   * Optional download relayer for proxying CORS-restricted downloads.\n   * Provides a proxy mechanism for files stored on servers with CORS restrictions.\n   */\n  downloadRelayer?: DownloadRelayerCallbacks;\n\n  /** Required storage providers configuration for file upload/download */\n  storage: StorageConfig;\n  /**\n   * Optional subgraph URL for querying user files and permissions.\n   * If not provided, defaults to the built-in subgraph URL for the current chain.\n   * Can be overridden per method call if needed.\n   */\n  subgraphUrl?: string;\n  /**\n   * Optional default IPFS gateways to use for fetching files.\n   * These gateways will be used by default in fetchFromIPFS unless overridden per-call.\n   * If not provided, the SDK will use public gateways.\n   *\n   * @example ['https://gateway.pinata.cloud', 'https://ipfs.io']\n   */\n  ipfsGateways?: string[];\n  /**\n   * Default personal server base URL for server operations.\n   * Required for ServerController methods like getIdentity(), createOperation(), etc.\n   *\n   * @example 'https://my-personal-server.example.com'\n   */\n  defaultPersonalServerUrl?: string;\n\n  /**\n   * Optional operation store for tracking async relayed transactions.\n   * When provided with a relayer, enables resilient transaction management\n   * with polling support for pending operations.\n   */\n  operationStore?: IOperationStore | IRelayerStateStore;\n}\n\n/**\n * Configuration with wallet client\n *\n * @category Configuration\n */\nexport interface WalletConfig extends BaseConfig {\n  /** The viem WalletClient instance used for signing transactions */\n  walletClient: WalletClient & {\n    chain: VanaChain;\n  };\n}\n\n/**\n * Configuration with wallet client that requires storage\n *\n * @category Configuration\n */\nexport interface WalletConfigWithStorage extends BaseConfigWithStorage {\n  /** The viem WalletClient instance used for signing transactions */\n  walletClient: WalletClient & {\n    chain: VanaChain;\n  };\n}\n\n/**\n * Configuration with chain and account details\n *\n * @category Configuration\n */\nexport interface ChainConfig extends BaseConfig {\n  /**\n   * The chain ID for Vana network.\n   *   Supported: 14800 (Vana Mainnet), 14801 (Moksha Testnet), 31337 (Local Development).\n   *   Use chain constants from '@vana/sdk' for type safety.\n   */\n  chainId: VanaChainId;\n  /**\n   * RPC URL for the chain (optional, will use default for the chain if not provided).\n   *   Default URLs: mainnet (https://rpc.vana.org), testnet (https://rpc.moksha.vana.org).\n   *   Override for custom nodes or local development.\n   */\n  rpcUrl?: string;\n  /**\n   * Optional account for signing transactions.\n   *   Can be: privateKeyToAccount(), mnemonicToAccount(), or custom Account implementation.\n   *   Required for write operations; read-only operations work without account.\n   */\n  account?: Account;\n}\n\n/**\n * Configuration with chain and account details that requires storage\n *\n * @category Configuration\n */\nexport interface ChainConfigWithStorage extends BaseConfigWithStorage {\n  /** The chain ID for Vana network */\n  chainId: VanaChainId;\n  /** RPC URL for the chain (optional, will use default for the chain if not provided) */\n  rpcUrl?: string;\n  /** Optional account for signing transactions */\n  account?: Account;\n}\n\n/**\n * Configuration with wallet client and optional public client\n *\n * @category Configuration\n */\nexport interface VanaConfigWithWallet extends BaseConfig {\n  /** The viem WalletClient instance used for signing transactions */\n  walletClient: WalletClient;\n  /** Optional PublicClient for read operations (derived from wallet if not provided) */\n  publicClient?: PublicClient;\n}\n\n/**\n * Configuration for read-only operations with public client and address\n *\n * @category Configuration\n */\nexport interface VanaConfigReadOnly extends BaseConfig {\n  /** The viem PublicClient instance for read operations */\n  publicClient: PublicClient;\n  /** The user's address for read operations */\n  address: Address;\n}\n\n/**\n * Configuration for minimal read-only operations with just an address\n *\n * @category Configuration\n */\nexport interface VanaConfigAddressOnly extends BaseConfig {\n  /** The user's address for read operations */\n  address: Address;\n  /** Optional chain configuration (will use default if not provided) */\n  chain?: Chain;\n}\n\n/**\n * Configuration with wallet client and optional public client that requires storage\n *\n * @category Configuration\n */\nexport interface VanaConfigWithWalletWithStorage extends BaseConfigWithStorage {\n  /** The viem WalletClient instance used for signing transactions */\n  walletClient: WalletClient;\n  /** Optional PublicClient for read operations (derived from wallet if not provided) */\n  publicClient?: PublicClient;\n}\n\n/**\n * Configuration for read-only operations with public client and address that requires storage\n *\n * @category Configuration\n */\nexport interface VanaConfigReadOnlyWithStorage extends BaseConfigWithStorage {\n  /** The viem PublicClient instance for read operations */\n  publicClient: PublicClient;\n  /** The user's address for read operations */\n  address: Address;\n}\n\n/**\n * Configuration for minimal read-only operations with just an address that requires storage\n *\n * @category Configuration\n */\nexport interface VanaConfigAddressOnlyWithStorage\n  extends BaseConfigWithStorage {\n  /** The user's address for read operations */\n  address: Address;\n  /** Optional chain configuration (will use default if not provided) */\n  chain?: Chain;\n}\n\n/**\n * Main configuration interface for initializing the Vana SDK.\n *\n * The SDK supports three initialization modes:\n * 1. Full mode with wallet client for signing transactions\n * 2. Read-only mode with public client and address for read operations\n * 3. Minimal mode with just an address and optional chain\n *\n * @category Configuration\n * @example\n * ```typescript\n * // Mode 1: Full configuration with wallet client\n * const configWithWallet: VanaConfig = {\n *   walletClient: createWalletClient({\n *     account: privateKeyToAccount('0x...'),\n *     chain: moksha,\n *     transport: http()\n *   }),\n *   publicClient: createPublicClient({\n *     chain: moksha,\n *     transport: http()\n *   })\n * };\n *\n * // Mode 2: Read-only with public client and address\n * const configReadOnly: VanaConfig = {\n *   publicClient: createPublicClient({\n *     chain: moksha,\n *     transport: http()\n *   }),\n *   address: '0x1234...'\n * };\n *\n * // Mode 3: Minimal with just address\n * const configMinimal: VanaConfig = {\n *   address: '0x1234...',\n *   chain: moksha // optional\n * };\n * ```\n */\nexport type VanaConfig =\n  | VanaConfigWithWallet\n  | VanaConfigReadOnly\n  | VanaConfigAddressOnly\n  | WalletConfig\n  | ChainConfig;\n\n/**\n * Configuration interface for Vana SDK that requires storage providers.\n *\n * Use this type when you need to ensure storage is configured for operations\n * like file uploads, permission grants without pre-stored URLs, or schema creation.\n * Supports all three initialization modes with required storage.\n *\n * @category Configuration\n * @example\n * ```typescript\n * // Full configuration with wallet client and storage\n * const configWithWallet: VanaConfigWithStorage = {\n *   walletClient: createWalletClient({\n *     account: privateKeyToAccount('0x...'),\n *     chain: moksha,\n *     transport: http()\n *   }),\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({ gateway: 'https://gateway.pinata.cloud' })\n *     },\n *     defaultProvider: 'ipfs'\n *   }\n * };\n *\n * // Read-only configuration with storage\n * const configReadOnly: VanaConfigWithStorage = {\n *   publicClient: createPublicClient({\n *     chain: moksha,\n *     transport: http()\n *   }),\n *   address: '0x1234...',\n *   storage: {\n *     providers: {\n *       ipfs: new IPFSStorage({ gateway: 'https://gateway.pinata.cloud' })\n *     },\n *     defaultProvider: 'ipfs'\n *   }\n * };\n * ```\n */\nexport type VanaConfigWithStorage =\n  | VanaConfigWithWalletWithStorage\n  | VanaConfigReadOnlyWithStorage\n  | VanaConfigAddressOnlyWithStorage\n  | WalletConfigWithStorage\n  | ChainConfigWithStorage;\n\n/**\n * Runtime configuration information\n *\n * @category Configuration\n */\nexport interface RuntimeConfig {\n  /** Current chain ID */\n  chainId: VanaChainId;\n  /** Current chain name */\n  chainName: string;\n  /** Available storage providers */\n  storageProviders: string[];\n  /** Default storage provider */\n  defaultStorageProvider?: string;\n  /** Current relayer configuration */\n  relayerConfig?: RelayerConfig;\n}\n\n/**\n * Validates whether a configuration object has a wallet client (any wallet-based config).\n *\n * @param config - The configuration object to check\n * @returns True if the config contains a walletClient\n * @example\n * ```typescript\n * if (isWalletConfig(config)) {\n *   console.log('Using wallet client:', config.walletClient.account?.address);\n * } else {\n *   console.log('Read-only or chain config');\n * }\n * ```\n */\nexport function isWalletConfig(\n  config: VanaConfig,\n): config is VanaConfigWithWallet | WalletConfig {\n  return \"walletClient\" in config;\n}\n\n/**\n * Validates whether a configuration object is a read-only config with public client.\n *\n * @param config - The configuration object to check\n * @returns True if the config has publicClient and address but no walletClient\n * @example\n * ```typescript\n * if (isReadOnlyConfig(config)) {\n *   console.log('Read-only mode with address:', config.address);\n * }\n * ```\n */\nexport function isReadOnlyConfig(\n  config: VanaConfig,\n): config is VanaConfigReadOnly {\n  return (\n    \"publicClient\" in config &&\n    \"address\" in config &&\n    !(\"walletClient\" in config)\n  );\n}\n\n/**\n * Validates whether a configuration object is an address-only config.\n *\n * @param config - The configuration object to check\n * @returns True if the config has only address (and optionally chain) but no clients\n * @example\n * ```typescript\n * if (isAddressOnlyConfig(config)) {\n *   console.log('Address-only mode:', config.address);\n * }\n * ```\n */\nexport function isAddressOnlyConfig(\n  config: VanaConfig,\n): config is VanaConfigAddressOnly {\n  return (\n    \"address\" in config &&\n    !(\"publicClient\" in config) &&\n    !(\"walletClient\" in config) &&\n    !(\"chainId\" in config)\n  );\n}\n\n/**\n * Validates whether a configuration object is a ChainConfig.\n *\n * @param config - The configuration object to check\n * @returns True if the config is a ChainConfig (contains chainId but not walletClient)\n * @example\n * ```typescript\n * if (isChainConfig(config)) {\n *   console.log('Chain ID:', config.chainId);\n *   console.log('RPC URL:', config.rpcUrl);\n * } else {\n *   console.log('Using pre-configured wallet client');\n * }\n * ```\n */\nexport function isChainConfig(config: VanaConfig): config is ChainConfig {\n  return \"chainId\" in config && !(\"walletClient\" in config);\n}\n\n/**\n * Validates whether a configuration has required storage providers.\n *\n * @param config - The configuration object to check\n * @returns True if the config has storage providers configured\n * @example\n * ```typescript\n * if (hasStorageConfig(config)) {\n *   // Safe to use storage-dependent operations\n *   await vana.data.uploadFile(file);\n * } else {\n *   console.log('Storage not configured - some operations may fail');\n * }\n * ```\n */\nexport function hasStorageConfig(\n  config: VanaConfig,\n): config is VanaConfigWithStorage {\n  return (\n    config.storage?.providers !== undefined &&\n    Object.keys(config.storage.providers).length > 0\n  );\n}\n\n/**\n * Configuration validation options\n *\n * @category Configuration\n */\nexport interface ConfigValidationOptions {\n  /** Whether to validate storage providers */\n  validateStorage?: boolean;\n  /** Whether to validate relayer URL */\n  validateRelayer?: boolean;\n  /** Whether to validate chain configuration */\n  validateChain?: boolean;\n}\n\n/**\n * Configuration validation result\n *\n * @category Configuration\n */\nexport interface ConfigValidationResult {\n  /** Whether the configuration is valid */\n  valid: boolean;\n  /** List of validation errors */\n  errors: string[];\n  /** List of validation warnings */\n  warnings: string[];\n}\n\n/**\n * Marker interface to enforce the presence of operationStore at compile time.\n * This interface is used to ensure that certain operations requiring a relayer\n * can only be called when the SDK has been properly configured with an operation store.\n *\n * @category Configuration\n */\nexport interface RelayerRequiredMarker {\n  readonly __relayerConfigured: true;\n}\n"],"mappings":"AAyqBO,SAAS,eACd,QAC+C;AAC/C,SAAO,kBAAkB;AAC3B;AAcO,SAAS,iBACd,QAC8B;AAC9B,SACE,kBAAkB,UAClB,aAAa,UACb,EAAE,kBAAkB;AAExB;AAcO,SAAS,oBACd,QACiC;AACjC,SACE,aAAa,UACb,EAAE,kBAAkB,WACpB,EAAE,kBAAkB,WACpB,EAAE,aAAa;AAEnB;AAiBO,SAAS,cAAc,QAA2C;AACvE,SAAO,aAAa,UAAU,EAAE,kBAAkB;AACpD;AAiBO,SAAS,iBACd,QACiC;AACjC,SACE,OAAO,SAAS,cAAc,UAC9B,OAAO,KAAK,OAAO,QAAQ,SAAS,EAAE,SAAS;AAEnD;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/contracts.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/contracts.ts"],"sourcesContent":["/**\n * Defines types for smart contract interactions.\n *\n * @remarks\n * This module provides comprehensive type definitions for Vana protocol\n * smart contracts including contract names, deployment information, and\n * advanced TypeScript utility types for type-safe contract interactions.\n *\n * @category Types\n * @module types/contracts\n */\n\nimport type { Abi, Address, Hash, GetContractReturnType } from \"viem\";\n\n/**\n * Enumerates all supported Vana protocol contract names.\n *\n * @remarks\n * Use these names with `getContractController()` to get typed contract\n * instances. Each name corresponds to a specific protocol contract with\n * its own ABI and functionality.\n *\n * @category Contracts\n */\nexport type VanaContractName =\n  | \"DataPortabilityPermissions\"\n  | \"DataPortabilityServers\"\n  | \"DataPortabilityGrantees\"\n  | \"DataRegistry\"\n  | \"TeePool\"\n  | \"ComputeEngine\"\n  | \"TeePoolPhala\"\n  | \"DataRefinerRegistry\"\n  | \"QueryEngine\"\n  | \"ComputeInstructionRegistry\"\n  | \"TeePoolEphemeralStandard\"\n  | \"TeePoolPersistentStandard\"\n  | \"TeePoolPersistentGpu\"\n  | \"TeePoolDedicatedStandard\"\n  | \"TeePoolDedicatedGpu\"\n  | \"VanaEpoch\"\n  | \"DLPRegistry\"\n  | \"DLPRegistryTreasury\"\n  | \"DLPPerformance\"\n  | \"DLPRewardDeployer\"\n  | \"DLPRewardDeployerTreasury\"\n  | \"DLPRewardSwap\"\n  | \"SwapHelper\"\n  | \"VanaPoolStaking\"\n  | \"VanaPoolEntity\"\n  | \"VanaPoolTreasury\"\n  | \"DAT\"\n  | \"DATFactory\"\n  | \"DATPausable\"\n  | \"DATVotes\"\n  | \"DataLiquidityPool\"\n  | \"DLPRoot\";\n\n/**\n * Provides contract deployment information with typed ABI.\n *\n * @remarks\n * Contains the minimum information needed to interact with a\n * deployed contract: its address and ABI.\n *\n * @typeParam TAbi - The contract's ABI type for full type safety\n *\n * @category Contracts\n */\nexport interface ContractInfo<TAbi extends Abi = Abi> {\n  /** The contract's deployed address */\n  address: Address;\n  /** The contract's ABI */\n  abi: TAbi;\n}\n\n/**\n * Tracks contract deployment metadata.\n *\n * @remarks\n * Records when and how a contract was deployed to the blockchain,\n * useful for verification and debugging.\n *\n * @category Contracts\n */\nexport interface ContractDeployment {\n  /** The contract's deployed address */\n  address: Address;\n  /** Block number where contract was deployed */\n  blockNumber: bigint;\n  /** Transaction hash of deployment */\n  transactionHash: Hash;\n}\n\n/**\n * Represents a fully typed contract instance.\n *\n * @remarks\n * Alias for viem's GetContractReturnType, providing a contract\n * instance with all methods fully typed based on the ABI.\n *\n * @typeParam TAbi - The contract's ABI type\n *\n * @category Contracts\n */\nexport type VanaContractInstance<TAbi extends Abi = Abi> =\n  GetContractReturnType<TAbi>;\n\n/**\n * Maps contract addresses by chain ID and contract name.\n *\n * @remarks\n * Hierarchical mapping structure for multi-chain contract deployments.\n * Used internally for address resolution across different networks.\n *\n * @category Contracts\n */\nexport type ContractAddresses = {\n  [chainId: number]: {\n    [contractName in VanaContractName]?: Address;\n  };\n};\n\n/**\n * Extracts typed parameters for a contract method from its ABI.\n *\n * @remarks\n * Advanced utility type that provides type-safe parameter extraction\n * from contract ABIs. Maps Solidity types to TypeScript types automatically.\n *\n * @typeParam TAbi - The contract's ABI type\n * @typeParam TFunctionName - The name of the function to extract parameters for\n *\n * @internal\n */\nexport type ContractMethodParams<\n  TAbi extends Abi,\n  TFunctionName extends string,\n> = TAbi extends readonly unknown[]\n  ? TAbi[number] extends {\n      name: TFunctionName;\n      type: \"function\";\n      inputs: infer TInputs;\n    }\n    ? TInputs extends readonly unknown[]\n      ? {\n          [K in keyof TInputs]: TInputs[K] extends {\n            name: infer TName;\n            type: infer TType;\n          }\n            ? TName extends string\n              ? TType extends \"address\"\n                ? Address\n                : TType extends \"uint256\"\n                  ? bigint\n                  : TType extends \"string\"\n                    ? string\n                    : TType extends \"bool\"\n                      ? boolean\n                      : TType extends \"bytes32\"\n                        ? Hash\n                        : unknown\n              : never\n            : never;\n        }\n      : never\n    : never\n  : never;\n\n/**\n * Extracts typed return values for a contract method from its ABI.\n *\n * @remarks\n * Advanced utility type that provides type-safe return type extraction\n * from contract ABIs. Handles single values and tuples appropriately.\n *\n * @typeParam TAbi - The contract's ABI type\n * @typeParam TFunctionName - The name of the function to extract return type for\n *\n * @internal\n */\nexport type ContractMethodReturnType<\n  TAbi extends Abi,\n  TFunctionName extends string,\n> = TAbi extends readonly unknown[]\n  ? TAbi[number] extends {\n      name: TFunctionName;\n      type: \"function\";\n      outputs: infer TOutputs;\n    }\n    ? TOutputs extends readonly unknown[]\n      ? TOutputs[\"length\"] extends 1\n        ? TOutputs[0] extends { type: infer TType }\n          ? TType extends \"address\"\n            ? Address\n            : TType extends \"uint256\"\n              ? bigint\n              : TType extends \"string\"\n                ? string\n                : TType extends \"bool\"\n                  ? boolean\n                  : TType extends \"bytes32\"\n                    ? Hash\n                    : unknown\n          : unknown\n        : {\n            [K in keyof TOutputs]: TOutputs[K] extends {\n              name: infer TName;\n              type: infer TType;\n            }\n              ? TName extends string\n                ? TType extends \"address\"\n                  ? Address\n                  : TType extends \"uint256\"\n                    ? bigint\n                    : TType extends \"string\"\n                      ? string\n                      : TType extends \"bool\"\n                        ? boolean\n                        : TType extends \"bytes32\"\n                          ? Hash\n                          : unknown\n                : never\n              : never;\n          }\n      : never\n    : never\n  : never;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/contracts.ts"],"sourcesContent":["/**\n * Defines types for smart contract interactions.\n *\n * @remarks\n * This module provides comprehensive type definitions for Vana protocol\n * smart contracts including contract names, deployment information, and\n * advanced TypeScript utility types for type-safe contract interactions.\n *\n * @category Types\n * @module types/contracts\n */\n\nimport type { Abi, Address, Hash, GetContractReturnType } from \"viem\";\n\n/**\n * Enumerates all supported Vana protocol contract names.\n *\n * @remarks\n * Use these names with `getContractController()` to get typed contract\n * instances. Each name corresponds to a specific protocol contract with\n * its own ABI and functionality.\n *\n * @category Contracts\n */\nexport type VanaContractName =\n  | \"DataPortabilityPermissions\"\n  | \"DataPortabilityServers\"\n  | \"DataPortabilityGrantees\"\n  | \"DataRegistry\"\n  | \"ComputeEngine\"\n  | \"TeePoolPhala\"\n  | \"DataRefinerRegistry\"\n  | \"QueryEngine\"\n  | \"ComputeInstructionRegistry\"\n  | \"TeePoolEphemeralStandard\"\n  | \"TeePoolPersistentStandard\"\n  | \"TeePoolPersistentGpu\"\n  | \"TeePoolDedicatedStandard\"\n  | \"TeePoolDedicatedGpu\"\n  | \"VanaEpoch\"\n  | \"DLPRegistry\"\n  | \"DLPRegistryTreasury\"\n  | \"VanaPoolStaking\"\n  | \"VanaPoolEntity\"\n  | \"VanaPoolTreasury\"\n  | \"DAT\"\n  | \"DATFactory\"\n  | \"DATPausable\"\n  | \"DATVotes\";\n\n/**\n * Provides contract deployment information with typed ABI.\n *\n * @remarks\n * Contains the minimum information needed to interact with a\n * deployed contract: its address and ABI.\n *\n * @typeParam TAbi - The contract's ABI type for full type safety\n *\n * @category Contracts\n */\nexport interface ContractInfo<TAbi extends Abi = Abi> {\n  /** The contract's deployed address */\n  address: Address;\n  /** The contract's ABI */\n  abi: TAbi;\n}\n\n/**\n * Tracks contract deployment metadata.\n *\n * @remarks\n * Records when and how a contract was deployed to the blockchain,\n * useful for verification and debugging.\n *\n * @category Contracts\n */\nexport interface ContractDeployment {\n  /** The contract's deployed address */\n  address: Address;\n  /** Block number where contract was deployed */\n  blockNumber: bigint;\n  /** Transaction hash of deployment */\n  transactionHash: Hash;\n}\n\n/**\n * Represents a fully typed contract instance.\n *\n * @remarks\n * Alias for viem's GetContractReturnType, providing a contract\n * instance with all methods fully typed based on the ABI.\n *\n * @typeParam TAbi - The contract's ABI type\n *\n * @category Contracts\n */\nexport type VanaContractInstance<TAbi extends Abi = Abi> =\n  GetContractReturnType<TAbi>;\n\n/**\n * Maps contract addresses by chain ID and contract name.\n *\n * @remarks\n * Hierarchical mapping structure for multi-chain contract deployments.\n * Used internally for address resolution across different networks.\n *\n * @category Contracts\n */\nexport type ContractAddresses = {\n  [chainId: number]: {\n    [contractName in VanaContractName]?: Address;\n  };\n};\n\n/**\n * Extracts typed parameters for a contract method from its ABI.\n *\n * @remarks\n * Advanced utility type that provides type-safe parameter extraction\n * from contract ABIs. Maps Solidity types to TypeScript types automatically.\n *\n * @typeParam TAbi - The contract's ABI type\n * @typeParam TFunctionName - The name of the function to extract parameters for\n *\n * @internal\n */\nexport type ContractMethodParams<\n  TAbi extends Abi,\n  TFunctionName extends string,\n> = TAbi extends readonly unknown[]\n  ? TAbi[number] extends {\n      name: TFunctionName;\n      type: \"function\";\n      inputs: infer TInputs;\n    }\n    ? TInputs extends readonly unknown[]\n      ? {\n          [K in keyof TInputs]: TInputs[K] extends {\n            name: infer TName;\n            type: infer TType;\n          }\n            ? TName extends string\n              ? TType extends \"address\"\n                ? Address\n                : TType extends \"uint256\"\n                  ? bigint\n                  : TType extends \"string\"\n                    ? string\n                    : TType extends \"bool\"\n                      ? boolean\n                      : TType extends \"bytes32\"\n                        ? Hash\n                        : unknown\n              : never\n            : never;\n        }\n      : never\n    : never\n  : never;\n\n/**\n * Extracts typed return values for a contract method from its ABI.\n *\n * @remarks\n * Advanced utility type that provides type-safe return type extraction\n * from contract ABIs. Handles single values and tuples appropriately.\n *\n * @typeParam TAbi - The contract's ABI type\n * @typeParam TFunctionName - The name of the function to extract return type for\n *\n * @internal\n */\nexport type ContractMethodReturnType<\n  TAbi extends Abi,\n  TFunctionName extends string,\n> = TAbi extends readonly unknown[]\n  ? TAbi[number] extends {\n      name: TFunctionName;\n      type: \"function\";\n      outputs: infer TOutputs;\n    }\n    ? TOutputs extends readonly unknown[]\n      ? TOutputs[\"length\"] extends 1\n        ? TOutputs[0] extends { type: infer TType }\n          ? TType extends \"address\"\n            ? Address\n            : TType extends \"uint256\"\n              ? bigint\n              : TType extends \"string\"\n                ? string\n                : TType extends \"bool\"\n                  ? boolean\n                  : TType extends \"bytes32\"\n                    ? Hash\n                    : unknown\n          : unknown\n        : {\n            [K in keyof TOutputs]: TOutputs[K] extends {\n              name: infer TName;\n              type: infer TType;\n            }\n              ? TName extends string\n                ? TType extends \"address\"\n                  ? Address\n                  : TType extends \"uint256\"\n                    ? bigint\n                    : TType extends \"string\"\n                      ? string\n                      : TType extends \"bool\"\n                        ? boolean\n                        : TType extends \"bytes32\"\n                          ? Hash\n                          : unknown\n                : never\n              : never;\n          }\n      : never\n    : never\n  : never;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/contracts.d.ts

@@ -20,7 +20,7 @@ import type { Abi, Address, Hash, GetContractReturnType } from "viem";
  *
  * @category Contracts
  */
-export type VanaContractName = "DataPortabilityPermissions" | "DataPortabilityServers" | "DataPortabilityGrantees" | "DataRegistry" | "TeePool" | "ComputeEngine" | "TeePoolPhala" | "DataRefinerRegistry" | "QueryEngine" | "ComputeInstructionRegistry" | "TeePoolEphemeralStandard" | "TeePoolPersistentStandard" | "TeePoolPersistentGpu" | "TeePoolDedicatedStandard" | "TeePoolDedicatedGpu" | "VanaEpoch" | "DLPRegistry" | "DLPRegistryTreasury" | "DLPPerformance" | "DLPRewardDeployer" | "DLPRewardDeployerTreasury" | "DLPRewardSwap" | "SwapHelper" | "VanaPoolStaking" | "VanaPoolEntity" | "VanaPoolTreasury" | "DAT" | "DATFactory" | "DATPausable" | "DATVotes" | "DataLiquidityPool" | "DLPRoot";
+export type VanaContractName = "DataPortabilityPermissions" | "DataPortabilityServers" | "DataPortabilityGrantees" | "DataRegistry" | "ComputeEngine" | "TeePoolPhala" | "DataRefinerRegistry" | "QueryEngine" | "ComputeInstructionRegistry" | "TeePoolEphemeralStandard" | "TeePoolPersistentStandard" | "TeePoolPersistentGpu" | "TeePoolDedicatedStandard" | "TeePoolDedicatedGpu" | "VanaEpoch" | "DLPRegistry" | "DLPRegistryTreasury" | "VanaPoolStaking" | "VanaPoolEntity" | "VanaPoolTreasury" | "DAT" | "DATFactory" | "DATPausable" | "DATVotes";
 /**
  * Provides contract deployment information with typed ABI.
  *

package/dist/types/index.cjs

@@ -18,48 +18,17 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var types_exports = {};
 __export(types_exports, {
-  SchemaValidationError: () => import_schemaValidation.SchemaValidationError,
-  SchemaValidator: () => import_schemaValidation.SchemaValidator,
   StorageError: () => import_storage.StorageError,
-  fetchAndValidateSchema: () => import_schemaValidation.fetchAndValidateSchema,
-  hasStorageConfig: () => import_config.hasStorageConfig,
-  isAPIResponse: () => import_external_apis.isAPIResponse,
-  isAddressOnlyConfig: () => import_config.isAddressOnlyConfig,
-  isChainConfig: () => import_config.isChainConfig,
-  isReadOnlyConfig: () => import_config.isReadOnlyConfig,
-  isReplicateAPIResponse: () => import_external_apis.isReplicateAPIResponse,
   isVanaChain: () => import_chains.isVanaChain,
-  isVanaChainId: () => import_chains.isVanaChainId,
-  isWalletConfig: () => import_config.isWalletConfig,
-  parseReplicateOutput: () => import_external_apis.parseReplicateOutput,
-  safeParseJSON: () => import_external_apis.safeParseJSON,
-  validateDataAgainstSchema: () => import_schemaValidation.validateDataAgainstSchema,
-  validateDataSchemaAgainstMetaSchema: () => import_schemaValidation.validateDataSchemaAgainstMetaSchema
+  isVanaChainId: () => import_chains.isVanaChainId
 });
 module.exports = __toCommonJS(types_exports);
-var import_config = require("./config");
 var import_chains = require("./chains");
 var import_storage = require("./storage");
-var import_schemaValidation = require("../utils/schemaValidation");
-var import_external_apis = require("./external-apis");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  SchemaValidationError,
-  SchemaValidator,
   StorageError,
-  fetchAndValidateSchema,
-  hasStorageConfig,
-  isAPIResponse,
-  isAddressOnlyConfig,
-  isChainConfig,
-  isReadOnlyConfig,
-  isReplicateAPIResponse,
   isVanaChain,
-  isVanaChainId,
-  isWalletConfig,
-  parseReplicateOutput,
-  safeParseJSON,
-  validateDataAgainstSchema,
-  validateDataSchemaAgainstMetaSchema
+  isVanaChainId
 });
 //# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Centralized type exports for the Vana SDK.\n *\n * @remarks\n * This module re-exports all public types from their respective modules,\n * providing a single import point for SDK consumers. Types are organized\n * by category for easy discovery and usage.\n *\n * **Import Strategy:**\n * - Import types from this module for application code\n * - Import from specific modules only for advanced use cases\n * - Avoid importing from internal paths\n *\n * @example\n * ```typescript\n * // Recommended: Import from types module\n * import type { VanaConfig, UserFile, GrantPermissionParams } from '@opendatalabs/vana-sdk';\n *\n * // Alternative: Import from specific category\n * import type { StorageProvider } from '@opendatalabs/vana-sdk';\n * ```\n *\n * @category Types\n * @module types\n */\n\n// Configuration types\nexport type {\n  BaseConfig,\n  BaseConfigWithStorage,\n  WalletConfig,\n  WalletConfigWithStorage,\n  ChainConfig,\n  ChainConfigWithStorage,\n  VanaConfig,\n  VanaConfigWithStorage,\n  VanaConfigWithWallet,\n  VanaConfigReadOnly,\n  VanaConfigAddressOnly,\n  VanaConfigWithWalletWithStorage,\n  VanaConfigReadOnlyWithStorage,\n  VanaConfigAddressOnlyWithStorage,\n  RuntimeConfig,\n  StorageConfig,\n  ConfigValidationOptions,\n  ConfigValidationResult,\n  DownloadRelayerCallbacks,\n  StorageRequiredMarker,\n  RelayerRequiredMarker,\n} from \"./config\";\n\nexport {\n  isWalletConfig,\n  isChainConfig,\n  isReadOnlyConfig,\n  isAddressOnlyConfig,\n  hasStorageConfig,\n} from \"./config\";\n\n// Chain types\nexport type { VanaChainId, VanaChain } from \"./chains\";\n\nexport { isVanaChainId, isVanaChain } from \"./chains\";\n\n// Contract types\nexport type {\n  VanaContractName,\n  ContractInfo,\n  ContractDeployment,\n  VanaContractInstance,\n  ContractAddresses,\n  ContractMethodParams,\n  ContractMethodReturnType,\n} from \"./contracts\";\n\n// Note: VanaContract and ContractAbis are exported directly from src/index.ts\n// to avoid circular dependencies. Do not re-export them here.\n\n// Storage types\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"./storage\";\n\nexport { StorageError } from \"./storage\";\n\n// Data types\nexport type {\n  UserFile,\n  FileMetadata,\n  UploadParams,\n  FilePermissionParams,\n  LegacyPermissionParams,\n  EncryptedUploadParams,\n  UnencryptedUploadParams,\n  UploadResult,\n  UploadFileParams,\n  UploadFileResult,\n  UploadEncryptedFileResult,\n  EncryptionInfo,\n  GetUserFilesParams,\n  GetFileParams,\n  EncryptFileOptions,\n  EncryptFileResult,\n  DecryptFileOptions,\n  UploadFileWithPermissionsParams,\n  AddFilePermissionParams,\n  DecryptFileWithPermissionOptions,\n  DownloadFileParams,\n  DownloadFileResult,\n  DeleteFileParams,\n  DeleteFileResult,\n  FileAccessPermissions,\n  FileSharingConfig,\n  BatchUploadParams,\n  BatchUploadResult,\n  SchemaMetadata,\n  CompleteSchema,\n  Schema,\n  Refiner,\n  AddSchemaParams,\n  AddSchemaResult,\n  AddRefinerParams,\n  AddRefinerResult,\n  UpdateSchemaIdParams,\n  UpdateSchemaIdResult,\n  TrustedServer,\n  GetUserTrustedServersParams,\n} from \"./data\";\n\n// Schema types\nexport type {\n  CreateSchemaParams,\n  CreateSchemaResult,\n} from \"../controllers/schemas\";\n\n// Schema validation types\nexport type { DataSchema } from \"../utils/schemaValidation\";\nexport {\n  SchemaValidationError,\n  SchemaValidator,\n  validateDataSchemaAgainstMetaSchema,\n  validateDataAgainstSchema,\n  fetchAndValidateSchema,\n} from \"../utils/schemaValidation\";\n\n// Permission types\nexport type {\n  OnChainPermissionGrant,\n  GetUserPermissionsOptions,\n  GrantPermissionParams,\n  RevokePermissionParams,\n  CheckPermissionParams,\n  PermissionCheckResult,\n  PermissionGrantDomain,\n  PermissionGrantMessage,\n  PermissionInputMessage,\n  SimplifiedPermissionMessage,\n  GrantFile,\n  PermissionGrantTypedData,\n  RevokePermissionTypedData,\n  GenericTypedData,\n  TypedDataPrimaryType,\n  SpecificTypedData,\n  PermissionOperation,\n  PermissionStatus,\n  QueryPermissionsParams,\n  PermissionQueryResult,\n  PermissionAnalytics,\n  PermissionEvent,\n  GrantedPermission,\n  Server,\n  AddAndTrustServerParams,\n  TrustServerParams,\n  UntrustServerParams,\n  AddAndTrustServerInput,\n  TrustServerInput,\n  UntrustServerInput,\n  AddAndTrustServerTypedData,\n  TrustServerTypedData,\n  UntrustServerTypedData,\n  PermissionInfo,\n  RevokePermissionInput,\n  TrustedServerInfo,\n  PaginatedTrustedServers,\n  TrustedServerQueryOptions,\n  BatchServerInfoResult,\n  ServerTrustStatus,\n  ServerInfo,\n  Grantee,\n  GranteeInfo,\n  RegisterGranteeParams,\n  RegisterGranteeInput,\n  RegisterGranteeTypedData,\n  GranteeQueryOptions,\n  PaginatedGrantees,\n  ServerFilesAndPermissionParams,\n  ServerFilesAndPermissionTypedData,\n  Permission,\n} from \"./permissions\";\n\n// Personal server types\nexport type {\n  PostRequestParams,\n  CreateOperationParams,\n  DownloadArtifactParams,\n  InitPersonalServerParams,\n  PersonalServerIdentity,\n} from \"./personal\";\n\n// Operations types\nexport type {\n  Operation,\n  Artifact,\n  PollingOptions,\n  TransactionResult,\n  TransactionReceipt as OperationTransactionReceipt,\n  TransactionWaitOptions,\n} from \"./operations\";\n\n// Server API types (auto-generated via fetch-server-types.ts)\nexport type * from \"../generated/server/server-exports\";\n\n// External API types\nexport type {\n  ReplicateAPIResponse,\n  ReplicateStatus,\n  PinataUploadResponse,\n  PinataPin,\n  PinataListResponse,\n  APIResponse,\n} from \"./external-apis\";\n\nexport {\n  isReplicateAPIResponse,\n  isAPIResponse,\n  safeParseJSON,\n  parseReplicateOutput,\n} from \"./external-apis\";\n\n// Relayer types\nexport type {\n  RelayerStorageResponse,\n  RelayerTransactionResponse,\n  RelayerStoreParams,\n  RelayerSubmitParams,\n  RelayerStatus,\n  RelayerConfig,\n  UnifiedRelayerRequest,\n  UnifiedRelayerResponse,\n  SignedRelayerRequest,\n  DirectRelayerRequest,\n  RelayerRequestOptions,\n  RelayerErrorResponse,\n  RelayerQueueInfo,\n  RelayerTransactionStatus,\n  RelayerMetrics,\n  RelayerWebhookConfig,\n  RelayerWebhookPayload,\n} from \"./relayer\";\n\n// Utility types\nexport type {\n  PartialExcept,\n  RequiredExcept,\n  Awaited,\n  MaybePromise,\n  MaybeArray,\n  PaginationParams,\n  PaginationResult,\n  BlockRange,\n  ApiResponse,\n  CacheConfig,\n  ValidationResult,\n  StatusInfo,\n  RateLimitInfo,\n  UploadProgress,\n  NetworkInfo,\n  GasEstimate,\n  TimeRange,\n} from \"./utils\";\n\n// Operation store types\nexport type {\n  IOperationStore,\n  StoredOperation,\n  IRelayerStateStore,\n  OperationState,\n} from \"./operationStore\";\n\n// Options types\nexport type {\n  ConsistencyOptions,\n  DataSource,\n  PaginationOptions,\n  ListOptions,\n  WriteOptions,\n  LegacyTransactionOptions,\n} from \"./options\";\n\n// Generic types for extensibility\nexport type {\n  GenericRequest,\n  GenericResponse,\n  AsyncResult,\n  ContractCall,\n  EventFilter,\n  EventLog,\n  ControllerContext,\n  Controller,\n  Cache,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n  Plugin,\n  Factory,\n  Repository,\n  Validator,\n  Transformer,\n  Service,\n  Observer,\n  Observable,\n  StateMachine,\n  ConditionalOptional,\n  PromiseResult,\n  AllKeys,\n  DeepPartial,\n  DeepReadonly,\n  RequireKeys,\n  OptionalKeys,\n  NonNullable,\n  PickByType,\n  OmitByType,\n  Brand,\n  Nominal,\n} from \"./generics\";\n\n// Re-export viem types that are commonly used\nexport type {\n  Address,\n  Hash,\n  Abi,\n  Chain,\n  WalletClient,\n  PublicClient,\n  Account,\n  GetContractReturnType,\n} from \"viem\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmDA,oBAMO;AAKP,oBAA2C;AAyB3C,qBAA6B;AAsD7B,8BAMO;AAyFP,2BAKO;","names":[]}
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Centralized type exports for the Vana SDK.\n *\n * @remarks\n * This module re-exports all public types from their respective modules,\n * providing a single import point for SDK consumers.\n *\n * @category Types\n * @module types\n */\n\n// Chain types\nexport type { VanaChainId, VanaChain } from \"./chains\";\nexport { isVanaChainId, isVanaChain } from \"./chains\";\n\n// Contract types\nexport type {\n  VanaContractName,\n  ContractInfo,\n  ContractDeployment,\n  VanaContractInstance,\n  ContractAddresses,\n  ContractMethodParams,\n  ContractMethodReturnType,\n} from \"./contracts\";\n\n// Storage types\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"./storage\";\n\nexport { StorageError } from \"./storage\";\n\n// Storage callback types\nexport type {\n  StorageCallbacks,\n  StorageDownloadOptions,\n  StorageListResult,\n} from \"./config\";\n\n// Re-export viem types that are commonly used\nexport type {\n  Address,\n  Hash,\n  Abi,\n  Chain,\n  WalletClient,\n  PublicClient,\n  Account,\n  GetContractReturnType,\n} from \"viem\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,oBAA2C;AAsB3C,qBAA6B;","names":[]}

package/dist/types/index.d.ts

@@ -3,46 +3,15 @@
  *
  * @remarks
  * This module re-exports all public types from their respective modules,
- * providing a single import point for SDK consumers. Types are organized
- * by category for easy discovery and usage.
- *
- * **Import Strategy:**
- * - Import types from this module for application code
- * - Import from specific modules only for advanced use cases
- * - Avoid importing from internal paths
- *
- * @example
- * ```typescript
- * // Recommended: Import from types module
- * import type { VanaConfig, UserFile, GrantPermissionParams } from '@opendatalabs/vana-sdk';
- *
- * // Alternative: Import from specific category
- * import type { StorageProvider } from '@opendatalabs/vana-sdk';
- * ```
+ * providing a single import point for SDK consumers.
  *
  * @category Types
  * @module types
  */
-export type { BaseConfig, BaseConfigWithStorage, WalletConfig, WalletConfigWithStorage, ChainConfig, ChainConfigWithStorage, VanaConfig, VanaConfigWithStorage, VanaConfigWithWallet, VanaConfigReadOnly, VanaConfigAddressOnly, VanaConfigWithWalletWithStorage, VanaConfigReadOnlyWithStorage, VanaConfigAddressOnlyWithStorage, RuntimeConfig, StorageConfig, ConfigValidationOptions, ConfigValidationResult, DownloadRelayerCallbacks, StorageRequiredMarker, RelayerRequiredMarker, } from "./config";
-export { isWalletConfig, isChainConfig, isReadOnlyConfig, isAddressOnlyConfig, hasStorageConfig, } from "./config";
 export type { VanaChainId, VanaChain } from "./chains";
 export { isVanaChainId, isVanaChain } from "./chains";
 export type { VanaContractName, ContractInfo, ContractDeployment, VanaContractInstance, ContractAddresses, ContractMethodParams, ContractMethodReturnType, } from "./contracts";
 export type { StorageProvider, StorageUploadResult, StorageFile, StorageListOptions, StorageProviderConfig, } from "./storage";
 export { StorageError } from "./storage";
-export type { UserFile, FileMetadata, UploadParams, FilePermissionParams, LegacyPermissionParams, EncryptedUploadParams, UnencryptedUploadParams, UploadResult, UploadFileParams, UploadFileResult, UploadEncryptedFileResult, EncryptionInfo, GetUserFilesParams, GetFileParams, EncryptFileOptions, EncryptFileResult, DecryptFileOptions, UploadFileWithPermissionsParams, AddFilePermissionParams, DecryptFileWithPermissionOptions, DownloadFileParams, DownloadFileResult, DeleteFileParams, DeleteFileResult, FileAccessPermissions, FileSharingConfig, BatchUploadParams, BatchUploadResult, SchemaMetadata, CompleteSchema, Schema, Refiner, AddSchemaParams, AddSchemaResult, AddRefinerParams, AddRefinerResult, UpdateSchemaIdParams, UpdateSchemaIdResult, TrustedServer, GetUserTrustedServersParams, } from "./data";
-export type { CreateSchemaParams, CreateSchemaResult, } from "../controllers/schemas";
-export type { DataSchema } from "../utils/schemaValidation";
-export { SchemaValidationError, SchemaValidator, validateDataSchemaAgainstMetaSchema, validateDataAgainstSchema, fetchAndValidateSchema, } from "../utils/schemaValidation";
-export type { OnChainPermissionGrant, GetUserPermissionsOptions, GrantPermissionParams, RevokePermissionParams, CheckPermissionParams, PermissionCheckResult, PermissionGrantDomain, PermissionGrantMessage, PermissionInputMessage, SimplifiedPermissionMessage, GrantFile, PermissionGrantTypedData, RevokePermissionTypedData, GenericTypedData, TypedDataPrimaryType, SpecificTypedData, PermissionOperation, PermissionStatus, QueryPermissionsParams, PermissionQueryResult, PermissionAnalytics, PermissionEvent, GrantedPermission, Server, AddAndTrustServerParams, TrustServerParams, UntrustServerParams, AddAndTrustServerInput, TrustServerInput, UntrustServerInput, AddAndTrustServerTypedData, TrustServerTypedData, UntrustServerTypedData, PermissionInfo, RevokePermissionInput, TrustedServerInfo, PaginatedTrustedServers, TrustedServerQueryOptions, BatchServerInfoResult, ServerTrustStatus, ServerInfo, Grantee, GranteeInfo, RegisterGranteeParams, RegisterGranteeInput, RegisterGranteeTypedData, GranteeQueryOptions, PaginatedGrantees, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, Permission, } from "./permissions";
-export type { PostRequestParams, CreateOperationParams, DownloadArtifactParams, InitPersonalServerParams, PersonalServerIdentity, } from "./personal";
-export type { Operation, Artifact, PollingOptions, TransactionResult, TransactionReceipt as OperationTransactionReceipt, TransactionWaitOptions, } from "./operations";
-export type * from "../generated/server/server-exports";
-export type { ReplicateAPIResponse, ReplicateStatus, PinataUploadResponse, PinataPin, PinataListResponse, APIResponse, } from "./external-apis";
-export { isReplicateAPIResponse, isAPIResponse, safeParseJSON, parseReplicateOutput, } from "./external-apis";
-export type { RelayerStorageResponse, RelayerTransactionResponse, RelayerStoreParams, RelayerSubmitParams, RelayerStatus, RelayerConfig, UnifiedRelayerRequest, UnifiedRelayerResponse, SignedRelayerRequest, DirectRelayerRequest, RelayerRequestOptions, RelayerErrorResponse, RelayerQueueInfo, RelayerTransactionStatus, RelayerMetrics, RelayerWebhookConfig, RelayerWebhookPayload, } from "./relayer";
-export type { PartialExcept, RequiredExcept, Awaited, MaybePromise, MaybeArray, PaginationParams, PaginationResult, BlockRange, ApiResponse, CacheConfig, ValidationResult, StatusInfo, RateLimitInfo, UploadProgress, NetworkInfo, GasEstimate, TimeRange, } from "./utils";
-export type { IOperationStore, StoredOperation, IRelayerStateStore, OperationState, } from "./operationStore";
-export type { ConsistencyOptions, DataSource, PaginationOptions, ListOptions, WriteOptions, LegacyTransactionOptions, } from "./options";
-export type { GenericRequest, GenericResponse, AsyncResult, ContractCall, EventFilter, EventLog, ControllerContext, Controller, Cache, RetryConfig, RateLimiterConfig, Middleware, Plugin, Factory, Repository, Validator, Transformer, Service, Observer, Observable, StateMachine, ConditionalOptional, PromiseResult, AllKeys, DeepPartial, DeepReadonly, RequireKeys, OptionalKeys, NonNullable, PickByType, OmitByType, Brand, Nominal, } from "./generics";
+export type { StorageCallbacks, StorageDownloadOptions, StorageListResult, } from "./config";
 export type { Address, Hash, Abi, Chain, WalletClient, PublicClient, Account, GetContractReturnType, } from "viem";

package/dist/types/index.js

@@ -1,42 +1,8 @@
-import {
-  isWalletConfig,
-  isChainConfig,
-  isReadOnlyConfig,
-  isAddressOnlyConfig,
-  hasStorageConfig
-} from "./config";
 import { isVanaChainId, isVanaChain } from "./chains";
 import { StorageError } from "./storage";
-import {
-  SchemaValidationError,
-  SchemaValidator,
-  validateDataSchemaAgainstMetaSchema,
-  validateDataAgainstSchema,
-  fetchAndValidateSchema
-} from "../utils/schemaValidation";
-import {
-  isReplicateAPIResponse,
-  isAPIResponse,
-  safeParseJSON,
-  parseReplicateOutput
-} from "./external-apis";
 export {
-  SchemaValidationError,
-  SchemaValidator,
   StorageError,
-  fetchAndValidateSchema,
-  hasStorageConfig,
-  isAPIResponse,
-  isAddressOnlyConfig,
-  isChainConfig,
-  isReadOnlyConfig,
-  isReplicateAPIResponse,
   isVanaChain,
-  isVanaChainId,
-  isWalletConfig,
-  parseReplicateOutput,
-  safeParseJSON,
-  validateDataAgainstSchema,
-  validateDataSchemaAgainstMetaSchema
+  isVanaChainId
 };
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Centralized type exports for the Vana SDK.\n *\n * @remarks\n * This module re-exports all public types from their respective modules,\n * providing a single import point for SDK consumers. Types are organized\n * by category for easy discovery and usage.\n *\n * **Import Strategy:**\n * - Import types from this module for application code\n * - Import from specific modules only for advanced use cases\n * - Avoid importing from internal paths\n *\n * @example\n * ```typescript\n * // Recommended: Import from types module\n * import type { VanaConfig, UserFile, GrantPermissionParams } from '@opendatalabs/vana-sdk';\n *\n * // Alternative: Import from specific category\n * import type { StorageProvider } from '@opendatalabs/vana-sdk';\n * ```\n *\n * @category Types\n * @module types\n */\n\n// Configuration types\nexport type {\n  BaseConfig,\n  BaseConfigWithStorage,\n  WalletConfig,\n  WalletConfigWithStorage,\n  ChainConfig,\n  ChainConfigWithStorage,\n  VanaConfig,\n  VanaConfigWithStorage,\n  VanaConfigWithWallet,\n  VanaConfigReadOnly,\n  VanaConfigAddressOnly,\n  VanaConfigWithWalletWithStorage,\n  VanaConfigReadOnlyWithStorage,\n  VanaConfigAddressOnlyWithStorage,\n  RuntimeConfig,\n  StorageConfig,\n  ConfigValidationOptions,\n  ConfigValidationResult,\n  DownloadRelayerCallbacks,\n  StorageRequiredMarker,\n  RelayerRequiredMarker,\n} from \"./config\";\n\nexport {\n  isWalletConfig,\n  isChainConfig,\n  isReadOnlyConfig,\n  isAddressOnlyConfig,\n  hasStorageConfig,\n} from \"./config\";\n\n// Chain types\nexport type { VanaChainId, VanaChain } from \"./chains\";\n\nexport { isVanaChainId, isVanaChain } from \"./chains\";\n\n// Contract types\nexport type {\n  VanaContractName,\n  ContractInfo,\n  ContractDeployment,\n  VanaContractInstance,\n  ContractAddresses,\n  ContractMethodParams,\n  ContractMethodReturnType,\n} from \"./contracts\";\n\n// Note: VanaContract and ContractAbis are exported directly from src/index.ts\n// to avoid circular dependencies. Do not re-export them here.\n\n// Storage types\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"./storage\";\n\nexport { StorageError } from \"./storage\";\n\n// Data types\nexport type {\n  UserFile,\n  FileMetadata,\n  UploadParams,\n  FilePermissionParams,\n  LegacyPermissionParams,\n  EncryptedUploadParams,\n  UnencryptedUploadParams,\n  UploadResult,\n  UploadFileParams,\n  UploadFileResult,\n  UploadEncryptedFileResult,\n  EncryptionInfo,\n  GetUserFilesParams,\n  GetFileParams,\n  EncryptFileOptions,\n  EncryptFileResult,\n  DecryptFileOptions,\n  UploadFileWithPermissionsParams,\n  AddFilePermissionParams,\n  DecryptFileWithPermissionOptions,\n  DownloadFileParams,\n  DownloadFileResult,\n  DeleteFileParams,\n  DeleteFileResult,\n  FileAccessPermissions,\n  FileSharingConfig,\n  BatchUploadParams,\n  BatchUploadResult,\n  SchemaMetadata,\n  CompleteSchema,\n  Schema,\n  Refiner,\n  AddSchemaParams,\n  AddSchemaResult,\n  AddRefinerParams,\n  AddRefinerResult,\n  UpdateSchemaIdParams,\n  UpdateSchemaIdResult,\n  TrustedServer,\n  GetUserTrustedServersParams,\n} from \"./data\";\n\n// Schema types\nexport type {\n  CreateSchemaParams,\n  CreateSchemaResult,\n} from \"../controllers/schemas\";\n\n// Schema validation types\nexport type { DataSchema } from \"../utils/schemaValidation\";\nexport {\n  SchemaValidationError,\n  SchemaValidator,\n  validateDataSchemaAgainstMetaSchema,\n  validateDataAgainstSchema,\n  fetchAndValidateSchema,\n} from \"../utils/schemaValidation\";\n\n// Permission types\nexport type {\n  OnChainPermissionGrant,\n  GetUserPermissionsOptions,\n  GrantPermissionParams,\n  RevokePermissionParams,\n  CheckPermissionParams,\n  PermissionCheckResult,\n  PermissionGrantDomain,\n  PermissionGrantMessage,\n  PermissionInputMessage,\n  SimplifiedPermissionMessage,\n  GrantFile,\n  PermissionGrantTypedData,\n  RevokePermissionTypedData,\n  GenericTypedData,\n  TypedDataPrimaryType,\n  SpecificTypedData,\n  PermissionOperation,\n  PermissionStatus,\n  QueryPermissionsParams,\n  PermissionQueryResult,\n  PermissionAnalytics,\n  PermissionEvent,\n  GrantedPermission,\n  Server,\n  AddAndTrustServerParams,\n  TrustServerParams,\n  UntrustServerParams,\n  AddAndTrustServerInput,\n  TrustServerInput,\n  UntrustServerInput,\n  AddAndTrustServerTypedData,\n  TrustServerTypedData,\n  UntrustServerTypedData,\n  PermissionInfo,\n  RevokePermissionInput,\n  TrustedServerInfo,\n  PaginatedTrustedServers,\n  TrustedServerQueryOptions,\n  BatchServerInfoResult,\n  ServerTrustStatus,\n  ServerInfo,\n  Grantee,\n  GranteeInfo,\n  RegisterGranteeParams,\n  RegisterGranteeInput,\n  RegisterGranteeTypedData,\n  GranteeQueryOptions,\n  PaginatedGrantees,\n  ServerFilesAndPermissionParams,\n  ServerFilesAndPermissionTypedData,\n  Permission,\n} from \"./permissions\";\n\n// Personal server types\nexport type {\n  PostRequestParams,\n  CreateOperationParams,\n  DownloadArtifactParams,\n  InitPersonalServerParams,\n  PersonalServerIdentity,\n} from \"./personal\";\n\n// Operations types\nexport type {\n  Operation,\n  Artifact,\n  PollingOptions,\n  TransactionResult,\n  TransactionReceipt as OperationTransactionReceipt,\n  TransactionWaitOptions,\n} from \"./operations\";\n\n// Server API types (auto-generated via fetch-server-types.ts)\nexport type * from \"../generated/server/server-exports\";\n\n// External API types\nexport type {\n  ReplicateAPIResponse,\n  ReplicateStatus,\n  PinataUploadResponse,\n  PinataPin,\n  PinataListResponse,\n  APIResponse,\n} from \"./external-apis\";\n\nexport {\n  isReplicateAPIResponse,\n  isAPIResponse,\n  safeParseJSON,\n  parseReplicateOutput,\n} from \"./external-apis\";\n\n// Relayer types\nexport type {\n  RelayerStorageResponse,\n  RelayerTransactionResponse,\n  RelayerStoreParams,\n  RelayerSubmitParams,\n  RelayerStatus,\n  RelayerConfig,\n  UnifiedRelayerRequest,\n  UnifiedRelayerResponse,\n  SignedRelayerRequest,\n  DirectRelayerRequest,\n  RelayerRequestOptions,\n  RelayerErrorResponse,\n  RelayerQueueInfo,\n  RelayerTransactionStatus,\n  RelayerMetrics,\n  RelayerWebhookConfig,\n  RelayerWebhookPayload,\n} from \"./relayer\";\n\n// Utility types\nexport type {\n  PartialExcept,\n  RequiredExcept,\n  Awaited,\n  MaybePromise,\n  MaybeArray,\n  PaginationParams,\n  PaginationResult,\n  BlockRange,\n  ApiResponse,\n  CacheConfig,\n  ValidationResult,\n  StatusInfo,\n  RateLimitInfo,\n  UploadProgress,\n  NetworkInfo,\n  GasEstimate,\n  TimeRange,\n} from \"./utils\";\n\n// Operation store types\nexport type {\n  IOperationStore,\n  StoredOperation,\n  IRelayerStateStore,\n  OperationState,\n} from \"./operationStore\";\n\n// Options types\nexport type {\n  ConsistencyOptions,\n  DataSource,\n  PaginationOptions,\n  ListOptions,\n  WriteOptions,\n  LegacyTransactionOptions,\n} from \"./options\";\n\n// Generic types for extensibility\nexport type {\n  GenericRequest,\n  GenericResponse,\n  AsyncResult,\n  ContractCall,\n  EventFilter,\n  EventLog,\n  ControllerContext,\n  Controller,\n  Cache,\n  RetryConfig,\n  RateLimiterConfig,\n  Middleware,\n  Plugin,\n  Factory,\n  Repository,\n  Validator,\n  Transformer,\n  Service,\n  Observer,\n  Observable,\n  StateMachine,\n  ConditionalOptional,\n  PromiseResult,\n  AllKeys,\n  DeepPartial,\n  DeepReadonly,\n  RequireKeys,\n  OptionalKeys,\n  NonNullable,\n  PickByType,\n  OmitByType,\n  Brand,\n  Nominal,\n} from \"./generics\";\n\n// Re-export viem types that are commonly used\nexport type {\n  Address,\n  Hash,\n  Abi,\n  Chain,\n  WalletClient,\n  PublicClient,\n  Account,\n  GetContractReturnType,\n} from \"viem\";\n"],"mappings":"AAmDA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,eAAe,mBAAmB;AAyB3C,SAAS,oBAAoB;AAsD7B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAyFP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Centralized type exports for the Vana SDK.\n *\n * @remarks\n * This module re-exports all public types from their respective modules,\n * providing a single import point for SDK consumers.\n *\n * @category Types\n * @module types\n */\n\n// Chain types\nexport type { VanaChainId, VanaChain } from \"./chains\";\nexport { isVanaChainId, isVanaChain } from \"./chains\";\n\n// Contract types\nexport type {\n  VanaContractName,\n  ContractInfo,\n  ContractDeployment,\n  VanaContractInstance,\n  ContractAddresses,\n  ContractMethodParams,\n  ContractMethodReturnType,\n} from \"./contracts\";\n\n// Storage types\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"./storage\";\n\nexport { StorageError } from \"./storage\";\n\n// Storage callback types\nexport type {\n  StorageCallbacks,\n  StorageDownloadOptions,\n  StorageListResult,\n} from \"./config\";\n\n// Re-export viem types that are commonly used\nexport type {\n  Address,\n  Hash,\n  Abi,\n  Chain,\n  WalletClient,\n  PublicClient,\n  Account,\n  GetContractReturnType,\n} from \"viem\";\n"],"mappings":"AAaA,SAAS,eAAe,mBAAmB;AAsB3C,SAAS,oBAAoB;","names":[]}

package/dist/types/ps-errors.cjs

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ps_errors_exports = {};
+__export(ps_errors_exports, {
+  PSError: () => PSError,
+  parsePSError: () => parsePSError
+});
+module.exports = __toCommonJS(ps_errors_exports);
+class PSError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "PSError";
+  }
+  code;
+}
+const KNOWN_CODES = /* @__PURE__ */ new Set([
+  "missing_auth",
+  "invalid_signature",
+  "unregistered_builder",
+  "not_owner",
+  "expired_token",
+  "grant_invalid",
+  "grant_required",
+  "grant_expired",
+  "grant_revoked",
+  "scope_mismatch",
+  "fee_required",
+  "ps_unavailable",
+  "server_not_configured",
+  "content_too_large"
+]);
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeCode(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const code = value.toLowerCase();
+  return KNOWN_CODES.has(code) ? code : null;
+}
+function extractPSErrorBody(body) {
+  if (!isRecord(body)) {
+    return null;
+  }
+  const nested = isRecord(body.error) ? body.error : null;
+  const code = normalizeCode(
+    nested?.errorCode ?? nested?.code ?? body.errorCode ?? body.code
+  );
+  const message = nested?.message ?? body.message;
+  if (!code || typeof message !== "string") {
+    return null;
+  }
+  return { code, message };
+}
+async function parsePSError(response) {
+  if (response.ok) {
+    return null;
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    return null;
+  }
+  const errorBody = extractPSErrorBody(body);
+  return errorBody ? new PSError(errorBody.code, errorBody.message) : null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PSError,
+  parsePSError
+});
+//# sourceMappingURL=ps-errors.cjs.map

package/dist/types/ps-errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/ps-errors.ts"],"sourcesContent":["/**\n * Typed errors returned by Personal Server endpoints.\n *\n * @remarks\n * vana-connect (and other PS clients) need to branch on a small, stable set\n * of lowercase error codes. Personal Server routes currently return protocol\n * errors as `{ error: { code, errorCode, message } }`, while older PoC\n * clients used `{ code, message }`; the parser accepts both shapes.\n *\n * @category Auth\n */\n\n/** Stable error codes returned by Personal Server. */\nexport type PSErrorCode =\n  | \"missing_auth\"\n  | \"invalid_signature\"\n  | \"unregistered_builder\"\n  | \"not_owner\"\n  | \"expired_token\"\n  | \"grant_invalid\"\n  | \"grant_required\"\n  | \"grant_expired\"\n  | \"grant_revoked\"\n  | \"scope_mismatch\"\n  | \"fee_required\"\n  | \"ps_unavailable\"\n  | \"server_not_configured\"\n  | \"content_too_large\";\n\n/** Typed error wrapping a non-2xx Personal Server response. */\nexport class PSError extends Error {\n  constructor(\n    public readonly code: PSErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"PSError\";\n  }\n}\n\nconst KNOWN_CODES: ReadonlySet<PSErrorCode> = new Set<PSErrorCode>([\n  \"missing_auth\",\n  \"invalid_signature\",\n  \"unregistered_builder\",\n  \"not_owner\",\n  \"expired_token\",\n  \"grant_invalid\",\n  \"grant_required\",\n  \"grant_expired\",\n  \"grant_revoked\",\n  \"scope_mismatch\",\n  \"fee_required\",\n  \"ps_unavailable\",\n  \"server_not_configured\",\n  \"content_too_large\",\n]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction normalizeCode(value: unknown): PSErrorCode | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const code = value.toLowerCase() as PSErrorCode;\n  return KNOWN_CODES.has(code) ? code : null;\n}\n\nfunction extractPSErrorBody(\n  body: unknown,\n): { code: PSErrorCode; message: string } | null {\n  if (!isRecord(body)) {\n    return null;\n  }\n\n  const nested = isRecord(body.error) ? body.error : null;\n  const code = normalizeCode(\n    nested?.errorCode ?? nested?.code ?? body.errorCode ?? body.code,\n  );\n  const message = nested?.message ?? body.message;\n\n  if (!code || typeof message !== \"string\") {\n    return null;\n  }\n\n  return { code, message };\n}\n\n/**\n * Read a Personal Server JSON error body from a non-2xx {@link Response} and\n * return the typed {@link PSError}. The returned code is always lowercase.\n *\n * @returns A {@link PSError} for non-2xx responses with a recognised code,\n *   or `null` for 2xx responses, malformed JSON, or unrecognised codes.\n */\nexport async function parsePSError(\n  response: Response,\n): Promise<PSError | null> {\n  if (response.ok) {\n    return null;\n  }\n\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return null;\n  }\n\n  const errorBody = extractPSErrorBody(body);\n  return errorBody ? new PSError(errorBody.code, errorBody.message) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BO,MAAM,gBAAgB,MAAM;AAAA,EACjC,YACkB,MAChB,SACA;AACA,UAAM,OAAO;AAHG;AAIhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAMpB;AAEA,MAAM,cAAwC,oBAAI,IAAiB;AAAA,EACjE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,SAAS,OAAkD;AAClE,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,cAAc,OAAoC;AACzD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,QAAM,OAAO,MAAM,YAAY;AAC/B,SAAO,YAAY,IAAI,IAAI,IAAI,OAAO;AACxC;AAEA,SAAS,mBACP,MAC+C;AAC/C,MAAI,CAAC,SAAS,IAAI,GAAG;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,SAAS,KAAK,KAAK,IAAI,KAAK,QAAQ;AACnD,QAAM,OAAO;AAAA,IACX,QAAQ,aAAa,QAAQ,QAAQ,KAAK,aAAa,KAAK;AAAA,EAC9D;AACA,QAAM,UAAU,QAAQ,WAAW,KAAK;AAExC,MAAI,CAAC,QAAQ,OAAO,YAAY,UAAU;AACxC,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,MAAM,QAAQ;AACzB;AASA,eAAsB,aACpB,UACyB;AACzB,MAAI,SAAS,IAAI;AACf,WAAO;AAAA,EACT;AAEA,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,SAAS,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,mBAAmB,IAAI;AACzC,SAAO,YAAY,IAAI,QAAQ,UAAU,MAAM,UAAU,OAAO,IAAI;AACtE;","names":[]}

package/dist/types/ps-errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Typed errors returned by Personal Server endpoints.
+ *
+ * @remarks
+ * vana-connect (and other PS clients) need to branch on a small, stable set
+ * of lowercase error codes. Personal Server routes currently return protocol
+ * errors as `{ error: { code, errorCode, message } }`, while older PoC
+ * clients used `{ code, message }`; the parser accepts both shapes.
+ *
+ * @category Auth
+ */
+/** Stable error codes returned by Personal Server. */
+export type PSErrorCode = "missing_auth" | "invalid_signature" | "unregistered_builder" | "not_owner" | "expired_token" | "grant_invalid" | "grant_required" | "grant_expired" | "grant_revoked" | "scope_mismatch" | "fee_required" | "ps_unavailable" | "server_not_configured" | "content_too_large";
+/** Typed error wrapping a non-2xx Personal Server response. */
+export declare class PSError extends Error {
+    readonly code: PSErrorCode;
+    constructor(code: PSErrorCode, message: string);
+}
+/**
+ * Read a Personal Server JSON error body from a non-2xx {@link Response} and
+ * return the typed {@link PSError}. The returned code is always lowercase.
+ *
+ * @returns A {@link PSError} for non-2xx responses with a recognised code,
+ *   or `null` for 2xx responses, malformed JSON, or unrecognised codes.
+ */
+export declare function parsePSError(response: Response): Promise<PSError | null>;

package/dist/types/ps-errors.js

@@ -0,0 +1,66 @@
+class PSError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "PSError";
+  }
+  code;
+}
+const KNOWN_CODES = /* @__PURE__ */ new Set([
+  "missing_auth",
+  "invalid_signature",
+  "unregistered_builder",
+  "not_owner",
+  "expired_token",
+  "grant_invalid",
+  "grant_required",
+  "grant_expired",
+  "grant_revoked",
+  "scope_mismatch",
+  "fee_required",
+  "ps_unavailable",
+  "server_not_configured",
+  "content_too_large"
+]);
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeCode(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const code = value.toLowerCase();
+  return KNOWN_CODES.has(code) ? code : null;
+}
+function extractPSErrorBody(body) {
+  if (!isRecord(body)) {
+    return null;
+  }
+  const nested = isRecord(body.error) ? body.error : null;
+  const code = normalizeCode(
+    nested?.errorCode ?? nested?.code ?? body.errorCode ?? body.code
+  );
+  const message = nested?.message ?? body.message;
+  if (!code || typeof message !== "string") {
+    return null;
+  }
+  return { code, message };
+}
+async function parsePSError(response) {
+  if (response.ok) {
+    return null;
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    return null;
+  }
+  const errorBody = extractPSErrorBody(body);
+  return errorBody ? new PSError(errorBody.code, errorBody.message) : null;
+}
+export {
+  PSError,
+  parsePSError
+};
+//# sourceMappingURL=ps-errors.js.map

package/dist/types/ps-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/ps-errors.ts"],"sourcesContent":["/**\n * Typed errors returned by Personal Server endpoints.\n *\n * @remarks\n * vana-connect (and other PS clients) need to branch on a small, stable set\n * of lowercase error codes. Personal Server routes currently return protocol\n * errors as `{ error: { code, errorCode, message } }`, while older PoC\n * clients used `{ code, message }`; the parser accepts both shapes.\n *\n * @category Auth\n */\n\n/** Stable error codes returned by Personal Server. */\nexport type PSErrorCode =\n  | \"missing_auth\"\n  | \"invalid_signature\"\n  | \"unregistered_builder\"\n  | \"not_owner\"\n  | \"expired_token\"\n  | \"grant_invalid\"\n  | \"grant_required\"\n  | \"grant_expired\"\n  | \"grant_revoked\"\n  | \"scope_mismatch\"\n  | \"fee_required\"\n  | \"ps_unavailable\"\n  | \"server_not_configured\"\n  | \"content_too_large\";\n\n/** Typed error wrapping a non-2xx Personal Server response. */\nexport class PSError extends Error {\n  constructor(\n    public readonly code: PSErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"PSError\";\n  }\n}\n\nconst KNOWN_CODES: ReadonlySet<PSErrorCode> = new Set<PSErrorCode>([\n  \"missing_auth\",\n  \"invalid_signature\",\n  \"unregistered_builder\",\n  \"not_owner\",\n  \"expired_token\",\n  \"grant_invalid\",\n  \"grant_required\",\n  \"grant_expired\",\n  \"grant_revoked\",\n  \"scope_mismatch\",\n  \"fee_required\",\n  \"ps_unavailable\",\n  \"server_not_configured\",\n  \"content_too_large\",\n]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction normalizeCode(value: unknown): PSErrorCode | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const code = value.toLowerCase() as PSErrorCode;\n  return KNOWN_CODES.has(code) ? code : null;\n}\n\nfunction extractPSErrorBody(\n  body: unknown,\n): { code: PSErrorCode; message: string } | null {\n  if (!isRecord(body)) {\n    return null;\n  }\n\n  const nested = isRecord(body.error) ? body.error : null;\n  const code = normalizeCode(\n    nested?.errorCode ?? nested?.code ?? body.errorCode ?? body.code,\n  );\n  const message = nested?.message ?? body.message;\n\n  if (!code || typeof message !== \"string\") {\n    return null;\n  }\n\n  return { code, message };\n}\n\n/**\n * Read a Personal Server JSON error body from a non-2xx {@link Response} and\n * return the typed {@link PSError}. The returned code is always lowercase.\n *\n * @returns A {@link PSError} for non-2xx responses with a recognised code,\n *   or `null` for 2xx responses, malformed JSON, or unrecognised codes.\n */\nexport async function parsePSError(\n  response: Response,\n): Promise<PSError | null> {\n  if (response.ok) {\n    return null;\n  }\n\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    return null;\n  }\n\n  const errorBody = extractPSErrorBody(body);\n  return errorBody ? new PSError(errorBody.code, errorBody.message) : null;\n}\n"],"mappings":"AA8BO,MAAM,gBAAgB,MAAM;AAAA,EACjC,YACkB,MAChB,SACA;AACA,UAAM,OAAO;AAHG;AAIhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAMpB;AAEA,MAAM,cAAwC,oBAAI,IAAiB;AAAA,EACjE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,SAAS,OAAkD;AAClE,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,cAAc,OAAoC;AACzD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,QAAM,OAAO,MAAM,YAAY;AAC/B,SAAO,YAAY,IAAI,IAAI,IAAI,OAAO;AACxC;AAEA,SAAS,mBACP,MAC+C;AAC/C,MAAI,CAAC,SAAS,IAAI,GAAG;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,SAAS,KAAK,KAAK,IAAI,KAAK,QAAQ;AACnD,QAAM,OAAO;AAAA,IACX,QAAQ,aAAa,QAAQ,QAAQ,KAAK,aAAa,KAAK;AAAA,EAC9D;AACA,QAAM,UAAU,QAAQ,WAAW,KAAK;AAExC,MAAI,CAAC,QAAQ,OAAO,YAAY,UAAU;AACxC,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,MAAM,QAAQ;AACzB;AASA,eAAsB,aACpB,UACyB;AACzB,MAAI,SAAS,IAAI;AACf,WAAO;AAAA,EACT;AAEA,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,SAAS,KAAK;AAAA,EAC7B,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,mBAAmB,IAAI;AACzC,SAAO,YAAY,IAAI,QAAQ,UAAU,MAAM,UAAU,OAAO,IAAI;AACtE;","names":[]}

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export all types from the new modular structure\nexport * from \"./types/index\";\n\n// Also re-export legacy types for backward compatibility\n// These were previously defined in this file and are now in the types module\nimport type { Address } from \"viem\";\n\n/**\n * Represents a user's registered data file.\n */\nexport interface UserFile {\n  /** Unique identifier for the file */\n  id: number;\n  /** URL where the file is stored */\n  url: string;\n  /** EVM address of the file owner */\n  ownerAddress: Address;\n  /** Block number when the file was added to the registry */\n  addedAtBlock: bigint;\n}\n\n/**\n * Parameters for the `vana.permissions.grant` method.\n */\nexport interface GrantPermissionParams {\n  /** The on-chain identity of the application */\n  grantee: Address;\n  /** The class of computation, e.g., \"llm_inference\" */\n  operation: string;\n  /** Array of file IDs to grant permission for */\n  files: number[];\n  /** The full, off-chain parameters (e.g., LLM prompt) */\n  parameters: Record<string, unknown>;\n  /** Optional pre-stored grant URL to avoid duplicate IPFS storage */\n  grantUrl?: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AACA,0BAAc,0BADd;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export all types from the modular structure\nexport * from \"./types/index\";\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AACA,0BAAc,0BADd;","names":[]}

package/dist/types.d.ts

@@ -1,30 +1 @@
 export * from "./types/index";
-import type { Address } from "viem";
-/**
- * Represents a user's registered data file.
- */
-export interface UserFile {
-    /** Unique identifier for the file */
-    id: number;
-    /** URL where the file is stored */
-    url: string;
-    /** EVM address of the file owner */
-    ownerAddress: Address;
-    /** Block number when the file was added to the registry */
-    addedAtBlock: bigint;
-}
-/**
- * Parameters for the `vana.permissions.grant` method.
- */
-export interface GrantPermissionParams {
-    /** The on-chain identity of the application */
-    grantee: Address;
-    /** The class of computation, e.g., "llm_inference" */
-    operation: string;
-    /** Array of file IDs to grant permission for */
-    files: number[];
-    /** The full, off-chain parameters (e.g., LLM prompt) */
-    parameters: Record<string, unknown>;
-    /** Optional pre-stored grant URL to avoid duplicate IPFS storage */
-    grantUrl?: string;
-}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export all types from the new modular structure\nexport * from \"./types/index\";\n\n// Also re-export legacy types for backward compatibility\n// These were previously defined in this file and are now in the types module\nimport type { Address } from \"viem\";\n\n/**\n * Represents a user's registered data file.\n */\nexport interface UserFile {\n  /** Unique identifier for the file */\n  id: number;\n  /** URL where the file is stored */\n  url: string;\n  /** EVM address of the file owner */\n  ownerAddress: Address;\n  /** Block number when the file was added to the registry */\n  addedAtBlock: bigint;\n}\n\n/**\n * Parameters for the `vana.permissions.grant` method.\n */\nexport interface GrantPermissionParams {\n  /** The on-chain identity of the application */\n  grantee: Address;\n  /** The class of computation, e.g., \"llm_inference\" */\n  operation: string;\n  /** Array of file IDs to grant permission for */\n  files: number[];\n  /** The full, off-chain parameters (e.g., LLM prompt) */\n  parameters: Record<string, unknown>;\n  /** Optional pre-stored grant URL to avoid duplicate IPFS storage */\n  grantUrl?: string;\n}\n"],"mappings":"AACA,cAAc;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export all types from the modular structure\nexport * from \"./types/index\";\n"],"mappings":"AACA,cAAc;","names":[]}