nothing-browser 0.1.1 → 0.1.3

package/dist/piggy.js

@@ -7279,6 +7279,24 @@ class PiggyClient {
         }
       }
     }
+    if (event.event === "dialog") {
+      const key = `dialog:${event.tabId ?? "default"}`;
+      const handlers = this.globalEventHandlers.get(key);
+      if (handlers) {
+        for (const h of handlers) {
+          try {
+            h({
+              dialogType: event.dialogType,
+              message: event.message,
+              defaultValue: event.defaultValue,
+              tabId: event.tabId
+            });
+          } catch (e) {
+            logger_default.error(`dialog handler error: ${e}`);
+          }
+        }
+      }
+    }
   }
   onEvent(eventName, tabId, handler) {
     const key = `${eventName}:${tabId}`;
@@ -7426,14 +7444,14 @@ class PiggyClient {
   async setCookie(name, value, domain, path = "/", tabId = "default") {
     await this.send("cookie.set", { name, value, domain, path, tabId });
   }
-  async getCookie(name, tabId = "default") {
-    return this.send("cookie.get", { name, tabId });
+  async getCookie(name, domain = "", tabId = "default") {
+    return this.send("cookie.get", { name, domain, tabId });
   }
-  async deleteCookie(name, tabId = "default") {
-    await this.send("cookie.delete", { name, tabId });
+  async deleteCookie(name, domain, tabId = "default") {
+    await this.send("cookie.delete", { name, domain, tabId });
   }
-  async listCookies(tabId = "default") {
-    return this.send("cookie.list", { tabId });
+  async listCookies(domain = "", tabId = "default") {
+    return this.send("cookie.list", { domain, tabId });
   }
   async addInterceptRule(action, pattern, options = {}, tabId = "default") {
     await this.send("intercept.rule.add", { action, pattern, ...options, tabId });
@@ -27293,7 +27311,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -28617,142 +28635,479 @@ async function storeRecord(storeName, data) {
   return { stored, skipped };
 }
 
-// piggy/register/index.ts
-var globalClient = null;
-var humanMode = false;
-function setClient(c) {
-  globalClient = c;
+// piggy/find/index.ts
+class FindClient {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  css(selector, tabId = "default") {
+    return this.client.send("find.css", { selector, tabId });
+  }
+  all(selector, tabId = "default") {
+    return this.client.send("find.all", { selector, tabId });
+  }
+  first(selector, tabId = "default") {
+    return this.client.send("find.first", { selector, tabId });
+  }
+  byText(text, tabId = "default") {
+    return this.client.send("find.byText", { text, tabId });
+  }
+  byAttr(attr, value, tabId = "default") {
+    return this.client.send("find.byAttr", { attr, value, tabId });
+  }
+  byTag(tag, tabId = "default") {
+    return this.client.send("find.byTag", { tag, tabId });
+  }
+  byPlaceholder(text, tabId = "default") {
+    return this.client.send("find.byPlaceholder", { text, tabId });
+  }
+  byRole(role, name, tabId = "default") {
+    return this.client.send("find.byRole", { role, name, tabId });
+  }
+  children(selector, tabId = "default") {
+    return this.client.send("find.children", { selector, tabId });
+  }
+  parent(selector, tabId = "default") {
+    return this.client.send("find.parent", { selector, tabId });
+  }
+  closest(selector, ancestor, tabId = "default") {
+    return this.client.send("find.closest", { selector, ancestor, tabId });
+  }
+  count(selector, tabId = "default") {
+    return this.client.send("find.count", { selector, tabId });
+  }
+  exists(selector, tabId = "default") {
+    return this.client.send("find.exists", { selector, tabId });
+  }
+  visible(selector, tabId = "default") {
+    return this.client.send("find.visible", { selector, tabId });
+  }
+  enabled(selector, tabId = "default") {
+    return this.client.send("find.enabled", { selector, tabId });
+  }
+  checked(selector, tabId = "default") {
+    return this.client.send("find.checked", { selector, tabId });
+  }
 }
-function setHumanMode(v) {
-  humanMode = v;
+function createFindAPI(client) {
+  return new FindClient(client);
 }
-async function retry(label, fn, retries = 2, backoff = 150) {
-  let last;
-  for (let i = 0;i <= retries; i++) {
-    try {
-      return await fn();
-    } catch (e) {
-      last = e;
-      if (i < retries) {
-        logger_default.warn(`[${label}] retry ${i + 1}/${retries}: ${e.message}`);
-        await new Promise((r) => setTimeout(r, backoff * (i + 1)));
-      }
-    }
+
+// piggy/provide/index.ts
+class ProvideClient {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  text(opts, tabId = "default") {
+    return this.client.send("provide.text", { ...opts, tabId });
+  }
+  textAll(opts, tabId = "default") {
+    return this.client.send("provide.textAll", { ...opts, tabId });
+  }
+  attr(opts, tabId = "default") {
+    return this.client.send("provide.attr", { ...opts, tabId });
+  }
+  attrAll(opts, tabId = "default") {
+    return this.client.send("provide.attrAll", { ...opts, tabId });
+  }
+  html(opts, tabId = "default") {
+    return this.client.send("provide.html", { ...opts, tabId });
+  }
+  table(opts, tabId = "default") {
+    return this.client.send("provide.table", { ...opts, tabId });
+  }
+  list(opts, tabId = "default") {
+    return this.client.send("provide.list", { ...opts, tabId });
+  }
+  links(opts, tabId = "default") {
+    return this.client.send("provide.links", { ...opts, tabId });
+  }
+  images(opts, tabId = "default") {
+    return this.client.send("provide.images", { ...opts, tabId });
+  }
+  form(opts, tabId = "default") {
+    return this.client.send("provide.form", { ...opts, tabId });
+  }
+  page(tabId = "default") {
+    return this.client.send("provide.page", { tabId });
+  }
+  div(opts, tabId = "default") {
+    return this.client.send("provide.div", { ...opts, tabId });
+  }
+  meta(tabId = "default") {
+    return this.client.send("provide.meta", { tabId });
+  }
+  select(opts, tabId = "default") {
+    return this.client.send("provide.select", { ...opts, tabId });
+  }
+  json(opts, tabId = "default") {
+    return this.client.send("provide.json", { ...opts, tabId });
   }
-  throw last;
 }
-function createSiteObject(name, registeredUrl, client, tabId, pool) {
-  let _currentUrl = registeredUrl;
-  let _modifyRuleCounter = 0;
-  function withTab(fn) {
-    return pool ? pool.withTab(fn) : fn(tabId);
+function createProvideAPI(client) {
+  return new ProvideClient(client);
+}
+
+// piggy/session/index.ts
+class SessionClient {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  const _eventListeners = new Map;
-  const _unsubNavigate = client.onEvent("navigate", tabId, (url2) => {
-    _currentUrl = url2;
-    const handlers = _eventListeners.get("navigate");
-    if (handlers) {
-      for (const h of handlers) {
-        try {
-          h(url2);
-        } catch (e) {
-          logger_default.error(`[${name}] navigate handler error: ${e}`);
-        }
-      }
-    }
-  });
-  const withErrScreen = async (fn, label) => {
-    try {
-      return await fn();
-    } catch (err) {
-      const p = `./error-${name}-${Date.now()}.png`;
-      try {
-        await client.screenshot(p, tabId);
-        logger_default.error(`[${name}] ${label} failed → ${p}`);
-      } catch {
-        logger_default.error(`[${name}] ${label} failed (no screenshot)`);
-      }
-      throw err;
-    }
-  };
-  const site = {
-    _name: name,
-    _tabId: tabId,
-    _pool: pool ?? null,
-    poolStats: () => pool?.stats ?? null,
-    navigate: (url2, opts) => {
-      const target = url2 ?? registeredUrl;
-      return withTab((t2) => retry(name, async () => {
-        logger_default.network(`[${name}] navigating → ${target}`);
-        await client.navigate(target, t2);
-        _currentUrl = target;
-      }, opts?.retries ?? 2));
-    },
-    reload: () => withTab((t2) => client.reload(t2)),
-    goBack: () => withTab((t2) => client.goBack(t2)),
-    goForward: () => withTab((t2) => client.goForward(t2)),
-    waitForNavigation: () => withTab((t2) => client.waitForNavigation(t2)),
-    title: () => withTab(async (t2) => {
-      const title = await client.getTitle(t2);
-      logger_default.info(`[${name}] title: ${title}`);
-      return title;
-    }),
-    url: () => _currentUrl,
-    content: () => withTab((t2) => client.content(t2)),
-    wait: (ms) => {
-      const actual = humanMode ? ms + Math.floor(Math.random() * 600) - 300 : ms;
-      return new Promise((r) => setTimeout(r, Math.max(0, actual)));
-    },
-    waitForSelector: (selector, timeout = 30000) => withTab((t2) => {
-      logger_default.debug(`[${name}] waitForSelector: ${selector}`);
-      return client.waitForSelector(selector, timeout, t2);
-    }),
-    waitForVisible: (selector, timeout = 30000) => withTab((t2) => client.waitForSelector(selector, timeout, t2)),
-    waitForResponse: (pattern, timeout = 30000) => withTab((t2) => client.waitForResponse(pattern, timeout, t2)),
-    addInitScript: async (js) => {
-      const code = typeof js === "function" ? `(${js.toString()})();` : js;
-      await withTab((t2) => client.addInitScript(code, t2));
-      logger_default.success(`[${name}] init script added`);
-      return site;
-    },
-    on: (event, handler) => {
-      if (!_eventListeners.has(event))
-        _eventListeners.set(event, new Set);
-      _eventListeners.get(event).add(handler);
-      logger_default.debug(`[${name}] on('${event}') registered`);
-      return () => {
-        _eventListeners.get(event)?.delete(handler);
-        logger_default.debug(`[${name}] on('${event}') unsubscribed`);
-      };
-    },
-    off: (event, handler) => {
-      _eventListeners.get(event)?.delete(handler);
-    },
-    click: (selector, opts) => withErrScreen(() => withTab((t2) => retry(name, async () => {
-      if (humanMode)
-        await new Promise((r) => setTimeout(r, 80 + Math.random() * 140));
-      await client.waitForSelector(selector, opts?.timeout ?? 15000, t2);
-      const ok = await client.click(selector, t2);
-      if (!ok)
-        throw new Error(`click failed: ${selector}`);
-      logger_default.success(`[${name}] clicked: ${selector}`);
-      return ok;
-    }, opts?.retries ?? 2)), `click(${selector})`),
-    doubleClick: (selector) => withErrScreen(() => withTab(async (t2) => {
-      if (humanMode)
-        await new Promise((r) => setTimeout(r, 80 + Math.random() * 120));
-      return client.doubleClick(selector, t2);
-    }), `dblclick(${selector})`),
-    hover: (selector) => withErrScreen(() => withTab(async (t2) => {
-      if (humanMode)
-        await new Promise((r) => setTimeout(r, 50 + Math.random() * 100));
-      return client.hover(selector, t2);
-    }), `hover(${selector})`),
-    type: (selector, text, opts) => withErrScreen(() => withTab(async (t2) => {
-      await client.waitForSelector(selector, 30000, t2);
-      if (humanMode) {
-        const human = new HumanClient(client);
-        await human.type({
+  reload(tabId = "default") {
+    return this.client.send("session.reload", { tabId });
+  }
+  paths() {
+    return this.client.send("session.paths", {});
+  }
+  cookiesPath() {
+    return this.client.send("session.cookies.path", {});
+  }
+  profilePath() {
+    return this.client.send("session.profile.path", {});
+  }
+  wsPath() {
+    return this.client.send("session.ws.path", {});
+  }
+  pingsPath() {
+    return this.client.send("session.pings.path", {});
+  }
+  setWsSave(enabled) {
+    return this.client.send("session.ws.save", { enabled });
+  }
+  setPingsSave(enabled) {
+    return this.client.send("session.pings.save", { enabled });
+  }
+  async export(tabId = "default") {
+    const raw = await this.client.send("session.export", { tabId });
+    return typeof raw === "string" ? JSON.parse(raw) : raw;
+  }
+  import(data, tabId = "default") {
+    return this.client.send("session.import", {
+      data: JSON.stringify(data),
+      tabId
+    });
+  }
+  setCookie(opts, tabId = "default") {
+    return this.client.send("cookie.set", { ...opts, tabId });
+  }
+  deleteCookie(opts, tabId = "default") {
+    return this.client.send("cookie.delete", { ...opts, tabId });
+  }
+}
+function createSessionAPI(client) {
+  return new SessionClient(client);
+}
+
+// piggy/dialog/index.ts
+class DialogClient {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  accept(tabId = "default", text) {
+    return this.client.send("dialog.accept", { tabId, ...text !== undefined ? { text } : {} });
+  }
+  dismiss(tabId = "default") {
+    return this.client.send("dialog.dismiss", { tabId });
+  }
+  status(tabId = "default") {
+    return this.client.send("dialog.status", { tabId });
+  }
+  setAutoAction(tabId = "default", action) {
+    return this.client.send("dialog.onDialog", { tabId, action });
+  }
+  upload(selector, filePath, tabId = "default") {
+    return this.client.send("upload", { selector, path: filePath, tabId });
+  }
+  onDialog(tabId, handler) {
+    return this.client.onEvent("dialog", tabId, handler);
+  }
+  waitAndAccept(tabId = "default", text, timeoutMs = 30000) {
+    return new Promise((resolve2, reject) => {
+      const timer = setTimeout(() => {
+        unsub();
+        reject(new Error(`dialog.waitAndAccept: timed out after ${timeoutMs}ms`));
+      }, timeoutMs);
+      const unsub = this.onDialog(tabId, async (data) => {
+        clearTimeout(timer);
+        unsub();
+        await this.accept(tabId, text);
+        resolve2(data);
+      });
+    });
+  }
+  waitAndDismiss(tabId = "default", timeoutMs = 30000) {
+    return new Promise((resolve2, reject) => {
+      const timer = setTimeout(() => {
+        unsub();
+        reject(new Error(`dialog.waitAndDismiss: timed out after ${timeoutMs}ms`));
+      }, timeoutMs);
+      const unsub = this.onDialog(tabId, async (data) => {
+        clearTimeout(timer);
+        unsub();
+        await this.dismiss(tabId);
+        resolve2(data);
+      });
+    });
+  }
+}
+function createDialogAPI(client) {
+  return new DialogClient(client);
+}
+
+// piggy/iframe/index.ts
+class IframeClient {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  list(tabId = "default") {
+    return this.client.send("iframe.list", { tabId });
+  }
+  evaluate(opts, tabId = "default") {
+    return this.client.send("iframe.evaluate", { ...opts, tabId });
+  }
+  click(opts, tabId = "default") {
+    return this.client.send("iframe.click", { ...opts, tabId });
+  }
+  type(opts, tabId = "default") {
+    return this.client.send("iframe.type", { ...opts, tabId });
+  }
+  text(opts, tabId = "default") {
+    return this.client.send("iframe.text", { ...opts, tabId });
+  }
+  html(opts, tabId = "default") {
+    return this.client.send("iframe.html", { ...opts, tabId });
+  }
+  waitSel(opts, tabId = "default") {
+    return this.client.send("iframe.waitSel", { ...opts, tabId });
+  }
+}
+function createIframeAPI(client) {
+  return new IframeClient(client);
+}
+
+// piggy/expose/index.ts
+async function exposeFunction(client, fnName, handler, tabId) {
+  await client.exposeFunction(fnName, handler, tabId);
+  logger_default.success(`[${tabId}] exposed function: ${fnName}`);
+}
+async function unexposeFunction(client, fnName, tabId) {
+  await client.unexposeFunction(fnName, tabId);
+  logger_default.info(`[${tabId}] unexposed function: ${fnName}`);
+}
+async function clearExposedFunctions(client, tabId) {
+  await client.clearExposedFunctions(tabId);
+  logger_default.info(`[${tabId}] cleared all exposed functions`);
+}
+async function exposeAndInject(client, fnName, handler, injectionJs, tabId) {
+  await client.exposeFunction(fnName, handler, tabId);
+  const js = typeof injectionJs === "function" ? injectionJs(fnName) : injectionJs;
+  await client.evaluate(js, tabId);
+  logger_default.success(`[${tabId}] exposed and injected: ${fnName}`);
+}
+
+// piggy/captcha/index.ts
+class CaptchaClient {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  status(tabId = "default") {
+    return this.client.send("captcha.status", { tabId });
+  }
+  resolve(tabId = "default") {
+    return this.client.send("captcha.resolve", { tabId });
+  }
+  pause(tabId = "default") {
+    return this.client.send("captcha.pause", { tabId });
+  }
+  check(tabId = "default") {
+    return this.client.send("captcha.check", { tabId });
+  }
+  setAutoRetry(enabled) {
+    return this.client.send("captcha.autoRetry", { enabled });
+  }
+  blockStatus(tabId = "default") {
+    return this.client.send("block.status", { tabId });
+  }
+  blockRetry(tabId = "default") {
+    return this.client.send("block.retry", { tabId });
+  }
+  onCaptcha(tabId, handler) {
+    return this.client.onEvent("captcha", tabId, handler);
+  }
+  onCaptchaResolved(tabId, handler) {
+    return this.client.onEvent("captcha:resolved", tabId, handler);
+  }
+  onBlocked(tabId, handler) {
+    return this.client.onEvent("blocked", tabId, handler);
+  }
+  onBlockRetry(tabId, handler) {
+    return this.client.onEvent("block:retry", tabId, handler);
+  }
+  waitForResolution(tabId = "default", timeoutMs = 300000) {
+    return new Promise((resolve2, reject) => {
+      const timer = setTimeout(() => {
+        unsub();
+        reject(new Error(`captcha.waitForResolution: timed out after ${timeoutMs}ms`));
+      }, timeoutMs);
+      const unsub = this.onCaptchaResolved(tabId, () => {
+        clearTimeout(timer);
+        unsub();
+        resolve2();
+      });
+      logger_default.warn(`[captcha] waiting for manual resolution on tab ${tabId}…`);
+    });
+  }
+}
+function createCaptchaAPI(client) {
+  return new CaptchaClient(client);
+}
+
+// piggy/register/index.ts
+var globalClient = null;
+var humanMode = false;
+function setClient(c) {
+  globalClient = c;
+}
+function setHumanMode(v) {
+  humanMode = v;
+}
+async function retry(label, fn, retries = 2, backoff = 150) {
+  let last;
+  for (let i = 0;i <= retries; i++) {
+    try {
+      return await fn();
+    } catch (e) {
+      last = e;
+      if (i < retries) {
+        logger_default.warn(`[${label}] retry ${i + 1}/${retries}: ${e.message}`);
+        await new Promise((r) => setTimeout(r, backoff * (i + 1)));
+      }
+    }
+  }
+  throw last;
+}
+function createSiteObject(name, registeredUrl, client, tabId, pool) {
+  let _currentUrl = registeredUrl;
+  let _modifyRuleCounter = 0;
+  function withTab(fn) {
+    return pool ? pool.withTab(fn) : fn(tabId);
+  }
+  const _eventListeners = new Map;
+  const _unsubNavigate = client.onEvent("navigate", tabId, (url2) => {
+    _currentUrl = url2;
+    const handlers = _eventListeners.get("navigate");
+    if (handlers) {
+      for (const h of handlers) {
+        try {
+          h(url2);
+        } catch (e) {
+          logger_default.error(`[${name}] navigate handler error: ${e}`);
+        }
+      }
+    }
+  });
+  const withErrScreen = async (fn, label) => {
+    try {
+      return await fn();
+    } catch (err) {
+      const p = `./error-${name}-${Date.now()}.png`;
+      try {
+        await client.screenshot(p, tabId);
+        logger_default.error(`[${name}] ${label} failed → ${p}`);
+      } catch {
+        logger_default.error(`[${name}] ${label} failed (no screenshot)`);
+      }
+      throw err;
+    }
+  };
+  const site = {
+    _name: name,
+    _tabId: tabId,
+    _pool: pool ?? null,
+    poolStats: () => pool?.stats ?? null,
+    navigate: (url2, opts) => {
+      const target = url2 ?? registeredUrl;
+      return withTab((t2) => retry(name, async () => {
+        logger_default.network(`[${name}] navigating → ${target}`);
+        await client.navigate(target, t2);
+        _currentUrl = target;
+      }, opts?.retries ?? 2));
+    },
+    reload: () => withTab((t2) => client.reload(t2)),
+    goBack: () => withTab((t2) => client.goBack(t2)),
+    goForward: () => withTab((t2) => client.goForward(t2)),
+    waitForNavigation: () => withTab((t2) => client.waitForNavigation(t2)),
+    title: () => withTab(async (t2) => {
+      const title = await client.getTitle(t2);
+      logger_default.info(`[${name}] title: ${title}`);
+      return title;
+    }),
+    url: () => _currentUrl,
+    content: () => withTab((t2) => client.content(t2)),
+    wait: (ms) => {
+      const actual = humanMode ? ms + Math.floor(Math.random() * 600) - 300 : ms;
+      return new Promise((r) => setTimeout(r, Math.max(0, actual)));
+    },
+    waitForSelector: (selector, timeout = 30000) => withTab((t2) => {
+      logger_default.debug(`[${name}] waitForSelector: ${selector}`);
+      return client.waitForSelector(selector, timeout, t2);
+    }),
+    exposeFunction: (fnName, handler) => exposeFunction(client, fnName, handler, tabId).then(() => site),
+    unexposeFunction: (fnName) => unexposeFunction(client, fnName, tabId).then(() => site),
+    clearExposedFunctions: () => clearExposedFunctions(client, tabId).then(() => site),
+    exposeAndInject: (fnName, handler, injectionJs) => exposeAndInject(client, fnName, handler, injectionJs, tabId).then(() => site),
+    waitForVisible: (selector, timeout = 30000) => withTab((t2) => client.waitForSelector(selector, timeout, t2)),
+    waitForResponse: (pattern, timeout = 30000) => withTab((t2) => client.waitForResponse(pattern, timeout, t2)),
+    addInitScript: async (js) => {
+      const code = typeof js === "function" ? `(${js.toString()})();` : js;
+      await withTab((t2) => client.addInitScript(code, t2));
+      logger_default.success(`[${name}] init script added`);
+      return site;
+    },
+    on: (event, handler) => {
+      if (!_eventListeners.has(event))
+        _eventListeners.set(event, new Set);
+      _eventListeners.get(event).add(handler);
+      logger_default.debug(`[${name}] on('${event}') registered`);
+      return () => {
+        _eventListeners.get(event)?.delete(handler);
+        logger_default.debug(`[${name}] on('${event}') unsubscribed`);
+      };
+    },
+    off: (event, handler) => {
+      _eventListeners.get(event)?.delete(handler);
+    },
+    click: (selector, opts) => withErrScreen(() => withTab((t2) => retry(name, async () => {
+      if (humanMode)
+        await new Promise((r) => setTimeout(r, 80 + Math.random() * 140));
+      await client.waitForSelector(selector, opts?.timeout ?? 15000, t2);
+      const ok = await client.click(selector, t2);
+      if (!ok)
+        throw new Error(`click failed: ${selector}`);
+      logger_default.success(`[${name}] clicked: ${selector}`);
+      return ok;
+    }, opts?.retries ?? 2)), `click(${selector})`),
+    doubleClick: (selector) => withErrScreen(() => withTab(async (t2) => {
+      if (humanMode)
+        await new Promise((r) => setTimeout(r, 80 + Math.random() * 120));
+      return client.doubleClick(selector, t2);
+    }), `dblclick(${selector})`),
+    hover: (selector) => withErrScreen(() => withTab(async (t2) => {
+      if (humanMode)
+        await new Promise((r) => setTimeout(r, 50 + Math.random() * 100));
+      return client.hover(selector, t2);
+    }), `hover(${selector})`),
+    type: (selector, text, opts) => withErrScreen(() => withTab(async (t2) => {
+      await client.waitForSelector(selector, 30000, t2);
+      if (humanMode) {
+        const human = new HumanClient(client);
+        await human.type({
           selector,
           text,
           clear: opts?.clear ?? false,
@@ -28816,6 +29171,68 @@ function createSiteObject(name, registeredUrl, client, tabId, pool) {
       css: (query) => withTab((t2) => client.searchCss(query, t2)),
       id: (query) => withTab((t2) => client.searchId(query, t2))
     },
+    captcha: {
+      status: () => withTab((t2) => createCaptchaAPI(client).status(t2)),
+      resolve: () => withTab((t2) => createCaptchaAPI(client).resolve(t2)),
+      pause: () => withTab((t2) => createCaptchaAPI(client).pause(t2)),
+      check: () => withTab((t2) => createCaptchaAPI(client).check(t2)),
+      autoRetry: (opts) => withTab((t2) => createCaptchaAPI(client).setAutoRetry(opts.enabled)),
+      onCaptcha: (handler) => createCaptchaAPI(client).onCaptcha(tabId, handler),
+      onResolved: (handler) => createCaptchaAPI(client).onCaptchaResolved(tabId, handler)
+    },
+    block: {
+      status: () => withTab((t2) => createCaptchaAPI(client).blockStatus(t2)),
+      retry: () => withTab((t2) => createCaptchaAPI(client).blockRetry(t2)),
+      onBlocked: (handler) => createCaptchaAPI(client).onBlocked(tabId, handler),
+      onRetry: (handler) => createCaptchaAPI(client).onBlockRetry(tabId, handler)
+    },
+    find: {
+      css: (selector) => withTab((t2) => {
+        console.log("[DEBUG] find.css tabId:", t2);
+        return createFindAPI(client).css(selector, t2);
+      }),
+      all: (selector) => withTab((t2) => createFindAPI(client).all(selector, t2)),
+      first: (selector) => withTab((t2) => createFindAPI(client).first(selector, t2)),
+      byText: (text) => withTab((t2) => createFindAPI(client).byText(text, t2)),
+      byAttr: (attr, value) => withTab((t2) => createFindAPI(client).byAttr(attr, value, t2)),
+      byTag: (tag) => withTab((t2) => createFindAPI(client).byTag(tag, t2)),
+      byPlaceholder: (text) => withTab((t2) => createFindAPI(client).byPlaceholder(text, t2)),
+      byRole: (role, name2) => withTab((t2) => createFindAPI(client).byRole(role, name2, t2)),
+      children: (selector) => withTab((t2) => createFindAPI(client).children(selector, t2)),
+      parent: (selector) => withTab((t2) => createFindAPI(client).parent(selector, t2)),
+      closest: (selector, ancestor) => withTab((t2) => createFindAPI(client).closest(selector, ancestor, t2)),
+      count: (selector) => withTab((t2) => createFindAPI(client).count(selector, t2)),
+      exists: (selector) => withTab((t2) => createFindAPI(client).exists(selector, t2)),
+      visible: (selector) => withTab((t2) => createFindAPI(client).visible(selector, t2)),
+      enabled: (selector) => withTab((t2) => createFindAPI(client).enabled(selector, t2)),
+      checked: (selector) => withTab((t2) => createFindAPI(client).checked(selector, t2))
+    },
+    provide: {
+      text: (opts) => withTab((t2) => createProvideAPI(client).text(opts, t2)),
+      textAll: (opts) => withTab((t2) => createProvideAPI(client).textAll(opts, t2)),
+      attr: (opts) => withTab((t2) => createProvideAPI(client).attr(opts, t2)),
+      attrAll: (opts) => withTab((t2) => createProvideAPI(client).attrAll(opts, t2)),
+      html: (opts) => withTab((t2) => createProvideAPI(client).html(opts, t2)),
+      table: (opts) => withTab((t2) => createProvideAPI(client).table(opts, t2)),
+      list: (opts) => withTab((t2) => createProvideAPI(client).list(opts, t2)),
+      links: (opts) => withTab((t2) => createProvideAPI(client).links(opts, t2)),
+      images: (opts) => withTab((t2) => createProvideAPI(client).images(opts, t2)),
+      form: (opts) => withTab((t2) => createProvideAPI(client).form(opts, t2)),
+      page: () => withTab((t2) => createProvideAPI(client).page(t2)),
+      div: (opts) => withTab((t2) => createProvideAPI(client).div(opts, t2)),
+      meta: () => withTab((t2) => createProvideAPI(client).meta(t2)),
+      select: (opts) => withTab((t2) => createProvideAPI(client).select(opts, t2)),
+      json: (opts) => withTab((t2) => createProvideAPI(client).json(opts, t2))
+    },
+    iframe: {
+      list: () => withTab((t2) => createIframeAPI(client).list(t2)),
+      evaluate: (opts) => withTab((t2) => createIframeAPI(client).evaluate(opts, t2)),
+      click: (opts) => withTab((t2) => createIframeAPI(client).click(opts, t2)),
+      type: (opts) => withTab((t2) => createIframeAPI(client).type(opts, t2)),
+      text: (opts) => withTab((t2) => createIframeAPI(client).text(opts, t2)),
+      html: (opts) => withTab((t2) => createIframeAPI(client).html(opts, t2)),
+      waitSel: (opts) => withTab((t2) => createIframeAPI(client).waitSel(opts, t2))
+    },
     screenshot: async (filePath) => {
       const r = await withTab((t2) => client.screenshot(filePath, t2));
       logger_default.success(`[${name}] screenshot → ${filePath ?? "base64"}`);
@@ -28826,6 +29243,12 @@ function createSiteObject(name, registeredUrl, client, tabId, pool) {
       logger_default.success(`[${name}] pdf → ${filePath ?? "base64"}`);
       return r;
     },
+    human: {
+      set: (opts) => withTab((t2) => createHumanAPI(client).set(opts, t2)),
+      get: () => withTab((t2) => createHumanAPI(client).get(t2)),
+      type: (opts) => withTab((t2) => createHumanAPI(client).type(opts, t2)),
+      click: (opts) => withTab((t2) => createHumanAPI(client).click(opts, t2))
+    },
     blockImages: () => withTab(async (t2) => {
       await client.blockImages(t2);
       logger_default.info(`[${name}] images blocked`);
@@ -28839,12 +29262,13 @@ function createSiteObject(name, registeredUrl, client, tabId, pool) {
         await withTab((t2) => client.setCookie(cookieName, value, domain, path, t2));
         logger_default.info(`[${name}] cookie set: ${cookieName} @ ${domain}`);
       },
-      get: (cookieName) => withTab((t2) => client.getCookie(cookieName, t2)),
-      delete: async (cookieName) => {
-        await withTab((t2) => client.deleteCookie(cookieName, t2));
+      get: (cookieName, domain = "") => withTab((t2) => client.getCookie(cookieName, domain, t2)),
+      delete: async (cookieName, domain) => {
+        const d = domain ?? new URL(registeredUrl).hostname;
+        await withTab((t2) => client.deleteCookie(cookieName, d, t2));
         logger_default.info(`[${name}] cookie deleted: ${cookieName}`);
       },
-      list: () => withTab((t2) => client.listCookies(t2))
+      list: (domain = "") => withTab((t2) => client.listCookies(domain, t2))
     },
     intercept: {
       block: async (pattern) => {
@@ -28931,6 +29355,16 @@ function createSiteObject(name, registeredUrl, client, tabId, pool) {
         logger_default.info(`[${name}] intercept rules cleared`);
       }
     },
+    dialog: {
+      accept: (tabId2 = "default", text) => new DialogClient(client).accept(tabId2, text),
+      dismiss: (tabId2 = "default") => new DialogClient(client).dismiss(tabId2),
+      status: (tabId2 = "default") => new DialogClient(client).status(tabId2),
+      setAutoAction: (tabId2 = "default", action) => new DialogClient(client).setAutoAction(tabId2, action),
+      upload: (selector, filePath, tabId2 = "default") => new DialogClient(client).upload(selector, filePath, tabId2),
+      onDialog: (tabId2, handler) => new DialogClient(client).onDialog(tabId2, handler),
+      waitAndAccept: (tabId2 = "default", text, timeoutMs = 30000) => new DialogClient(client).waitAndAccept(tabId2, text, timeoutMs),
+      waitAndDismiss: (tabId2 = "default", timeoutMs = 30000) => new DialogClient(client).waitAndDismiss(tabId2, timeoutMs)
+    },
     capture: {
       start: () => withTab(async (t2) => {
         await client.captureStart(t2);
@@ -28950,37 +29384,14 @@ function createSiteObject(name, registeredUrl, client, tabId, pool) {
       })
     },
     session: {
-      export: async () => {
-        const data = await withTab((t2) => client.sessionExport(t2));
-        logger_default.success(`[${name}] session exported`);
-        return data;
-      },
-      import: async (data) => {
-        await withTab((t2) => client.sessionImport(data, t2));
-        logger_default.success(`[${name}] session imported`);
-      }
-    },
-    exposeFunction: async (fnName, handler) => {
-      await client.exposeFunction(fnName, handler, tabId);
-      logger_default.success(`[${name}] exposed function: ${fnName}`);
-      return site;
-    },
-    unexposeFunction: async (fnName) => {
-      await client.unexposeFunction(fnName, tabId);
-      logger_default.info(`[${name}] unexposed function: ${fnName}`);
-      return site;
-    },
-    clearExposedFunctions: async () => {
-      await client.clearExposedFunctions(tabId);
-      logger_default.info(`[${name}] cleared all exposed functions`);
-      return site;
-    },
-    exposeAndInject: async (fnName, handler, injectionJs) => {
-      await client.exposeFunction(fnName, handler, tabId);
-      const js = typeof injectionJs === "function" ? injectionJs(fnName) : injectionJs;
-      await withTab((t2) => client.evaluate(js, t2));
-      logger_default.success(`[${name}] exposed and injected: ${fnName}`);
-      return site;
+      export: () => withTab((t2) => createSessionAPI(client).export(t2)),
+      import: (data) => withTab((t2) => createSessionAPI(client).import(data, t2)),
+      reload: () => withTab((t2) => createSessionAPI(client).reload(t2)),
+      paths: () => createSessionAPI(client).paths(),
+      cookies: { path: () => createSessionAPI(client).cookiesPath() },
+      profile: { path: () => createSessionAPI(client).profilePath() },
+      ws: { save: (opts) => createSessionAPI(client).setWsSave(opts.enabled) },
+      pings: { save: (opts) => createSessionAPI(client).setPingsSave(opts.enabled) }
     },
     store: async (data, schemaName) => {
       const target = schemaName ?? name;
@@ -29108,139 +29519,24 @@ class CaptureClient {
   stop(tabId = "default") {
     return this.client.send("capture.stop", { tabId });
   }
-  requests(tabId = "default") {
-    return this.client.send("capture.requests", { tabId });
-  }
-  ws(tabId = "default") {
-    return this.client.send("capture.ws", { tabId });
-  }
-  cookies(tabId = "default") {
-    return this.client.send("capture.cookies", { tabId });
-  }
-  storage(tabId = "default") {
-    return this.client.send("capture.storage", { tabId });
-  }
-  clear(tabId = "default") {
-    return this.client.send("capture.clear", { tabId });
-  }
-}
-function createCaptureAPI(client) {
-  return new CaptureClient(client);
-}
-
-// piggy/captcha/index.ts
-class CaptchaClient {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  status(tabId = "default") {
-    return this.client.send("captcha.status", { tabId });
-  }
-  resolve(tabId = "default") {
-    return this.client.send("captcha.resolve", { tabId });
-  }
-  pause(tabId = "default") {
-    return this.client.send("captcha.pause", { tabId });
-  }
-  check(tabId = "default") {
-    return this.client.send("captcha.check", { tabId });
-  }
-  setAutoRetry(enabled) {
-    return this.client.send("captcha.autoRetry", { enabled });
-  }
-  blockStatus(tabId = "default") {
-    return this.client.send("block.status", { tabId });
-  }
-  blockRetry(tabId = "default") {
-    return this.client.send("block.retry", { tabId });
-  }
-  onCaptcha(tabId, handler) {
-    return this.client.onEvent("captcha", tabId, handler);
-  }
-  onCaptchaResolved(tabId, handler) {
-    return this.client.onEvent("captcha:resolved", tabId, handler);
-  }
-  onBlocked(tabId, handler) {
-    return this.client.onEvent("blocked", tabId, handler);
-  }
-  onBlockRetry(tabId, handler) {
-    return this.client.onEvent("block:retry", tabId, handler);
-  }
-  waitForResolution(tabId = "default", timeoutMs = 300000) {
-    return new Promise((resolve2, reject) => {
-      const timer = setTimeout(() => {
-        unsub();
-        reject(new Error(`captcha.waitForResolution: timed out after ${timeoutMs}ms`));
-      }, timeoutMs);
-      const unsub = this.onCaptchaResolved(tabId, () => {
-        clearTimeout(timer);
-        unsub();
-        resolve2();
-      });
-      logger_default.warn(`[captcha] waiting for manual resolution on tab ${tabId}…`);
-    });
-  }
-}
-function createCaptchaAPI(client) {
-  return new CaptchaClient(client);
-}
-
-// piggy/dialog/index.ts
-class DialogClient {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  accept(tabId = "default", text) {
-    return this.client.send("dialog.accept", { tabId, ...text !== undefined ? { text } : {} });
-  }
-  dismiss(tabId = "default") {
-    return this.client.send("dialog.dismiss", { tabId });
-  }
-  status(tabId = "default") {
-    return this.client.send("dialog.status", { tabId });
-  }
-  setAutoAction(tabId = "default", action) {
-    return this.client.send("dialog.onDialog", { tabId, action });
+  requests(tabId = "default") {
+    return this.client.send("capture.requests", { tabId });
   }
-  upload(selector, filePath, tabId = "default") {
-    return this.client.send("upload", { selector, path: filePath, tabId });
+  ws(tabId = "default") {
+    return this.client.send("capture.ws", { tabId });
   }
-  onDialog(tabId, handler) {
-    return this.client.onEvent("dialog", tabId, handler);
+  cookies(tabId = "default") {
+    return this.client.send("capture.cookies", { tabId });
   }
-  waitAndAccept(tabId = "default", text, timeoutMs = 30000) {
-    return new Promise((resolve2, reject) => {
-      const timer = setTimeout(() => {
-        unsub();
-        reject(new Error(`dialog.waitAndAccept: timed out after ${timeoutMs}ms`));
-      }, timeoutMs);
-      const unsub = this.onDialog(tabId, async (data) => {
-        clearTimeout(timer);
-        unsub();
-        await this.accept(tabId, text);
-        resolve2(data);
-      });
-    });
+  storage(tabId = "default") {
+    return this.client.send("capture.storage", { tabId });
   }
-  waitAndDismiss(tabId = "default", timeoutMs = 30000) {
-    return new Promise((resolve2, reject) => {
-      const timer = setTimeout(() => {
-        unsub();
-        reject(new Error(`dialog.waitAndDismiss: timed out after ${timeoutMs}ms`));
-      }, timeoutMs);
-      const unsub = this.onDialog(tabId, async (data) => {
-        clearTimeout(timer);
-        unsub();
-        await this.dismiss(tabId);
-        resolve2(data);
-      });
-    });
+  clear(tabId = "default") {
+    return this.client.send("capture.clear", { tabId });
   }
 }
-function createDialogAPI(client) {
-  return new DialogClient(client);
+function createCaptureAPI(client) {
+  return new CaptureClient(client);
 }
 
 // piggy/export/index.ts
@@ -29318,97 +29614,6 @@ function createExportAPI(client) {
   return new ExportClient(client);
 }
 
-// piggy/find/index.ts
-class FindClient {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  css(selector, tabId = "default") {
-    return this.client.send("find.css", { selector, tabId });
-  }
-  all(selector, tabId = "default") {
-    return this.client.send("find.all", { selector, tabId });
-  }
-  first(selector, tabId = "default") {
-    return this.client.send("find.first", { selector, tabId });
-  }
-  byText(text, tabId = "default") {
-    return this.client.send("find.byText", { text, tabId });
-  }
-  byAttr(attr, value, tabId = "default") {
-    return this.client.send("find.byAttr", { attr, value, tabId });
-  }
-  byTag(tag, tabId = "default") {
-    return this.client.send("find.byTag", { tag, tabId });
-  }
-  byPlaceholder(text, tabId = "default") {
-    return this.client.send("find.byPlaceholder", { text, tabId });
-  }
-  byRole(role, name, tabId = "default") {
-    return this.client.send("find.byRole", { role, name, tabId });
-  }
-  children(selector, tabId = "default") {
-    return this.client.send("find.children", { selector, tabId });
-  }
-  parent(selector, tabId = "default") {
-    return this.client.send("find.parent", { selector, tabId });
-  }
-  closest(selector, ancestor, tabId = "default") {
-    return this.client.send("find.closest", { selector, ancestor, tabId });
-  }
-  count(selector, tabId = "default") {
-    return this.client.send("find.count", { selector, tabId });
-  }
-  exists(selector, tabId = "default") {
-    return this.client.send("find.exists", { selector, tabId });
-  }
-  visible(selector, tabId = "default") {
-    return this.client.send("find.visible", { selector, tabId });
-  }
-  enabled(selector, tabId = "default") {
-    return this.client.send("find.enabled", { selector, tabId });
-  }
-  checked(selector, tabId = "default") {
-    return this.client.send("find.checked", { selector, tabId });
-  }
-}
-function createFindAPI(client) {
-  return new FindClient(client);
-}
-
-// piggy/iframe/index.ts
-class IframeClient {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  list(tabId = "default") {
-    return this.client.send("iframe.list", { tabId });
-  }
-  evaluate(opts, tabId = "default") {
-    return this.client.send("iframe.evaluate", { ...opts, tabId });
-  }
-  click(opts, tabId = "default") {
-    return this.client.send("iframe.click", { ...opts, tabId });
-  }
-  type(opts, tabId = "default") {
-    return this.client.send("iframe.type", { ...opts, tabId });
-  }
-  text(opts, tabId = "default") {
-    return this.client.send("iframe.text", { ...opts, tabId });
-  }
-  html(opts, tabId = "default") {
-    return this.client.send("iframe.html", { ...opts, tabId });
-  }
-  waitSel(opts, tabId = "default") {
-    return this.client.send("iframe.waitSel", { ...opts, tabId });
-  }
-}
-function createIframeAPI(client) {
-  return new IframeClient(client);
-}
-
 // piggy/interactions/index.ts
 class InteractionsClient {
   client;
@@ -29535,62 +29740,6 @@ function createNavigationAPI(client) {
   return new NavigationClient(client);
 }
 
-// piggy/provide/index.ts
-class ProvideClient {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  text(opts, tabId = "default") {
-    return this.client.send("provide.text", { ...opts, tabId });
-  }
-  textAll(opts, tabId = "default") {
-    return this.client.send("provide.textAll", { ...opts, tabId });
-  }
-  attr(opts, tabId = "default") {
-    return this.client.send("provide.attr", { ...opts, tabId });
-  }
-  attrAll(opts, tabId = "default") {
-    return this.client.send("provide.attrAll", { ...opts, tabId });
-  }
-  html(opts, tabId = "default") {
-    return this.client.send("provide.html", { ...opts, tabId });
-  }
-  table(opts, tabId = "default") {
-    return this.client.send("provide.table", { ...opts, tabId });
-  }
-  list(opts, tabId = "default") {
-    return this.client.send("provide.list", { ...opts, tabId });
-  }
-  links(opts, tabId = "default") {
-    return this.client.send("provide.links", { ...opts, tabId });
-  }
-  images(opts, tabId = "default") {
-    return this.client.send("provide.images", { ...opts, tabId });
-  }
-  form(opts, tabId = "default") {
-    return this.client.send("provide.form", { ...opts, tabId });
-  }
-  page(tabId = "default") {
-    return this.client.send("provide.page", { tabId });
-  }
-  div(opts, tabId = "default") {
-    return this.client.send("provide.div", { ...opts, tabId });
-  }
-  meta(tabId = "default") {
-    return this.client.send("provide.meta", { tabId });
-  }
-  select(opts, tabId = "default") {
-    return this.client.send("provide.select", { ...opts, tabId });
-  }
-  json(opts, tabId = "default") {
-    return this.client.send("provide.json", { ...opts, tabId });
-  }
-}
-function createProvideAPI(client) {
-  return new ProvideClient(client);
-}
-
 // piggy/proxy/index.ts
 class ProxyClient {
   client;
@@ -29650,57 +29799,6 @@ function createProxyAPI(client) {
   return new ProxyClient(client);
 }
 
-// piggy/session/index.ts
-class SessionClient {
-  client;
-  constructor(client) {
-    this.client = client;
-  }
-  reload(tabId = "default") {
-    return this.client.send("session.reload", { tabId });
-  }
-  paths() {
-    return this.client.send("session.paths", {});
-  }
-  cookiesPath() {
-    return this.client.send("session.cookies.path", {});
-  }
-  profilePath() {
-    return this.client.send("session.profile.path", {});
-  }
-  wsPath() {
-    return this.client.send("session.ws.path", {});
-  }
-  pingsPath() {
-    return this.client.send("session.pings.path", {});
-  }
-  setWsSave(enabled) {
-    return this.client.send("session.ws.save", { enabled });
-  }
-  setPingsSave(enabled) {
-    return this.client.send("session.pings.save", { enabled });
-  }
-  async export(tabId = "default") {
-    const raw = await this.client.send("session.export", { tabId });
-    return typeof raw === "string" ? JSON.parse(raw) : raw;
-  }
-  import(data, tabId = "default") {
-    return this.client.send("session.import", {
-      data: JSON.stringify(data),
-      tabId
-    });
-  }
-  setCookie(opts, tabId = "default") {
-    return this.client.send("cookie.set", { ...opts, tabId });
-  }
-  deleteCookie(opts, tabId = "default") {
-    return this.client.send("cookie.delete", { ...opts, tabId });
-  }
-}
-function createSessionAPI(client) {
-  return new SessionClient(client);
-}
-
 // piggy/tabs/index.ts
 class TabsClient {
   client;
@@ -29710,7 +29808,8 @@ class TabsClient {
   new() {
     return this.client.send("tab.new", {});
   }
-  close(tabId) {
+  close(opts) {
+    const tabId = typeof opts === "string" ? opts : opts.tabId;
     return this.client.send("tab.close", { tabId });
   }
   list() {
@@ -29867,6 +29966,7 @@ var _router = null;
 var _tabMode = "tab";
 var _extraProcs = [];
 var _sites = {};
+var _singleSiteName = null;
 function guardClient() {
   if (!_client)
     throw new Error("No client. Call piggy.launch() or piggy.connect() first.");
@@ -29903,9 +30003,15 @@ var piggy = {
       throw new Error(`No URL for site "${name}"`);
     const binaryMode = opts?.binary ?? "headless";
     const poolSize = opts?.pool ?? 0;
+    const isSingle = opts?.single === true;
+    if (isSingle && _singleSiteName && _singleSiteName !== name) {
+      throw new Error(`piggy: site "${_singleSiteName}" is already registered as single. ` + `Only one site may use { single: true } at a time.`);
+    }
     if (_tabMode === "tab") {
       const client = guardClient();
       if (poolSize > 1) {
+        if (isSingle)
+          throw new Error("piggy: { single: true } is incompatible with pool > 1");
         const pool = new TabPool(client, poolSize, url2, name);
         await pool.init();
         const siteObj = createSiteObject(name, url2, client, "default", pool);
@@ -29913,13 +30019,20 @@ var piggy = {
         piggy[name] = siteObj;
         logger_default.success(`[${name}] registered with pool of ${poolSize} tabs`);
       } else {
-        const tabId = await client.newTab();
+        const tabId = isSingle ? "default" : await client.newTab();
         const siteObj = createSiteObject(name, url2, client, tabId);
         _sites[name] = siteObj;
         piggy[name] = siteObj;
-        logger_default.success(`[${name}] registered as tab ${tabId}`);
+        if (isSingle) {
+          _singleSiteName = name;
+          logger_default.success(`[${name}] registered as single-tab site (default tab)`);
+        } else {
+          logger_default.success(`[${name}] registered as tab ${tabId}`);
+        }
       }
     } else {
+      if (isSingle)
+        throw new Error("piggy: { single: true } is only supported in tab mode");
       const socketName = `piggy_${name}`;
       await spawnBrowserOnSocket(socketName, binaryMode);
       await new Promise((r) => setTimeout(r, 500));
@@ -29933,9 +30046,34 @@ var piggy = {
     }
     return piggy;
   },
+  extend: async (...installers) => {
+    if (!_singleSiteName) {
+      throw new Error(`piggy.extend() requires a site registered with { single: true }.
+` + 'Example: await piggy.register("mysite", url, { single: true })');
+    }
+    if (installers.length === 0) {
+      logger_default.warn("[piggy] extend() called with no plugins — nothing to do");
+      return piggy;
+    }
+    const site = _sites[_singleSiteName];
+    if (!site) {
+      throw new Error(`piggy.extend(): site "${_singleSiteName}" not found — register it first`);
+    }
+    for (const installer of installers) {
+      if (typeof installer !== "function") {
+        throw new Error("piggy.extend(): each argument must be a plugin installer function");
+      }
+      await installer(site);
+    }
+    logger_default.success(`[piggy] ${installers.length} plugin(s) installed on "${_singleSiteName}"`);
+    return piggy;
+  },
   get tabs() {
     return _router?.tabs ?? createTabsAPI(guardClient());
   },
+  get tab() {
+    return _router?.tabs ?? createTabsAPI(guardClient());
+  },
   get navigation() {
     return _router?.navigation ?? createNavigationAPI(guardClient());
   },
@@ -30045,6 +30183,7 @@ var piggy = {
   }),
   close: async (opts) => {
     stopServer();
+    _singleSiteName = null;
     if (opts?.force) {
       for (const { client: c } of _extraProcs)
         c.disconnect();