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

package/dist/storage/manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/manager.ts"],"sourcesContent":["import {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageError,\n} from \"./index\";\n\n/**\n * Manages multiple storage providers with a unified interface for file operations.\n *\n * @remarks\n * The StorageManager provides a consistent API for uploading, downloading, and managing\n * files across different storage backends including IPFS, Pinata, Google Drive, and\n * server-managed storage. It handles provider registration, default provider selection,\n * and automatic fallback scenarios for robust file operations.\n *\n * Used internally by DataController for encrypted file storage, but can also be used\n * directly for custom storage workflows. Each provider implements the `StorageProvider`\n * interface to ensure consistent behavior across different storage backends.\n *\n * The manager supports provider-specific configurations and features while maintaining\n * a uniform API surface for applications.\n * @example\n * ```typescript\n * import { StorageManager, IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk';\n *\n * const storage = new StorageManager();\n *\n * // Register multiple providers\n * storage.register('ipfs', new IPFSStorage({\n *   apiEndpoint: 'https://api.pinata.cloud/pinning/pinFileToIPFS'\n * }), true);\n * storage.register('pinata', new PinataStorage({\n *   jwt: 'your-pinata-jwt-token'\n * }));\n *\n * // Upload to default provider\n * const result = await storage.upload(fileBlob, 'myfile.json');\n *\n * // Upload to specific provider\n * const result2 = await storage.upload(fileBlob, 'myfile.json', 'pinata');\n * ```\n * @category Storage\n * @see {@link https://docs.vana.com/developer/vana-sdk-documentation/core-modules/storage-providers | Storage Providers Guide} for configuration details\n */\nexport class StorageManager {\n  private providers: Map<string, StorageProvider> = new Map();\n  private defaultProvider: string | null = null;\n\n  /**\n   * Registers a storage provider with the manager.\n   *\n   * @remarks\n   * This method adds a new storage provider to the manager's registry and optionally\n   * sets it as the default provider for subsequent operations. If no default provider\n   * is currently set, the first registered provider automatically becomes the default.\n   * @param name - Unique identifier for the provider\n   * @param provider - The storage provider instance implementing the `StorageProvider` interface\n   * @param isDefault - Whether this provider should be set as the default (defaults to `false`)\n   * @example\n   * ```typescript\n   * const pinata = new PinataStorage({ jwt: 'your-jwt-token' });\n   * storage.register('pinata', pinata, true); // Set as default\n   *\n   * const ipfs = new IPFSStorage({ apiEndpoint: 'https://...' });\n   * storage.register('ipfs', ipfs); // Not default\n   * ```\n   */\n  register(name: string, provider: StorageProvider, isDefault = false): void {\n    this.providers.set(name, provider);\n\n    if (isDefault || this.defaultProvider === null) {\n      this.defaultProvider = name;\n    }\n  }\n\n  /**\n   * Get a registered storage provider\n   *\n   * @param name - Provider identifier, uses default if not specified\n   * @returns Storage provider instance\n   */\n  getProvider(name?: string): StorageProvider {\n    const providerName = name || this.defaultProvider;\n\n    if (!providerName) {\n      throw new StorageError(\n        \"No storage provider specified and no default provider set\",\n        \"NO_PROVIDER\",\n        \"manager\",\n      );\n    }\n\n    const provider = this.providers.get(providerName);\n    if (!provider) {\n      throw new StorageError(\n        `Storage provider '${providerName}' not found`,\n        \"PROVIDER_NOT_FOUND\",\n        \"manager\",\n      );\n    }\n\n    return provider;\n  }\n\n  /**\n   * List all registered providers\n   *\n   * @returns Array of provider names\n   */\n  listProviders(): string[] {\n    return Array.from(this.providers.keys());\n  }\n\n  /**\n   * Get the default provider name\n   *\n   * @returns Default provider name or null\n   */\n  getDefaultProvider(): string | null {\n    return this.defaultProvider;\n  }\n\n  /**\n   * Set the default provider\n   *\n   * @param name - Provider identifier\n   */\n  setDefaultProvider(name: string): void {\n    if (!this.providers.has(name)) {\n      throw new StorageError(\n        `Cannot set default provider '${name}': provider not registered`,\n        \"PROVIDER_NOT_FOUND\",\n        \"manager\",\n      );\n    }\n    this.defaultProvider = name;\n  }\n\n  /**\n   * Uploads a file using the specified or default storage provider.\n   *\n   * @remarks\n   * This method uploads a file to the specified provider or falls back to the default\n   * provider if none is specified. The upload result includes the storage URL, file size,\n   * content type, and provider-specific metadata that can be used for subsequent operations.\n   * @param file - The file blob to upload\n   * @param filename - Optional custom filename (defaults to auto-generated name)\n   * @param providerName - Optional provider identifier (uses default if not specified)\n   * @returns A Promise that resolves to the storage upload result with URL and metadata\n   * @throws {StorageError} When no provider is available or upload fails\n   * @example\n   * ```typescript\n   * // Upload to default provider\n   * const result = await storage.upload(fileBlob, 'data.json');\n   * console.log(`Uploaded to: ${result.url}`);\n   *\n   * // Upload to specific provider\n   * const result2 = await storage.upload(fileBlob, 'data.json', 'pinata');\n   * ```\n   */\n  async upload(\n    file: Blob,\n    filename?: string,\n    providerName?: string,\n  ): Promise<StorageUploadResult> {\n    const provider = this.getProvider(providerName);\n    return provider.upload(file, filename);\n  }\n\n  /**\n   * Download a file using the specified or default provider\n   *\n   * @param url - The storage URL\n   * @param providerName - Optional provider to use\n   * @returns Promise with file blob\n   */\n  async download(url: string, providerName?: string): Promise<Blob> {\n    const provider = this.getProvider(providerName);\n    return provider.download(url);\n  }\n\n  /**\n   * List files using the specified or default provider\n   *\n   * @param options - Optional filtering and pagination\n   * @param providerName - Optional provider to use\n   * @returns Promise with file list\n   */\n  async list(\n    options?: StorageListOptions,\n    providerName?: string,\n  ): Promise<StorageFile[]> {\n    const provider = this.getProvider(providerName);\n    return provider.list(options);\n  }\n\n  /**\n   * Delete a file using the specified or default provider\n   *\n   * @param url - The storage URL\n   * @param providerName - Optional provider to use\n   * @returns Promise with success status\n   */\n  async delete(url: string, providerName?: string): Promise<boolean> {\n    const provider = this.getProvider(providerName);\n    return provider.delete(url);\n  }\n\n  /**\n   * Get list of registered storage provider names\n   *\n   * @returns Array of provider names\n   */\n  getStorageProviders(): string[] {\n    return Array.from(this.providers.keys());\n  }\n\n  /**\n   * Get the default storage provider name\n   *\n   * @returns Default provider name or undefined\n   */\n  getDefaultStorageProvider(): string | undefined {\n    return this.defaultProvider || undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAMO;AAwCA,MAAM,eAAe;AAAA,EAClB,YAA0C,oBAAI,IAAI;AAAA,EAClD,kBAAiC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBzC,SAAS,MAAc,UAA2B,YAAY,OAAa;AACzE,SAAK,UAAU,IAAI,MAAM,QAAQ;AAEjC,QAAI,aAAa,KAAK,oBAAoB,MAAM;AAC9C,WAAK,kBAAkB;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,MAAgC;AAC1C,UAAM,eAAe,QAAQ,KAAK;AAElC,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,WAAW,KAAK,UAAU,IAAI,YAAY;AAChD,QAAI,CAAC,UAAU;AACb,YAAM,IAAI;AAAA,QACR,qBAAqB,YAAY;AAAA,QACjC;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAA0B;AACxB,WAAO,MAAM,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB,MAAoB;AACrC,QAAI,CAAC,KAAK,UAAU,IAAI,IAAI,GAAG;AAC7B,YAAM,IAAI;AAAA,QACR,gCAAgC,IAAI;AAAA,QACpC;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,SAAK,kBAAkB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,MAAM,OACJ,MACA,UACA,cAC8B;AAC9B,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,OAAO,MAAM,QAAQ;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,SAAS,KAAa,cAAsC;AAChE,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,SAAS,GAAG;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,KACJ,SACA,cACwB;AACxB,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,KAAK,OAAO;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAO,KAAa,cAAyC;AACjE,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,OAAO,GAAG;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,sBAAgC;AAC9B,WAAO,MAAM,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,4BAAgD;AAC9C,WAAO,KAAK,mBAAmB;AAAA,EACjC;AACF;","names":[]}

