mockaton 2.1.0 → 2.2.0

package/README.md

@@ -28,7 +28,7 @@ The first file in **alphabetical order** becomes the default mock.
 ### Optionally, you can write mocks in JavaScript
 An Object, Array, or String is sent as JSON.
 
-`api/user/likes.GET.200.js`
+`api/foo.GET.200.js`
 ```js
 export default [
   { id: 0 }
@@ -98,27 +98,9 @@ interface Config {
   proxyFallback?: string // e.g. http://localhost:9999 Target for relaying routes without mocks
   allowedExt?: RegExp // /\.(json|txt|md|js)$/ Just for excluding temporary editor files (e.g. JetBrains appends a ~)
   generate500?: boolean // autogenerates an Internal Server Error empty mock for routes that have no 500
+  extraHeaders?: []
 }
 ```
-
-## Cookies
-```js
-import { jwtCookie } from 'mockaton'
-
-Config.cookies = {
-  'My Admin User': 'my-cookie=1;Path=/;SameSite=strict',
-  'My Normal User': 'my-cookie=0;Path=/;SameSite=strict',
-  'My JWT': jwtCookie('my-cookie', {
-    email: 'john.doe@example.com',
-    picture: 'https://cdn.auth0.com/avatars/jd.png'
-  })
-}
-```
-The key is just a label used for selecting a particular cookie in the dashboard.
-
-`jwtCookie` has a hardcoded header and signature. In other
-words, it’s useful if you only care about its payload.
-
 ---
 
 ## File Name Convention
