@opentabs-dev/plugin-sdk 0.0.10 → 0.0.11

package/dist/dom.d.ts

@@ -0,0 +1,38 @@
+export interface WaitForSelectorOptions {
+    /** Timeout in milliseconds (default: 10000) */
+    timeout?: number;
+}
+export interface ObserveDOMOptions {
+    /** Watch for added/removed child nodes (default: true) */
+    childList?: boolean;
+    /** Watch for attribute changes (default: false) */
+    attributes?: boolean;
+    /** Watch the entire subtree (default: true) */
+    subtree?: boolean;
+}
+/**
+ * Waits for an element matching `selector` to appear in the DOM.
+ * Uses MutationObserver for efficient detection, falls back to an
+ * initial querySelector check for elements already present.
+ */
+export declare const waitForSelector: (selector: string, opts?: WaitForSelectorOptions) => Promise<Element>;
+/**
+ * Waits for an element matching `selector` to be removed from the DOM.
+ * Resolves immediately if no matching element exists.
+ */
+export declare const waitForSelectorRemoval: (selector: string, opts?: WaitForSelectorOptions) => Promise<void>;
+/**
+ * Typed wrapper around `document.querySelectorAll` that returns a real array.
+ */
+export declare const querySelectorAll: <T extends Element = Element>(selector: string) => T[];
+/**
+ * Returns the trimmed `textContent` of the first element matching `selector`,
+ * or `null` if no element is found.
+ */
+export declare const getTextContent: (selector: string) => string | null;
+/**
+ * Sets up a MutationObserver on the element matching `selector`.
+ * Returns a cleanup function that disconnects the observer.
+ */
+export declare const observeDOM: (selector: string, callback: (mutations: MutationRecord[], observer: MutationObserver) => void, options?: ObserveDOMOptions) => (() => void);
+//# sourceMappingURL=dom.d.ts.map

package/dist/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,OAAO,sBAAsB,KAAG,OAAO,CAAC,OAAO,CA+BhG,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,EAAE,OAAO,sBAAsB,KAAG,OAAO,CAAC,IAAI,CA6BpG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,UAAU,MAAM,KAAG,CAAC,EAC9B,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAI1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EAC3E,UAAU,iBAAiB,KAC1B,CAAC,MAAM,IAAI,CAcb,CAAC"}

package/dist/dom.js

@@ -0,0 +1,102 @@
+// ---------------------------------------------------------------------------
+// DOM utilities for plugin authors
+// ---------------------------------------------------------------------------
+/**
+ * Waits for an element matching `selector` to appear in the DOM.
+ * Uses MutationObserver for efficient detection, falls back to an
+ * initial querySelector check for elements already present.
+ */
+export const waitForSelector = (selector, opts) => {
+    const timeout = opts?.timeout ?? 10_000;
+    return new Promise((resolve, reject) => {
+        const existing = document.querySelector(selector);
+        if (existing) {
+            resolve(existing);
+            return;
+        }
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            observer.disconnect();
+            reject(new Error(`waitForSelector: timed out after ${timeout}ms waiting for "${selector}"`));
+        }, timeout);
+        const observer = new MutationObserver(() => {
+            const el = document.querySelector(selector);
+            if (el) {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                observer.disconnect();
+                resolve(el);
+            }
+        });
+        observer.observe(document.body, { childList: true, subtree: true });
+    });
+};
+/**
+ * Waits for an element matching `selector` to be removed from the DOM.
+ * Resolves immediately if no matching element exists.
+ */
+export const waitForSelectorRemoval = (selector, opts) => {
+    const timeout = opts?.timeout ?? 10_000;
+    return new Promise((resolve, reject) => {
+        if (!document.querySelector(selector)) {
+            resolve();
+            return;
+        }
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            observer.disconnect();
+            reject(new Error(`waitForSelectorRemoval: timed out after ${timeout}ms waiting for "${selector}" to be removed`));
+        }, timeout);
+        const observer = new MutationObserver(() => {
+            if (!document.querySelector(selector)) {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                observer.disconnect();
+                resolve();
+            }
+        });
+        observer.observe(document.body, { childList: true, subtree: true });
+    });
+};
+/**
+ * Typed wrapper around `document.querySelectorAll` that returns a real array.
+ */
+export const querySelectorAll = (selector) => Array.from(document.querySelectorAll(selector));
+/**
+ * Returns the trimmed `textContent` of the first element matching `selector`,
+ * or `null` if no element is found.
+ */
+export const getTextContent = (selector) => {
+    const el = document.querySelector(selector);
+    if (!el)
+        return null;
+    return el.textContent.trim();
+};
+/**
+ * Sets up a MutationObserver on the element matching `selector`.
+ * Returns a cleanup function that disconnects the observer.
+ */
+export const observeDOM = (selector, callback, options) => {
+    const target = document.querySelector(selector);
+    if (!target) {
+        throw new Error(`observeDOM: no element found for selector "${selector}"`);
+    }
+    const observer = new MutationObserver(callback);
+    observer.observe(target, {
+        childList: options?.childList ?? true,
+        attributes: options?.attributes ?? false,
+        subtree: options?.subtree ?? true,
+    });
+    return () => observer.disconnect();
+};
+//# sourceMappingURL=dom.js.map

