guardian-risk-browser 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,36 @@
+# guardian-risk-browser
+
+> **Requires:** [`guardian-risk`](https://www.npmjs.com/package/guardian-risk) (core)
+
+```bash
+npm install guardian-risk guardian-risk-browser
+```
+
+> **Stub package** — API may change before `1.0.0`.
+
+Browser integration for [guardian-risk](https://www.npmjs.com/package/guardian-risk). Collects client-side behavioral and fingerprint signals.
+
+## Planned signals
+
+| Signal | Source |
+|--------|--------|
+| `mouseLinearity` | Mouse movement patterns |
+| `keystrokeInterval` | Typing rhythm |
+| `headlessUA` | User agent heuristics |
+| `canvasFingerprint` | Canvas hash |
+
+## Usage (stub)
+
+```typescript
+import { Guardian } from 'guardian-risk';
+import { browserPlugin, collectSignals } from 'guardian-risk-browser';
+
+const guardian = new Guardian().use(browserPlugin());
+
+collectSignals(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 browserPlugin(options = {}) {
+  const { container = "document" } = options;
+  return {
+    name: "guardian-risk-browser",
+    install(_guardian) {
+    }
+  };
+}
+function collectSignals(guardian) {
+  return guardian.signal("signalSource", "browser").signal("browserPlugin", "stub");
+}
+
+exports.browserPlugin = browserPlugin;
+exports.collectSignals = collectSignals;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAcO,SAAS,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAW;AACxE,EAAA,MAAM,EAAE,SAAA,GAAY,UAAA,EAAW,GAAI,OAAA;AAEnC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,uBAAA;AAAA,IACN,QAAQ,SAAA,EAAW;AACZ,IAEP;AAAA,GACF;AACF;AAKO,SAAS,eACd,QAAA,EACkC;AAClC,EAAA,OAAO,SACJ,MAAA,CAAO,cAAA,EAAgB,SAAS,CAAA,CAChC,MAAA,CAAO,iBAAiB,MAAM,CAAA;AACnC","file":"index.cjs","sourcesContent":["import type { Plugin } from 'guardian-risk';\n\n/** Options for the browser plugin (stub). */\nexport interface BrowserPluginOptions {\n  /** DOM element to attach behavioral collectors. Defaults to document. */\n  readonly container?: string;\n}\n\n/**\n * Browser plugin for guardian-risk.\n *\n * @stub Future versions will collect mouse, keyboard, and fingerprint signals\n * in the page and add them to Guardian before analysis.\n */\nexport function browserPlugin(options: BrowserPluginOptions = {}): Plugin {\n  const { container = 'document' } = options;\n\n  return {\n    name: 'guardian-risk-browser',\n    install(_guardian) {\n      void container;\n      // Stub: collectors will attach listeners and call guardian.signal()\n    },\n  };\n}\n\n/**\n * @stub Future helper to start client-side signal collection.\n */\nexport function collectSignals(\n  guardian: import('guardian-risk').Guardian,\n): import('guardian-risk').Guardian {\n  return guardian\n    .signal('signalSource', 'browser')\n    .signal('browserPlugin', 'stub');\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import * as guardian_risk from 'guardian-risk';
+import { Plugin } from 'guardian-risk';
+
+/** Options for the browser plugin (stub). */
+interface BrowserPluginOptions {
+    /** DOM element to attach behavioral collectors. Defaults to document. */
+    readonly container?: string;
+}
+/**
+ * Browser plugin for guardian-risk.
+ *
+ * @stub Future versions will collect mouse, keyboard, and fingerprint signals
+ * in the page and add them to Guardian before analysis.
+ */
+declare function browserPlugin(options?: BrowserPluginOptions): Plugin;
+/**
+ * @stub Future helper to start client-side signal collection.
+ */
+declare function collectSignals(guardian: guardian_risk.Guardian): guardian_risk.Guardian;
+
+export { type BrowserPluginOptions, browserPlugin, collectSignals };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as guardian_risk from 'guardian-risk';
+import { Plugin } from 'guardian-risk';
+
+/** Options for the browser plugin (stub). */
+interface BrowserPluginOptions {
+    /** DOM element to attach behavioral collectors. Defaults to document. */
+    readonly container?: string;
+}
+/**
+ * Browser plugin for guardian-risk.
+ *
+ * @stub Future versions will collect mouse, keyboard, and fingerprint signals
+ * in the page and add them to Guardian before analysis.
+ */
+declare function browserPlugin(options?: BrowserPluginOptions): Plugin;
+/**
+ * @stub Future helper to start client-side signal collection.
+ */
+declare function collectSignals(guardian: guardian_risk.Guardian): guardian_risk.Guardian;
+
+export { type BrowserPluginOptions, browserPlugin, collectSignals };

package/dist/index.js

@@ -0,0 +1,16 @@
+// src/index.ts
+function browserPlugin(options = {}) {
+  const { container = "document" } = options;
+  return {
+    name: "guardian-risk-browser",
+    install(_guardian) {
+    }
+  };
+}
+function collectSignals(guardian) {
+  return guardian.signal("signalSource", "browser").signal("browserPlugin", "stub");
+}
+
+export { browserPlugin, collectSignals };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAcO,SAAS,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAW;AACxE,EAAA,MAAM,EAAE,SAAA,GAAY,UAAA,EAAW,GAAI,OAAA;AAEnC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,uBAAA;AAAA,IACN,QAAQ,SAAA,EAAW;AACZ,IAEP;AAAA,GACF;AACF;AAKO,SAAS,eACd,QAAA,EACkC;AAClC,EAAA,OAAO,SACJ,MAAA,CAAO,cAAA,EAAgB,SAAS,CAAA,CAChC,MAAA,CAAO,iBAAiB,MAAM,CAAA;AACnC","file":"index.js","sourcesContent":["import type { Plugin } from 'guardian-risk';\n\n/** Options for the browser plugin (stub). */\nexport interface BrowserPluginOptions {\n  /** DOM element to attach behavioral collectors. Defaults to document. */\n  readonly container?: string;\n}\n\n/**\n * Browser plugin for guardian-risk.\n *\n * @stub Future versions will collect mouse, keyboard, and fingerprint signals\n * in the page and add them to Guardian before analysis.\n */\nexport function browserPlugin(options: BrowserPluginOptions = {}): Plugin {\n  const { container = 'document' } = options;\n\n  return {\n    name: 'guardian-risk-browser',\n    install(_guardian) {\n      void container;\n      // Stub: collectors will attach listeners and call guardian.signal()\n    },\n  };\n}\n\n/**\n * @stub Future helper to start client-side signal collection.\n */\nexport function collectSignals(\n  guardian: import('guardian-risk').Guardian,\n): import('guardian-risk').Guardian {\n  return guardian\n    .signal('signalSource', 'browser')\n    .signal('browserPlugin', 'stub');\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "guardian-risk-browser",
+  "version": "0.1.0",
+  "description": "Browser plugin for guardian-risk — collects behavioral and fingerprint signals",
+  "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"
+  ],
+  "keywords": [
+    "guardian-risk",
+    "guardian-risk-browser",
+    "browser",
+    "fingerprint",
+    "bot-detection",
+    "risk"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/himanshu6306singh/guardian-risk.git",
+    "directory": "packages/browser"
+  },
+  "homepage": "https://github.com/himanshu6306singh/guardian-risk/tree/main/packages/browser#readme",
+  "bugs": {
+    "url": "https://github.com/himanshu6306singh/guardian-risk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "guardian-risk": "^0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "guardian-risk": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}