Skip to main content
← back to extensions

Network

@webframp/networkv2026.09.15.1· 1d agoMODELS
01README

DNS and network probing model that generates diverse diagnostic events.

Tools Required

  • dig (DNS lookups)
  • whois (domain registration info)
  • traceroute (network path tracing)
  • openssl (TLS certificate inspection)

Usage

# Create the network probe model
swamp model create @webframp/network net-probe

# DNS lookup
swamp model method run net-probe dns_lookup --input domain=example.com
swamp model method run net-probe dns_lookup --input domain=example.com --input recordType=MX

# HTTP check
swamp model method run net-probe http_check --input url=https://example.com

# WHOIS lookup
swamp model method run net-probe whois_lookup --input domain=example.com

# TLS certificate check
swamp model method run net-probe cert_check --input host=example.com

# Traceroute
swamp model method run net-probe traceroute --input host=example.com

# Port scan
swamp model method run net-probe port_check --input host=example.com --input ports=[80,443,8080]

Methods

  • dns_lookup - Run dig to resolve DNS records for a domain
  • http_check - Fetch a URL and record status, headers, timing, and redirects
  • whois_lookup - Query WHOIS for domain registration details
  • cert_check - Inspect TLS certificate subject, issuer, and validity dates
  • traceroute - Trace network path to a host
  • port_check - Test TCP connectivity on specific ports
02Release Notes

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

03Models1
@webframp/networkv2026.09.15.1network/probe.ts
fn dns_lookup(domain: string)
Run dig to resolve DNS records for a domain
ArgumentTypeDescription
domainstringDomain name to look up
fn http_check(url: string)
Fetch a URL and record status code, headers, timing, and redirect chain
ArgumentTypeDescription
urlstringURL to check
fn whois_lookup(domain: string)
Query WHOIS for domain registration details
ArgumentTypeDescription
domainstringDomain name to look up
fn cert_check(host: string, port: number)
Inspect TLS certificate subject, issuer, and validity dates
ArgumentTypeDescription
hoststringHostname to check
portnumberTLS port to connect to
fn traceroute(host: string)
Trace network path to a host
ArgumentTypeDescription
hoststringTarget host to trace
fn port_check(host: string)
Test TCP connectivity on specific ports
ArgumentTypeDescription
hoststringTarget host to scan
fn describe_endpoint(host: string, port: number)
Aggregate DNS, HTTP, and TLS certificate checks for a single host into one health summary
ArgumentTypeDescription
hoststringHostname to describe (e.g. example.com)
portnumberHTTPS/TLS port to check (default 443)

Resources

dns_records(15m)— DNS lookup results for a domain
http_checks(10m)— HTTP endpoint check results
whois_info(24h)— WHOIS registration data for a domain
cert_info(1h)— TLS certificate details for a host
traceroute(30m)— Network path trace to a host
port_scan(10m)— TCP port connectivity results
endpoint_summary(10m)— Aggregated endpoint health: DNS + HTTP + TLS certificate
04Previous Versions19
2026.08.28.1

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.2

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.25.1

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.5

2026.08.24.5

Added: describe_endpoint method — aggregated health check that runs DNS resolution, HTTP reachability, and TLS certificate inspection for a single host in one call. Returns a unified endpoint_summary resource with per-check results and an overall healthy boolean.

Added: endpoint_summary resource spec storing the aggregated check output.

Modified 1 models

2026.08.24.4

2026.08.24.4

Added: Output metadata attributes for observability.

  • durationMs: Method execution duration in milliseconds.
  • collectedBy: Extension name that produced the data.
  • fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.24.3

2026.08.24.3

Fixed: Added missing description field to the 2026.08.24.2 upgrade entry. The swamp binary's model loader requires description: string on every upgrade entry; the prior publish omitted it, causing a Zod validation error at load time.

2026.08.24.2

2026.08.24.2

Added Troubleshooting section documenting error-resource-not-exception pattern, http_check catch-all, per-port independence, dig JSON fallback, command timeouts, and zero global args.

2026.08.21.1

2026.08.21.1

Added:

  • dns_records, whois_info, and traceroute resources now include an error field (nullable, null on success). When dig, whois, or traceroute exits non-zero, this field carries the command's stderr so a failed lookup is distinguishable from a domain/host with genuinely no data, instead of silently returning empty records.

Changed:

  • dns_lookup, http_check, whois_lookup, cert_check, traceroute, and port_check now reject an empty domain/url/host argument with a clear validation error before invoking the underlying command, instead of running dig/whois/openssl/traceroute against an empty target and surfacing whatever cryptic error the tool produces.
  • port_check's ports argument now requires at least one port and rejects port numbers outside 1-65535, instead of silently scanning zero ports or passing an invalid port straight to Deno.connect.
  • If the underlying command binary itself is missing or fails to spawn (dig, whois, traceroute, openssl via bash), the error now names the command and target instead of surfacing an unqualified low-level "No such file or directory" exception.

Upgrade note: No global-arg or method-signature changes. Existing stored dns_records, whois_info, and traceroute resources remain valid — the new error field is nullable and defaults to null on read.

2026.07.18.1

2026.07.18.1

Added: An upgrades array entry (no-op) to probe.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.

2026.07.16.1

Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.

2026.07.16.1

2026.07.16.1

Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.

2026.06.21.1
2026.06.15.1
2026.05.21.1
2026.05.14.1
2026.05.06.1

updated labels

2026.04.22.1
2026.04.14.1
2026.04.13.1
2026.04.12.1
05Stats
A
100 / 100
Downloads
7,304
Archive size
25.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
06Platforms
07Labels
#certificate#diagnostics#dns#http#network#networking#observability#ops#port-scan#probe#security#tls#traceroute#whois