@opendatalabs/vana-sdk 2.2.3 → 3.0.0

package/dist/protocol/scopes.cjs

@@ -0,0 +1,78 @@
+"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 scopes_exports = {};
+__export(scopes_exports, {
+  ScopeSchema: () => ScopeSchema,
+  parseScope: () => parseScope,
+  scopeCoveredByGrant: () => scopeCoveredByGrant,
+  scopeMatchesPattern: () => scopeMatchesPattern,
+  scopeToPathSegments: () => scopeToPathSegments
+});
+module.exports = __toCommonJS(scopes_exports);
+var import_zod = require("zod");
+const SEGMENT_RE = /^[a-z0-9][a-z0-9_]*$/;
+const ScopeSchema = import_zod.z.string().refine(
+  (scope) => {
+    const parts = scope.split(".");
+    return parts.length >= 2 && parts.length <= 3 && parts.every((part) => SEGMENT_RE.test(part));
+  },
+  {
+    message: "Scope must be {source}.{category}[.{subcategory}] with lowercase alphanumeric segments (may start with a letter or digit)"
+  }
+);
+function parseScope(scope) {
+  const validated = ScopeSchema.parse(scope);
+  const parts = validated.split(".");
+  return {
+    source: parts[0],
+    category: parts[1],
+    subcategory: parts[2],
+    raw: validated
+  };
+}
+function scopeToPathSegments(scope) {
+  const parsed = parseScope(scope);
+  const segments = [parsed.source, parsed.category];
+  if (parsed.subcategory) {
+    segments.push(parsed.subcategory);
+  }
+  return segments;
+}
+function scopeMatchesPattern(requestedScope, grantPattern) {
+  if (grantPattern === "*") return true;
+  if (grantPattern.endsWith(".*")) {
+    const prefix = grantPattern.slice(0, -1);
+    return requestedScope.startsWith(prefix);
+  }
+  return requestedScope === grantPattern;
+}
+function scopeCoveredByGrant(requestedScope, grantedScopes) {
+  return grantedScopes.some(
+    (pattern) => scopeMatchesPattern(requestedScope, pattern)
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ScopeSchema,
+  parseScope,
+  scopeCoveredByGrant,
+  scopeMatchesPattern,
+  scopeToPathSegments
+});
+//# sourceMappingURL=scopes.cjs.map

package/dist/protocol/scopes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/scopes.ts"],"sourcesContent":["import { z } from \"zod\";\n\nconst SEGMENT_RE = /^[a-z0-9][a-z0-9_]*$/;\n\nexport const ScopeSchema = z.string().refine(\n  (scope) => {\n    const parts = scope.split(\".\");\n    return (\n      parts.length >= 2 &&\n      parts.length <= 3 &&\n      parts.every((part) => SEGMENT_RE.test(part))\n    );\n  },\n  {\n    message:\n      \"Scope must be {source}.{category}[.{subcategory}] with lowercase alphanumeric segments (may start with a letter or digit)\",\n  },\n);\n\nexport type Scope = z.infer<typeof ScopeSchema>;\n\nexport interface ParsedScope {\n  source: string;\n  category: string;\n  subcategory?: string;\n  raw: string;\n}\n\nexport function parseScope(scope: string): ParsedScope {\n  const validated = ScopeSchema.parse(scope);\n  const parts = validated.split(\".\");\n  return {\n    source: parts[0],\n    category: parts[1],\n    subcategory: parts[2],\n    raw: validated,\n  };\n}\n\nexport function scopeToPathSegments(scope: string): string[] {\n  const parsed = parseScope(scope);\n  const segments = [parsed.source, parsed.category];\n  if (parsed.subcategory) {\n    segments.push(parsed.subcategory);\n  }\n  return segments;\n}\n\nexport function scopeMatchesPattern(\n  requestedScope: string,\n  grantPattern: string,\n): boolean {\n  if (grantPattern === \"*\") return true;\n\n  if (grantPattern.endsWith(\".*\")) {\n    const prefix = grantPattern.slice(0, -1);\n    return requestedScope.startsWith(prefix);\n  }\n\n  return requestedScope === grantPattern;\n}\n\nexport function scopeCoveredByGrant(\n  requestedScope: string,\n  grantedScopes: string[],\n): boolean {\n  return grantedScopes.some((pattern) =>\n    scopeMatchesPattern(requestedScope, pattern),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAElB,MAAM,aAAa;AAEZ,MAAM,cAAc,aAAE,OAAO,EAAE;AAAA,EACpC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,WACE,MAAM,UAAU,KAChB,MAAM,UAAU,KAChB,MAAM,MAAM,CAAC,SAAS,WAAW,KAAK,IAAI,CAAC;AAAA,EAE/C;AAAA,EACA;AAAA,IACE,SACE;AAAA,EACJ;AACF;AAWO,SAAS,WAAW,OAA4B;AACrD,QAAM,YAAY,YAAY,MAAM,KAAK;AACzC,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,SAAO;AAAA,IACL,QAAQ,MAAM,CAAC;AAAA,IACf,UAAU,MAAM,CAAC;AAAA,IACjB,aAAa,MAAM,CAAC;AAAA,IACpB,KAAK;AAAA,EACP;AACF;AAEO,SAAS,oBAAoB,OAAyB;AAC3D,QAAM,SAAS,WAAW,KAAK;AAC/B,QAAM,WAAW,CAAC,OAAO,QAAQ,OAAO,QAAQ;AAChD,MAAI,OAAO,aAAa;AACtB,aAAS,KAAK,OAAO,WAAW;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,oBACd,gBACA,cACS;AACT,MAAI,iBAAiB,IAAK,QAAO;AAEjC,MAAI,aAAa,SAAS,IAAI,GAAG;AAC/B,UAAM,SAAS,aAAa,MAAM,GAAG,EAAE;AACvC,WAAO,eAAe,WAAW,MAAM;AAAA,EACzC;AAEA,SAAO,mBAAmB;AAC5B;AAEO,SAAS,oBACd,gBACA,eACS;AACT,SAAO,cAAc;AAAA,IAAK,CAAC,YACzB,oBAAoB,gBAAgB,OAAO;AAAA,EAC7C;AACF;","names":[]}

package/dist/protocol/scopes.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const ScopeSchema: z.ZodString;
+export type Scope = z.infer<typeof ScopeSchema>;
+export interface ParsedScope {
+    source: string;
+    category: string;
+    subcategory?: string;
+    raw: string;
+}
+export declare function parseScope(scope: string): ParsedScope;
+export declare function scopeToPathSegments(scope: string): string[];
+export declare function scopeMatchesPattern(requestedScope: string, grantPattern: string): boolean;
+export declare function scopeCoveredByGrant(requestedScope: string, grantedScopes: string[]): boolean;

package/dist/protocol/scopes.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+const SEGMENT_RE = /^[a-z0-9][a-z0-9_]*$/;
+const ScopeSchema = z.string().refine(
+  (scope) => {
+    const parts = scope.split(".");
+    return parts.length >= 2 && parts.length <= 3 && parts.every((part) => SEGMENT_RE.test(part));
+  },
+  {
+    message: "Scope must be {source}.{category}[.{subcategory}] with lowercase alphanumeric segments (may start with a letter or digit)"
+  }
+);
+function parseScope(scope) {
+  const validated = ScopeSchema.parse(scope);
+  const parts = validated.split(".");
+  return {
+    source: parts[0],
+    category: parts[1],
+    subcategory: parts[2],
+    raw: validated
+  };
+}
+function scopeToPathSegments(scope) {
+  const parsed = parseScope(scope);
+  const segments = [parsed.source, parsed.category];
+  if (parsed.subcategory) {
+    segments.push(parsed.subcategory);
+  }
+  return segments;
+}
+function scopeMatchesPattern(requestedScope, grantPattern) {
+  if (grantPattern === "*") return true;
+  if (grantPattern.endsWith(".*")) {
+    const prefix = grantPattern.slice(0, -1);
+    return requestedScope.startsWith(prefix);
+  }
+  return requestedScope === grantPattern;
+}
+function scopeCoveredByGrant(requestedScope, grantedScopes) {
+  return grantedScopes.some(
+    (pattern) => scopeMatchesPattern(requestedScope, pattern)
+  );
+}
+export {
+  ScopeSchema,
+  parseScope,
+  scopeCoveredByGrant,
+  scopeMatchesPattern,
+  scopeToPathSegments
+};
+//# sourceMappingURL=scopes.js.map

