@thor-commerce/app-bridge-react 0.3.0 → 0.4.0

package/dist/{chunk-JNYIAUPA.js → chunk-EASM25ZU.js}

@@ -1,6 +1,61 @@
+// 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/core.ts
 var DEFAULT_NAMESPACE = "thorcommerce:app-bridge";
 var DEFAULT_TIMEOUT_MS = 1e4;
+var DEFAULT_REDIRECT_EVENT_TYPE = "navigation:redirect";
 function createMessageId() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
@@ -41,6 +96,9 @@ function hasAllowedOrigin(origin, allowedOrigins) {
   }
   return allowedOrigins.includes(origin);
 }
+function isMessageTarget(value) {
+  return !!value && typeof value.postMessage === "function";
+}
 function omitUndefinedFields(value) {
   return Object.fromEntries(
     Object.entries(value).filter(([, fieldValue]) => fieldValue !== void 0)
@@ -87,6 +145,27 @@ var AppBridge = class {
   hasTargetWindow() {
     return this.targetWindow !== void 0;
   }
+  redirect(payload) {
+    const destination = resolveNavigationDestination(payload);
+    if (!destination) {
+      throw new Error("AppBridge redirect requires a valid destination.");
+    }
+    if (!this.targetWindow) {
+      this.navigateSelf(destination);
+      return;
+    }
+    this.postMessage({
+      kind: "event",
+      type: DEFAULT_REDIRECT_EVENT_TYPE,
+      payload: typeof payload === "string" ? { href: payload } : payload
+    });
+  }
+  redirectToRemote(href) {
+    this.redirect({ href });
+  }
+  redirectToApp(path) {
+    this.redirect(typeof path === "string" ? { path } : path);
+  }
   send(type, payload) {
     this.postMessage({
       kind: "event",
@@ -169,6 +248,9 @@ var AppBridge = class {
       origin: event.origin,
       rawEvent: event
     };
+    if (message.kind === "event" && message.type === DEFAULT_REDIRECT_EVENT_TYPE && this.handleRedirectMessage(receivedMessage)) {
+      return;
+    }
     if (message.kind === "response" && message.replyTo) {
       this.resolvePendingRequest(message.replyTo, message);
       return;
@@ -200,22 +282,29 @@ var AppBridge = class {
     if (!handler) {
       return;
     }
+    const replyTarget = isMessageTarget(message.rawEvent.source) ? message.rawEvent.source : this.targetWindow;
     try {
       const payload = await handler(message.payload, message);
-      this.postMessage({
-        kind: "response",
-        type: message.type,
-        payload,
-        replyTo: message.id
-      });
+      this.postMessage(
+        {
+          kind: "response",
+          type: message.type,
+          payload,
+          replyTo: message.id
+        },
+        replyTarget
+      );
     } 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
-      });
+      this.postMessage(
+        {
+          kind: "response",
+          type: message.type,
+          error: bridgeError,
+          replyTo: message.id
+        },
+        replyTarget
+      );
     }
   }
   resolvePendingRequest(messageId, message) {
@@ -231,8 +320,8 @@ var AppBridge = class {
     }
     pendingRequest.resolve(message.payload);
   }
-  postMessage(partialMessage) {
-    const targetWindow = this.targetWindow;
+  postMessage(partialMessage, targetWindowOverride) {
+    const targetWindow = targetWindowOverride ?? this.targetWindow;
     if (!targetWindow) {
       throw new Error(
         "AppBridge could not resolve a target window. Pass targetWindow explicitly or call setTargetWindow()."
@@ -252,65 +341,25 @@ var AppBridge = class {
     });
     targetWindow.postMessage(message, this.targetOrigin);
   }
+  handleRedirectMessage(message) {
+    const destination = resolveNavigationDestination(message.payload);
+    if (!destination) {
+      return false;
+    }
+    this.navigateSelf(destination);
+    return true;
+  }
+  navigateSelf(destination) {
+    if (!this.selfWindow) {
+      throw new Error("AppBridge could not resolve a browser window for redirect.");
+    }
+    this.selfWindow.location.assign(destination);
+  }
 };
 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
 import {
   createContext,
@@ -359,7 +408,6 @@ function AppBridgeProvider({
       targetWindow
     });
     setBridge(nextBridge);
-    nextBridge.send(readyEventType, readyPayload);
     return () => {
       setBridge((currentBridge) => currentBridge === nextBridge ? null : currentBridge);
       nextBridge.destroy();
@@ -405,12 +453,12 @@ function useAppBridge() {
 }
 
 export {
+  buildNavigationUpdatePayload,
+  resolveNavigationDestination,
   isBridgeMessage,
   AppBridge,
   createAppBridge,
-  buildNavigationUpdatePayload,
-  resolveNavigationDestination,
   AppBridgeProvider,
   useAppBridge
 };
-//# sourceMappingURL=chunk-JNYIAUPA.js.map
+//# sourceMappingURL=chunk-EASM25ZU.js.map

package/dist/chunk-EASM25ZU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/navigation.ts","../src/core.ts","../src/react.tsx"],"sourcesContent":["export interface BridgeNavigationGoPayload {\n  path?: string;\n  href?: string;\n  pathname?: string;\n  search?: string;\n  hash?: string;\n}\n\nexport interface BridgeNavigationRedirectPayload extends BridgeNavigationGoPayload {}\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","import {\n  resolveNavigationDestination,\n  type BridgeNavigationGoPayload,\n  type BridgeNavigationRedirectPayload\n} from \"./navigation\";\n\nexport 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;\nconst DEFAULT_REDIRECT_EVENT_TYPE = \"navigation:redirect\";\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 isMessageTarget(value: unknown): value is Window {\n  return !!value && typeof (value as Window).postMessage === \"function\";\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  hasTargetWindow() {\n    return this.targetWindow !== undefined;\n  }\n\n  redirect(payload: string | BridgeNavigationRedirectPayload) {\n    const destination = resolveNavigationDestination(payload);\n    if (!destination) {\n      throw new Error(\"AppBridge redirect requires a valid destination.\");\n    }\n\n    if (!this.targetWindow) {\n      this.navigateSelf(destination);\n      return;\n    }\n\n    this.postMessage<BridgeNavigationRedirectPayload>({\n      kind: \"event\",\n      type: DEFAULT_REDIRECT_EVENT_TYPE,\n      payload: typeof payload === \"string\" ? { href: payload } : payload\n    });\n  }\n\n  redirectToRemote(href: string) {\n    this.redirect({ href });\n  }\n\n  redirectToApp(path: string | BridgeNavigationGoPayload) {\n    this.redirect(typeof path === \"string\" ? { path } : path);\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 (\n      message.kind === \"event\" &&\n      message.type === DEFAULT_REDIRECT_EVENT_TYPE &&\n      this.handleRedirectMessage(receivedMessage)\n    ) {\n      return;\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    const replyTarget = isMessageTarget(message.rawEvent.source)\n      ? message.rawEvent.source\n      : this.targetWindow;\n\n    try {\n      const payload = await handler(message.payload, message);\n      this.postMessage(\n        {\n          kind: \"response\",\n          type: message.type,\n          payload,\n          replyTo: message.id\n        },\n        replyTarget\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        {\n          kind: \"response\",\n          type: message.type,\n          error: bridgeError,\n          replyTo: message.id\n        },\n        replyTarget\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    targetWindowOverride?: Window\n  ) {\n    const targetWindow = targetWindowOverride ?? 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  private handleRedirectMessage(message: ReceivedBridgeMessage): boolean {\n    const destination = resolveNavigationDestination(message.payload);\n    if (!destination) {\n      return false;\n    }\n\n    this.navigateSelf(destination);\n    return true;\n  }\n\n  private navigateSelf(destination: string) {\n    if (!this.selfWindow) {\n      throw new Error(\"AppBridge could not resolve a browser window for redirect.\");\n    }\n\n    this.selfWindow.location.assign(destination);\n  }\n}\n\nexport function createAppBridge(options: AppBridgeOptions = {}) {\n  return new AppBridge(options);\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\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 || !bridge.hasTargetWindow()) {\n      return;\n    }\n\n    bridge.send(readyEventType, readyPayload);\n  }, [bridge, readyEventType, readyPayload]);\n\n  useEffect(() => {\n    if (!bridge || !bridge.hasTargetWindow() || !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"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -30,9 +30,64 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// 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/core.ts
 var DEFAULT_NAMESPACE = "thorcommerce:app-bridge";
 var DEFAULT_TIMEOUT_MS = 1e4;
+var DEFAULT_REDIRECT_EVENT_TYPE = "navigation:redirect";
 function createMessageId() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
@@ -73,6 +128,9 @@ function hasAllowedOrigin(origin, allowedOrigins) {
   }
   return allowedOrigins.includes(origin);
 }
+function isMessageTarget(value) {
+  return !!value && typeof value.postMessage === "function";
+}
 function omitUndefinedFields(value) {
   return Object.fromEntries(
     Object.entries(value).filter(([, fieldValue]) => fieldValue !== void 0)
@@ -119,6 +177,27 @@ var AppBridge = class {
   hasTargetWindow() {
     return this.targetWindow !== void 0;
   }
+  redirect(payload) {
+    const destination = resolveNavigationDestination(payload);
+    if (!destination) {
+      throw new Error("AppBridge redirect requires a valid destination.");
+    }
+    if (!this.targetWindow) {
+      this.navigateSelf(destination);
+      return;
+    }
+    this.postMessage({
+      kind: "event",
+      type: DEFAULT_REDIRECT_EVENT_TYPE,
+      payload: typeof payload === "string" ? { href: payload } : payload
+    });
+  }
+  redirectToRemote(href) {
+    this.redirect({ href });
+  }
+  redirectToApp(path) {
+    this.redirect(typeof path === "string" ? { path } : path);
+  }
   send(type, payload) {
     this.postMessage({
       kind: "event",
@@ -201,6 +280,9 @@ var AppBridge = class {
       origin: event.origin,
       rawEvent: event
     };
+    if (message.kind === "event" && message.type === DEFAULT_REDIRECT_EVENT_TYPE && this.handleRedirectMessage(receivedMessage)) {
+      return;
+    }
     if (message.kind === "response" && message.replyTo) {
       this.resolvePendingRequest(message.replyTo, message);
       return;
@@ -232,22 +314,29 @@ var AppBridge = class {
     if (!handler) {
       return;
     }
+    const replyTarget = isMessageTarget(message.rawEvent.source) ? message.rawEvent.source : this.targetWindow;
     try {
       const payload = await handler(message.payload, message);
-      this.postMessage({
-        kind: "response",
-        type: message.type,
-        payload,
-        replyTo: message.id
-      });
+      this.postMessage(
+        {
+          kind: "response",
+          type: message.type,
+          payload,
+          replyTo: message.id
+        },
+        replyTarget
+      );
     } 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
-      });
+      this.postMessage(
+        {
+          kind: "response",
+          type: message.type,
+          error: bridgeError,
+          replyTo: message.id
+        },
+        replyTarget
+      );
     }
   }
   resolvePendingRequest(messageId, message) {
@@ -263,8 +352,8 @@ var AppBridge = class {
     }
     pendingRequest.resolve(message.payload);
   }
-  postMessage(partialMessage) {
-    const targetWindow = this.targetWindow;
+  postMessage(partialMessage, targetWindowOverride) {
+    const targetWindow = targetWindowOverride ?? this.targetWindow;
     if (!targetWindow) {
       throw new Error(
         "AppBridge could not resolve a target window. Pass targetWindow explicitly or call setTargetWindow()."
@@ -284,65 +373,25 @@ var AppBridge = class {
     });
     targetWindow.postMessage(message, this.targetOrigin);
   }
+  handleRedirectMessage(message) {
+    const destination = resolveNavigationDestination(message.payload);
+    if (!destination) {
+      return false;
+    }
+    this.navigateSelf(destination);
+    return true;
+  }
+  navigateSelf(destination) {
+    if (!this.selfWindow) {
+      throw new Error("AppBridge could not resolve a browser window for redirect.");
+    }
+    this.selfWindow.location.assign(destination);
+  }
 };
 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_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -385,7 +434,6 @@ function AppBridgeProvider({
       targetWindow
     });
     setBridge(nextBridge);
-    nextBridge.send(readyEventType, readyPayload);
     return () => {
       setBridge((currentBridge) => currentBridge === nextBridge ? null : currentBridge);
       nextBridge.destroy();