package/dist/storage/manager.d.cts

@@ -0,0 +1,150 @@
+import { StorageProvider, StorageUploadResult, StorageListOptions, StorageFile } from '../types/storage.cjs';
+
+/**
+ * Manages multiple storage providers with a unified interface for file operations.
+ *
+ * @remarks
+ * The StorageManager provides a consistent API for uploading, downloading, and managing
+ * files across different storage backends including IPFS, Pinata, Google Drive, and
+ * server-managed storage. It handles provider registration, default provider selection,
+ * and automatic fallback scenarios for robust file operations.
+ *
+ * Used internally by DataController for encrypted file storage, but can also be used
+ * directly for custom storage workflows. Each provider implements the `StorageProvider`
+ * interface to ensure consistent behavior across different storage backends.
+ *
+ * The manager supports provider-specific configurations and features while maintaining
+ * a uniform API surface for applications.
+ * @example
+ * ```typescript
+ * import { StorageManager, IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk';
+ *
+ * const storage = new StorageManager();
+ *
+ * // Register multiple providers
+ * storage.register('ipfs', new IPFSStorage({
+ *   apiEndpoint: 'https://api.pinata.cloud/pinning/pinFileToIPFS'
+ * }), true);
+ * storage.register('pinata', new PinataStorage({
+ *   jwt: 'your-pinata-jwt-token'
+ * }));
+ *
+ * // Upload to default provider
+ * const result = await storage.upload(fileBlob, 'myfile.json');
+ *
+ * // Upload to specific provider
+ * const result2 = await storage.upload(fileBlob, 'myfile.json', 'pinata');
+ * ```
+ * @category Storage
+ * @see {@link https://docs.vana.com/developer/vana-sdk-documentation/core-modules/storage-providers | Storage Providers Guide} for configuration details
+ */
+declare class StorageManager {
+    private providers;
+    private defaultProvider;
+    /**
+     * Registers a storage provider with the manager.
+     *
+     * @remarks
+     * This method adds a new storage provider to the manager's registry and optionally
+     * sets it as the default provider for subsequent operations. If no default provider
+     * is currently set, the first registered provider automatically becomes the default.
+     * @param name - Unique identifier for the provider
+     * @param provider - The storage provider instance implementing the `StorageProvider` interface
+     * @param isDefault - Whether this provider should be set as the default (defaults to `false`)
+     * @example
+     * ```typescript
+     * const pinata = new PinataStorage({ jwt: 'your-jwt-token' });
+     * storage.register('pinata', pinata, true); // Set as default
+     *
+     * const ipfs = new IPFSStorage({ apiEndpoint: 'https://...' });
+     * storage.register('ipfs', ipfs); // Not default
+     * ```
+     */
+    register(name: string, provider: StorageProvider, isDefault?: boolean): void;
+    /**
+     * Get a registered storage provider
+     *
+     * @param name - Provider identifier, uses default if not specified
+     * @returns Storage provider instance
+     */
+    getProvider(name?: string): StorageProvider;
+    /**
+     * List all registered providers
+     *
+     * @returns Array of provider names
+     */
+    listProviders(): string[];
+    /**
+     * Get the default provider name
+     *
+     * @returns Default provider name or null
+     */
+    getDefaultProvider(): string | null;
+    /**
+     * Set the default provider
+     *
+     * @param name - Provider identifier
+     */
+    setDefaultProvider(name: string): void;
+    /**
+     * Uploads a file using the specified or default storage provider.
+     *
+     * @remarks
+     * This method uploads a file to the specified provider or falls back to the default
+     * provider if none is specified. The upload result includes the storage URL, file size,
+     * content type, and provider-specific metadata that can be used for subsequent operations.
+     * @param file - The file blob to upload
+     * @param filename - Optional custom filename (defaults to auto-generated name)
+     * @param providerName - Optional provider identifier (uses default if not specified)
+     * @returns A Promise that resolves to the storage upload result with URL and metadata
+     * @throws {StorageError} When no provider is available or upload fails
+     * @example
+     * ```typescript
+     * // Upload to default provider
+     * const result = await storage.upload(fileBlob, 'data.json');
+     * console.log(`Uploaded to: ${result.url}`);
+     *
+     * // Upload to specific provider
+     * const result2 = await storage.upload(fileBlob, 'data.json', 'pinata');
+     * ```
+     */
+    upload(file: Blob, filename?: string, providerName?: string): Promise<StorageUploadResult>;
+    /**
+     * Download a file using the specified or default provider
+     *
+     * @param url - The storage URL
+     * @param providerName - Optional provider to use
+     * @returns Promise with file blob
+     */
+    download(url: string, providerName?: string): Promise<Blob>;
+    /**
+     * List files using the specified or default provider
+     *
+     * @param options - Optional filtering and pagination
+     * @param providerName - Optional provider to use
+     * @returns Promise with file list
+     */
+    list(options?: StorageListOptions, providerName?: string): Promise<StorageFile[]>;
+    /**
+     * Delete a file using the specified or default provider
+     *
+     * @param url - The storage URL
+     * @param providerName - Optional provider to use
+     * @returns Promise with success status
+     */
+    delete(url: string, providerName?: string): Promise<boolean>;
+    /**
+     * Get list of registered storage provider names
+     *
+     * @returns Array of provider names
+     */
+    getStorageProviders(): string[];
+    /**
+     * Get the default storage provider name
+     *
+     * @returns Default provider name or undefined
+     */
+    getDefaultStorageProvider(): string | undefined;
+}
+
+export { StorageManager };

