keypointjs 1.0.0 → 1.1.0

package/README.md

@@ -6,8 +6,6 @@
 
 </div>
 
-Based on your complete codebase, here is the comprehensive documentation:
-
 <div align="center">
 <p align="center">
   <img alt="GitHub" src="https://img.shields.io/github/license/anasbex-dev/keypointjs?color=blue">
@@ -23,7 +21,6 @@ Based on your complete codebase, here is the comprehensive documentation:
 </div>
 
 
-
 # Project Overview
 
 KeypointJS is a sophisticated, layered authentication and authorization framework for Node.js with built-in security features, plugin architecture, and real-time capabilities.
@@ -51,7 +48,6 @@ Layered Middleware System
 │ Layer 7: Response Processing    │
 └─────────────────────────────────┘
 ```
-
 # File Structure & Responsibilities
 
 ## Core Components (core/)
@@ -192,6 +188,16 @@ responses
 
 Installation & Setup
 
+``` bash
+
+npm install keypointjs
+# or
+yarn add keypointjs
+# or
+pnpm add keypointjs
+
+```
+
 ```javascript
 import { KeypointJS } from './src/keypointJS.js';
 
@@ -800,7 +806,10 @@ Apache-2.0 license - see the LICENSE file for details.
 - Contributions: PRs welcome for bug fixes and features
 - Questions: Open a discussion for usage questions
 
----
+## KeypointJS is Independent
+
+KeypointJS does not depend on Express, Fastify, or any third-party HTTP framework.
+It ships with its own HTTP server, routing system, middleware pipeline, and security layer.
 
 ## Created Base ♥️ KeypointJS
 ### AnasBex - (⁠づ⁠￣⁠ ⁠³⁠￣⁠)⁠づ 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keypointjs",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "KeypointJS Identity-First API Framework with Mandatory Authentication",
   "main": "src/keypointJS.js",
   "type": "module",
@@ -12,6 +12,7 @@
     "./keypoint/validator": "./src/keypoint/KeypointValidator.js",
     "./keypoint/scopes": "./src/keypoint/ScopeManager.js",
     "./plugins": "./src/plugins/PluginManager.js",
+    "./plugins/transformer": "./src/plugins/transformer/TransformerPlugin.js",
     "./plugins/audit": "./src/plugins/AuditLogger.js",
     "./plugins/ratelimit": "./src/plugins/RateLimiter.js",
     "./plugins/websocket": "./src/plugins/WebSocketGuard.js",

package/src/plugins/transformer/TransformerPlugin.js

@@ -0,0 +1,82 @@
+// Copyright AnasBex - 2026 TransformersPlugin.js
+/*
+
+API response standardization
+
+Inject metadata (requestId, timestamp, duration)
+
+Optional envelope (success, data, error)
+
+*/
+
+export class TransformerPlugin {
+  constructor(options = {}) {
+    this.options = {
+      envelope: true,
+      addRequestId: true,
+      addTimestamp: true,
+      addDuration: true,
+      ...options
+    };
+  }
+
+  async process(ctx, next) {
+    const start = Date.now();
+
+    const response = await next(ctx);
+
+    // Jika handler return null / undefined
+    if (!response) return response;
+
+    // Jika response bukan object API KeypointJS
+    if (typeof response !== 'object' || !response.body) {
+      return response;
+    }
+
+    const duration = Date.now() - start;
+
+    // Error response
+    if (response.status >= 400) {
+      return {
+        ...response,
+        body: this.options.envelope
+          ? {
+              success: false,
+              error: response.body,
+              meta: this._meta(ctx, duration)
+            }
+          : response.body
+      };
+    }
+
+    // Success response
+    return {
+      ...response,
+      body: this.options.envelope
+        ? {
+            success: true,
+            data: response.body,
+            meta: this._meta(ctx, duration)
+          }
+        : response.body
+    };
+  }
+
+  _meta(ctx, duration) {
+    const meta = {};
+
+    if (this.options.addRequestId) {
+      meta.requestId = ctx.id;
+    }
+
+    if (this.options.addTimestamp) {
+      meta.timestamp = new Date().toISOString();
+    }
+
+    if (this.options.addDuration) {
+      meta.durationMs = duration;
+    }
+
+    return meta;
+  }
+}