package/dist/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Typed error for tool handlers — the platform catches these
+ * and returns structured MCP error responses.
+ */
+export declare class ToolError extends Error {
+    /** Machine-readable error code (e.g., 'CHANNEL_NOT_FOUND') */
+    readonly code: string;
+    constructor(message: string, 
+    /** Machine-readable error code (e.g., 'CHANNEL_NOT_FOUND') */
+    code: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAGhC,8DAA8D;aAC9C,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM;IACf,8DAA8D;IAC9C,IAAI,EAAE,MAAM;CAK/B"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+// ---------------------------------------------------------------------------
+// Shared error types for the SDK
+// ---------------------------------------------------------------------------
+/**
+ * Typed error for tool handlers — the platform catches these
+ * and returns structured MCP error responses.
+ */
+export class ToolError extends Error {
+    code;
+    constructor(message, 
+    /** Machine-readable error code (e.g., 'CHANNEL_NOT_FOUND') */
+    code) {
+        super(message);
+        this.code = code;
+        this.name = 'ToolError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAIhB;IAHlB,YACE,OAAe;IACf,8DAA8D;IAC9C,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/fetch.d.ts

@@ -0,0 +1,21 @@
+export interface FetchFromPageOptions extends RequestInit {
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Fetches a URL using the page's authenticated session (credentials: 'include').
+ * Provides built-in timeout via AbortSignal and throws a descriptive ToolError
+ * on non-ok HTTP status codes.
+ */
+export declare const fetchFromPage: (url: string, init?: FetchFromPageOptions) => Promise<Response>;
+/**
+ * Fetches a URL and parses the response as JSON. Uses the page's session
+ * cookies (credentials: 'include') and provides timeout + error handling.
+ */
+export declare const fetchJSON: <T>(url: string, init?: FetchFromPageOptions) => Promise<T>;
+/**
+ * Convenience wrapper for POST requests with a JSON body. Sets Content-Type,
+ * stringifies the body, and parses the JSON response.
+ */
+export declare const postJSON: <T>(url: string, body: unknown, init?: FetchFromPageOptions) => Promise<T>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,KAAK,MAAM,EAAE,OAAO,oBAAoB,KAAG,OAAO,CAAC,QAAQ,CAgC9F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAU,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,oBAAoB,KAAG,OAAO,CAAC,CAAC,CAQtF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAU,CAAC,EAAE,KAAK,MAAM,EAAE,MAAM,OAAO,EAAE,OAAO,oBAAoB,KAAG,OAAO,CAAC,CAAC,CAQpG,CAAC"}

package/dist/fetch.js

@@ -0,0 +1,63 @@
+// ---------------------------------------------------------------------------
+// Fetch utilities for plugin authors
+// ---------------------------------------------------------------------------
+import { ToolError } from './errors.js';
+/**
+ * Fetches a URL using the page's authenticated session (credentials: 'include').
+ * Provides built-in timeout via AbortSignal and throws a descriptive ToolError
+ * on non-ok HTTP status codes.
+ */
+export const fetchFromPage = async (url, init) => {
+    const { timeout = 30_000, signal, ...rest } = init ?? {};
+    const timeoutSignal = AbortSignal.timeout(timeout);
+    const combinedSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+    let response;
+    try {
+        response = await fetch(url, {
+            credentials: 'include',
+            ...rest,
+            signal: combinedSignal,
+        });
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === 'TimeoutError') {
+            throw new ToolError(`fetchFromPage: request timed out after ${timeout}ms for ${url}`, 'timeout');
+        }
+        if (error instanceof DOMException && error.name === 'AbortError') {
+            throw new ToolError(`fetchFromPage: request aborted for ${url}`, 'aborted');
+        }
+        throw new ToolError(`fetchFromPage: network error for ${url}: ${error instanceof Error ? error.message : String(error)}`, 'network_error');
+    }
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => response.statusText);
+        throw new ToolError(`fetchFromPage: HTTP ${response.status} for ${url}: ${errorText}`, 'http_error');
+    }
+    return response;
+};
+/**
+ * Fetches a URL and parses the response as JSON. Uses the page's session
+ * cookies (credentials: 'include') and provides timeout + error handling.
+ */
+export const fetchJSON = async (url, init) => {
+    const response = await fetchFromPage(url, init);
+    try {
+        return (await response.json());
+    }
+    catch {
+        throw new ToolError(`fetchJSON: failed to parse JSON response from ${url}`, 'json_parse_error');
+    }
+};
+/**
+ * Convenience wrapper for POST requests with a JSON body. Sets Content-Type,
+ * stringifies the body, and parses the JSON response.
+ */
+export const postJSON = async (url, body, init) => {
+    const extraHeaders = init?.headers ? Object.fromEntries(new Headers(init.headers).entries()) : {};
+    return fetchJSON(url, {
+        ...init,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...extraHeaders },
+        body: JSON.stringify(body),
+    });
+};
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -63,15 +63,13 @@ export declare abstract class OpenTabsPlugin {
      */
     teardown?(): void;
 }
-/**
- * Typed error for tool handlers — the platform catches these
- * and returns structured MCP error responses.
- */
-export declare class ToolError extends Error {
-    /** Machine-readable error code (e.g., 'CHANNEL_NOT_FOUND') */
-    readonly code: string;
-    constructor(message: string, 
-    /** Machine-readable error code (e.g., 'CHANNEL_NOT_FOUND') */
-    code: string);
-}
+export { ToolError } from './errors.js';
+export { waitForSelector, waitForSelectorRemoval, querySelectorAll, getTextContent, observeDOM } from './dom.js';
+export type { WaitForSelectorOptions, ObserveDOMOptions } from './dom.js';
+export { fetchFromPage, fetchJSON, postJSON } from './fetch.js';
+export type { FetchFromPageOptions } from './fetch.js';
+export { retry, sleep, waitUntil } from './timing.js';
+export type { RetryOptions, WaitUntilOptions } from './timing.js';
+export { getLocalStorage, setLocalStorage, getSessionStorage, getCookie } from './storage.js';
+export { getPageGlobal, getCurrentUrl, getPageTitle } from './page-state.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1G,YAAY,EAAE,YAAY,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EACtE,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAErC,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,IAAI,EAAE,cAAc,CAAC;IACrB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,2GAA2G;IAC3G,MAAM,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;CAC5D;AAED,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,SAAS,CAAC,CAAC,OAAO,EAC7F,QAAQ,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,KACtC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAW,CAAC;AAE7C;;;GAGG;AACH,8BAAsB,cAAc;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAClC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAC1C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,IAAI;CAClB;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAGhC,8DAA8D;aAC9C,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM;IACf,8DAA8D;IAC9C,IAAI,EAAE,MAAM;CAK/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -11,18 +11,28 @@ export const defineTool = (config) => config;
  */
 export class OpenTabsPlugin {
 }
-/**
- * Typed error for tool handlers — the platform catches these
- * and returns structured MCP error responses.
- */
-export class ToolError extends Error {
-    code;
-    constructor(message, 
-    /** Machine-readable error code (e.g., 'CHANNEL_NOT_FOUND') */
-    code) {
-        super(message);
-        this.code = code;
-        this.name = 'ToolError';
-    }
-}
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export { ToolError } from './errors.js';
+// ---------------------------------------------------------------------------
+// SDK utilities — DOM
+// ---------------------------------------------------------------------------
+export { waitForSelector, waitForSelectorRemoval, querySelectorAll, getTextContent, observeDOM } from './dom.js';
+// ---------------------------------------------------------------------------
+// SDK utilities — Fetch
+// ---------------------------------------------------------------------------
+export { fetchFromPage, fetchJSON, postJSON } from './fetch.js';
+// ---------------------------------------------------------------------------
+// SDK utilities — Timing
+// ---------------------------------------------------------------------------
+export { retry, sleep, waitUntil } from './timing.js';
+// ---------------------------------------------------------------------------
+// SDK utilities — Storage
+// ---------------------------------------------------------------------------
+export { getLocalStorage, setLocalStorage, getSessionStorage, getCookie } from './storage.js';
+// ---------------------------------------------------------------------------
+// SDK utilities — Page State
+// ---------------------------------------------------------------------------
+export { getPageGlobal, getCurrentUrl, getPageTitle } from './page-state.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA0B3D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAuC,EACN,EAAE,CAAC,MAAM,CAAC;AAE7C;;;GAGG;AACH,MAAM,OAAgB,cAAc;CAoCnC;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAIhB;IAHlB,YACE,OAAe;IACf,8DAA8D;IAC9C,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA0B3D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAuC,EACN,EAAE,CAAC,MAAM,CAAC;AAE7C;;;GAGG;AACH,MAAM,OAAgB,cAAc;CAoCnC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGjH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGhE,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGtD,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9F,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/page-state.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Safe deep property access on `globalThis` using dot-notation path.
+ * Returns `undefined` if any segment in the path is missing or if a getter
+ * throws. Callers can narrow the result with `as` at the call site.
+ *
+ * @example
+ * const token = getPageGlobal('TS.boot_data.api_token') as string | undefined;
+ */
+export declare const getPageGlobal: (path: string) => unknown;
+/**
+ * Returns the current page URL (`window.location.href`).
+ */
+export declare const getCurrentUrl: () => string;
+/**
+ * Returns the current page title (`document.title`).
+ */
+export declare const getPageTitle: () => string;
+//# sourceMappingURL=page-state.d.ts.map

package/dist/page-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-state.d.ts","sourceRoot":"","sources":["../src/page-state.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OAY5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,MAA8B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,MAAwB,CAAC"}

package/dist/page-state.js

@@ -0,0 +1,35 @@
+// ---------------------------------------------------------------------------
+// Page state utilities for plugin authors
+// ---------------------------------------------------------------------------
+/**
+ * Safe deep property access on `globalThis` using dot-notation path.
+ * Returns `undefined` if any segment in the path is missing or if a getter
+ * throws. Callers can narrow the result with `as` at the call site.
+ *
+ * @example
+ * const token = getPageGlobal('TS.boot_data.api_token') as string | undefined;
+ */
+export const getPageGlobal = (path) => {
+    try {
+        const segments = path.split('.');
+        let current = globalThis;
+        for (const segment of segments) {
+            if (current === null || current === undefined || typeof current !== 'object')
+                return undefined;
+            current = current[segment];
+        }
+        return current;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Returns the current page URL (`window.location.href`).
+ */
+export const getCurrentUrl = () => window.location.href;
+/**
+ * Returns the current page title (`document.title`).
+ */
+export const getPageTitle = () => document.title;
+//# sourceMappingURL=page-state.js.map

package/dist/page-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-state.js","sourceRoot":"","sources":["../src/page-state.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,GAAY,UAAU,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC/F,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Reads a value from localStorage. Returns null if the key is not found or
+ * if storage access throws (e.g., SecurityError in sandboxed iframes).
+ */
+export declare const getLocalStorage: (key: string) => string | null;
+/**
+ * Writes a value to localStorage. Silently fails if storage access throws
+ * (e.g., SecurityError in sandboxed iframes or when storage is full).
+ */
+export declare const setLocalStorage: (key: string, value: string) => void;
+/**
+ * Reads a value from sessionStorage. Returns null if the key is not found or
+ * if storage access throws (e.g., SecurityError in sandboxed iframes).
+ */
+export declare const getSessionStorage: (key: string) => string | null;
+/**
+ * Reads a cookie by name from `document.cookie`. Handles URI-encoded values.
+ * Returns null if the cookie is not found.
+ */
+export declare const getCookie: (name: string) => string | null;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAMtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAM5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAMxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAajD,CAAC"}

package/dist/storage.js

@@ -0,0 +1,59 @@
+// ---------------------------------------------------------------------------
+// Storage utilities for plugin authors
+// ---------------------------------------------------------------------------
+/**
+ * Reads a value from localStorage. Returns null if the key is not found or
+ * if storage access throws (e.g., SecurityError in sandboxed iframes).
+ */
+export const getLocalStorage = (key) => {
+    try {
+        return localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Writes a value to localStorage. Silently fails if storage access throws
+ * (e.g., SecurityError in sandboxed iframes or when storage is full).
+ */
+export const setLocalStorage = (key, value) => {
+    try {
+        localStorage.setItem(key, value);
+    }
+    catch {
+        // Silently fail on SecurityError or QuotaExceededError
+    }
+};
+/**
+ * Reads a value from sessionStorage. Returns null if the key is not found or
+ * if storage access throws (e.g., SecurityError in sandboxed iframes).
+ */
+export const getSessionStorage = (key) => {
+    try {
+        return sessionStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Reads a cookie by name from `document.cookie`. Handles URI-encoded values.
+ * Returns null if the cookie is not found.
+ */
+export const getCookie = (name) => {
+    const prefix = `${name}=`;
+    const entries = document.cookie.split('; ');
+    for (const entry of entries) {
+        if (entry.startsWith(prefix)) {
+            try {
+                return decodeURIComponent(entry.slice(prefix.length));
+            }
+            catch {
+                return entry.slice(prefix.length);
+            }
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAiB,EAAE;IAC5D,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IAClE,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAiB,EAAE;IAC9D,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAiB,EAAE;IACvD,MAAM,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/timing.d.ts

@@ -0,0 +1,32 @@
+export interface RetryOptions {
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Delay between attempts in milliseconds (default: 1000) */
+    delay?: number;
+    /** Use exponential backoff — doubles the delay after each attempt (default: false) */
+    backoff?: boolean;
+    /** AbortSignal to cancel retries early */
+    signal?: AbortSignal;
+}
+export interface WaitUntilOptions {
+    /** Polling interval in milliseconds (default: 200) */
+    interval?: number;
+    /** Timeout in milliseconds (default: 10000) */
+    timeout?: number;
+}
+/**
+ * Retries `fn` on failure up to `maxAttempts` times. Waits `delay` ms between
+ * attempts (doubled each time when `backoff` is true). Re-throws the last
+ * error after all attempts are exhausted. Supports cancellation via AbortSignal.
+ */
+export declare const retry: <T>(fn: () => Promise<T>, opts?: RetryOptions) => Promise<T>;
+/**
+ * Returns a promise that resolves after `ms` milliseconds.
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * Polls `predicate` at `interval` ms until it returns `true`, or rejects on
+ * timeout with a descriptive error.
+ */
+export declare const waitUntil: (predicate: () => boolean | Promise<boolean>, opts?: WaitUntilOptions) => Promise<void>;
+//# sourceMappingURL=timing.d.ts.map

package/dist/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../src/timing.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAU,CAAC,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,CAAC,CA6BnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAAoD,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAqC5G,CAAC"}

package/dist/timing.js

@@ -0,0 +1,78 @@
+// ---------------------------------------------------------------------------
+// Retry / timing utilities for plugin authors
+// ---------------------------------------------------------------------------
+/**
+ * Retries `fn` on failure up to `maxAttempts` times. Waits `delay` ms between
+ * attempts (doubled each time when `backoff` is true). Re-throws the last
+ * error after all attempts are exhausted. Supports cancellation via AbortSignal.
+ */
+export const retry = async (fn, opts) => {
+    const maxAttempts = opts?.maxAttempts ?? 3;
+    const baseDelay = opts?.delay ?? 1_000;
+    const backoff = opts?.backoff ?? false;
+    const signal = opts?.signal;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        if (signal?.aborted) {
+            throw signal.reason instanceof Error ? signal.reason : new Error('retry: aborted');
+        }
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+        }
+        if (attempt < maxAttempts) {
+            if (signal?.aborted) {
+                throw signal.reason instanceof Error ? signal.reason : new Error('retry: aborted');
+            }
+            const currentDelay = backoff ? baseDelay * 2 ** (attempt - 1) : baseDelay;
+            await sleep(currentDelay);
+        }
+    }
+    throw lastError;
+};
+/**
+ * Returns a promise that resolves after `ms` milliseconds.
+ */
+export const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+/**
+ * Polls `predicate` at `interval` ms until it returns `true`, or rejects on
+ * timeout with a descriptive error.
+ */
+export const waitUntil = (predicate, opts) => {
+    const interval = opts?.interval ?? 200;
+    const timeout = opts?.timeout ?? 10_000;
+    return new Promise((resolve, reject) => {
+        const state = { settled: false };
+        const cleanup = () => {
+            state.settled = true;
+            clearTimeout(timer);
+            clearInterval(poller);
+        };
+        const timer = setTimeout(() => {
+            if (state.settled)
+                return;
+            cleanup();
+            reject(new Error(`waitUntil: timed out after ${timeout}ms waiting for predicate to return true`));
+        }, timeout);
+        const check = async () => {
+            if (state.settled)
+                return;
+            try {
+                const result = await predicate();
+                if (result) {
+                    cleanup();
+                    resolve();
+                }
+            }
+            catch {
+                // Predicate threw — keep polling until timeout
+            }
+        };
+        const poller = setInterval(() => void check(), interval);
+        // Check immediately on first call
+        void check();
+    });
+};
+//# sourceMappingURL=timing.js.map

package/dist/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../src/timing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentabs-dev/plugin-sdk",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "type": "module",
   "exports": {
     ".": {
@@ -20,13 +20,14 @@
     "generate:icons": "bun scripts/generate-icon-names.ts"
   },
   "dependencies": {
-    "@opentabs-dev/shared": "^0.0.10"
+    "@opentabs-dev/shared": "^0.0.11"
   },
   "peerDependencies": {
     "zod": "^4.0.0"
   },
   "devDependencies": {
     "bun-types": "^1.3.9",
+    "happy-dom": "^20.7.0",
     "lucide-react": "^0.574.0"
   }
 }