@harperfast/harper 5.0.0-alpha.10

package/dist/server/operationsServer.js

@@ -0,0 +1,265 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hdbServer = operationsServer;
+exports.start = operationsServer;
+exports.calculateRestHttpURL = calculateRestHttpURL;
+const cluster_1 = __importDefault(require("cluster"));
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const environmentManager_js_1 = __importDefault(require("../utility/environment/environmentManager.js"));
+environmentManager_js_1.default.initSync();
+const terms = __importStar(require("../utility/hdbTerms.js"));
+const harper_logger_js_1 = __importDefault(require("../utility/logging/harper_logger.js"));
+const fastify_1 = __importDefault(require("fastify"));
+const cors_1 = __importDefault(require("@fastify/cors"));
+const compress_1 = __importDefault(require("@fastify/compress"));
+const static_1 = __importDefault(require("@fastify/static"));
+const requestTimePlugin_js_1 = __importDefault(require("./serverHelpers/requestTimePlugin.js"));
+const path_1 = __importDefault(require("path"));
+const packageUtils_js_1 = require("../utility/packageUtils.js");
+const globalSchema_js_1 = __importDefault(require("../utility/globalSchema.js"));
+const common_utils_js_1 = __importDefault(require("../utility/common_utils.js"));
+const userSchema = __importStar(require("../security/user.js"));
+const Server_ts_1 = require("../server/Server.js");
+const serverHandlers_js_1 = require("./serverHelpers/serverHandlers.js");
+const contentTypes_ts_1 = require("./serverHelpers/contentTypes.js");
+const openApi_ts_1 = require("../resources/openApi.js");
+const hdbError_js_1 = require("../utility/errors/hdbError.js");
+const DEFAULT_HEADERS_TIMEOUT = 60000;
+const REQ_MAX_BODY_SIZE = environmentManager_js_1.default.get(terms.CONFIG_PARAMS.OPERATIONSAPI_NETWORK_MAXREQUESTBODYSIZE) ?? 1024 * 1024 * 1024; //this defaults to 1GB in bytes
+const TRUE_COMPARE_VAL = 'TRUE';
+const { CONFIG_PARAMS } = terms;
+let server;
+/**
+ * Builds a Harper server.
+ */
+async function operationsServer(options) {
+    try {
+        harper_logger_js_1.default.debug('In Fastify server' + process.cwd());
+        harper_logger_js_1.default.debug(`Running with NODE_ENV set as: ${process.env.NODE_ENV}`);
+        harper_logger_js_1.default.debug(`Harper server process ${process.pid} starting up.`);
+        global.clustering_on = false;
+        global.isMaster = cluster_1.default.isMaster;
+        await setUp();
+        // if we have a secure port, need to use the secure HTTP server for fastify (it can be used for HTTP as well)
+        const isHttps = options.securePort > 0;
+        //generate a Fastify server instance
+        server = buildServer(isHttps, options.resources);
+        //make sure the process waits for the server to be fully instantiated before moving forward
+        await server.ready();
+        if (!options)
+            options = {};
+        options.isOperationsServer = true;
+        // fastify can't clean up properly
+        try {
+            // now that server is fully loaded/ready, start listening on port provided in config settings or just use
+            // zero to wait for sockets from the main thread
+            Server_ts_1.server.http(server.server, options);
+            if (!server.server.closeIdleConnections) {
+                // before Node v18, closeIdleConnections is not available, and we have to setup a listener for fastify
+                // to handle closing by setting up the dynamic port
+                await server.listen({ port: 0, host: '::' });
+            }
+        }
+        catch (err) {
+            server.close();
+            harper_logger_js_1.default.error(err);
+            harper_logger_js_1.default.error(`Error configuring operations server`);
+            throw err;
+        }
+    }
+    catch (err) {
+        console.error(`Failed to build server on ${process.pid}`, err);
+        harper_logger_js_1.default.fatal(err);
+        process.exit(1);
+    }
+}
+/**
+ * Makes sure global values are set and that clustering connections are set/ready before server starts.
+ */
+async function setUp() {
+    harper_logger_js_1.default.trace('Configuring Harper process.');
+    globalSchema_js_1.default.setSchemaDataToGlobal();
+    return userSchema.setUsersWithRolesCache();
+}
+/**
+ * This method configures and returns a Fastify server - for either HTTP or HTTPS - based on the provided config settings
+ */
+function buildServer(isHttps, resources) {
+    harper_logger_js_1.default.debug(`Harper process starting to build ${isHttps ? 'HTTPS' : 'HTTP'} server.`);
+    const serverOpts = getServerOptions(isHttps);
+    const app = (0, fastify_1.default)(serverOpts);
+    // Fastify does not set this property in the initial app construction
+    app.server.headersTimeout = getHeaderTimeoutConfig();
+    // Set a top-level error handler for the server - all errors caught/thrown within the API will bubble up to this
+    // handler so that they can be handled in a coordinated way
+    app.setErrorHandler(serverHandlers_js_1.serverErrorHandler);
+    const corsOptions = getCORSOpts();
+    if (corsOptions) {
+        app.register(cors_1.default, corsOptions);
+    }
+    app.register(function (instance, options, done) {
+        instance.setNotFoundHandler(function (request, reply) {
+            app.server.emit('unhandled', request.raw, reply.raw);
+        });
+        done();
+    });
+    app.register(requestTimePlugin_js_1.default);
+    // This handles all get requests for the studio
+    app.register(compress_1.default, {
+        brotliOptions: {
+            params: {
+                [node_zlib_1.default.constants.BROTLI_PARAM_MODE]: node_zlib_1.default.constants.BROTLI_MODE_TEXT, // useful for APIs that primarily return text
+                [node_zlib_1.default.constants.BROTLI_PARAM_QUALITY]: 2, // default is 4, max is 11, min is 0
+            },
+        },
+    });
+    (0, contentTypes_ts_1.registerContentHandlers)(app);
+    // Add a simple health check
+    app.get('/health', () => 'Harper is running.');
+    // Add a top-level GET handler for browsers.
+    app.register(static_1.default, { root: path_1.default.join(packageUtils_js_1.PACKAGE_ROOT, 'studio/web') });
+    const studioOn = environmentManager_js_1.default.get(terms.HDB_SETTINGS_NAMES.LOCAL_STUDIO_ON);
+    if (!common_utils_js_1.default.isEmpty(studioOn) && studioOn.toString().toLowerCase() === 'true') {
+        app.get('/', (req, res) => res.sendFile('index.html'));
+    }
+    else {
+        app.get('/', (req, res) => res.sendFile('running.html'));
+    }
+    // Describe the APIs.
+    app.get('/api/openapi/rest', { preValidation: [serverHandlers_js_1.authAndEnsureUserOnRequest] }, restOpenAPIHandler(resources));
+    // Add the top-level POST handler.
+    app.post('/', {
+        preValidation: [serverHandlers_js_1.reqBodyValidationHandler, serverHandlers_js_1.authHandler],
+        config: { isOperation: true },
+    }, handler);
+    harper_logger_js_1.default.debug(`Harper process starting up ${isHttps ? 'HTTPS' : 'HTTP'} server listener.`);
+    return app;
+}
+function restOpenAPIHandler(resources) {
+    const httpPort = environmentManager_js_1.default.get(terms.CONFIG_PARAMS.HTTP_PORT);
+    const httpSecurePort = environmentManager_js_1.default.get(terms.CONFIG_PARAMS.HTTP_SECUREPORT);
+    return (req) => {
+        if (req.hdb_user?.role?.permission?.super_user) {
+            return (0, openApi_ts_1.generateJsonApi)(resources, calculateRestHttpURL(httpPort, httpSecurePort, req));
+        }
+        else {
+            harper_logger_js_1.default.warn(`{"ip":"${req.socket.remoteAddress}", "error":"attempt to access /api/openapi/rest without being super_user"`);
+            return new hdbError_js_1.ServerError(`Forbidden`, 403);
+        }
+    };
+}
+function calculateRestHttpURL(httpPort, httpSecurePort, req) {
+    const httpURL = new URL(`${req.protocol}://${req.hostname}`);
+    // note that the request is from fastify, which doesn't seem to have a correct hostname property (includes port), so the URL needs to be used for hostname
+    if (httpURL.hostname.toLowerCase() === 'localhost' || httpURL.hostname.match(/^[\d.:]+$/)) {
+        // Only use ports when running against localhost, or an ip address.
+        if (httpSecurePort) {
+            httpURL.port = httpSecurePort;
+            httpURL.protocol = 'https:';
+        }
+        else if (httpPort) {
+            httpURL.port = httpPort;
+            httpURL.protocol = 'http:';
+        }
+    }
+    else {
+        // Otherwise, assume that port forwarding is happening, and possibly SSL termination.
+        httpURL.port = '443';
+        httpURL.protocol = 'https:';
+    }
+    return httpURL.toString();
+}
+function handler(req, reply) {
+    // if the operation is a restart, we have to tell the client not to use keep alive on this connection
+    // anymore; it needs to be closed because this thread is going to be terminated
+    if (req.body?.operation?.startsWith('restart')) {
+        reply.header('Connection', 'close');
+    }
+    //if no error is thrown below, the response 'data' returned from the handler will be returned with 200/OK code
+    return (0, serverHandlers_js_1.handlePostRequest)(req, reply);
+}
+/**
+ * Builds server options object to pass to Fastify when using server factory.
+ */
+function getServerOptions(isHttps) {
+    const server_timeout = environmentManager_js_1.default.get(CONFIG_PARAMS.OPERATIONSAPI_NETWORK_TIMEOUT);
+    const keep_alive_timeout = environmentManager_js_1.default.get(CONFIG_PARAMS.OPERATIONSAPI_NETWORK_KEEPALIVETIMEOUT);
+    return {
+        bodyLimit: REQ_MAX_BODY_SIZE,
+        connectionTimeout: server_timeout,
+        keepAliveTimeout: keep_alive_timeout,
+        forceCloseConnections: true,
+        return503OnClosing: false,
+        http2: environmentManager_js_1.default.get(CONFIG_PARAMS.OPERATIONSAPI_NETWORK_HTTP2),
+        https: isHttps /* && {
+            allowHTTP1: true,
+        },*/,
+    };
+}
+/**
+ * Builds CORS options object to pass to cors plugin when/if it needs to be registered with Fastify
+ */
+function getCORSOpts() {
+    const propsCors = environmentManager_js_1.default.get(CONFIG_PARAMS.OPERATIONSAPI_NETWORK_CORS);
+    const propsCorsAccesslist = environmentManager_js_1.default.get(CONFIG_PARAMS.OPERATIONSAPI_NETWORK_CORSACCESSLIST);
+    let corsOptions;
+    if (propsCors && (propsCors === true || propsCors.toUpperCase() === TRUE_COMPARE_VAL)) {
+        corsOptions = {
+            origin: true,
+            allowedHeaders: ['Content-Type', 'Authorization', 'Accept'],
+            credentials: false,
+        };
+        if (propsCorsAccesslist &&
+            propsCorsAccesslist.length > 0 &&
+            propsCorsAccesslist[0] !== null &&
+            propsCorsAccesslist[0] !== '*') {
+            corsOptions.origin = (origin, callback) => {
+                return callback(null, propsCorsAccesslist.indexOf(origin) !== -1);
+            };
+        }
+    }
+    return corsOptions;
+}
+/**
+ * Returns header timeout value from config file or, if not entered, the default value
+ */
+function getHeaderTimeoutConfig() {
+    return environmentManager_js_1.default.get(CONFIG_PARAMS.OPERATIONSAPI_NETWORK_HEADERSTIMEOUT) ?? DEFAULT_HEADERS_TIMEOUT;
+}
+//# sourceMappingURL=operationsServer.js.map