package/dist/storage/manager.d.ts

@@ -0,0 +1,150 @@
+import { StorageProvider, StorageUploadResult, StorageListOptions, StorageFile } from '../types/storage.js';
+
+/**
+ * Manages multiple storage providers with a unified interface for file operations.
+ *
+ * @remarks
+ * The StorageManager provides a consistent API for uploading, downloading, and managing
+ * files across different storage backends including IPFS, Pinata, Google Drive, and
+ * server-managed storage. It handles provider registration, default provider selection,
+ * and automatic fallback scenarios for robust file operations.
+ *
+ * Used internally by DataController for encrypted file storage, but can also be used
+ * directly for custom storage workflows. Each provider implements the `StorageProvider`
+ * interface to ensure consistent behavior across different storage backends.
+ *
+ * The manager supports provider-specific configurations and features while maintaining
+ * a uniform API surface for applications.
+ * @example
+ * ```typescript
+ * import { StorageManager, IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk';
+ *
+ * const storage = new StorageManager();
+ *
+ * // Register multiple providers
+ * storage.register('ipfs', new IPFSStorage({
+ *   apiEndpoint: 'https://api.pinata.cloud/pinning/pinFileToIPFS'
+ * }), true);
+ * storage.register('pinata', new PinataStorage({
+ *   jwt: 'your-pinata-jwt-token'
+ * }));
+ *
+ * // Upload to default provider
+ * const result = await storage.upload(fileBlob, 'myfile.json');
+ *
+ * // Upload to specific provider
+ * const result2 = await storage.upload(fileBlob, 'myfile.json', 'pinata');
+ * ```
+ * @category Storage
+ * @see {@link https://docs.vana.com/developer/vana-sdk-documentation/core-modules/storage-providers | Storage Providers Guide} for configuration details
+ */
+declare class StorageManager {
+    private providers;
+    private defaultProvider;
+    /**
+     * Registers a storage provider with the manager.
+     *
+     * @remarks
+     * This method adds a new storage provider to the manager's registry and optionally
+     * sets it as the default provider for subsequent operations. If no default provider
+     * is currently set, the first registered provider automatically becomes the default.
+     * @param name - Unique identifier for the provider
+     * @param provider - The storage provider instance implementing the `StorageProvider` interface
+     * @param isDefault - Whether this provider should be set as the default (defaults to `false`)
+     * @example
+     * ```typescript
+     * const pinata = new PinataStorage({ jwt: 'your-jwt-token' });
+     * storage.register('pinata', pinata, true); // Set as default
+     *
+     * const ipfs = new IPFSStorage({ apiEndpoint: 'https://...' });
+     * storage.register('ipfs', ipfs); // Not default
+     * ```
+     */
+    register(name: string, provider: StorageProvider, isDefault?: boolean): void;
+    /**
+     * Get a registered storage provider
+     *
+     * @param name - Provider identifier, uses default if not specified
+     * @returns Storage provider instance
+     */
+    getProvider(name?: string): StorageProvider;
+    /**
+     * List all registered providers
+     *
+     * @returns Array of provider names
+     */
+    listProviders(): string[];
+    /**
+     * Get the default provider name
+     *
+     * @returns Default provider name or null
+     */
+    getDefaultProvider(): string | null;
+    /**
+     * Set the default provider
+     *
+     * @param name - Provider identifier
+     */
+    setDefaultProvider(name: string): void;
+    /**
+     * Uploads a file using the specified or default storage provider.
+     *
+     * @remarks
+     * This method uploads a file to the specified provider or falls back to the default
+     * provider if none is specified. The upload result includes the storage URL, file size,
+     * content type, and provider-specific metadata that can be used for subsequent operations.
+     * @param file - The file blob to upload
+     * @param filename - Optional custom filename (defaults to auto-generated name)
+     * @param providerName - Optional provider identifier (uses default if not specified)
+     * @returns A Promise that resolves to the storage upload result with URL and metadata
+     * @throws {StorageError} When no provider is available or upload fails
+     * @example
+     * ```typescript
+     * // Upload to default provider
+     * const result = await storage.upload(fileBlob, 'data.json');
+     * console.log(`Uploaded to: ${result.url}`);
+     *
+     * // Upload to specific provider
+     * const result2 = await storage.upload(fileBlob, 'data.json', 'pinata');
+     * ```
+     */
+    upload(file: Blob, filename?: string, providerName?: string): Promise<StorageUploadResult>;
+    /**
+     * Download a file using the specified or default provider
+     *
+     * @param url - The storage URL
+     * @param providerName - Optional provider to use
+     * @returns Promise with file blob
+     */
+    download(url: string, providerName?: string): Promise<Blob>;
+    /**
+     * List files using the specified or default provider
+     *
+     * @param options - Optional filtering and pagination
+     * @param providerName - Optional provider to use
+     * @returns Promise with file list
+     */
+    list(options?: StorageListOptions, providerName?: string): Promise<StorageFile[]>;
+    /**
+     * Delete a file using the specified or default provider
+     *
+     * @param url - The storage URL
+     * @param providerName - Optional provider to use
+     * @returns Promise with success status
+     */
+    delete(url: string, providerName?: string): Promise<boolean>;
+    /**
+     * Get list of registered storage provider names
+     *
+     * @returns Array of provider names
+     */
+    getStorageProviders(): string[];
+    /**
+     * Get the default storage provider name
+     *
+     * @returns Default provider name or undefined
+     */
+    getDefaultStorageProvider(): string | undefined;
+}
+
+export { StorageManager };

