@noya-app/noya-multiplayer-react 0.1.43 → 0.1.44

package/dist/index.d.mts

@@ -1,19 +1,8 @@
 import * as _noya_app_state_manager from '@noya-app/state-manager';
-import { MultiplayerUser, EphemeralUserData, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, TSchema, Static } from '@noya-app/state-manager';
+import { ConnectedUsersManager, EphemeralUserDataManager, RPCManager, StandardRPCRequestPayload, StandardRPCResponsePayload, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, SecretManager as SecretManager$1, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, AIManager, WorkflowManager, TSchema, Static } from '@noya-app/state-manager';
 export * from '@noya-app/state-manager';
-import React, { ComponentPropsWithoutRef, SetStateAction } from 'react';
-import { GetAtPath, ObservableOptions, PathKey, Observable } from '@noya-app/observable';
-
-declare function getAvatarInitials(name: string): string;
-/**
- * Create a background color and initials from a name
- *
- * Adapted from https://mui.com/material-ui/react-avatar/
- */
-declare function getAvatarStyle(name: string): {
-    color: string;
-    backgroundColor: string;
-};
+import React, { SetStateAction } from 'react';
+import { Observable, GetAtPath, ObservableOptions, PathKey } from '@noya-app/observable';
 
 type Point = {
     x: number;
@@ -22,76 +11,75 @@ type Point = {
 type UserPointerData = {
     pointer?: Point;
 };
-type UserPointerProps<E extends UserPointerData> = {
-    user: MultiplayerUser;
-    ephemeralUserData: EphemeralUserData<E>;
-    hideAfter?: number;
-};
-declare const UserPointer_: <E extends UserPointerData>({ user, ephemeralUserData, hideAfter, }: UserPointerProps<E>) => React.JSX.Element | null;
-declare const UserPointer: typeof UserPointer_;
-declare const UserPointerContainer: React.NamedExoticComponent<{
+type RenderUserPointerProps = {
+    userId: string;
+    name?: string;
+    visible: boolean;
     point: Point;
-    children: React.ReactNode;
-    show?: boolean;
-}>;
-declare const UserNameTag: React.NamedExoticComponent<{
-    background: string;
-    children: React.ReactNode;
-}>;
+};
+type RenderUserPointer = {
+    renderUserPointer: (options: RenderUserPointerProps) => React.ReactNode;
+};
 type UserPointersOverlayProps<E extends UserPointerData> = {
-    connectedUsers: MultiplayerUser[];
-    ephemeralUserData: EphemeralUserData<E>;
+    connectedUsersManager: ConnectedUsersManager;
+    ephemeralUserDataManager: EphemeralUserDataManager<E>;
+} & RenderUserPointer;
+declare const UserPointersOverlay: <E extends UserPointerData>(props: UserPointersOverlayProps<E>) => React.ReactElement | null;
+
+type Secret = {
+    id: string;
+    name: string;
 };
-declare const UserPointersOverlay: React.MemoExoticComponent<(<E extends UserPointerData>({ connectedUsers, ephemeralUserData }: UserPointersOverlayProps<E>) => React.JSX.Element)>;
-declare const UserPointerIcon: React.NamedExoticComponent<{
-    color?: string;
-}>;
+declare class SecretManager {
+    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
+    constructor(rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>);
+    secrets$: Observable<Secret[]>;
+    isInitialized$: Observable<boolean>;
+    createSecret(name: string, value: string): Promise<StandardRPCResponsePayload>;
+    deleteSecret(name: string): Promise<StandardRPCResponsePayload>;
+}
 
 type StateInspectorAnchor = "left" | "right" | "bottom left" | "bottom right";
 type StateInspectorOptions = {
     colorScheme?: "light" | "dark";
     anchor?: StateInspectorAnchor;
 };
-declare const StateInspector: React.MemoExoticComponent<(<S, M, E>({ state, connectionEvents, connectedUsers, tasks, userId, unstyled, colorScheme, multiplayerStateManager, assetManager, ephemeralUserData, anchor, forceInit, ...props }: {
+declare const StateInspector: <S, M, E extends object>(props: {
     state: S;
     connectionEvents?: ConnectionEvent<S>[];
-    connectedUsers?: MultiplayerUser[];
     tasks?: Task[];
-    userId?: string;
     unstyled?: boolean;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assetManager: AssetManager;
-    ephemeralUserData: EphemeralUserData<E>;
+    connectedUsersManager: ConnectedUsersManager;
+    secretManager: SecretManager$1;
+    ephemeralUserDataManager: EphemeralUserDataManager<E>;
     forceInit: () => void;
-} & StateInspectorOptions & ComponentPropsWithoutRef<"div">) => React.JSX.Element | null)>;
+} & StateInspectorOptions & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">) => React.ReactElement | null;
 
 declare function useSyncStateManager<S, M>(stateManager: StateManager<S, M>): S;
 declare function useSyncStateManager<S, M, P extends string>(stateManager: StateManager<S, M>, path: P): GetAtPath<S, P>;
 declare function useManagedState<S, M = void>(createInitialState: () => S, options?: StateManagerOptions<S, M>): readonly [S, (...args: M extends {} ? [metadata: M, action: SetStateAction<S>] : [action: SetStateAction<S>]) => void, StateManager<S, M>];
 declare function useManagedHistory<S, M = void>(stateManager: StateManager<S, M>): _noya_app_state_manager.HistorySnapshot<S, M>;
 declare function useSyncMultiplayerStateManager<S, M = void>(multiplayerStateManager: MultiplayerStateManager<S, M>): S;
-declare function useEphemeralUserData<E>(ephemeralUserData: EphemeralUserData<E>, options?: {
-    throttle?: number;
-}): {
-    data: Record<string, E | undefined>;
-    metadata: Record<string, _noya_app_state_manager.EphemeralUserMetadata | undefined>;
-    currentUserId: string | undefined;
-};
-type UseMultiplayerStateOptions<S, M = void, E = void> = MultiplayerStateManagerOptions<S, M> & {
-    sync?: (options: Pick<SyncAdapterOptions<S, M, E>, "ms" | "ephemeralUserData" | "assetManager">) => void;
+type UseMultiplayerStateOptions<S, M = void, E extends object = object> = MultiplayerStateManagerOptions<S, M> & {
+    sync?: (options: Pick<SyncAdapterOptions<S, M, E>, "ms" | "ephemeralUserDataManager" | "assetManager">) => void;
     trackConnectionEvents?: boolean;
     trackTasks?: boolean;
     inspector?: boolean | StateInspectorOptions;
 };
-declare function useMultiplayerState<S, M = void, E = void>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E>): readonly [S, (...args: M extends {} ? [metadata: M, action: S | ((prevState: S) => S)] : [action: S | ((prevState: S) => S)]) => void, {
+declare function useMultiplayerState<S, M = void, E extends object = object>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E>): readonly [S, (...args: M extends {} ? [metadata: M, action: S | ((prevState: S) => S)] : [action: S | ((prevState: S) => S)]) => void, {
     tasks: Task[];
-    userId: string | undefined;
     connectionEvents: ConnectionEvent<S>[] | undefined;
-    connectedUsers: MultiplayerUser[];
-    ephemeralUserData: EphemeralUserData<E>;
+    connectedUsersManager: ConnectedUsersManager;
+    ephemeralUserDataManager: EphemeralUserDataManager<E>;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assets: _noya_app_state_manager.Asset[];
     assetManager: AssetManager;
+    aiManager: AIManager;
+    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
+    workflowManager: WorkflowManager;
+    secretManager: SecretManager;
     createAsset: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     deleteAsset: (id: string) => Promise<void>;
 }];
@@ -134,13 +122,13 @@ type HostToIframeMessage = {
         value: string;
     };
 };
-declare function useBroadcastConnectedUsers(connectedUsers: MultiplayerUser[]): void;
+declare function useBroadcastConnectedUsers(connectedUsersManager: ConnectedUsersManager): void;
 declare function useBroadcastMenuItems<T>(menuItems: any[], handleSelectMenuItem: (value: T) => void): void;
 declare function isEmbeddedApp(): boolean;
-type UseNoyaStateOptions<S, M = void, E = void> = UseMultiplayerStateOptions<S, M, E> & {
+type UseNoyaStateOptions<S, M = void, E extends object = object> = UseMultiplayerStateOptions<S, M, E> & {
     offlineStorageKey?: string;
 };
-type UseNoyaStateResult<S, M = void, E = void> = [
+type UseNoyaStateResult<S, M = void, E extends object = object> = [
     ReturnType<typeof useMultiplayerState<S, M, E>>[0],
     ReturnType<typeof useMultiplayerState<S, M, E>>[1],
     ReturnType<typeof useMultiplayerState<S, M, E>>[2] & {
@@ -157,16 +145,17 @@ type UseNoyaStateResult<S, M = void, E = void> = [
  * 2. Pass an initial state and a schema: `useNoyaState(initialState, { schema })`
  * 3. Pass only a schema, and a conforming initial state is created automatically: `useNoyaState({ schema })`
  */
-declare function useNoyaState<S, M = void, E = void, O extends UseNoyaStateOptions<S, M, E> = UseNoyaStateOptions<S, M, E>>(...args: [
+declare function useNoyaState<S, M = void, E extends object = object, O extends UseNoyaStateOptions<S, M, E> = UseNoyaStateOptions<S, M, E>>(...args: [
     initialState: O["schema"] extends TSchema ? Static<O["schema"]> | (() => Static<O["schema"]>) : S | (() => S),
     options?: O
 ] | [options: O & {
     schema: TSchema;
 }]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E>;
 
-interface NoyaStateProviderProps<S, M, E> extends Omit<UseNoyaStateOptions<S, M, E>, "schema" | "mergeHistoryEntries"> {
+interface NoyaStateProviderProps<S, M, E extends object> extends Omit<UseNoyaStateOptions<S, M, E>, "schema" | "mergeHistoryEntries"> {
     children: React.ReactNode;
     initialState?: S;
+    fallback?: React.ReactNode;
 }
 declare function useAssets(): _noya_app_state_manager.Asset[];
 declare function useAsset(id: string | undefined): _noya_app_state_manager.Asset | undefined;
@@ -174,13 +163,29 @@ declare function useAssetManager(): {
     create: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     delete: (id: string) => Promise<void>;
 };
-declare function createNoyaContext<Schema extends TSchema, M = void, E = void>({ schema, mergeHistoryEntries, }: {
+declare function useAIManager(): AIManager;
+declare function useSecretManager(): SecretManager$1;
+declare function useSecrets(): _noya_app_state_manager.Secret[];
+declare function useSecret(name: string): _noya_app_state_manager.Secret | undefined;
+declare function useIsInitialized(): boolean;
+declare function useWorkflowManager(): WorkflowManager;
+declare const ConnectedUsersContext: React.Context<ConnectedUsersManager | undefined>;
+declare function useConnectedUsersManager(): ConnectedUsersManager | undefined;
+declare const AnyEphemeralUserDataManagerContext: React.Context<EphemeralUserDataManager<object> | undefined>;
+declare function useAnyEphemeralUserData(): EphemeralUserDataManager<object> | undefined;
+declare function useCurrentUserId(): string | undefined;
+declare const FallbackUntilInitialized: ({ children, fallback, }: {
+    children: React.ReactNode;
+    fallback?: React.ReactNode;
+}) => React.ReactNode;
+declare function createNoyaContext<Schema extends TSchema, M = void, E extends object = object>({ schema, mergeHistoryEntries, }: {
     schema: Schema;
     mergeHistoryEntries?: StateManagerOptions<Static<Schema>, M>["mergeHistoryEntries"];
 }): {
     Context: React.Context<{
         ms: MultiplayerStateManager<Static<Schema>, M>;
         assetManager: AssetManager;
+        secretManager: SecretManager$1;
     } | undefined>;
     Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Static<Schema>, M, E>) => React.JSX.Element;
     useValue: {
@@ -198,9 +203,14 @@ declare function createNoyaContext<Schema extends TSchema, M = void, E = void>({
         <P extends PathKey[] | string>(path?: P): [GetAtPath<Static<Schema>, P>, M extends {} ? (metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void : (value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void];
     };
     useStateManager: () => MultiplayerStateManager<Static<Schema>, M>;
+    useEphemeralUserDataManager: () => EphemeralUserDataManager<E>;
 };
 
 declare function useObservable<T>(observable: Observable<T>): T;
+declare function useObservable<T, A>(observable: Observable<T>, selector: (value: T) => A, options?: Pick<ObservableOptions, "isEqual">): A;
 declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T>, path: P): GetAtPath<T, P>;
+declare function useObservable<T>(observable: Observable<T> | undefined): T | undefined;
+declare function useObservable<T, A>(observable: Observable<T> | undefined, selector: (value: T) => A, options?: Pick<ObservableOptions, "isEqual">): A | undefined;
+declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T> | undefined, path: P): GetAtPath<T, P> | undefined;
 
-export { type AppData, type AppTheme, type AppViewType, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, UserNameTag, UserPointer, UserPointerContainer, type UserPointerData, UserPointerIcon, type UserPointerProps, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, getAvatarInitials, getAvatarStyle, isEmbeddedApp, parseAppDataParameter, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useEphemeralUserData, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSyncMultiplayerStateManager, useSyncStateManager };
+export { AnyEphemeralUserDataManagerContext, type AppData, type AppTheme, type AppViewType, ConnectedUsersContext, FallbackUntilInitialized, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, type RenderUserPointer, type RenderUserPointerProps, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, type UserPointerData, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, isEmbeddedApp, parseAppDataParameter, useAIManager, useAnyEphemeralUserData, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useConnectedUsersManager, useCurrentUserId, useIsInitialized, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSecret, useSecretManager, useSecrets, useSyncMultiplayerStateManager, useSyncStateManager, useWorkflowManager };

package/dist/index.d.ts

@@ -1,19 +1,8 @@
 import * as _noya_app_state_manager from '@noya-app/state-manager';
-import { MultiplayerUser, EphemeralUserData, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, TSchema, Static } from '@noya-app/state-manager';
+import { ConnectedUsersManager, EphemeralUserDataManager, RPCManager, StandardRPCRequestPayload, StandardRPCResponsePayload, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, SecretManager as SecretManager$1, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, AIManager, WorkflowManager, TSchema, Static } from '@noya-app/state-manager';
 export * from '@noya-app/state-manager';
-import React, { ComponentPropsWithoutRef, SetStateAction } from 'react';
-import { GetAtPath, ObservableOptions, PathKey, Observable } from '@noya-app/observable';
-
-declare function getAvatarInitials(name: string): string;
-/**
- * Create a background color and initials from a name
- *
- * Adapted from https://mui.com/material-ui/react-avatar/
- */
-declare function getAvatarStyle(name: string): {
-    color: string;
-    backgroundColor: string;
-};
+import React, { SetStateAction } from 'react';
+import { Observable, GetAtPath, ObservableOptions, PathKey } from '@noya-app/observable';
 
 type Point = {
     x: number;
@@ -22,76 +11,75 @@ type Point = {
 type UserPointerData = {
     pointer?: Point;
 };
-type UserPointerProps<E extends UserPointerData> = {
-    user: MultiplayerUser;
-    ephemeralUserData: EphemeralUserData<E>;
-    hideAfter?: number;
-};
-declare const UserPointer_: <E extends UserPointerData>({ user, ephemeralUserData, hideAfter, }: UserPointerProps<E>) => React.JSX.Element | null;
-declare const UserPointer: typeof UserPointer_;
-declare const UserPointerContainer: React.NamedExoticComponent<{
+type RenderUserPointerProps = {
+    userId: string;
+    name?: string;
+    visible: boolean;
     point: Point;
-    children: React.ReactNode;
-    show?: boolean;
-}>;
-declare const UserNameTag: React.NamedExoticComponent<{
-    background: string;
-    children: React.ReactNode;
-}>;
+};
+type RenderUserPointer = {
+    renderUserPointer: (options: RenderUserPointerProps) => React.ReactNode;
+};
 type UserPointersOverlayProps<E extends UserPointerData> = {
-    connectedUsers: MultiplayerUser[];
-    ephemeralUserData: EphemeralUserData<E>;
+    connectedUsersManager: ConnectedUsersManager;
+    ephemeralUserDataManager: EphemeralUserDataManager<E>;
+} & RenderUserPointer;
+declare const UserPointersOverlay: <E extends UserPointerData>(props: UserPointersOverlayProps<E>) => React.ReactElement | null;
+
+type Secret = {
+    id: string;
+    name: string;
 };
-declare const UserPointersOverlay: React.MemoExoticComponent<(<E extends UserPointerData>({ connectedUsers, ephemeralUserData }: UserPointersOverlayProps<E>) => React.JSX.Element)>;
-declare const UserPointerIcon: React.NamedExoticComponent<{
-    color?: string;
-}>;
+declare class SecretManager {
+    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
+    constructor(rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>);
+    secrets$: Observable<Secret[]>;
+    isInitialized$: Observable<boolean>;
+    createSecret(name: string, value: string): Promise<StandardRPCResponsePayload>;
+    deleteSecret(name: string): Promise<StandardRPCResponsePayload>;
+}
 
 type StateInspectorAnchor = "left" | "right" | "bottom left" | "bottom right";
 type StateInspectorOptions = {
     colorScheme?: "light" | "dark";
     anchor?: StateInspectorAnchor;
 };
-declare const StateInspector: React.MemoExoticComponent<(<S, M, E>({ state, connectionEvents, connectedUsers, tasks, userId, unstyled, colorScheme, multiplayerStateManager, assetManager, ephemeralUserData, anchor, forceInit, ...props }: {
+declare const StateInspector: <S, M, E extends object>(props: {
     state: S;
     connectionEvents?: ConnectionEvent<S>[];
-    connectedUsers?: MultiplayerUser[];
     tasks?: Task[];
-    userId?: string;
     unstyled?: boolean;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assetManager: AssetManager;
-    ephemeralUserData: EphemeralUserData<E>;
+    connectedUsersManager: ConnectedUsersManager;
+    secretManager: SecretManager$1;
+    ephemeralUserDataManager: EphemeralUserDataManager<E>;
     forceInit: () => void;
-} & StateInspectorOptions & ComponentPropsWithoutRef<"div">) => React.JSX.Element | null)>;
+} & StateInspectorOptions & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">) => React.ReactElement | null;
 
 declare function useSyncStateManager<S, M>(stateManager: StateManager<S, M>): S;
 declare function useSyncStateManager<S, M, P extends string>(stateManager: StateManager<S, M>, path: P): GetAtPath<S, P>;
 declare function useManagedState<S, M = void>(createInitialState: () => S, options?: StateManagerOptions<S, M>): readonly [S, (...args: M extends {} ? [metadata: M, action: SetStateAction<S>] : [action: SetStateAction<S>]) => void, StateManager<S, M>];
 declare function useManagedHistory<S, M = void>(stateManager: StateManager<S, M>): _noya_app_state_manager.HistorySnapshot<S, M>;
 declare function useSyncMultiplayerStateManager<S, M = void>(multiplayerStateManager: MultiplayerStateManager<S, M>): S;
-declare function useEphemeralUserData<E>(ephemeralUserData: EphemeralUserData<E>, options?: {
-    throttle?: number;
-}): {
-    data: Record<string, E | undefined>;
-    metadata: Record<string, _noya_app_state_manager.EphemeralUserMetadata | undefined>;
-    currentUserId: string | undefined;
-};
-type UseMultiplayerStateOptions<S, M = void, E = void> = MultiplayerStateManagerOptions<S, M> & {
-    sync?: (options: Pick<SyncAdapterOptions<S, M, E>, "ms" | "ephemeralUserData" | "assetManager">) => void;
+type UseMultiplayerStateOptions<S, M = void, E extends object = object> = MultiplayerStateManagerOptions<S, M> & {
+    sync?: (options: Pick<SyncAdapterOptions<S, M, E>, "ms" | "ephemeralUserDataManager" | "assetManager">) => void;
     trackConnectionEvents?: boolean;
     trackTasks?: boolean;
     inspector?: boolean | StateInspectorOptions;
 };
-declare function useMultiplayerState<S, M = void, E = void>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E>): readonly [S, (...args: M extends {} ? [metadata: M, action: S | ((prevState: S) => S)] : [action: S | ((prevState: S) => S)]) => void, {
+declare function useMultiplayerState<S, M = void, E extends object = object>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E>): readonly [S, (...args: M extends {} ? [metadata: M, action: S | ((prevState: S) => S)] : [action: S | ((prevState: S) => S)]) => void, {
     tasks: Task[];
-    userId: string | undefined;
     connectionEvents: ConnectionEvent<S>[] | undefined;
-    connectedUsers: MultiplayerUser[];
-    ephemeralUserData: EphemeralUserData<E>;
+    connectedUsersManager: ConnectedUsersManager;
+    ephemeralUserDataManager: EphemeralUserDataManager<E>;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assets: _noya_app_state_manager.Asset[];
     assetManager: AssetManager;
+    aiManager: AIManager;
+    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
+    workflowManager: WorkflowManager;
+    secretManager: SecretManager;
     createAsset: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     deleteAsset: (id: string) => Promise<void>;
 }];
@@ -134,13 +122,13 @@ type HostToIframeMessage = {
         value: string;
     };
 };
-declare function useBroadcastConnectedUsers(connectedUsers: MultiplayerUser[]): void;
+declare function useBroadcastConnectedUsers(connectedUsersManager: ConnectedUsersManager): void;
 declare function useBroadcastMenuItems<T>(menuItems: any[], handleSelectMenuItem: (value: T) => void): void;
 declare function isEmbeddedApp(): boolean;
-type UseNoyaStateOptions<S, M = void, E = void> = UseMultiplayerStateOptions<S, M, E> & {
+type UseNoyaStateOptions<S, M = void, E extends object = object> = UseMultiplayerStateOptions<S, M, E> & {
     offlineStorageKey?: string;
 };
-type UseNoyaStateResult<S, M = void, E = void> = [
+type UseNoyaStateResult<S, M = void, E extends object = object> = [
     ReturnType<typeof useMultiplayerState<S, M, E>>[0],
     ReturnType<typeof useMultiplayerState<S, M, E>>[1],
     ReturnType<typeof useMultiplayerState<S, M, E>>[2] & {
@@ -157,16 +145,17 @@ type UseNoyaStateResult<S, M = void, E = void> = [
  * 2. Pass an initial state and a schema: `useNoyaState(initialState, { schema })`
  * 3. Pass only a schema, and a conforming initial state is created automatically: `useNoyaState({ schema })`
  */
-declare function useNoyaState<S, M = void, E = void, O extends UseNoyaStateOptions<S, M, E> = UseNoyaStateOptions<S, M, E>>(...args: [
+declare function useNoyaState<S, M = void, E extends object = object, O extends UseNoyaStateOptions<S, M, E> = UseNoyaStateOptions<S, M, E>>(...args: [
     initialState: O["schema"] extends TSchema ? Static<O["schema"]> | (() => Static<O["schema"]>) : S | (() => S),
     options?: O
 ] | [options: O & {
     schema: TSchema;
 }]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E>;
 
-interface NoyaStateProviderProps<S, M, E> extends Omit<UseNoyaStateOptions<S, M, E>, "schema" | "mergeHistoryEntries"> {
+interface NoyaStateProviderProps<S, M, E extends object> extends Omit<UseNoyaStateOptions<S, M, E>, "schema" | "mergeHistoryEntries"> {
     children: React.ReactNode;
     initialState?: S;
+    fallback?: React.ReactNode;
 }
 declare function useAssets(): _noya_app_state_manager.Asset[];
 declare function useAsset(id: string | undefined): _noya_app_state_manager.Asset | undefined;
@@ -174,13 +163,29 @@ declare function useAssetManager(): {
     create: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     delete: (id: string) => Promise<void>;
 };
-declare function createNoyaContext<Schema extends TSchema, M = void, E = void>({ schema, mergeHistoryEntries, }: {
+declare function useAIManager(): AIManager;
+declare function useSecretManager(): SecretManager$1;
+declare function useSecrets(): _noya_app_state_manager.Secret[];
+declare function useSecret(name: string): _noya_app_state_manager.Secret | undefined;
+declare function useIsInitialized(): boolean;
+declare function useWorkflowManager(): WorkflowManager;
+declare const ConnectedUsersContext: React.Context<ConnectedUsersManager | undefined>;
+declare function useConnectedUsersManager(): ConnectedUsersManager | undefined;
+declare const AnyEphemeralUserDataManagerContext: React.Context<EphemeralUserDataManager<object> | undefined>;
+declare function useAnyEphemeralUserData(): EphemeralUserDataManager<object> | undefined;
+declare function useCurrentUserId(): string | undefined;
+declare const FallbackUntilInitialized: ({ children, fallback, }: {
+    children: React.ReactNode;
+    fallback?: React.ReactNode;
+}) => React.ReactNode;
+declare function createNoyaContext<Schema extends TSchema, M = void, E extends object = object>({ schema, mergeHistoryEntries, }: {
     schema: Schema;
     mergeHistoryEntries?: StateManagerOptions<Static<Schema>, M>["mergeHistoryEntries"];
 }): {
     Context: React.Context<{
         ms: MultiplayerStateManager<Static<Schema>, M>;
         assetManager: AssetManager;
+        secretManager: SecretManager$1;
     } | undefined>;
     Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Static<Schema>, M, E>) => React.JSX.Element;
     useValue: {
@@ -198,9 +203,14 @@ declare function createNoyaContext<Schema extends TSchema, M = void, E = void>({
         <P extends PathKey[] | string>(path?: P): [GetAtPath<Static<Schema>, P>, M extends {} ? (metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void : (value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void];
     };
     useStateManager: () => MultiplayerStateManager<Static<Schema>, M>;
+    useEphemeralUserDataManager: () => EphemeralUserDataManager<E>;
 };
 
 declare function useObservable<T>(observable: Observable<T>): T;
+declare function useObservable<T, A>(observable: Observable<T>, selector: (value: T) => A, options?: Pick<ObservableOptions, "isEqual">): A;
 declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T>, path: P): GetAtPath<T, P>;
+declare function useObservable<T>(observable: Observable<T> | undefined): T | undefined;
+declare function useObservable<T, A>(observable: Observable<T> | undefined, selector: (value: T) => A, options?: Pick<ObservableOptions, "isEqual">): A | undefined;
+declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T> | undefined, path: P): GetAtPath<T, P> | undefined;
 
-export { type AppData, type AppTheme, type AppViewType, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, UserNameTag, UserPointer, UserPointerContainer, type UserPointerData, UserPointerIcon, type UserPointerProps, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, getAvatarInitials, getAvatarStyle, isEmbeddedApp, parseAppDataParameter, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useEphemeralUserData, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSyncMultiplayerStateManager, useSyncStateManager };
+export { AnyEphemeralUserDataManagerContext, type AppData, type AppTheme, type AppViewType, ConnectedUsersContext, FallbackUntilInitialized, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, type RenderUserPointer, type RenderUserPointerProps, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, type UserPointerData, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, isEmbeddedApp, parseAppDataParameter, useAIManager, useAnyEphemeralUserData, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useConnectedUsersManager, useCurrentUserId, useIsInitialized, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSecret, useSecretManager, useSecrets, useSyncMultiplayerStateManager, useSyncStateManager, useWorkflowManager };