orator-http-proxy 1.0.0

package/.vscode/launch.json

@@ -0,0 +1,46 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Launch Debug Harness",
+            "type": "pwa-node",
+            "request": "launch",
+            "outputCapture": "std",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${workspaceFolder}/debug/Harness.js",
+            "presentation": {
+                "hidden": false,
+                "group": "",
+                "order": 1
+            }
+        },
+        {
+            "name": "Mocha Tests",
+            "args": [
+                "-u",
+                "tdd",
+                "--timeout",
+                "999999",
+                "--colors",
+                "${workspaceFolder}/test"
+            ],
+            "internalConsoleOptions": "openOnSessionStart",
+            "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
+            "request": "launch",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "type": "pwa-node",
+            "presentation": {
+                "hidden": false,
+                "group": "",
+                "order": 2
+            }
+        }
+    ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Steven Velozo
+
+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,7 @@
+# Orator Service Server Proxy
+
+Proxy API requests from a stable prefix.  This lets you map /1.0/ to one set
+of servers, /1.1/ to another and /1.0/CustomApi* to a third.
+
+Meant to be used for local development and pass-through API for front-side
+web servers, not an industrial-grade API routing service.

package/debug/Harness.js

@@ -0,0 +1,62 @@
+const libFable = require('fable');
+
+const defaultFableSettings = (
+	{
+		Product:'Orator-Proxy',
+		ProductVersion: '1.0.0',
+		APIServerPort: 8765
+	});
+
+// Initialize Fable
+let _Fable = new libFable(defaultFableSettings);
+
+// Now initialize the Restify ServiceServer Fable Service
+_Fable.serviceManager.addServiceType('OratorServiceServer', require('orator-serviceserver-restify'));
+_Fable.serviceManager.instantiateServiceProvider('OratorServiceServer', 
+	{
+		RestifyConfiguration: { strictNext: true }
+	});
+
+// Now add the orator service to Fable
+_Fable.serviceManager.addServiceType('Orator', require('orator'));
+let _Orator = _Fable.serviceManager.instantiateServiceProvider('Orator', {});
+
+let tmpAnticipate = _Fable.newAnticipate();
+
+// Initialize the Orator server
+tmpAnticipate.anticipate(_Orator.initialize.bind(_Orator));
+
+// Create a simple custom endpoint on the server.
+tmpAnticipate.anticipate(
+	(fStageComplete)=>
+	{
+		// Create an endpoint.  This can also be done after the service is started.
+		_Orator.serviceServer.get
+		(
+			'/test/:hash',
+			(pRequest, pResponse, fNext) =>
+			{
+				// Send back the request parameters
+				pResponse.send(pRequest.params);
+				_Orator.fable.log.info(`Endpoint sent parameters object:`, pRequest.params);
+				return fNext();
+			}
+		);
+		return fStageComplete();
+	});
+
+// Proxy all /1.0/ requests to the locally-running bookstore service (you need to run this from https://github.com/stevenvelozo/retold-harness ... it's a one-liner to start the service)
+
+
+// Now start the service server.
+tmpAnticipate.anticipate(_Orator.startService.bind(_Orator));
+
+tmpAnticipate.wait(
+	(pError)=>
+	{
+		if (pError)
+		{
+			_Fable.log.error('Error initializing Orator Service Server: '+pError.message, pError);
+		}
+		_Fable.log.info('Orator Service Server Initialized.');
+	});

package/package.json

@@ -0,0 +1,50 @@
+{
+    "name": "orator-http-proxy",
+    "version": "1.0.0",
+    "description": "Orator http proxy pass-through.",
+    "main": "source/Orator-HTTP-Proxy.js",
+    "scripts": {
+        "test": "./node_modules/mocha/bin/_mocha --exit -u tdd -R spec",
+        "coverage": "./node_modules/.bin/nyc --reporter=lcov --reporter=text-lcov ./node_modules/mocha/bin/_mocha -- -u tdd -R spec",
+        "start": "node debug/Harness.js",
+        "tests": "npx mocha -u tdd --exit -R spec --grep"
+    },
+    "mocha": {
+        "diff": true,
+        "extension": [
+            "js"
+        ],
+        "package": "./package.json",
+        "reporter": "spec",
+        "slow": "75",
+        "timeout": "5000",
+        "ui": "tdd",
+        "watch-files": [
+            "source/**/*.js",
+            "test/**/*.js"
+        ],
+        "watch-ignore": [
+            "lib/vendor"
+        ]
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/stevenvelozo/orator-http-proxy.git"
+    },
+    "author": "steven velozo <steven@velozo.com>",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/stevenvelozo/orator-http-proxy/issues"
+    },
+    "homepage": "https://github.com/stevenvelozo/orator-http-proxy#readme",
+    "dependencies": {
+        "http-proxy": "^1.18.1",
+        "orator-serviceserver-base": "^1.0.1"
+    },
+    "devDependencies": {
+        "fable": "^3.0.145",
+        "orator": "^5.0.0",
+        "orator-serviceserver-restify": "^2.0.3",
+        "quackage": "^1.0.33"
+    }
+}

package/source/Orator-HTTP-Proxy.js

