@soulcraft/brainy 3.43.2 → 3.43.3

package/dist/storage/storageFactory.d.ts

@@ -40,6 +40,15 @@ export interface StorageOptions {
      * Root directory for file system storage (Node.js only)
      */
     rootDirectory?: string;
+    /**
+     * Nested options object for backward compatibility with BrainyConfig.storage.options
+     * Supports flexible API patterns
+     */
+    options?: {
+        rootDirectory?: string;
+        path?: string;
+        [key: string]: any;
+    };
     /**
      * Configuration for Amazon S3 storage
      */

package/dist/storage/storageFactory.js

@@ -8,6 +8,19 @@ import { S3CompatibleStorage, R2Storage } from './adapters/s3CompatibleStorage.j
 import { GcsStorage } from './adapters/gcsStorage.js';
 // FileSystemStorage is dynamically imported to avoid issues in browser environments
 import { isBrowser } from '../utils/environment.js';
+/**
+ * Extract filesystem root directory from options
+ * Single source of truth for path resolution - supports all API variants
+ * Zero-config philosophy: flexible input, predictable output
+ */
+function getFileSystemPath(options) {
+    return (options.rootDirectory || // Official storageFactory API
+        options.path || // User-friendly API
+        options.options?.rootDirectory || // Nested options API
+        options.options?.path || // Nested path API
+        './brainy-data' // Zero-config fallback
+    );
+}
 /**
  * Create a storage adapter based on the environment and configuration
  * @param options Options for creating the storage adapter
@@ -28,7 +41,7 @@ export async function createStorage(options = {}) {
         console.log('Using file system storage (forced)');
         try {
             const { FileSystemStorage } = await import('./adapters/fileSystemStorage.js');
-            return new FileSystemStorage(options.rootDirectory || './brainy-data');
+            return new FileSystemStorage(getFileSystemPath(options));
         }
         catch (error) {
             console.warn('Failed to load FileSystemStorage, falling back to memory storage:', error);
@@ -67,7 +80,7 @@ export async function createStorage(options = {}) {
                 console.log('Using file system storage');
                 try {
                     const { FileSystemStorage } = await import('./adapters/fileSystemStorage.js');
-                    return new FileSystemStorage(options.rootDirectory || './brainy-data');
+                    return new FileSystemStorage(getFileSystemPath(options));
                 }
                 catch (error) {
                     console.warn('Failed to load FileSystemStorage, falling back to memory storage:', error);
@@ -220,7 +233,7 @@ export async function createStorage(options = {}) {
                 console.log('Using file system storage (auto-detected)');
                 try {
                     const { FileSystemStorage } = await import('./adapters/fileSystemStorage.js');
-                    return new FileSystemStorage(options.rootDirectory || './brainy-data');
+                    return new FileSystemStorage(getFileSystemPath(options));
                 }
                 catch (fsError) {
                     console.warn('Failed to load FileSystemStorage, falling back to memory storage:', fsError);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.43.2",
+  "version": "3.43.3",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",