How johnpaulpatigas/liveness works
Liveness SDK combines browser-side challenge and face verification with a SaaS console and API for account, key, enrollment, verification, and log management. The user flow runs camera input through the SDK and vision engine to a descriptor; API-key clients can submit verification operations to the backend, while console users manage credentials and review results. The graph preserves major documented capabilities and sampled module relationships. Some web-page/API and backend route wiring is unsampled, so those links are omitted rather than inferred.
Main entry points: App.jsx Console routing · Documentation.jsx Documentation · auth.controller.js Account controller · auth.service.js Account service
Components 33
Browser verification
- SDK wrapper
packages/sdk/src/LivenessSDK.js
SaaS console
- Console routing
apps/saas-web/src/App.jsx - API client
apps/saas-web/src/services/api.js - Dashboard
apps/saas-web/src/pages/Dashboard.jsx - API key management
apps/saas-web/src/pages/ApiKeys.jsx - Verification logs
apps/saas-web/src/pages/Logs.jsx - User management
apps/saas-web/src/pages/Users.jsx - Account settings
apps/saas-web/src/pages/Settings.jsx - Documentation
apps/saas-web/src/pages/Documentation.jsx - Landing page
apps/saas-web/src/pages/Landing.jsx - Signup
apps/saas-web/src/pages/Signup.jsx - Navigation
apps/saas-web/src/components/Navbar.jsx - Dashboard layout
apps/saas-web/src/layouts/DashboardLayout.jsx
SaaS API
- API route dispatch
apps/saas-api/src/routes/liveness.routes.js - Account routes
apps/saas-api/src/routes/auth.routes.js - Verification controller
apps/saas-api/src/controllers/liveness.controller.js - Account controller
apps/saas-api/src/controllers/auth.controller.js - Account service
apps/saas-api/src/services/auth.service.js - Verification service
apps/saas-api/src/services/liveness.services.js - API key service
apps/saas-api/src/services/api-key.service.js - Authentication
apps/saas-api/src/middleware/auth.js - Cookie options
apps/saas-api/src/utils/cookie.js
Vision engine
- Challenge engine
packages/engine/src/LivenessEngine.js - Face recognition
packages/engine/src/FaceRecognitionNet.js - Vision utilities
packages/engine/src/utils.js
Persistence
- Account repository
apps/saas-api/src/repositories/auth.repository.js - Verification repository
apps/saas-api/src/repositories/liveness.repository.js - API key repository
apps/saas-api/src/repositories/api-key.repository.js - PostgreSQL
apps/saas-api/src/db.js
Other components
- End user
- Integrating application
- API client
- Email service
Connections 31
- End user → SDK wrapper: starts verification
README.md - SDK wrapper → Challenge engine: delegates to
packages/sdk/src/LivenessSDK.js - Challenge engine → Face recognition: loads model
packages/engine/src/LivenessEngine.js - Challenge engine → Vision utilities: calculates checks
packages/engine/src/LivenessEngine.js - Integrating application → SDK wrapper: integrates
README.md - Console routing → Dashboard: routes to
apps/saas-web/src/App.jsx - Console routing → API key management: routes to
apps/saas-web/src/App.jsx - Console routing → Documentation: routes to
apps/saas-web/src/App.jsx - Console routing → Landing page: routes to
apps/saas-web/src/App.jsx - Console routing → Signup: routes to
apps/saas-web/src/App.jsx - Console routing → Verification logs: routes to
apps/saas-web/src/App.jsx - Console routing → User management: routes to
apps/saas-web/src/App.jsx - Console routing → Account settings: routes to
apps/saas-web/src/App.jsx - Dashboard layout → API client: requests through
apps/saas-web/src/layouts/DashboardLayout.jsx - Documentation → Dashboard layout: uses
apps/saas-web/src/pages/Documentation.jsx - Documentation → Navigation: renders
apps/saas-web/src/pages/Documentation.jsx - Dashboard → API client: requests through
apps/saas-web/src/pages/Dashboard.jsx - API client → API client: sends HTTP requests
apps/saas-web/src/services/api.js - API client → API route dispatch: calls verification API
- API route dispatch → Verification controller: dispatches to
apps/saas-api/src/routes/liveness.routes.js - Account routes → Account controller: dispatches to
apps/saas-api/src/routes/auth.routes.js - Verification controller → Verification service: calls
apps/saas-api/src/controllers/liveness.controller.js - Account controller → Account service: calls
apps/saas-api/src/controllers/auth.controller.js - Account controller → Cookie options: configures cookies
apps/saas-api/src/controllers/auth.controller.js - Account service → Account repository: reads and writes
apps/saas-api/src/services/auth.service.js - Account service → Email service: sends reset email
apps/saas-api/src/services/auth.service.js - Verification service → Verification repository: persists verification data
apps/saas-api/src/services/liveness.services.js - API key service → API key repository: uses repository
apps/saas-api/src/services/api-key.service.js - Authentication → API key service: validates API keys
apps/saas-api/src/middleware/auth.js - Authentication → Account repository: checks token version
apps/saas-api/src/middleware/auth.js - Account repository → PostgreSQL: queries
apps/saas-api/src/repositories/auth.repository.js