mockaton 0.9.9 → 0.10.0

package/README.md

@@ -5,9 +5,7 @@ It scans `Config.mocksDir` for files following a specific directory
 and file name convention, which is similar to the URL paths. For
 example, the following file will be served for `/api/user/1234`
 ```
--- api/
-   |-- user/
-       |-- [user-id].GET.200.json
+my-mocks-dir/api/user/[user-id].GET.200.json
 ```
 
 By the way, [this browser
@@ -63,7 +61,7 @@ npm install mockaton
 Create a `my-mockaton.js` file
 ```js
 import { resolve } from 'node:path'
-import { Mockaton } from 'mockaton'
+import { Mockaton } from 'src/Mockaton'
 
 Mockaton({ // Config options
   port: 2345,
@@ -86,16 +84,17 @@ interface Config {
   cookies?(): object 
   database?: object // for "Transforms"
   skipOpen?: boolean // Prevents opening the dashboard in a browser
+	proxyFallback?: string // e.g. http://localhost:9999 For relaying routes without mocks
   allowedExt?: RegExp // /\.(json|txt|md|mjs)$/ Just for excluding temporary editor files (e.g. JetBrains appends a ~)
 }
 ```
 
 ## Cookies
 ```js
-import { jwtCookie } from 'mockaton'
+import { jwtCookie } from 'src/Mockaton'
 
 Config.cookies = {
-  'My Admin User':  'my-cookie=1;Path=/;SameSite=strict',
+  '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',
@@ -177,9 +176,9 @@ with `.mjs` will process the mock before serving it.
 
 For example, this handler will capitalize the mock body and increment a counter.
 ```js
-export default function capitalizeAllText(mockAsText, requestBody, Config) {
-  Config.database.myCount ??= 0
-  Config.database.myCount++
+export default function capitalizeAllText(mockAsText, requestBody, config) {
+  config.database.myCount ??= 0
+  config.database.myCount++
   return mockAsText.toUpperCase()
 }
 ```

package/Tests.js

@@ -3,13 +3,14 @@
 import { tmpdir } from 'node:os'
 import { dirname } from 'node:path'
 import { describe, it } from 'node:test'
+import { createServer } from 'node:http'
 import { equal, deepEqual, match } from 'node:assert/strict'
 import { writeFileSync, mkdtempSync, mkdirSync } from 'node:fs'
 
-import { Route } from './Route.js'
-import { mimeFor } from './utils/mime.js'
-import { DP, DF } from './ApiConstants.js'
-import { Mockaton } from './Mockaton.js'
+import { Route } from './src/Route.js'
+import { mimeFor } from './src/utils/mime.js'
+import { Mockaton } from './src/Mockaton.js'
+import { DP, DF } from './src/ApiConstants.js'
 
 
 const tmpDir = mkdtempSync(tmpdir()) + '/'
@@ -98,17 +99,22 @@ writeStatic('index.html', '<h1>Static</h1>')
 writeStatic('assets/app.js', 'const app = 1')
 writeStatic('another-entry/index.html', '<h1>Another</h1>')
 
-
-const server = Mockaton({
-	mocksDir: tmpDir,
-	staticDir: staticTmpDir,
-	skipOpen: true,
-	cookies: {
-		userA: 'CookieA',
-		userB: 'CookieB'
-	}
+let server
+const fallbackServer = createServer((_, response) => {
+	response.end('From_Fallback_Server')
+}).listen(0, 'localhost', function () {
+	server = Mockaton({
+		mocksDir: tmpDir,
+		staticDir: staticTmpDir,
+		skipOpen: true,
+		cookies: {
+			userA: 'CookieA',
+			userB: 'CookieB'
+		},
+		proxyFallback: `http://localhost:${fallbackServer.address().port}`
+	})
+	server.on('listening', runTests)
 })
-server.on('listening', runTests)
 
 async function runTests() {
 	await testItRendersDashboard()
@@ -157,7 +163,9 @@ async function runTests() {
 	await testTransforms()
 	await testStaticFileServing()
 	await testInvalidFilenamesAreIgnored()
+	await testRouteWithoutMocksRelaysGetsProxied()
 	server.close()
+	fallbackServer.close()
 }
 
 async function reset() {
@@ -350,6 +358,12 @@ async function testInvalidFilenamesAreIgnored() {
 	})
 }
 
+async function testRouteWithoutMocksRelaysGetsProxied() {
+	await it('Fallback relay', async () => {
+		const res = await request('/non-existing-mock')
+		equal(await res.text(), 'From_Fallback_Server')
+	})
+}
 
 // Utils
 

package/index.d.ts

@@ -11,6 +11,7 @@ interface Config {
 
 	database?: object
 	skipOpen?: boolean
+	proxyFallback?: string
 	allowedExt?: RegExp
 }
 

package/index.js

@@ -1,2 +1,2 @@
-export { Mockaton } from './Mockaton.js'
-export { jwtCookie } from './utils/jwt.js'
+export { Mockaton } from './src/Mockaton.js'
+export { jwtCookie } from './src/utils/jwt.js'

package/package.json

@@ -2,13 +2,13 @@
 	"name": "mockaton",
 	"description": "A deterministic server-side for developing and testing frontend clients",
 	"type": "module",
-	"version": "0.9.9",
+	"version": "0.10.0",
 	"main": "index.js",
 	"types": "index.d.ts",
 	"license": "MIT",
 	"repository": "https://github.com/ericfortis/mockaton",
 	"scripts": {
 		"test": "./Tests.js",
-		"demo": "_usage_example.js"
+		"demo": "./_usage_example.js"
 	}
 }

package/{Config.js → src/Config.js}

@@ -11,6 +11,7 @@ export const Config = {
 	cookies: {}, // defaults to the first kv
 	database: {},
 	skipOpen: false,
+	proxyFallback: '', // e.g. http://localhost:9999
 	allowedExt: /\.(json|txt|md|mjs)$/ // Just for excluding temporary editor files (e.g. JetBrains appends a ~)
 }
 
@@ -25,6 +26,7 @@ export function setup(options) {
 		cookies: is(Object),
 		database: is(Object),
 		skipOpen: is(Boolean),
+		proxyFallback: is(String),
 		allowedExt: is(RegExp)
 	})
 }

package/{MockDispatcher.js → src/MockDispatcher.js}

@@ -2,6 +2,7 @@ import { join } from 'node:path'
 import { readFileSync } from 'node:fs'
 
 import { DF } from './ApiConstants.js'
+import { proxy } from './ProxyRelay.js'
 import { cookie } from './cookie.js'
 import { Config } from './Config.js'
 import { mimeFor } from './utils/mime.js'
@@ -19,10 +20,13 @@ export async function dispatchMock(req, response) {
 
 	const broker = mockBrokerCollection.getBrokerForUrl(req.method, req.url)
 	if (!broker) {
-		sendNotFound(response)
+		if (Config.proxyFallback)
+			await proxy(req, response)
+		else
+			sendNotFound(response) // TESTME
 		return
 	}
-	
+
 	try {
 		const { file, status, delay, currentTransform } = broker
 		console.log('\n', req.url, '→\n ', file)

package/src/ProxyRelay.js

@@ -0,0 +1,11 @@
+import { Config } from './Config.js'
+
+
+export async function proxy(req, response) {
+	const proxyResponse = await fetch(Config.proxyFallback + req.url, {
+		method: req.method,
+		headers: req.headers
+	})
+	response.writeHead(proxyResponse.status, proxyResponse.headers)
+	response.end(await proxyResponse.text())
+}