@mentra/cloud-client 3.2.1-dev.311 → 3.3.0-dev.316

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/cloud-client",
-  "version": "3.2.1-dev.311",
+  "version": "3.3.0-dev.316",
   "type": "module",
   "main": "./src/index.ts",
   "exports": {
@@ -12,7 +12,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@mentra/cloud-protocol": "3.2.1-dev.311",
+    "@mentra/cloud-protocol": "3.3.0-dev.316",
     "tweetnacl": "^1.0.3"
   },
   "devDependencies": {

package/src/client.ts

@@ -33,6 +33,7 @@ import {RuntimeEmitter} from "./modules/runtime/emitter"
 import {Subscriptions} from "./modules/runtime/subscriptions"
 import {Camera} from "./modules/runtime/camera"
 import {Maps} from "./modules/runtime/maps"
+import {Meetings} from "./modules/runtime/meetings"
 import {Tts} from "./modules/runtime/tts"
 import {UdpAudio} from "./modules/runtime/audio-udp"
 import {Core} from "./modules/core/core"
@@ -247,6 +248,7 @@ export class CloudClient {
       camera,
       tts,
       maps,
+      meetings: new Meetings(runtimeHttp),
       audio,
       timers,
       logger,

package/src/index.ts

@@ -16,6 +16,7 @@
 
 // The top-level object. Implemented in ./client by the client agent; re-exported
 // here so the public import is `@mentra/cloud-client`, not a deep path.
+export type { AcsMeetingCredential } from "./modules/runtime/meetings";
 export { CloudClient } from "./client";
 export { DEFAULT_REFRESH_TOKEN_KEY } from "./modules/auth/token-store";
 

package/src/modules/runtime/meetings.ts

@@ -0,0 +1,34 @@
+import type {HttpClient} from "../../http"
+
+/** Host-only credentials. Never forward this object to a miniapp. */
+export interface AcsMeetingCredential {
+  token: string
+  expiresOn: string
+  identityMode: "guest" | "teams-user"
+  acsUserId?: string
+  guestReason?: "teams-license-unavailable"
+}
+
+export class Meetings {
+  constructor(private readonly http: HttpClient) {}
+
+  async getAcsCredential(teamsUserAadToken?: string): Promise<AcsMeetingCredential> {
+    const value = await this.http.post<AcsMeetingCredential>(
+      "/api/meetings/acs/token",
+      teamsUserAadToken ? {teamsUserAadToken} : {},
+    )
+    if (
+      !value ||
+      typeof value.token !== "string" ||
+      !value.token ||
+      !Number.isFinite(Date.parse(value.expiresOn)) ||
+      Date.parse(value.expiresOn) <= Date.now() ||
+      (value.identityMode !== "guest" && value.identityMode !== "teams-user") ||
+      (value.identityMode === "guest" && (typeof value.acsUserId !== "string" || !value.acsUserId)) ||
+      (teamsUserAadToken && value.identityMode === "guest" && value.guestReason !== "teams-license-unavailable") ||
+      (!teamsUserAadToken && value.identityMode !== "guest")
+    )
+      throw new Error("Runtime returned an invalid meeting credential")
+    return value
+  }
+}

package/src/modules/runtime/runtime.ts

@@ -30,6 +30,7 @@ import { HandshakeRejectedError } from "./connection";
 import type { RuntimeEmitter, RuntimeEvents } from "./emitter";
 import type { Subscriptions } from "./subscriptions";
 import type { Camera, StreamOptions, ManagedStream, StreamStatusResult } from "./camera";
+import type { Meetings } from "./meetings";
 import type { Maps, DirectionsRequest, DirectionsResult, LatLng, ReverseGeocodeResult } from "./maps";
 import type { Tts, RuntimeTtsSpeakOptions, RuntimeTtsSpeechSource } from "./tts";
 import type { UdpAudio } from "./audio-udp";
@@ -68,6 +69,7 @@ export type { RuntimeStatus, RuntimeSnapshot } from "./status";
  * unsubscribe function.
  */
 export interface RuntimeModule {
+  readonly meetings: Meetings;
   connect(): Promise<void>;
   close(): void;
 
@@ -111,6 +113,7 @@ export interface RuntimeModule {
 }
 
 export interface RuntimeDeps {
+  meetings?: Meetings;
   connection: Connection;
   emitter: RuntimeEmitter;
   subscriptions: Subscriptions;
@@ -136,6 +139,11 @@ export interface RuntimeDeps {
 const AUTH_EXPIRED_CODE = "AUTH_EXPIRED";
 
 export class Runtime implements RuntimeModule {
+  private readonly meetingService?: Meetings;
+  get meetings(): Meetings {
+    if (!this.meetingService) throw new Error("Meeting credentials are unavailable");
+    return this.meetingService;
+  }
   private readonly connection: Connection;
   private readonly emitter: RuntimeEmitter;
   private readonly subscriptions: Subscriptions;
@@ -175,6 +183,7 @@ export class Runtime implements RuntimeModule {
   private opened = false;
 
   constructor(deps: RuntimeDeps) {
+    this.meetingService = deps.meetings;
     this.connection = deps.connection;
     this.emitter = deps.emitter;
     this.subscriptions = deps.subscriptions;