@absolutejs/vulnerabilities-postgres 0.2.0 → 0.4.0

package/README.md

@@ -14,11 +14,11 @@ const osvSnapshots = persistence.snapshots();
 ```
 
 The package stores complete provider snapshots and records, appendable sync
-history, tenant-scoped managed findings and correlation observations, and
-expiring distributed refresh leases. Snapshot replacement is one Postgres
-statement, so readers never see a half-replaced record set. Schema creation is
-lazy and idempotent, or can be disabled when application migrations own the
-tables.
+history, tenant-scoped managed findings, correlation observations, VEX decisions
+and applications, risk assessments, and expiring distributed refresh leases. Snapshot replacement is
+one Postgres statement, so readers never see a half-replaced record set. Schema
+creation is lazy and idempotent, or can be disabled when application migrations
+own the tables.
 
 The SQL surface is compatible with postgres.js and Neon-style tagged-template
 clients. Table prefixes are strictly validated before identifiers are included

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type FeedSnapshotStore, type FeedSyncRunStore, type ManagedFindingStore, type VulnerabilityObservationStore } from "@absolutejs/vulnerabilities";
+import { type FeedSnapshotStore, type FeedSyncRunStore, type ManagedFindingStore, type VulnerabilityObservationStore, type VulnerabilityRiskAssessmentStore, type VexDecisionStore, type VexFindingApplicationStore } from "@absolutejs/vulnerabilities";
 export type PostgresTag = {
     (strings: TemplateStringsArray, ...values: never[]): PromiseLike<unknown[]>;
     unsafe: (sql: string, ...args: never[]) => PromiseLike<unknown[]>;
@@ -18,8 +18,11 @@ export type PostgresVulnerabilityStore = {
     findings: ManagedFindingStore;
     leases: FeedLeaseStore;
     observations: VulnerabilityObservationStore;
+    riskAssessments: VulnerabilityRiskAssessmentStore;
     snapshots: <T>() => FeedSnapshotStore<T>;
     syncRuns: FeedSyncRunStore;
+    vexApplications: VexFindingApplicationStore;
+    vexDecisions: VexDecisionStore;
 };
 export type CreatePostgresVulnerabilityStoreOptions = {
     ensureSchema?: boolean;

package/dist/index.js

@@ -2,7 +2,10 @@
 // src/index.ts
 import {
   ManagedVulnerabilityFindingSchema,
-  VulnerabilityObservationSchema
+  VulnerabilityObservationSchema,
+  VulnerabilityRiskAssessmentSchema,
+  VexDecisionSchema,
+  VexFindingApplicationSchema
 } from "@absolutejs/vulnerabilities";
 import { Value } from "@sinclair/typebox/value";
 var IDENTIFIER = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
@@ -58,9 +61,12 @@ var prefixTables = (prefix) => ({
   findings: `${prefix}_findings`,
   leases: `${prefix}_feed_leases`,
   observations: `${prefix}_observations`,
+  riskAssessments: `${prefix}_risk_assessments`,
   records: `${prefix}_feed_records`,
   runs: `${prefix}_feed_sync_runs`,
-  snapshots: `${prefix}_feed_snapshots`
+  snapshots: `${prefix}_feed_snapshots`,
+  vexApplications: `${prefix}_vex_applications`,
+  vexDecisions: `${prefix}_vex_decisions`
 });
 var vulnerabilityPostgresSchemaSql = (tablePrefix = "vulnerability") => {
   if (!IDENTIFIER.test(tablePrefix))
@@ -132,6 +138,49 @@ var vulnerabilityPostgresSchemaSql = (tablePrefix = "vulnerability") => {
       ON ${table.observations} (tenant_id, asset_id, observed_at DESC);
     CREATE INDEX IF NOT EXISTS ${table.observations}_tenant_component_idx
       ON ${table.observations} (tenant_id, component_id, observed_at DESC);
+    CREATE TABLE IF NOT EXISTS ${table.riskAssessments} (
+      tenant_id text NOT NULL,
+      finding_id text NOT NULL,
+      priority text NOT NULL,
+      assessed_at timestamptz NOT NULL,
+      remediate_by timestamptz,
+      value jsonb NOT NULL,
+      updated_at timestamptz NOT NULL DEFAULT now(),
+      PRIMARY KEY (tenant_id, finding_id)
+    );
+    CREATE INDEX IF NOT EXISTS ${table.riskAssessments}_tenant_priority_idx
+      ON ${table.riskAssessments} (tenant_id, priority, assessed_at DESC);
+    CREATE INDEX IF NOT EXISTS ${table.riskAssessments}_tenant_due_idx
+      ON ${table.riskAssessments} (tenant_id, remediate_by)
+      WHERE remediate_by IS NOT NULL;
+    CREATE TABLE IF NOT EXISTS ${table.vexDecisions} (
+      tenant_id text NOT NULL,
+      decision_id text NOT NULL,
+      product_id text NOT NULL,
+      vulnerability_id text NOT NULL,
+      status text NOT NULL,
+      created_at timestamptz NOT NULL,
+      expires_at timestamptz,
+      value jsonb NOT NULL,
+      updated_at timestamptz NOT NULL DEFAULT now(),
+      PRIMARY KEY (tenant_id, decision_id)
+    );
+    CREATE INDEX IF NOT EXISTS ${table.vexDecisions}_tenant_product_idx
+      ON ${table.vexDecisions} (tenant_id, product_id, created_at DESC);
+    CREATE INDEX IF NOT EXISTS ${table.vexDecisions}_tenant_vulnerability_idx
+      ON ${table.vexDecisions} (tenant_id, vulnerability_id, created_at DESC);
+    CREATE TABLE IF NOT EXISTS ${table.vexApplications} (
+      tenant_id text NOT NULL,
+      finding_id text NOT NULL,
+      decision_id text NOT NULL,
+      applied_at timestamptz NOT NULL,
+      ended_at timestamptz,
+      value jsonb NOT NULL,
+      updated_at timestamptz NOT NULL DEFAULT now(),
+      PRIMARY KEY (tenant_id, finding_id)
+    );
+    CREATE INDEX IF NOT EXISTS ${table.vexApplications}_tenant_decision_idx
+      ON ${table.vexApplications} (tenant_id, decision_id, applied_at DESC);
     CREATE TABLE IF NOT EXISTS ${table.leases} (
       feed_id text PRIMARY KEY,
       owner_id text NOT NULL,
@@ -465,6 +514,209 @@ var createPostgresVulnerabilityStore = (options) => {
     save: async (tenantId, observation) => saveObservations(tenantId, [observation]),
     saveMany: saveObservations
   };
+  const parseRiskAssessment = (value) => {
+    const assessment = json(value, "Vulnerability risk assessment");
+    if (!Value.Check(VulnerabilityRiskAssessmentSchema, assessment))
+      throw new Error("Stored vulnerability risk assessment is invalid");
+    return assessment;
+  };
+  const saveRiskAssessments = async (tenantId, assessments) => {
+    await ensureSchema();
+    const normalizedTenantId = requiredText(tenantId, "Tenant id");
+    if (assessments.length === 0)
+      return;
+    for (const assessment of assessments) {
+      const findingId = assessment.findingId;
+      if (!Value.Check(VulnerabilityRiskAssessmentSchema, assessment))
+        throw new Error(`Vulnerability risk assessment ${findingId} is invalid`);
+    }
+    const payload = JSON.stringify(assessments.map((assessment) => ({
+      assessed_at: assessment.assessedAt,
+      finding_id: assessment.findingId,
+      priority: assessment.priority,
+      remediate_by: assessment.remediateBy,
+      value: assessment
+    })));
+    await sql`
+      INSERT INTO ${sql.unsafe(table.riskAssessments)} (
+        tenant_id, finding_id, priority, assessed_at, remediate_by, value,
+        updated_at
+      )
+      SELECT
+        ${normalizedTenantId}, item.finding_id, item.priority,
+        item.assessed_at::timestamptz, item.remediate_by::timestamptz,
+        item.value, now()
+      FROM jsonb_to_recordset(${payload}::jsonb) AS item(
+        finding_id text, priority text, assessed_at text, remediate_by text,
+        value jsonb
+      )
+      ON CONFLICT (tenant_id, finding_id) DO UPDATE SET
+        priority = EXCLUDED.priority,
+        assessed_at = EXCLUDED.assessed_at,
+        remediate_by = EXCLUDED.remediate_by,
+        value = EXCLUDED.value,
+        updated_at = now()
+    `;
+  };
+  const riskAssessments = {
+    get: async (tenantId, findingId) => {
+      await ensureSchema();
+      const rows = await sql`
+        SELECT value FROM ${sql.unsafe(table.riskAssessments)}
+        WHERE tenant_id = ${requiredText(tenantId, "Tenant id")}
+          AND finding_id = ${requiredText(findingId, "Finding id")}
+      `;
+      return rows[0] ? parseRiskAssessment(rows[0].value) : null;
+    },
+    list: async (filter) => {
+      await ensureSchema();
+      const tenantId = requiredText(filter.tenantId, "Tenant id");
+      const priority = filter.priority ?? null;
+      const rows = await sql`
+        SELECT value FROM ${sql.unsafe(table.riskAssessments)}
+        WHERE tenant_id = ${tenantId}
+          AND (${priority}::text IS NULL OR priority = ${priority})
+        ORDER BY assessed_at DESC, finding_id
+        LIMIT ${limit(filter.limit)}
+      `;
+      return rows.map(({ value }) => parseRiskAssessment(value));
+    },
+    save: async (tenantId, assessment) => saveRiskAssessments(tenantId, [assessment]),
+    saveMany: saveRiskAssessments
+  };
+  const parseVexDecision = (value) => {
+    const decision = json(value, "VEX decision");
+    if (!Value.Check(VexDecisionSchema, decision))
+      throw new Error("Stored VEX decision is invalid");
+    return decision;
+  };
+  const saveVexDecisions = async (tenantId, decisions) => {
+    await ensureSchema();
+    const normalizedTenantId = requiredText(tenantId, "Tenant id");
+    if (decisions.length === 0)
+      return;
+    for (const decision of decisions) {
+      const decisionId = decision.id;
+      if (!Value.Check(VexDecisionSchema, decision))
+        throw new Error(`VEX decision ${decisionId} is invalid`);
+    }
+    const payload = JSON.stringify(decisions.map((decision) => ({
+      created_at: decision.createdAt,
+      decision_id: decision.id,
+      expires_at: decision.expiresAt,
+      product_id: decision.productId,
+      status: decision.status,
+      value: decision,
+      vulnerability_id: decision.vulnerabilityId
+    })));
+    await sql`
+      INSERT INTO ${sql.unsafe(table.vexDecisions)} (
+        tenant_id, decision_id, product_id, vulnerability_id, status,
+        created_at, expires_at, value, updated_at
+      )
+      SELECT
+        ${normalizedTenantId}, item.decision_id, item.product_id,
+        item.vulnerability_id, item.status, item.created_at::timestamptz,
+        item.expires_at::timestamptz, item.value, now()
+      FROM jsonb_to_recordset(${payload}::jsonb) AS item(
+        decision_id text, product_id text, vulnerability_id text, status text,
+        created_at text, expires_at text, value jsonb
+      )
+      ON CONFLICT (tenant_id, decision_id) DO UPDATE SET
+        product_id = EXCLUDED.product_id,
+        vulnerability_id = EXCLUDED.vulnerability_id,
+        status = EXCLUDED.status,
+        created_at = EXCLUDED.created_at,
+        expires_at = EXCLUDED.expires_at,
+        value = EXCLUDED.value,
+        updated_at = now()
+    `;
+  };
+  const vexDecisions = {
+    get: async (tenantId, decisionId) => {
+      await ensureSchema();
+      const rows = await sql`
+        SELECT value FROM ${sql.unsafe(table.vexDecisions)}
+        WHERE tenant_id = ${requiredText(tenantId, "Tenant id")}
+          AND decision_id = ${requiredText(decisionId, "Decision id")}
+      `;
+      return rows[0] ? parseVexDecision(rows[0].value) : null;
+    },
+    list: async (filter) => {
+      await ensureSchema();
+      const tenantId = requiredText(filter.tenantId, "Tenant id");
+      const productId = filter.productId?.trim() || null;
+      const vulnerabilityId = filter.vulnerabilityId?.trim() || null;
+      const rows = await sql`
+        SELECT value FROM ${sql.unsafe(table.vexDecisions)}
+        WHERE tenant_id = ${tenantId}
+          AND (${productId}::text IS NULL OR product_id = ${productId})
+          AND (${vulnerabilityId}::text IS NULL OR vulnerability_id = ${vulnerabilityId})
+        ORDER BY created_at DESC, decision_id
+        LIMIT ${limit(filter.limit)}
+      `;
+      return rows.map(({ value }) => parseVexDecision(value));
+    },
+    save: async (tenantId, decision) => saveVexDecisions(tenantId, [decision]),
+    saveMany: saveVexDecisions
+  };
+  const parseVexApplication = (value) => {
+    const application = json(value, "VEX application");
+    if (!Value.Check(VexFindingApplicationSchema, application))
+      throw new Error("Stored VEX application is invalid");
+    return application;
+  };
+  const saveVexApplications = async (applications) => {
+    await ensureSchema();
+    if (applications.length === 0)
+      return;
+    for (const application of applications) {
+      const findingId = application.findingId;
+      if (!Value.Check(VexFindingApplicationSchema, application))
+        throw new Error(`VEX application ${findingId} is invalid`);
+    }
+    const payload = JSON.stringify(applications.map((application) => ({
+      applied_at: application.appliedAt,
+      decision_id: application.decisionId,
+      ended_at: application.endedAt,
+      finding_id: application.findingId,
+      tenant_id: application.tenantId,
+      value: application
+    })));
+    await sql`
+      INSERT INTO ${sql.unsafe(table.vexApplications)} (
+        tenant_id, finding_id, decision_id, applied_at, ended_at, value,
+        updated_at
+      )
+      SELECT
+        item.tenant_id, item.finding_id, item.decision_id,
+        item.applied_at::timestamptz, item.ended_at::timestamptz,
+        item.value, now()
+      FROM jsonb_to_recordset(${payload}::jsonb) AS item(
+        tenant_id text, finding_id text, decision_id text, applied_at text,
+        ended_at text, value jsonb
+      )
+      ON CONFLICT (tenant_id, finding_id) DO UPDATE SET
+        decision_id = EXCLUDED.decision_id,
+        applied_at = EXCLUDED.applied_at,
+        ended_at = EXCLUDED.ended_at,
+        value = EXCLUDED.value,
+        updated_at = now()
+    `;
+  };
+  const vexApplications = {
+    get: async (tenantId, findingId) => {
+      await ensureSchema();
+      const rows = await sql`
+        SELECT value FROM ${sql.unsafe(table.vexApplications)}
+        WHERE tenant_id = ${requiredText(tenantId, "Tenant id")}
+          AND finding_id = ${requiredText(findingId, "Finding id")}
+      `;
+      return rows[0] ? parseVexApplication(rows[0].value) : null;
+    },
+    save: async (application) => saveVexApplications([application]),
+    saveMany: saveVexApplications
+  };
   const leases = {
     acquire: async (request) => {
       await ensureSchema();
@@ -507,8 +759,11 @@ var createPostgresVulnerabilityStore = (options) => {
     findings,
     leases,
     observations,
+    riskAssessments,
     snapshots,
-    syncRuns
+    syncRuns,
+    vexApplications,
+    vexDecisions
   };
 };
 export {

package/dist/manifest.js

@@ -9,7 +9,7 @@ var manifest = defineManifest()({
     intents: [
       "persist vulnerability intelligence",
       "retain vulnerability sync history",
-      "store managed vulnerability findings and observations"
+      "store managed vulnerability findings, observations, VEX decisions, and risk assessments"
     ],
     keywords: ["vulnerabilities", "Postgres", "CVE", "feed-history"],
     protocols: ["PostgreSQL", "AbsoluteJS vulnerability contracts"]
@@ -17,7 +17,7 @@ var manifest = defineManifest()({
   identity: {
     accent: "#336791",
     category: "operations",
-    description: "Durable Postgres snapshots, records, sync history, managed findings, observations, and distributed refresh leases.",
+    description: "Durable Postgres snapshots, sync history, findings, observations, VEX decisions, risk assessments, and distributed refresh leases.",
     docsUrl: "https://github.com/absolutejs/vulnerabilities-postgres",
     name: "@absolutejs/vulnerabilities-postgres",
     tagline: "Keep vulnerability intelligence durable and auditable."
@@ -30,7 +30,7 @@ var manifest = defineManifest()({
       requires: {
         env: [
           {
-            description: "Postgres connection string for vulnerability intelligence, findings, and observations",
+            description: "Postgres connection string for vulnerability intelligence, findings, observations, VEX decisions, and risk assessments",
             example: "postgres://user:pass@host/db",
             key: "DATABASE_URL",
             secret: true
@@ -45,7 +45,7 @@ var manifest = defineManifest()({
         ],
         services: [
           {
-            description: "Stores vulnerability intelligence, history, findings, observations, and leases",
+            description: "Stores vulnerability intelligence, findings, observations, VEX decisions, risk assessments, and leases",
             id: "postgres"
           }
         ]

package/dist/manifest.json

@@ -8,7 +8,7 @@
 		"intents": [
 			"persist vulnerability intelligence",
 			"retain vulnerability sync history",
-			"store managed vulnerability findings and observations"
+			"store managed vulnerability findings, observations, VEX decisions, and risk assessments"
 		],
 		"keywords": [
 			"vulnerabilities",
@@ -24,7 +24,7 @@
 	"identity": {
 		"accent": "#336791",
 		"category": "operations",
-		"description": "Durable Postgres snapshots, records, sync history, managed findings, observations, and distributed refresh leases.",
+		"description": "Durable Postgres snapshots, sync history, findings, observations, VEX decisions, risk assessments, and distributed refresh leases.",
 		"docsUrl": "https://github.com/absolutejs/vulnerabilities-postgres",
 		"name": "@absolutejs/vulnerabilities-postgres",
 		"tagline": "Keep vulnerability intelligence durable and auditable."
@@ -37,7 +37,7 @@
 			"requires": {
 				"env": [
 					{
-						"description": "Postgres connection string for vulnerability intelligence, findings, and observations",
+						"description": "Postgres connection string for vulnerability intelligence, findings, observations, VEX decisions, and risk assessments",
 						"example": "postgres://user:pass@host/db",
 						"key": "DATABASE_URL",
 						"secret": true
@@ -52,7 +52,7 @@
 				],
 				"services": [
 					{
-						"description": "Stores vulnerability intelligence, history, findings, observations, and leases",
+						"description": "Stores vulnerability intelligence, findings, observations, VEX decisions, risk assessments, and leases",
 						"id": "postgres"
 					}
 				]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@absolutejs/vulnerabilities-postgres",
-  "version": "0.2.0",
-  "description": "Durable Postgres feed snapshots, sync history, findings, observations, and refresh leases for AbsoluteJS vulnerability management.",
+  "version": "0.4.0",
+  "description": "Durable Postgres feeds, findings, observations, VEX decisions, risk assessments, and refresh leases for AbsoluteJS vulnerability management.",
   "type": "module",
   "license": "BSL-1.1",
   "author": "Alex Kahn",
@@ -53,7 +53,7 @@
   ],
   "dependencies": {
     "@absolutejs/manifest": "0.3.0",
-    "@absolutejs/vulnerabilities": "0.6.1",
+    "@absolutejs/vulnerabilities": "0.7.1",
     "@sinclair/typebox": "0.34.52"
   },
   "peerDependencies": {