@mentra/cloud-client 3.3.0-dev.320 → 3.3.0-dev.322

package/package.json

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

package/src/index.ts

@@ -16,7 +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 type { AcsMeetingCredential, CreatedTeamsMeeting } from "./modules/runtime/meetings";
 export { CloudClient } from "./client";
 export { DEFAULT_REFRESH_TOKEN_KEY } from "./modules/auth/token-store";
 

package/src/modules/runtime/meetings.ts

@@ -9,9 +9,51 @@ export interface AcsMeetingCredential {
   guestReason?: "teams-license-unavailable"
 }
 
+export interface CreatedTeamsMeeting {
+  provider: "acs-teams"
+  joinUrl: string
+  meetingRef: string
+  identityMode: "guest" | "teams-user"
+  guestReason?: "no-entra-identity" | "teams-license-unavailable"
+}
+
 export class Meetings {
   constructor(private readonly http: HttpClient) {}
 
+  async createTeamsMeeting(
+    options: {subject?: string; durationMinutes?: number},
+    teamsUserAadToken?: string,
+  ): Promise<CreatedTeamsMeeting> {
+    const value = await this.http.post<CreatedTeamsMeeting>("/api/meetings/teams/create", {
+      ...options,
+      ...(teamsUserAadToken ? {teamsUserAadToken} : {}),
+    })
+    if (
+      !value ||
+      value.provider !== "acs-teams" ||
+      typeof value.joinUrl !== "string" ||
+      !/^https:\/\/(teams\.microsoft\.com|teams\.cloud\.microsoft)\//.test(value.joinUrl) ||
+      typeof value.meetingRef !== "string" ||
+      !value.meetingRef ||
+      !["guest", "teams-user"].includes(value.identityMode) ||
+      (teamsUserAadToken && value.identityMode === "guest" && value.guestReason !== "teams-license-unavailable") ||
+      (!teamsUserAadToken && (value.identityMode !== "guest" || value.guestReason !== "no-entra-identity"))
+    ) {
+      throw new Error("Runtime returned an invalid created meeting")
+    }
+    return {
+      provider: value.provider,
+      joinUrl: value.joinUrl,
+      meetingRef: value.meetingRef,
+      identityMode: value.identityMode,
+      ...(value.identityMode === "guest" ? {guestReason: value.guestReason} : {}),
+    }
+  }
+
+  async retireTeamsMeeting(meetingRef: string): Promise<void> {
+    await this.http.post("/api/meetings/teams/retire", {meetingRef})
+  }
+
   async getAcsCredential(teamsUserAadToken?: string): Promise<AcsMeetingCredential> {
     const value = await this.http.post<AcsMeetingCredential>(
       "/api/meetings/acs/token",