@ai-matrx/meet 0.8.1 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog — `@ai-matrx/meet`
 
+## 0.10.0
+### Unreleased
+### S4: admission truth — the wait reads the server
+
+- **The waiting room reads `GET /v1/meet/state`** (`MEET_ROUTES.state`) on a timer
+  (`waiting_poll_seconds`), on every `mx.state.changed` hint, on `online` and on visibility
+  return. `snapshot.waiting` holds the row's word; `useWaiting()` exposes it with `withdraw()`
+  and `askAgain()`. New phases rendered: `waiting:host_not_started`, `denied`, `knock_expired`,
+  `left` (withdrawn); `data-meet-host-present` while waiting.
+- **Admission RPCs** `meet_admit`, `meet_deny`, `meet_undeny`, `meet_admit_all` return rows
+  (`repository.decideAdmission`, `repository.admitAll`); `MeetingSession.undeny`.
+- **A token that cannot subscribe never renders the in-call screen.**
+- **Removed (no shim):** `MEET_EVENTS.knock`, `.admission`, `.lock`, `.recording`;
+  `MeetingSession.knock`, `useLobby().knock`, the `onDenied` option, `RPCS.admit =
+  meet_admit_participant` (dropped from the database). `MEET_EVENTS.stateChanged` is the one
+  room-channel event. `AdmissionState` widens to the server's eight states.
+
+Consumer action: none for `<MeetingSkinRoot>` consumers; a custom waiting screen reads
+`useWaiting()`.
+
+## 0.9.0
+### S3: the meeting pass, the role/standing vocabulary, refusal phases
+
+- **The meeting pass.** `RoomToken` gains `meetingPass`, `meetingPassExpiresAt`, `sessionId`,
+  `standing`. Every aidream meet route (record, claim, chat, collab, moderate, Q&A, captions)
+  now reads `x-meet-pass` (`MEETING_PASS_HEADER`, `meetingPassHeaders`); the LiveKit `token` is
+  for media only. `ROOM_TOKEN_HEADER` is removed (no shim). `rememberedMeetingPass(room)` reads
+  a guest's kept pass.
+- **Role vocabulary** `host · cohost · presenter · participant · viewer`; being a guest is the
+  STANDING `guest` (`ParticipantStanding`, `isLinkFollower`, attribute
+  `matrx.participant.standing`). `data-meet-role` still renders `guest` for a link follower.
+- **Refusals are phases.** `MeetError.reason` carries the join gate's reason code; a refused
+  join renders `refused:<reason>` (`ended` renders the `ended` phase), never pre-join.
+- **Session-aware record:** `loadGuestMeetingRecord({ sessionId })`.
+- **Removed:** `RPCS.endMeeting` / `repository.endMeeting` (the `meet_end_meeting` RPC is
+  dropped; `/v1/meet/end` is the one end door).
+
+Consumer action: send `meetingPass` (not `token`) as `x-meet-pass`; read the guest badge from
+`standing`, not `role === "guest"`; replace `ROOM_TOKEN_HEADER` with `MEETING_PASS_HEADER`.
+
 ## 0.8.1
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/{collab-Bss-_Jfp.d.cts → collab-C2R-kQnV.d.cts}

