@mentra/sdk 2.1.27 → 2.1.28

package/dist/app/session/modules/simple-storage.js

@@ -1,232 +0,0 @@
-"use strict";
-/**
- * Simple Storage SDK Module for MentraOS Apps
- * Provides localStorage-like API with cloud synchronization
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SimpleStorage = void 0;
-const node_fetch_1 = __importDefault(require("node-fetch"));
-/**
- * Key-value storage with local caching and cloud sync
- * Data is isolated by userId and packageName
- */
-class SimpleStorage {
-    constructor(appSession) {
-        this.storage = null;
-        this.appSession = appSession;
-        this.userId = appSession.userId;
-        this.packageName = appSession.getPackageName();
-        this.baseUrl = this.getBaseUrl();
-    }
-    // Convert WebSocket URL to HTTP for API calls
-    getBaseUrl() {
-        const serverUrl = this.appSession.getServerUrl();
-        if (!serverUrl)
-            return "http://localhost:8002";
-        return serverUrl.replace(/\/app-ws$/, "").replace(/^ws/, "http");
-    }
-    // Generate auth headers for API requests
-    getAuthHeaders() {
-        const apiKey = this.appSession.config?.apiKey || "unknown-api-key";
-        return {
-            Authorization: `Bearer ${this.packageName}:${apiKey}`,
-            "Content-Type": "application/json",
-        };
-    }
-    // Fetch all data from cloud and cache locally
-    async fetchStorageFromCloud() {
-        try {
-            const response = await (0, node_fetch_1.default)(`${this.baseUrl}/api/sdk/simple-storage/${encodeURIComponent(this.userId)}`, {
-                headers: this.getAuthHeaders(),
-            });
-            if (response.ok) {
-                const result = await response.json();
-                if (result.success && result.data) {
-                    this.storage = result.data;
-                }
-                else {
-                    this.storage = {};
-                }
-            }
-            else {
-                console.error("Failed to fetch storage from cloud:", await response.text());
-                this.storage = {};
-            }
-        }
-        catch (error) {
-            console.error("Error fetching storage from cloud:", error);
-            this.storage = {};
-        }
-    }
-    // Get item from cache or cloud
-    async get(key) {
-        try {
-            if (this.storage !== null && this.storage !== undefined) {
-                return this.storage[key];
-            }
-            await this.fetchStorageFromCloud();
-            return this.storage?.[key];
-        }
-        catch (error) {
-            console.error("Error getting item:", error);
-            return undefined;
-        }
-    }
-    // Set item with optimistic update and cloud sync
-    async set(key, value) {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            // Update cache immediately (optimistic update)
-            if (this.storage) {
-                this.storage[key] = value;
-            }
-            // Sync to cloud
-            const response = await (0, node_fetch_1.default)(`${this.baseUrl}/api/sdk/simple-storage/${encodeURIComponent(this.userId)}/${encodeURIComponent(key)}`, {
-                method: "PUT",
-                headers: this.getAuthHeaders(),
-                body: JSON.stringify({ value }),
-            });
-            if (!response.ok) {
-                console.error("Failed to sync item to cloud:", await response.text());
-            }
-        }
-        catch (error) {
-            console.error("Error setting item:", error);
-            throw error;
-        }
-    }
-    // Delete item from cache and cloud
-    async delete(key) {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            // Remove from cache
-            if (this.storage) {
-                delete this.storage[key];
-            }
-            // Sync to cloud
-            const response = await (0, node_fetch_1.default)(`${this.baseUrl}/api/sdk/simple-storage/${encodeURIComponent(this.userId)}/${encodeURIComponent(key)}`, {
-                method: "DELETE",
-                headers: this.getAuthHeaders(),
-            });
-            if (response.ok) {
-                const result = await response.json();
-                return result.success;
-            }
-            else {
-                console.error("Failed to delete item from cloud:", await response.text());
-                return false;
-            }
-        }
-        catch (error) {
-            console.error("Error deleting item:", error);
-            return false;
-        }
-    }
-    // Clear all data from cache and cloud
-    async clear() {
-        try {
-            this.storage = {};
-            const response = await (0, node_fetch_1.default)(`${this.baseUrl}/api/sdk/simple-storage/${encodeURIComponent(this.userId)}`, {
-                method: "DELETE",
-                headers: this.getAuthHeaders(),
-            });
-            if (response.ok) {
-                const result = await response.json();
-                return result.success;
-            }
-            else {
-                console.error("Failed to clear storage from cloud:", await response.text());
-                return false;
-            }
-        }
-        catch (error) {
-            console.error("Error clearing storage:", error);
-            return false;
-        }
-    }
-    // Get all storage keys
-    async keys() {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            return Object.keys(this.storage || {});
-        }
-        catch (error) {
-            console.error("Error getting keys:", error);
-            return [];
-        }
-    }
-    // Get number of stored items
-    async size() {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            return Object.keys(this.storage || {}).length;
-        }
-        catch (error) {
-            console.error("Error getting storage size:", error);
-            return 0;
-        }
-    }
-    // Check if key exists
-    async hasKey(key) {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            return key in (this.storage || {});
-        }
-        catch (error) {
-            console.error("Error checking key:", error);
-            return false;
-        }
-    }
-    // Get copy of all stored data
-    async getAllData() {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            return { ...(this.storage || {}) };
-        }
-        catch (error) {
-            console.error("Error getting all data:", error);
-            return {};
-        }
-    }
-    // Set multiple items at once
-    async setMultiple(data) {
-        try {
-            if (this.storage === null || this.storage === undefined) {
-                await this.fetchStorageFromCloud();
-            }
-            // Update cache
-            if (this.storage) {
-                Object.assign(this.storage, data);
-            }
-            // Bulk upsert to cloud
-            const response = await (0, node_fetch_1.default)(`${this.baseUrl}/api/sdk/simple-storage/${encodeURIComponent(this.userId)}`, {
-                method: "PUT",
-                headers: this.getAuthHeaders(),
-                body: JSON.stringify({ data }),
-            });
-            if (!response.ok) {
-                console.error("Failed to upsert multiple items to cloud:", await response.text());
-            }
-        }
-        catch (error) {
-            console.error("Error setting multiple items:", error);
-            throw error;
-        }
-    }
-}
-exports.SimpleStorage = SimpleStorage;

