@plurid/plurid-react-server 0.0.0-1 → 0.0.0-12

package/distribution/data/constants/general/index.d.ts

@@ -1,5 +1,6 @@
 export declare const DEFAULT_SERVER_PORT: number;
 export declare const DEFAULT_SERVER_OPTIONS_SERVER_NAME = "Plurid Server";
+export declare const DEFAULT_SERVER_OPTIONS_HOSTNAME = "origin";
 export declare const DEFAULT_SERVER_OPTIONS_QUIET = false;
 export declare const DEFAULT_SERVER_OPTIONS_COMPRESSION = true;
 export declare const DEFAULT_SERVER_OPTIONS_OPEN = false;
@@ -9,6 +10,7 @@ export declare const DEFAULT_SERVER_OPTIONS_STILLS_DIRECTORY = "stills";
 export declare const DEFAULT_SERVER_OPTIONS_GATEWAY = "/gateway";
 export declare const DEFAULT_SERVER_OPTIONS: {
     SERVER_NAME: string;
+    HOSTNAME: string;
     QUIET: boolean;
     COMPRESSION: boolean;
     OPEN: boolean;

package/distribution/data/constants/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./general/index";
-export * from "./stiller/index";
+export * from './general';
+export * from './stiller';

package/distribution/data/constants/stiller/index.d.ts

@@ -1,2 +1,2 @@
-import { PluridStillerOptions } from "../../interfaces/index";
+import { PluridStillerOptions } from "../../interfaces";
 export declare const defaultStillerOptions: PluridStillerOptions;

package/distribution/data/interfaces/external/index.d.ts

@@ -1,7 +1,6 @@
 import express from 'express';
 import { Helmet } from 'react-helmet-async';
-import { PluridRoute, PluridRoutePlane, PluridPreserve } from '@plurid/plurid-data';
-import { routing } from '@plurid/plurid-engine';
+import { PluridRoute, PluridRoutePlane, PluridPreserve, IsoMatcherRouteResult } from '@plurid/plurid-data';
 import { PluridReactComponent } from '@plurid/plurid-react';
 export declare type PluridServerMiddleware = (request: express.Request, response: express.Response, next: express.NextFunction) => void;
 export declare type ServerRequest = express.Request & {
@@ -12,6 +11,11 @@ export declare type DebugLevels = 'none' | 'error' | 'warn' | 'info';
 export interface PluridServerOptions {
     /** To be used for logging. Default `Plurid Server` */
     serverName: string;
+    /**
+     * The hostname of the server exposed to the internet, e.g. `example.com`,
+     * to be used in plurid plane links.
+     */
+    hostname: string;
     /**
      * To log or not to log to the console.
      */
@@ -70,7 +74,7 @@ export interface PluridServerService<P = any> {
 export interface PluridServerConfiguration {
     routes: PluridRoute<PluridReactComponent>[];
     planes?: PluridRoutePlane<PluridReactComponent>[];
-    preserves: PluridPreserve<routing.IsoMatcherRouteResult<PluridReactComponent<any>> | undefined, express.Request, express.Response>[];
+    preserves: PluridPreserveReact[];
     helmet: Helmet;
     styles?: string[];
     middleware?: PluridServerMiddleware[];
@@ -141,3 +145,7 @@ export interface PluridStillerOptions {
      */
     ignore: string[];
 }
+export declare type PluridPreserveReact = PluridPreserve<IsoMatcherRouteResult<PluridReactComponent<any>> | undefined, express.Request, express.Response>;
+export interface PluridLiveServerOptions {
+    server: string;
+}

package/distribution/data/interfaces/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./external/index";
-export * from "./internal/index";
+export * from './external';
+export * from './internal';

package/distribution/data/interfaces/internal/index.d.ts

@@ -2,7 +2,7 @@ import { Helmet } from 'react-helmet-async';
 import { ServerStyleSheet } from 'styled-components';
 import { Indexed, PluridRoute, PluridRoutePlane, PluridPreserveResponse } from '@plurid/plurid-data';
 import { PluridReactComponent } from '@plurid/plurid-react';
-import { PluridServerService, PluridStillerOptions } from "../external/index";
+import { PluridServerService, PluridStillerOptions } from '../external';
 export interface PluridRendererConfiguration {
     htmlLanguage: string | undefined;
     htmlAttributes: string;
@@ -60,6 +60,7 @@ export interface PluridContentGeneratorData {
     preserveResult: PluridPreserveResponse | undefined;
     matchedPlane: any;
     pathname: string;
+    hostname: string;
 }
 export interface RendererTemplateData {
     htmlLanguage: string;

package/distribution/index.d.ts

@@ -1,5 +1,6 @@
-import PluridServer from "./objects/Server/index";
-import PluridStillsGenerator from "./objects/StillsGenerator/index";
-export * from "./data/interfaces/external/index";
-export { PluridStillsGenerator, };
+import PluridServer from './objects/Server';
+import PluridLiveServer from './objects/LiveServer';
+import PluridStillsGenerator from './objects/StillsGenerator';
+export * from './data/interfaces/external';
+export { PluridLiveServer, PluridStillsGenerator, };
 export default PluridServer;

package/distribution/index.es.js

@@ -18,18 +18,20 @@ import { routing } from "@plurid/plurid-engine";
 
 import { PluridProvider, PluridRouterStatic, serverComputeMetastate } from "@plurid/plurid-react";
 
+import { minify } from "html-minifier";
+
 import React from "react";
 
 import { renderToString } from "react-dom/server";
 
 import { HelmetProvider } from "react-helmet-async";
 
+import http from "http";
+
 import { fork } from "child_process";
 
 import detectPort from "detect-port";
 
-import puppeteer from "puppeteer";
-
 function __awaiter(thisArg, _arguments, P, generator) {
     function adopt(value) {
         return value instanceof P ? value : new P((function(resolve) {
@@ -100,6 +102,8 @@ const DEFAULT_SERVER_PORT = process.env.PORT ? parseInt(process.env.PORT) : 8080
 
 const DEFAULT_SERVER_OPTIONS_SERVER_NAME = "Plurid Server";
 
+const DEFAULT_SERVER_OPTIONS_HOSTNAME = "origin";
+
 const DEFAULT_SERVER_OPTIONS_QUIET = false;
 
 const DEFAULT_SERVER_OPTIONS_COMPRESSION = true;
@@ -116,6 +120,7 @@ const DEFAULT_SERVER_OPTIONS_GATEWAY = "/gateway";
 
 const DEFAULT_SERVER_OPTIONS = {
     SERVER_NAME: DEFAULT_SERVER_OPTIONS_SERVER_NAME,
+    HOSTNAME: DEFAULT_SERVER_OPTIONS_HOSTNAME,
     QUIET: DEFAULT_SERVER_OPTIONS_QUIET,
     COMPRESSION: DEFAULT_SERVER_OPTIONS_COMPRESSION,
     OPEN: DEFAULT_SERVER_OPTIONS_OPEN,
@@ -154,7 +159,9 @@ const defaultStillerOptions = {
     ignore: []
 };
 
-const cleanTemplate = template => template.replace(/(?:\r\n|\r|\n)/g, " ").replace(/  +/g, " ").trim();
+const cleanTemplate = template => minify(template, {
+    collapseWhitespace: true
+});
 
 const resolveBackgroundStyle = store => {
     var _a;
@@ -279,7 +286,7 @@ class PluridContentGenerator {
                 console.log("Plurid Server Error :: Providers not loaded");
                 return "";
             }
-            const {pluridMetastate: pluridMetastate, routes: routes, planes: planes, exterior: exterior, shell: shell, gateway: gateway, gatewayEndpoint: gatewayEndpoint, gatewayQuery: gatewayQuery, helmet: helmet, services: services, stylesheet: stylesheet, preserveResult: preserveResult, matchedPlane: matchedPlane, pathname: pathname} = this.data;
+            const {pluridMetastate: pluridMetastate, routes: routes, planes: planes, exterior: exterior, shell: shell, gateway: gateway, gatewayEndpoint: gatewayEndpoint, gatewayQuery: gatewayQuery, helmet: helmet, services: services, stylesheet: stylesheet, preserveResult: preserveResult, matchedPlane: matchedPlane, pathname: pathname, hostname: hostname} = this.data;
             const RoutedApplication = () => React.createElement(PluridProvider, {
                 metastate: pluridMetastate
             }, React.createElement(PluridRouterStatic, {
@@ -291,7 +298,8 @@ class PluridContentGenerator {
                 shell: shell,
                 gateway: gateway,
                 gatewayEndpoint: gatewayEndpoint,
-                gatewayQuery: gatewayQuery
+                gatewayQuery: gatewayQuery,
+                hostname: hostname
             }));
             let Wrap = wrapping(HelmetProvider, RoutedApplication, {
                 context: helmet
@@ -364,7 +372,7 @@ class PluridServer {
         this.isoMatcher = new PluridIsoMatcher({
             routes: this.routes,
             routePlanes: this.planes
-        });
+        }, this.options.hostname);
         this.configureServer();
         this.handleEndpoints();
         process.addListener("SIGINT", (() => {
@@ -440,8 +448,7 @@ class PluridServer {
                 if (this.debugAllows("info")) {
                     console.info(`[${time.stamp()} :: ${requestID}] (000 Start) Handling GET ${request.path}`);
                 }
-                const path = request.originalUrl;
-                const ignorable = this.ignoreGetRequest(path);
+                const ignorable = this.ignoreGetRequest(request.path);
                 if (ignorable) {
                     if (this.debugAllows("info")) {
                         const requestTime = this.computeRequestTime(request);
@@ -458,7 +465,7 @@ class PluridServer {
                     }
                     return;
                 }
-                const {externalRedirect: externalRedirect, matchingPath: matchingPath} = this.resolveMatchingPath(preserveResult, path);
+                const {externalRedirect: externalRedirect, matchingPath: matchingPath} = this.resolveMatchingPath(preserveResult, request.originalUrl);
                 if (externalRedirect) {
                     if (this.debugAllows("info")) {
                         const requestTime = this.computeRequestTime(request);
@@ -725,8 +732,9 @@ class PluridServer {
     renderApplication(isoMatch, preserveResult, matchedPlane) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
         return __awaiter(this, void 0, void 0, (function*() {
+            const globals = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.globals;
             const mergedHtmlLanguage = ((_a = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _a === void 0 ? void 0 : _a.htmlLanguage) || ((_b = this.template) === null || _b === void 0 ? void 0 : _b.htmlLanguage);
-            const pluridMetastate = serverComputeMetastate(isoMatch, this.routes);
+            const pluridMetastate = yield serverComputeMetastate(isoMatch, this.routes, globals);
             const {content: content, styles: styles} = yield this.getContentAndStyles(isoMatch, pluridMetastate, preserveResult, matchedPlane);
             const stringedStyles = this.styles.reduce(((accumulator, style) => accumulator + style), "");
             const preserveStyles = ((_d = (_c = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _c === void 0 ? void 0 : _c.styles) === null || _d === void 0 ? void 0 : _d.join(" ")) || "";
@@ -742,7 +750,6 @@ class PluridServer {
             const mergedHeadScripts = [ ...headScripts, ...((_j = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _j === void 0 ? void 0 : _j.headScripts) || [] ];
             const bodyScripts = ((_k = this.template) === null || _k === void 0 ? void 0 : _k.bodyScripts) || [];
             const mergedBodyScripts = [ ...bodyScripts, ...((_l = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _l === void 0 ? void 0 : _l.bodyScripts) || [] ];
-            const globals = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.globals;
             const renderer = new PluridRenderer({
                 htmlLanguage: mergedHtmlLanguage,
                 head: head,
@@ -785,7 +792,8 @@ class PluridServer {
                     gatewayEndpoint: gatewayEndpoint,
                     gatewayQuery: gatewayQuery,
                     preserveResult: preserveResult,
-                    pathname: isoMatch.kind === "Route" ? isoMatch.data.value : isoMatch.match.value,
+                    pathname: isoMatch.match.value,
+                    hostname: this.options.hostname,
                     matchedPlane: isoMatch.kind === "RoutePlane" ? {
                         value: isoMatch.match.value
                     } : undefined
@@ -825,6 +833,7 @@ class PluridServer {
         var _a, _b;
         const options = {
             serverName: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.serverName) || DEFAULT_SERVER_OPTIONS.SERVER_NAME,
+            hostname: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.hostname) || DEFAULT_SERVER_OPTIONS.HOSTNAME,
             quiet: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.quiet) || DEFAULT_SERVER_OPTIONS.QUIET,
             debug: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.debug) ? partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.debug : environment.production ? "error" : "info",
             compression: (_a = partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.compression) !== null && _a !== void 0 ? _a : DEFAULT_SERVER_OPTIONS.COMPRESSION,
@@ -916,6 +925,37 @@ class PluridServer {
     }
 }
 
+class LiveServer {
+    constructor(options) {
+        this.sockets = [];
+        this.resolveOptions = options => {
+            const defaultServerPath = "./source/server/index.ts";
+            const resolvedOptions = {
+                server: (options === null || options === void 0 ? void 0 : options.server) || defaultServerPath
+            };
+            return resolvedOptions;
+        };
+        this.options = this.resolveOptions(options);
+        this.expressServer = express();
+        this.setupExpressServer();
+        this.httpServer = http.createServer(this.expressServer);
+        this.setupHttpServer();
+    }
+    setupExpressServer() {}
+    setupHttpServer() {
+        this.httpServer.on("connection", (socket => {
+            this.sockets.push(socket);
+            socket.once("close", (() => {
+                this.sockets.splice(this.sockets.indexOf(socket), 1);
+            }));
+        }));
+        this.httpServer.on("error", (error => {
+            throw error;
+        }));
+    }
+    start() {}
+}
+
 const replacePluridResolution = html => {
     const normalResolution = "width: 1366px; height: 768px;";
     const zeroResolution = "width: 0px; height: 0px;";
@@ -924,7 +964,7 @@ const replacePluridResolution = html => {
 
 const isCurrentUserRoot = () => process.getuid() == 0;
 
-const render = (host, route, configuration) => __awaiter(void 0, void 0, void 0, (function*() {
+const render = (puppeteer, host, route, configuration) => __awaiter(void 0, void 0, void 0, (function*() {
     const start = Date.now();
     const browser = yield puppeteer.launch({
         defaultViewport: {
@@ -958,6 +998,11 @@ const render = (host, route, configuration) => __awaiter(void 0, void 0, void 0,
 
 class Stiller {
     constructor(options) {
+        try {
+            this.puppeteer = require("puppeteer");
+        } catch (error) {
+            console.error("could not load puppeteer: check puppeteer is installed");
+        }
         const {host: host, routes: routes, configuration: configuration} = options;
         this.host = host;
         this.routes = routes;
@@ -966,7 +1011,7 @@ class Stiller {
     still() {
         return __asyncGenerator(this, arguments, (function* still_1() {
             for (const route of this.routes) {
-                yield yield __await(yield __await(render(this.host, route, this.configuration)));
+                yield yield __await(yield __await(render(this.puppeteer, this.host, route, this.configuration)));
             }
         }));
     }
@@ -1063,6 +1108,4 @@ class StillsGenerator {
     }
 }
 
-export default PluridServer;
-
-export { StillsGenerator as PluridStillsGenerator };
+export { LiveServer as PluridLiveServer, StillsGenerator as PluridStillsGenerator, PluridServer as default };

package/distribution/index.js

@@ -24,18 +24,20 @@ var pluridEngine = require("@plurid/plurid-engine");
 
 var pluridReact = require("@plurid/plurid-react");
 
+var htmlMinifier = require("html-minifier");
+
 var React = require("react");
 
 var server = require("react-dom/server");
 
 var reactHelmetAsync = require("react-helmet-async");
 
+var http = require("http");
+
 var child_process = require("child_process");
 
 var detectPort = require("detect-port");
 
-var puppeteer = require("puppeteer");
-
 function _interopDefaultLegacy(e) {
     return e && typeof e === "object" && "default" in e ? e : {
         default: e
@@ -74,9 +76,9 @@ var open__default = _interopDefaultLegacy(open);
 
 var React__default = _interopDefaultLegacy(React);
 
-var detectPort__default = _interopDefaultLegacy(detectPort);
+var http__default = _interopDefaultLegacy(http);
 
-var puppeteer__default = _interopDefaultLegacy(puppeteer);
+var detectPort__default = _interopDefaultLegacy(detectPort);
 
 function __awaiter(thisArg, _arguments, P, generator) {
     function adopt(value) {
@@ -148,6 +150,8 @@ const DEFAULT_SERVER_PORT = process.env.PORT ? parseInt(process.env.PORT) : 8080
 
 const DEFAULT_SERVER_OPTIONS_SERVER_NAME = "Plurid Server";
 
+const DEFAULT_SERVER_OPTIONS_HOSTNAME = "origin";
+
 const DEFAULT_SERVER_OPTIONS_QUIET = false;
 
 const DEFAULT_SERVER_OPTIONS_COMPRESSION = true;
@@ -164,6 +168,7 @@ const DEFAULT_SERVER_OPTIONS_GATEWAY = "/gateway";
 
 const DEFAULT_SERVER_OPTIONS = {
     SERVER_NAME: DEFAULT_SERVER_OPTIONS_SERVER_NAME,
+    HOSTNAME: DEFAULT_SERVER_OPTIONS_HOSTNAME,
     QUIET: DEFAULT_SERVER_OPTIONS_QUIET,
     COMPRESSION: DEFAULT_SERVER_OPTIONS_COMPRESSION,
     OPEN: DEFAULT_SERVER_OPTIONS_OPEN,
@@ -202,7 +207,9 @@ const defaultStillerOptions = {
     ignore: []
 };
 
-const cleanTemplate = template => template.replace(/(?:\r\n|\r|\n)/g, " ").replace(/  +/g, " ").trim();
+const cleanTemplate = template => htmlMinifier.minify(template, {
+    collapseWhitespace: true
+});
 
 const resolveBackgroundStyle = store => {
     var _a;
@@ -327,7 +334,7 @@ class PluridContentGenerator {
                 console.log("Plurid Server Error :: Providers not loaded");
                 return "";
             }
-            const {pluridMetastate: pluridMetastate, routes: routes, planes: planes, exterior: exterior, shell: shell, gateway: gateway, gatewayEndpoint: gatewayEndpoint, gatewayQuery: gatewayQuery, helmet: helmet, services: services, stylesheet: stylesheet, preserveResult: preserveResult, matchedPlane: matchedPlane, pathname: pathname} = this.data;
+            const {pluridMetastate: pluridMetastate, routes: routes, planes: planes, exterior: exterior, shell: shell, gateway: gateway, gatewayEndpoint: gatewayEndpoint, gatewayQuery: gatewayQuery, helmet: helmet, services: services, stylesheet: stylesheet, preserveResult: preserveResult, matchedPlane: matchedPlane, pathname: pathname, hostname: hostname} = this.data;
             const RoutedApplication = () => React__default["default"].createElement(pluridReact.PluridProvider, {
                 metastate: pluridMetastate
             }, React__default["default"].createElement(pluridReact.PluridRouterStatic, {
@@ -339,7 +346,8 @@ class PluridContentGenerator {
                 shell: shell,
                 gateway: gateway,
                 gatewayEndpoint: gatewayEndpoint,
-                gatewayQuery: gatewayQuery
+                gatewayQuery: gatewayQuery,
+                hostname: hostname
             }));
             let Wrap = wrapping(reactHelmetAsync.HelmetProvider, RoutedApplication, {
                 context: helmet
@@ -359,9 +367,11 @@ class PluridContentGenerator {
             const providers = {};
             for (const service of this.data.services) {
                 try {
-                    const importedService = yield Promise.resolve().then((function() {
-                        return _interopNamespace(require(service.package));
-                    }));
+                    const importedService = yield function(t) {
+                        return Promise.resolve().then((function() {
+                            return _interopNamespace(require(t));
+                        }));
+                    }(service.package);
                     const ImportedServiceProvider = service.provider === "default" ? importedService : importedService[service.provider];
                     providers[service.name] = ImportedServiceProvider;
                 } catch (error) {
@@ -414,7 +424,7 @@ class PluridServer {
         this.isoMatcher = new PluridIsoMatcher({
             routes: this.routes,
             routePlanes: this.planes
-        });
+        }, this.options.hostname);
         this.configureServer();
         this.handleEndpoints();
         process.addListener("SIGINT", (() => {
@@ -490,8 +500,7 @@ class PluridServer {
                 if (this.debugAllows("info")) {
                     console.info(`[${pluridFunctions.time.stamp()} :: ${requestID}] (000 Start) Handling GET ${request.path}`);
                 }
-                const path = request.originalUrl;
-                const ignorable = this.ignoreGetRequest(path);
+                const ignorable = this.ignoreGetRequest(request.path);
                 if (ignorable) {
                     if (this.debugAllows("info")) {
                         const requestTime = this.computeRequestTime(request);
@@ -508,7 +517,7 @@ class PluridServer {
                     }
                     return;
                 }
-                const {externalRedirect: externalRedirect, matchingPath: matchingPath} = this.resolveMatchingPath(preserveResult, path);
+                const {externalRedirect: externalRedirect, matchingPath: matchingPath} = this.resolveMatchingPath(preserveResult, request.originalUrl);
                 if (externalRedirect) {
                     if (this.debugAllows("info")) {
                         const requestTime = this.computeRequestTime(request);
@@ -775,8 +784,9 @@ class PluridServer {
     renderApplication(isoMatch, preserveResult, matchedPlane) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
         return __awaiter(this, void 0, void 0, (function*() {
+            const globals = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.globals;
             const mergedHtmlLanguage = ((_a = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _a === void 0 ? void 0 : _a.htmlLanguage) || ((_b = this.template) === null || _b === void 0 ? void 0 : _b.htmlLanguage);
-            const pluridMetastate = pluridReact.serverComputeMetastate(isoMatch, this.routes);
+            const pluridMetastate = yield pluridReact.serverComputeMetastate(isoMatch, this.routes, globals);
             const {content: content, styles: styles} = yield this.getContentAndStyles(isoMatch, pluridMetastate, preserveResult, matchedPlane);
             const stringedStyles = this.styles.reduce(((accumulator, style) => accumulator + style), "");
             const preserveStyles = ((_d = (_c = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _c === void 0 ? void 0 : _c.styles) === null || _d === void 0 ? void 0 : _d.join(" ")) || "";
@@ -792,7 +802,6 @@ class PluridServer {
             const mergedHeadScripts = [ ...headScripts, ...((_j = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _j === void 0 ? void 0 : _j.headScripts) || [] ];
             const bodyScripts = ((_k = this.template) === null || _k === void 0 ? void 0 : _k.bodyScripts) || [];
             const mergedBodyScripts = [ ...bodyScripts, ...((_l = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.template) === null || _l === void 0 ? void 0 : _l.bodyScripts) || [] ];
-            const globals = preserveResult === null || preserveResult === void 0 ? void 0 : preserveResult.globals;
             const renderer = new PluridRenderer({
                 htmlLanguage: mergedHtmlLanguage,
                 head: head,
@@ -835,7 +844,8 @@ class PluridServer {
                     gatewayEndpoint: gatewayEndpoint,
                     gatewayQuery: gatewayQuery,
                     preserveResult: preserveResult,
-                    pathname: isoMatch.kind === "Route" ? isoMatch.data.value : isoMatch.match.value,
+                    pathname: isoMatch.match.value,
+                    hostname: this.options.hostname,
                     matchedPlane: isoMatch.kind === "RoutePlane" ? {
                         value: isoMatch.match.value
                     } : undefined
@@ -875,6 +885,7 @@ class PluridServer {
         var _a, _b;
         const options = {
             serverName: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.serverName) || DEFAULT_SERVER_OPTIONS.SERVER_NAME,
+            hostname: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.hostname) || DEFAULT_SERVER_OPTIONS.HOSTNAME,
             quiet: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.quiet) || DEFAULT_SERVER_OPTIONS.QUIET,
             debug: (partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.debug) ? partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.debug : environment.production ? "error" : "info",
             compression: (_a = partialOptions === null || partialOptions === void 0 ? void 0 : partialOptions.compression) !== null && _a !== void 0 ? _a : DEFAULT_SERVER_OPTIONS.COMPRESSION,
@@ -966,6 +977,37 @@ class PluridServer {
     }
 }
 
+class LiveServer {
+    constructor(options) {
+        this.sockets = [];
+        this.resolveOptions = options => {
+            const defaultServerPath = "./source/server/index.ts";
+            const resolvedOptions = {
+                server: (options === null || options === void 0 ? void 0 : options.server) || defaultServerPath
+            };
+            return resolvedOptions;
+        };
+        this.options = this.resolveOptions(options);
+        this.expressServer = express__default["default"]();
+        this.setupExpressServer();
+        this.httpServer = http__default["default"].createServer(this.expressServer);
+        this.setupHttpServer();
+    }
+    setupExpressServer() {}
+    setupHttpServer() {
+        this.httpServer.on("connection", (socket => {
+            this.sockets.push(socket);
+            socket.once("close", (() => {
+                this.sockets.splice(this.sockets.indexOf(socket), 1);
+            }));
+        }));
+        this.httpServer.on("error", (error => {
+            throw error;
+        }));
+    }
+    start() {}
+}
+
 const replacePluridResolution = html => {
     const normalResolution = "width: 1366px; height: 768px;";
     const zeroResolution = "width: 0px; height: 0px;";
@@ -974,9 +1016,9 @@ const replacePluridResolution = html => {
 
 const isCurrentUserRoot = () => process.getuid() == 0;
 
-const render = (host, route, configuration) => __awaiter(void 0, void 0, void 0, (function*() {
+const render = (puppeteer, host, route, configuration) => __awaiter(void 0, void 0, void 0, (function*() {
     const start = Date.now();
-    const browser = yield puppeteer__default["default"].launch({
+    const browser = yield puppeteer.launch({
         defaultViewport: {
             width: 1366,
             height: 768
@@ -1008,6 +1050,11 @@ const render = (host, route, configuration) => __awaiter(void 0, void 0, void 0,
 
 class Stiller {
     constructor(options) {
+        try {
+            this.puppeteer = require("puppeteer");
+        } catch (error) {
+            console.error("could not load puppeteer: check puppeteer is installed");
+        }
         const {host: host, routes: routes, configuration: configuration} = options;
         this.host = host;
         this.routes = routes;
@@ -1016,7 +1063,7 @@ class Stiller {
     still() {
         return __asyncGenerator(this, arguments, (function* still_1() {
             for (const route of this.routes) {
-                yield yield __await(yield __await(render(this.host, route, this.configuration)));
+                yield yield __await(yield __await(render(this.puppeteer, this.host, route, this.configuration)));
             }
         }));
     }
@@ -1113,6 +1160,8 @@ class StillsGenerator {
     }
 }
 
+exports.PluridLiveServer = LiveServer;
+
 exports.PluridStillsGenerator = StillsGenerator;
 
-exports.default = PluridServer;
+exports["default"] = PluridServer;

package/distribution/objects/ContentGenerator/index.d.ts

@@ -1,4 +1,4 @@
-import { PluridContentGeneratorData } from "../../data/interfaces/index";
+import { PluridContentGeneratorData } from "../../data/interfaces";
 declare class PluridContentGenerator {
     private data;
     private providers;

package/distribution/objects/LiveServer/index.d.ts

@@ -0,0 +1,13 @@
+import { PluridLiveServerOptions } from "../../data/interfaces";
+declare class LiveServer {
+    private options;
+    private expressServer;
+    private httpServer;
+    private sockets;
+    constructor(options?: Partial<PluridLiveServerOptions>);
+    private resolveOptions;
+    private setupExpressServer;
+    private setupHttpServer;
+    start(): void;
+}
+export default LiveServer;

package/distribution/objects/Renderer/index.d.ts

@@ -1,4 +1,4 @@
-import { PluridRendererConfiguration } from "../../data/interfaces/index";
+import { PluridRendererConfiguration } from "../../data/interfaces";
 declare class PluridRenderer {
     private htmlLanguage;
     private head;

package/distribution/objects/Renderer/template/index.d.ts

@@ -1,3 +1,3 @@
-import { RendererTemplateData } from "../../../data/interfaces/index";
+import { RendererTemplateData } from "../../../data/interfaces";
 declare const template: (data: RendererTemplateData) => string;
 export default template;

package/distribution/objects/Server/index.d.ts

@@ -3,7 +3,7 @@ import { Server } from 'http';
 import express from 'express';
 import { PluridRoute } from '@plurid/plurid-data';
 import { PluridReactComponent } from '@plurid/plurid-react';
-import { PluridServerOptions, PluridServerConfiguration } from "../../data/interfaces/index";
+import { PluridServerOptions, PluridServerConfiguration } from "../../data/interfaces";
 declare class PluridServer {
     private routes;
     private planes;
@@ -25,7 +25,7 @@ declare class PluridServer {
     private isoMatcher;
     constructor(configuration: PluridServerConfiguration);
     static analysis(pluridServer: PluridServer): {
-        routes: PluridRoute<PluridReactComponent<any>>[];
+        routes: PluridRoute<PluridReactComponent<any, import("@plurid/plurid-data").PluridPlaneComponentProperty | import("@plurid/plurid-data").PluridRouteComponentProperty>, any>[];
         options: PluridServerOptions;
     };
     start(port?: string | number): Server;

package/distribution/objects/Stiller/index.d.ts

@@ -1,4 +1,4 @@
-import { StillerOptions } from "../../data/interfaces/index";
+import { StillerOptions } from "../../data/interfaces";
 /**
  * The Server will parse the given application routes,
  * and will decide which ones to send to the Stiller.
@@ -10,6 +10,7 @@ import { StillerOptions } from "../../data/interfaces/index";
  * to serve the adequate plurid space structure when asked for the given route.
  */
 declare class Stiller {
+    private puppeteer;
     private host;
     private routes;
     private configuration;

package/distribution/objects/StillsGenerator/index.d.ts

@@ -1,4 +1,4 @@
-import { StillsGeneratorOptions } from "../../data/interfaces/index";
+import { StillsGeneratorOptions } from "../../data/interfaces";
 declare class StillsGenerator {
     private options;
     constructor(options?: Partial<StillsGeneratorOptions>);

package/distribution/objects/StillsManager/index.d.ts

@@ -1,4 +1,4 @@
-import { PluridServerOptions } from "../../data/interfaces/index";
+import { PluridServerOptions } from "../../data/interfaces";
 declare class StillsManager {
     private options;
     private stills;

package/distribution/utilities/pttp/index.d.ts

@@ -1,6 +1,6 @@
-import { routing } from '@plurid/plurid-engine';
+import { IsoMatcherPlaneResult } from '@plurid/plurid-data';
 import { PluridReactComponent } from '@plurid/plurid-react';
-export declare const resolveElementFromPlaneMatch: (planeMatch: routing.IsoMatcherPlaneResult<PluridReactComponent<any>>, elementqlEndpoint: string | undefined) => {
+export declare const resolveElementFromPlaneMatch: (planeMatch: IsoMatcherPlaneResult<PluridReactComponent<any>>, elementqlEndpoint: string | undefined) => {
     name: string;
     url: string | undefined;
 } | undefined;

package/distribution/utilities/wrapping/index.d.ts

@@ -2,12 +2,10 @@ import React from 'react';
 declare const wrapping: (WrappedComponent: any, WrappeeComponent: any, properties: any) => {
     new (props: any): {
         render(): JSX.Element;
-        context: any;
+        context: unknown;
         setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<{}>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
         forceUpdate(callback?: (() => void) | undefined): void;
-        readonly props: Readonly<{}> & Readonly<{
-            children?: React.ReactNode;
-        }>;
+        readonly props: Readonly<{}>;
         state: Readonly<{}>;
         refs: {
             [key: string]: React.ReactInstance;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurid/plurid-react-server",
-    "version": "0.0.0-1",
+    "version": "0.0.0-12",
     "description": "React implementation of Plurid to view and explore the web in three dimensions with server-side rendering",
     "keywords": [
         "plurid",
@@ -39,12 +39,12 @@
         "clean": "rm -rf ./distribution",
         "test": "jest ./source --config ./configurations/jest.config.js --rootDir ./",
         "lint": "eslint -c ./configurations/.eslintrc.js ./source --ext .ts,.tsx",
-        "start": "yarn clean && rollup -c ./scripts/rollup.development.js -w --environment ENV_MODE:local",
-        "build.development": "yarn clean && rollup -c ./scripts/rollup.config.js --environment ENV_MODE:development",
-        "build.production": "yarn clean && rollup -c ./scripts/rollup.config.js --environment ENV_MODE:production",
-        "build": "yarn clean && yarn lint && yarn test && yarn build.production",
+        "start": "pnpm clean && rollup -c ./scripts/rollup.development.js -w --environment ENV_MODE:local",
+        "build.development": "pnpm clean && rollup -c ./scripts/rollup.config.js --environment ENV_MODE:development",
+        "build.production": "pnpm clean && rollup -c ./scripts/rollup.config.js --environment ENV_MODE:production",
+        "build": "pnpm clean && pnpm lint && pnpm test && pnpm build.production",
         "esbuild": "esbuild source/index.ts --bundle --platform=node --outfile=distribution/index.js --external:react",
-        "prepublishOnly": "yarn build"
+        "prepublishOnly": "pnpm build"
     },
     "peerDependencies": {
         "@plurid/elementql": "*",
@@ -60,7 +60,6 @@
         "@plurid/plurid-ui-components-react": "*",
         "@plurid/plurid-ui-state-react": "*",
         "cross-fetch": ">=3.1",
-        "puppeteer": ">=2.1",
         "react": ">=16.8",
         "react-dom": ">=16.8",
         "react-helmet-async": ">=1",
@@ -69,66 +68,68 @@
         "styled-components": ">=5"
     },
     "dependencies": {
-        "body-parser": "^1.19.0",
+        "body-parser": "^1.20.0",
         "compression": "^1.7.4",
         "detect-port": "^1.3.0",
-        "express": "^4.17.1",
-        "open": "^8.0.8"
+        "express": "^4.18.1",
+        "html-minifier": "^4.0.0",
+        "open": "^8.4.0"
     },
     "devDependencies": {
-        "@apollo/client": "^3.3.18",
-        "@babel/core": "^7.14.2",
+        "@apollo/client": "^3.6.9",
+        "@babel/core": "^7.18.10",
         "@plurid/elementql": "^0.0.0-1",
         "@plurid/elementql-client-react": "^0.0.0-1",
-        "@plurid/plurid-data": "0.0.0-3",
-        "@plurid/plurid-engine": "0.0.0-2",
-        "@plurid/plurid-functions": "0.0.0-3",
-        "@plurid/plurid-functions-react": "0.0.0-1",
-        "@plurid/plurid-icons-react": "0.0.0-0",
-        "@plurid/plurid-pubsub": "0.0.0-4",
-        "@plurid/plurid-react": "0.0.0-3",
-        "@plurid/plurid-themes": "0.0.0-0",
-        "@plurid/plurid-ui-components-react": "0.0.0-1",
-        "@plurid/plurid-ui-state-react": "0.0.0-0",
-        "@rollup/plugin-node-resolve": "^13.0.0",
-        "@types/body-parser": "^1.19.0",
-        "@types/compression": "^1.7.0",
-        "@types/detect-port": "^1.3.0",
-        "@types/express": "^4.17.11",
-        "@types/hammerjs": "^2.0.39",
-        "@types/jest": "^26.0.23",
-        "@types/puppeteer": "^5.4.3",
-        "@types/react": "^17.0.5",
-        "@types/react-dom": "^17.0.5",
-        "@types/react-redux": "^7.1.16",
-        "@types/react-stripe-elements": "^6.0.4",
-        "@types/styled-components": "^5.1.9",
-        "@typescript-eslint/eslint-plugin": "^4.23.0",
-        "@typescript-eslint/parser": "^4.23.0",
+        "@plurid/plurid-data": "0.0.0-15",
+        "@plurid/plurid-engine": "0.0.0-14",
+        "@plurid/plurid-functions": "0.0.0-28",
+        "@plurid/plurid-functions-react": "0.0.0-5",
+        "@plurid/plurid-icons-react": "0.0.0-5",
+        "@plurid/plurid-pubsub": "0.0.0-7",
+        "@plurid/plurid-react": "0.0.0-24",
+        "@plurid/plurid-themes": "0.0.0-2",
+        "@plurid/plurid-ui-components-react": "0.0.0-15",
+        "@plurid/plurid-ui-state-react": "0.0.0-6",
+        "@redux-devtools/extension": "^3.2.3",
+        "@rollup/plugin-node-resolve": "^13.3.0",
+        "@types/body-parser": "^1.19.2",
+        "@types/compression": "^1.7.2",
+        "@types/detect-port": "^1.3.2",
+        "@types/express": "^4.17.13",
+        "@types/hammerjs": "^2.0.41",
+        "@types/html-minifier": "^4.0.2",
+        "@types/jest": "^28.1.6",
+        "@types/node": "^18.7.4",
+        "@types/react": "^18.0.17",
+        "@types/react-dom": "^18.0.6",
+        "@types/react-redux": "^7.1.24",
+        "@types/react-stripe-elements": "^6.0.6",
+        "@types/styled-components": "^5.1.26",
+        "@typescript-eslint/eslint-plugin": "^5.33.0",
+        "@typescript-eslint/parser": "^5.33.0",
         "@zerollup/ts-transform-paths": "^1.7.18",
-        "cross-fetch": "^3.1.4",
-        "eslint": "^7.26.0",
-        "graphql": "^15.5.0",
+        "cross-fetch": "^3.1.5",
+        "eslint": "^8.22.0",
+        "graphql": "^16.5.0",
         "hammerjs": "^2.0.8",
-        "jest": "^26.6.3",
-        "jest-config": "^26.6.3",
-        "puppeteer": "^9.1.1",
-        "react": "^17.0.2",
-        "react-dom": "^17.0.2",
-        "react-helmet-async": "^1.0.9",
-        "react-redux": "^7.2.4",
-        "redux": "^4.1.0",
-        "redux-devtools-extension": "^2.13.9",
-        "redux-thunk": "^2.3.0",
-        "rollup": "^2.47.0",
+        "jest": "^28.1.3",
+        "jest-config": "^28.1.3",
+        "react": "^18.2.0",
+        "react-dom": "^18.2.0",
+        "react-helmet-async": "^1.3.0",
+        "react-redux": "^8.0.2",
+        "redux": "^4.2.0",
+        "redux-thunk": "^2.4.1",
+        "rollup": "^2.78.0",
         "rollup-plugin-peer-deps-external": "^2.2.4",
         "rollup-plugin-terser": "^7.0.2",
-        "rollup-plugin-typescript2": "^0.30.0",
-        "styled-components": "^5.3.0",
-        "ts-jest": "^26.5.6",
-        "ts-node": "^9.1.1",
-        "ttypescript": "^1.5.12",
-        "typescript": "^4.2.4",
-        "typescript-transform-paths": "^2.2.3"
+        "rollup-plugin-typescript2": "^0.32.1",
+        "styled-components": "^5.3.5",
+        "ts-jest": "^28.0.8",
+        "ts-node": "^10.9.1",
+        "tslib": "^2.4.0",
+        "ttypescript": "^1.5.13",
+        "typescript": "^4.7.4",
+        "typescript-transform-paths": "^3.3.1"
     }
 }