@gjsify/iframe 0.10.0 → 0.11.0

package/lib/types/message-bridge.d.ts

@@ -1,6 +1,14 @@
 import WebKit from 'gi://WebKit?version=6.0';
+import './promisify.js';
 import type { IFrameWindowProxy } from './iframe-window-proxy.js';
+import type { ConsoleCallback, ConsoleLogEntry } from './types/index.js';
 import type { MessagePort } from '@gjsify/message-channel';
+/** Options for {@link MessageBridge}. */
+export interface MessageBridgeOptions {
+    /** Inject the console-capture UserScript so the page's console.* is
+     *  forwarded to the host. Default: false. */
+    captureConsole?: boolean;
+}
 /**
  * Synthetic origin attached to messages travelling FROM the GJS host
  * INTO the WebView. The WebView can use this in a targetOrigin filter to
@@ -65,7 +73,19 @@ export declare class MessageBridge {
     private _nextPortId;
     private _transport;
     private _getTransport;
-    constructor(webView: WebKit.WebView);
+    private _captureConsole;
+    private _consoleBuffer;
+    private _consoleCallbacks;
+    constructor(webView: WebKit.WebView, options?: MessageBridgeOptions);
+    /** Buffered console entries captured from the page (oldest first). Empty
+     *  unless the bridge was created with `captureConsole`. */
+    getConsoleLogs(): ConsoleLogEntry[];
+    /** Drop all buffered console entries. */
+    clearConsoleLogs(): void;
+    /** Subscribe to console entries as they arrive. */
+    onConsole(cb: ConsoleCallback): void;
+    /** @internal Record a parsed console entry + fan out to subscribers. */
+    private _recordConsole;
     /** Connect the IFrameWindowProxy that will receive messages from the WebView */
     setWindowProxy(proxy: IFrameWindowProxy): void;
     /** Update current URI (called by IFrameBridge on load-changed) */
@@ -118,4 +138,10 @@ export declare class MessageBridge {
      * window.parent.postMessage() bridges back to GJS.
      */
     private _injectBootstrapScript;
+    /**
+     * Inject the opt-in console-capture UserScript so the page's `console.*`
+     * output is mirrored to the host. Self-contained (own handler reference +
+     * idempotency guard), so it is independent of the bootstrap script.
+     */
+    private _injectConsoleCaptureScript;
 }

package/lib/types/promisify.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/types/index.d.ts

@@ -4,6 +4,10 @@ export interface IFrameBridgeOptions {
     enableDeveloperExtras?: boolean;
     /** Enable JavaScript execution in the WebView. Default: true */
     enableJavascript?: boolean;
+    /** Mirror the page's `console.*` output to the host so it can be read via
+     *  `getConsoleLogs()` / `onConsole()`. Off by default — it wraps `console`
+     *  on every page, so it is opt-in. Default: false */
+    captureConsole?: boolean;
 }
 /** Data structure for messages crossing the GJS/WebView boundary */
 export interface IFrameMessageData {
@@ -13,3 +17,23 @@ export interface IFrameMessageData {
 }
 /** Callback for when the IFrameBridge is ready */
 export type IFrameReadyCallback = (iframe: globalThis.HTMLIFrameElement) => void;
+/** Detail of the most recent failed load (a network / main-resource failure
+ *  surfaced by WebKit's `load-failed` signal, distinct from an HTTP error
+ *  page which still loads and reports `FINISHED`). */
+export interface LoadErrorInfo {
+    /** The URI that failed to load. */
+    uri: string;
+    /** Human-readable failure message from WebKit / GLib. */
+    message: string;
+}
+/** Callback invoked when a load fails. */
+export type LoadErrorCallback = (info: LoadErrorInfo) => void;
+/** A captured `console.*` call forwarded from the page. */
+export interface ConsoleLogEntry {
+    /** The console level (`log` / `warn` / `error` / `info` / `debug`). */
+    level: string;
+    /** The call arguments, stringified in-page. */
+    args: string[];
+}
+/** Callback invoked for each captured console entry. */
+export type ConsoleCallback = (entry: ConsoleLogEntry) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/iframe",
-    "version": "0.10.0",
+    "version": "0.11.0",
     "description": "HTMLIFrameElement for GJS, backed by WebKit.WebView",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -38,13 +38,13 @@
         "@girs/gtk-4.0": "4.23.0-4.0.4",
         "@girs/javascriptcore-6.0": "2.52.1-4.0.4",
         "@girs/webkit-6.0": "2.52.1-4.0.4",
-        "@gjsify/dom-elements": "^0.10.0",
-        "@gjsify/dom-events": "^0.10.0",
-        "@gjsify/message-channel": "^0.10.0"
+        "@gjsify/dom-elements": "^0.11.0",
+        "@gjsify/dom-events": "^0.11.0",
+        "@gjsify/message-channel": "^0.11.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.10.0",
-        "@gjsify/unit": "^0.10.0",
+        "@gjsify/cli": "^0.11.0",
+        "@gjsify/unit": "^0.11.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },