@ensera/plugin-frontend 1.0.1 → 1.1.0

package/dist/index.d.ts

@@ -89,6 +89,14 @@ type PluginThemeMessage = {
         theme: PluginThemeSnapshot;
     };
 };
+type WorkspaceMemberRole = "OWNER" | "ADMIN" | "MEMBER" | "GUEST";
+type PluginWorkspaceMember = {
+    userId: string;
+    name: string | null;
+    email: string;
+    image: string | null;
+    role: WorkspaceMemberRole;
+};
 /**
  * Launch modes for plugin instances
  */
@@ -587,6 +595,15 @@ declare function getFeatureColorTokens(hex: string, mode: PluginThemeMode): {
 };
 declare function syncAdaptiveFeatureColors(root: ParentNode | null | undefined, mode: PluginThemeMode): void;
 
+declare function getWorkspaceMembers(options?: {
+    includeGuests?: boolean;
+}): PluginWorkspaceMember[];
+declare function getUser(userId: string): PluginWorkspaceMember | null;
+declare function isMembersReady(): boolean;
+declare function useWorkspaceMembers(options?: {
+    includeGuests?: boolean;
+}): PluginWorkspaceMember[];
+
 declare const tokens: {
     readonly spacing: {
         readonly xs: 4;
@@ -788,4 +805,4 @@ declare function setupContextMenuRelay(ctx: {
     instanceId: string;
 }): () => void;
 
-export { Button, type ButtonProps, type ButtonSize, type ButtonVariant, ContextMenuShell, ContextRow, type ContextRowProps, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, Input, type InputProps, type InputSize, type InputVariant, type JsonObject, type JsonValue, type NotificationAction, type NotificationCapabilities, type NotificationTypeConfig, type PluginActionHandler, type PluginActionHandlerArgs, type PluginActionId, type PluginActionsMap, PluginAuthError, type PluginCtx, type PluginDispatchFn, type PluginDispatchRequest, type PluginDispatchResult, type PluginErrorPayload, PluginFetchError, type PluginFetchExpect, PluginFetchInputError, type PluginFetchOptions, type PluginFetchResponse, type PluginFetchRetry, PluginForbiddenError, type PluginLaunch, type PluginLogLevel, type PluginLogger, PluginNetworkError, PluginNotFoundError, type PluginNotification, type PluginNotificationBulkResponse, type PluginNotificationOptions, type PluginNotificationRequest, type PluginNotificationResponse, type PluginNotificationResultMessage, type PluginNotify, type PluginOpenOverlayMessage, PluginRateLimitError, PluginResponseError, type PluginRuntime, PluginServerError, type PluginStorage, type PluginStorageBackend, PluginStorageError, type PluginStorageIndexedDB, PluginStorageQuotaError, type PluginThemeColorRole, type PluginThemeMessage, type PluginThemeMode, type PluginThemeSnapshot, PluginUnknownActionError, PluginValidationError, Row, type RowAlign, type RowHeight, type RowJustify, type RowProps, type SyncCallback, type SyncEventType, type SyncMessage, type SyncPayload, type SyncedState, type Tokens, adaptFeatureColor, applyPluginTheme, attachActionDispatcher, broadcast, createPluginFetch, createPluginLogger, createPluginNotify, createPluginRuntime, createPluginStorage, createPluginStorageIndexedDB, createSyncedState, defineActions, dispatchPluginThemeChange, getFeatureColorTokens, getPluginThemeSnapshot, getReadableFeatureTextColor, initBroadcast, initializePluginTheme, makeStorageNamespace, normalizePluginThemeMode, normalizePluginThemeSnapshot, onBroadcast, openOverlay, runActionSafe, setupContextMenuRelay, subscribePluginTheme, syncAdaptiveFeatureColors, tokens, useBroadcastListener, usePluginTheme, useSyncedState };
+export { Button, type ButtonProps, type ButtonSize, type ButtonVariant, ContextMenuShell, ContextRow, type ContextRowProps, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, Input, type InputProps, type InputSize, type InputVariant, type JsonObject, type JsonValue, type NotificationAction, type NotificationCapabilities, type NotificationTypeConfig, type PluginActionHandler, type PluginActionHandlerArgs, type PluginActionId, type PluginActionsMap, PluginAuthError, type PluginCtx, type PluginDispatchFn, type PluginDispatchRequest, type PluginDispatchResult, type PluginErrorPayload, PluginFetchError, type PluginFetchExpect, PluginFetchInputError, type PluginFetchOptions, type PluginFetchResponse, type PluginFetchRetry, PluginForbiddenError, type PluginLaunch, type PluginLogLevel, type PluginLogger, PluginNetworkError, PluginNotFoundError, type PluginNotification, type PluginNotificationBulkResponse, type PluginNotificationOptions, type PluginNotificationRequest, type PluginNotificationResponse, type PluginNotificationResultMessage, type PluginNotify, type PluginOpenOverlayMessage, PluginRateLimitError, PluginResponseError, type PluginRuntime, PluginServerError, type PluginStorage, type PluginStorageBackend, PluginStorageError, type PluginStorageIndexedDB, PluginStorageQuotaError, type PluginThemeColorRole, type PluginThemeMessage, type PluginThemeMode, type PluginThemeSnapshot, PluginUnknownActionError, PluginValidationError, type PluginWorkspaceMember, Row, type RowAlign, type RowHeight, type RowJustify, type RowProps, type SyncCallback, type SyncEventType, type SyncMessage, type SyncPayload, type SyncedState, type Tokens, type WorkspaceMemberRole, adaptFeatureColor, applyPluginTheme, attachActionDispatcher, broadcast, createPluginFetch, createPluginLogger, createPluginNotify, createPluginRuntime, createPluginStorage, createPluginStorageIndexedDB, createSyncedState, defineActions, dispatchPluginThemeChange, getFeatureColorTokens, getPluginThemeSnapshot, getReadableFeatureTextColor, getUser, getWorkspaceMembers, initBroadcast, initializePluginTheme, isMembersReady, makeStorageNamespace, normalizePluginThemeMode, normalizePluginThemeSnapshot, onBroadcast, openOverlay, runActionSafe, setupContextMenuRelay, subscribePluginTheme, syncAdaptiveFeatureColors, tokens, useBroadcastListener, usePluginTheme, useSyncedState, useWorkspaceMembers };

package/dist/index.js

@@ -1581,6 +1581,92 @@ function syncAdaptiveFeatureColors(root, mode) {
 }
 bindWindowThemeListeners();
 
+// src/members.ts
+import { useSyncExternalStore as useSyncExternalStore2 } from "react";
+var membersStore = [];
+var membersInitialized = false;
+var boundWindowListeners2 = false;
+var listeners2 = /* @__PURE__ */ new Set();
+function notifyListeners() {
+  for (const listener of listeners2) {
+    listener();
+  }
+}
+function getMembersSnapshot() {
+  return membersStore;
+}
+function subscribeMembersStore(listener) {
+  listeners2.add(listener);
+  return () => listeners2.delete(listener);
+}
+function bindMembersMessageListeners() {
+  if (boundWindowListeners2 || typeof window === "undefined") {
+    return;
+  }
+  window.addEventListener("message", (event) => {
+    const message = event.data;
+    if (!message || typeof message !== "object") {
+      return;
+    }
+    switch (message.type) {
+      case "ENSERA_INIT": {
+        const members = message.payload?.members;
+        if (Array.isArray(members)) {
+          setWorkspaceMembers(members);
+        } else {
+          setWorkspaceMembers([]);
+        }
+        break;
+      }
+      case "ENSERA_MEMBERS_UPDATE": {
+        const members = message.payload?.members;
+        if (Array.isArray(members)) {
+          updateWorkspaceMembers(members);
+        }
+        break;
+      }
+    }
+  });
+  boundWindowListeners2 = true;
+}
+function setWorkspaceMembers(members) {
+  membersStore = Array.isArray(members) ? members : [];
+  membersInitialized = true;
+  notifyListeners();
+}
+function updateWorkspaceMembers(members) {
+  membersStore = Array.isArray(members) ? members : [];
+  notifyListeners();
+}
+function getWorkspaceMembers(options) {
+  bindMembersMessageListeners();
+  if (!options?.includeGuests) {
+    return membersStore.filter((member) => member.role !== "GUEST");
+  }
+  return [...membersStore];
+}
+function getUser(userId) {
+  bindMembersMessageListeners();
+  return membersStore.find((member) => member.userId === userId) ?? null;
+}
+function isMembersReady() {
+  bindMembersMessageListeners();
+  return membersInitialized;
+}
+function useWorkspaceMembers(options) {
+  bindMembersMessageListeners();
+  const all = useSyncExternalStore2(
+    subscribeMembersStore,
+    getMembersSnapshot,
+    getMembersSnapshot
+  );
+  if (!options?.includeGuests) {
+    return all.filter((member) => member.role !== "GUEST");
+  }
+  return all;
+}
+bindMembersMessageListeners();
+
 // src/ui/tokens.ts
 var tokens = {
   // Spacing scale (in pixels)
@@ -2336,8 +2422,11 @@ export {
   getFeatureColorTokens,
   getPluginThemeSnapshot,
   getReadableFeatureTextColor,
+  getUser,
+  getWorkspaceMembers,
   initBroadcast,
   initializePluginTheme,
+  isMembersReady,
   makeStorageNamespace,
   normalizePluginThemeMode,
   normalizePluginThemeSnapshot,
@@ -2350,5 +2439,6 @@ export {
   tokens,
   useBroadcastListener,
   usePluginTheme,
-  useSyncedState
+  useSyncedState,
+  useWorkspaceMembers
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ensera/plugin-frontend",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Runtime frontend SDK for Ensera plugins.",
   "type": "module",
   "main": "./dist/index.js",