mage-remote-run 0.1.0 → 0.2.5

package/bin/mage-remote-run.js

@@ -35,11 +35,63 @@ registerEavCommands(program);
 registerProductsCommands(program);
 registerTaxCommands(program);
 
+function resolveCommandMatch(parent, token) {
+    const tokenLower = token.toLowerCase();
+    const matches = parent.commands.filter((cmd) => {
+        const name = cmd.name().toLowerCase();
+        if (name.startsWith(tokenLower)) return true;
+        const aliases = cmd.aliases ? cmd.aliases() : [];
+        return aliases.some((alias) => alias.toLowerCase().startsWith(tokenLower));
+    });
+
+    return {
+        match: matches.length === 1 ? matches[0] : null,
+        matches
+    };
+}
+
+function expandCommandAbbreviations(rootCommand, argv) {
+    const expanded = [];
+    let current = rootCommand;
+    const path = [];
+
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (token.startsWith('-')) {
+            expanded.push(token);
+            continue;
+        }
+
+        if (!current.commands || current.commands.length === 0) {
+            expanded.push(...argv.slice(i));
+            break;
+        }
+
+        const { match, matches } = resolveCommandMatch(current, token);
+        if (!match) {
+            if (matches.length > 1) {
+                const parentName = path.length > 0 ? path.join(' ') : current.name();
+                const options = matches.map((cmd) => cmd.name()).join(', ');
+                console.error(`Ambiguous command "${token}" under "${parentName}". Options: ${options}.`);
+                process.exit(1);
+            }
+            expanded.push(token);
+            continue;
+        }
+
+        expanded.push(match.name());
+        current = match;
+        path.push(match.name());
+    }
+
+    return expanded;
+}
+
 // Check for first run (no profiles configured and no arguments or just help)
 // We need to check args length.
 // node script.js -> length 2.
 // node script.js command -> length 3.
-const args = process.argv.slice(2);
+let args = process.argv.slice(2);
 const config = await loadConfig();
 const hasProfiles = Object.keys(config.profiles || {}).length > 0;
 
@@ -55,7 +107,10 @@ if (!hasProfiles && args.length === 0) {
     // Easiest is to manually invoke program.parse with ['node', 'script', 'connection', 'add']
     // BUT program.parse executes asynchronously usually? commander is synchronous by default but actions are async.
     // Let's modify process.argv before parsing.
-    process.argv = [...process.argv.slice(0, 2), 'connection', 'add'];
+    args = ['connection', 'add'];
 }
 
+args = expandCommandAbbreviations(program, args);
+process.argv = [...process.argv.slice(0, 2), ...args];
+
 program.parse(process.argv);

package/lib/api/paas.js

