411 lines
17 KiB
TypeScript
411 lines
17 KiB
TypeScript
/*
|
|
* Vencord, a Discord client mod
|
|
* Copyright (c) 2024 Vendicated, Nuckyz, and contributors
|
|
* SPDX-License-Identifier: GPL-3.0-or-later
|
|
*/
|
|
|
|
import { Settings } from "@api/Settings";
|
|
import { Logger } from "@utils/Logger";
|
|
import { interpolateIfDefined } from "@utils/misc";
|
|
import { canonicalizeReplacement } from "@utils/patches";
|
|
import { PatchReplacement } from "@utils/types";
|
|
|
|
import { traceFunction } from "../debug/Tracer";
|
|
import { patches } from "../plugins";
|
|
import { _initWebpack, factoryListeners, ModuleFactory, moduleListeners, subscriptions, WebpackRequire, wreq } from ".";
|
|
|
|
type AnyWebpackRequire = Partial<WebpackRequire> & Pick<WebpackRequire, "m">;
|
|
|
|
type PatchedModuleFactory = ModuleFactory & {
|
|
$$vencordOriginal?: ModuleFactory;
|
|
};
|
|
|
|
type PatchedModuleFactories = Record<PropertyKey, PatchedModuleFactory>;
|
|
|
|
const logger = new Logger("WebpackInterceptor", "#8caaee");
|
|
|
|
/** A set with all the Webpack instances */
|
|
export const allWebpackInstances = new Set<AnyWebpackRequire>();
|
|
/** Whether we tried to fallback to factory WebpackRequire, or disabled patches */
|
|
let wreqFallbackApplied = false;
|
|
|
|
type Define = typeof Reflect.defineProperty;
|
|
const define: Define = (target, p, attributes) => {
|
|
if (Object.hasOwn(attributes, "value")) {
|
|
attributes.writable = true;
|
|
}
|
|
|
|
return Reflect.defineProperty(target, p, {
|
|
configurable: true,
|
|
enumerable: true,
|
|
...attributes
|
|
});
|
|
};
|
|
|
|
// wreq.m is the Webpack object containing module factories.
|
|
// We wrap it with our proxy, which is responsible for patching the module factories when they are set, or definining getters for the patched versions.
|
|
// If this is the main Webpack, we also set up the internal references to WebpackRequire.
|
|
// wreq.m is pre-populated with module factories, and is also populated via webpackGlobal.push
|
|
// The sentry module also has their own Webpack with a pre-populated wreq.m, so this also patches the sentry module factories.
|
|
define(Function.prototype, "m", {
|
|
enumerable: false,
|
|
|
|
set(this: WebpackRequire, moduleFactories: PatchedModuleFactories) {
|
|
// When using React DevTools or other extensions, we may also catch their Webpack here.
|
|
// This ensures we actually got the right ones.
|
|
const { stack } = new Error();
|
|
if (!(stack?.includes("discord.com") || stack?.includes("discordapp.com")) || Array.isArray(moduleFactories)) {
|
|
define(this, "m", { value: moduleFactories });
|
|
return;
|
|
}
|
|
|
|
const fileName = stack?.match(/\/assets\/(.+?\.js)/)?.[1];
|
|
logger.info("Found Webpack module factories" + interpolateIfDefined` in ${fileName}`);
|
|
|
|
allWebpackInstances.add(this);
|
|
|
|
// Define a setter for the bundlePath property of WebpackRequire. Only the main Webpack has this property.
|
|
// So if the setter is called, this means we can initialize the internal references to WebpackRequire.
|
|
define(this, "p", {
|
|
enumerable: false,
|
|
|
|
set(this: WebpackRequire, bundlePath: WebpackRequire["p"]) {
|
|
define(this, "p", { value: bundlePath });
|
|
clearTimeout(setterTimeout);
|
|
|
|
if (bundlePath !== "/assets/") return;
|
|
|
|
logger.info("Main Webpack found" + interpolateIfDefined` in ${fileName}` + ", initializing internal references to WebpackRequire");
|
|
_initWebpack(this);
|
|
}
|
|
});
|
|
// setImmediate to clear this property setter if this is not the main Webpack.
|
|
// If this is the main Webpack, wreq.m will always be set before the timeout runs.
|
|
const setterTimeout = setTimeout(() => Reflect.deleteProperty(this, "p"), 0);
|
|
|
|
define(moduleFactories, Symbol.toStringTag, {
|
|
value: "ModuleFactories",
|
|
enumerable: false
|
|
});
|
|
|
|
// The proxy responsible for patching the module factories when they are set, or definining getters for the patched versions
|
|
const proxiedModuleFactories = new Proxy(moduleFactories, moduleFactoriesHandler);
|
|
/*
|
|
If Discord ever decides to set module factories using the variable of the modules object directly, instead of wreq.m, switch the proxy to the prototype
|
|
Reflect.setPrototypeOf(moduleFactories, new Proxy(moduleFactories, moduleFactoriesHandler));
|
|
*/
|
|
|
|
define(this, "m", { value: proxiedModuleFactories });
|
|
|
|
// Patch the pre-populated factories
|
|
for (const id in moduleFactories) {
|
|
defineModulesFactoryGetter(id, Settings.eagerPatches ? patchFactory(id, moduleFactories[id]) : moduleFactories[id]);
|
|
}
|
|
}
|
|
});
|
|
|
|
/**
|
|
* Define the getter for returning the patched version of the module factory.
|
|
*
|
|
* If eagerPatches is enabled, the factory argument should already be the patched version, else it will be the original
|
|
* and only be patched when accessed for the first time.
|
|
*
|
|
* @param id The id of the module
|
|
* @param factory The original or patched module factory
|
|
*/
|
|
function defineModulesFactoryGetter(id: PropertyKey, factory: PatchedModuleFactory) {
|
|
// Define the getter in all the module factories objects. Patches are only executed once, so make sure all module factories object
|
|
// have the patched version
|
|
for (const wreq of allWebpackInstances) {
|
|
define(wreq.m, id, {
|
|
get() {
|
|
// $$vencordOriginal means the factory is already patched
|
|
if (factory.$$vencordOriginal != null) {
|
|
return factory;
|
|
}
|
|
|
|
return (factory = patchFactory(id, factory));
|
|
},
|
|
set(v: ModuleFactory) {
|
|
if (factory.$$vencordOriginal != null) {
|
|
factory.$$vencordOriginal = v;
|
|
} else {
|
|
factory = v;
|
|
}
|
|
}
|
|
});
|
|
}
|
|
}
|
|
|
|
const moduleFactoriesHandler: ProxyHandler<PatchedModuleFactories> = {
|
|
/*
|
|
If Discord ever decides to set module factories using the variable of the modules object directly instead of wreq.m, we need to switch the proxy to the prototype
|
|
and that requires defining additional traps for keeping the object working
|
|
|
|
// Proxies on the prototype dont intercept "get" when the property is in the object itself. But in case it isn't we need to return undefined,
|
|
// to avoid Reflect.get having no effect and causing a stack overflow
|
|
get: (target, p, receiver) => {
|
|
return undefined;
|
|
},
|
|
// Same thing as get
|
|
has: (target, p) => {
|
|
return false;
|
|
}
|
|
*/
|
|
|
|
// The set trap for patching or defining getters for the module factories when new module factories are loaded
|
|
set: (target, p, newValue, receiver) => {
|
|
// If the property is not a number, we are not dealing with a module factory
|
|
if (Number.isNaN(Number(p))) {
|
|
return define(target, p, { value: newValue });
|
|
}
|
|
|
|
const existingFactory = Reflect.get(target, p, receiver);
|
|
|
|
if (!Settings.eagerPatches) {
|
|
// If existingFactory exists, its either wrapped in defineModuleFactoryGetter, or it has already been required
|
|
// so call Reflect.set with the new original and let the correct logic apply (normal set, or defineModuleFactoryGetter setter)
|
|
if (existingFactory != null) {
|
|
return Reflect.set(target, p, newValue, receiver);
|
|
}
|
|
|
|
// eagerPatches are disabled, so the factory argument should be the original
|
|
defineModulesFactoryGetter(p, newValue);
|
|
return true;
|
|
}
|
|
|
|
// Check if this factory is already patched
|
|
if (existingFactory?.$$vencordOriginal != null) {
|
|
existingFactory.$$vencordOriginal = newValue;
|
|
return true;
|
|
}
|
|
|
|
const patchedFactory = patchFactory(p, newValue);
|
|
|
|
// If multiple Webpack instances exist, when new a new module is loaded, it will be set in all the module factories objects.
|
|
// Because patches are only executed once, we need to set the patched version in all of them, to avoid the Webpack instance
|
|
// that uses the factory to contain the original factory instead of the patched, in case it was set first in another instance
|
|
defineModulesFactoryGetter(p, patchedFactory);
|
|
|
|
return true;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Patches a module factory.
|
|
*
|
|
* The factory argument will become the patched version of the factory.
|
|
* @param id The id of the module
|
|
* @param factory The original or patched module factory
|
|
* @returns The wrapper for the patched module factory
|
|
*/
|
|
function patchFactory(id: PropertyKey, factory: ModuleFactory) {
|
|
const originalFactory = factory;
|
|
|
|
for (const factoryListener of factoryListeners) {
|
|
try {
|
|
factoryListener(originalFactory);
|
|
} catch (err) {
|
|
logger.error("Error in Webpack factory listener:\n", err, factoryListener);
|
|
}
|
|
}
|
|
|
|
const patchedBy = new Set<string>();
|
|
|
|
// 0, prefix to turn it into an expression: 0,function(){} would be invalid syntax without the 0,
|
|
let code: string = "0," + String(factory);
|
|
|
|
for (let i = 0; i < patches.length; i++) {
|
|
const patch = patches[i];
|
|
if (patch.predicate && !patch.predicate()) continue;
|
|
|
|
const moduleMatches = typeof patch.find === "string"
|
|
? code.includes(patch.find)
|
|
: (patch.find.global && (patch.find.lastIndex = 0), patch.find.test(code));
|
|
|
|
if (!moduleMatches) continue;
|
|
|
|
patchedBy.add(patch.plugin);
|
|
|
|
const executePatch = traceFunction(`patch by ${patch.plugin}`, (match: string | RegExp, replace: string) => code.replace(match, replace));
|
|
const previousCode = code;
|
|
const previousFactory = factory;
|
|
|
|
// We change all patch.replacement to array in plugins/index
|
|
for (const replacement of patch.replacement as PatchReplacement[]) {
|
|
if (replacement.predicate && !replacement.predicate()) continue;
|
|
|
|
const lastCode = code;
|
|
const lastFactory = factory;
|
|
|
|
canonicalizeReplacement(replacement, patch.plugin);
|
|
|
|
try {
|
|
const newCode = executePatch(replacement.match, replacement.replace as string);
|
|
if (newCode === code) {
|
|
if (!patch.noWarn) {
|
|
logger.warn(`Patch by ${patch.plugin} had no effect (Module id is ${String(id)}): ${replacement.match}`);
|
|
if (IS_DEV) {
|
|
logger.debug("Function Source:\n", code);
|
|
}
|
|
}
|
|
|
|
if (patch.group) {
|
|
logger.warn(`Undoing patch group ${patch.find} by ${patch.plugin} because replacement ${replacement.match} had no effect`);
|
|
code = previousCode;
|
|
factory = previousFactory;
|
|
patchedBy.delete(patch.plugin);
|
|
break;
|
|
}
|
|
|
|
continue;
|
|
}
|
|
|
|
code = newCode;
|
|
factory = (0, eval)(`// Webpack Module ${String(id)} - Patched by ${[...patchedBy].join(", ")}\n${newCode}\n//# sourceURL=WebpackModule${String(id)}`);
|
|
} catch (err) {
|
|
logger.error(`Patch by ${patch.plugin} errored (Module id is ${String(id)}): ${replacement.match}\n`, err);
|
|
|
|
if (IS_DEV) {
|
|
const changeSize = code.length - lastCode.length;
|
|
const match = lastCode.match(replacement.match)!;
|
|
|
|
// Use 200 surrounding characters of context
|
|
const start = Math.max(0, match.index! - 200);
|
|
const end = Math.min(lastCode.length, match.index! + match[0].length + 200);
|
|
// (changeSize may be negative)
|
|
const endPatched = end + changeSize;
|
|
|
|
const context = lastCode.slice(start, end);
|
|
const patchedContext = code.slice(start, endPatched);
|
|
|
|
// inline require to avoid including it in !IS_DEV builds
|
|
const diff = (require("diff") as typeof import("diff")).diffWordsWithSpace(context, patchedContext);
|
|
let fmt = "%c %s ";
|
|
const elements = [] as string[];
|
|
for (const d of diff) {
|
|
const color = d.removed
|
|
? "red"
|
|
: d.added
|
|
? "lime"
|
|
: "grey";
|
|
fmt += "%c%s";
|
|
elements.push("color:" + color, d.value);
|
|
}
|
|
|
|
logger.errorCustomFmt(...Logger.makeTitle("white", "Before"), context);
|
|
logger.errorCustomFmt(...Logger.makeTitle("white", "After"), patchedContext);
|
|
const [titleFmt, ...titleElements] = Logger.makeTitle("white", "Diff");
|
|
logger.errorCustomFmt(titleFmt + fmt, ...titleElements, ...elements);
|
|
}
|
|
|
|
patchedBy.delete(patch.plugin);
|
|
|
|
if (patch.group) {
|
|
logger.warn(`Undoing patch group ${patch.find} by ${patch.plugin} because replacement ${replacement.match} errored`);
|
|
code = previousCode;
|
|
factory = previousFactory;
|
|
break;
|
|
}
|
|
|
|
code = lastCode;
|
|
factory = lastFactory;
|
|
}
|
|
}
|
|
|
|
if (!patch.all) patches.splice(i--, 1);
|
|
}
|
|
|
|
// The patched factory wrapper, define it in an object to preserve the name after minification
|
|
const patchedFactory: PatchedModuleFactory = {
|
|
PatchedFactory(...args: Parameters<ModuleFactory>) {
|
|
// Restore the original factory in all the module factories objects,
|
|
// because we want to make sure the original factory is restored properly, no matter what is the Webpack instance
|
|
for (const wreq of allWebpackInstances) {
|
|
define(wreq.m, id, { value: patchedFactory.$$vencordOriginal });
|
|
}
|
|
|
|
// eslint-disable-next-line prefer-const
|
|
let [module, exports, require] = args;
|
|
|
|
if (wreq == null) {
|
|
if (!wreqFallbackApplied) {
|
|
wreqFallbackApplied = true;
|
|
|
|
// Make sure the require argument is actually the WebpackRequire function
|
|
if (typeof require === "function" && require.m != null) {
|
|
const { stack } = new Error();
|
|
const webpackInstanceFileName = stack?.match(/\/assets\/(.+?\.js)/)?.[1];
|
|
logger.warn(
|
|
"WebpackRequire was not initialized, falling back to WebpackRequire passed to the first called patched module factory (" +
|
|
`id: ${String(id)}` + interpolateIfDefined`, WebpackInstance origin: ${webpackInstanceFileName}` +
|
|
")"
|
|
);
|
|
_initWebpack(require);
|
|
} else if (IS_DEV) {
|
|
logger.error("WebpackRequire was not initialized, running modules without patches instead.");
|
|
}
|
|
}
|
|
|
|
if (IS_DEV) {
|
|
return originalFactory.apply(this, args);
|
|
}
|
|
}
|
|
|
|
let factoryReturn: unknown;
|
|
try {
|
|
// Call the patched factory
|
|
factoryReturn = factory.apply(this, args);
|
|
} catch (err) {
|
|
// Just re-throw Discord errors
|
|
if (factory === originalFactory) throw err;
|
|
|
|
logger.error("Error in patched module factory", err);
|
|
return originalFactory.apply(this, args);
|
|
}
|
|
|
|
// Webpack sometimes sets the value of module.exports directly, so assign exports to it to make sure we properly handle it
|
|
exports = module?.exports;
|
|
if (exports == null) return factoryReturn;
|
|
|
|
// There are (at the time of writing) 11 modules exporting the window
|
|
// Make these non enumerable to improve webpack search performance
|
|
if ((exports === window || exports?.default === window) && typeof require === "function" && require.c != null) {
|
|
define(require.c, id, {
|
|
value: require.c[id],
|
|
enumerable: false
|
|
});
|
|
return factoryReturn;
|
|
}
|
|
|
|
for (const callback of moduleListeners) {
|
|
try {
|
|
callback(exports, id);
|
|
} catch (err) {
|
|
logger.error("Error in Webpack module listener:\n", err, callback);
|
|
}
|
|
}
|
|
|
|
for (const [filter, callback] of subscriptions) {
|
|
try {
|
|
if (exports && filter(exports)) {
|
|
subscriptions.delete(filter);
|
|
callback(exports, id);
|
|
} else if (exports.default && filter(exports.default)) {
|
|
subscriptions.delete(filter);
|
|
callback(exports.default, id);
|
|
}
|
|
} catch (err) {
|
|
logger.error("Error while firing callback for Webpack subscription:\n", err, filter, callback);
|
|
}
|
|
}
|
|
|
|
return factoryReturn;
|
|
}
|
|
}.PatchedFactory;
|
|
|
|
patchedFactory.toString = originalFactory.toString.bind(originalFactory);
|
|
patchedFactory.$$vencordOriginal = originalFactory;
|
|
|
|
return patchedFactory;
|
|
}
|