@heyputer/puter.js 1.0.1 → 2.0.1

package/src/modules/FileSystem/operations/readdir.js

@@ -1,102 +0,0 @@
-import * as utils from '../../../lib/utils.js';
-import getAbsolutePathForApp from '../utils/getAbsolutePathForApp.js';
-
-const readdir = async function (...args) {
-    let options;
-
-    // If first argument is an object, it's the options
-    if (typeof args[0] === 'object' && args[0] !== null) {
-        options = args[0];
-    } else {
-        // Otherwise, we assume separate arguments are provided
-        options = {
-            path: args[0],
-            success: args[1],
-            error: args[2],
-        };
-    }
-
-    return new Promise(async (resolve, reject) => {
-        // consistency levels
-        if(!options.consistency){
-            options.consistency = 'strong';
-        }
-
-        // Either path or uid is required
-        if(!options.path && !options.uid){
-            throw new Error({ code: 'NO_PATH_OR_UID', message: 'Either path or uid must be provided.' });
-        }
-
-        // Generate cache key based on path or uid
-        let cacheKey;
-        if(options.path){
-            cacheKey = 'readdir:' + options.path;
-        }else if(options.uid){
-            cacheKey = 'readdir:' + options.uid;
-        }
-
-        if(options.consistency === 'eventual'){
-            // Check cache
-            const cachedResult = await puter._cache.get(cacheKey);
-            if(cachedResult){
-                resolve(cachedResult);
-                return;
-            }
-        }
-
-        // If auth token is not provided and we are in the web environment, 
-        // try to authenticate with Puter
-        if(!puter.authToken && puter.env === 'web'){
-            try{
-                await puter.ui.authenticateWithPuter();
-            }catch(e){
-                // if authentication fails, throw an error
-                reject('Authentication failed.');
-            }
-        }
-
-        // create xhr object
-        const xhr = utils.initXhr('/readdir', this.APIOrigin, undefined, "post", "text/plain;actually=json");
-
-        // set up event handlers for load and error events
-        utils.setupXhrEventHandlers(xhr, options.success, options.error, async (result) => {
-            // Calculate the size of the result for cache eligibility check
-            const resultSize = JSON.stringify(result).length;
-            
-            // Cache the result if it's not bigger than MAX_CACHE_SIZE
-            const MAX_CACHE_SIZE = 20 * 1024 * 1024;
-            const EXPIRE_TIME = 60 * 60; // 1 hour
-
-            if(resultSize <= MAX_CACHE_SIZE){
-                // UPSERT the cache
-                await puter._cache.set(cacheKey, result, { EX: EXPIRE_TIME });
-            }
-
-            // set each individual item's cache
-            for(const item of result){
-                await puter._cache.set('item:' + item.id, item, { EX: EXPIRE_TIME });
-                await puter._cache.set('item:' + item.path, item, { EX: EXPIRE_TIME });
-            }
-            
-            resolve(result);
-        }, reject);
-
-        // Build request payload - support both path and uid parameters
-        const payload = {
-            no_thumbs: options.no_thumbs,
-            no_assocs: options.no_assocs,
-            auth_token: this.authToken
-        };
-
-        // Add either uid or path to the payload
-        if (options.uid) {
-            payload.uid = options.uid;
-        } else if (options.path) {
-            payload.path = getAbsolutePathForApp(options.path);
-        }
-
-        xhr.send(JSON.stringify(payload));
-    })
-}
-
-export default readdir;

package/src/modules/FileSystem/operations/rename.js

@@ -1,58 +0,0 @@
-import * as utils from '../../../lib/utils.js';
-import getAbsolutePathForApp from '../utils/getAbsolutePathForApp.js';
-
-const rename = function (...args) {
-    let options;
-
-    // If first argument is an object, it's the options
-    if (typeof args[0] === 'object' && args[0] !== null) {
-        options = args[0];
-    } else {
-        // Otherwise, we assume separate arguments are provided
-        options = {
-            path: args[0],
-            new_name: args[1],
-            success: args[2],
-            error: args[3],
-            // Add more if needed...
-        };
-    }
-
-    return new Promise(async (resolve, reject) => {
-        // If auth token is not provided and we are in the web environment, 
-        // try to authenticate with Puter
-        if(!puter.authToken && puter.env === 'web'){
-            try{
-                await puter.ui.authenticateWithPuter();
-            }catch(e){
-                // if authentication fails, throw an error
-                reject('Authentication failed.');
-            }
-        }
-
-        // create xhr object
-        const xhr = utils.initXhr('/rename', this.APIOrigin, this.authToken);
-
-        // set up event handlers for load and error events
-        utils.setupXhrEventHandlers(xhr, options.success, options.error, resolve, reject);
-
-        let dataToSend = {
-            original_client_socket_id: options.excludeSocketID || options.original_client_socket_id,
-            new_name: options.new_name || options.newName,
-        };
-        
-        if (options.uid !== undefined) {
-            dataToSend.uid = options.uid;
-        } 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);
-        }
-        
-        xhr.send(JSON.stringify(dataToSend));
-        // todo: EXTREMELY NAIVE CACHE PURGE
-        puter._cache.flushall();
-    })
-}
-
-export default rename;

