🧩 DSA Middleware BB

A lightweight and secure middleware for integrating Data Security Agent (DSA) capabilities into your Node.js or NestJS applications.

DSA (Data Security Agent) is a lightweight, plug-and-play middleware designed to automatically protect sensitive data in your API responses and files before they leave your server.

It intelligently scans and masks sensitive information such as emails, phone numbers, credit card details, and personal identifiers based on your configured agent rules — ensuring data privacy and compliance without changing your application logic.

🔒 Key Features

• 🧩 Universal Middleware — works with Express, NestJS, and other Node.js frameworks.
• ⚙️ Plug-and-Play Setup — integrate in seconds with a single app.use() call.
• 🧠 Smart Detection Engine — masks sensitive information dynamically before sending a response.
• 📄 Supports Multiple Formats — compatible with JSON, XML, and even DOCX files.
• 🧾 Custom Rules — define your own masking logic per agent/account for flexible security policies.

🧰 Use Cases

• ✅ Mask personal data (email, phone, card numbers) before returning API responses.
• ✅ Sanitize downloadable files like .docx or .xml automatically.
• ✅ Enforce organization-wide data security rules centrally.

🧱 How It Works

• The middleware intercepts every HTTP response before it’s sent to the client.
• It scans response bodies or file buffers for sensitive data patterns.
• Matches are masked or replaced according to your DSA agent configuration.
• The cleaned, privacy-safe data is then delivered to the end user.

🚀 Installation

npm install dsa-middleware-bb
# or
yarn add dsa-middleware-bb

⚙️ Usage in Node.js (CommonJS)

const express = require("express");
const { dsaMiddleware } = require("dsa-middleware-bb");

const app = express();

app.use(
  dsaMiddleware({
    accountId: "<YOUR_ACCOUNT_ID>",
    agentId: "<YOUR_AGENT_ID>",
    email: "<YOUR_EMAIL>",
    password: "<YOUR_PASSWORD>",
    debug: true, // optional: logs internal activity
  })
);

app.get("/", (req, res) => {
  res.send("✅ DSA Middleware Active!");
});

app.listen(3000, () => console.log("Server running on http://localhost:3000"));

⚙️ Usage in TypeScript / NestJS

1️⃣ Install

npm install dsa-middleware-bb

2️⃣ Register Middleware in main.ts

import { NestFactory } from "@nestjs/core";
import { AppModule } from "./app.module";
import { dsaMiddleware } from "dsa-middleware-bb";

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  app.use(
    dsaMiddleware({
      accountId: "<YOUR_ACCOUNT_ID>",
      agentId: "<YOUR_AGENT_ID>",
      email: "<YOUR_EMAIL>",
      password: "<YOUR_PASSWORD>",
    })
  );

  await app.listen(3000);
  console.log("🚀 NestJS App running on http://localhost:3000");
}

bootstrap();

⚙️ Configuration Options

| Option | Type | Required | Description | | ----------- | --------- | -------- | ------------------------------------------- | | accountId | string | ✅ Yes | Unique account identifier | | agentId | string | ✅ Yes | Registered agent ID | | email | string | ✅ Yes | Login email for agent authentication | | password | string | ✅ Yes | Login password for agent authentication | | debug | boolean | ❌ No | Enables detailed console logs for debugging |

🧠 Middleware Behavior

Once applied, dsaMiddleware will:

• Secure and hide sesitive information in each response.
• Information like Card numbers, Mobile numbers, emails, etc.
• Everything is masked based on defined rules.

🧩 Example Output (Debug Mode)

✅ Agent registration and authentication successful
 > Scheduling Re-Authentication
 > Re-Authentication Scheduled every 3 minutes
 > Report Sync Scheduled every 1 minutes

📦 Latest Version

Version: 0.0.1
(Always check the npm registry for the latest release.)

🧰 Troubleshooting

| Issue | Possible Cause | Solution | | --------------------- | -------------------- | ----------------------------------------------------------------- | | Invalid credentials | Wrong email/password | Verify your credentials | | Unauthorized agent | Invalid agentId | Check your agent registration | | Request blocked | Missing middleware | Ensure app.use(dsaMiddleware(...)) is placed before your routes |

📜 License

MIT © [Your Organization or Name]

💬 Support

For issues, suggestions, or contributions:
👉 Open a GitHub Issue

💡 Pro Tip

Use environment variables to keep your credentials secure:

ACCOUNT_ID=acc_12345
AGENT_ID=agent_56789
[email protected]
AGENT_PASSWORD=supersecret

app.use(
  dsaMiddleware({
    accountId: process.env.ACCOUNT_ID,
    agentId: process.env.AGENT_ID,
    email: process.env.AGENT_EMAIL,
    password: process.env.AGENT_PASSWORD,
  })
);

🧩 Simple. Secure. Smart — That’s DSA Middleware.

📜 Changelog

See full details in CHANGELOG.md