@@ -0,0 +1,89 @@
+const FableServiceProviderBase = require('fable-serviceproviderbase');
+
+const HttpProxy = require('http-proxy');
+
+/**
+ * Fable service that provies a simple proxy for an orator web server instance that redirects /1.0/* to
+ * a given URL (ex. a hosted Headlight API).
+ */
+class HeadlightAPIProxyService extends FableServiceProviderBase
+{
+	/**
+	 * Construct a service instance.
+	 *
+	 * @param {object} pFable The fable instance for the application. Used for logging and settings.
+	 * @param {object} pOptions Custom settings for this service instance.
+	 * @param {string} pServiceHash The hash for this service instance.
+	 *
+	 * @return a HeadlightAPIProxyService instance.
+	 */
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+
+		if (typeof(this.options.proxyUrl) != 'string' || !this.options.proxyUrl.startsWith('http'))
+		{
+			this.log.trace('API proxy url falling back to settings...', { badUrl: this.options.proxyUrl });
+			this.options.proxyUrl = this.fable.settings.APIProxyUrl;
+		}
+
+		if (typeof(this.options.proxyUrl) != 'string' || !this.options.proxyUrl.startsWith('http'))
+		{
+			this.log.trace('API proxy url falling back to default...', { badUrl: this.options.proxyUrl });
+			this.options.proxyUrl = 'https://127.0.0.1/';
+		}
+
+		if (typeof(this.options.requestPrefix) != 'string' || !this.options.requestPrefix.startsWith('/'))
+		{
+			this.options.requestPrefix = '/1.0/*';
+		}
+
+		if (!Array.isArray(this.options.requestPrefixes) || this.options.requestPrefixes.length < 1)
+		{
+			this.options.requestPrefixes = [this.options.requestPrefix];
+		}
+
+		this.httpProxyServer = HttpProxy.createProxyServer({});
+	}
+
+	/**
+	 * Create handlers for each HTTP verb on /1.0/* that proxy requests to the configured proxy URL.
+	 */
+	connectProxyRoutes(pOrator)
+	{
+		const proxyRequest = (pRequest, pResponse, fNext) =>
+		{
+			this.log.info(`Proxying request from URI [${pRequest.url}] to [${this.options.proxyUrl}]`);
+			const options =
+			{
+				target: this.options.proxyUrl,
+				secure: false, // needed when proxying from HTTP to HTTPS
+			};
+			if (this.options.httpProxyOptions)
+			{
+				Object.assign(options, this.options.httpProxyOptions);
+			}
+			try
+			{
+				this.httpProxyServer.web(pRequest, pResponse, options);
+			}
+			catch (pError)
+			{
+				this.log.error(`Error proxying ${pRequest.url}: ${pError.message}`, { stack: pError.stack });
+				pResponse.end(` - ERROR: ${pError.message}`);
+			}
+		};
+
+		this.log.info('Adding API proxy to orator...', { proxyUrl: this.options.proxyUrl, requestPrefixes: this.options.requestPrefixes });
+
+		for (const requestPrefix of this.options.requestPrefixes)
+		{
+			pOrator.webServer.get(requestPrefix, proxyRequest);
+			pOrator.webServer.put(requestPrefix, proxyRequest);
+			pOrator.webServer.del(requestPrefix, proxyRequest);
+			pOrator.webServer.post(requestPrefix, proxyRequest);
+		}
+	}
+}
+
+module.exports = HeadlightAPIProxyService;

package/test/Orator-HTTP-Proxy-basic_tests.js

@@ -0,0 +1,62 @@
+/**
+* Unit tests for Orator
+* @license     MIT
+* @author      Steven Velozo <steven@velozo.com>
+*/
+
+const Chai = require("chai");
+const Expect = Chai.expect;
+const Assert = Chai.assert;
+
+const libFable = require('fable');
+const libOrator = require('orator');
+const libOratorHTTPProxy = require('../source/Orator-HTTP-Proxy.js');
+
+//const libSuperTest = require('supertest');
+
+suite
+(
+	'Orator Restify Abstraction',
+	() =>
+	{
+		suite
+		(
+			'Object Sanity',
+			() =>
+			{
+				test
+				(
+					'The class should initialize itself into a happy little object.',
+					function (fDone)
+					{
+						// Initialize fable
+						let tmpFable = new libFable();
+
+						// Add Restify as the default service server type
+						tmpFable.addServiceType('OratorHTTPProxy', libOratorHTTPProxy);
+
+						// We can safely create the service now if we want, or after Orator is created.  As long as it's before we initialize orator.
+						let tmpOratorServiceServerRestify = tmpFable.instantiateServiceProvider('OratorHTTPProxy', {});
+
+						// Add Orator as a service
+						tmpFable.addServiceType('Orator', libOrator);
+
+						// Initialize the Orator service
+						let tmpOrator = tmpFable.instantiateServiceProvider('Orator', {});
+						// Sanity check Orator
+						Expect(tmpOrator).to.be.an('object', 'Orator should initialize as an object directly from the require statement.');
+
+						tmpOrator.initialize(
+							(pError)=>
+							{
+								Expect(tmpOrator.startService).to.be.an('function');
+
+								Expect(tmpOrator.serviceServer.ServiceServerType).to.equal('IPC', 'The service server provider should be Restify.');
+								fDone();
+							});
+					}
+				);
+			}
+		);
+	}
+);