@zintrust/core 0.1.17 → 0.1.19

package/README.md

@@ -21,6 +21,12 @@ 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.)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -18,10 +18,18 @@
       "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": {
@@ -45,6 +53,7 @@
   "files": [
     "bin",
     "src",
+    "routes",
     "public"
   ],
   "engines": {

package/public/index.html

@@ -423,7 +423,7 @@
             'zin --version',
             'zin new my-api',
             'cd my-api',
-            'npm run dev',
+            'zin start',
             'curl http://localhost:3000/health',
             'zin debug',
           ],

package/routes/api.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Example Routes
+ * Demonstrates routing patterns
+ */
+import { type IRouter } from '../src/routing/Router';
+export declare function registerRoutes(router: IRouter): void;
+//# sourceMappingURL=api.d.ts.map

package/routes/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../routes/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAKpD"}

package/routes/api.js

@@ -0,0 +1,91 @@
+/**
+ * Example Routes
+ * Demonstrates routing patterns
+ */
+import { UserController } from '../app/Controllers/UserController.js';
+import { Env } from '../src/config/env.js';
+import { registerBroadcastRoutes } from './broadcast.js';
+import { registerHealthRoutes } from './health.js';
+import { registerStorageRoutes } from './storage.js';
+import { Router } from '../src/routing/Router.js';
+export function registerRoutes(router) {
+    const userController = UserController.create();
+    registerPublicRoutes(router);
+    registerApiV1Routes(router, userController);
+    registerAdminRoutes(router);
+}
+/**
+ * Register public routes
+ */
+function registerPublicRoutes(router) {
+    registerRootRoute(router);
+    registerHealthRoutes(router);
+    registerBroadcastRoutes(router);
+    registerStorageRoutes(router);
+}
+function registerRootRoute(router) {
+    Router.get(router, '/', async (_req, res) => {
+        res.json({
+            framework: 'Zintrust Framework',
+            app_name: Env.APP_NAME,
+            version: '0.1.0',
+            env: Env.NODE_ENV ?? 'development',
+            database: Env.DB_CONNECTION ?? 'sqlite',
+        });
+    });
+}
+/**
+ * Register API V1 routes
+ */
+function registerApiV1Routes(router, userController) {
+    Router.group(router, '/api/v1', (r) => {
+        // Auth routes
+        Router.post(r, '/auth/login', async (_req, res) => {
+            res.json({ message: 'Login endpoint' });
+        });
+        Router.post(r, '/auth/register', async (_req, res) => {
+            res.json({ message: 'Register endpoint' });
+        });
+        // Protected routes (middleware is not modeled in Router.ts yet)
+        const pr = r;
+        // User resource (REST-ish)
+        Router.resource(pr, '/users', {
+            index: userController.index,
+            store: userController.store,
+            show: userController.show,
+            update: userController.update,
+            destroy: userController.destroy,
+        });
+        // If the controller exposes create/edit, wire them explicitly.
+        Router.get(pr, '/users/create', userController.create);
+        Router.get(pr, '/users/:id/edit', userController.edit);
+        // Custom user routes
+        Router.get(pr, '/profile', async (_req, res) => {
+            res.json({ message: 'Get user profile' });
+        });
+        Router.put(pr, '/profile', async (_req, res) => {
+            res.json({ message: 'Update user profile' });
+        });
+        // Posts resource
+        Router.get(r, '/posts', async (_req, res) => {
+            res.json({ data: [] });
+        });
+        Router.get(r, '/posts/:id', async (req, res) => {
+            const id = req.getParam('id');
+            res.json({ data: { id } });
+        });
+    });
+}
+/**
+ * Register admin routes
+ */
+function registerAdminRoutes(router) {
+    Router.group(router, '/admin', (r) => {
+        Router.get(r, '/dashboard', async (_req, res) => {
+            res.json({ message: 'Admin dashboard' });
+        });
+        Router.get(r, '/users', async (_req, res) => {
+            res.json({ data: [] });
+        });
+    });
+}

package/routes/broadcast.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Broadcast Routes
+ *
+ * Runtime-only endpoints for broadcast.
+ * Provider setup and secret provisioning remain CLI-only.
+ */
+import { type IRouter } from '../src/routing/Router';
+export declare function registerBroadcastRoutes(router: IRouter): void;
+//# sourceMappingURL=broadcast.d.ts.map

package/routes/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../routes/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAsB7D"}

package/routes/broadcast.js

@@ -0,0 +1,27 @@
+/**
+ * Broadcast Routes
+ *
+ * Runtime-only endpoints for broadcast.
+ * Provider setup and secret provisioning remain CLI-only.
+ */
+import { Router } from '../src/routing/Router.js';
+export function registerBroadcastRoutes(router) {
+    Router.get(router, '/broadcast/health', async (_req, res) => {
+        res.json({ ok: true });
+    });
+    Router.post(router, '/broadcast/send', async (req, res) => {
+        const body = (req.body ?? {});
+        const channel = typeof body['channel'] === 'string' ? body['channel'] : '';
+        const event = typeof body['event'] === 'string' ? body['event'] : '';
+        const data = body['data'];
+        if (!channel || !event) {
+            res
+                .setStatus(400)
+                .json({ ok: false, error: 'Invalid payload: channel and event are required' });
+            return;
+        }
+        const { Broadcast } = await import('../src/tools/broadcast/Broadcast.js');
+        const result = await Broadcast.send(channel, event, data);
+        res.json({ ok: true, result });
+    });
+}

package/routes/health.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Health Routes
+ * Provides health, liveness, and readiness endpoints.
+ */
+import { type IRouter } from '../src/routing/Router';
+export declare function registerHealthRoutes(router: IRouter): void;
+//# sourceMappingURL=health.d.ts.map

package/routes/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../routes/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAI1D"}

package/routes/health.js

@@ -0,0 +1,127 @@
+/**
+ * Health Routes
+ * Provides health, liveness, and readiness endpoints.
+ */
+import { appConfig } from '../src/config/index.js';
+import { RuntimeHealthProbes } from '../src/health/RuntimeHealthProbes.js';
+import { Env } from '../src/config/env.js';
+import { Logger } from '../src/config/logger.js';
+import { useDatabase } from '../src/orm/Database.js';
+import { QueryBuilder } from '../src/orm/QueryBuilder.js';
+import { Router } from '../src/routing/Router.js';
+export function registerHealthRoutes(router) {
+    registerHealthRoute(router);
+    registerHealthLiveRoute(router);
+    registerHealthReadyRoute(router);
+}
+function registerHealthRoute(router) {
+    Router.get(router, '/health', async (_req, res) => {
+        const environment = Env.NODE_ENV ?? 'development';
+        try {
+            const db = useDatabase();
+            const maybeIsConnected = db.isConnected;
+            const maybeConnect = db.connect;
+            if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
+                if (typeof maybeConnect === 'function') {
+                    await maybeConnect.call(db);
+                }
+            }
+            await QueryBuilder.ping(db);
+            const uptime = typeof process !== 'undefined' && typeof process.uptime === 'function'
+                ? process.uptime()
+                : 0;
+            res.json({
+                status: 'healthy',
+                timestamp: new Date().toISOString(),
+                uptime,
+                database: 'connected',
+                environment,
+            });
+        }
+        catch (error) {
+            Logger.error('Health check failed:', error);
+            const isProd = environment === 'production' || environment === 'prod';
+            res.setStatus(503).json({
+                status: 'unhealthy',
+                timestamp: new Date().toISOString(),
+                database: 'disconnected',
+                error: isProd ? 'Service unavailable' : error.message,
+            });
+        }
+    });
+}
+function registerHealthLiveRoute(router) {
+    Router.get(router, '/health/live', async (_req, res) => {
+        const uptime = typeof process !== 'undefined' && typeof process.uptime === 'function' ? process.uptime() : 0;
+        res.json({
+            status: 'alive',
+            timestamp: new Date().toISOString(),
+            uptime,
+        });
+    });
+}
+function registerHealthReadyRoute(router) {
+    Router.get(router, '/health/ready', async (_req, res) => {
+        const startTime = Date.now();
+        const environment = appConfig.environment;
+        let databaseResponseTime = null;
+        let cacheResponseTime = null;
+        try {
+            const db = useDatabase();
+            const maybeIsConnected = db.isConnected;
+            const maybeConnect = db.connect;
+            if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
+                if (typeof maybeConnect === 'function') {
+                    await maybeConnect.call(db);
+                }
+            }
+            await QueryBuilder.ping(db);
+            databaseResponseTime = Date.now() - startTime;
+            // Only probe KV at runtime when explicitly configured.
+            cacheResponseTime = await RuntimeHealthProbes.pingKvCache(2000);
+            res.json({
+                status: 'ready',
+                timestamp: new Date().toISOString(),
+                environment,
+                dependencies: {
+                    database: {
+                        status: 'ready',
+                        responseTime: databaseResponseTime,
+                    },
+                    ...(cacheResponseTime === null
+                        ? {}
+                        : {
+                            cache: {
+                                status: 'ready',
+                                responseTime: cacheResponseTime,
+                            },
+                        }),
+                },
+            });
+        }
+        catch (error) {
+            Logger.error('Readiness check failed:', error);
+            const isProd = environment === 'production';
+            const responseTime = Date.now() - startTime;
+            const dependencies = {
+                database: {
+                    status: databaseResponseTime === null ? 'unavailable' : 'ready',
+                    responseTime: databaseResponseTime ?? responseTime,
+                },
+            };
+            if (RuntimeHealthProbes.getCacheDriverName() === 'kv') {
+                dependencies['cache'] = {
+                    status: 'unavailable',
+                    responseTime: cacheResponseTime ?? responseTime,
+                };
+            }
+            res.setStatus(503).json({
+                status: 'not_ready',
+                timestamp: new Date().toISOString(),
+                environment,
+                dependencies,
+                error: isProd ? 'Service unavailable' : error.message,
+            });
+        }
+    });
+}

