@mentra/sdk 1.1.19

package/dist/tpa/webview/index.js

@@ -0,0 +1,344 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTempToken = extractTempToken;
+exports.exchangeToken = exchangeToken;
+exports.createAuthMiddleware = createAuthMiddleware;
+// src/tpa/webview/index.ts
+const axios_1 = __importDefault(require("axios"));
+// Note: Your Express app needs to use cookie-parser middleware for this to work
+// Example: app.use(require('cookie-parser')());
+const crypto = __importStar(require("crypto"));
+const jsrsasign_1 = require("jsrsasign");
+const userTokenPublicKey = process.env.AUGMENTOS_CLOUD_USER_TOKEN_PUBLIC_KEY || "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0Yt2RtNOdeKQxWMY0c84\nADpY1Jy58YWZhaEgP2A5tBwFUKgy/TH9gQLWZjQ3dQ/6XXO8qq0kluoYFqM7ZDRF\nzJ0E4Yi0WQncioLRcCx4q8pDmqY9vPKgv6PruJdFWca0l0s3gZ3BqSeWum/C23xK\nFPHPwi8gvRdc6ALrkcHeciM+7NykU8c0EY8PSitNL+Tchti95kGu+j6APr5vNewi\nzRpQGOdqaLWe+ahHmtj6KtUZjm8o6lan4f/o08C6litizguZXuw2Nn/Kd9fFI1xF\nIVNJYMy9jgGaOi71+LpGw+vIpwAawp/7IvULDppvY3DdX5nt05P1+jvVJXPxMKzD\nTQIDAQAB\n-----END PUBLIC KEY-----";
+/**
+ * Extracts the temporary token from a URL string.
+ * @param url The URL string, typically window.location.href.
+ * @returns The token string or null if not found.
+ */
+function extractTempToken(url) {
+    try {
+        const parsedUrl = new URL(url);
+        return parsedUrl.searchParams.get('aos_temp_token');
+    }
+    catch (e) {
+        console.error("Error parsing URL for temp token:", e);
+        return null;
+    }
+}
+/**
+ * Exchanges a temporary token for a user ID with the AugmentOS Cloud.
+ * This should be called from the TPA's backend server.
+ * @param cloudApiUrl The base URL of the AugmentOS Cloud API.
+ * @param tempToken The temporary token obtained from the webview URL.
+ * @param apiKey Your TPA's secret API key.
+ * @returns A Promise that resolves with an object containing the userId.
+ * @throws Throws an error if the exchange fails (e.g., invalid token, expired, network error).
+ */
+async function exchangeToken(cloudApiUrl, tempToken, apiKey, packageName) {
+    const endpoint = `${cloudApiUrl}/api/auth/exchange-user-token`;
+    console.log(`Exchanging token for user at ${endpoint}`);
+    try {
+        const response = await axios_1.default.post(endpoint, { aos_temp_token: tempToken, packageName: packageName }, {
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            timeout: 10000, // 10 second timeout
+        });
+        if (response.status === 200 && response.data.success && response.data.userId) {
+            return { userId: response.data.userId };
+        }
+        else {
+            // Handle specific error messages from the server if available
+            const errorMessage = response.data?.error || `Failed with status ${response.status}`;
+            throw new Error(errorMessage);
+        }
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            const status = error.response?.status;
+            const data = error.response?.data;
+            const message = data?.error || error.message || 'Unknown error during token exchange';
+            console.error(`Token exchange failed with status ${status}: ${message}`);
+            throw new Error(`Token exchange failed: ${message}`);
+        }
+        else {
+            console.error('Unexpected error during token exchange:', error);
+            throw new Error('An unexpected error occurred during token exchange.');
+        }
+    }
+}
+/**
+ * Signs a user ID to create a secure session token.
+ * @param userId The user ID to sign
+ * @param secret The secret key used for signing
+ * @returns A signed session token string
+ */
+function signSession(userId, secret) {
+    // Format: userId.timestamp.signature
+    const timestamp = Date.now();
+    const data = `${userId}|${timestamp}`;
+    const signature = crypto
+        .createHmac('sha256', secret)
+        .update(data)
+        .digest('hex');
+    return `${data}|${signature}`;
+}
+/**
+ * Verifies and extracts the user ID from a signed session token.
+ * @param token The signed session token
+ * @param secret The secret key used for verification
+ * @param maxAge The maximum age of the token in milliseconds
+ * @returns The extracted user ID if valid, or null if invalid
+ */
+function verifySession(token, secret, maxAge) {
+    try {
+        const parts = token.split('|');
+        if (parts.length !== 3)
+            return null;
+        const [userId, timestampStr, signature] = parts;
+        const timestamp = parseInt(timestampStr, 10);
+        // Check if token has expired
+        if (maxAge && Date.now() - timestamp > maxAge) {
+            console.log(`Session token expired: ${token}.  Parsed date is ${timestamp}, meaning age is ${Date.now() - timestamp}, but maxAge is ${maxAge}`);
+            return null;
+        }
+        // Verify signature
+        const data = `${userId}|${timestamp}`;
+        const expectedSignature = crypto
+            .createHmac('sha256', secret)
+            .update(data)
+            .digest('hex');
+        if (signature !== expectedSignature) {
+            console.log(`Session token signature mismatch: ${signature} !== ${expectedSignature}`);
+            return null;
+        }
+        return userId;
+    }
+    catch (error) {
+        console.error("Session verification failed:", error);
+        return null;
+    }
+}
+/**
+ * Verifies a signed user token and extracts the user ID from it
+ * @param signedUserToken The JWT token to verify
+ * @returns The user ID (subject) from the token, or null if invalid
+ */
+async function verifySignedUserToken(signedUserToken) {
+    try {
+        // 1. Parse the PEM public key into a jsrsasign key object
+        const publicKeyObj = jsrsasign_1.KEYUTIL.getKey(userTokenPublicKey);
+        // 2. Verify JWT signature + claims (issuer, exp, iat) with 2-min tolerance
+        const isValid = jsrsasign_1.KJUR.jws.JWS.verifyJWT(signedUserToken, publicKeyObj, {
+            alg: ["RS256"],
+            iss: ["https://prod.augmentos.cloud"],
+            verifyAt: jsrsasign_1.KJUR.jws.IntDate.get("now"),
+            gracePeriod: 120,
+        });
+        if (!isValid)
+            return null;
+        // 3. Decode payload and return the subject (user ID)
+        const parsed = jsrsasign_1.KJUR.jws.JWS.parse(signedUserToken);
+        return parsed.payloadObj.sub || null;
+    }
+    catch (e) {
+        console.error("[verifySignedUserToken] Error verifying token:", e);
+        return null;
+    }
+}
+/**
+ * Verifies a frontend token by comparing it to a secure hash of the API key
+ * @param frontendToken The token to verify (should be a hash of the API key)
+ * @param apiKey The API key to hash and compare against
+ * @param userId Optional user ID that may be embedded in the token format
+ * @returns The user ID if the token is valid, or null if invalid
+ */
+function verifyFrontendToken(frontendToken, apiKey) {
+    try {
+        // Check if the token contains a user ID and hash separated by a colon
+        const tokenParts = frontendToken.split(':');
+        if (tokenParts.length === 2) {
+            // Format: userId:hash
+            const [tokenUserId, tokenHash] = tokenParts;
+            // Align the hashing algorithm with server-side `hashWithApiKey`
+            // 1. Hash the API key first (server only stores the hashed version)
+            const hashedApiKey = crypto.createHash('sha256').update(apiKey).digest('hex');
+            // 2. Create the expected hash using userId + hashedApiKey (same order & update calls)
+            const expectedHash = crypto.createHash('sha256')
+                .update(tokenUserId)
+                .update(hashedApiKey)
+                .digest('hex');
+            if (tokenHash === expectedHash) {
+                return tokenUserId;
+            }
+        }
+        else {
+            throw new Error("Invalid frontend token format");
+        }
+        return null;
+    }
+    catch (error) {
+        console.error("Frontend token verification failed:", error);
+        return null;
+    }
+}
+function validateCloudApiUrlChecksum(checksum, cloudApiUrl, apiKey) {
+    const hashedApiKey = crypto.createHash('sha256').update(apiKey).digest('hex');
+    const expectedChecksum = crypto.createHash('sha256').update(cloudApiUrl)
+        .update(hashedApiKey)
+        .digest('hex');
+    return expectedChecksum === checksum;
+}
+/**
+ * Express middleware for automatically handling the token exchange.
+ * Assumes API key and Cloud URL are available (e.g., via environment variables).
+ * Adds `req.authUserId` if successful.
+ *
+ * @param options Configuration options.
+ * @param options.cloudApiUrl The base URL of the AugmentOS Cloud API.
+ * @param options.apiKey Your TPA's secret API key.
+ * @param options.tokenQueryParam The name of the query parameter containing the token (default: 'aos_temp_token').
+ * @param options.cookieName The name of the cookie to store the session token (default: 'aos_session').
+ * @param options.cookieSecret Secret key used to sign the session cookie. MUST be provided and kept secure.
+ * @param options.cookieOptions Options for the session cookie (default: { httpOnly: true, secure: process.env.NODE_ENV === 'production' }).
+ */
+function createAuthMiddleware(options) {
+    const { apiKey, packageName, cookieName = 'aos_session', cookieSecret, cookieOptions = {
+        httpOnly: true,
+        secure: process.env.NODE_ENV === 'production',
+        maxAge: 30 * 24 * 60 * 60 * 1000, // 30 days by default
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
+        path: '/'
+    } } = options;
+    if (!apiKey) {
+        throw new Error("API Key are required for the auth middleware.");
+    }
+    if (!cookieSecret || typeof cookieSecret !== 'string' || cookieSecret.length < 8) {
+        throw new Error("A strong cookieSecret (at least 8 characters) is required for secure session management.");
+    }
+    return async (req, res, next) => {
+        // First check for temporary token in the query string
+        const tempToken = req.query['aos_temp_token'];
+        const frontendToken = req.headers.authorization?.replace('Bearer ', '') || req.query['aos_frontend_token'];
+        const signedUserToken = req.query['aos_signed_user_token'];
+        // first check for signed user token
+        if (signedUserToken) {
+            const userId = await verifySignedUserToken(signedUserToken);
+            if (userId) {
+                // Set the user ID on the request
+                req.authUserId = userId;
+                // Create a signed session token and store it in a cookie
+                const signedSession = signSession(userId, cookieSecret);
+                res.cookie(cookieName, signedSession, cookieOptions);
+                console.log('[auth.middleware] User ID verified from signed user token: ', userId);
+                return next();
+            }
+            else {
+                console.log('[auth.middleware] Signed user token invalid');
+            }
+        }
+        // If temporary token exists, authenticate with it
+        if (tempToken) {
+            try {
+                let cloudApiUrl = `https://prod.augmentos.cloud`;
+                const cloudApiUrlFromQuery = req.query['cloudApiUrl'];
+                if (cloudApiUrlFromQuery) {
+                    const cloudApiUrlChecksum = req.query['cloudApiUrlChecksum'];
+                    if (validateCloudApiUrlChecksum(cloudApiUrlChecksum, cloudApiUrlFromQuery, apiKey)) {
+                        console.log(`Cloud API is being routed to alternate url at request of the server: ${cloudApiUrlFromQuery}`);
+                        cloudApiUrl = cloudApiUrlFromQuery;
+                    }
+                    else {
+                        console.error(`Server requested alternate cloud url of ${cloudApiUrlFromQuery} but the checksum is invalid (checksum: ${cloudApiUrlChecksum}).  Using default cloud url of ${cloudApiUrl} instead.`);
+                    }
+                }
+                const { userId } = await exchangeToken(cloudApiUrl, tempToken, apiKey, packageName);
+                // Set the user ID on the request
+                req.authUserId = userId;
+                // Create a signed session token and store it in a cookie
+                const signedSession = signSession(userId, cookieSecret);
+                res.cookie(cookieName, signedSession, cookieOptions);
+                console.log('[auth.middleware] User ID verified from temporary token: ', userId);
+                return next();
+            }
+            catch (error) {
+                console.error("Webview token exchange failed:", error);
+                // Temporary token is invalid
+            }
+        }
+        if (frontendToken) {
+            // Check for user ID in headers if not embedded in token
+            const userId = verifyFrontendToken(frontendToken, apiKey);
+            if (userId) {
+                req.authUserId = userId;
+                // Create a signed session token and store it in a cookie
+                const signedSession = signSession(userId, cookieSecret);
+                res.cookie(cookieName, signedSession, cookieOptions);
+                console.log('[auth.middleware] User ID verified from frontend user token: ', userId);
+                return next();
+            }
+            else {
+                console.log('[auth.middleware] Frontend token invalid');
+            }
+        }
+        // No valid temporary token, check for existing session cookie
+        const sessionCookie = req.cookies?.[cookieName];
+        if (sessionCookie) {
+            try {
+                // Verify the signed session cookie and extract the user ID
+                const userId = verifySession(sessionCookie, cookieSecret, cookieOptions.maxAge);
+                console.log(`User ID verified from session cookie: ${userId}`);
+                if (userId) {
+                    req.authUserId = userId;
+                    return next();
+                }
+                // Invalid or expired session, clear the cookie
+                res.clearCookie(cookieName, { path: cookieOptions.path });
+            }
+            catch (error) {
+                console.error("Invalid session cookie:", error);
+                // Clear the invalid cookie
+                res.clearCookie(cookieName, { path: cookieOptions.path });
+            }
+        }
+        // No valid authentication method found, proceed without setting req.authUserId
+        next();
+    };
+}

