@ethisyscore/extension-runtime 1.9.0 → 1.10.0

package/dist/plugin/index.d.cts

@@ -1,7 +1,10 @@
-import { M as McpTransport } from '../transport-DVn2GVZh.cjs';
+import { M as McpTransport, P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-CIThO7jZ.cjs';
+export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-CIThO7jZ.cjs';
+import * as react from 'react';
 import { ReactNode } from 'react';
 import { SduiNode, RenderMode } from '@ethisyscore/protocol';
 import { RemoteConnection } from '@remote-dom/core';
+import '../bridge-envelopes-BRKGSiSC.cjs';
 
 interface ExtensionRuntimeProviderProps {
     transport: McpTransport;
@@ -397,4 +400,49 @@ interface PortShim {
  */
 declare function createPortMcpTransport(port: MessagePort | PortShim, options?: CreatePortMcpTransportOptions): McpTransport;
 
-export { type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type ItemsResponse, McpTransport, type PortShim, type RemoteRoot, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, createPortMcpTransport, createRemoteRoot, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useMcpQuery, useMcpResource, useMcpTool };
+/**
+ * React context carrying the plugin's active {@link PortBridgeClient}.
+ * Provided by the host mount (WorkerMockHost in dev, real bridge in production)
+ * and consumed by `useBridgeTheme`, `useBridgeLocale`, and the `plugin-ui` hooks.
+ */
+declare const BridgeClientContext: react.Context<PortBridgeClient | null>;
+/**
+ * Returns the bridge client from context, throwing a clear error when missing.
+ * Used by the `useBridge*` hooks to fail loudly on misconfiguration.
+ */
+declare function useBridgeClient(): PortBridgeClient;
+
+/**
+ * Subscribe to host theme pushes. Returns the most recently pushed theme,
+ * or `undefined` before the first push (e.g. during initial render before
+ * the host has sent its first `BRIDGE_PUSH_THEME` message).
+ *
+ * The hook re-registers with the bridge client if the client identity changes
+ * (e.g. on hot-reload of the mock host in dev), keeping state consistent.
+ */
+declare function useBridgeTheme(): ThemePayload | undefined;
+
+/**
+ * Subscribe to host locale pushes. Returns the most recently pushed locale
+ * and text direction, or `undefined` before the first push.
+ */
+declare function useBridgeLocale(): LocalePayload | undefined;
+
+interface UseFrontendSessionTokenResult {
+    /** The compact-serialised JWT, or null while loading / on error. */
+    token: string | null;
+    /** True while the first fetch (or a refresh) is in-flight. */
+    isLoading: boolean;
+    /** Set when the bridge rejects; null otherwise. */
+    error: Error | null;
+}
+/**
+ * Returns the current FE-session token fetched from the host bridge.
+ * Schedules silent refresh 30 s before the token expires.
+ *
+ * @param transport The {@link McpTransport} to use. Typically the context
+ * transport from the extension runtime provider.
+ */
+declare function useFrontendSessionToken(transport: McpTransport): UseFrontendSessionTokenResult;
+
+export { BridgeClientContext, type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type ItemsResponse, LocalePayload, McpTransport, PortBridgeClient, type PortShim, type RemoteRoot, ThemePayload, type UseFrontendSessionTokenResult, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, createPortMcpTransport, createRemoteRoot, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useBridgeClient, useBridgeLocale, useBridgeTheme, useFrontendSessionToken, useMcpQuery, useMcpResource, useMcpTool };

package/dist/plugin/index.d.ts

@@ -1,7 +1,10 @@
-import { M as McpTransport } from '../transport-DVn2GVZh.js';
+import { M as McpTransport, P as PortBridgeClient, T as ThemePayload, L as LocalePayload } from '../bridge-client-UK3qcGoi.js';
+export { A as A11yPayload, B as BridgePortShim, D as DensityPayload, N as NavPayload, S as SessionTokenPayload, c as createPortBridgeClient } from '../bridge-client-UK3qcGoi.js';
+import * as react from 'react';
 import { ReactNode } from 'react';
 import { SduiNode, RenderMode } from '@ethisyscore/protocol';
 import { RemoteConnection } from '@remote-dom/core';
+import '../bridge-envelopes-BRKGSiSC.js';
 
 interface ExtensionRuntimeProviderProps {
     transport: McpTransport;
@@ -397,4 +400,49 @@ interface PortShim {
  */
 declare function createPortMcpTransport(port: MessagePort | PortShim, options?: CreatePortMcpTransportOptions): McpTransport;
 
-export { type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type ItemsResponse, McpTransport, type PortShim, type RemoteRoot, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, createPortMcpTransport, createRemoteRoot, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useMcpQuery, useMcpResource, useMcpTool };
+/**
+ * React context carrying the plugin's active {@link PortBridgeClient}.
+ * Provided by the host mount (WorkerMockHost in dev, real bridge in production)
+ * and consumed by `useBridgeTheme`, `useBridgeLocale`, and the `plugin-ui` hooks.
+ */
+declare const BridgeClientContext: react.Context<PortBridgeClient | null>;
+/**
+ * Returns the bridge client from context, throwing a clear error when missing.
+ * Used by the `useBridge*` hooks to fail loudly on misconfiguration.
+ */
+declare function useBridgeClient(): PortBridgeClient;
+
+/**
+ * Subscribe to host theme pushes. Returns the most recently pushed theme,
+ * or `undefined` before the first push (e.g. during initial render before
+ * the host has sent its first `BRIDGE_PUSH_THEME` message).
+ *
+ * The hook re-registers with the bridge client if the client identity changes
+ * (e.g. on hot-reload of the mock host in dev), keeping state consistent.
+ */
+declare function useBridgeTheme(): ThemePayload | undefined;
+
+/**
+ * Subscribe to host locale pushes. Returns the most recently pushed locale
+ * and text direction, or `undefined` before the first push.
+ */
+declare function useBridgeLocale(): LocalePayload | undefined;
+
+interface UseFrontendSessionTokenResult {
+    /** The compact-serialised JWT, or null while loading / on error. */
+    token: string | null;
+    /** True while the first fetch (or a refresh) is in-flight. */
+    isLoading: boolean;
+    /** Set when the bridge rejects; null otherwise. */
+    error: Error | null;
+}
+/**
+ * Returns the current FE-session token fetched from the host bridge.
+ * Schedules silent refresh 30 s before the token expires.
+ *
+ * @param transport The {@link McpTransport} to use. Typically the context
+ * transport from the extension runtime provider.
+ */
+declare function useFrontendSessionToken(transport: McpTransport): UseFrontendSessionTokenResult;
+
+export { BridgeClientContext, type CreatePortMcpTransportOptions, type CreateRemoteRootOptions, type DeclarativePluginConfig, type EthisysPluginConfig, ExtensionRuntimeProvider, type ExtensionRuntimeProviderProps, type ItemsResponse, LocalePayload, McpTransport, PortBridgeClient, type PortShim, type RemoteRoot, ThemePayload, type UseFrontendSessionTokenResult, type UseMcpQueryOptions, type UseMcpQueryResult, type UseMcpResourceOptions, type UseMcpResourceResult, type UseMcpToolOptions, type UseMcpToolResult, createPortMcpTransport, createRemoteRoot, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useBridgeClient, useBridgeLocale, useBridgeTheme, useFrontendSessionToken, useMcpQuery, useMcpResource, useMcpTool };

package/dist/plugin/index.js

@@ -520,6 +520,204 @@ function abortError() {
   return e;
 }
 
-export { ExtensionRuntimeProvider, createPortMcpTransport, createRemoteRoot, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useMcpQuery, useMcpResource, useMcpTool };
+// src/host/worker/bridge-envelopes.ts
+var BRIDGE_PUSH_THEME = "ethisys:bridge:theme";
+var BRIDGE_PUSH_LOCALE = "ethisys:bridge:locale";
+var BRIDGE_PUSH_DENSITY = "ethisys:bridge:density";
+var BRIDGE_PUSH_A11Y = "ethisys:bridge:a11y";
+var BRIDGE_NAV_PUSH = "ethisys:bridge:nav";
+var BRIDGE_CHROME_REQUEST = "ethisys:bridge:chrome:request";
+var BRIDGE_CHROME_RESPONSE = "ethisys:bridge:chrome:response";
+var BRIDGE_SESSION_TOKEN_PUSH = "ethisys:bridge:token";
+var BRIDGE_A11Y_ANNOUNCE = "ethisys:bridge:a11y:announce";
+function isObj(v) {
+  return v !== null && typeof v === "object";
+}
+function isBridgePushTheme(v) {
+  return isObj(v) && v["type"] === BRIDGE_PUSH_THEME && typeof v["mode"] === "string";
+}
+function isBridgePushLocale(v) {
+  return isObj(v) && v["type"] === BRIDGE_PUSH_LOCALE && typeof v["locale"] === "string";
+}
+function isBridgePushDensity(v) {
+  return isObj(v) && v["type"] === BRIDGE_PUSH_DENSITY && typeof v["density"] === "string";
+}
+function isBridgePushA11y(v) {
+  return isObj(v) && v["type"] === BRIDGE_PUSH_A11Y && typeof v["reducedMotion"] === "boolean" && typeof v["highContrast"] === "boolean";
+}
+function isBridgeNavPush(v) {
+  return isObj(v) && v["type"] === BRIDGE_NAV_PUSH && typeof v["path"] === "string";
+}
+function isBridgeChromeResponse(v) {
+  return isObj(v) && v["type"] === BRIDGE_CHROME_RESPONSE && typeof v["id"] === "string";
+}
+function isBridgeSessionTokenPush(v) {
+  return isObj(v) && v["type"] === BRIDGE_SESSION_TOKEN_PUSH && typeof v["token"] === "string" && typeof v["expiresAtMs"] === "number";
+}
+
+// src/plugin/bridge-client.ts
+var _requestCounter = 0;
+function nextId2() {
+  _requestCounter += 1;
+  return `br-${_requestCounter}`;
+}
+function createPortBridgeClient(port) {
+  let themeCb;
+  let localeCb;
+  let densityCb;
+  let a11yCb;
+  let navCb;
+  let tokenCb;
+  const pending = /* @__PURE__ */ new Map();
+  port.onmessage = (ev) => {
+    const msg = ev.data;
+    if (isBridgePushTheme(msg)) {
+      themeCb?.({ mode: msg.mode, tokens: msg.tokens });
+      return;
+    }
+    if (isBridgePushLocale(msg)) {
+      localeCb?.({ locale: msg.locale, dir: msg.dir });
+      return;
+    }
+    if (isBridgePushDensity(msg)) {
+      densityCb?.({ density: msg.density });
+      return;
+    }
+    if (isBridgePushA11y(msg)) {
+      a11yCb?.({ reducedMotion: msg.reducedMotion, highContrast: msg.highContrast });
+      return;
+    }
+    if (isBridgeNavPush(msg)) {
+      navCb?.({ path: msg.path, historyLength: msg.historyLength });
+      return;
+    }
+    if (isBridgeSessionTokenPush(msg)) {
+      tokenCb?.({ token: msg.token, expiresAtMs: msg.expiresAtMs });
+      return;
+    }
+    if (isBridgeChromeResponse(msg)) {
+      const p = pending.get(msg.id);
+      if (p === void 0) {
+        return;
+      }
+      pending.delete(msg.id);
+      if (msg.ok) {
+        p.resolve(msg.result ?? null);
+      } else {
+        p.reject(new Error(typeof msg.error === "string" ? msg.error : "Chrome request failed"));
+      }
+    }
+  };
+  return {
+    onTheme(cb) {
+      themeCb = cb;
+    },
+    onLocale(cb) {
+      localeCb = cb;
+    },
+    onDensity(cb) {
+      densityCb = cb;
+    },
+    onA11y(cb) {
+      a11yCb = cb;
+    },
+    onNav(cb) {
+      navCb = cb;
+    },
+    onSessionToken(cb) {
+      tokenCb = cb;
+    },
+    requestChrome(action, payload) {
+      const id = nextId2();
+      return new Promise((resolve, reject) => {
+        pending.set(id, { resolve, reject });
+        port.postMessage({ type: BRIDGE_CHROME_REQUEST, id, action, payload });
+      });
+    },
+    announceA11y(message, politeness) {
+      port.postMessage({ type: BRIDGE_A11Y_ANNOUNCE, message, politeness });
+    }
+  };
+}
+var BridgeClientContext = createContext(null);
+function useBridgeClient() {
+  const client = useContext(BridgeClientContext);
+  if (client === null) {
+    throw new Error(
+      "No PortBridgeClient available. Wrap your plugin in <BridgeClientProvider> or ensure the host mount wires a BridgeClientContext.Provider."
+    );
+  }
+  return client;
+}
+function useBridgeTheme() {
+  const client = useBridgeClient();
+  const [theme, setTheme] = useState(void 0);
+  useEffect(() => {
+    client.onTheme((payload) => setTheme(payload));
+  }, [client]);
+  return theme;
+}
+function useBridgeLocale() {
+  const client = useBridgeClient();
+  const [locale, setLocale] = useState(void 0);
+  useEffect(() => {
+    client.onLocale((payload) => setLocale(payload));
+  }, [client]);
+  return locale;
+}
+var SESSION_TOKEN_URI = "ethisys:session-token";
+var REFRESH_SKEW_MS = 3e4;
+function useFrontendSessionToken(transport) {
+  const [token, setToken] = useState(null);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refreshTimerRef = useRef(null);
+  const mountedRef = useRef(true);
+  const fetch = useCallback(async () => {
+    if (refreshTimerRef.current !== null) {
+      clearTimeout(refreshTimerRef.current);
+      refreshTimerRef.current = null;
+    }
+    try {
+      const { data } = await transport.getResource(
+        SESSION_TOKEN_URI
+      );
+      if (!mountedRef.current) {
+        return;
+      }
+      setToken(data.accessToken);
+      setError(null);
+      setIsLoading(false);
+      const expiresAtMs = Date.parse(data.expiresAtUtc);
+      const refreshIn = expiresAtMs - Date.now() - REFRESH_SKEW_MS;
+      if (refreshIn > 0) {
+        refreshTimerRef.current = setTimeout(() => {
+          void fetch();
+        }, refreshIn);
+      }
+    } catch (err) {
+      if (!mountedRef.current) {
+        return;
+      }
+      setError(err instanceof Error ? err : new Error(String(err)));
+      setToken(null);
+      setIsLoading(false);
+    }
+  }, [transport]);
+  useEffect(() => {
+    mountedRef.current = true;
+    setIsLoading(true);
+    void fetch();
+    return () => {
+      mountedRef.current = false;
+      if (refreshTimerRef.current !== null) {
+        clearTimeout(refreshTimerRef.current);
+      }
+    };
+  }, [fetch]);
+  return { token, isLoading, error };
+}
+
+export { BridgeClientContext, ExtensionRuntimeProvider, createPortBridgeClient, createPortMcpTransport, createRemoteRoot, defineDeclarativePlugin, defineEthisysPlugin, unwrapItems, useBridgeClient, useBridgeLocale, useBridgeTheme, useFrontendSessionToken, useMcpQuery, useMcpResource, useMcpTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map