@carlos-tzin/tzin 0.1.4 → 0.1.5

package/dist/cli.js

@@ -1,30 +1,125 @@
 import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
+import { resolve } from 'node:path';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+const [, , cmd, ...rest] = process.argv;
 function usage() {
     console.error(`tzin CLI
 
-  tzin dev [entry] [--port N]    start dev server with hot reload
-                                  entry defaults to src/app.ts`);
+  Commands:
+    tzin dev [entry] [--port N]     start dev server with hot reload
+    tzin generate route <name>      generate a route stub
+    tzin generate middleware <name>  generate a middleware stub
+    tzin generate test <name>       generate a test stub`);
     process.exit(1);
 }
-const [, , cmd, ...rest] = process.argv;
-if (cmd !== 'dev')
+if (!cmd || cmd === '--help' || cmd === '-h')
     usage();
-// Entry is optional now - dev-server auto-detects
-let entry = '';
-let port = '3000';
-const portFlag = rest.indexOf('--port');
-if (portFlag !== -1 && rest[portFlag + 1])
-    port = rest[portFlag + 1];
-// First non-flag arg is the entry (optional)
-const entryArg = rest.find((a) => !a.startsWith('-') && a !== 'dev');
-if (entryArg)
-    entry = entryArg;
-const devServer = fileURLToPath(new URL('./dev-server.ts', import.meta.url));
-const args = ['tsx', 'watch', '--clear-screen=false', devServer];
-if (entry)
-    args.push(entry);
-args.push('--port', port);
-const child = spawn('npx', args, { stdio: 'inherit' });
-process.on('SIGINT', () => child.kill('SIGINT'));
-child.on('exit', (code) => process.exit(code ?? 0));
+// ── dev ──────────────────────────────────────────────────────────────
+if (cmd === 'dev') {
+    let entry = '';
+    let port = '3000';
+    const portFlag = rest.indexOf('--port');
+    if (portFlag !== -1 && rest[portFlag + 1])
+        port = rest[portFlag + 1];
+    const entryArg = rest.find((a) => !a.startsWith('-'));
+    if (entryArg)
+        entry = entryArg;
+    const devServer = fileURLToPath(new URL('./dev-server.ts', import.meta.url));
+    const args = ['tsx', 'watch', '--clear-screen=false', devServer];
+    if (entry)
+        args.push(entry);
+    args.push('--port', port);
+    const child = spawn('npx', args, { stdio: 'inherit' });
+    process.on('SIGINT', () => child.kill('SIGINT'));
+    child.on('exit', (code) => process.exit(code ?? 0));
+    process.exit(0);
+}
+// ── generate ─────────────────────────────────────────────────────────
+if (cmd === 'generate' || cmd === 'g') {
+    const [sub, ...args] = rest;
+    const name = args[0];
+    if (!sub || !name) {
+        console.error('Usage: tzin generate <route|middleware|test> <name>');
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    if (sub === 'route' || sub === 'r') {
+        const dir = resolve(cwd, 'src/routes');
+        mkdirSync(dir, { recursive: true });
+        const file = resolve(dir, `${name}.ts`);
+        if (existsSync(file)) {
+            console.error(`File already exists: ${file}`);
+            process.exit(1);
+        }
+        const slug = name.replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+        writeFileSync(file, `import { t } from '@carlos-tzin/tzin'
+import { contract, impl } from '@carlos-tzin/tzin'
+
+const ${slug} = contract({
+  method: 'GET',
+  path: '/${slug}',
+  responses: {
+    200: t.Object({ ok: t.Boolean() }),
+  },
+})
+
+export const ${slug}Route = impl(${slug}, async () => ({
+  status: 200 as const,
+  body: { ok: true },
+}))
+`);
+        console.log(`Created ${file}`);
+        process.exit(0);
+    }
+    if (sub === 'middleware' || sub === 'm') {
+        const dir = resolve(cwd, 'src/middleware');
+        mkdirSync(dir, { recursive: true });
+        const file = resolve(dir, `${name}.ts`);
+        if (existsSync(file)) {
+            console.error(`File already exists: ${file}`);
+            process.exit(1);
+        }
+        const slug = name.replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+        writeFileSync(file, `import { middleware } from '@carlos-tzin/tzin'
+
+export const ${slug} = middleware(async (ctx, next) => {
+  // TODO: add logic here
+  return next()
+})
+`);
+        console.log(`Created ${file}`);
+        process.exit(0);
+    }
+    if (sub === 'test' || sub === 't') {
+        const dir = resolve(cwd, 'tests');
+        mkdirSync(dir, { recursive: true });
+        const file = resolve(dir, `${name}.test.ts`);
+        if (existsSync(file)) {
+            console.error(`File already exists: ${file}`);
+            process.exit(1);
+        }
+        writeFileSync(file, `import { describe, it, expect } from 'vitest'
+import { createTestClient } from '@carlos-tzin/tzin/test'
+import { app } from '../src/app.js'
+
+describe('${name}', () => {
+  it('returns 200', async () => {
+    const api = await createTestClient(app)
+    try {
+      const res = await api.get('/${name}')
+      expect(res.status).toBe(200)
+    } finally {
+      await api.close()
+    }
+  })
+})
+`);
+        console.log(`Created ${file}`);
+        process.exit(0);
+    }
+    console.error(`Unknown generate type: ${sub}`);
+    console.error('Available: route, middleware, test');
+    process.exit(1);
+}
+usage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlos-tzin/tzin",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Contract-first TypeScript framework. Types that scale, realtime channels with presence, and an MCP server for every API.",
   "license": "MIT",
   "author": "The tzin authors",