@docouno/devkit 0.0.0-stage → 0.3.1

package/templates/node-api/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "devkit-node-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": "^24.22.1"
+  },
+  "scripts": {
+    "check": "devkit-verify && npm run format:check && npm run lint && npm run typecheck && npm test",
+    "format:check": "prettier --check src tsconfig.json tsconfig.build.json eslint.config.mjs prettier.config.mjs",
+    "lint": "eslint --no-ignore --max-warnings 0 src eslint.config.mjs prettier.config.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "fix": "prettier --write src tsconfig.json tsconfig.build.json eslint.config.mjs prettier.config.mjs && eslint --no-ignore --max-warnings 0 --fix src eslint.config.mjs prettier.config.mjs",
+    "test": "node --test --test-reporter=@docouno/env/node-test-reporter 'src/**/*.test.ts'",
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "node --watch src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@docouno/env": "0.3.1",
+    "@types/node": "24.19.2",
+    "eslint": "10.13.0",
+    "prettier": "3.9.10",
+    "typescript": "6.0.3"
+  },
+  "devkit": {
+    "sourceDirectories": [
+      "src"
+    ],
+    "typecheckConfigs": [
+      "tsconfig.json"
+    ],
+    "boundaries": {
+      "forbidCrossAppImports": true
+    }
+  }
+}

package/templates/node-api/prettier.config.mjs

@@ -0,0 +1 @@
+export { default } from '@docouno/env/prettier';

package/templates/node-api/src/greeting.test.ts

@@ -0,0 +1,14 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { greeting } from './greeting.ts';
+
+await test('normalizes a name and gives an explicit default', () => {
+  assert.deepEqual(greeting('  Ada  '), { message: 'Hello, Ada!' });
+  assert.deepEqual(greeting('  '), { message: 'Hello, world!' });
+  assert.deepEqual(greeting(undefined), { message: 'Hello, world!' });
+});
+
+await test('rejects invalid input instead of coercing it silently', () => {
+  assert.throws(() => greeting(42));
+  assert.throws(() => greeting('x'.repeat(81)));
+});

package/templates/node-api/src/greeting.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+
+const nameSchema = z.string().trim().max(80).default('world');
+
+export function greeting(name: unknown): { message: string } {
+  const parsed = nameSchema.parse(name);
+  return { message: `Hello, ${parsed || 'world'}!` };
+}

package/templates/node-api/src/http.test.ts

@@ -0,0 +1,64 @@
+import assert from 'node:assert/strict';
+import { once } from 'node:events';
+import { createConnection } from 'node:net';
+import test from 'node:test';
+import { createApplication } from './http.ts';
+
+await test('serves the real API and exposes failure statuses', async () => {
+  const server = createApplication();
+  server.listen(0, '127.0.0.1');
+  await once(server, 'listening');
+  const address = server.address();
+  assert.ok(address && typeof address !== 'string');
+  const root = `http://127.0.0.1:${address.port}`;
+  try {
+    const health = await fetch(`${root}/health`);
+    assert.equal(health.status, 200);
+    assert.deepEqual(await health.json(), { status: 'ok' });
+    const named = await fetch(`${root}/api/greeting?name=%20Ada%20`);
+    assert.equal(named.status, 200);
+    assert.deepEqual(await named.json(), { message: 'Hello, Ada!' });
+    const empty = await fetch(`${root}/api/greeting?name=%20`);
+    assert.deepEqual(await empty.json(), { message: 'Hello, world!' });
+    const invalid = await fetch(`${root}/api/greeting?name=${'x'.repeat(81)}`);
+    assert.equal(invalid.status, 400);
+    const method = await fetch(`${root}/api/greeting`, { method: 'POST' });
+    assert.equal(method.status, 405);
+    assert.equal((await fetch(`${root}/missing`)).status, 404);
+  } finally {
+    await new Promise<void>((resolve, reject) => {
+      server.close((error) => (error ? reject(error) : resolve()));
+    });
+  }
+});
+
+await test('a malformed raw request target returns 400 and keeps the server responsive', async () => {
+  const server = createApplication();
+  server.listen(0, '127.0.0.1');
+  await once(server, 'listening');
+  const address = server.address();
+  assert.ok(address && typeof address !== 'string');
+  try {
+    const response = await new Promise<string>((resolve, reject) => {
+      const socket = createConnection({ host: '127.0.0.1', port: address.port }, () => {
+        socket.end('GET // HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\r\n');
+      });
+      socket.setEncoding('utf8');
+      socket.setTimeout(5_000, () => socket.destroy(new Error('Raw HTTP request timed out.')));
+      let raw = '';
+      socket.on('data', (chunk: string) => {
+        raw += chunk;
+      });
+      socket.once('end', () => resolve(raw));
+      socket.once('error', reject);
+    });
+    assert.match(response, /^HTTP\/1\.1 400 Bad Request\r\n/u);
+    assert.deepEqual(await (await fetch(`http://127.0.0.1:${address.port}/health`)).json(), {
+      status: 'ok',
+    });
+  } finally {
+    await new Promise<void>((resolve, reject) => {
+      server.close((error) => (error ? reject(error) : resolve()));
+    });
+  }
+});