package/src/modules/FileSystem/operations/sign.js

@@ -1,103 +0,0 @@
-
-import * as utils from '../../../lib/utils.js';
-
-/**
- * Signs a file system entry or entries and optionally calls a provided callback with the result.
- * If a single item is passed, it is converted into an array.
- * Sends a POST request to the server to sign the items.
- *
- * @param {(Object|Object[])} items - The file system entry or entries to be signed. Can be a single object or an array of objects.
- * @param {function} [callback] - Optional callback function to be invoked with the result of the signing.
- * @returns {(Object|Object[])} If a single item was passed, returns a single object. If multiple items were passed, returns an array of objects.
- * @throws {Error} If the AJAX request fails.
- * @async
- */
-const sign = function(...args){
-    let options;
-
-    // Otherwise, we assume separate arguments are provided
-    options = {
-        app_uid: args[0],
-        items: args[1],
-        success: args[2],
-        error: args[3],
-        // Add more if needed...
-    };
-
-    return new Promise(async (resolve, reject) => {
-        // If auth token is not provided and we are in the web environment, 
-        // try to authenticate with Puter
-        if(!puter.authToken && puter.env === 'web'){
-            try{
-                await puter.ui.authenticateWithPuter();
-            }catch(e){
-                // if authentication fails, throw an error
-                reject('Authentication failed.');
-            }
-        }
-
-
-        let items = options.items;
-
-        // if only a single item is passed, convert it to array
-        // so that the code below can work with arrays
-        if(!Array.isArray(items)){
-            items = [items]
-        }
-
-        // create xhr object
-        const xhr = utils.initXhr('/sign', this.APIOrigin, this.authToken);
-
-        // response
-        xhr.addEventListener('load', async function(e){
-            const resp = await utils.parseResponse(this);
-            // error
-            if(this.status !== 200){
-                // if error callback is provided, call it
-                if(options.error && typeof options.error === 'function')
-                    options.error(resp)
-                // reject promise
-                return reject(resp)
-            }
-            // success
-            else{
-                let res = resp;
-                let result;
-                let token = res.token;
-                // if only a single item was passed, return a single object
-                if(items.length == 1){
-                    result = {...(res.signatures[0])};
-                }
-                // if multiple items were passed, return an array of objects
-                else{
-                    let obj=[];
-                    for(let i=0; i<res.signatures.length; i++){
-                        obj.push({...res.signatures[i]});
-                    }
-                    result = obj;
-                }
-
-                // if success callback is provided, call it
-                if(options.success && typeof options.success === 'function')
-                    options.success({token: token, items: result});
-                // resolve with success
-                return resolve({token: token, items: result});
-            }
-        });
-
-        xhr.upload.addEventListener('progress', function(e){
-        })
-
-        // error
-        xhr.addEventListener('error', function(e){
-            return utils.handle_error(options.error, reject, this);
-        })
-
-        xhr.send(JSON.stringify({
-            app_uid: options.app_uid,
-            items: items
-        }));
-    })
-}
-
-export default sign;

package/src/modules/FileSystem/operations/space.js

@@ -1,40 +0,0 @@
-import * as utils from '../../../lib/utils.js';
-
-const space = function (...args) {
-    let options;
-
-    // If first argument is an object, it's the options
-    if (typeof args[0] === 'object' && args[0] !== null) {
-        options = args[0];
-    } else {
-        // Otherwise, we assume separate arguments are provided
-        options = {
-            success: args[0],
-            error: args[1],
-            // Add more if needed...
-        };
-    }
-
-    return new Promise(async (resolve, reject) => {
-        // If auth token is not provided and we are in the web environment, 
-        // try to authenticate with Puter
-        if(!puter.authToken && puter.env === 'web'){
-            try{
-                await puter.ui.authenticateWithPuter();
-            }catch(e){
-                // if authentication fails, throw an error
-                reject('Authentication failed.');
-            }
-        }
-
-        // create xhr object
-        const xhr = utils.initXhr('/df', this.APIOrigin, this.authToken);
-
-        // set up event handlers for load and error events
-        utils.setupXhrEventHandlers(xhr, options.success, options.error, resolve, reject);
-
-        xhr.send();
-    })
-}
-
-export default space;

package/src/modules/FileSystem/operations/stat.js

