@parhelia/editor-bridge-head 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export declare const PARHELIA_BRIDGE_HEAD_READY_MESSAGE = "parhelia:bridge-head-ready";
+export declare const PARHELIA_BRIDGE_URL_MESSAGE = "parhelia:bridge-url";
+export type BridgeHeadReadyMessage = {
+    type: typeof PARHELIA_BRIDGE_HEAD_READY_MESSAGE;
+    href: string;
+};
+export type BridgeUrlMessage = {
+    type: typeof PARHELIA_BRIDGE_URL_MESSAGE;
+    bridgeUrl: string;
+};
+export type EditorBridgeHeadOptions = {
+    allowedOrigins?: readonly string[];
+    autoAnnounce?: boolean;
+    scriptId?: string;
+};
+export type EditorBridgeHeadHandle = {
+    announceReady: () => void;
+    dispose: () => void;
+    loadBridge: (bridgeUrl: string) => HTMLScriptElement | undefined;
+};
+export declare function installEditorBridgeHead(options?: EditorBridgeHeadOptions): EditorBridgeHeadHandle | undefined;
+export declare function getAutoInstalledEditorBridgeHead(): EditorBridgeHeadHandle | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kCAAkC,+BACjB,CAAC;AAC/B,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AAIjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,OAAO,kCAAkC,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,2BAA2B,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;CAClE,CAAC;AAIF,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,GAAG,SAAS,CA8CpC;AAiFD,wBAAgB,gCAAgC,uCAE/C"}

package/dist/index.js

@@ -0,0 +1,108 @@
+export const PARHELIA_BRIDGE_HEAD_READY_MESSAGE = "parhelia:bridge-head-ready";
+export const PARHELIA_BRIDGE_URL_MESSAGE = "parhelia:bridge-url";
+const DEFAULT_SCRIPT_ID = "parhelia-editor-bridge";
+let autoInstalledHandle;
+export function installEditorBridgeHead(options = {}) {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+        return undefined;
+    }
+    const scriptId = options.scriptId ?? DEFAULT_SCRIPT_ID;
+    const allowedOrigins = options.allowedOrigins ?? getAllowedOrigins();
+    const scriptNonce = getCurrentScriptNonce();
+    const loadBridge = (bridgeUrl) => loadBridgeScript(bridgeUrl, scriptId, scriptNonce);
+    const handleMessage = (event) => {
+        if (event.source !== window.parent)
+            return;
+        if (allowedOrigins.length > 0 && !allowedOrigins.includes(event.origin)) {
+            return;
+        }
+        const message = parseBridgeUrlMessage(event.data);
+        if (!message)
+            return;
+        loadBridge(message.bridgeUrl);
+    };
+    const announceReady = () => {
+        if (window.parent === window)
+            return;
+        const message = {
+            type: PARHELIA_BRIDGE_HEAD_READY_MESSAGE,
+            href: window.location.href,
+        };
+        window.parent.postMessage(message, "*");
+    };
+    window.addEventListener("message", handleMessage);
+    if (options.autoAnnounce !== false) {
+        announceReady();
+    }
+    return {
+        announceReady,
+        dispose: () => window.removeEventListener("message", handleMessage),
+        loadBridge,
+    };
+}
+function loadBridgeScript(bridgeUrl, scriptId, scriptNonce) {
+    const normalizedUrl = normalizeBridgeUrl(bridgeUrl);
+    if (!normalizedUrl)
+        return undefined;
+    const existingScript = document.getElementById(scriptId);
+    if (existingScript instanceof HTMLScriptElement) {
+        if (existingScript.src === normalizedUrl)
+            return existingScript;
+        existingScript.remove();
+    }
+    const script = document.createElement("script");
+    script.id = scriptId;
+    script.async = true;
+    script.src = normalizedUrl;
+    if (scriptNonce)
+        script.nonce = scriptNonce;
+    const parent = document.head ?? document.documentElement;
+    parent.appendChild(script);
+    return script;
+}
+function normalizeBridgeUrl(bridgeUrl) {
+    try {
+        const url = new URL(bridgeUrl, window.location.href);
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            return undefined;
+        }
+        return url.href;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseBridgeUrlMessage(data) {
+    if (!isRecord(data))
+        return undefined;
+    if (data.type !== PARHELIA_BRIDGE_URL_MESSAGE)
+        return undefined;
+    if (typeof data.bridgeUrl !== "string" || data.bridgeUrl.length === 0) {
+        return undefined;
+    }
+    return {
+        type: PARHELIA_BRIDGE_URL_MESSAGE,
+        bridgeUrl: data.bridgeUrl,
+    };
+}
+function getAllowedOrigins() {
+    const origins = document.currentScript instanceof HTMLScriptElement
+        ? document.currentScript.dataset.parheliaAllowedOrigins
+        : undefined;
+    return (origins
+        ?.split(",")
+        .map((origin) => origin.trim())
+        .filter(Boolean) ?? []);
+}
+function getCurrentScriptNonce() {
+    return document.currentScript instanceof HTMLScriptElement
+        ? (document.currentScript.nonce ?? "")
+        : "";
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+autoInstalledHandle = installEditorBridgeHead();
+export function getAutoInstalledEditorBridgeHead() {
+    return autoInstalledHandle;
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@parhelia/editor-bridge-head",
+  "version": "1.0.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "sideEffects": true,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:native": "tsgo -p tsconfig.build.json",
+    "lint": "tsc --noEmit -p tsconfig.build.json",
+    "check-types": "tsc --noEmit -p tsconfig.build.json",
+    "check-types:native": "tsgo --noEmit -p tsconfig.build.json"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "*",
+    "typescript": "5.8.2"
+  }
+}