@mentra/sdk 2.1.24 → 2.1.27

package/dist/types/webhooks.d.ts

@@ -5,13 +5,7 @@ export declare enum WebhookRequestType {
     /** Request to start a App session */
     SESSION_REQUEST = "session_request",
     /** Request to stop a App session */
-    STOP_REQUEST = "stop_request",
-    /** Server registration confirmation */
-    SERVER_REGISTRATION = "server_registration",
-    /** Server heartbeat response */
-    SERVER_HEARTBEAT = "server_heartbeat",
-    /** Session recovery request */
-    SESSION_RECOVERY = "session_recovery"
+    STOP_REQUEST = "stop_request"
 }
 /**
  * Base interface for all webhook requests
@@ -43,46 +37,17 @@ export interface SessionWebhookRequest extends BaseWebhookRequest {
  */
 export interface StopWebhookRequest extends BaseWebhookRequest {
     type: WebhookRequestType.STOP_REQUEST;
-    reason: 'user_disabled' | 'system_stop' | 'error';
-}
-/**
- * Server registration webhook
- *
- * Sent to a App when its server registration is confirmed
- */
-export interface ServerRegistrationWebhookRequest extends BaseWebhookRequest {
-    type: WebhookRequestType.SERVER_REGISTRATION;
-    registrationId: string;
-    packageName: string;
-    serverUrls: string[];
-}
-/**
- * Session recovery webhook
- *
- * Sent to a App when the system is trying to recover a session after server restart
- */
-export interface SessionRecoveryWebhookRequest extends BaseWebhookRequest {
-    type: WebhookRequestType.SESSION_RECOVERY;
-    mentraOSWebsocketUrl: string;
-}
-/**
- * Server heartbeat webhook
- *
- * Sent to a App to check its health status
- */
-export interface ServerHeartbeatWebhookRequest extends BaseWebhookRequest {
-    type: WebhookRequestType.SERVER_HEARTBEAT;
-    registrationId: string;
+    reason: "user_disabled" | "system_stop" | "error";
 }
 /**
  * Union type for all webhook requests
  */
-export type WebhookRequest = SessionWebhookRequest | StopWebhookRequest | ServerRegistrationWebhookRequest | SessionRecoveryWebhookRequest | ServerHeartbeatWebhookRequest;
+export type WebhookRequest = SessionWebhookRequest | StopWebhookRequest;
 /**
  * Response to a webhook request
  */
 export interface WebhookResponse {
-    status: 'success' | 'error';
+    status: "success" | "error";
     message?: string;
 }
 /**
@@ -93,16 +58,4 @@ export declare function isSessionWebhookRequest(request: WebhookRequest): reques
  * Type guard to check if a webhook request is a stop request
  */
 export declare function isStopWebhookRequest(request: WebhookRequest): request is StopWebhookRequest;
-/**
- * Type guard to check if a webhook request is a server registration request
- */
-export declare function isServerRegistrationWebhookRequest(request: WebhookRequest): request is ServerRegistrationWebhookRequest;
-/**
- * Type guard to check if a webhook request is a session recovery request
- */
-export declare function isSessionRecoveryWebhookRequest(request: WebhookRequest): request is SessionRecoveryWebhookRequest;
-/**
- * Type guard to check if a webhook request is a server heartbeat request
- */
-export declare function isServerHeartbeatWebhookRequest(request: WebhookRequest): request is ServerHeartbeatWebhookRequest;
 //# sourceMappingURL=webhooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/types/webhooks.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,qCAAqC;IACrC,eAAe,oBAAoB;IAEnC,oCAAoC;IACpC,YAAY,iBAAiB;IAE7B,uCAAuC;IACvC,mBAAmB,wBAAwB;IAE3C,gCAAgC;IAChC,gBAAgB,qBAAqB;IAErC,+BAA+B;IAC/B,gBAAgB,qBAAqB;CACtC;AAEC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IAEzB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,kBAAkB,CAAC,eAAe,CAAC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAEhC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,IAAI,EAAE,kBAAkB,CAAC,YAAY,CAAC;IACtC,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAiC,SAAQ,kBAAkB;IAC1E,IAAI,EAAE,kBAAkB,CAAC,mBAAmB,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACvE,IAAI,EAAE,kBAAkB,CAAC,gBAAgB,CAAC;IAC1C,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACvE,IAAI,EAAE,kBAAkB,CAAC,gBAAgB,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,gCAAgC,GAChC,6BAA6B,GAC7B,6BAA6B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,qBAAqB,CAEjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,kBAAkB,CAE3F;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,gCAAgC,CAE7C;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,6BAA6B,CAE1C;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,6BAA6B,CAE1C"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/types/webhooks.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,qCAAqC;IACrC,eAAe,oBAAoB;IAEnC,oCAAoC;IACpC,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IAEzB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,kBAAkB,CAAC,eAAe,CAAC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,IAAI,EAAE,kBAAkB,CAAC,YAAY,CAAC;IACtC,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,qBAAqB,CAElC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,kBAAkB,CAE/B"}

