gina 0.7.2 → 0.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gina",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "MVC framework for Node.js and Bun with built-in HTTP/2, multi-bundle architecture, and scope-based data isolation — no Express dependency",
   "keywords": [
     "nodejs",
@@ -76,12 +76,12 @@
     "gina-container": "bin/gina-container",
     "gina-init": "bin/gina-init"
   },
-  "main": "./framework/v0.7.2/core/gna",
+  "main": "./framework/v0.7.3/core/gna",
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
       "import": "./index.mjs",
-      "require": "./framework/v0.7.2/core/gna.js"
+      "require": "./framework/v0.7.3/core/gna.js"
     },
     "./gna": {
       "types": "./types/gna.d.ts",

package/schema/settings.json

@@ -348,6 +348,11 @@
           "type": "boolean",
           "description": "When true, the HTTP/2 server also accepts HTTP/1.1 connections (ALPN negotiation). Defaults to true."
         },
+        "earlyHintsOverHTTP1": {
+          "type": "boolean",
+          "default": false,
+          "description": "Send 103 Early Hints over HTTP/1.1 too: the automatic preload hints and self.setEarlyHints(). Off by default: browsers act on a 103 only over HTTP/2 and HTTP/3, and an nginx older than 1.29 takes an upstream 103 for the final response, which breaks every page behind it. Turn it on only behind a proxy that handles 103 (nginx 1.29 or later with early_hints, Apache). Must be the boolean true."
+        },
         "maintenance": {
           "type": "object",
           "description": "Opt-in maintenance mode (#MAINT1). When active, every request EXCEPT the /_gina/* endpoints is answered 503 + Retry-After with a self-contained maintenance page, before static assets, the render/output cache and routing — coverage a route middleware cannot reach, since middleware only runs once a route has matched. The /_gina/* family stays reachable on purpose: liveness keeps answering 200 so an orchestrator does not restart pods over a declared window, and the operator can always reach the toggle. Flip it at runtime with POST /_gina/maintenance (admin-gated); a runtime override is NOT persisted across a restart and is PER PROCESS — a POST reaches the one process that received it, so with replicas either fan it out and read back `pid`/`hostname` from each reply, or name a shared kv namespace in `store` so every replica follows one POST — and `enabled` here is the durable, deployment-wide form. A malformed block warns at boot per key and never refuses a boot, with one deliberate exception: a `store` naming a namespace that is not declared, or one running failMode \"open\", refuses the boot rather than run without the coherence you configured.",

package/types/index.d.ts

@@ -798,6 +798,7 @@ declare namespace gina {
             protocol?: string;
             scheme?: string;
             allowHTTP1?: boolean;
+            earlyHintsOverHTTP1?: boolean;
             warmup?: number;
         };
         ioServer?: {

package/utils/helper.js

@@ -81,6 +81,31 @@ function MainHelper(opt) {
         return ( os.platform() == 'win32' ) ? true : false;
     }
 
+    /**
+     * filterArgs
+     * Promotes the `--<key>=<value>` arguments of the command line into the
+     * framework environment (`process.gina`), then imports the shell's
+     * `GINA_*` / `VENDOR_*` / `USER_*` variables with `importEnvVars()`.
+     *
+     * The key is the flag name without its leading `--`, with its first
+     * hyphen turned into `_`, upper-cased, and prefixed with `GINA_` unless it
+     * already starts with `GINA_`, `VENDOR_` or `USER_` (`--logs-path=…` →
+     * `GINA_LOGS_PATH`). The value is the argument's text after its first
+     * `=`, as given, except that `true` and `false` become booleans.
+     * `--prefix`, `--env`, `--scope` and `--gina-version` are never promoted,
+     * and for a sub-topic command the framework-connection flags (`--port`,
+     * `--mq-port`, `--host-v4`, …) stay on the argv for the command's own
+     * parser (#B40). A flag naming a protected variable is not promoted:
+     * `filterArgs` logs an error and returns without processing the rest.
+     *
+     * @returns {void}
+     *
+     * @example
+     * // gina framework:version --version=0.7.2-alpha.2 --logs-path=/var/log/gina
+     * filterArgs();
+     * getEnvVar('GINA_VERSION');   // '0.7.2-alpha.2' (the value keeps its hyphens)
+     * getEnvVar('GINA_LOGS_PATH'); // '/var/log/gina'
+     */
     filterArgs = function() {
 
         var setget  = ( typeof(process.argv[2]) != 'undefined'
@@ -137,6 +162,14 @@ function MainHelper(opt) {
                 var _raw = (process.argv[a].replace(/--/, '')).replace(/-/, '_');
                 var _eq  = _raw.indexOf('=');
                 evar     = (_eq > -1) ? [ _raw.substring(0, _eq), _raw.substring(_eq + 1) ] : [ _raw ];
+                // #B584 — the two rewrites above are meant for the flag name, but
+                // they run on the whole argument: with a hyphen-free name the
+                // value's first hyphen became `_` (`--version=0.7.2-alpha.2`
+                // reached GINA_VERSION as `0.7.2_alpha.2`). The value is the
+                // argument's text after its first `=`, as given.
+                if ( _eq > -1 ) {
+                    evar[1] = process.argv[a].substring(process.argv[a].indexOf('=') + 1);
+                }
 
                 evar[0] = evar[0].toUpperCase();
                 if (

package/framework/v0.7.2/VERSION

@@ -1 +0,0 @@
-0.7.2

package/framework/v0.7.2/lib/cmd/framework/inc/ps-titles.js

@@ -1,113 +0,0 @@
-/**
- * @module gina/lib/cmd/framework/inc/ps-titles
- *
- * Finds the current user's running framework daemons in the process listing,
- * without a shell. Used by `framework:status` (#B665, #B677).
- *
- * A daemon titles its process `gina-v<version>`: `lib/cmd/index.js` creates it
- * with `new Proc('gina-v' + version)`, and `lib/proc.js` sets that title
- * verbatim. Only a title that matches this rule is returned, so a title can
- * never name a pid file outside the run directory. `framework:status` used to
- * take any `gina-`-titled process of any user, and `_()` normalises `..`, so a
- * process titled `gina-v/../../x` wrote `~/.gina/x.pid`.
- *
- * `ps` runs from an argument vector and lists the current user's processes
- * only (`ps -f -U <uid>`, measured on macOS and on procps-ng 4.0.2). A host
- * without `ps`, or with a `ps` that rejects `-U` (busybox), lists nothing.
- */
-var execFileSync = require('child_process').execFileSync;
-
-/**
- * A framework daemon's process title: `gina-v`, a digit, then version
- * characters only (letters, digits, `.` and `-`). No `/` can pass, so the
- * title is safe as a file name inside the run directory.
- *
- * @constant
- * @type {RegExp}
- */
-var DAEMON_TITLE_RE = /^gina-v[0-9][A-Za-z0-9.-]*$/;
-
-/**
- * Output cap for the `ps -f` listing, which is read whole: Node's 1 MB default
- * could be exceeded on a host running many processes with long command lines
- * (the same cap as `bundle:stop`'s).
- *
- * @constant
- * @type {number}
- */
-var PS_MAX_BUFFER = 64 * 1024 * 1024;
-
-/**
- * Reads a pid: a positive decimal integer without a leading zero, surrounding
- * whitespace allowed. Anything else is not a pid; `parseInt` made `-1` (every
- * process the user may signal) and `12abc` (pid 12) into pids.
- *
- * @param {*} content - A pid file's content, a `ps` column or a Buffer
- * @returns {?number} The pid, or `null`
- * @example
- * parsePid('4242\n');  // 4242
- * parsePid('-1');      // null
- * parsePid('12abc');   // null
- */
-function parsePid(content) {
-    var s = String(content).trim();
-    return /^[1-9]\d*$/.test(s) ? parseInt(s, 10) : null;
-}
-
-/**
- * Picks the framework daemons out of a `ps -f` listing (the `ps -ef` layout:
- * `UID PID PPID C STIME TTY TIME CMD`). The title is the eighth column, and a
- * ninth column holding `<defunct>` flags a zombie. A line whose PID column is
- * not a pid (the header) or whose title is not a daemon title is skipped.
- *
- * @param {string|Buffer} psOut - The listing
- * @returns {Array<{pid: number, title: string, zombie: boolean}>}
- * @example
- * parseDaemonTitles('  501 22221     1   0 12:57AM ??   0:00.04 gina-v0.7.1\n');
- * // [ { pid: 22221, title: 'gina-v0.7.1', zombie: false } ]
- */
-function parseDaemonTitles(psOut) {
-    var found = [];
-    String(psOut || '').split(/\n/).forEach(function (line) {
-        var cols  = line.trim().split(/\s+/);
-        var pid   = parsePid(cols[1]);
-        var title = cols[7] || '';
-        if (pid === null || !DAEMON_TITLE_RE.test(title)) {
-            return;
-        }
-        found.push({ pid: pid, title: title, zombie: /defunct/.test(cols[8] || '') });
-    });
-    return found;
-}
-
-/**
- * Lists the current user's framework daemons: runs `ps -f -U <uid>` from an
- * argument vector and reads it with `parseDaemonTitles()`. Returns an empty
- * list where there is no uid (Windows) and where no `ps` could list; a `ps`
- * that exits non-zero after printing keeps what it printed.
- *
- * @returns {Array<{pid: number, title: string, zombie: boolean}>}
- * @example
- * listOwnDaemons().forEach(function (d) {
- *     console.log(d.pid, d.title, d.zombie);
- * });
- */
-function listOwnDaemons() {
-    if (typeof process.getuid !== 'function') {
-        return [];
-    }
-    var psOut = '';
-    try {
-        psOut = execFileSync('ps', ['-f', '-U', String(process.getuid())], { stdio: ['ignore', 'pipe', 'ignore'], maxBuffer: PS_MAX_BUFFER });
-    } catch (psErr) {
-        psOut = (psErr && psErr.stdout) ? psErr.stdout : '';
-    }
-    return parseDaemonTitles(psOut);
-}
-
-module.exports = {
-    DAEMON_TITLE_RE   : DAEMON_TITLE_RE,
-    parsePid          : parsePid,
-    parseDaemonTitles : parseDaemonTitles,
-    listOwnDaemons    : listOwnDaemons
-};