@hailbytes/vulnerability-calculator 1.0.0

package/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Type declarations for @hailbytes/vulnerability-calculator.
+ */
+
+export interface VulnInputs {
+  target_hosts: number;
+  scan_intensity: 'light' | 'medium' | 'aggressive' | 'continuous' | string;
+  scan_frequency: 'daily' | 'weekly' | 'monthly' | 'quarterly' | string;
+  time_pressure?: 'light' | 'medium' | 'aggressive' | 'continuous' | string;
+  scanning_tools: string[];
+  compliance_needs?: string[];
+  [extra: string]: unknown;
+}
+
+export interface VMResources {
+  cpu: number;
+  ram: number;
+  storage: number;
+  [extra: string]: unknown;
+}
+
+export interface VulnResult {
+  vm_resources: VMResources;
+  timing: Record<string, unknown>;
+  costs: Record<string, unknown>;
+  recommendations: string[];
+  has_asm: boolean;
+  inputs: VulnInputs;
+  timestamp: string;
+}
+
+/**
+ * Pure infrastructure-sizing calculation — no DOM required.
+ */
+export function calculate(inputs: VulnInputs): VulnResult;
+
+/**
+ * The custom-element class. Importing this module also registers
+ * the `<hailbytes-vuln-calculator>` tag via `customElements.define`.
+ *
+ * Supported attributes:
+ *   - `theme="dark"|"light"`  (default: `"dark"`)
+ *   - `branding="off"`        hides the "by HailBytes" footer + header badge
+ */
+export default class HailbytesVulnCalculator extends HTMLElement {
+  static readonly observedAttributes: readonly string[];
+}
+
+export { HailbytesVulnCalculator };
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'hailbytes-vuln-calculator': HailbytesVulnCalculator;
+  }
+  interface HTMLElementEventMap {
+    'vuln-calculated': CustomEvent<VulnResult>;
+  }
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@hailbytes/vulnerability-calculator",
+  "version": "1.0.0",
+  "description": "Zero-dependency web component for sizing vulnerability scanning infrastructure. Estimates VM sizing, cloud costs, and timing across AWS/Azure.",
+  "type": "module",
+  "main": "./hailbytes-vuln-calculator.js",
+  "module": "./hailbytes-vuln-calculator.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./hailbytes-vuln-calculator.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./index.d.ts",
+  "files": [
+    "hailbytes-vuln-calculator.js",
+    "index.d.ts",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./hailbytes-vuln-calculator.js"
+  ],
+  "scripts": {
+    "test": "node --test test/smoke.test.mjs"
+  },
+  "keywords": [
+    "vulnerability",
+    "vulnerability-scanner",
+    "vulnerability-calculator",
+    "attack-surface-management",
+    "infrastructure-calculator",
+    "cybersecurity",
+    "risk-calculator",
+    "web-component",
+    "custom-element",
+    "es-module",
+    "zero-dependency",
+    "hailbytes",
+    "vanilla-js"
+  ],
+  "author": "HailBytes, LLC (https://hailbytes.com)",
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HailBytes/vulnerability-calculator.git"
+  },
+  "bugs": {
+    "url": "https://github.com/HailBytes/vulnerability-calculator/issues"
+  },
+  "homepage": "https://hailbytes.com/asm",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}