package/dist/storage/manager.js

@@ -0,0 +1,172 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import {
+  StorageError
+} from "./index";
+class StorageManager {
+  constructor() {
+    __publicField(this, "providers", /* @__PURE__ */ new Map());
+    __publicField(this, "defaultProvider", null);
+  }
+  /**
+   * Registers a storage provider with the manager.
+   *
+   * @remarks
+   * This method adds a new storage provider to the manager's registry and optionally
+   * sets it as the default provider for subsequent operations. If no default provider
+   * is currently set, the first registered provider automatically becomes the default.
+   * @param name - Unique identifier for the provider
+   * @param provider - The storage provider instance implementing the `StorageProvider` interface
+   * @param isDefault - Whether this provider should be set as the default (defaults to `false`)
+   * @example
+   * ```typescript
+   * const pinata = new PinataStorage({ jwt: 'your-jwt-token' });
+   * storage.register('pinata', pinata, true); // Set as default
+   *
+   * const ipfs = new IPFSStorage({ apiEndpoint: 'https://...' });
+   * storage.register('ipfs', ipfs); // Not default
+   * ```
+   */
+  register(name, provider, isDefault = false) {
+    this.providers.set(name, provider);
+    if (isDefault || this.defaultProvider === null) {
+      this.defaultProvider = name;
+    }
+  }
+  /**
+   * Get a registered storage provider
+   *
+   * @param name - Provider identifier, uses default if not specified
+   * @returns Storage provider instance
+   */
+  getProvider(name) {
+    const providerName = name || this.defaultProvider;
+    if (!providerName) {
+      throw new StorageError(
+        "No storage provider specified and no default provider set",
+        "NO_PROVIDER",
+        "manager"
+      );
+    }
+    const provider = this.providers.get(providerName);
+    if (!provider) {
+      throw new StorageError(
+        `Storage provider '${providerName}' not found`,
+        "PROVIDER_NOT_FOUND",
+        "manager"
+      );
+    }
+    return provider;
+  }
+  /**
+   * List all registered providers
+   *
+   * @returns Array of provider names
+   */
+  listProviders() {
+    return Array.from(this.providers.keys());
+  }
+  /**
+   * Get the default provider name
+   *
+   * @returns Default provider name or null
+   */
+  getDefaultProvider() {
+    return this.defaultProvider;
+  }
+  /**
+   * Set the default provider
+   *
+   * @param name - Provider identifier
+   */
+  setDefaultProvider(name) {
+    if (!this.providers.has(name)) {
+      throw new StorageError(
+        `Cannot set default provider '${name}': provider not registered`,
+        "PROVIDER_NOT_FOUND",
+        "manager"
+      );
+    }
+    this.defaultProvider = name;
+  }
+  /**
+   * Uploads a file using the specified or default storage provider.
+   *
+   * @remarks
+   * This method uploads a file to the specified provider or falls back to the default
+   * provider if none is specified. The upload result includes the storage URL, file size,
+   * content type, and provider-specific metadata that can be used for subsequent operations.
+   * @param file - The file blob to upload
+   * @param filename - Optional custom filename (defaults to auto-generated name)
+   * @param providerName - Optional provider identifier (uses default if not specified)
+   * @returns A Promise that resolves to the storage upload result with URL and metadata
+   * @throws {StorageError} When no provider is available or upload fails
+   * @example
+   * ```typescript
+   * // Upload to default provider
+   * const result = await storage.upload(fileBlob, 'data.json');
+   * console.log(`Uploaded to: ${result.url}`);
+   *
+   * // Upload to specific provider
+   * const result2 = await storage.upload(fileBlob, 'data.json', 'pinata');
+   * ```
+   */
+  async upload(file, filename, providerName) {
+    const provider = this.getProvider(providerName);
+    return provider.upload(file, filename);
+  }
+  /**
+   * Download a file using the specified or default provider
+   *
+   * @param url - The storage URL
+   * @param providerName - Optional provider to use
+   * @returns Promise with file blob
+   */
+  async download(url, providerName) {
+    const provider = this.getProvider(providerName);
+    return provider.download(url);
+  }
+  /**
+   * List files using the specified or default provider
+   *
+   * @param options - Optional filtering and pagination
+   * @param providerName - Optional provider to use
+   * @returns Promise with file list
+   */
+  async list(options, providerName) {
+    const provider = this.getProvider(providerName);
+    return provider.list(options);
+  }
+  /**
+   * Delete a file using the specified or default provider
+   *
+   * @param url - The storage URL
+   * @param providerName - Optional provider to use
+   * @returns Promise with success status
+   */
+  async delete(url, providerName) {
+    const provider = this.getProvider(providerName);
+    return provider.delete(url);
+  }
+  /**
+   * Get list of registered storage provider names
+   *
+   * @returns Array of provider names
+   */
+  getStorageProviders() {
+    return Array.from(this.providers.keys());
+  }
+  /**
+   * Get the default storage provider name
+   *
+   * @returns Default provider name or undefined
+   */
+  getDefaultStorageProvider() {
+    return this.defaultProvider || void 0;
+  }
+}
+export {
+  StorageManager
+};
+//# sourceMappingURL=manager.js.map

