@voltrix/security 0.3.0

package/dist/types/index.d.ts

@@ -0,0 +1,98 @@
+import type { IRequest, IResponse } from '@voltrix/core';
+/**
+ * Interface representing a shared caching store for security modules.
+ * This abstracts local memory from clustered distributed instances like Redis.
+ */
+export interface SecurityStore {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlMs: number): Promise<void>;
+    increment(key: string, ttlMs: number): Promise<number>;
+    decrement(key: string): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Helmet module configuration options.
+ */
+export interface HelmetOptions {
+    csp?: boolean | Record<string, string[]>;
+    hsts?: boolean | {
+        maxAge?: number;
+        includeSubDomains?: boolean;
+        preload?: boolean;
+    };
+    xFrame?: boolean | 'DENY' | 'SAMEORIGIN';
+    xContentType?: boolean;
+    referrerPolicy?: boolean | string;
+    permissionsPolicy?: boolean | Record<string, string>;
+}
+/**
+ * CORS module configuration options.
+ */
+export interface CorsOptions {
+    origin?: string | string[] | ((origin: string) => boolean | Promise<boolean>);
+    methods?: string | string[];
+    allowedHeaders?: string | string[];
+    exposedHeaders?: string | string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
+/**
+ * Rate Limiting module configuration options.
+ */
+export interface RateLimitOptions {
+    windowMs?: number;
+    limit?: number;
+    keyGenerator?: (req: IRequest) => string | Promise<string>;
+    store?: SecurityStore;
+    handler?: (req: IRequest, res: IResponse) => void | Promise<void>;
+}
+/**
+ * IP Filtering module configuration options.
+ */
+export interface IpFilterOptions {
+    whitelist?: string[];
+    blacklist?: string[];
+    handler?: (req: IRequest, res: IResponse) => void | Promise<void>;
+}
+/**
+ * CSRF Protection module configuration options.
+ */
+export interface CsrfOptions {
+    cookieName?: string;
+    headerName?: string;
+    cookieOptions?: {
+        path?: string;
+        domain?: string;
+        secure?: boolean;
+        httpOnly?: boolean;
+        sameSite?: 'Strict' | 'Lax' | 'None';
+    };
+    ignoreMethods?: string[];
+}
+/**
+ * Session Management module configuration options.
+ */
+export interface SessionOptions {
+    secret: string;
+    cookieName?: string;
+    ttlMs?: number;
+    store?: SecurityStore;
+    cookieOptions?: {
+        path?: string;
+        domain?: string;
+        secure?: boolean;
+        httpOnly?: boolean;
+        sameSite?: 'Strict' | 'Lax' | 'None';
+    };
+}
+/**
+ * Complete security module options pack.
+ */
+export interface SecurityOptions {
+    helmet?: boolean | HelmetOptions;
+    cors?: boolean | CorsOptions;
+    rateLimit?: boolean | RateLimitOptions;
+    ipFilter?: boolean | IpFilterOptions;
+    csrf?: boolean | CsrfOptions;
+    session?: boolean | SessionOptions;
+}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@voltrix/security",
+  "version": "0.3.0",
+  "description": "High-performance distributed security package (CORS, Rate Limiting, IP Firewall, CSRF, Helmet, Sessions) for Voltrix",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "voltrix",
+    "security",
+    "cors",
+    "rate-limit",
+    "helmet",
+    "csrf",
+    "session",
+    "ip-filter",
+    "firewall"
+  ],
+  "author": "Voltrix Team",
+  "license": "MIT",
+  "dependencies": {
+    "ioredis": "^5.4.1",
+    "reflect-metadata": "^0.2.2",
+    "tslib": "^2.8.1",
+    "@voltrix/core": "0.3.0",
+    "@voltrix/injector": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "5.9.3",
+    "vitest": "^4.1.0",
+    "@voltrix/decorator": "0.2.2",
+    "@voltrix/server": "0.2.1"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  }
+}