@@ -57,19 +57,23 @@ declare function isGuest(identity: MeetIdentity): boolean;
 /**
  * WHO SOMEBODY IS IN A ROOM — the SERVER's word, never this client's (MRI-A11).
  *
- * `host` is `meet_meetings.host_user_id` or a real `iam` grant on the meeting;
- * `participant` is an authenticated member of the meeting's organization;
- * `guest` is a link-follower with no session. Organization membership is
- * TENANCY and never permission, which is why "member of the org" lands on
- * `participant` and not on `host`.
- *
- * `cohost` has no server-side minter yet and is kept because the rank ladder
- * below is the thing that stops a co-host from removing the host; the moment a
- * co-host grant exists it slots in without a second vocabulary.
+ * THE ROLE VOCABULARY (CORE-DESIGN §2.1, S3): `host · cohost · presenter · participant ·
+ * viewer`. `host` is `meet_meetings.host_user_id`; `cohost` is a real `iam` grant on the
+ * meeting. Being a guest is a STANDING (`ParticipantStanding`), never a role: a guest is a
+ * `participant` whose standing is `guest`. Pinned against aidream's `config.py` by
+ * `test_meet_service.py`.
+ */
+type ParticipantRole = "host" | "cohost" | "presenter" | "participant" | "viewer";
+/**
+ * Where a person stands with the meeting, beside the role: `member` of its organization,
+ * `invited` (shared with them), `outsider` (signed in, followed the link), `guest` (no
+ * session). The server mints it (attribute `matrx.participant.standing`).
  */
-type ParticipantRole = "host" | "cohost" | "participant" | "guest";
+type ParticipantStanding = "member" | "invited" | "outsider" | "guest";
 /** Rank, so "can this actor do that to that participant" is one comparison. */
 declare const ROLE_RANK: Readonly<Record<ParticipantRole, number>>;
+/** Does this standing follow the link-holder (guest) rules? `outsider` and `guest`. */
+declare function isLinkFollower(standing: ParticipantStanding | null | undefined): boolean;
 /**
  * 🚨 THE ONE PREDICATE FOR "DOES THIS PERSON HOLD HOST POWERS".
  *
@@ -83,7 +87,7 @@ declare function isHostRole(role: ParticipantRole): boolean;
  * admits or denies. An authenticated member of the meeting's org is `admitted`
  * on arrival unless the meeting is locked.
  */
