How mgalen007/tether works
This appears to be a NestJS bookmark-management API, despite the README describing a generic Nest starter. Its main workflow is account registration or login, followed by authenticated bookmark and collection operations backed by PostgreSQL through Prisma. The sampled controllers and services establish those calls and persistence operations; user-service internals and application bootstrap wiring beyond the visible module imports were not sampled, so their internal links are omitted.
Main entry points: app.module.ts Application modules · bookmarks.controller.ts Bookmark endpoints · collections.controller.ts Collection endpoints · prisma.service.ts Prisma database client
Components 16
Application runtime
- Application modules
src/app.module.ts - Health endpoint
src/app.controller.ts - Health response
src/app.service.ts
Identity and access
- Auth endpoints
src/modules/auth/auth.controller.ts - Authentication
src/modules/auth/auth.service.ts - User operations
src/modules/users/users.service.ts - User endpoints
src/modules/users/users.controller.ts - JWT service
- JWT guard
src/modules/auth/guards/jwt-auth.guard.ts
Bookmark management
- Bookmark endpoints
src/modules/bookmarks/bookmarks.controller.ts - Bookmark operations
src/modules/bookmarks/bookmarks.service.ts
Collections and storage
- Collection endpoints
src/modules/collections/collections.controller.ts - Collection operations
src/modules/collections/collections.service.ts - Prisma database client
src/modules/prisma/prisma.service.ts
Other components
- API client
- PostgreSQL
Connections 22
- Application modules → Auth endpoints: imports auth module
- Application modules → Bookmark endpoints: imports bookmarks module
- Application modules → Collection endpoints: imports collections module
- Application modules → User endpoints: imports users module
- Application modules → Prisma database client: imports Prisma module
- API client → Health endpoint: requests health
- Health endpoint → Health response: calls health check
- API client → Auth endpoints: registers or logs in
- Auth endpoints → Authentication: calls auth methods
- Authentication → User operations: creates or finds user
- Authentication → JWT service: signs token
- API client → User endpoints: requests user data
- User endpoints → User operations: calls user methods
- API client → Bookmark endpoints: requests bookmark operations
- Bookmark endpoints → JWT guard: requires authentication
- Bookmark endpoints → Bookmark operations: calls bookmark methods
- Bookmark operations → Prisma database client: reads and writes bookmarks
- API client → Collection endpoints: requests collection operations
- Collection endpoints → JWT guard: requires authentication
- Collection endpoints → Collection operations: calls collection methods
- Collection operations → Prisma database client: reads and writes collections
- Prisma database client → PostgreSQL: connects through pg adapter