@intranefr/superbackend 1.4.3 → 1.5.0

package/.env.example

@@ -43,5 +43,10 @@ MAX_FILE_SIZE_HARD_CAP=10485760
 # S3_REGION=us-east-1
 # S3_ACCESS_KEY_ID=minioadmin
 # S3_SECRET_ACCESS_KEY=minioadmin
-# S3_BUCKET=saasbackend
+# S3_BUCKET=superbackend
+# Legacy fallback: S3_BUCKET=saasbackend
 # S3_FORCE_PATH_STYLE=true
+
+# Encryption key for encrypted settings (new preferred name)
+# SUPERBACKEND_ENCRYPTION_KEY=your-32-byte-encryption-key
+# Legacy fallback: SAASBACKEND_ENCRYPTION_KEY=your-32-byte-encryption-key

package/README.md

@@ -29,13 +29,13 @@ Node.js middleware that gives your project backend superpowers. Handles authenti
 ## Installation
 
 ```bash
-npm install superbackend
+npm install @intranefr/superbackend
 ```
 
 or
 
 ```bash
-yarn add superbackend
+yarn add @intranefr/superbackend
 ```
 
 ---
@@ -45,7 +45,7 @@ yarn add superbackend
 ```javascript
 require('dotenv').config();
 const express = require('express');
-const { middleware } = require('saasbackend');
+const { middleware } = require('@intranefr/superbackend');
 
 const app = express();
 
@@ -101,8 +101,8 @@ Please read the [CONTRIBUTING.md](#) for guidelines.
   <img src="https://img.shields.io/badge/Intrane-intranefr-blue?style=flat-square" alt="Intrane"/>
 </a>
 &nbsp;
-<a href="https://www.npmjs.com/package/superbackend" target="_blank">
-  <img src="https://img.shields.io/npm/v/superbackend?style=flat-square" alt="npm"/>
+<a href="https://www.npmjs.com/package/@intranefr/superbackend" target="_blank">
+  <img src="https://img.shields.io/npm/v/@intranefr%2Fsuperbackend?style=flat-square" alt="npm"/>
 </a>
 
 ## License

package/index.js

@@ -2,7 +2,7 @@ require("dotenv").config({ path: process.env.ENV_FILE || ".env" });
 const express = require("express");
 
 /**
- * Creates the SaaS backend as Express middleware
+ * Creates the SuperBackend as Express middleware
  * @param {Object} options - Configuration options
  * @param {string} options.mongodbUri - MongoDB connection string
  * @param {string} options.corsOrigin - CORS origin(s)
@@ -11,9 +11,10 @@ const express = require("express");
  * @returns {express.Router} Configured Express router
  */
 const middleware = require("./src/middleware");
+const { attachTerminalWebsocketServer } = require('./src/services/terminalsWs.service');
 
 /**
- * Creates and starts a standalone SaaS backend server
+ * Creates and starts a standalone SuperBackend server
  * @param {Object} options - Configuration options
  * @param {number} options.port - Port to listen on
  * @param {string} options.mongodbUri - MongoDB connection string
@@ -24,20 +25,36 @@ function startServer(options = {}) {
   const app = express();
   const PORT = options.port || process.env.PORT || 3000;
 
-  app.use(module.exports.middleware(options));
+  const router = module.exports.middleware(options);
+  app.use(router);
 
   // Start server
   const server = app.listen(PORT, () => {
-    console.log(`🚀 SaaSBackend standalone server running on http://localhost:${PORT}`);
+    console.log(`🚀 SuperBackend standalone server running on http://localhost:${PORT}`);
   });
 
