@intranefr/superbackend 1.4.3

package/.commiat

@@ -0,0 +1,4 @@
+{
+  "format": "{type}: {msg}",
+  "variables": {}
+}

package/.env.example

@@ -0,0 +1,47 @@
+# Server
+PORT=3000
+NODE_ENV=development
+PUBLIC_URL=http://localhost:3000
+BILLING_RETURN_URL_RELATIVE=/billing/view
+
+# CORS Configuration
+# Use * for all origins (default) or specify comma-separated list
+# Examples:
+#   CORS_ORIGIN=*
+#   CORS_ORIGIN=http://localhost:3000
+#   CORS_ORIGIN=http://localhost:3000,https://app.com
+CORS_ORIGIN=*
+
+# Database
+MONGODB_URI=mongodb://localhost:27017/myappdb
+
+# JWT Secrets (change these in production!)
+JWT_ACCESS_SECRET=your-access-secret-change-me
+JWT_REFRESH_SECRET=your-refresh-secret-change-me
+
+# Stripe
+STRIPE_SECRET_KEY=sk_test_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+
+# Admin Basic Auth
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=change-me-in-production
+
+# Emailing
+RESEND_API_KEY=
+
+# File Storage (filesystem fallback)
+UPLOAD_DIR=uploads
+MAX_FILE_SIZE=10485760
+MAX_FILE_SIZE_HARD_CAP=10485760
+
+# Multer file size limit in bytes (used by Express middleware) (multer ceiling)
+#MULTER_FILE_SIZE_LIMIT=10485760
+
+# S3 / MinIO (optional - enables S3 backend when all are set)
+# 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

package/README.md

