holosphere 2.0.0-alpha10 → 2.0.0-alpha11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holosphere",
-  "version": "2.0.0-alpha10",
+  "version": "2.0.0-alpha11",
   "description": "Holonic geospatial communication infrastructure combining H3 hexagonal indexing with distributed P2P storage",
   "type": "module",
   "bin": {

package/src/index.js

@@ -276,10 +276,14 @@ class HoloSphereBase extends HoloSphereCore {
    * @throws {AuthorizationError} If capability token is invalid
    */
   async write(holonId, lensName, data, options = {}) {
-    if (!holonId || typeof holonId !== 'string') {
+    // Auto-convert to strings for convenience
+    if (holonId != null) holonId = String(holonId);
+    if (lensName != null) lensName = String(lensName);
+
+    if (!holonId) {
       throw new ValidationError('ValidationError: holonId must be a non-empty string');
     }
-    if (!lensName || typeof lensName !== 'string') {
+    if (!lensName) {
       throw new ValidationError('ValidationError: lensName must be a non-empty string');
     }
     if (!data || typeof data !== 'object') {
@@ -296,6 +300,9 @@ class HoloSphereBase extends HoloSphereCore {
 
     if (!data.id) {
       data.id = `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    } else {
+      // Auto-convert data.id to string for convenience
+      data.id = String(data.id);
     }
 
     // Add metadata
@@ -318,7 +325,7 @@ class HoloSphereBase extends HoloSphereCore {
     // OPTIMISTIC UPDATE: Store in write cache and clear from delete cache
     this._writeCache.set(path, { data: { ...data }, timestamp: Date.now() });
     this._deleteCache.delete(path);
-    this._log('INFO', '📝 CACHE WRITE', {
+    this._log('DEBUG', '📝 CACHE WRITE', {
       path,
       dataId: data.id,
       cacheSize: this._writeCache.size,
@@ -353,7 +360,7 @@ class HoloSphereBase extends HoloSphereCore {
    */
   async _syncWriteToRelay(holonId, lensName, data, path, options) {
     const startTime = Date.now();
-    this._log('INFO', '🔄 RELAY SYNC START', {
+    this._log('DEBUG', '🔄 RELAY SYNC START', {
       path,
       dataId: data.id,
       relays: this.client?.relays?.map(r => r.url) || ['local-only']
@@ -378,7 +385,7 @@ class HoloSphereBase extends HoloSphereCore {
       if (!this._metrics.totalWriteTime) this._metrics.totalWriteTime = 0;
       this._metrics.totalWriteTime += duration;
 
-      this._log('INFO', '✅ RELAY SYNC SUCCESS', {
+      this._log('DEBUG', '✅ RELAY SYNC SUCCESS', {
         path,
         dataId: data.id,
         duration: `${duration}ms`,
@@ -594,10 +601,15 @@ class HoloSphereBase extends HoloSphereCore {
    * @throws {AuthorizationError} If capability token is invalid
    */
   async read(holonId, lensName, dataId = null, options = {}) {
-    if (!holonId || typeof holonId !== 'string') {
+    // Auto-convert to strings for convenience
+    if (holonId != null) holonId = String(holonId);
+    if (lensName != null) lensName = String(lensName);
+    if (dataId != null) dataId = String(dataId);
+
+    if (!holonId) {
       throw new ValidationError('ValidationError: holonId must be a non-empty string');
     }
-    if (!lensName || typeof lensName !== 'string') {
+    if (!lensName) {
       throw new ValidationError('ValidationError: lensName must be a non-empty string');
     }
 
@@ -617,7 +629,7 @@ class HoloSphereBase extends HoloSphereCore {
 
       // Check delete cache first - if deleted, return null immediately
       if (this._deleteCache.has(path)) {
-        this._log('INFO', '🗑️ CACHE READ: Deleted item', {
+        this._log('DEBUG', '🗑️ CACHE READ: Deleted item', {
           path,
           source: 'delete-cache',
           deleteCacheSize: this._deleteCache.size
@@ -628,7 +640,7 @@ class HoloSphereBase extends HoloSphereCore {
         const cached = this._writeCache.get(path);
         if (cached) {
           const cacheAge = Date.now() - cached.timestamp;
-          this._log('INFO', '⚡ CACHE HIT: Write cache', {
+          this._log('DEBUG', '⚡ CACHE HIT: Write cache', {
             path,
             source: 'write-cache',
             cacheAge: `${cacheAge}ms`,
@@ -638,7 +650,7 @@ class HoloSphereBase extends HoloSphereCore {
         } else {
           this._log('DEBUG', '📖 CACHE MISS: Reading from storage', { path });
           result = await storage.read(this.client, path);
-          this._log('INFO', '💾 STORAGE READ', {
+          this._log('DEBUG', '💾 STORAGE READ', {
             path,
             source: 'storage',
             found: !!result,
@@ -782,7 +794,7 @@ class HoloSphereBase extends HoloSphereCore {
     // OPTIMISTIC UPDATE: Store in write cache and clear from delete cache
     this._writeCache.set(path, { data: { ...mergedData }, timestamp: Date.now() });
     this._deleteCache.delete(path);
-    this._log('INFO', '✏️ CACHE UPDATE', {
+    this._log('DEBUG', '✏️ CACHE UPDATE', {
       path,
       dataId,
       updatedFields: Object.keys(updates),
@@ -808,7 +820,7 @@ class HoloSphereBase extends HoloSphereCore {
    */
   async _syncUpdateToRelay(holonId, lensName, dataId, mergedData, existingData, path) {
     const startTime = Date.now();
-    this._log('INFO', '🔄 UPDATE SYNC START', {
+    this._log('DEBUG', '🔄 UPDATE SYNC START', {
       path,
       dataId,
       relays: this.client?.relays?.map(r => r.url) || ['local-only']
@@ -822,7 +834,7 @@ class HoloSphereBase extends HoloSphereCore {
       if (!this._metrics.totalWriteTime) this._metrics.totalWriteTime = 0;
       this._metrics.totalWriteTime += duration;
 
-      this._log('INFO', '✅ UPDATE SYNC SUCCESS', {
+      this._log('DEBUG', '✅ UPDATE SYNC SUCCESS', {
         path,
         dataId,
         duration: `${duration}ms`,
@@ -865,13 +877,18 @@ class HoloSphereBase extends HoloSphereCore {
    * @throws {AuthorizationError} If not owner and no valid capability token
    */
   async delete(holonId, lensName, dataId, options = {}) {
-    if (!holonId || typeof holonId !== 'string') {
+    // Auto-convert to strings for convenience
+    if (holonId != null) holonId = String(holonId);
+    if (lensName != null) lensName = String(lensName);
+    if (dataId != null) dataId = String(dataId);
+
+    if (!holonId) {
       throw new ValidationError('ValidationError: holonId must be a non-empty string');
     }
-    if (!lensName || typeof lensName !== 'string') {
+    if (!lensName) {
       throw new ValidationError('ValidationError: lensName must be a non-empty string');
     }
-    if (!dataId || typeof dataId !== 'string') {
+    if (!dataId) {
       throw new ValidationError('ValidationError: dataId must be a non-empty string');
     }
 
@@ -920,7 +937,7 @@ class HoloSphereBase extends HoloSphereCore {
     // OPTIMISTIC DELETE: Remove from write cache and add to delete cache
     this._writeCache.delete(path);
     this._deleteCache.add(path);
-    this._log('INFO', '🗑️ CACHE DELETE', {
+    this._log('DEBUG', '🗑️ CACHE DELETE', {
       path,
       dataId,
       deleteCacheSize: this._deleteCache.size,
@@ -935,14 +952,14 @@ class HoloSphereBase extends HoloSphereCore {
 
     // Delete from storage (background unless blocking)
     const startTime = Date.now();
-    this._log('INFO', '🔄 DELETE SYNC START', { path, dataId });
+    this._log('DEBUG', '🔄 DELETE SYNC START', { path, dataId });
 
     const deletePromise = storage.deleteData(this.client, path).then(() => {
       const duration = Date.now() - startTime;
       this._metrics.deletes++;
       // Clear from delete cache after successful sync
       this._deleteCache.delete(path);
-      this._log('INFO', '✅ DELETE SYNC SUCCESS', {
+      this._log('DEBUG', '✅ DELETE SYNC SUCCESS', {
         path,
         dataId,
         duration: `${duration}ms`,
@@ -983,6 +1000,10 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<boolean>} True if write succeeded
    */
   async writeGlobal(table, data) {
+    // Auto-convert to strings for convenience
+    if (table != null) table = String(table);
+    if (data?.id != null) data.id = String(data.id);
+
     return globalTables.writeGlobal(this.client, this.config.appName, table, data);
   }
 
@@ -994,6 +1015,10 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<Object|Array|null>} Data object, array of objects, or null
    */
   async readGlobal(table, key = null) {
+    // Auto-convert to strings for convenience
+    if (table != null) table = String(table);
+    if (key != null) key = String(key);
+
     return globalTables.readGlobal(this.client, this.config.appName, table, key);
   }
 
@@ -1006,6 +1031,10 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<boolean>} True if update succeeded
    */
   async updateGlobal(table, key, updates) {
+    // Auto-convert to strings for convenience
+    if (table != null) table = String(table);
+    if (key != null) key = String(key);
+
     return globalTables.updateGlobal(this.client, this.config.appName, table, key, updates);
   }
 
@@ -1017,6 +1046,10 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<boolean>} True if deletion succeeded
    */
   async deleteGlobal(table, key) {
+    // Auto-convert to strings for convenience
+    if (table != null) table = String(table);
+    if (key != null) key = String(key);
+
     return globalTables.deleteGlobal(this.client, this.config.appName, table, key);
   }
 
@@ -1027,6 +1060,9 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<Array>} Array of all data objects in the table
    */
   async getAllGlobal(table) {
+    // Auto-convert to strings for convenience
+    if (table != null) table = String(table);
+
     return globalTables.getAllGlobal(this.client, this.config.appName, table);
   }
 
@@ -1037,6 +1073,9 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<boolean>} True if deletion succeeded
    */
   async deleteAllGlobal(table) {
+    // Auto-convert to strings for convenience
+    if (table != null) table = String(table);
+
     return globalTables.deleteAllGlobal(this.client, this.config.appName, table);
   }
 
@@ -1061,6 +1100,10 @@ class HoloSphereBase extends HoloSphereCore {
    * @returns {Promise<boolean>} True if deletion succeeded
    */
   async deleteAll(holonId, lensName) {
+    // Auto-convert to strings for convenience
+    if (holonId != null) holonId = String(holonId);
+    if (lensName != null) lensName = String(lensName);
+
     const path = storage.buildPath(this.config.appName, holonId, lensName);
     return storage.deleteAll(this.client, path);
   }