package/dist/types/dashboard/index.d.ts

@@ -0,0 +1,128 @@
+import { TpaToCloudMessageType } from '../message-types';
+/**
+ * Dashboard modes supported by the system
+ */
+export declare enum DashboardMode {
+    MAIN = "main",// Full dashboard experience
+    EXPANDED = "expanded"
+}
+/**
+ * Dashboard API for the system dashboard TPA
+ */
+export interface DashboardSystemAPI {
+    /**
+     * Set content for the top left section of the dashboard
+     * @param content Content to display
+     */
+    setTopLeft(content: string): void;
+    /**
+     * Set content for the top right section of the dashboard
+     * @param content Content to display
+     */
+    setTopRight(content: string): void;
+    /**
+     * Set content for the bottom left section of the dashboard
+     * @param content Content to display
+     */
+    setBottomLeft(content: string): void;
+    /**
+     * Set content for the bottom right section of the dashboard
+     * @param content Content to display
+     */
+    setBottomRight(content: string): void;
+    /**
+     * Set the current dashboard mode
+     * @param mode Dashboard mode to set
+     */
+    setViewMode(mode: DashboardMode): void;
+}
+/**
+ * Dashboard API for all TPAs
+ */
+export interface DashboardContentAPI {
+    /**
+     * Write content to dashboard
+     * @param content Content to display
+     * @param targets Optional list of dashboard modes to target
+     */
+    write(content: string, targets?: DashboardMode[]): void;
+    /**
+     * Write content to main dashboard mode
+     * @param content Content to display
+     */
+    writeToMain(content: string): void;
+    /**
+     * Write content to expanded dashboard mode
+     * @param content Text content to display
+     */
+    writeToExpanded(content: string): void;
+    /**
+     * Write content to always-on dashboard mode
+     * @param content Content to display
+     */
+    /**
+     * Get current active dashboard mode
+     * @returns Promise resolving to current mode or 'none'
+     */
+    getCurrentMode(): Promise<DashboardMode | 'none'>;
+    /**
+     * Check if always-on dashboard is enabled
+     * @returns Promise resolving to boolean
+     */
+    /**
+     * Register for mode change notifications
+     * @param callback Function to call when mode changes
+     * @returns Cleanup function to unregister callback
+     */
+    onModeChange(callback: (mode: DashboardMode | 'none') => void): () => void;
+}
+/**
+ * Dashboard API exposed on TpaSession
+ */
+export interface DashboardAPI {
+    /**
+     * System dashboard API (only available for system dashboard TPA)
+     */
+    system?: DashboardSystemAPI;
+    /**
+     * Content API (available to all TPAs)
+     */
+    content: DashboardContentAPI;
+}
+/**
+ * Message to update dashboard content
+ */
+export interface DashboardContentUpdate {
+    type: TpaToCloudMessageType.DASHBOARD_CONTENT_UPDATE;
+    packageName: string;
+    sessionId: string;
+    content: string;
+    modes: DashboardMode[];
+    timestamp: Date;
+}
+/**
+ * Message for dashboard mode change
+ */
+export interface DashboardModeChange {
+    type: TpaToCloudMessageType.DASHBOARD_MODE_CHANGE;
+    packageName: string;
+    sessionId: string;
+    mode: DashboardMode;
+    timestamp: Date;
+}
+/**
+ * Message to update system dashboard content
+ */
+export interface DashboardSystemUpdate {
+    type: TpaToCloudMessageType.DASHBOARD_SYSTEM_UPDATE;
+    packageName: string;
+    sessionId: string;
+    section: 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+    content: string;
+    timestamp: Date;
+}
+/**
+ * Union type of all dashboard message types
+ */
+export type DashboardMessage = DashboardContentUpdate | DashboardModeChange | DashboardSystemUpdate;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/dashboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/dashboard/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS,CAAY,4BAA4B;IACrD,QAAQ,aAAa;CAEtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAExD;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IAGH;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC;IAElD;;;OAGG;IAGH;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAQ5E;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,CAAC,wBAAwB,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,qBAAqB,CAAC,qBAAqB,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,CAAC,uBAAuB,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,sBAAsB,GACtB,mBAAmB,GACnB,qBAAqB,CAAC"}

