underpost 2.99.4 → 2.99.6

package/examples/static-page/README.md

@@ -1,406 +1,150 @@
-# Underpost Static Site Generator - Examples
+# Static Page Example
 
-This directory contains comprehensive examples and documentation for the Underpost Static Site Generator.
-
-## Contents
-
-### Documentation
-
-- **[STATIC-GENERATOR-GUIDE.md](./STATIC-GENERATOR-GUIDE.md)** - Complete guide covering all features, best practices, and advanced usage patterns
-
-### Configuration Examples
-
-- **[static-config-example.json](./static-page/static-config-example.json)** - Fully documented configuration file template with all available options
-
-### SSR Component Examples
-
-- **[ssr-components/CustomPage.js](./ssr-components/CustomPage.js)** - Complete example of a custom landing page with:
-  - Semantic HTML structure
-  - Accessibility features
-  - Responsive design
-  - Progressive enhancement
-  - Inline critical CSS
-  - Interactive JavaScript
+Generate static HTML pages using the `underpost static` CLI.
 
 ## Quick Start
 
-### 1. Generate a Config Template
-
-```bash
-underpost static --generate-config ./my-static-config.json
+```sh
+# From the project root directory:
+underpost static --page ./examples/static-page/ssr-components/CustomPage.js \
+                 --output-path ./public/default.net/example.html
 ```
 
-This creates a template configuration file with all available options documented.
+## Using a Config File
 
-### 2. Customize Your Config
+A JSON config file lets you define all options in one place instead of passing CLI flags.
 
-Edit the generated config file with your specific requirements:
+**Generate a starter config:**
 
-```json
-{
-  "page": "./src/client/ssr/body/YourPage.js",
-  "outputPath": "./dist/index.html",
-  "metadata": {
-    "title": "Your App Title",
-    "description": "Your app description"
-  }
-}
+```sh
+underpost static --generate-config ./static-config.json
 ```
 
-### 3. Build Your Static Page
+**Build from the included example config:**
 
-```bash
-underpost static --config-file ./my-static-config.json
+```sh
+underpost static --config-file ./examples/static-page/static-config-example.json
 ```
 
-## Example Usage Scenarios
+## Preview with Static Server
 
-### Basic Static Page
+Use `--run-sv` to start a standalone Express static file server that serves the build output directory, so you can preview your generated pages in a browser.
 
-```bash
-underpost static \
-  --page ./src/client/ssr/body/DefaultSplashScreen.js \
-  --output-path ./dist/index.html \
-  --title "My App"
-```
-
-### Landing Page with SEO
-
-```bash
-underpost static \
-  --page ./examples/static-page/ssr-components/CustomPage.js \
-  --output-path ./dist/landing.html \
-  --title "Welcome to My App" \
-  --description "The best app for your needs" \
-  --keywords "app,solution,innovation" \
-  --theme-color "#667eea" \
-  --canonical-url "https://myapp.com"
-```
-
-### Complete Customization
+```sh
+# Build and serve on default port 5000:
+underpost static --page ./examples/static-page/ssr-components/CustomPage.js \
+                 --output-path ./dist/index.html \
+                 --run-sv
 
-Use the provided `static-config-example.json`:
+# Build and serve on a custom port:
+underpost static --page ./examples/static-page/ssr-components/CustomPage.js \
+                 --output-path ./dist/index.html \
+                 --run-sv 3000
 
-```bash
-# Copy the example
-cp ./examples/static-page/static-config-example.json ./my-config.json
+# Serve an existing build directory without rebuilding:
+underpost static --output-path ./dist/index.html --run-sv
 
-# Edit with your settings
-nano ./my-config.json
-
-# Build
-underpost static --config-file ./my-config.json
+# Serve the current working directory:
+underpost static --run-sv 8080
 ```
 
