From 7c852b1f0e0ad0cb93973cd5f30a6116ca773ea4 Mon Sep 17 00:00:00 2001
From: emma <hi@emma.cafe>
Date: Mon, 28 Apr 2025 19:04:22 -0400
Subject: [PATCH 1/5] wip

---
 .gitignore            |   2 +-
 package.json          |  11 ++-
 src/autoclick.ts      |  28 +++---
 src/autofetcher.ts    |  57 ++++++-----
 src/behavior.d.ts     |  42 ++++++++
 src/index.ts          | 121 +++++++++++++++++------
 src/lib/behavior.ts   |  95 ++++++++++--------
 src/lib/utils.ts      | 220 ++++++++++++++++++++++++++++--------------
 src/site/facebook.ts  |  86 +++++++++++------
 src/site/index.ts     |   4 +-
 src/site/instagram.ts | 118 ++++++++++++++--------
 src/site/telegram.ts  |  19 +++-
 src/site/tiktok.ts    |  30 +++---
 src/site/twitter.ts   | 123 +++++++++++++++--------
 tsconfig.json         |  20 +---
 webpack.config.js     |   8 +-
 yarn.lock             |  10 ++
 17 files changed, 661 insertions(+), 333 deletions(-)
 create mode 100644 src/behavior.d.ts

diff --git a/.gitignore b/.gitignore
index 2a6dddb..940d56a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,2 @@
 node_modules/