package/templates/node-api/src/http.ts

@@ -0,0 +1,46 @@
+import { createServer } from 'node:http';
+import type { Server, ServerResponse } from 'node:http';
+import { z } from 'zod';
+import { greeting } from './greeting.ts';
+
+function send(response: ServerResponse, status: number, body: Record<string, unknown>): void {
+  response.writeHead(status, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+  });
+  response.end(`${JSON.stringify(body)}\n`);
+}
+
+export function createApplication(): Server {
+  return createServer((request, response) => {
+    let url: URL;
+    try {
+      url = new URL(request.url ?? '/', 'http://localhost');
+    } catch {
+      send(response, 400, { error: 'Invalid request target.' });
+      return;
+    }
+    if (!['/health', '/api/greeting'].includes(url.pathname)) {
+      send(response, 404, { error: 'Not found.' });
+      return;
+    }
+    if (request.method !== 'GET') {
+      response.setHeader('allow', 'GET');
+      send(response, 405, { error: 'Method not allowed.' });
+      return;
+    }
+    if (url.pathname === '/health') {
+      send(response, 200, { status: 'ok' });
+      return;
+    }
+    try {
+      send(response, 200, greeting(url.searchParams.get('name') ?? undefined));
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        send(response, 400, { error: 'Name must contain at most 80 characters.' });
+      } else {
+        send(response, 500, { error: 'Unable to produce a greeting.' });
+      }
+    }
+  });
+}

package/templates/node-api/src/index.ts

@@ -0,0 +1,26 @@
+import { env } from 'node:process';
+import { z } from 'zod';
+import { createApplication } from './http.ts';
+
+const port = z.coerce.number().int().min(0).max(65_535).default(8080).parse(env.PORT);
+const server = createApplication();
+server.on('error', (error: Error) => {
+  console.error(`Server error: ${error.message}`);
+  process.exitCode = 1;
+});
+server.listen(port, '0.0.0.0', () => {
+  const address = server.address();
+  if (address && typeof address !== 'string') {
+    console.log(`Listening on 0.0.0.0:${address.port}`);
+  }
+});
+for (const signal of ['SIGINT', 'SIGTERM'] as const) {
+  process.once(signal, () => {
+    server.close((error) => {
+      if (error) {
+        console.error(`Unable to close the server: ${error.message}`);
+        process.exitCode = 1;
+      }
+    });
+  });
+}

package/templates/node-api/tsconfig.build.json

@@ -0,0 +1,5 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": { "noEmit": false, "rootDir": "src", "outDir": "dist" },
+  "exclude": ["src/**/*.test.ts"]
+}

package/templates/node-api/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@docouno/env/tsconfig/node.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "rewriteRelativeImportExtensions": true,
+    "erasableSyntaxOnly": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/react-client/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Devkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/react-client/eslint.config.mjs

@@ -0,0 +1,2 @@
+import { browserConfig } from '@docouno/env/eslint';
+export default browserConfig(import.meta.dirname);