@heyputer/puter.js 2.1.6 → 2.1.7

package/src/lib/APICallLogger.js

@@ -1,32 +1,31 @@
 /*
  * Copyright (C) 2024-present Puter Technologies Inc.
- * 
+ *
  * This file is part of Puter.
- * 
+ *
  * Puter is free software: you can redistribute it and/or modify
  * it under the terms of the GNU Affero General Public License as published
  * by the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
- * 
+ *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR PARTICULAR PURPOSE.  See the
  * GNU Affero General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU Affero General Public License
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-
 /**
  * APICallLogger provides centralized logging for all API calls made by the puter-js SDK.
  * It logs API calls in a simple format: service - operation - params - result
  */
 class APICallLogger {
-    constructor(config = {}) {
+    constructor (config = {}) {
         this.config = {
             enabled: config.enabled ?? false,
-            ...config
+            ...config,
         };
     }
 
@@ -34,21 +33,21 @@ class APICallLogger {
      * Updates the logger configuration
      * @param {Object} newConfig - New configuration options
      */
-    updateConfig(newConfig) {
+    updateConfig (newConfig) {
         this.config = { ...this.config, ...newConfig };
     }
 
     /**
      * Enables API call logging
      */
-    enable() {
+    enable () {
         this.config.enabled = true;
     }
 
     /**
      * Disables API call logging
      */
-    disable() {
+    disable () {
         this.config.enabled = false;
     }
 
@@ -56,7 +55,7 @@ class APICallLogger {
      * Checks if logging is enabled for the current configuration
      * @returns {boolean}
      */
-    isEnabled() {
+    isEnabled () {
         return this.config.enabled;
     }
 
@@ -64,20 +63,20 @@ class APICallLogger {
      * Logs the completion of an API request in a simple format
      * @param {Object} options - Request completion options
      */
-    logRequest(options = {}) {
-        if (!this.isEnabled()) return;
+    logRequest (options = {}) {
+        if ( ! this.isEnabled() ) return;
 
-        const { 
-            service = 'unknown', 
+        const {
+            service = 'unknown',
             operation = 'unknown',
             params = {},
             result = null,
-            error = null
+            error = null,
         } = options;
 
         // Format params as a readable string
         let paramsStr = '{}';
-        if (params && Object.keys(params).length > 0) {
+        if ( params && Object.keys(params).length > 0 ) {
             try {
                 paramsStr = JSON.stringify(params);
             } catch (e) {
@@ -87,8 +86,8 @@ class APICallLogger {
 
         // Format the log message with bold params
         const logMessage = `${service} - ${operation} - \x1b[1m${paramsStr}\x1b[22m`;
-        
-        if (error) {
+
+        if ( error ) {
             console.error(logMessage, { error: error.message || error, result });
         } else {
             console.log(logMessage, result);
@@ -99,10 +98,10 @@ class APICallLogger {
      * Gets current logging statistics
      * @returns {Object}
      */
-    getStats() {
+    getStats () {
         return {
             enabled: this.config.enabled,
-            config: { ...this.config }
+            config: { ...this.config },
         };
     }
 }

package/src/lib/EventListener.js

@@ -5,20 +5,20 @@ export default class EventListener {
     // Map of eventName -> array of listeners
     #eventListeners;
 
-    constructor(eventNames) {
+    constructor (eventNames) {
         this.#eventNames = eventNames;
 
         this.#eventListeners = (() => {
             const map = new Map();
-            for (let eventName of this.#eventNames) {
+            for ( let eventName of this.#eventNames ) {
                 map[eventName] = [];
             }
             return map;
         })();
     }
 
-    emit(eventName, data) {
-        if (!this.#eventNames.includes(eventName)) {
+    emit (eventName, data) {
+        if ( ! this.#eventNames.includes(eventName) ) {
             console.error(`Event name '${eventName}' not supported`);
             return;
         }
@@ -27,8 +27,8 @@ export default class EventListener {
         });
     }
 
-    on(eventName, callback) {
-        if (!this.#eventNames.includes(eventName)) {
+    on (eventName, callback) {
+        if ( ! this.#eventNames.includes(eventName) ) {
             console.error(`Event name '${eventName}' not supported`);
             return;
         }
@@ -36,14 +36,14 @@ export default class EventListener {
         return this;
     }
 
-    off(eventName, callback) {
-        if (!this.#eventNames.includes(eventName)) {
+    off (eventName, callback) {
+        if ( ! this.#eventNames.includes(eventName) ) {
             console.error(`Event name '${eventName}' not supported`);
             return;
         }
         const listeners = this.#eventListeners[eventName];
-        const index = listeners.indexOf(callback)
-        if (index !== -1) {
+        const index = listeners.indexOf(callback);
+        if ( index !== -1 ) {
             listeners.splice(index, 1);
         }
         return this;

package/src/lib/filesystem/APIFS.js

@@ -1,6 +1,6 @@
 import * as utils from '../utils.js';
-import putility from "@heyputer/putility";
-import { TeePromise } from "@heyputer/putility/src/libs/promise.js";
+import putility from '@heyputer/putility';
+import { TeePromise } from '@heyputer/putility/src/libs/promise.js';
 import getAbsolutePathForApp from '../../modules/FileSystem/utils/getAbsolutePathForApp.js';
 import { TFilesystem } from './definitions.js';
 
@@ -16,17 +16,13 @@ export class PuterAPIFilesystem extends putility.AdvancedBase {
                 this.ensure_auth_();
                 const tp = new TeePromise();
 
-
-                const xhr = new utils.initXhr('/stat', this.api_info.APIOrigin, undefined, "post", "text/plain;actually=json");
-                utils.setupXhrEventHandlers(xhr, undefined, undefined,
-                    tp.resolve.bind(tp),
-                    tp.reject.bind(tp),
-                );
+                const xhr = new utils.initXhr('/stat', this.api_info.APIOrigin, undefined, 'post', 'text/plain;actually=json');
+                utils.setupXhrEventHandlers(xhr, undefined, undefined, tp.resolve.bind(tp), tp.reject.bind(tp));
 
                 let dataToSend = {};
-                if (options.uid !== undefined) {
+                if ( options.uid !== undefined ) {
                     dataToSend.uid = options.uid;
-                } else if (options.path !== undefined) {
+                } else if ( options.path !== undefined ) {
                     // If dirPath is not provided or it's not starting with a slash, it means it's a relative path
                     // in that case, we need to prepend the app's root directory to it
                     dataToSend.path = getAbsolutePathForApp(options.path);
@@ -38,7 +34,6 @@ export class PuterAPIFilesystem extends putility.AdvancedBase {
                 dataToSend.return_size = options.returnSize;
                 dataToSend.auth_token = this.api_info.authToken;
 
-
                 xhr.send(JSON.stringify(dataToSend));
 
                 return await tp;
@@ -47,22 +42,19 @@ export class PuterAPIFilesystem extends putility.AdvancedBase {
                 this.ensure_auth_();
                 const tp = new TeePromise();
 
-                const xhr = new utils.initXhr('/readdir', this.api_info.APIOrigin, undefined, "post", "text/plain;actually=json");
-                utils.setupXhrEventHandlers(xhr, undefined, undefined,
-                    tp.resolve.bind(tp),
-                    tp.reject.bind(tp),
-                );
+                const xhr = new utils.initXhr('/readdir', this.api_info.APIOrigin, undefined, 'post', 'text/plain;actually=json');
+                utils.setupXhrEventHandlers(xhr, undefined, undefined, tp.resolve.bind(tp), tp.reject.bind(tp));
 
                 xhr.send(JSON.stringify({ path: getAbsolutePathForApp(options.path), auth_token: this.api_info.authToken }));
 
                 return await tp;
             },
-        }
-    }
+        },
+    };
 
     ensure_auth_ () {
         // TODO: remove reference to global 'puter'; get 'env' via context
-        if ( ! this.api_info.authToken && puter.env === 'web' ) {
+        if ( !this.api_info.authToken && puter.env === 'web' ) {
             try {
                 this.ui.authenticateWithPuter();
             } catch (e) {

package/src/lib/filesystem/CacheFS.js

@@ -1,7 +1,7 @@
-import putility from "@heyputer/putility";
-import { RWLock } from "@heyputer/putility/src/libs/promise.js";
-import { ProxyFilesystem, TFilesystem } from "./definitions.js";
-import { uuidv4 } from "../utils.js";
+import putility from '@heyputer/putility';
+import { RWLock } from '@heyputer/putility/src/libs/promise.js';
+import { ProxyFilesystem, TFilesystem } from './definitions.js';
+import { uuidv4 } from '../utils.js';
 
 export const ROOT_UUID = '00000000-0000-0000-0000-000000000000';
 const TTL = 5 * 1000;
@@ -59,7 +59,7 @@ export class CacheFS extends putility.AdvancedBase {
         if ( uuid === internal_identifier ) return;
         this.assocs_uuid_[uuid] = internal_identifier;
     }
-    
+
 }
 
 export class CachedFilesystem extends ProxyFilesystem {
@@ -82,9 +82,9 @@ export class CachedFilesystem extends ProxyFilesystem {
 
                 let values_requested = {};
                 for ( const mod of modifiers ) {
-                    const optionsKey = 'return' +
-                        mod.charAt(0).toUpperCase() +
-                        mod.slice(1);
+                    const optionsKey = `return${
+                        mod.charAt(0).toUpperCase()
+                    }${mod.slice(1)}`;
                     if ( ! o[optionsKey] ) continue;
                     values_requested[mod] = true;
                 }
@@ -97,8 +97,8 @@ export class CachedFilesystem extends ProxyFilesystem {
                         }
                     }
                     return true;
-                }
-                
+                };
+
                 let cached_stat;
                 if ( cent && cent.stat && cent.stat_exp > Date.now() ) {
                     const l = await cent.locks.stat.rlock();
@@ -123,7 +123,7 @@ export class CachedFilesystem extends ProxyFilesystem {
                 const entry = await this.delegate.stat(o);
 
                 // We might have new information to identify a relevant cache entry
-                let cent_replaced = !! cent;
+                let cent_replaced = !!cent;
                 cent = this.cacheFS.get_entry_ei([entry.uid, entry.path]);
                 if ( cent ) {
                     if ( cent_replaced ) l.unlock();
@@ -134,7 +134,7 @@ export class CachedFilesystem extends ProxyFilesystem {
                     cent = this.cacheFS.add_entry({ id: entry.uid });
                     this.cacheFS.assoc_path(entry.path, cent.id);
                     this.cacheFS.assoc_uuid(entry.uid, cent.id);
-                    
+
                     l = await cent.locks.stat.wlock();
                 }
 
@@ -160,21 +160,21 @@ export class CachedFilesystem extends ProxyFilesystem {
 
                     for ( const id of cent.members ) {
                         const member = this.cacheFS.get_entry_ei(id);
-                        if ( ! member || ! member.stat || member.stat_exp <= Date.now() ) {
+                        if ( !member || !member.stat || member.stat_exp <= Date.now() ) {
                             console.log('NO MEMBER OR STAT', member);
                             stats = null;
                             break;
                         }
                         console.log('member', member);
-                        if ( ! o.no_assocs && ! member.stat_has.subdomains ) {
+                        if ( !o.no_assocs && !member.stat_has.subdomains ) {
                             stats = null;
                             break;
                         }
-                        if ( ! o.no_assocs && ! member.stat_has.apps ) {
+                        if ( !o.no_assocs && !member.stat_has.apps ) {
                             stats = null;
                             break;
                         }
-                        if ( ! o.no_thumbs && ! member.stat_has.thumbnail ) {
+                        if ( !o.no_thumbs && !member.stat_has.thumbnail ) {
                             stats = null;
                             break;
                         }
@@ -219,14 +219,14 @@ export class CachedFilesystem extends ProxyFilesystem {
                     // });
                     entry_cent.stat = entry;
                     entry_cent.stat_has = {
-                        subdomains: ! o.no_assocs,
-                        apps: ! o.no_assocs,
-                        thumbnail: ! o.no_thumbs,
-                    }
-                    entry_cent.stat_exp = Date.now() + 1000*3;
+                        subdomains: !o.no_assocs,
+                        apps: !o.no_assocs,
+                        thumbnail: !o.no_thumbs,
+                    };
+                    entry_cent.stat_exp = Date.now() + 1000 * 3;
                 }
 
-                cent.members = []
+                cent.members = [];
                 for ( const id of cent_ids ) {
                     cent.members.push(id);
                 }
@@ -237,7 +237,7 @@ export class CachedFilesystem extends ProxyFilesystem {
                 console.log('CACHE ENTRY?', cent);
 
                 return entries;
-            }
-        }
-    }
+            },
+        },
+    };
 }

package/src/lib/filesystem/PostMessageFS.js

@@ -1,13 +1,13 @@
-import putility from "@heyputer/putility";
-import { TFilesystem } from "./definitions.js";
+import putility from '@heyputer/putility';
+import { TFilesystem } from './definitions.js';
 
 const example =     {
-        "id": "f485f1ba-de07-422c-8c4b-c2da057d4a44",
-        "uid": "f485f1ba-de07-422c-8c4b-c2da057d4a44",
-        "is_dir": true,
-        "immutable": true,
-        "name": "Test",
-    };
+    'id': 'f485f1ba-de07-422c-8c4b-c2da057d4a44',
+    'uid': 'f485f1ba-de07-422c-8c4b-c2da057d4a44',
+    'is_dir': true,
+    'immutable': true,
+    'name': 'Test',
+};
 
 export class PostMessageFilesystem extends putility.AdvancedBase {
     constructor ({ rpc, messageTarget }) {
@@ -34,7 +34,7 @@ export class PostMessageFilesystem extends putility.AdvancedBase {
                 }, '*');
 
                 return await tp;
-            }
-        }
-    }
+            },
+        },
+    };
 }

package/src/lib/filesystem/definitions.js

@@ -1,4 +1,4 @@
-import putility from "@heyputer/putility";
+import putility from '@heyputer/putility';
 
 export const TFilesystem = 'TFilesystem';
 
@@ -10,17 +10,18 @@ export const IFilesystem = {
             parameters: {
                 path: {
                     alias: 'uid',
-                }
-            }
-        }
-    }
+                },
+            },
+        },
+    },
 
 };
 
 export class ProxyFilesystem extends putility.AdvancedBase {
     static PROPERTIES = {
-        delegate: () => {}, 
-    }
+        delegate: () => {
+        },
+    };
     // TODO: constructor implied by properties
     constructor ({ delegate }) {
         super();
@@ -33,7 +34,7 @@ export class ProxyFilesystem extends putility.AdvancedBase {
             },
             readdir: async function (o) {
                 return this.delegate.readdir(o);
-            }
-        }
-    }
+            },
+        },
+    };
 }