@cyvest/cyvest-js 4.4.0 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/README.md +5 -4
  2. package/dist/{index.mjs → index.cjs} +368 -318
  3. package/dist/{index.d.mts → index.d.cts} +255 -121
  4. package/dist/index.d.ts +255 -121
  5. package/dist/index.js +225 -453
  6. package/package.json +15 -2
  7. package/src/finders.ts +101 -186
  8. package/src/getters.ts +176 -104
  9. package/src/graph.ts +4 -4
  10. package/src/keys.ts +84 -30
  11. package/src/levels.ts +7 -7
  12. package/src/types.generated.ts +25 -24
  13. package/tests/getters-finders.test.ts +225 -126
  14. package/tests/graph.test.ts +6 -7
  15. package/tests/keys-levels.test.ts +14 -15
package/README.md CHANGED
@@ -5,7 +5,8 @@ TypeScript utilities and generated types for working with serialized Cyvest inve
5
5
  ## What it does
6
6
 
7
7
  - Validates Cyvest JSON payloads against the schema (AJV) and returns typed investigations.
8
- - Ships generated TypeScript types plus helpers to query observables, checks, threat intel, and relationships.
8
+ - Ships generated TypeScript types plus helpers to query observables, checks, threat intel, tags, and relationships.
9
+ - Provides tag hierarchy utilities including aggregated score/level calculations.
9
10
  - Builds lightweight graph representations for use in visualizers or custom tooling.
10
11
 
11
12
  ## Install & build
@@ -32,17 +33,17 @@ pnpm --filter @cyvest/cyvest-js test
32
33
  ```ts
33
34
  import {
34
35
  parseCyvest,
35
- findRootObservables,
36
+ findSourceObservables,
36
37
  getObservableGraph,
37
38
  type CyvestInvestigation,
38
39
  } from "@cyvest/cyvest-js";
39
40
  import raw from "./investigation.json";
40
41
 
41
42
  const investigation: CyvestInvestigation = parseCyvest(raw);
42
- const roots = findRootObservables(investigation);
43
+ const sources = findSourceObservables(investigation);
43
44
  const graph = getObservableGraph(investigation);
44
45
 
45
- console.log(`Roots: ${roots.length} • Nodes: ${graph.nodes.length}`);
46
+ console.log(`Sources: ${sources.length} • Nodes: ${graph.nodes.length}`);
46
47
  ```
47
48
 
48
49
  ## Publishing / consumers