@thor-commerce/app-bridge-react 0.1.0 → 0.2.0

package/dist/react-router.cjs

@@ -0,0 +1,449 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react-router.tsx
+var react_router_exports = {};
+__export(react_router_exports, {
+  ReactRouterAppBridgeProvider: () => ReactRouterAppBridgeProvider
+});
+module.exports = __toCommonJS(react_router_exports);
+var import_react_router = require("react-router");
+
+// src/react.tsx
+var import_react = require("react");
+
+// src/core.ts
+var DEFAULT_NAMESPACE = "thorcommerce:app-bridge";
+var DEFAULT_TIMEOUT_MS = 1e4;
+function createMessageId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function resolveSelfWindow(explicitWindow) {
+  if (explicitWindow) {
+    return explicitWindow;
+  }
+  if (typeof window !== "undefined") {
+    return window;
+  }
+  return void 0;
+}
+function resolveTargetWindow(selfWindow, targetWindow) {
+  if (targetWindow) {
+    return targetWindow;
+  }
+  if (!selfWindow) {
+    return void 0;
+  }
+  if (selfWindow.parent && selfWindow.parent !== selfWindow) {
+    return selfWindow.parent;
+  }
+  return void 0;
+}
+function isDevelopmentEnvironment() {
+  const nodeEnv = typeof globalThis !== "undefined" && "process" in globalThis ? globalThis.process?.env?.NODE_ENV : void 0;
+  if (nodeEnv) {
+    return nodeEnv !== "production";
+  }
+  return true;
+}
+function hasAllowedOrigin(origin, allowedOrigins) {
+  if (!allowedOrigins || allowedOrigins.length === 0) {
+    return true;
+  }
+  return allowedOrigins.includes(origin);
+}
+function omitUndefinedFields(value) {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, fieldValue]) => fieldValue !== void 0)
+  );
+}
+function isBridgeMessage(value, namespace = DEFAULT_NAMESPACE) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const message = value;
+  return message.namespace === namespace && message.version === "1.0" && typeof message.kind === "string" && typeof message.id === "string" && typeof message.type === "string" && typeof message.source === "string";
+}
+var AppBridge = class {
+  constructor(options = {}) {
+    this.eventHandlers = /* @__PURE__ */ new Map();
+    this.requestHandlers = /* @__PURE__ */ new Map();
+    this.pendingRequests = /* @__PURE__ */ new Map();
+    this.namespace = options.namespace ?? DEFAULT_NAMESPACE;
+    this.source = options.source ?? "embedded-app";
+    this.target = options.target;
+    this.targetOrigin = options.targetOrigin ?? "*";
+    this.allowedOrigins = options.allowedOrigins;
+    this.defaultTimeoutMs = options.requestTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.selfWindow = resolveSelfWindow(options.selfWindow);
+    this.targetWindow = resolveTargetWindow(this.selfWindow, options.targetWindow);
+    this.messageListener = (event) => {
+      this.handleMessage(event);
+    };
+    if (!this.selfWindow) {
+      throw new Error(
+        "AppBridge requires a browser window. Pass selfWindow explicitly when constructing it outside global window scope."
+      );
+    }
+    if (this.targetOrigin === "*" && isDevelopmentEnvironment()) {
+      console.warn(
+        'AppBridge is using "*" as targetOrigin. Set targetOrigin explicitly for both the dashboard and embedded app in production.'
+      );
+    }
+    this.selfWindow.addEventListener("message", this.messageListener);
+  }
+  setTargetWindow(targetWindow) {
+    this.targetWindow = targetWindow ?? void 0;
+  }
+  send(type, payload) {
+    this.postMessage({
+      kind: "event",
+      type,
+      payload
+    });
+  }
+  request(type, payload, options = {}) {
+    const messageId = createMessageId();
+    const timeoutMs = options.timeoutMs ?? this.defaultTimeoutMs;
+    return new Promise((resolve, reject) => {
+      const timeoutId = setTimeout(() => {
+        this.pendingRequests.delete(messageId);
+        reject(new Error(`Bridge request timed out for "${type}" after ${timeoutMs}ms.`));
+      }, timeoutMs);
+      this.pendingRequests.set(messageId, {
+        resolve: (value) => resolve(value),
+        reject,
+        timeoutId
+      });
+      try {
+        this.postMessage({
+          id: messageId,
+          kind: "request",
+          type,
+          payload
+        });
+      } catch (error) {
+        clearTimeout(timeoutId);
+        this.pendingRequests.delete(messageId);
+        reject(error instanceof Error ? error : new Error("Failed to send bridge request."));
+      }
+    });
+  }
+  on(type, handler) {
+    const handlers = this.eventHandlers.get(type) ?? /* @__PURE__ */ new Set();
+    handlers.add(handler);
+    this.eventHandlers.set(type, handlers);
+    return () => {
+      handlers.delete(handler);
+      if (handlers.size === 0) {
+        this.eventHandlers.delete(type);
+      }
+    };
+  }
+  onRequest(type, handler) {
+    this.requestHandlers.set(type, handler);
+    return () => {
+      const registeredHandler = this.requestHandlers.get(type);
+      if (registeredHandler === handler) {
+        this.requestHandlers.delete(type);
+      }
+    };
+  }
+  destroy() {
+    if (this.selfWindow) {
+      this.selfWindow.removeEventListener("message", this.messageListener);
+    }
+    for (const pendingRequest of this.pendingRequests.values()) {
+      clearTimeout(pendingRequest.timeoutId);
+      pendingRequest.reject(new Error("AppBridge destroyed before a response was received."));
+    }
+    this.pendingRequests.clear();
+    this.eventHandlers.clear();
+    this.requestHandlers.clear();
+  }
+  handleMessage(event) {
+    if (!hasAllowedOrigin(event.origin, this.allowedOrigins)) {
+      return;
+    }
+    if (!isBridgeMessage(event.data, this.namespace)) {
+      return;
+    }
+    const message = event.data;
+    if (this.target && message.target && message.target !== this.source) {
+      return;
+    }
+    const receivedMessage = {
+      ...message,
+      origin: event.origin,
+      rawEvent: event
+    };
+    if (message.kind === "response" && message.replyTo) {
+      this.resolvePendingRequest(message.replyTo, message);
+      return;
+    }
+    this.emitHandlers(message.type, receivedMessage);
+    if (message.kind === "request") {
+      void this.handleRequest(receivedMessage);
+    }
+  }
+  emitHandlers(type, message) {
+    const typeHandlers = this.eventHandlers.get(type);
+    if (typeHandlers) {
+      for (const handler of typeHandlers) {
+        handler(message);
+      }
+    }
+    if (type === "*") {
+      return;
+    }
+    const wildcardHandlers = this.eventHandlers.get("*");
+    if (wildcardHandlers) {
+      for (const handler of wildcardHandlers) {
+        handler(message);
+      }
+    }
+  }
+  async handleRequest(message) {
+    const handler = this.requestHandlers.get(message.type);
+    if (!handler) {
+      return;
+    }
+    try {
+      const payload = await handler(message.payload, message);
+      this.postMessage({
+        kind: "response",
+        type: message.type,
+        payload,
+        replyTo: message.id
+      });
+    } catch (error) {
+      const bridgeError = error instanceof Error ? { code: "request_handler_error", message: error.message } : { code: "request_handler_error", message: "Unknown request handler error." };
+      this.postMessage({
+        kind: "response",
+        type: message.type,
+        error: bridgeError,
+        replyTo: message.id
+      });
+    }
+  }
+  resolvePendingRequest(messageId, message) {
+    const pendingRequest = this.pendingRequests.get(messageId);
+    if (!pendingRequest) {
+      return;
+    }
+    clearTimeout(pendingRequest.timeoutId);
+    this.pendingRequests.delete(messageId);
+    if (message.error) {
+      pendingRequest.reject(new Error(`${message.error.code}: ${message.error.message}`));
+      return;
+    }
+    pendingRequest.resolve(message.payload);
+  }
+  postMessage(partialMessage) {
+    const targetWindow = this.targetWindow;
+    if (!targetWindow) {
+      throw new Error(
+        "AppBridge could not resolve a target window. Pass targetWindow explicitly or call setTargetWindow()."
+      );
+    }
+    const message = omitUndefinedFields({
+      namespace: this.namespace,
+      version: "1.0",
+      id: partialMessage.id ?? createMessageId(),
+      kind: partialMessage.kind,
+      type: partialMessage.type,
+      source: this.source,
+      target: partialMessage.target ?? this.target,
+      payload: partialMessage.payload,
+      replyTo: partialMessage.replyTo,
+      error: partialMessage.error
+    });
+    targetWindow.postMessage(message, this.targetOrigin);
+  }
+};
+function createAppBridge(options = {}) {
+  return new AppBridge(options);
+}
+
+// src/navigation.ts
+function normalizeSearch(search) {
+  if (!search) {
+    return "";
+  }
+  return search.startsWith("?") ? search : `?${search}`;
+}
+function normalizeHash(hash) {
+  if (!hash) {
+    return "";
+  }
+  return hash.startsWith("#") ? hash : `#${hash}`;
+}
+function buildNavigationUpdatePayload(path) {
+  let pathname = path;
+  let search = "";
+  let hash = "";
+  const hashIndex = pathname.indexOf("#");
+  if (hashIndex >= 0) {
+    hash = pathname.slice(hashIndex);
+    pathname = pathname.slice(0, hashIndex);
+  }
+  const searchIndex = pathname.indexOf("?");
+  if (searchIndex >= 0) {
+    search = pathname.slice(searchIndex);
+    pathname = pathname.slice(0, searchIndex);
+  }
+  return {
+    path: `${pathname || "/"}${search}${hash}`,
+    pathname: pathname || "/",
+    search,
+    hash
+  };
+}
+function resolveNavigationDestination(payload) {
+  if (typeof payload === "string") {
+    return payload;
+  }
+  if (!payload || typeof payload !== "object") {
+    return null;
+  }
+  const value = payload;
+  if (typeof value.path === "string" && value.path) {
+    return value.path;
+  }
+  if (typeof value.href === "string" && value.href) {
+    return value.href;
+  }
+  if (typeof value.pathname !== "string" || !value.pathname) {
+    return null;
+  }
+  return `${value.pathname}${normalizeSearch(value.search ?? "")}${normalizeHash(value.hash ?? "")}`;
+}
+
+// src/react.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var AppBridgeContext = (0, import_react.createContext)(null);
+function AppBridgeProvider({
+  allowedOrigins,
+  children,
+  currentPath,
+  navigationEventType = "navigation:go",
+  navigationUpdateEventType = "navigation:update",
+  namespace,
+  onNavigate,
+  readyEventType = "app:ready",
+  readyPayload,
+  requestTimeoutMs,
+  selfWindow,
+  source,
+  target,
+  targetOrigin,
+  targetWindow
+}) {
+  const [bridge, setBridge] = (0, import_react.useState)(null);
+  const onNavigateRef = (0, import_react.useRef)(onNavigate);
+  const allowedOriginsKey = allowedOrigins?.join("\n") ?? "";
+  (0, import_react.useEffect)(() => {
+    onNavigateRef.current = onNavigate;
+  }, [onNavigate]);
+  (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined" && !selfWindow) {
+      return;
+    }
+    const nextBridge = createAppBridge({
+      allowedOrigins: allowedOriginsKey ? allowedOriginsKey.split("\n") : void 0,
+      namespace,
+      requestTimeoutMs,
+      selfWindow,
+      source,
+      target,
+      targetOrigin,
+      targetWindow
+    });
+    setBridge(nextBridge);
+    nextBridge.send(readyEventType, readyPayload);
+    return () => {
+      setBridge((currentBridge) => currentBridge === nextBridge ? null : currentBridge);
+      nextBridge.destroy();
+    };
+  }, [
+    allowedOriginsKey,
+    namespace,
+    requestTimeoutMs,
+    selfWindow,
+    source,
+    target,
+    targetOrigin,
+    targetWindow
+  ]);
+  (0, import_react.useEffect)(() => {
+    if (!bridge) {
+      return;
+    }
+    bridge.send(readyEventType, readyPayload);
+  }, [bridge, readyEventType, readyPayload]);
+  (0, import_react.useEffect)(() => {
+    if (!bridge || !currentPath) {
+      return;
+    }
+    bridge.send(navigationUpdateEventType, buildNavigationUpdatePayload(currentPath));
+  }, [bridge, currentPath, navigationUpdateEventType]);
+  (0, import_react.useEffect)(() => {
+    if (!bridge || !onNavigate) {
+      return;
+    }
+    return bridge.on(navigationEventType, (message) => {
+      const destination = resolveNavigationDestination(message.payload);
+      if (!destination) {
+        return;
+      }
+      onNavigateRef.current?.(destination, message);
+    });
+  }, [bridge, navigationEventType, onNavigate]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AppBridgeContext.Provider, { value: bridge, children });
+}
+
+// src/react-router.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function ReactRouterAppBridgeProvider({
+  children,
+  ...props
+}) {
+  const location = (0, import_react_router.useLocation)();
+  const navigate = (0, import_react_router.useNavigate)();
+  const currentPath = `${location.pathname}${location.search}${location.hash}`;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    AppBridgeProvider,
+    {
+      ...props,
+      currentPath,
+      onNavigate: (path) => {
+        void navigate(path);
+      },
+      children
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReactRouterAppBridgeProvider
+});
+//# sourceMappingURL=react-router.cjs.map

