@opendatalabs/vana-sdk 0.1.0-alpha.d7fc764 → 0.1.0-alpha.dba79a3

package/dist/types/generics.d.ts

@@ -1,22 +1,47 @@
-import { Hash, Address } from 'viem';
-
 /**
- * Generic request pattern for all SDK operations
+ * Defines generic types and interfaces for SDK infrastructure.
+ *
+ * @remarks
+ * This module provides reusable type definitions and interfaces that form
+ * the foundation of the SDK's architecture. It includes patterns for requests,
+ * responses, caching, middleware, repositories, and other common software
+ * engineering abstractions.
+ *
+ * @category Types
+ * @module types/generics
+ */
+import type { Address, Hash } from "viem";
+/**
+ * Represents a standardized request structure for SDK operations.
+ *
+ * @remarks
+ * Provides consistent request handling across all SDK methods with
+ * typed parameters and optional configuration.
+ *
+ * @typeParam TParams - Type of request parameters
+ * @typeParam TOptions - Type of optional configuration
  *
  * @category Reference
  */
-interface GenericRequest<TParams = unknown, TOptions = unknown> {
+export interface GenericRequest<TParams = unknown, TOptions = unknown> {
     /** Request parameters */
     params: TParams;
     /** Additional request options */
     options?: TOptions;
 }
 /**
- * Generic response pattern for all SDK operations
+ * Represents a standardized response structure for SDK operations.
+ *
+ * @remarks
+ * Provides consistent response handling with success/error states
+ * and optional metadata for additional context.
+ *
+ * @typeParam TData - Type of response data
+ * @typeParam TMeta - Type of response metadata
  *
  * @category Reference
  */
-interface GenericResponse<TData = unknown, TMeta = unknown> {
+export interface GenericResponse<TData = unknown, TMeta = unknown> {
     /** Response data */
     data: TData;
     /** Response metadata */
@@ -31,11 +56,17 @@ interface GenericResponse<TData = unknown, TMeta = unknown> {
     };
 }
 /**
- * Generic async operation result
+ * Represents the result of an asynchronous blockchain operation.
+ *
+ * @remarks
+ * Includes transaction details when the operation involves
+ * blockchain state changes.
+ *
+ * @typeParam T - Type of the operation result
  *
  * @category Reference
  */
-interface AsyncResult<T> {
+export interface AsyncResult<T> {
     /** Operation result */
     result: T;
     /** Transaction hash if applicable */
@@ -50,7 +81,7 @@ interface AsyncResult<T> {
  *
  * @category Reference
  */
-interface ContractCall<TArgs extends readonly unknown[] = readonly unknown[]> {
+export interface ContractCall<TArgs extends readonly unknown[] = readonly unknown[]> {
     /** Contract method name */
     method: string;
     /** Method arguments */
@@ -58,7 +89,7 @@ interface ContractCall<TArgs extends readonly unknown[] = readonly unknown[]> {
     /** Call options */
     options?: {
         /** Gas limit */
-        gasLimit?: bigint;
+        gas?: bigint;
         /** Gas price */
         gasPrice?: bigint;
         /** Value to send */
@@ -70,7 +101,7 @@ interface ContractCall<TArgs extends readonly unknown[] = readonly unknown[]> {
  *
  * @category Reference
  */
-interface EventFilter<TEventArgs = unknown> {
+export interface EventFilter<TEventArgs = unknown> {
     /** Event name */
     event: string;
     /** Event arguments filter */
@@ -87,7 +118,7 @@ interface EventFilter<TEventArgs = unknown> {
  *
  * @category Reference
  */
-interface EventLog<TArgs = unknown> {
+export interface EventLog<TArgs = unknown> {
     /** Event name */
     event: string;
     /** Event arguments */
@@ -108,7 +139,7 @@ interface EventLog<TArgs = unknown> {
  *
  * @category Reference
  */
-interface ControllerContext<TClient = unknown, TConfig = unknown> {
+export interface ControllerContext<TClient = unknown, TConfig = unknown> {
     /** Client instance */
     client: TClient;
     /** Configuration */
@@ -121,7 +152,7 @@ interface ControllerContext<TClient = unknown, TConfig = unknown> {
  *
  * @category Reference
  */
-interface Controller<TContext = unknown> {
+export interface Controller<TContext = unknown> {
     /** Controller context */
     readonly context: TContext;
 }
@@ -130,7 +161,7 @@ interface Controller<TContext = unknown> {
  *
  * @category Reference
  */
-interface StorageProvider<TConfig = unknown, TOptions = unknown> {
+export interface StorageProvider<TConfig = unknown, TOptions = unknown> {
     /** Provider name */
     readonly name: string;
     /** Provider configuration */
@@ -153,11 +184,18 @@ interface StorageProvider<TConfig = unknown, TOptions = unknown> {
     exists?(url: string, options?: TOptions): Promise<boolean>;
 }
 /**
- * Generic cache interface
+ * Defines a generic caching interface with TTL support.
+ *
+ * @remarks
+ * Provides standard cache operations for performance optimization
+ * and reducing redundant computations or network requests.
+ *
+ * @typeParam TKey - Type of cache keys
+ * @typeParam TValue - Type of cached values
  *
  * @category Reference
  */
-interface Cache<TKey = string, TValue = unknown> {
+export interface Cache<TKey = string, TValue = unknown> {
     /** Get value from cache */
     get(key: TKey): Promise<TValue | undefined>;
     /** Set value in cache */
@@ -170,11 +208,17 @@ interface Cache<TKey = string, TValue = unknown> {
     has(key: TKey): Promise<boolean>;
 }
 /**
- * Generic retry configuration
+ * Configures retry behavior for resilient operations.
+ *
+ * @remarks
+ * Supports exponential backoff, jitter, and custom retry conditions
+ * for handling transient failures gracefully.
+ *
+ * @typeParam TError - Type of errors to handle
  *
  * @category Reference
  */
-interface RetryConfig<TError = Error> {
+export interface RetryConfig<TError = Error> {
     /** Maximum retry attempts */
     maxAttempts: number;
     /** Base delay in milliseconds */
@@ -193,7 +237,7 @@ interface RetryConfig<TError = Error> {
  *
  * @category Reference
  */
-interface RateLimiterConfig {
+export interface RateLimiterConfig {
     /** Requests per time window */
     requestsPerWindow: number;
     /** Time window in milliseconds */
@@ -202,11 +246,18 @@ interface RateLimiterConfig {
     burstLimit?: number;
 }
 /**
- * Generic middleware interface
+ * Defines middleware for request/response processing pipelines.
+ *
+ * @remarks
+ * Middleware can transform requests, responses, and handle errors
+ * in a composable chain of responsibility pattern.
+ *
+ * @typeParam TRequest - Type of requests to process
+ * @typeParam TResponse - Type of responses to process
  *
  * @category Reference
  */
-interface Middleware<TRequest = unknown, TResponse = unknown> {
+export interface Middleware<TRequest = unknown, TResponse = unknown> {
     /** Middleware name */
     readonly name: string;
     /** Process request */
@@ -221,7 +272,7 @@ interface Middleware<TRequest = unknown, TResponse = unknown> {
  *
  * @category Reference
  */
-interface Plugin<TConfig = unknown> {
+export interface Plugin<TConfig = unknown> {
     /** Plugin name */
     readonly name: string;
     /** Plugin version */
@@ -238,7 +289,7 @@ interface Plugin<TConfig = unknown> {
  *
  * @category Reference
  */
-interface Factory<T, TParams = unknown> {
+export interface Factory<T, TParams = unknown> {
     /** Create instance */
     create(params: TParams): T;
     /** Create multiple instances */
@@ -247,11 +298,18 @@ interface Factory<T, TParams = unknown> {
     validate?(params: TParams): boolean;
 }
 /**
- * Generic repository interface for data access
+ * Defines a repository pattern for data access abstraction.
+ *
+ * @remarks
+ * Provides CRUD operations with filtering, sorting, and pagination
+ * for consistent data access across different storage backends.
+ *
+ * @typeParam TEntity - Type of entities managed by the repository
+ * @typeParam TKey - Type of entity identifiers
  *
  * @category Reference
  */
-interface Repository<TEntity, TKey = string | number> {
+export interface Repository<TEntity, TKey = string | number> {
     /** Find by ID */
     findById(id: TKey): Promise<TEntity | undefined>;
     /** Find all entities */
@@ -282,7 +340,7 @@ interface Repository<TEntity, TKey = string | number> {
  *
  * @category Reference
  */
-interface Validator<T> {
+export interface Validator<T> {
     /** Validate value */
     validate(value: unknown): value is T;
     /** Get validation errors */
@@ -295,7 +353,7 @@ interface Validator<T> {
  *
  * @category Reference
  */
-interface Transformer<TInput, TOutput> {
+export interface Transformer<TInput, TOutput> {
     /** Transform input to output */
     transform(input: TInput): TOutput | Promise<TOutput>;
     /** Reverse transform output to input */
@@ -306,7 +364,7 @@ interface Transformer<TInput, TOutput> {
  *
  * @category Reference
  */
-interface Service<TConfig = unknown> {
+export interface Service<TConfig = unknown> {
     /** Service name */
     readonly name: string;
     /** Service configuration */
@@ -326,20 +384,32 @@ interface Service<TConfig = unknown> {
     }>;
 }
 /**
- * Generic observer pattern
+ * Implements the observer in the observer pattern.
+ *
+ * @remarks
+ * Receives notifications about events from observable subjects
+ * for decoupled event handling.
+ *
+ * @typeParam TEvent - Type of events to observe
  *
  * @category Reference
  */
-interface Observer<TEvent = unknown> {
+export interface Observer<TEvent = unknown> {
     /** Handle event */
     notify(event: TEvent): void | Promise<void>;
 }
 /**
- * Generic observable pattern
+ * Implements the subject in the observer pattern.
+ *
+ * @remarks
+ * Manages observers and emits events to all subscribed observers
+ * for event-driven architectures.
+ *
+ * @typeParam TEvent - Type of events to emit
  *
  * @category Reference
  */
-interface Observable<TEvent = unknown> {
+export interface Observable<TEvent = unknown> {
     /** Subscribe to events */
     subscribe(observer: Observer<TEvent>): () => void;
     /** Unsubscribe from events */
@@ -352,7 +422,7 @@ interface Observable<TEvent = unknown> {
  *
  * @category Reference
  */
-interface StateMachine<TState, TEvent> {
+export interface StateMachine<TState, TEvent> {
     /** Current state */
     readonly currentState: TState;
     /** Transition to new state */
@@ -367,25 +437,25 @@ interface StateMachine<TState, TEvent> {
  *
  * @category Reference
  */
-type ConditionalOptional<T, K extends keyof T, Condition extends boolean> = Condition extends true ? Omit<T, K> & Partial<Pick<T, K>> : T;
+export type ConditionalOptional<T, K extends keyof T, Condition extends boolean> = Condition extends true ? Omit<T, K> & Partial<Pick<T, K>> : T;
 /**
  * Helper type to extract promise result type
  *
  * @category Reference
  */
-type PromiseResult<T> = T extends Promise<infer U> ? U : T;
+export type PromiseResult<T> = T extends Promise<infer U> ? U : T;
 /**
  * Helper type to create a union of all possible keys
  *
  * @category Reference
  */
-type AllKeys<T> = T extends unknown ? keyof T : never;
+export type AllKeys<T> = T extends unknown ? keyof T : never;
 /**
  * Helper type to create a deep partial type
  *
  * @category Reference
  */
-type DeepPartial<T> = {
+export type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 /**
@@ -393,7 +463,7 @@ type DeepPartial<T> = {
  *
  * @category Reference
  */
-type DeepReadonly<T> = {
+export type DeepReadonly<T> = {
     readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
 };
 /**
@@ -401,25 +471,25 @@ type DeepReadonly<T> = {
  *
  * @category Reference
  */
-type RequireKeys<T, K extends keyof T> = Required<Pick<T, K>> & Omit<T, K>;
+export type RequireKeys<T, K extends keyof T> = Required<Pick<T, K>> & Omit<T, K>;
 /**
  * Helper type to create an optional type with specific keys
  *
  * @category Reference
  */
-type OptionalKeys<T, K extends keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
+export type OptionalKeys<T, K extends keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
 /**
  * Helper type to exclude null and undefined
  *
  * @category Reference
  */
-type NonNullable<T> = T extends null | undefined ? never : T;
+export type NonNullable<T> = T extends null | undefined ? never : T;
 /**
  * Helper type to create a type with only specific keys
  *
  * @category Reference
  */
-type PickByType<T, U> = {
+export type PickByType<T, U> = {
     [K in keyof T as T[K] extends U ? K : never]: T[K];
 };
 /**
@@ -427,7 +497,7 @@ type PickByType<T, U> = {
  *
  * @category Reference
  */
-type OmitByType<T, U> = {
+export type OmitByType<T, U> = {
     [K in keyof T as T[K] extends U ? never : K]: T[K];
 };
 /**
@@ -435,7 +505,7 @@ type OmitByType<T, U> = {
  *
  * @category Reference
  */
-type Brand<T, B> = T & {
+export type Brand<T, B> = T & {
     readonly __brand: B;
 };
 /**
@@ -443,8 +513,6 @@ type Brand<T, B> = T & {
  *
  * @category Reference
  */
-type Nominal<T, N extends string> = T & {
+export type Nominal<T, N extends string> = T & {
     readonly __nominal: N;
 };
-
-export type { AllKeys, AsyncResult, Brand, Cache, ConditionalOptional, ContractCall, Controller, ControllerContext, DeepPartial, DeepReadonly, EventFilter, EventLog, Factory, GenericRequest, GenericResponse, Middleware, Nominal, NonNullable, Observable, Observer, OmitByType, OptionalKeys, PickByType, Plugin, PromiseResult, RateLimiterConfig, Repository, RequireKeys, RetryConfig, Service, StateMachine, StorageProvider, Transformer, Validator };

package/dist/types/index.cjs

@@ -15,7 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var types_exports = {};
 __export(types_exports, {
@@ -25,7 +24,9 @@ __export(types_exports, {
   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,
@@ -40,7 +41,6 @@ var import_config = require("./config");
 var import_chains = require("./chains");
 var import_storage = require("./storage");
 var import_schemaValidation = require("../utils/schemaValidation");
-__reExport(types_exports, require("../generated/server/server-exports"), module.exports);
 var import_external_apis = require("./external-apis");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -50,7 +50,9 @@ var import_external_apis = require("./external-apis");
   fetchAndValidateSchema,
   hasStorageConfig,
   isAPIResponse,
+  isAddressOnlyConfig,
   isChainConfig,
+  isReadOnlyConfig,
   isReplicateAPIResponse,
   isVanaChain,
   isVanaChainId,
@@ -58,7 +60,6 @@ var import_external_apis = require("./external-apis");
   parseReplicateOutput,
   safeParseJSON,
   validateDataAgainstSchema,
-  validateDataSchemaAgainstMetaSchema,
-  ...require("../generated/server/server-exports")
+  validateDataSchemaAgainstMetaSchema
 });
 //# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Configuration types\nexport type {\n  BaseConfig,\n  BaseConfigWithStorage,\n  WalletConfig,\n  WalletConfigWithStorage,\n  ChainConfig,\n  ChainConfigWithStorage,\n  VanaConfig,\n  VanaConfigWithStorage,\n  RuntimeConfig,\n  StorageConfig,\n  ConfigValidationOptions,\n  ConfigValidationResult,\n  RelayerCallbacks,\n  DownloadRelayerCallbacks,\n  StorageRequiredMarker,\n} from \"./config\";\n\nexport { isWalletConfig, isChainConfig, hasStorageConfig } 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  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  InitPersonalServerParams,\n  PersonalServerIdentity,\n} from \"./personal\";\n\n// Server API types (auto-generated via fetch-server-types.ts)\nexport * 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  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  TransactionOptions,\n  TransactionReceipt,\n  ApiResponse,\n  CacheConfig,\n  ValidationResult,\n  StatusInfo,\n  RateLimitInfo,\n  UploadProgress,\n  NetworkInfo,\n  GasEstimate,\n  TimeRange,\n} from \"./utils\";\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;AAmBA,oBAAgE;AAKhE,oBAA2C;AAyB3C,qBAA6B;AAgD7B,8BAMO;AAkEP,0BAAc,+CAzKd;AAqLA,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. 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  InitPersonalServerParams,\n  PersonalServerIdentity,\n} from \"./personal\";\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 types\nexport type {\n  TransactionOptions,\n  TransactionReceipt,\n  TransactionResult,\n} from \"./operations\";\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;AA8EP,2BAKO;","names":[]}

package/dist/types/index.d.ts

@@ -1,34 +1,48 @@
-export { BaseConfig, BaseConfigWithStorage, ChainConfig, ChainConfigWithStorage, ConfigValidationOptions, ConfigValidationResult, DownloadRelayerCallbacks, RelayerCallbacks, RuntimeConfig, StorageConfig, StorageRequiredMarker, VanaConfig, VanaConfigWithStorage, WalletConfig, WalletConfigWithStorage, hasStorageConfig, isChainConfig, isWalletConfig } from './config.js';
-export { VanaChain, VanaChainId, isVanaChain, isVanaChainId } from './chains.js';
-export { ContractAddresses, ContractDeployment, ContractInfo, ContractMethodParams, ContractMethodReturnType, VanaContractInstance, VanaContractName } from './contracts.js';
-export { StorageError, StorageFile, StorageListOptions, StorageProvider, StorageProviderConfig, StorageUploadResult } from './storage.js';
-export { AddRefinerParams, AddRefinerResult, AddSchemaParams, AddSchemaResult, BatchUploadParams, BatchUploadResult, CompleteSchema, DeleteFileParams, DeleteFileResult, DownloadFileParams, DownloadFileResult, EncryptedUploadParams, EncryptionInfo, FileAccessPermissions, FileMetadata, FilePermissionParams, FileSharingConfig, GetFileParams, GetUserFilesParams, GetUserTrustedServersParams, LegacyPermissionParams, Refiner, Schema, SchemaMetadata, TrustedServer, UnencryptedUploadParams, UpdateSchemaIdParams, UpdateSchemaIdResult, UploadEncryptedFileResult, UploadFileParams, UploadFileResult, UploadParams, UploadResult, UserFile } from './data.js';
-export { CreateSchemaParams, CreateSchemaResult } from '../controllers/schemas.js';
-export { DataSchema, SchemaValidationError, SchemaValidator, fetchAndValidateSchema, validateDataAgainstSchema, validateDataSchemaAgainstMetaSchema } from '../utils/schemaValidation.js';
-export { AddAndTrustServerInput, AddAndTrustServerParams, AddAndTrustServerTypedData, BatchServerInfoResult, CheckPermissionParams, GenericTypedData, GetUserPermissionsOptions, GrantFile, GrantPermissionParams, GrantedPermission, Grantee, GranteeInfo, GranteeQueryOptions, OnChainPermissionGrant, PaginatedGrantees, PaginatedTrustedServers, Permission, PermissionAnalytics, PermissionCheckResult, PermissionEvent, PermissionGrantDomain, PermissionGrantMessage, PermissionGrantTypedData, PermissionInfo, PermissionInputMessage, PermissionOperation, PermissionQueryResult, PermissionStatus, QueryPermissionsParams, RegisterGranteeInput, RegisterGranteeParams, RegisterGranteeTypedData, RevokePermissionInput, RevokePermissionParams, RevokePermissionTypedData, Server, ServerFilesAndPermissionParams, ServerFilesAndPermissionTypedData, ServerInfo, ServerTrustStatus, SimplifiedPermissionMessage, SpecificTypedData, TrustServerInput, TrustServerParams, TrustServerTypedData, TrustedServerInfo, TrustedServerQueryOptions, TypedDataPrimaryType, UntrustServerInput, UntrustServerParams, UntrustServerTypedData } from './permissions.js';
-export { CreateOperationParams, InitPersonalServerParams, PersonalServerIdentity, PostRequestParams } from './personal.js';
-export { AuthenticationErrorResponse, BlockchainErrorResponse, ComputeErrorResponse, CreateOperationRequest, CreateOperationResponse, DecryptionErrorResponse, ErrorResponse, FileAccessErrorResponse, GetOperationResponse, GrantValidationErrorResponse, IdentityResponseModel, InternalServerErrorResponse, NotFoundErrorResponse, OperationErrorResponse, PersonalServerModel, ValidationErrorResponse } from '../generated/server/server-exports.js';
-export { APIResponse, PinataListResponse, PinataPin, PinataUploadResponse, ReplicateAPIResponse, ReplicateStatus, isAPIResponse, isReplicateAPIResponse, parseReplicateOutput, safeParseJSON } from './external-apis.js';
-export { RelayerConfig, RelayerErrorResponse, RelayerMetrics, RelayerQueueInfo, RelayerRequestOptions, RelayerStatus, RelayerStorageResponse, RelayerStoreParams, RelayerSubmitParams, RelayerTransactionResponse, RelayerTransactionStatus, RelayerWebhookConfig, RelayerWebhookPayload } from './relayer.js';
-export { ApiResponse, Awaited, BlockRange, CacheConfig, GasEstimate, MaybeArray, MaybePromise, NetworkInfo, PaginationParams, PaginationResult, PartialExcept, RateLimitInfo, RequiredExcept, StatusInfo, TimeRange, TransactionOptions, TransactionReceipt, UploadProgress, ValidationResult } from './utils.js';
-export { AllKeys, AsyncResult, Brand, Cache, ConditionalOptional, ContractCall, Controller, ControllerContext, DeepPartial, DeepReadonly, EventFilter, EventLog, Factory, GenericRequest, GenericResponse, Middleware, Nominal, NonNullable, Observable, Observer, OmitByType, OptionalKeys, PickByType, Plugin, PromiseResult, RateLimiterConfig, Repository, RequireKeys, RetryConfig, Service, StateMachine, Transformer, Validator } from './generics.js';
-export { Abi, Account, Address, Chain, GetContractReturnType, Hash, PublicClient, WalletClient } from 'viem';
-export { $defs, components as ServerComponents, $defs as ServerDefs, operations as ServerOperations, paths as ServerPaths, webhooks as ServerWebhooks, components, operations, paths, webhooks } from '../generated/server/server.js';
-import '../permissions-eo8YeLGf.js';
-import './operations.js';
-import '../config/eventMappings.js';
-import '../generated/abi/index.js';
-import '../generated/abi/DataPortabilityPermissionsImplementation.js';
-import '../generated/abi/DataPortabilityServersImplementation.js';
-import '../generated/abi/DataPortabilityGranteesImplementation.js';
-import '../generated/abi/VanaEpochImplementation.js';
-import '../generated/abi/DLPRegistryImplementation.js';
-import '../generated/abi/DLPTreasuryImplementation.js';
-import '../generated/abi/DLPRewardDeployerTreasuryImplementation.js';
-import '../generated/abi/DLPPerformanceImplementation.js';
-import '../generated/abi/DLPRewardDeployerImplementation.js';
-import '../generated/abi/DLPRootImplementation.js';
-import '../generated/abi/DataLiquidityPoolImplementation.js';
-import '../generated/abi/DLPRegistryTreasuryImplementation.js';
-import '../storage/manager.js';
-import '../platform/interface.js';
+/**
+ * Centralized type exports for the Vana SDK.
+ *
+ * @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';
+ * ```
+ *
+ * @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, InitPersonalServerParams, PersonalServerIdentity, } from "./personal";
+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 { TransactionOptions, TransactionReceipt, TransactionResult, } from "./operations";
+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 { Address, Hash, Abi, Chain, WalletClient, PublicClient, Account, GetContractReturnType, } from "viem";

package/dist/types/index.js

@@ -1,4 +1,10 @@
-import { isWalletConfig, isChainConfig, hasStorageConfig } from "./config";
+import {
+  isWalletConfig,
+  isChainConfig,
+  isReadOnlyConfig,
+  isAddressOnlyConfig,
+  hasStorageConfig
+} from "./config";
 import { isVanaChainId, isVanaChain } from "./chains";
 import { StorageError } from "./storage";
 import {
@@ -8,7 +14,6 @@ import {
   validateDataAgainstSchema,
   fetchAndValidateSchema
 } from "../utils/schemaValidation";
-export * from "../generated/server/server-exports";
 import {
   isReplicateAPIResponse,
   isAPIResponse,
@@ -22,7 +27,9 @@ export {
   fetchAndValidateSchema,
   hasStorageConfig,
   isAPIResponse,
+  isAddressOnlyConfig,
   isChainConfig,
+  isReadOnlyConfig,
   isReplicateAPIResponse,
   isVanaChain,
   isVanaChainId,

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["// Configuration types\nexport type {\n  BaseConfig,\n  BaseConfigWithStorage,\n  WalletConfig,\n  WalletConfigWithStorage,\n  ChainConfig,\n  ChainConfigWithStorage,\n  VanaConfig,\n  VanaConfigWithStorage,\n  RuntimeConfig,\n  StorageConfig,\n  ConfigValidationOptions,\n  ConfigValidationResult,\n  RelayerCallbacks,\n  DownloadRelayerCallbacks,\n  StorageRequiredMarker,\n} from \"./config\";\n\nexport { isWalletConfig, isChainConfig, hasStorageConfig } 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  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  InitPersonalServerParams,\n  PersonalServerIdentity,\n} from \"./personal\";\n\n// Server API types (auto-generated via fetch-server-types.ts)\nexport * 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  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  TransactionOptions,\n  TransactionReceipt,\n  ApiResponse,\n  CacheConfig,\n  ValidationResult,\n  StatusInfo,\n  RateLimitInfo,\n  UploadProgress,\n  NetworkInfo,\n  GasEstimate,\n  TimeRange,\n} from \"./utils\";\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":"AAmBA,SAAS,gBAAgB,eAAe,wBAAwB;AAKhE,SAAS,eAAe,mBAAmB;AAyB3C,SAAS,oBAAoB;AAgD7B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAkEP,cAAc;AAYd;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. 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  InitPersonalServerParams,\n  PersonalServerIdentity,\n} from \"./personal\";\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 types\nexport type {\n  TransactionOptions,\n  TransactionReceipt,\n  TransactionResult,\n} from \"./operations\";\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;AA8EP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}