-## Available Examples
-
-### 1. Complete Configuration Example
-
-**File:** `static-config-example.json`
-
-**What it demonstrates:**
-- Complete metadata configuration
-- Script injection (head and body)
-- Stylesheet management
-- Icon configuration
-- SSR component inclusion
-- Microdata/structured data
-- Custom payload injection
-
-**Use case:** Production-ready web application with full SEO and PWA support
-
-### 2. Custom Landing Page Component
-
-**File:** `ssr-components/CustomPage.js`
-
-**What it demonstrates:**
-- Hero section with call-to-action
-- Feature showcase grid
-- Content sections
-- Contact form
-- Footer with links
-- Responsive design
-- Accessibility features
-- Progressive enhancement
-
-**Use case:** Marketing landing page or product showcase
-
-## Configuration Options Reference
-
-### Metadata Options
-
-```json
-{
-  "metadata": {
-    "title": "Page title",
-    "description": "SEO description",
-    "keywords": ["keyword1", "keyword2"],
-    "author": "Author name",
-    "themeColor": "#ffffff",
-    "canonicalURL": "https://example.com",
-    "thumbnail": "https://example.com/image.png",
-    "locale": "en-US",
-    "siteName": "Site Name"
-  }
-}
-```
+When `--output-path` is provided, the server serves the directory containing the output file (e.g. `./dist/`). Otherwise it serves the current working directory.
 
-### Script Options
-
-```json
-{
-  "scripts": {
-    "head": [
-      {
-        "src": "https://cdn.example.com/script.js",
-        "async": true,
-        "integrity": "sha384-...",
-        "crossorigin": "anonymous"
-      },
-      {
-        "content": "window.config = {};",
-        "type": "text/javascript"
-      }
-    ],
-    "body": [
-      {
-        "src": "/app.js",
-        "type": "module",
-        "defer": true
-      }
-    ]
-  }
-}
-```
+## Config File Reference
 
-### Style Options
+See [`static-config-example.json`](./static-config-example.json) for a complete working example.
 
-```json
-{
-  "styles": [
-    { "href": "/main.css" },
-    { "content": "body { margin: 0; }" },
-    { "href": "/print.css", "media": "print" }
-  ]
-}
-```
+| Field | Type | Description |
+|-------|------|-------------|
+| `page` | `string` | Path to the SSR component to render |
+| `outputPath` | `string` | Output HTML file path |
+| `buildPath` | `string` | Base path for static documents or assets (default: `"/"`) |
+| `env` | `string` | `"production"` or `"development"` |
+| `minify` | `boolean` | Minify HTML output |
+| `lang` | `string` | HTML `lang` attribute |
+| `dir` | `string` | HTML `dir` attribute (`ltr`/`rtl`) |
+| `metadata` | `object` | SEO metadata (title, description, keywords, author, themeColor, canonicalURL, thumbnail, locale, siteName) |
+| `scripts` | `object` | `{ head: [...], body: [...] }` — inline or external scripts |
+| `styles` | `array` | Inline (`content`) or external (`href`) stylesheets |
+| `icons` | `object` | `favicon`, `appleTouchIcon`, `manifest` paths |
+| `headComponents` | `array` | SSR component paths injected into `<head>` |
+| `bodyComponents` | `array` | SSR component paths injected into `<body>` |
+| `microdata` | `array` | JSON-LD structured data objects |
+| `customPayload` | `object` | Arbitrary data injected into the render payload |
 
-### Icon Options
-
-```json
-{
-  "icons": {
-    "favicon": "/favicon.ico",
-    "appleTouchIcon": "/apple-touch-icon.png",
-    "manifest": "/manifest.json",
-    "additional": [
-      {
-        "rel": "icon",
-        "type": "image/png",
-        "sizes": "32x32",
-        "href": "/favicon-32x32.png"
-      }
-    ]
-  }
-}
-```
+## CLI Flags
 
-### Component Options
-
-```json
-{
-  "headComponents": [
-    "./src/client/ssr/head/Seo.js",
-    "./src/client/ssr/head/Pwa.js"
-  ],
-  "bodyComponents": [
-    "./src/client/ssr/body/Header.js"
-  ]
-}
-```
+Flags override config file values when both are provided.
 