package/dist/react-router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react-router.tsx","../src/react.tsx","../src/core.ts","../src/navigation.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\n\nimport {\n  AppBridgeProvider,\n  type AppBridgeProviderProps\n} from \"./react\";\n\nexport interface ReactRouterAppBridgeProviderProps\n  extends Omit<AppBridgeProviderProps, \"currentPath\" | \"onNavigate\"> {\n  children: ReactNode;\n}\n\nexport function ReactRouterAppBridgeProvider({\n  children,\n  ...props\n}: ReactRouterAppBridgeProviderProps) {\n  const location = useLocation();\n  const navigate = useNavigate();\n  const currentPath = `${location.pathname}${location.search}${location.hash}`;\n\n  return (\n    <AppBridgeProvider\n      {...props}\n      currentPath={currentPath}\n      onNavigate={(path) => {\n        void navigate(path);\n      }}\n    >\n      {children}\n    </AppBridgeProvider>\n  );\n}\n","import {\n  createContext,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n  type ReactNode\n} from \"react\";\n\nimport {\n  createAppBridge,\n  type AppBridge,\n  type AppBridgeOptions,\n  type ReceivedBridgeMessage\n} from \"./core\";\nimport {\n  buildNavigationUpdatePayload,\n  resolveNavigationDestination,\n  type BridgeNavigationGoPayload\n} from \"./navigation\";\n\nconst AppBridgeContext = createContext<AppBridge | null>(null);\n\nexport interface AppBridgeProviderProps extends AppBridgeOptions {\n  children: ReactNode;\n  readyEventType?: string;\n  readyPayload?: unknown;\n  currentPath?: string | null;\n  navigationEventType?: string;\n  navigationUpdateEventType?: string;\n  onNavigate?: (\n    path: string,\n    message: ReceivedBridgeMessage<BridgeNavigationGoPayload>\n  ) => void;\n}\n\nexport function AppBridgeProvider({\n  allowedOrigins,\n  children,\n  currentPath,\n  navigationEventType = \"navigation:go\",\n  navigationUpdateEventType = \"navigation:update\",\n  namespace,\n  onNavigate,\n  readyEventType = \"app:ready\",\n  readyPayload,\n  requestTimeoutMs,\n  selfWindow,\n  source,\n  target,\n  targetOrigin,\n  targetWindow\n}: AppBridgeProviderProps) {\n  const [bridge, setBridge] = useState<AppBridge | null>(null);\n  const onNavigateRef = useRef(onNavigate);\n  const allowedOriginsKey = allowedOrigins?.join(\"\\n\") ?? \"\";\n\n  useEffect(() => {\n    onNavigateRef.current = onNavigate;\n  }, [onNavigate]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" && !selfWindow) {\n      return;\n    }\n\n    const nextBridge = createAppBridge({\n      allowedOrigins: allowedOriginsKey ? allowedOriginsKey.split(\"\\n\") : undefined,\n      namespace,\n      requestTimeoutMs,\n      selfWindow,\n      source,\n      target,\n      targetOrigin,\n      targetWindow\n    });\n\n    setBridge(nextBridge);\n    nextBridge.send(readyEventType, readyPayload);\n\n    return () => {\n      setBridge((currentBridge) => (currentBridge === nextBridge ? null : currentBridge));\n      nextBridge.destroy();\n    };\n  }, [\n    allowedOriginsKey,\n    namespace,\n    requestTimeoutMs,\n    selfWindow,\n    source,\n    target,\n    targetOrigin,\n    targetWindow\n  ]);\n\n  useEffect(() => {\n    if (!bridge) {\n      return;\n    }\n\n    bridge.send(readyEventType, readyPayload);\n  }, [bridge, readyEventType, readyPayload]);\n\n  useEffect(() => {\n    if (!bridge || !currentPath) {\n      return;\n    }\n\n    bridge.send(navigationUpdateEventType, buildNavigationUpdatePayload(currentPath));\n  }, [bridge, currentPath, navigationUpdateEventType]);\n\n  useEffect(() => {\n    if (!bridge || !onNavigate) {\n      return;\n    }\n\n    return bridge.on<BridgeNavigationGoPayload>(navigationEventType, (message) => {\n      const destination = resolveNavigationDestination(message.payload);\n      if (!destination) {\n        return;\n      }\n\n      onNavigateRef.current?.(destination, message);\n    });\n  }, [bridge, navigationEventType, onNavigate]);\n\n  return <AppBridgeContext.Provider value={bridge}>{children}</AppBridgeContext.Provider>;\n}\n\nexport function useAppBridge() {\n  return useContext(AppBridgeContext);\n}\n","export type BridgeParticipant = \"embedded-app\" | \"dashboard\" | \"unknown\";\n\nexport type BridgeMessageKind = \"event\" | \"request\" | \"response\";\n\nexport interface BridgeErrorPayload {\n  code: string;\n  message: string;\n}\n\nexport interface BridgeMessage<TPayload = unknown> {\n  namespace: string;\n  version: \"1.0\";\n  kind: BridgeMessageKind;\n  id: string;\n  type: string;\n  source: BridgeParticipant;\n  target?: BridgeParticipant;\n  payload?: TPayload;\n  replyTo?: string;\n  error?: BridgeErrorPayload;\n}\n\nexport interface AppBridgeOptions {\n  source?: BridgeParticipant;\n  target?: BridgeParticipant;\n  namespace?: string;\n  targetOrigin?: string;\n  allowedOrigins?: string[];\n  requestTimeoutMs?: number;\n  selfWindow?: Window;\n  targetWindow?: Window | null;\n}\n\nexport interface RequestOptions {\n  timeoutMs?: number;\n}\n\nexport interface ReceivedBridgeMessage<TPayload = unknown> extends BridgeMessage<TPayload> {\n  origin: string;\n  rawEvent: MessageEvent<unknown>;\n}\n\nexport type BridgeEventHandler<TPayload = unknown> = (\n  message: ReceivedBridgeMessage<TPayload>\n) => void;\n\nexport type BridgeRequestHandler<TRequest = unknown, TResponse = unknown> = (\n  payload: TRequest,\n  message: ReceivedBridgeMessage<TRequest>\n) => TResponse | Promise<TResponse>;\n\nexport type Unsubscribe = () => void;\n\nconst DEFAULT_NAMESPACE = \"thorcommerce:app-bridge\";\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\nfunction createMessageId() {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n\n  return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction resolveSelfWindow(explicitWindow?: Window) {\n  if (explicitWindow) {\n    return explicitWindow;\n  }\n\n  if (typeof window !== \"undefined\") {\n    return window;\n  }\n\n  return undefined;\n}\n\nfunction resolveTargetWindow(selfWindow: Window | undefined, targetWindow?: Window | null) {\n  if (targetWindow) {\n    return targetWindow;\n  }\n\n  if (!selfWindow) {\n    return undefined;\n  }\n\n  if (selfWindow.parent && selfWindow.parent !== selfWindow) {\n    return selfWindow.parent;\n  }\n\n  return undefined;\n}\n\nfunction isDevelopmentEnvironment() {\n  const nodeEnv =\n    typeof globalThis !== \"undefined\" && \"process\" in globalThis\n      ? (\n          globalThis as typeof globalThis & {\n            process?: { env?: { NODE_ENV?: string } };\n          }\n        ).process?.env?.NODE_ENV\n      : undefined;\n\n  if (nodeEnv) {\n    return nodeEnv !== \"production\";\n  }\n\n  return true;\n}\n\nfunction hasAllowedOrigin(origin: string, allowedOrigins?: string[]) {\n  if (!allowedOrigins || allowedOrigins.length === 0) {\n    return true;\n  }\n\n  return allowedOrigins.includes(origin);\n}\n\nfunction omitUndefinedFields<T extends object>(value: T): T {\n  return Object.fromEntries(\n    Object.entries(value).filter(([, fieldValue]) => fieldValue !== undefined)\n  ) as T;\n}\n\nexport function isBridgeMessage<TPayload = unknown>(\n  value: unknown,\n  namespace = DEFAULT_NAMESPACE\n): value is BridgeMessage<TPayload> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const message = value as Partial<BridgeMessage<TPayload>>;\n\n  return (\n    message.namespace === namespace &&\n    message.version === \"1.0\" &&\n    typeof message.kind === \"string\" &&\n    typeof message.id === \"string\" &&\n    typeof message.type === \"string\" &&\n    typeof message.source === \"string\"\n  );\n}\n\nexport class AppBridge {\n  private readonly namespace: string;\n  private readonly source: BridgeParticipant;\n  private readonly target: BridgeParticipant | undefined;\n  private readonly targetOrigin: string;\n  private readonly allowedOrigins?: string[];\n  private readonly selfWindow?: Window;\n  private readonly defaultTimeoutMs: number;\n  private targetWindow?: Window;\n  private readonly eventHandlers = new Map<string, Set<BridgeEventHandler>>();\n  private readonly requestHandlers = new Map<string, BridgeRequestHandler>();\n  private readonly pendingRequests = new Map<\n    string,\n    {\n      resolve: (value: unknown) => void;\n      reject: (error: Error) => void;\n      timeoutId: ReturnType<typeof setTimeout>;\n    }\n  >();\n  private readonly messageListener: (event: MessageEvent<unknown>) => void;\n\n  constructor(options: AppBridgeOptions = {}) {\n    this.namespace = options.namespace ?? DEFAULT_NAMESPACE;\n    this.source = options.source ?? \"embedded-app\";\n    this.target = options.target;\n    this.targetOrigin = options.targetOrigin ?? \"*\";\n    this.allowedOrigins = options.allowedOrigins;\n    this.defaultTimeoutMs = options.requestTimeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.selfWindow = resolveSelfWindow(options.selfWindow);\n    this.targetWindow = resolveTargetWindow(this.selfWindow, options.targetWindow);\n    this.messageListener = (event) => {\n      this.handleMessage(event);\n    };\n\n    if (!this.selfWindow) {\n      throw new Error(\n        \"AppBridge requires a browser window. Pass selfWindow explicitly when constructing it outside global window scope.\"\n      );\n    }\n\n    if (this.targetOrigin === \"*\" && isDevelopmentEnvironment()) {\n      console.warn(\n        'AppBridge is using \"*\" as targetOrigin. Set targetOrigin explicitly for both the dashboard and embedded app in production.'\n      );\n    }\n\n    this.selfWindow.addEventListener(\"message\", this.messageListener);\n  }\n\n  setTargetWindow(targetWindow: Window | null) {\n    this.targetWindow = targetWindow ?? undefined;\n  }\n\n  send<TPayload = unknown>(type: string, payload?: TPayload) {\n    this.postMessage({\n      kind: \"event\",\n      type,\n      payload\n    });\n  }\n\n  request<TRequest = unknown, TResponse = unknown>(\n    type: string,\n    payload?: TRequest,\n    options: RequestOptions = {}\n  ) {\n    const messageId = createMessageId();\n    const timeoutMs = options.timeoutMs ?? this.defaultTimeoutMs;\n\n    return new Promise<TResponse>((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        this.pendingRequests.delete(messageId);\n        reject(new Error(`Bridge request timed out for \"${type}\" after ${timeoutMs}ms.`));\n      }, timeoutMs);\n\n      this.pendingRequests.set(messageId, {\n        resolve: (value) => resolve(value as TResponse),\n        reject,\n        timeoutId\n      });\n\n      try {\n        this.postMessage({\n          id: messageId,\n          kind: \"request\",\n          type,\n          payload\n        });\n      } catch (error) {\n        clearTimeout(timeoutId);\n        this.pendingRequests.delete(messageId);\n        reject(error instanceof Error ? error : new Error(\"Failed to send bridge request.\"));\n      }\n    });\n  }\n\n  on<TPayload = unknown>(type: string, handler: BridgeEventHandler<TPayload>): Unsubscribe {\n    const handlers = this.eventHandlers.get(type) ?? new Set<BridgeEventHandler>();\n    handlers.add(handler as BridgeEventHandler);\n    this.eventHandlers.set(type, handlers);\n\n    return () => {\n      handlers.delete(handler as BridgeEventHandler);\n      if (handlers.size === 0) {\n        this.eventHandlers.delete(type);\n      }\n    };\n  }\n\n  onRequest<TRequest = unknown, TResponse = unknown>(\n    type: string,\n    handler: BridgeRequestHandler<TRequest, TResponse>\n  ): Unsubscribe {\n    this.requestHandlers.set(type, handler as BridgeRequestHandler);\n\n    return () => {\n      const registeredHandler = this.requestHandlers.get(type);\n      if (registeredHandler === handler) {\n        this.requestHandlers.delete(type);\n      }\n    };\n  }\n\n  destroy() {\n    if (this.selfWindow) {\n      this.selfWindow.removeEventListener(\"message\", this.messageListener);\n    }\n\n    for (const pendingRequest of this.pendingRequests.values()) {\n      clearTimeout(pendingRequest.timeoutId);\n      pendingRequest.reject(new Error(\"AppBridge destroyed before a response was received.\"));\n    }\n\n    this.pendingRequests.clear();\n    this.eventHandlers.clear();\n    this.requestHandlers.clear();\n  }\n\n  private handleMessage(event: MessageEvent<unknown>) {\n    if (!hasAllowedOrigin(event.origin, this.allowedOrigins)) {\n      return;\n    }\n\n    if (!isBridgeMessage(event.data, this.namespace)) {\n      return;\n    }\n\n    const message = event.data;\n\n    if (this.target && message.target && message.target !== this.source) {\n      return;\n    }\n\n    const receivedMessage: ReceivedBridgeMessage = {\n      ...message,\n      origin: event.origin,\n      rawEvent: event\n    };\n\n    if (message.kind === \"response\" && message.replyTo) {\n      this.resolvePendingRequest(message.replyTo, message);\n      return;\n    }\n\n    this.emitHandlers(message.type, receivedMessage);\n\n    if (message.kind === \"request\") {\n      void this.handleRequest(receivedMessage);\n    }\n  }\n\n  private emitHandlers(type: string, message: ReceivedBridgeMessage) {\n    const typeHandlers = this.eventHandlers.get(type);\n    if (typeHandlers) {\n      for (const handler of typeHandlers) {\n        handler(message);\n      }\n    }\n\n    if (type === \"*\") {\n      return;\n    }\n\n    const wildcardHandlers = this.eventHandlers.get(\"*\");\n    if (wildcardHandlers) {\n      for (const handler of wildcardHandlers) {\n        handler(message);\n      }\n    }\n  }\n\n  private async handleRequest(message: ReceivedBridgeMessage) {\n    const handler = this.requestHandlers.get(message.type);\n    if (!handler) {\n      return;\n    }\n\n    try {\n      const payload = await handler(message.payload, message);\n      this.postMessage({\n        kind: \"response\",\n        type: message.type,\n        payload,\n        replyTo: message.id\n      });\n    } catch (error) {\n      const bridgeError =\n        error instanceof Error\n          ? { code: \"request_handler_error\", message: error.message }\n          : { code: \"request_handler_error\", message: \"Unknown request handler error.\" };\n\n      this.postMessage({\n        kind: \"response\",\n        type: message.type,\n        error: bridgeError,\n        replyTo: message.id\n      });\n    }\n  }\n\n  private resolvePendingRequest(messageId: string, message: BridgeMessage) {\n    const pendingRequest = this.pendingRequests.get(messageId);\n    if (!pendingRequest) {\n      return;\n    }\n\n    clearTimeout(pendingRequest.timeoutId);\n    this.pendingRequests.delete(messageId);\n\n    if (message.error) {\n      pendingRequest.reject(new Error(`${message.error.code}: ${message.error.message}`));\n      return;\n    }\n\n    pendingRequest.resolve(message.payload);\n  }\n\n  private postMessage<TPayload = unknown>(\n    partialMessage: Pick<BridgeMessage<TPayload>, \"kind\" | \"type\"> &\n      Partial<Omit<BridgeMessage<TPayload>, \"namespace\" | \"version\" | \"source\">>\n  ) {\n    const targetWindow = this.targetWindow;\n    if (!targetWindow) {\n      throw new Error(\n        \"AppBridge could not resolve a target window. Pass targetWindow explicitly or call setTargetWindow().\"\n      );\n    }\n\n    const message = omitUndefinedFields({\n      namespace: this.namespace,\n      version: \"1.0\",\n      id: partialMessage.id ?? createMessageId(),\n      kind: partialMessage.kind,\n      type: partialMessage.type,\n      source: this.source,\n      target: partialMessage.target ?? this.target,\n      payload: partialMessage.payload,\n      replyTo: partialMessage.replyTo,\n      error: partialMessage.error\n    }) as BridgeMessage<TPayload>;\n\n    targetWindow.postMessage(message, this.targetOrigin);\n  }\n}\n\nexport function createAppBridge(options: AppBridgeOptions = {}) {\n  return new AppBridge(options);\n}\n","export interface BridgeNavigationGoPayload {\n  path?: string;\n  href?: string;\n  pathname?: string;\n  search?: string;\n  hash?: string;\n}\n\nexport interface BridgeNavigationUpdatePayload {\n  path: string;\n  pathname: string;\n  search: string;\n  hash: string;\n}\n\nfunction normalizeSearch(search: string) {\n  if (!search) {\n    return \"\";\n  }\n\n  return search.startsWith(\"?\") ? search : `?${search}`;\n}\n\nfunction normalizeHash(hash: string) {\n  if (!hash) {\n    return \"\";\n  }\n\n  return hash.startsWith(\"#\") ? hash : `#${hash}`;\n}\n\nexport function buildNavigationUpdatePayload(path: string): BridgeNavigationUpdatePayload {\n  let pathname = path;\n  let search = \"\";\n  let hash = \"\";\n\n  const hashIndex = pathname.indexOf(\"#\");\n  if (hashIndex >= 0) {\n    hash = pathname.slice(hashIndex);\n    pathname = pathname.slice(0, hashIndex);\n  }\n\n  const searchIndex = pathname.indexOf(\"?\");\n  if (searchIndex >= 0) {\n    search = pathname.slice(searchIndex);\n    pathname = pathname.slice(0, searchIndex);\n  }\n\n  return {\n    path: `${pathname || \"/\"}${search}${hash}`,\n    pathname: pathname || \"/\",\n    search,\n    hash\n  };\n}\n\nexport function resolveNavigationDestination(payload: unknown): string | null {\n  if (typeof payload === \"string\") {\n    return payload;\n  }\n\n  if (!payload || typeof payload !== \"object\") {\n    return null;\n  }\n\n  const value = payload as BridgeNavigationGoPayload;\n\n  if (typeof value.path === \"string\" && value.path) {\n    return value.path;\n  }\n\n  if (typeof value.href === \"string\" && value.href) {\n    return value.href;\n  }\n\n  if (typeof value.pathname !== \"string\" || !value.pathname) {\n    return null;\n  }\n\n  return `${value.pathname}${normalizeSearch(value.search ?? \"\")}${normalizeHash(value.hash ?? \"\")}`;\n}\n"],"mappings":"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","names":["import_jsx_runtime"]}

package/dist/react-router.d.cts

@@ -0,0 +1,10 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { AppBridgeProviderProps } from './index.cjs';
+
+interface ReactRouterAppBridgeProviderProps extends Omit<AppBridgeProviderProps, "currentPath" | "onNavigate"> {
+    children: ReactNode;
+}
+declare function ReactRouterAppBridgeProvider({ children, ...props }: ReactRouterAppBridgeProviderProps): react_jsx_runtime.JSX.Element;
+
+export { ReactRouterAppBridgeProvider, type ReactRouterAppBridgeProviderProps };

package/dist/react-router.d.ts

@@ -0,0 +1,10 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { AppBridgeProviderProps } from './index.js';
+
+interface ReactRouterAppBridgeProviderProps extends Omit<AppBridgeProviderProps, "currentPath" | "onNavigate"> {
+    children: ReactNode;
+}
+declare function ReactRouterAppBridgeProvider({ children, ...props }: ReactRouterAppBridgeProviderProps): react_jsx_runtime.JSX.Element;
+
+export { ReactRouterAppBridgeProvider, type ReactRouterAppBridgeProviderProps };

package/dist/react-router.js

@@ -0,0 +1,30 @@
+import {
+  AppBridgeProvider
+} from "./chunk-J4BEZO5J.js";
+
+// src/react-router.tsx
+import { useLocation, useNavigate } from "react-router";
+import { jsx } from "react/jsx-runtime";
+function ReactRouterAppBridgeProvider({
+  children,
+  ...props
+}) {
+  const location = useLocation();
+  const navigate = useNavigate();
+  const currentPath = `${location.pathname}${location.search}${location.hash}`;
+  return /* @__PURE__ */ jsx(
+    AppBridgeProvider,
+    {
+      ...props,
+      currentPath,
+      onNavigate: (path) => {
+        void navigate(path);
+      },
+      children
+    }
+  );
+}
+export {
+  ReactRouterAppBridgeProvider
+};
+//# sourceMappingURL=react-router.js.map

package/dist/react-router.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react-router.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useLocation, useNavigate } from \"react-router\";\n\nimport {\n  AppBridgeProvider,\n  type AppBridgeProviderProps\n} from \"./react\";\n\nexport interface ReactRouterAppBridgeProviderProps\n  extends Omit<AppBridgeProviderProps, \"currentPath\" | \"onNavigate\"> {\n  children: ReactNode;\n}\n\nexport function ReactRouterAppBridgeProvider({\n  children,\n  ...props\n}: ReactRouterAppBridgeProviderProps) {\n  const location = useLocation();\n  const navigate = useNavigate();\n  const currentPath = `${location.pathname}${location.search}${location.hash}`;\n\n  return (\n    <AppBridgeProvider\n      {...props}\n      currentPath={currentPath}\n      onNavigate={(path) => {\n        void navigate(path);\n      }}\n    >\n      {children}\n    </AppBridgeProvider>\n  );\n}\n"],"mappings":";;;;;AACA,SAAS,aAAa,mBAAmB;AAqBrC;AATG,SAAS,6BAA6B;AAAA,EAC3C;AAAA,EACA,GAAG;AACL,GAAsC;AACpC,QAAM,WAAW,YAAY;AAC7B,QAAM,WAAW,YAAY;AAC7B,QAAM,cAAc,GAAG,SAAS,QAAQ,GAAG,SAAS,MAAM,GAAG,SAAS,IAAI;AAE1E,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACA,YAAY,CAAC,SAAS;AACpB,aAAK,SAAS,IAAI;AAAA,MACpB;AAAA,MAEC;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thor-commerce/app-bridge-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Communication bridge between embedded apps and the Thor Commerce dashboard",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -11,6 +11,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./react-router": {
+      "types": "./dist/react-router.d.ts",
+      "import": "./dist/react-router.js",
+      "require": "./dist/react-router.cjs"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.js",
+      "require": "./dist/next.cjs"
     }
   },
   "files": [
@@ -19,19 +29,64 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "release": "semantic-release",
     "test": "tsx --test test/*.test.ts",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "tagFormat": "v${version}",
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      [
+        "@semantic-release/npm",
+        {
+          "npmPublish": true
+        }
+      ]
+    ]
+  },
   "devDependencies": {
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "react": "^19.2.4",
+    "react-router": "^7.13.1",
+    "semantic-release": "^25.0.3",
     "tsup": "^8.0.0",
     "tsx": "^4.21.0",
     "typescript": "^5.5.0"
   },
   "license": "MIT",
+  "peerDependencies": {
+    "next": ">=13.4.0",
+    "react": ">=18.2.0",
+    "react-router": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react-router": {
+      "optional": true
+    }
+  },
   "repository": {
-    "type": "git"
+    "type": "git",
+    "url": "git+https://github.com/thor-commerce/thor-app-bridge.git"
+  },
+  "homepage": "https://github.com/thor-commerce/thor-email-app",
+  "bugs": {
+    "url": "https://github.com/thor-commerce/thor-app-bridge/issues"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "keywords": [
     "thor-commerce",