xorima/node-play

★ 0Forks 0TypeScriptGitHub ↗Compare

README

myapp-api

Small learning API demonstrating Hexagonal Architecture and DDD with Hono.

Structure

  • src/domains/users: user model, ports, services, and adapter-to-domain mappers.
  • src/adapters/inbound/httpapi: Hono routes, Zod contracts, authentication, validation, and problem responses.
  • src/adapters/outbound/persistence/in-memory-users: Map-backed user repository.
  • src/infrastructure: configuration, injected logging, and fetch-backed HTTP client.
  • src/app: explicit dependency wiring.

Run

npm install
npm run dev

Send Authorization: Bearer learning-token. The static token is deliberately insecure and exists only for learning; do not use it in a real deployment.

Verify

npm test
npm run typecheck
npm run generate:openapi
npm run docs:build

Open docs/index.html after building the API documentation.

Contributors

xorima

Issues