@phreshos/react 0.1.25 → 0.1.27

package/dist/desktop-provider.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import type { Desktop, DesktopPreferences, DesktopViewportSnapshot } from "@phreshos/core";
+import type { Connection, Desktop, DesktopPreferences, DesktopViewportSnapshot } from "@phreshos/core";
 import LiveSnapshot from "./live-snapshot.js";
 /** Provides one complete Client Desktop environment to a React tree. */
 export default function DesktopProvider({ children, desktop, fallback }: DesktopProviderProperties): string | number | bigint | boolean | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").FunctionComponentElement<import("react").ProviderProps<Readonly<{
@@ -13,6 +13,8 @@ export declare function useDesktop(): Desktop;
 export declare function useDesktopViewport(): DesktopViewportSnapshot;
 /** Resolves and follows the effective Desktop preferences. */
 export declare function useDesktopPreferences(): DesktopPreferences;
+/** Resolves the browser Connection carrying this Desktop when explicitly used. */
+export declare function useDesktopConnection(): Connection | undefined;
 export type DesktopProviderProperties = Readonly<{
     children: ReactNode;
     desktop: Desktop;

package/dist/desktop-provider.js

@@ -1,5 +1,6 @@
 import { createContext, createElement, useContext as useReactContext, useMemo, useSyncExternalStore } from "react";
 import LiveSnapshot from "./live-snapshot.js";
+import LiveState from "./live-state.js";
 import useProviderResolution from "./provider-resolution.js";
 const DesktopContext = createContext(null);
 /** Provides one complete Client Desktop environment to a React tree. */
@@ -27,6 +28,12 @@ export function useDesktopPreferences() {
     const store = useValue().preferences;
     return useSyncExternalStore(store.subscribe, store.snapshot, store.snapshot);
 }
+/** Resolves the browser Connection carrying this Desktop when explicitly used. */
+export function useDesktopConnection() {
+    const desktop = useDesktop();
+    const state = useMemo(() => new LiveState(() => desktop.connection(), () => () => undefined), [desktop]);
+    return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+}
 function useValue() {
     const value = useReactContext(DesktopContext);
     if (!value)

package/dist/main.d.ts

@@ -1,9 +1,11 @@
 export { default as ContextProvider, useContext, useParent, useProcess, useProgram, type ContextProviderProperties } from "./context-provider.js";
 export { default as SystemProvider, useSystem, useSystemAppearance, type SystemProviderProperties } from "./system-provider.js";
-export { default as DesktopProvider, useDesktop, useDesktopViewport, useDesktopPreferences, type DesktopProviderProperties } from "./desktop-provider.js";
+export { default as DesktopProvider, useDesktop, useDesktopConnection, useDesktopViewport, useDesktopPreferences, type DesktopProviderProperties } from "./desktop-provider.js";
 export { default as useSubscribe } from "./use-subscribe.js";
 export { default as useProgramState, type ProgramState } from "./use-program-state.js";
 export { default as useProcessState, type ProcessState } from "./use-process-state.js";
+export { default as useConnectionState, type ConnectionState } from "./use-connection-state.js";
+export { default as useSessionState, type SessionState } from "./use-session-state.js";
 export { default as useEndpointState, type EndpointState } from "./use-endpoint-state.js";
 export { default as useServiceState, type ServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";

package/dist/main.js

@@ -1,9 +1,11 @@
 export { default as ContextProvider, useContext, useParent, useProcess, useProgram } from "./context-provider.js";
 export { default as SystemProvider, useSystem, useSystemAppearance } from "./system-provider.js";
-export { default as DesktopProvider, useDesktop, useDesktopViewport, useDesktopPreferences } from "./desktop-provider.js";
+export { default as DesktopProvider, useDesktop, useDesktopConnection, useDesktopViewport, useDesktopPreferences } from "./desktop-provider.js";
 export { default as useSubscribe } from "./use-subscribe.js";
 export { default as useProgramState } from "./use-program-state.js";
 export { default as useProcessState } from "./use-process-state.js";
+export { default as useConnectionState } from "./use-connection-state.js";
+export { default as useSessionState } from "./use-session-state.js";
 export { default as useEndpointState } from "./use-endpoint-state.js";
 export { default as useServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";

package/dist/use-connection-state.d.ts

@@ -0,0 +1,8 @@
+import type { Connection, Session } from "@phreshos/core";
+/** Mutable authorization state of one browser Connection. */
+export type ConnectionState = Readonly<{
+    connected: boolean;
+    session: Session | null;
+}>;
+/** Explicitly reads and follows one Connection while this hook is mounted. */
+export default function useConnectionState(connection: Connection): ConnectionState | undefined;

package/dist/use-connection-state.js

@@ -0,0 +1,19 @@
+import { useMemo, useSyncExternalStore } from "react";
+import LiveState, { combineCleanups } from "./live-state.js";
+/** Explicitly reads and follows one Connection while this hook is mounted. */
+export default function useConnectionState(connection) {
+    const state = useMemo(() => new LiveState(async () => {
+        const [connected, session] = await Promise.all([
+            connection.connected(),
+            connection.session()
+        ]);
+        return { connected, session };
+    }, reduce => combineCleanups(connection.subscribe("sessionChange", session => reduce(current => setSession(current, session))), connection.subscribe("disconnect", () => reduce(current => disconnect(current))))), [connection]);
+    return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+}
+function setSession(state, session) {
+    return state.session === session ? state : { ...state, session };
+}
+function disconnect(state) {
+    return !state.connected && state.session === null ? state : { connected: false, session: null };
+}

package/dist/use-program-state.js

@@ -5,10 +5,10 @@ export default function useProgramState(program) {
     const state = useMemo(() => new LiveState(async () => {
         const [installed, processes] = await Promise.all([
             program.installed(),
-            program.process.list()
+            program.processes()
         ]);
         return { installed, processes };
-    }, reduce => combineCleanups(program.process.subscribe("create", process => reduce(current => addProcess(current, process))), program.process.subscribe("exit", ({ process }) => reduce(current => removeProcess(current, process))), program.subscribe("uninstall", () => reduce(current => current.installed ? { ...current, installed: false } : current)))), [program]);
+    }, reduce => combineCleanups(program.subscribe("processCreate", process => reduce(current => addProcess(current, process))), program.subscribe("processExit", ({ process }) => reduce(current => removeProcess(current, process))), program.subscribe("uninstall", () => reduce(current => current.installed ? { ...current, installed: false } : current)))), [program]);
     return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }
 function addProcess(state, process) {

package/dist/use-session-state.d.ts

@@ -0,0 +1,8 @@
+import type { Connection, Session } from "@phreshos/core";
+/** Mutable lifecycle state of one authentication Session. */
+export type SessionState = Readonly<{
+    valid: boolean;
+    connections: readonly Connection[];
+}>;
+/** Explicitly reads and follows one Session while this hook is mounted. */
+export default function useSessionState(session: Session): SessionState | undefined;

package/dist/use-session-state.js

@@ -0,0 +1,25 @@
+import { useMemo, useSyncExternalStore } from "react";
+import LiveState, { combineCleanups } from "./live-state.js";
+/** Explicitly reads and follows one Session while this hook is mounted. */
+export default function useSessionState(session) {
+    const state = useMemo(() => new LiveState(async () => {
+        const [valid, connections] = await Promise.all([
+            session.valid(),
+            session.connections()
+        ]);
+        return { valid, connections };
+    }, reduce => combineCleanups(session.subscribe("connectionAttach", connection => reduce(current => attach(current, connection))), session.subscribe("connectionDetach", connection => reduce(current => detach(current, connection))), session.subscribe("end", () => reduce(current => end(current))))), [session]);
+    return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+}
+function attach(state, connection) {
+    if (state.connections.includes(connection))
+        return state;
+    return { ...state, connections: [...state.connections, connection] };
+}
+function detach(state, connection) {
+    const connections = state.connections.filter(candidate => candidate !== connection);
+    return connections.length === state.connections.length ? state : { ...state, connections };
+}
+function end(state) {
+    return !state.valid && state.connections.length === 0 ? state : { valid: false, connections: [] };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Runtime-neutral React adapters for PhreshOS contracts.",
   "type": "module",
   "main": "dist/main.js",
@@ -46,11 +46,11 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.49",
+    "@phreshos/core": "^0.1.52",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.49",
+    "@phreshos/core": "^0.1.52",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",