auth-events 0.0.2

package/README.md

@@ -0,0 +1,36 @@
+# auth-events
+
+![npm](https://img.shields.io/npm/v/auth-events) ![license](https://img.shields.io/github/license/<your-username>/auth-events)
+
+**auth-events** is a lightweight, open-source Node.js library designed to **track, monitor, and react to authentication events** across any authentication provider.  
+
+While providers like Auth0, Clerk, or Firebase handle authentication, they do **not provide an easy way to control and respond to post-auth events**. This library fills that gap by giving developers **visibility, control, and automation** over everything that happens after login.
+
+---
+
+## 🚀 Features
+
+- **Unified Event Tracking:** login, logout, password changes, role updates — all in one consistent API  
+- **Session Intelligence:** track active sessions, devices, locations, and token lifetimes  
+- **Rule Engine:** define custom logic for auth events (revoke sessions, force re-auth, trigger webhooks)  
+- **Provider-Agnostic:** works with Auth0, Clerk, Firebase, or any custom JWT auth  
+- **Developer-First:** minimal setup, zero magic, easy integration  
+
+---
+
+## 💡 Why Use auth-events?
+
+Traditional auth providers solve "who the user is", but **what happens after login** is often messy and error-prone.  
+
+With **auth-events**, developers can:  
+- Track all user sessions and devices  
+- Automatically enforce security rules (e.g., revoke old sessions after password change)  
+- React to suspicious logins or role changes  
+- Gain peace of mind and focus on business logic instead of boilerplate auth management  
+
+---
+
+## ⚡ Installation
+
+```bash
+npm install auth-events

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+type AuthEventType = "login" | "logout" | "password_changed" | "role_changed";
+interface AuthEvent {
+    type: AuthEventType;
+    userId: string;
+    sessionId?: string;
+    ip?: string;
+    userAgent?: string;
+    timestamp: Date;
+}
+type AuthEventHandler = (event: AuthEvent, context: unknown) => void | Promise<void>;
+
+declare class AuthEvents {
+    private bus;
+    on(type: AuthEventType, handler: AuthEventHandler): void;
+    emit(type: AuthEventType, payload: Omit<AuthEvent, "type" | "timestamp">): Promise<void>;
+    private createContext;
+}
+
+export { AuthEvent, AuthEventHandler, AuthEventType, AuthEvents };

package/dist/index.js

@@ -0,0 +1,36 @@
+// src/core/EventBus.ts
+var EventBus = class {
+  handlers = /* @__PURE__ */ new Map();
+  on(type, handler) {
+    const existing = this.handlers.get(type) ?? [];
+    this.handlers.set(type, [...existing, handler]);
+  }
+  async emit(event, context) {
+    const handlers = this.handlers.get(event.type) ?? [];
+    for (const handler of handlers) {
+      await handler(event, context);
+    }
+  }
+};
+
+// src/core/AuthEvents.ts
+var AuthEvents = class {
+  bus = new EventBus();
+  on(type, handler) {
+    this.bus.on(type, handler);
+  }
+  async emit(type, payload) {
+    const event = {
+      type,
+      timestamp: /* @__PURE__ */ new Date(),
+      ...payload
+    };
+    await this.bus.emit(event, this.createContext());
+  }
+  createContext() {
+    return {};
+  }
+};
+export {
+  AuthEvents
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "auth-events",
+  "version": "0.0.2",
+  "description": "A lightweight Node.js library to track and react to authentication events across any auth provider.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/index.js",
+    "dist/index.d.ts"
+  ],
+  "license": "MIT",
+  "author": "Meraj Ansari",
+  "keywords": [
+    "auth",
+    "authentication",
+    "sessions",
+    "events",
+    "nodejs",
+    "npm"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^6.6.0",
+    "typescript": "^5.1.6",
+    "@types/node": "^20.5.1",
+    "ts-node": "^10.9.1"
+  }
+}