@ai-matrx/meet 0.7.80 → 0.7.82

package/dist/index.d.cts

@@ -796,10 +796,10 @@ declare function unavailableFrom(error: MeetError): MediaUnavailable;
  */
 declare const LISTEN_ONLY_NOTICE = "You're attending without a microphone \u2014 others can't hear you";
 /**
- * True when this participant is in the room and publishing no microphone —
- * whether the device was refused or simply turned off. Both are listen-only,
- * and both deserve the same honest line; only the REMEDY differs, and that
- * comes from `media.microphone.unavailable`.
+ * True when this participant is in the room with NO USABLE microphone — the
+ * device was refused or is missing. A person who simply muted themselves has a
+ * working microphone and is not "attending without" one, so a mute never
+ * counts: `unavailable` is the only signal.
  */
 declare function isListenOnly(media: LocalMediaState): boolean;
 /**
@@ -2408,6 +2408,8 @@ interface MeetRoomDriver {
     setVideoEffect?(effect: VideoEffect): Promise<void>;
     /** Whether this browser can run background effects at all. */
     supportsVideoEffects?(): boolean;
+    /** Whether this browser can share a screen at all (iOS cannot). Absent = assume yes. */
+    supportsScreenShare?(): boolean;
     /**
      * Attach a participant's track to a media element. Returns the detach
      * function — returning it (rather than exposing `detach`) is what makes a
@@ -3463,6 +3465,8 @@ interface RoomEngine {
     setEffects(next: Partial<MediaEffects>): Promise<void>;
     /** Whether this browser can run a background effect at all (absent, never dead). */
     supportsVideoEffects(): boolean;
+    /** Whether this browser can share a screen at all — the control is ABSENT where it cannot. */
+    supportsScreenShare(): boolean;
     /** Choose the speaker (audio output) for this meeting. */
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;

package/dist/index.d.ts

@@ -796,10 +796,10 @@ declare function unavailableFrom(error: MeetError): MediaUnavailable;
  */
 declare const LISTEN_ONLY_NOTICE = "You're attending without a microphone \u2014 others can't hear you";
 /**
- * True when this participant is in the room and publishing no microphone —
- * whether the device was refused or simply turned off. Both are listen-only,
- * and both deserve the same honest line; only the REMEDY differs, and that
- * comes from `media.microphone.unavailable`.
+ * True when this participant is in the room with NO USABLE microphone — the
+ * device was refused or is missing. A person who simply muted themselves has a
+ * working microphone and is not "attending without" one, so a mute never
+ * counts: `unavailable` is the only signal.
  */
 declare function isListenOnly(media: LocalMediaState): boolean;
 /**
@@ -2408,6 +2408,8 @@ interface MeetRoomDriver {
     setVideoEffect?(effect: VideoEffect): Promise<void>;
     /** Whether this browser can run background effects at all. */
     supportsVideoEffects?(): boolean;
+    /** Whether this browser can share a screen at all (iOS cannot). Absent = assume yes. */
+    supportsScreenShare?(): boolean;
     /**
      * Attach a participant's track to a media element. Returns the detach
      * function — returning it (rather than exposing `detach`) is what makes a
@@ -3463,6 +3465,8 @@ interface RoomEngine {
     setEffects(next: Partial<MediaEffects>): Promise<void>;
     /** Whether this browser can run a background effect at all (absent, never dead). */
     supportsVideoEffects(): boolean;
+    /** Whether this browser can share a screen at all — the control is ABSENT where it cannot. */
+    supportsScreenShare(): boolean;
     /** Choose the speaker (audio output) for this meeting. */
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;

package/dist/index.js

@@ -139,6 +139,55 @@ function normalizeDeviceError(error, operation) {
       );
   }
 }
