npm - mastercontroller - Versions diffs - 1.3.8 → 1.3.10 - Mend

mastercontroller 1.3.8 → 1.3.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/.claude/settings.local.json +4 -1
package/FIXES_APPLIED.md +378 -0
package/MasterAction.js +10 -263
package/MasterControl.js +128 -27
package/MasterRequest.js +6 -0
package/MasterRouter.js +27 -32
package/PERFORMANCE_SECURITY_AUDIT.md +677 -0
package/README.md +117 -43
package/monitoring/README.md +3112 -0
package/package.json +1 -1
package/security/README.md +1805 -0
package/test-raw-body-preservation.js +128 -0
package/MasterCors.js.tmp +0 -0
package/MasterHtml.js +0 -649
package/MasterPipeline.js.tmp +0 -0
package/MasterRequest.js.tmp +0 -0
package/MasterRouter.js.tmp +0 -0
package/MasterSocket.js.tmp +0 -0
package/MasterTemp.js.tmp +0 -0
package/MasterTemplate.js +0 -230
package/MasterTimeout.js.tmp +0 -0
package/TemplateOverwrite.js +0 -41
package/TemplateOverwrite.js.tmp +0 -0
package/ssr/hydration-client.js +0 -93
package/ssr/runtime-ssr.cjs +0 -553
package/ssr/ssr-shims.js +0 -73

package/README.md CHANGED Viewed

@@ -444,6 +444,60 @@ class UsersController {
 ## Views and Templates
+MasterController v1.3+ uses a **pluggable view architecture**, allowing you to choose any template engine (MasterView, EJS, Pug, React SSR, etc.) or build your own adapter.
+### Quick Start with MasterView
+MasterView is the official view engine with built-in SSR support:
+```bash
+npm install masterview
+```
+```javascript
+// config/initializers/config.js
+const master = require('mastercontroller');
+const MasterView = require('masterview');
+// Register view engine
+master.useView(MasterView, {
+    ssr: true,  // Enable server-side rendering
+    layoutPath: 'app/views/layouts/master.html'
+});
+// Rest of your config...
+master.startMVC('config');
+```
+### Controller Usage (Same for All View Engines)
+```javascript
+class HomeController {
+    index(obj) {
+        // Render view with layout
+        this.returnView({
+            title: 'Home',
+            message: 'Welcome!'
+        });
+    }
+    partial(obj) {
+        // Render partial (no layout)
+        this.returnPartialView('shared/header', { user: 'John' });
+    }
+    raw(obj) {
+        // Render raw HTML file
+        this.returnViewWithoutEngine('static/page.html');
+    }
+    api(obj) {
+        // Return JSON (works with any view engine)
+        this.returnJson({ status: 'ok', data: [] });
+    }
+}
+```
 ### View Structure
 ```
@@ -451,50 +505,81 @@ app/
   views/
     layouts/
       master.html          # Main layout
+    home/
+      index.html           # Home index view
+      about.html           # Home about view
     users/
       index.html           # Users index view
       show.html            # Users show view
 ```
-### Layout (master.html)
+### Alternative View Engines
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <title>{{title}}</title>
-</head>
-<body>
-    <header>
-        <h1>My App</h1>
-    </header>
+#### Using EJS
-    <main>
-        {{body}}  <!-- View content inserted here -->
-    </main>
+```bash
+npm install ejs
+```
-    <footer>
-        &copy; 2025
-    </footer>
-</body>
-</html>
+```javascript
+const EJSView = {
+    register(master) {
+        master.controllerList.returnView = async function(data, location) {
+            const html = await ejs.renderFile(viewPath, data);
+            this.__response.end(html);
+        };
+    }
+};
+master.useView(EJSView);
 ```
-### View (users/index.html)
+See [MasterView Examples](https://github.com/yourorg/masterview/tree/master/examples) for EJS, Pug, and React SSR adapters.
-```html
-<h2>{{title}}</h2>
+#### Using Pug
+```bash
+npm install pug
+```
+```javascript
+const PugView = {
+    register(master) {
+        master.controllerList.returnView = function(data, location) {
+            const html = pug.renderFile(viewPath, data);
+            this.__response.end(html);
+        };
+    }
+};
+master.useView(PugView);
+```
+#### Using React SSR
+```bash
+npm install react react-dom
+```
+```javascript
+const ReactSSRView = {
+    register(master) {
+        master.controllerList.returnView = function(data, location) {
+            const Component = require(componentPath);
+            const html = ReactDOMServer.renderToString(
+                React.createElement(Component, data)
+            );
+            this.__response.end(wrapInHTML(html, data));
+        };
+    }
+};
-<ul>
-{{#each users}}
-    <li>{{this}}</li>
-{{/each}}
-</ul>
+master.useView(ReactSSRView);
 ```
-### Template Syntax
+### MasterView Template Syntax
-MasterController uses Handlebars-style templates:
+MasterView uses `{{...}}` syntax similar to Handlebars:
 ```html
 <!-- Variables -->
@@ -504,22 +589,11 @@ MasterController uses Handlebars-style templates:
 <!-- HTML escaping (automatic) -->
 {{description}}
-<!-- Conditionals -->
-{{#if isAdmin}}
-    <a href="/admin">Admin Panel</a>
-{{/if}}
-{{#unless isGuest}}
-    <p>Welcome back!</p>
-{{/unless}}
-<!-- Loops -->
-{{#each items}}
-    <div>{{this.name}}</div>
-{{/each}}
+<!-- Raw HTML (use sparingly, XSS risk) -->
+{{{htmlContent}}}
 <!-- Partials -->
-{{> header}}
+{{html.renderPartial('shared/header', {user: currentUser})}}
 ```
 ---