@soulcraft/brainy 3.26.0 → 3.27.0

package/dist/storage/storageFactory.d.ts

@@ -6,6 +6,7 @@ import { StorageAdapter } from '../coreTypes.js';
 import { MemoryStorage } from './adapters/memoryStorage.js';
 import { OPFSStorage } from './adapters/opfsStorage.js';
 import { S3CompatibleStorage, R2Storage } from './adapters/s3CompatibleStorage.js';
+import { GcsStorage } from './adapters/gcsStorage.js';
 import { OperationConfig } from '../utils/operationUtils.js';
 /**
  * Options for creating a storage adapter
@@ -19,9 +20,10 @@ export interface StorageOptions {
      * - 'filesystem': Use file system storage (Node.js only)
      * - 's3': Use Amazon S3 storage
      * - 'r2': Use Cloudflare R2 storage
-     * - 'gcs': Use Google Cloud Storage
+     * - 'gcs': Use Google Cloud Storage (S3-compatible with HMAC keys)
+     * - 'gcs-native': Use Google Cloud Storage (native SDK with ADC)
      */
-    type?: 'auto' | 'memory' | 'opfs' | 'filesystem' | 's3' | 'r2' | 'gcs';
+    type?: 'auto' | 'memory' | 'opfs' | 'filesystem' | 's3' | 'r2' | 'gcs' | 'gcs-native';
     /**
      * Force the use of memory storage even if other storage types are available
      */
@@ -85,7 +87,7 @@ export interface StorageOptions {
         secretAccessKey: string;
     };
     /**
-     * Configuration for Google Cloud Storage
+     * Configuration for Google Cloud Storage (S3-compatible with HMAC keys)
      */
     gcsStorage?: {
         /**
@@ -109,6 +111,31 @@ export interface StorageOptions {
          */
         endpoint?: string;
     };
+    /**
+     * Configuration for Google Cloud Storage (native SDK with ADC)
+     */
+    gcsNativeStorage?: {
+        /**
+         * GCS bucket name
+         */
+        bucketName: string;
+        /**
+         * Service account key file path (optional, uses ADC if not provided)
+         */
+        keyFilename?: string;
+        /**
+         * Service account credentials object (optional, uses ADC if not provided)
+         */
+        credentials?: object;
+        /**
+         * HMAC access key ID (backward compatibility, not recommended)
+         */
+        accessKeyId?: string;
+        /**
+         * HMAC secret access key (backward compatibility, not recommended)
+         */
+        secretAccessKey?: string;
+    };
     /**
      * Configuration for custom S3-compatible storage
      */
@@ -196,4 +223,4 @@ export declare function createStorage(options?: StorageOptions): Promise<Storage
 /**
  * Export storage adapters
  */
-export { MemoryStorage, OPFSStorage, S3CompatibleStorage, R2Storage };
+export { MemoryStorage, OPFSStorage, S3CompatibleStorage, R2Storage, GcsStorage };

package/dist/storage/storageFactory.js

@@ -5,6 +5,7 @@
 import { MemoryStorage } from './adapters/memoryStorage.js';
 import { OPFSStorage } from './adapters/opfsStorage.js';
 import { S3CompatibleStorage, R2Storage } from './adapters/s3CompatibleStorage.js';
+import { GcsStorage } from './adapters/gcsStorage.js';
 // FileSystemStorage is dynamically imported to avoid issues in browser environments
 import { isBrowser } from '../utils/environment.js';
 /**
@@ -109,7 +110,7 @@ export async function createStorage(options = {}) {
                 }
             case 'gcs':
                 if (options.gcsStorage) {
-                    console.log('Using Google Cloud Storage');
+                    console.log('Using Google Cloud Storage (S3-compatible)');
                     return new S3CompatibleStorage({
                         bucketName: options.gcsStorage.bucketName,
                         region: options.gcsStorage.region,
@@ -124,6 +125,22 @@ export async function createStorage(options = {}) {
                     console.warn('GCS storage configuration is missing, falling back to memory storage');
                     return new MemoryStorage();
                 }
+            case 'gcs-native':
+                if (options.gcsNativeStorage) {
+                    console.log('Using Google Cloud Storage (native SDK)');
+                    return new GcsStorage({
+                        bucketName: options.gcsNativeStorage.bucketName,
+                        keyFilename: options.gcsNativeStorage.keyFilename,
+                        credentials: options.gcsNativeStorage.credentials,
+                        accessKeyId: options.gcsNativeStorage.accessKeyId,
+                        secretAccessKey: options.gcsNativeStorage.secretAccessKey,
+                        cacheConfig: options.cacheConfig
+                    });
+                }
+                else {
+                    console.warn('GCS native storage configuration is missing, falling back to memory storage');
+                    return new MemoryStorage();
+                }
             default:
                 console.warn(`Unknown storage type: ${options.type}, falling back to memory storage`);
                 return new MemoryStorage();
@@ -167,9 +184,21 @@ export async function createStorage(options = {}) {
             cacheConfig: options.cacheConfig
         });
     }
-    // If GCS storage is specified, use it
+    // If GCS native storage is specified, use it (prioritize native over S3-compatible)
+    if (options.gcsNativeStorage) {
+        console.log('Using Google Cloud Storage (native SDK)');
+        return new GcsStorage({
+            bucketName: options.gcsNativeStorage.bucketName,
+            keyFilename: options.gcsNativeStorage.keyFilename,
+            credentials: options.gcsNativeStorage.credentials,
+            accessKeyId: options.gcsNativeStorage.accessKeyId,
+            secretAccessKey: options.gcsNativeStorage.secretAccessKey,
+            cacheConfig: options.cacheConfig
+        });
+    }
+    // If GCS storage is specified, use it (S3-compatible)
     if (options.gcsStorage) {
-        console.log('Using Google Cloud Storage');
+        console.log('Using Google Cloud Storage (S3-compatible)');
         return new S3CompatibleStorage({
             bucketName: options.gcsStorage.bucketName,
             region: options.gcsStorage.region,
@@ -224,7 +253,7 @@ export async function createStorage(options = {}) {
 /**
  * Export storage adapters
  */
-export { MemoryStorage, OPFSStorage, S3CompatibleStorage, R2Storage };
+export { MemoryStorage, OPFSStorage, S3CompatibleStorage, R2Storage, GcsStorage };
 // Export FileSystemStorage conditionally
 // NOTE: FileSystemStorage is now only imported dynamically to avoid fs imports in browser builds
 // export { FileSystemStorage } from './adapters/fileSystemStorage.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.26.0",
+  "version": "3.27.0",
   "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",
@@ -157,6 +157,7 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.540.0",
+    "@google-cloud/storage": "^7.14.0",
     "@huggingface/transformers": "^3.7.2",
     "boxen": "^8.0.1",
     "chalk": "^5.3.0",