@@ -0,0 +1,110 @@
+# SuperBackend
+
+Node.js middleware that gives your project backend superpowers. Handles authentication, billing, audit logs, file storage, error tracking, and more—all in one cohesive layer.
+
+---
+
+## Features
+
+- **Authentication & Security**: JWT-based auth with refresh tokens, organization management, and granular RBAC system
+- **Billing & Subscriptions**: Full Stripe integration with checkout sessions, billing portal, and webhook processing
+- **File Storage**: Unified S3/filesystem API with multipart uploads, namespace support, and public/private visibility
+- **Admin Panel**: Basic-auth protected UI for user management, settings, metrics, and operational tasks
+- **Audit Logging**: Append-only audit trail for security and compliance with admin search interface
+- **Error Tracking**: Frontend + backend error aggregation with fingerprinting and admin triage UI
+- **Notifications**: Multi-channel system with in-app notifications and email alerts
+- **Feature Flags**: Dynamic feature toggles with rollout percentages and allow lists
+- **Global Settings**: Runtime configuration with encrypted storage support for secrets
+- **Forms & Leads**: Custom form definitions, lead capture, webhooks, and multi-tenant support
+- **Internationalization**: JSON-based localization with server-side and client-side integration
+- **Organizations**: Multi-tenant support with role-based member management
+- **Headless CMS**: JSON configs, SEO configuration, and content management
+- **Email System**: SMTP integration with templates and delivery tracking
+- **Webhooks**: Outgoing webhook system for event-driven integrations
+- **Metrics & Activity**: Usage tracking and analytics for business insights
+- **Middleware Mode**: Drop-in Express middleware that preserves your app structure
+
+---
+
+## Installation
+
+```bash
+npm install superbackend
+```
+
+or
+
+```bash
+yarn add superbackend
+```
+
+---
+
+## Quick Start
+
+```javascript
+require('dotenv').config();
+const express = require('express');
+const { middleware } = require('saasbackend');
+
+const app = express();
+
+// Mount under /saas prefix (recommended)
+app.use('/saas', middleware({
+  mongodbUri: process.env.MONGODB_URI,
+  corsOrigin: process.env.CORS_ORIGIN || '*',
+}));
+
+app.listen(3000, () => {
+  console.log('Server running on http://localhost:3000');
+});
+```
+
+---
+
+## Configuration
+
+SuperBackend is fully configurable. Example options:
+
+```javascript
+const backend = new SuperBackend({
+  rbac: { /* roles, permissions */ },
+  logging: { level: 'info', output: 'console' },
+  metrics: true,
+  queues: { redisUrl: 'redis://localhost:6379' },
+  audit: true,
+});
+```
+
+---
+
+## Documentation
+
+See the `docs/features/` directory for detailed guides:
+- [Getting Started](docs/features/getting-started.md)
+- [Core Configuration](docs/features/core-configuration.md)
+- [Admin API Usage](docs/features/admin-api-usage.md)
+- [Billing & Subscriptions](docs/features/billing-and-subscriptions.md)
+
+---
+
+## Contributing
+
+SuperBackend is open-source and welcomes contributions!  
+Please read the [CONTRIBUTING.md](#) for guidelines.
+
+---
+
+<!-- Made by Intrane block -->
+<p><em>Part of the Intrane suite of practical developer tools</em></p>
+<a href="https://intrane.fr" target="_blank">
+  <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>
+
+## License
+
+MIT © 2026 Intrane

package/index.js

@@ -0,0 +1,94 @@
+require("dotenv").config({ path: process.env.ENV_FILE || ".env" });
+const express = require("express");
+
+/**
+ * Creates the SaaS backend as Express middleware
+ * @param {Object} options - Configuration options
+ * @param {string} options.mongodbUri - MongoDB connection string
+ * @param {string} options.corsOrigin - CORS origin(s)
+ * @param {string} options.jwtSecret - JWT secret for authentication
+ * @param {Object} options.dbConnection - Existing Mongoose connection
+ * @returns {express.Router} Configured Express router
+ */
+const middleware = require("./src/middleware");
+
+/**
+ * Creates and starts a standalone SaaS backend server
+ * @param {Object} options - Configuration options
+ * @param {number} options.port - Port to listen on
+ * @param {string} options.mongodbUri - MongoDB connection string
+ * @param {string} options.corsOrigin - CORS origin(s)
+ * @returns {Object} Express app and server instance
+ */
+function startServer(options = {}) {
+  const app = express();
+  const PORT = options.port || process.env.PORT || 3000;
+
+  app.use(module.exports.middleware(options));
+
+  // Start server
+  const server = app.listen(PORT, () => {
+    console.log(`🚀 SaaSBackend standalone server running on http://localhost:${PORT}`);
+  });
+
+  return { app, server };
+}
+
+const saasbackend = {
+  server: startServer,
+  middleware: (options = {}) => {
+    globalThis.saasbackend = saasbackend;
+    return middleware(options);
+  },
+  services: {
+    email: require("./src/services/email.service"),
+    storage: require("./src/services/storage"),
+    i18n: require("./src/services/i18n.service"),
+    audit: require("./src/services/audit.service"),
+    globalSettings: require("./src/services/globalSettings.service"),
+    jsonConfigs: require("./src/services/jsonConfigs.service"),
+    assets: require("./src/services/assets.service"),
+    uploadNamespaces: require("./src/services/uploadNamespaces.service"),
+    llm: require("./src/services/llm.service"),
+    migration: require("./src/services/migration.service"),
+    ejsVirtual: require("./src/services/ejsVirtual.service"),
+    forms: require("./src/services/forms.service"),
+    webhooks: require("./src/services/webhook.service"),
+    workflow: require("./src/services/workflow.service"),
+  },
+  models: {
+    ActionEvent: require("./src/models/ActionEvent"),
+    ActivityLog: require("./src/models/ActivityLog"),
+    Asset: require("./src/models/Asset"),
+    AuditEvent: require("./src/models/AuditEvent"),
+    EmailLog: require("./src/models/EmailLog"),
+    ErrorAggregate: require("./src/models/ErrorAggregate"),
+    FormSubmission: require("./src/models/FormSubmission"),
+    GlobalSetting: require("./src/models/GlobalSetting"),
+    I18nEntry: require("./src/models/I18nEntry"),
+    I18nLocale: require("./src/models/I18nLocale"),
+    Invite: require("./src/models/Invite"),
+    JsonConfig: require("./src/models/JsonConfig"),
+    Notification: require("./src/models/Notification"),
+    Organization: require("./src/models/Organization"),
+    OrganizationMember: require("./src/models/OrganizationMember"),
+    StripeCatalogItem: require("./src/models/StripeCatalogItem"),
+    StripeWebhookEvent: require("./src/models/StripeWebhookEvent"),
+    User: require("./src/models/User"),
+    WaitingList: require("./src/models/WaitingList"),
+    VirtualEjsFile: require("./src/models/VirtualEjsFile"),
+    VirtualEjsFileVersion: require("./src/models/VirtualEjsFileVersion"),
+    VirtualEjsGroupChange: require("./src/models/VirtualEjsGroupChange"),
+    Webhook: require("./src/models/Webhook"),
+    Workflow: require("./src/models/Workflow"),
+    WorkflowExecution: require("./src/models/WorkflowExecution"),
+  },
+  helpers: {
+    auth: require("./src/middleware/auth"),
+    org: require("./src/middleware/org"),
+    i18n: require("./src/services/i18n.service"),
+    jsonConfigs: require("./src/services/jsonConfigs.service"),
+  },
+};
+
+module.exports = saasbackend;

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@intranefr/superbackend",
+  "version": "1.4.3",
+  "description": "Node.js middleware that gives your project backend superpowers",
+  "main": "index.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js",
+    "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",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "substack",
+    "notes",
+    "automation",
+    "ai"
+  ],
+  "author": "Javier Leandro Arancibia <arancibia.javier@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/javimosch/superbackend"
+  },
+  "homepage": "https://javimosch.github.io/superbackend/",
+  "bugs": {
+    "url": "https://github.com/javimosch/superbackend/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.0.0",
+    "axios": "^1.13.2",
+    "bcryptjs": "^2.4.3",
+    "cheerio": "^1.0.0-rc.12",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "ejs": "^3.1.9",
+    "express": "^4.18.2",
+    "jsonwebtoken": "^9.0.2",
+    "mongoose": "^8.0.0",
+    "multer": "^1.4.5-lts.1",
+    "openai": "^4.0.0",
+    "resend": "^6.4.0",
+    "ssh2-sftp-client": "^12.0.1",
+    "stripe": "^14.0.0",
+    "vm2": "^3.10.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0",
+    "jest": "^29.7.0",
+    "nodemon": "^3.0.1",
+    "supertest": "^7.1.4"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "collectCoverageFrom": [
+      "src/**/*.js",
+      "!src/**/*.test.js"
+    ],
+    "testMatch": [
+      "**/__tests__/**/*.js",
+      "**/*.test.js"
+    ]
+  }
+}