-### Structured Data (Microdata)
-
-```json
-{
-  "microdata": [
-    {
-      "@context": "https://schema.org",
-      "@type": "WebSite",
-      "name": "My Site",
-      "url": "https://example.com"
-    }
-  ]
-}
-```
+### Build & Output
 
-## Common Use Cases
-
-### 1. Simple Blog Post
-
-```json
-{
-  "page": "./src/client/ssr/body/BlogPost.js",
-  "outputPath": "./dist/blog/my-post.html",
-  "metadata": {
-    "title": "My Blog Post Title",
-    "description": "Summary of the blog post",
-    "author": "John Doe",
-    "keywords": ["blogging", "tutorial"]
-  },
-  "microdata": [
-    {
-      "@context": "https://schema.org",
-      "@type": "BlogPosting",
-      "headline": "My Blog Post Title",
-      "author": {
-        "@type": "Person",
-        "name": "John Doe"
-      },
-      "datePublished": "2024-01-01"
-    }
-  ]
-}
+```sh
+underpost static --page <path>                  # SSR component path
+                 --output-path <path>           # Output file
+                 --build-path <path>            # Base path for assets (default: "/")
+                 --config-file <path>           # JSON config file
+                 --generate-config [path]       # Generate a template config file
+                 --env <env>                    # production | development
+                 --minify / --no-minify         # Toggle minification
+                 --lang <lang>                  # HTML lang attribute (default: en)
+                 --dir <dir>                    # HTML dir attribute (default: ltr)
+                 --dev                          # Development mode
 ```
 
-### 2. E-commerce Product Page
-
-```json
-{
-  "page": "./src/client/ssr/body/ProductPage.js",
-  "outputPath": "./dist/products/widget.html",
-  "metadata": {
-    "title": "Premium Widget - Buy Now",
-    "description": "High-quality widget with free shipping",
-    "thumbnail": "https://shop.com/widget.jpg"
-  },
-  "microdata": [
-    {
-      "@context": "https://schema.org",
-      "@type": "Product",
-      "name": "Premium Widget",
-      "offers": {
-        "@type": "Offer",
-        "price": "29.99",
-        "priceCurrency": "USD"
-      }
-    }
-  ]
-}
-```
+### Metadata & SEO
 
-### 3. Documentation Page
-
-```json
-{
-  "page": "./src/client/ssr/body/DocsPage.js",
-  "outputPath": "./dist/docs/index.html",
-  "headComponents": [
-    "./src/client/ssr/head/Seo.js"
-  ],
-  "styles": [
-    { "href": "/docs/prism.css" },
-    { "href": "/docs/docs.css" }
-  ],
-  "scripts": {
-    "body": [
-      { "src": "/docs/prism.js", "defer": true },
-      { "src": "/docs/search.js", "defer": true }
-    ]
-  }
-}
+```sh
+                 --title <title>                # Page title (deprecated: use --config-file)
+                 --description <text>           # Meta description
+                 --keywords <a,b,c>             # Comma-separated keywords
+                 --author <name>                # Meta author
+                 --theme-color <color>          # Theme color for mobile browsers
+                 --canonical-url <url>          # Canonical URL for SEO
+                 --thumbnail <url>              # Open Graph thumbnail image URL
+                 --locale <locale>              # Page locale (default: en-US)
+                 --site-name <name>             # Site name for Open Graph
 ```
 