@@ -171,6 +153,40 @@ api/foo/?bar=[bar].GET.200.json
 api/foo/(my comment).GET.200.json
 ```
 
+
+## `Config.cookies`
+The selected cookie is sent in every response in the `Set-Cookie` header.
+```js
+import { jwtCookie } from 'mockaton'
+
+Config.cookies = {
+  'My Admin User': 'my-cookie=1;Path=/;SameSite=strict',
+  'My Normal User': 'my-cookie=0;Path=/;SameSite=strict',
+  'My JWT': jwtCookie('my-cookie', {
+    email: 'john.doe@example.com',
+    picture: 'https://cdn.auth0.com/avatars/jd.png'
+  })
+}
+```
+The key is just a label used for selecting a particular cookie in the dashboard.
+
+`jwtCookie` has a hardcoded header and signature. In other
+words, it’s useful if you only care about its payload.
+
+
+## `Config.extraHeaders`
+They are applied last, right before ending the response. In
+other words, they can overwrite the `Content-Type`. They are
+not tuples, the header name goes in even-numbered indices.
+
+```js
+Config.extraHeaders = [
+  'Server', 'Mockaton',
+  'Set-Cookie', 'another-cookie=FOO;Path=/;SameSite=strict',
+  'Set-Cookie', 'another-cookie=BAR;Path=/;SameSite=strict'
+]
+```
+
 ## Documenting Contracts (.md)
 This is handy for documenting request payload parameters. The dashboard will
 print the Markdown document (as plain text) above the actual payload content.

package/Tests.js

@@ -111,7 +111,8 @@ const server = Mockaton({
 		userA: 'CookieA',
 		userB: 'CookieB'
 	},
-	generate500: true
+	generate500: true,
+	extraHeaders: ['Server', 'MockatonTester']
 })
 server.on('listening', runTests)
 
@@ -158,7 +159,7 @@ async function runTests() {
 	await reset()
 	for (const [url, file, body] of fixtures)
 		await testMockDispatching(url, file, body)
-	
+
 	await testMockDispatching('/api/object', 'api/object.GET.200.js', { JSON_FROM_JS: true }, mimeFor('.json'))
 	await testJsFunctionMocks()
 
@@ -205,6 +206,7 @@ async function testMockDispatching(url, file, expectedBody, forcedMime = void 0)
 		it('status: ' + status, () => equal(res.status, status))
 		it('cookie: ' + mime, () => equal(res.headers.get('set-cookie'), 'CookieA'))
 		it('delay is under 1 sec', () => equal((new Date()).getTime() - now.getTime() < 1000, true))
+		it('extra header', () => equal(res.headers.get('server'), 'MockatonTester'))
 	})
 }
 

package/index.d.ts

@@ -10,7 +10,8 @@ interface Config {
 	skipOpen?: boolean
 	proxyFallback?: string
 	allowedExt?: RegExp
-	generate500?: boolean
+	generate500?: boolean,
+	extraHeaders?: [string, string][] 
 }
 
 export function Mockaton(options: Config): Server

package/package.json

@@ -2,7 +2,7 @@
 	"name": "mockaton",
 	"description": "A deterministic server-side for developing and testing frontend clients",
 	"type": "module",
-	"version": "2.1.0",
+	"version": "2.2.0",
 	"main": "index.js",
 	"types": "index.d.ts",
 	"license": "MIT",

package/sample-mocks/api/user/likes.GET.200.js

@@ -1,7 +1,9 @@
-// You can write JSON responses in JavaScript.
+// You can write JSON responses in JavaScript. 
+// You can export an: Object, Array, or String
 
 export default [
 	{ id: 0 },
 	{ id: 1 },
 	{ id: 2 },
 ]
+

package/sample-mocks/api/user/links.GET.200.js

@@ -0,0 +1,8 @@
+// You can write JSON responses in JavaScript as a function.
+// Must return a String and they should NOT call `response.end()`
+
+export default function (req, response) {
+	return JSON.stringify([
+		{ id: 0 }
+	])
+}

package/src/Config.js

@@ -12,7 +12,8 @@ export const Config = {
 	skipOpen: false,
 	proxyFallback: '', // e.g. http://localhost:9999
 	allowedExt: /\.(json|txt|md|js)$/, // Just for excluding temporary editor files (e.g. JetBrains appends a ~)
-	generate500: false
+	generate500: false,
+	extraHeaders: []
 }
 
 export function setup(options) {
@@ -27,7 +28,8 @@ export function setup(options) {
 		skipOpen: is(Boolean),
 		proxyFallback: is(String),
 		allowedExt: is(RegExp),
-		generate500: is(Boolean)
+		generate500: is(Boolean),
+		extraHeaders: Array.isArray
 	})
 }
 

package/src/MockDispatcher.js

@@ -31,10 +31,6 @@ export async function dispatchMock(req, response) {
 		const { file, status, delay } = broker
 		console.log('\n', req.url, '→\n ', file)
 
-		response.statusCode = status
-		if (cookie.getCurrent())
-			response.setHeader('set-cookie', cookie.getCurrent())
-
 		let mockText
 		if (file.endsWith('.js')) {
 			response.setHeader('content-type', mimeFor('.json'))
@@ -47,6 +43,11 @@ export async function dispatchMock(req, response) {
 			response.setHeader('content-type', mimeFor(file))
 			mockText = readMock(file)
 		}
+		
+		if (cookie.getCurrent())
+			response.setHeader('set-cookie', cookie.getCurrent())
+		
+		response.writeHead(status, Config.extraHeaders)
 		setTimeout(() => response.end(mockText), delay)
 	}
 	catch (error) {

package/src/Mockaton.js

@@ -14,6 +14,8 @@ export function Mockaton(options) {
 	mockBrokerCollection.init()
 
 	return createServer(async (req, response) => {
+		response.setHeader('Server', 'Mockaton')
+
 		const { url, method } = req
 		if (method === 'GET' && apiGetRequests.has(url))
 			apiGetRequests.get(url)(req, response)

package/sample-mocks/api/user/loves.GET.200.js

@@ -1,7 +0,0 @@
-// You can write JSON responses in JavaScript.
-
-export default function (req, response) {
-	return JSON.stringify([
-		{ id: 0 }
-	])
-}