-type AdmissionState = "knocking" | "admitted" | "denied" | "removed";
+type AdmissionState = "waiting_host" | "knocking" | "admitted" | "denied" | "expired" | "withdrawn" | "removed" | "ended";
 interface LobbyEntry {
     readonly identity: ParticipantIdentity;
     readonly displayName: string;
@@ -91,6 +95,8 @@ interface LobbyEntry {
     readonly userId: UserId | null;
     readonly state: AdmissionState;
     readonly knockedAt: string;
+    /** When an unanswered knock lapses (`knock_timeout_minutes`); null = never. */
+    readonly knockExpiresAt?: string | null | undefined;
     readonly decidedAt: string | null;
     readonly decidedBy: UserId | null;
 }
@@ -102,6 +108,8 @@ interface MeetParticipant {
     readonly displayName: string;
     readonly avatarUrl: string | null;
     readonly role: ParticipantRole;
+    /** Where they stand with the meeting (server-minted); null when the server sent none. */
+    readonly standing?: ParticipantStanding | null;
     /**
      * Whether the SERVER granted this participant the power to start a recording
      * (MRI-A11). It is not `role === "host"`: a meeting whose recording policy is
@@ -367,6 +375,9 @@ interface MeetingAttendee {
     readonly userId: UserId | null;
     readonly role: ParticipantRole;
     readonly admissionState: AdmissionState;
+    /** When this person knocked, and when an unanswered knock lapses (null = never). */
+    readonly knockedAt?: string | null | undefined;
+    readonly knockExpiresAt?: string | null | undefined;
     readonly isAgent: boolean;
     /** FIRST arrival in the room — a rejoin never moves it. */
     readonly joinedAt: string | null;
@@ -800,6 +811,6 @@ interface MeetingActivities {
  * The same `GET /v1/meet/collab` the room reads on join; a refusal is returned as data,
  * so the record still renders everything else.
  */
-declare function loadMeetingActivities(api: MeetApi, meetingId: string, roomToken?: string | null): Promise<MeetingActivities>;
+declare function loadMeetingActivities(api: MeetApi, meetingId: string, meetingPass?: string | null): Promise<MeetingActivities>;
 
-export { type NoteTakerState as $, type AccessTokenSource as A, type MeetPollState as B, type CollabPanel as C, type MeetQuestion as D, EMPTY_COLLAB as E, FILE_SESSION_PATH as F, type MeetQuestionState as G, type MeetStroke as H, type InviteeInput as I, type JsonObject as J, type MeetingActivities as K, type LobbyEntry as L, type MeetingRecord as M, type MeetingAttendee as N, type OrganizationId as O, type ParticipantIdentity as P, type MeetingChanges as Q, type RoomName as R, type StageLayout as S, type TranscriptSource as T, type UserId as U, type MeetingInvitee as V, type WrapUpAnnouncement as W, type MeetingKind as X, type MeetingNoteKind as Y, type MeetingOccurrence as Z, type MeetingSettings as _, type MeetParticipant as a, ORGANIZATION_HEADER as a0, type OccurrenceOverride as a1, type OccurrenceState as a2, ROLE_RANK as a3, type RecordingPolicy as a4, type RecordingRecord as a5, type RecordingState as a6, type RoomPhase as a7, type RsvpAnswer as a8, type RsvpInvitation as a9, type RsvpState as aa, type TranscriptSegment as ab, type UpcomingOccurrence as ac, applyCollabPacket as ad, asCallId as ae, asMeetingId as af, asOrganizationId as ag, asParticipantIdentity as ah, asRoomName as ai, asUserId as aj, assignedRoom as ak, autoAssign as al, breakoutRemainingMs as am, collabFromState as an, createMeetApi as ao, defaultCaptionLanguage as ap, fileDownloadPath as aq, isGuest as ar, isHostRole as as, loadMeetingActivities as at, withItem as au, type RecordingSource as av, type MeetApi as b, type MeetIdentity as c, type CallInvite as d, type ParticipantRole as e, type CallMode as f, type MeetingNote as g, type MeetingId as h, type CollabSnapshot as i, type AdmissionState as j, CAPTION_LANGUAGES as k, type CallId as l, type CallState as m, type CallablePerson as n, type ConnectionQuality as o, type InviteeRole as p, type JsonValue as q, type MeetApiOptions as r, type MeetApiRequest as s, type MeetBreakoutBroadcast as t, type MeetBreakoutPlan as u, type MeetBreakoutRoom as v, type MeetCollabSettings as w, type MeetFileMedia as x, type MeetPoll as y, type MeetPollOption as z };
+export { type NoteTakerState as $, type AccessTokenSource as A, type MeetPollState as B, type CollabPanel as C, type MeetQuestion as D, EMPTY_COLLAB as E, FILE_SESSION_PATH as F, type MeetQuestionState as G, type MeetStroke as H, type InviteeInput as I, type JsonObject as J, type MeetingActivities as K, type LobbyEntry as L, type MeetingRecord as M, type MeetingAttendee as N, type OrganizationId as O, type ParticipantIdentity as P, type MeetingChanges as Q, type RoomName as R, type StageLayout as S, type TranscriptSource as T, type UserId as U, type MeetingInvitee as V, type WrapUpAnnouncement as W, type MeetingKind as X, type MeetingNoteKind as Y, type MeetingOccurrence as Z, type MeetingSettings as _, type MeetParticipant as a, ORGANIZATION_HEADER as a0, type OccurrenceOverride as a1, type OccurrenceState as a2, type ParticipantStanding as a3, ROLE_RANK as a4, type RecordingPolicy as a5, type RecordingRecord as a6, type RecordingState as a7, type RoomPhase as a8, type RsvpAnswer as a9, type RsvpInvitation as aa, type RsvpState as ab, type TranscriptSegment as ac, type UpcomingOccurrence as ad, applyCollabPacket as ae, asCallId as af, asMeetingId as ag, asOrganizationId as ah, asParticipantIdentity as ai, asRoomName as aj, asUserId as ak, assignedRoom as al, autoAssign as am, breakoutRemainingMs as an, collabFromState as ao, createMeetApi as ap, defaultCaptionLanguage as aq, fileDownloadPath as ar, isGuest as as, isHostRole as at, isLinkFollower as au, loadMeetingActivities as av, withItem as aw, type RecordingSource as ax, type MeetApi as b, type MeetIdentity as c, type CallInvite as d, type ParticipantRole as e, type CallMode as f, type MeetingNote as g, type MeetingId as h, type CollabSnapshot as i, type AdmissionState as j, CAPTION_LANGUAGES as k, type CallId as l, type CallState as m, type CallablePerson as n, type ConnectionQuality as o, type InviteeRole as p, type JsonValue as q, type MeetApiOptions as r, type MeetApiRequest as s, type MeetBreakoutBroadcast as t, type MeetBreakoutPlan as u, type MeetBreakoutRoom as v, type MeetCollabSettings as w, type MeetFileMedia as x, type MeetPoll as y, type MeetPollOption as z };

package/dist/{collab-Bss-_Jfp.d.ts → collab-C2R-kQnV.d.ts}

@@ -57,19 +57,23 @@ declare function isGuest(identity: MeetIdentity): boolean;
 /**
  * WHO SOMEBODY IS IN A ROOM — the SERVER's word, never this client's (MRI-A11).
  *
- * `host` is `meet_meetings.host_user_id` or a real `iam` grant on the meeting;
- * `participant` is an authenticated member of the meeting's organization;
- * `guest` is a link-follower with no session. Organization membership is
- * TENANCY and never permission, which is why "member of the org" lands on
- * `participant` and not on `host`.
- *
- * `cohost` has no server-side minter yet and is kept because the rank ladder
- * below is the thing that stops a co-host from removing the host; the moment a
- * co-host grant exists it slots in without a second vocabulary.
+ * THE ROLE VOCABULARY (CORE-DESIGN §2.1, S3): `host · cohost · presenter · participant ·
+ * viewer`. `host` is `meet_meetings.host_user_id`; `cohost` is a real `iam` grant on the
+ * meeting. Being a guest is a STANDING (`ParticipantStanding`), never a role: a guest is a
+ * `participant` whose standing is `guest`. Pinned against aidream's `config.py` by
+ * `test_meet_service.py`.
+ */
+type ParticipantRole = "host" | "cohost" | "presenter" | "participant" | "viewer";
+/**
+ * Where a person stands with the meeting, beside the role: `member` of its organization,
+ * `invited` (shared with them), `outsider` (signed in, followed the link), `guest` (no
+ * session). The server mints it (attribute `matrx.participant.standing`).
  */
-type ParticipantRole = "host" | "cohost" | "participant" | "guest";
+type ParticipantStanding = "member" | "invited" | "outsider" | "guest";
 /** Rank, so "can this actor do that to that participant" is one comparison. */
 declare const ROLE_RANK: Readonly<Record<ParticipantRole, number>>;
+/** Does this standing follow the link-holder (guest) rules? `outsider` and `guest`. */
+declare function isLinkFollower(standing: ParticipantStanding | null | undefined): boolean;
 /**
  * 🚨 THE ONE PREDICATE FOR "DOES THIS PERSON HOLD HOST POWERS".
  *
@@ -83,7 +87,7 @@ declare function isHostRole(role: ParticipantRole): boolean;
  * admits or denies. An authenticated member of the meeting's org is `admitted`
  * on arrival unless the meeting is locked.
  */
-type AdmissionState = "knocking" | "admitted" | "denied" | "removed";
+type AdmissionState = "waiting_host" | "knocking" | "admitted" | "denied" | "expired" | "withdrawn" | "removed" | "ended";
 interface LobbyEntry {
     readonly identity: ParticipantIdentity;
     readonly displayName: string;
@@ -91,6 +95,8 @@ interface LobbyEntry {
     readonly userId: UserId | null;
     readonly state: AdmissionState;
     readonly knockedAt: string;
+    /** When an unanswered knock lapses (`knock_timeout_minutes`); null = never. */
+    readonly knockExpiresAt?: string | null | undefined;
     readonly decidedAt: string | null;
     readonly decidedBy: UserId | null;
 }
@@ -102,6 +108,8 @@ interface MeetParticipant {
     readonly displayName: string;
     readonly avatarUrl: string | null;
     readonly role: ParticipantRole;
+    /** Where they stand with the meeting (server-minted); null when the server sent none. */
+    readonly standing?: ParticipantStanding | null;
     /**
      * Whether the SERVER granted this participant the power to start a recording
      * (MRI-A11). It is not `role === "host"`: a meeting whose recording policy is
@@ -367,6 +375,9 @@ interface MeetingAttendee {
     readonly userId: UserId | null;
     readonly role: ParticipantRole;
     readonly admissionState: AdmissionState;
+    /** When this person knocked, and when an unanswered knock lapses (null = never). */
+    readonly knockedAt?: string | null | undefined;
+    readonly knockExpiresAt?: string | null | undefined;
     readonly isAgent: boolean;
     /** FIRST arrival in the room — a rejoin never moves it. */
     readonly joinedAt: string | null;
@@ -800,6 +811,6 @@ interface MeetingActivities {
  * The same `GET /v1/meet/collab` the room reads on join; a refusal is returned as data,
  * so the record still renders everything else.
  */
-declare function loadMeetingActivities(api: MeetApi, meetingId: string, roomToken?: string | null): Promise<MeetingActivities>;
+declare function loadMeetingActivities(api: MeetApi, meetingId: string, meetingPass?: string | null): Promise<MeetingActivities>;
 
-export { type NoteTakerState as $, type AccessTokenSource as A, type MeetPollState as B, type CollabPanel as C, type MeetQuestion as D, EMPTY_COLLAB as E, FILE_SESSION_PATH as F, type MeetQuestionState as G, type MeetStroke as H, type InviteeInput as I, type JsonObject as J, type MeetingActivities as K, type LobbyEntry as L, type MeetingRecord as M, type MeetingAttendee as N, type OrganizationId as O, type ParticipantIdentity as P, type MeetingChanges as Q, type RoomName as R, type StageLayout as S, type TranscriptSource as T, type UserId as U, type MeetingInvitee as V, type WrapUpAnnouncement as W, type MeetingKind as X, type MeetingNoteKind as Y, type MeetingOccurrence as Z, type MeetingSettings as _, type MeetParticipant as a, ORGANIZATION_HEADER as a0, type OccurrenceOverride as a1, type OccurrenceState as a2, ROLE_RANK as a3, type RecordingPolicy as a4, type RecordingRecord as a5, type RecordingState as a6, type RoomPhase as a7, type RsvpAnswer as a8, type RsvpInvitation as a9, type RsvpState as aa, type TranscriptSegment as ab, type UpcomingOccurrence as ac, applyCollabPacket as ad, asCallId as ae, asMeetingId as af, asOrganizationId as ag, asParticipantIdentity as ah, asRoomName as ai, asUserId as aj, assignedRoom as ak, autoAssign as al, breakoutRemainingMs as am, collabFromState as an, createMeetApi as ao, defaultCaptionLanguage as ap, fileDownloadPath as aq, isGuest as ar, isHostRole as as, loadMeetingActivities as at, withItem as au, type RecordingSource as av, type MeetApi as b, type MeetIdentity as c, type CallInvite as d, type ParticipantRole as e, type CallMode as f, type MeetingNote as g, type MeetingId as h, type CollabSnapshot as i, type AdmissionState as j, CAPTION_LANGUAGES as k, type CallId as l, type CallState as m, type CallablePerson as n, type ConnectionQuality as o, type InviteeRole as p, type JsonValue as q, type MeetApiOptions as r, type MeetApiRequest as s, type MeetBreakoutBroadcast as t, type MeetBreakoutPlan as u, type MeetBreakoutRoom as v, type MeetCollabSettings as w, type MeetFileMedia as x, type MeetPoll as y, type MeetPollOption as z };
+export { type NoteTakerState as $, type AccessTokenSource as A, type MeetPollState as B, type CollabPanel as C, type MeetQuestion as D, EMPTY_COLLAB as E, FILE_SESSION_PATH as F, type MeetQuestionState as G, type MeetStroke as H, type InviteeInput as I, type JsonObject as J, type MeetingActivities as K, type LobbyEntry as L, type MeetingRecord as M, type MeetingAttendee as N, type OrganizationId as O, type ParticipantIdentity as P, type MeetingChanges as Q, type RoomName as R, type StageLayout as S, type TranscriptSource as T, type UserId as U, type MeetingInvitee as V, type WrapUpAnnouncement as W, type MeetingKind as X, type MeetingNoteKind as Y, type MeetingOccurrence as Z, type MeetingSettings as _, type MeetParticipant as a, ORGANIZATION_HEADER as a0, type OccurrenceOverride as a1, type OccurrenceState as a2, type ParticipantStanding as a3, ROLE_RANK as a4, type RecordingPolicy as a5, type RecordingRecord as a6, type RecordingState as a7, type RoomPhase as a8, type RsvpAnswer as a9, type RsvpInvitation as aa, type RsvpState as ab, type TranscriptSegment as ac, type UpcomingOccurrence as ad, applyCollabPacket as ae, asCallId as af, asMeetingId as ag, asOrganizationId as ah, asParticipantIdentity as ai, asRoomName as aj, asUserId as ak, assignedRoom as al, autoAssign as am, breakoutRemainingMs as an, collabFromState as ao, createMeetApi as ap, defaultCaptionLanguage as aq, fileDownloadPath as ar, isGuest as as, isHostRole as at, isLinkFollower as au, loadMeetingActivities as av, withItem as aw, type RecordingSource as ax, type MeetApi as b, type MeetIdentity as c, type CallInvite as d, type ParticipantRole as e, type CallMode as f, type MeetingNote as g, type MeetingId as h, type CollabSnapshot as i, type AdmissionState as j, CAPTION_LANGUAGES as k, type CallId as l, type CallState as m, type CallablePerson as n, type ConnectionQuality as o, type InviteeRole as p, type JsonValue as q, type MeetApiOptions as r, type MeetApiRequest as s, type MeetBreakoutBroadcast as t, type MeetBreakoutPlan as u, type MeetBreakoutRoom as v, type MeetCollabSettings as w, type MeetFileMedia as x, type MeetPoll as y, type MeetPollOption as z };

package/dist/{components-BmgstFx_.d.ts → components-CMtSekZS.d.ts}

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { M as MeetingRecord, P as ParticipantIdentity, R as RoomName, a as MeetParticipant } from './collab-Bss-_Jfp.js';
+import { M as MeetingRecord, P as ParticipantIdentity, R as RoomName, a as MeetParticipant } from './collab-C2R-kQnV.js';
 
 /**
  * THE PRODUCT UI (R6/R7). Not a headless kernel with a note telling the host to

package/dist/{components-BOUmOiPj.d.cts → components-DKHfkEVB.d.cts}

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { M as MeetingRecord, P as ParticipantIdentity, R as RoomName, a as MeetParticipant } from './collab-Bss-_Jfp.cjs';
+import { M as MeetingRecord, P as ParticipantIdentity, R as RoomName, a as MeetParticipant } from './collab-C2R-kQnV.cjs';
 
 /**
  * THE PRODUCT UI (R6/R7). Not a headless kernel with a note telling the host to