@sanity/workflow-studio 0.9.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @sanity/workflow-studio
 
+## 0.20.0
+
+### Minor Changes
+
+- e860898: **BREAKING:** Published Editorial Workflows packages now ship as one fixed release stack and require exact-version peers for every shared runtime package. Install the matching stack so the engine, reactive core, adapters, tools, and UI cannot silently load private or version-skewed copies.
+- e3122cc: `useWorkflowSession` gains `guardScope` — the co-mounted session id-set passed through to the observer so guard observation consolidates into one shared live query per resource.
+
+### Patch Changes
+
+- bce09fc: Restore automatic effect request tags while preserving concrete handler client APIs, backed by native request-prefix support in the test client.
+- ab5e454: Keep one indexed project-member directory per Studio client, batch profile requests, and back off failed loads.
+- Updated dependencies [ab5e454]
+- Updated dependencies [bce09fc]
+- Updated dependencies [efb4cd9]
+- Updated dependencies [46b0285]
+- Updated dependencies [ab5e454]
+- Updated dependencies [8a76c67]
+- Updated dependencies [e3122cc]
+- Updated dependencies [e3122cc]
+- Updated dependencies [7e8f459]
+- Updated dependencies [98e488e]
+- Updated dependencies [7c4dd86]
+- Updated dependencies [e860898]
+  - @sanity/workflow-sdk@0.20.0
+  - @sanity/workflow-engine@0.20.0
+  - @sanity/workflow-react@0.20.0
+
+## 0.10.0
+
+### Minor Changes
+
+- 767497c: **BREAKING:** reactive instance-list reads are per-row tolerant. `WorkflowInstanceList` replaces `invalid: InvalidDoc | undefined` with `unreadable: readonly InvalidDoc[]`: rows the engine's read discipline refuses are skipped from `instances` and flagged there, so one bad row no longer sinks the whole listing (a silently short list stays impossible — the refused rows are always named). `ObservedInstances` becomes `{instances, unreadable}` to carry the same split through the observer contract. The engine's own stateless list reads stay wholesale; single-instance and guard streams keep their explicit invalid states.
+
+### Patch Changes
+
+- Updated dependencies [24b11dd]
+- Updated dependencies [2005ab7]
+- Updated dependencies [767497c]
+- Updated dependencies [24b11dd]
+- Updated dependencies [59b40fd]
+  - @sanity/workflow-engine@0.19.0
+  - @sanity/workflow-react@0.14.0
+  - @sanity/workflow-sdk@0.11.0
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -26,17 +26,19 @@ Studio source context (`useSource` / `useClient`).
   set) instead of an eternal spinner.
 - `useWorkflowInstances` / `useDocumentWorkflows` — live instance lists
   (filterable collection / per-document discovery), each returning
-  `{instances, loading, invalid, error}` through the App SDK query store. Hooks
-  under one Studio source share the auto-bootstrapped SDK instance; callers can
-  instead pass a shared `sdk` explicitly. SDK store errors surface reactively
-  through `error`.
+  `{instances, loading, unreadable, error}` through the App SDK query store —
+  rows the read discipline refuses are skipped from `instances` and flagged
+  in `unreadable`. Hooks under one Studio source share the auto-bootstrapped
+  SDK instance; callers can instead pass a shared `sdk` explicitly. SDK store
+  errors surface reactively through `error`.
 - `useStudioProjectUsers` — the shared Studio project-user directory used by
   actor resolution and member pickers. It returns the upstream membership and
   profile records without an Editorial Workflows projection, plus the engine's
-  `ProjectUserDirectory` integration. Concurrent loads are coalesced and a
-  settled snapshot is reused for 30 seconds before mutable user data is
-  refreshed. `studioProjectUserDirectory` provides the same contract outside
-  React when a Studio client and project ID are already available.
+  `ProjectUserDirectory` integration. Concurrent loads are coalesced, the
+  settled successful directory is reused for the client/project lifetime, and
+  failed loads retry after a 30-second backoff. `studioProjectUserDirectory`
+  provides the same contract outside React when a Studio client and project ID
+  are already available.
 
 ## How observation routes
 
@@ -84,6 +86,8 @@ This adapter composes `@sanity/workflow-sdk`'s store layer through its headless
 `./observer` entry. What that means for installs:
 
 - **`@sanity/sdk` is required** (peer) — it addresses every observed resource.
+- **`@sanity/workflow-engine` is required** (peer) — the host and adapter share one engine runtime.
+- **`@sanity/workflow-react` and `@sanity/workflow-sdk` are required** (exact-version peers) — install the matching Editorial Workflows release stack so the reactive context and SDK store are single-sourced.
 - **`@sanity/sdk-react` is NOT required** — nothing here touches the App
   SDK's React binding.
 

package/dist/index.cjs

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
     value: !0
 });
 
-var observer = require("@sanity/workflow-react/observer"), observer$1 = require("@sanity/workflow-sdk/observer"), sdk = require("@sanity/sdk"), workflowEngine = require("@sanity/workflow-engine"), react = require("react"), sanity = require("sanity"), workflowReact = require("@sanity/workflow-react");
+var observer = require("@sanity/workflow-react/observer"), observer$1 = require("@sanity/workflow-sdk/observer"), sdk = require("@sanity/sdk"), workflowEngine = require("@sanity/workflow-engine"), react = require("react"), sanity = require("sanity"), workflowReact = require("@sanity/workflow-react"), projectUsers = require("@sanity/workflow-sdk/project-users");
 
 function makeStudioObserver(sdk2, options) {
     const {client: client, engineResource: engineResource} = options;
@@ -142,7 +142,7 @@ function studioResourceClients(client) {
     }) : void 0;
 }
 