package/public/css/styles.css

@@ -0,0 +1,139 @@
+/* Custom Animations and Styles */
+
+/* Fade in animations */
+.fade-in {
+  animation: fadeIn 0.8s ease-in;
+}
+
+.fade-in-delayed {
+  animation: fadeIn 0.8s ease-in 0.3s both;
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(20px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* Floating note icons animation */
+.note-icon {
+  position: absolute;
+  animation: float 8s ease-in-out infinite;
+}
+
+@keyframes float {
+  0%, 100% {
+    opacity: 0.1;
+    transform: translateY(0) translateX(0);
+  }
+  25% {
+    opacity: 0.3;
+    transform: translateY(-100px) translateX(50px);
+  }
+  50% {
+    opacity: 0.2;
+    transform: translateY(-200px) translateX(-30px);
+  }
+  75% {
+    opacity: 0.3;
+    transform: translateY(-300px) translateX(70px);
+  }
+}
+
+/* Floating cards animation */
+.float-card {
+  animation: floatCard 3s ease-in-out infinite;
+}
+
+@keyframes floatCard {
+  0%, 100% {
+    transform: translateY(0);
+  }
+  50% {
+    transform: translateY(-10px);
+  }
+}
+
+/* CTA Button pulse effect */
+.cta-button {
+  animation: pulse 2s ease-in-out infinite;
+}
+
+@keyframes pulse {
+  0%, 100% {
+    box-shadow: 0 10px 25px rgba(126, 211, 33, 0.3);
+  }
+  50% {
+    box-shadow: 0 15px 35px rgba(126, 211, 33, 0.5);
+  }
+}
+
+/* Scroll reveal animation */
+.scroll-reveal {
+  opacity: 0;
+  transform: translateY(30px);
+  transition: opacity 0.6s ease, transform 0.6s ease;
+}
+
+.scroll-reveal.revealed {
+  opacity: 1;
+  transform: translateY(0);
+}
+
+/* Feature card hover effects */
+.feature-card {
+  transition: all 0.3s ease;
+}
+
+.feature-card:hover {
+  transform: translateY(-8px);
+  box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
+}
+
+/* Testimonial card effects */
+.testimonial-card {
+  transition: all 0.3s ease;
+}
+
+.testimonial-card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.08);
+}
+
+/* Pricing card effects */
+.pricing-card {
+  transition: all 0.3s ease;
+}
+
+.pricing-card:hover {
+  transform: scale(1.02);
+  box-shadow: 0 25px 50px rgba(0, 0, 0, 0.15);
+}
+
+/* Smooth scrolling */
+html {
+  scroll-behavior: smooth;
+}
+
+/* Custom scrollbar */
+::-webkit-scrollbar {
+  width: 10px;
+}
+
+::-webkit-scrollbar-track {
+  background: #f1f1f1;
+}
+
+::-webkit-scrollbar-thumb {
+  background: #4A90E2;
+  border-radius: 5px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: #357ABD;
+}

package/public/js/animations.js

@@ -0,0 +1,41 @@
+// Intersection Observer for scroll animations
+const observerOptions = {
+  threshold: 0.1,
+  rootMargin: '0px 0px -100px 0px'
+};
+
+const observer = new IntersectionObserver((entries) => {
+  entries.forEach(entry => {
+    if (entry.isIntersecting) {
+      entry.target.classList.add('revealed');
+    }
+  });
+}, observerOptions);
+
+// Observe all scroll-reveal elements
+document.addEventListener('DOMContentLoaded', () => {
+  const scrollElements = document.querySelectorAll('.scroll-reveal');
+  scrollElements.forEach(el => observer.observe(el));
+});
+
+// Smooth scroll for anchor links
+document.querySelectorAll('a[href^="#"]').forEach(anchor => {
+  anchor.addEventListener('click', function (e) {
+    const href = this.getAttribute('href');
+    if (href !== '#' && href !== '#demo') {
+      e.preventDefault();
+      const target = document.querySelector(href);
+      if (target) {
+        target.scrollIntoView({
+          behavior: 'smooth',
+          block: 'start'
+        });
+      }
+    }
+  });
+});
+
+// Add loading animation class
+window.addEventListener('load', () => {
+  document.body.classList.add('loaded');
+});

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

@@ -0,0 +1,16 @@
+{
+  "name": "@saasbackend/error-tracking-browser-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "esbuild src/embed.js --bundle --format=iife --global-name=saasbackendErrorTrackingEmbed --outfile=dist/embed.iife.js --minify"
+  },
+  "devDependencies": {
+    "esbuild": "^0.27.2"
+  }
+}