@salve-software/react-native-nitro-jsdom 1.0.0

package/src/classes/JSDOM/types/IJSDOMOptions.ts

@@ -0,0 +1,57 @@
+import type { IFetchRequestInit, IFetchResponseInit } from './IFetchOptions';
+
+export interface IJSDOMOptions {
+  /** Execute <script> tags found in the initial HTML. Default: true */
+  runScripts?: boolean;
+  /** Value of window.location.href inside the sandbox. Default: 'about:blank' */
+  url?: string;
+  /** Sets document.hidden = false. Default: false */
+  pretendToBeVisual?: boolean;
+  /**
+   * Callback invoked whenever console.log / warn / error / info / debug is called
+   * inside the sandbox. If not provided, console output is silently discarded.
+   */
+  onConsole?: (level: 'log' | 'warn' | 'error' | 'info' | 'debug', args: string[]) => void;
+  /**
+   * Callback invoked when `window.alert(message)` is called inside the sandbox.
+   * If not provided, alert() is a silent no-op (browser default when no UI is available).
+   *
+   * WARNING: The callback is synchronous. Do NOT call back into the same sandbox
+   * from inside the callback — QuickJS is not re-entrant.
+   */
+  onAlert?: (message: string) => void;
+  /**
+   * Callback invoked when `window.confirm(message)` is called inside the sandbox.
+   * Must return a boolean. If not provided, confirm() returns false (browser default).
+   *
+   * WARNING: The callback is synchronous. Do NOT call back into the same sandbox
+   * from inside the callback — QuickJS is not re-entrant.
+   */
+  onConfirm?: (message: string) => boolean;
+  /**
+   * Callback invoked when `window.prompt(message, defaultValue?)` is called inside
+   * the sandbox. Return a string for the user input, or null for a dismissed prompt.
+   * If not provided, prompt() returns null (browser default for dismissed prompts).
+   *
+   * WARNING: The callback is synchronous. Do NOT call back into the same sandbox
+   * from inside the callback — QuickJS is not re-entrant.
+   */
+  onPrompt?: (message: string, defaultValue?: string) => string | null;
+  /**
+   * Callback invoked when `fetch(url, init)` is called inside the sandbox.
+   * Receives the request and must resolve with the response. If not provided,
+   * `fetch()` inside the sandbox rejects with "fetch is not available".
+   *
+   * Typically wired to React Native's real `fetch()`:
+   * ```ts
+   * onFetch: async (url, init) => {
+   *   const res = await fetch(url, init)
+   *   return { status: res.status, statusText: res.statusText, headers: Object.fromEntries(res.headers), body: await res.text() }
+   * }
+   * ```
+   *
+   * WARNING: Do NOT call back into the same sandbox (`dom.evaluate()`) from inside
+   * this callback — QuickJS is not re-entrant.
+   */
+  onFetch?: (url: string, init: IFetchRequestInit) => Promise<IFetchResponseInit>;
+}

package/src/classes/JSDOM/types/index.ts

@@ -0,0 +1,2 @@
+export type * from './IJSDOMOptions';
+export type * from './IFetchOptions';

package/src/classes/index.ts

@@ -0,0 +1 @@
+export * from './JSDOM';

package/src/index.ts

@@ -0,0 +1 @@
+export * from './classes';

package/src/specs/HtmlSandbox.nitro.ts

@@ -0,0 +1,33 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export interface HtmlSandbox extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  // Must be called once right after createHybridObject()
+  initialize(html: string, runScripts: boolean, url: string): void;
+
+  // Run arbitrary JS inside the QuickJS sandbox; returns the result as a string
+  evaluate(script: string): Promise<string>;
+
+  // Returns the current HTML of the document
+  serialize(): string;
+
+  // Set (or clear) the console output callback. Pass null to silence console output.
+  setConsoleCallback(callback: ((level: string, args: string[]) => void) | null): void;
+
+  // Set (or clear) the dialog callbacks for window.alert / confirm / prompt.
+  // Pass null for any callback to use the browser default (no-op / false / null).
+  setDialogCallbacks(
+    onAlert: ((message: string) => void) | null,
+    onConfirm: ((message: string) => boolean) | null,
+    onPrompt: ((message: string, defaultValue?: string) => string | null) | null,
+  ): void;
+
+  // Set (or clear) the fetch() bridge. Pass null to disable fetch() inside the sandbox
+  // (calling it will reject). The callback receives (url, method, headersJson, body) and
+  // must resolve with a JSON-encoded response: {ok, status, statusText, headersJson, body}.
+  // Declared as returning Promise<string> (not `string`) so Nitro's JSIConverter for
+  // Promise<T> properly chains `.then()` on the real async JS callback — a plain `string`
+  // return type is only auto-dispatched across threads, it does NOT await a returned Promise.
+  setFetchCallback(
+    callback: ((url: string, method: string, headersJson: string, body?: string) => Promise<string>) | null,
+  ): void;
+}