-function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, sdk: sdk2}) {
+function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, guardScope: guardScope, sdk: sdk2}) {
     const observer2 = useStudioObserver({
         engine: engine,
         sdk: sdk2
@@ -152,6 +152,9 @@ function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromP
         instanceId: instanceId,
         observer: observer2,
         host: "studio",
+        ...guardScope !== void 0 ? {
+            guardScope: guardScope
+        } : {},
         opts: {
             grantsFromPath: grantsFromPath
         }
@@ -184,7 +187,7 @@ function useDocumentWorkflows({engine: engine, document: document, sdk: sdk2}) {
     });
 }
 
-const PROJECT_USERS_TTL_MS = 3e4;
+const PROJECT_USERS_RETRY_MS = 3e4;
 
 function isRecord(value) {
     return typeof value == "object" && value !== null && !Array.isArray(value);
@@ -198,10 +201,6 @@ function isMembership(value) {
     return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
 }
 
-function isUser(value) {
-    return isRecord(value) && typeof value.id == "string" && (value.email === void 0 || typeof value.email == "string") && (value.displayName === void 0 || typeof value.displayName == "string") && (value.imageUrl === void 0 || value.imageUrl === null || typeof value.imageUrl == "string");
-}
-
 async function fetchProjectUsers(client, projectId) {
     const project = await client.request({
         uri: `/projects/${projectId}`
@@ -211,9 +210,11 @@ async function fetchProjectUsers(client, projectId) {
     if (!membershipRows.every(isMembership)) throw new Error("Studio project user response contained an invalid membership row");
     const memberships = membershipRows.filter(member => !member.isRobot);
     if (memberships.length === 0) return [];
-    const ids = memberships.map(member => encodeURIComponent(member.id)), response = await client.request({
-        uri: `/projects/${projectId}/users/${ids.join(",")}`
-    }), profiles = (Array.isArray(response) ? response : [ response ]).filter(isUser), profileById = new Map(profiles.map(profile => [ profile.id, profile ]));
+    const profiles = await projectUsers.loadProjectUserProfiles({
+        client: client,
+        projectId: projectId,
+        ids: memberships.map(member => member.id)
+    }), profileById = new Map(profiles.map(profile => [ profile.id, profile ]));
     return memberships.map(membership => ({
         membership: membership,
         profile: profileById.get(membership.id)
@@ -222,6 +223,40 @@ async function fetchProjectUsers(client, projectId) {
 
 const projectUsersByClient = /* @__PURE__ */ new WeakMap;
 
+function createProjectUsersStore(client, projectId) {
+    let snapshot = {
+        users: [],
+        loading: !1,
+        error: void 0
+    }, pending, retryAt = 0, usersById = /* @__PURE__ */ new Map, usersByEmail = /* @__PURE__ */ new Map;
+    const listeners = /* @__PURE__ */ new Set, setSnapshot = next => {
+        snapshot = next, listeners.forEach(listener => listener());
+    };
+    return {
+        getSnapshot: () => snapshot,
+        load: () => pending || (snapshot.users.length > 0 || snapshot.error === void 0 && retryAt === 1 / 0 ? Promise.resolve(snapshot.users) : snapshot.error !== void 0 && Date.now() < retryAt ? Promise.reject(snapshot.error) : (setSnapshot({
+            ...snapshot,
+            loading: !0,
+            error: void 0
+        }), pending = fetchProjectUsers(client, projectId).then(users => (usersById = new Map(users.map(user => [ user.membership.id, user ])), 
+        usersByEmail = new Map(users.flatMap(user => user.profile?.email ? [ [ user.profile.email.toLowerCase(), user ] ] : [])), 
+        retryAt = 1 / 0, setSnapshot({
+            users: users,
+            loading: !1,
+            error: void 0
+        }), pending = void 0, users), error => {
+            throw retryAt = Date.now() + PROJECT_USERS_RETRY_MS, setSnapshot({
+                users: [],
+                loading: !1,
+                error: error
+            }), pending = void 0, error;
+        }), pending)),
+        subscribe: listener => (listeners.add(listener), () => listeners.delete(listener)),
+        userByEmail: email => usersByEmail.get(email.toLowerCase()),
+        userById: id => usersById.get(id)
+    };
+}
+
 function clientProjectUsers(client) {
     const cached = projectUsersByClient.get(client);
     if (cached) return cached;
@@ -229,27 +264,20 @@ function clientProjectUsers(client) {
     return projectUsersByClient.set(client, created), created;
 }
 
-function loadProjectUsers(client, projectId) {
-    const projectUsers = clientProjectUsers(client), cached = projectUsers.get(projectId);
-    if (cached && cached.expiresAt > Date.now()) return cached.promise;
-    projectUsers.delete(projectId);
-    const pending = fetchProjectUsers(client, projectId), entry = {
-        promise: pending,
-        expiresAt: Number.POSITIVE_INFINITY
-    };
-    return projectUsers.set(projectId, entry), pending.then(() => {
-        entry.expiresAt = Date.now() + PROJECT_USERS_TTL_MS;
-    }, () => {
-        projectUsers.get(projectId) === entry && projectUsers.delete(projectId);
-    }), pending;
+function projectUsersStore(client, projectId) {
+    const projectUsers2 = clientProjectUsers(client), cached = projectUsers2.get(projectId);
+    if (cached) return cached;
+    const created = createProjectUsersStore(client, projectId);
+    return projectUsers2.set(projectId, created), created;
 }
 
 function studioProjectUserDirectory(client, projectId) {
-    const load = () => loadProjectUsers(client, projectId);
+    const store = projectUsersStore(client, projectId);
     return {
         findById: async id => {
             try {
-                const user = (await load()).find(candidate => candidate.membership.id === id);
+                await store.load();
+                const user = store.userById(id);
                 return user ? {
                     status: "resolved",
                     user: user
@@ -265,7 +293,8 @@ function studioProjectUserDirectory(client, projectId) {
         },
         findByEmail: async email => {
             try {
-                const normalized = email.toLowerCase(), user = (await load()).find(candidate => candidate.profile?.email?.toLowerCase() === normalized);
+                await store.load();
+                const user = store.userByEmail(email);
                 return user ? {
                     status: "resolved",
                     user: user
@@ -282,44 +311,19 @@ function studioProjectUserDirectory(client, projectId) {
     };
 }
 
+const missingProjectSnapshot = {
+    users: [],
+    loading: !1,
+    error: new Error("No projectId on the Studio client")
+}, noopSubscribe = () => () => {};
+
 function useStudioProjectUsers() {
     const client = sanity.useClient({
         apiVersion: workflowEngine.ENGINE_API_VERSION
-    }), projectId = client.config().projectId, directory = react.useMemo(() => projectId ? studioProjectUserDirectory(client, projectId) : void 0, [ client, projectId ]), [state, setState] = react.useState({
-        users: [],
-        loading: projectId !== void 0,
-        error: projectId === void 0 ? new Error("No projectId on the Studio client") : void 0
-    });
+    }), projectId = client.config().projectId, directory = react.useMemo(() => projectId ? studioProjectUserDirectory(client, projectId) : void 0, [ client, projectId ]), store = react.useMemo(() => projectId ? projectUsersStore(client, projectId) : void 0, [ client, projectId ]), state = react.useSyncExternalStore(store?.subscribe ?? noopSubscribe, store?.getSnapshot ?? (() => missingProjectSnapshot), store?.getSnapshot ?? (() => missingProjectSnapshot));
     return react.useEffect(() => {
-        if (!projectId) {
-            setState({
-                users: [],
-                loading: !1,
-                error: new Error("No projectId on the Studio client")
-            });
-            return;
-        }
-        let cancelled = !1;
-        return setState({
-            users: [],
-            loading: !0,
-            error: void 0
-        }), loadProjectUsers(client, projectId).then(users => {
-            cancelled || setState({
-                users: users,
-                loading: !1,
-                error: void 0
-            });
-        }, error => {
-            cancelled || setState({
-                users: [],
-                loading: !1,
-                error: error
-            });
-        }), () => {
-            cancelled = !0;
-        };
-    }, [ client, projectId ]), {
+        store && store.load().catch(() => {});
+    }, [ store ]), {
         ...state,
         directory: directory
     };

package/dist/index.d.cts

@@ -7,10 +7,10 @@ import type { InstancesQueryFilter } from "@sanity/workflow-engine";
 import { MissingHandlerPolicy } from "@sanity/workflow-engine";
 import { MutationGuardDoc } from "@sanity/workflow-react";
 import { ProjectUserDirectory } from "@sanity/workflow-engine";
+import { ProjectUserProfile } from "@sanity/workflow-sdk/project-users";
 import { ResourceClientResolver } from "@sanity/workflow-engine";
 import { SanityClient } from "sanity";
 import { SanityInstance } from "@sanity/sdk";
-import { User } from "sanity";
 import { WorkflowInstanceList } from "@sanity/workflow-react";
 import { WorkflowObserver } from "@sanity/workflow-react/observer";
 import { WorkflowResource } from "@sanity/workflow-engine";
@@ -81,12 +81,13 @@ declare interface StudioUserClient {
   readonly config: () => {
     readonly projectId?: string;
   };
-  readonly request: (options: { readonly uri: string }) => Promise<unknown>;
+  readonly request: (options: {
+    readonly uri: string;
+    readonly tag?: string;
+  }) => Promise<unknown>;
 }
 
-/** Native Studio profile response, whose nullable avatar is wider than Sanity's public type. */
-export declare interface StudioUserProfile extends Omit<User, "imageUrl"> {
-  readonly imageUrl?: string | null;
+export declare interface StudioUserProfile extends ProjectUserProfile {
   readonly [key: string]: unknown;
 }
 
@@ -173,11 +174,17 @@ export declare function useWorkflowSession({
   engine,
   instanceId,
   grantsFromPath,
+  guardScope,
   sdk,
 }: {
   engine: Engine;
   instanceId: string;
   grantsFromPath?: string;
+  /** The id-set of every co-mounted session, handed identically to each one
+   *  so guard observation consolidates into one shared live query per
+   *  resource. Must include `instanceId`. Omitted, guards are observed per
+   *  instance. */
+  guardScope?: readonly string[];
   sdk?: SanityInstance;
 }): WorkflowSession;
 

package/dist/index.d.ts

@@ -7,10 +7,10 @@ import type { InstancesQueryFilter } from "@sanity/workflow-engine";
 import { MissingHandlerPolicy } from "@sanity/workflow-engine";
 import { MutationGuardDoc } from "@sanity/workflow-react";
 import { ProjectUserDirectory } from "@sanity/workflow-engine";
+import { ProjectUserProfile } from "@sanity/workflow-sdk/project-users";
 import { ResourceClientResolver } from "@sanity/workflow-engine";
 import { SanityClient } from "sanity";
 import { SanityInstance } from "@sanity/sdk";
-import { User } from "sanity";
 import { WorkflowInstanceList } from "@sanity/workflow-react";
 import { WorkflowObserver } from "@sanity/workflow-react/observer";
 import { WorkflowResource } from "@sanity/workflow-engine";
@@ -81,12 +81,13 @@ declare interface StudioUserClient {
   readonly config: () => {
     readonly projectId?: string;
   };
-  readonly request: (options: { readonly uri: string }) => Promise<unknown>;
+  readonly request: (options: {
+    readonly uri: string;
+    readonly tag?: string;
+  }) => Promise<unknown>;
 }
 
-/** Native Studio profile response, whose nullable avatar is wider than Sanity's public type. */
-export declare interface StudioUserProfile extends Omit<User, "imageUrl"> {
-  readonly imageUrl?: string | null;
+export declare interface StudioUserProfile extends ProjectUserProfile {
   readonly [key: string]: unknown;
 }
 
@@ -173,11 +174,17 @@ export declare function useWorkflowSession({
   engine,
   instanceId,
   grantsFromPath,
+  guardScope,
   sdk,
 }: {
   engine: Engine;
   instanceId: string;
   grantsFromPath?: string;
+  /** The id-set of every co-mounted session, handed identically to each one
+   *  so guard observation consolidates into one shared live query per
+   *  resource. Must include `instanceId`. Omitted, guards are observed per
+   *  instance. */
+  guardScope?: readonly string[];
   sdk?: SanityInstance;
 }): WorkflowSession;
 

package/dist/index.js

@@ -6,12 +6,14 @@ import { createSanityInstance } from "@sanity/sdk";
 
 import { ENGINE_API_VERSION, createEngine, EXECUTION_KINDS } from "@sanity/workflow-engine";
 
-import { useMemo, useEffect, useState } from "react";
+import { useMemo, useEffect, useSyncExternalStore } from "react";
 
 import { useSource, useClient } from "sanity";
 
 import { useWorkflowTelemetry, useWorkflowSession as useWorkflowSession$1, useDocumentWorkflows as useDocumentWorkflows$1, useWorkflowInstances as useWorkflowInstances$1 } from "@sanity/workflow-react";
 
+import { loadProjectUserProfiles } from "@sanity/workflow-sdk/project-users";
+
 function makeStudioObserver(sdk, options) {
     const {client: client, engineResource: engineResource} = options;
     return {
@@ -148,7 +150,7 @@ function studioResourceClients(client) {
     }) : void 0;
 }
 
-function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, sdk: sdk}) {
+function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, guardScope: guardScope, sdk: sdk}) {
     const observer = useStudioObserver({
         engine: engine,
         sdk: sdk
@@ -158,6 +160,9 @@ function useWorkflowSession({engine: engine, instanceId: instanceId, grantsFromP
         instanceId: instanceId,
         observer: observer,
         host: "studio",
+        ...guardScope !== void 0 ? {
+            guardScope: guardScope
+        } : {},
         opts: {
             grantsFromPath: grantsFromPath
         }
@@ -190,7 +195,7 @@ function useDocumentWorkflows({engine: engine, document: document, sdk: sdk}) {
     });
 }
 
-const PROJECT_USERS_TTL_MS = 3e4;
+const PROJECT_USERS_RETRY_MS = 3e4;
 
 function isRecord(value) {
     return typeof value == "object" && value !== null && !Array.isArray(value);
@@ -204,10 +209,6 @@ function isMembership(value) {
     return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
 }
 
-function isUser(value) {
-    return isRecord(value) && typeof value.id == "string" && (value.email === void 0 || typeof value.email == "string") && (value.displayName === void 0 || typeof value.displayName == "string") && (value.imageUrl === void 0 || value.imageUrl === null || typeof value.imageUrl == "string");
-}
-
 async function fetchProjectUsers(client, projectId) {
     const project = await client.request({
         uri: `/projects/${projectId}`
@@ -217,9 +218,11 @@ async function fetchProjectUsers(client, projectId) {
     if (!membershipRows.every(isMembership)) throw new Error("Studio project user response contained an invalid membership row");
     const memberships = membershipRows.filter(member => !member.isRobot);
     if (memberships.length === 0) return [];
-    const ids = memberships.map(member => encodeURIComponent(member.id)), response = await client.request({
-        uri: `/projects/${projectId}/users/${ids.join(",")}`
-    }), profiles = (Array.isArray(response) ? response : [ response ]).filter(isUser), profileById = new Map(profiles.map(profile => [ profile.id, profile ]));
+    const profiles = await loadProjectUserProfiles({
+        client: client,
+        projectId: projectId,
+        ids: memberships.map(member => member.id)
+    }), profileById = new Map(profiles.map(profile => [ profile.id, profile ]));
     return memberships.map(membership => ({
         membership: membership,
         profile: profileById.get(membership.id)
@@ -228,6 +231,40 @@ async function fetchProjectUsers(client, projectId) {
 
 const projectUsersByClient = /* @__PURE__ */ new WeakMap;
 
+function createProjectUsersStore(client, projectId) {
+    let snapshot = {
+        users: [],
+        loading: !1,
+        error: void 0
+    }, pending, retryAt = 0, usersById = /* @__PURE__ */ new Map, usersByEmail = /* @__PURE__ */ new Map;
+    const listeners = /* @__PURE__ */ new Set, setSnapshot = next => {
+        snapshot = next, listeners.forEach(listener => listener());
+    };
+    return {
+        getSnapshot: () => snapshot,
+        load: () => pending || (snapshot.users.length > 0 || snapshot.error === void 0 && retryAt === 1 / 0 ? Promise.resolve(snapshot.users) : snapshot.error !== void 0 && Date.now() < retryAt ? Promise.reject(snapshot.error) : (setSnapshot({
+            ...snapshot,
+            loading: !0,
+            error: void 0
+        }), pending = fetchProjectUsers(client, projectId).then(users => (usersById = new Map(users.map(user => [ user.membership.id, user ])), 
+        usersByEmail = new Map(users.flatMap(user => user.profile?.email ? [ [ user.profile.email.toLowerCase(), user ] ] : [])), 
+        retryAt = 1 / 0, setSnapshot({
+            users: users,
+            loading: !1,
+            error: void 0
+        }), pending = void 0, users), error => {
+            throw retryAt = Date.now() + PROJECT_USERS_RETRY_MS, setSnapshot({
+                users: [],
+                loading: !1,
+                error: error
+            }), pending = void 0, error;
+        }), pending)),
+        subscribe: listener => (listeners.add(listener), () => listeners.delete(listener)),
+        userByEmail: email => usersByEmail.get(email.toLowerCase()),
+        userById: id => usersById.get(id)
+    };
+}
+
 function clientProjectUsers(client) {
     const cached = projectUsersByClient.get(client);
     if (cached) return cached;
@@ -235,27 +272,20 @@ function clientProjectUsers(client) {
     return projectUsersByClient.set(client, created), created;
 }
 
-function loadProjectUsers(client, projectId) {
+function projectUsersStore(client, projectId) {
     const projectUsers = clientProjectUsers(client), cached = projectUsers.get(projectId);
-    if (cached && cached.expiresAt > Date.now()) return cached.promise;
-    projectUsers.delete(projectId);
-    const pending = fetchProjectUsers(client, projectId), entry = {
-        promise: pending,
-        expiresAt: Number.POSITIVE_INFINITY
-    };
-    return projectUsers.set(projectId, entry), pending.then(() => {
-        entry.expiresAt = Date.now() + PROJECT_USERS_TTL_MS;
-    }, () => {
-        projectUsers.get(projectId) === entry && projectUsers.delete(projectId);
-    }), pending;
+    if (cached) return cached;
+    const created = createProjectUsersStore(client, projectId);
+    return projectUsers.set(projectId, created), created;
 }
 
 function studioProjectUserDirectory(client, projectId) {
-    const load = () => loadProjectUsers(client, projectId);
+    const store = projectUsersStore(client, projectId);
     return {
         findById: async id => {
             try {
-                const user = (await load()).find(candidate => candidate.membership.id === id);
+                await store.load();
+                const user = store.userById(id);
                 return user ? {
                     status: "resolved",
                     user: user
@@ -271,7 +301,8 @@ function studioProjectUserDirectory(client, projectId) {
         },
         findByEmail: async email => {
             try {
-                const normalized = email.toLowerCase(), user = (await load()).find(candidate => candidate.profile?.email?.toLowerCase() === normalized);
+                await store.load();
+                const user = store.userByEmail(email);
                 return user ? {
                     status: "resolved",
                     user: user
@@ -288,44 +319,19 @@ function studioProjectUserDirectory(client, projectId) {
     };
 }
 
+const missingProjectSnapshot = {
+    users: [],
+    loading: !1,
+    error: new Error("No projectId on the Studio client")
+}, noopSubscribe = () => () => {};
+
 function useStudioProjectUsers() {
     const client = useClient({
         apiVersion: ENGINE_API_VERSION
-    }), projectId = client.config().projectId, directory = useMemo(() => projectId ? studioProjectUserDirectory(client, projectId) : void 0, [ client, projectId ]), [state, setState] = useState({
-        users: [],
-        loading: projectId !== void 0,
-        error: projectId === void 0 ? new Error("No projectId on the Studio client") : void 0
-    });
+    }), projectId = client.config().projectId, directory = useMemo(() => projectId ? studioProjectUserDirectory(client, projectId) : void 0, [ client, projectId ]), store = useMemo(() => projectId ? projectUsersStore(client, projectId) : void 0, [ client, projectId ]), state = useSyncExternalStore(store?.subscribe ?? noopSubscribe, store?.getSnapshot ?? (() => missingProjectSnapshot), store?.getSnapshot ?? (() => missingProjectSnapshot));
     return useEffect(() => {
-        if (!projectId) {
-            setState({
-                users: [],
-                loading: !1,
-                error: new Error("No projectId on the Studio client")
-            });
-            return;
-        }
-        let cancelled = !1;
-        return setState({
-            users: [],
-            loading: !0,
-            error: void 0
-        }), loadProjectUsers(client, projectId).then(users => {
-            cancelled || setState({
-                users: users,
-                loading: !1,
-                error: void 0
-            });
-        }, error => {
-            cancelled || setState({
-                users: [],
-                loading: !1,
-                error: error
-            });
-        }), () => {
-            cancelled = !0;
-        };
-    }, [ client, projectId ]), {
+        store && store.load().catch(() => {});
+    }, [ store ]), {
         ...state,
         directory: directory
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workflow-studio",
-  "version": "0.9.0",
+  "version": "0.20.0",
   "description": "React adapter that drives the @sanity/workflow-engine reactive session in Sanity Studio through the App SDK store.",
   "keywords": [
     "sanity",
@@ -40,11 +40,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@sanity/workflow-engine": "0.18.0",
-    "@sanity/workflow-react": "0.13.0",
-    "@sanity/workflow-sdk": "0.10.0"
-  },
   "devDependencies": {
     "@sanity/pkg-utils": "^10.5.2",
     "@sanity/sdk": "^2.12.0",
@@ -54,12 +49,18 @@
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "sanity": "^6",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.8",
+    "@sanity/workflow-engine": "0.20.0",
+    "@sanity/workflow-sdk": "0.20.0",
+    "@sanity/workflow-react": "0.20.0"
   },
   "peerDependencies": {
     "@sanity/sdk": "^2.12.0",
     "react": "^19.2.7",
-    "sanity": "^6"
+    "sanity": "^6",
+    "@sanity/workflow-engine": "0.20.0",
+    "@sanity/workflow-react": "0.20.0",
+    "@sanity/workflow-sdk": "0.20.0"
   },
   "engines": {
     "node": ">=20"