@howdoi-cli/networking 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 howdoi-cli contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @howdoi-cli/networking
+
+**howdoi knowledge base — networking commands.**
+
+Part of the [howdoi](https://github.com/SiphoChris/howdoi-cli) ecosystem.
+
+## Install
+
+```bash
+npm install -g @howdoi-cli/networking
+```
+
+This also installs `@howdoi-cli/core` (the engine and `howdoi` binary) automatically.
+
+## Usage
+
+```bash
+howdoi <what you want to do>
+```
+
+## Install more knowledge bases
+
+```bash
+npm install -g @howdoi-cli/unix
+npm install -g @howdoi-cli/git
+npm install -g @howdoi-cli/ssh
+npm install -g @howdoi-cli/docker
+npm install -g @howdoi-cli/networking
+npm install -g @howdoi-cli/all
+```
+
+## License
+
+MIT

package/data/networking/curl.yaml

@@ -0,0 +1,57 @@
+tool: curl
+category: networking
+description: Transfer data to and from servers
+package: "@howdoi-cli/networking"
+intents:
+  - make http request
+  - send get request
+  - send post request
+  - send json data
+  - post json to api
+  - add headers to request
+  - download file with curl
+  - follow redirects
+  - send form data
+  - test api endpoint
+  - check http response code
+  - send delete request
+  - send put request
+  - authenticate with curl
+  - pass bearer token
+examples:
+  - intent: send get request
+    title: Simple GET request
+    command: curl https://api.example.com/users
+  - intent: send get request
+    title: GET request with pretty output
+    command: curl -s https://api.example.com/users | python3 -m json.tool
+  - intent: send post request
+    title: POST request with JSON body
+    command: curl -X POST https://api.example.com/users -H "Content-Type: application/json" -d '{"name":"Sipho"}'
+  - intent: post json to api
+    title: POST JSON from a file
+    command: curl -X POST https://api.example.com/users -H "Content-Type: application/json" -d @payload.json
+  - intent: add headers to request
+    title: Add custom headers to a request
+    command: curl -H "Authorization: Bearer TOKEN" -H "Accept: application/json" https://api.example.com
+  - intent: pass bearer token
+    title: Authenticate with a Bearer token
+    command: curl -H "Authorization: Bearer YOUR_TOKEN" https://api.example.com/protected
+  - intent: download file with curl
+    title: Download a file and save it
+    command: curl -o filename.zip https://example.com/file.zip
+  - intent: download file with curl
+    title: Download and keep the original filename
+    command: curl -O https://example.com/file.zip
+  - intent: check http response code
+    title: Show only the HTTP status code
+    command: curl -s -o /dev/null -w "%{http_code}" https://example.com
+  - intent: follow redirects
+    title: Follow HTTP redirects automatically
+    command: curl -L https://example.com
+  - intent: send delete request
+    title: Send a DELETE request
+    command: curl -X DELETE https://api.example.com/users/123
+  - intent: send put request
+    title: Send a PUT request with JSON
+    command: curl -X PUT https://api.example.com/users/123 -H "Content-Type: application/json" -d '{"name":"Updated"}'

package/data/networking/dig.yaml

@@ -0,0 +1,35 @@
+tool: dig
+category: networking
+description: DNS lookup and query tool
+package: "@howdoi-cli/networking"
+intents:
+  - lookup dns record
+  - check dns for domain
+  - find ip address of domain
+  - check mx record
+  - check nameservers
+  - lookup txt record
+  - reverse dns lookup
+  - query specific dns server
+examples:
+  - intent: find ip address of domain
+    title: Look up the A record for a domain
+    command: dig google.com
+  - intent: find ip address of domain
+    title: Short answer only
+    command: dig +short google.com
+  - intent: check mx record
+    title: Look up MX (mail) records
+    command: dig MX google.com
+  - intent: check nameservers
+    title: Look up NS records
+    command: dig NS google.com
+  - intent: lookup txt record
+    title: Look up TXT records (SPF, verification etc.)
+    command: dig TXT google.com
+  - intent: reverse dns lookup
+    title: Reverse DNS lookup from IP address
+    command: dig -x 8.8.8.8
+  - intent: query specific dns server
+    title: Query a specific DNS server
+    command: dig @8.8.8.8 google.com

package/data/networking/ping.yaml

@@ -0,0 +1,21 @@
+tool: ping
+category: networking
+description: Test network connectivity to a host
+package: "@howdoi-cli/networking"
+intents:
+  - test network connection
+  - check if host is reachable
+  - ping a server
+  - check network latency
+  - test internet connection
+examples:
+  - intent: ping a server
+    title: Ping a host
+    command: ping google.com
+  - intent: test network connection
+    title: Ping a limited number of times
+    command: ping -c 4 google.com
+  - intent: check network latency
+    title: Ping with timestamps
+    command: ping -D google.com
+    os: linux-only

package/data/networking/ss.yaml

@@ -0,0 +1,35 @@
+tool: ss
+category: networking
+description: Inspect network sockets and connections (modern netstat)
+package: "@howdoi-cli/networking"
+intents:
+  - check open ports
+  - see listening ports
+  - find what is using a port
+  - list network connections
+  - check port in use
+  - see active connections
+  - find process using port
+examples:
+  - intent: see listening ports
+    title: Show all listening ports
+    command: ss -tlnp
+  - intent: see listening ports
+    title: Show listening ports (netstat fallback)
+    command: netstat -tlnp
+    os: linux-only
+  - intent: check open ports
+    title: Show all open ports (TCP and UDP)
+    command: ss -tulnp
+  - intent: find what is using a port
+    title: Find what process is using port 3000
+    command: ss -tlnp | grep :3000
+  - intent: find process using port
+    title: Find process using a port with lsof
+    command: lsof -i :3000
+  - intent: list network connections
+    title: Show all established connections
+    command: ss -tnp state established
+  - intent: check port in use
+    title: Check if a specific port is open on a remote host
+    command: nc -zv hostname 3000

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@howdoi-cli/networking",
+  "version": "1.0.0",
+  "description": "Networking knowledge base for howdoi — curl, netstat, ping, dig, and more.",
+  "type": "module",
+  "files": [
+    "data",
+    "postinstall.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node postinstall.mjs",
+    "publish:npm": "npm publish"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "howdoi": {
+    "type": "knowledge-base",
+    "dataDir": "data"
+  },
+  "dependencies": {
+    "@howdoi-cli/core": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["cli", "networking", "curl", "terminal", "howdoi"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SiphoChris/howdoi-cli"
+  }
+}

package/postinstall.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { cpSync, mkdirSync, existsSync, readFileSync } from "fs";
+import { join, dirname, resolve } from "path";
+import { homedir } from "os";
+
+// process.argv[1] is always the path of the running script — reliable across
+// all package managers and working directories
+const scriptDir = dirname(resolve(process.argv[1]));
+const pkgJsonPath = join(scriptDir, "package.json");
+
+if (!existsSync(pkgJsonPath)) {
+  process.exit(0);
+}
+
+const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+const pkgName = pkgJson.name.replace("@howdoi-cli/", "");
+
+// Skip in monorepo dev context — check for workspace root two levels up
+const monoRootPkg = resolve(scriptDir, "..", "..", "package.json");
+if (existsSync(monoRootPkg)) {
+  try {
+    const root = JSON.parse(readFileSync(monoRootPkg, "utf-8"));
+    if (root.workspaces) {
+      console.log(`[howdoi] Dev mode — skipping XDG install for ${pkgJson.name}`);
+      process.exit(0);
+    }
+  } catch { /* continue */ }
+}
+
+const srcData = join(scriptDir, "data");
+if (!existsSync(srcData)) {
+  process.exit(0);
+}
+
+const xdgBase = process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share");
+const dest = join(xdgBase, "howdoi", pkgName);
+
+try {
+  mkdirSync(dest, { recursive: true });
+  cpSync(srcData, dest, { recursive: true });
+  console.log(`[howdoi] ✓ ${pkgJson.name}@${pkgJson.version} → ${dest}`);
+} catch (err) {
+  console.warn(`[howdoi] Warning: could not copy data: ${err.message}`);
+  console.warn(`[howdoi] howdoi will still work via node_modules fallback.`);
+}