@thor-commerce/app-bridge-react 0.7.3 → 0.8.0

package/README.md

@@ -10,6 +10,53 @@ Repository link: [thor-email-app](https://github.com/thor-commerce/thor-email-ap
 npm install @thor-commerce/app-bridge-react
 ```
 
+## CDN Runtime
+
+The package now also builds a standalone browser runtime that can be hosted on a CDN.
+
+Build it with:
+
+```bash
+pnpm build
+```
+
+The CDN-friendly artifact is:
+
+```txt
+dist/thor-app-bridge.js
+```
+
+You can load it before your app bundle:
+
+```html
+<script
+  src="https://cdn.example.com/thor-app-bridge/thor-app-bridge.js"
+  data-client-id="your-client-id"
+  data-target-origin="https://dashboard.thorcommerce.com"
+></script>
+```
+
+For Shopify-like markup, the script also accepts `data-api-key`, but the value must still be the public Thor `clientId`, not the `clientSecret`.
+
+That script:
+
+- bootstraps a singleton runtime before React mounts
+- patches same-origin `fetch` to attach Thor session tokens
+- intercepts in-app navigation and reports sanitized paths back to the dashboard
+- keeps embedded launch params on the iframe document URL
+
+If you do not want auto-init, omit the data attributes and initialize it manually:
+
+```html
+<script src="https://cdn.example.com/thor-app-bridge/thor-app-bridge.js"></script>
+<script>
+  window.ThorAppBridge.init({
+    clientId: "your-client-id",
+    targetOrigin: "https://dashboard.thorcommerce.com",
+  });
+</script>
+```
+
 ## Core Usage
 
 ```ts
@@ -65,6 +112,7 @@ export function Providers({ children }: { children: React.ReactNode }) {
 `ReactRouterAppBridgeProvider` and `NextAppBridgeProvider` automatically:
 
 - create the bridge on the client
+- attach to the singleton runtime when the browser script already initialized it
 - send `app:ready`
 - emit `navigation:update` when the route changes
 - listen for `navigation:go` and push the app to the requested route