Files
network-tools/README.md
T
zemion 429b55d587
Verify / verify (push) Canceled after 0s
Release Network Tools 0.2.0
2026-09-02 11:38:57 +02:00

37 lines
1.7 KiB
Markdown

# Network Tools
Calculate and construct network values locally in the browser.
Network Tools is a standalone local-first application in the [add·ideas Toolbox](https://git.add-ideas.de/lotobo/toolbox-portal). Inputs are processed in the browser and are not uploaded.
## Current scope
- IPv4 and IPv6 parsing, canonicalisation, prefix ranges and IPv4 broadcast calculation
- Largest-first IPv4 VLSM planning with conventional network/broadcast reservations, alignment and atomic fit failures
- URL resolution, component/query inspection and password-redacted display without requesting the URL
- Bounded A, AAAA, CNAME, MX, SRV, CAA and TXT zone-record construction
- Inert, bounded zone-file parsing with `$ORIGIN`, `$TTL`, inherited owners, multiline records, common RDATA validation and explicit syntax-only coverage for unknown types; `$INCLUDE` is never followed
- Bounded response-header security analysis covering CSP, HSTS, cookies, CORS, framing, content sniffing, referrer and cross-origin policies
- CSP parsing/diagnostics and explicit conservative CSP construction
- A compact offline extension/MIME reference
The application treats pasted values as untrusted, applies explicit length and numeric limits, and makes no DNS, URL or HTTP request. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [docs/PRIVACY-SECURITY.md](docs/PRIVACY-SECURITY.md).
## Development
Requires Node.js 22 and npm 11.
```sh
npm ci
npm run check
npm run test:browser
```
## Release
`npm run release:artifact` creates a deterministic `release/network-tools-0.2.0.zip` and checksum sidecar.
## Licence
GPL-3.0-or-later. Runtime dependencies retain their own licences; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).