+  // Attach WebSocket server via middleware helper or directly
+  console.log('[Index] Attaching WebSocket server...');
+  if (typeof router.attachWs === 'function') {
+    console.log('[Index] Using router.attachWs');
+    router.attachWs(server);
+  } else {
+    // Fallback: attach directly with admin path
+    const adminPath = router.adminPath || '/admin';
+    console.log('[Index] Using fallback attach with adminPath:', adminPath);
+    attachTerminalWebsocketServer(server, { basePathPrefix: adminPath });
+  }
+
   return { app, server };
 }
 
 const saasbackend = {
   server: startServer,
+  consoleOverride: require("./src/services/consoleOverride.service"),
   middleware: (options = {}) => {
-    globalThis.saasbackend = saasbackend;
+    // Set both registries for backward compatibility
+    globalThis.superbackend = saasbackend;
+    globalThis.saasbackend = saasbackend; // Legacy support
     return middleware(options);
   },
   services: {
@@ -88,6 +105,7 @@ const saasbackend = {
     org: require("./src/middleware/org"),
     i18n: require("./src/services/i18n.service"),
     jsonConfigs: require("./src/services/jsonConfigs.service"),
+    terminals: require("./src/services/terminalsWs.service"),
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intranefr/superbackend",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "Node.js middleware that gives your project backend superpowers",
   "main": "index.js",
   "scripts": {
@@ -9,6 +9,7 @@
     "start:minio": "docker compose -f compose.standalone.yml --profile minio-only up -d minio",
     "minio:envs": "node -e \"console.log(['S3_ENDPOINT=http://localhost:9000','S3_REGION=us-east-1','S3_ACCESS_KEY_ID=minioadmin','S3_SECRET_ACCESS_KEY=minioadmin','S3_BUCKET=saasbackend','S3_FORCE_PATH_STYLE=true'].join('\\n'))\"",
     "build:sdk:error-tracking:browser": "esbuild sdk/error-tracking/browser/src/embed.js --bundle --format=iife --global-name=saasbackendErrorTrackingEmbed --outfile=sdk/error-tracking/browser/dist/embed.iife.js",
+    "build:sdk:ui-components:browser": "esbuild sdk/ui-components/browser/src/index.js --bundle --format=iife --outfile=public/sdk/ui-components.iife.js",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage"
@@ -41,11 +42,13 @@
     "jsonwebtoken": "^9.0.2",
     "mongoose": "^8.0.0",
     "multer": "^1.4.5-lts.1",
+    "node-pty": "^1.1.0",
     "openai": "^4.0.0",
     "resend": "^6.4.0",
     "ssh2-sftp-client": "^12.0.1",
     "stripe": "^14.0.0",
-    "vm2": "^3.10.0"
+    "vm2": "^3.10.0",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
     "esbuild": "^0.25.0",

package/public/sdk/ui-components.iife.js

@@ -0,0 +1,191 @@
+(() => {
+  // sdk/ui-components/browser/src/index.js
+  (function() {
+    function toStr(v) {
+      return v === void 0 || v === null ? "" : String(v);
+    }
+    function normalizeApiUrl(apiUrl) {
+      const u = toStr(apiUrl).trim();
+      if (!u) return "";
+      return u.replace(/\/$/, "");
+    }
+    function buildHeaders(apiKey) {
+      const headers = {};
+      const key = toStr(apiKey).trim();
+      if (key) headers["x-project-key"] = key;
+      return headers;
+    }
+    async function fetchJson(url, headers) {
+      const res = await fetch(url, { headers: headers || {} });
+      const text = await res.text();
+      let data = null;
+      try {
+        data = text ? JSON.parse(text) : null;
+      } catch {
+        data = null;
+      }
+      if (!res.ok) {
+        const msg = data && data.error ? data.error : "Request failed";
+        const err = new Error(msg);
+        err.status = res.status;
+        throw err;
+      }
+      return data;
+    }
+    function ensureTemplate(code, html) {
+      const id = "ui-cmp-" + code;
+      let tpl = document.getElementById(id);
+      if (!tpl) {
+        tpl = document.createElement("template");
+        tpl.id = id;
+        document.body.appendChild(tpl);
+      }
+      tpl.innerHTML = toStr(html);
+      return tpl;
+    }
+    function injectCssScoped(code, cssText) {
+      const id = "ui-cmp-style-" + code;
+      let el = document.getElementById(id);
+      if (!el) {
+        el = document.createElement("style");
+        el.id = id;
+        document.head.appendChild(el);
+      }
+      el.textContent = toStr(cssText);
+    }
+    function createShadowRootContainer() {
+      const host = document.createElement("div");
+      host.style.all = "initial";
+      const shadow = host.attachShadow({ mode: "open" });
+      return { host, shadow };
+    }
+    function defaultMountTarget() {
+      return document.body;
+    }
+    function compileComponentJs(jsCode) {
+      const code = toStr(jsCode);
+      if (!code.trim()) {
+        return function() {
+          return {};
+        };
+      }
+      return new Function("api", "templateRootEl", "props", code);
+    }
+    const state = {
+      initialized: false,
+      projectId: null,
+      apiKey: null,
+      apiUrl: "",
+      cssIsolation: "scoped",
+      components: {}
+    };
+    function registerComponent(def) {
+      const code = toStr(def.code).trim().toLowerCase();
+      if (!code) return;
+      const version = def.version;
+      const html = def.html;
+      const js = def.js;
+      const css = def.css;
+      ensureTemplate(code, html);
+      const component = {
+        code,
+        version,
+        css,
+        js,
+        create: function(props, options) {
+          const opts = options || {};
+          const mountEl = opts.mountEl || defaultMountTarget();
+          const isolation = opts.cssIsolation || state.cssIsolation;
+          const tpl = ensureTemplate(code, html);
+          const fragment = tpl.content.cloneNode(true);
+          let templateRootEl;
+          let instanceRoot;
+          let shadow = null;
+          if (isolation === "shadow") {
+            const c = createShadowRootContainer();
+            instanceRoot = c.host;
+            shadow = c.shadow;
+            templateRootEl = shadow;
+            if (css) {
+              const style = document.createElement("style");
+              style.textContent = toStr(css);
+              shadow.appendChild(style);
+            }
+            shadow.appendChild(fragment);
+          } else {
+            instanceRoot = document.createElement("div");
+            templateRootEl = instanceRoot;
+            if (css) injectCssScoped(code, css);
+            instanceRoot.appendChild(fragment);
+          }
+          mountEl.appendChild(instanceRoot);
+          const api = {
+            unmount: function() {
+              try {
+                instanceRoot.remove();
+              } catch {
+              }
+            },
+            mountEl,
+            hostEl: instanceRoot,
+            shadowRoot: shadow
+          };
+          const fn = compileComponentJs(js);
+          let exported = {};
+          try {
+            exported = fn(api, templateRootEl, props || {}) || {};
+          } catch (e) {
+            exported = {
+              error: e
+            };
+          }
+          return Object.assign({ api }, exported);
+        }
+      };
+      state.components[code] = component;
+      uiCmp[code] = component;
+      uiComponents[code] = component;
+    }
+    async function init(options) {
+      const opts = options || {};
+      const projectId = toStr(opts.projectId).trim();
+      if (!projectId) throw new Error("projectId is required");
+      const apiUrl = normalizeApiUrl(opts.apiUrl);
+      const apiKey = opts.apiKey;
+      state.projectId = projectId;
+      state.apiKey = apiKey;
+      state.apiUrl = apiUrl;
+      const cssIsolation = toStr(opts.cssIsolation || "scoped").trim().toLowerCase();
+      state.cssIsolation = cssIsolation === "shadow" ? "shadow" : "scoped";
+      const base = state.apiUrl;
+      const url = base + "/api/ui-components/projects/" + encodeURIComponent(projectId) + "/manifest";
+      const data = await fetchJson(url, buildHeaders(apiKey));
+      const items = data && Array.isArray(data.components) ? data.components : [];
+      for (const def of items) {
+        registerComponent(def);
+      }
+      state.initialized = true;
+      return { project: data ? data.project : null, count: items.length };
+    }
+    async function load(code) {
+      const c = toStr(code).trim().toLowerCase();
+      if (!c) throw new Error("code is required");
+      if (!state.projectId) throw new Error("uiCmp not initialized");
+      if (state.components[c]) return state.components[c];
+      const base = state.apiUrl;
+      const url = base + "/api/ui-components/projects/" + encodeURIComponent(state.projectId) + "/components/" + encodeURIComponent(c);
+      const data = await fetchJson(url, buildHeaders(state.apiKey));
+      if (!data || !data.component) throw new Error("Component not found");
+      registerComponent(data.component);
+      return state.components[c];
+    }
+    const uiCmp = {
+      init,
+      load,
+      _state: state
+    };
+    const uiComponents = uiCmp;
+    window.uiCmp = uiCmp;
+    window.uiComponents = uiComponents;
+  })();
+})();

package/sdk/error-tracking/browser/package.json

@@ -1,6 +1,7 @@
 {
-  "name": "@saasbackend/error-tracking-browser-sdk",
-  "version": "1.0.0",
+  "name": "@intranefr/superbackend-error-tracking-browser-sdk",
+  "version": "2.0.0",
+  "description": "Error tracking SDK for SuperBackend browser applications.",
   "type": "module",
   "exports": {
     ".": {
@@ -8,7 +9,7 @@
     }
   },
   "scripts": {
-    "build": "esbuild src/embed.js --bundle --format=iife --global-name=saasbackendErrorTrackingEmbed --outfile=dist/embed.iife.js --minify"
+    "build": "esbuild src/embed.js --bundle --format=iife --global-name=superbackendErrorTrackingEmbed --outfile=dist/embed.iife.js --minify"
   },
   "devDependencies": {
     "esbuild": "^0.27.2"

package/sdk/error-tracking/browser/src/embed.js

@@ -1,11 +1,39 @@
 import { createErrorTrackingClient } from './core.js';
 
+function attachToSuperbackendGlobal() {
+  const root = (typeof window !== 'undefined' ? window : undefined);
+  if (!root) return;
+
+  if (root.saasbackendErrorTrackingEmbed && !root.superbackendErrorTrackingEmbed) {
+    root.superbackendErrorTrackingEmbed = root.saasbackendErrorTrackingEmbed;
+  }
+
+  root.superbackend = root.superbackend || {};
+
+  if (!root.superbackend.errorTracking) {
+    root.superbackend.errorTracking = createErrorTrackingClient();
+  }
+
+  if (root.superbackend.errorTracking && typeof root.superbackend.errorTracking.init === 'function') {
+    root.superbackend.errorTracking.init();
+  }
+}
+
 function attachToSaasbackendGlobal() {
   const root = (typeof window !== 'undefined' ? window : undefined);
   if (!root) return;
 
+  // Show deprecation warning in console
+  if (console.warn) {
+    console.warn('DEPRECATION: Global "window.saasbackend" is deprecated. Use "window.superbackend" instead.');
+  }
+
   root.saasbackend = root.saasbackend || {};
 
+  if (root.superbackendErrorTrackingEmbed && !root.saasbackendErrorTrackingEmbed) {
+    root.saasbackendErrorTrackingEmbed = root.superbackendErrorTrackingEmbed;
+  }
+
   if (!root.saasbackend.errorTracking) {
     root.saasbackend.errorTracking = createErrorTrackingClient();
   }
@@ -15,4 +43,5 @@ function attachToSaasbackendGlobal() {
   }
 }
 
+attachToSuperbackendGlobal();
 attachToSaasbackendGlobal();

package/sdk/ui-components/browser/src/index.js

@@ -0,0 +1,228 @@
+(function () {
+  function toStr(v) {
+    return v === undefined || v === null ? '' : String(v);
+  }
+
+  function normalizeApiUrl(apiUrl) {
+    const u = toStr(apiUrl).trim();
+    if (!u) return '';
+    return u.replace(/\/$/, '');
+  }
+
+  function buildHeaders(apiKey) {
+    const headers = {};
+    const key = toStr(apiKey).trim();
+    if (key) headers['x-project-key'] = key;
+    return headers;
+  }
+
+  async function fetchJson(url, headers) {
+    const res = await fetch(url, { headers: headers || {} });
+    const text = await res.text();
+    let data = null;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      data = null;
+    }
+    if (!res.ok) {
+      const msg = data && data.error ? data.error : 'Request failed';
+      const err = new Error(msg);
+      err.status = res.status;
+      throw err;
+    }
+    return data;
+  }
+
+  function ensureTemplate(code, html) {
+    const id = 'ui-cmp-' + code;
+    let tpl = document.getElementById(id);
+    if (!tpl) {
+      tpl = document.createElement('template');
+      tpl.id = id;
+      document.body.appendChild(tpl);
+    }
+    tpl.innerHTML = toStr(html);
+    return tpl;
+  }
+
+  function injectCssScoped(code, cssText) {
+    const id = 'ui-cmp-style-' + code;
+    let el = document.getElementById(id);
+    if (!el) {
+      el = document.createElement('style');
+      el.id = id;
+      document.head.appendChild(el);
+    }
+    el.textContent = toStr(cssText);
+  }
+
+  function createShadowRootContainer() {
+    const host = document.createElement('div');
+    host.style.all = 'initial';
+    const shadow = host.attachShadow({ mode: 'open' });
+    return { host, shadow };
+  }
+
+  function defaultMountTarget() {
+    return document.body;
+  }
+
+  function compileComponentJs(jsCode) {
+    const code = toStr(jsCode);
+    if (!code.trim()) {
+      return function () {
+        return {};
+      };
+    }
+    return new Function('api', 'templateRootEl', 'props', code);
+  }
+
+  const state = {
+    initialized: false,
+    projectId: null,
+    apiKey: null,
+    apiUrl: '',
+    cssIsolation: 'scoped',
+    components: {},
+  };
+
+  function registerComponent(def) {
+    const code = toStr(def.code).trim().toLowerCase();
+    if (!code) return;
+
+    const version = def.version;
+    const html = def.html;
+    const js = def.js;
+    const css = def.css;
+
+    ensureTemplate(code, html);
+
+    const component = {
+      code,
+      version,
+      css,
+      js,
+      create: function (props, options) {
+        const opts = options || {};
+        const mountEl = opts.mountEl || defaultMountTarget();
+        const isolation = opts.cssIsolation || state.cssIsolation;
+
+        const tpl = ensureTemplate(code, html);
+        const fragment = tpl.content.cloneNode(true);
+
+        let templateRootEl;
+        let instanceRoot;
+        let shadow = null;
+
+        if (isolation === 'shadow') {
+          const c = createShadowRootContainer();
+          instanceRoot = c.host;
+          shadow = c.shadow;
+          templateRootEl = shadow;
+          if (css) {
+            const style = document.createElement('style');
+            style.textContent = toStr(css);
+            shadow.appendChild(style);
+          }
+          shadow.appendChild(fragment);
+        } else {
+          instanceRoot = document.createElement('div');
+          templateRootEl = instanceRoot;
+          if (css) injectCssScoped(code, css);
+          instanceRoot.appendChild(fragment);
+        }
+
+        mountEl.appendChild(instanceRoot);
+
+        const api = {
+          unmount: function () {
+            try {
+              instanceRoot.remove();
+            } catch {}
+          },
+          mountEl,
+          hostEl: instanceRoot,
+          shadowRoot: shadow,
+        };
+
+        const fn = compileComponentJs(js);
+        let exported = {};
+        try {
+          exported = fn(api, templateRootEl, props || {}) || {};
+        } catch (e) {
+          exported = {
+            error: e,
+          };
+        }
+
+        return Object.assign({ api }, exported);
+      },
+    };
+
+    state.components[code] = component;
+    uiCmp[code] = component;
+    uiComponents[code] = component;
+  }
+
+  async function init(options) {
+    const opts = options || {};
+    const projectId = toStr(opts.projectId).trim();
+    if (!projectId) throw new Error('projectId is required');
+
+    const apiUrl = normalizeApiUrl(opts.apiUrl);
+    const apiKey = opts.apiKey;
+
+    state.projectId = projectId;
+    state.apiKey = apiKey;
+    state.apiUrl = apiUrl;
+
+    const cssIsolation = toStr(opts.cssIsolation || 'scoped').trim().toLowerCase();
+    state.cssIsolation = cssIsolation === 'shadow' ? 'shadow' : 'scoped';
+
+    const base = state.apiUrl;
+    const url = base + '/api/ui-components/projects/' + encodeURIComponent(projectId) + '/manifest';
+
+    const data = await fetchJson(url, buildHeaders(apiKey));
+    const items = data && Array.isArray(data.components) ? data.components : [];
+
+    for (const def of items) {
+      registerComponent(def);
+    }
+
+    state.initialized = true;
+    return { project: data ? data.project : null, count: items.length };
+  }
+
+  async function load(code) {
+    const c = toStr(code).trim().toLowerCase();
+    if (!c) throw new Error('code is required');
+    if (!state.projectId) throw new Error('uiCmp not initialized');
+    if (state.components[c]) return state.components[c];
+
+    const base = state.apiUrl;
+    const url =
+      base +
+      '/api/ui-components/projects/' +
+      encodeURIComponent(state.projectId) +
+      '/components/' +
+      encodeURIComponent(c);
+
+    const data = await fetchJson(url, buildHeaders(state.apiKey));
+    if (!data || !data.component) throw new Error('Component not found');
+
+    registerComponent(data.component);
+    return state.components[c];
+  }
+
+  const uiCmp = {
+    init,
+    load,
+    _state: state,
+  };
+
+  const uiComponents = uiCmp;
+
+  window.uiCmp = uiCmp;
+  window.uiComponents = uiComponents;
+})();