@saber-usa/node-common

Node Common

Common nodejs functions used across a number of saber's applications.

Bulk WASM propagation

node-common is the single conduit for all satellite.js propagation in the Saber stack. As of v7, every primitive (prop, propGeodetic, the manual LookAngles chain) and every high-value high-level helper (getLeoRpoData, getGeoRpoData, getLeoWaterfallData, getGeoShadowZones) ships an async, WASM-backed *Bulk sibling (propBulk, propGeodeticBulk, propLookAnglesBulk, getLeoRpoDataBulk, getGeoRpoDataBulk, getLeoWaterfallDataBulk, getGeoShadowZonesBulk) that batches the work through satellite.js's BulkPropagator. The original sync functions are unchanged and still supported.

See docs/BULK_PROPAGATION.md for the full design rationale, lifecycle (lazy getBulkRuntime / eager initBulkRuntime / shutdown disposeBulkRuntime), per-thread pipeline registry, the measured break-even table (benchmarks/benchmarkBulkPropagator.js, npm run bench:wasmProp), the documented satellite.js@7.0.0 lat/lon swap that propGeodeticBulk un-swaps internally, and the meanElements semantic gap on the WASM path.

License

AGPLv3

Publishing changes

1. Increment the version in package.json
2. Check you are logged in to npm using npm whoami
3. You may need to login using npm login note your npm user must have 2FA enabled (in your profile)
4. Run npm install npm login then npm publish

Run SonarQube Scan

To run SonarQube locally:

docker run -d --name sonarqube -p 9000:9000 sonarqube:latest

Go to http://localhost:9000 (default credentials: admin / admin).

Create a local project (NPM) and generate a token.

Run a scan on this project:

sonar -Dsonar.host.url=http://localhost:9000 -Dsonar.token=<your_sonarqube_token> -Dsonar.projectKey=node-common

MCP setup options:

• Cursor: set token/url in .cursor/sonarqube.env (used by .cursor/mcp.json).
• Claude Code: set token/url in .mcp.json (or copy from .mcp.json.example).

Note: for Dockerized MCP, use http://host.docker.internal:9000 as SONARQUBE_URL.