@mentra/sdk 2.1.31-beta.6 → 3.0.0-alpha.3

package/node_modules/@mentra/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/types",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "description": "Shared TypeScript types for MentraOS client and cloud",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,7 +17,7 @@
     }
   },
   "scripts": {
-    "build": "rm -rf dist && bun x tsc -p tsconfig.json",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json",
     "dev": "bun x tsc --watch",
     "typecheck": "bun x tsc --noEmit",
     "prepare": "bun run build"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/sdk",
-  "version": "2.1.31-beta.6",
+  "version": "3.0.0-alpha.3",
   "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",
@@ -18,6 +18,18 @@
         "types": "./dist/index.d.ts"
       }
     },
+    "./session": {
+      "development": {
+        "import": "./src/session.ts",
+        "require": "./src/session.ts",
+        "types": "./src/session.ts"
+      },
+      "default": {
+        "import": "./dist/session.js",
+        "require": "./dist/session.js",
+        "types": "./dist/session.d.ts"
+      }
+    },
     "./display-utils": {
       "development": {
         "import": "./src/display-utils.ts",
@@ -32,11 +44,12 @@
     }
   },
   "scripts": {
-    "build": "bun run clean && bun run build:js && bun run build:types",
-    "build:js-only": "bun run clean && bun run build:js",
-    "build:full": "bun run clean && bun run build:js && bun run build:types",
-    "clean": "rm -rf dist",
-    "build:js": "bun build src/index.ts src/display-utils.ts --outdir dist --target node --format esm --sourcemap=external --external @logtail/pino --external axios --external boxen --external chalk --external cookie-parser --external dotenv --external express --external jimp --external jsonwebtoken --external jsrsasign --external multer --external pino --external pino-pretty --external strip-ansi --external ws",
+    "build": "bun run build:js && bun run build:types",
+    "build:js-only": "bun run build:js",
+    "build:full": "bun run build:js && bun run build:types",
+    "build:clean": "bun run clean && bun run build",
+    "clean": "rm -rf dist .dist-tmp",
+    "build:js": "rm -rf .dist-tmp && bun build src/index.ts src/session.ts src/display-utils.ts --outdir .dist-tmp --target node --format esm --sourcemap=external --external @logtail/pino --external axios --external chalk --external dotenv --external hono --external jimp --external jsonwebtoken --external jsrsasign --external lamejs --external pino --external pino-pretty --external strip-ansi --external ws && rm -rf dist && mv .dist-tmp dist",
     "build:types": "bun x tsc --build --force",
     "dev": "echo 'No build needed in dev mode - using source files directly'",
     "prepare": "bun run build",
@@ -46,26 +59,25 @@
     "@logtail/pino": "^0.5.4",
     "@mentra/types": "^1.0.0-beta.1",
     "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",
+    "hono": "^4.11.3",
     "jimp": "^1.6.0",
     "jsonwebtoken": "^8.5.1",
     "jsrsasign": "^11.1.0",
-    "multer": "^2.0.1",
     "pino": "^9.6.0",
-    "pino-pretty": "^13.0.0",
     "strip-ansi": "^7.1.2",
+    "lamejs": "^1.2.1",
     "ws": "^8.18.2"
   },
+  "optionalDependencies": {
+    "pino-pretty": "^13.0.0"
+  },
   "bundledDependencies": [
     "@mentra/types"
   ],
   "devDependencies": {
     "@types/babel__core": "^7.20.5",
-    "@types/express": "^4.17.17",
     "@types/jsonwebtoken": "^9.0.2",
     "@types/jsrsasign": "^10.5.15",
     "@types/node": "^20.0.0",

package/dist/examples/managed-rtmp-streaming-example.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=managed-rtmp-streaming-example.d.ts.map

package/dist/examples/managed-rtmp-streaming-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"managed-rtmp-streaming-example.d.ts","sourceRoot":"","sources":["../../src/examples/managed-rtmp-streaming-example.ts"],"names":[],"mappings":""}

