feat: allow binding any object to globalThis variable

.eslintrc.js

@@ -9,9 +9,17 @@ module.exports = {
   plugins: ["@typescript-eslint", "prettier"],
   root: true,
   rules: {
-    "prettier/prettier": "error",
+    "prettier/prettier": [
+      "error",
+      {
+        tabWidth: 2,
+        singleQuote: false,
+        trailingComma: "all",
+        printWidth: 120,
+        bracketSpacing: true,
+      },
+    ],
     "no-unused-vars": "off",
-    "no-var": "off",
     "@typescript-eslint/no-unused-vars": [
       "error", // or "error"
       {

package.json

@@ -28,8 +28,5 @@
     "prettier": "^3.2.4",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2"
-  },
-  "prettier": {
-    "tabWidth": 2
   }
 }

src/binder/index.ts

@@ -0,0 +1,45 @@
+/**
+ * Safely binds functions to globalThis
+ *
+ * @example
+ * ```ts
+ * type bindings = { test: Function };
+ *
+ * set<bindings>("wallet", bindings);
+ * ```
+ *
+ * @export
+ * @template T
+ * @param {string} name
+ * @param {T} bindings
+ */
+export function set<T = object>(name: string, bindings: T) {
+  (
+    globalThis as typeof globalThis & {
+      [key in typeof name]: T;
+    }
+  )[name] = bindings;
+}
+
+/**
+ * Returns bindings assigned to globalThis
+ *
+ * @example
+ * ```
+ * type bindings = { test: Function };
+ *
+ * const wallet = get<bindings>("wallet");
+ * ```
+ *
+ * @export
+ * @template T
+ * @param {string} name
+ * @return {T}
+ */
+export function get<T = object>(name: string): T {
+  return (
+    globalThis as typeof globalThis & {
+      [key in typeof name]: T;
+    }
+  )[name];
+}

src/index.test.ts

@@ -1,21 +1,31 @@
-import { ProxyAPI, bindToWindow } from "./extension";
+import * as bindings from "./binder";
 import { expect, test } from "vitest";
 
 declare global {
-  var wallet: ProxyAPI;
+  // eslint-disable-next-line no-var
+  var wallet: typeof testBindings;
 }
 
+const testBindings = {
+  test1() {},
+  test2() {},
+  test3() {},
+};
+
 test("test binding to 'window' or 'global' variables", () => {
+  const bindingName = "wallet";
+
   const target = typeof window !== "undefined" ? window : global;
 
   expect(typeof target).not.toBe("undefined");
-  expect(Object.hasOwn(target, "wallet")).toBe(false);
+  expect(Object.hasOwn(target, bindingName)).toBe(false);
 
-  bindToWindow(target, "wallet");
+  bindings.set(bindingName, testBindings);
 
-  expect(typeof target.wallet).not.toBe("undefined");
+  expect(typeof target[bindingName]).not.toBe("undefined");
 
-  expect(typeof target.wallet?.test1).toBe("function");
-  expect(typeof target.wallet?.test2).toBe("function");
-  expect(typeof target.wallet?.test3).toBe("function");
+  const result = bindings.get<typeof testBindings>(bindingName);
+  expect(typeof result.test1).toBe("function");
+  expect(typeof result.test2).toBe("function");
+  expect(typeof result.test3).toBe("function");
 });