@ksz54213/specbridge 0.1.0 → 0.2.0

package/README.md

@@ -23,13 +23,22 @@ npm install -g @ksz54213/specbridge
 ## Usage
 
 ```
-specbridge verify -f <path-to-feature> -u <base-url>
+specbridge verify -f <path-to-feature> -u <base-url> [-H "Key: Value"]
 ```
 
 | Option | Alias | Required | Description |
 |---|---|---|---|
 | `--file` | `-f` | ✅ | Path to the `.feature` contract file |
 | `--url` | `-u` | ✅ | Base URL of the service to test (e.g. `http://localhost:3000`) |
+| `--header` | `-H` | ❌ | HTTP header to include in every request (repeatable) |
+
+Multiple headers are supported by repeating the flag:
+
+```bash
+specbridge verify -f contract.feature -u http://localhost:3000 \
+  -H "Authorization: Bearer <token>" \
+  -H "X-Api-Key: abc123"
+```
 
 ---
 

package/index.js

@@ -16,6 +16,7 @@ program
   .description('Verify a contract defined in a Gherkin feature file')
   .requiredOption('-f, --file <path>', 'Path to the .feature file')
   .requiredOption('-u, --url <url>', 'Base URL of the service to test')
+  .option('-H, --header <header...>', 'HTTP header(s) to include (format: "Key: Value")')
   .action(async (opts) => {
     if (!existsSync(opts.file)) {
       console.error(`\x1b[31mError: Feature File not found: ${opts.file}\x1b[0m`)
@@ -35,6 +36,16 @@ program
       process.exit(0)
     }
 
+    const globalHeaders = {}
+    for (const raw of (opts.header ?? [])) {
+      const sep = raw.indexOf(':')
+      if (sep === -1) {
+        console.error(`\x1b[31mError: Invalid header format (expected "Key: Value"): ${raw}\x1b[0m`)
+        process.exit(1)
+      }
+      globalHeaders[raw.slice(0, sep).trim()] = raw.slice(sep + 1).trim()
+    }
+
     let passed = 0
     let failed = 0
 
@@ -45,7 +56,7 @@ program
       }
 
       const endpoint = buildEndpoint(opts.url, scenario.path)
-      const result = await runScenario(scenario, opts.url)
+      const result = await runScenario(scenario, opts.url, globalHeaders)
       reportScenario(scenario.name, endpoint, result)
 
       if (result.pass) passed++

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksz54213/specbridge",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Contract testing CLI tool — verify HTTP APIs against Gherkin feature files",
   "type": "module",
   "bin": {

package/src/runner.js

@@ -2,7 +2,7 @@ import axios from 'axios'
 import { buildEndpoint } from './endpoint.js'
 import { assertStatusCode, assertBodyExact, assertBodyField } from './assertions.js'
 
-export async function runScenario(scenario, baseUrl) {
+export async function runScenario(scenario, baseUrl, globalHeaders = {}) {
   const endpoint = buildEndpoint(baseUrl, scenario.path)
   const messages = []
 
@@ -10,6 +10,7 @@ export async function runScenario(scenario, baseUrl) {
     const response = await axios({
       method: scenario.method,
       url: endpoint,
+      headers: { ...globalHeaders, ...(scenario.headers ?? {}) },
       data: scenario.requestBody ?? undefined,
       timeout: 30_000,
       validateStatus: () => true,