-### 4. Multi-language Pages
-
-```bash
-# English version
-underpost static --config-file ./config-en.json --lang en --dir ltr
-
-# Spanish version
-underpost static --config-file ./config-es.json --lang es --dir ltr
+### Scripts & Styles
 
-# Arabic version
-underpost static --config-file ./config-ar.json --lang ar --dir rtl
+```sh
+                 --head-scripts <paths>         # Comma-separated script paths for <head>
+                 --body-scripts <paths>         # Comma-separated script paths for <body>
+                 --styles <paths>               # Comma-separated stylesheet paths
 ```
 
-## Best Practices
+### Icons
 
-### 1. SEO Optimization
-
-✅ Always include title, description, and keywords
-✅ Use canonical URLs
-✅ Add Open Graph metadata
-✅ Include structured data (JSON-LD)
-✅ Optimize images in metadata
-
-### 2. Performance
+```sh
+                 --favicon <path>               # Favicon path
+                 --apple-touch-icon <path>      # Apple touch icon path
+                 --manifest <path>              # Web manifest path
+```
 
-✅ Minify HTML in production
-✅ Use async/defer for scripts
-✅ Inline critical CSS
-✅ Optimize asset loading order
+### SSR Components
 
-### 3. Accessibility
+```sh
+                 --head-components <paths>      # Comma-separated SSR head component paths
+                 --body-components <paths>      # Comma-separated SSR body component paths
+```
 
-✅ Use semantic HTML
-✅ Include ARIA labels
-✅ Ensure keyboard navigation
-✅ Test with screen readers
+### Static Server
 
-### 4. Progressive Enhancement
+```sh
+                 --run-sv [port]                # Start Express static server (default port: 5000)
+```
 
-✅ Ensure content works without JavaScript
-✅ Add interactive features progressively
-✅ Test on various devices
-✅ Provide fallbacks
+## SSR Component
 
-## Advanced Techniques
+The page content is defined in an SSR component file. See [`ssr-components/CustomPage.js`](./ssr-components/CustomPage.js) for an example.
 
-### Custom SSR Component Template
+A component exports an `SrrComponent` function that returns an HTML template literal:
 
-```javascript
-/**
- * Custom Component Template
- * @description Brief description of the component
- */
+```js
 SrrComponent = () => html`
-  <div class="custom-component">
-    <!-- Your HTML here -->
+  <div>
+    <h1>Hello World</h1>
+    <p>Your page content here.</p>
   </div>
-  
-  <style>
-    /* Component-specific styles */
-  </style>
-  
-  <script>
-    // Component-specific JavaScript
-    document.addEventListener('DOMContentLoaded', function() {
-      // Your code here
-    });
-  </script>
 `;
 ```
-
-### Programmatic Usage
-
-```javascript
-import UnderpostStatic from './src/cli/static.js';
-
-// Generate multiple pages
-const pages = [
-  { slug: 'home', title: 'Home' },
-  { slug: 'about', title: 'About' },
-  { slug: 'contact', title: 'Contact' }
-];
-
-for (const page of pages) {
-  await UnderpostStatic.API.callback({
-    page: `./src/client/ssr/body/${page.slug}.js`,
-    outputPath: `./dist/${page.slug}.html`,
-    metadata: {
-      title: page.title
-    }
-  });
-}
-```

package/examples/static-page/ssr-components/CustomPage.js

@@ -1,22 +1,10 @@
 /**
  * Custom Page SSR Component Example
  * @module examples/ssr-components/CustomPage
- *
- * @description
- * This is an example SSR component demonstrating best practices for creating
- * custom static pages with the Underpost Static Site Generator.
  */
 
 /**
- * Main SSR Component for rendering a custom landing page
- *
- * This component demonstrates:
- * - Semantic HTML structure
- * - Accessibility best practices
- * - Responsive design patterns
- * - Progressive enhancement
- * - Clean, maintainable code
- *
+ * SSR Component Example for rendering a custom landing page
  * @function SrrComponent
  * @returns {string} HTML string for the page body
  */

package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml

@@ -0,0 +1,40 @@
+apiVersion: batch/v1
+kind: CronJob
+metadata:
+  name: dd-cron-backup
+  namespace: default
+  labels:
+    app: dd-cron-backup
+    managed-by: underpost
+spec:
+  schedule: "0 1 * * *"
+  concurrencyPolicy: Forbid
+  startingDeadlineSeconds: 200
+  successfulJobsHistoryLimit: 3
+  failedJobsHistoryLimit: 1
+  suspend: false
+  jobTemplate:
+    spec:
+      template:
+        metadata:
+          labels:
+            app: dd-cron-backup
+            managed-by: underpost
+        spec:
+          containers:
+            - name: dd-cron-backup
+              image: underpost/underpost-engine:v2.99.6
+              command:
+                - /bin/sh
+                - -c
+                - >
+                  cd /home/dd/engine && node bin run secret && node bin env dd-cron production && node bin cron --git --dev dd-lampp,dd-cyberia,dd-core,dd-test backup
+              volumeMounts:
+                - mountPath: /home/dd/engine
+                  name: underpost-cron-container-volume
+          volumes:
+            - hostPath:
+                path: /home/dd/engine
+                type: Directory
+              name: underpost-cron-container-volume
+          restartPolicy: OnFailure

