@opendatalabs/vana-sdk 0.1.0-alpha.e9cead7 → 0.1.0-alpha.eebb656

package/dist/types/generics.d.ts

@@ -0,0 +1,447 @@
+import type { Address, Hash } from "viem";
+/**
+ * Generic request pattern for all SDK operations
+ *
+ * @category Reference
+ */
+export interface GenericRequest<TParams = unknown, TOptions = unknown> {
+    /** Request parameters */
+    params: TParams;
+    /** Additional request options */
+    options?: TOptions;
+}
+/**
+ * Generic response pattern for all SDK operations
+ *
+ * @category Reference
+ */
+export interface GenericResponse<TData = unknown, TMeta = unknown> {
+    /** Response data */
+    data: TData;
+    /** Response metadata */
+    meta?: TMeta;
+    /** Success status */
+    success: boolean;
+    /** Error information if not successful */
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Generic async operation result
+ *
+ * @category Reference
+ */
+export interface AsyncResult<T> {
+    /** Operation result */
+    result: T;
+    /** Transaction hash if applicable */
+    transactionHash?: Hash;
+    /** Block number if applicable */
+    blockNumber?: bigint;
+    /** Gas used if applicable */
+    gasUsed?: bigint;
+}
+/**
+ * Generic contract interaction parameters
+ *
+ * @category Reference
+ */
+export interface ContractCall<TArgs extends readonly unknown[] = readonly unknown[]> {
+    /** Contract method name */
+    method: string;
+    /** Method arguments */
+    args: TArgs;
+    /** Call options */
+    options?: {
+        /** Gas limit */
+        gasLimit?: bigint;
+        /** Gas price */
+        gasPrice?: bigint;
+        /** Value to send */
+        value?: bigint;
+    };
+}
+/**
+ * Generic contract event filter
+ *
+ * @category Reference
+ */
+export interface EventFilter<TEventArgs = unknown> {
+    /** Event name */
+    event: string;
+    /** Event arguments filter */
+    args?: TEventArgs;
+    /** From block */
+    fromBlock?: bigint;
+    /** To block */
+    toBlock?: bigint;
+    /** Address filter */
+    address?: Address | Address[];
+}
+/**
+ * Generic event log
+ *
+ * @category Reference
+ */
+export interface EventLog<TArgs = unknown> {
+    /** Event name */
+    event: string;
+    /** Event arguments */
+    args: TArgs;
+    /** Block number */
+    blockNumber: bigint;
+    /** Transaction hash */
+    transactionHash: Hash;
+    /** Log index */
+    logIndex: number;
+    /** Transaction index */
+    transactionIndex: number;
+    /** Contract address */
+    address: Address;
+}
+/**
+ * Generic controller context for dependency injection
+ *
+ * @category Reference
+ */
+export interface ControllerContext<TClient = unknown, TConfig = unknown> {
+    /** Client instance */
+    client: TClient;
+    /** Configuration */
+    config?: TConfig;
+    /** Additional context */
+    [key: string]: unknown;
+}
+/**
+ * Generic controller interface
+ *
+ * @category Reference
+ */
+export interface Controller<TContext = unknown> {
+    /** Controller context */
+    readonly context: TContext;
+}
+/**
+ * Generic storage provider interface
+ *
+ * @category Reference
+ */
+export interface StorageProvider<TConfig = unknown, TOptions = unknown> {
+    /** Provider name */
+    readonly name: string;
+    /** Provider configuration */
+    readonly config: TConfig;
+    /** Upload data */
+    upload(data: Uint8Array, options?: TOptions): Promise<{
+        url: string;
+        size: number;
+        checksum?: string;
+    }>;
+    /** Download data */
+    download(url: string, options?: TOptions): Promise<{
+        data: Uint8Array;
+        size: number;
+        checksum?: string;
+    }>;
+    /** Delete data */
+    delete?(url: string, options?: TOptions): Promise<boolean>;
+    /** Check if data exists */
+    exists?(url: string, options?: TOptions): Promise<boolean>;
+}
+/**
+ * Generic cache interface
+ *
+ * @category Reference
+ */
+export interface Cache<TKey = string, TValue = unknown> {
+    /** Get value from cache */
+    get(key: TKey): Promise<TValue | undefined>;
+    /** Set value in cache */
+    set(key: TKey, value: TValue, ttl?: number): Promise<void>;
+    /** Delete value from cache */
+    delete(key: TKey): Promise<boolean>;
+    /** Clear all cache */
+    clear(): Promise<void>;
+    /** Check if key exists */
+    has(key: TKey): Promise<boolean>;
+}
+/**
+ * Generic retry configuration
+ *
+ * @category Reference
+ */
+export interface RetryConfig<TError = Error> {
+    /** Maximum retry attempts */
+    maxAttempts: number;
+    /** Base delay in milliseconds */
+    baseDelay: number;
+    /** Backoff multiplier */
+    backoffMultiplier?: number;
+    /** Maximum delay */
+    maxDelay?: number;
+    /** Jitter factor */
+    jitter?: number;
+    /** Retry condition */
+    shouldRetry?: (error: TError, attempt: number) => boolean;
+}
+/**
+ * Generic rate limiter configuration
+ *
+ * @category Reference
+ */
+export interface RateLimiterConfig {
+    /** Requests per time window */
+    requestsPerWindow: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+    /** Burst allowance */
+    burstLimit?: number;
+}
+/**
+ * Generic middleware interface
+ *
+ * @category Reference
+ */
+export interface Middleware<TRequest = unknown, TResponse = unknown> {
+    /** Middleware name */
+    readonly name: string;
+    /** Process request */
+    request?(req: TRequest): Promise<TRequest>;
+    /** Process response */
+    response?(res: TResponse): Promise<TResponse>;
+    /** Handle errors */
+    error?(error: Error, req: TRequest): Promise<TResponse | void>;
+}
+/**
+ * Generic plugin interface
+ *
+ * @category Reference
+ */
+export interface Plugin<TConfig = unknown> {
+    /** Plugin name */
+    readonly name: string;
+    /** Plugin version */
+    readonly version: string;
+    /** Plugin configuration */
+    readonly config: TConfig;
+    /** Initialize plugin */
+    init?(): Promise<void>;
+    /** Cleanup plugin */
+    cleanup?(): Promise<void>;
+}
+/**
+ * Generic factory interface
+ *
+ * @category Reference
+ */
+export interface Factory<T, TParams = unknown> {
+    /** Create instance */
+    create(params: TParams): T;
+    /** Create multiple instances */
+    createMany?(params: TParams[]): T[];
+    /** Validate parameters */
+    validate?(params: TParams): boolean;
+}
+/**
+ * Generic repository interface for data access
+ *
+ * @category Reference
+ */
+export interface Repository<TEntity, TKey = string | number> {
+    /** Find by ID */
+    findById(id: TKey): Promise<TEntity | undefined>;
+    /** Find all entities */
+    findAll(options?: {
+        limit?: number;
+        offset?: number;
+        filter?: Partial<TEntity>;
+        sort?: Array<{
+            field: keyof TEntity;
+            direction: "asc" | "desc";
+        }>;
+    }): Promise<{
+        entities: TEntity[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    /** Create entity */
+    create(entity: Omit<TEntity, "id">): Promise<TEntity>;
+    /** Update entity */
+    update(id: TKey, updates: Partial<TEntity>): Promise<TEntity>;
+    /** Delete entity */
+    delete(id: TKey): Promise<boolean>;
+    /** Check if entity exists */
+    exists(id: TKey): Promise<boolean>;
+}
+/**
+ * Generic validator interface
+ *
+ * @category Reference
+ */
+export interface Validator<T> {
+    /** Validate value */
+    validate(value: unknown): value is T;
+    /** Get validation errors */
+    getErrors?(value: unknown): string[];
+    /** Get validation schema */
+    getSchema?(): unknown;
+}
+/**
+ * Generic transformer interface
+ *
+ * @category Reference
+ */
+export interface Transformer<TInput, TOutput> {
+    /** Transform input to output */
+    transform(input: TInput): TOutput | Promise<TOutput>;
+    /** Reverse transform output to input */
+    reverse?(output: TOutput): TInput | Promise<TInput>;
+}
+/**
+ * Generic service interface
+ *
+ * @category Reference
+ */
+export interface Service<TConfig = unknown> {
+    /** Service name */
+    readonly name: string;
+    /** Service configuration */
+    readonly config: TConfig;
+    /** Service status */
+    readonly status: "idle" | "starting" | "running" | "stopping" | "stopped" | "error";
+    /** Start service */
+    start(): Promise<void>;
+    /** Stop service */
+    stop(): Promise<void>;
+    /** Restart service */
+    restart?(): Promise<void>;
+    /** Get health status */
+    getHealth?(): Promise<{
+        healthy: boolean;
+        details?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Generic observer pattern
+ *
+ * @category Reference
+ */
+export interface Observer<TEvent = unknown> {
+    /** Handle event */
+    notify(event: TEvent): void | Promise<void>;
+}
+/**
+ * Generic observable pattern
+ *
+ * @category Reference
+ */
+export interface Observable<TEvent = unknown> {
+    /** Subscribe to events */
+    subscribe(observer: Observer<TEvent>): () => void;
+    /** Unsubscribe from events */
+    unsubscribe(observer: Observer<TEvent>): void;
+    /** Emit event */
+    emit(event: TEvent): void;
+}
+/**
+ * Generic state machine interface
+ *
+ * @category Reference
+ */
+export interface StateMachine<TState, TEvent> {
+    /** Current state */
+    readonly currentState: TState;
+    /** Transition to new state */
+    transition(event: TEvent): TState;
+    /** Check if transition is valid */
+    canTransition(event: TEvent): boolean;
+    /** Get available transitions */
+    getAvailableTransitions(): TEvent[];
+}
+/**
+ * Helper type to make properties optional conditionally
+ *
+ * @category Reference
+ */
+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
+ */
+export type PromiseResult<T> = T extends Promise<infer U> ? U : T;
+/**
+ * Helper type to create a union of all possible keys
+ *
+ * @category Reference
+ */
+export type AllKeys<T> = T extends unknown ? keyof T : never;
+/**
+ * Helper type to create a deep partial type
+ *
+ * @category Reference
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Helper type to create a deep readonly type
+ *
+ * @category Reference
+ */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/**
+ * Helper type to create a required type with specific keys
+ *
+ * @category Reference
+ */
+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
+ */
+export type OptionalKeys<T, K extends keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
+/**
+ * Helper type to exclude null and undefined
+ *
+ * @category Reference
+ */
+export type NonNullable<T> = T extends null | undefined ? never : T;
+/**
+ * Helper type to create a type with only specific keys
+ *
+ * @category Reference
+ */
+export type PickByType<T, U> = {
+    [K in keyof T as T[K] extends U ? K : never]: T[K];
+};
+/**
+ * Helper type to omit keys by type
+ *
+ * @category Reference
+ */
+export type OmitByType<T, U> = {
+    [K in keyof T as T[K] extends U ? never : K]: T[K];
+};
+/**
+ * Helper type for branded types
+ *
+ * @category Reference
+ */
+export type Brand<T, B> = T & {
+    readonly __brand: B;
+};
+/**
+ * Helper type for nominal types
+ *
+ * @category Reference
+ */
+export type Nominal<T, N extends string> = T & {
+    readonly __nominal: N;
+};

package/dist/types/generics.js

@@ -0,0 +1 @@
+//# sourceMappingURL=generics.js.map

package/dist/types/generics.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/index.cjs

@@ -0,0 +1,61 @@
+"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 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,
+  isChainConfig: () => import_config.isChainConfig,
+  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
+});
+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,
+  isChainConfig,
+  isReplicateAPIResponse,
+  isVanaChain,
+  isVanaChainId,
+  isWalletConfig,
+  parseReplicateOutput,
+  safeParseJSON,
+  validateDataAgainstSchema,
+  validateDataSchemaAgainstMetaSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +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 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  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;AA8EP,2BAKO;","names":[]}

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+export type { BaseConfig, BaseConfigWithStorage, WalletConfig, WalletConfigWithStorage, ChainConfig, ChainConfigWithStorage, VanaConfig, VanaConfigWithStorage, RuntimeConfig, StorageConfig, ConfigValidationOptions, ConfigValidationResult, RelayerCallbacks, DownloadRelayerCallbacks, StorageRequiredMarker, } from "./config";
+export { isWalletConfig, isChainConfig, 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, 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, RelayerRequestOptions, RelayerErrorResponse, RelayerQueueInfo, RelayerTransactionStatus, RelayerMetrics, RelayerWebhookConfig, RelayerWebhookPayload, } from "./relayer";
+export type { PartialExcept, RequiredExcept, Awaited, MaybePromise, MaybeArray, PaginationParams, PaginationResult, BlockRange, TransactionOptions, TransactionReceipt, ApiResponse, CacheConfig, ValidationResult, StatusInfo, RateLimitInfo, UploadProgress, NetworkInfo, GasEstimate, TimeRange, } from "./utils";
+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

@@ -0,0 +1,34 @@
+import { isWalletConfig, isChainConfig, 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,
+  isChainConfig,
+  isReplicateAPIResponse,
+  isVanaChain,
+  isVanaChainId,
+  isWalletConfig,
+  parseReplicateOutput,
+  safeParseJSON,
+  validateDataAgainstSchema,
+  validateDataSchemaAgainstMetaSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +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 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  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;AA8EP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/types/operations.cjs

@@ -0,0 +1,65 @@
+"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 operations_exports = {};
+__export(operations_exports, {
+  getOperationId: () => getOperationId,
+  getTransactionHash: () => getTransactionHash,
+  isOperation: () => isOperation,
+  isTransactionResult: () => isTransactionResult,
+  toOperation: () => toOperation
+});
+module.exports = __toCommonJS(operations_exports);
+function isOperation(obj) {
+  return typeof obj === "object" && obj !== null && "id" in obj && "status" in obj && typeof obj.id === "string" && typeof obj.status === "string";
+}
+function isTransactionResult(obj) {
+  if (typeof obj !== "object" || obj === null || !("hash" in obj)) {
+    return false;
+  }
+  const { hash } = obj;
+  return typeof hash === "string" && hash.startsWith("0x");
+}
+function toOperation(response) {
+  return {
+    id: response.id,
+    status: response.status,
+    createdAt: Date.now(),
+    // Server doesn't provide this, so we use current time
+    result: response.status === "succeeded" ? response.result : void 0,
+    error: response.status === "failed" ? response.result ?? void 0 : void 0
+  };
+}
+function getOperationId(opOrId) {
+  return typeof opOrId === "string" ? opOrId : opOrId.id;
+}
+function getTransactionHash(txOrHash) {
+  if (typeof txOrHash === "string") {
+    return txOrHash;
+  }
+  return txOrHash.hash;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getOperationId,
+  getTransactionHash,
+  isOperation,
+  isTransactionResult,
+  toOperation
+});
+//# sourceMappingURL=operations.cjs.map