package/dist/protocol/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/scopes.ts"],"sourcesContent":["import { z } from \"zod\";\n\nconst SEGMENT_RE = /^[a-z0-9][a-z0-9_]*$/;\n\nexport const ScopeSchema = z.string().refine(\n  (scope) => {\n    const parts = scope.split(\".\");\n    return (\n      parts.length >= 2 &&\n      parts.length <= 3 &&\n      parts.every((part) => SEGMENT_RE.test(part))\n    );\n  },\n  {\n    message:\n      \"Scope must be {source}.{category}[.{subcategory}] with lowercase alphanumeric segments (may start with a letter or digit)\",\n  },\n);\n\nexport type Scope = z.infer<typeof ScopeSchema>;\n\nexport interface ParsedScope {\n  source: string;\n  category: string;\n  subcategory?: string;\n  raw: string;\n}\n\nexport function parseScope(scope: string): ParsedScope {\n  const validated = ScopeSchema.parse(scope);\n  const parts = validated.split(\".\");\n  return {\n    source: parts[0],\n    category: parts[1],\n    subcategory: parts[2],\n    raw: validated,\n  };\n}\n\nexport function scopeToPathSegments(scope: string): string[] {\n  const parsed = parseScope(scope);\n  const segments = [parsed.source, parsed.category];\n  if (parsed.subcategory) {\n    segments.push(parsed.subcategory);\n  }\n  return segments;\n}\n\nexport function scopeMatchesPattern(\n  requestedScope: string,\n  grantPattern: string,\n): boolean {\n  if (grantPattern === \"*\") return true;\n\n  if (grantPattern.endsWith(\".*\")) {\n    const prefix = grantPattern.slice(0, -1);\n    return requestedScope.startsWith(prefix);\n  }\n\n  return requestedScope === grantPattern;\n}\n\nexport function scopeCoveredByGrant(\n  requestedScope: string,\n  grantedScopes: string[],\n): boolean {\n  return grantedScopes.some((pattern) =>\n    scopeMatchesPattern(requestedScope, pattern),\n  );\n}\n"],"mappings":"AAAA,SAAS,SAAS;AAElB,MAAM,aAAa;AAEZ,MAAM,cAAc,EAAE,OAAO,EAAE;AAAA,EACpC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,WACE,MAAM,UAAU,KAChB,MAAM,UAAU,KAChB,MAAM,MAAM,CAAC,SAAS,WAAW,KAAK,IAAI,CAAC;AAAA,EAE/C;AAAA,EACA;AAAA,IACE,SACE;AAAA,EACJ;AACF;AAWO,SAAS,WAAW,OAA4B;AACrD,QAAM,YAAY,YAAY,MAAM,KAAK;AACzC,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,SAAO;AAAA,IACL,QAAQ,MAAM,CAAC;AAAA,IACf,UAAU,MAAM,CAAC;AAAA,IACjB,aAAa,MAAM,CAAC;AAAA,IACpB,KAAK;AAAA,EACP;AACF;AAEO,SAAS,oBAAoB,OAAyB;AAC3D,QAAM,SAAS,WAAW,KAAK;AAC/B,QAAM,WAAW,CAAC,OAAO,QAAQ,OAAO,QAAQ;AAChD,MAAI,OAAO,aAAa;AACtB,aAAS,KAAK,OAAO,WAAW;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,oBACd,gBACA,cACS;AACT,MAAI,iBAAiB,IAAK,QAAO;AAEjC,MAAI,aAAa,SAAS,IAAI,GAAG;AAC/B,UAAM,SAAS,aAAa,MAAM,GAAG,EAAE;AACvC,WAAO,eAAe,WAAW,MAAM;AAAA,EACzC;AAEA,SAAO,mBAAmB;AAC5B;AAEO,SAAS,oBACd,gBACA,eACS;AACT,SAAO,cAAc;AAAA,IAAK,CAAC,YACzB,oBAAoB,gBAAgB,OAAO;AAAA,EAC7C;AACF;","names":[]}

package/dist/{types/atomicStore.cjs → storage/default.cjs}

@@ -16,16 +16,17 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var atomicStore_exports = {};
-__export(atomicStore_exports, {
-  hasNonceSupport: () => hasNonceSupport
+var default_exports = {};
+__export(default_exports, {
+  createVanaStorageProvider: () => createVanaStorageProvider
 });
-module.exports = __toCommonJS(atomicStore_exports);
-function hasNonceSupport(store) {
-  return "atomicAssignNonce" in store && typeof store.atomicAssignNonce === "function";
+module.exports = __toCommonJS(default_exports);
+var import_vana_storage = require("./providers/vana-storage");
+function createVanaStorageProvider(options) {
+  return new import_vana_storage.VanaStorage(options);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  hasNonceSupport
+  createVanaStorageProvider
 });
-//# sourceMappingURL=atomicStore.cjs.map
+//# sourceMappingURL=default.cjs.map

package/dist/storage/default.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/default.ts"],"sourcesContent":["import type { StorageProvider } from \"../types/storage\";\nimport { VanaStorage, type VanaStorageConfig } from \"./providers/vana-storage\";\n\nexport type VanaStorageProviderOptions = VanaStorageConfig;\n\nexport function createVanaStorageProvider(\n  options: VanaStorageProviderOptions,\n): StorageProvider {\n  return new VanaStorage(options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,0BAAoD;AAI7C,SAAS,0BACd,SACiB;AACjB,SAAO,IAAI,gCAAY,OAAO;AAChC;","names":[]}

package/dist/storage/default.d.ts

@@ -0,0 +1,4 @@
+import type { StorageProvider } from "../types/storage";
+import { type VanaStorageConfig } from "./providers/vana-storage";
+export type VanaStorageProviderOptions = VanaStorageConfig;
+export declare function createVanaStorageProvider(options: VanaStorageProviderOptions): StorageProvider;

package/dist/storage/default.js

@@ -0,0 +1,8 @@
+import { VanaStorage } from "./providers/vana-storage";
+function createVanaStorageProvider(options) {
+  return new VanaStorage(options);
+}
+export {
+  createVanaStorageProvider
+};
+//# sourceMappingURL=default.js.map

package/dist/storage/default.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/default.ts"],"sourcesContent":["import type { StorageProvider } from \"../types/storage\";\nimport { VanaStorage, type VanaStorageConfig } from \"./providers/vana-storage\";\n\nexport type VanaStorageProviderOptions = VanaStorageConfig;\n\nexport function createVanaStorageProvider(\n  options: VanaStorageProviderOptions,\n): StorageProvider {\n  return new VanaStorage(options);\n}\n"],"mappings":"AACA,SAAS,mBAA2C;AAI7C,SAAS,0BACd,SACiB;AACjB,SAAO,IAAI,YAAY,OAAO;AAChC;","names":[]}

package/dist/storage/index.cjs

@@ -23,11 +23,17 @@ __export(storage_exports, {
   GoogleDriveStorage: () => import_google_drive.GoogleDriveStorage,
   IpfsStorage: () => import_ipfs.IpfsStorage,
   PinataStorage: () => import_pinata.PinataStorage,
+  R2Storage: () => import_r2.R2Storage,
   StorageError: () => import_storage.StorageError,
-  StorageManager: () => import_manager.StorageManager
+  StorageManager: () => import_manager.StorageManager,
+  VanaStorage: () => import_vana_storage.VanaStorage,
+  createVanaStorageProvider: () => import_default.createVanaStorageProvider
 });
 module.exports = __toCommonJS(storage_exports);
 var import_storage = require("../types/storage");
+var import_default = require("./default");
+var import_r2 = require("./providers/r2");
+var import_vana_storage = require("./providers/vana-storage");
 var import_google_drive = require("./providers/google-drive");
 var import_dropbox = require("./providers/dropbox");
 var import_ipfs = require("./providers/ipfs");
@@ -41,7 +47,10 @@ var import_manager = require("./manager");
   GoogleDriveStorage,
   IpfsStorage,
   PinataStorage,
+  R2Storage,
   StorageError,
-  StorageManager
+  StorageManager,
+  VanaStorage,
+  createVanaStorageProvider
 });
 //# sourceMappingURL=index.cjs.map

