@zintrust/core 0.1.18 → 0.1.20

package/README.md

@@ -1,11 +1,11 @@
-# Getting Started with Zintrust
+# Getting Started with ZinTrust
 
-Welcome to Zintrust, a production-grade TypeScript backend framework with proven architectural patterns and a minimal core (no Express/Fastify). The published npm package also includes a few runtime dependencies for the CLI and developer experience.
+Welcome to ZinTrust, a production-grade TypeScript backend framework with proven architectural patterns and a minimal core (no Express/Fastify). The published npm package also includes a few runtime dependencies for the CLI and developer experience.
 
 ## Quick Start (2 minutes)
 
 ```bash
-# Install @zintrust/core (Zintrust CLI)
+# Install @zintrust/core (ZinTrust CLI)
 npm install -g @zintrust/core
 
 # Create a new project
@@ -21,11 +21,17 @@ zin start
 
 Your API is now running at `http://localhost:7777`
 
+If you’re targeting a different runtime:
+
+- Cloudflare Workers (Wrangler): `zin start --wg`
+- AWS Lambda adapter mode: `zin start --lambda`
+- Deno adapter mode: `zin start --deno`
+
 The canonical CLI is `zin`. `z` is a shorthand alias.
 
 ## Install adapters (database/cache/etc.)
 
-Zintrust keeps the core package minimal. Integrations like database drivers are installed explicitly via adapter packages.
+ZinTrust keeps the core package minimal. Integrations like database drivers are installed explicitly via adapter packages.
 
 ```bash
 # Database adapters
@@ -35,9 +41,9 @@ zin add db:mysql     # @zintrust/db-mysql
 zin add db:mssql     # @zintrust/db-sqlserver
 ```
 
-## What is Zintrust?
+## What is ZinTrust?
 
-Zintrust is a **minimal-core** backend framework built on:
+ZinTrust is a **minimal-core** backend framework built on:
 
 - ✅ **Pure Node.js** - No Express, Fastify, or external HTTP libraries
 - ✅ **Type-Safe** - Strict TypeScript with 100% type coverage
@@ -82,7 +88,7 @@ Zintrust is a **minimal-core** backend framework built on:
 
 ### From npm (Recommended)
 
-Zintrust is distributed on npm as `@zintrust/core`.
+ZinTrust is distributed on npm as `@zintrust/core`.
 
 ```bash
 npm install -g @zintrust/core
@@ -108,7 +114,7 @@ bun add -g @zintrust/core
 ### From source
 
 ```bash
-git clone https://github.com/ZinTrust/ZinTrust.git
+git clone https://github.com/ZinTrust /ZinTrust .git
 cd ZinTrust
 npm install
 npm run build
@@ -194,7 +200,7 @@ curl -X POST http://localhost:7777/api/users \
 
 ## Architecture Overview
 
