load-remote-module 1.0.1

package/README.md

@@ -0,0 +1,97 @@
+# load-remote-module
+
+Load JavaScript modules dynamically from remote URLs — safely, asynchronously, and with zero configuration.
+
+`load-remote-module` lets you fetch and execute remote ES modules at runtime.  
+Perfect for plugin systems, dynamic feature loading, micro‑frontends, or any scenario where your code needs to pull logic from the outside world.
+
+---
+
+## ✨ Features
+
+- 🚀 **Load ES modules from any URL**
+- 🔒 **Isolated execution** using native dynamic `import()`
+- 🧩 **Works with any module** that exports functions, objects, classes, etc.
+- ⏱️ **Promise‑based API**
+- 🪶 **Tiny & dependency‑free**
+
+---
+
+## 📦 Installation
+
+```bash
+npm install load-remote-module
+```
+
+---
+
+## 🛠️ Usage
+
+### Basic Example
+
+```js
+import loadRemoteModule from 'load-remote-module';
+
+async function test() {
+  const mod = await loadRemoteModule('https://test.com/test');
+
+  console.log(mod.sayHello('Alice'));
+}
+
+test();
+```
+### What the remote module might look like
+```js
+function sayHello(name) {
+    return `Hello, ${name}!`;
+}
+
+module.exports = { sayHello };
+```
+
+---
+
+## 📚 API
+
+### `loadRemoteModule(url: string): Promise<any>`
+Loads a remote ES module and returns its exported object.
+
+### Parameters
+
+| Name | Type   | Description                              |
+|------|--------|------------------------------------------|
+| url  | string | Full URL to the remote JavaScript module |
+### Returns
+A Promise resolving to the module’s exports.
+
+---
+
+## ⚠️ Security Notes
+Loading remote code always carries risk.
+You should only load modules from trusted sources and consider implementing:
+
+- URL allowlists
+
+- Integrity checks
+
+- Version pinning
+
+- Sandboxing strategies
+
+---
+
+## 🧪 Example Use Cases
+- Plugin systems
+
+- Dynamic feature flags
+
+- Remote configuration logic
+
+- Micro‑frontend architectures
+
+- A/B testing logic loaded on demand
+
+---
+
+## 📄 License
+MIT — feel free to use it however you like.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { AxiosRequestConfig } from 'axios';
+declare function loadRemoteModule(url: string, options?: AxiosRequestConfig): Promise<any>;
+export = loadRemoteModule;

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const axios_1 = __importDefault(require("axios"));
+const module_1 = require("module");
+async function loadRemoteModule(url, options) {
+    if (typeof url !== 'string') {
+        throw new TypeError('Expected a string URL');
+    }
+    const res = await (0, axios_1.default)({ method: 'GET', url, ...options });
+    const code = res.data.toString();
+    const m = new module_1.Module(url);
+    m.filename = url;
+    // internal Node API
+    m._compile(code, url);
+    return m.exports;
+}
+module.exports = loadRemoteModule;

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "load-remote-module",
+  "version": "1.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": "Antonio",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "axios": "^1.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.2.0"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,8 @@
+import { AxiosRequestConfig } from 'axios';
+
+declare function loadRemoteModule(
+  url: string,
+  options?: AxiosRequestConfig
+): Promise<any>;
+
+export = loadRemoteModule;

package/src/index.ts

@@ -0,0 +1,25 @@
+import axios, { AxiosRequestConfig } from 'axios';
+import { Module } from 'module';
+
+async function loadRemoteModule(
+  url: string,
+  options?: AxiosRequestConfig
+): Promise<any> {
+  if (typeof url !== 'string') {
+    throw new TypeError('Expected a string URL');
+  }
+
+  const res = await axios({ method: 'GET', url, ...options });
+  const code = res.data.toString();
+
+  const m = new Module(url);
+  m.filename = url;
+
+  // internal Node API
+  (m as any)._compile(code, url);
+
+  return m.exports;
+}
+
+// 🔥 IMPORTANT: CommonJS export
+export = loadRemoteModule;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true
+  },
+  "include": ["src/**/*"],
+  "exclude": [
+    "node_modules"
+  ]
+}