package/dist/storage/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/manager.ts"],"sourcesContent":["import {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageError,\n} from \"./index\";\n\n/**\n * Manages multiple storage providers with a unified interface for file operations.\n *\n * @remarks\n * The StorageManager provides a consistent API for uploading, downloading, and managing\n * files across different storage backends including IPFS, Pinata, Google Drive, and\n * server-managed storage. It handles provider registration, default provider selection,\n * and automatic fallback scenarios for robust file operations.\n *\n * Used internally by DataController for encrypted file storage, but can also be used\n * directly for custom storage workflows. Each provider implements the `StorageProvider`\n * interface to ensure consistent behavior across different storage backends.\n *\n * The manager supports provider-specific configurations and features while maintaining\n * a uniform API surface for applications.\n * @example\n * ```typescript\n * import { StorageManager, IPFSStorage, PinataStorage } from '@opendatalabs/vana-sdk';\n *\n * const storage = new StorageManager();\n *\n * // Register multiple providers\n * storage.register('ipfs', new IPFSStorage({\n *   apiEndpoint: 'https://api.pinata.cloud/pinning/pinFileToIPFS'\n * }), true);\n * storage.register('pinata', new PinataStorage({\n *   jwt: 'your-pinata-jwt-token'\n * }));\n *\n * // Upload to default provider\n * const result = await storage.upload(fileBlob, 'myfile.json');\n *\n * // Upload to specific provider\n * const result2 = await storage.upload(fileBlob, 'myfile.json', 'pinata');\n * ```\n * @category Storage\n * @see {@link https://docs.vana.com/developer/vana-sdk-documentation/core-modules/storage-providers | Storage Providers Guide} for configuration details\n */\nexport class StorageManager {\n  private providers: Map<string, StorageProvider> = new Map();\n  private defaultProvider: string | null = null;\n\n  /**\n   * Registers a storage provider with the manager.\n   *\n   * @remarks\n   * This method adds a new storage provider to the manager's registry and optionally\n   * sets it as the default provider for subsequent operations. If no default provider\n   * is currently set, the first registered provider automatically becomes the default.\n   * @param name - Unique identifier for the provider\n   * @param provider - The storage provider instance implementing the `StorageProvider` interface\n   * @param isDefault - Whether this provider should be set as the default (defaults to `false`)\n   * @example\n   * ```typescript\n   * const pinata = new PinataStorage({ jwt: 'your-jwt-token' });\n   * storage.register('pinata', pinata, true); // Set as default\n   *\n   * const ipfs = new IPFSStorage({ apiEndpoint: 'https://...' });\n   * storage.register('ipfs', ipfs); // Not default\n   * ```\n   */\n  register(name: string, provider: StorageProvider, isDefault = false): void {\n    this.providers.set(name, provider);\n\n    if (isDefault || this.defaultProvider === null) {\n      this.defaultProvider = name;\n    }\n  }\n\n  /**\n   * Get a registered storage provider\n   *\n   * @param name - Provider identifier, uses default if not specified\n   * @returns Storage provider instance\n   */\n  getProvider(name?: string): StorageProvider {\n    const providerName = name || this.defaultProvider;\n\n    if (!providerName) {\n      throw new StorageError(\n        \"No storage provider specified and no default provider set\",\n        \"NO_PROVIDER\",\n        \"manager\",\n      );\n    }\n\n    const provider = this.providers.get(providerName);\n    if (!provider) {\n      throw new StorageError(\n        `Storage provider '${providerName}' not found`,\n        \"PROVIDER_NOT_FOUND\",\n        \"manager\",\n      );\n    }\n\n    return provider;\n  }\n\n  /**\n   * List all registered providers\n   *\n   * @returns Array of provider names\n   */\n  listProviders(): string[] {\n    return Array.from(this.providers.keys());\n  }\n\n  /**\n   * Get the default provider name\n   *\n   * @returns Default provider name or null\n   */\n  getDefaultProvider(): string | null {\n    return this.defaultProvider;\n  }\n\n  /**\n   * Set the default provider\n   *\n   * @param name - Provider identifier\n   */\n  setDefaultProvider(name: string): void {\n    if (!this.providers.has(name)) {\n      throw new StorageError(\n        `Cannot set default provider '${name}': provider not registered`,\n        \"PROVIDER_NOT_FOUND\",\n        \"manager\",\n      );\n    }\n    this.defaultProvider = name;\n  }\n\n  /**\n   * Uploads a file using the specified or default storage provider.\n   *\n   * @remarks\n   * This method uploads a file to the specified provider or falls back to the default\n   * provider if none is specified. The upload result includes the storage URL, file size,\n   * content type, and provider-specific metadata that can be used for subsequent operations.\n   * @param file - The file blob to upload\n   * @param filename - Optional custom filename (defaults to auto-generated name)\n   * @param providerName - Optional provider identifier (uses default if not specified)\n   * @returns A Promise that resolves to the storage upload result with URL and metadata\n   * @throws {StorageError} When no provider is available or upload fails\n   * @example\n   * ```typescript\n   * // Upload to default provider\n   * const result = await storage.upload(fileBlob, 'data.json');\n   * console.log(`Uploaded to: ${result.url}`);\n   *\n   * // Upload to specific provider\n   * const result2 = await storage.upload(fileBlob, 'data.json', 'pinata');\n   * ```\n   */\n  async upload(\n    file: Blob,\n    filename?: string,\n    providerName?: string,\n  ): Promise<StorageUploadResult> {\n    const provider = this.getProvider(providerName);\n    return provider.upload(file, filename);\n  }\n\n  /**\n   * Download a file using the specified or default provider\n   *\n   * @param url - The storage URL\n   * @param providerName - Optional provider to use\n   * @returns Promise with file blob\n   */\n  async download(url: string, providerName?: string): Promise<Blob> {\n    const provider = this.getProvider(providerName);\n    return provider.download(url);\n  }\n\n  /**\n   * List files using the specified or default provider\n   *\n   * @param options - Optional filtering and pagination\n   * @param providerName - Optional provider to use\n   * @returns Promise with file list\n   */\n  async list(\n    options?: StorageListOptions,\n    providerName?: string,\n  ): Promise<StorageFile[]> {\n    const provider = this.getProvider(providerName);\n    return provider.list(options);\n  }\n\n  /**\n   * Delete a file using the specified or default provider\n   *\n   * @param url - The storage URL\n   * @param providerName - Optional provider to use\n   * @returns Promise with success status\n   */\n  async delete(url: string, providerName?: string): Promise<boolean> {\n    const provider = this.getProvider(providerName);\n    return provider.delete(url);\n  }\n\n  /**\n   * Get list of registered storage provider names\n   *\n   * @returns Array of provider names\n   */\n  getStorageProviders(): string[] {\n    return Array.from(this.providers.keys());\n  }\n\n  /**\n   * Get the default storage provider name\n   *\n   * @returns Default provider name or undefined\n   */\n  getDefaultStorageProvider(): string | undefined {\n    return this.defaultProvider || undefined;\n  }\n}\n"],"mappings":";;;AAAA;AAAA,EAKE;AAAA,OACK;AAwCA,MAAM,eAAe;AAAA,EAArB;AACL,wBAAQ,aAA0C,oBAAI,IAAI;AAC1D,wBAAQ,mBAAiC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBzC,SAAS,MAAc,UAA2B,YAAY,OAAa;AACzE,SAAK,UAAU,IAAI,MAAM,QAAQ;AAEjC,QAAI,aAAa,KAAK,oBAAoB,MAAM;AAC9C,WAAK,kBAAkB;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,MAAgC;AAC1C,UAAM,eAAe,QAAQ,KAAK;AAElC,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,WAAW,KAAK,UAAU,IAAI,YAAY;AAChD,QAAI,CAAC,UAAU;AACb,YAAM,IAAI;AAAA,QACR,qBAAqB,YAAY;AAAA,QACjC;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAA0B;AACxB,WAAO,MAAM,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB,MAAoB;AACrC,QAAI,CAAC,KAAK,UAAU,IAAI,IAAI,GAAG;AAC7B,YAAM,IAAI;AAAA,QACR,gCAAgC,IAAI;AAAA,QACpC;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,SAAK,kBAAkB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,MAAM,OACJ,MACA,UACA,cAC8B;AAC9B,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,OAAO,MAAM,QAAQ;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,SAAS,KAAa,cAAsC;AAChE,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,SAAS,GAAG;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,KACJ,SACA,cACwB;AACxB,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,KAAK,OAAO;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAO,KAAa,cAAyC;AACjE,UAAM,WAAW,KAAK,YAAY,YAAY;AAC9C,WAAO,SAAS,OAAO,GAAG;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,sBAAgC;AAC9B,WAAO,MAAM,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,4BAAgD;AAC9C,WAAO,KAAK,mBAAmB;AAAA,EACjC;AACF;","names":[]}