@heyputer/puter.js 2.1.15 → 2.2.4

package/src/modules/AI.js

@@ -11,33 +11,6 @@ const normalizeTTSProvider = (value) => {
     return value;
 };
 
-const TOGETHER_IMAGE_MODEL_PREFIXES = [
-    'black-forest-labs/',
-    'stabilityai/',
-    'togethercomputer/',
-    'playgroundai/',
-    'runwayml/',
-    'lightricks/',
-    'sg161222/',
-    'wavymulder/',
-    'prompthero/',
-    'bytedance-seed/',
-    'hidream-ai/',
-    'lykon/',
-    'qwen/',
-    'rundiffusion/',
-    'google/',
-    'ideogram/',
-];
-
-const TOGETHER_IMAGE_MODEL_KEYWORDS = [
-    'flux',
-    'kling',
-    'sd3',
-    'stable-diffusion',
-    'kolors',
-];
-
 const TOGETHER_VIDEO_MODEL_PREFIXES = [
     'minimax/',
     'google/',
@@ -57,10 +30,11 @@ class AI {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
     }
 
     /**
@@ -666,7 +640,7 @@ class AI {
         let testMode = false;
 
         // default driver is openai-completion
-        let driver = 'openai-completion';
+        let driver = 'ai-chat';
 
         // Check that the argument is not undefined or null
         if ( ! args ) {
@@ -765,160 +739,6 @@ class AI {
         // convert undefined to empty string so that .startsWith works
         requestParams.model = requestParams.model ?? '';
 
-        // If model starts with "anthropic/", remove it
-        // later on we should standardize the model names to [vendor]/[model]
-        // for example: "claude-3-5-sonnet" should become "anthropic/claude-3-5-sonnet"
-        // but for now, we want to keep the old behavior
-        // so we remove the "anthropic/" prefix if it exists
-        if ( requestParams.model && requestParams.model.startsWith('anthropic/') ) {
-            requestParams.model = requestParams.model.replace('anthropic/', '');
-        }
-
-        // convert to the correct model name if necessary
-        if ( requestParams.model === 'claude-3-5-sonnet' ) {
-            requestParams.model = 'claude-3-5-sonnet-latest';
-        }
-        if ( requestParams.model === 'claude-3-7-sonnet' || requestParams.model === 'claude' ) {
-            requestParams.model = 'claude-3-7-sonnet-latest';
-        }
-        if ( requestParams.model === 'claude-sonnet-4' || requestParams.model === 'claude-sonnet-4-latest' ) {
-            requestParams.model = 'claude-sonnet-4-20250514';
-        }
-        if ( requestParams.model === 'claude-opus-4' || requestParams.model === 'claude-opus-4-latest' ) {
-            requestParams.model = 'claude-opus-4-20250514';
-        }
-        if ( requestParams.model === 'mistral' ) {
-            requestParams.model = 'mistral-large-latest';
-        }
-        if ( requestParams.model === 'groq' ) {
-            requestParams.model = 'llama3-8b-8192';
-        }
-        if ( requestParams.model === 'deepseek' ) {
-            requestParams.model = 'deepseek-chat';
-        }
-
-        // o1-mini to openrouter:openai/o1-mini
-        if ( requestParams.model === 'o1-mini' ) {
-            requestParams.model = 'openrouter:openai/o1-mini';
-        }
-
-        // if a model is prepended with "openai/", remove it
-        if ( requestParams.model && requestParams.model.startsWith('openai/') ) {
-            requestParams.model = requestParams.model.replace('openai/', '');
-            driver = 'openai-completion';
-        }
-        // For the following providers, we need to prepend "openrouter:" to the model name so that the backend driver can handle it
-        if (
-            requestParams.model.startsWith('agentica-org/') ||
-            requestParams.model.startsWith('ai21/') ||
-            requestParams.model.startsWith('aion-labs/') ||
-            requestParams.model.startsWith('alfredpros/') ||
-            requestParams.model.startsWith('allenai/') ||
-            requestParams.model.startsWith('alpindale/') ||
-            requestParams.model.startsWith('amazon/') ||
-            requestParams.model.startsWith('anthracite-org/') ||
-            requestParams.model.startsWith('arcee-ai/') ||
-            requestParams.model.startsWith('arliai/') ||
-            requestParams.model.startsWith('baidu/') ||
-            requestParams.model.startsWith('bytedance/') ||
-            requestParams.model.startsWith('cognitivecomputations/') ||
-            requestParams.model.startsWith('cohere/') ||
-            requestParams.model.startsWith('deepseek/') ||
-            requestParams.model.startsWith('eleutherai/') ||
-            requestParams.model.startsWith('google/') ||
-            requestParams.model.startsWith('gryphe/') ||
-            requestParams.model.startsWith('inception/') ||
-            requestParams.model.startsWith('infermatic/') ||
-            requestParams.model.startsWith('liquid/') ||
-            requestParams.model.startsWith('mancer/') ||
-            requestParams.model.startsWith('meta-llama/') ||
-            requestParams.model.startsWith('microsoft/') ||
-            requestParams.model.startsWith('minimax/') ||
-            requestParams.model.startsWith('mistralai/') ||
-            requestParams.model.startsWith('moonshotai/') ||
-            requestParams.model.startsWith('morph/') ||
-            requestParams.model.startsWith('neversleep/') ||
-            requestParams.model.startsWith('nousresearch/') ||
-            requestParams.model.startsWith('nvidia/') ||
-            requestParams.model.startsWith('openrouter/') ||
-            requestParams.model.startsWith('perplexity/') ||
-            requestParams.model.startsWith('pygmalionai/') ||
-            requestParams.model.startsWith('qwen/') ||
-            requestParams.model.startsWith('raifle/') ||
-            requestParams.model.startsWith('rekaai/') ||
-            requestParams.model.startsWith('sao10k/') ||
-            requestParams.model.startsWith('sarvamai/') ||
-            requestParams.model.startsWith('scb10x/') ||
-            requestParams.model.startsWith('shisa-ai/') ||
-            requestParams.model.startsWith('sophosympatheia/') ||
-            requestParams.model.startsWith('switchpoint/') ||
-            requestParams.model.startsWith('tencent/') ||
-            requestParams.model.startsWith('thedrummer/') ||
-            requestParams.model.startsWith('thudm/') ||
-            requestParams.model.startsWith('tngtech/') ||
-            requestParams.model.startsWith('undi95/') ||
-            requestParams.model.startsWith('x-ai/') ||
-            requestParams.model.startsWith('z-ai/')
-        ) {
-            requestParams.model = `openrouter:${ requestParams.model}`;
-        }
-
-        // map model to the appropriate driver
-        if ( !requestParams.model || requestParams.model.startsWith('gpt-') ) {
-            driver = 'openai-completion';
-        } else if (
-            requestParams.model.startsWith('claude-')
-        ) {
-            driver = 'claude';
-        } else if ( requestParams.model === 'meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo' || requestParams.model === 'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo' || requestParams.model === 'meta-llama/Meta-Llama-3.1-405B-Instruct-Turbo' || requestParams.model === 'google/gemma-2-27b-it' ) {
-            driver = 'together-ai';
-        } else if ( requestParams.model.startsWith('mistral-') || requestParams.model.startsWith('codestral-') || requestParams.model.startsWith('pixtral-') || requestParams.model.startsWith('magistral-') || requestParams.model.startsWith('devstral-') || requestParams.model.startsWith('mistral-ocr-') || requestParams.model.startsWith('open-mistral-') ) {
-            driver = 'mistral';
-        } else if ( [
-            'distil-whisper-large-v3-en',
-            'gemma2-9b-it',
-            'gemma-7b-it',
-            'llama-3.1-70b-versatile',
-            'llama-3.1-8b-instant',
-            'llama3-70b-8192',
-            'llama3-8b-8192',
-            'llama3-groq-70b-8192-tool-use-preview',
-            'llama3-groq-8b-8192-tool-use-preview',
-            'llama-guard-3-8b',
-            'mixtral-8x7b-32768',
-            'whisper-large-v3',
-        ].includes(requestParams.model) ) {
-            driver = 'groq';
-        } else if ( requestParams.model === 'grok-beta' ) {
-            driver = 'xai';
-        }
-        else if ( requestParams.model.startsWith('grok-') ) {
-            driver = 'openrouter';
-        }
-        else if (
-            requestParams.model === 'deepseek-chat' ||
-            requestParams.model === 'deepseek-reasoner'
-        ) {
-            driver = 'deepseek';
-        }
-        else if (
-            requestParams.model === 'gemini-1.5-flash' ||
-            requestParams.model === 'gemini-2.0-flash' ||
-            requestParams.model === 'gemini-2.5-flash' ||
-            requestParams.model === 'gemini-2.5-flash-lite' ||
-            requestParams.model === 'gemini-2.0-flash-lite' ||
-            requestParams.model === 'gemini-3-pro-preview' ||
-            requestParams.model === 'gemini-2.5-pro'
-        ) {
-            driver = 'gemini';
-        }
-        else if ( requestParams.model.startsWith('openrouter:') ) {
-            driver = 'openrouter';
-        }
-        else if ( requestParams.model.startsWith('ollama:') ) {
-            driver = 'ollama';
-        }
-
         // stream flag from userParams
         if ( userParams.stream !== undefined && typeof userParams.stream === 'boolean' ) {
             requestParams.stream = userParams.stream;
@@ -1020,27 +840,11 @@ class AI {
         }
 
         const driverHint = typeof options.driver === 'string' ? options.driver : undefined;
-        const providerRaw = typeof options.provider === 'string'
-            ? options.provider
-            : (typeof options.service === 'string' ? options.service : undefined);
-        const providerHint = typeof providerRaw === 'string' ? providerRaw.toLowerCase() : undefined;
-        const modelLower = typeof options.model === 'string' ? options.model.toLowerCase() : '';
-
-        const looksLikeTogetherModel =
-            typeof options.model === 'string' &&
-            (TOGETHER_IMAGE_MODEL_PREFIXES.some(prefix => modelLower.startsWith(prefix)) ||
-                TOGETHER_IMAGE_MODEL_KEYWORDS.some(keyword => modelLower.includes(keyword)));
 
         if ( driverHint ) {
             AIService = driverHint;
-        } else if ( providerHint === 'gemini' ) {
-            AIService = 'gemini-image-generation';
-        } else if ( providerHint === 'together' || providerHint === 'together-ai' ) {
-            AIService = 'together-image-generation';
-        } else if (options.model === 'gemini-2.5-flash-image-preview' || options.model === "gemini-3-pro-image-preview" ) {
-            AIService = 'gemini-image-generation';
-        } else if ( looksLikeTogetherModel ) {
-            AIService = 'together-image-generation';
+        } else {
+            AIService = 'ai-image';
         }
         // Call the original chat.complete method
         return await utils.make_driver_method(['prompt'], 'puter-image-generation', AIService, 'generate', {

package/src/modules/Apps.js

@@ -9,10 +9,42 @@ class Apps {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
+    }
+
+    #addUserIterationToApp (app) {
+        app.getUsers = async (params) => {
+            params = params ?? {};
+            return (await puter.drivers.call('app-telemetry', 'app-telemetry', 'get_users', { app_uuid: app.uid, limit: params.limit, offset: params.offset })).result;
+        };
+        app.users = async function* (pageSize = 100) {
+            let offset = 0;
+
+            while ( true ) {
+                const users = await app.getUsers({ limit: pageSize, offset });
+
+                if ( !users || users.length === 0 ) return;
+
+                for ( const user of users ) {
+                    yield user;
+                }
+
+                offset += users.length;
+                if ( users.length < pageSize ) return;
+            }
+        };
+        return app;
+    }
+
+    #addUserIterationToApps (apps) {
+        apps.forEach(app => {
+            this.#addUserIterationToApp(app);
+        });
+        return apps;
     }
 
     /**
@@ -47,7 +79,7 @@ class Apps {
 
         options.predicate = ['user-can-edit'];
 
-        return utils.make_driver_method(['uid'], 'puter-apps', undefined, 'select').call(this, options);
+        return this.#addUserIterationToApps(await utils.make_driver_method(['uid'], 'puter-apps', 'es:app', 'select').call(this, options));
     };
 
     create = async (...args) => {
@@ -111,7 +143,7 @@ class Apps {
         }
 
         // Call the original chat.complete method
-        return await utils.make_driver_method(['object'], 'puter-apps', undefined, 'create').call(this, options);
+        return this.#addUserIterationToApp(await utils.make_driver_method(['object'], 'puter-apps', 'es:app', 'create').call(this, options));
     };
 
     update = async (...args) => {
@@ -137,7 +169,7 @@ class Apps {
         }
 
         // Call the original chat.complete method
-        return await utils.make_driver_method(['object'], 'puter-apps', undefined, 'update').call(this, options);
+        return this.#addUserIterationToApp(await utils.make_driver_method(['object'], 'puter-apps', 'es:app', 'update').call(this, options));
     };
 
     get = async (...args) => {
@@ -158,8 +190,7 @@ class Apps {
         if ( typeof args[0] === 'object' && args[0] !== null ) {
             options.params = args[0];
         }
-
-        return utils.make_driver_method(['uid'], 'puter-apps', undefined, 'read').call(this, options);
+        return this.#addUserIterationToApp(await utils.make_driver_method(['uid'], 'puter-apps', 'es:app', 'read').call(this, options));
     };
 
     delete = async (...args) => {
@@ -169,7 +200,7 @@ class Apps {
         if ( Array.isArray(args) && typeof args[0] === 'string' ) {
             options = { id: { name: args[0] } };
         }
-        return utils.make_driver_method(['uid'], 'puter-apps', undefined, 'delete').call(this, options);
+        return utils.make_driver_method(['uid'], 'puter-apps', 'es:app', 'delete').call(this, options);
     };
 
     getDeveloperProfile = function (...args) {
@@ -212,4 +243,4 @@ class Apps {
     };
 }
 
-export default Apps;
+export default Apps;

package/src/modules/Auth.js

@@ -13,10 +13,11 @@ class Auth {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
     }
 
     /**
@@ -291,4 +292,4 @@ class Auth {
     }
 }
 
-export default Auth;
+export default Auth;

package/src/modules/Debug.js

@@ -1,6 +1,6 @@
 export class Debug {
-    constructor (context, parameters) {
-        this.context = context;
+    constructor (puter, parameters) {
+        this.puter = puter;
         this.parameters = parameters;
 
         this._init();
@@ -14,7 +14,7 @@ export class Debug {
         enabled_logs = enabled_logs.split(';');
         for ( const category of enabled_logs ) {
             if ( category === '' ) continue;
-            this.context.puter.logger.on(category);
+            this.puter.logger.on(category);
         }
 
         globalThis.addEventListener('message', async e => {
@@ -32,7 +32,7 @@ export class Debug {
 
             if ( e.data.cmd === 'log.on' ) {
                 console.log('Got instruction to turn logs on!');
-                this.context.puter.logger.on(e.data.category);
+                this.puter.logger.on(e.data.category);
             }
         });
     }

package/src/modules/Drivers.js

@@ -1,6 +1,7 @@
 class FetchDriverCallBackend {
-    constructor ({ context }) {
-        this.context = context;
+    constructor ({ getAPIOrigin, getAuthToken }) {
+        this.getAPIOrigin = getAPIOrigin;
+        this.getAuthToken = getAuthToken;
         this.response_handlers = this.constructor.response_handlers;
     }
 
@@ -32,7 +33,7 @@ class FetchDriverCallBackend {
 
     async call ({ driver, method_name, parameters }) {
         try {
-            const resp = await fetch(`${this.context.APIOrigin}/drivers/call`, {
+            const resp = await fetch(`${this.getAPIOrigin()}/drivers/call`, {
                 headers: {
                     'Content-Type': 'text/plain;actually=json',
                 },
@@ -44,7 +45,7 @@ class FetchDriverCallBackend {
                         : {}),
                     method: method_name,
                     args: parameters,
-                    auth_token: this.context.authToken,
+                    auth_token: this.getAuthToken(),
                 }),
             });
 
@@ -131,22 +132,15 @@ class Drivers {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
 
         // Driver-specific
         this.drivers_ = {};
 
-        // TODO: replace with `context` from constructor and test site login
-        this.context = {};
-        Object.defineProperty(this.context, 'authToken', {
-            get: () => this.authToken,
-        });
-        Object.defineProperty(this.context, 'APIOrigin', {
-            get: () => this.APIOrigin,
-        });
     }
 
     _init ({ puter }) {
@@ -226,7 +220,8 @@ class Drivers {
 
         return this.drivers_[key] = new Driver ({
             call_backend: new FetchDriverCallBackend({
-                context: this.context,
+                getAPIOrigin: () => this.APIOrigin,
+                getAuthToken: () => this.authToken,
             }),
             // iface: interfaces[iface_name],
             iface_name,

package/src/modules/FileSystem/index.js

@@ -20,14 +20,11 @@ import stat from './operations/stat.js';
 import symlink from './operations/symlink.js';
 import upload from './operations/upload.js';
 import write from './operations/write.js';
-// Why is this called deleteFSEntry instead of just delete? because delete is
-// a reserved keyword in javascript
-import { AdvancedBase } from '../../../../putility/index.js';
 import FSItem from '../FSItem.js';
 import deleteFSEntry from './operations/deleteFSEntry.js';
 import getReadURL from './operations/getReadUrl.js';
 
-export class PuterJSFileSystemModule extends AdvancedBase {
+export class PuterJSFileSystemModule {
 
     space = space;
     mkdir = mkdir;
@@ -48,17 +45,6 @@ export class PuterJSFileSystemModule extends AdvancedBase {
 
     FSItem = FSItem;
 
-    static NARI_METHODS = {
-        // stat: {
-        //     positional: ['path'],
-        //     firstarg_options: true,
-        //     async fn (parameters) {
-        //         const svc_fs = await this.context.services.aget('filesystem');
-        //         return svc_fs.filesystem.stat(parameters);
-        //     }
-        // },
-    };
-
     /**
      * Creates a new instance with the given authentication token, API origin, and app ID,
      * and connects to the socket.
@@ -68,12 +54,11 @@ export class PuterJSFileSystemModule extends AdvancedBase {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        super();
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
-        this.context = context;
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
         this.cacheUpdateTimer = null;
         // Connect socket.
         this.initializeSocket();
@@ -107,7 +92,7 @@ export class PuterJSFileSystemModule extends AdvancedBase {
             auth: {
                 auth_token: this.authToken,
             },
-            autoUnref: this.context.env === 'nodejs',
+            autoUnref: this.puter.env === 'nodejs',
         });
 
         this.bindSocketEvents();
@@ -212,7 +197,7 @@ export class PuterJSFileSystemModule extends AdvancedBase {
         this.authToken = authToken;
 
         // Check cache timestamp and purge if needed (only in GUI environment)
-        if ( this.context.env === 'gui' ) {
+        if ( this.puter.env === 'gui' ) {
             this.checkCacheAndPurge();
             // Start background task to update LAST_VALID_TS every 1 second
             this.startCacheUpdateTimer();
@@ -305,7 +290,7 @@ export class PuterJSFileSystemModule extends AdvancedBase {
      * @returns {void}
      */
     startCacheUpdateTimer () {
-        if ( this.context.env !== 'gui' ) {
+        if ( this.puter.env !== 'gui' ) {
             return;
         }
 

package/src/modules/Hosting.js

@@ -10,10 +10,11 @@ class Hosting {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
     }
 
     /**

package/src/modules/KV.js

@@ -1,6 +1,15 @@
-import { TeePromise } from '@heyputer/putility/src/libs/promise.js';
 import * as utils from '../lib/utils.js';
 
+const createDeferred = () => {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+};
+
 const gui_cache_keys = [
     'has_set_default_app_user_permissions',
     'window_sidebar_width',
@@ -29,15 +38,16 @@ class KV {
      * @param {string} APIOrigin - Origin of the API server. Used to build the API endpoint URLs.
      * @param {string} appID - ID of the app to use.
      */
-    constructor (context) {
-        this.authToken = context.authToken;
-        this.APIOrigin = context.APIOrigin;
-        this.appID = context.appID;
-
-        this.gui_cached = new TeePromise();
-        this.gui_cache_init = new TeePromise();
+    constructor (puter) {
+        this.puter = puter;
+        this.authToken = puter.authToken;
+        this.APIOrigin = puter.APIOrigin;
+        this.appID = puter.appID;
+
+        this.gui_cached = createDeferred();
+        this.gui_cache_init = createDeferred();
         (async () => {
-            await this.gui_cache_init;
+            await this.gui_cache_init.promise;
             this.gui_cache_init = null;
             const resp = await fetch(`${this.APIOrigin}/drivers/call`, {
                 method: 'POST',
@@ -142,7 +152,7 @@ class KV {
             this.gui_cached !== null
         ) {
             this.gui_cache_init && this.gui_cache_init.resolve();
-            const cache = await this.gui_cached;
+            const cache = await this.gui_cached.promise;
             return cache[args[0]];
         }
 
@@ -202,6 +212,52 @@ class KV {
         return utils.make_driver_method(['key'], 'puter-kvstore', undefined, 'decr').call(this, options);
     };
 
+    add = async (...args) => {
+        let options = {};
+
+        // arguments are required
+        if ( !args || args.length === 0 ) {
+            throw ({ message: 'Arguments are required', code: 'arguments_required' });
+        }
+
+        options.key = args[0];
+        const provided = args[1];
+        const isPathMap = provided && typeof provided === 'object' && !Array.isArray(provided);
+        options.pathAndValueMap = provided === undefined ? { '': 1 } : isPathMap ? provided : { '': provided };
+
+        // key size cannot be larger than MAX_KEY_SIZE
+        if ( options.key.length > this.MAX_KEY_SIZE ) {
+            throw ({ message: `Key size cannot be larger than ${this.MAX_KEY_SIZE}`, code: 'key_too_large' });
+        }
+
+        return utils.make_driver_method(['key'], 'puter-kvstore', undefined, 'add').call(this, options);
+    };
+
+    update = utils.make_driver_method(['key', 'pathAndValueMap', 'ttl'], 'puter-kvstore', undefined, 'update', {
+        preprocess: (args) => {
+            if ( args.key === undefined || args.key === null ) {
+                throw { message: 'Key cannot be undefined', code: 'key_undefined' };
+            }
+            if ( args.key.length > this.MAX_KEY_SIZE ) {
+                throw { message: `Key size cannot be larger than ${this.MAX_KEY_SIZE}`, code: 'key_too_large' };
+            }
+            if ( args.pathAndValueMap === undefined || args.pathAndValueMap === null || Array.isArray(args.pathAndValueMap) || typeof args.pathAndValueMap !== 'object' ) {
+                throw { message: 'pathAndValueMap must be an object', code: 'path_map_invalid' };
+            }
+            if ( Object.keys(args.pathAndValueMap).length === 0 ) {
+                throw { message: 'pathAndValueMap cannot be empty', code: 'path_map_invalid' };
+            }
+            if ( args.ttl !== undefined && args.ttl !== null ) {
+                const ttl = Number(args.ttl);
+                if ( Number.isNaN(ttl) ) {
+                    throw { message: 'ttl must be a number', code: 'ttl_invalid' };
+                }
+                args.ttl = ttl;
+            }
+            return args;
+        },
+    });
+
     /**
      * Set a time to live (in seconds) on a key. After the time to live has expired, the key will be deleted.
      * Prefer this over expireAt if you want timestamp to be set by the server, to avoid issues with clock drift.
@@ -323,4 +379,4 @@ function globMatch (pattern, str) {
     return re.test(str);
 }
 
-export default KV;
+export default KV;