gina 0.3.2 → 0.3.3

package/framework/{v0.3.2 → v0.3.3}/core/plugins/lib/validator/src/main.js

@@ -6,7 +6,7 @@
  *  - lib/merge
  *  - utils/events
  *  - utils/data
- *  - vendor/uuid
+ *  - lib/uuid
  *
  * Additional helpers for the backend are located in framwework/v{version}/helpers/plugins/validator-*.js
  *
@@ -92,7 +92,7 @@ function ValidatorPlugin(rules, data, formId) {
         require('../../../../../helpers/data');
     }
 
-    var uuid            = { v1: function() { return Date.now().toString(36) + '-' + crypto.randomUUID(); }, v4: function() { return crypto.randomUUID(); } };
+    var uuid            = (isGFFCtx) ? require('lib/uuid') : require('../../../../../lib/uuid');
     var merge           = (isGFFCtx) ? require('lib/merge') : require('../../../../../lib/merge');
     var inherits        = (isGFFCtx) ? require('lib/inherits') : require('../../../../../lib/inherits');
     var FormValidator   = (isGFFCtx) ? require('lib/form-validator') : require('./form-validator');
@@ -102,7 +102,7 @@ function ValidatorPlugin(rules, data, formId) {
 
     /** definitions */
     var instance    = {
-        'id'                : 'validator-' + uuid.v4(),
+        'id'                : 'validator-' + uuid(),
 
         'plugin'            : this.plugin,
         'on'                : (isGFFCtx) ? on : null,
@@ -351,7 +351,7 @@ function ValidatorPlugin(rules, data, formId) {
         } else if ( typeof(_id) == 'object' && !Array.isArray(_id) ) { // weird exception
 
             $target = _id.form;
-            _id = $target.getAttribute('id') || 'form.'+uuid.v4();
+            _id = $target.getAttribute('id') || 'form.'+uuid();
 
             $target.setAttribute('id', _id);// just in case
 
@@ -1686,7 +1686,7 @@ function ValidatorPlugin(rules, data, formId) {
                         if (hasBinaries && binaries.length > 0) {
 
                             // We need a separator to define each part of the request
-                            var boundary = '--ginaWKBoundary' + uuid.v4().replace(/\-/g, '');
+                            var boundary = '--ginaWKBoundary' + uuid();
 
 
                             return processFiles(binaries, boundary, '', 0, function onComplete(err, data, done) {
@@ -2354,7 +2354,7 @@ function ValidatorPlugin(rules, data, formId) {
             _id = _id.replace(/\#/, '')
         } else if ( typeof(_id) == 'object' && !Array.isArray(_id) ) { // weird exception
             var $target = _id.form;
-            _id = $target.getAttribute('id') || 'form.'+uuid.v4();
+            _id = $target.getAttribute('id') || 'form.'+uuid();
 
             $target.setAttribute('id', _id);// just in case
 
@@ -2578,12 +2578,12 @@ function ValidatorPlugin(rules, data, formId) {
                     // preparing prototype (need at least an ID for this)
 
                     if ($allForms[f].getAttribute) {
-                        id = $allForms[f].getAttribute('id') || 'form.' + uuid.v4();
+                        id = $allForms[f].getAttribute('id') || 'form.' + uuid();
                         if ( id !== $allForms[f].getAttribute('id') ) {
                             $allForms[f].setAttribute('id', id)
                         }
                     } else {
-                        id = 'form.' + uuid.v4();
+                        id = 'form.' + uuid();
                         $allForms[f].setAttribute('id', id)
                     }
 
@@ -2632,7 +2632,7 @@ function ValidatorPlugin(rules, data, formId) {
                             if ( typeof($allForms[f].id) == 'object' ) {
                                 delete instance.$forms[$allForms[f].id];
 
-                                var _id = $allForms[f].attributes.getNamedItem('id').nodeValue || 'form.'+uuid.v4();
+                                var _id = $allForms[f].attributes.getNamedItem('id').nodeValue || 'form.'+uuid();
 
                                 $allForms[f].setAttribute('id', _id);
                                 $allForms[f]['id'] = _id;
@@ -2696,12 +2696,12 @@ function ValidatorPlugin(rules, data, formId) {
         ;
 
         if ($form.getAttribute) {
-            id = $form.getAttribute('id') || 'form.' + uuid.v4();
+            id = $form.getAttribute('id') || 'form.' + uuid();
             if (id !== $form.getAttribute('id')) {
                 $form.setAttribute('id', id)
             }
         } else {
-            id = 'form.' + uuid.v4();
+            id = 'form.' + uuid();
             $form.setAttribute('id', id)
         }
 
@@ -2738,7 +2738,7 @@ function ValidatorPlugin(rules, data, formId) {
                 if (typeof ($form.id) == 'object') {
                     delete instance.$forms[$form.id];
 
-                    var _id = $form.attributes.getNamedItem('id').nodeValue || 'form.' + uuid.v4();
+                    var _id = $form.attributes.getNamedItem('id').nodeValue || 'form.' + uuid();
 
                     $form.setAttribute('id', _id);
                     $form.id = _id;
@@ -3334,10 +3334,14 @@ function ValidatorPlugin(rules, data, formId) {
                                     if ( !isFormValid && gResult.error ) {
                                         // Fixed on 2025-03-16 - we need past and live errors
                                         instance.$forms[ $el.form.getAttribute('id') ].errors = merge(result.error, gResult.error);
-                                        // Fixed on 2025-03-16
-                                        for (let eField in gResult.error) {
-                                            refreshWarning($gFields[eField]);
-                                            handleErrorsDisplay($gForm, gResult.error, gResult.data, eField);
+                                        // Fixed on 2026-04-09 - only display errors for the touched field,
+                                        // not all fields from the global pass. The global pass determines
+                                        // submit button state; untouched fields should not show errors
+                                        // until the user interacts with them or submits.
+                                        var _touchedField = event.target.name;
+                                        if ( typeof(gResult.error[_touchedField]) != 'undefined' ) {
+                                            refreshWarning($gFields[_touchedField]);
+                                            handleErrorsDisplay($gForm, gResult.error, gResult.data, _touchedField);
                                         }
                                     }
                                     // Fixed on 2025-03-16
@@ -4256,7 +4260,7 @@ function ValidatorPlugin(rules, data, formId) {
         //         if ( $target.isPopinContext ) {
         //             elId = ( isPopinClick ) ? 'popin.click.' : 'popin.link.';
         //         }
-        //         elId += uuid.v4();
+        //         elId += uuid();
         //         $a[f].setAttribute('id', elId)
         //     }
         // }
@@ -4267,7 +4271,7 @@ function ValidatorPlugin(rules, data, formId) {
             checkForRuleAlias($form.rules, $textareas[f]);
             elId = $textareas[f].getAttribute('id');
             if (!elId || elId == '') {
-                elId = 'textareas.' + uuid.v4();
+                elId = 'textareas.' + uuid();
                 $textareas[f].setAttribute('id', elId)
             }
             if (!$form.fieldsSet[ elId ]) {
@@ -4299,7 +4303,7 @@ function ValidatorPlugin(rules, data, formId) {
             checkForRuleAlias($form.rules, $inputs[f]);
             elId = $inputs[f].getAttribute('id');
             if (!elId || elId == '') {
-                elId = 'input.' + uuid.v4();
+                elId = 'input.' + uuid();
                 $inputs[f].setAttribute('id', elId)
             }
 
@@ -4685,7 +4689,7 @@ function ValidatorPlugin(rules, data, formId) {
                                             // create input & add it to the form
                                             $newVirtualField = document.createElement('input');
                                             $newVirtualField.type = 'hidden';
-                                            $newVirtualField.id = 'input.' + uuid.v4();
+                                            $newVirtualField.id = 'input.' + uuid();
                                             $newVirtualField.name = _name;
                                             $newVirtualField.value = '';
 
@@ -4862,9 +4866,10 @@ function ValidatorPlugin(rules, data, formId) {
                         var isFormValid = gResult.isValid();
                         if (!isFormValid) {
                             instance.$forms[formId].errors = gResult.error;
-                            for (let eField in gResult.error) {
-                                // refreshWarning($gFields[eField]);
-                                handleErrorsDisplay($gForm, gResult.error, gResult.data, eField);
+                            // Fixed on 2026-04-09 - only display errors for the touched field
+                            var _touchedField = event.target.name;
+                            if ( typeof(gResult.error[_touchedField]) != 'undefined' ) {
+                                handleErrorsDisplay($gForm, gResult.error, gResult.data, _touchedField);
                             }
                         }
 
@@ -4885,7 +4890,7 @@ function ValidatorPlugin(rules, data, formId) {
             if (elId && /^gina\-toolbar/.test(elId)) continue;
 
             if (!elId || elId == '') {
-                elId = 'select.' + uuid.v4();
+                elId = 'select.' + uuid();
                 $select[s].setAttribute('id', elId)
             }
 
@@ -5269,7 +5274,7 @@ function ValidatorPlugin(rules, data, formId) {
             type    = $inputs[i].getAttribute('type');
 
             if ( typeof($inputs[i].id) == 'undefined' || $inputs[i].id == '' ) {
-                $inputs[i].id = type +'-'+ uuid.v4();
+                $inputs[i].id = type +'-'+ uuid();
                 $inputs[i].setAttribute('id', $inputs[i].id)
             }
 
@@ -5612,7 +5617,7 @@ function ValidatorPlugin(rules, data, formId) {
                     }
                     // safety checking
                     if ( typeof($el.id) == 'undefined' || !$el.getAttribute('id') ) {
-                        $el.setAttribute('id', 'click.' + uuid.v4() );
+                        $el.setAttribute('id', 'click.' + uuid() );
                         $el.id = $el.getAttribute('id')
                     } else {
                         $el.id = $el.getAttribute('id')
@@ -5818,7 +5823,7 @@ function ValidatorPlugin(rules, data, formId) {
                     && !gina.popinIsBinded
                     && !/gina\-link/.test($buttonsTMP[b].className)
                 ) { // will not be binded but will receive an id if not existing
-                    linkId = 'link.'+ uuid.v4();
+                    linkId = 'link.'+ uuid();
                     $buttonsTMP[b].id = linkId;
                 }
             }
@@ -5848,7 +5853,7 @@ function ValidatorPlugin(rules, data, formId) {
                 }
 
                 if ( typeof($submit.id) == 'undefined' || typeof($submit.id) != 'undefined' && $submit.id == "" ) {
-                    $submit.id = 'click.'+uuid.v4();
+                    $submit.id = 'click.'+uuid();
                     $submit.setAttribute('id', $submit.id);
                 }
 
@@ -5891,7 +5896,7 @@ function ValidatorPlugin(rules, data, formId) {
             }
 
             if (!$submit['id']) {
-                evt             = 'click.'+ uuid.v4();
+                evt             = 'click.'+ uuid();
                 $submit['id']   = evt;
                 $submit.setAttribute( 'id', evt);
             } else {

package/framework/{v0.3.2 → v0.3.3}/core/server.isaac.js

@@ -11,6 +11,21 @@ const {EventEmitter}        = require('events');
 let Eio = null;
 // const zlib                  = require('zlib'); // gzip / deflate
 
+// Lightweight debug logger — gated on LOG_LEVEL so zero cost in production.
+// Format mirrors lib/logger template: [date] [debug  ][gina:isaac] message
+var _isDebugLog = function() {
+    return process.env.LOG_LEVEL === 'debug' || process.env.LOG_LEVEL === 'trace';
+};
+var _debugLog = function(msg) {
+    if (!_isDebugLog()) return;
+    var _m = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'];
+    var p2 = function(n) { return (n < 10 ? '0' : '') + n; };
+    var d = new Date();
+    var ts = d.getFullYear() + ' ' + _m[d.getMonth()] + ' ' + p2(d.getDate())
+        + ' ' + p2(d.getHours()) + ':' + p2(d.getMinutes()) + ':' + p2(d.getSeconds());
+    process.stderr.write('\u001b[90m[' + ts + '] [debug  ][gina:isaac] ' + msg + '\u001b[39m\n');
+};
+
 const lib               = require('./../lib');
 const inherits          = lib.inherits;
 const merge             = lib.merge;
@@ -26,19 +41,6 @@ const env               = process.env.NODE_ENV
     , isProductionScope = process.env.NODE_SCOPE_IS_PRODUCTION && process.env.NODE_SCOPE_IS_PRODUCTION.toLowerCase() === 'true'
 ;
 
-var _isDebugLog = function() {
-    return process.env.LOG_LEVEL === 'debug' || process.env.LOG_LEVEL === 'trace';
-};
-var _debugLog = function(msg) {
-    if (!_isDebugLog()) return;
-    var d = new Date()
-        , _m = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec']
-        , p2 = function(n) { return (n < 10 ? '0' : '') + n; };
-    fs.writeSync(2, '\u001b[90m[' + d.getFullYear() +' '+ _m[d.getMonth()] +' '+ p2(d.getDate())
-        +' '+ p2(d.getHours()) +':'+ p2(d.getMinutes()) +':'+ p2(d.getSeconds())
-        + '] [debug  ][gina:isaac] ' + msg + '\u001b[39m\n');
-};
-
 /**
  * Reloads all core and lib modules from disk by replacing their require.cache
  * entries with fresh exports. Excludes gna.js itself. Also refreshes the
@@ -798,6 +800,68 @@ function ServerEngineClass(options) {
                 return;
             }
 
+            // ── Live index introspection — JSON at /_gina/indexes in dev mode ──
+            // #QI2 — triggers inspector#indexes event; each SQL connector responds
+            // with its live index data. Collector aggregates responses.
+            if (
+                isCacheless
+                && request.method.toUpperCase() === 'GET'
+                && /\/_gina\/indexes$/.test(request.url)
+            ) {
+                if (!process.gina._inspectorActive) process.gina._inspectorActive = true;
+
+                var _ixListenerCount = process.listenerCount('inspector#indexes');
+                var _ixHeaders = {
+                    'content-type': 'application/json; charset=utf8',
+                    'cache-control': 'no-cache, no-store',
+                    'access-control-allow-origin': '*',
+                    'X-Powered-By': 'Gina/' + GINA_VERSION
+                };
+
+                if (_ixListenerCount === 0) {
+                    var _ixEmpty = JSON.stringify({ connectors: {} });
+                    if (response.stream) {
+                        response.stream.respond({ ':status': 200, ..._ixHeaders });
+                        return response.stream.end(_ixEmpty);
+                    }
+                    response.writeHead(200, _ixHeaders);
+                    console.info(request.method + ' [200] ' + request.url);
+                    return response.end(_ixEmpty);
+                }
+
+                var _ixResults   = {};
+                var _ixRemaining = _ixListenerCount;
+                var _ixResponded = false;
+
+                var _ixRespond = function() {
+                    if (_ixResponded) return;
+                    _ixResponded = true;
+                    clearTimeout(_ixTimeout);
+                    var _ixBody = JSON.stringify({ connectors: _ixResults });
+                    if (response.stream) {
+                        if (response.stream.destroyed || response.stream.closed) return;
+                        response.stream.respond({ ':status': 200, ..._ixHeaders });
+                        return response.stream.end(_ixBody);
+                    }
+                    response.writeHead(200, _ixHeaders);
+                    console.info(request.method + ' [200] ' + request.url);
+                    response.end(_ixBody);
+                };
+
+                var _ixCollector = function(err, type, database, indexMap) {
+                    if (_ixResponded) return;
+                    if (!err && indexMap) {
+                        var key = type + ':' + database;
+                        _ixResults[key] = { type: type, database: database, tables: indexMap };
+                    }
+                    if (--_ixRemaining <= 0) _ixRespond();
+                };
+
+                var _ixTimeout = setTimeout(_ixRespond, 2000);
+                process.emit('inspector#indexes', _ixCollector);
+                return;
+            }
+
             // Proxy detection - Needs to be place after /_gina/health/*
             isProxyHost = getContext('isProxyHost') || false;
             requestHost = request.headers.host || request.headers[':authority'];

package/framework/{v0.3.2 → v0.3.3}/core/server.js

@@ -27,22 +27,10 @@
  */
 //Imports.
 const fs            = require('fs');
-var _isDebugLog = function() {
-    return process.env.LOG_LEVEL === 'debug' || process.env.LOG_LEVEL === 'trace';
-};
-var _debugLog = function(msg) {
-    if (!_isDebugLog()) return;
-    var d = new Date()
-        , _m = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec']
-        , p2 = function(n) { return (n < 10 ? '0' : '') + n; };
-    fs.writeSync(2, '\u001b[90m[' + d.getFullYear() +' '+ _m[d.getMonth()] +' '+ p2(d.getDate())
-        +' '+ p2(d.getHours()) +':'+ p2(d.getMinutes()) +':'+ p2(d.getSeconds())
-        + '] [debug  ][gina:server] ' + msg + '\u001b[39m\n');
-};
 const os            = require('os');
 const path          = require('path');
 const EventEmitter  = require('events').EventEmitter;
-const swig          = require('./deps/swig-1.4.2');
+const swig          = require('@rhinostone/swig');
 const Busboy        = require('./deps/busboy-1.6.0');
 const Stream        = require('stream');
 const util          = require('util');
@@ -50,6 +38,21 @@ var https           = require('https');
 // ssl-checker dependency removed in 0.3.1 — replaced by inline verifyCertificate().
 
 
+// Lightweight debug logger — gated on LOG_LEVEL so zero cost in production.
+// Format mirrors lib/logger template: [date] [debug  ][gina:server] message
+var _isDebugLog = function() {
+    return process.env.LOG_LEVEL === 'debug' || process.env.LOG_LEVEL === 'trace';
+};
+var _debugLog = function(msg) {
+    if (!_isDebugLog()) return;
+    var _m = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'];
+    var p2 = function(n) { return (n < 10 ? '0' : '') + n; };
+    var d = new Date();
+    var ts = d.getFullYear() + ' ' + _m[d.getMonth()] + ' ' + p2(d.getDate())
+        + ' ' + p2(d.getHours()) + ':' + p2(d.getMinutes()) + ':' + p2(d.getSeconds());
+    process.stderr.write('\u001b[90m[' + ts + '] [debug  ][gina:server] ' + msg + '\u001b[39m\n');
+};
+
 var Config          = require('./config');
 var Router          = require('./router');
 var lib             = require('./../lib');
@@ -228,15 +231,11 @@ function Server(options) {
                 serverOpt.ioServer = ioServerOpt
             }
 
-            _debugLog('checkpoint I1: requiring engine ' + ((typeof (serverOpt.engine) != 'undefined' && serverOpt.engine != '') ? serverOpt.engine : 'express'));
             Engine = require('./server.' + ((typeof (serverOpt.engine) != 'undefined' && serverOpt.engine != '') ? serverOpt.engine : 'express'));
-            _debugLog('checkpoint I2: engine required, instantiating; scheme=' + serverOpt.scheme + ' protocol=' + serverOpt.protocol + ' cachePath=' + serverOpt.cachePath + ' hasCredentials=' + (typeof(serverOpt.credentials) != 'undefined') + ' hasAllRoutes=' + (typeof(options.conf.routing) != 'undefined'));
             var engine = new Engine(serverOpt);
-            _debugLog('checkpoint I3: engine instantiated');
 
             // swigEngine to render thrown HTML errors
             if ( hasViews(self.appName) ) {
-                _debugLog('checkpoint I4: initSwigEngine');
                 initSwigEngine(self.conf[self.appName][self.env]);
             }
 
@@ -249,7 +248,6 @@ function Server(options) {
                 process.env.TZ = options.conf[self.appName][self.env].content.settings.region.timeZone;
             }
 
-            _debugLog('checkpoint I5: emitting configured');
             self.emit('configured', false, engine.instance, engine.middleware, self.conf[self.appName][self.env]);
 
         } catch (err) {
@@ -2483,6 +2481,56 @@ function Server(options) {
                 return;
             }
 
+            // ── Live index introspection — JSON at /_gina/indexes in dev mode ──
+            // #QI2 — triggers inspector#indexes event; each SQL connector responds
+            // with its live index data. Collector aggregates responses from all
+            // active connectors and returns a single JSON payload.
+            if (
+                process.env.NODE_ENV_IS_DEV && process.env.NODE_ENV_IS_DEV.toLowerCase() === 'true'
+                && request.method.toUpperCase() === 'GET'
+                && /\/_gina\/indexes$/.test(request.url)
+            ) {
+                if (!process.gina._inspectorActive) process.gina._inspectorActive = true;
+
+                var _ixListenerCount = process.listenerCount('inspector#indexes');
+                if (_ixListenerCount === 0) {
+                    response.setHeader('content-type', 'application/json; charset=utf8');
+                    response.setHeader('cache-control', 'no-cache, no-store');
+                    response.setHeader('access-control-allow-origin', '*');
+                    console.info(request.method + ' [200] ' + request.url);
+                    return response.end(JSON.stringify({ connectors: {} }));
+                }
+
+                var _ixResults   = {};
+                var _ixRemaining = _ixListenerCount;
+                var _ixResponded = false;
+
+                var _ixRespond = function() {
+                    if (_ixResponded) return;
+                    _ixResponded = true;
+                    clearTimeout(_ixTimeout);
+                    var _ixBody = JSON.stringify({ connectors: _ixResults });
+                    response.setHeader('content-type', 'application/json; charset=utf8');
+                    response.setHeader('cache-control', 'no-cache, no-store');
+                    response.setHeader('access-control-allow-origin', '*');
+                    console.info(request.method + ' [200] ' + request.url);
+                    response.end(_ixBody);
+                };
+
+                var _ixCollector = function(err, type, database, indexMap) {
+                    if (_ixResponded) return;
+                    if (!err && indexMap) {
+                        var key = type + ':' + database;
+                        _ixResults[key] = { type: type, database: database, tables: indexMap };
+                    }
+                    if (--_ixRemaining <= 0) _ixRespond();
+                };
+
+                var _ixTimeout = setTimeout(_ixRespond, 2000);
+                process.emit('inspector#indexes', _ixCollector);
+                return;
+            }
+
             // Fixing an express js bug :(
             // express is trying to force : /path/dir => /path/dir/
             // which causes : /path/dir/path/dir/  <---- by trying to add a slash in the end

package/framework/{v0.3.2 → v0.3.3}/helpers/json/src/main.js

@@ -79,7 +79,20 @@ module.exports = function(){
 
         try {
             return JSON.parse(jsonStr)
-        } catch (err) {
+        } catch (firstErr) {
+            // Trailing comma tolerance: strip ,} and ,] patterns and retry
+            var _stripped = jsonStr.replace(/,(\s*[\}\]])/g, '$1');
+            if (_stripped !== jsonStr) {
+                try {
+                    var _result = JSON.parse(_stripped);
+                    console.warn('[ requireJSON ] trailing comma in `'+ filename +'` — parsed successfully but please fix the file');
+                    return _result;
+                } catch (_retryErr) {
+                    // fall through to the original error reporting below
+                }
+            }
+
+            var err = firstErr;
             var pos     = null
                 , msg   = null
                 , error = null

package/framework/{v0.3.2 → v0.3.3}/lib/cache/src/main.js

@@ -53,7 +53,7 @@ function Cache(options) {
     // LRU cap: 0 means unlimited. Overridden by from() if the shared Map carries _maxEntries.
     var maxEntries      = (options && options.maxEntries > 0) ? ~~(options.maxEntries) : 0;
     var merge           = (isGFFCtx) ? require('lib/merge') : require('../../../lib/merge');
-    var uuid            = { v4: function() { return crypto.randomUUID(); } };
+    var uuid            = (isGFFCtx) ? require('lib/uuid') : require('../../../lib/uuid');
     var Collection      = (isGFFCtx) ? require('lib/collection') : require('../../../lib/collection');
     // var EventEmitter    = (isGFFCtx) ? EventTarget : require('events').EventEmitter;
 
@@ -453,7 +453,7 @@ function Cache(options) {
 
             if ( !cache._events.setSearchOption('cacheKey', 'skipEval', true).findOne({cacheKey: cacheKey, event: cacheEvents[i]}) ) {
                 cache._events.insert({
-                    id: uuid.v4(),
+                    id: uuid(),
                     cacheKey: cacheKey,
                     event: cacheEvents[i]
                 });

package/framework/{v0.3.2 → v0.3.3}/lib/cmd/aliases.json

@@ -12,5 +12,8 @@
         "-ln" : "link",
         "--link" : "link",
         "--link-node-modules": "link-node-modules"
+    },
+    "bundle" : {
+        "oas" : "openapi"
     }
 }

package/framework/{v0.3.2 → v0.3.3}/lib/cmd/bundle/arguments.json

@@ -5,5 +5,6 @@
   "--import",
   "--replace",
   "--start-port-from",
-  "--gina-version"
+  "--gina-version",
+  "--output"
 ]

package/framework/{v0.3.2 → v0.3.3}/lib/cmd/bundle/help.txt

@@ -84,4 +84,24 @@
 
 [ Restarting all your project bundles ]
 
-    $ gina bundle:restart @<project_name>
+    $ gina bundle:restart @<project_name>
+
+
+[ Generating OpenAPI spec ]
+
+    Generate an OpenAPI 3.1.0 specification from routing.json for a bundle.
+    The spec is written to <bundle>/config/openapi.json by default.
+
+    $ gina bundle:openapi <bundle_name> @<project_name>
+
+    Generate specs for all bundles in a project
+    ----------
+    $ gina bundle:openapi @<project_name>
+
+    Write to a custom output path
+    ----------
+    $ gina bundle:openapi <bundle_name> @<project_name> --output=/path/to/spec.json
+
+    Alias
+    ----------
+    $ gina bundle:oas <bundle_name> @<project_name>

package/framework/v0.3.3/lib/cmd/bundle/oas.js

@@ -0,0 +1,6 @@
+/**
+ * @module gina/lib/cmd/bundle/oas
+ * @description Alias for {@link module:gina/lib/cmd/bundle/openapi}.
+ */
+// alias
+module.exports = require('./openapi')