package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml

@@ -0,0 +1,40 @@
+apiVersion: batch/v1
+kind: CronJob
+metadata:
+  name: dd-cron-dns
+  namespace: default
+  labels:
+    app: dd-cron-dns
+    managed-by: underpost
+spec:
+  schedule: "* * * * *"
+  concurrencyPolicy: Forbid
+  startingDeadlineSeconds: 200
+  successfulJobsHistoryLimit: 3
+  failedJobsHistoryLimit: 1
+  suspend: false
+  jobTemplate:
+    spec:
+      template:
+        metadata:
+          labels:
+            app: dd-cron-dns
+            managed-by: underpost
+        spec:
+          containers:
+            - name: dd-cron-dns
+              image: underpost/underpost-engine:v2.99.6
+              command:
+                - /bin/sh
+                - -c
+                - >
+                  cd /home/dd/engine && node bin run secret && node bin env dd-cron production && node bin cron --git --dev dd-cron dns
+              volumeMounts:
+                - mountPath: /home/dd/engine
+                  name: underpost-cron-container-volume
+          volumes:
+            - hostPath:
+                path: /home/dd/engine
+                type: Directory
+              name: underpost-cron-container-volume
+          restartPolicy: OnFailure

package/manifests/deployment/dd-default-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-blue
-          image: localhost/rockylinux9-underpost:v2.99.4
+          image: localhost/rockylinux9-underpost:v2.99.6
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v2.99.4
+          image: localhost/rockylinux9-underpost:v2.99.6
           #          resources:
           #            requests:
           #              memory: "124Ki"

package/manifests/deployment/dd-test-development/deployment.yaml

@@ -18,7 +18,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v2.99.4
+          image: localhost/rockylinux9-underpost:v2.99.6
 
           command:
             - /bin/sh
@@ -103,7 +103,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v2.99.4
+          image: localhost/rockylinux9-underpost:v2.99.6
 
           command:
             - /bin/sh

package/package.json

@@ -2,13 +2,12 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.99.4",
+    "version": "2.99.6",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",
         "build": "node bin/deploy build-full-client",
         "test": "env-cmd -f .env.test c8 mocha",
-        "pm2": "env-cmd -f .env.production pm2 start src/server.js --node-args=\"--max-old-space-size=8192\" --name engine -- dd-default",
         "dev": "env-cmd -f .env.development nodemon src/server",
         "dev-img": "env-cmd -f .env.development node src/server",
         "prod-img": "env-cmd -f .env.production node src/server",
@@ -16,13 +15,13 @@
         "dev-client": "env-cmd -f .env.development node src/client.dev",
         "dev-proxy": "env-cmd -f .env.development node src/proxy proxy",
         "docs": "jsdoc -c jsdoc.json",
-        "install-global": "npm install -g pm2 && npm install -g jsdoc && npm install -g prettier && npm install -g env-cmd",
+        "install-global": "npm install -g jsdoc && npm install -g prettier && npm install -g env-cmd",
         "install-test": "npm install -g mocha && npm install -g c8 && npm install -g coveralls",
         "install-underpost": "cp -a $(npm root -g)/underpost/node_modules ./node_modules && npm install --only=dev --ignore-scripts",
         "install": "npm run install-global && npm run install-test",
         "prettier": "prettier --write .",
         "fix": "npm audit fix --force && npm audit",
-        "baremetal": "node bin baremetal --dev --commission --clear-discovered --remove-machines all --ls --create-machine"
+        "baremetal": "node bin baremetal --dev --commission --ls --create-machine"
     },
     "bin": {
         "underpost": "bin/index.js"