guardian-risk-redis 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guardian Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# guardian-risk-redis
+
+> **Requires:** [`guardian-risk`](https://www.npmjs.com/package/guardian-risk) (core)
+
+```bash
+npm install guardian-risk guardian-risk-redis
+```
+
+> **Stub package** — API may change before `1.0.0`.
+
+Redis integration for [guardian-risk](https://www.npmjs.com/package/guardian-risk). Stores events and exposes session-based counters as signals.
+
+## Planned signals
+
+| Signal | Source |
+|--------|--------|
+| `requestsPerMinute` | Sliding window counter |
+| `sessionAge` | First-seen timestamp |
+| `failedLoginCount` | Incremented on auth failures |
+| `uniqueIpsPerSession` | HyperLogLog or set cardinality |
+
+## Usage (stub)
+
+```typescript
+import { Guardian } from 'guardian-risk';
+import { redisPlugin, loadSessionSignals } from 'guardian-risk-redis';
+
+const guardian = new Guardian().use(
+  redisPlugin({ url: process.env.REDIS_URL, keyPrefix: 'app:risk:' }),
+);
+
+await loadSessionSignals('session-123', guardian);
+const report = guardian.analyze();
+```
+
+## Status
+
+Not yet published. Implementation in progress.

package/dist/index.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+// src/index.ts
+function redisPlugin(options = {}) {
+  const { url = "redis://localhost:6379", keyPrefix = "guardian:" } = options;
+  return {
+    name: "guardian-risk-redis",
+    install(_guardian) {
+    }
+  };
+}
+async function loadSessionSignals(_sessionId, guardian) {
+  return guardian.signal("signalSource", "redis").signal("redisPlugin", "stub");
+}
+
+exports.loadSessionSignals = loadSessionSignals;
+exports.redisPlugin = redisPlugin;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAgBO,SAAS,WAAA,CAAY,OAAA,GAA8B,EAAC,EAAW;AACpE,EAAA,MAAM,EAAE,GAAA,GAAM,wBAAA,EAA0B,SAAA,GAAY,aAAY,GAAI,OAAA;AAEpE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,qBAAA;AAAA,IACN,QAAQ,SAAA,EAAW;AAEZ,IAEP;AAAA,GACF;AACF;AAKA,eAAsB,kBAAA,CACpB,YACA,QAAA,EAC2C;AAC3C,EAAA,OAAO,SACJ,MAAA,CAAO,cAAA,EAAgB,OAAO,CAAA,CAC9B,MAAA,CAAO,eAAe,MAAM,CAAA;AACjC","file":"index.cjs","sourcesContent":["import type { Plugin } from 'guardian-risk';\n\n/** Options for the Redis plugin (stub). */\nexport interface RedisPluginOptions {\n  /** Redis connection URL. */\n  readonly url?: string;\n  /** Key prefix for Guardian counters. */\n  readonly keyPrefix?: string;\n}\n\n/**\n * Redis plugin for guardian-risk.\n *\n * @stub Future versions will read/write session counters in Redis and\n * expose signals like `requestsPerMinute` and `sessionAge`.\n */\nexport function redisPlugin(options: RedisPluginOptions = {}): Plugin {\n  const { url = 'redis://localhost:6379', keyPrefix = 'guardian:' } = options;\n\n  return {\n    name: 'guardian-risk-redis',\n    install(_guardian) {\n      void url;\n      void keyPrefix;\n      // Stub: will connect to Redis and sync counters into signals\n    },\n  };\n}\n\n/**\n * @stub Future helper to load session counters from Redis into signals.\n */\nexport async function loadSessionSignals(\n  _sessionId: string,\n  guardian: import('guardian-risk').Guardian,\n): Promise<import('guardian-risk').Guardian> {\n  return guardian\n    .signal('signalSource', 'redis')\n    .signal('redisPlugin', 'stub');\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import * as guardian_risk from 'guardian-risk';
+import { Plugin } from 'guardian-risk';
+
+/** Options for the Redis plugin (stub). */
+interface RedisPluginOptions {
+    /** Redis connection URL. */
+    readonly url?: string;
+    /** Key prefix for Guardian counters. */
+    readonly keyPrefix?: string;
+}
+/**
+ * Redis plugin for guardian-risk.
+ *
+ * @stub Future versions will read/write session counters in Redis and
+ * expose signals like `requestsPerMinute` and `sessionAge`.
+ */
+declare function redisPlugin(options?: RedisPluginOptions): Plugin;
+/**
+ * @stub Future helper to load session counters from Redis into signals.
+ */
+declare function loadSessionSignals(_sessionId: string, guardian: guardian_risk.Guardian): Promise<guardian_risk.Guardian>;
+
+export { type RedisPluginOptions, loadSessionSignals, redisPlugin };

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import * as guardian_risk from 'guardian-risk';
+import { Plugin } from 'guardian-risk';
+
+/** Options for the Redis plugin (stub). */
+interface RedisPluginOptions {
+    /** Redis connection URL. */
+    readonly url?: string;
+    /** Key prefix for Guardian counters. */
+    readonly keyPrefix?: string;
+}
+/**
+ * Redis plugin for guardian-risk.
+ *
+ * @stub Future versions will read/write session counters in Redis and
+ * expose signals like `requestsPerMinute` and `sessionAge`.
+ */
+declare function redisPlugin(options?: RedisPluginOptions): Plugin;
+/**
+ * @stub Future helper to load session counters from Redis into signals.
+ */
+declare function loadSessionSignals(_sessionId: string, guardian: guardian_risk.Guardian): Promise<guardian_risk.Guardian>;
+
+export { type RedisPluginOptions, loadSessionSignals, redisPlugin };

package/dist/index.js

@@ -0,0 +1,16 @@
+// src/index.ts
+function redisPlugin(options = {}) {
+  const { url = "redis://localhost:6379", keyPrefix = "guardian:" } = options;
+  return {
+    name: "guardian-risk-redis",
+    install(_guardian) {
+    }
+  };
+}
+async function loadSessionSignals(_sessionId, guardian) {
+  return guardian.signal("signalSource", "redis").signal("redisPlugin", "stub");
+}
+
+export { loadSessionSignals, redisPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAgBO,SAAS,WAAA,CAAY,OAAA,GAA8B,EAAC,EAAW;AACpE,EAAA,MAAM,EAAE,GAAA,GAAM,wBAAA,EAA0B,SAAA,GAAY,aAAY,GAAI,OAAA;AAEpE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,qBAAA;AAAA,IACN,QAAQ,SAAA,EAAW;AAEZ,IAEP;AAAA,GACF;AACF;AAKA,eAAsB,kBAAA,CACpB,YACA,QAAA,EAC2C;AAC3C,EAAA,OAAO,SACJ,MAAA,CAAO,cAAA,EAAgB,OAAO,CAAA,CAC9B,MAAA,CAAO,eAAe,MAAM,CAAA;AACjC","file":"index.js","sourcesContent":["import type { Plugin } from 'guardian-risk';\n\n/** Options for the Redis plugin (stub). */\nexport interface RedisPluginOptions {\n  /** Redis connection URL. */\n  readonly url?: string;\n  /** Key prefix for Guardian counters. */\n  readonly keyPrefix?: string;\n}\n\n/**\n * Redis plugin for guardian-risk.\n *\n * @stub Future versions will read/write session counters in Redis and\n * expose signals like `requestsPerMinute` and `sessionAge`.\n */\nexport function redisPlugin(options: RedisPluginOptions = {}): Plugin {\n  const { url = 'redis://localhost:6379', keyPrefix = 'guardian:' } = options;\n\n  return {\n    name: 'guardian-risk-redis',\n    install(_guardian) {\n      void url;\n      void keyPrefix;\n      // Stub: will connect to Redis and sync counters into signals\n    },\n  };\n}\n\n/**\n * @stub Future helper to load session counters from Redis into signals.\n */\nexport async function loadSessionSignals(\n  _sessionId: string,\n  guardian: import('guardian-risk').Guardian,\n): Promise<import('guardian-risk').Guardian> {\n  return guardian\n    .signal('signalSource', 'redis')\n    .signal('redisPlugin', 'stub');\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "guardian-risk-redis",
+  "version": "0.1.0",
+  "description": "Redis plugin for guardian-risk — session counters and event history",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "guardian-risk",
+    "guardian-risk-redis",
+    "redis",
+    "session",
+    "rate-limit",
+    "risk"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/himanshu6306singh/guardian-risk.git",
+    "directory": "packages/redis"
+  },
+  "homepage": "https://github.com/himanshu6306singh/guardian-risk/tree/main/packages/redis#readme",
+  "bugs": {
+    "url": "https://github.com/himanshu6306singh/guardian-risk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "guardian-risk": "^0.2.0",
+    "ioredis": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "guardian-risk": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}