package/dist/types/dashboard/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardMode = void 0;
+/**
+ * Dashboard modes supported by the system
+ */
+var DashboardMode;
+(function (DashboardMode) {
+    DashboardMode["MAIN"] = "main";
+    DashboardMode["EXPANDED"] = "expanded";
+    // ALWAYS_ON = 'always_on'  // Persistent minimal dashboard
+})(DashboardMode || (exports.DashboardMode = DashboardMode = {}));

package/dist/types/enums.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Types of Third-Party Applications (TPAs)
+ */
+export declare enum TpaType {
+    SYSTEM_DASHBOARD = "system_dashboard",// Special UI placement, system functionality
+    BACKGROUND = "background",// Can temporarily take control of display
+    STANDARD = "standard"
+}
+/**
+ * Application states in the system
+ */
+export declare enum AppState {
+    NOT_INSTALLED = "not_installed",// Initial state
+    INSTALLED = "installed",// Installed but never run
+    BOOTING = "booting",// Starting up
+    RUNNING = "running",// Active and running
+    STOPPED = "stopped",// Manually stopped
+    ERROR = "error"
+}
+/**
+ * Supported languages
+ */
+export declare enum Language {
+    EN = "en",
+    ES = "es",
+    FR = "fr"
+}
+/**
+ * Types of layouts for displaying content
+ */
+export declare enum LayoutType {
+    TEXT_WALL = "text_wall",
+    DOUBLE_TEXT_WALL = "double_text_wall",
+    DASHBOARD_CARD = "dashboard_card",
+    REFERENCE_CARD = "reference_card",
+    BITMAP_VIEW = "bitmap_view"
+}
+/**
+ * Types of views for displaying content
+ */
+export declare enum ViewType {
+    DASHBOARD = "dashboard",// Regular dashboard (main/expanded)
+    ALWAYS_ON = "always_on",// Persistent overlay dashboard
+    MAIN = "main"
+}
+export declare enum AppSettingType {
+    TOGGLE = "toggle",
+    TEXT = "text",
+    SELECT = "select",
+    SLIDER = "slider",
+    GROUP = "group",
+    TEXT_NO_SAVE_BUTTON = "text_no_save_button",
+    SELECT_WITH_SEARCH = "select_with_search",
+    MULTISELECT = "multiselect",
+    TITLE_VALUE = "titleValue"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/types/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,OAAO;IACf,gBAAgB,qBAAqB,CAAG,6CAA6C;IACrF,UAAU,eAAe,CAAe,0CAA0C;IAClF,QAAQ,aAAa;CACxB;AAGD;;GAEG;AACH,oBAAY,QAAQ;IAChB,aAAa,kBAAkB,CAAG,gBAAgB;IAClD,SAAS,cAAc,CAAW,0BAA0B;IAC5D,OAAO,YAAY,CAAe,cAAc;IAChD,OAAO,YAAY,CAAe,qBAAqB;IACvD,OAAO,YAAY,CAAe,mBAAmB;IACrD,KAAK,UAAU;CAClB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAChB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;CAEZ;AAED;;GAEG;AACH,oBAAY,UAAU;IAClB,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;CAC9B;AAED;;GAEG;AACH,oBAAY,QAAQ;IAChB,SAAS,cAAc,CAAI,oCAAoC;IAC/D,SAAS,cAAc,CAAI,+BAA+B;IAC1D,IAAI,SAAS;CAChB;AAGD,oBAAY,cAAc;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,WAAW,eAAe;CAC7B"}

package/dist/types/enums.js

@@ -0,0 +1,72 @@
+"use strict";
+// src/enums.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppSettingType = exports.ViewType = exports.LayoutType = exports.Language = exports.AppState = exports.TpaType = void 0;
+/**
+ * Types of Third-Party Applications (TPAs)
+ */
+var TpaType;
+(function (TpaType) {
+    TpaType["SYSTEM_DASHBOARD"] = "system_dashboard";
+    TpaType["BACKGROUND"] = "background";
+    TpaType["STANDARD"] = "standard"; // Regular TPA (default) only one standard app can run at a time. starting a standard TPA will close any other standard TPA that is running.
+})(TpaType || (exports.TpaType = TpaType = {}));
+// TODO(isaiah): doesn't seem like this is actually used anywhere, remove?
+/**
+ * Application states in the system
+ */
+var AppState;
+(function (AppState) {
+    AppState["NOT_INSTALLED"] = "not_installed";
+    AppState["INSTALLED"] = "installed";
+    AppState["BOOTING"] = "booting";
+    AppState["RUNNING"] = "running";
+    AppState["STOPPED"] = "stopped";
+    AppState["ERROR"] = "error"; // Error state
+})(AppState || (exports.AppState = AppState = {}));
+/**
+ * Supported languages
+ */
+var Language;
+(function (Language) {
+    Language["EN"] = "en";
+    Language["ES"] = "es";
+    Language["FR"] = "fr";
+    // TODO: Add more languages
+})(Language || (exports.Language = Language = {}));
+/**
+ * Types of layouts for displaying content
+ */
+var LayoutType;
+(function (LayoutType) {
+    LayoutType["TEXT_WALL"] = "text_wall";
+    LayoutType["DOUBLE_TEXT_WALL"] = "double_text_wall";
+    LayoutType["DASHBOARD_CARD"] = "dashboard_card";
+    LayoutType["REFERENCE_CARD"] = "reference_card";
+    LayoutType["BITMAP_VIEW"] = "bitmap_view";
+})(LayoutType || (exports.LayoutType = LayoutType = {}));
+/**
+ * Types of views for displaying content
+ */
+var ViewType;
+(function (ViewType) {
+    ViewType["DASHBOARD"] = "dashboard";
+    ViewType["ALWAYS_ON"] = "always_on";
+    ViewType["MAIN"] = "main"; // Regular app content
+})(ViewType || (exports.ViewType = ViewType = {}));
+// Types for AppSettings
+var AppSettingType;
+(function (AppSettingType) {
+    AppSettingType["TOGGLE"] = "toggle";
+    AppSettingType["TEXT"] = "text";
+    AppSettingType["SELECT"] = "select";
+    AppSettingType["SLIDER"] = "slider";
+    AppSettingType["GROUP"] = "group";
+    AppSettingType["TEXT_NO_SAVE_BUTTON"] = "text_no_save_button";
+    AppSettingType["SELECT_WITH_SEARCH"] = "select_with_search";
+    AppSettingType["MULTISELECT"] = "multiselect";
+    AppSettingType["TITLE_VALUE"] = "titleValue";
+})(AppSettingType || (exports.AppSettingType = AppSettingType = {}));
+// | { type: "toggle"; key: string; label: string; defaultValue: boolean }
+// | { type: "text"; key: string; label: string; defaultValue?: string }
+// | { type: "select"; key: string; label: string; options: { label: string; value: string }[]; defaultValue?: string };

package/dist/types/index.d.ts

@@ -0,0 +1,38 @@
+export * from './token';
+export * from './message-types';
+export * from './messages/base';
+export * from './messages/glasses-to-cloud';
+export * from './messages/cloud-to-glasses';
+export * from './messages/tpa-to-cloud';
+export { TpaConnectionAck, TpaConnectionError, AppStopped, SettingsUpdate as TpaSettingsUpdate, // Alias to avoid conflict with cloud-to-glasses SettingsUpdate
+DataStream, CloudToTpaMessage, TranslationData, ToolCall, StandardConnectionError, CustomMessage, AugmentosSettingsUpdate, TranscriptionData, AudioChunk, PermissionError, PermissionErrorDetail, isTpaConnectionAck, isTpaConnectionError, isAppStopped, isSettingsUpdate, isDataStream, isAudioChunk, isDashboardModeChanged, isDashboardAlwaysOnChanged, isPhotoResponse as isPhotoResponseFromCloud, isRtmpStreamStatus as isRtmpStreamStatusFromCloud } from './messages/cloud-to-tpa';
+export * from './streams';
+export * from './layouts';
+export * from './dashboard';
+export * from './rtmp-stream';
+export * from './enums';
+export * from './models';
+export * from './user-session';
+export * from './webhooks';
+export { ButtonPress, HeadPosition, GlassesBatteryUpdate, PhoneBatteryUpdate, GlassesConnectionState, LocationUpdate, CalendarEvent, Vad, PhoneNotification, NotificationDismissed, StartApp, StopApp, ConnectionInit, DashboardState, OpenDashboard, GlassesToCloudMessage, PhotoResponse, RtmpStreamStatus, KeepAliveAck } from './messages/glasses-to-cloud';
+export { ConnectionAck, ConnectionError, AuthError, DisplayEvent, AppStateChange, MicrophoneStateChange, CloudToGlassesMessage, PhotoRequestToGlasses, SettingsUpdate, StartRtmpStream, StopRtmpStream, KeepRtmpStreamAlive } from './messages/cloud-to-glasses';
+export { TpaConnectionInit, TpaSubscriptionUpdate, RtmpStreamRequest, RtmpStreamStopRequest, TpaToCloudMessage, PhotoRequest } from './messages/tpa-to-cloud';
+export { TextWall, DoubleTextWall, DashboardCard, ReferenceCard, Layout, DisplayRequest } from './layouts';
+export { isButtonPress, isHeadPosition, isConnectionInit, isStartApp, isStopApp, isPhotoResponse as isPhotoResponseFromGlasses, isRtmpStreamStatus as isRtmpStreamStatusFromGlasses, isKeepAliveAck } from './messages/glasses-to-cloud';
+export { isConnectionAck, isDisplayEvent, isAppStateChange, isPhotoRequest, isSettingsUpdate as isSettingsUpdateToGlasses, isStartRtmpStream, isStopRtmpStream, isKeepRtmpStreamAlive } from './messages/cloud-to-glasses';
+export { isTpaConnectionInit, isTpaSubscriptionUpdate, isDisplayRequest, isRtmpStreamRequest, isRtmpStreamStopRequest, isPhotoRequest as isPhotoRequestFromTpa } from './messages/tpa-to-cloud';
+export { BaseAppSetting, AppSetting, AppSettings, TpaConfig, validateTpaConfig, ToolSchema, ToolParameterSchema } from './models';
+export { VideoConfig, AudioConfig, StreamConfig, StreamStatusHandler } from './rtmp-stream';
+/**
+ * WebSocket error information
+ */
+export interface WebSocketError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+import { Request } from 'express';
+export interface AuthenticatedRequest extends Request {
+    authUserId?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}