package/dist/types/webhooks.js

@@ -4,9 +4,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookRequestType = void 0;
 exports.isSessionWebhookRequest = isSessionWebhookRequest;
 exports.isStopWebhookRequest = isStopWebhookRequest;
-exports.isServerRegistrationWebhookRequest = isServerRegistrationWebhookRequest;
-exports.isSessionRecoveryWebhookRequest = isSessionRecoveryWebhookRequest;
-exports.isServerHeartbeatWebhookRequest = isServerHeartbeatWebhookRequest;
 /**
  * Types of webhook requests that can be sent to Apps
  */
@@ -16,12 +13,6 @@ var WebhookRequestType;
     WebhookRequestType["SESSION_REQUEST"] = "session_request";
     /** Request to stop a App session */
     WebhookRequestType["STOP_REQUEST"] = "stop_request";
-    /** Server registration confirmation */
-    WebhookRequestType["SERVER_REGISTRATION"] = "server_registration";
-    /** Server heartbeat response */
-    WebhookRequestType["SERVER_HEARTBEAT"] = "server_heartbeat";
-    /** Session recovery request */
-    WebhookRequestType["SESSION_RECOVERY"] = "session_recovery";
 })(WebhookRequestType || (exports.WebhookRequestType = WebhookRequestType = {}));
 /**
  * Type guard to check if a webhook request is a session request
@@ -35,21 +26,3 @@ function isSessionWebhookRequest(request) {
 function isStopWebhookRequest(request) {
     return request.type === WebhookRequestType.STOP_REQUEST;
 }
-/**
- * Type guard to check if a webhook request is a server registration request
- */
-function isServerRegistrationWebhookRequest(request) {
-    return request.type === WebhookRequestType.SERVER_REGISTRATION;
-}
-/**
- * Type guard to check if a webhook request is a session recovery request
- */
-function isSessionRecoveryWebhookRequest(request) {
-    return request.type === WebhookRequestType.SESSION_RECOVERY;
-}
-/**
- * Type guard to check if a webhook request is a server heartbeat request
- */
-function isServerHeartbeatWebhookRequest(request) {
-    return request.type === WebhookRequestType.SERVER_HEARTBEAT;
-}

package/dist/utils/permissions-utils.d.ts

@@ -0,0 +1,8 @@
+export declare const microPhoneWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+export declare const locationWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+export declare const backgroundLocationWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+export declare const calendarWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+export declare const readNotificationWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+export declare const postNotificationWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+export declare const cameraWarnLog: (cloudServerUrl: string, packageName: string, funcName?: string) => void;
+//# sourceMappingURL=permissions-utils.d.ts.map

package/dist/utils/permissions-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions-utils.d.ts","sourceRoot":"","sources":["../../src/utils/permissions-utils.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,iBAAiB,GAC5B,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SA2ClB,CAAC;AAGF,eAAO,MAAM,eAAe,GAC1B,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SAyClB,CAAC;AAGF,eAAO,MAAM,yBAAyB,GACpC,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SAyClB,CAAC;AAGF,eAAO,MAAM,eAAe,GAC1B,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SAyClB,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SAyClB,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SAyClB,CAAC;AAGF,eAAO,MAAM,aAAa,GACxB,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,WAAW,MAAM,SAyClB,CAAC"}

