gina 0.3.1 → 0.3.2

package/package.json

@@ -1,112 +1,112 @@
 {
-  "name": "gina",
-  "version": "0.3.1",
-  "description": "Node.js MVC framework with built-in HTTP/2, multi-bundle architecture, and scope-based data isolation — no Express dependency",
-  "keywords": [
-    "nodejs",
-    "framework",
-    "mvc",
-    "http2",
-    "rest-api",
-    "full-stack",
-    "server-side-rendering",
-    "event-driven",
-    "multi-bundle",
-    "couchbase",
-    "mongodb",
-    "typescript",
-    "gina",
-    "ginajs"
-  ],
-  "homepage": "https://gina.io",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gina-io/gina.git"
-  },
-  "bugs": {
-    "url": "https://github.com/gina-io/gina/issues",
-    "email": "bugs@gina.io"
-  },
-  "author": {
-    "name": "Martin-Luther ETOUMAN",
-    "email": "martin-luther.etouman@gina.io"
-  },
-  "contributors": [
-    {
-      "name": "Martin-Luther ETOUMAN",
-      "email": "martin-luther.etouman@gina.io"
+    "name": "gina",
+    "version": "0.3.2",
+    "description": "Node.js MVC framework with built-in HTTP/2, multi-bundle architecture, and scope-based data isolation — no Express dependency",
+    "keywords": [
+        "nodejs",
+        "framework",
+        "mvc",
+        "http2",
+        "rest-api",
+        "full-stack",
+        "server-side-rendering",
+        "event-driven",
+        "multi-bundle",
+        "couchbase",
+        "mongodb",
+        "typescript",
+        "gina",
+        "ginajs"
+    ],
+    "homepage": "https://gina.io",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/gina-io/gina.git"
     },
-    {
-      "name": "Fabrice DELANEAU",
-      "email": "fabrice.delaneau@gina.io",
-      "url": "https://fdelaneau.com"
-    }
-  ],
-  "copyright": "Copyright (c) 2009-2026 Rhinostone <contact@gina.io>",
-  "engine": {
-    "node": ">= 22 <26"
-  },
-  "config": {
-    "optionalPrefix": "~/.npm-global",
-    "prefix": "/usr/local",
-    "globalMode": true
-  },
-  "bin": {
-    "gina": "bin/gina",
-    "gina-container": "bin/gina-container",
-    "gina-init": "bin/gina-init"
-  },
-  "main": "./framework/v0.3.1/core/gna",
-  "scripts": {
-    "test": "node --test test*.test.js",
-    "prepare": "node script/prepare_version.js",
-    "postpublish": "node script/post_publish.js",
-    "preinstall": "node script/pre_install.js",
-    "postinstall": "node script/post_install.js"
-  },
-  "license": "MIT",
-  "readmeFilename": "README.md",
-  "dependencies": {
-    "engine.io": "^6.0.0"
-  },
-  "devDependencies": {
-    "engine.io-client": "^6.6.3",
-    "requirejs": "^2.3.7"
-  },
-  "peerDependencies": {
-    "@anthropic-ai/sdk": ">=0.27.0",
-    "@scylladb/scylla-driver": ">=1.0.0",
-    "couchbase": ">=3.0.0",
-    "ioredis": ">=5.0.0",
-    "mongodb": ">=5.0.0",
-    "mysql2": ">=2.0.0",
-    "openai": ">=4.0.0",
-    "pg": ">=8.0.0"
-  },
-  "peerDependenciesMeta": {
-    "couchbase": {
-      "optional": true
+    "bugs": {
+        "url": "https://github.com/gina-io/gina/issues",
+        "email": "bugs@gina.io"
+    },
+    "author": {
+        "name": "Martin-Luther ETOUMAN",
+        "email": "martin-luther.etouman@gina.io"
+    },
+    "contributors": [
+        {
+            "name": "Martin-Luther ETOUMAN",
+            "email": "martin-luther.etouman@gina.io"
+        },
+        {
+            "name": "Fabrice DELANEAU",
+            "email": "fabrice.delaneau@gina.io",
+            "url": "https://fdelaneau.com"
+        }
+    ],
+    "copyright": "Copyright (c) 2009-2026 Rhinostone <contact@gina.io>",
+    "engine": {
+        "node": ">= 22 <26"
     },
-    "ioredis": {
-      "optional": true
+    "config": {
+        "optionalPrefix": "~/.npm-global",
+        "prefix": "~/.npm-global",
+        "globalMode": true
     },
-    "mysql2": {
-      "optional": true
+    "bin": {
+        "gina": "bin/gina",
+        "gina-container": "bin/gina-container",
+        "gina-init": "bin/gina-init"
     },
-    "pg": {
-      "optional": true
+    "main": "./framework/v0.3.2/core/gna",
+    "scripts": {
+        "test": "node --test test*.test.js",
+        "prepare": "node script/prepare_version.js",
+        "postpublish": "node script/post_publish.js",
+        "preinstall": "node script/pre_install.js",
+        "postinstall": "node script/post_install.js"
     },
-    "mongodb": {
-      "optional": true
+    "license": "MIT",
+    "readmeFilename": "README.md",
+    "dependencies": {
+        "engine.io": "^6.0.0"
     },
-    "@scylladb/scylla-driver": {
-      "optional": true
+    "devDependencies": {
+        "engine.io-client": "^6.6.3",
+        "requirejs": "^2.3.7"
     },
-    "openai": {
-      "optional": true
+    "peerDependencies": {
+        "@anthropic-ai/sdk": ">=0.27.0",
+        "@scylladb/scylla-driver": ">=1.0.0",
+        "couchbase": ">=3.0.0",
+        "ioredis": ">=5.0.0",
+        "mongodb": ">=5.0.0",
+        "mysql2": ">=2.0.0",
+        "openai": ">=4.0.0",
+        "pg": ">=8.0.0"
     },
-    "@anthropic-ai/sdk": {
-      "optional": true
+    "peerDependenciesMeta": {
+        "couchbase": {
+            "optional": true
+        },
+        "ioredis": {
+            "optional": true
+        },
+        "mysql2": {
+            "optional": true
+        },
+        "pg": {
+            "optional": true
+        },
+        "mongodb": {
+            "optional": true
+        },
+        "@scylladb/scylla-driver": {
+            "optional": true
+        },
+        "openai": {
+            "optional": true
+        },
+        "@anthropic-ai/sdk": {
+            "optional": true
+        }
     }
-  }
 }

package/schema/connectors.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://gina.io/schema/connectors.json",
   "title": "Gina connectors.json",
-  "description": "Database connector declarations for a Gina bundle. Each key is a logical connector name (e.g. \"couchbase\", \"session\"); the value describes the connection parameters. Acquired at runtime via getConnection().",
+  "description": "Database and service connector declarations for a Gina bundle. Each key is a logical connector name; the value describes the connection parameters. Acquired at runtime via getConnection(). The required fields depend on the connector type.",
   "type": "object",
   "additionalProperties": {
     "$ref": "#/definitions/connector"
@@ -10,27 +10,31 @@
   "definitions": {
     "connector": {
       "type": "object",
-      "required": ["protocol", "host", "database"],
       "additionalProperties": true,
       "properties": {
         "connector": {
           "type": "string",
-          "description": "Connector type override. Required when the key does not match a built-in connector name.",
-          "examples": ["couchbase"]
+          "description": "Connector driver type. Required when the key name does not match a built-in connector name (e.g. key \"session\" with connector \"redis\").",
+          "enum": ["couchbase", "mysql", "postgresql", "sqlite", "redis", "ai"]
         },
         "protocol": {
           "type": "string",
-          "description": "Connection protocol URI scheme.",
-          "examples": ["couchbase://", "redis://", "sqlite://", "mysql://", "postgres://"]
+          "description": "Connection protocol URI scheme. Required for Couchbase and AI connectors.",
+          "examples": ["couchbase://", "mysql://", "postgres://", "redis://", "anthropic://", "openai://"]
         },
         "host": {
           "type": "string",
-          "description": "Hostname or IP address of the database server. Supports comma-separated values for clusters and ${variable} interpolation.",
+          "description": "Hostname or IP address. Supports comma-separated values for clusters and ${variable} interpolation. Required for Couchbase, MySQL, PostgreSQL, Redis.",
           "examples": ["127.0.0.1", "db1.example.com,db2.example.com"]
         },
+        "port": {
+          "type": ["number", "string"],
+          "description": "Server port. Defaults: MySQL 3306, PostgreSQL 5432, Redis 6379.",
+          "examples": [3306, 5432, 6379]
+        },
         "database": {
           "type": "string",
-          "description": "Database or bucket name."
+          "description": "Database, bucket, or keyspace name. Also used as the model directory name under models/. Required for Couchbase, MySQL, PostgreSQL, SQLite."
         },
         "username": {
           "type": "string",
@@ -45,17 +49,100 @@
           "description": "Data isolation scope stamped on every document at insert time and used to filter queries. Falls back to NODE_SCOPE env var when omitted.",
           "enum": ["local", "beta", "production", "testing"]
         },
-        "ping": {
+        "connectionLimit": {
+          "type": "number",
+          "description": "Maximum connections in the pool. MySQL and PostgreSQL only. Defaults to 10.",
+          "default": 10
+        },
+        "ssl": {
+          "type": ["object", "boolean"],
+          "description": "TLS/SSL configuration. Passed through to the underlying driver (mysql2, pg). Set to true for default TLS.",
+          "additionalProperties": true
+        },
+        "file": {
+          "type": "string",
+          "description": "SQLite only. Database file path. Defaults to ~/.gina/{version}/{database}.sqlite. Use \":memory:\" for in-memory databases.",
+          "examples": [":memory:", "/data/app.sqlite"]
+        },
+        "idleTimeout": {
+          "type": "number",
+          "description": "PostgreSQL only. Idle client timeout in milliseconds. Defaults to 30000.",
+          "default": 30000
+        },
+        "connectionTimeout": {
+          "type": "number",
+          "description": "PostgreSQL only. Connection timeout in milliseconds. Defaults to 2000.",
+          "default": 2000
+        },
+        "db": {
+          "type": "number",
+          "description": "Redis only. Database index (0-15). Defaults to 0.",
+          "default": 0
+        },
+        "tls": {
+          "type": "boolean",
+          "description": "Redis only. Enable TLS for the connection."
+        },
+        "prefix": {
           "type": "string",
-          "description": "Interval to ping the cluster and verify connectivity (e.g. \"2m\", \"30s\")."
+          "description": "Redis only. Key prefix for session store entries. Defaults to \"sess:\".",
+          "default": "sess:"
+        },
+        "ttl": {
+          "type": "number",
+          "description": "Redis only. Default TTL in seconds for session entries. Defaults to 86400.",
+          "default": 86400
+        },
+        "cluster": {
+          "type": "array",
+          "description": "Redis Cluster only. Array of cluster node endpoints.",
+          "items": {
+            "type": "object",
+            "required": ["host", "port"],
+            "properties": {
+              "host": { "type": "string" },
+              "port": { "type": "number" }
+            }
+          }
+        },
+        "keepAlive": {
+          "type": "boolean",
+          "description": "Couchbase only. Enable TCP keep-alive. Defaults to true.",
+          "default": true
         },
         "pingInterval": {
           "type": "string",
-          "description": "Alias for ping. Interval to keep the connection alive (e.g. \"2m\", \"30s\")."
+          "description": "Couchbase only. Interval to keep the connection alive (e.g. \"2m\", \"30s\").",
+          "examples": ["2m", "30s", "1h"]
+        },
+        "useScopeAndCollections": {
+          "type": "boolean",
+          "description": "Couchbase only. Enable scope and collection support (SDK v3+). Defaults to true.",
+          "default": true
+        },
+        "timeouts": {
+          "type": "object",
+          "description": "Couchbase only. Timeout overrides passed to the SDK.",
+          "additionalProperties": { "type": "number" },
+          "examples": [{ "kvTimeout": 10000 }]
         },
         "detailed_errcodes": {
           "type": "boolean",
-          "description": "When true, exposes detailed Couchbase error codes in error objects instead of generic messages."
+          "description": "Couchbase only. Expose detailed error codes instead of generic messages."
+        },
+        "apiKey": {
+          "type": "string",
+          "description": "AI connector only. API key for the provider. Supports ${ENV_VAR} interpolation.",
+          "examples": ["${ANTHROPIC_API_KEY}", "${OPENAI_API_KEY}"]
+        },
+        "model": {
+          "type": "string",
+          "description": "AI connector only. Default model identifier.",
+          "examples": ["claude-sonnet-4-20250514", "gpt-4o", "deepseek-chat"]
+        },
+        "baseURL": {
+          "type": "string",
+          "description": "AI connector only. Override the default API base URL (OpenAI-compatible providers)."
         }
       }
     }

package/schema/routing.json

@@ -15,23 +15,24 @@
       "properties": {
         "namespace": {
           "type": "string",
-          "description": "Groups routes under a shared URL prefix and controller namespace (e.g. \"account\" maps to AccountController)."
+          "description": "Controller namespace. Maps to controller.<namespace>.js. Groups related routes under the same controller file."
         },
         "url": {
           "type": "string",
-          "description": "URL pattern. Use :param for named segments. Multiple patterns can be comma-separated (e.g. \"/item/:id, /item/:id/:slug\")."
+          "description": "URL pattern. Use :param for named segments. Multiple patterns can be comma-separated (e.g. \"/item/:id, /item/:id/:slug\"). The webroot is prepended automatically unless param.ignoreWebRoot is set."
         },
         "method": {
           "type": "string",
           "description": "Accepted HTTP method(s), comma-separated. Case-insensitive.",
-          "examples": ["GET", "POST", "PUT", "DELETE", "GET, POST", "GET, POST, PUT"]
+          "examples": ["GET", "POST", "PUT", "DELETE", "GET, POST", "GET, POST, PUT, DELETE"]
         },
         "requirements": {
           "type": "object",
-          "description": "Regex validation patterns for URL parameters. Keys match :param names. Values are regex strings (e.g. \"/^[0-9a-f]{8}-/i\").",
+          "description": "Validation patterns for URL parameters. Keys match :param names. Values are regex strings (prefixed with \"/\") or validator references (prefixed with \"validator::\").",
           "additionalProperties": {
             "type": "string"
-          }
+          },
+          "examples": [{ "id": "/^[0-9a-f]{8}-/i" }, { "slug": "/^[a-z0-9-]+$/" }]
         },
         "param": {
           "type": "object",
@@ -45,7 +46,24 @@
             },
             "file": {
               "type": "string",
-              "description": "Template file path relative to the bundle views directory (without extension)."
+              "description": "Template file path relative to the bundle views directory (without extension). Defaults to the route name."
+            },
+            "path": {
+              "type": "string",
+              "description": "Redirect target path. Used with control: \"redirect\"."
+            },
+            "code": {
+              "type": "number",
+              "description": "HTTP status code for redirects (e.g. 301, 302).",
+              "examples": [301, 302]
+            },
+            "ignoreWebRoot": {
+              "type": "boolean",
+              "description": "When true, the bundle webroot prefix is not prepended to the URL."
+            },
+            "title": {
+              "type": "string",
+              "description": "Page title passed to the template."
             },
             "isPopinContext": {
               "type": "boolean",
@@ -61,9 +79,77 @@
             "examples": ["middlewares.passport.jwtLogin", "middlewares.global.requirePasswordCheck"]
           }
         },
+        "middlewareIgnored": {
+          "type": "array",
+          "description": "Middleware names to skip for this route (overrides global middleware).",
+          "items": {
+            "type": "string"
+          }
+        },
+        "bundle": {
+          "type": "string",
+          "description": "Target bundle name for cross-bundle routing. The request is proxied to the named bundle."
+        },
+        "hostname": {
+          "type": "string",
+          "description": "Override target hostname for cross-bundle or external routing."
+        },
+        "scopes": {
+          "type": "array",
+          "description": "Allowed scopes for this route. Defaults to the current bundle scope.",
+          "items": {
+            "type": "string",
+            "enum": ["local", "beta", "production", "testing"]
+          }
+        },
+        "cache": {
+          "description": "Response caching configuration. Use a string for the cache type shorthand, or an object for full control.",
+          "oneOf": [
+            {
+              "type": "string",
+              "enum": ["memory", "fs"],
+              "description": "Cache type shorthand."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": ["memory", "fs"],
+                  "description": "Cache backend."
+                },
+                "ttl": {
+                  "type": "number",
+                  "description": "Time-to-live in seconds."
+                },
+                "visibility": {
+                  "type": "string",
+                  "enum": ["public", "private"],
+                  "description": "Cache-Control visibility directive. Defaults to \"private\".",
+                  "default": "private"
+                },
+                "sliding": {
+                  "type": "boolean",
+                  "description": "Enable sliding window eviction. Defaults to false.",
+                  "default": false
+                },
+                "maxAge": {
+                  "type": "number",
+                  "description": "Absolute ceiling in seconds when sliding is enabled."
+                },
+                "invalidateOnEvents": {
+                  "type": "array",
+                  "description": "Event names that invalidate the cached response.",
+                  "items": { "type": "string" }
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
         "_comment": {
           "type": "string",
-          "description": "Internal documentation comment. Ignored at runtime."
+          "description": "Internal documentation comment. Stripped at server init."
         },
         "_sample": {
           "type": "string",

package/schema/watchers.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://gina.io/schema/watchers.json",
+  "title": "Gina watchers.json",
+  "description": "File watcher declarations for a Gina bundle. Each key is a config file name to watch (relative to the bundle config directory); the value defines the fs.watch options. Watched files trigger callbacks registered via gna.watcher.on(name, cb).",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/definitions/watcherEntry"
+  },
+  "definitions": {
+    "watcherEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "event": {
+          "type": "string",
+          "description": "The fs.watch event type to listen for.",
+          "enum": ["change", "rename"],
+          "default": "change"
+        },
+        "persistent": {
+          "type": "boolean",
+          "description": "Whether the watcher should keep the Node.js process alive. Defaults to false.",
+          "default": false
+        }
+      }
+    }
+  }
+}

package/script/post_install.js

@@ -732,7 +732,11 @@ function PostInstall() {
             cmd = ginaBinanry + ' framework:set --global-mode='+ self.isGlobalInstall;
             console.info('Running: '+ cmd);
             console.debug(execSync(cmd));
-            cmd = ginaBinanry + ' framework:set --prefix='+ self.prefix;
+            // Always use defaultPrefix (npm config get prefix) for the global
+            // settings — self.prefix gets overridden to INIT_CWD for local
+            // installs (line 154), which would corrupt ~/.gina/*/settings.json
+            // with the project directory instead of the npm global prefix.
+            cmd = ginaBinanry + ' framework:set --prefix='+ self.defaultPrefix;
             console.info('Running: '+ cmd);
             console.debug(execSync(cmd));
         } catch (err) {

package/framework/v0.3.1/VERSION

@@ -1 +0,0 @@
-0.3.1