@soulcraft/brainy 3.28.0 → 3.29.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [3.29.0](https://github.com/soulcraftlabs/brainy/compare/v3.28.0...v3.29.0) (2025-10-09)
+
+
+### 🐛 Bug Fixes
+
+* enable GCS native storage with Application Default Credentials ([1e77ecd](https://github.com/soulcraftlabs/brainy/commit/1e77ecd145d3dea46e04ca5ecc6692b41e569c1e))
+
 ### [3.28.0](https://github.com/soulcraftlabs/brainy/compare/v3.27.1...v3.28.0) (2025-10-08)
 
 - feat: add unified import system with auto-detection and dual storage (a06e877)

package/dist/brainy.js

@@ -2274,8 +2274,24 @@ export class Brainy {
      */
     normalizeConfig(config) {
         // Validate storage configuration
-        if (config?.storage?.type && !['auto', 'memory', 'filesystem', 'opfs', 'remote', 's3', 'r2', 'gcs'].includes(config.storage.type)) {
-            throw new Error(`Invalid storage type: ${config.storage.type}. Must be one of: auto, memory, filesystem, opfs, remote, s3, r2, gcs`);
+        if (config?.storage?.type && !['auto', 'memory', 'filesystem', 'opfs', 'remote', 's3', 'r2', 'gcs', 'gcs-native'].includes(config.storage.type)) {
+            throw new Error(`Invalid storage type: ${config.storage.type}. Must be one of: auto, memory, filesystem, opfs, remote, s3, r2, gcs, gcs-native`);
+        }
+        // Validate storage type/config pairing (catch common mismatches)
+        if (config?.storage) {
+            const storage = config.storage;
+            // Check for gcs/gcsNativeStorage mismatch
+            if (storage.type === 'gcs' && storage.gcsNativeStorage) {
+                throw new Error(`Storage type/config mismatch: type 'gcs' requires 'gcsStorage' config object (S3-compatible). ` +
+                    `You provided 'gcsNativeStorage' which requires type 'gcs-native'. ` +
+                    `Either change type to 'gcs-native' or use 'gcsStorage' instead of 'gcsNativeStorage'.`);
+            }
+            // Check for gcs-native/gcsStorage mismatch
+            if (storage.type === 'gcs-native' && storage.gcsStorage) {
+                throw new Error(`Storage type/config mismatch: type 'gcs-native' requires 'gcsNativeStorage' config object. ` +
+                    `You provided 'gcsStorage' which requires type 'gcs' (S3-compatible). ` +
+                    `Either change type to 'gcs' or use 'gcsNativeStorage' instead of 'gcsStorage'.`);
+            }
         }
         // Validate model configuration
         if (config?.model?.type && !['fast', 'accurate', 'custom'].includes(config.model.type)) {

package/dist/config/storageAutoConfig.d.ts

@@ -11,6 +11,7 @@ export declare enum StorageType {
     OPFS = "opfs",
     S3 = "s3",
     GCS = "gcs",
+    GCS_NATIVE = "gcs-native",
     R2 = "r2"
 }
 /**
@@ -22,7 +23,7 @@ export declare enum StoragePreset {
     DISK = "disk",
     CLOUD = "cloud"
 }
-export type StorageTypeString = 'memory' | 'filesystem' | 'opfs' | 's3' | 'gcs' | 'r2';
+export type StorageTypeString = 'memory' | 'filesystem' | 'opfs' | 's3' | 'gcs' | 'r2' | 'gcs-native';
 export type StoragePresetString = 'auto' | 'memory' | 'disk' | 'cloud';
 export interface StorageConfigResult {
     type: StorageType | StorageTypeString;

package/dist/config/storageAutoConfig.js

@@ -13,6 +13,7 @@ export var StorageType;
     StorageType["OPFS"] = "opfs";
     StorageType["S3"] = "s3";
     StorageType["GCS"] = "gcs";
+    StorageType["GCS_NATIVE"] = "gcs-native";
     StorageType["R2"] = "r2";
 })(StorageType || (StorageType = {}));
 /**
@@ -170,14 +171,14 @@ async function detectCloudStorage() {
             }
         };
     }
-    // Google Cloud Storage Detection
+    // Google Cloud Storage Detection (Native SDK with ADC)
     if (hasGCPConfig()) {
         return {
-            type: StorageType.GCS,
+            type: StorageType.GCS_NATIVE,
             config: {
-                gcsStorage: {
+                gcsNativeStorage: {
                     bucketName: process.env.GCS_BUCKET || process.env.GOOGLE_STORAGE_BUCKET || 'brainy-data',
-                    // Credentials will be picked up by GCP SDK automatically
+                    // Application Default Credentials will be picked up automatically
                 }
             }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.28.0",
+  "version": "3.29.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",