package/dist/app/session/settings.js

@@ -1,358 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SettingsManager = void 0;
-/**
- * 🔧 Settings Manager Module
- *
- * Manages App settings with automatic synchronization and change notifications.
- * Provides type-safe access to settings with default values.
- */
-const events_1 = __importDefault(require("events"));
-const api_client_1 = require("./api-client");
-const logger_1 = require("../../logging/logger"); // Adjust import path as needed
-/**
- * Internal event names
- */
-var SettingsEvents;
-(function (SettingsEvents) {
-    SettingsEvents["CHANGE"] = "settings:change";
-    SettingsEvents["VALUE_CHANGE"] = "settings:value:";
-})(SettingsEvents || (SettingsEvents = {}));
-/**
- * 🔧 Settings Manager
- *
- * Provides a type-safe interface for accessing and reacting to App settings.
- * Automatically synchronizes with MentraOS Cloud.
- */
-class SettingsManager {
-    /**
-     * Create a new settings manager
-     *
-     * @param initialSettings Initial settings values (if available)
-     * @param packageName Package name for the App
-     * @param wsUrl WebSocket URL (for deriving HTTP API URL)
-     * @param userId User ID (for authenticated requests)
-     * @param subscribeFn Optional function to call to subscribe to streams
-     */
-    constructor(initialSettings = [], packageName, wsUrl, userId, subscribeFn) {
-        // Current settings values
-        this.settings = [];
-        // Event emitter for change notifications
-        this.emitter = new events_1.default();
-        // --- MentraOS settings event system ---
-        this.mentraosSettings = {};
-        this.mentraosEmitter = new events_1.default();
-        this.settings = [...initialSettings];
-        this.subscribeFn = subscribeFn; // Store the subscribe function
-        // Create API client if we have enough information
-        if (packageName) {
-            this.apiClient = new api_client_1.ApiClient(packageName, wsUrl, userId);
-        }
-    }
-    /**
-     * Configure the API client
-     *
-     * @param packageName Package name for the App
-     * @param wsUrl WebSocket URL
-     * @param userId User ID
-     */
-    configureApiClient(packageName, wsUrl, userId) {
-        if (!this.apiClient) {
-            this.apiClient = new api_client_1.ApiClient(packageName, wsUrl, userId);
-        }
-        else {
-            this.apiClient.setWebSocketUrl(wsUrl);
-            this.apiClient.setUserId(userId);
-        }
-    }
-    /**
-     * Update the current settings
-     * This is called internally when settings are loaded or changed
-     *
-     * @param newSettings New settings values
-     * @returns Map of changed settings
-     */
-    updateSettings(newSettings) {
-        const changes = {};
-        // Copy the new settings
-        const updatedSettings = [...newSettings];
-        // Detect changes comparing old and new settings
-        for (const newSetting of updatedSettings) {
-            const oldSetting = this.settings.find((s) => s.key === newSetting.key);
-            // Skip if value hasn't changed
-            if (oldSetting && this.areEqual(oldSetting.value, newSetting.value)) {
-                continue;
-            }
-            // Record change
-            changes[newSetting.key] = {
-                oldValue: oldSetting?.value,
-                newValue: newSetting.value,
-            };
-        }
-        // Check for removed settings
-        for (const oldSetting of this.settings) {
-            const stillExists = updatedSettings.some((s) => s.key === oldSetting.key);
-            if (!stillExists) {
-                changes[oldSetting.key] = {
-                    oldValue: oldSetting.value,
-                    newValue: undefined,
-                };
-            }
-        }
-        // If there are changes, update the settings and emit events
-        if (Object.keys(changes).length > 0) {
-            this.settings = updatedSettings;
-            this.emitChanges(changes);
-        }
-        return changes;
-    }
-    /**
-     * Check if two setting values are equal
-     *
-     * @param a First value
-     * @param b Second value
-     * @returns True if the values are equal
-     */
-    areEqual(a, b) {
-        // Simple equality check - for objects, this won't do a deep equality check
-        // but for most setting values (strings, numbers, booleans) it works
-        return a === b;
-    }
-    /**
-     * Emit change events for updated settings
-     *
-     * @param changes Map of changed settings
-     */
-    emitChanges(changes) {
-        // Emit the general change event
-        this.emitter.emit(SettingsEvents.CHANGE, changes);
-        // Emit individual value change events
-        for (const [key, change] of Object.entries(changes)) {
-            this.emitter.emit(`${SettingsEvents.VALUE_CHANGE}${key}`, change.newValue, change.oldValue);
-        }
-    }
-    /**
-     * 🔄 Listen for changes to any setting
-     *
-     * @param handler Function to call when settings change
-     * @returns Function to remove the listener
-     *
-     * @example
-     * ```typescript
-     * settings.onChange((changes) => {
-     *   console.log('Settings changed:', changes);
-     * });
-     * ```
-     */
-    onChange(handler) {
-        this.emitter.on(SettingsEvents.CHANGE, handler);
-        return () => this.emitter.off(SettingsEvents.CHANGE, handler);
-    }
-    /**
-     * 🔄 Listen for changes to a specific setting
-     *
-     * @param key Setting key to monitor
-     * @param handler Function to call when the setting changes
-     * @returns Function to remove the listener
-     *
-     * @example
-     * ```typescript
-     * settings.onValueChange('transcribe_language', (newValue, oldValue) => {
-     *   console.log(`Language changed from ${oldValue} to ${newValue}`);
-     * });
-     * ```
-     */
-    onValueChange(key, handler) {
-        const eventName = `${SettingsEvents.VALUE_CHANGE}${key}`;
-        this.emitter.on(eventName, handler);
-        return () => this.emitter.off(eventName, handler);
-    }
-    /**
-     * 🔍 Check if a setting exists
-     *
-     * @param key Setting key to check
-     * @returns True if the setting exists
-     */
-    has(key) {
-        return this.settings.some((s) => s.key === key);
-    }
-    /**
-     * 🔍 Get all settings
-     *
-     * @returns Copy of all settings
-     */
-    getAll() {
-        return [...this.settings];
-    }
-    /**
-     * 🔍 Get a setting value with type safety
-     *
-     * @param key Setting key to get
-     * @param defaultValue Default value if setting doesn't exist or is undefined
-     * @returns Setting value or default value
-     *
-     * @example
-     * ```typescript
-     * const lineWidth = settings.get<number>('line_width', 30);
-     * const language = settings.get<string>('transcribe_language', 'English');
-     * ```
-     */
-    get(key, defaultValue) {
-        const setting = this.settings.find((s) => s.key === key);
-        if (setting && setting.value !== undefined) {
-            return setting.value;
-        }
-        return defaultValue;
-    }
-    /**
-     * 🎛️ Get an MentraOS system setting value with optional default
-     *
-     * @param key MentraOS setting key (e.g., 'metricSystemEnabled', 'brightness')
-     * @param defaultValue Default value to return if the setting is not found
-     * @returns The setting value or the default value
-     *
-     * @example
-     * ```typescript
-     * const isMetric = settings.getMentraOS<boolean>('metricSystemEnabled', false);
-     * const brightness = settings.getMentraOS<number>('brightness', 50);
-     * ```
-     */
-    getMentraOS(key, defaultValue) {
-        const value = this.mentraosSettings[key];
-        if (value !== undefined) {
-            return value;
-        }
-        return defaultValue;
-    }
-    /**
-     * 🔍 Find a setting by key
-     *
-     * @param key Setting key to find
-     * @returns Setting object or undefined
-     */
-    getSetting(key) {
-        return this.settings.find((s) => s.key === key);
-    }
-    /**
-     * 🔄 Fetch settings from the cloud
-     * This is generally not needed since settings are automatically kept in sync,
-     * but can be used to force a refresh if needed.
-     *
-     * @returns Promise that resolves to the updated settings
-     * @throws Error if the API client is not configured or the request fails
-     */
-    async fetch() {
-        if (!this.apiClient) {
-            throw new Error("Settings API client is not configured");
-        }
-        try {
-            const newSettings = await this.apiClient.fetchSettings();
-            this.updateSettings(newSettings);
-            return this.settings;
-        }
-        catch (error) {
-            console.error("Error fetching settings:", error);
-            throw error;
-        }
-    }
-    /**
-     * 🎛️ Listen for changes to a specific MentraOS setting (e.g., metricSystemEnabled)
-     *
-     * @param key The mentraosSettings key to listen for (e.g., 'metricSystemEnabled')
-     * @param handler Function to call when the value changes
-     * @returns Function to remove the listener
-     *
-     * @example
-     * ```typescript
-     * settings.onMentraosChange('metricSystemEnabled', (isMetric, wasMetric) => {
-     *   console.log(`Units changed: ${wasMetric ? 'metric' : 'imperial'} → ${isMetric ? 'metric' : 'imperial'}`);
-     * });
-     * ```
-     */
-    onMentraosChange(key, handler) {
-        return this.onMentraosSettingChange(key, handler);
-    }
-    /**
-     * Listen for changes to a specific MentraOS setting (e.g., metricSystemEnabled)
-     * This is a convenience wrapper for onValueChange for well-known mentraosSettings keys.
-     * @param key The mentraosSettings key to listen for (e.g., 'metricSystemEnabled')
-     * @param handler Function to call when the value changes
-     * @returns Function to remove the listener
-     * @deprecated Use onMentraosChange instead
-     */
-    onMentraosSettingsChange(key, handler) {
-        return this.onMentraosSettingChange(key, handler);
-    }
-    /**
-     * Update the current MentraOS settings
-     * Compares new and old values, emits per-key events, and updates stored values.
-     * @param newSettings The new MentraOS settings object
-     */
-    updateMentraosSettings(newSettings) {
-        const oldSettings = this.mentraosSettings;
-        logger_1.logger.debug({ newSettings }, `[SettingsManager] Updating MentraOS settings. New settings`);
-        for (const key of Object.keys(newSettings)) {
-            const oldValue = oldSettings[key];
-            const newValue = newSettings[key];
-            if (oldValue !== newValue) {
-                logger_1.logger.info(`[SettingsManager] MentraOS setting '${key}' changed: ${oldValue} -> ${newValue}. Emitting event.`);
-                this.mentraosEmitter.emit(`augmentos:value:${key}`, newValue, oldValue);
-            }
-        }
-        // Also handle keys that might have been removed from newSettings but existed in oldSettings
-        for (const key of Object.keys(oldSettings)) {
-            if (!(key in newSettings)) {
-                logger_1.logger.info(`[SettingsManager] MentraOS setting '${key}' removed. Old value: ${oldSettings[key]}. Emitting event with undefined newValue.`);
-                this.mentraosEmitter.emit(`augmentos:value:${key}`, undefined, oldSettings[key]);
-            }
-        }
-        this.mentraosSettings = { ...newSettings };
-        logger_1.logger.debug({ mentraosSettings: this.mentraosSettings }, `[SettingsManager] Finished updating MentraOS settings. Current state:`);
-    }
-    /**
-     * Subscribe to changes for a specific MentraOS setting (e.g., 'metricSystemEnabled')
-     * @param key The MentraOS setting key to listen for
-     * @param handler Function to call when the value changes (newValue, oldValue)
-     * @returns Function to remove the listener
-     */
-    onMentraosSettingChange(key, handler) {
-        const eventName = `augmentos:value:${key}`;
-        logger_1.logger.info(`[SettingsManager] Registering handler for MentraOS setting '${key}' on event '${eventName}'.`);
-        this.mentraosEmitter.on(eventName, (...args) => {
-            logger_1.logger.info({ args }, `[SettingsManager] MentraOS setting '${key}' event fired. Args:`);
-            handler(...args);
-        });
-        if (this.subscribeFn) {
-            const subscriptionKey = `augmentos:${key}`;
-            logger_1.logger.info(`[SettingsManager] Calling subscribeFn for stream '${subscriptionKey}'.`);
-            this.subscribeFn([subscriptionKey])
-                .then(() => {
-                logger_1.logger.info(`[SettingsManager] subscribeFn resolved for stream '${subscriptionKey}'.`);
-            })
-                .catch((err) => {
-                logger_1.logger.error(`[SettingsManager] subscribeFn failed for stream '${subscriptionKey}':`, err);
-            });
-        }
-        else {
-            logger_1.logger.warn(`[SettingsManager] 'subscribeFn' not provided. Cannot auto-subscribe for MentraOS setting '${key}'. Manual App subscription might be required.`);
-        }
-        return () => {
-            logger_1.logger.info(`[SettingsManager] Unregistering handler for MentraOS setting '${key}' from event '${eventName}'.`);
-            this.mentraosEmitter.off(eventName, handler);
-        };
-    }
-    /**
-     * Get the current value of an MentraOS setting
-     */
-    getMentraosSetting(key, defaultValue) {
-        console.log(`[SettingsManager] Getting MentraOS setting '${key}' with settings:`, this.mentraosSettings);
-        if (key in this.mentraosSettings) {
-            return this.mentraosSettings[key];
-        }
-        return defaultValue;
-    }
-}
-exports.SettingsManager = SettingsManager;

package/dist/app/token/index.js

@@ -1,22 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * 🔐 App Token Module
- *
- * Provides utilities for working with App tokens.
- */
-__exportStar(require("./utils"), exports);