+var SYSTEM_BLOCK = /by system|permissions?[- ]policy|display-capture|disallowed|not allowed by the system/i;
+function classifyScreenShareError(error) {
+  const read = (value, key) => {
+    const v = value?.[key];
+    return typeof v === "string" ? v : "";
+  };
+  const cause = error instanceof MeetError ? error.cause : void 0;
+  const denied = [error, cause].some((value) => {
+    const name = read(value, "name");
+    return name === "NotAllowedError" || name === "AbortError" || name === "SecurityError";
+  });
+  if (denied) {
+    const text3 = [read(error, "message"), read(cause, "message")].join(" ");
+    return SYSTEM_BLOCK.test(text3) || [error, cause].some((v) => read(v, "name") === "SecurityError") ? "blocked" : "ambiguous";
+  }
+  if (error instanceof MeetError && error.code === "permission-denied" && cause === void 0) {
+    return "ambiguous";
+  }
+  return "other";
+}
+var SCREEN_SHARE_BLOCKED_REMEDY = "Your browser or computer is blocking screen sharing. On a Mac, open System Settings > Privacy & Security > Screen Recording, turn it on for your browser, then restart the browser. On a work computer, ask your administrator. You are still in the call.";
+function normalizeScreenShareError(error, operation) {
+  if (error instanceof MeetError) return error;
+  const raw = error ?? {};
+  const message = typeof raw.message === "string" ? raw.message : String(error);
+  const kind = classifyScreenShareError(error);
+  if (kind === "blocked") {
+    return new MeetError(
+      "permission-denied",
+      `${operation}: screen sharing is blocked (${message})`,
+      SCREEN_SHARE_BLOCKED_REMEDY,
+      error
+    );
+  }
+  if (kind === "ambiguous") {
+    return new MeetError(
+      "permission-denied",
+      `${operation}: screen sharing was cancelled or refused`,
+      "Choose a screen, window or tab in the picker to share it. If no picker appeared, " + SCREEN_SHARE_BLOCKED_REMEDY,
+      error
+    );
+  }
+  return new MeetError(
+    "media-unsupported",
+    `${operation}: screen sharing is not available (${message})`,
+    "This browser or device could not share a screen. You are still in the call; try a desktop browser to present.",
+    error
+  );
+}
 function invalidResponse(operation, detail) {
   return new MeetError(
     "invalid-response",
@@ -2602,7 +2651,7 @@ function unavailableFrom(error) {
 }
 var LISTEN_ONLY_NOTICE = "You're attending without a microphone \u2014 others can't hear you";
 function isListenOnly(media) {
-  return !media.microphone.enabled;
+  return !media.microphone.enabled && media.microphone.unavailable !== null;
 }
 function listenOnlyNotice(media) {
   return isListenOnly(media) ? LISTEN_ONLY_NOTICE : null;
@@ -3789,7 +3838,7 @@ function createLiveKitDriver(handlers, options = {}) {
       try {
         await requireRoom("setScreenShareEnabled").localParticipant.setScreenShareEnabled(enabled);
       } catch (error) {
-        throw normalizeDeviceError(error, "meet.setScreenShareEnabled");
+        throw normalizeScreenShareError(error, "meet.setScreenShareEnabled");
       }
     },
     async publishData(topic, payload, to) {
@@ -3826,6 +3875,9 @@ function createLiveKitDriver(handlers, options = {}) {
     supportsVideoEffects() {
       return videoEffectsSupported();
     },
+    supportsScreenShare() {
+      return typeof navigator !== "undefined" && typeof navigator.mediaDevices?.getDisplayMedia === "function";
+    },
     attach(identity, kind, element) {
       const target = requireRoom("attach");
       const source = sources?.[kind];
@@ -4885,6 +4937,7 @@ function createRoomEngine(options) {
   function report(level, message, remedy) {
     options.onDiagnostic?.(remedy === void 0 ? { level, message } : { level, message, remedy });
   }
+  let ambiguousShareDenials = 0;
   function fail(error, operation) {
     const normalized = normalizeMeetError(error, operation);
     store.patch({
@@ -5275,8 +5328,17 @@ function createRoomEngine(options) {
       if (driver === null) return;
       try {
         await driver.setScreenShareEnabled(enabled);
+        ambiguousShareDenials = 0;
       } catch (error) {
-        throw fail(error, "meet.setScreenShareEnabled");
+        const kind = classifyScreenShareError(error);
+        if (kind === "ambiguous") {
+          ambiguousShareDenials += 1;
+          if (ambiguousShareDenials < 2) return;
+        }
+        const normalized = normalizeScreenShareError(error, "meet.setScreenShareEnabled");
+        report("warn", normalized.message, normalized.remedy);
+        const text3 = kind === "other" ? `Screen sharing is not available. ${normalized.remedy}` : `Screen sharing did not start. ${SCREEN_SHARE_BLOCKED_REMEDY}`;
+        store.patch({ actionNotice: { text: text3, failed: true, at: now() } });
       }
     },
     async raiseHand(raised) {
@@ -5324,6 +5386,9 @@ function createRoomEngine(options) {
     supportsVideoEffects() {
       return driver?.supportsVideoEffects?.() ?? false;
     },
+    supportsScreenShare() {
+      return driver?.supportsScreenShare?.() ?? true;
+    },
     async switchDevice(kind, deviceId) {
       if (driver === null) return;
       await driver.switchDevice(kind, deviceId);