-dist/behaviors.js
+dist
diff --git a/package.json b/package.json
index 0db2d3b..90cf7ab 100644
--- a/package.json
+++ b/package.json
@@ -5,16 +5,18 @@
   "author": "Webrecorder Software",
   "license": "AGPL-3.0-or-later",
   "devDependencies": {
+    "@types/query-selector-shadow-dom": "^1.0.4",
     "@typescript-eslint/eslint-plugin": "^8.28.0",
     "@typescript-eslint/parser": "^8.28.0",
     "@webpack-cli/init": "^1.1.3",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.5.3",
     "ts-loader": "^9.4.2",
     "typescript": "^5.7.3",
     "webpack": "^5.75.0",
     "webpack-cli": "^4.5.0",
-    "webpack-dev-server": "^3.11.2",
-    "eslint": "^8.56.0",
-    "eslint-config-prettier": "^9.1.0"
+    "webpack-dev-server": "^3.11.2"
   },
   "scripts": {
     "build": "webpack --mode production",
@@ -22,7 +24,8 @@
     "build-dev-copy": "webpack --mode development && cat ./dist/behaviors.js | pbcopy",
     "watch": "webpack watch --mode production",
     "watch-dev": "webpack watch --mode development",
-    "lint": "eslint ./src/**/*.ts webpack.config.js"
+    "lint": "eslint ./src/**/*.ts webpack.config.js",
+    "format": "prettier --write ./src/**/*.ts webpack.config.js"
   },
   "description": "Browsertrix Behaviors",
   "files": [
diff --git a/src/autoclick.ts b/src/autoclick.ts
index 28e80df..a0be360 100644
--- a/src/autoclick.ts
+++ b/src/autoclick.ts
@@ -3,8 +3,7 @@ import { addToExternalSet, sleep } from "./lib/utils";
 
 declare let getEventListeners: any;
 
-export class AutoClick extends BackgroundBehavior
-{
+export class AutoClick extends BackgroundBehavior {
   _donePromise: Promise<void>;
   _markDone: () => void;
   selector: string;
@@ -15,10 +14,12 @@ export class AutoClick extends BackgroundBehavior
   constructor(selector = "a") {
     super();
     this.selector = selector;
-    this._donePromise = new Promise<void>((resolve) => this._markDone = resolve);
+    this._donePromise = new Promise<void>(
+      (resolve) => (this._markDone = resolve),
+    );
   }
 
-  nextSameOriginLink() : HTMLAnchorElement | null {
+  nextSameOriginLink(): HTMLAnchorElement | null {
     try {
       const allLinks = document.querySelectorAll(this.selector);
       for (const el of allLinks) {
@@ -49,7 +50,7 @@ export class AutoClick extends BackgroundBehavior
 
   async start() {
     const origHref = self.location.href;
-    
+
     const beforeUnload = (event) => {
       event.preventDefault();
       return false;
@@ -92,7 +93,7 @@ export class AutoClick extends BackgroundBehavior
 
     if (elem.href) {
       // skip if already clicked this URL, tracked in external state
-      if (!await addToExternalSet(elem.href)) {
+      if (!(await addToExternalSet(elem.href))) {
         return;
       }
 
@@ -107,18 +108,23 @@ export class AutoClick extends BackgroundBehavior
 
     if (self.location.href != origHref) {
       await new Promise((resolve) => {
-        window.addEventListener("popstate", () => {
-          resolve(null);
-        }, { once: true });
+        window.addEventListener(
+          "popstate",
+          () => {
+            resolve(null);
+          },
+          { once: true },
+        );
 
         window.history.back();
       });
     }
-  } catch (e) {
+  }
+  catch(e) {
     this.debug(e.toString());
   }
 
-  done() {
+  async done() {
     return this._donePromise;
   }
 }
diff --git a/src/autofetcher.ts b/src/autofetcher.ts
index d36b9b8..a79ff5e 100644
--- a/src/autofetcher.ts
+++ b/src/autofetcher.ts
@@ -9,7 +9,8 @@ import { querySelectorAllDeep } from "query-selector-shadow-dom";
 import { BackgroundBehavior } from "./lib/behavior";
 import { doExternalFetch, sleep, xpathNodes } from "./lib/utils";
 
-const SRC_SET_SELECTOR = "img[srcset], img[data-srcset], img[data-src], noscript > img[src], img[loading='lazy'], " +
+const SRC_SET_SELECTOR =
+  "img[srcset], img[data-srcset], img[data-src], noscript > img[src], img[loading='lazy'], " +
   "video[srcset], video[data-srcset], video[data-src], audio[srcset], audio[data-srcset], audio[data-src], " +
   "picture > source[srcset], picture > source[data-srcset], picture > source[data-src], " +
   "video > source[srcset], video > source[data-srcset], video > source[data-src], " +
@@ -22,18 +23,17 @@ const IMPORT_REGEX = /(@import\s*[\\"']*)([^)'";]+)([\\"']*\s*;?)/gi;
 
 const MAX_CONCURRENT = 6;
 
-
 // ===========================================================================
 export class AutoFetcher extends BackgroundBehavior {
-  urlSet: Set<string> = new Set();
+  urlSet = new Set<string>();
   pendingQueue: string[] = [];
   waitQueue: string[] = [];
-  mutationObserver: MutationObserver;
-  numPending: number = 0;
-  numDone: number = 0;
+  mutationObserver?: MutationObserver;
+  numPending = 0;
+  numDone = 0;
   headers: object;
   _donePromise: Promise<null>;
-  _markDone: (value: any) => void;
+  _markDone?: (value: any) => void;
   active: boolean;
   running = false;
 
@@ -44,7 +44,7 @@ export class AutoFetcher extends BackgroundBehavior {
 
     this.headers = headers || {};
 
-    this._donePromise = new Promise((resolve) => this._markDone = resolve);
+    this._donePromise = new Promise((resolve) => (this._markDone = resolve));
 
     this.active = active;
     if (this.active && startEarly) {
@@ -72,7 +72,7 @@ export class AutoFetcher extends BackgroundBehavior {
     });
   }
 
-  done() {
+  async done() {
     return this._donePromise;
   }
 
@@ -93,7 +93,7 @@ export class AutoFetcher extends BackgroundBehavior {
     return url && (url.startsWith("http:") || url.startsWith("https:"));
   }
 
-  queueUrl(url: string, immediate: boolean = false) {
+  queueUrl(url: string, immediate = false) {
     try {
       url = new URL(url, document.baseURI).href;
     } catch (e) {
@@ -122,7 +122,10 @@ export class AutoFetcher extends BackgroundBehavior {
   // fetch with default CORS mode, read entire stream
   async doFetchStream(url: string) {
     try {
-      const resp = await fetch(url, { "credentials": "include", "referrerPolicy": "origin-when-cross-origin" });
+      const resp = await fetch(url, {
+        credentials: "include",
+        referrerPolicy: "origin-when-cross-origin",
+      });
       this.debug(`Autofetch: started ${url}`);
 
       const reader = resp.body.getReader();
@@ -133,7 +136,6 @@ export class AutoFetcher extends BackgroundBehavior {
       this.debug(`Autofetch: finished ${url}`);
 
       return true;
-
     } catch (e) {
       this.debug(e);
 
@@ -146,11 +148,11 @@ export class AutoFetcher extends BackgroundBehavior {
     try {
       const abort = new AbortController();
       await fetch(url, {
-        "mode": "no-cors",
-        "credentials": "include",
-        "referrerPolicy": "origin-when-cross-origin",
-        "headers": this.headers,
-        abort
+        mode: "no-cors",
+        credentials: "include",
+        referrerPolicy: "origin-when-cross-origin",
+        headers: this.headers,
+        abort,
       } as {});
       abort.abort();
       this.debug(`Autofetch: started non-cors stream for ${url}`);
@@ -167,7 +169,7 @@ export class AutoFetcher extends BackgroundBehavior {
 
         this.numPending++;
 
-        let success = await doExternalFetch(url);
+        const success = await doExternalFetch(url);
 
         if (!success) {
           await this.doFetchNonCors(url);
@@ -186,7 +188,9 @@ export class AutoFetcher extends BackgroundBehavior {
     if (this.mutationObserver) {
       return;
     }
-    this.mutationObserver = new MutationObserver((changes) => this.observeChange(changes));
+    this.mutationObserver = new MutationObserver((changes) =>
+      this.observeChange(changes),
+    );
 
     this.mutationObserver.observe(document.documentElement, {
       characterData: false,
@@ -195,7 +199,7 @@ export class AutoFetcher extends BackgroundBehavior {
       attributeOldValue: true,
       subtree: true,
       childList: true,
-      attributeFilter: ["srcset", "loading"]
+      attributeFilter: ["srcset", "loading"],
     });
   }
 
@@ -282,7 +286,10 @@ export class AutoFetcher extends BackgroundBehavior {
     // check regular src in case of <noscript> only to avoid duplicate loading
     const src = elem.getAttribute("src");
 
-    if (src && (srcset || data_srcset || elem.parentElement.tagName === "NOSCRIPT")) {
+    if (
+      src &&
+      (srcset || data_srcset || elem.parentElement.tagName === "NOSCRIPT")
+    ) {
       this.queueUrl(src);
     }
   }
@@ -331,12 +338,12 @@ export class AutoFetcher extends BackgroundBehavior {
   }
 
   extractDataAttributes(root) {
-    const QUERY = "//@*[starts-with(name(), 'data-') and " +
-    "(starts-with(., 'http') or starts-with(., '/') or starts-with(., './') or starts-with(., '../'))]";
-    
+    const QUERY =
+      "//@*[starts-with(name(), 'data-') and " +
+      "(starts-with(., 'http') or starts-with(., '/') or starts-with(., './') or starts-with(., '../'))]";
+
     for (const attr of xpathNodes(QUERY, root)) {
       this.queueUrl(attr.value);
     }
   }
 }
-
diff --git a/src/behavior.d.ts b/src/behavior.d.ts
new file mode 100644
index 0000000..950c51b
--- /dev/null
+++ b/src/behavior.d.ts
@@ -0,0 +1,42 @@
+import {
+  type waitUntil,
+  type sleep,
+  type xpathNode,
+  type waitUnit,
+  type scrollIntoView,
+  type RestoreState,
+  type xpathString,
+  type getState,
+  type HistoryState,
+  type waitUntilNode,
+} from "./lib/utils";
+
+type Opts = {
+  maxDepth: number;
+};
+
+export interface Context<State = {}> {
+  Lib: {
+    xpathNode: typeof xpathNode;
+    sleep: typeof sleep;
+    waitUntil: typeof waitUntil;
+    waitUnit: typeof waitUnit;
+    scrollIntoView: typeof scrollIntoView;
+    RestoreState: typeof RestoreState;
+    xpathString: typeof xpathString;
+    getState: typeof getState;
+    HistoryState: typeof HistoryState;
+    waitUntilNode: typeof waitUntilNode;
+  };
+  opts: Opts;
+  state?: Partial<State>;
+  log: (...args: unknown[]) => void;
+}
+
+declare abstract class Behavior<State = {}> {
+  static readonly id: string;
+  constructor();
+  abstract run(ctx: Context<Partial<State>>): AsyncGenerator;
+  showingProgressBar?(ctx: Context<State>, root: Node): boolean;
+  awaitPageLoad?(ctx: Context<State>): Promise<void>;
+}
diff --git a/src/index.ts b/src/index.ts
index 86cd411..42b8da6 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -2,8 +2,17 @@ import { AutoFetcher } from "./autofetcher";
 import { Autoplay } from "./autoplay";
 import { AutoScroll } from "./autoscroll";
 import { AutoClick } from "./autoclick";
-import { awaitLoad, sleep, behaviorLog, _setLogFunc, _setBehaviorManager, installBehaviors, addLink, checkToJsonOverride } from "./lib/utils";
-import { Behavior, BehaviorRunner } from "./lib/behavior";
+import {
+  awaitLoad,
+  sleep,
+  behaviorLog,
+  _setLogFunc,
+  _setBehaviorManager,
+  installBehaviors,
+  addLink,
+  checkToJsonOverride,
+} from "./lib/utils";
+import { type Behavior, BehaviorRunner } from "./lib/behavior";
 
 import siteBehaviors from "./site";
 
@@ -31,7 +40,13 @@ type LinkOpts = {
   attrOnly?: boolean;
 };
 
-const DEFAULT_OPTS: BehaviorManagerOpts = {autofetch: true, autoplay: true, autoscroll: true, autoclick: true, siteSpecific: true};
+const DEFAULT_OPTS: BehaviorManagerOpts = {
+  autofetch: true,
+  autoplay: true,
+  autoscroll: true,
+  autoclick: true,
+  siteSpecific: true,
+};
 
 const DEFAULT_CLICK_SELECTOR = "a";
 
@@ -59,11 +74,18 @@ export class BehaviorManager {
     this.mainBehavior = null;
     this.inited = false;
     this.started = false;
-    this.linkOpts = {selector: DEFAULT_LINK_SELECTOR, extractName: DEFAULT_LINK_EXTRACT};
+    this.linkOpts = {
+      selector: DEFAULT_LINK_SELECTOR,
+      extractName: DEFAULT_LINK_EXTRACT,
+    };
     behaviorLog("Loaded behaviors for: " + self.location.href);
   }
 
-  init(opts: BehaviorManagerOpts = DEFAULT_OPTS, restart = false, customBehaviors: any[] = null) {
+  init(
+    opts: BehaviorManagerOpts = DEFAULT_OPTS,
+    restart = false,
+    customBehaviors: any[] = null,
+  ) {
     if (this.inited && !restart) {
       return;
     }
@@ -81,11 +103,11 @@ export class BehaviorManager {
     if (opts.log !== undefined) {
       let logger = opts.log;
       // if string, look up as global
-      if (typeof (logger) === "string") {
+      if (typeof logger === "string") {
         logger = self[logger];
       }
       // if function, set to it
-      if (typeof (logger) === "function") {
+      if (typeof logger === "function") {
         _setLogFunc(logger);
         // if false, disable logging
       } else if (logger === false) {
@@ -93,7 +115,11 @@ export class BehaviorManager {
       }
     }
 
-    this.autofetch = new AutoFetcher(!!opts.autofetch, opts.fetchHeaders, opts.startEarly);
+    this.autofetch = new AutoFetcher(
+      !!opts.autofetch,
+      opts.fetchHeaders,
+      opts.startEarly,
+    );
 
     if (opts.autofetch) {
       behaviorLog("Using AutoFetcher");
@@ -107,7 +133,9 @@ export class BehaviorManager {
 
     if (opts.autoclick) {
       behaviorLog("Using AutoClick");
-      this.behaviors.push(new AutoClick(opts.clickSelector || DEFAULT_CLICK_SELECTOR));
+      this.behaviors.push(
+        new AutoClick(opts.clickSelector || DEFAULT_CLICK_SELECTOR),
+      );
     }
 
     if (customBehaviors) {
@@ -134,12 +162,17 @@ export class BehaviorManager {
         if (siteBehaviorClass.isMatch()) {
           behaviorLog("Using Site-Specific Behavior: " + name);
           this.mainBehaviorClass = siteBehaviorClass;
-          const siteSpecificOpts = typeof opts.siteSpecific === "object" ?
-            (opts.siteSpecific[name] || {}) : {};
+          const siteSpecificOpts =
+            typeof opts.siteSpecific === "object"
+              ? opts.siteSpecific[name] || {}
+              : {};
           try {
-            this.mainBehavior = new BehaviorRunner(siteBehaviorClass, siteSpecificOpts);
+            this.mainBehavior = new BehaviorRunner(
+              siteBehaviorClass,
+              siteSpecificOpts,
+            );
           } catch (e) {
-            behaviorLog({msg: e.toString(), siteSpecific: true}, "error");
+            behaviorLog({ msg: e.toString(), siteSpecific: true }, "error");
           }
           siteMatch = true;
           break;
@@ -165,29 +198,38 @@ export class BehaviorManager {
   }
 
   load(behaviorClass) {
-    if (typeof(behaviorClass.id) !== "string") {
-      behaviorLog("Behavior class must have a string string \"id\" property", "error");
+    if (typeof behaviorClass.id !== "string") {
+      behaviorLog(
+        'Behavior class must have a string string "id" property',
+        "error",
+      );
       return;
     }
 
     const name = behaviorClass.id;
 
-    if (typeof(behaviorClass) !== "function") {
+    if (typeof behaviorClass !== "function") {
       behaviorLog(`Must pass a class object, got ${behaviorClass}`, "error");
       return;
     }
 
     if (
-      typeof(behaviorClass.isMatch) !== "function" ||
-      typeof(behaviorClass.init) !== "function"
+      typeof behaviorClass.isMatch !== "function" ||
+      typeof behaviorClass.init !== "function"
     ) {
-      behaviorLog("Behavior class must have an is `isMatch()` and `init()` static methods", "error");
+      behaviorLog(
+        "Behavior class must have an is `isMatch()` and `init()` static methods",
+        "error",
+      );
       return;
     }
 
     if (!this.isInTopFrame()) {
       if (!behaviorClass.runInIframe) {
-        behaviorLog(`Behavior class ${name}: not running in iframes (.runInIframe not set)`, "debug");
+        behaviorLog(
+          `Behavior class ${name}: not running in iframes (.runInIframe not set)`,
+          "debug",
+        );
         return;
       }
     }
@@ -230,7 +272,7 @@ export class BehaviorManager {
 
     await awaitLoad();
 
-    this.behaviors.forEach(x => {
+    this.behaviors.forEach((x) => {
       const id = x.id || x.constructor.id || "(Unnamed)";
       behaviorLog("Starting behavior: " + id, "debug");
       x.start();
@@ -240,10 +282,15 @@ export class BehaviorManager {
 
     await sleep(500);
 
-    const allBehaviors = Promise.allSettled(this.behaviors.map(x => x.done()));
+    const allBehaviors = Promise.allSettled(
+      this.behaviors.map((x) => x.done()),
+    );
 
     if (this.timeout) {
-      behaviorLog(`Waiting for behaviors to finish or ${this.timeout}ms timeout`, "debug");
+      behaviorLog(
+        `Waiting for behaviors to finish or ${this.timeout}ms timeout`,
+        "debug",
+      );
       await Promise.race([allBehaviors, sleep(this.timeout)]);
     } else {
       behaviorLog("Waiting for behaviors to finish", "debug");
@@ -258,7 +305,7 @@ export class BehaviorManager {
   }
 
   async runOne(name, behaviorOpts = {}) {
-    const siteBehaviorClass = siteBehaviors.find(b => b.name === name);
+    const siteBehaviorClass = siteBehaviors.find((b) => b.name === name);
     if (typeof siteBehaviorClass === "undefined") {
       console.error(`No behavior of name ${name} found`);
       return;
@@ -273,12 +320,12 @@ export class BehaviorManager {
 
   pause() {
     behaviorLog("Pausing Main Behavior" + this.mainBehaviorClass.name);
-    this.behaviors.forEach(x => x.pause());
+    this.behaviors.forEach((x) => x.pause());
   }
 
   unpause() {
     // behaviorLog("Unpausing Main Behavior: " + this.mainBehaviorClass.name);
-    this.behaviors.forEach(x => x.unpause());
+    this.behaviors.forEach((x) => x.unpause());
   }
 
   doAsyncFetch(url) {
@@ -287,17 +334,28 @@ export class BehaviorManager {
   }
 
   isInTopFrame() {
-    return self.window.top === self.window || window["__WB_replay_top"] === self.window;
+    return (
+      self.window.top === self.window ||
+      window["__WB_replay_top"] === self.window
+    );
   }
 
-  async extractLinks(selector = DEFAULT_LINK_SELECTOR, extractName = "href", attrOnly = false) {
-    this.linkOpts = {selector, extractName, attrOnly};
+  async extractLinks(
+    selector = DEFAULT_LINK_SELECTOR,
+    extractName = "href",
+    attrOnly = false,
+  ) {
+    this.linkOpts = { selector, extractName, attrOnly };
     checkToJsonOverride();
     return await this.extractLinksActual();
   }
 
   async extractLinksActual() {
-    const {selector = DEFAULT_LINK_SELECTOR, extractName = DEFAULT_LINK_EXTRACT, attrOnly = false} = this.linkOpts;
+    const {
+      selector = DEFAULT_LINK_SELECTOR,
+      extractName = DEFAULT_LINK_EXTRACT,
+      attrOnly = false,
+    } = this.linkOpts;
 
     const urls = new Set<string>();
 
@@ -308,7 +366,7 @@ export class BehaviorManager {
         value = elem.getAttribute(extractName);
       }
       // set if got a string
-      if (typeof(value) === "string") {
+      if (typeof value === "string") {
         urls.add(value);
       }
     });
@@ -323,7 +381,6 @@ export class BehaviorManager {
   }
 }
 
-
 _setBehaviorManager(BehaviorManager);
 
 installBehaviors(self);
diff --git a/src/lib/behavior.ts b/src/lib/behavior.ts
index a8918e8..d7db688 100644
--- a/src/lib/behavior.ts
+++ b/src/lib/behavior.ts
@@ -1,29 +1,39 @@
+import { type Context } from "../behavior";
 import { behaviorLog } from "./utils";
 import * as Lib from "./utils";
 
+type KeysWithValsOfType<T, V> = keyof {
+  [P in keyof T as T[P] extends V ? P : never]: P;
+};
+
 // ===========================================================================
 export class BackgroundBehavior {
-  debug(msg) {
-    behaviorLog(msg, "debug");
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  debug(msg: any) {
+    void behaviorLog(msg, "debug");
   }
 
-  error(msg) {
-    behaviorLog(msg, "error");
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  error(msg: any) {
+    void behaviorLog(msg, "error");
   }
 
-  log(msg, type = "info") {
-    behaviorLog(msg, type);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  log(msg: any, type = "info") {
+    void behaviorLog(msg, type);
   }
 }
 
 // ===========================================================================
-export class Behavior extends BackgroundBehavior {
-  _running: any;
-  paused: any;
-  _unpause: any;
-  state: any;
+export class Behavior<State extends Object = {}> extends BackgroundBehavior {
+  _running: Promise<void> | null;
+  paused: Promise<void> | null;
+  _unpause: ((value: void | PromiseLike<void>) => void) | null;
+  state: Partial<State>;
   scrollOpts: {
-    behavior: string, block: string, inline: string
+    behavior: string;
+    block: string;
+    inline: string;
   };
 
   constructor() {
@@ -40,7 +50,7 @@ export class Behavior extends BackgroundBehavior {
     this._running = this.run();
   }
 
-  done() {
+  async done() {
     return this._running ? this._running : Promise.resolve();
   }
 
@@ -52,7 +62,7 @@ export class Behavior extends BackgroundBehavior {
           await this.paused;
         }
       }
-      this.debug(this.getState("done!"));
+      this.debug(this.getState("done!", "done!"));
     } catch (e) {
       this.error(e.toString());
     }
@@ -75,21 +85,27 @@ export class Behavior extends BackgroundBehavior {
     }
   }
 
-  getState(msg: string, incrValue?) {
+  getState(msg: string, incrValue?: KeysWithValsOfType<State, number>) {
     if (incrValue) {
       if (this.state[incrValue] === undefined) {
-        this.state[incrValue] = 1;
+        (
+          this.state as {
+            [K in KeysWithValsOfType<State, number>]: number;
+          }
+        )[incrValue] = 1;
       } else {
-        this.state[incrValue]++;
+        (
+          this.state as {
+            [K in KeysWithValsOfType<State, number>]: number;
+          }
+        )[incrValue]++;
       }
     }
 
     return { state: this.state, msg };
   }
 
-  cleanup() {
-
-  }
+  cleanup() {}
 
   async awaitPageLoad() {
     // wait for initial page load here
@@ -100,12 +116,12 @@ export class Behavior extends BackgroundBehavior {
       self["__bx_behaviors"].load(this);
     } else {
       console.warn(
-        `Could not load ${this.name} behavior: window.__bx_behaviors is not initialized`
+        `Could not load ${this.name} behavior: window.__bx_behaviors is not initialized`,
       );
     }
   }
 
-  async*[Symbol.asyncIterator]() {
+  async *[Symbol.asyncIterator]() {
     yield;
   }
 }
@@ -125,25 +141,25 @@ interface StaticAbstractBehavior {
   init: () => any;
 }
 
-type AbstractBehavior =
-  (new () => AbstractBehaviorInst) & StaticAbstractBehavior;
+type AbstractBehavior = (new () => AbstractBehaviorInst) &
+  StaticAbstractBehavior;
 
 export class BehaviorRunner extends BackgroundBehavior {
   inst: AbstractBehaviorInst;
   behaviorProps: StaticAbstractBehavior;
-  ctx: any;
-  _running: any;
+  ctx: Context;
+  _running: Promise<void> | undefined;
   paused: any;
   _unpause: any;
 
   get id() {
-    return (this.inst?.constructor as any).id;
+    return (this.inst.constructor as any).id;
   }
 
   constructor(behavior: AbstractBehavior, mainOpts = {}) {
     super();
     this.behaviorProps = behavior;
-    this.inst = new behavior;
+    this.inst = new behavior();
 
     if (
       typeof this.inst.run !== "function" ||
@@ -152,9 +168,9 @@ export class BehaviorRunner extends BackgroundBehavior {
       throw Error("Invalid behavior: missing `async run*` instance method");
     }
 
-    let {state, opts} = behavior.init();
+    let { state, opts } = behavior.init();
     state = state || {};
-    opts = opts ? {...opts, ...mainOpts} : mainOpts;
+    opts = opts ? { ...opts, ...mainOpts } : mainOpts;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const log = async (data: any, type: string) => this.wrappedLog(data, type);
 
@@ -169,18 +185,21 @@ export class BehaviorRunner extends BackgroundBehavior {
   wrappedLog(data: any, type = "info") {
     let logData;
     if (typeof data === "string" || data instanceof String) {
-      logData = {msg: data}
+      logData = { msg: data };
     } else {
       logData = data;
     }
-    this.log({...logData, behavior: this.behaviorProps.id, siteSpecific: true}, type);
+    this.log(
+      { ...logData, behavior: this.behaviorProps.id, siteSpecific: true },
+      type,
+    );
   }
 
   start() {
     this._running = this.run();
   }
 
-  done() {
+  async done() {
     return this._running ? this._running : Promise.resolve();
   }
 
@@ -194,9 +213,9 @@ export class BehaviorRunner extends BackgroundBehavior {
           await this.paused;
         }
       }
-      this.debug({msg: "done!", behavior: this.behaviorProps.id});
+      this.debug({ msg: "done!", behavior: this.behaviorProps.id });
     } catch (e) {
-      this.error({msg: e.toString(), behavior: this.behaviorProps.id});
+      this.error({ msg: e.toString(), behavior: this.behaviorProps.id });
     }
   }
 
@@ -217,9 +236,7 @@ export class BehaviorRunner extends BackgroundBehavior {
     }
   }
 
-  cleanup() {
-
-  }
+  cleanup() {}
 
   async awaitPageLoad() {
     if (this.inst.awaitPageLoad) {
@@ -232,7 +249,7 @@ export class BehaviorRunner extends BackgroundBehavior {
       self["__bx_behaviors"].load(this);
     } else {
       console.warn(
-        `Could not load ${this.name} behavior: window.__bx_behaviors is not initialized`
+        `Could not load ${this.name} behavior: window.__bx_behaviors is not initialized`,
       );
     }
   }
diff --git a/src/lib/utils.ts b/src/lib/utils.ts
index 6cfdfc7..1a22398 100644
--- a/src/lib/utils.ts
+++ b/src/lib/utils.ts
@@ -1,9 +1,19 @@
-let _logFunc = console.log;
+import { type Context } from "../behavior";
+
+let _logFunc: (...args: unknown[]) => void | undefined = console.log;
 let _behaviorMgrClass = null;
 
-const scrollOpts = { behavior: "smooth", block: "center", inline: "center" };
+const scrollOpts: ScrollIntoViewOptions = {
+  behavior: "smooth",
+  block: "center",
+  inline: "center",
+};
 
-export async function scrollAndClick(node, interval = 500, opts = scrollOpts) {
+export async function scrollAndClick(
+  node: HTMLElement,
+  interval = 500,
+  opts: ScrollIntoViewOptions | undefined = scrollOpts,
+) {
   node.scrollIntoView(opts);
   await sleep(interval);
   node.click();
@@ -11,33 +21,42 @@ export async function scrollAndClick(node, interval = 500, opts = scrollOpts) {
 
 export const waitUnit = 200;
 
-export async function sleep(timeout) {
+export async function sleep(timeout: number) {
   return new Promise((resolve) => setTimeout(resolve, timeout));
 }
 
-export async function waitUntil(pred, interval = waitUnit) {
+export async function waitUntil(pred: () => unknown, interval = waitUnit) {
   while (!pred()) {
     await sleep(interval);
   }
 }
 
-export async function waitUntilNode(path, root = document, old = null, timeout = 1000, interval = waitUnit) {
-  let node = null;
+export async function waitUntilNode(
+  path: string,
+  root = document,
+  old: Node | null = null,
+  timeout = 1000,
+  interval = waitUnit,
+) {
+  let node: Node | null = null;
   let stop = false;
   const waitP = waitUntil(() => {
     node = xpathNode(path, root);
     return stop || (node !== old && node !== null);
   }, interval);
   const timeoutP = new Promise((r) =>
-    setTimeout(() => { stop = true; r("TIMEOUT"); }, timeout)
+    setTimeout(() => {
+      stop = true;
+      r("TIMEOUT");
+    }, timeout),
   );
   await Promise.race([waitP, timeoutP]);
   return node;
 }
 
 export async function awaitLoad(iframe?: HTMLIFrameElement) {
-  const doc = iframe ? iframe.contentDocument : document;
-  const win = iframe ? iframe.contentWindow : window;
+  const doc = iframe ? iframe.contentDocument! : document;
+  const win = iframe ? iframe.contentWindow! : window;
   return new Promise((resolve) => {
     if (doc.readyState === "complete") {
       resolve(null);
@@ -47,6 +66,7 @@ export async function awaitLoad(iframe?: HTMLIFrameElement) {
   });
 }
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function unsetToJson(obj: any) {
   if (obj.toJSON) {
     try {
@@ -58,6 +78,7 @@ function unsetToJson(obj: any) {
   }
 }
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function restoreToJson(obj: any) {
   if (obj.__bx__toJSON) {
     try {
@@ -70,26 +91,45 @@ function restoreToJson(obj: any) {
 }
 
 function unsetAllJson() {
-  unsetToJson((Object as any));
-  unsetToJson((Object.prototype as any));
-  unsetToJson((Array as any));
-  unsetToJson((Array.prototype as any));
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  unsetToJson(Object as any);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  unsetToJson(Object.prototype as any);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  unsetToJson(Array as any);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  unsetToJson(Array.prototype as any);
 }
 
 function restoreAllJson() {
-  restoreToJson((Object as any));
-  restoreToJson((Object.prototype as any));
-  restoreToJson((Array as any));
-  restoreToJson((Array.prototype as any));
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  restoreToJson(Object as any);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  restoreToJson(Object.prototype as any);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  restoreToJson(Array as any);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  restoreToJson(Array.prototype as any);
 }
 
 let needUnsetToJson = false;
 
 export function checkToJsonOverride() {
-  needUnsetToJson = (!!(Object as any).toJSON || !!(Object.prototype as any).toJSON || !!(Array as any).toJSON || !!(Array.prototype as any).toJSON);
-}
-
-export async function callBinding(binding, obj) : Promise<any> {
+  needUnsetToJson =
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    !!(Object as any).toJSON ||
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    !!(Object.prototype as any).toJSON ||
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    !!(Array as any).toJSON ||
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    !!(Array.prototype as any).toJSON;
+}
+
+export async function callBinding<T, U>(
+  binding: (obj: T | string) => U,
+  obj: T,
+): Promise<U> {
   try {
     if (needUnsetToJson) {
       unsetAllJson();
@@ -104,28 +144,28 @@ export async function callBinding(binding, obj) : Promise<any> {
   }
 }
 
-export async function behaviorLog(data, type = "debug") {
+export async function behaviorLog(data: unknown, type = "debug") {
   if (_logFunc) {
     await callBinding(_logFunc, { data, type });
   }
 }
 
-export async function addLink(url) : Promise<void> {
-  if (typeof(self["__bx_addLink"]) === "function") {
+export async function addLink(url: string): Promise<void> {
+  if (typeof self["__bx_addLink"] === "function") {
     return await callBinding(self["__bx_addLink"], url);
   }
 }
 
-export async function doExternalFetch(url) : Promise<boolean> {
-  if (typeof(self["__bx_fetch"]) === "function") {
+export async function doExternalFetch(url): Promise<boolean> {
+  if (typeof self["__bx_fetch"] === "function") {
     return await callBinding(self["__bx_fetch"], url);
   }
 
   return false;
 }
 
-export async function addToExternalSet(url) : Promise<boolean> {
-  if (typeof(self["__bx_addSet"]) === "function") {
+export async function addToExternalSet(url): Promise<boolean> {
+  if (typeof self["__bx_addSet"] === "function") {
     return await callBinding(self["__bx_addSet"], url);
   }
 
@@ -134,30 +174,30 @@ export async function addToExternalSet(url) : Promise<boolean> {
 }
 
 export async function waitForNetworkIdle(idleTime = 500, concurrency = 0) {
-  if (typeof(self["__bx_netIdle"]) === "function") {
-    return await callBinding(self["__bx_netIdle"], {idleTime, concurrency});
+  if (typeof self["__bx_netIdle"] === "function") {
+    return await callBinding(self["__bx_netIdle"], { idleTime, concurrency });
   }
 }
 
-export async function initFlow(params) : Promise<number> {
-  if (typeof(self["__bx_initFlow"]) === "function") {
+export async function initFlow(params): Promise<number> {
+  if (typeof self["__bx_initFlow"] === "function") {
     return await callBinding(self["__bx_initFlow"], params);
   }
 
   return -1;
 }
 
-export async function nextFlowStep(id: number) : Promise<any> {
-  if (typeof(self["__bx_nextFlowStep"]) === "function") {
+export async function nextFlowStep(id: number): Promise<any> {
+  if (typeof self["__bx_nextFlowStep"] === "function") {
     return await callBinding(self["__bx_nextFlowStep"], id);
   }
 
-  return {done: true, msg: ""};
+  return { done: true, msg: "" };
 }
 
-export async function openWindow(url) {
+export async function openWindow(url: string) {
   if (self["__bx_open"]) {
-    const p = new Promise((resolve) => self["__bx_openResolve"] = resolve);
+    const p = new Promise((resolve) => (self["__bx_openResolve"] = resolve));
     await callBinding(self["__bx_open"], { url });
 
     let win = null;
@@ -177,7 +217,7 @@ export async function openWindow(url) {
   return window.open(url);
 }
 
-export function _setLogFunc(func) {
+export function _setLogFunc(func: (...args: unknown[]) => void | undefined) {
   _logFunc = func;
 }
 
@@ -192,14 +232,14 @@ export function installBehaviors(obj) {
 // ===========================================================================
 export class RestoreState {
   matchValue: string;
-  constructor(childMatchSelect, child) {
+  constructor(childMatchSelect: string, child: Node) {
     this.matchValue = xpathString(childMatchSelect, child);
   }
 
-  async restore(rootPath, childMatch) {
+  async restore(rootPath: string, childMatch: string) {
     let root = null;
 
-    while (root = xpathNode(rootPath), !root) {
+    while (((root = xpathNode(rootPath)), !root)) {
       await sleep(100);
     }
 
@@ -210,7 +250,7 @@ export class RestoreState {
 // ===========================================================================
 export class HistoryState {
   loc: string;
-  constructor(op) {
+  constructor(op: () => void) {
     this.loc = window.location.href;
     op();
   }
@@ -219,17 +259,21 @@ export class HistoryState {
     return window.location.href !== this.loc;
   }
 
-  async goBack(backButtonQuery) {
+  async goBack(backButtonQuery: string) {
     if (!this.changed) {
       return Promise.resolve(true);
     }
 
-    const backButton = xpathNode(backButtonQuery);
+    const backButton = xpathNode(backButtonQuery) as HTMLElement | null;
 
     return new Promise((resolve) => {
-      window.addEventListener("popstate", () => {
-        resolve(null);
-      }, { once: true });
+      window.addEventListener(
+        "popstate",
+        () => {
+          resolve(null);
+        },
+        { once: true },
+      );
 
       if (backButton) {
         backButton["click"]();
@@ -241,26 +285,41 @@ export class HistoryState {
 }
 
 // ===========================================================================
-export function xpathNode(path, root?) {
+export function xpathNode(path: string, root?: Node | null) {
   root = root || document;
-  return document.evaluate(path, root, null, XPathResult.FIRST_ORDERED_NODE_TYPE).singleNodeValue;
+  return document.evaluate(
+    path,
+    root,
+    null,
+    XPathResult.FIRST_ORDERED_NODE_TYPE,
+  ).singleNodeValue;
 }
 
-export function* xpathNodes(path, root) {
+export function* xpathNodes(path: string, root?: Node) {
   root = root || document;
-  const iter = document.evaluate(path, root, null, XPathResult.ORDERED_NODE_ITERATOR_TYPE);
+  const iter = document.evaluate(
+    path,
+    root,
+    null,
+    XPathResult.ORDERED_NODE_ITERATOR_TYPE,
+  );
   let result = null;
   while ((result = iter.iterateNext()) !== null) {
     yield result;
   }
 }
 
-export function xpathString(path, root) {
+export function xpathString(path: string, root?: Node | null) {
   root = root || document;
-  return document.evaluate(path, root, null, XPathResult.STRING_TYPE).stringValue;
+  return document.evaluate(path, root, null, XPathResult.STRING_TYPE)
+    .stringValue;
 }
 
-export async function* iterChildElem(root, timeout, totalTimeout) {
+export async function* iterChildElem(
+  root: Element,
+  timeout: number,
+  totalTimeout: number,
+) {
   let child = root.firstElementChild;
 
   while (child) {
@@ -268,8 +327,8 @@ export async function* iterChildElem(root, timeout, totalTimeout) {
 
     if (!child.nextElementSibling) {
       await Promise.race([
-        waitUntil(() => !!child.nextElementSibling, timeout),
-        sleep(totalTimeout)
+        waitUntil(() => !!child?.nextElementSibling, timeout),
+        sleep(totalTimeout),
       ]);
     }
 
@@ -278,59 +337,76 @@ export async function* iterChildElem(root, timeout, totalTimeout) {
 }
 
 export async function* iterChildMatches(
-  path, root, interval = waitUnit, timeout = 5000
+  path: string,
+  root: Node,
+  interval = waitUnit,
+  timeout = 5000,
 ) {
   let node = xpathNode(`.//${path}`, root);
-  const getMatch = (node) => xpathNode(`./following-sibling::${path}`, node);
+  const getMatch = (node: Node | null) =>
+    xpathNode(`./following-sibling::${path}`, node);
   while (node) {
     yield node;
     let next = getMatch(node);
-    if (next) { node = next; continue; }
+    if (next) {
+      node = next;
+      continue;
+    }
     await Promise.race([
       waitUntil(() => {
         next = getMatch(node);
         return next;
       }, interval),
-      sleep(timeout)
+      sleep(timeout),
     ]);
     node = next;
   }
 }
 
 // ===========================================================================
-export function isInViewport(elem) {
+export function isInViewport(elem: Element) {
   const bounding = elem.getBoundingClientRect();
   return (
     bounding.top >= 0 &&
     bounding.left >= 0 &&
-    bounding.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
-    bounding.right <= (window.innerWidth || document.documentElement.clientWidth)
+    bounding.bottom <=
+      (window.innerHeight || document.documentElement.clientHeight) &&
+    bounding.right <=
+      (window.innerWidth || document.documentElement.clientWidth)
   );
 }
 
-export function scrollToOffset(element, offset = 0) {
+export function scrollToOffset(element: Element, offset = 0) {
   const elPosition = element.getBoundingClientRect().top;
   const topPosition = elPosition + window.pageYOffset - offset;
   window.scrollTo({ top: topPosition, behavior: "smooth" });
 }
 
-export function scrollIntoView(element, opts = {
-  behavior: "smooth", block: "center", inline: "center"
-}) {
+export function scrollIntoView(
+  element: Element,
+  opts: ScrollIntoViewOptions = {
+    behavior: "smooth",
+    block: "center",
+    inline: "center",
+  },
+) {
   element.scrollIntoView(opts);
 }
 
-export function getState(ctx: any, msg: string, incrValue?: string) {
-  if (typeof(ctx.state) === "undefined") {
+export function getState<
+  StateContext extends Context<{ [K in IncrValue]: number }>,
+  const IncrValue extends string,
+>(ctx: StateContext, msg: string, incrValue?: IncrValue) {
+  if (typeof ctx.state === "undefined") {
     ctx.state = {};
   }
   if (incrValue) {
     if (ctx.state[incrValue] === undefined) {
-      ctx.state[incrValue] = 1;
+      (ctx.state as unknown as { [K in IncrValue]: number })[incrValue] = 1;
     } else {
       ctx.state[incrValue]++;
     }
   }
 
-  return { state: ctx.state, msg };
+  return { state: ctx.state as StateContext["state"], msg };
 }
diff --git a/src/site/facebook.ts b/src/site/facebook.ts
index 2a6d720..42f280c 100644
--- a/src/site/facebook.ts
+++ b/src/site/facebook.ts
@@ -1,24 +1,34 @@
 const Q = {
   feed: "//div[@role='feed']",
   article: ".//div[@role='article']",
-  pageletPostList: "//div[@data-pagelet='page']/div[@role='main']//div[@role='main']/div",
-  pageletProfilePostList: "//div[@data-pagelet='page']//div[@data-pagelet='ProfileTimeline']",
+  pageletPostList:
+    "//div[@data-pagelet='page']/div[@role='main']//div[@role='main']/div",
+  pageletProfilePostList:
+    "//div[@data-pagelet='page']//div[@data-pagelet='ProfileTimeline']",
   articleToPostList: "//div[@role='article']/../../../../div",
   photosOrVideos: `.//a[(contains(@href, '/photos/') or contains(@href, '/photo/?') or contains(@href, '/videos/')) and (starts-with(@href, '${window.location.origin}/') or starts-with(@href, '/'))]`,
   postQuery: ".//a[contains(@href, '/posts/')]",
   extraLabel: "//*[starts-with(text(), '+')]",
-  nextSlideQuery: "//div[@data-name='media-viewer-nav-container']/div[@data-visualcompletion][2]//div[@role='button']",
-  nextSlide: "//div[@aria-hidden='false']//div[@role='button' and not(@aria-hidden) and @aria-label]",
+  nextSlideQuery:
+    "//div[@data-name='media-viewer-nav-container']/div[@data-visualcompletion][2]//div[@role='button']",
+  nextSlide:
+    "//div[@aria-hidden='false']//div[@role='button' and not(@aria-hidden) and @aria-label]",
   commentList: ".//ul[(../h3) or (../h4)]",
   commentMoreReplies: "./div[2]/div[1]/div[2]/div[@role='button']",
-  commentMoreComments: "./following-sibling::div/div/div[2][@role='button'][./span/span]",
+  commentMoreComments:
+    "./following-sibling::div/div/div[2][@role='button'][./span/span]",
   viewComments: ".//h4/..//div[@role='button']",
   photoCommentList: "//ul[../h2]",
-  firstPhotoThumbnail: "//div[@role='main']//div[3]//div[contains(@style, 'border-radius')]//div[contains(@style, 'max-width') and contains(@style, 'min-width')]//a[@role='link']",
-  firstVideoThumbnail: "//div[@role='main']//div[contains(@style, 'z-index')]/following-sibling::div/div/div/div[last()]//a[contains(@href, '/videos/') and @aria-hidden!='true']",
-  firstVideoSimple: "//div[@role='main']//a[contains(@href, '/videos/') and @aria-hidden!='true']",
-  mainVideo: "//div[@data-pagelet='root']//div[@role='dialog']//div[@role='main']//video",
-  nextVideo: "following::a[contains(@href, '/videos/') and @aria-hidden!='true']",
+  firstPhotoThumbnail:
+    "//div[@role='main']//div[3]//div[contains(@style, 'border-radius')]//div[contains(@style, 'max-width') and contains(@style, 'min-width')]//a[@role='link']",
+  firstVideoThumbnail:
+    "//div[@role='main']//div[contains(@style, 'z-index')]/following-sibling::div/div/div/div[last()]//a[contains(@href, '/videos/') and @aria-hidden!='true']",
+  firstVideoSimple:
+    "//div[@role='main']//a[contains(@href, '/videos/') and @aria-hidden!='true']",
+  mainVideo:
+    "//div[@data-pagelet='root']//div[@role='dialog']//div[@role='main']//video",
+  nextVideo:
+    "following::a[contains(@href, '/videos/') and @aria-hidden!='true']",
   isPhotoVideoPage: /^.*facebook\.com\/[^/]+\/(photos|videos)\/.+/,
   isPhotosPage: /^.*facebook\.com\/[^/]+\/photos\/?($|\?)/,
   isVideosPage: /^.*facebook\.com\/[^/]+\/videos\/?($|\?)/,
@@ -38,7 +48,7 @@ export class FacebookTimelineBehavior {
 
   static init() {
     return {
-      state: {}
+      state: {},
     };
   }
 
@@ -48,12 +58,17 @@ export class FacebookTimelineBehavior {
     this.allowNewWindow = false;
   }
 
-  async* iterPostFeeds(ctx) {
-    const { iterChildElem, waitUnit, waitUntil, xpathNode, xpathNodes } = ctx.Lib;
+  async *iterPostFeeds(ctx) {
+    const { iterChildElem, waitUnit, waitUntil, xpathNode, xpathNodes } =
+      ctx.Lib;
     const feeds = Array.from(xpathNodes(Q.feed));
     if (feeds && feeds.length) {
       for (const feed of feeds) {
-        for await (const post of iterChildElem(feed, waitUnit, waitUntil * 10)) {
+        for await (const post of iterChildElem(
+          feed,
+          waitUnit,
+          waitUntil * 10,
+        )) {
           yield* this.viewPost(ctx, xpathNode(Q.article, post));
         }
       }
@@ -77,7 +92,7 @@ export class FacebookTimelineBehavior {
     }
   }
 
-  async* viewPost(ctx, post, maxExpands = 2) {
+  async *viewPost(ctx, post, maxExpands = 2) {
     const { getState, scrollIntoView, sleep, waitUnit, xpathNode } = ctx.Lib;
     if (!post) {
       return;
@@ -119,7 +134,7 @@ export class FacebookTimelineBehavior {
     await sleep(waitUnit * 5);
   }
 
-  async* viewPhotosOrVideos(ctx, post) {
+  async *viewPhotosOrVideos(ctx, post) {
     const { getState, sleep, waitUnit, xpathNode, xpathNodes } = ctx.Lib;
     const objects: any[] = Array.from(xpathNodes(Q.photosOrVideos, post));
 
@@ -170,7 +185,7 @@ export class FacebookTimelineBehavior {
     }
   }
 
-  async* viewExtraObjects(ctx, obj, type, openNew) {
+  async *viewExtraObjects(ctx, obj, type, openNew) {
     const { getState, sleep, waitUnit, waitUntil, xpathNode } = ctx.Lib;
     const extraLabel = xpathNode(Q.extraLabel, obj);
 
@@ -215,7 +230,7 @@ export class FacebookTimelineBehavior {
     }
   }
 
-  async* iterComments(ctx, commentRootUL, maxExpands = 2) {
+  async *iterComments(ctx, commentRootUL, maxExpands = 2) {
     const { getState, scrollIntoView, sleep, waitUnit, xpathNode } = ctx.Lib;
     if (!commentRootUL) {
       await sleep(waitUnit * 5);
@@ -262,8 +277,9 @@ export class FacebookTimelineBehavior {
     await sleep(waitUnit * 2);
   }
 
-  async* iterPhotoSlideShow(ctx) {
-    const { getState, scrollIntoView, sleep, waitUnit, waitUntil, xpathNode } = ctx.Lib;
+  async *iterPhotoSlideShow(ctx) {
+    const { getState, scrollIntoView, sleep, waitUnit, waitUntil, xpathNode } =
+      ctx.Lib;
     const firstPhoto = xpathNode(Q.firstPhotoThumbnail);
 
     if (!firstPhoto) {
@@ -289,7 +305,7 @@ export class FacebookTimelineBehavior {
 
       await Promise.race([
         waitUntil(() => window.location.href !== lastHref, waitUnit * 2),
-        sleep(3000)
+        sleep(3000),
       ]);
 
       if (window.location.href === lastHref) {
@@ -305,15 +321,24 @@ export class FacebookTimelineBehavior {
     }
   }
 
-  async* iterAllVideos(ctx) {
-    const { getState, scrollIntoView, sleep, waitUnit, waitUntil, xpathNode, xpathNodes } = ctx.Lib;
+  async *iterAllVideos(ctx) {
+    const {
+      getState,
+      scrollIntoView,
+      sleep,
+      waitUnit,
+      waitUntil,
+      xpathNode,
+      xpathNodes,
+    } = ctx.Lib;
     const firstInlineVideo = xpathNode("//video");
     if (firstInlineVideo) {
       scrollIntoView(firstInlineVideo);
       await sleep(waitUnit * 5);
     }
 
-    let videoLink = xpathNode(Q.firstVideoThumbnail) || xpathNode(Q.firstVideoSimple);
+    let videoLink =
+      xpathNode(Q.firstVideoThumbnail) || xpathNode(Q.firstVideoSimple);
 
     if (!videoLink) {
       return;
@@ -340,7 +365,8 @@ export class FacebookTimelineBehavior {
           }
           return false;
         }, waitUnit * 2),
-        sleep(20000)]);
+        sleep(20000),
+      ]);
 
       await sleep(waitUnit * 10);
 
@@ -358,32 +384,32 @@ export class FacebookTimelineBehavior {
     }
   }
 
-  async* run(ctx) {
+  async *run(ctx) {
     const { getState, sleep, xpathNode } = ctx.Lib;
     yield getState(ctx, "Starting...");
 
     await sleep(2000);
 
     if (Q.isPhotosPage.exec(window.location.href)) {
-      ctx.state = { "photos": 0, "comments": 0 };
+      ctx.state = { photos: 0, comments: 0 };
       yield* this.iterPhotoSlideShow(ctx);
       return;
     }
 
     if (Q.isVideosPage.exec(window.location.href)) {
-      ctx.state = { "videos": 0, "comments": 0 };
+      ctx.state = { videos: 0, comments: 0 };
       yield* this.iterAllVideos(ctx);
       return;
     }
 
     if (Q.isPhotoVideoPage.exec(window.location.href)) {
-      ctx.state = { "comments": 0 };
+      ctx.state = { comments: 0 };
       const root = xpathNode(Q.photoCommentList);
       yield* this.iterComments(ctx, root, 1000);
       return;
     }
 
-    ctx.state = { "posts": 0, "comments": 0, "videos": 0 };
+    ctx.state = { posts: 0, comments: 0, videos: 0 };
     yield* this.iterPostFeeds(ctx);
   }
 }
diff --git a/src/site/index.ts b/src/site/index.ts
index 93a8d99..2629ea9 100644
--- a/src/site/index.ts
+++ b/src/site/index.ts
@@ -10,7 +10,7 @@ const siteBehaviors = [
   FacebookTimelineBehavior,
   TelegramBehavior,
   TikTokVideoBehavior,
-  TikTokProfileBehavior
-];
+  TikTokProfileBehavior,
+] as const;
 
 export default siteBehaviors;
diff --git a/src/site/instagram.ts b/src/site/instagram.ts
index 678a281..b6e0f28 100644
--- a/src/site/instagram.ts
+++ b/src/site/instagram.ts
@@ -1,4 +1,7 @@
-const subpostNextOnlyChevron = "//article[@role='presentation']//div[@role='presentation']/following-sibling::button";
+import { Behavior, type Context } from "../behavior";
+
+const subpostNextOnlyChevron =
+  "//article[@role='presentation']//div[@role='presentation']/following-sibling::button";
 
 const Q = {
   rootPath: "//main/div/div[2]/div",
@@ -10,20 +13,30 @@ const Q = {
   postLoading: "//*[@aria-label='Loading...']",
   subpostNextOnlyChevron,
   subpostPrevNextChevron: subpostNextOnlyChevron + "[2]",
-  commentRoot: "//article[@role='presentation']/div[1]/div[2]//ul/div[last()]/div/div",
+  commentRoot:
+    "//article[@role='presentation']/div[1]/div[2]//ul/div[last()]/div/div",
   viewReplies: "ul/li//button[span[not(count(*)) and contains(text(), '(')]]",
   loadMore: "//button[span[@aria-label]]",
-  pageLoadWaitUntil: "//main"
+  pageLoadWaitUntil: "//main",
+};
+
+type State = {
+  posts: number;
+  slides: number;
+  rows: number;
+  comments: number;
 };
 
-export class InstagramPostsBehavior {
+export class InstagramPostsBehavior extends Behavior<State> {
   maxCommentsTime: number;
   postOnlyWindow: any;
 
   static id = "Instagram";
 
   static isMatch() {
-    return !!window.location.href.match(/https:\/\/(www\.)?instagram\.com\/\w[\w.-]+/);
+    return !!window.location.href.match(
+      /https:\/\/(www\.)?instagram\.com\/\w[\w.-]+/,
+    );
   }
 
   static init() {
@@ -33,11 +46,12 @@ export class InstagramPostsBehavior {
         slides: 0,
         rows: 0,
         comments: 0,
-      }
+      },
     };
   }
 
   constructor() {
+    super();
     this.maxCommentsTime = 10000;
     // extra window for first post, if allowed
     this.postOnlyWindow = null;
@@ -50,7 +64,7 @@ export class InstagramPostsBehavior {
     }
   }
 
-  async waitForNext(ctx, child) {
+  async waitForNext(ctx: Context<State>, child: Element | null) {
     if (!child) {
       return null;
     }
@@ -64,9 +78,9 @@ export class InstagramPostsBehavior {
     return child.nextElementSibling;
   }
 
-  async* iterRow(ctx) {
+  async *iterRow(ctx: Context<State>) {
     const { RestoreState, sleep, waitUnit, xpathNode } = ctx.Lib;
-    const root = xpathNode(Q.rootPath);
+    const root = xpathNode(Q.rootPath) as Element | null;
 
     if (!root) {
       return;
@@ -86,45 +100,61 @@ export class InstagramPostsBehavior {
       if (restorer.matchValue) {
         yield child;
 
-        child = await restorer.restore(Q.rootPath, Q.childMatch);
+        child = (await restorer.restore(
+          Q.rootPath,
+          Q.childMatch,
+        )) as Element | null;
       }
 
       child = await this.waitForNext(ctx, child);
     }
   }
 
-  async* viewStandalonePost(ctx, origLoc) {
-    const { getState, sleep, waitUnit, waitUntil, xpathNode, xpathString } = ctx.Lib;
-    const root = xpathNode(Q.rootPath);
+  async *viewStandalonePost(ctx: Context<State>, origLoc: string | URL) {
+    const { getState, sleep, waitUnit, waitUntil, xpathNode, xpathString } =
+      ctx.Lib;
+    const root = xpathNode(Q.rootPath) as Element | null;
 
     if (!root?.firstElementChild) {
       return;
     }
 
-    const firstPostHref = xpathString(Q.childMatchSelect, root.firstElementChild);
+    const firstPostHref = xpathString(
+      Q.childMatchSelect,
+      root.firstElementChild,
+    );
 
-    yield getState(ctx, "Loading single post view for first post: " + firstPostHref);
+    yield getState(
+      ctx,
+      "Loading single post view for first post: " + firstPostHref,
+    );
 
     window.history.replaceState({}, "", firstPostHref);
     window.dispatchEvent(new PopStateEvent("popstate", { state: {} }));
 
-    let root2 = null;
-    let root3 = null;
+    let root2: Node | null = null;
+    let root3: Node | null = null;
 
     await sleep(waitUnit * 5);
 
-    await waitUntil(() => (root2 = xpathNode(Q.rootPath)) !== root && root2, waitUnit * 5);
+    await waitUntil(
+      () => (root2 = xpathNode(Q.rootPath)) !== root && root2,
+      waitUnit * 5,
+    );
 
     await sleep(waitUnit * 5);
 
     window.history.replaceState({}, "", origLoc);
     window.dispatchEvent(new PopStateEvent("popstate", { state: {} }));
 
-    await waitUntil(() => (root3 = xpathNode(Q.rootPath)) !== root2 && root3, waitUnit * 5);
+    await waitUntil(
+      () => (root3 = xpathNode(Q.rootPath)) !== root2 && root3,
+      waitUnit * 5,
+    );
     //}
   }
 
-  async *iterSubposts(ctx) {
+  async *iterSubposts(ctx: Context<State>) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
     let next = xpathNode(Q.subpostNextOnlyChevron);
 
@@ -134,7 +164,11 @@ export class InstagramPostsBehavior {
       next.click();
       await sleep(waitUnit * 5);
 
-      yield getState(ctx, `Loading Slide ${++count} for ${window.location.href}`, "slides");
+      yield getState(
+        ctx,
+        `Loading Slide ${++count} for ${window.location.href}`,
+        "slides",
+      );
 
       next = xpathNode(Q.subpostPrevNextChevron);
     }
@@ -142,9 +176,9 @@ export class InstagramPostsBehavior {
     await sleep(waitUnit * 5);
   }
 
-  async iterComments(ctx) {
+  async iterComments(ctx: Context<State>) {
     const { scrollIntoView, sleep, waitUnit, waitUntil, xpathNode } = ctx.Lib;
-    const root = xpathNode(Q.commentRoot);
+    const root = xpathNode(Q.commentRoot) as Element | null;
 
     if (!root) {
       return;
@@ -154,8 +188,8 @@ export class InstagramPostsBehavior {
 
     let commentsLoaded = false;
 
-    const getViewRepliesButton = (child) => {
-      return xpathNode(Q.viewReplies, child);
+    const getViewRepliesButton = (child: Node | null) => {
+      return xpathNode(Q.viewReplies, child) as HTMLElement | null;
     };
 
     while (child) {
@@ -168,19 +202,26 @@ export class InstagramPostsBehavior {
       while (viewReplies) {
         const orig = viewReplies.textContent;
         viewReplies.click();
-        ctx.state.comments++;
+        ctx.state!.comments!++;
         await sleep(waitUnit * 2.5);
 
-        await waitUntil(() => orig !== viewReplies.textContent, waitUnit);
+        await waitUntil(() => orig !== viewReplies!.textContent, waitUnit);
 
         viewReplies = getViewRepliesButton(child);
       }
 
-      if (child.nextElementSibling && child.nextElementSibling.tagName === "LI" && !child.nextElementSibling.nextElementSibling) {
-        const loadMore = xpathNode(Q.loadMore, child.nextElementSibling);
+      if (
+        child.nextElementSibling &&
+        child.nextElementSibling.tagName === "LI" &&
+        !child.nextElementSibling.nextElementSibling
+      ) {
+        const loadMore = xpathNode(
+          Q.loadMore,
+          child.nextElementSibling,
+        ) as HTMLElement | null;
         if (loadMore) {
           loadMore.click();
-          ctx.state.comments++;
+          ctx.state!.comments!++;
           await sleep(waitUnit * 5);
         }
       }
@@ -192,7 +233,7 @@ export class InstagramPostsBehavior {
     return commentsLoaded;
   }
 
-  async* iterPosts(ctx, next) {
+  async *iterPosts(ctx: Context<State>, next: HTMLElement | null) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
     let count = 0;
 
@@ -208,12 +249,9 @@ export class InstagramPostsBehavior {
 
       yield getState(ctx, "Loaded Comments", "comments");
 
-      await Promise.race([
-        this.iterComments(ctx),
-        sleep(this.maxCommentsTime)
-      ]);
+      await Promise.race([this.iterComments(ctx), sleep(this.maxCommentsTime)]);
 
-      next = xpathNode(Q.nextPost);
+      next = xpathNode(Q.nextPost) as HTMLElement | null;
 
       while (!next && xpathNode(Q.postLoading)) {
         await sleep(waitUnit * 2.5);
@@ -223,7 +261,7 @@ export class InstagramPostsBehavior {
     await sleep(waitUnit * 5);
   }
 
-  async* run(ctx) {
+  async *run(ctx: Context<State>) {
     const { getState, scrollIntoView, sleep, waitUnit, xpathNode } = ctx.Lib;
     //const origLoc = window.location.href;
 
@@ -236,11 +274,11 @@ export class InstagramPostsBehavior {
 
       yield getState(ctx, "Loading Row", "rows");
 
-      const first = xpathNode(Q.firstPostInRow, row);
+      const first = xpathNode(Q.firstPostInRow, row) as HTMLElement | null;
 
       yield* this.iterPosts(ctx, first);
 
-      const close = xpathNode(Q.postCloseButton);
+      const close = xpathNode(Q.postCloseButton) as HTMLElement | null;
       if (close) {
         close.click();
       }
@@ -249,7 +287,7 @@ export class InstagramPostsBehavior {
     }
   }
 
-  async awaitPageLoad(ctx: any) {
+  async awaitPageLoad(ctx: Context<State>) {
     const { Lib, log } = ctx;
     const { waitUntilNode } = Lib;
 
diff --git a/src/site/telegram.ts b/src/site/telegram.ts
index de7a9be..608b8d7 100644
--- a/src/site/telegram.ts
+++ b/src/site/telegram.ts
@@ -1,7 +1,9 @@
 const Q = {
-  telegramContainer: "//main//section[@class='tgme_channel_history js-message_history']",
+  telegramContainer:
+    "//main//section[@class='tgme_channel_history js-message_history']",
   postId: "string(./div[@data-post]/@data-post)",
-  linkExternal: "string(.//a[@class='tgme_widget_message_link_preview' and @href]/@href)",
+  linkExternal:
+    "string(.//a[@class='tgme_widget_message_link_preview' and @href]/@href)",
 };
 
 export class TelegramBehavior {
@@ -13,7 +15,7 @@ export class TelegramBehavior {
 
   static init() {
     return {
-      state: { messages: 0 }
+      state: { messages: 0 },
     };
   }
 
@@ -31,8 +33,15 @@ export class TelegramBehavior {
     return child.previousElementSibling;
   }
 
-  async* run(ctx) {
-    const { getState, scrollIntoView, sleep, waitUnit, xpathNode, xpathString } = ctx.Lib;
+  async *run(ctx) {
+    const {
+      getState,
+      scrollIntoView,
+      sleep,
+      waitUnit,
+      xpathNode,
+      xpathString,
+    } = ctx.Lib;
     const root = xpathNode(Q.telegramContainer);
 
     if (!root) {
diff --git a/src/site/tiktok.ts b/src/site/tiktok.ts
index 17fff73..bd03b21 100644
--- a/src/site/tiktok.ts
+++ b/src/site/tiktok.ts
@@ -2,10 +2,11 @@ const Q = {
   commentList: "//div[contains(@class, 'CommentListContainer')]",
   commentItem: "div[contains(@class, 'CommentItemContainer')]",
   viewMoreReplies: ".//p[contains(@class, 'ReplyActionText')]",
-  viewMoreThread: ".//p[starts-with(@data-e2e, 'view-more') and string-length(text()) > 0]",
+  viewMoreThread:
+    ".//p[starts-with(@data-e2e, 'view-more') and string-length(text()) > 0]",
   profileVideoList: "//div[starts-with(@data-e2e, 'user-post-item-list')]",
   profileVideoItem: "div[contains(@class, 'DivItemContainerV2')]",
-  backButton: "button[contains(@class, 'StyledCloseIconContainer')]"
+  backButton: "button[contains(@class, 'StyledCloseIconContainer')]",
 };
 
 export const BREADTH_ALL = Symbol("BREADTH_ALL");
@@ -16,7 +17,7 @@ export class TikTokVideoBehavior {
   static init() {
     return {
       state: { comments: 0 },
-      opts: { breadth: BREADTH_ALL }
+      opts: { breadth: BREADTH_ALL },
     };
   }
 
@@ -29,7 +30,7 @@ export class TikTokVideoBehavior {
     return breadth !== BREADTH_ALL && breadth <= iter;
   }
 
-  async* crawlThread(ctx, parentNode, prev = null, iter = 0) {
+  async *crawlThread(ctx, parentNode, prev = null, iter = 0) {
     const { waitUntilNode, scrollAndClick, getState } = ctx.Lib;
     const next = await waitUntilNode(Q.viewMoreThread, parentNode, prev);
     if (!next || this.breadthComplete(ctx, iter)) return;
@@ -38,7 +39,7 @@ export class TikTokVideoBehavior {
     yield* this.crawlThread(ctx, parentNode, next, iter + 1);
   }
 
-  async* expandThread(ctx, item) {
+  async *expandThread(ctx, item) {
     const { xpathNode, scrollAndClick, getState } = ctx.Lib;
     const viewMore = xpathNode(Q.viewMoreReplies, item);
     if (!viewMore) return;
@@ -47,7 +48,7 @@ export class TikTokVideoBehavior {
     yield* this.crawlThread(ctx, item, null, 1);
   }
 
-  async* run(ctx) {
+  async *run(ctx) {
     const { xpathNode, iterChildMatches, scrollIntoView, getState } = ctx.Lib;
     const commentList = xpathNode(Q.commentList);
     const commentItems = iterChildMatches(Q.commentItem, commentList);
@@ -65,18 +66,19 @@ export class TikTokProfileBehavior {
   static id = "TikTokProfile";
 
   static isMatch() {
-    const pathRegex = /https:\/\/(www\.)?tiktok\.com\/@[a-zA-Z0-9]+(\/?$|\/\?.*)/;
+    const pathRegex =
+      /https:\/\/(www\.)?tiktok\.com\/@[a-zA-Z0-9]+(\/?$|\/\?.*)/;
     return !!window.location.href.match(pathRegex);
   }
 
   static init() {
     return {
       state: { videos: 0, comments: 0 },
-      opts: { breadth: BREADTH_ALL }
+      opts: { breadth: BREADTH_ALL },
     };
   }
 
-  async* openVideo(ctx, item) {
+  async *openVideo(ctx, item) {
     const { HistoryState, xpathNode, sleep } = ctx.Lib;
     const link = xpathNode(".//a", item);
     if (!link) return;
@@ -90,10 +92,14 @@ export class TikTokProfileBehavior {
     }
   }
 
-  async* run(ctx) {
-    const { xpathNode, iterChildMatches, scrollIntoView, getState, sleep } = ctx.Lib;
+  async *run(ctx) {
+    const { xpathNode, iterChildMatches, scrollIntoView, getState, sleep } =
+      ctx.Lib;
     const profileVideoList = xpathNode(Q.profileVideoList);
-    const profileVideos = iterChildMatches(Q.profileVideoItem, profileVideoList);
+    const profileVideos = iterChildMatches(
+      Q.profileVideoItem,
+      profileVideoList,
+    );
     for await (const item of profileVideos) {
       scrollIntoView(item);
       yield getState(ctx, "View video", "videos");
diff --git a/src/site/twitter.ts b/src/site/twitter.ts
index 7ee748f..78f7f42 100644
--- a/src/site/twitter.ts
+++ b/src/site/twitter.ts
@@ -1,23 +1,40 @@
+import { type Context } from "../behavior";
+import { Behavior } from "../behavior";
+
 const Q = {
-  rootPath: "//h1[@role='heading' and @aria-level='1']/following-sibling::div[@aria-label]//div[@style]",
+  rootPath:
+    "//h1[@role='heading' and @aria-level='1']/following-sibling::div[@aria-label]//div[@style]",
   anchor: ".//article",
-  childMatchSelect: "string(.//article//a[starts-with(@href, '/') and @aria-label]/@href)",
+  childMatchSelect:
+    "string(.//article//a[starts-with(@href, '/') and @aria-label]/@href)",
   childMatch: "child::div[.//a[@href='$1']]",
-  expand: ".//div[@role='button' and not(@aria-haspopup) and not(@data-testid)]",
+  expand:
+    ".//div[@role='button' and not(@aria-haspopup) and not(@data-testid)]",
   quote: ".//div[@role='blockquote' and @aria-haspopup='false']",
-  image: ".//a[@role='link' and starts-with(@href, '/') and contains(@href, '/photo/')]",
-  imageFirstNext: "//div[@aria-roledescription='carousel']/div[2]/div[1]//div[@role='button']",
-  imageNext: "//div[@aria-roledescription='carousel']/div[2]/div[2]//div[@role='button']",
+  image:
+    ".//a[@role='link' and starts-with(@href, '/') and contains(@href, '/photo/')]",
+  imageFirstNext:
+    "//div[@aria-roledescription='carousel']/div[2]/div[1]//div[@role='button']",
+  imageNext:
+    "//div[@aria-roledescription='carousel']/div[2]/div[2]//div[@role='button']",
   imageClose: "//div[@role='presentation']/div[@role='button' and @aria-label]",
   backButton: "//div[@data-testid='titleContainer']//div[@role='button']",
-  viewSensitive: ".//a[@href='/settings/content_you_see']/parent::div/parent::div/parent::div//div[@role='button']",
+  viewSensitive:
+    ".//a[@href='/settings/content_you_see']/parent::div/parent::div/parent::div//div[@role='button']",
   progress: ".//*[@role='progressbar']",
   promoted: ".//div[data-testid='placementTracking']",
 };
 
-export class TwitterTimelineBehavior {
-  seenTweets: Set<any>;
-  seenMediaTweets: Set<any>;
+type State = {
+  tweets: number;
+  images: number;
+  videos: number;
+  threads: number;
+};
+
+export class TwitterTimelineBehavior extends Behavior<State> {
+  seenTweets: Set<string>;
+  seenMediaTweets: Set<string>;
 
   static id = "Twitter";
 
@@ -30,22 +47,23 @@ export class TwitterTimelineBehavior {
       state: {
         tweets: 0,
         images: 0,
-        videos: 0
+        videos: 0,
       },
       opts: {
-        maxDepth: 0
-      }
+        maxDepth: 0,
+      },
     };
   }
 
   constructor() {
+    super();
     this.seenTweets = new Set();
     this.seenMediaTweets = new Set();
   }
 
-  showingProgressBar(ctx, root) {
+  showingProgressBar(ctx: Context<State>, root: Node) {
     const { xpathNode } = ctx.Lib;
-    const node = xpathNode(Q.progress, root);
+    const node = xpathNode(Q.progress, root) as Element | null;
     if (!node) {
       return false;
     }
@@ -53,7 +71,7 @@ export class TwitterTimelineBehavior {
     return node.clientHeight > 10;
   }
 
-  async waitForNext(ctx, child) {
+  async waitForNext(ctx: Context<State>, child: Element | null) {
     const { sleep, waitUnit } = ctx.Lib;
     if (!child) {
       return null;
@@ -72,26 +90,27 @@ export class TwitterTimelineBehavior {
     return child.nextElementSibling;
   }
 
-  async expandMore(ctx, child) {
+  async expandMore(ctx: Context<State>, child: Element | null) {
     const { sleep, waitUnit, xpathNode } = ctx.Lib;
-    const expandElem = xpathNode(Q.expand, child);
+    const expandElem = xpathNode(Q.expand, child) as HTMLElement | null;
     if (!expandElem) {
       return child;
     }
 
-    const prev = child.previousElementSibling;
+    const prev = child?.previousElementSibling;
     expandElem.click();
     await sleep(waitUnit);
-    while (this.showingProgressBar(ctx, prev.nextElementSibling)) {
+    while (this.showingProgressBar(ctx, prev?.nextElementSibling as Node)) {
       await sleep(waitUnit);
     }
-    child = prev.nextElementSibling;
+    child = prev?.nextElementSibling ?? null;
     return child;
   }
 
-  async* infScroll(ctx) {
-    const { scrollIntoView, RestoreState, sleep, waitUnit, xpathNode } = ctx.Lib;
-    const root = xpathNode(Q.rootPath);
+  async *infScroll(ctx: Context<State>) {
+    const { scrollIntoView, RestoreState, sleep, waitUnit, xpathNode } =
+      ctx.Lib;
+    const root = xpathNode(Q.rootPath) as Element | null;
 
     if (!root) {
       return;
@@ -111,8 +130,8 @@ export class TwitterTimelineBehavior {
         anchorElem = xpathNode(Q.anchor, child);
       }
 
-      if (child?.innerText) {
-        scrollIntoView(child);
+      if ((child as HTMLElement).innerText) {
+        scrollIntoView(child!);
       }
 
       if (child && anchorElem) {
@@ -123,7 +142,10 @@ export class TwitterTimelineBehavior {
         yield anchorElem;
 
         if (restorer.matchValue) {
-          child = await restorer.restore(Q.rootPath, Q.childMatch);
+          child = (await restorer.restore(
+            Q.rootPath,
+            Q.childMatch,
+          )) as Element | null;
         }
       }
 
@@ -131,9 +153,12 @@ export class TwitterTimelineBehavior {
     }
   }
 
-  async* mediaPlaying(ctx, tweet) {
+  async *mediaPlaying(ctx: Context<State>, tweet: Node) {
     const { getState, sleep, xpathNode, xpathString } = ctx.Lib;
-    const media = xpathNode("(.//video | .//audio)", tweet);
+    const media = xpathNode(
+      "(.//video | .//audio)",
+      tweet,
+    ) as HTMLMediaElement | null;
     if (!media || media.paused) {
       return;
     }
@@ -141,14 +166,21 @@ export class TwitterTimelineBehavior {
     let mediaTweetUrl = null;
 
     try {
-      mediaTweetUrl = new URL(xpathString(Q.childMatchSelect, tweet.parentElement), window.location.origin).href;
+      mediaTweetUrl = new URL(
+        xpathString(Q.childMatchSelect, tweet.parentElement),
+        window.location.origin,
+      ).href;
     } catch (e) {
       console.warn(e);
     }
 
     // no need to wait for mp4s, should be loaded fully automatically
     if (media.src.startsWith("https://") && media.src.indexOf(".mp4") > 0) {
-      yield getState(ctx, `Loading video for ${mediaTweetUrl || "unknown"}`, "videos");
+      yield getState(
+        ctx,
+        `Loading video for ${mediaTweetUrl || "unknown"}`,
+        "videos",
+      );
       return;
     }
 
@@ -177,9 +209,9 @@ export class TwitterTimelineBehavior {
     await Promise.race([p, sleep(60000)]);
   }
 
-  async* clickImages(ctx, tweet) {
+  async *clickImages(ctx: Context<State>, tweet: HTMLElement) {
     const { getState, HistoryState, sleep, waitUnit, xpathNode } = ctx.Lib;
-    const imagePopup = xpathNode(Q.image, tweet);
+    const imagePopup = xpathNode(Q.image, tweet) as HTMLElement | null;
 
     if (imagePopup) {
       const imageState = new HistoryState(() => imagePopup.click());
@@ -188,7 +220,7 @@ export class TwitterTimelineBehavior {
 
       await sleep(waitUnit * 5);
 
-      let nextImage = xpathNode(Q.imageFirstNext);
+      let nextImage = xpathNode(Q.imageFirstNext) as HTMLElement | null;
       let prevLocation = window.location.href;
 
       while (nextImage) {
@@ -204,14 +236,18 @@ export class TwitterTimelineBehavior {
         yield getState(ctx, "Loading Image: " + window.location.href, "images");
         await sleep(waitUnit * 5);
 
-        nextImage = xpathNode(Q.imageNext);
+        nextImage = xpathNode(Q.imageNext) as HTMLElement | null;
       }
 
       await imageState.goBack(Q.imageClose);
     }
   }
 
-  async* clickTweet(ctx, tweet, depth) {
+  async *clickTweet(
+    ctx: Context<State>,
+    tweet: HTMLElement,
+    depth: number,
+  ): AsyncGenerator<{ state: Context<State>["state"]; msg: string }> {
     const { getState, HistoryState, sleep, waitUnit } = ctx.Lib;
     const tweetState = new HistoryState(() => tweet.click());
 
@@ -235,7 +271,7 @@ export class TwitterTimelineBehavior {
     }
   }
 
-  async* iterTimeline(ctx, depth = 0) {
+  async *iterTimeline(ctx: Context<State>, depth = 0) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
     if (this.seenTweets.has(window.location.href)) {
       return;
@@ -252,17 +288,20 @@ export class TwitterTimelineBehavior {
 
       await sleep(waitUnit * 2.5);
 
-      const viewButton = xpathNode(Q.viewSensitive, tweet);
+      const viewButton = xpathNode(
+        Q.viewSensitive,
+        tweet,
+      ) as HTMLElement | null;
       if (viewButton) {
         viewButton.click();
         await sleep(waitUnit * 2.5);
       }
 
       // process images
-      yield* this.clickImages(ctx, tweet);
+      yield* this.clickImages(ctx, tweet as HTMLElement);
 
       // process quoted tweet
-      const quoteTweet = xpathNode(Q.quote, tweet);
+      const quoteTweet = xpathNode(Q.quote, tweet) as HTMLElement | null;
 
       if (quoteTweet) {
         yield* this.clickTweet(ctx, quoteTweet, 1000);
@@ -272,14 +311,14 @@ export class TwitterTimelineBehavior {
       yield* this.mediaPlaying(ctx, tweet);
 
       // track location to see if click goes to new url
-      yield* this.clickTweet(ctx, tweet, depth);
+      yield* this.clickTweet(ctx, tweet as HTMLElement, depth);
 
       // wait before continuing
       await sleep(waitUnit * 5);
     }
   }
 
-  async* run(ctx) {
+  async *run(ctx: Context<State>) {
     yield* this.iterTimeline(ctx, 0);
   }
 }
diff --git a/tsconfig.json b/tsconfig.json
index 78e563a..9434ddf 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -4,24 +4,14 @@
     "moduleResolution": "node",
     "removeComments": true,
     "preserveConstEnums": true,
+    "strict": true,
     "allowJs": true,
     "checkJs": true,
     "target": "es2022",
-    "lib": [
-      "es2022",
-      "dom",
-      "dom.iterable"
-    ],
+    "lib": ["es2022", "dom", "dom.iterable"],
     "outDir": "./dist/"
   },
-  "files": [
-    "index.ts"
-  ],
-  "include": [
-    "src/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "**/*.spec.ts"
-  ]
+  "files": ["index.ts"],
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "**/*.spec.ts"]
 }
diff --git a/webpack.config.js b/webpack.config.js
index 94f8855..6af7746 100644
--- a/webpack.config.js
+++ b/webpack.config.js
@@ -9,8 +9,10 @@ const tsConfig = (_env, argv) => {
   return {
     mode: argv.mode,
     plugins: [
-      new webpack.BannerPlugin(`behaviors.js is part of Webrecorder project. Copyright (C) 2021-${new Date().getFullYear()}, Webrecorder Software. Licensed under the Affero General Public License v3.`),
-      new webpack.ProgressPlugin()
+      new webpack.BannerPlugin(
+        `behaviors.js is part of Webrecorder project. Copyright (C) 2021-${new Date().getFullYear()}, Webrecorder Software. Licensed under the Affero General Public License v3.`,
+      ),
+      new webpack.ProgressPlugin(),
     ],
     entry: "./index.ts",
     module: {
@@ -36,7 +38,7 @@ const tsConfig = (_env, argv) => {
           extractComments: false,
         }),
       ],
-    }
+    },
   };
 };
 
diff --git a/yarn.lock b/yarn.lock
index 3d61f0a..487fdda 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -535,6 +535,11 @@
   resolved "https://registry.yarnpkg.com/@types/normalize-package-data/-/normalize-package-data-2.4.0.tgz#e486d0d97396d79beedd0a6e33f4534ff6b4973e"
   integrity sha512-f5j5b/Gf71L+dbqxIpQ4Z2WlmI/mPJ0fOkGGmFgtb6sAu97EPczzbS3/tJKxmcYDj55OX6ssqwDAWOHIYDRDGA==
 
+"@types/query-selector-shadow-dom@^1.0.4":
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/@types/query-selector-shadow-dom/-/query-selector-shadow-dom-1.0.4.tgz#89712de2b066866865f6e01698b4cbbe6fedab82"
+  integrity sha512-8jfGPD0wCMCdyBvrvOrWVn8bHL1UEjkPVJKsqNZpEXp+a7mIIvvGpJMd6n6dlNl7IkG2ryxIVqFI516RPE0uhQ==
+
 "@types/responselike@*", "@types/responselike@^1.0.0":
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/@types/responselike/-/responselike-1.0.0.tgz#251f4fe7d154d2bad125abe1b429b23afd262e29"
@@ -4230,6 +4235,11 @@ prepend-http@^1.0.1:
   resolved "https://registry.yarnpkg.com/prepend-http/-/prepend-http-1.0.4.tgz#d4f4562b0ce3696e41ac52d0e002e57a635dc6dc"
   integrity sha1-1PRWKwzjaW5BrFLQ4ALlemNdxtw=
 
+prettier@^3.5.3:
+  version "3.5.3"
+  resolved "https://registry.yarnpkg.com/prettier/-/prettier-3.5.3.tgz#4fc2ce0d657e7a02e602549f053b239cb7dfe1b5"
+  integrity sha512-QQtaxnoDJeAkDvDKWCLiwIXkTgRhwYDEQCghU9Z6q03iyek/rxRh/2lC3HB7P8sWT2xC/y5JDctPLBIGzHKbhw==
+
 pretty-bytes@^5.2.0:
   version "5.6.0"
   resolved "https://registry.yarnpkg.com/pretty-bytes/-/pretty-bytes-5.6.0.tgz#356256f643804773c82f64723fe78c92c62beaeb"

From 3cf3c3c60e80ece16fa644ae0ba1699995d7a129 Mon Sep 17 00:00:00 2001
From: emma <hi@emma.cafe>
Date: Tue, 29 Apr 2025 16:09:40 -0400
Subject: [PATCH 2/5] get things building ok

---
 src/autofetcher.ts                      |  6 +-
 src/autoscroll.ts                       | 99 +++++++++++++++++--------
 src/{behavior.d.ts => behaviorClass.ts} |  3 +-
 src/lib/behavior.ts                     | 13 ++--
 src/lib/utils.ts                        |  2 +-
 src/site/instagram.ts                   |  9 +--
 src/site/twitter.ts                     |  6 +-
 tsconfig.json                           |  2 +-
 8 files changed, 88 insertions(+), 52 deletions(-)
 rename src/{behavior.d.ts => behaviorClass.ts} (93%)

diff --git a/src/autofetcher.ts b/src/autofetcher.ts
index a79ff5e..b4c8ec7 100644
--- a/src/autofetcher.ts
+++ b/src/autofetcher.ts
@@ -96,7 +96,7 @@ export class AutoFetcher extends BackgroundBehavior {
   queueUrl(url: string, immediate = false) {
     try {
       url = new URL(url, document.baseURI).href;
-    } catch (e) {
+    } catch (_e) {
       return false;
     }
 
@@ -156,7 +156,7 @@ export class AutoFetcher extends BackgroundBehavior {
       } as {});
       abort.abort();
       this.debug(`Autofetch: started non-cors stream for ${url}`);
-    } catch (e) {
+    } catch (_e) {
       this.debug(`Autofetch: failed non-cors for ${url}`);
     }
   }
@@ -316,7 +316,7 @@ export class AutoFetcher extends BackgroundBehavior {
 
     try {
       rules = sheet.cssRules || sheet.rules;
-    } catch (e) {
+    } catch (_e) {
       this.debug("Can't access stylesheet");
       return;
     }
diff --git a/src/autoscroll.ts b/src/autoscroll.ts
index 3b49ee3..b9e8506 100644
--- a/src/autoscroll.ts
+++ b/src/autoscroll.ts
@@ -1,13 +1,20 @@
 import { Behavior } from "./lib/behavior";
-import { sleep, waitUnit, xpathNode, isInViewport, waitUntil, behaviorLog, addLink } from "./lib/utils";
+import {
+  sleep,
+  waitUnit,
+  xpathNode,
+  isInViewport,
+  waitUntil,
+  behaviorLog,
+  addLink,
+} from "./lib/utils";
 import { type AutoFetcher } from "./autofetcher";
 
-
 // ===========================================================================
-export class AutoScroll extends Behavior {
+export class AutoScroll extends Behavior<{ segments: number }> {
   autoFetcher: AutoFetcher;
   showMoreQuery: string;
-  state: { segments: number } = { segments: 1};
+  state = { segments: 1 };
   lastScrollPos: number;
   samePosCount: number;
 
@@ -18,7 +25,8 @@ export class AutoScroll extends Behavior {
 
     this.autoFetcher = autofetcher;
 
-    this.showMoreQuery = "//*[contains(text(), 'show more') or contains(text(), 'Show more')]";
+    this.showMoreQuery =
+      "//*[contains(text(), 'show more') or contains(text(), 'Show more')]";
 
     this.lastScrollPos = -1;
     this.samePosCount = 0;
@@ -34,13 +42,16 @@ export class AutoScroll extends Behavior {
 
   canScrollMore() {
     const scrollElem = self.document.scrollingElement || self.document.body;
-    return this.currScrollPos() < Math.max(scrollElem.clientHeight, scrollElem.scrollHeight);
+    return (
+      this.currScrollPos() <
+      Math.max(scrollElem.clientHeight, scrollElem.scrollHeight)
+    );
   }
 
   hasScrollEL(obj) {
     try {
       return !!self["getEventListeners"](obj).scroll;
-    } catch (e) {
+    } catch (_e) {
       // unknown, assume has listeners
       this.debug("getEventListeners() not available");
       return true;
@@ -48,9 +59,11 @@ export class AutoScroll extends Behavior {
   }
 
   async shouldScroll() {
-    if (!this.hasScrollEL(self.window) &&
+    if (
+      !this.hasScrollEL(self.window) &&
       !this.hasScrollEL(self.document) &&
-      !this.hasScrollEL(self.document.body)) {
+      !this.hasScrollEL(self.document.body)
+    ) {
       return false;
     }
 
@@ -63,7 +76,8 @@ export class AutoScroll extends Behavior {
     const numFetching = this.autoFetcher.numFetching;
 
     // scroll to almost end of page
-    const scrollEnd = (document.scrollingElement.scrollHeight * 0.98) - self.innerHeight;
+    const scrollEnd =
+      document.scrollingElement.scrollHeight * 0.98 - self.innerHeight;
 
     window.scrollTo({ top: scrollEnd, left: 0, behavior: "smooth" });
 
@@ -71,8 +85,10 @@ export class AutoScroll extends Behavior {
     await sleep(500);
 
     // scroll height changed, should scroll
-    if (lastScrollHeight !== self.document.scrollingElement.scrollHeight ||
-      numFetching < this.autoFetcher.numFetching) {
+    if (
+      lastScrollHeight !== self.document.scrollingElement.scrollHeight ||
+      numFetching < this.autoFetcher.numFetching
+    ) {
       window.scrollTo({ top: 0, left: 0, behavior: "auto" });
       return true;
     }
@@ -85,14 +101,18 @@ export class AutoScroll extends Behavior {
       return false;
     }
 
-    if ((self.window.scrollY + self["scrollHeight"]) / self.document.scrollingElement.scrollHeight < 0.90) {
+    if (
+      (self.window.scrollY + self["scrollHeight"]) /
+        self.document.scrollingElement.scrollHeight <
+      0.9
+    ) {
       return false;
     }
 
     return true;
   }
 
-  async*[Symbol.asyncIterator]() {
+  async *[Symbol.asyncIterator]() {
     if (this.shouldScrollUp()) {
       yield* this.scrollUp();
       return;
@@ -103,11 +123,16 @@ export class AutoScroll extends Behavior {
       return;
     }
 
-    yield this.getState("Skipping autoscroll, page seems to not be responsive to scrolling events");
+    yield this.getState(
+      "Skipping autoscroll, page seems to not be responsive to scrolling events",
+    );
   }
 
-  async* scrollDown() {
-    const scrollInc = Math.min(self.document.scrollingElement.clientHeight * 0.10, 30);
+  async *scrollDown() {
+    const scrollInc = Math.min(
+      self.document.scrollingElement.clientHeight * 0.1,
+      30,
+    );
     const interval = 75;
     let elapsedWait = 0;
 
@@ -119,8 +144,11 @@ export class AutoScroll extends Behavior {
 
     while (this.canScrollMore()) {
       if (document.location.pathname !== this.origPath) {
-        behaviorLog("Location Changed, stopping scroll: " +
-          `${document.location.pathname} != ${this.origPath}`, "info");
+        behaviorLog(
+          "Location Changed, stopping scroll: " +
+            `${document.location.pathname} != ${this.origPath}`,
+          "info",
+        );
         addLink(document.location.href);
         return;
       }
@@ -143,8 +171,11 @@ export class AutoScroll extends Behavior {
         await sleep(waitUnit);
 
         await Promise.race([
-          waitUntil(() => self.document.scrollingElement.scrollHeight > scrollHeight, 500),
-          sleep(30000)
+          waitUntil(
+            () => self.document.scrollingElement.scrollHeight > scrollHeight,
+            500,
+          ),
+          sleep(30000),
         ]);
 
         if (self.document.scrollingElement.scrollHeight === scrollHeight) {
@@ -154,27 +185,29 @@ export class AutoScroll extends Behavior {
         showMoreElem = null;
       }
 
-      // eslint-disable-next-line
       self.scrollBy(scrollOpts as ScrollToOptions);
 
       await sleep(interval);
 
       if (this.state.segments === 1) {
         // only print this the first time
-        yield this.getState(`Scrolling down by ${scrollOpts.top} pixels every ${interval / 1000.0} seconds`);
+        yield this.getState(
+          `Scrolling down by ${scrollOpts.top} pixels every ${interval / 1000.0} seconds`,
+        );
         elapsedWait = 2.0;
-
       } else {
         const waitSecs = elapsedWait / (this.state.segments - 1);
         // only add extra wait if actually changed height
         // check for scrolling, but allow for more time for content to appear the longer have already scrolled
-        this.debug(`Waiting up to ${waitSecs} seconds for more scroll segments`);
+        this.debug(
+          `Waiting up to ${waitSecs} seconds for more scroll segments`,
+        );
 
         const startTime = Date.now();
 
         await Promise.race([
           waitUntil(() => this.canScrollMore(), interval),
-          sleep(waitSecs)
+          sleep(waitSecs),
         ]);
 
         elapsedWait += (Date.now() - startTime) * 2;
@@ -194,8 +227,11 @@ export class AutoScroll extends Behavior {
     }
   }
 
-  async* scrollUp() {
-    const scrollInc = Math.min(self.document.scrollingElement.clientHeight * 0.10, 30);
+  async *scrollUp() {
+    const scrollInc = Math.min(
+      self.document.scrollingElement.clientHeight * 0.1,
+      30,
+    );
     const interval = 75;
 
     const scrollOpts = { top: -scrollInc, left: 0, behavior: "auto" };
@@ -210,20 +246,21 @@ export class AutoScroll extends Behavior {
         lastScrollHeight = scrollHeight;
       }
 
-      // eslint-disable-next-line
       self.scrollBy(scrollOpts as ScrollToOptions);
 
       await sleep(interval);
 
       if (this.state.segments === 1) {
         // only print this the first time
-        yield this.getState(`Scrolling up by ${scrollOpts.top} pixels every ${interval / 1000.0} seconds`);
+        yield this.getState(
+          `Scrolling up by ${scrollOpts.top} pixels every ${interval / 1000.0} seconds`,
+        );
       } else {
         // only add extra wait if actually changed height
         // check for scrolling, but allow for more time for content to appear the longer have already scrolled
         await Promise.race([
           waitUntil(() => self.scrollY > 0, interval),
-          sleep((this.state.segments - 1) * 2000)
+          sleep((this.state.segments - 1) * 2000),
         ]);
       }
     }
diff --git a/src/behavior.d.ts b/src/behaviorClass.ts
similarity index 93%
rename from src/behavior.d.ts
rename to src/behaviorClass.ts
index 950c51b..4ae2ba1 100644
--- a/src/behavior.d.ts
+++ b/src/behaviorClass.ts
@@ -33,9 +33,8 @@ export interface Context<State = {}> {
   log: (...args: unknown[]) => void;
 }
 
-declare abstract class Behavior<State = {}> {
+export abstract class Behavior<State = {}> {
   static readonly id: string;
-  constructor();
   abstract run(ctx: Context<Partial<State>>): AsyncGenerator;
   showingProgressBar?(ctx: Context<State>, root: Node): boolean;
   awaitPageLoad?(ctx: Context<State>): Promise<void>;
diff --git a/src/lib/behavior.ts b/src/lib/behavior.ts
index d7db688..dcc9750 100644
--- a/src/lib/behavior.ts
+++ b/src/lib/behavior.ts
@@ -1,4 +1,4 @@
-import { type Context } from "../behavior";
+import { type Context } from "../behaviorClass";
 import { behaviorLog } from "./utils";
 import * as Lib from "./utils";
 
@@ -29,7 +29,7 @@ export class Behavior<State extends Object = {}> extends BackgroundBehavior {
   _running: Promise<void> | null;
   paused: Promise<void> | null;
   _unpause: ((value: void | PromiseLike<void>) => void) | null;
-  state: Partial<State>;
+  state: Partial<State> & { "done!"?: number };
   scrollOpts: {
     behavior: string;
     block: string;
@@ -85,18 +85,21 @@ export class Behavior<State extends Object = {}> extends BackgroundBehavior {
     }
   }
 
-  getState(msg: string, incrValue?: KeysWithValsOfType<State, number>) {
+  getState(
+    msg: string,
+    incrValue?: KeysWithValsOfType<typeof this.state, number>,
+  ) {
     if (incrValue) {
       if (this.state[incrValue] === undefined) {
         (
           this.state as {
-            [K in KeysWithValsOfType<State, number>]: number;
+            [K in KeysWithValsOfType<typeof this.state, number>]: number;
           }
         )[incrValue] = 1;
       } else {
         (
           this.state as {
-            [K in KeysWithValsOfType<State, number>]: number;
+            [K in KeysWithValsOfType<typeof this.state, number>]: number;
           }
         )[incrValue]++;
       }
diff --git a/src/lib/utils.ts b/src/lib/utils.ts
index 1a22398..60b2ac9 100644
--- a/src/lib/utils.ts
+++ b/src/lib/utils.ts
@@ -1,4 +1,4 @@
-import { type Context } from "../behavior";
+import { type Context } from "../behaviorClass";
 
 let _logFunc: (...args: unknown[]) => void | undefined = console.log;
 let _behaviorMgrClass = null;
diff --git a/src/site/instagram.ts b/src/site/instagram.ts
index b6e0f28..86a1d1d 100644
--- a/src/site/instagram.ts
+++ b/src/site/instagram.ts
@@ -1,4 +1,4 @@
-import { Behavior, type Context } from "../behavior";
+import { type Context, type Behavior } from "../behaviorClass";
 
 const subpostNextOnlyChevron =
   "//article[@role='presentation']//div[@role='presentation']/following-sibling::button";
@@ -27,7 +27,7 @@ type State = {
   comments: number;
 };
 
-export class InstagramPostsBehavior extends Behavior<State> {
+export class InstagramPostsBehavior implements Behavior<State> {
   maxCommentsTime: number;
   postOnlyWindow: any;
 
@@ -51,7 +51,6 @@ export class InstagramPostsBehavior extends Behavior<State> {
   }
 
   constructor() {
-    super();
     this.maxCommentsTime = 10000;
     // extra window for first post, if allowed
     this.postOnlyWindow = null;
@@ -156,7 +155,7 @@ export class InstagramPostsBehavior extends Behavior<State> {
 
   async *iterSubposts(ctx: Context<State>) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
-    let next = xpathNode(Q.subpostNextOnlyChevron);
+    let next = xpathNode(Q.subpostNextOnlyChevron) as HTMLElement | null;
 
     let count = 1;
 
@@ -170,7 +169,7 @@ export class InstagramPostsBehavior extends Behavior<State> {
         "slides",
       );
 
-      next = xpathNode(Q.subpostPrevNextChevron);
+      next = xpathNode(Q.subpostPrevNextChevron) as HTMLElement | null;
     }
 
     await sleep(waitUnit * 5);
diff --git a/src/site/twitter.ts b/src/site/twitter.ts
index 78f7f42..f60e828 100644
--- a/src/site/twitter.ts
+++ b/src/site/twitter.ts
@@ -1,5 +1,4 @@
-import { type Context } from "../behavior";
-import { Behavior } from "../behavior";
+import { type Context, type Behavior } from "../behaviorClass";
 
 const Q = {
   rootPath:
@@ -32,7 +31,7 @@ type State = {
   threads: number;
 };
 
-export class TwitterTimelineBehavior extends Behavior<State> {
+export class TwitterTimelineBehavior implements Behavior<State> {
   seenTweets: Set<string>;
   seenMediaTweets: Set<string>;
 
@@ -56,7 +55,6 @@ export class TwitterTimelineBehavior extends Behavior<State> {
   }
 
   constructor() {
-    super();
     this.seenTweets = new Set();
     this.seenMediaTweets = new Set();
   }
diff --git a/tsconfig.json b/tsconfig.json
index 9434ddf..4d0eff6 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -4,7 +4,7 @@
     "moduleResolution": "node",
     "removeComments": true,
     "preserveConstEnums": true,
-    "strict": true,
+    // "strict": true,
     "allowJs": true,
     "checkJs": true,
     "target": "es2022",

From 7b14c808f911ece8318ade196a40eb657efd16bb Mon Sep 17 00:00:00 2001
From: emma <hi@emma.cafe>
Date: Tue, 29 Apr 2025 17:01:10 -0400
Subject: [PATCH 3/5] rename & add a few comments

---
 .eslintrc.cjs                  |   4 +
 package.json                   |   4 +
 src/autoplay.ts                |  98 ++++---
 src/autoscroll.ts              |   2 +-
 src/lib/behavior.ts            |  12 +-
 src/{ => lib}/behaviorClass.ts |  13 +-
 src/lib/utils.ts               |  10 +-
 src/site/instagram.ts          |  29 +-
 src/site/twitter.ts            |  30 +-
 tsconfig.eslint.json           |   2 +-
 tsconfig.json                  |   1 +
 yarn.lock                      | 502 ++++++++++++++++++++++++++++++++-
 12 files changed, 616 insertions(+), 91 deletions(-)
 rename src/{ => lib}/behaviorClass.ts (63%)

diff --git a/.eslintrc.cjs b/.eslintrc.cjs
index c719a88..f35e704 100644
--- a/.eslintrc.cjs
+++ b/.eslintrc.cjs
@@ -107,5 +107,9 @@ module.exports = {
         "@typescript-eslint/no-var-requires": "off",
       },
     },
+    {
+      files: ["scripts/*.mjs"],
+      env: { node: true },
+    },
   ],
 };
diff --git a/package.json b/package.json
index 90cf7ab..8690ba9 100644
--- a/package.json
+++ b/package.json
@@ -35,5 +35,9 @@
   ],
   "dependencies": {
     "query-selector-shadow-dom": "^1.0.1"
+  },
+  "optionalDependencies": {
+    "memfs": "^4.17.0",
+    "puppeteer": "^24.7.2"
   }
 }
diff --git a/src/autoplay.ts b/src/autoplay.ts
index 369e0a2..eb3d6f9 100644
--- a/src/autoplay.ts
+++ b/src/autoplay.ts
@@ -4,7 +4,6 @@ import { BackgroundBehavior } from "./lib/behavior";
 import { sleep } from "./lib/utils";
 import { type AutoFetcher } from "./autofetcher";
 
-
 // ===========================================================================
 export class Autoplay extends BackgroundBehavior {
   mediaSet: Set<string>;
@@ -24,9 +23,11 @@ export class Autoplay extends BackgroundBehavior {
     this.numPlaying = 0;
     this.promises = [];
     this._initDone = () => null;
-    this.promises.push(new Promise((resolve) => this._initDone = resolve));
+    this.promises.push(new Promise((resolve) => (this._initDone = resolve)));
     if (startEarly) {
-      document.addEventListener("DOMContentLoaded", () => this.pollAudioVideo());
+      document.addEventListener("DOMContentLoaded", async () =>
+        this.pollAudioVideo(),
+      );
     }
   }
 
@@ -49,9 +50,10 @@ export class Autoplay extends BackgroundBehavior {
     this.polling = true;
 
     while (run) {
-      for (const [, elem] of querySelectorAllDeep("video, audio, picture").entries()) {
+      for (const [, elem] of querySelectorAllDeep(
+        "video, audio, picture",
+      ).entries()) {
         if (!elem["__bx_autoplay_found"]) {
-
           if (!this.running) {
             if (this.processFetchableUrl(elem)) {
               elem["__bx_autoplay_found"] = true;
@@ -126,28 +128,35 @@ export class Autoplay extends BackgroundBehavior {
 
     if (media.paused || media.currentTime) {
       if (media.paused) {
-        this.debug("no src url found, attempting to click or play: " + media.outerHTML);
+        this.debug(
+          "no src url found, attempting to click or play: " + media.outerHTML,
+        );
       } else {
-        this.debug("media already playing, waiting for full playback to finish: " + media.outerHTML);
+        this.debug(
+          "media already playing, waiting for full playback to finish: " +
+            media.outerHTML,
+        );
       }
 
-      this.attemptMediaPlay(media).then(async (finished: Promise<any> | null) => {
-        let check = true;
+      this.attemptMediaPlay(media).then(
+        async (finished: Promise<any> | null) => {
+          let check = true;
 
-        if (finished) {
-          finished.then(() => check = false);
-        }
-
-        while (check) {
-          if (this.processFetchableUrl(media)) {
-            check = false;
+          if (finished != null) {
+            finished.then(() => (check = false));
           }
-          this.debug("Waiting for fixed URL or media to finish: " + media.currentSrc);
-          await sleep(1000);
-        }
-
-      });
 
+          while (check) {
+            if (this.processFetchableUrl(media)) {
+              check = false;
+            }
+            this.debug(
+              "Waiting for fixed URL or media to finish: " + media.currentSrc,
+            );
+            await sleep(1000);
+          }
+        },
+      );
     } else if (media.currentSrc) {
       this.debug("media playing from non-URL source: " + media.currentSrc);
     }
@@ -175,17 +184,43 @@ export class Autoplay extends BackgroundBehavior {
       resolveStarted();
     }
 
-    media.addEventListener("loadstart", () => { this.debug("media event: loadstart"); resolveStarted(true); });
-    media.addEventListener("playing", () => { this.debug("media event: playing"); resolveStarted(true); });
+    media.addEventListener("loadstart", () => {
+      this.debug("media event: loadstart");
+      resolveStarted(true);
+    });
+    media.addEventListener("playing", () => {
+      this.debug("media event: playing");
+      resolveStarted(true);
+    });
 
-    media.addEventListener("loadeddata", () => this.debug("media event: loadeddata"));
+    media.addEventListener("loadeddata", () =>
+      this.debug("media event: loadeddata"),
+    );
 
-    media.addEventListener("ended", () => { this.debug("media event: ended"); resolveFinished(); });
-    media.addEventListener("pause", () => { this.debug("media event: pause"); resolveFinished(); });
-    media.addEventListener("abort", () => { this.debug("media event: abort"); resolveFinished(); });
-    media.addEventListener("error", () => { this.debug("media event: error"); resolveFinished(); });
-    media.addEventListener("stalled", () => { this.debug("media event: stalled"); resolveFinished(); });
-    media.addEventListener("suspend", () => { this.debug("media event: suspend"); resolveFinished(); });
+    media.addEventListener("ended", () => {
+      this.debug("media event: ended");
+      resolveFinished();
+    });
+    media.addEventListener("pause", () => {
+      this.debug("media event: pause");
+      resolveFinished();
+    });
+    media.addEventListener("abort", () => {
+      this.debug("media event: abort");
+      resolveFinished();
+    });
+    media.addEventListener("error", () => {
+      this.debug("media event: error");
+      resolveFinished();
+    });
+    media.addEventListener("stalled", () => {
+      this.debug("media event: stalled");
+      resolveFinished();
+    });
+    media.addEventListener("suspend", () => {
+      this.debug("media event: suspend");
+      resolveFinished();
+    });
 
     media.muted = true;
 
@@ -214,8 +249,7 @@ export class Autoplay extends BackgroundBehavior {
     return finished;
   }
 
-  done() {
+  async done() {
     return Promise.allSettled(this.promises);
   }
 }
-
diff --git a/src/autoscroll.ts b/src/autoscroll.ts
index b9e8506..b560085 100644
--- a/src/autoscroll.ts
+++ b/src/autoscroll.ts
@@ -11,7 +11,7 @@ import {
 import { type AutoFetcher } from "./autofetcher";
 
 // ===========================================================================
-export class AutoScroll extends Behavior<{ segments: number }> {
+export class AutoScroll extends Behavior {
   autoFetcher: AutoFetcher;
   showMoreQuery: string;
   state = { segments: 1 };
diff --git a/src/lib/behavior.ts b/src/lib/behavior.ts
index dcc9750..e61d944 100644
--- a/src/lib/behavior.ts
+++ b/src/lib/behavior.ts
@@ -1,4 +1,4 @@
-import { type Context } from "../behaviorClass";
+import { type BehaviorContext } from "./behaviorClass";
 import { behaviorLog } from "./utils";
 import * as Lib from "./utils";
 
@@ -51,14 +51,14 @@ export class Behavior<State extends Object = {}> extends BackgroundBehavior {
   }
 
   async done() {
-    return this._running ? this._running : Promise.resolve();
+    return this._running != null ? this._running : Promise.resolve();
   }
 
   async run() {
     try {
       for await (const step of this) {
         this.debug(step);
-        if (this.paused) {
+        if (this.paused != null) {
           await this.paused;
         }
       }
@@ -69,7 +69,7 @@ export class Behavior<State extends Object = {}> extends BackgroundBehavior {
   }
 
   pause() {
-    if (this.paused) {
+    if (this.paused != null) {
       return;
     }
     this.paused = new Promise((resolve) => {
@@ -150,7 +150,7 @@ type AbstractBehavior = (new () => AbstractBehaviorInst) &
 export class BehaviorRunner extends BackgroundBehavior {
   inst: AbstractBehaviorInst;
   behaviorProps: StaticAbstractBehavior;
-  ctx: Context;
+  ctx: BehaviorContext;
   _running: Promise<void> | undefined;
   paused: any;
   _unpause: any;
@@ -203,7 +203,7 @@ export class BehaviorRunner extends BackgroundBehavior {
   }
 
   async done() {
-    return this._running ? this._running : Promise.resolve();
+    return this._running != null ? this._running : Promise.resolve();
   }
 
   async run() {
diff --git a/src/behaviorClass.ts b/src/lib/behaviorClass.ts
similarity index 63%
rename from src/behaviorClass.ts
rename to src/lib/behaviorClass.ts
index 4ae2ba1..83d0c83 100644
--- a/src/behaviorClass.ts
+++ b/src/lib/behaviorClass.ts
@@ -1,3 +1,5 @@
+/** WIP rewrite of some of the WIP abstract behavior class & types from `behavior.ts` that allows for better autocomplete & typing */
+
 import {
   type waitUntil,
   type sleep,
@@ -9,13 +11,13 @@ import {
   type getState,
   type HistoryState,
   type waitUntilNode,
-} from "./lib/utils";
+} from "./utils";
 
 type Opts = {
   maxDepth: number;
 };
 
-export interface Context<State = {}> {
+export interface BehaviorContext<State = {}> {
   Lib: {
     xpathNode: typeof xpathNode;
     sleep: typeof sleep;
@@ -35,7 +37,8 @@ export interface Context<State = {}> {
 
 export abstract class Behavior<State = {}> {
   static readonly id: string;
-  abstract run(ctx: Context<Partial<State>>): AsyncGenerator;
-  showingProgressBar?(ctx: Context<State>, root: Node): boolean;
-  awaitPageLoad?(ctx: Context<State>): Promise<void>;
+  abstract run(ctx: BehaviorContext<Partial<State>>): AsyncGenerator;
+  showingProgressBar?(ctx: BehaviorContext<State>, root: Node): boolean;
+  awaitPageLoad?(ctx: BehaviorContext<State>): Promise<void>;
+  // TODO fill more of these in
 }
diff --git a/src/lib/utils.ts b/src/lib/utils.ts
index 60b2ac9..40aa901 100644
--- a/src/lib/utils.ts
+++ b/src/lib/utils.ts
@@ -1,4 +1,4 @@
-import { type Context } from "../behaviorClass";
+import { type BehaviorContext } from "./behaviorClass";
 
 let _logFunc: (...args: unknown[]) => void | undefined = console.log;
 let _behaviorMgrClass = null;
@@ -55,8 +55,8 @@ export async function waitUntilNode(
 }
 
 export async function awaitLoad(iframe?: HTMLIFrameElement) {
-  const doc = iframe ? iframe.contentDocument! : document;
-  const win = iframe ? iframe.contentWindow! : window;
+  const doc = iframe ? iframe.contentDocument : document;
+  const win = iframe ? iframe.contentWindow : window;
   return new Promise((resolve) => {
     if (doc.readyState === "complete") {
       resolve(null);
@@ -327,7 +327,7 @@ export async function* iterChildElem(
 
     if (!child.nextElementSibling) {
       await Promise.race([
-        waitUntil(() => !!child?.nextElementSibling, timeout),
+        waitUntil(() => !!child.nextElementSibling, timeout),
         sleep(totalTimeout),
       ]);
     }
@@ -394,7 +394,7 @@ export function scrollIntoView(
 }
 
 export function getState<
-  StateContext extends Context<{ [K in IncrValue]: number }>,
+  StateContext extends BehaviorContext<{ [K in IncrValue]: number }>,
   const IncrValue extends string,
 >(ctx: StateContext, msg: string, incrValue?: IncrValue) {
   if (typeof ctx.state === "undefined") {
diff --git a/src/site/instagram.ts b/src/site/instagram.ts
index 86a1d1d..4a2b831 100644
--- a/src/site/instagram.ts
+++ b/src/site/instagram.ts
@@ -1,4 +1,4 @@
-import { type Context, type Behavior } from "../behaviorClass";
+import { type BehaviorContext, type Behavior } from "../lib/behaviorClass";
 
 const subpostNextOnlyChevron =
   "//article[@role='presentation']//div[@role='presentation']/following-sibling::button";
@@ -63,7 +63,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     }
   }
 
-  async waitForNext(ctx: Context<State>, child: Element | null) {
+  async waitForNext(ctx: BehaviorContext<State>, child: Element | null) {
     if (!child) {
       return null;
     }
@@ -77,7 +77,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     return child.nextElementSibling;
   }
 
-  async *iterRow(ctx: Context<State>) {
+  async *iterRow(ctx: BehaviorContext<State>) {
     const { RestoreState, sleep, waitUnit, xpathNode } = ctx.Lib;
     const root = xpathNode(Q.rootPath) as Element | null;
 
@@ -109,12 +109,15 @@ export class InstagramPostsBehavior implements Behavior<State> {
     }
   }
 
-  async *viewStandalonePost(ctx: Context<State>, origLoc: string | URL) {
+  async *viewStandalonePost(
+    ctx: BehaviorContext<State>,
+    origLoc: string | URL,
+  ) {
     const { getState, sleep, waitUnit, waitUntil, xpathNode, xpathString } =
       ctx.Lib;
     const root = xpathNode(Q.rootPath) as Element | null;
 
-    if (!root?.firstElementChild) {
+    if (!root.firstElementChild) {
       return;
     }
 
@@ -153,7 +156,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     //}
   }
 
-  async *iterSubposts(ctx: Context<State>) {
+  async *iterSubposts(ctx: BehaviorContext<State>) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
     let next = xpathNode(Q.subpostNextOnlyChevron) as HTMLElement | null;
 
@@ -175,7 +178,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     await sleep(waitUnit * 5);
   }
 
-  async iterComments(ctx: Context<State>) {
+  async iterComments(ctx: BehaviorContext<State>) {
     const { scrollIntoView, sleep, waitUnit, waitUntil, xpathNode } = ctx.Lib;
     const root = xpathNode(Q.commentRoot) as Element | null;
 
@@ -201,10 +204,10 @@ export class InstagramPostsBehavior implements Behavior<State> {
       while (viewReplies) {
         const orig = viewReplies.textContent;
         viewReplies.click();
-        ctx.state!.comments!++;
+        ctx.state.comments++;
         await sleep(waitUnit * 2.5);
 
-        await waitUntil(() => orig !== viewReplies!.textContent, waitUnit);
+        await waitUntil(() => orig !== viewReplies.textContent, waitUnit);
 
         viewReplies = getViewRepliesButton(child);
       }
@@ -220,7 +223,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
         ) as HTMLElement | null;
         if (loadMore) {
           loadMore.click();
-          ctx.state!.comments!++;
+          ctx.state.comments++;
           await sleep(waitUnit * 5);
         }
       }
@@ -232,7 +235,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     return commentsLoaded;
   }
 
-  async *iterPosts(ctx: Context<State>, next: HTMLElement | null) {
+  async *iterPosts(ctx: BehaviorContext<State>, next: HTMLElement | null) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
     let count = 0;
 
@@ -260,7 +263,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     await sleep(waitUnit * 5);
   }
 
-  async *run(ctx: Context<State>) {
+  async *run(ctx: BehaviorContext<State>) {
     const { getState, scrollIntoView, sleep, waitUnit, xpathNode } = ctx.Lib;
     //const origLoc = window.location.href;
 
@@ -286,7 +289,7 @@ export class InstagramPostsBehavior implements Behavior<State> {
     }
   }
 
-  async awaitPageLoad(ctx: Context<State>) {
+  async awaitPageLoad(ctx: BehaviorContext<State>) {
     const { Lib, log } = ctx;
     const { waitUntilNode } = Lib;
 
diff --git a/src/site/twitter.ts b/src/site/twitter.ts
index f60e828..72225ce 100644
--- a/src/site/twitter.ts
+++ b/src/site/twitter.ts
@@ -1,4 +1,4 @@
-import { type Context, type Behavior } from "../behaviorClass";
+import { type BehaviorContext, type Behavior } from "../lib/behaviorClass";
 
 const Q = {
   rootPath:
@@ -59,7 +59,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     this.seenMediaTweets = new Set();
   }
 
-  showingProgressBar(ctx: Context<State>, root: Node) {
+  showingProgressBar(ctx: BehaviorContext<State>, root: Node) {
     const { xpathNode } = ctx.Lib;
     const node = xpathNode(Q.progress, root) as Element | null;
     if (!node) {
@@ -69,7 +69,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     return node.clientHeight > 10;
   }
 
-  async waitForNext(ctx: Context<State>, child: Element | null) {
+  async waitForNext(ctx: BehaviorContext<State>, child: Element | null) {
     const { sleep, waitUnit } = ctx.Lib;
     if (!child) {
       return null;
@@ -88,24 +88,24 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     return child.nextElementSibling;
   }
 
-  async expandMore(ctx: Context<State>, child: Element | null) {
+  async expandMore(ctx: BehaviorContext<State>, child: Element | null) {
     const { sleep, waitUnit, xpathNode } = ctx.Lib;
     const expandElem = xpathNode(Q.expand, child) as HTMLElement | null;
     if (!expandElem) {
       return child;
     }
 
-    const prev = child?.previousElementSibling;
+    const prev = child.previousElementSibling;
     expandElem.click();
     await sleep(waitUnit);
-    while (this.showingProgressBar(ctx, prev?.nextElementSibling as Node)) {
+    while (this.showingProgressBar(ctx, prev.nextElementSibling as Node)) {
       await sleep(waitUnit);
     }
-    child = prev?.nextElementSibling ?? null;
+    child = prev.nextElementSibling ?? null;
     return child;
   }
 
-  async *infScroll(ctx: Context<State>) {
+  async *infScroll(ctx: BehaviorContext<State>) {
     const { scrollIntoView, RestoreState, sleep, waitUnit, xpathNode } =
       ctx.Lib;
     const root = xpathNode(Q.rootPath) as Element | null;
@@ -129,7 +129,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
       }
 
       if ((child as HTMLElement).innerText) {
-        scrollIntoView(child!);
+        scrollIntoView(child);
       }
 
       if (child && anchorElem) {
@@ -151,7 +151,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     }
   }
 
-  async *mediaPlaying(ctx: Context<State>, tweet: Node) {
+  async *mediaPlaying(ctx: BehaviorContext<State>, tweet: Node) {
     const { getState, sleep, xpathNode, xpathString } = ctx.Lib;
     const media = xpathNode(
       "(.//video | .//audio)",
@@ -207,7 +207,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     await Promise.race([p, sleep(60000)]);
   }
 
-  async *clickImages(ctx: Context<State>, tweet: HTMLElement) {
+  async *clickImages(ctx: BehaviorContext<State>, tweet: HTMLElement) {
     const { getState, HistoryState, sleep, waitUnit, xpathNode } = ctx.Lib;
     const imagePopup = xpathNode(Q.image, tweet) as HTMLElement | null;
 
@@ -242,10 +242,10 @@ export class TwitterTimelineBehavior implements Behavior<State> {
   }
 
   async *clickTweet(
-    ctx: Context<State>,
+    ctx: BehaviorContext<State>,
     tweet: HTMLElement,
     depth: number,
-  ): AsyncGenerator<{ state: Context<State>["state"]; msg: string }> {
+  ): AsyncGenerator<{ state: BehaviorContext<State>["state"]; msg: string }> {
     const { getState, HistoryState, sleep, waitUnit } = ctx.Lib;
     const tweetState = new HistoryState(() => tweet.click());
 
@@ -269,7 +269,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     }
   }
 
-  async *iterTimeline(ctx: Context<State>, depth = 0) {
+  async *iterTimeline(ctx: BehaviorContext<State>, depth = 0) {
     const { getState, sleep, waitUnit, xpathNode } = ctx.Lib;
     if (this.seenTweets.has(window.location.href)) {
       return;
@@ -316,7 +316,7 @@ export class TwitterTimelineBehavior implements Behavior<State> {
     }
   }
 
-  async *run(ctx: Context<State>) {
+  async *run(ctx: BehaviorContext<State>) {
     yield* this.iterTimeline(ctx, 0);
   }
 }
diff --git a/tsconfig.eslint.json b/tsconfig.eslint.json
index 9774ecd..d96adc4 100644
--- a/tsconfig.eslint.json
+++ b/tsconfig.eslint.json
@@ -3,6 +3,6 @@
     "noEmit": true
   },
   "extends": "./tsconfig.json",
-  "include": ["**/*.ts", "**/*.js", ".*.js", "**/*.cjs"],
+  "include": ["**/*.ts", "**/*.js", "**/*.mjs", ".*.js", "**/*.cjs"],
   "exclude": ["__generated__", "__mocks__", "dist"]
 }
diff --git a/tsconfig.json b/tsconfig.json
index 4d0eff6..76359bf 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -5,6 +5,7 @@
     "removeComments": true,
     "preserveConstEnums": true,
     // "strict": true,
+    // "strictNullChecks": true,
     "allowJs": true,
     "checkJs": true,
     "target": "es2022",
diff --git a/yarn.lock b/yarn.lock
index 487fdda..c0adc66 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -408,6 +408,26 @@
     "@jridgewell/resolve-uri" "3.1.0"
     "@jridgewell/sourcemap-codec" "1.4.14"
 
+"@jsonjoy.com/base64@^1.1.1":
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/@jsonjoy.com/base64/-/base64-1.1.2.tgz#cf8ea9dcb849b81c95f14fc0aaa151c6b54d2578"
+  integrity sha512-q6XAnWQDIMA3+FTiOYajoYqySkO+JSat0ytXGSuRdq9uXE7o92gzuQwQM14xaCRlBLGq3v5miDGC4vkVTn54xA==
+
+"@jsonjoy.com/json-pack@^1.0.3":
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/@jsonjoy.com/json-pack/-/json-pack-1.2.0.tgz#e658900e81d194903171c42546e1aa27f446846a"
+  integrity sha512-io1zEbbYcElht3tdlqEOFxZ0dMTYrHz9iMf0gqn1pPjZFTCgM5R4R5IMA20Chb2UPYYsxjzs8CgZ7Nb5n2K2rA==
+  dependencies:
+    "@jsonjoy.com/base64" "^1.1.1"
+    "@jsonjoy.com/util" "^1.1.2"
+    hyperdyperid "^1.2.0"
+    thingies "^1.20.0"
+
+"@jsonjoy.com/util@^1.1.2", "@jsonjoy.com/util@^1.3.0":
+  version "1.5.0"
+  resolved "https://registry.yarnpkg.com/@jsonjoy.com/util/-/util-1.5.0.tgz#6008e35b9d9d8ee27bc4bfaa70c8cbf33a537b4c"
+  integrity sha512-ojoNsrIuPI9g6o8UxhraZQSyF2ByJanAY4cTFbc8Mf2AXEF4aQRGY1dJxyJpuyav8r9FGflEt/Ff3u5Nt6YMPA==
+
 "@mrmlnc/readdir-enhanced@^2.2.1":
   version "2.2.1"
   resolved "https://registry.yarnpkg.com/@mrmlnc/readdir-enhanced/-/readdir-enhanced-2.2.1.tgz#524af240d1a360527b730475ecfa1344aa540dde"
@@ -442,6 +462,19 @@
     "@nodelib/fs.scandir" "2.1.5"
     fastq "^1.6.0"
 
+"@puppeteer/browsers@2.10.2":
+  version "2.10.2"
+  resolved "https://registry.yarnpkg.com/@puppeteer/browsers/-/browsers-2.10.2.tgz#c2a63cee699c6b5b971b9fcba9095098970f1648"
+  integrity sha512-i4Ez+s9oRWQbNjtI/3+jxr7OH508mjAKvza0ekPJem0ZtmsYHP3B5dq62+IaBHKaGCOuqJxXzvFLUhJvQ6jtsQ==
+  dependencies:
+    debug "^4.4.0"
+    extract-zip "^2.0.1"
+    progress "^2.0.3"
+    proxy-agent "^6.5.0"
+    semver "^7.7.1"
+    tar-fs "^3.0.8"
+    yargs "^17.7.2"
+
 "@sindresorhus/is@^4.0.0":
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-4.0.0.tgz#2ff674e9611b45b528896d820d3d7a812de2f0e4"
@@ -454,6 +487,11 @@
   dependencies:
     defer-to-connect "^2.0.0"
 
+"@tootallnate/quickjs-emscripten@^0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@tootallnate/quickjs-emscripten/-/quickjs-emscripten-0.23.0.tgz#db4ecfd499a9765ab24002c3b696d02e6d32a12c"
+  integrity sha512-C5Mc6rdnsaJDjO3UpGW/CQTHtCKaYlScZTly4JIu97Jxo/odCiH0ITnDXSJPTOrEKk/ycSZ0AOgTmkDtkOsvIA==
+
 "@types/cacheable-request@^6.0.1":
   version "6.0.1"
   resolved "https://registry.yarnpkg.com/@types/cacheable-request/-/cacheable-request-6.0.1.tgz#5d22f3dded1fd3a84c0bbeb5039a7419c2c91976"
@@ -547,6 +585,13 @@
   dependencies:
     "@types/node" "*"
 
+"@types/yauzl@^2.9.1":
+  version "2.10.3"
+  resolved "https://registry.yarnpkg.com/@types/yauzl/-/yauzl-2.10.3.tgz#e9b2808b4f109504a03cda958259876f61017999"
+  integrity sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q==
+  dependencies:
+    "@types/node" "*"
+
 "@typescript-eslint/eslint-plugin@^8.28.0":
   version "8.28.0"
   resolved "https://registry.yarnpkg.com/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.28.0.tgz#ad1465aa6fe7e937801c291648dec951c4dc38e6"
@@ -840,6 +885,11 @@ acorn@^8.9.0:
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.14.1.tgz#721d5dc10f7d5b5609a891773d47731796935dfb"
   integrity sha512-OvQ/2pUDKmgfCg++xsTX1wGxfTaszcHVcTctW4UJB4hibJx2HXxxO5UmVgyjMa+ZDsiaf5wWLXYpRWMmBI0QHg==
 
+agent-base@^7.1.0, agent-base@^7.1.2:
+  version "7.1.3"
+  resolved "https://registry.yarnpkg.com/agent-base/-/agent-base-7.1.3.tgz#29435eb821bc4194633a5b89e5bc4703bafc25a1"
+  integrity sha512-jRR5wdylq8CkOe6hei19GGZnxM6rBGwFl3Bg0YItGDimvjGtAvdZk4Pu6Cl4u4Igsws4a1fd1Vq3ezrhn4KmFw==
+
 ajv-errors@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/ajv-errors/-/ajv-errors-1.0.1.tgz#f35986aceb91afadec4102fbd85014950cefa64d"
@@ -914,7 +964,7 @@ ansi-styles@^3.2.0, ansi-styles@^3.2.1:
   dependencies:
     color-convert "^1.9.0"
 
-ansi-styles@^4.1.0:
+ansi-styles@^4.0.0, ansi-styles@^4.1.0:
   version "4.3.0"
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-4.3.0.tgz#edd803628ae71c04c85ae7a0906edad34b648937"
   integrity sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==
@@ -1008,6 +1058,13 @@ ast-types@0.14.2:
   dependencies:
     tslib "^2.0.1"
 
+ast-types@^0.13.4:
+  version "0.13.4"
+  resolved "https://registry.yarnpkg.com/ast-types/-/ast-types-0.13.4.tgz#ee0d77b343263965ecc3fb62da16e7222b2b6782"
+  integrity sha512-x1FCFnFifvYDDzTaLII71vG5uvDwgtmDTEVWAxrgeiR8VjMONcCXJx7E+USjDtHlwFmt9MysbqgF9b9Vjr6w+w==
+  dependencies:
+    tslib "^2.0.1"
+
 async-each@^1.0.1:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/async-each/-/async-each-1.0.3.tgz#b727dbf87d7651602f06f4d4ac387f47d91b0cbf"
@@ -1042,6 +1099,11 @@ axios@^0.21.1:
   dependencies:
     follow-redirects "^1.10.0"
 
+b4a@^1.6.4:
+  version "1.6.7"
+  resolved "https://registry.yarnpkg.com/b4a/-/b4a-1.6.7.tgz#a99587d4ebbfbd5a6e3b21bdb5d5fa385767abe4"
+  integrity sha512-OnAYlL5b7LEkALw87fUVafQw5rVR9RjwGd4KUwNQ6DrrNmaVaUCgLipfVlzrPQ4tWOR9P0IXGNOx50jYCCdSJg==
+
 babel-core@^7.0.0-bridge.0:
   version "7.0.0-bridge.0"
   resolved "https://registry.yarnpkg.com/babel-core/-/babel-core-7.0.0-bridge.0.tgz#95a492ddd90f9b4e9a4a1da14eb335b87b634ece"
@@ -1059,6 +1121,39 @@ balanced-match@^1.0.0:
   resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.0.tgz#89b4d199ab2bee49de164ea02b89ce462d71b767"
   integrity sha1-ibTRmasr7kneFk6gK4nORi1xt2c=
 
+bare-events@^2.2.0, bare-events@^2.5.4:
+  version "2.5.4"
+  resolved "https://registry.yarnpkg.com/bare-events/-/bare-events-2.5.4.tgz#16143d435e1ed9eafd1ab85f12b89b3357a41745"
+  integrity sha512-+gFfDkR8pj4/TrWCGUGWmJIkBwuxPS5F+a5yWjOHQt2hHvNZd5YLzadjmDUtFmMM4y429bnKLa8bYBMHcYdnQA==
+
+bare-fs@^4.0.1:
+  version "4.1.3"
+  resolved "https://registry.yarnpkg.com/bare-fs/-/bare-fs-4.1.3.tgz#9b23313163d844e807aa6eafb4ba82b5f070eefc"
+  integrity sha512-OeEZYIg+2qepaWLyphaOXHAHKo3xkM8y3BeGAvHdMN8GNWvEAU1Yw6rYpGzu/wDDbKxgEjVeVDpgGhDzaeMpjg==
+  dependencies:
+    bare-events "^2.5.4"
+    bare-path "^3.0.0"
+    bare-stream "^2.6.4"
+
+bare-os@^3.0.1:
+  version "3.6.1"
+  resolved "https://registry.yarnpkg.com/bare-os/-/bare-os-3.6.1.tgz#9921f6f59edbe81afa9f56910658422c0f4858d4"
+  integrity sha512-uaIjxokhFidJP+bmmvKSgiMzj2sV5GPHaZVAIktcxcpCyBFFWO+YlikVAdhmUo2vYFvFhOXIAlldqV29L8126g==
+
+bare-path@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/bare-path/-/bare-path-3.0.0.tgz#b59d18130ba52a6af9276db3e96a2e3d3ea52178"
+  integrity sha512-tyfW2cQcB5NN8Saijrhqn0Zh7AnFNsnczRcuWODH0eYAXBsJ5gVxAUuNr7tsHSC6IZ77cA0SitzT+s47kot8Mw==
+  dependencies:
+    bare-os "^3.0.1"
+
+bare-stream@^2.6.4:
+  version "2.6.5"
+  resolved "https://registry.yarnpkg.com/bare-stream/-/bare-stream-2.6.5.tgz#bba8e879674c4c27f7e27805df005c15d7a2ca07"
+  integrity sha512-jSmxKJNJmHySi6hC42zlZnq00rga4jjxcgNZjY9N5WlOe/iOoGRtdwGsHzQv2RlH2KOYMwGUXhf2zXd32BA9RA==
+  dependencies:
+    streamx "^2.21.0"
+
 base@^0.11.1:
   version "0.11.2"
   resolved "https://registry.yarnpkg.com/base/-/base-0.11.2.tgz#7bde5ced145b6d551a90db87f83c558b4eb48a8f"
@@ -1072,6 +1167,11 @@ base@^0.11.1:
     mixin-deep "^1.2.0"
     pascalcase "^0.1.1"
 
+basic-ftp@^5.0.2:
+  version "5.0.5"
+  resolved "https://registry.yarnpkg.com/basic-ftp/-/basic-ftp-5.0.5.tgz#14a474f5fffecca1f4f406f1c26b18f800225ac0"
+  integrity sha512-4Bcg1P8xhUuqcii/S0Z9wiHIrQVPMermM1any+MX5GeGD7faD3/msQUDGLol9wOcz4/jbg/WJnGqoJF6LiBdtg==
+
 batch@0.6.1:
   version "0.6.1"
   resolved "https://registry.yarnpkg.com/batch/-/batch-0.6.1.tgz#dc34314f4e679318093fc760272525f94bf25c16"
@@ -1178,6 +1278,11 @@ browserslist@^4.14.5:
     escalade "^3.1.1"
     node-releases "^1.1.70"
 
+buffer-crc32@~0.2.3:
+  version "0.2.13"
+  resolved "https://registry.yarnpkg.com/buffer-crc32/-/buffer-crc32-0.2.13.tgz#0d333e3f00eac50aa1454abd30ef8c2a5d9a7242"
+  integrity sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==
+
 buffer-from@^1.0.0:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/buffer-from/-/buffer-from-1.1.1.tgz#32713bc028f75c02fdb710d7c7bcec1f2c6070ef"
@@ -1312,6 +1417,14 @@ chrome-trace-event@^1.0.2:
   dependencies:
     tslib "^1.9.0"
 
+chromium-bidi@4.1.1:
+  version "4.1.1"
+  resolved "https://registry.yarnpkg.com/chromium-bidi/-/chromium-bidi-4.1.1.tgz#e1c34154ddd94473f180fd15158a24d36049e3d5"
+  integrity sha512-biR7t4vF3YluE6RlMSk9IWk+b9U+WWyzHp+N2pL9vRTk+UXHYRTVp7jTK58ZNzMLBgoLMHY4QyJMbeuw3eKxqg==
+  dependencies:
+    mitt "^3.0.1"
+    zod "^3.24.1"
+
 class-utils@^0.3.5:
   version "0.3.6"
   resolved "https://registry.yarnpkg.com/class-utils/-/class-utils-0.3.6.tgz#f93369ae8b9a7ce02fd41faad0ca83033190c463"
@@ -1350,6 +1463,15 @@ cliui@^5.0.0:
     strip-ansi "^5.2.0"
     wrap-ansi "^5.1.0"
 
+cliui@^8.0.1:
+  version "8.0.1"
+  resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa"
+  integrity sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==
+  dependencies:
+    string-width "^4.2.0"
+    strip-ansi "^6.0.1"
+    wrap-ansi "^7.0.0"
+
 clone-buffer@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/clone-buffer/-/clone-buffer-1.0.0.tgz#e3e25b207ac4e701af721e2cb5a16792cac3dc58"
@@ -1526,6 +1648,16 @@ core-util-is@~1.0.0:
   resolved "https://registry.yarnpkg.com/core-util-is/-/core-util-is-1.0.2.tgz#b5fd54220aa2bc5ab57aab7140c940754503c1a7"
   integrity sha1-tf1UIgqivFq1eqtxQMlAdUUDwac=
 
+cosmiconfig@^9.0.0:
+  version "9.0.0"
+  resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-9.0.0.tgz#34c3fc58287b915f3ae905ab6dc3de258b55ad9d"
+  integrity sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==
+  dependencies:
+    env-paths "^2.2.1"
+    import-fresh "^3.3.0"
+    js-yaml "^4.1.0"
+    parse-json "^5.2.0"
+
 create-error-class@^3.0.0:
   version "3.0.2"
   resolved "https://registry.yarnpkg.com/create-error-class/-/create-error-class-3.0.2.tgz#06be7abef947a3f14a30fd610671d401bca8b7b6"
@@ -1567,6 +1699,11 @@ dargs@^6.1.0:
   resolved "https://registry.yarnpkg.com/dargs/-/dargs-6.1.0.tgz#1f3b9b56393ecf8caa7cbfd6c31496ffcfb9b272"
   integrity sha512-5dVBvpBLBnPwSsYXqfybFyehMmC/EenKEcf23AhCTgTf48JFBbmJKqoZBsERDnjL0FyiVTYWdFsRfTLHxLyKdQ==
 
+data-uri-to-buffer@^6.0.2:
+  version "6.0.2"
+  resolved "https://registry.yarnpkg.com/data-uri-to-buffer/-/data-uri-to-buffer-6.0.2.tgz#8a58bb67384b261a38ef18bea1810cb01badd28b"
+  integrity sha512-7hvf7/GW8e86rW0ptuwS3OcBGDjIi6SZva7hCyWC0yYry2cOPmLIjXAUHI6DK2HsnwJd9ifmt57i8eV2n4YNpw==
+
 dateformat@^3.0.3:
   version "3.0.3"
   resolved "https://registry.yarnpkg.com/dateformat/-/dateformat-3.0.3.tgz#a6e37499a4d9a9cf85ef5872044d62901c9889ae"
@@ -1579,6 +1716,13 @@ debug@2.6.9, debug@^2.2.0, debug@^2.3.3:
   dependencies:
     ms "2.0.0"
 
+debug@4, debug@^4.3.1, debug@^4.3.2, debug@^4.4.0:
+  version "4.4.0"
+  resolved "https://registry.yarnpkg.com/debug/-/debug-4.4.0.tgz#2b3f2aea2ffeb776477460267377dc8710faba8a"
+  integrity sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==
+  dependencies:
+    ms "^2.1.3"
+
 debug@^3.1.0, debug@^3.1.1, debug@^3.2.6:
   version "3.2.7"
   resolved "https://registry.yarnpkg.com/debug/-/debug-3.2.7.tgz#72580b7e9145fb39b6676f9c5e5fb100b934179a"
@@ -1593,13 +1737,6 @@ debug@^4.1.0, debug@^4.1.1:
   dependencies:
     ms "2.1.2"
 
-debug@^4.3.1, debug@^4.3.2:
-  version "4.4.0"
-  resolved "https://registry.yarnpkg.com/debug/-/debug-4.4.0.tgz#2b3f2aea2ffeb776477460267377dc8710faba8a"
-  integrity sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==
-  dependencies:
-    ms "^2.1.3"
-
 debug@^4.3.4:
   version "4.3.4"
   resolved "https://registry.yarnpkg.com/debug/-/debug-4.3.4.tgz#1319f6579357f2338d3337d2cdd4914bb5dcc865"
@@ -1688,6 +1825,15 @@ define-property@^2.0.2:
     is-descriptor "^1.0.2"
     isobject "^3.0.1"
 
+degenerator@^5.0.0:
+  version "5.0.1"
+  resolved "https://registry.yarnpkg.com/degenerator/-/degenerator-5.0.1.tgz#9403bf297c6dad9a1ece409b37db27954f91f2f5"
+  integrity sha512-TllpMR/t0M5sqCXfj85i4XaAzxmS5tVA16dqvdkMwGmzI+dXLXnw3J+3Vdv7VKw+ThlTMboK6i9rnZ6Nntj5CQ==
+  dependencies:
+    ast-types "^0.13.4"
+    escodegen "^2.1.0"
+    esprima "^4.0.1"
+
 del@^4.1.1:
   version "4.1.1"
   resolved "https://registry.yarnpkg.com/del/-/del-4.1.1.tgz#9e8f117222ea44a31ff3a156c049b99052a9f0b4"
@@ -1721,6 +1867,11 @@ detect-node@^2.0.4:
   resolved "https://registry.yarnpkg.com/detect-node/-/detect-node-2.0.4.tgz#014ee8f8f669c5c58023da64b8179c083a28c46c"
   integrity sha512-ZIzRpLJrOj7jjP2miAtgqIfmzbxa4ZOr5jJc601zklsfEx9oTzmmj2nVpIPRpNlRTIh8lc1kyViIY7BWSGNmKw==
 
+devtools-protocol@0.0.1425554:
+  version "0.0.1425554"
+  resolved "https://registry.yarnpkg.com/devtools-protocol/-/devtools-protocol-0.0.1425554.tgz#51ed2fed1405f56783d24a393f7c75b6bbb58029"
+  integrity sha512-uRfxR6Nlzdzt0ihVIkV+sLztKgs7rgquY/Mhcv1YNCWDh5IZgl5mnn2aeEnW5stYTE0wwiF4RYVz8eMEpV1SEw==
+
 diff@^3.5.0:
   version "3.5.0"
   resolved "https://registry.yarnpkg.com/diff/-/diff-3.5.0.tgz#800c0dd1e0a8bfbc95835c202ad220fe317e5a12"
@@ -1854,6 +2005,11 @@ enquirer@^2.3.6:
   dependencies:
     ansi-colors "^4.1.1"
 
+env-paths@^2.2.1:
+  version "2.2.1"
+  resolved "https://registry.yarnpkg.com/env-paths/-/env-paths-2.2.1.tgz#420399d416ce1fbe9bc0a07c62fa68d67fd0f8f2"
+  integrity sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==
+
 envinfo@^7.7.3:
   version "7.7.4"
   resolved "https://registry.yarnpkg.com/envinfo/-/envinfo-7.7.4.tgz#c6311cdd38a0e86808c1c9343f667e4267c4a320"
@@ -1910,6 +2066,17 @@ escape-string-regexp@^4.0.0:
   resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz#14ba83a5d373e3d311e5afca29cf5bfad965bf34"
   integrity sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==
 
+escodegen@^2.1.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/escodegen/-/escodegen-2.1.0.tgz#ba93bbb7a43986d29d6041f99f5262da773e2e17"
+  integrity sha512-2NlIDTwUWJN0mRPQOdtQBzbUHvdGY2P1VXSyU83Q3xKxM7WHX2Ql8dKq782Q9TgQUNOLEzEYu9bzLNj1q88I5w==
+  dependencies:
+    esprima "^4.0.1"
+    estraverse "^5.2.0"
+    esutils "^2.0.2"
+  optionalDependencies:
+    source-map "~0.6.1"
+
 eslint-config-prettier@^9.1.0:
   version "9.1.0"
   resolved "https://registry.yarnpkg.com/eslint-config-prettier/-/eslint-config-prettier-9.1.0.tgz#31af3d94578645966c082fcb71a5846d3c94867f"
@@ -1994,7 +2161,7 @@ espree@^9.6.0, espree@^9.6.1:
     acorn-jsx "^5.3.2"
     eslint-visitor-keys "^3.4.1"
 
-esprima@~4.0.0:
+esprima@^4.0.1, esprima@~4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/esprima/-/esprima-4.0.1.tgz#13b04cdb3e6c5d19df91ab6987a8695619b0aa71"
   integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==
@@ -2192,11 +2359,27 @@ extglob@^2.0.4:
     snapdragon "^0.8.1"
     to-regex "^3.0.1"
 
+extract-zip@^2.0.1:
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/extract-zip/-/extract-zip-2.0.1.tgz#663dca56fe46df890d5f131ef4a06d22bb8ba13a"
+  integrity sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==
+  dependencies:
+    debug "^4.1.1"
+    get-stream "^5.1.0"
+    yauzl "^2.10.0"
+  optionalDependencies:
+    "@types/yauzl" "^2.9.1"
+
 fast-deep-equal@^3.1.1, fast-deep-equal@^3.1.3:
   version "3.1.3"
   resolved "https://registry.yarnpkg.com/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz#3a7d56b559d6cbc3eb512325244e619a65c6c525"
   integrity sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==
 
+fast-fifo@^1.2.0, fast-fifo@^1.3.2:
+  version "1.3.2"
+  resolved "https://registry.yarnpkg.com/fast-fifo/-/fast-fifo-1.3.2.tgz#286e31de96eb96d38a97899815740ba2a4f3640c"
+  integrity sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==
+
 fast-glob@^2.0.2, fast-glob@^2.2.6:
   version "2.2.7"
   resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-2.2.7.tgz#6953857c3afa475fff92ee6015d52da70a4cd39d"
@@ -2249,6 +2432,13 @@ faye-websocket@^0.11.3:
   dependencies:
     websocket-driver ">=0.5.1"
 
+fd-slicer@~1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/fd-slicer/-/fd-slicer-1.1.0.tgz#25c7c89cb1f9077f8891bbe61d8f390eae256f1e"
+  integrity sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==
+  dependencies:
+    pend "~1.2.0"
+
 figures@^3.0.0:
   version "3.2.0"
   resolved "https://registry.yarnpkg.com/figures/-/figures-3.2.0.tgz#625c18bd293c604dc4a8ddb2febf0c88341746af"
@@ -2430,7 +2620,7 @@ gensync@^1.0.0-beta.1:
   resolved "https://registry.yarnpkg.com/gensync/-/gensync-1.0.0-beta.2.tgz#32a6ee76c3d7f52d46b2b1ae5d93fea8580a25e0"
   integrity sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==
 
-get-caller-file@^2.0.1:
+get-caller-file@^2.0.1, get-caller-file@^2.0.5:
   version "2.0.5"
   resolved "https://registry.yarnpkg.com/get-caller-file/-/get-caller-file-2.0.5.tgz#4f94412a82db32f36e3b0b9741f8a97feb031f7e"
   integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==
@@ -2468,6 +2658,15 @@ get-stream@^6.0.0:
   resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-6.0.0.tgz#3e0012cb6827319da2706e601a1583e8629a6718"
   integrity sha512-A1B3Bh1UmL0bidM/YX2NsCOTnGJePL9rO/M+Mw3m9f2gUpfokS0hi5Eah0WSUEWZdZhIZtMjkIYS7mDfOqNHbg==
 
+get-uri@^6.0.1:
+  version "6.0.4"
+  resolved "https://registry.yarnpkg.com/get-uri/-/get-uri-6.0.4.tgz#6daaee9e12f9759e19e55ba313956883ef50e0a7"
+  integrity sha512-E1b1lFFLvLgak2whF2xDBcOy6NLVGZBqqjJjsIhvopKfWWEi64pLVTWWehV8KlLerZkfNTA95sTe2OdJKm1OzQ==
+  dependencies:
+    basic-ftp "^5.0.2"
+    data-uri-to-buffer "^6.0.2"
+    debug "^4.3.4"
+
 get-value@^2.0.3, get-value@^2.0.6:
   version "2.0.6"
   resolved "https://registry.yarnpkg.com/get-value/-/get-value-2.0.6.tgz#dc15ca1c672387ca76bd37ac0a395ba2042a2c28"
@@ -2806,6 +3005,14 @@ http-parser-js@>=0.5.1:
   resolved "https://registry.yarnpkg.com/http-parser-js/-/http-parser-js-0.5.3.tgz#01d2709c79d41698bb01d4decc5e9da4e4a033d9"
   integrity sha512-t7hjvef/5HEK7RWTdUzVUhl8zkEu+LlaE0IYzdMuvbSDipxBRpOn4Uhw8ZyECEa808iVT8XCjzo6xmYt4CiLZg==
 
+http-proxy-agent@^7.0.0, http-proxy-agent@^7.0.1:
+  version "7.0.2"
+  resolved "https://registry.yarnpkg.com/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz#9a8b1f246866c028509486585f62b8f2c18c270e"
+  integrity sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==
+  dependencies:
+    agent-base "^7.1.0"
+    debug "^4.3.4"
+
 http-proxy-middleware@0.19.1:
   version "0.19.1"
   resolved "https://registry.yarnpkg.com/http-proxy-middleware/-/http-proxy-middleware-0.19.1.tgz#183c7dc4aa1479150306498c210cdaf96080a43a"
@@ -2833,6 +3040,14 @@ http2-wrapper@^1.0.0-beta.5.2:
     quick-lru "^5.1.1"
     resolve-alpn "^1.0.0"
 
+https-proxy-agent@^7.0.6:
+  version "7.0.6"
+  resolved "https://registry.yarnpkg.com/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz#da8dfeac7da130b05c2ba4b59c9b6cd66611a6b9"
+  integrity sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==
+  dependencies:
+    agent-base "^7.1.2"
+    debug "4"
+
 human-signals@^1.1.1:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/human-signals/-/human-signals-1.1.1.tgz#c5b1cd14f50aeae09ab6c59fe63ba3395fe4dfa3"
@@ -2843,6 +3058,11 @@ human-signals@^2.1.0:
   resolved "https://registry.yarnpkg.com/human-signals/-/human-signals-2.1.0.tgz#dc91fcba42e4d06e4abaed33b3e7a3c02f514ea0"
   integrity sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==
 
+hyperdyperid@^1.2.0:
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/hyperdyperid/-/hyperdyperid-1.2.0.tgz#59668d323ada92228d2a869d3e474d5a33b69e6b"
+  integrity sha512-Y93lCzHYgGWdrJ66yIktxiaGULYc6oGiABxhcO5AufBeOyoIdZF7bIfLaOrbM0iGIOXQQgxxRrFEnb+Y6w1n4A==
+
 iconv-lite@0.4.24, iconv-lite@^0.4.24:
   version "0.4.24"
   resolved "https://registry.yarnpkg.com/iconv-lite/-/iconv-lite-0.4.24.tgz#2022b4b25fbddc21d2f524974a474aafe733908b"
@@ -2865,7 +3085,7 @@ ignore@^5.2.0, ignore@^5.3.1:
   resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.3.2.tgz#3cd40e729f3643fd87cb04e50bf0eb722bc596f5"
   integrity sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==
 
-import-fresh@^3.2.1:
+import-fresh@^3.2.1, import-fresh@^3.3.0:
   version "3.3.1"
   resolved "https://registry.yarnpkg.com/import-fresh/-/import-fresh-3.3.1.tgz#9cecb56503c0ada1f2741dbbd6546e4b13b57ccf"
   integrity sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==
@@ -2954,6 +3174,14 @@ interpret@^2.2.0:
   resolved "https://registry.yarnpkg.com/interpret/-/interpret-2.2.0.tgz#1a78a0b5965c40a5416d007ad6f50ad27c417df9"
   integrity sha512-Ju0Bz/cEia55xDwUWEa8+olFpCiQoypjnQySseKtmjNrnps3P+xfpUmGr90T7yjlVJmOtybRvPXhKMbHr+fWnw==
 
+ip-address@^9.0.5:
+  version "9.0.5"
+  resolved "https://registry.yarnpkg.com/ip-address/-/ip-address-9.0.5.tgz#117a960819b08780c3bd1f14ef3c1cc1d3f3ea5a"
+  integrity sha512-zHtQzGojZXTwZTHQqra+ETKd4Sn3vgi7uBmlPoXVWZqYvuKmtI0l/VZTjqGmJY9x88GGOaZ9+G9ES8hC4T4X8g==
+  dependencies:
+    jsbn "1.1.0"
+    sprintf-js "^1.1.3"
+
 ip-regex@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/ip-regex/-/ip-regex-2.1.0.tgz#fa78bf5d2e6913c911ce9f819ee5146bb6d844e9"
@@ -3269,6 +3497,11 @@ js-yaml@^4.1.0:
   dependencies:
     argparse "^2.0.1"
 
+jsbn@1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/jsbn/-/jsbn-1.1.0.tgz#b01307cb29b618a1ed26ec79e911f803c4da0040"
+  integrity sha512-4bYVV3aAMtDTTu4+xsDYa6sy9GyJ69/amsu9sYF2zqjiEoZA5xJi3BrfX3uY+/IekIu7MwdObdbDWpoZdBv3/A==
+
 jscodeshift@^0.11.0:
   version "0.11.0"
   resolved "https://registry.yarnpkg.com/jscodeshift/-/jscodeshift-0.11.0.tgz#4f95039408f3f06b0e39bb4d53bc3139f5330e2f"
@@ -3472,6 +3705,11 @@ lru-cache@^6.0.0:
   dependencies:
     yallist "^4.0.0"
 
+lru-cache@^7.14.1:
+  version "7.18.3"
+  resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-7.18.3.tgz#f793896e0fd0e954a59dfdd82f0773808df6aa89"
+  integrity sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==
+
 make-dir@^2.0.0, make-dir@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/make-dir/-/make-dir-2.1.0.tgz#5f0310e18b8be898cc07009295a30ae41e91e6f5"
@@ -3547,6 +3785,16 @@ mem-fs@^1.1.0:
     vinyl "^2.0.1"
     vinyl-file "^3.0.0"
 
+memfs@^4.17.0:
+  version "4.17.0"
+  resolved "https://registry.yarnpkg.com/memfs/-/memfs-4.17.0.tgz#a3c4b5490b9b1e7df5d433adc163e08208ce7ca2"
+  integrity sha512-4eirfZ7thblFmqFjywlTmuWVSvccHAJbn1r8qQLzmTO11qcqpohOjmY2mFce6x7x7WtskzRqApPD0hv+Oa74jg==
+  dependencies:
+    "@jsonjoy.com/json-pack" "^1.0.3"
+    "@jsonjoy.com/util" "^1.3.0"
+    tree-dump "^1.0.1"
+    tslib "^2.0.0"
+
 memory-fs@^0.4.1:
   version "0.4.1"
   resolved "https://registry.yarnpkg.com/memory-fs/-/memory-fs-0.4.1.tgz#3a9a20b8462523e447cfbc7e8bb80ed667bfc552"
@@ -3686,6 +3934,11 @@ minimist@^1.2.5:
   resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602"
   integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw==
 
+mitt@^3.0.1:
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/mitt/-/mitt-3.0.1.tgz#ea36cf0cc30403601ae074c8f77b7092cdab36d1"
+  integrity sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==
+
 mixin-deep@^1.2.0:
   version "1.3.2"
   resolved "https://registry.yarnpkg.com/mixin-deep/-/mixin-deep-1.3.2.tgz#1120b43dc359a785dce65b55b82e257ccf479566"
@@ -3797,6 +4050,11 @@ neo-async@^2.5.0, neo-async@^2.6.2:
   resolved "https://registry.yarnpkg.com/neo-async/-/neo-async-2.6.2.tgz#b4aafb93e3aeb2d8174ca53cf163ab7d7308305f"
   integrity sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==
 
+netmask@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/netmask/-/netmask-2.0.2.tgz#8b01a07644065d536383835823bc52004ebac5e7"
+  integrity sha512-dBpDMdxv9Irdq66304OLfEmQ9tbNRFnFTuZiLo+bD+r332bBmMJ8GBLXklIXXgxd3+v9+KUnZaUR5PJMa75Gsg==
+
 nice-try@^1.0.4:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/nice-try/-/nice-try-1.0.5.tgz#a3378a7696ce7d223e88fc9b764bd7ef1089e366"
@@ -4062,6 +4320,28 @@ p-try@^2.0.0, p-try@^2.1.0:
   resolved "https://registry.yarnpkg.com/p-try/-/p-try-2.2.0.tgz#cb2868540e313d61de58fafbe35ce9004d5540e6"
   integrity sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==
 
+pac-proxy-agent@^7.1.0:
+  version "7.2.0"
+  resolved "https://registry.yarnpkg.com/pac-proxy-agent/-/pac-proxy-agent-7.2.0.tgz#9cfaf33ff25da36f6147a20844230ec92c06e5df"
+  integrity sha512-TEB8ESquiLMc0lV8vcd5Ql/JAKAoyzHFXaStwjkzpOpC5Yv+pIzLfHvjTSdf3vpa2bMiUQrg9i6276yn8666aA==
+  dependencies:
+    "@tootallnate/quickjs-emscripten" "^0.23.0"
+    agent-base "^7.1.2"
+    debug "^4.3.4"
+    get-uri "^6.0.1"
+    http-proxy-agent "^7.0.0"
+    https-proxy-agent "^7.0.6"
+    pac-resolver "^7.0.1"
+    socks-proxy-agent "^8.0.5"
+
+pac-resolver@^7.0.1:
+  version "7.0.1"
+  resolved "https://registry.yarnpkg.com/pac-resolver/-/pac-resolver-7.0.1.tgz#54675558ea368b64d210fd9c92a640b5f3b8abb6"
+  integrity sha512-5NPgf87AT2STgwa2ntRMr45jTKrYBGkVU36yT0ig/n/GMAa3oPqhZfIQ2kMEimReg0+t9kZViDVZ83qfVUlckg==
+  dependencies:
+    degenerator "^5.0.0"
+    netmask "^2.0.2"
+
 paged-request@^2.0.1:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/paged-request/-/paged-request-2.0.2.tgz#4d621a08b8d6bee4440a0a92112354eeece5b5b0"
@@ -4076,7 +4356,7 @@ parent-module@^1.0.0:
   dependencies:
     callsites "^3.0.0"
 
-parse-json@^5.0.0:
+parse-json@^5.0.0, parse-json@^5.2.0:
   version "5.2.0"
   resolved "https://registry.yarnpkg.com/parse-json/-/parse-json-5.2.0.tgz#c76fc66dee54231c962b22bcc8a72cf2f99753cd"
   integrity sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==
@@ -4153,6 +4433,11 @@ path-type@^3.0.0:
   dependencies:
     pify "^3.0.0"
 
+pend@~1.2.0:
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/pend/-/pend-1.2.0.tgz#7a57eb550a6783f9115331fcf4663d5c8e007a50"
+  integrity sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==
+
 picomatch@^2.0.5:
   version "2.2.2"
   resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-2.2.2.tgz#21f333e9b6b8eaff02468f5146ea406d345f4dad"
@@ -4250,6 +4535,11 @@ process-nextick-args@^2.0.0, process-nextick-args@~2.0.0:
   resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-2.0.1.tgz#7820d9b16120cc55ca9ae7792680ae7dba6d7fe2"
   integrity sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==
 
+progress@^2.0.3:
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/progress/-/progress-2.0.3.tgz#7e8cf8d8f5b8f239c1bc68beb4eb78567d572ef8"
+  integrity sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==
+
 proxy-addr@~2.0.5:
   version "2.0.6"
   resolved "https://registry.yarnpkg.com/proxy-addr/-/proxy-addr-2.0.6.tgz#fdc2336505447d3f2f2c638ed272caf614bbb2bf"
@@ -4258,6 +4548,25 @@ proxy-addr@~2.0.5:
     forwarded "~0.1.2"
     ipaddr.js "1.9.1"
 
+proxy-agent@^6.5.0:
+  version "6.5.0"
+  resolved "https://registry.yarnpkg.com/proxy-agent/-/proxy-agent-6.5.0.tgz#9e49acba8e4ee234aacb539f89ed9c23d02f232d"
+  integrity sha512-TmatMXdr2KlRiA2CyDu8GqR8EjahTG3aY3nXjdzFyoZbmB8hrBsTyMezhULIXKnC0jpfjlmiZ3+EaCzoInSu/A==
+  dependencies:
+    agent-base "^7.1.2"
+    debug "^4.3.4"
+    http-proxy-agent "^7.0.1"
+    https-proxy-agent "^7.0.6"
+    lru-cache "^7.14.1"
+    pac-proxy-agent "^7.1.0"
+    proxy-from-env "^1.1.0"
+    socks-proxy-agent "^8.0.5"
+
+proxy-from-env@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/proxy-from-env/-/proxy-from-env-1.1.0.tgz#e102f16ca355424865755d2c9e8ea4f24d58c3e2"
+  integrity sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==
+
 prr@~1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/prr/-/prr-1.0.1.tgz#d3fc114ba06995a45ec6893f484ceb1d78f5f476"
@@ -4281,6 +4590,30 @@ punycode@^2.1.0:
   resolved "https://registry.yarnpkg.com/punycode/-/punycode-2.1.1.tgz#b58b010ac40c22c5657616c8d2c2c02c7bf479ec"
   integrity sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==
 
+puppeteer-core@24.7.2:
+  version "24.7.2"
+  resolved "https://registry.yarnpkg.com/puppeteer-core/-/puppeteer-core-24.7.2.tgz#734e377a5634ce1e419fa3ce20ad297a7e1a99ff"
+  integrity sha512-P9pZyTmJqKODFCnkZgemCpoFA4LbAa8+NumHVQKyP5X9IgdNS1ZnAnIh1sMAwhF8/xEUGf7jt+qmNLlKieFw1Q==
+  dependencies:
+    "@puppeteer/browsers" "2.10.2"
+    chromium-bidi "4.1.1"
+    debug "^4.4.0"
+    devtools-protocol "0.0.1425554"
+    typed-query-selector "^2.12.0"
+    ws "^8.18.1"
+
+puppeteer@^24.7.2:
+  version "24.7.2"
+  resolved "https://registry.yarnpkg.com/puppeteer/-/puppeteer-24.7.2.tgz#1798b05db1a8b99f592239b11b54a470a56cdace"
+  integrity sha512-ifYqoY6wGs0yZeFuFPn8BE9FhuveXkarF+eO18I2e/axdoCh4Qh1AE+qXdJBhdaeoPt6eRNTY4Dih29Jbq8wow==
+  dependencies:
+    "@puppeteer/browsers" "2.10.2"
+    chromium-bidi "4.1.1"
+    cosmiconfig "^9.0.0"
+    devtools-protocol "0.0.1425554"
+    puppeteer-core "24.7.2"
+    typed-query-selector "^2.12.0"
+
 qs@6.7.0:
   version "6.7.0"
   resolved "https://registry.yarnpkg.com/qs/-/qs-6.7.0.tgz#41dc1a015e3d581f1621776be31afb2876a9b1bc"
@@ -4671,7 +5004,7 @@ semver@^7.3.4:
   dependencies:
     lru-cache "^6.0.0"
 
-semver@^7.6.0:
+semver@^7.6.0, semver@^7.7.1:
   version "7.7.1"
   resolved "https://registry.yarnpkg.com/semver/-/semver-7.7.1.tgz#abd5098d82b18c6c81f6074ff2647fd3e7220c9f"
   integrity sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==
@@ -4812,6 +5145,11 @@ slash@^2.0.0:
   resolved "https://registry.yarnpkg.com/slash/-/slash-2.0.0.tgz#de552851a1759df3a8f206535442f5ec4ddeab44"
   integrity sha512-ZYKh3Wh2z1PpEXWr0MpSBZ0V6mZHAQfYevttO11c51CaWjGTaadiKZ+wVt1PbMlDV5qhMFslpZCemhwOK7C89A==
 
+smart-buffer@^4.2.0:
+  version "4.2.0"
+  resolved "https://registry.yarnpkg.com/smart-buffer/-/smart-buffer-4.2.0.tgz#6e1d71fa4f18c05f7d0ff216dd16a481d0e8d9ae"
+  integrity sha512-94hK0Hh8rPqQl2xXc3HsaBoOXKV20MToPkcXvwbISWLEs+64sBq5kFgn2kJDHb1Pry9yrP0dxrCI9RRci7RXKg==
+
 snapdragon-node@^2.0.1:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/snapdragon-node/-/snapdragon-node-2.1.1.tgz#6c175f86ff14bdb0724563e8f3c1b021a286853b"
@@ -4863,6 +5201,23 @@ sockjs@^0.3.21:
     uuid "^3.4.0"
     websocket-driver "^0.7.4"
 
+socks-proxy-agent@^8.0.5:
+  version "8.0.5"
+  resolved "https://registry.yarnpkg.com/socks-proxy-agent/-/socks-proxy-agent-8.0.5.tgz#b9cdb4e7e998509d7659d689ce7697ac21645bee"
+  integrity sha512-HehCEsotFqbPW9sJ8WVYB6UbmIMv7kUUORIF2Nncq4VQvBfNBLibW9YZR5dlYCSUhwcD628pRllm7n+E+YTzJw==
+  dependencies:
+    agent-base "^7.1.2"
+    debug "^4.3.4"
+    socks "^2.8.3"
+
+socks@^2.8.3:
+  version "2.8.4"
+  resolved "https://registry.yarnpkg.com/socks/-/socks-2.8.4.tgz#07109755cdd4da03269bda4725baa061ab56d5cc"
+  integrity sha512-D3YaD0aRxR3mEcqnidIs7ReYJFVzWdd6fXJYUM8ixcQcJRGTka/b3saV0KflYhyVJXKhb947GndU35SxYNResQ==
+  dependencies:
+    ip-address "^9.0.5"
+    smart-buffer "^4.2.0"
+
 source-map-resolve@^0.5.0:
   version "0.5.3"
   resolved "https://registry.yarnpkg.com/source-map-resolve/-/source-map-resolve-0.5.3.tgz#190866bece7553e1f8f267a2ee82c606b5509a1a"
@@ -4961,6 +5316,11 @@ split-string@^3.0.1, split-string@^3.0.2:
   dependencies:
     extend-shallow "^3.0.0"
 
+sprintf-js@^1.1.3:
+  version "1.1.3"
+  resolved "https://registry.yarnpkg.com/sprintf-js/-/sprintf-js-1.1.3.tgz#4914b903a2f8b685d17fdf78a70e917e872e444a"
+  integrity sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==
+
 static-extend@^0.1.1:
   version "0.1.2"
   resolved "https://registry.yarnpkg.com/static-extend/-/static-extend-0.1.2.tgz#60809c39cbff55337226fd5e0b520f341f1fb5c6"
@@ -4974,6 +5334,16 @@ static-extend@^0.1.1:
   resolved "https://registry.yarnpkg.com/statuses/-/statuses-1.5.0.tgz#161c7dac177659fd9811f43771fa99381478628c"
   integrity sha1-Fhx9rBd2Wf2YEfQ3cfqZOBR4Yow=
 
+streamx@^2.15.0, streamx@^2.21.0:
+  version "2.22.0"
+  resolved "https://registry.yarnpkg.com/streamx/-/streamx-2.22.0.tgz#cd7b5e57c95aaef0ff9b2aef7905afa62ec6e4a7"
+  integrity sha512-sLh1evHOzBy/iWRiR6d1zRcLao4gGZr3C1kzNz4fopCOKJb6xD9ub8Mpi9Mr1R6id5o43S+d93fI48UC5uM9aw==
+  dependencies:
+    fast-fifo "^1.3.2"
+    text-decoder "^1.1.0"
+  optionalDependencies:
+    bare-events "^2.2.0"
+
 string-template@~0.2.1:
   version "0.2.1"
   resolved "https://registry.yarnpkg.com/string-template/-/string-template-0.2.1.tgz#42932e598a352d01fc22ec3367d9d84eec6c9add"
@@ -4997,6 +5367,15 @@ string-width@^4.1.0:
     is-fullwidth-code-point "^3.0.0"
     strip-ansi "^6.0.0"
 
+string-width@^4.2.0, string-width@^4.2.3:
+  version "4.2.3"
+  resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
+  integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
+  dependencies:
+    emoji-regex "^8.0.0"
+    is-fullwidth-code-point "^3.0.0"
+    strip-ansi "^6.0.1"
+
 string_decoder@^1.1.1:
   version "1.3.0"
   resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.3.0.tgz#42f114594a46cf1a8e30b0a84f56c78c3edac21e"
@@ -5116,6 +5495,26 @@ tapable@^2.1.1, tapable@^2.2.0:
   resolved "https://registry.yarnpkg.com/tapable/-/tapable-2.2.0.tgz#5c373d281d9c672848213d0e037d1c4165ab426b"
   integrity sha512-FBk4IesMV1rBxX2tfiK8RAmogtWn53puLOQlvO8XuwlgxcYbP4mVPS9Ph4aeamSyyVjOl24aYWAuc8U5kCVwMw==
 
+tar-fs@^3.0.8:
+  version "3.0.8"
+  resolved "https://registry.yarnpkg.com/tar-fs/-/tar-fs-3.0.8.tgz#8f62012537d5ff89252d01e48690dc4ebed33ab7"
+  integrity sha512-ZoROL70jptorGAlgAYiLoBLItEKw/fUxg9BSYK/dF/GAGYFJOJJJMvjPAKDJraCXFwadD456FCuvLWgfhMsPwg==
+  dependencies:
+    pump "^3.0.0"
+    tar-stream "^3.1.5"
+  optionalDependencies:
+    bare-fs "^4.0.1"
+    bare-path "^3.0.0"
+
+tar-stream@^3.1.5:
+  version "3.1.7"
+  resolved "https://registry.yarnpkg.com/tar-stream/-/tar-stream-3.1.7.tgz#24b3fb5eabada19fe7338ed6d26e5f7c482e792b"
+  integrity sha512-qJj60CXt7IU1Ffyc3NJMjh6EkuCFej46zUqJ4J7pqYlThyd9bO0XBTmcOIhSzZJVWfsLks0+nle/j538YAW9RQ==
+  dependencies:
+    b4a "^1.6.4"
+    fast-fifo "^1.2.0"
+    streamx "^2.15.0"
+
 temp@^0.8.1:
   version "0.8.4"
   resolved "https://registry.yarnpkg.com/temp/-/temp-0.8.4.tgz#8c97a33a4770072e0a05f919396c7665a7dd59f2"
@@ -5144,6 +5543,13 @@ terser@^5.14.1:
     commander "^2.20.0"
     source-map-support "~0.5.20"
 
+text-decoder@^1.1.0:
+  version "1.2.3"
+  resolved "https://registry.yarnpkg.com/text-decoder/-/text-decoder-1.2.3.tgz#b19da364d981b2326d5f43099c310cc80d770c65"
+  integrity sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==
+  dependencies:
+    b4a "^1.6.4"
+
 text-table@^0.2.0:
   version "0.2.0"
   resolved "https://registry.yarnpkg.com/text-table/-/text-table-0.2.0.tgz#7f5ee823ae805207c00af2df4a84ec3fcfa570b4"
@@ -5154,6 +5560,11 @@ textextensions@^2.5.0:
   resolved "https://registry.yarnpkg.com/textextensions/-/textextensions-2.6.0.tgz#d7e4ab13fe54e32e08873be40d51b74229b00fc4"
   integrity sha512-49WtAWS+tcsy93dRt6P0P3AMD2m5PvXRhuEA0kaXos5ZLlujtYmpmFsB+QvWUSxE1ZsstmYXfQ7L40+EcQgpAQ==
 
+thingies@^1.20.0:
+  version "1.21.0"
+  resolved "https://registry.yarnpkg.com/thingies/-/thingies-1.21.0.tgz#e80fbe58fd6fdaaab8fad9b67bd0a5c943c445c1"
+  integrity sha512-hsqsJsFMsV+aD4s3CWKk85ep/3I9XzYV/IXaSouJMYIoDlgyi11cBhsqYe9/geRfB0YIikBQg6raRaM+nIMP9g==
+
 through2@^3.0.0, through2@^3.0.1, through2@^3.0.2:
   version "3.0.2"
   resolved "https://registry.yarnpkg.com/through2/-/through2-3.0.2.tgz#99f88931cfc761ec7678b41d5d7336b5b6a07bf4"
@@ -5226,6 +5637,11 @@ toidentifier@1.0.0:
   resolved "https://registry.yarnpkg.com/toidentifier/-/toidentifier-1.0.0.tgz#7e1be3470f1e77948bc43d94a3c8f4d7752ba553"
   integrity sha512-yaOH/Pk/VEhBWWTlhI+qXxDFXlejDGcQipMlyxda9nthulaxLZUNcUqFxokp0vcYnvteJln5FNQDRrxj3YcbVw==
 
+tree-dump@^1.0.1:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/tree-dump/-/tree-dump-1.0.2.tgz#c460d5921caeb197bde71d0e9a7b479848c5b8ac"
+  integrity sha512-dpev9ABuLWdEubk+cIaI9cHwRNNDjkBBLXTwI4UCUFdQ5xXKqNXoK4FEciw/vxf+NQ7Cb7sGUyeUtORvHIdRXQ==
+
 ts-api-utils@^2.0.1:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/ts-api-utils/-/ts-api-utils-2.1.0.tgz#595f7094e46eed364c13fd23e75f9513d29baf91"
@@ -5246,6 +5662,11 @@ tslib@^1.9.0:
   resolved "https://registry.yarnpkg.com/tslib/-/tslib-1.14.1.tgz#cf2d38bdc34a134bcaf1091c41f6619e2f672d00"
   integrity sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==
 
+tslib@^2.0.0:
+  version "2.8.1"
+  resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.8.1.tgz#612efe4ed235d567e8aba5f2a5fab70280ade83f"
+  integrity sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==
+
 tslib@^2.0.1:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.1.0.tgz#da60860f1c2ecaa5703ab7d39bc05b6bf988b97a"
@@ -5281,6 +5702,11 @@ type-is@~1.6.17, type-is@~1.6.18:
     media-typer "0.3.0"
     mime-types "~2.1.24"
 
+typed-query-selector@^2.12.0:
+  version "2.12.0"
+  resolved "https://registry.yarnpkg.com/typed-query-selector/-/typed-query-selector-2.12.0.tgz#92b65dbc0a42655fccf4aeb1a08b1dddce8af5f2"
+  integrity sha512-SbklCd1F0EiZOyPiW192rrHZzZ5sBijB6xM+cpmrwDqObvdtunOHHIk9fCGsoK5JVIYXoyEp4iEdE3upFH3PAg==
+
 typescript@^5.7.3:
   version "5.7.3"
   resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.7.3.tgz#919b44a7dbb8583a9b856d162be24a54bf80073e"
@@ -5617,6 +6043,15 @@ wrap-ansi@^5.1.0:
     string-width "^3.0.0"
     strip-ansi "^5.0.0"
 
+wrap-ansi@^7.0.0:
+  version "7.0.0"
+  resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
+  integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
+  dependencies:
+    ansi-styles "^4.0.0"
+    string-width "^4.1.0"
+    strip-ansi "^6.0.0"
+
 wrappy@1:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f"
@@ -5638,11 +6073,21 @@ ws@^6.2.1:
   dependencies:
     async-limiter "~1.0.0"
 
+ws@^8.18.1:
+  version "8.18.1"
+  resolved "https://registry.yarnpkg.com/ws/-/ws-8.18.1.tgz#ea131d3784e1dfdff91adb0a4a116b127515e3cb"
+  integrity sha512-RKW2aJZMXeMxVpnZ6bck+RswznaxmzdULiBr6KY7XkTnW8uvt0iT9H5DkHUChXrc+uurzwa0rVI16n/Xzjdz1w==
+
 y18n@^4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/y18n/-/y18n-4.0.1.tgz#8db2b83c31c5d75099bb890b23f3094891e247d4"
   integrity sha512-wNcy4NvjMYL8gogWWYAO7ZFWFfHcbdbE57tZO8e4cbpj8tfUcwrwqSl3ad8HxpYWCdXcJUCeKKZS62Av1affwQ==
 
+y18n@^5.0.5:
+  version "5.0.8"
+  resolved "https://registry.yarnpkg.com/y18n/-/y18n-5.0.8.tgz#7f4934d0f7ca8c56f95314939ddcd2dd91ce1d55"
+  integrity sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==
+
 yallist@^4.0.0:
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/yallist/-/yallist-4.0.0.tgz#9bb92790d9c0effec63be73519e11a35019a3a72"
@@ -5656,6 +6101,11 @@ yargs-parser@^13.1.2:
     camelcase "^5.0.0"
     decamelize "^1.2.0"
 
+yargs-parser@^21.1.1:
+  version "21.1.1"
+  resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35"
+  integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==
+
 yargs@^13.3.2:
   version "13.3.2"
   resolved "https://registry.yarnpkg.com/yargs/-/yargs-13.3.2.tgz#ad7ffefec1aa59565ac915f82dccb38a9c31a2dd"
@@ -5672,6 +6122,27 @@ yargs@^13.3.2:
     y18n "^4.0.0"
     yargs-parser "^13.1.2"
 
+yargs@^17.7.2:
+  version "17.7.2"
+  resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.7.2.tgz#991df39aca675a192b816e1e0363f9d75d2aa269"
+  integrity sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==
+  dependencies:
+    cliui "^8.0.1"
+    escalade "^3.1.1"
+    get-caller-file "^2.0.5"
+    require-directory "^2.1.1"
+    string-width "^4.2.3"
+    y18n "^5.0.5"
+    yargs-parser "^21.1.1"
+
+yauzl@^2.10.0:
+  version "2.10.0"
+  resolved "https://registry.yarnpkg.com/yauzl/-/yauzl-2.10.0.tgz#c7eb17c93e112cb1086fa6d8e51fb0667b79a5f9"
+  integrity sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==
+  dependencies:
+    buffer-crc32 "~0.2.3"
+    fd-slicer "~1.1.0"
+
 yeoman-environment@^2.10.3, yeoman-environment@^2.9.5:
   version "2.10.3"
   resolved "https://registry.yarnpkg.com/yeoman-environment/-/yeoman-environment-2.10.3.tgz#9d8f42b77317414434cc0e51fb006a4bdd54688e"
@@ -5735,3 +6206,8 @@ yocto-queue@^0.1.0:
   version "0.1.0"
   resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b"
   integrity sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==
+
+zod@^3.24.1:
+  version "3.24.3"
+  resolved "https://registry.yarnpkg.com/zod/-/zod-3.24.3.tgz#1f40f750a05e477396da64438e0e1c0995dafd87"
+  integrity sha512-HhY1oqzWCQWuUqvBFnsyrtZRhyPeR7SUGv+C4+MsisMuVfSPx8HpwWqH8tRahSlt6M3PiFAcoeFhZAqIXTxoSg==

From 218cff3d454f4d922b437baf6cbdd092e382506f Mon Sep 17 00:00:00 2001
From: emma <hi@emma.cafe>
Date: Tue, 29 Apr 2025 17:01:23 -0400
Subject: [PATCH 4/5] add first pass at test harness

---
 scripts/test-harness.mjs | 48 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 scripts/test-harness.mjs

diff --git a/scripts/test-harness.mjs b/scripts/test-harness.mjs
new file mode 100644
index 0000000..0ae283f
--- /dev/null
+++ b/scripts/test-harness.mjs
@@ -0,0 +1,48 @@
+import puppeteer from "puppeteer";
+import Webpack from "webpack";
+import { fs } from "memfs";
+
+import webpackConfig from "../webpack.config.js";
+const config = webpackConfig({}, { mode: "development" });
+
+const compiler = Webpack(config);
+compiler.outputFileSystem = fs;
+
+const browser = await puppeteer.launch({ headless: false, devtools: true });
+const page = await browser.newPage();
+
+const _watching = compiler.watch({}, async (err, stats) => {
+  if (err) {
+    console.error(err);
+    console.error("Not opening browser");
+    return;
+  }
+  console.log(
+    stats.toString({
+      colors: true,
+      preset: "summary",
+    }),
+  );
+  const behaviorScript = fs.readFileSync("dist/behaviors.js", "utf8");
+
+  await page.goto(process.argv[2]);
+
+  await page.evaluate(
+    behaviorScript +
+      `
+  self.__bx_behaviors.init({
+    autofetch: true,
+    autoplay: true,
+    autoscroll: true,
+    siteSpecific: true,
+  });
+  `,
+  );
+
+  // call and await run on top frame and all child iframes
+  await Promise.allSettled(
+    page
+      .frames()
+      .map(async (frame) => frame.evaluate("self.__bx_behaviors.run()")),
+  );
+});

From 55dd85cdf7efaaaa11d755375bd1b6e166356c3e Mon Sep 17 00:00:00 2001
From: emma <hi@emma.cafe>
Date: Tue, 29 Apr 2025 17:09:12 -0400
Subject: [PATCH 5/5] add validation & npm script for test harness

---
 package.json             |  3 ++-
 scripts/test-harness.mjs | 26 +++++++++++++++++++++++++-
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/package.json b/package.json
index 8690ba9..021472e 100644
--- a/package.json
+++ b/package.json
@@ -25,7 +25,8 @@
     "watch": "webpack watch --mode production",
     "watch-dev": "webpack watch --mode development",
     "lint": "eslint ./src/**/*.ts webpack.config.js",
-    "format": "prettier --write ./src/**/*.ts webpack.config.js"
+    "format": "prettier --write ./src/**/*.ts webpack.config.js",
+    "test": "node ./scripts/test-harness.mjs"
   },
   "description": "Browsertrix Behaviors",
   "files": [
diff --git a/scripts/test-harness.mjs b/scripts/test-harness.mjs
index 0ae283f..f974d3b 100644
--- a/scripts/test-harness.mjs
+++ b/scripts/test-harness.mjs
@@ -3,6 +3,30 @@ import Webpack from "webpack";
 import { fs } from "memfs";
 
 import webpackConfig from "../webpack.config.js";
+
+/**
+ * Validate a URL
+ * @param {URL} url
+ * @returns {boolean}
+ */
+const validateUrl = (url) => {
+  try {
+    return new URL(url);
+  } catch (_e) {
+    return false;
+  }
+};
+
+if (!process.argv[2]) {
+  console.error("Usage: yarn test '<url>'");
+  process.exit(1);
+}
+
+if (!validateUrl(process.argv[2])) {
+  console.error("Invalid URL (hint: include http:// or https://)");
+  process.exit(1);
+}
+
 const config = webpackConfig({}, { mode: "development" });
 
 const compiler = Webpack(config);
@@ -25,7 +49,7 @@ const _watching = compiler.watch({}, async (err, stats) => {
   );
   const behaviorScript = fs.readFileSync("dist/behaviors.js", "utf8");
 
-  await page.goto(process.argv[2]);
+  await page.goto(validateUrl(process.argv[2]));
 
   await page.evaluate(
     behaviorScript +