-Zintrust uses a proven layered architecture:
+ZinTrust uses a proven layered architecture:
 
 ```
 ┌─────────────────────────────────┐
@@ -223,7 +229,7 @@ Zintrust uses a proven layered architecture:
 - 📚 [Documentation](https://zintrust.com)
 - 💬 [Discord Community](https://discord.gg/zintrust)
 - 🐦 [Follow on X](https://x.com/zintrust)
-- 🐛 [Issue Tracker](https://github.com/ZinTrust/ZinTrust/issues)
+- 🐛 [Issue Tracker](https://github.com/ZinTrust /ZinTrust /issues)
 - 🤝 [Contributing Guide](./contributing.md)
 
 ## License

package/bin/zintrust-main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgFH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAiCzC;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgFH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CzC;AAED,OAAO,EAAE,CAAC"}

package/bin/zintrust-main.js

@@ -78,6 +78,15 @@ export async function run() {
         }
         const { EnvFileLoader } = await import('../src/cli/utils/EnvFileLoader.js');
         EnvFileLoader.ensureLoaded();
+        // Ensure project-installed adapters/drivers are registered for CLI commands.
+        // (This is driven by src/zintrust.plugins.ts generated by `zin plugin install`.)
+        try {
+            const { PluginAutoImports } = await import('../src/runtime/PluginAutoImports.js');
+            await PluginAutoImports.tryImportProjectAutoImports();
+        }
+        catch {
+            // best-effort; CLI should still run even if plugins file is missing
+        }
         const { CLI } = await import('../src/cli/CLI.js');
         const cli = CLI.create();
         // When executing via tsx (e.g. `npx tsx bin/zin.ts ...`), the script path can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -18,17 +18,25 @@
       "types": "./src/index.d.ts",
       "import": "./src/index.js"
     },
+    "./start": {
+      "types": "./src/start.d.ts",
+      "import": "./src/start.js"
+    },
     "./node": {
       "types": "./src/node.d.ts",
       "import": "./src/node.js"
     },
+    "./routes/*": {
+      "types": "./routes/*.d.ts",
+      "import": "./routes/*.js"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
     "bcrypt": "^6.0.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
-    "inquirer": "^13.1.0",
+    "inquirer": "^13.2.0",
     "jsonwebtoken": "^9.0.3"
   },
   "overrides": {
@@ -45,6 +53,7 @@
   "files": [
     "bin",
     "src",
+    "routes",
     "public"
   ],
   "engines": {

package/public/error-pages/404.html

@@ -0,0 +1,145 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{statusCode}} • {{errorName}}</title>
+    <link rel="stylesheet" href="/error-pages/error.css" />
+    <script defer src="/error-pages/error.js"></script>
+  </head>
+  <body>
+    <div id="layout">
+      <header id="header">
+        <div id="header-actions">
+          <div id="toggle-theme-container">
+            <input type="checkbox" id="toggle-theme-checkbox" />
+            <label id="toggle-theme-label" for="toggle-theme-checkbox">
+              <span id="light-theme-indicator" title="Light mode">
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="15"
+                  height="15"
+                  viewBox="0 0 24 24"
+                  stroke-width="2"
+                  stroke="currentColor"
+                  fill="none"
+                  stroke-linecap="round"
+                  stroke-linejoin="round"
+                >
+                  <path d="M0 0h24v24H0z" stroke="none"></path>
+                  <circle cx="12" cy="12" r="4"></circle>
+                  <path
+                    d="M3 12h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"
+                  ></path>
+                </svg>
+              </span>
+              <span id="dark-theme-indicator" title="Dark mode">
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="15"
+                  height="15"
+                  viewBox="0 0 24 24"
+                  stroke-width="2"
+                  stroke="currentColor"
+                  fill="none"
+                  stroke-linecap="round"
+                  stroke-linejoin="round"
+                >
+                  <path d="M0 0h24v24H0z" stroke="none"></path>
+                  <path d="M12 3h.393a7.5 7.5 0 0 0 7.92 12.446A9 9 0 1 1 12 2.992z"></path>
+                </svg>
+              </span>
+            </label>
+          </div>
+        </div>
+      </header>
+
+      <section>
+        <h4 id="error-name">{{errorName}}</h4>
+        <h1 id="error-title">That route doesn’t exist.</h1>
+      </section>
+
+      <section>
+        <div class="card">
+          <div class="card-body">
+            <h2 id="error-message">
+              <span>
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="24"
+                  height="24"
+                  fill="none"
+                >
+                  <path
+                    stroke="currentColor"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    stroke-width="2"
+                    d="M12 7v6m0 4.01.01-.011M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10Z"
+                  ></path>
+                </svg>
+              </span>
+              <span>{{errorMessage}}</span>
+            </h2>
+
+            <div id="error-hint">
+              <span>
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="24"
+                  height="24"
+                  fill="none"
+                >
+                  <path
+                    stroke="currentColor"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    stroke-width="1.5"
+                    d="m21 2-1 1M3 2l1 1m17 13-1-1M3 16l1-1m5 3h6m-5 3h4M12 3C8 3 5.952 4.95 6 8c.023 1.487.5 2.5 1.5 3.5S9 13 9 15h6c0-2 .5-2.5 1.5-3.5h0c1-1 1.477-2.013 1.5-3.5.048-3.05-2-5-6-5Z"
+                  ></path>
+                </svg>
+              </span>
+              <span> Try the docs or check your route file. </span>
+            </div>
+
+            <div class="pills">
+              <span class="pill"><b>Status</b> {{statusCode}}</span>
+              <span class="pill"><b>Path</b> {{requestPath}}</span>
+              <a class="pill" href="/doc"><b>Open</b> Docs</a>
+            </div>
+
+            <pre class="code">
+Next steps:
+- Visit /doc for routes + reference
+- If this is an API endpoint, double-check routes/api.ts registration
+- Run: zin routes</pre
+            >
+          </div>
+        </div>
+      </section>
+
+      <section>
+        <div class="footer">
+          <div class="brand">
+            <div class="logo-frame" aria-hidden="true">
+              <img class="logo-img" src="/zintrust.svg" alt="ZinTrust logo" />
+            </div>
+            <div>
+              <b>ZinTrust</b>
+              <div><span>https://zintrust.com</span></div>
+            </div>
+          </div>
+          <div>
+            <a href="/">Home</a>
+            <span> · </span>
+            <a href="/doc">Docs</a>
+          </div>
+        </div>
+      </section>
+    </div>
+  </body>
+</html>

package/public/error-pages/500.html

@@ -0,0 +1,266 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{statusCode}} • {{errorName}}</title>
+    <link rel="stylesheet" href="/error-pages/error.css" />
+    <script defer src="/error-pages/error.js"></script>
+  </head>
+  <body>
+    <div id="layout">
+      <header id="header">
+        <div id="header-actions">
+          <div id="toggle-theme-container">
+            <input
+              type="checkbox"
+              id="toggle-theme-checkbox"
+              name="toggle-theme"
+              aria-label="Toggle theme"
+            />
+            <label id="toggle-theme-label" for="toggle-theme-checkbox">
+              <span id="light-theme-indicator" title="Light mode">
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="15"
+                  height="15"
+                  viewBox="0 0 24 24"
+                  stroke-width="2"
+                  stroke="currentColor"
+                  fill="none"
+                  stroke-linecap="round"
+                  stroke-linejoin="round"
+                >
+                  <path d="M0 0h24v24H0z" stroke="none"></path>
+                  <circle cx="12" cy="12" r="4"></circle>
+                  <path
+                    d="M3 12h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"
+                  ></path>
+                </svg>
+              </span>
+              <span id="dark-theme-indicator" title="Dark mode">
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="15"
+                  height="15"
+                  viewBox="0 0 24 24"
+                  stroke-width="2"
+                  stroke="currentColor"
+                  fill="none"
+                  stroke-linecap="round"
+                  stroke-linejoin="round"
+                >
+                  <path d="M0 0h24v24H0z" stroke="none"></path>
+                  <path d="M12 3h.393a7.5 7.5 0 0 0 7.92 12.446A9 9 0 1 1 12 2.992z"></path>
+                </svg>
+              </span>
+            </label>
+          </div>
+        </div>
+      </header>
+
+      <section>
+        <h4 id="error-name">{{errorName}}</h4>
+        <h1 id="error-title">An error has occurred</h1>
+      </section>
+
+      <section>
+        <div class="card">
+          <div class="card-body">
+            <h2 id="error-message">
+              <span>
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="24"
+                  height="24"
+                  fill="none"
+                >
+                  <path
+                    stroke="currentColor"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    stroke-width="2"
+                    d="M12 7v6m0 4.01.01-.011M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10Z"
+                  ></path>
+                </svg>
+              </span>
+              <span>{{errorMessage}}</span>
+            </h2>
+
+            <div id="error-hint">
+              <span>
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  aria-hidden="true"
+                  width="24"
+                  height="24"
+                  fill="none"
+                >
+                  <path
+                    stroke="currentColor"
+                    stroke-linecap="round"
+                    stroke-linejoin="round"
+                    stroke-width="1.5"
+                    d="m21 2-1 1M3 2l1 1m17 13-1-1M3 16l1-1m5 3h6m-5 3h4M12 3C8 3 5.952 4.95 6 8c.023 1.487.5 2.5 1.5 3.5S9 13 9 15h6c0-2 .5-2.5 1.5-3.5h0c1-1 1.477-2.013 1.5-3.5.048-3.05-2-5-6-5Z"
+                  ></path>
+                </svg>
+              </span>
+              <span> Don’t panic — most 500s are config or missing env vars. </span>
+            </div>
+
+            <div class="pills">
+              <span class="pill"><b>Status</b> {{statusCode}}</span>
+              <span class="pill"><b>Path</b> {{requestPath}}</span>
+              <a class="pill" href="/doc"><b>📚</b> Docs</a>
+              <a class="pill" href="https://zintrust.com" target="_blank" rel="noreferrer"
+                ><b>🌐</b> Site</a
+              >
+              <a
+                class="pill"
+                href="https://github.com/orgs/ZinTrust/discussions"
+                target="_blank"
+                rel="noreferrer"
+                ><b>💬</b> Discussions</a
+              >
+            </div>
+
+            <pre class="code">
+Debug flow:
+- Check logs for the first error cause
+- Run: zin qa
+- Verify env: APP_KEY, DB_CONNECTION, JWT_SECRET (if enabled)</pre
+            >
+          </div>
+        </div>
+      </section>
+
+      <section class="optional-section" data-hide-when-empty="#stack-pretty,#stack-raw">
+        <div class="card">
+          <div class="card-heading">
+            <h3 class="card-title">Stack Trace</h3>
+            <div class="tabset" data-tabset role="tablist" aria-label="Stack Trace format">
+              <button
+                class="tab"
+                type="button"
+                role="tab"
+                id="stack-tab-pretty"
+                data-tab="pretty"
+                aria-selected="true"
+                aria-controls="stack-pretty"
+              >
+                Pretty
+              </button>
+              <button
+                class="tab"
+                type="button"
+                role="tab"
+                id="stack-tab-raw"
+                data-tab="raw"
+                aria-selected="false"
+                aria-controls="stack-raw"
+              >
+                Raw
+              </button>
+            </div>
+          </div>
+          <div class="card-body">
+            <pre
+              class="code tab-panel"
+              id="stack-pretty"
+              data-panel="pretty"
+              role="tabpanel"
+              aria-labelledby="stack-tab-pretty"
+            >
+{{stackPretty}}</pre
+            >
+            <pre
+              class="code tab-panel"
+              id="stack-raw"
+              data-panel="raw"
+              role="tabpanel"
+              aria-labelledby="stack-tab-raw"
+              hidden
+            >
+{{stackRaw}}</pre
+            >
+          </div>
+        </div>
+      </section>
+
+      <section class="optional-section" data-hide-when-empty="#request-pretty,#request-raw">
+        <div class="card">
+          <div class="card-heading">
+            <h3 class="card-title">Request</h3>
+            <div class="tabset" data-tabset role="tablist" aria-label="Request format">
+              <button
+                class="tab"
+                type="button"
+                role="tab"
+                id="request-tab-pretty"
+                data-tab="pretty"
+                aria-selected="true"
+                aria-controls="request-pretty"
+              >
+                Pretty
+              </button>
+              <button
+                class="tab"
+                type="button"
+                role="tab"
+                id="request-tab-raw"
+                data-tab="raw"
+                aria-selected="false"
+                aria-controls="request-raw"
+              >
+                Raw
+              </button>
+            </div>
+          </div>
+          <div class="card-body">
+            <pre
+              class="code tab-panel"
+              id="request-pretty"
+              data-panel="pretty"
+              role="tabpanel"
+              aria-labelledby="request-tab-pretty"
+            >
+{{requestPretty}}</pre
+            >
+            <pre
+              class="code tab-panel"
+              id="request-raw"
+              data-panel="raw"
+              role="tabpanel"
+              aria-labelledby="request-tab-raw"
+              hidden
+            >
+{{requestRaw}}</pre
+            >
+          </div>
+        </div>
+      </section>
+
+      <section>
+        <div class="footer">
+          <div class="brand">
+            <div class="logo-frame" aria-hidden="true">
+              <img class="logo-img" src="/zintrust.svg" alt="ZinTrust logo" />
+            </div>
+            <div>
+              <b>ZinTrust</b>
+              <div><span>https://zintrust.com</span></div>
+            </div>
+          </div>
+          <div>
+            <a href="/">Home</a>
+            <span> · </span>
+            <a href="/doc">Docs</a>
+          </div>
+        </div>
+      </section>
+    </div>
+  </body>
+</html>