package/routes/storage.d.ts

@@ -0,0 +1,4 @@
+import { type IRouter } from '../src/routing/Router';
+export declare function registerStorageRoutes(router: IRouter): void;
+export default registerStorageRoutes;
+//# sourceMappingURL=storage.d.ts.map

package/routes/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../routes/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,iBAAiB,CAAC;AAIvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAiC3D;AAED,eAAe,qBAAqB,CAAC"}

package/routes/storage.js

@@ -0,0 +1,35 @@
+import { HTTP_HEADERS } from '../src/config/constants.js';
+import { Env } from '../src/config/env.js';
+import { Router } from '../src/routing/Router.js';
+import { LocalSignedUrl } from '../src/tools/storage/LocalSignedUrl.js';
+import { Storage } from '../src/tools/storage/index.js';
+export function registerStorageRoutes(router) {
+    Router.get(router, '/storage/download', async (req, res) => {
+        const tokenRaw = req.getQueryParam('token');
+        const token = typeof tokenRaw === 'string' ? tokenRaw : '';
+        if (token.trim() === '') {
+            res.setStatus(400).json({ message: 'Missing token' });
+            return;
+        }
+        const appKey = Env.get('APP_KEY', '');
+        if (appKey.trim() === '') {
+            res.setStatus(500).json({ message: 'Storage signing is not configured' });
+            return;
+        }
+        try {
+            const payload = LocalSignedUrl.verifyToken(token, appKey);
+            // Only local disk is supported by this route.
+            if (payload.disk !== 'local') {
+                res.setStatus(400).json({ message: 'Unsupported disk' });
+                return;
+            }
+            const contents = await Storage.get('local', payload.key);
+            res.setHeader(HTTP_HEADERS.CONTENT_TYPE, 'application/octet-stream');
+            res.setStatus(200).send(contents);
+        }
+        catch {
+            res.setStatus(403).json({ message: 'Invalid or expired token' });
+        }
+    });
+}
+export default registerStorageRoutes;

