@sanity/workbench 0.1.0-alpha.16 → 0.1.0-alpha.18

package/dist/system.js

@@ -1,7 +1,9 @@
 import { getAuthState, logout, AuthStateType, getClient, createSanityInstance } from "@sanity/sdk";
-import { fromObservable, fromPromise, setup, assign, fromCallback, sendTo, raise } from "xstate";
+import { fromObservable, fromPromise, setup, assign, sendParent, fromCallback, sendTo, raise } from "xstate";
 import "./_chunks-es/studio.js";
 import { logger } from "./_chunks-es/index.js";
+import { createInstance } from "@sanity/federation/runtime";
+import { log } from "@sanity/federation/runtime/plugins/log";
 import { createSessionId, createBatchedStore } from "@sanity/telemetry";
 const authStateLogic = fromObservable(
   ({ input }) => getAuthState(input.instance).observable
@@ -185,20 +187,168 @@ const authStateLogic = fromObservable(
     segments.unshift(current.id ?? current.sessionId), current = current._parent;
   return segments.join(":");
 }, inspect = (event) => {
-  const ref = event.actorRef, log = logger.child(actorPath(ref));
+  const ref = event.actorRef, log2 = logger.child(actorPath(ref));
   switch (event.type) {
     case "@xstate.snapshot": {
-      log.debug("snapshot", event.snapshot);
+      log2.debug("snapshot", event.snapshot);
       break;
     }
     case "@xstate.event":
-      log.debug("event", event.event);
+      log2.debug("event", event.event);
       break;
     case "@xstate.action":
-      log.debug("action", event.action);
+      log2.debug("action", event.action);
       break;
   }
-}, DEFAULT_PREFERRED_COLOR_SCHEME = "system", DEFAULT_OS_COLOR_SCHEME = "light", resolveColorScheme = (preferred, osColorScheme) => preferred === "system" ? osColorScheme : preferred, adapterBridgeLogic = fromCallback(({ input: adapter, sendBack, receive }) => {
+};
+class ModuleShapeError extends Error {
+  constructor(remoteId) {
+    super(`Remote "${remoteId}" did not expose a render function`);
+  }
+}
+const REMOTE_MODULE = "App", loadLogic = fromPromise(
+  async ({ input }) => {
+    input.instance.registerRemotes([{ name: input.id, entry: input.entry }]);
+    const remoteModule = await input.instance.loadRemote(
+      `${input.id}/${REMOTE_MODULE}`
+    );
+    if (!remoteModule || typeof remoteModule.render != "function")
+      throw new ModuleShapeError(input.id);
+    return remoteModule;
+  }
+), remoteLogic = setup({
+  types: {
+    input: {},
+    context: {},
+    tags: {}
+  },
+  actors: {
+    load: loadLogic
+  },
+  actions: {
+    setModule: assign({
+      module: (_, params) => params.module,
+      error: () => null
+    }),
+    setError: assign({
+      module: () => null,
+      error: (_, params) => normaliseError(params.error)
+    })
+  }
+}).createMachine({
+  id: "remote",
+  initial: "loading",
+  context: ({ input }) => ({
+    ...input,
+    module: null,
+    error: null
+  }),
+  states: {
+    loading: {
+      tags: ["loading"],
+      invoke: {
+        src: "load",
+        input: ({ context }) => ({
+          id: context.id,
+          entry: context.entry,
+          instance: context.instance
+        }),
+        onDone: {
+          target: "loaded",
+          actions: [
+            {
+              type: "setModule",
+              params: ({ event }) => ({ module: event.output })
+            }
+          ]
+        },
+        onError: {
+          target: "error",
+          actions: [
+            {
+              type: "setError",
+              params: ({ event }) => ({ error: event.error })
+            }
+          ]
+        }
+      }
+    },
+    loaded: {
+      tags: ["ready"],
+      entry: sendParent(({ context }) => ({
+        type: "remote.settled",
+        id: context.id,
+        status: "loaded"
+      }))
+    },
+    error: {
+      tags: ["failed"],
+      entry: sendParent(({ context }) => ({
+        type: "remote.settled",
+        id: context.id,
+        status: "error"
+      }))
+    }
+  }
+});
+function normaliseError(error) {
+  return error instanceof Error ? { message: error.message, cause: error } : { message: String(error), cause: error };
+}
+const remotesLogic = setup({
+  types: {
+    context: {},
+    events: {}
+  },
+  actors: {
+    remote: remoteLogic
+  },
+  guards: {
+    remoteNotKnown: ({ context }, params) => !context.children.has(params.id)
+  },
+  actions: {
+    spawnRemote: assign({
+      children: ({ context, spawn }, params) => {
+        const ref = spawn("remote", {
+          id: params.id,
+          systemId: `remotes.${params.id}`,
+          input: {
+            id: params.id,
+            entry: params.entry,
+            instance: context.instance
+          }
+        });
+        return new Map(context.children).set(params.id, ref);
+      }
+    })
+  }
+}).createMachine({
+  id: "remotes",
+  context: () => ({
+    instance: createInstance({
+      name: "workbench-applications",
+      plugins: [log(logger.debug)]
+    }),
+    children: /* @__PURE__ */ new Map()
+  }),
+  on: {
+    "remote.load.request": {
+      guard: {
+        type: "remoteNotKnown",
+        params: ({ event }) => ({ id: event.id })
+      },
+      actions: [
+        {
+          type: "spawnRemote",
+          params: ({ event }) => ({ id: event.id, entry: event.entry })
+        }
+      ]
+    },
+    // Reserved for future supervision/retry. Forwarded by per-remote
+    // children on entry to `loaded` or `error`; currently a no-op so the
+    // event is part of the typed surface rather than a silent unknown.
+    "remote.settled": {}
+  }
+}), DEFAULT_PREFERRED_COLOR_SCHEME = "system", DEFAULT_OS_COLOR_SCHEME = "light", resolveColorScheme = (preferred, osColorScheme) => preferred === "system" ? osColorScheme : preferred, adapterBridgeLogic = fromCallback(({ input: adapter, sendBack, receive }) => {
   if (!adapter) return;
   const unsubscribePreferredColorScheme = adapter.subscribePreferredColorScheme(
     (next) => {
@@ -404,7 +554,8 @@ const authStateLogic = fromObservable(
   actors: {
     auth: authLogic,
     telemetry: telemetryLogic,
-    systemPreferences: systemPreferencesLogic
+    systemPreferences: systemPreferencesLogic,
+    remotes: remotesLogic
   },
   guards: {
     hasTag: (_, params) => params.hasTag
@@ -484,6 +635,11 @@ const authStateLogic = fromObservable(
       systemId: "system-preferences",
       src: "systemPreferences",
       input: ({ context }) => ({ adapter: context.systemPreferencesAdapter })
+    },
+    {
+      id: "remotes",
+      systemId: "remotes",
+      src: "remotes"
     }
   ],
   states: {

package/dist/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sources":["../src/system/auth.machine.ts","../src/system/inspect.ts","../src/system/system-preferences.machine.ts","../src/system/telemetry.machine.ts","../src/system/root.machine.ts"],"sourcesContent":["import {\n  type AuthState,\n  AuthStateType,\n  type CurrentUser,\n  getAuthState,\n  type LoggedInAuthState,\n  logout,\n  type SanityInstance,\n} from \"@sanity/sdk\";\nimport { assign, fromObservable, fromPromise, setup } from \"xstate\";\n\nimport type { OSBaseInput } from \"./root.machine\";\n\n/**\n * @internal\n */\nexport interface AuthInput extends OSBaseInput {}\n\nconst authStateLogic = fromObservable<AuthState, AuthInput>(\n  ({ input }) => getAuthState(input.instance).observable,\n);\n\n/**\n * @internal\n */\nexport interface LogoutInput extends OSBaseInput {}\n\nconst logoutActorLogic = fromPromise<void, LogoutInput>(async ({ input }) => {\n  await logout(input.instance);\n});\n\ntype AuthContext = {\n  instance: SanityInstance;\n  token: string | null;\n  currentUser: CurrentUser | null;\n  error: unknown;\n};\n\ntype AuthEvent = { type: \"auth.logout\" };\n\nexport const authLogic = setup({\n  types: {\n    input: {} as AuthInput,\n    context: {} as AuthContext,\n    events: {} as AuthEvent,\n    tags: {} as \"authenticating\" | \"authenticated\" | \"error\",\n  },\n  actors: {\n    authState: authStateLogic,\n    logoutActor: logoutActorLogic,\n  },\n  delays: {\n    authTimeout: 30_000,\n  },\n  guards: {\n    isLoggedInComplete: (_, params: { state: AuthState | undefined }) =>\n      params.state?.type === AuthStateType.LOGGED_IN &&\n      Boolean((params.state as LoggedInAuthState).token) &&\n      (params.state as LoggedInAuthState).currentUser !== null,\n    isAuthState: (\n      _,\n      params: { state: AuthState | undefined; type: AuthStateType },\n    ) => params.state?.type === params.type,\n  },\n  actions: {\n    setLoggedIn: assign({\n      token: (_, params: { token: string; currentUser: CurrentUser }) =>\n        params.token,\n      currentUser: (_, params: { token: string; currentUser: CurrentUser }) =>\n        params.currentUser,\n      error: () => null,\n    }),\n    clearAuth: assign({\n      token: () => null,\n      currentUser: () => null,\n      error: () => null,\n    }),\n    setError: assign({\n      token: () => null,\n      currentUser: () => null,\n      error: (_, params: { error: unknown }) => params.error,\n    }),\n  },\n}).createMachine({\n  id: \"auth\",\n  initial: \"init\",\n  context: ({ input }) => ({\n    instance: input.instance,\n    token: null,\n    currentUser: null,\n    error: null,\n  }),\n  invoke: {\n    src: \"authState\",\n    input: ({ context }) => ({ instance: context.instance }),\n    onSnapshot: [\n      {\n        guard: {\n          type: \"isLoggedInComplete\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n          }),\n        },\n        actions: [\n          {\n            type: \"setLoggedIn\",\n            params: ({ event }) => {\n              const state = event.snapshot.context as LoggedInAuthState;\n              return {\n                token: state.token,\n                currentUser: state.currentUser!,\n              };\n            },\n          },\n        ],\n        target: `.${AuthStateType.LOGGED_IN}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.LOGGING_IN,\n          }),\n        },\n        actions: [{ type: \"clearAuth\" }],\n        target: `.${AuthStateType.LOGGING_IN}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.ERROR,\n          }),\n        },\n        actions: [\n          {\n            type: \"setError\",\n            params: ({ event }) => ({\n              error:\n                event.snapshot.context?.type === AuthStateType.ERROR\n                  ? event.snapshot.context.error\n                  : null,\n            }),\n          },\n        ],\n        target: `.${AuthStateType.ERROR}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.LOGGED_OUT,\n          }),\n        },\n        actions: [{ type: \"clearAuth\" }],\n        target: `.${AuthStateType.LOGGED_OUT}`,\n      },\n    ],\n  },\n  states: {\n    init: {\n      tags: [\"authenticating\"],\n      after: {\n        authTimeout: {\n          actions: [\n            {\n              type: \"setError\",\n              params: () => ({\n                error: new Error(\"Authentication timed out\"),\n              }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGING_IN]: {\n      tags: [\"authenticating\"],\n      after: {\n        authTimeout: {\n          actions: [\n            {\n              type: \"setError\",\n              params: () => ({\n                error: new Error(\"Authentication timed out\"),\n              }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGED_IN]: {\n      tags: [\"authenticated\"],\n      on: {\n        \"auth.logout\": { target: \"logging-out\" },\n      },\n    },\n    [\"logging-out\"]: {\n      invoke: {\n        src: \"logoutActor\",\n        input: ({ context }) => ({ instance: context.instance }),\n        onDone: {\n          target: AuthStateType.LOGGED_OUT,\n        },\n        onError: {\n          actions: [\n            {\n              type: \"setError\",\n              params: ({ event }) => ({ error: event.error }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGED_OUT]: {},\n    [AuthStateType.ERROR]: { tags: [\"error\"] },\n  },\n});\n","import { type ActorRefLike, type InspectionEvent } from \"xstate\";\n\nimport { logger } from \"../core\";\n\n// Mirrors @statelyai/inspect's ActorRefLikeWithData — the inspect\n// callback receives full Actor instances at runtime, but the type is\n// narrowed for @xstate/store compat.\ntype ActorRefWithAncestry = ActorRefLike & {\n  id?: string;\n  _parent?: ActorRefWithAncestry;\n};\n\nconst actorPath = (ref: ActorRefWithAncestry): string => {\n  const segments: string[] = [];\n  let current: ActorRefWithAncestry | undefined = ref;\n  while (current) {\n    segments.unshift(current.id ?? current.sessionId);\n    current = current._parent;\n  }\n  return segments.join(\":\");\n};\n\n/** @internal exported for testing */\nexport const inspect = (event: InspectionEvent): void => {\n  const ref = event.actorRef as ActorRefWithAncestry;\n  const log = logger.child(actorPath(ref));\n\n  switch (event.type) {\n    case \"@xstate.snapshot\": {\n      log.debug(\"snapshot\", event.snapshot);\n      break;\n    }\n    case \"@xstate.event\":\n      log.debug(\"event\", event.event);\n      break;\n    case \"@xstate.action\":\n      log.debug(\"action\", event.action);\n      break;\n  }\n};\n","import { assign, fromCallback, sendTo, setup } from \"xstate\";\n\ntype ColorScheme = \"light\" | \"dark\";\n\ntype ColorSchemePreference = \"system\" | ColorScheme;\n\n/**\n * The system-preferences machine's context. Consumers read fields directly\n * (e.g. via `useSelector`) rather than going through a resolver utility —\n * the action handlers keep `colorScheme` in sync with `preferredColorScheme`\n * and `osColorScheme`.\n *\n * Note: `colorScheme` is intentionally stored as derived state in context so\n * consumers can read the resolved value directly without a utility. The\n * action handlers below are the single source of truth for the resolution.\n * @public\n */\nexport type SystemPreferencesContext = {\n  /** User's color scheme choice; `system` defers to the OS preference. */\n  preferredColorScheme: ColorSchemePreference;\n  /** Last reported OS color scheme. Used to resolve `colorScheme` when the\n   * preference is `system`. */\n  osColorScheme: ColorScheme;\n  /** Resolved color scheme — what the UI should render. Recomputed by the\n   * action handlers whenever an input changes. */\n  colorScheme: ColorScheme;\n};\n\nconst DEFAULT_PREFERRED_COLOR_SCHEME: ColorSchemePreference = \"system\";\nconst DEFAULT_OS_COLOR_SCHEME: ColorScheme = \"light\";\n\n/**\n * Events the system-preferences machine accepts. Both originate from the\n * host's adapter — `preferredColorScheme.set` is also forwarded back to it\n * so it can persist the user's choice.\n * @public\n */\nexport type SystemPreferencesEvent =\n  | {\n      type: \"preferredColorScheme.set\";\n      preferredColorScheme: ColorSchemePreference;\n    }\n  | {\n      type: \"osColorScheme.set\";\n      osColorScheme: ColorScheme;\n    };\n\n/**\n * Adapter interface the host implements to give the system-preferences\n * machine access to the user's environment (OS color scheme, persistent\n * storage, cross-context change notifications).\n *\n * The package owns all orchestration — synchronous seeding, idempotent\n * persistence, mapping cleared storage to `\"system\"`. The host's\n * implementation is pure DOM/storage glue: read, write, subscribe.\n * @public\n */\nexport type SystemPreferencesAdapter = {\n  /** Read the user's stored preference. `null` means \"no preference set\"\n   * (the machine treats this as `\"system\"`). */\n  getPreferredColorScheme: () => ColorSchemePreference | null;\n  /** Write the user's preference to persistent storage. */\n  persistPreferredColorScheme: (value: ColorSchemePreference) => void;\n  /** Subscribe to cross-context preference changes (e.g. another tab\n   * writing to the shared storage). The callback receives the new stored\n   * value (or `null` if it was cleared). Returns an unsubscribe function. */\n  subscribePreferredColorScheme: (\n    callback: (next: ColorSchemePreference | null) => void,\n  ) => () => void;\n  /** Read the current OS-detected color scheme. */\n  getOsColorScheme: () => ColorScheme;\n  /** Subscribe to OS color-scheme changes (e.g. user flipping dark mode).\n   * Returns an unsubscribe function. */\n  subscribeOsColorScheme: (callback: (next: ColorScheme) => void) => () => void;\n};\n\nconst resolveColorScheme = (\n  preferred: ColorSchemePreference,\n  osColorScheme: ColorScheme,\n): ColorScheme => (preferred === \"system\" ? osColorScheme : preferred);\n\n// Internal bridge actor — subscribes to the host's adapter for runtime\n// changes and persists user-driven preference changes when the parent\n// forwards them. No-op if the host didn't pass an adapter (SSR, tests).\ntype AdapterBridgeReceiveEvent = Extract<\n  SystemPreferencesEvent,\n  { type: \"preferredColorScheme.set\" }\n>;\n\nconst adapterBridgeLogic = fromCallback<\n  AdapterBridgeReceiveEvent,\n  SystemPreferencesAdapter | undefined,\n  SystemPreferencesEvent\n>(({ input: adapter, sendBack, receive }) => {\n  if (!adapter) return;\n\n  const unsubscribePreferredColorScheme = adapter.subscribePreferredColorScheme(\n    (next) => {\n      // Falls back to `\"system\"` so an external clear (another tab deleting\n      // the key) resets the preference rather than silently keeping the\n      // previous value.\n      sendBack({\n        type: \"preferredColorScheme.set\",\n        preferredColorScheme: next ?? \"system\",\n      });\n    },\n  );\n\n  const unsubscribeOs = adapter.subscribeOsColorScheme((next) => {\n    sendBack({ type: \"osColorScheme.set\", osColorScheme: next });\n  });\n\n  receive((event) => {\n    // Idempotent: skip writes that match the current stored value so a\n    // `preferredColorScheme.set` originating from cross-context change\n    // doesn't loop back into another write.\n    if (adapter.getPreferredColorScheme() === event.preferredColorScheme)\n      return;\n\n    adapter.persistPreferredColorScheme(event.preferredColorScheme);\n  });\n\n  return () => {\n    unsubscribePreferredColorScheme();\n    unsubscribeOs();\n  };\n});\n\n/**\n * @internal\n */\nexport const systemPreferencesLogic = setup({\n  types: {\n    input: {} as { adapter?: SystemPreferencesAdapter },\n    context: {} as SystemPreferencesContext & {\n      adapter: SystemPreferencesAdapter | undefined;\n    },\n    events: {} as SystemPreferencesEvent,\n  },\n  actors: {\n    adapterBridge: adapterBridgeLogic,\n  },\n  actions: {\n    setPreferredColorScheme: assign({\n      preferredColorScheme: (\n        _,\n        params: { preferredColorScheme: ColorSchemePreference },\n      ) => params.preferredColorScheme,\n      colorScheme: (\n        { context },\n        params: { preferredColorScheme: ColorSchemePreference },\n      ) =>\n        resolveColorScheme(params.preferredColorScheme, context.osColorScheme),\n    }),\n    setOsColorScheme: assign({\n      osColorScheme: (_, params: { osColorScheme: ColorScheme }) =>\n        params.osColorScheme,\n      colorScheme: ({ context }, params: { osColorScheme: ColorScheme }) =>\n        resolveColorScheme(context.preferredColorScheme, params.osColorScheme),\n    }),\n  },\n}).createMachine({\n  id: \"system-preferences\",\n  initial: \"ready\",\n  context: ({ input }) => {\n    const adapter = input.adapter;\n    const preferredColorScheme =\n      adapter?.getPreferredColorScheme() ?? DEFAULT_PREFERRED_COLOR_SCHEME;\n    const osColorScheme =\n      adapter?.getOsColorScheme() ?? DEFAULT_OS_COLOR_SCHEME;\n\n    return {\n      adapter,\n      preferredColorScheme,\n      osColorScheme,\n      colorScheme: resolveColorScheme(preferredColorScheme, osColorScheme),\n    };\n  },\n  invoke: {\n    id: \"adapter\",\n    src: \"adapterBridge\",\n    input: ({ context }) => context.adapter,\n  },\n  states: {\n    ready: {\n      on: {\n        \"preferredColorScheme.set\": {\n          actions: [\n            {\n              type: \"setPreferredColorScheme\",\n              params: ({ event }) => ({\n                preferredColorScheme: event.preferredColorScheme,\n              }),\n            },\n            // Forward to the adapter bridge so it can persist the user's\n            // choice. The bridge guards against redundant writes, so\n            // round-tripping a `preferredColorScheme.set` it sourced itself\n            // (e.g. from a `storage` event in another tab) is a no-op.\n            sendTo(\"adapter\", ({ event }) => event),\n          ],\n        },\n        \"osColorScheme.set\": {\n          actions: [\n            {\n              type: \"setOsColorScheme\",\n              params: ({ event }) => ({\n                osColorScheme: event.osColorScheme,\n              }),\n            },\n          ],\n        },\n      },\n    },\n  },\n});\n","import { getClient, type SanityInstance } from \"@sanity/sdk\";\nimport {\n  type ConsentStatus,\n  createBatchedStore,\n  createSessionId,\n  type TelemetryEvent,\n  type TelemetryStore,\n} from \"@sanity/telemetry\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport type { OSBaseInput } from \"./root.machine\";\n\n/**\n * @public\n */\nexport type WorkbenchUserProperties = {\n  version: string;\n  organizationId: string;\n  environment: string;\n  userAgent: string;\n};\n\n/**\n * @internal\n */\nexport interface TelemetryInput extends OSBaseInput, WorkbenchUserProperties {}\n\n/**\n * TODO: this shouldn't be unique to the telemetry machine,\n * remove this and set it globally with a single client actor.\n */\nconst TELEMETRY_API_VERSION = \"2024-11-12\";\n/**\n * 30 seconds, in milliseconds, is the default flush interval\n * for the telemetry store.\n */\nconst FLUSH_INTERVAL_MS = 30_000;\n\ntype ConsentResult = { status: ConsentStatus };\n\nconst checkConsentLogic = fromPromise<\n  ConsentResult,\n  { instance: SanityInstance }\n>(async ({ input, signal }) => {\n  try {\n    const client = getClient(input.instance, {\n      apiVersion: TELEMETRY_API_VERSION,\n    });\n    return await client.request<ConsentResult>({\n      uri: \"/intake/telemetry-status\",\n      tag: \"telemetry-consent\",\n      signal,\n    });\n  } catch {\n    return { status: \"undetermined\" } satisfies ConsentResult;\n  }\n});\n\ntype TelemetryContext = {\n  instance: SanityInstance;\n  store: TelemetryStore<WorkbenchUserProperties> | null;\n  userProperties: WorkbenchUserProperties;\n};\n\ntype TelemetryMachineEvent =\n  | { type: \"telemetry.start\" }\n  | { type: \"telemetry.stop\" };\n\nexport const telemetryLogic = setup({\n  types: {\n    input: {} as TelemetryInput,\n    context: {} as TelemetryContext,\n    events: {} as TelemetryMachineEvent,\n  },\n  actors: {\n    checkConsent: checkConsentLogic,\n  },\n  guards: {\n    isConsentGranted: (_, params: { status: ConsentStatus }) =>\n      params.status === \"granted\",\n  },\n  actions: {\n    createStore: assign({\n      store: ({ context }) => {\n        const sessionId = createSessionId();\n        const client = getClient(context.instance, {\n          apiVersion: TELEMETRY_API_VERSION,\n        });\n        const store = createBatchedStore<WorkbenchUserProperties>(sessionId, {\n          flushInterval: FLUSH_INTERVAL_MS,\n          resolveConsent: () =>\n            client.request<{ status: ConsentStatus }>({\n              uri: \"/intake/telemetry-status\",\n              tag: \"telemetry-consent\",\n            }),\n          sendEvents: (batch: TelemetryEvent[]) =>\n            client.request({\n              uri: \"/intake/batch\",\n              method: \"POST\",\n              body: { batch },\n              tag: \"telemetry.batch\",\n            }),\n          sendBeacon: (batch: TelemetryEvent[]) => {\n            if (typeof navigator === \"undefined\") {\n              return false;\n            }\n            return navigator.sendBeacon(\n              client.getUrl(\"/intake/batch\"),\n              JSON.stringify({ batch }),\n            );\n          },\n        });\n        store.logger.updateUserProperties(context.userProperties);\n        return store;\n      },\n    }),\n    teardownStore: ({ context }) => {\n      context.store?.end();\n    },\n  },\n}).createMachine({\n  id: \"telemetry\",\n  initial: \"idle\",\n  context: ({ input }) => ({\n    instance: input.instance,\n    store: null,\n    userProperties: {\n      version: input.version,\n      organizationId: input.organizationId,\n      environment: input.environment,\n      userAgent: input.userAgent,\n    },\n  }),\n  states: {\n    idle: {\n      on: {\n        \"telemetry.start\": {\n          target: \"checkingConsent\",\n        },\n      },\n    },\n    checkingConsent: {\n      invoke: {\n        src: \"checkConsent\",\n        input: ({ context }) => ({\n          instance: context.instance,\n        }),\n        onDone: [\n          {\n            guard: {\n              type: \"isConsentGranted\",\n              params: ({ event }) => ({\n                status: event.output.status,\n              }),\n            },\n            actions: [{ type: \"createStore\" }],\n            target: \"active\",\n          },\n          {\n            target: \"denied\",\n          },\n        ],\n      },\n    },\n    active: {\n      tags: [\"telemetry-resolved\"],\n      exit: [{ type: \"teardownStore\" }],\n      on: {\n        \"telemetry.stop\": { target: \"stopped\" },\n      },\n    },\n    stopped: {\n      type: \"final\",\n    },\n    denied: {\n      tags: [\"telemetry-resolved\"],\n    },\n  },\n});\n","import { createSanityInstance, type SanityInstance } from \"@sanity/sdk\";\nimport { raise, sendTo, setup, type ActorOptions } from \"xstate\";\n\nimport { authLogic } from \"./auth.machine\";\nimport { inspect } from \"./inspect\";\nimport {\n  type SystemPreferencesAdapter,\n  systemPreferencesLogic,\n} from \"./system-preferences.machine\";\nimport {\n  telemetryLogic,\n  type WorkbenchUserProperties,\n} from \"./telemetry.machine\";\n\ntype OSInput = WorkbenchUserProperties & {\n  systemPreferencesAdapter?: SystemPreferencesAdapter;\n};\n\ntype OSContext = {\n  instance: SanityInstance;\n  userProperties: WorkbenchUserProperties;\n  systemPreferencesAdapter: SystemPreferencesAdapter | undefined;\n};\n\n/**\n * The base inputs for the OS machine.\n * @internal\n */\nexport interface OSBaseInput extends Pick<OSContext, \"instance\"> {}\n\n/**\n * The sanity OS machine, responsible for managing the global state of the OS.\n * @public\n * @example\n * ```ts\n * import { os, createOSOptions } from \"@sanity/workbench/system\";\n * import { useActor } from \"@xstate/react\";\n *\n * const [state, send] = useActor(os, createOSOptions({\n *   version: \"1.0.0\",\n *   organizationId: \"...\",\n *   environment: \"production\",\n *   userAgent: navigator.userAgent,\n * }));\n * ```\n */\nexport const os = setup({\n  types: {\n    input: {} as OSInput,\n    context: {} as OSContext,\n    events: {} as\n      | { type: \"boot.auth.ready\" }\n      | { type: \"boot.auth.failed\" }\n      | { type: \"boot.telemetry.ready\" },\n    // https://github.com/statelyai/xstate/issues/5515\n    children: {} as {\n      auth: \"auth\";\n      telemetry: \"telemetry\";\n      \"system-preferences\": \"systemPreferences\";\n    },\n  },\n  actors: {\n    auth: authLogic,\n    telemetry: telemetryLogic,\n    systemPreferences: systemPreferencesLogic,\n  },\n  guards: {\n    hasTag: (_, params: { hasTag: boolean }) => params.hasTag,\n  },\n  actions: {\n    raiseAuthReady: raise({ type: \"boot.auth.ready\" }),\n    raiseAuthFailed: raise({ type: \"boot.auth.failed\" }),\n    raiseTelemetryReady: raise({\n      type: \"boot.telemetry.ready\",\n    }),\n    startTelemetry: sendTo(\"telemetry\", {\n      type: \"telemetry.start\",\n    }),\n  },\n}).createMachine({\n  id: \"os\",\n  context: ({ input }) => ({\n    instance: createSanityInstance(),\n    userProperties: {\n      version: input.version,\n      organizationId: input.organizationId,\n      environment: input.environment,\n      userAgent: input.userAgent,\n    },\n    systemPreferencesAdapter: input.systemPreferencesAdapter,\n  }),\n  initial: \"booting\",\n  invoke: [\n    {\n      id: \"auth\",\n      systemId: \"auth\",\n      src: \"auth\",\n      input: ({ context }) => ({ instance: context.instance }),\n      onSnapshot: [\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"authenticated\"),\n            }),\n          },\n          actions: [{ type: \"raiseAuthReady\" }],\n        },\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"error\"),\n            }),\n          },\n          actions: [{ type: \"raiseAuthFailed\" }],\n        },\n      ],\n    },\n    {\n      id: \"telemetry\",\n      systemId: \"telemetry\",\n      src: \"telemetry\",\n      input: ({ context }) => ({\n        instance: context.instance,\n        ...context.userProperties,\n      }),\n      onSnapshot: [\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"telemetry-resolved\"),\n            }),\n          },\n          actions: [{ type: \"raiseTelemetryReady\" }],\n        },\n      ],\n    },\n    {\n      id: \"system-preferences\",\n      systemId: \"system-preferences\",\n      src: \"systemPreferences\",\n      input: ({ context }) => ({ adapter: context.systemPreferencesAdapter }),\n    },\n  ],\n  states: {\n    booting: {\n      initial: \"auth\",\n      states: {\n        auth: {\n          on: {\n            \"boot.auth.ready\": {\n              target: \"telemetry\",\n              actions: [{ type: \"startTelemetry\" }],\n            },\n            \"boot.auth.failed\": { target: \"error\" },\n          },\n        },\n        telemetry: {\n          on: {\n            \"boot.telemetry.ready\": { target: \"done\" },\n          },\n        },\n        error: {},\n        done: { type: \"final\" },\n      },\n      onDone: { target: \"running\" },\n    },\n    running: {\n      type: \"parallel\",\n    },\n  },\n});\n\n/**\n * Creates a set of default options for the OS machine. Forwards the workbench\n * user properties to the machine's input and wires the structured-logging\n * `inspect` callback. Browser-specific concerns (color-scheme seeding,\n * persistence) live in the {@link SystemPreferencesAdapter} the host passes\n * via `systemPreferencesAdapter`.\n * @public\n */\nexport function createOSOptions(input: OSInput) {\n  return {\n    id: \"os\",\n    input,\n    inspect,\n  } satisfies ActorOptions<typeof os>;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"system.js","sources":["../src/system/auth.machine.ts","../src/system/inspect.ts","../src/system/remote.machine.ts","../src/system/remotes.machine.ts","../src/system/system-preferences.machine.ts","../src/system/telemetry.machine.ts","../src/system/root.machine.ts"],"sourcesContent":["import {\n  type AuthState,\n  AuthStateType,\n  type CurrentUser,\n  getAuthState,\n  type LoggedInAuthState,\n  logout,\n  type SanityInstance,\n} from \"@sanity/sdk\";\nimport { assign, fromObservable, fromPromise, setup } from \"xstate\";\n\nimport type { OSBaseInput } from \"./root.machine\";\n\n/**\n * @internal\n */\nexport interface AuthInput extends OSBaseInput {}\n\nconst authStateLogic = fromObservable<AuthState, AuthInput>(\n  ({ input }) => getAuthState(input.instance).observable,\n);\n\n/**\n * @internal\n */\nexport interface LogoutInput extends OSBaseInput {}\n\nconst logoutActorLogic = fromPromise<void, LogoutInput>(async ({ input }) => {\n  await logout(input.instance);\n});\n\ntype AuthContext = {\n  instance: SanityInstance;\n  token: string | null;\n  currentUser: CurrentUser | null;\n  error: unknown;\n};\n\ntype AuthEvent = { type: \"auth.logout\" };\n\nexport const authLogic = setup({\n  types: {\n    input: {} as AuthInput,\n    context: {} as AuthContext,\n    events: {} as AuthEvent,\n    tags: {} as \"authenticating\" | \"authenticated\" | \"error\",\n  },\n  actors: {\n    authState: authStateLogic,\n    logoutActor: logoutActorLogic,\n  },\n  delays: {\n    authTimeout: 30_000,\n  },\n  guards: {\n    isLoggedInComplete: (_, params: { state: AuthState | undefined }) =>\n      params.state?.type === AuthStateType.LOGGED_IN &&\n      Boolean((params.state as LoggedInAuthState).token) &&\n      (params.state as LoggedInAuthState).currentUser !== null,\n    isAuthState: (\n      _,\n      params: { state: AuthState | undefined; type: AuthStateType },\n    ) => params.state?.type === params.type,\n  },\n  actions: {\n    setLoggedIn: assign({\n      token: (_, params: { token: string; currentUser: CurrentUser }) =>\n        params.token,\n      currentUser: (_, params: { token: string; currentUser: CurrentUser }) =>\n        params.currentUser,\n      error: () => null,\n    }),\n    clearAuth: assign({\n      token: () => null,\n      currentUser: () => null,\n      error: () => null,\n    }),\n    setError: assign({\n      token: () => null,\n      currentUser: () => null,\n      error: (_, params: { error: unknown }) => params.error,\n    }),\n  },\n}).createMachine({\n  id: \"auth\",\n  initial: \"init\",\n  context: ({ input }) => ({\n    instance: input.instance,\n    token: null,\n    currentUser: null,\n    error: null,\n  }),\n  invoke: {\n    src: \"authState\",\n    input: ({ context }) => ({ instance: context.instance }),\n    onSnapshot: [\n      {\n        guard: {\n          type: \"isLoggedInComplete\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n          }),\n        },\n        actions: [\n          {\n            type: \"setLoggedIn\",\n            params: ({ event }) => {\n              const state = event.snapshot.context as LoggedInAuthState;\n              return {\n                token: state.token,\n                currentUser: state.currentUser!,\n              };\n            },\n          },\n        ],\n        target: `.${AuthStateType.LOGGED_IN}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.LOGGING_IN,\n          }),\n        },\n        actions: [{ type: \"clearAuth\" }],\n        target: `.${AuthStateType.LOGGING_IN}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.ERROR,\n          }),\n        },\n        actions: [\n          {\n            type: \"setError\",\n            params: ({ event }) => ({\n              error:\n                event.snapshot.context?.type === AuthStateType.ERROR\n                  ? event.snapshot.context.error\n                  : null,\n            }),\n          },\n        ],\n        target: `.${AuthStateType.ERROR}`,\n      },\n      {\n        guard: {\n          type: \"isAuthState\",\n          params: ({ event }) => ({\n            state: event.snapshot.context,\n            type: AuthStateType.LOGGED_OUT,\n          }),\n        },\n        actions: [{ type: \"clearAuth\" }],\n        target: `.${AuthStateType.LOGGED_OUT}`,\n      },\n    ],\n  },\n  states: {\n    init: {\n      tags: [\"authenticating\"],\n      after: {\n        authTimeout: {\n          actions: [\n            {\n              type: \"setError\",\n              params: () => ({\n                error: new Error(\"Authentication timed out\"),\n              }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGING_IN]: {\n      tags: [\"authenticating\"],\n      after: {\n        authTimeout: {\n          actions: [\n            {\n              type: \"setError\",\n              params: () => ({\n                error: new Error(\"Authentication timed out\"),\n              }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGED_IN]: {\n      tags: [\"authenticated\"],\n      on: {\n        \"auth.logout\": { target: \"logging-out\" },\n      },\n    },\n    [\"logging-out\"]: {\n      invoke: {\n        src: \"logoutActor\",\n        input: ({ context }) => ({ instance: context.instance }),\n        onDone: {\n          target: AuthStateType.LOGGED_OUT,\n        },\n        onError: {\n          actions: [\n            {\n              type: \"setError\",\n              params: ({ event }) => ({ error: event.error }),\n            },\n          ],\n          target: AuthStateType.ERROR,\n        },\n      },\n    },\n    [AuthStateType.LOGGED_OUT]: {},\n    [AuthStateType.ERROR]: { tags: [\"error\"] },\n  },\n});\n","import { type ActorRefLike, type InspectionEvent } from \"xstate\";\n\nimport { logger } from \"../core\";\n\n// Mirrors @statelyai/inspect's ActorRefLikeWithData — the inspect\n// callback receives full Actor instances at runtime, but the type is\n// narrowed for @xstate/store compat.\ntype ActorRefWithAncestry = ActorRefLike & {\n  id?: string;\n  _parent?: ActorRefWithAncestry;\n};\n\nconst actorPath = (ref: ActorRefWithAncestry): string => {\n  const segments: string[] = [];\n  let current: ActorRefWithAncestry | undefined = ref;\n  while (current) {\n    segments.unshift(current.id ?? current.sessionId);\n    current = current._parent;\n  }\n  return segments.join(\":\");\n};\n\n/** @internal exported for testing */\nexport const inspect = (event: InspectionEvent): void => {\n  const ref = event.actorRef as ActorRefWithAncestry;\n  const log = logger.child(actorPath(ref));\n\n  switch (event.type) {\n    case \"@xstate.snapshot\": {\n      log.debug(\"snapshot\", event.snapshot);\n      break;\n    }\n    case \"@xstate.event\":\n      log.debug(\"event\", event.event);\n      break;\n    case \"@xstate.action\":\n      log.debug(\"action\", event.action);\n      break;\n  }\n};\n","import type { FederationInstance } from \"@sanity/federation/runtime\";\nimport { assign, fromPromise, sendParent, setup } from \"xstate\";\n\n/**\n * @public\n */\nexport interface RemoteRenderOptions {\n  basePath?: string;\n  scheme?: \"light\" | \"dark\";\n  /**\n   * This is a temporary measure designed to authenticate federated\n   * studios & SDK apps before we write a working protocol.\n   */\n  unstable_temporaryToken?: string | null;\n}\n\n/**\n * @public\n */\nexport interface LoadedRemoteModule {\n  render: (\n    rootElement: HTMLElement,\n    options?: RemoteRenderOptions,\n  ) => () => void;\n}\n\n/**\n * @public\n */\nexport interface RemoteError {\n  message: string;\n  cause: unknown;\n}\n\n/**\n * Thrown by the load actor when a remote responds successfully but does\n * not expose a `render` function. Surfaced via `RemoteError.cause` for\n * consumers that need to discriminate.\n * @internal\n */\nexport class ModuleShapeError extends Error {\n  constructor(remoteId: string) {\n    super(`Remote \"${remoteId}\" did not expose a render function`);\n  }\n}\n\n/**\n * @internal\n */\nexport interface RemoteInput {\n  id: string;\n  entry: string;\n  instance: FederationInstance;\n}\n\ntype RemoteContext = RemoteInput & {\n  module: LoadedRemoteModule | null;\n  error: RemoteError | null;\n};\n\nconst REMOTE_MODULE = \"App\";\n\nconst loadLogic = fromPromise<LoadedRemoteModule, RemoteInput>(\n  async ({ input }) => {\n    input.instance.registerRemotes([{ name: input.id, entry: input.entry }]);\n    const remoteModule = await input.instance.loadRemote<unknown>(\n      `${input.id}/${REMOTE_MODULE}`,\n    );\n    if (\n      !remoteModule ||\n      typeof (remoteModule as { render?: unknown }).render !== \"function\"\n    ) {\n      throw new ModuleShapeError(input.id);\n    }\n    return remoteModule as LoadedRemoteModule;\n  },\n);\n\n/**\n * Lifecycle machine for a single federated application remote.\n *\n * Spawned by the {@link remotesLogic} supervisor on demand. Each instance\n * owns one remote's load lifecycle: `loading` → `loaded | error`. Tags\n * (`loading` / `ready` / `failed`) drive the UI contract — state names\n * are internal.\n *\n * The machine sends a `remote.settled` event to its parent on entry to\n * either terminal state, reserved for future supervision/retry.\n *\n * @internal\n */\nexport const remoteLogic = setup({\n  types: {\n    input: {} as RemoteInput,\n    context: {} as RemoteContext,\n    tags: {} as \"loading\" | \"ready\" | \"failed\",\n  },\n  actors: {\n    load: loadLogic,\n  },\n  actions: {\n    setModule: assign({\n      module: (_, params: { module: LoadedRemoteModule }) => params.module,\n      error: () => null,\n    }),\n    setError: assign({\n      module: () => null,\n      error: (_, params: { error: unknown }) => normaliseError(params.error),\n    }),\n  },\n}).createMachine({\n  id: \"remote\",\n  initial: \"loading\",\n  context: ({ input }) => ({\n    ...input,\n    module: null,\n    error: null,\n  }),\n  states: {\n    loading: {\n      tags: [\"loading\"],\n      invoke: {\n        src: \"load\",\n        input: ({ context }) => ({\n          id: context.id,\n          entry: context.entry,\n          instance: context.instance,\n        }),\n        onDone: {\n          target: \"loaded\",\n          actions: [\n            {\n              type: \"setModule\",\n              params: ({ event }) => ({ module: event.output }),\n            },\n          ],\n        },\n        onError: {\n          target: \"error\",\n          actions: [\n            {\n              type: \"setError\",\n              params: ({ event }) => ({ error: event.error }),\n            },\n          ],\n        },\n      },\n    },\n    loaded: {\n      tags: [\"ready\"],\n      entry: sendParent(({ context }) => ({\n        type: \"remote.settled\" as const,\n        id: context.id,\n        status: \"loaded\" as const,\n      })),\n    },\n    error: {\n      tags: [\"failed\"],\n      entry: sendParent(({ context }) => ({\n        type: \"remote.settled\" as const,\n        id: context.id,\n        status: \"error\" as const,\n      })),\n    },\n  },\n});\n\nfunction normaliseError(error: unknown): RemoteError {\n  if (error instanceof Error) {\n    return { message: error.message, cause: error };\n  }\n  return { message: String(error), cause: error };\n}\n","import {\n  createInstance,\n  type FederationInstance,\n} from \"@sanity/federation/runtime\";\nimport { log } from \"@sanity/federation/runtime/plugins/log\";\nimport { type ActorRefFrom, assign, setup } from \"xstate\";\n\nimport { logger } from \"../core/log\";\nimport { remoteLogic } from \"./remote.machine\";\n\ntype RemotesContext = {\n  instance: FederationInstance;\n  children: Map<string, ActorRefFrom<typeof remoteLogic>>;\n};\n\ntype RemotesEvent =\n  | { type: \"remote.load.request\"; id: string; entry: string }\n  | { type: \"remote.settled\"; id: string; status: \"loaded\" | \"error\" };\n\n/**\n * Supervisor machine for federated application remotes.\n *\n * Owns a single {@link FederationInstance} (the `workbench-applications`\n * instance) and spawns one {@link remoteLogic} child per requested\n * remote. The supervisor is invoked at the root of the OS machine for\n * inspector visibility (`[sanity-workbench:os:remotes]`) — boot does\n * not gate on it.\n *\n * @internal\n */\nexport const remotesLogic = setup({\n  types: {\n    context: {} as RemotesContext,\n    events: {} as RemotesEvent,\n  },\n  actors: {\n    remote: remoteLogic,\n  },\n  guards: {\n    remoteNotKnown: ({ context }, params: { id: string }) =>\n      !context.children.has(params.id),\n  },\n  actions: {\n    spawnRemote: assign({\n      children: ({ context, spawn }, params: { id: string; entry: string }) => {\n        const ref = spawn(\"remote\", {\n          id: params.id,\n          systemId: `remotes.${params.id}`,\n          input: {\n            id: params.id,\n            entry: params.entry,\n            instance: context.instance,\n          },\n        });\n        return new Map(context.children).set(params.id, ref);\n      },\n    }),\n  },\n}).createMachine({\n  id: \"remotes\",\n  context: () => ({\n    instance: createInstance({\n      name: \"workbench-applications\",\n      plugins: [log(logger.debug)],\n    }),\n    children: new Map(),\n  }),\n  on: {\n    \"remote.load.request\": {\n      guard: {\n        type: \"remoteNotKnown\",\n        params: ({ event }) => ({ id: event.id }),\n      },\n      actions: [\n        {\n          type: \"spawnRemote\",\n          params: ({ event }) => ({ id: event.id, entry: event.entry }),\n        },\n      ],\n    },\n    // Reserved for future supervision/retry. Forwarded by per-remote\n    // children on entry to `loaded` or `error`; currently a no-op so the\n    // event is part of the typed surface rather than a silent unknown.\n    \"remote.settled\": {},\n  },\n});\n","import { assign, fromCallback, sendTo, setup } from \"xstate\";\n\ntype ColorScheme = \"light\" | \"dark\";\n\ntype ColorSchemePreference = \"system\" | ColorScheme;\n\n/**\n * The system-preferences machine's context. Consumers read fields directly\n * (e.g. via `useSelector`) rather than going through a resolver utility —\n * the action handlers keep `colorScheme` in sync with `preferredColorScheme`\n * and `osColorScheme`.\n *\n * Note: `colorScheme` is intentionally stored as derived state in context so\n * consumers can read the resolved value directly without a utility. The\n * action handlers below are the single source of truth for the resolution.\n * @public\n */\nexport type SystemPreferencesContext = {\n  /** User's color scheme choice; `system` defers to the OS preference. */\n  preferredColorScheme: ColorSchemePreference;\n  /** Last reported OS color scheme. Used to resolve `colorScheme` when the\n   * preference is `system`. */\n  osColorScheme: ColorScheme;\n  /** Resolved color scheme — what the UI should render. Recomputed by the\n   * action handlers whenever an input changes. */\n  colorScheme: ColorScheme;\n};\n\nconst DEFAULT_PREFERRED_COLOR_SCHEME: ColorSchemePreference = \"system\";\nconst DEFAULT_OS_COLOR_SCHEME: ColorScheme = \"light\";\n\n/**\n * Events the system-preferences machine accepts. Both originate from the\n * host's adapter — `preferredColorScheme.set` is also forwarded back to it\n * so it can persist the user's choice.\n * @public\n */\nexport type SystemPreferencesEvent =\n  | {\n      type: \"preferredColorScheme.set\";\n      preferredColorScheme: ColorSchemePreference;\n    }\n  | {\n      type: \"osColorScheme.set\";\n      osColorScheme: ColorScheme;\n    };\n\n/**\n * Adapter interface the host implements to give the system-preferences\n * machine access to the user's environment (OS color scheme, persistent\n * storage, cross-context change notifications).\n *\n * The package owns all orchestration — synchronous seeding, idempotent\n * persistence, mapping cleared storage to `\"system\"`. The host's\n * implementation is pure DOM/storage glue: read, write, subscribe.\n * @public\n */\nexport type SystemPreferencesAdapter = {\n  /** Read the user's stored preference. `null` means \"no preference set\"\n   * (the machine treats this as `\"system\"`). */\n  getPreferredColorScheme: () => ColorSchemePreference | null;\n  /** Write the user's preference to persistent storage. */\n  persistPreferredColorScheme: (value: ColorSchemePreference) => void;\n  /** Subscribe to cross-context preference changes (e.g. another tab\n   * writing to the shared storage). The callback receives the new stored\n   * value (or `null` if it was cleared). Returns an unsubscribe function. */\n  subscribePreferredColorScheme: (\n    callback: (next: ColorSchemePreference | null) => void,\n  ) => () => void;\n  /** Read the current OS-detected color scheme. */\n  getOsColorScheme: () => ColorScheme;\n  /** Subscribe to OS color-scheme changes (e.g. user flipping dark mode).\n   * Returns an unsubscribe function. */\n  subscribeOsColorScheme: (callback: (next: ColorScheme) => void) => () => void;\n};\n\nconst resolveColorScheme = (\n  preferred: ColorSchemePreference,\n  osColorScheme: ColorScheme,\n): ColorScheme => (preferred === \"system\" ? osColorScheme : preferred);\n\n// Internal bridge actor — subscribes to the host's adapter for runtime\n// changes and persists user-driven preference changes when the parent\n// forwards them. No-op if the host didn't pass an adapter (SSR, tests).\ntype AdapterBridgeReceiveEvent = Extract<\n  SystemPreferencesEvent,\n  { type: \"preferredColorScheme.set\" }\n>;\n\nconst adapterBridgeLogic = fromCallback<\n  AdapterBridgeReceiveEvent,\n  SystemPreferencesAdapter | undefined,\n  SystemPreferencesEvent\n>(({ input: adapter, sendBack, receive }) => {\n  if (!adapter) return;\n\n  const unsubscribePreferredColorScheme = adapter.subscribePreferredColorScheme(\n    (next) => {\n      // Falls back to `\"system\"` so an external clear (another tab deleting\n      // the key) resets the preference rather than silently keeping the\n      // previous value.\n      sendBack({\n        type: \"preferredColorScheme.set\",\n        preferredColorScheme: next ?? \"system\",\n      });\n    },\n  );\n\n  const unsubscribeOs = adapter.subscribeOsColorScheme((next) => {\n    sendBack({ type: \"osColorScheme.set\", osColorScheme: next });\n  });\n\n  receive((event) => {\n    // Idempotent: skip writes that match the current stored value so a\n    // `preferredColorScheme.set` originating from cross-context change\n    // doesn't loop back into another write.\n    if (adapter.getPreferredColorScheme() === event.preferredColorScheme)\n      return;\n\n    adapter.persistPreferredColorScheme(event.preferredColorScheme);\n  });\n\n  return () => {\n    unsubscribePreferredColorScheme();\n    unsubscribeOs();\n  };\n});\n\n/**\n * @internal\n */\nexport const systemPreferencesLogic = setup({\n  types: {\n    input: {} as { adapter?: SystemPreferencesAdapter },\n    context: {} as SystemPreferencesContext & {\n      adapter: SystemPreferencesAdapter | undefined;\n    },\n    events: {} as SystemPreferencesEvent,\n  },\n  actors: {\n    adapterBridge: adapterBridgeLogic,\n  },\n  actions: {\n    setPreferredColorScheme: assign({\n      preferredColorScheme: (\n        _,\n        params: { preferredColorScheme: ColorSchemePreference },\n      ) => params.preferredColorScheme,\n      colorScheme: (\n        { context },\n        params: { preferredColorScheme: ColorSchemePreference },\n      ) =>\n        resolveColorScheme(params.preferredColorScheme, context.osColorScheme),\n    }),\n    setOsColorScheme: assign({\n      osColorScheme: (_, params: { osColorScheme: ColorScheme }) =>\n        params.osColorScheme,\n      colorScheme: ({ context }, params: { osColorScheme: ColorScheme }) =>\n        resolveColorScheme(context.preferredColorScheme, params.osColorScheme),\n    }),\n  },\n}).createMachine({\n  id: \"system-preferences\",\n  initial: \"ready\",\n  context: ({ input }) => {\n    const adapter = input.adapter;\n    const preferredColorScheme =\n      adapter?.getPreferredColorScheme() ?? DEFAULT_PREFERRED_COLOR_SCHEME;\n    const osColorScheme =\n      adapter?.getOsColorScheme() ?? DEFAULT_OS_COLOR_SCHEME;\n\n    return {\n      adapter,\n      preferredColorScheme,\n      osColorScheme,\n      colorScheme: resolveColorScheme(preferredColorScheme, osColorScheme),\n    };\n  },\n  invoke: {\n    id: \"adapter\",\n    src: \"adapterBridge\",\n    input: ({ context }) => context.adapter,\n  },\n  states: {\n    ready: {\n      on: {\n        \"preferredColorScheme.set\": {\n          actions: [\n            {\n              type: \"setPreferredColorScheme\",\n              params: ({ event }) => ({\n                preferredColorScheme: event.preferredColorScheme,\n              }),\n            },\n            // Forward to the adapter bridge so it can persist the user's\n            // choice. The bridge guards against redundant writes, so\n            // round-tripping a `preferredColorScheme.set` it sourced itself\n            // (e.g. from a `storage` event in another tab) is a no-op.\n            sendTo(\"adapter\", ({ event }) => event),\n          ],\n        },\n        \"osColorScheme.set\": {\n          actions: [\n            {\n              type: \"setOsColorScheme\",\n              params: ({ event }) => ({\n                osColorScheme: event.osColorScheme,\n              }),\n            },\n          ],\n        },\n      },\n    },\n  },\n});\n","import { getClient, type SanityInstance } from \"@sanity/sdk\";\nimport {\n  type ConsentStatus,\n  createBatchedStore,\n  createSessionId,\n  type TelemetryEvent,\n  type TelemetryStore,\n} from \"@sanity/telemetry\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport type { OSBaseInput } from \"./root.machine\";\n\n/**\n * @public\n */\nexport type WorkbenchUserProperties = {\n  version: string;\n  organizationId: string;\n  environment: string;\n  userAgent: string;\n};\n\n/**\n * @internal\n */\nexport interface TelemetryInput extends OSBaseInput, WorkbenchUserProperties {}\n\n/**\n * TODO: this shouldn't be unique to the telemetry machine,\n * remove this and set it globally with a single client actor.\n */\nconst TELEMETRY_API_VERSION = \"2024-11-12\";\n/**\n * 30 seconds, in milliseconds, is the default flush interval\n * for the telemetry store.\n */\nconst FLUSH_INTERVAL_MS = 30_000;\n\ntype ConsentResult = { status: ConsentStatus };\n\nconst checkConsentLogic = fromPromise<\n  ConsentResult,\n  { instance: SanityInstance }\n>(async ({ input, signal }) => {\n  try {\n    const client = getClient(input.instance, {\n      apiVersion: TELEMETRY_API_VERSION,\n    });\n    return await client.request<ConsentResult>({\n      uri: \"/intake/telemetry-status\",\n      tag: \"telemetry-consent\",\n      signal,\n    });\n  } catch {\n    return { status: \"undetermined\" } satisfies ConsentResult;\n  }\n});\n\ntype TelemetryContext = {\n  instance: SanityInstance;\n  store: TelemetryStore<WorkbenchUserProperties> | null;\n  userProperties: WorkbenchUserProperties;\n};\n\ntype TelemetryMachineEvent =\n  | { type: \"telemetry.start\" }\n  | { type: \"telemetry.stop\" };\n\nexport const telemetryLogic = setup({\n  types: {\n    input: {} as TelemetryInput,\n    context: {} as TelemetryContext,\n    events: {} as TelemetryMachineEvent,\n  },\n  actors: {\n    checkConsent: checkConsentLogic,\n  },\n  guards: {\n    isConsentGranted: (_, params: { status: ConsentStatus }) =>\n      params.status === \"granted\",\n  },\n  actions: {\n    createStore: assign({\n      store: ({ context }) => {\n        const sessionId = createSessionId();\n        const client = getClient(context.instance, {\n          apiVersion: TELEMETRY_API_VERSION,\n        });\n        const store = createBatchedStore<WorkbenchUserProperties>(sessionId, {\n          flushInterval: FLUSH_INTERVAL_MS,\n          resolveConsent: () =>\n            client.request<{ status: ConsentStatus }>({\n              uri: \"/intake/telemetry-status\",\n              tag: \"telemetry-consent\",\n            }),\n          sendEvents: (batch: TelemetryEvent[]) =>\n            client.request({\n              uri: \"/intake/batch\",\n              method: \"POST\",\n              body: { batch },\n              tag: \"telemetry.batch\",\n            }),\n          sendBeacon: (batch: TelemetryEvent[]) => {\n            if (typeof navigator === \"undefined\") {\n              return false;\n            }\n            return navigator.sendBeacon(\n              client.getUrl(\"/intake/batch\"),\n              JSON.stringify({ batch }),\n            );\n          },\n        });\n        store.logger.updateUserProperties(context.userProperties);\n        return store;\n      },\n    }),\n    teardownStore: ({ context }) => {\n      context.store?.end();\n    },\n  },\n}).createMachine({\n  id: \"telemetry\",\n  initial: \"idle\",\n  context: ({ input }) => ({\n    instance: input.instance,\n    store: null,\n    userProperties: {\n      version: input.version,\n      organizationId: input.organizationId,\n      environment: input.environment,\n      userAgent: input.userAgent,\n    },\n  }),\n  states: {\n    idle: {\n      on: {\n        \"telemetry.start\": {\n          target: \"checkingConsent\",\n        },\n      },\n    },\n    checkingConsent: {\n      invoke: {\n        src: \"checkConsent\",\n        input: ({ context }) => ({\n          instance: context.instance,\n        }),\n        onDone: [\n          {\n            guard: {\n              type: \"isConsentGranted\",\n              params: ({ event }) => ({\n                status: event.output.status,\n              }),\n            },\n            actions: [{ type: \"createStore\" }],\n            target: \"active\",\n          },\n          {\n            target: \"denied\",\n          },\n        ],\n      },\n    },\n    active: {\n      tags: [\"telemetry-resolved\"],\n      exit: [{ type: \"teardownStore\" }],\n      on: {\n        \"telemetry.stop\": { target: \"stopped\" },\n      },\n    },\n    stopped: {\n      type: \"final\",\n    },\n    denied: {\n      tags: [\"telemetry-resolved\"],\n    },\n  },\n});\n","import { createSanityInstance, type SanityInstance } from \"@sanity/sdk\";\nimport { raise, sendTo, setup, type ActorOptions } from \"xstate\";\n\nimport { authLogic } from \"./auth.machine\";\nimport { inspect } from \"./inspect\";\nimport { remotesLogic } from \"./remotes.machine\";\nimport {\n  type SystemPreferencesAdapter,\n  systemPreferencesLogic,\n} from \"./system-preferences.machine\";\nimport {\n  telemetryLogic,\n  type WorkbenchUserProperties,\n} from \"./telemetry.machine\";\n\ntype OSInput = WorkbenchUserProperties & {\n  systemPreferencesAdapter?: SystemPreferencesAdapter;\n};\n\ntype OSContext = {\n  instance: SanityInstance;\n  userProperties: WorkbenchUserProperties;\n  systemPreferencesAdapter: SystemPreferencesAdapter | undefined;\n};\n\n/**\n * The base inputs for the OS machine.\n * @internal\n */\nexport interface OSBaseInput extends Pick<OSContext, \"instance\"> {}\n\n/**\n * The sanity OS machine, responsible for managing the global state of the OS.\n * @public\n * @example\n * ```ts\n * import { os, createOSOptions } from \"@sanity/workbench/system\";\n * import { useActor } from \"@xstate/react\";\n *\n * const [state, send] = useActor(os, createOSOptions({\n *   version: \"1.0.0\",\n *   organizationId: \"...\",\n *   environment: \"production\",\n *   userAgent: navigator.userAgent,\n * }));\n * ```\n */\nexport const os = setup({\n  types: {\n    input: {} as OSInput,\n    context: {} as OSContext,\n    events: {} as\n      | { type: \"boot.auth.ready\" }\n      | { type: \"boot.auth.failed\" }\n      | { type: \"boot.telemetry.ready\" },\n    // https://github.com/statelyai/xstate/issues/5515\n    children: {} as {\n      auth: \"auth\";\n      telemetry: \"telemetry\";\n      \"system-preferences\": \"systemPreferences\";\n      remotes: \"remotes\";\n    },\n  },\n  actors: {\n    auth: authLogic,\n    telemetry: telemetryLogic,\n    systemPreferences: systemPreferencesLogic,\n    remotes: remotesLogic,\n  },\n  guards: {\n    hasTag: (_, params: { hasTag: boolean }) => params.hasTag,\n  },\n  actions: {\n    raiseAuthReady: raise({ type: \"boot.auth.ready\" }),\n    raiseAuthFailed: raise({ type: \"boot.auth.failed\" }),\n    raiseTelemetryReady: raise({\n      type: \"boot.telemetry.ready\",\n    }),\n    startTelemetry: sendTo(\"telemetry\", {\n      type: \"telemetry.start\",\n    }),\n  },\n}).createMachine({\n  id: \"os\",\n  context: ({ input }) => ({\n    instance: createSanityInstance(),\n    userProperties: {\n      version: input.version,\n      organizationId: input.organizationId,\n      environment: input.environment,\n      userAgent: input.userAgent,\n    },\n    systemPreferencesAdapter: input.systemPreferencesAdapter,\n  }),\n  initial: \"booting\",\n  invoke: [\n    {\n      id: \"auth\",\n      systemId: \"auth\",\n      src: \"auth\",\n      input: ({ context }) => ({ instance: context.instance }),\n      onSnapshot: [\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"authenticated\"),\n            }),\n          },\n          actions: [{ type: \"raiseAuthReady\" }],\n        },\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"error\"),\n            }),\n          },\n          actions: [{ type: \"raiseAuthFailed\" }],\n        },\n      ],\n    },\n    {\n      id: \"telemetry\",\n      systemId: \"telemetry\",\n      src: \"telemetry\",\n      input: ({ context }) => ({\n        instance: context.instance,\n        ...context.userProperties,\n      }),\n      onSnapshot: [\n        {\n          guard: {\n            type: \"hasTag\",\n            params: ({ event }) => ({\n              hasTag: event.snapshot.hasTag(\"telemetry-resolved\"),\n            }),\n          },\n          actions: [{ type: \"raiseTelemetryReady\" }],\n        },\n      ],\n    },\n    {\n      id: \"system-preferences\",\n      systemId: \"system-preferences\",\n      src: \"systemPreferences\",\n      input: ({ context }) => ({ adapter: context.systemPreferencesAdapter }),\n    },\n    {\n      id: \"remotes\",\n      systemId: \"remotes\",\n      src: \"remotes\",\n    },\n  ],\n  states: {\n    booting: {\n      initial: \"auth\",\n      states: {\n        auth: {\n          on: {\n            \"boot.auth.ready\": {\n              target: \"telemetry\",\n              actions: [{ type: \"startTelemetry\" }],\n            },\n            \"boot.auth.failed\": { target: \"error\" },\n          },\n        },\n        telemetry: {\n          on: {\n            \"boot.telemetry.ready\": { target: \"done\" },\n          },\n        },\n        error: {},\n        done: { type: \"final\" },\n      },\n      onDone: { target: \"running\" },\n    },\n    running: {\n      type: \"parallel\",\n    },\n  },\n});\n\n/**\n * Creates a set of default options for the OS machine. Forwards the workbench\n * user properties to the machine's input and wires the structured-logging\n * `inspect` callback. Browser-specific concerns (color-scheme seeding,\n * persistence) live in the {@link SystemPreferencesAdapter} the host passes\n * via `systemPreferencesAdapter`.\n * @public\n */\nexport function createOSOptions(input: OSInput) {\n  return {\n    id: \"os\",\n    input,\n    inspect,\n  } satisfies ActorOptions<typeof os>;\n}\n"],"names":["log"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workbench",
-  "version": "0.1.0-alpha.16",
+  "version": "0.1.0-alpha.18",
   "description": "Workbench component for the Sanity Content Operating System",
   "keywords": [],
   "homepage": "https://github.com/sanity-io/workbench/packages/@sanity/workbench#readme",
@@ -48,7 +48,7 @@
     "semver": "^7.7.4",
     "xstate": "^5.31.0",
     "zod": "^4.3.6",
-    "@sanity/federation": "0.1.0-alpha.7"
+    "@sanity/federation": "0.1.0-alpha.8"
   },
   "devDependencies": {
     "@sanity/pkg-utils": "^9.2.3",
@@ -56,8 +56,8 @@
     "@types/semver": "^7.7.1",
     "typescript": "^6.0.2",
     "vite": "^7.3.1",
-    "@repo/tsconfig": "0.0.1",
-    "@repo/oxc-config": "0.0.0"
+    "@repo/oxc-config": "0.0.0",
+    "@repo/tsconfig": "0.0.1"
   },
   "peerDependencies": {
     "@sanity/sdk": "^2.9.0"

package/src/core/user-applications/studios/studio.ts

@@ -164,7 +164,7 @@ export class StudioApplication extends UserApplication<
           workspace.basePath === DEFAULT_WORKSPACE_DATA.basePath &&
           workspace.title === DEFAULT_WORKSPACE_DATA.title;
 
-        return new StudioWorkspace(this, workspace, p, isDefaultWorkspace);
+        return this.createWorkspace(workspace, p, isDefaultWorkspace);
       }),
     );
 
@@ -179,6 +179,20 @@ export class StudioApplication extends UserApplication<
     this.projects = Array.from(usedProjects);
   }
 
+  /**
+   * Factory hook called for each workspace during construction. Subclasses
+   * override this to substitute a `StudioWorkspace` subclass (e.g. a UI-aware
+   * variant in a downstream package) without re-implementing the constructor's
+   * workspace-derivation logic.
+   */
+  protected createWorkspace(
+    workspace: Workspace,
+    project: Project<false, false>,
+    isDefaultWorkspace: boolean,
+  ): StudioWorkspace {
+    return new StudioWorkspace(this, workspace, project, isDefaultWorkspace);
+  }
+
   get href() {
     return this.isLocal
       ? `/local/${this.id}`

package/src/system/index.ts

@@ -1,4 +1,10 @@
 export type { AuthInput, LogoutInput } from "./auth.machine";
+export type {
+  LoadedRemoteModule,
+  RemoteError,
+  RemoteInput,
+  RemoteRenderOptions,
+} from "./remote.machine";
 export type {
   SystemPreferencesAdapter,
   SystemPreferencesContext,

package/src/system/remote.machine.ts

@@ -0,0 +1,173 @@
+import type { FederationInstance } from "@sanity/federation/runtime";
+import { assign, fromPromise, sendParent, setup } from "xstate";
+
+/**
+ * @public
+ */
+export interface RemoteRenderOptions {
+  basePath?: string;
+  scheme?: "light" | "dark";
+  /**
+   * This is a temporary measure designed to authenticate federated
+   * studios & SDK apps before we write a working protocol.
+   */
+  unstable_temporaryToken?: string | null;
+}
+
+/**
+ * @public
+ */
+export interface LoadedRemoteModule {
+  render: (
+    rootElement: HTMLElement,
+    options?: RemoteRenderOptions,
+  ) => () => void;
+}
+
+/**
+ * @public
+ */
+export interface RemoteError {
+  message: string;
+  cause: unknown;
+}
+
+/**
+ * Thrown by the load actor when a remote responds successfully but does
+ * not expose a `render` function. Surfaced via `RemoteError.cause` for
+ * consumers that need to discriminate.
+ * @internal
+ */
+export class ModuleShapeError extends Error {
+  constructor(remoteId: string) {
+    super(`Remote "${remoteId}" did not expose a render function`);
+  }
+}
+
+/**
+ * @internal
+ */
+export interface RemoteInput {
+  id: string;
+  entry: string;
+  instance: FederationInstance;
+}
+
+type RemoteContext = RemoteInput & {
+  module: LoadedRemoteModule | null;
+  error: RemoteError | null;
+};
+
+const REMOTE_MODULE = "App";
+
+const loadLogic = fromPromise<LoadedRemoteModule, RemoteInput>(
+  async ({ input }) => {
+    input.instance.registerRemotes([{ name: input.id, entry: input.entry }]);
+    const remoteModule = await input.instance.loadRemote<unknown>(
+      `${input.id}/${REMOTE_MODULE}`,
+    );
+    if (
+      !remoteModule ||
+      typeof (remoteModule as { render?: unknown }).render !== "function"
+    ) {
+      throw new ModuleShapeError(input.id);
+    }
+    return remoteModule as LoadedRemoteModule;
+  },
+);
+
+/**
+ * Lifecycle machine for a single federated application remote.
+ *
+ * Spawned by the {@link remotesLogic} supervisor on demand. Each instance
+ * owns one remote's load lifecycle: `loading` → `loaded | error`. Tags
+ * (`loading` / `ready` / `failed`) drive the UI contract — state names
+ * are internal.
+ *
+ * The machine sends a `remote.settled` event to its parent on entry to
+ * either terminal state, reserved for future supervision/retry.
+ *
+ * @internal
+ */
+export const remoteLogic = setup({
+  types: {
+    input: {} as RemoteInput,
+    context: {} as RemoteContext,
+    tags: {} as "loading" | "ready" | "failed",
+  },
+  actors: {
+    load: loadLogic,
+  },
+  actions: {
+    setModule: assign({
+      module: (_, params: { module: LoadedRemoteModule }) => params.module,
+      error: () => null,
+    }),
+    setError: assign({
+      module: () => null,
+      error: (_, params: { error: unknown }) => normaliseError(params.error),
+    }),
+  },
+}).createMachine({
+  id: "remote",
+  initial: "loading",
+  context: ({ input }) => ({
+    ...input,
+    module: null,
+    error: null,
+  }),
+  states: {
+    loading: {
+      tags: ["loading"],
+      invoke: {
+        src: "load",
+        input: ({ context }) => ({
+          id: context.id,
+          entry: context.entry,
+          instance: context.instance,
+        }),
+        onDone: {
+          target: "loaded",
+          actions: [
+            {
+              type: "setModule",
+              params: ({ event }) => ({ module: event.output }),
+            },
+          ],
+        },
+        onError: {
+          target: "error",
+          actions: [
+            {
+              type: "setError",
+              params: ({ event }) => ({ error: event.error }),
+            },
+          ],
+        },
+      },
+    },
+    loaded: {
+      tags: ["ready"],
+      entry: sendParent(({ context }) => ({
+        type: "remote.settled" as const,
+        id: context.id,
+        status: "loaded" as const,
+      })),
+    },
+    error: {
+      tags: ["failed"],
+      entry: sendParent(({ context }) => ({
+        type: "remote.settled" as const,
+        id: context.id,
+        status: "error" as const,
+      })),
+    },
+  },
+});
+
+function normaliseError(error: unknown): RemoteError {
+  if (error instanceof Error) {
+    return { message: error.message, cause: error };
+  }
+  return { message: String(error), cause: error };
+}