package/dist/storage/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/storage/index.ts"],"sourcesContent":["/**\n * Storage API for Vana SDK\n *\n * Provides unified interface for different storage providers\n * to upload, download, and manage user data files.\n *\n * ## Storage Provider Decision Tree\n *\n * Choose your storage provider based on your needs:\n *\n * **Need full CRUD operations and metadata?**\n * - ✅ Use `PinataStorage` - Managed IPFS with listing, deletion, and rich metadata\n *\n * **Want to use your own IPFS infrastructure?**\n * - ✅ Use `IpfsStorage.forInfura()` - Connect to Infura IPFS service\n * - ✅ Use `IpfsStorage.forLocalNode()` - Connect to local IPFS node\n * - ✅ Use `new IpfsStorage()` - Connect to any IPFS-compatible service\n *\n * **Want flexible callback-based storage?**\n * - ✅ Use `CallbackStorage` - Implement storage via custom callbacks (HTTP, WebSocket, etc.)\n *\n * **Need Google Drive integration?**\n * - ✅ Use `GoogleDriveStorage` - Direct Google Drive API with folder management\n *\n * @example\n * ```typescript\n * // Managed IPFS with full features\n * const pinata = new PinataStorage({ jwt: \"your-jwt\" });\n *\n * // Standard IPFS with Infura\n * const ipfs = IpfsStorage.forInfura({ projectId: \"...\", projectSecret: \"...\" });\n *\n * // Callback-based storage (flexible)\n * const storage = new CallbackStorage({\n *   async upload(blob, filename) {\n *     // Your custom upload logic\n *     const response = await fetch('/api/upload', { method: 'POST', body: blob });\n *     const data = await response.json();\n *     return { url: data.url, size: blob.size, contentType: blob.type };\n *   },\n *   async download(identifier) {\n *     // Your custom download logic\n *     const response = await fetch(`/api/download/${identifier}`);\n *     return response.blob();\n *   }\n * });\n * ```\n */\n\n// Re-export storage types from types module to avoid circular dependencies\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"../types/storage\";\n\nexport { StorageError } from \"../types/storage\";\n\n// Export storage providers\nexport { GoogleDriveStorage } from \"./providers/google-drive\";\nexport { DropboxStorage } from \"./providers/dropbox\";\nexport { IpfsStorage } from \"./providers/ipfs\";\nexport { PinataStorage } from \"./providers/pinata\";\nexport { CallbackStorage } from \"./providers/callback-storage\";\n\n// Export storage manager\nexport { StorageManager } from \"./manager\";\n\n// Export storage callback types\nexport type {\n  StorageCallbacks,\n  StorageDownloadOptions,\n  StorageListResult,\n} from \"../types/config\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0DA,qBAA6B;AAG7B,0BAAmC;AACnC,qBAA+B;AAC/B,kBAA4B;AAC5B,oBAA8B;AAC9B,8BAAgC;AAGhC,qBAA+B;","names":[]}
+{"version":3,"sources":["../../src/storage/index.ts"],"sourcesContent":["/**\n * Storage API for Vana SDK\n *\n * Provides unified interface for different storage providers\n * to upload, download, and manage user data files.\n *\n * ## Storage Provider Decision Tree\n *\n * Choose your storage provider based on your needs:\n *\n * **Default backend hosted by ODL?**\n * - ✅ Use `VanaStorage` - storage.vana.com with Web3Signed auth.\n *\n * **Need full CRUD operations and metadata?**\n * - ✅ Use `PinataStorage` - Managed IPFS with listing, deletion, and rich metadata\n *\n * **Want to use your own IPFS infrastructure?**\n * - ✅ Use `IpfsStorage.forInfura()` - Connect to Infura IPFS service\n * - ✅ Use `IpfsStorage.forLocalNode()` - Connect to local IPFS node\n * - ✅ Use `new IpfsStorage()` - Connect to any IPFS-compatible service\n *\n * **Want flexible callback-based storage?**\n * - ✅ Use `CallbackStorage` - Implement storage via custom callbacks (HTTP, WebSocket, etc.)\n *\n * **Need Google Drive integration?**\n * - ✅ Use `GoogleDriveStorage` - Direct Google Drive API with folder management\n *\n * @example\n * ```typescript\n * // Managed IPFS with full features\n * const pinata = new PinataStorage({ jwt: \"your-jwt\" });\n *\n * // Standard IPFS with Infura\n * const ipfs = IpfsStorage.forInfura({ projectId: \"...\", projectSecret: \"...\" });\n *\n * // Callback-based storage (flexible)\n * const storage = new CallbackStorage({\n *   async upload(blob, filename) {\n *     // Your custom upload logic\n *     const response = await fetch('/api/upload', { method: 'POST', body: blob });\n *     const data = await response.json();\n *     return { url: data.url, size: blob.size, contentType: blob.type };\n *   },\n *   async download(identifier) {\n *     // Your custom download logic\n *     const response = await fetch(`/api/download/${identifier}`);\n *     return response.blob();\n *   }\n * });\n * ```\n */\n\n// Re-export storage types from types module to avoid circular dependencies\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"../types/storage\";\n\nexport { StorageError } from \"../types/storage\";\n\n// Export default Vana storage factory\nexport { createVanaStorageProvider } from \"./default\";\nexport type { VanaStorageProviderOptions } from \"./default\";\n\n// Export storage providers\nexport { R2Storage } from \"./providers/r2\";\nexport type { R2Config } from \"./providers/r2\";\nexport { VanaStorage } from \"./providers/vana-storage\";\nexport type {\n  VanaStorageConfig,\n  VanaStorageSigner,\n} from \"./providers/vana-storage\";\nexport { GoogleDriveStorage } from \"./providers/google-drive\";\nexport { DropboxStorage } from \"./providers/dropbox\";\nexport { IpfsStorage } from \"./providers/ipfs\";\nexport { PinataStorage } from \"./providers/pinata\";\nexport { CallbackStorage } from \"./providers/callback-storage\";\n\n// Export storage manager\nexport { StorageManager } from \"./manager\";\n\n// Export storage callback types\nexport type {\n  StorageCallbacks,\n  StorageDownloadOptions,\n  StorageListResult,\n} from \"../types/config\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6DA,qBAA6B;AAG7B,qBAA0C;AAI1C,gBAA0B;AAE1B,0BAA4B;AAK5B,0BAAmC;AACnC,qBAA+B;AAC/B,kBAA4B;AAC5B,oBAA8B;AAC9B,8BAAgC;AAGhC,qBAA+B;","names":[]}

package/dist/storage/index.d.ts

@@ -8,6 +8,9 @@
  *
  * Choose your storage provider based on your needs:
  *
+ * **Default backend hosted by ODL?**
+ * - ✅ Use `VanaStorage` - storage.vana.com with Web3Signed auth.
+ *
  * **Need full CRUD operations and metadata?**
  * - ✅ Use `PinataStorage` - Managed IPFS with listing, deletion, and rich metadata
  *
@@ -48,6 +51,12 @@
  */
 export type { StorageProvider, StorageUploadResult, StorageFile, StorageListOptions, StorageProviderConfig, } from "../types/storage";
 export { StorageError } from "../types/storage";
+export { createVanaStorageProvider } from "./default";
+export type { VanaStorageProviderOptions } from "./default";
+export { R2Storage } from "./providers/r2";
+export type { R2Config } from "./providers/r2";
+export { VanaStorage } from "./providers/vana-storage";
+export type { VanaStorageConfig, VanaStorageSigner, } from "./providers/vana-storage";
 export { GoogleDriveStorage } from "./providers/google-drive";
 export { DropboxStorage } from "./providers/dropbox";
 export { IpfsStorage } from "./providers/ipfs";

package/dist/storage/index.js

@@ -1,4 +1,7 @@
 import { StorageError } from "../types/storage";
+import { createVanaStorageProvider } from "./default";
+import { R2Storage } from "./providers/r2";
+import { VanaStorage } from "./providers/vana-storage";
 import { GoogleDriveStorage } from "./providers/google-drive";
 import { DropboxStorage } from "./providers/dropbox";
 import { IpfsStorage } from "./providers/ipfs";
@@ -11,7 +14,10 @@ export {
   GoogleDriveStorage,
   IpfsStorage,
   PinataStorage,
+  R2Storage,
   StorageError,
-  StorageManager
+  StorageManager,
+  VanaStorage,
+  createVanaStorageProvider
 };
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/storage/index.ts"],"sourcesContent":["/**\n * Storage API for Vana SDK\n *\n * Provides unified interface for different storage providers\n * to upload, download, and manage user data files.\n *\n * ## Storage Provider Decision Tree\n *\n * Choose your storage provider based on your needs:\n *\n * **Need full CRUD operations and metadata?**\n * - ✅ Use `PinataStorage` - Managed IPFS with listing, deletion, and rich metadata\n *\n * **Want to use your own IPFS infrastructure?**\n * - ✅ Use `IpfsStorage.forInfura()` - Connect to Infura IPFS service\n * - ✅ Use `IpfsStorage.forLocalNode()` - Connect to local IPFS node\n * - ✅ Use `new IpfsStorage()` - Connect to any IPFS-compatible service\n *\n * **Want flexible callback-based storage?**\n * - ✅ Use `CallbackStorage` - Implement storage via custom callbacks (HTTP, WebSocket, etc.)\n *\n * **Need Google Drive integration?**\n * - ✅ Use `GoogleDriveStorage` - Direct Google Drive API with folder management\n *\n * @example\n * ```typescript\n * // Managed IPFS with full features\n * const pinata = new PinataStorage({ jwt: \"your-jwt\" });\n *\n * // Standard IPFS with Infura\n * const ipfs = IpfsStorage.forInfura({ projectId: \"...\", projectSecret: \"...\" });\n *\n * // Callback-based storage (flexible)\n * const storage = new CallbackStorage({\n *   async upload(blob, filename) {\n *     // Your custom upload logic\n *     const response = await fetch('/api/upload', { method: 'POST', body: blob });\n *     const data = await response.json();\n *     return { url: data.url, size: blob.size, contentType: blob.type };\n *   },\n *   async download(identifier) {\n *     // Your custom download logic\n *     const response = await fetch(`/api/download/${identifier}`);\n *     return response.blob();\n *   }\n * });\n * ```\n */\n\n// Re-export storage types from types module to avoid circular dependencies\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"../types/storage\";\n\nexport { StorageError } from \"../types/storage\";\n\n// Export storage providers\nexport { GoogleDriveStorage } from \"./providers/google-drive\";\nexport { DropboxStorage } from \"./providers/dropbox\";\nexport { IpfsStorage } from \"./providers/ipfs\";\nexport { PinataStorage } from \"./providers/pinata\";\nexport { CallbackStorage } from \"./providers/callback-storage\";\n\n// Export storage manager\nexport { StorageManager } from \"./manager\";\n\n// Export storage callback types\nexport type {\n  StorageCallbacks,\n  StorageDownloadOptions,\n  StorageListResult,\n} from \"../types/config\";\n"],"mappings":"AA0DA,SAAS,oBAAoB;AAG7B,SAAS,0BAA0B;AACnC,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAGhC,SAAS,sBAAsB;","names":[]}
+{"version":3,"sources":["../../src/storage/index.ts"],"sourcesContent":["/**\n * Storage API for Vana SDK\n *\n * Provides unified interface for different storage providers\n * to upload, download, and manage user data files.\n *\n * ## Storage Provider Decision Tree\n *\n * Choose your storage provider based on your needs:\n *\n * **Default backend hosted by ODL?**\n * - ✅ Use `VanaStorage` - storage.vana.com with Web3Signed auth.\n *\n * **Need full CRUD operations and metadata?**\n * - ✅ Use `PinataStorage` - Managed IPFS with listing, deletion, and rich metadata\n *\n * **Want to use your own IPFS infrastructure?**\n * - ✅ Use `IpfsStorage.forInfura()` - Connect to Infura IPFS service\n * - ✅ Use `IpfsStorage.forLocalNode()` - Connect to local IPFS node\n * - ✅ Use `new IpfsStorage()` - Connect to any IPFS-compatible service\n *\n * **Want flexible callback-based storage?**\n * - ✅ Use `CallbackStorage` - Implement storage via custom callbacks (HTTP, WebSocket, etc.)\n *\n * **Need Google Drive integration?**\n * - ✅ Use `GoogleDriveStorage` - Direct Google Drive API with folder management\n *\n * @example\n * ```typescript\n * // Managed IPFS with full features\n * const pinata = new PinataStorage({ jwt: \"your-jwt\" });\n *\n * // Standard IPFS with Infura\n * const ipfs = IpfsStorage.forInfura({ projectId: \"...\", projectSecret: \"...\" });\n *\n * // Callback-based storage (flexible)\n * const storage = new CallbackStorage({\n *   async upload(blob, filename) {\n *     // Your custom upload logic\n *     const response = await fetch('/api/upload', { method: 'POST', body: blob });\n *     const data = await response.json();\n *     return { url: data.url, size: blob.size, contentType: blob.type };\n *   },\n *   async download(identifier) {\n *     // Your custom download logic\n *     const response = await fetch(`/api/download/${identifier}`);\n *     return response.blob();\n *   }\n * });\n * ```\n */\n\n// Re-export storage types from types module to avoid circular dependencies\nexport type {\n  StorageProvider,\n  StorageUploadResult,\n  StorageFile,\n  StorageListOptions,\n  StorageProviderConfig,\n} from \"../types/storage\";\n\nexport { StorageError } from \"../types/storage\";\n\n// Export default Vana storage factory\nexport { createVanaStorageProvider } from \"./default\";\nexport type { VanaStorageProviderOptions } from \"./default\";\n\n// Export storage providers\nexport { R2Storage } from \"./providers/r2\";\nexport type { R2Config } from \"./providers/r2\";\nexport { VanaStorage } from \"./providers/vana-storage\";\nexport type {\n  VanaStorageConfig,\n  VanaStorageSigner,\n} from \"./providers/vana-storage\";\nexport { GoogleDriveStorage } from \"./providers/google-drive\";\nexport { DropboxStorage } from \"./providers/dropbox\";\nexport { IpfsStorage } from \"./providers/ipfs\";\nexport { PinataStorage } from \"./providers/pinata\";\nexport { CallbackStorage } from \"./providers/callback-storage\";\n\n// Export storage manager\nexport { StorageManager } from \"./manager\";\n\n// Export storage callback types\nexport type {\n  StorageCallbacks,\n  StorageDownloadOptions,\n  StorageListResult,\n} from \"../types/config\";\n"],"mappings":"AA6DA,SAAS,oBAAoB;AAG7B,SAAS,iCAAiC;AAI1C,SAAS,iBAAiB;AAE1B,SAAS,mBAAmB;AAK5B,SAAS,0BAA0B;AACnC,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAGhC,SAAS,sBAAsB;","names":[]}

package/dist/storage/providers/callback-storage.cjs

@@ -38,6 +38,7 @@ class CallbackStorage {
       );
     }
   }