package/dist/utils/permissions-utils.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cameraWarnLog = exports.postNotificationWarnLog = exports.readNotificationWarnLog = exports.calendarWarnLog = exports.backgroundLocationWarnLog = exports.locationWarnLog = exports.microPhoneWarnLog = void 0;
+/**
+ * permissions-utils.ts
+ *
+ * This file provides runtime permission validation utilities for the MentraOS SDK.
+ *
+ * Each function queries the public permissions API endpoint to check if an app
+ * has declared the required permission for a specific feature. If the permission
+ * is missing, a styled warning message is displayed in the terminal.
+ *
+ * Key features:
+ * - Fetches app permissions from /api/public/permissions/:packageName
+ * - Gracefully handles offline/unreachable endpoints (silent failure)
+ * - Displays professional bordered warnings when permissions are missing
+ * - Non-blocking - allows app execution to continue even if checks fail
+ *
+ * These functions are called automatically by SDK methods that require specific
+ * permissions (e.g., microphone access, location tracking, camera, etc.) to help
+ * developers identify missing permission declarations during development.
+ */
+const warning_1 = require("../constants/log-messages/warning");
+// Check if app has microphone permission, warn if missing
+const microPhoneWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    // console.log(`Fetching permissions from: ${permissionsUrl}`);
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasMic = data.permissions.some((p) => p.type === "MICROPHONE");
+            if (!hasMic) {
+                console.log((0, warning_1.noMicrophoneWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        // Silently fail if endpoint is unreachable - don't block execution
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.microPhoneWarnLog = microPhoneWarnLog;
+// Check if app has location permission, warn if missing
+const locationWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasLocation = data.permissions.some((p) => p.type === "LOCATION");
+            if (!hasLocation) {
+                console.log((0, warning_1.locationWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.locationWarnLog = locationWarnLog;
+// Check if app has background location permission, warn if missing
+const backgroundLocationWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasBackgroundLocation = data.permissions.some((p) => p.type === "BACKGROUND_LOCATION");
+            if (!hasBackgroundLocation) {
+                console.log((0, warning_1.baackgroundLocationWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.backgroundLocationWarnLog = backgroundLocationWarnLog;
+// Check if app has calendar permission, warn if missing
+const calendarWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasCalendar = data.permissions.some((p) => p.type === "CALENDAR");
+            if (!hasCalendar) {
+                console.log((0, warning_1.calendarWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.calendarWarnLog = calendarWarnLog;
+// Check if app has read notifications permission, warn if missing
+const readNotificationWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasReadNotifications = data.permissions.some((p) => p.type === "READ_NOTIFICATIONS");
+            if (!hasReadNotifications) {
+                console.log((0, warning_1.readNotficationWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.readNotificationWarnLog = readNotificationWarnLog;
+// Check if app has post notifications permission, warn if missing
+const postNotificationWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasPostNotifications = data.permissions.some((p) => p.type === "POST_NOTIFICATIONS");
+            if (!hasPostNotifications) {
+                console.log((0, warning_1.postNotficationWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.postNotificationWarnLog = postNotificationWarnLog;
+// Check if app has camera permission, warn if missing
+const cameraWarnLog = (cloudServerUrl, packageName, funcName) => {
+    if (!cloudServerUrl)
+        return;
+    const permissionsUrl = `${cloudServerUrl}/api/public/permissions/${encodeURIComponent(packageName)}`;
+    fetch(permissionsUrl)
+        .then(async (res) => {
+        const contentType = res.headers.get("content-type");
+        if (!res.ok) {
+            console.warn(`Permission API returned ${res.status}: ${res.statusText}`);
+            return null;
+        }
+        if (contentType && contentType.includes("application/json")) {
+            return (await res.json());
+        }
+        else {
+            const text = await res.text();
+            console.warn(`Permission API returned non-JSON response: ${text}`);
+            return null;
+        }
+    })
+        .then((data) => {
+        if (data) {
+            const hasCamera = data.permissions.some((p) => p.type === "CAMERA");
+            if (!hasCamera) {
+                console.log((0, warning_1.cameraWarn)(funcName, packageName));
+            }
+        }
+    })
+        .catch((err) => {
+        console.debug("Permission check skipped - endpoint unreachable:", err.message);
+    });
+};
+exports.cameraWarnLog = cameraWarnLog;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/sdk",
-  "version": "2.1.24",
+  "version": "2.1.27",
   "description": "Build apps for MentraOS smartglasses. This SDK provides everything you need to create real-time smartglasses applications.",
   "source": "src/index.ts",
   "main": "dist/index.js",
@@ -29,6 +29,8 @@
   "dependencies": {
     "@logtail/pino": "^0.5.4",
     "axios": "^1.8.1",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
     "cookie-parser": "^1.4.7",
     "dotenv": "^16.4.0",
     "express": "^4.18.2",
@@ -38,6 +40,7 @@
     "multer": "^2.0.1",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0",
+    "strip-ansi": "^7.1.2",
     "ws": "^8.18.2"
   },
   "devDependencies": {

package/dist/constants/messages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/constants/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,aAAa,GAAI,aAAa,MAAM,KAAG,MAcnD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,MAoBlD,CAAC"}

package/dist/constants/messages.js

@@ -1,57 +0,0 @@
-"use strict";
-/**
- * messages.ts
- *
- * This file defines constant messages that should be displayed
- * in the terminal to notify developers about new SDK releases.
- *
- * Each function generates a stylized ASCII message (banner-style)
- * that highlights the latest SDK version and provides the npm install command.
- * https://patorjk.com/software/taag/
- *
- * These messages are intended to be logged to the console or shown in
- * terminal output so developers are aware of updates in a clear
- * and visually distinct way.
- *
- *
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.newSDKUpdate = exports.newSDKUpdate2 = void 0;
-const newSDKUpdate2 = (versionNumb) => {
-    return `
-          ___     
-         /__/:\\        ┬╔╗╔╔═╗╦ ╦  ╦ ╦╔═╗╔╦╗╔═╗╔╦╗╔═╗┬
-        |  |:: \\       │║║║║╣ ║║║  ║ ║╠═╝ ║║╠═╣ ║ ║╣ │
-        |  |:|: \\      o╝╚╝╚═╝╚╩╝  ╚═╝╩  ═╩╝╩ ╩ ╩ ╚═╝o  
-      __|__|:|\\:\\     -------------------------------
-     /__/::::| \\:\\    SDK VERSION V${versionNumb} is out!
-     \\  \\:\\~~\\_\\   -------------------------------
-      \\  \\:\\         npm install @mentra/sdk@latest
-       \\  \\:\\        
-        \\  \\:\\    
-         \\__\\/    
-  `;
-};
-exports.newSDKUpdate2 = newSDKUpdate2;
-const newSDKUpdate = (versionNumb) => {
-    return `
-
- /$$      /$$ /$$$$$$$$ /$$   /$$ /$$$$$$$$ /$$$$$$$   /$$$$$$ 
-| $$$    /$$$| $$_____/| $$$ | $$|__  $$__/| $$__  $$ /$$__  $$
-| $$$$  /$$$$| $$      | $$$$| $$   | $$   | $$  \ $$|  $$  \  $$
-| $$ $$/$$ $$| $$$$$   | $$ $$ $$   | $$   | $$$$$$$/| $$$$$$$$
-| $$  $$$| $$| $$__/   | $$  $$$$   | $$   | $$__  $$| $$__  $$
-| $$\  $  | $$| $$      | $$\   $$$   | $$   | $$   \ $$| $$  | $$
-| $$ \/   | $$| $$$$$$$$| $$ \   $$   | $$   | $$  | $$| $$  | $$
-|__/     |__/|________/|__/   \__/   |__/   |__/  |__/|__/  |__/
-                                                               
-┬╔╗╔╔═╗╦ ╦  ╦ ╦╔═╗╔╦╗╔═╗╔╦╗╔═╗┬
-│║║║║╣ ║║║  ║ ║╠═╝ ║║╠═╣ ║ ║╣ │                                                               
-o╝╚╝╚═╝╚╩╝  ╚═╝╩  ═╩╝╩ ╩ ╩ ╚═╝o 
-------------------------------- 
-SDK VERSION V${versionNumb} is out!     
-------------------------------- 
-bun install @mentra/sdk@latest   
-  `;
-};
-exports.newSDKUpdate = newSDKUpdate;

package/dist/types/user-session.d.ts

@@ -1,73 +0,0 @@
-import { WebSocket } from "ws";
-import { AppI, TranscriptI } from "./models";
-import { DisplayRequest } from "./layouts";
-import { Transform } from "stream";
-import { ConversationTranscriber, PushAudioInputStream } from "microsoft-cognitiveservices-speech-sdk";
-import { ExtendedStreamType } from "./streams";
-import pino from "pino";
-/**
- * Session for an application
- */
-/**
- * Audio processor configuration
- */
-export interface AudioProcessorConfig {
-    threshold: number;
-    ratio: number;
-    attack: number;
-    release: number;
-    gainDb: number;
-    sampleRate: number;
-    channels: number;
-}
-/**
- * Audio processor interface
- */
-export interface AudioProcessorI extends Transform {
-}
-/**
- * The display manager interface
- */
-export interface DisplayManagerI {
-    handleDisplayEvent(displayRequest: DisplayRequest, userSession: UserSession): boolean;
-    handleAppStart(packageName: string, userSession: UserSession): void;
-    handleAppStop(packageName: string, userSession: UserSession): void;
-}
-/**
- * Currently active display
- */
-export interface ActiveDisplay {
-    displayRequest: DisplayRequest;
-    startedAt: Date;
-    expiresAt?: Date;
-}
-/**
- * User session with glasses client
- */
-export interface UserSession {
-    sessionId: string;
-    userId: string;
-    startTime: Date;
-    disconnectedAt: Date | null;
-    logger: pino.Logger;
-    installedApps: AppI[];
-    activeAppSessions: string[];
-    loadingApps: Set<string>;
-    appSubscriptions: Map<string, ExtendedStreamType[]> | object;
-    appConnections: Map<string, WebSocket>;
-    websocket: WebSocket;
-    transcript: TranscriptI;
-    pushStream?: PushAudioInputStream;
-    recognizer?: ConversationTranscriber;
-    isTranscribing: boolean;
-    lastAudioTimestamp?: number;
-    isGracefullyClosing?: boolean;
-    bufferedAudio: ArrayBufferLike[];
-    audioProcessor?: AudioProcessorI;
-    isAudioProcessing?: boolean;
-    whatToStream: ExtendedStreamType[];
-}
-/**
- * App session within a user session
- */
-//# sourceMappingURL=user-session.d.ts.map

package/dist/types/user-session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-session.d.ts","sourceRoot":"","sources":["../../src/types/user-session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAU,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAc,MAAM,WAAW,CAAC;AAE3D,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AAkBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;CAAG;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAChB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IACX,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACpE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAG5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAGpB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7D,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEvC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,WAAW,CAAC;IAGxB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAG9B,aAAa,EAAE,eAAe,EAAE,CAAC;IAGjC,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED;;GAEG"}

package/dist/types/user-session.js

@@ -1,17 +0,0 @@
-"use strict";
-// src/sessions.ts - Session-related interfaces
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * App session within a user session
- */
-// This is not actually used anywhere so i commented it out.
-// export interface AppSession {
-//   packageName: string;
-//   userId: string;
-//   subscriptions: StreamType[];
-//   settings: AppSettings;
-//   websocket?: WebSocket;
-//   state: AppState;
-//   startTime: Date;
-//   lastActiveTime: Date;
-// }