@@ -1,95 +0,0 @@
-import * as utils from '../../../lib/utils.js';
-import getAbsolutePathForApp from '../utils/getAbsolutePathForApp.js';
-
-const stat = async function (...args) {
-    let options;
-
-    // If first argument is an object, it's the options
-    if (typeof args[0] === 'object' && args[0] !== null) {
-        options = args[0];
-    } else {
-        // Otherwise, we assume separate arguments are provided
-        options = {
-            path: args[0],
-            options: typeof args[1] === 'object' ? args[1] : {},
-            success: typeof args[1] === 'object' ? args[2] : args[1],
-            error: typeof args[1] === 'object' ? args[3] : args[2],
-            // Add more if needed...
-        };
-    }
-
-    return new Promise(async (resolve, reject) => {
-        // consistency levels
-        if(!options.consistency){
-            options.consistency = 'strong';
-        }
-
-        // If auth token is not provided and we are in the web environment, 
-        // try to authenticate with Puter
-        if(!puter.authToken && puter.env === 'web'){
-            try{
-                await puter.ui.authenticateWithPuter();
-            }catch(e){
-                // if authentication fails, throw an error
-                reject('Authentication failed.');
-            }
-        }
-
-        // Generate cache key based on path or uid
-        let cacheKey;
-        if(options.path){
-            cacheKey = 'item:' + options.path;
-        }else if(options.uid){
-            cacheKey = 'item:' + options.uid;
-        }
-
-        if(options.consistency === 'eventual' && !options.returnSubdomains && !options.returnPermissions && !options.returnVersions && !options.returnSize){
-            // Check cache
-            const cachedResult = await puter._cache.get(cacheKey);
-            if(cachedResult){
-                resolve(cachedResult);
-                return;
-            }
-        }
-
-        // create xhr object
-        const xhr = utils.initXhr('/stat', this.APIOrigin, undefined, "post", "text/plain;actually=json");
-
-        // set up event handlers for load and error events
-        utils.setupXhrEventHandlers(xhr, options.success, options.error, async (result) => {
-            // Calculate the size of the result for cache eligibility check
-            const resultSize = JSON.stringify(result).length;
-            
-            // Cache the result if it's not bigger than MAX_CACHE_SIZE
-            const MAX_CACHE_SIZE = 20 * 1024 * 1024;
-            const EXPIRE_TIME = 60 * 60; // 1 hour
-
-            if(resultSize <= MAX_CACHE_SIZE){
-                // UPSERT the cache
-                await puter._cache.set('item:' + result.path, result, { EX: EXPIRE_TIME });
-                await puter._cache.set('item:' + result.uid, result, { EX: EXPIRE_TIME });
-            }
-            
-            resolve(result);
-        }, reject);
-
-        let dataToSend = {};
-        if (options.uid !== undefined) {
-            dataToSend.uid = options.uid;
-        } 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);
-        }
-        
-        dataToSend.return_subdomains = options.returnSubdomains;
-        dataToSend.return_permissions = options.returnPermissions;
-        dataToSend.return_versions = options.returnVersions;
-        dataToSend.return_size = options.returnSize;
-        dataToSend.auth_token = this.authToken;
-
-        xhr.send(JSON.stringify(dataToSend));
-    })
-}
-
-export default stat;

package/src/modules/FileSystem/operations/symlink.js

@@ -1,55 +0,0 @@
-import getAbsolutePathForApp from '../utils/getAbsolutePathForApp.js';
-import pathLib from '../../../lib/path.js';
-
-// This only works for absolute symlinks for now
-const symlink = async function (target, linkPath) {
-
-
-    // If auth token is not provided and we are in the web environment, 
-    // try to authenticate with Puter
-    if(!puter.authToken && puter.env === 'web'){
-        try{
-            await puter.ui.authenticateWithPuter();
-        }catch(e){
-            // if authentication fails, throw an error
-            throw 'Authentication failed.';
-        }
-    }
-
-    // convert path to absolute path
-    linkPath = getAbsolutePathForApp(linkPath);
-    target = getAbsolutePathForApp(target);
-    const name = pathLib.basename(linkPath);
-    const linkDir = pathLib.dirname(linkPath)
-
-    const op =
-        {
-          op: 'symlink',
-          path: linkDir,
-          name: name,
-          target: target
-        };
-
-    const formData = new FormData();
-    formData.append('operation', JSON.stringify(op));
-
-    try {
-        const response = await fetch(this.APIOrigin + "/batch", {
-            method: 'POST',
-            headers: { 'Authorization': `Bearer ${puter.authToken}` },
-            body: formData
-        });
-        if (response.status !== 200) {
-            const error = await response.text();
-            console.error("[symlink] fetch error: ", error);
-            throw error;
-        }
-    } catch (e) {
-        console.error("[symlink] fetch error: ", e);
-        throw e;
-    }
-    
-
-}
-
-export default symlink;