package/src/boot/Application.js

@@ -164,7 +164,7 @@ const registerRoutes = async (resolvedBasePath, router) => {
             mod.registerRoutes(router);
             return;
         }
-        const { registerRoutes: registerFrameworkRoutes } = await import('../../routes/api.js');
+        const { registerRoutes: registerFrameworkRoutes } = await import('../routes/api.js');
         registerFrameworkRoutes(router);
     }
     catch (error) {

package/src/boot/bootstrap.js

@@ -126,7 +126,7 @@ const BootstrapFunctions = Object.freeze({
             // Boot application
             await app.boot();
             // Get port and host from environment
-            const port = Env.getInt('PORT', 3000);
+            const port = Env.getInt('PORT', 7777);
             const host = Env.get('HOST', 'localhost');
             // Create and start server
             const server = Server.create(app, port, host);

package/src/cli/CLI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAyLD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AA0LD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}

package/src/cli/CLI.js

@@ -22,6 +22,7 @@ import { SecretsCommand } from './commands/SecretsCommand.js';
 import { SimulateCommand } from './commands/SimulateCommand.js';
 import { StartCommand } from './commands/StartCommand.js';
 import { TemplatesCommand } from './commands/TemplatesCommand.js';
+import { UpgradeCommand } from './commands/UpgradeCommand.js';
 import { ErrorHandler } from './ErrorHandler.js';
 import { esmDirname } from '../common/index.js';
 import { Logger } from '../config/logger.js';
@@ -68,6 +69,7 @@ const setupProgram = (program, version) => {
 const registerCommands = (program) => {
     const commands = [
         NewCommand.create(),
+        UpgradeCommand.create(),
         PrepareCommand,
         AddCommand.create(),
         StartCommand.create(),

package/src/cli/PromptHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PromptHelper.d.ts","sourceRoot":"","sources":["../../../src/cli/PromptHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;sBACqB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlE;;OAEG;8BAC6B,MAAM,gBAAe,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAuBrF;;OAEG;6BAEU,MAAM,gBACJ,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAsBlB;;OAEG;uBACqB,MAAM,gBAAsB,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAqBpF;;OAEG;uCAEkB,MAAM,EAAE,gBACd,OAAO,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;OAEG;qBAEQ,MAAM,mBACC,OAAO,gBACV,OAAO,GACnB,OAAO,CAAC,OAAO,CAAC;IAiBnB;;OAEG;wBAEQ,MAAM,WACN,MAAM,EAAE,kBACF,MAAM,gBACR,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;uBAEQ,MAAM,iBACD,MAAM,gBACP,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;EAgBlB,CAAC"}
+{"version":3,"file":"PromptHelper.d.ts","sourceRoot":"","sources":["../../../src/cli/PromptHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;sBACqB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlE;;OAEG;8BAC6B,MAAM,gBAAe,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAuBrF;;OAEG;6BAEU,MAAM,gBACJ,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAuBlB;;OAEG;uBACqB,MAAM,gBAAsB,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAqBpF;;OAEG;uCAEkB,MAAM,EAAE,gBACd,OAAO,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;OAEG;qBAEQ,MAAM,mBACC,OAAO,gBACV,OAAO,GACnB,OAAO,CAAC,OAAO,CAAC;IAiBnB;;OAEG;wBAEQ,MAAM,WACN,MAAM,EAAE,kBACF,MAAM,gBACR,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;uBAEQ,MAAM,iBACD,MAAM,gBACP,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;EAgBlB,CAAC"}

package/src/cli/PromptHelper.js

@@ -51,9 +51,10 @@ export const PromptHelper = Object.freeze({
                 name: 'database',
                 message: 'Select database:',
                 choices: [
-                    { name: 'PostgreSQL (recommended)', value: 'postgresql' },
-                    { name: 'MySQL', value: 'mysql' },
-                    { name: 'SQLite', value: 'sqlite' },
+                    { name: 'PostgreSQL — Production-ready relational DB', value: 'postgresql' },
+                    { name: 'MySQL — Production-ready relational DB', value: 'mysql' },
+                    { name: 'SQLite — Local dev (file-based)', value: 'sqlite' },
+                    { name: 'd1-proxy — Cloudflare D1 via HTTPS proxy', value: 'd1-remote' },
                 ],
                 default: defaultDb,
             },
@@ -63,7 +64,7 @@ export const PromptHelper = Object.freeze({
     /**
      * Ask for port number
      */
-    async port(defaultPort = 3000, interactive = true) {
+    async port(defaultPort = 7777, interactive = true) {
         if (!interactive) {
             return defaultPort;
         }

package/src/cli/commands/NewCommand.d.ts

@@ -4,7 +4,7 @@
  */
 import { CommandOptions, IBaseCommand } from '../BaseCommand';
 type TemplateType = 'basic' | 'api' | 'microservice' | 'fullstack';
-type DatabaseType = 'sqlite' | 'mysql' | 'postgresql' | 'mongodb';
+type DatabaseType = 'sqlite' | 'mysql' | 'postgresql' | 'mongodb' | 'd1-remote';
 interface NewProjectConfigResult {
     template: TemplateType;
     database: DatabaseType;

package/src/cli/commands/NewCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAe,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAY7E,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;AAYlE,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsOhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAmOD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}
+{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAe,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAY7E,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAYhF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuPhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AA2ND;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}

package/src/cli/commands/NewCommand.js

@@ -51,10 +51,26 @@ const getBooleanOption = (options, key, fallback) => {
 };
 const getProjectDefaults = (name, options) => {
     const template = getStringOption(options, 'template', 'basic');
-    const database = getStringOption(options, 'database', 'sqlite');
+    const normalizeDatabase = (value) => {
+        const v = value.trim();
+        if (v === 'd1-proxy')
+            return 'd1-remote';
+        if (v === 'd1-remote')
+            return 'd1-remote';
+        if (v === 'sqlite')
+            return 'sqlite';
+        if (v === 'mysql')
+            return 'mysql';
+        if (v === 'postgresql' || v === 'postgres')
+            return 'postgresql';
+        if (v === 'mongodb')
+            return 'mongodb';
+        return 'sqlite';
+    };
+    const database = normalizeDatabase(getStringOption(options, 'database', 'sqlite'));
     const portRaw = getStringOption(options, 'port', '7777');
     const portParsed = Number.parseInt(portRaw, 10);
-    const port = Number.isFinite(portParsed) && portParsed > 0 ? portParsed : 3000;
+    const port = Number.isFinite(portParsed) && portParsed > 0 ? portParsed : 7777;
     const author = getStringOption(options, 'author', '');
     const description = getStringOption(options, 'description', `A new Zintrust project: ${name}`);
     const interactive = getBooleanOption(options, 'interactive', true);
@@ -80,7 +96,13 @@ const getQuestions = (name, defaults) => {
             type: 'rawlist',
             name: 'database',
             message: 'Database driver:',
-            choices: ['sqlite', 'mysql', 'postgresql', 'mongodb'],
+            choices: [
+                { name: 'sqlite — Local dev (file-based)', value: 'sqlite' },
+                { name: 'postgresql — Production-ready relational DB', value: 'postgresql' },
+                { name: 'mysql — Production-ready relational DB', value: 'mysql' },
+                { name: 'd1-proxy — Cloudflare D1 via HTTPS proxy', value: 'd1-remote' },
+                { name: 'mongodb — Document DB (may require additional setup)', value: 'mongodb' },
+            ],
             default: defaults.database,
         },
         {
@@ -289,14 +311,9 @@ const executeNewCommand = async (options, command) => {
         const target = await resolveProjectTarget(options);
         await createProject(target, options, command);
         maybeInitializeGit(options, command, target);
-        const installedWithPm = await maybeInstallDependencies(options, command, target);
+        await maybeInstallDependencies(options, command, target);
         command.success(`\n✨ Project ${target.name} created successfully!`);
-        const optPm = options['packageManager'] ??
-            options['package-manager'];
-        const effectivePm = installedWithPm ?? optPm ?? resolvePackageManager();
-        const runDevCmd = effectivePm === 'yarn' || effectivePm === 'pnpm'
-            ? `${effectivePm} dev`
-            : `${effectivePm} run dev`;
+        const runDevCmd = 'zin start';
         command.info(`\nNext steps:\n  cd ${target.cdPath}\n  ${runDevCmd}\n`);
     }
     catch (error) {

package/src/cli/commands/SimulateCommand.js

@@ -67,7 +67,7 @@ export const SimulateCommand = {
                 Logger.info(`\n${chalk.bold('Next steps:')}`);
                 Logger.info(`  cd ${path.relative(process.cwd(), appPath)}`);
                 Logger.info('  npm install');
-                Logger.info('  npm run dev');
+                Logger.info('  zin start');
             }
             catch (error) {
                 Logger.error('Failed to create simulated app', error);

package/src/cli/commands/StartCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmSvF,eAAO,MAAM,YAAY;cACb,YAAY;EAsBtB,CAAC"}
+{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAyZvF,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC"}