gina 0.3.6-alpha.2 → 0.3.6-alpha.3

package/framework/v0.3.6-alpha.3/VERSION

@@ -0,0 +1 @@
+0.3.6-alpha.3

package/framework/{v0.3.6-alpha.2 → v0.3.6-alpha.3}/helpers/context.js

@@ -691,6 +691,27 @@ function ContextHelper(contexts) {
     //     );
     // }
 
+    /**
+     * Interpolates `${key}` tokens in `replaceable` using values from `dictionary`.
+     *
+     * Handles three passes:
+     *  1. Quoted boolean/null shapes: `"${key}"` → unquoted literal when the value is a boolean or null.
+     *  2. Bare tokens: `${key}` → string value.
+     *  3. Embedded tokens inside a larger string (e.g. `~/.${projectName}`) via a manual
+     *     replace to avoid infinite recursion on the regex engine.
+     *
+     * Unknown keys are left untouched silently — earlier revisions logged a
+     * "Whisper Error" on every first-run CLI command when a default had not yet
+     * been seeded (see #B12). Callers that need strict-mode behaviour must
+     * validate their dictionaries before the call.
+     *
+     * @global
+     * @function whisper
+     * @param {Object} dictionary - Map of `key → replacement` values.
+     * @param {Object|string} replaceable - Object or JSON-serialisable value containing `${key}` tokens.
+     * @param {RegExp} [rule] - Optional custom replace rule; when provided, short-circuits the three-pass logic.
+     * @returns {Object|string} The interpolated object or string. Unknown tokens are preserved verbatim.
+     */
     global.whisper = function(dictionary, replaceable, rule) {
         // 1. Inline rule
         if (typeof(rule) != 'undefined') {
@@ -736,17 +757,12 @@ function ContextHelper(contexts) {
                 if (dictionary[key] !== undefined) {
                     // Manual replace to avoid infinite recursion.
                     return s.replace(new RegExp('\\$\\{' + key + '\\}'), dictionary[key]);
-                } else {
-                    // Generate stack trace to identify the caller
-                    const stack = new Error().stack;
-
-                    console.error(
-                        `[Whisper Error]: The key \${${key}} was not found in the dictionary.\n` +
-                        `Skipping replacement to prevent infinite loop.\n` +
-                        `Stack Trace:\n${stack}`
-                    );
-                    return s;
                 }
+                // Key not in dictionary — leave the token in place silently.
+                // Earlier branches already handled the common shapes; reaching here
+                // means no seeded default exists yet. Emitting an error on every
+                // first-run CLI command was noisy and misleading (see #B12).
+                return s;
             })
             // OS Environment Variables
             .replace(/\"\~\/\"|\"\$([_A-Z0-9]+)\"/g, function(s, key) {

package/gna.js

@@ -15,14 +15,14 @@
 'use strict';
 
 // Framework core — the main gna module (lifecycle hooks, lib, etc.)
-var _gna = require('./framework/v0.3.6-alpha.2/core/gna');
+var _gna = require('./framework/v0.3.6-alpha.3/core/gna');
 
 // SuperController and EntitySuper — loaded from their source modules
-var SuperController = require('./framework/v0.3.6-alpha.2/core/controller');
-var EntitySuper     = require('./framework/v0.3.6-alpha.2/core/model/entity');
+var SuperController = require('./framework/v0.3.6-alpha.3/core/controller');
+var EntitySuper     = require('./framework/v0.3.6-alpha.3/core/model/entity');
 
 // uuid — from the lib registry
-var uuid = require('./framework/v0.3.6-alpha.2/lib/uuid');
+var uuid = require('./framework/v0.3.6-alpha.3/lib/uuid');
 
 module.exports = {
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gina",
-  "version": "0.3.6-alpha.2",
+  "version": "0.3.6-alpha.3",
   "description": "Node.js MVC framework with built-in HTTP/2, multi-bundle architecture, and scope-based data isolation — no Express dependency",
   "keywords": [
     "nodejs",
@@ -56,7 +56,7 @@
     "gina-container": "bin/gina-container",
     "gina-init": "bin/gina-init"
   },
-  "main": "./framework/v0.3.6-alpha.2/core/gna",
+  "main": "./framework/v0.3.6-alpha.3/core/gna",
   "types": "./types/index.d.ts",
   "typesVersions": {
     "*": {

package/script/post_install.js

@@ -783,6 +783,43 @@ function PostInstall() {
             }
         }
 
+        // Seed def_global_mode[shortVersion] from packObj.config.globalMode (#B12).
+        // The resources/home/main.json template carries a ${global_mode} placeholder that
+        // is only resolved when checkIfMain runs with GINA_GLOBAL_MODE already in the env.
+        // On a fresh `npm install gina`, that env var isn't set yet — the token persists
+        // into ~/.gina/main.json, and the first `gina --version` surfaces a Whisper error.
+        // Reading packObj.config.globalMode here honours `npm config set gina:globalMode <v>`
+        // overrides (npm rewrites package.json.config at install time when that is set).
+        try {
+            var _packObj = require(pack);
+            var _gmRaw = ( _packObj.config && typeof(_packObj.config.globalMode) != 'undefined' )
+                ? _packObj.config.globalMode
+                : true;
+            var _gmResolved = ( typeof(_gmRaw) == 'string' ) ? /^true$/i.test(_gmRaw) : !!_gmRaw;
+
+            if ( fs.existsSync(_mainJsonPath) ) {
+                var _rootData = JSON.parse( fs.readFileSync(_mainJsonPath, 'utf8') );
+                if ( !_rootData.def_global_mode ) { _rootData.def_global_mode = {}; }
+                if ( _rootData.def_global_mode[self.shortVersion] !== _gmResolved ) {
+                    _rootData.def_global_mode[self.shortVersion] = _gmResolved;
+                    fs.writeFileSync(_mainJsonPath, JSON.stringify(_rootData, null, 4));
+                }
+            }
+
+            var _versionMainPath = _(getUserHome() + '/.gina/' + self.shortVersion + '/main.json', true);
+            if ( fs.existsSync(_versionMainPath) ) {
+                var _verData = JSON.parse( fs.readFileSync(_versionMainPath, 'utf8') );
+                if ( !_verData.def_global_mode ) { _verData.def_global_mode = {}; }
+                var _existing = _verData.def_global_mode[self.shortVersion];
+                if ( typeof(_existing) != 'boolean' || _existing !== _gmResolved ) {
+                    _verData.def_global_mode[self.shortVersion] = _gmResolved;
+                    fs.writeFileSync(_versionMainPath, JSON.stringify(_verData, null, 4));
+                }
+            }
+        } catch(e) {
+            console.warn('Could not seed def_global_mode in main.json: ' + (e.message || e));
+        }
+
         // Update middleware file
         var filename = _(self.versionPath) + '/MIDDLEWARE';
         var msg = "Gina's command line tool has been installed.";

package/framework/v0.3.6-alpha.2/VERSION

@@ -1 +0,0 @@
-0.3.6-alpha.2