mockaton 8.27.0 → 9.1.2

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+
+## 9.0.0 (9/13/25)
+- **Breaking change**: Commander GET APIs have been consolidated into `commander.getState()`. These were undocumented APIs, so likely you are not affected.
+- `--no-open` new cli flag. Prevents opening dashboard in a browser. (No-ops `config.onReady`)

package/README.md

@@ -4,6 +4,8 @@
 ![NPM Version](https://img.shields.io/npm/l/mockaton)
 [![Test](https://github.com/ericfortis/mockaton/actions/workflows/test.yml/badge.svg)](https://github.com/ericfortis/mockaton/actions/workflows/test.yml)
 [![CodeQL](https://github.com/ericfortis/mockaton/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/ericfortis/mockaton/actions/workflows/github-code-scanning/codeql)
+[![codecov](https://codecov.io/github/ericfortis/mockaton/graph/badge.svg?token=90NYLMMG1J)](https://codecov.io/github/ericfortis/mockaton)
+
 
 An HTTP mock server for simulating APIs with minimal setup
 — ideal for testing difficult to reproduce states.
@@ -92,9 +94,9 @@ api/videos.GET.<b>500</b>.txt   # Internal Server Error
 ## Scraping Mocks from your Backend
 
 ### Option 1: Browser Extension
-With the companion [browser-devtools
+The companion Chrome [devtools
 extension](https://github.com/ericfortis/download-http-requests-browser-ext)
-you can download all the HTTP responses, and they
+lets you download all the HTTP responses, and they
 get saved following Mockaton’s filename convention.
 
 ### Option 2: Fallback to Your Backend
@@ -121,26 +123,36 @@ They will be saved in your `config.mocksDir` following the filename convention.
 - Does not write to disk. Except when you select ✅ **Save Mocks** for scraping mocks from a backend.
 - Does not initiate network connections (no logs, no telemetry).
 - Does not hijack your HTTP client.
-- Auditable. Organized and small &mdash; under 4 KLoC (50% is UI and tests) with 92% code coverage.
+- Auditable. Organized and small &mdash; under 4 KLoC (half is UI and tests).
 
 
 ## Basic Usage
-Create a sample mock in the default mocks directory (`./mockaton-mocks`).
+1. Install Node.js, which comes with `npm` and `npx`
+
+2. Create a sample mock in the default mocks directory (`./mockaton-mocks`)
 ```sh
-mkdir -p mockaton-mocks/api/
+mkdir -p         mockaton-mocks/api
 echo "[1,2,3]" > mockaton-mocks/api/foo.GET.200.json
 ```
-
-Mockaton is a Node.js program, so you install and run it with:
+3. Run Mockaton (`npx` installs it if needed)
 ```shell
 npx mockaton --port 2345
 ```
 
-Or, if you have a `package.json`
+4. Test it
+```shell
+curl http://localhost:2345/api/foo 
+```
+
+### Alternative Installations
+<details>
+<summary>With NPM…</summary>
+
 ```shell
 npm install mockaton --save-dev
 ```
 
+Then in your, `package.json`:
 ```json
 {
   "scripts": {
@@ -148,7 +160,23 @@ npm install mockaton --save-dev
   }
 }
 ```
+</details>
+
+
+<details>
+<summary>Without NPM…</summary>
+
+Since Mockaton has no dependencies, you can create an executable
+by linking to `src/cli.js`.
+
+```shell
+git clone https://github.com/ericfortis/mockaton.git
+ln -s `realpath mockaton/src/cli.js` ~/bin/mockaton # some dir in your $PATH
+```
+
+</details>
 
+<br/>
 
 
 ## CLI Options
@@ -164,6 +192,8 @@ The CLI options override their counterparts in `mockaton.config.js`
 -p, --port <port>      (default: 0) which means auto-assigned
 
 -q, --quiet            Errors only
+--no-open              Don’t open dashboard in a browser (noops onReady callback)
+
 -h, --help             Show this help
 -v, --version          Show version
 ```
@@ -186,24 +216,20 @@ export default defineConfig({
 
   host: '127.0.0.1',
   port: 0,
+  
+  logLevel: 'normal',
+  
+  delay: 1200,
+  delayJitter: 0,
 
   proxyFallback: '',
   collectProxied: false,
   formatCollectedJSON: true,
 
-  delay: 1200,
-  delayJitter: 0,
-
   cookies: {},
-
   extraHeaders: [],
-
   extraMimes: {},
 
-  plugins: [
-    [/\.(js|ts)$/, jsToJsonPlugin]
-  ],
-
   corsAllowed: true,
   corsOrigins: ['*'],
   corsMethods: SUPPORTED_METHODS,
@@ -211,10 +237,13 @@ export default defineConfig({
   corsExposedHeaders: [],
   corsCredentials: true,
   corsMaxAge: 0,
+  
+  
+  plugins: [
+    [/\.(js|ts)$/, jsToJsonPlugin]
+  ],
 
   onReady: await openInBrowser,
-  
-  logLevel: 'normal'
 })
 ```
 
@@ -354,7 +383,8 @@ config.extraHeaders = [
 ### `extraMimes?: { [fileExt: string]: string }`
 ```js
 config.extraMimes = {
-  jpe: 'application/jpeg'
+  jpe: 'application/jpeg',
+  html: 'text/html; charset=utf-8' // overrides built-in
 }
 ```
 Those extra media types take precedence over the built-in
@@ -463,15 +493,17 @@ Defaults to `'normal'`.
 <details>
 <summary>Programmatic Launch (Optional)</summary>
 
+
 ```js
 import { Mockaton } from 'mockaton'
 import mockatonConfig from './mockaton.config.js'
 
-Mockaton({
+const server = Mockaton({
   ...mockatonConfig, // Not required, but it’s not read by default.
-  port: 3333, // etc.
 })
 ```
+See [src/cli.js](src/cli.js)
+
 </details>
 
 
@@ -732,6 +764,14 @@ with many partial matches, their first mock in alphabetical order wins.
 ### Set route is delayed flag
 ```js
 await mockaton.setRouteIsDelayed('GET', '/api/foo', true)
+// or
+await mockaton.setStaticRouteIsDelayed('/api/foo', true)
+```
+<br/>
+
+### Set static route status
+```js
+await mockaton.setStaticRouteStatus('/api/foo', 404)
 ```
 
 ### Set route is proxied flag
@@ -762,6 +802,23 @@ await mockaton.setCollectProxied(true)
 
 <br/>
 
+### Set global delay value
+```js
+await mockaton.setGlobalDelsy(1200) // ms
+```
+
+<br/>
+
+
+### Set CORS allowed
+```js
+await mockaton.setCorsAllowed(true)
+```
+
+<br/>
+
+
+
 ### Reset
 Re-initialize the collection. The selected mocks, cookies, and delays go back to
 default, but the `proxyFallback`, `colledProxied`, and `corsAllowed` are not affected.

package/index.d.ts

@@ -16,22 +16,20 @@ interface Config {
 
 	host?: string,
 	port?: number
+	
+	logLevel?: 'normal' | 'quiet'
+
+	delay?: number
+	delayJitter?: number
 
 	proxyFallback?: string
 	collectProxied?: boolean
 	formatCollectedJSON?: boolean
 
-	delay?: number
-	delayJitter?: number
-
 	cookies?: { [label: string]: string }
-
 	extraHeaders?: string[]
-
 	extraMimes?: { [fileExt: string]: string }
 
-	plugins?: [filenameTester: RegExp, plugin: Plugin][]
-
 	corsAllowed?: boolean,
 	corsOrigins?: string[]
 	corsMethods?: string[]
@@ -39,15 +37,16 @@ interface Config {
 	corsExposedHeaders?: string[]
 	corsCredentials?: boolean
 	corsMaxAge?: number
+	
+	
+	plugins?: [filenameTester: RegExp, plugin: Plugin][]
 
 	onReady?: (address: string) => void
-	
-	logLevel?: 'normal' | 'quiet'
 }
 
 
 export function Mockaton(options: Partial<Config>): Server | undefined
-export function defineConfig(options: Partial<Config>): Config
+export function defineConfig(options: Partial<Config>): Partial<Config>
 
 export const jsToJsonPlugin: Plugin
 
@@ -86,3 +85,17 @@ export type ClientStaticBrokers = {
 }
 
 
+export interface State {
+	brokersByMethod: ClientBrokersByMethod
+	staticBrokers: ClientStaticBrokers
+	
+	cookies: [label:string, selected:boolean][] 
+	comments: string[]
+	
+	delay: number
+	
+	collectProxied: boolean
+	proxyFallback: string
+	
+	corsAllowed: boolean
+}

package/index.js

@@ -5,5 +5,4 @@ export { jwtCookie } from './src/utils/jwt.js'
 export { jsToJsonPlugin } from './src/MockDispatcher.js'
 export { parseJSON } from './src/utils/http-request.js'
 
-/** @param {Partial<Config>} opts */
 export const defineConfig = opts => opts