@ianmenethil/zp-devicefp 0.1.0 → 0.2.0

package/docs/testing.md

@@ -1,32 +1,54 @@
-# Testing
-
-The project uses Node 24's built-in TypeScript execution and test runner.
-
-## Coverage intent
-
-The included tests focus on:
-
-- deterministic canonicalization
-- stable hashing
-- anomaly scoring
-- storage and WebRTC collector behavior
-- audio and media-device collector behavior
-- client sync collection
-- parallel async collection
-- abort and timeout paths
-- warning isolation between runs
-- upload plumbing
-- built-artifact smoke loading
-
-## Run locally
-
-```bash
-node --test ./tests/**/*.test.ts
-node ./scripts/build.mjs
-```
-
-## Suggested next expansion
-
-- Add browser-matrix tests in Playwright for Chromium, Firefox, and WebKit.
-- Add snapshot tests for collector outputs in privacy-hardened environments.
-- Add server-side reconciliation tests once an API consumer is introduced.
+# Testing
+
+The project uses **bun test** (`bun test --coverage`) as its test runner. Tests are written in TypeScript with bun's built-in test module.
+
+## Current coverage
+
+92 tests across 24 files, 94.9% line coverage, 82.3% function coverage.
+
+```
+All files  |  82.26% funcs  |  94.92% lines
+```
+
+## Coverage intent
+
+The included tests focus on:
+
+- deterministic canonicalization
+- stable hashing
+- anomaly scoring
+- storage and WebRTC collector behavior
+- audio and media-device collector behavior
+- client sync collection
+- parallel async collection
+- abort and timeout paths
+- warning isolation between runs
+- built-artifact smoke loading
+
+## Test layout
+
+```
+tests/
+├── unit/                 # Unit tests (antiSpoof, canonicalize, hash, events, browser)
+├── integration/          # Client orchestration tests (collect, collectSync, events)
+└── signals/              # Collector tests (21 signal test files)
+```
+
+## Run locally
+
+```bash
+# Run tests
+bun test
+
+# Run tests with coverage
+bun test --coverage
+
+# Run the full build pipeline (lint → typecheck → knip → jscpd → tests → esbuild → CDN)
+bun run build
+```
+
+## Suggested next expansion
+
+- Add browser-matrix tests in Playwright for Chromium, Firefox, and WebKit.
+- Add snapshot tests for collector outputs in privacy-hardened environments.
+- Add server-side reconciliation tests once an API consumer is introduced.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ianmenethil/zp-devicefp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Async-first browser and device fingerprinting library with explainable signals and anomaly scoring.",
   "type": "module",
   "main": "./dist/npm/index.cjs",
@@ -26,12 +26,12 @@
     "bun": ">=1.3.0",
     "node": ">=22"
   },
-  "prepublishOnly": "bun run build",
   "scripts": {
+    "prepublishOnly": "bun run build",
     "build": "bun run check && bun run test:coverage && bun -e \"await import('./.scripts/build.ts')\"",
     "test": "bun test",
     "test:coverage": "bun test --coverage",
-    "release": "sh -c 'V=$(npm version \"${1:-minor}\" -m \"chore: release %s\" | tail -1 | sed s/v//) && bun publish --access public && rm -rf \"F:/_ZP-Main/apps/CDN-server/public/devicefp\" && mkdir -p \"F:/_ZP-Main/apps/CDN-server/public/devicefp/$V\" && cp -r dist/cdn/* \"F:/_ZP-Main/apps/CDN-server/public/devicefp/$V/\" && mkdir -p \"F:/_ZP-Main/apps/CDN-server/public/devicefp/latest\" && cp -r dist/cdn/* \"F:/_ZP-Main/apps/CDN-server/public/devicefp/latest/\" && git push --follow-tags' --",
+    "release": "sh -c 'npm version \"${1:-minor}\" -m \"chore: release %s\" && bun publish --access public && rm -rf \"F:/_ZP-Main/apps/CDN-server/public/devicefp\" && mkdir -p \"F:/_ZP-Main/apps/CDN-server/public/devicefp\" && cp -r dist/cdn/* \"F:/_ZP-Main/apps/CDN-server/public/devicefp/\" && git push --follow-tags' --",
     "release:minor": "bun run release minor",
     "release:patch": "bun run release patch",
     "release:major": "bun run release major",