+  callbacks;
   /**
    * Uploads a file using the user-provided callback.
    *

package/dist/storage/providers/callback-storage.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/callback-storage.ts"],"sourcesContent":["/**\n * Provides user-defined storage operations through callback functions.\n *\n * @remarks\n * This module implements a flexible storage provider that delegates all\n * operations to user-provided callbacks. It enables custom storage\n * integrations without modifying the SDK, supporting any backend including\n * HTTP APIs, WebSocket servers, cloud storage services, or local filesystems.\n *\n * @category Storage\n * @module storage/providers/callback-storage\n */\n\nimport type { StorageCallbacks } from \"../../types/config\";\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../../types/storage\";\n\n/**\n * Delegates storage operations to user-provided callback functions.\n *\n * @remarks\n * This provider enables custom storage integrations by delegating all\n * operations to user-defined callbacks. It follows the same flexible\n * pattern as relayer callbacks, allowing implementations via HTTP,\n * WebSocket, direct cloud APIs, local filesystem, or any other backend.\n *\n * The provider validates callback results and wraps errors in consistent\n * `StorageError` types for uniform error handling across the SDK.\n *\n * @example\n * ```typescript\n * // HTTP-based implementation\n * const httpCallbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const formData = new FormData();\n *     formData.append('file', blob, filename);\n *     const response = await fetch('/api/storage/upload', {\n *       method: 'POST',\n *       body: formData\n *     });\n *     const data = await response.json();\n *     return {\n *       url: data.url,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const response = await fetch(`/api/storage/download/${identifier}`);\n *     return response.blob();\n *   }\n * };\n *\n * const storage = new CallbackStorage(httpCallbacks);\n *\n * // Direct S3 implementation\n * const s3Callbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const url = await getPresignedUploadUrl(filename);\n *     await fetch(url, { method: 'PUT', body: blob });\n *     return {\n *       url: `s3://my-bucket/${filename}`,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const url = await getPresignedDownloadUrl(identifier);\n *     const response = await fetch(url);\n *     return response.blob();\n *   }\n * };\n * ```\n *\n * @category Storage\n */\nexport class CallbackStorage implements StorageProvider {\n  /**\n   * Creates a new callback-based storage provider.\n   *\n   * @param callbacks - User-provided storage operation callbacks.\n   *   Must include at minimum `upload` and `download` functions.\n   * @throws {Error} If required callbacks are missing\n   */\n  constructor(private readonly callbacks: StorageCallbacks) {\n    if (!callbacks.upload || !callbacks.download) {\n      throw new Error(\n        \"CallbackStorage requires both upload and download callbacks\",\n      );\n    }\n  }\n\n  /**\n   * Uploads a file using the user-provided callback.\n   *\n   * @param file - The blob to upload.\n   *   Can be any Blob-compatible object including File.\n   * @param filename - Optional filename for the upload.\n   *   If not provided, callback may generate a name.\n   * @returns Upload result containing URL and metadata\n   *\n   * @throws {StorageError} With code 'INVALID_UPLOAD_RESULT' if callback returns invalid data\n   * @throws {StorageError} With code 'UPLOAD_ERROR' if upload fails\n   *\n   * @example\n   * ```typescript\n   * const file = new File(['content'], 'data.json');\n   * const result = await storage.upload(file);\n   * console.log('Uploaded to:', result.url);\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const result = await this.callbacks.upload(file, filename);\n\n      // Validate the result has required fields\n      if (!result.url || result.url.trim() === \"\") {\n        throw new StorageError(\n          \"Upload callback returned invalid result: missing or empty url\",\n          \"INVALID_UPLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Upload failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"UPLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Downloads a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to download.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns The downloaded file as a Blob\n   *\n   * @throws {StorageError} With code 'INVALID_DOWNLOAD_RESULT' if callback returns non-Blob\n   * @throws {StorageError} With code 'DOWNLOAD_ERROR' if download fails\n   *\n   * @example\n   * ```typescript\n   * const blob = await storage.download('https://storage.example.com/file123');\n   * const text = await blob.text();\n   * ```\n   */\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      const blob = await this.callbacks.download(identifier);\n\n      if (!(blob instanceof Blob)) {\n        throw new StorageError(\n          \"Download callback returned invalid result: expected Blob\",\n          \"INVALID_DOWNLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Download failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DOWNLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Lists files using the user-provided callback.\n   *\n   * @param options - Optional list options.\n   * @param options.namePattern - Pattern to filter files by name.\n   *   Implementation depends on callback.\n   * @param options.limit - Maximum number of files to return.\n   *   Implementation depends on callback.\n   * @returns Array of storage file metadata\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if list callback not provided\n   * @throws {StorageError} With code 'LIST_ERROR' if listing fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `list` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const files = await storage.list({ namePattern: '*.json' });\n   * files.forEach(file => console.log(file.name, file.size));\n   * ```\n   */\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.callbacks.list) {\n      throw new StorageError(\n        \"List operation not supported - no list callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      const result = await this.callbacks.list(options?.namePattern, options);\n\n      // Convert list result to StorageFile format\n      return result.items.map((item, index) => ({\n        id: item.identifier,\n        name: item.identifier.split(\"/\").pop() ?? `file-${index}`,\n        url: item.identifier,\n        size: item.size ?? 0,\n        contentType: \"application/octet-stream\",\n        createdAt: item.lastModified ?? new Date(),\n        metadata: item.metadata,\n      }));\n    } catch (error) {\n      throw new StorageError(\n        `List failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"LIST_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Deletes a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to delete.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns True if deletion succeeded, false otherwise\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if delete callback not provided\n   * @throws {StorageError} With code 'DELETE_ERROR' if deletion fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `delete` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const deleted = await storage.delete('https://storage.example.com/file123');\n   * if (deleted) {\n   *   console.log('File deleted successfully');\n   * }\n   * ```\n   */\n  async delete(url: string): Promise<boolean> {\n    if (!this.callbacks.delete) {\n      throw new StorageError(\n        \"Delete operation not supported - no delete callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      return await this.callbacks.delete(identifier);\n    } catch (error) {\n      throw new StorageError(\n        `Delete failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DELETE_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Returns the provider's configuration and capabilities.\n   *\n   * @returns Configuration object indicating supported features\n   *\n   * @example\n   * ```typescript\n   * const config = storage.getConfig();\n   * if (config.features.list) {\n   *   // List operation is supported\n   *   const files = await storage.list();\n   * }\n   * ```\n   */\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"callback-storage\",\n      type: \"callback\",\n      requiresAuth: false,\n      features: {\n        upload: true,\n        download: true,\n        list: !!this.callbacks.list,\n        delete: !!this.callbacks.delete,\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/callback-storage.ts"],"sourcesContent":["/**\n * Provides user-defined storage operations through callback functions.\n *\n * @remarks\n * This module implements a flexible storage provider that delegates all\n * operations to user-provided callbacks. It enables custom storage\n * integrations without modifying the SDK, supporting any backend including\n * HTTP APIs, WebSocket servers, cloud storage services, or local filesystems.\n *\n * @category Storage\n * @module storage/providers/callback-storage\n */\n\nimport type { StorageCallbacks } from \"../../types/config\";\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../../types/storage\";\n\n/**\n * Delegates storage operations to user-provided callback functions.\n *\n * @remarks\n * This provider enables custom storage integrations by delegating all\n * operations to user-defined callbacks. It follows the same flexible\n * pattern as relayer callbacks, allowing implementations via HTTP,\n * WebSocket, direct cloud APIs, local filesystem, or any other backend.\n *\n * The provider validates callback results and wraps errors in consistent\n * `StorageError` types for uniform error handling across the SDK.\n *\n * @example\n * ```typescript\n * // HTTP-based implementation\n * const httpCallbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const formData = new FormData();\n *     formData.append('file', blob, filename);\n *     const response = await fetch('/api/storage/upload', {\n *       method: 'POST',\n *       body: formData\n *     });\n *     const data = await response.json();\n *     return {\n *       url: data.url,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const response = await fetch(`/api/storage/download/${identifier}`);\n *     return response.blob();\n *   }\n * };\n *\n * const storage = new CallbackStorage(httpCallbacks);\n *\n * // Direct S3 implementation\n * const s3Callbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const url = await getPresignedUploadUrl(filename);\n *     await fetch(url, { method: 'PUT', body: blob });\n *     return {\n *       url: `s3://my-bucket/${filename}`,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const url = await getPresignedDownloadUrl(identifier);\n *     const response = await fetch(url);\n *     return response.blob();\n *   }\n * };\n * ```\n *\n * @category Storage\n */\nexport class CallbackStorage implements StorageProvider {\n  /**\n   * Creates a new callback-based storage provider.\n   *\n   * @param callbacks - User-provided storage operation callbacks.\n   *   Must include at minimum `upload` and `download` functions.\n   * @throws {Error} If required callbacks are missing\n   */\n  constructor(private readonly callbacks: StorageCallbacks) {\n    if (!callbacks.upload || !callbacks.download) {\n      throw new Error(\n        \"CallbackStorage requires both upload and download callbacks\",\n      );\n    }\n  }\n\n  /**\n   * Uploads a file using the user-provided callback.\n   *\n   * @param file - The blob to upload.\n   *   Can be any Blob-compatible object including File.\n   * @param filename - Optional filename for the upload.\n   *   If not provided, callback may generate a name.\n   * @returns Upload result containing URL and metadata\n   *\n   * @throws {StorageError} With code 'INVALID_UPLOAD_RESULT' if callback returns invalid data\n   * @throws {StorageError} With code 'UPLOAD_ERROR' if upload fails\n   *\n   * @example\n   * ```typescript\n   * const file = new File(['content'], 'data.json');\n   * const result = await storage.upload(file);\n   * console.log('Uploaded to:', result.url);\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const result = await this.callbacks.upload(file, filename);\n\n      // Validate the result has required fields\n      if (!result.url || result.url.trim() === \"\") {\n        throw new StorageError(\n          \"Upload callback returned invalid result: missing or empty url\",\n          \"INVALID_UPLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Upload failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"UPLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Downloads a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to download.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns The downloaded file as a Blob\n   *\n   * @throws {StorageError} With code 'INVALID_DOWNLOAD_RESULT' if callback returns non-Blob\n   * @throws {StorageError} With code 'DOWNLOAD_ERROR' if download fails\n   *\n   * @example\n   * ```typescript\n   * const blob = await storage.download('https://storage.example.com/file123');\n   * const text = await blob.text();\n   * ```\n   */\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      const blob = await this.callbacks.download(identifier);\n\n      if (!(blob instanceof Blob)) {\n        throw new StorageError(\n          \"Download callback returned invalid result: expected Blob\",\n          \"INVALID_DOWNLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Download failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DOWNLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Lists files using the user-provided callback.\n   *\n   * @param options - Optional list options.\n   * @param options.namePattern - Pattern to filter files by name.\n   *   Implementation depends on callback.\n   * @param options.limit - Maximum number of files to return.\n   *   Implementation depends on callback.\n   * @returns Array of storage file metadata\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if list callback not provided\n   * @throws {StorageError} With code 'LIST_ERROR' if listing fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `list` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const files = await storage.list({ namePattern: '*.json' });\n   * files.forEach(file => console.log(file.name, file.size));\n   * ```\n   */\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.callbacks.list) {\n      throw new StorageError(\n        \"List operation not supported - no list callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      const result = await this.callbacks.list(options?.namePattern, options);\n\n      // Convert list result to StorageFile format\n      return result.items.map((item, index) => ({\n        id: item.identifier,\n        name: item.identifier.split(\"/\").pop() ?? `file-${index}`,\n        url: item.identifier,\n        size: item.size ?? 0,\n        contentType: \"application/octet-stream\",\n        createdAt: item.lastModified ?? new Date(),\n        metadata: item.metadata,\n      }));\n    } catch (error) {\n      throw new StorageError(\n        `List failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"LIST_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Deletes a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to delete.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns True if deletion succeeded, false otherwise\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if delete callback not provided\n   * @throws {StorageError} With code 'DELETE_ERROR' if deletion fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `delete` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const deleted = await storage.delete('https://storage.example.com/file123');\n   * if (deleted) {\n   *   console.log('File deleted successfully');\n   * }\n   * ```\n   */\n  async delete(url: string): Promise<boolean> {\n    if (!this.callbacks.delete) {\n      throw new StorageError(\n        \"Delete operation not supported - no delete callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      return await this.callbacks.delete(identifier);\n    } catch (error) {\n      throw new StorageError(\n        `Delete failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DELETE_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Returns the provider's configuration and capabilities.\n   *\n   * @returns Configuration object indicating supported features\n   *\n   * @example\n   * ```typescript\n   * const config = storage.getConfig();\n   * if (config.features.list) {\n   *   // List operation is supported\n   *   const files = await storage.list();\n   * }\n   * ```\n   */\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"callback-storage\",\n      type: \"callback\",\n      requiresAuth: false,\n      features: {\n        upload: true,\n        download: true,\n        list: !!this.callbacks.list,\n        delete: !!this.callbacks.delete,\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/callback-storage.js

@@ -17,6 +17,7 @@ class CallbackStorage {
       );
     }
   }
