HeyPuter · velzie · Jul 16, 2025 · Jul 15, 2025 · Jul 15, 2025 · Jul 16, 2025
diff --git a/INTERCEPTION_PROXY_BIBLE.md b/INTERCEPTION_PROXY_BIBLE.md
@@ -0,0 +1 @@
+# The Interception Proxy Bible
diff --git a/eslint.config.mjs b/eslint.config.mjs
@@ -53,7 +53,7 @@ export default [
 			"@typescript-eslint/no-explicit-any": "off",
 			"@typescript-eslint/ban-ts-comment": "off",
 			"@typescript-eslint/ban-types": "off",
-
+			"@typescript-eslint/no-require-imports": "off",
 			"@typescript-eslint/no-unused-vars": [
 				"warn",
 				{

diff --git a/frontend/index.html b/frontend/index.html
@@ -6,7 +6,7 @@
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
 		<title>Vite + TS</title>
 
-		<script src="/scram/scramjet.controller.js"></script>
+		<script src="/scram/scramjet.all.js"></script>
 	</head>
 
 	<body>

diff --git a/lib/index.d.ts b/lib/index.d.ts
@@ -1,16 +1,22 @@
 declare const scramjetPath: string;
 
 import * as controller from "../dist/types/controller/index.ts";
+import * as worker from "../dist/types/worker/index.ts";
 import * as types from "../dist/types/types.ts";
 import * as frame from "../dist/types/controller/frame.ts";
 
 declare global {
-	const ScramjetController: typeof controller.ScramjetController;
-	const ScramjetFrame: typeof frame.ScramjetFrame;
+	function $scramjetLoadController(): typeof controller;
+	function $scramjetLoadWorker(): typeof worker;
+	function $scramjetLoadClient(config: ScramjetConfig);
 	type ScramjetController = controller.ScramjetController;
 	type ScramjetFrame = frame.ScramjetFrame;
 
 	type ScramjetConfig = types.ScramjetConfig;
 	type ScramjetInitConfig = types.ScramjetInitConfig;
+	var $scramjetVersion: {
+		build: string;
+		version: string;
+	};
 }
 export { scramjetPath };
diff --git a/package.json b/package.json
@@ -43,8 +43,8 @@
 		"@nebula-services/bare-server-node": "^2.0.4",
 		"@playwright/test": "^1.53.1",
 		"@rsdoctor/rspack-plugin": "^1.1.5",
-		"@rspack/cli": "^1.4.1",
-		"@rspack/core": "^1.4.1",
+		"@rspack/cli": "^1.4.8",
+		"@rspack/core": "^1.4.8",
 		"@types/eslint": "^9.6.1",
 		"@types/estree": "^1.0.8",
 		"@types/node": "^24.0.6",

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/rspack.config.js b/rspack.config.js
@@ -14,10 +14,11 @@ export default defineConfig({
 	mode: "development",
 	devtool: "source-map",
 	entry: {
-		shared: join(__dirname, "src/shared/index.ts"),
-		worker: join(__dirname, "src/worker/index.ts"),
-		client: join(__dirname, "src/client/index.ts"),
-		controller: join(__dirname, "src/controller/index.ts"),
+		all: join(__dirname, "src/entry.ts"),
+		// shared: join(__dirname, "src/shared/index.ts"),
+		// worker: join(__dirname, "src/worker/index.ts"),
+		// client: join(__dirname, "src/client/index.ts"),
+		// controller: join(__dirname, "src/controller/index.ts"),
 		sync: join(__dirname, "src/sync.ts"),
 	},
 	resolve: {

diff --git a/src/client/client.ts b/src/client/client.ts
@@ -8,16 +8,18 @@ import { createLocationProxy } from "./location";
 import { nativeGetOwnPropertyDescriptor } from "./natives";
 import {
 	BareClient,
-	CookieStore,
-	config,
-	unrewriteUrl,
-	rewriteUrl,
-} from "../shared";
-import type { BareClient as BareClientType } from "@mercuryworkshop/bare-mux";
+	type BareClient as BareClientType,
+} from "@mercuryworkshop/bare-mux";
 import { createWrapFn } from "./shared/wrap";
 import { NavigateEvent } from "./events";
-import type { URLMeta } from "../shared/rewriters/url";
+import {
+	rewriteUrl,
+	unrewriteUrl,
+	type URLMeta,
+} from "../shared/rewriters/url";
 import { SourceMaps } from "./shared/sourcemaps";
+import { config } from "../shared";
+import { CookieStore } from "../shared/cookie";
 
 type NativeStore = {
 	store: Record<string, any>;
@@ -365,15 +367,14 @@ export class ScramjetClient {
 	}
 
 	hook() {
-		// @ts-ignore
 		const context = import.meta.webpackContext(".", {
 			recursive: true,
 		});
 
 		const modules: ScramjetModule[] = [];
 
 		for (const key of context.keys()) {
-			const module: ScramjetModule = context(key);
+			const module = context(key) as ScramjetModule;
 			if (!key.endsWith(".ts")) continue;
 			if (
 				(key.startsWith("./dom/") && "window" in this.global) ||

diff --git a/src/client/document.ts b/src/client/document.ts
@@ -1,4 +1,4 @@
-import { rewriteUrl } from "../shared";
+import { rewriteUrl } from "../shared/rewriters/url";
 import { ScramjetClient } from "./client";
 import { getOwnPropertyDescriptorHandler } from "./helpers";
 

diff --git a/src/client/dom/beacon.ts b/src/client/dom/beacon.ts
@@ -1,4 +1,4 @@
-import { rewriteUrl } from "../../shared";
+import { rewriteUrl } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
 
 export default function (client: ScramjetClient, _self: Self) {

diff --git a/src/client/dom/css.ts b/src/client/dom/css.ts
@@ -1,5 +1,5 @@
+import { rewriteCss, unrewriteCss } from "../../shared/rewriters/css";
 import { ScramjetClient } from "../client";
-import { rewriteCss, unrewriteCss } from "../../shared";
 
 export default function (client: ScramjetClient) {
 	client.Proxy("CSSStyleDeclaration.prototype.setProperty", {

diff --git a/src/client/dom/document.ts b/src/client/dom/document.ts
@@ -1,4 +1,4 @@
-import { rewriteHtml } from "../../shared";
+import { rewriteHtml } from "../../shared/rewriters/html";
 import { ScramjetClient } from "../client";
 
 export default function (client: ScramjetClient, _self: Self) {

diff --git a/src/client/dom/element.ts b/src/client/dom/element.ts
@@ -1,13 +1,11 @@
+import { htmlRules } from "../../shared/htmlRules";
+import { rewriteCss, unrewriteCss } from "../../shared/rewriters/css";
+import { rewriteHtml, unrewriteHtml } from "../../shared/rewriters/html";
+import { rewriteJs } from "../../shared/rewriters/js";
+import { rewriteUrl, unrewriteUrl } from "../../shared/rewriters/url";
 import { SCRAMJETCLIENT } from "../../symbols";
 import { ScramjetClient } from "../client";
 import { nativeGetOwnPropertyDescriptor } from "../natives";
-import {
-	unrewriteUrl,
-	rewriteUrl,
-	htmlRules,
-	unrewriteHtml,
-} from "../../shared";
-import { unrewriteCss, rewriteCss, rewriteHtml, rewriteJs } from "../../shared";
 
 const encoder = new TextEncoder();
 function bytesToBase64(bytes: Uint8Array) {

diff --git a/src/client/dom/fontface.ts b/src/client/dom/fontface.ts
@@ -1,5 +1,5 @@
+import { rewriteCss } from "../../shared/rewriters/css";
 import { ScramjetClient } from "../client";
-import { rewriteCss } from "../../shared";
 
 export default function (client: ScramjetClient, _self: Self) {
 	client.Proxy("FontFace", {

diff --git a/src/client/dom/history.ts b/src/client/dom/history.ts
@@ -1,5 +1,5 @@
+import { rewriteUrl } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
-import { rewriteUrl } from "../../shared";
 import { UrlChangeEvent } from "../events";
 
 export default function (client: ScramjetClient, _self: Self) {

diff --git a/src/client/dom/open.ts b/src/client/dom/open.ts
@@ -1,6 +1,6 @@
-import { rewriteUrl } from "../../shared";
 import { ScramjetClient } from "../client";
 import { SCRAMJETCLIENT } from "../../symbols";
+import { rewriteUrl } from "../../shared/rewriters/url";
 
 export default function (client: ScramjetClient) {
 	client.Proxy("window.open", {

diff --git a/src/client/dom/performance.ts b/src/client/dom/performance.ts
@@ -1,4 +1,4 @@
-import { unrewriteUrl } from "../../shared";
+import { unrewriteUrl } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
 
 export default function (client: ScramjetClient, _self: Self) {

diff --git a/src/client/dom/protocol.ts b/src/client/dom/protocol.ts
@@ -1,4 +1,4 @@
-import { rewriteUrl } from "../../shared";
+import { rewriteUrl } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
 
 export default function (client: ScramjetClient, self: Self) {

diff --git a/src/client/dom/serviceworker.ts b/src/client/dom/serviceworker.ts
@@ -1,7 +1,7 @@
-import { rewriteUrl } from "../../shared";
 import { ScramjetClient } from "../client";
 import { type MessageC2W } from "../../worker";
-import { flagEnabled } from "../../scramjet";
+import { flagEnabled } from "../../shared";
+import { rewriteUrl } from "../../shared/rewriters/url";
 
 // we need a late order because we're mangling with addEventListener at a higher level
 export const order = 2;

diff --git a/src/client/index.ts b/src/client/index.ts
@@ -1,6 +1,6 @@
 // entrypoint for scramjet.client.js
 
-import { loadCodecs } from "../scramjet";
+import { loadCodecs, setConfig } from "../shared/index";
 import { SCRAMJETCLIENT } from "../symbols";
 import { ScramjetClient } from "./client";
 import { ScramjetContextEvent, UrlChangeEvent } from "./events";
@@ -21,35 +21,35 @@ function createFrameId() {
 		.join("")}`;
 }
 
-dbg.log("initializing scramjet client");
-// if it already exists, that means the handlers have probably already been setup by the parent document
-if (!(SCRAMJETCLIENT in <Partial<typeof self>>self)) {
-	loadCodecs();
-
-	const client = new ScramjetClient(self);
-	const frame: HTMLIFrameElement = self.frameElement as HTMLIFrameElement;
-	if (frame && !frame.name) {
-		// all frames need to be named for our logic to work
-		frame.name = createFrameId();
+export function clientInitHook(config: ScramjetConfig) {
+	setConfig(config);
+	dbg.log("initializing scramjet client");
+	// if it already exists, that means the handlers have probably already been setup by the parent document
+	if (!(SCRAMJETCLIENT in <Partial<typeof self>>self)) {
+		loadCodecs();
+
+		const client = new ScramjetClient(self);
+		const frame: HTMLIFrameElement = self.frameElement as HTMLIFrameElement;
+		if (frame && !frame.name) {
+			// all frames need to be named for our logic to work
+			frame.name = createFrameId();
+		}
+
+		if (self.COOKIE) client.loadcookies(self.COOKIE);
+
+		client.hook();
+
+		if (isemulatedsw) {
+			const runtime = new ScramjetServiceWorkerRuntime(client);
+			runtime.hook();
+		}
+
+		const contextev = new ScramjetContextEvent(client.global.window, client);
+		client.frame?.dispatchEvent(contextev);
+		const urlchangeev = new UrlChangeEvent(client.url.href);
+		if (!client.isSubframe) client.frame?.dispatchEvent(urlchangeev);
 	}
 
-	if (self.COOKIE) client.loadcookies(self.COOKIE);
-
-	client.hook();
-
-	if (isemulatedsw) {
-		const runtime = new ScramjetServiceWorkerRuntime(client);
-		runtime.hook();
-	}
-
-	const contextev = new ScramjetContextEvent(client.global.window, client);
-	client.frame?.dispatchEvent(contextev);
-	const urlchangeev = new UrlChangeEvent(client.url.href);
-	if (!client.isSubframe) client.frame?.dispatchEvent(urlchangeev);
-}
-
-Reflect.deleteProperty(self, "WASM");
-Reflect.deleteProperty(self, "COOKIE");
-if ("document" in self && document?.currentScript) {
-	document.currentScript.remove();
+	Reflect.deleteProperty(self, "WASM");
+	Reflect.deleteProperty(self, "COOKIE");
 }
diff --git a/src/client/location.ts b/src/client/location.ts
@@ -1,17 +1,16 @@
-// @ts-nocheck
 import { ScramjetClient } from "./client";
 import { nativeGetOwnPropertyDescriptor } from "./natives";
-import { rewriteUrl } from "../shared";
 import { UrlChangeEvent } from "./events";
 import { iswindow } from ".";
+import { rewriteUrl } from "../shared/rewriters/url";
 
 export function createLocationProxy(
 	client: ScramjetClient,
 	self: typeof globalThis
 ) {
 	const Location = iswindow ? self.Location : self.WorkerLocation;
 	// location cannot be Proxy()d
-	const fakeLocation = {};
+	const fakeLocation: any = {};
 	Object.setPrototypeOf(fakeLocation, Location.prototype);
 	fakeLocation.constructor = Location;
 
@@ -32,7 +31,7 @@ export function createLocationProxy(
 		const native = nativeGetOwnPropertyDescriptor(descriptorSource, prop);
 		if (!native) continue;
 
-		const desc = {
+		const desc: Partial<PropertyDescriptor> = {
 			configurable: true,
 			enumerable: true,
 		};

diff --git a/src/client/shared/blob.ts b/src/client/shared/blob.ts
@@ -1,4 +1,4 @@
-import { rewriteBlob, unrewriteBlob } from "../../shared";
+import { rewriteBlob, unrewriteBlob } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
 export default function (client: ScramjetClient) {
 	// hide the origin from object urls from the page

diff --git a/src/client/shared/caches.ts b/src/client/shared/caches.ts
@@ -1,4 +1,4 @@
-import { rewriteUrl } from "../../shared";
+import { rewriteUrl } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
 
 export default function (client: ScramjetClient, _self: Self) {

diff --git a/src/client/shared/err.ts b/src/client/shared/err.ts
@@ -1,4 +1,4 @@
-import { flagEnabled } from "../../scramjet";
+import { flagEnabled } from "../../shared";
 import { ScramjetClient } from "../client";
 
 export const enabled = (client: ScramjetClient) =>

diff --git a/src/client/shared/error.ts b/src/client/shared/error.ts
@@ -1,5 +1,5 @@
-import { flagEnabled } from "../../scramjet";
-import { config, unrewriteUrl } from "../../shared";
+import { config, flagEnabled } from "../../shared";
+import { unrewriteUrl } from "../../shared/rewriters/url";
 import { ScramjetClient } from "../client";
 
 export const enabled = (client: ScramjetClient) =>
@@ -13,7 +13,7 @@ export default function (client: ScramjetClient, _self: Self) {
 		for (let i = 0; i < stack.length; i++) {
 			const url = stack[i].getFileName();
 
-			if (url.endsWith(config.files.client)) {
+			if (url.endsWith(config.files.all)) {
 				// strip stack frames including scramjet handlers from the trace
 				const lines = newstack.split("\n");
 				const line = lines.find((l) => l.includes(url));

diff --git a/src/client/shared/eval.ts b/src/client/shared/eval.ts
@@ -1,5 +1,6 @@
+import { config } from "../../shared";
+import { rewriteJs } from "../../shared/rewriters/js";
 import { ScramjetClient } from "../client";
-import { config, rewriteJs } from "../../shared";
 
 export default function (client: ScramjetClient, self: Self) {
 	// used for proxying *direct eval*

diff --git a/src/client/shared/event.ts b/src/client/shared/event.ts
@@ -1,5 +1,5 @@
 import { iswindow } from "..";
-import { unrewriteUrl } from "../../shared";
+import { unrewriteUrl } from "../../shared/rewriters/url";
 import { SCRAMJETCLIENT } from "../../symbols";
 import { ScramjetClient } from "../client";
 import { getOwnPropertyDescriptorHandler } from "../helpers";

diff --git a/src/client/shared/function.ts b/src/client/shared/function.ts
@@ -1,5 +1,5 @@
+import { rewriteJs } from "../../shared/rewriters/js";
 import { ScramjetClient, ProxyCtx, Proxy } from "../client";
-import { rewriteJs } from "../../shared";
 
 function rewriteFunction(ctx: ProxyCtx, client: ScramjetClient) {
 	const stringifiedFunction = ctx.call().toString();

diff --git a/src/client/shared/requests/eventsource.ts b/src/client/shared/requests/eventsource.ts
@@ -1,4 +1,4 @@
-import { unrewriteUrl, rewriteUrl } from "../../../shared";
+import { rewriteUrl, unrewriteUrl } from "../../../shared/rewriters/url";
 import { ScramjetClient } from "../../client";
 
 export default function (client: ScramjetClient) {

diff --git a/src/client/shared/requests/fetch.ts b/src/client/shared/requests/fetch.ts
@@ -1,9 +1,8 @@
 // ts throws an error if you dont do window.fetch
 
 import { isemulatedsw } from "../..";
-import { unrewriteUrl } from "../../../shared";
+import { rewriteUrl, unrewriteUrl } from "../../../shared/rewriters/url";
 import { ScramjetClient } from "../../client";
-import { rewriteUrl } from "../../../shared";
 
 export default function (client: ScramjetClient) {
 	client.Proxy("fetch", {

diff --git a/src/client/shared/requests/xmlhttprequest.ts b/src/client/shared/requests/xmlhttprequest.ts
@@ -1,5 +1,5 @@
-import { flagEnabled } from "../../../scramjet";
-import { config, unrewriteUrl, rewriteUrl } from "../../../shared";
+import { config, flagEnabled } from "../../../shared";
+import { rewriteUrl, unrewriteUrl } from "../../../shared/rewriters/url";
 import { ScramjetClient } from "../../client";
 
 export default function (client: ScramjetClient, self: Self) {