feat: ar:// protocol doc links

shim.d.ts

@@ -14,6 +14,7 @@ declare module "@arconnect/webext-bridge" {
     event: Event;
     auth_listening: number;
     auth_chunk: Chunk;
+    ar_protocol: ProtocolWithReturn<{ url: string }, { url: sting }>;
   }
 }
 

src/contents/ar_protocol.ts

@@ -0,0 +1,48 @@
+import { sendMessage } from "@arconnect/webext-bridge";
+import type { PlasmoCSConfig } from "plasmo";
+import { isString } from "typed-assert";
+
+export const config: PlasmoCSConfig = {
+  matches: ["file://*/*", "http://*/*", "https://*/*"],
+  run_at: "document_start",
+  all_frames: true
+};
+
+document.addEventListener("DOMContentLoaded", async () => {
+  // all elements with the "ar://" protocol
+  const elements = document.querySelectorAll(
+    'a[href^="ar://"], img[src^="ar://"], iframe[src^="ar://"], ' +
+      'audio > source[src^="ar://"], video > source[src^="ar://"], ' +
+      'link[href^="ar://"], embed[src^="ar://"], object[data^="ar://"],' +
+      'script[src^="ar://"]'
+  );
+  const fields = {
+    src: ["img", "iframe", "source", "embed", "script"],
+    href: ["a", "link"],
+    data: ["object"]
+  };
+
+  for (const el of elements) {
+    // ask the background script to return the correct ar:// url
+    try {
+      const res = await sendMessage(
+        "ar_protocol",
+        { url: el[fields[el.tagName]] },
+        "background"
+      );
+
+      // check result
+      isString(res?.url);
+
+      el[fields[el.tagName]] = res.url;
+
+      // reload parent
+      if (el.tagName === "SOURCE") {
+        // @ts-expect-error
+        el.parentNode.load();
+      }
+    } catch {
+      console.error(`Failed to load ar:// resource: ${el[fields[el.tagName]]}`);
+    }
+  }
+});

src/gateways/wayfinder.ts

@@ -26,6 +26,8 @@ export function useGateway(requirements: Requirements) {
     })();
   }, [requirements]);
 
+  // TODO: health check
+
   return activeGateway;
 }