package/dist/server/operationsServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationsServer.js","sourceRoot":"","sources":["../../server/operationsServer.ts"],"names":[],"mappings":"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"}

package/dist/server/serverHelpers/Headers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Fast implementation of standard Headers
+ */
+export declare class Headers extends Map<string, string | string[]> {
+    constructor(init?: Headers | HeadersInit);
+    set(name: any, value: any): this;
+    get(name: any): string;
+    has(name: any): boolean;
+    setIfNone(name: any, value: any): this;
+    append(name: any, value: any, commaDelimited: any): this;
+    [Symbol.iterator](): MapIterator<string | string[]>;
+}
+export declare function appendHeader(headers: any, name: any, value: any, commaDelimited: any): any;
+/**
+ * Merge headers from source into target, ensuring that target is a Headers object, and avoiding any overwrite
+ * of existing headers in target.
+ * @param target
+ * @param source
+ */
+export declare function mergeHeaders(target: any, source: Headers): any;

package/dist/server/serverHelpers/Headers.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Headers = void 0;
+exports.appendHeader = appendHeader;
+exports.mergeHeaders = mergeHeaders;
+/**
+ * Fast implementation of standard Headers
+ */
+class Headers extends Map {
+    constructor(init) {
+        if (init) {
+            if (init[Symbol.iterator]) {
+                super(init);
+            }
+            else {
+                super();
+                for (const name in init)
+                    this.set(name, init[name]);
+            }
+        }
+        else
+            super();
+    }
+    set(name, value) {
+        if (typeof name !== 'string')
+            name = '' + name;
+        if (Array.isArray(value)) {
+            // Ensure all array elements are strings
+            value = value.map((v) => (typeof v === 'string' ? v : '' + v));
+        }
+        else if (typeof value !== 'string') {
+            value = '' + value;
+        }
+        return super.set(name.toLowerCase(), [name, value]);
+    }
+    get(name) {
+        if (typeof name !== 'string')
+            name = '' + name;
+        return super.get(name.toLowerCase())?.[1];
+    }
+    has(name) {
+        if (typeof name !== 'string')
+            name = '' + name;
+        return super.has(name.toLowerCase());
+    }
+    setIfNone(name, value) {
+        if (typeof name !== 'string')
+            name = '' + name;
+        if (typeof value !== 'string')
+            value = '' + value;
+        const lowerName = name.toLowerCase();
+        if (!super.has(lowerName))
+            return super.set(lowerName, [name, value]);
+    }
+    append(name, value, commaDelimited) {
+        if (typeof name !== 'string')
+            name = '' + name;
+        if (typeof value !== 'string')
+            value = '' + value;
+        const lowerName = name.toLowerCase();
+        const existing = super.get(lowerName);
+        if (existing) {
+            const existingValue = existing[1];
+            if (commaDelimited)
+                value = (typeof existingValue === 'string' ? existingValue : existingValue.join(', ')) + ', ' + value;
+            else if (typeof existingValue === 'string')
+                value = [existingValue, value];
+            else {
+                existingValue.push(value);
+                return;
+            }
+        }
+        return super.set(lowerName, [name, value]);
+    }
+    [Symbol.iterator]() {
+        return super.values()[Symbol.iterator]();
+    }
+}
+exports.Headers = Headers;
+function appendHeader(headers, name, value, commaDelimited) {
+    if (headers.append) {
+        headers.append(name, value, commaDelimited);
+    }
+    else if (headers.set) {
+        const existingValue = headers.get(name);
+        if (existingValue) {
+            if (commaDelimited)
+                value = (typeof existingValue === 'string' ? existingValue : existingValue.join(', ')) + ', ' + value;
+            else if (typeof existingValue === 'string')
+                value = [existingValue, value];
+            else {
+                existingValue.push(value);
+                return;
+            }
+        }
+        return headers.set(name, value);
+    }
+    else {
+        headers[name] = (headers[name] ? headers[name] + ', ' : '') + value;
+    }
+}
+/**
+ * Merge headers from source into target, ensuring that target is a Headers object, and avoiding any overwrite
+ * of existing headers in target.
+ * @param target
+ * @param source
+ */
+function mergeHeaders(target, source) {
+    // ensure target is a Headers object, which could be this Headers class, the global.Headers, or even a Map, which is ok
+    if (typeof target.set !== 'function' || typeof target.has !== 'function')
+        target = new Headers(target);
+    for (const [name, value] of source) {
+        if (!target.has(name))
+            target.set(name, value);
+        else if (name.toLowerCase() === 'set-cookie') {
+            // Set-Cookie headers must NEVER be comma-delimited
+            // If value is an array, append each one separately; otherwise append the single value
+            const values = Array.isArray(value) ? value : [value];
+            if (target.append) {
+                for (const v of values)
+                    target.append(name, v);
+            }
+            else {
+                // Fallback for Map or objects without append method
+                // We know existing exists because we're in the else-if branch (target.has(name) is true)
+                const existing = target.get(name);
+                const newValue = Array.isArray(existing) ? [...existing, ...values] : [existing, ...values];
+                target.set(name, newValue);
+            }
+        }
+    }
+    return target;
+}
+//# sourceMappingURL=Headers.js.map

package/dist/server/serverHelpers/Headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headers.js","sourceRoot":"","sources":["../../../server/serverHelpers/Headers.ts"],"names":[],"mappings":"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"}

package/dist/server/serverHelpers/JSONStream.d.ts

@@ -0,0 +1,14 @@
+import { Readable } from 'stream';
+export declare function streamAsJSON(value: any): JSONStream;
+declare class JSONStream extends Readable {
+    constructor(options: any);
+    serialize(object: any): any;
+    _read(): any;
+    push(content: any): any;
+    flush(): any;
+    readIterator(iterator: any): any;
+    _destroy(error: any, callback: any): void;
+}
+export declare function stringify(value: any): any;
+export declare function parse(json: any): any;
+export {};