package/dist/examples/managed-rtmp-streaming-with-restream-example.d.ts

@@ -1,11 +0,0 @@
-/**
- * Example: Managed RTMP Streaming with Re-streaming to Multiple Platforms
- *
- * This example demonstrates how to use the managed streaming feature with
- * automatic re-streaming to platforms like YouTube, Twitch, and Facebook.
- *
- * The cloud handles all RTMP endpoints and automatically forwards your stream
- * to the specified destinations.
- */
-export {};
-//# sourceMappingURL=managed-rtmp-streaming-with-restream-example.d.ts.map

package/dist/examples/managed-rtmp-streaming-with-restream-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"managed-rtmp-streaming-with-restream-example.d.ts","sourceRoot":"","sources":["../../src/examples/managed-rtmp-streaming-with-restream-example.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/examples/rtmp-streaming-example.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=rtmp-streaming-example.d.ts.map

package/dist/examples/rtmp-streaming-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rtmp-streaming-example.d.ts","sourceRoot":"","sources":["../../src/examples/rtmp-streaming-example.ts"],"names":[],"mappings":""}

package/node_modules/@mentra/types/src/applet.ts

@@ -1,51 +0,0 @@
-/**
- * @mentra/types - App/Applet types for client interfaces
- */
-
-import {HardwareRequirement} from "./hardware"
-
-/**
- * App execution model types
- */
-export type AppletType = "standard" | "background" | "system_dashboard";
-
-/**
- * Permission types that apps can request
- */
-export type AppPermissionType =
-  | "ALL"
-  | "MICROPHONE"
-  | "CAMERA"
-  | "CALENDAR"
-  | "LOCATION"
-  | "BACKGROUND_LOCATION"
-  | "READ_NOTIFICATIONS"
-  | "POST_NOTIFICATIONS";
-
-/**
- * Permission object with type and description
- */
-export interface AppletPermission {
-  type: AppPermissionType;
-  description?: string;
-  required?: boolean;
-}
-
-/**
- * Minimal app interface for client home screen display
- * Optimized for fast rendering - only essential fields (9 fields)
- *
- * This is the client-facing interface used by mobile apps.
- * Internal cloud services use AppI from models (more fields).
- */
-export interface AppletInterface {
-  packageName: string;
-  name: string;
-  webviewUrl: string;
-  logoUrl: string;
-  type: AppletType;
-  permissions: AppletPermission[];
-  running: boolean;
-  healthy: boolean;
-  hardwareRequirements: HardwareRequirement[];
-}

package/node_modules/@mentra/types/src/capabilities/even-realities-g1.ts

@@ -1,63 +0,0 @@
-/**
- * @fileoverview Even Realities G1 Hardware Capabilities
- *
- * Capability profile for the Even Realities G1 smart glasses model.
- * Defines the hardware and software features available on this device.
- */
-
-import type { Capabilities } from "../hardware";
-
-/**
- * Even Realities G1 capability profile
- */
-export const evenRealitiesG1: Capabilities = {
-  modelName: "Even Realities G1",
-
-  // Camera capabilities - G1 does not have a camera
-  hasCamera: false,
-  camera: null,
-
-  // Display capabilities - G1 has a green monochrome display
-  hasDisplay: true,
-  display: {
-    count: 2,
-    isColor: false,
-    color: "green",
-    canDisplayBitmap: true,
-    resolution: { width: 640, height: 200 },
-    fieldOfView: { horizontal: 25 },
-    maxTextLines: 5,
-    adjustBrightness: true,
-  },
-
-  // Microphone capabilities - G1 has one microphone without VAD
-  hasMicrophone: true,
-  microphone: {
-    count: 1,
-    hasVAD: false,
-  },
-
-  // Speaker capabilities - G1 does not have a speaker
-  hasSpeaker: false,
-  speaker: null,
-
-  // IMU capabilities - G1 has IMU for head-up/down detection but raw data not exposed to apps
-  hasIMU: true,
-  imu: null,
-
-  // Button capabilities - G1 does not have buttons
-  hasButton: false,
-  button: null,
-
-  // Light capabilities - G1 does not have lights
-  hasLight: false,
-  light: null,
-
-  // Power capabilities - G1 does not have external battery
-  power: {
-    hasExternalBattery: false,
-  },
-
-  // WiFi capabilities - G1 does not support WiFi
-  hasWifi: false,
-};

package/node_modules/@mentra/types/src/capabilities/mentra-live.ts

@@ -1,103 +0,0 @@
-/**
- * @fileoverview Mentra Live Hardware Capabilities
- *
- * Capability profile for the Mentra Live smart glasses model.
- * Defines the hardware and software features available on this device.
- */
-
-import type { Capabilities } from "../hardware";
-
-/**
- * Mentra Live capability profile
- */
-export const mentraLive: Capabilities = {
-  modelName: "Mentra Live",
-
-  // Camera capabilities - Mentra Live has camera with streaming
-  hasCamera: true,
-  camera: {
-    resolution: { width: 1920, height: 1080 },
-    hasHDR: false,
-    hasFocus: true,
-    video: {
-      canRecord: true,
-      canStream: true,
-      supportedStreamTypes: ["rtmp"],
-      supportedResolutions: [
-        { width: 1920, height: 1080 },
-        { width: 1280, height: 720 },
-        { width: 640, height: 480 },
-      ],
-    },
-  },
-
-  // Display capabilities - Mentra Live does not have a display
-  hasDisplay: false,
-  display: null,
-
-  // Microphone capabilities - Mentra Live has one microphone with VAD
-  hasMicrophone: true,
-  microphone: {
-    count: 1,
-    hasVAD: true,
-  },
-
-  // Speaker capabilities - Mentra Live has one standard speaker
-  hasSpeaker: true,
-  speaker: {
-    count: 1,
-    isPrivate: false,
-  },
-
-  // IMU capabilities - Mentra Live has 6-axis IMU
-  hasIMU: true,
-  imu: {
-    axisCount: 6,
-    hasAccelerometer: true,
-    hasCompass: false,
-    hasGyroscope: true,
-  },
-
-  // Button capabilities - Mentra Live has one physical button
-  hasButton: true,
-  button: {
-    count: 1,
-    buttons: [
-      {
-        type: "press",
-        events: ["press", "double_press", "long_press"],
-        isCapacitive: false,
-      },
-    ],
-  },
-
-  // Light capabilities - Mentra Live has two lights: privacy light + RGB LED
-  hasLight: true,
-  light: {
-    count: 2,
-    lights: [
-      {
-        id: "privacy",
-        purpose: "privacy",
-        isFullColor: false,
-        color: "white",
-        position: "front_facing",
-      },
-      {
-        id: "user_feedback",
-        purpose: "user_feedback",
-        isFullColor: true,
-        color: "rgb",
-        position: "user_facing",
-      },
-    ],
-  },
-
-  // Power capabilities - Mentra Live does not have external battery
-  power: {
-    hasExternalBattery: false,
-  },
-
-  // WiFi capabilities - Mentra Live supports WiFi
-  hasWifi: true,
-};

package/node_modules/@mentra/types/src/capabilities/simulated-glasses.ts

@@ -1,76 +0,0 @@
-/**
- * @fileoverview Simulated Glasses Hardware Capabilities
- *
- * Capability profile for the Simulated Glasses model.
- * Defines the hardware and software features available on this device.
- * This profile matches the Vuzix Z100 capabilities for testing purposes.
- */
-
-import type { Capabilities } from "../hardware";
-
-/**
- * Simulated Glasses capability profile
- */
-export const simulatedGlasses: Capabilities = {
-  modelName: "Simulated Glasses",
-
-  // Camera capabilities - does not have a camera
-  hasCamera: false,
-  camera: null,
-
-  // Display capabilities - has a green monochrome display
-  hasDisplay: true,
-  display: {
-    count: 1,
-    isColor: false,
-    color: "green",
-    canDisplayBitmap: false,
-    resolution: { width: 640, height: 480 },
-    fieldOfView: { horizontal: 30 },
-    maxTextLines: 7,
-    adjustBrightness: true,
-  },
-
-  // Microphone capabilities - has a microphone (phone mic)
-  hasMicrophone: true,
-  microphone: {
-    count: 1,
-    hasVAD: false,
-  },
-
-  // Speaker capabilities - has a speaker (phone speaker)
-  hasSpeaker: true,
-  speaker: {
-    count: 1,
-    isPrivate: false,
-  },
-
-  // IMU capabilities - does not have an IMU
-  hasIMU: false,
-  imu: null,
-
-  // Button capabilities - Has one simulated button
-  hasButton: true,
-  button: {
-    count: 1,
-    buttons: [
-      {
-        type: "press",
-        events: ["press"],
-        isCapacitive: false,
-      },
-    ],
-  },
-
-  // Light capabilities - does not have lights
-  hasLight: false,
-  light: null,
-
-  // Power capabilities - does not have external battery
-  power: {
-    hasExternalBattery: false,
-  },
-
-  // WiFi capabilities - does not support WiFi
-  hasWifi: false,
-};

package/node_modules/@mentra/types/src/capabilities/vuzix-z100.ts

@@ -1,60 +0,0 @@
-/**
- * @fileoverview Vuzix Z100 Hardware Capabilities
- *
- * Capability profile for the Vuzix Z100 smart glasses model.
- * Defines the hardware and software features available on this device.
- */
-
-import type { Capabilities } from "../hardware";
-
-/**
- * Vuzix Z100 capability profile
- */
-export const vuzixZ100: Capabilities = {
-  modelName: "Vuzix Z100",
-
-  // Camera capabilities - does not have a camera
-  hasCamera: false,
-  camera: null,
-
-  // Display capabilities - has a green monochrome display
-  hasDisplay: true,
-  display: {
-    count: 1,
-    isColor: false,
-    color: "green",
-    canDisplayBitmap: false,
-    resolution: { width: 640, height: 480 },
-    fieldOfView: { horizontal: 30 },
-    maxTextLines: 7,
-    adjustBrightness: true,
-  },
-
-  // Microphone capabilities - does not have a microphone
-  hasMicrophone: false,
-  microphone: null,
-
-  // Speaker capabilities - does not have a speaker
-  hasSpeaker: false,
-  speaker: null,
-
-  // IMU capabilities - does not have an IMU
-  hasIMU: false,
-  imu: null,
-
-  // Button capabilities - does not have buttons
-  hasButton: false,
-  button: null,
-
-  // Light capabilities - does not have lights
-  hasLight: false,
-  light: null,
-
-  // Power capabilities - does not have external battery
-  power: {
-    hasExternalBattery: false,
-  },
-
-  // WiFi capabilities - does not support WiFi
-  hasWifi: false,
-};

package/node_modules/@mentra/types/src/cli.ts

@@ -1,169 +0,0 @@
-/**
- * CLI API Key Management Types
- *
- * Shared between cloud backend and CLI tool.
- */
-
-/**
- * CLI API Key stored in database
- */
-export interface CLIApiKey {
-  /** Unique key identifier (UUID v4) */
-  keyId: string
-
-  /** User ID who owns this key (ObjectId as string) */
-  userId: string
-
-  /** User email (denormalized for backward compatibility) */
-  email: string
-
-  /** User-friendly name for the key */
-  name: string
-
-  /** SHA-256 hash of the JWT token (for revocation checks) */
-  hashedToken: string
-
-  /** When the key was created */
-  createdAt: Date
-
-  /** When the key was last updated */
-  updatedAt: Date
-
-  /** Last time this key was used (optional tracking) */
-  lastUsedAt?: Date
-
-  /** Optional expiration date */
-  expiresAt?: Date
-
-  /** Whether key is active (false = revoked) */
-  isActive: boolean
-
-  /** Optional metadata */
-  metadata?: {
-    createdFrom?: string
-    userAgent?: string
-  }
-}
-
-/**
- * Request to generate a new CLI API key
- */
-export interface GenerateCLIKeyRequest {
-  /** User-friendly name for the key */
-  name: string
-
-  /** Optional expiration in days (default: never) */
-  expiresInDays?: number
-}
-
-/**
- * Response when generating a CLI API key
- * Token is shown ONCE and never retrievable
- */
-export interface GenerateCLIKeyResponse {
-  /** The CLI API key ID */
-  keyId: string
-
-  /** User-friendly name */
-  name: string
-
-  /** JWT token (ONLY shown once!) */
-  token: string
-
-  /** When it was created */
-  createdAt: string
-
-  /** Optional expiration date */
-  expiresAt?: string
-}
-
-/**
- * CLI API Key list item (token not included)
- */
-export interface CLIApiKeyListItem {
-  /** Key identifier */
-  keyId: string
-
-  /** User-friendly name */
-  name: string
-
-  /** Creation timestamp */
-  createdAt: string
-
-  /** Last usage timestamp (if tracked) */
-  lastUsedAt?: string
-
-  /** Expiration timestamp */
-  expiresAt?: string
-
-  /** Whether key is active */
-  isActive: boolean
-}
-
-/**
- * Request to update a CLI API key
- */
-export interface UpdateCLIKeyRequest {
-  /** New name for the key */
-  name: string
-}
-
-/**
- * JWT payload for CLI API keys
- */
-export interface CLITokenPayload {
-  /** User email */
-  email: string
-
-  /** Token type discriminator */
-  type: "cli"
-
-  /** Key ID for revocation lookups */
-  keyId: string
-
-  /** User-friendly key name */
-  name: string
-
-  /** Issued at (Unix timestamp) */
-  iat: number
-
-  /** Optional expiration (Unix timestamp) */
-  exp?: number
-}
-
-/**
- * CLI credentials stored locally on user's machine
- */
-export interface CLICredentials {
-  /** JWT token */
-  token: string
-
-  /** User email (extracted from token) */
-  email: string
-
-  /** Key name (extracted from token) */
-  keyName: string
-
-  /** Key ID (extracted from token) */
-  keyId: string
-
-  /** When credentials were stored */
-  storedAt: string
-
-  /** Optional expiration timestamp */
-  expiresAt?: string
-}
-
-/**
- * Cloud environment configuration
- */
-export interface Cloud {
-  /** Display name */
-  name: string
-
-  /** API URL */
-  url: string
-
-  /** Whether this is a built-in cloud */
-  builtin?: boolean
-}

package/node_modules/@mentra/types/src/device.ts

@@ -1,43 +0,0 @@
-/**
- * Device connection state and metadata types
- * Used for POST /api/client/device/state
- */
-
-export interface GlassesInfo {
-  // Connection state
-  connected: boolean
-
-  // Device identification
-  modelName: string | null
-  androidVersion?: string
-  fwVersion?: string
-  buildNumber?: string
-  otaVersionUrl?: string
-  appVersion?: string
-  bluetoothName?: string
-  serialNumber?: string
-  style?: string
-  color?: string
-
-  // WiFi info (only for WiFi-capable devices)
-  wifiConnected?: boolean
-  wifiSsid?: string
-  wifiLocalIp?: string
-
-  // Battery info
-  batteryLevel?: number
-  charging?: boolean
-  caseBatteryLevel?: number
-  caseCharging?: boolean
-  caseOpen?: boolean
-  caseRemoved?: boolean
-
-  // Hotspot info
-  hotspotEnabled?: boolean
-  hotspotSsid?: string
-  hotspotPassword?: string
-  hotspotGatewayIp?: string
-
-  // Metadata
-  timestamp?: string
-}