+  callbacks;
   /**
    * Uploads a file using the user-provided callback.
    *

package/dist/storage/providers/callback-storage.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/callback-storage.ts"],"sourcesContent":["/**\n * Provides user-defined storage operations through callback functions.\n *\n * @remarks\n * This module implements a flexible storage provider that delegates all\n * operations to user-provided callbacks. It enables custom storage\n * integrations without modifying the SDK, supporting any backend including\n * HTTP APIs, WebSocket servers, cloud storage services, or local filesystems.\n *\n * @category Storage\n * @module storage/providers/callback-storage\n */\n\nimport type { StorageCallbacks } from \"../../types/config\";\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../../types/storage\";\n\n/**\n * Delegates storage operations to user-provided callback functions.\n *\n * @remarks\n * This provider enables custom storage integrations by delegating all\n * operations to user-defined callbacks. It follows the same flexible\n * pattern as relayer callbacks, allowing implementations via HTTP,\n * WebSocket, direct cloud APIs, local filesystem, or any other backend.\n *\n * The provider validates callback results and wraps errors in consistent\n * `StorageError` types for uniform error handling across the SDK.\n *\n * @example\n * ```typescript\n * // HTTP-based implementation\n * const httpCallbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const formData = new FormData();\n *     formData.append('file', blob, filename);\n *     const response = await fetch('/api/storage/upload', {\n *       method: 'POST',\n *       body: formData\n *     });\n *     const data = await response.json();\n *     return {\n *       url: data.url,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const response = await fetch(`/api/storage/download/${identifier}`);\n *     return response.blob();\n *   }\n * };\n *\n * const storage = new CallbackStorage(httpCallbacks);\n *\n * // Direct S3 implementation\n * const s3Callbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const url = await getPresignedUploadUrl(filename);\n *     await fetch(url, { method: 'PUT', body: blob });\n *     return {\n *       url: `s3://my-bucket/${filename}`,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const url = await getPresignedDownloadUrl(identifier);\n *     const response = await fetch(url);\n *     return response.blob();\n *   }\n * };\n * ```\n *\n * @category Storage\n */\nexport class CallbackStorage implements StorageProvider {\n  /**\n   * Creates a new callback-based storage provider.\n   *\n   * @param callbacks - User-provided storage operation callbacks.\n   *   Must include at minimum `upload` and `download` functions.\n   * @throws {Error} If required callbacks are missing\n   */\n  constructor(private readonly callbacks: StorageCallbacks) {\n    if (!callbacks.upload || !callbacks.download) {\n      throw new Error(\n        \"CallbackStorage requires both upload and download callbacks\",\n      );\n    }\n  }\n\n  /**\n   * Uploads a file using the user-provided callback.\n   *\n   * @param file - The blob to upload.\n   *   Can be any Blob-compatible object including File.\n   * @param filename - Optional filename for the upload.\n   *   If not provided, callback may generate a name.\n   * @returns Upload result containing URL and metadata\n   *\n   * @throws {StorageError} With code 'INVALID_UPLOAD_RESULT' if callback returns invalid data\n   * @throws {StorageError} With code 'UPLOAD_ERROR' if upload fails\n   *\n   * @example\n   * ```typescript\n   * const file = new File(['content'], 'data.json');\n   * const result = await storage.upload(file);\n   * console.log('Uploaded to:', result.url);\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const result = await this.callbacks.upload(file, filename);\n\n      // Validate the result has required fields\n      if (!result.url || result.url.trim() === \"\") {\n        throw new StorageError(\n          \"Upload callback returned invalid result: missing or empty url\",\n          \"INVALID_UPLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Upload failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"UPLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Downloads a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to download.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns The downloaded file as a Blob\n   *\n   * @throws {StorageError} With code 'INVALID_DOWNLOAD_RESULT' if callback returns non-Blob\n   * @throws {StorageError} With code 'DOWNLOAD_ERROR' if download fails\n   *\n   * @example\n   * ```typescript\n   * const blob = await storage.download('https://storage.example.com/file123');\n   * const text = await blob.text();\n   * ```\n   */\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      const blob = await this.callbacks.download(identifier);\n\n      if (!(blob instanceof Blob)) {\n        throw new StorageError(\n          \"Download callback returned invalid result: expected Blob\",\n          \"INVALID_DOWNLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Download failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DOWNLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Lists files using the user-provided callback.\n   *\n   * @param options - Optional list options.\n   * @param options.namePattern - Pattern to filter files by name.\n   *   Implementation depends on callback.\n   * @param options.limit - Maximum number of files to return.\n   *   Implementation depends on callback.\n   * @returns Array of storage file metadata\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if list callback not provided\n   * @throws {StorageError} With code 'LIST_ERROR' if listing fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `list` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const files = await storage.list({ namePattern: '*.json' });\n   * files.forEach(file => console.log(file.name, file.size));\n   * ```\n   */\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.callbacks.list) {\n      throw new StorageError(\n        \"List operation not supported - no list callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      const result = await this.callbacks.list(options?.namePattern, options);\n\n      // Convert list result to StorageFile format\n      return result.items.map((item, index) => ({\n        id: item.identifier,\n        name: item.identifier.split(\"/\").pop() ?? `file-${index}`,\n        url: item.identifier,\n        size: item.size ?? 0,\n        contentType: \"application/octet-stream\",\n        createdAt: item.lastModified ?? new Date(),\n        metadata: item.metadata,\n      }));\n    } catch (error) {\n      throw new StorageError(\n        `List failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"LIST_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Deletes a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to delete.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns True if deletion succeeded, false otherwise\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if delete callback not provided\n   * @throws {StorageError} With code 'DELETE_ERROR' if deletion fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `delete` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const deleted = await storage.delete('https://storage.example.com/file123');\n   * if (deleted) {\n   *   console.log('File deleted successfully');\n   * }\n   * ```\n   */\n  async delete(url: string): Promise<boolean> {\n    if (!this.callbacks.delete) {\n      throw new StorageError(\n        \"Delete operation not supported - no delete callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      return await this.callbacks.delete(identifier);\n    } catch (error) {\n      throw new StorageError(\n        `Delete failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DELETE_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Returns the provider's configuration and capabilities.\n   *\n   * @returns Configuration object indicating supported features\n   *\n   * @example\n   * ```typescript\n   * const config = storage.getConfig();\n   * if (config.features.list) {\n   *   // List operation is supported\n   *   const files = await storage.list();\n   * }\n   * ```\n   */\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"callback-storage\",\n      type: \"callback\",\n      requiresAuth: false,\n      features: {\n        upload: true,\n        download: true,\n        list: !!this.callbacks.list,\n        delete: !!this.callbacks.delete,\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/callback-storage.ts"],"sourcesContent":["/**\n * Provides user-defined storage operations through callback functions.\n *\n * @remarks\n * This module implements a flexible storage provider that delegates all\n * operations to user-provided callbacks. It enables custom storage\n * integrations without modifying the SDK, supporting any backend including\n * HTTP APIs, WebSocket servers, cloud storage services, or local filesystems.\n *\n * @category Storage\n * @module storage/providers/callback-storage\n */\n\nimport type { StorageCallbacks } from \"../../types/config\";\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../../types/storage\";\n\n/**\n * Delegates storage operations to user-provided callback functions.\n *\n * @remarks\n * This provider enables custom storage integrations by delegating all\n * operations to user-defined callbacks. It follows the same flexible\n * pattern as relayer callbacks, allowing implementations via HTTP,\n * WebSocket, direct cloud APIs, local filesystem, or any other backend.\n *\n * The provider validates callback results and wraps errors in consistent\n * `StorageError` types for uniform error handling across the SDK.\n *\n * @example\n * ```typescript\n * // HTTP-based implementation\n * const httpCallbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const formData = new FormData();\n *     formData.append('file', blob, filename);\n *     const response = await fetch('/api/storage/upload', {\n *       method: 'POST',\n *       body: formData\n *     });\n *     const data = await response.json();\n *     return {\n *       url: data.url,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const response = await fetch(`/api/storage/download/${identifier}`);\n *     return response.blob();\n *   }\n * };\n *\n * const storage = new CallbackStorage(httpCallbacks);\n *\n * // Direct S3 implementation\n * const s3Callbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const url = await getPresignedUploadUrl(filename);\n *     await fetch(url, { method: 'PUT', body: blob });\n *     return {\n *       url: `s3://my-bucket/${filename}`,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const url = await getPresignedDownloadUrl(identifier);\n *     const response = await fetch(url);\n *     return response.blob();\n *   }\n * };\n * ```\n *\n * @category Storage\n */\nexport class CallbackStorage implements StorageProvider {\n  /**\n   * Creates a new callback-based storage provider.\n   *\n   * @param callbacks - User-provided storage operation callbacks.\n   *   Must include at minimum `upload` and `download` functions.\n   * @throws {Error} If required callbacks are missing\n   */\n  constructor(private readonly callbacks: StorageCallbacks) {\n    if (!callbacks.upload || !callbacks.download) {\n      throw new Error(\n        \"CallbackStorage requires both upload and download callbacks\",\n      );\n    }\n  }\n\n  /**\n   * Uploads a file using the user-provided callback.\n   *\n   * @param file - The blob to upload.\n   *   Can be any Blob-compatible object including File.\n   * @param filename - Optional filename for the upload.\n   *   If not provided, callback may generate a name.\n   * @returns Upload result containing URL and metadata\n   *\n   * @throws {StorageError} With code 'INVALID_UPLOAD_RESULT' if callback returns invalid data\n   * @throws {StorageError} With code 'UPLOAD_ERROR' if upload fails\n   *\n   * @example\n   * ```typescript\n   * const file = new File(['content'], 'data.json');\n   * const result = await storage.upload(file);\n   * console.log('Uploaded to:', result.url);\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const result = await this.callbacks.upload(file, filename);\n\n      // Validate the result has required fields\n      if (!result.url || result.url.trim() === \"\") {\n        throw new StorageError(\n          \"Upload callback returned invalid result: missing or empty url\",\n          \"INVALID_UPLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Upload failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"UPLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Downloads a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to download.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns The downloaded file as a Blob\n   *\n   * @throws {StorageError} With code 'INVALID_DOWNLOAD_RESULT' if callback returns non-Blob\n   * @throws {StorageError} With code 'DOWNLOAD_ERROR' if download fails\n   *\n   * @example\n   * ```typescript\n   * const blob = await storage.download('https://storage.example.com/file123');\n   * const text = await blob.text();\n   * ```\n   */\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      const blob = await this.callbacks.download(identifier);\n\n      if (!(blob instanceof Blob)) {\n        throw new StorageError(\n          \"Download callback returned invalid result: expected Blob\",\n          \"INVALID_DOWNLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Download failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DOWNLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Lists files using the user-provided callback.\n   *\n   * @param options - Optional list options.\n   * @param options.namePattern - Pattern to filter files by name.\n   *   Implementation depends on callback.\n   * @param options.limit - Maximum number of files to return.\n   *   Implementation depends on callback.\n   * @returns Array of storage file metadata\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if list callback not provided\n   * @throws {StorageError} With code 'LIST_ERROR' if listing fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `list` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const files = await storage.list({ namePattern: '*.json' });\n   * files.forEach(file => console.log(file.name, file.size));\n   * ```\n   */\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.callbacks.list) {\n      throw new StorageError(\n        \"List operation not supported - no list callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      const result = await this.callbacks.list(options?.namePattern, options);\n\n      // Convert list result to StorageFile format\n      return result.items.map((item, index) => ({\n        id: item.identifier,\n        name: item.identifier.split(\"/\").pop() ?? `file-${index}`,\n        url: item.identifier,\n        size: item.size ?? 0,\n        contentType: \"application/octet-stream\",\n        createdAt: item.lastModified ?? new Date(),\n        metadata: item.metadata,\n      }));\n    } catch (error) {\n      throw new StorageError(\n        `List failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"LIST_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Deletes a file using the user-provided callback.\n   *\n   * @param url - The URL or identifier to delete.\n   *   If `extractIdentifier` callback is provided, it will be used to extract the identifier.\n   * @returns True if deletion succeeded, false otherwise\n   *\n   * @throws {StorageError} With code 'NOT_SUPPORTED' if delete callback not provided\n   * @throws {StorageError} With code 'DELETE_ERROR' if deletion fails\n   *\n   * @remarks\n   * This operation is optional and only available if a `delete` callback\n   * is provided during construction.\n   *\n   * @example\n   * ```typescript\n   * const deleted = await storage.delete('https://storage.example.com/file123');\n   * if (deleted) {\n   *   console.log('File deleted successfully');\n   * }\n   * ```\n   */\n  async delete(url: string): Promise<boolean> {\n    if (!this.callbacks.delete) {\n      throw new StorageError(\n        \"Delete operation not supported - no delete callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      return await this.callbacks.delete(identifier);\n    } catch (error) {\n      throw new StorageError(\n        `Delete failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DELETE_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Returns the provider's configuration and capabilities.\n   *\n   * @returns Configuration object indicating supported features\n   *\n   * @example\n   * ```typescript\n   * const config = storage.getConfig();\n   * if (config.features.list) {\n   *   // List operation is supported\n   *   const files = await storage.list();\n   * }\n   * ```\n   */\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"callback-storage\",\n      type: \"callback\",\n      requiresAuth: false,\n      features: {\n        upload: true,\n        download: true,\n        list: !!this.callbacks.list,\n        delete: !!this.callbacks.delete,\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/dropbox.cjs

@@ -34,6 +34,7 @@ class DropboxStorage {
     }
     this.rootPath = config.rootPath ?? "/Vana Data";
   }
+  config;
   apiUrl = "https://api.dropboxapi.com/2";
   contentUrl = "https://content.dropboxapi.com/2";
   rootPath;

package/dist/storage/providers/dropbox.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/dropbox.ts"],"sourcesContent":["/**\n * Dropbox Storage Provider for Vana SDK\n *\n * Implements the storage interface for Dropbox using its API.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface DropboxConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Root path for uploads (defaults to '/Vana Data') */\n  rootPath?: string;\n}\n\ninterface DropboxUploadResponse {\n  name: string;\n  path_lower: string;\n  path_display: string;\n  id: string;\n  size: number;\n}\n\ninterface DropboxSharedLinkResponse {\n  url: string;\n}\n\ninterface DropboxListResponse {\n  entries: Array<{\n    \".tag\": \"file\" | \"folder\";\n    name: string;\n    path_lower: string;\n    id: string;\n    server_modified: string;\n    size: number;\n  }>;\n  has_more: boolean;\n  cursor: string;\n}\n\n/**\n * Dropbox Storage Provider\n *\n * @remarks\n * Implements the storage interface for Dropbox. Requires OAuth2 authentication.\n *\n * @category Storage\n */\nexport class DropboxStorage implements StorageProvider {\n  private readonly apiUrl = \"https://api.dropboxapi.com/2\";\n  private readonly contentUrl = \"https://content.dropboxapi.com/2\";\n  private readonly rootPath: string;\n\n  constructor(private config: DropboxConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Dropbox access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"dropbox\",\n      );\n    }\n    this.rootPath = config.rootPath ?? \"/Vana Data\";\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n      const path = `${this.rootPath}/${fileName}`;\n\n      const response = await fetch(`${this.contentUrl}/files/upload`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/octet-stream\",\n          \"Dropbox-API-Arg\": JSON.stringify({\n            path,\n            mode: \"add\",\n            autorename: true,\n            mute: false,\n          }),\n        },\n        body: file,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Dropbox: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxUploadResponse;\n      const sharedLinkUrl = await this.createSharedLink(result.path_lower);\n\n      // Convert the shareable URL to a direct download URL before returning.\n      // This ensures the correct, raw-content URL is stored on-chain.\n      const directDownloadUrl = sharedLinkUrl\n        .replace(\"www.dropbox.com\", \"dl.dropboxusercontent.com\")\n        .replace(\"?dl=1\", \"\");\n\n      return {\n        url: directDownloadUrl,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          path: result.path_display,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    // URL to force a direct download instead of showing the preview page.\n    // This is done by changing the hostname from 'www.dropbox.com' to 'dl.dropboxusercontent.com'.\n    const downloadUrl = url.replace(\n      \"www.dropbox.com\",\n      \"dl.dropboxusercontent.com\",\n    );\n    try {\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from Dropbox: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n      return response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.config.accessToken) {\n      throw new StorageError(\n        \"Access token not provided\",\n        \"AUTH_ERROR\",\n        \"dropbox\",\n      );\n    }\n\n    try {\n      const response = await fetch(`${this.apiUrl}/files/list_folder`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path: this.rootPath,\n          limit: options?.limit ?? 100,\n          include_deleted: false,\n        }),\n      });\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to list Dropbox files: ${await response.text()}`,\n          \"LIST_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxListResponse;\n\n      return result.entries\n        .filter((entry) => entry[\".tag\"] === \"file\")\n        .map((file) => ({\n          id: file.id,\n          name: file.name,\n          url: `dropbox://${file.path_lower}`, // Placeholder URL\n          size: file.size,\n          contentType: \"application/octet-stream\", // Dropbox API doesn't provide this in list\n          createdAt: new Date(file.server_modified),\n        }));\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      const path = new URL(url).pathname; // Assuming a direct URL format that includes the path\n      const response = await fetch(`${this.apiUrl}/files/delete_v2`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ path }),\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Dropbox: ${error}`,\n          \"DELETE_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Dropbox\",\n      type: \"dropbox\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  private async createSharedLink(path: string): Promise<string> {\n    const response = await fetch(\n      `${this.apiUrl}/sharing/create_shared_link_with_settings`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path,\n          settings: {\n            requested_visibility: \"public\",\n          },\n        }),\n      },\n    );\n\n    if (!response.ok) {\n      const errorData = await response.json();\n      // If link already exists, Dropbox returns a 409 with the existing link\n      if (\n        response.status === 409 &&\n        errorData.error?.shared_link_already_exists\n      ) {\n        return errorData.error.shared_link_already_exists.metadata.url;\n      }\n      throw new StorageError(\n        `Failed to create shared link: ${JSON.stringify(errorData)}`,\n        \"LINK_CREATION_FAILED\",\n        \"dropbox\",\n      );\n    }\n\n    const result = (await response.json()) as DropboxSharedLinkResponse;\n    // Modify URL for direct download\n    return result.url.replace(\"?dl=0\", \"?dl=1\");\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/dropbox.ts"],"sourcesContent":["/**\n * Dropbox Storage Provider for Vana SDK\n *\n * Implements the storage interface for Dropbox using its API.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface DropboxConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Root path for uploads (defaults to '/Vana Data') */\n  rootPath?: string;\n}\n\ninterface DropboxUploadResponse {\n  name: string;\n  path_lower: string;\n  path_display: string;\n  id: string;\n  size: number;\n}\n\ninterface DropboxSharedLinkResponse {\n  url: string;\n}\n\ninterface DropboxListResponse {\n  entries: Array<{\n    \".tag\": \"file\" | \"folder\";\n    name: string;\n    path_lower: string;\n    id: string;\n    server_modified: string;\n    size: number;\n  }>;\n  has_more: boolean;\n  cursor: string;\n}\n\n/**\n * Dropbox Storage Provider\n *\n * @remarks\n * Implements the storage interface for Dropbox. Requires OAuth2 authentication.\n *\n * @category Storage\n */\nexport class DropboxStorage implements StorageProvider {\n  private readonly apiUrl = \"https://api.dropboxapi.com/2\";\n  private readonly contentUrl = \"https://content.dropboxapi.com/2\";\n  private readonly rootPath: string;\n\n  constructor(private config: DropboxConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Dropbox access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"dropbox\",\n      );\n    }\n    this.rootPath = config.rootPath ?? \"/Vana Data\";\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n      const path = `${this.rootPath}/${fileName}`;\n\n      const response = await fetch(`${this.contentUrl}/files/upload`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/octet-stream\",\n          \"Dropbox-API-Arg\": JSON.stringify({\n            path,\n            mode: \"add\",\n            autorename: true,\n            mute: false,\n          }),\n        },\n        body: file,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Dropbox: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxUploadResponse;\n      const sharedLinkUrl = await this.createSharedLink(result.path_lower);\n\n      // Convert the shareable URL to a direct download URL before returning.\n      // This ensures the correct, raw-content URL is stored on-chain.\n      const directDownloadUrl = sharedLinkUrl\n        .replace(\"www.dropbox.com\", \"dl.dropboxusercontent.com\")\n        .replace(\"?dl=1\", \"\");\n\n      return {\n        url: directDownloadUrl,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          path: result.path_display,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    // URL to force a direct download instead of showing the preview page.\n    // This is done by changing the hostname from 'www.dropbox.com' to 'dl.dropboxusercontent.com'.\n    const downloadUrl = url.replace(\n      \"www.dropbox.com\",\n      \"dl.dropboxusercontent.com\",\n    );\n    try {\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from Dropbox: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n      return response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.config.accessToken) {\n      throw new StorageError(\n        \"Access token not provided\",\n        \"AUTH_ERROR\",\n        \"dropbox\",\n      );\n    }\n\n    try {\n      const response = await fetch(`${this.apiUrl}/files/list_folder`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path: this.rootPath,\n          limit: options?.limit ?? 100,\n          include_deleted: false,\n        }),\n      });\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to list Dropbox files: ${await response.text()}`,\n          \"LIST_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxListResponse;\n\n      return result.entries\n        .filter((entry) => entry[\".tag\"] === \"file\")\n        .map((file) => ({\n          id: file.id,\n          name: file.name,\n          url: `dropbox://${file.path_lower}`, // Placeholder URL\n          size: file.size,\n          contentType: \"application/octet-stream\", // Dropbox API doesn't provide this in list\n          createdAt: new Date(file.server_modified),\n        }));\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      const path = new URL(url).pathname; // Assuming a direct URL format that includes the path\n      const response = await fetch(`${this.apiUrl}/files/delete_v2`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ path }),\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Dropbox: ${error}`,\n          \"DELETE_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Dropbox\",\n      type: \"dropbox\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  private async createSharedLink(path: string): Promise<string> {\n    const response = await fetch(\n      `${this.apiUrl}/sharing/create_shared_link_with_settings`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path,\n          settings: {\n            requested_visibility: \"public\",\n          },\n        }),\n      },\n    );\n\n    if (!response.ok) {\n      const errorData = await response.json();\n      // If link already exists, Dropbox returns a 409 with the existing link\n      if (\n        response.status === 409 &&\n        errorData.error?.shared_link_already_exists\n      ) {\n        return errorData.error.shared_link_already_exists.metadata.url;\n      }\n      throw new StorageError(\n        `Failed to create shared link: ${JSON.stringify(errorData)}`,\n        \"LINK_CREATION_FAILED\",\n        \"dropbox\",\n      );\n    }\n\n    const result = (await response.json()) as DropboxSharedLinkResponse;\n    // Modify URL for direct download\n    return result.url.replace(\"?dl=0\", \"?dl=1\");\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/dropbox.js

@@ -13,6 +13,7 @@ class DropboxStorage {
     }
     this.rootPath = config.rootPath ?? "/Vana Data";
   }
+  config;
   apiUrl = "https://api.dropboxapi.com/2";
   contentUrl = "https://content.dropboxapi.com/2";
   rootPath;