@@ -19,7 +19,7 @@ export class PaasClient extends ApiClient {
         this.openApi = new OpenAPIClientAxios({
             definition,
             axiosConfigDefaults: {
-                baseURL: `${this.baseUrl}/rest/V1`
+                baseURL: `${this.baseUrl}/rest`
             }
         });
 

package/lib/api/saas.js

@@ -2,6 +2,7 @@ import axios from 'axios';
 import { ApiClient } from './client.js';
 import { OpenAPIClientAxios } from 'openapi-client-axios';
 import { loadSpec } from './spec-loader.js';
+import { loadTokenCache, saveTokenCache } from '../config.js';
 
 export class SaasClient extends ApiClient {
     constructor(config) {
@@ -16,10 +17,11 @@ export class SaasClient extends ApiClient {
         if (this.openApi) return;
 
         const definition = loadSpec(this.config.type);
+        const basePath = this.baseUrl;
         this.openApi = new OpenAPIClientAxios({
             definition,
             axiosConfigDefaults: {
-                baseURL: `${this.baseUrl}/rest/V1`, // Base for generated client
+                baseURL: basePath, // Base for generated client
                 // Note: The definition might have servers block, but we override functionality.
             }
         });
@@ -40,19 +42,49 @@ export class SaasClient extends ApiClient {
             return this.token;
         }
 
-        const tokenUrl = `${this.baseUrl}/oauth/token`;
+        const tokenUrl = (this.config.type === 'ac-saas' || this.config.type === 'saas')
+            ? 'https://ims-na1.adobelogin.com/ims/token/v3'
+            : `${this.baseUrl}/oauth/token`;
 
         try {
+            const cacheKey = `${this.config.type}|${this.config.url}|${this.config.auth.clientId}`;
+            const cache = await loadTokenCache();
+            const cachedEntry = cache[cacheKey];
+            if (cachedEntry?.token && cachedEntry?.expiresAt && Date.now() < cachedEntry.expiresAt) {
+                this.token = cachedEntry.token;
+                this.tokenExpiresAt = cachedEntry.expiresAt;
+                return this.token;
+            }
+
             // Use raw axios for token fetch to avoid circular dependency or interceptor issues
-            const response = await axios.post(tokenUrl, {
-                grant_type: 'client_credentials',
-                client_id: this.config.auth.clientId,
-                client_secret: this.config.auth.clientSecret
-            });
+            let response;
+            if (this.config.type === 'ac-saas' || this.config.type === 'saas') {
+                const payload = new URLSearchParams({
+                    grant_type: 'client_credentials',
+                    client_id: this.config.auth.clientId,
+                    client_secret: this.config.auth.clientSecret,
+                    scope: 'openid,AdobeID,email,profile,additional_info.roles,additional_info.projectedProductContext,commerce.accs'
+                });
+                response = await axios.post(tokenUrl, payload.toString(), {
+                    headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
+                });
+            } else {
+                const payload = {
+                    grant_type: 'client_credentials',
+                    client_id: this.config.auth.clientId,
+                    client_secret: this.config.auth.clientSecret
+                };
+                response = await axios.post(tokenUrl, payload);
+            }
 
             this.token = response.data.access_token;
             const expiresIn = response.data.expires_in || 3600;
             this.tokenExpiresAt = Date.now() + (expiresIn * 1000) - 60000;
+            cache[cacheKey] = {
+                token: this.token,
+                expiresAt: this.tokenExpiresAt
+            };
+            await saveTokenCache(cache);
 
             return this.token;
         } catch (error) {
@@ -66,7 +98,7 @@ export class SaasClient extends ApiClient {
         // Use the configured axios instance for generic requests
         // Note: endpoint passed here is like 'store/websites'
         // openapi-client-axios client base is usually set to server root or we adjusted it.
-        // If we set baseURL to /rest/V1, we just need the relative path.
+        // baseURL is the instance root; include API version in the endpoint.
 
         // Ensure endpoint does not start with / if base has it, or handle cleanly
         const cleanEndpoint = endpoint.replace(/^\//, '');

package/lib/commands/connections.js

@@ -1,4 +1,4 @@
-import { loadConfig, saveConfig, addProfile } from '../config.js';
+import { loadConfig, saveConfig, addProfile, clearTokenCache } from '../config.js';
 import { printTable, handleError } from '../utils.js';
 import { askForProfileSettings } from '../prompts.js';
 import { createClient } from '../api/factory.js';
@@ -134,7 +134,7 @@ export function registerConnectionCommands(program) {
                             const client = await createClient(profileConfig);
 
                             const start = Date.now();
-                            await client.get('store/storeViews');
+                            await client.get('V1/store/storeViews');
                             const duration = Date.now() - start;
 
                             results.push([name, chalk.green('SUCCESS'), `${duration}ms`]);
@@ -155,7 +155,7 @@ export function registerConnectionCommands(program) {
                     try {
                         const client = await createClient(); // Uses active profile
                         const start = Date.now();
-                        await client.get('store/storeViews');
+                        await client.get('V1/store/storeViews');
                         const duration = Date.now() - start;
 
                         console.log(chalk.green(`\n✔ Connection successful! (${duration}ms)`));
@@ -211,4 +211,13 @@ export function registerConnectionCommands(program) {
                 console.log(chalk.green(`Active profile set to "${selected}".`));
             } catch (e) { handleError(e); }
         });
+
+    connections.command('clear-token-cache')
+        .description('Clear cached access tokens')
+        .action(async () => {
+            try {
+                await clearTokenCache();
+                console.log(chalk.green('Token cache cleared.'));
+            } catch (e) { handleError(e); }
+        });
 }

package/lib/commands/customers.js

@@ -16,7 +16,7 @@ export function registerCustomersCommands(program) {
                     'searchCriteria[currentPage]': options.page,
                     'searchCriteria[pageSize]': options.size
                 };
-                const data = await client.get('customers/search', params);
+                const data = await client.get('V1/customers/search', params);
                 const rows = (data.items || []).map(c => [c.id, c.email, c.firstname, c.lastname, c.group_id]);
                 console.log(chalk.bold(`Total: ${data.total_count}, Page: ${options.page}, Size: ${options.size}`));
                 printTable(['ID', 'Email', 'First Name', 'Last Name', 'Group'], rows);
@@ -33,7 +33,7 @@ export function registerCustomersCommands(program) {
                     'searchCriteria[filter_groups][0][filters][0][value]': `%${query}%`,
                     'searchCriteria[filter_groups][0][filters][0][condition_type]': 'like'
                 };
-                const data = await client.get('customers/search', params);
+                const data = await client.get('V1/customers/search', params);
                 const rows = (data.items || []).map(c => [c.id, c.email, c.firstname, c.lastname]);
                 printTable(['ID', 'Email', 'Name', 'Lastname'], rows);
             } catch (e) { handleError(e); }
@@ -43,7 +43,7 @@ export function registerCustomersCommands(program) {
         .action(async (id) => {
             try {
                 const client = await createClient();
-                const data = await client.get(`customers/${id}`);
+                const data = await client.get(`V1/customers/${id}`);
 
                 const answers = await inquirer.prompt([
                     { name: 'firstname', message: 'First Name', default: data.firstname },
@@ -60,7 +60,7 @@ export function registerCustomersCommands(program) {
                     }
                 };
 
-                await client.put(`customers/${id}`, payload);
+                await client.put(`V1/customers/${id}`, payload);
                 console.log(chalk.green(`Customer ${id} updated.`));
             } catch (e) { handleError(e); }
         });
@@ -75,7 +75,7 @@ export function registerCustomersCommands(program) {
                 if (options.format === 'json') headers['Accept'] = 'application/json';
                 else if (options.format === 'xml') headers['Accept'] = 'application/xml';
 
-                const data = await client.get(`customers/${customerId}`, {}, { headers });
+                const data = await client.get(`V1/customers/${customerId}`, {}, { headers });
 
                 if (options.format === 'json') {
                     console.log(JSON.stringify(data, null, 2));
@@ -139,7 +139,7 @@ export function registerCustomersCommands(program) {
                 }
 
                 const client = await createClient();
-                await client.delete(`customers/${customerId}`);
+                await client.delete(`V1/customers/${customerId}`);
                 console.log(chalk.green(`✅ Customer ${customerId} deleted.`));
             } catch (e) { handleError(e); }
         });
@@ -154,7 +154,7 @@ export function registerCustomersCommands(program) {
 
                 if (customerId) {
                     try {
-                        const customer = await client.get(`customers/${customerId}`);
+                        const customer = await client.get(`V1/customers/${customerId}`);
                         email = customer.email;
                         websiteId = customer.website_id;
                         console.log(chalk.gray(`Fetched customer ${customerId}: ${email} (Website: ${websiteId})`));
@@ -183,7 +183,7 @@ export function registerCustomersCommands(program) {
                     redirectUrl: options.redirectUrl || undefined
                 };
 
-                await client.post('customers/confirm', payload);
+                await client.post('V1/customers/confirm', payload);
                 console.log(chalk.green(`✅ Confirmation email sent to ${email}`));
             } catch (e) {
                 if (e.response && e.response.status === 400 && e.response.data && e.response.data.message === "Confirmation isn't needed.") {

package/lib/commands/eav.js

@@ -19,7 +19,7 @@ export function registerEavCommands(program) {
                     'searchCriteria[currentPage]': options.page,
                     'searchCriteria[pageSize]': options.size
                 };
-                const data = await client.get('eav/attribute-sets/list', params);
+                const data = await client.get('V1/eav/attribute-sets/list', params);
                 const rows = (data.items || []).map(set => [
                     set.attribute_set_id,
                     set.attribute_set_name,
@@ -36,7 +36,7 @@ export function registerEavCommands(program) {
         .action(async (id) => {
             try {
                 const client = await createClient();
-                const data = await client.get(`eav/attribute-sets/${id}`);
+                const data = await client.get(`V1/eav/attribute-sets/${id}`);
 
                 console.log(chalk.bold.blue('\nAttribute Set Details:'));
                 console.log(`${chalk.bold('ID:')}             ${data.attribute_set_id}`);

package/lib/commands/orders.js

@@ -16,7 +16,7 @@ export function registerOrdersCommands(program) {
                     'searchCriteria[currentPage]': options.page,
                     'searchCriteria[pageSize]': options.size
                 };
-                const data = await client.get('orders', params);
+                const data = await client.get('V1/orders', params);
                 const rows = (data.items || []).map(o => [o.entity_id, o.increment_id, o.status, o.grand_total, o.customer_email]);
                 console.log(chalk.bold(`Total: ${data.total_count}, Page: ${options.page}, Size: ${options.size}`));
                 printTable(['ID', 'Increment ID', 'Status', 'Total', 'Email'], rows);
@@ -33,7 +33,7 @@ export function registerOrdersCommands(program) {
                     'searchCriteria[filter_groups][0][filters][0][value]': `%${query}%`,
                     'searchCriteria[filter_groups][0][filters][0][condition_type]': 'like'
                 };
-                const data = await client.get('orders', params);
+                const data = await client.get('V1/orders', params);
                 const rows = (data.items || []).map(o => [o.entity_id, o.increment_id, o.status, o.grand_total]);
                 printTable(['ID', 'Increment ID', 'Status', 'Total'], rows);
             } catch (e) { handleError(e); }
@@ -52,7 +52,7 @@ export function registerOrdersCommands(program) {
                 ]);
 
                 // POST /V1/orders/:id/comments
-                await client.post(`orders/${id}/comments`, {
+                await client.post(`V1/orders/${id}/comments`, {
                     statusHistory: {
                         comment: answers.comment,
                         status: answers.status,
@@ -86,7 +86,7 @@ export function registerOrdersCommands(program) {
                     'searchCriteria[sortOrders][0][field]': 'created_at',
                     'searchCriteria[sortOrders][0][direction]': 'DESC'
                 };
-                const data = await client.get('orders', params);
+                const data = await client.get('V1/orders', params);
                 const items = data.items || [];
 
                 if (items.length === 0) {
@@ -141,7 +141,7 @@ async function showOrder(identifier, format = 'text') {
     }
 
     try {
-        order = await client.get(`orders/${identifier}`, {}, { headers });
+        order = await client.get(`V1/orders/${identifier}`, {}, { headers });
     } catch (e) {
         // If 404, maybe it was an increment ID
         // Or if user provided something that is definitely an increment ID
@@ -150,14 +150,14 @@ async function showOrder(identifier, format = 'text') {
             'searchCriteria[filter_groups][0][filters][0][value]': identifier,
             'searchCriteria[filter_groups][0][filters][0][condition_type]': 'eq'
         };
-        const searchData = await client.get('orders', params);
+        const searchData = await client.get('V1/orders', params);
         if (searchData.items && searchData.items.length > 0) {
             order = searchData.items[0];
             // If format is specific, we might want to re-fetch by ID with headers if search didn't return format?
             // Search API usually returns JSON. If user wants XML, search return helps find ID, then we fetch XML.
             if (format !== 'text') {
                 try {
-                    order = await client.get(`orders/${order.entity_id}`, {}, { headers });
+                    order = await client.get(`V1/orders/${order.entity_id}`, {}, { headers });
                 } catch (subError) {
                     // ignore or log? If we fail to get formatted, fallback or throw?
                     // If we found it via search, 'order' is the object. 

package/lib/commands/products.js

@@ -10,7 +10,7 @@ export function registerProductsCommands(program) {
         .action(async () => {
             try {
                 const client = await createClient();
-                const data = await client.get('products/types');
+                const data = await client.get('V1/products/types');
                 const rows = (data || []).map(t => [t.name, t.label]);
                 printTable(['Name (ID)', 'Label'], rows);
             } catch (e) { handleError(e); }
@@ -31,7 +31,7 @@ export function registerProductsCommands(program) {
                     'searchCriteria[sortOrders][0][field]': 'attribute_code',
                     'searchCriteria[sortOrders][0][direction]': 'ASC'
                 };
-                const data = await client.get('products/attributes', params);
+                const data = await client.get('V1/products/attributes', params);
                 const rows = (data.items || []).map(a => [
                     a.attribute_id,
                     a.attribute_code,
@@ -56,7 +56,7 @@ export function registerProductsCommands(program) {
 
                 let data;
                 try {
-                    data = await client.get(`products/attributes/${attributeCode}`, {}, { headers });
+                    data = await client.get(`V1/products/attributes/${attributeCode}`, {}, { headers });
                 } catch (e) {
                     throw new Error(`Attribute '${attributeCode}' not found.`);
                 }
@@ -125,7 +125,7 @@ export function registerProductsCommands(program) {
         .action(async () => {
             try {
                 const client = await createClient();
-                const data = await client.get('products/attributes/types');
+                const data = await client.get('V1/products/attributes/types');
                 const rows = (data || []).map(t => [t.value, t.label]);
                 printTable(['Value', 'Label'], rows);
             } catch (e) { handleError(e); }

package/lib/commands/stores.js

@@ -10,7 +10,7 @@ export function registerStoresCommands(program) {
         .action(async () => {
             try {
                 const client = await createClient();
-                const data = await client.get('store/storeGroups');
+                const data = await client.get('V1/store/storeGroups');
                 const rows = data.map(s => [s.id, s.code, s.name, s.website_id, s.root_category_id]);
                 printTable(['ID', 'Code', 'Name', 'Web ID', 'Root Cat'], rows);
             } catch (e) { handleError(e); }
@@ -20,7 +20,7 @@ export function registerStoresCommands(program) {
         .action(async (query) => {
             try {
                 const client = await createClient();
-                const data = await client.get('store/storeGroups');
+                const data = await client.get('V1/store/storeGroups');
                 const filtered = data.filter(s => s.name.includes(query) || s.code.includes(query));
                 const rows = filtered.map(s => [s.id, s.code, s.name]);
                 printTable(['ID', 'Code', 'Name'], rows);
@@ -33,7 +33,7 @@ export function registerStoresCommands(program) {
                 const client = await createClient();
                 const { confirm } = await inquirer.prompt([{ type: 'confirm', name: 'confirm', message: `Delete Store Group ${id}?` }]);
                 if (!confirm) return;
-                await client.delete(`store/storeGroups/${id}`);
+                await client.delete(`V1/store/storeGroups/${id}`);
                 console.log(chalk.green(`Store Group ${id} deleted.`));
             } catch (e) { handleError(e); }
         });
@@ -42,7 +42,7 @@ export function registerStoresCommands(program) {
         .action(async (id) => {
             try {
                 const client = await createClient();
-                const all = await client.get('store/storeGroups');
+                const all = await client.get('V1/store/storeGroups');
                 const current = all.find(s => s.id == id);
                 if (!current) throw new Error(`Store ${id} not found`);
 
@@ -52,7 +52,7 @@ export function registerStoresCommands(program) {
                     { name: 'website_id', message: 'Website ID', default: current.website_id }
                 ]);
 
-                await client.put(`store/storeGroups/${id}`, { group: { id: parseInt(id), ...answers } });
+                await client.put(`V1/store/storeGroups/${id}`, { group: { id: parseInt(id), ...answers } });
                 console.log(chalk.green(`Store ${id} updated.`));
             } catch (e) { handleError(e); }
         });
@@ -64,7 +64,7 @@ export function registerStoresCommands(program) {
         .action(async () => {
             try {
                 const client = await createClient();
-                const data = await client.get('store/storeViews');
+                const data = await client.get('V1/store/storeViews');
                 const rows = data.map(v => [v.id, v.code, v.name, v.store_group_id, v.is_active]);
                 printTable(['ID', 'Code', 'Name', 'Group ID', 'Active'], rows);
             } catch (e) { handleError(e); }
@@ -74,7 +74,7 @@ export function registerStoresCommands(program) {
         .action(async (query) => {
             try {
                 const client = await createClient();
-                const data = await client.get('store/storeViews');
+                const data = await client.get('V1/store/storeViews');
                 const filtered = data.filter(v => v.name.includes(query) || v.code.includes(query));
                 const rows = filtered.map(v => [v.id, v.code, v.name]);
                 printTable(['ID', 'Code', 'Name'], rows);
@@ -87,7 +87,7 @@ export function registerStoresCommands(program) {
                 const client = await createClient();
                 const { confirm } = await inquirer.prompt([{ type: 'confirm', name: 'confirm', message: `Delete Store View ${id}?` }]);
                 if (!confirm) return;
-                await client.delete(`store/storeViews/${id}`);
+                await client.delete(`V1/store/storeViews/${id}`);
                 console.log(chalk.green(`Store View ${id} deleted.`));
             } catch (e) { handleError(e); }
         });
@@ -96,7 +96,7 @@ export function registerStoresCommands(program) {
         .action(async (id) => {
             try {
                 const client = await createClient();
-                const all = await client.get('store/storeViews');
+                const all = await client.get('V1/store/storeViews');
                 const current = all.find(v => v.id == id);
                 if (!current) throw new Error(`View ${id} not found`);
 
@@ -106,7 +106,7 @@ export function registerStoresCommands(program) {
                     { name: 'is_active', message: 'Is Active (0/1)', default: current.is_active }
                 ]);
 
-                await client.put(`store/storeViews/${id}`, { store: { id: parseInt(id), ...answers } });
+                await client.put(`V1/store/storeViews/${id}`, { store: { id: parseInt(id), ...answers } });
                 console.log(chalk.green(`Store View ${id} updated.`));
             } catch (e) { handleError(e); }
         });

package/lib/commands/tax.js

@@ -18,7 +18,7 @@ export function registerTaxCommands(program) {
                     'searchCriteria[currentPage]': options.page,
                     'searchCriteria[pageSize]': options.size
                 };
-                const data = await client.get('taxClasses/search', params);
+                const data = await client.get('V1/taxClasses/search', params);
                 const rows = (data.items || []).map(tc => [
                     tc.class_id,
                     tc.class_name,
@@ -34,7 +34,7 @@ export function registerTaxCommands(program) {
         .action(async (id) => {
             try {
                 const client = await createClient();
-                const data = await client.get(`taxClasses/${id}`);
+                const data = await client.get(`V1/taxClasses/${id}`);
 
                 console.log(chalk.bold.blue('\nTax Class Details:'));
                 console.log(`${chalk.bold('ID:')}   ${data.class_id}`);

package/lib/commands/websites.js

@@ -11,7 +11,7 @@ export function registerWebsitesCommands(program) {
         .action(async () => {
             try {
                 const client = await createClient();
-                const data = await client.get('store/websites');
+                const data = await client.get('V1/store/websites');
                 const rows = data.map(w => [w.id, w.code, w.name, w.default_group_id]);
                 printTable(['ID', 'Code', 'Name', 'Def Group ID'], rows);
             } catch (e) { handleError(e); }
@@ -22,7 +22,7 @@ export function registerWebsitesCommands(program) {
         .action(async (query) => {
             try {
                 const client = await createClient();
-                const data = await client.get('store/websites');
+                const data = await client.get('V1/store/websites');
                 const filtered = data.filter(w =>
                     w.code.includes(query) || w.name.includes(query)
                 );
@@ -44,7 +44,7 @@ export function registerWebsitesCommands(program) {
                 }]);
                 if (!confirm) return;
 
-                await client.delete(`store/websites/${id}`);
+                await client.delete(`V1/store/websites/${id}`);
                 console.log(chalk.green(`Website ${id} deleted.`));
             } catch (e) { handleError(e); }
         });
@@ -57,7 +57,7 @@ export function registerWebsitesCommands(program) {
                 // Fetch current
                 // Actually Magento doesn't have a single GET /store/websites/:id easily publicly documented distinct from the list?
                 // But let's assume we fetch list and find it.
-                const all = await client.get('store/websites');
+                const all = await client.get('V1/store/websites');
                 const current = all.find(w => w.id == id);
                 if (!current) throw new Error(`Website ${id} not found`);
 
@@ -69,7 +69,7 @@ export function registerWebsitesCommands(program) {
                 ]);
 
                 // PUT /V1/store/websites/:id
-                await client.put(`store/websites/${id}`, { website: { id: parseInt(id), ...answers } });
+                await client.put(`V1/store/websites/${id}`, { website: { id: parseInt(id), ...answers } });
                 console.log(chalk.green(`Website ${id} updated.`));
             } catch (e) { handleError(e); }
         });

package/lib/config.js

@@ -6,6 +6,7 @@ import { mkdirp } from 'mkdirp';
 const paths = envPaths('mage-remote-run', { suffix: '' });
 const CONFIG_DIR = paths.config;
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const TOKEN_CACHE_FILE = path.join(CONFIG_DIR, 'token-cache.json');
 
 export async function loadConfig() {
     try {
@@ -52,3 +53,37 @@ export async function getActiveProfile() {
 export function getConfigPath() {
     return CONFIG_FILE;
 }
+
+export async function loadTokenCache() {
+    try {
+        if (!fs.existsSync(TOKEN_CACHE_FILE)) {
+            return {};
+        }
+        const data = fs.readFileSync(TOKEN_CACHE_FILE, 'utf-8');
+        return JSON.parse(data);
+    } catch (e) {
+        console.error("Error loading token cache:", e.message);
+        return {};
+    }
+}
+
+export async function saveTokenCache(cache) {
+    try {
+        await mkdirp(CONFIG_DIR);
+        fs.writeFileSync(TOKEN_CACHE_FILE, JSON.stringify(cache, null, 2));
+    } catch (e) {
+        console.error("Error saving token cache:", e.message);
+        throw e;
+    }
+}
+
+export async function clearTokenCache() {
+    try {
+        if (fs.existsSync(TOKEN_CACHE_FILE)) {
+            fs.unlinkSync(TOKEN_CACHE_FILE);
+        }
+    } catch (e) {
+        console.error("Error clearing token cache:", e.message);
+        throw e;
+    }
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "mage-remote-run",
-  "version": "0.1.0",
+  "version": "0.2.5",
   "description": "The remote swiss army knife for Magento Open Source, Mage-OS, Adobe Commerce",
   "main": "index.js",
   "scripts": {
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules --localstorage-file=./.localstorage\" jest",
     "start": "node bin/mage-remote-run.js",
     "release": "release-it"
   },
@@ -16,6 +16,10 @@
   },
   "license": "MIT",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/muench-dev/mage-remote-run"
+  },
   "bin": {
     "mage-remote-run": "./bin/mage-remote-run.js"
   },