@phreshos/react 0.1.2 → 0.1.3

package/README.md

@@ -24,9 +24,10 @@ It provides two kinds of adapter:
   `usePointerPosition()` expose those values synchronously after resolution.
 - `useSubscribe()` and `useObserve()` own persistent ordinary-event
   registrations for one mounted React consumer.
-- `useProgramState(program)`, `useProcessState(process)`, and
-  `useWindowState(window)` explicitly compose existing reads with future live
-  events for one mounted consumer. They add no state operation to another SDK.
+- `useProgramState(program)`, `useProcessState(process)`,
+  `useServiceState(service)`, and `useWindowState(window)` explicitly compose
+  existing reads with future live events for one mounted consumer. They add no
+  state operation to another SDK.
 - `useObserveAsks()` adapts an Endpoint traffic surface's question observation,
   while `useObserveAnswers()` adapts a Server traffic surface's answer
   observation.
@@ -48,6 +49,9 @@ useProgramState(program)
 useProcessState(process)
 // { exited, serverExists, clientExists } | undefined
 
+useServiceState(service)
+// { disabled } | undefined
+
 useWindowState(window)
 // WindowState | undefined
 ```

package/dist/main.d.ts

@@ -6,6 +6,7 @@ export { default as useScale } from "./use-scale.js";
 export { default as useColor } from "./use-color.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 useServiceState, type ServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";
 export { default as useObserveAsks, type AskObservable } from "./use-observe-asks.js";
 export { default as useObserveAnswers, type AnswerObservable } from "./use-observe-answers.js";

package/dist/main.js

@@ -6,6 +6,7 @@ export { default as useScale } from "./use-scale.js";
 export { default as useColor } from "./use-color.js";
 export { default as useProgramState } from "./use-program-state.js";
 export { default as useProcessState } from "./use-process-state.js";
+export { default as useServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";
 export { default as useObserveAsks } from "./use-observe-asks.js";
 export { default as useObserveAnswers } from "./use-observe-answers.js";

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

@@ -0,0 +1,7 @@
+import type { ServiceHandler } from "@phreshos/client";
+/** Live availability of one exact service identity. */
+export type ServiceState = Readonly<{
+    disabled: boolean;
+}>;
+/** Explicitly reads and follows one service while this hook is mounted. */
+export default function useServiceState(service: ServiceHandler): ServiceState | undefined;

package/dist/use-service-state.js

@@ -0,0 +1,10 @@
+import { useMemo, useSyncExternalStore } from "react";
+import LiveState, { combineCleanups } from "./live-state.js";
+/** Explicitly reads and follows one service while this hook is mounted. */
+export default function useServiceState(service) {
+    const state = useMemo(() => new LiveState(async () => ({ disabled: await service.disabled() }), reduce => combineCleanups(service.subscribe("enable", () => reduce(current => setDisabled(current, false))), service.subscribe("disable", () => reduce(current => setDisabled(current, true))))), [service]);
+    return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+}
+function setDisabled(state, disabled) {
+    return state.disabled === disabled ? state : { disabled };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "React adapters for the Client SDK.",
   "type": "module",
   "main": "dist/main.js",
@@ -47,13 +47,13 @@
     "prepack": "node --run test && node --run build"
   },
   "peerDependencies": {
-    "@phreshos/client": "^0.1.2",
-    "@phreshos/core": "^0.1.2",
+    "@phreshos/client": "^0.1.3",
+    "@phreshos/core": "^0.1.3",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/client": "^0.1.2",
-    "@phreshos/core": "^0.1.2",
+    "@phreshos/client": "^0.1.3",
+    "@phreshos/core": "^0.1.3",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",