@archie/devtools 0.0.4 → 0.0.6

package/dist/client/inject-inspector/auto.mjs

@@ -0,0 +1,7 @@
+import {
+  injectInspector
+} from "../../chunk-NYVHR4QL.mjs";
+import "../../chunk-6MYORGLK.mjs";
+
+// src/client/inject-inspector/auto.ts
+injectInspector();

package/dist/client/inject-inspector/injectInspector.d.mts

@@ -0,0 +1,33 @@
+/** Only configured domains (Archie host origins) and optionally localhost in dev. "*" is never used. */
+type InjectOptions = {
+    id?: string;
+    /**
+     * Origin(s) allowed to send postMessage commands to the inspector.
+     * If not set, uses Archie host origins + localhost when dev is true.
+     * "*" is not allowed; pass an array of concrete origins.
+     */
+    allowedOrigins?: string | string[];
+    /**
+     * Origin to which the inspector sends postMessage replies.
+     * If not set and in an iframe, uses document.referrer origin.
+     * "*" is not allowed.
+     */
+    targetOrigin?: string;
+    /**
+     * When true, allowedOrigins default includes localhost for local testing.
+     * When undefined, inferred from document.referrer (localhost or missing = dev).
+     */
+    dev?: boolean;
+};
+/**
+ * Loads and runs the Archie inspector script (dynamic import).
+ * Safe to call multiple times: avoids duplicate execution by id.
+ * No-op when run outside the browser (e.g. SSR).
+ *
+ * Origin restrictions are always set (never "*"): Archie host origins, and in dev optionally localhost.
+ *
+ * @returns Promise that resolves to the marker script element, or null if not in browser / already present
+ */
+declare function injectInspector(opts?: InjectOptions): Promise<HTMLScriptElement | null> | null;
+
+export { type InjectOptions, injectInspector };

package/dist/client/inject-inspector/injectInspector.d.ts

@@ -0,0 +1,33 @@
+/** Only configured domains (Archie host origins) and optionally localhost in dev. "*" is never used. */
+type InjectOptions = {
+    id?: string;
+    /**
+     * Origin(s) allowed to send postMessage commands to the inspector.
+     * If not set, uses Archie host origins + localhost when dev is true.
+     * "*" is not allowed; pass an array of concrete origins.
+     */
+    allowedOrigins?: string | string[];
+    /**
+     * Origin to which the inspector sends postMessage replies.
+     * If not set and in an iframe, uses document.referrer origin.
+     * "*" is not allowed.
+     */
+    targetOrigin?: string;
+    /**
+     * When true, allowedOrigins default includes localhost for local testing.
+     * When undefined, inferred from document.referrer (localhost or missing = dev).
+     */
+    dev?: boolean;
+};
+/**
+ * Loads and runs the Archie inspector script (dynamic import).
+ * Safe to call multiple times: avoids duplicate execution by id.
+ * No-op when run outside the browser (e.g. SSR).
+ *
+ * Origin restrictions are always set (never "*"): Archie host origins, and in dev optionally localhost.
+ *
+ * @returns Promise that resolves to the marker script element, or null if not in browser / already present
+ */
+declare function injectInspector(opts?: InjectOptions): Promise<HTMLScriptElement | null> | null;
+
+export { type InjectOptions, injectInspector };