MyChelper Auth

Authentication subgraph and shared package for MyChelper federated GraphQL architecture.

Overview

This project serves dual purposes:

1. GraphQL Subgraph: Exposes authentication operations (login, register, verify) via Apollo Federation
2. Shared Package: Provides utilities (resolveAdminPermissions, generateToken, types) for direct imports in other subgraphs

Structure

• src/package/ - Shared utilities exported as npm package
• src/services/ - Business logic for auth operations
• src/resolvers/ - GraphQL resolvers
• src/schema/ - GraphQL schema definitions

Usage

As a GraphQL Subgraph

The subgraph runs on port 4003 by default (configurable via AUTH_PORT).

As a Shared Package

Import utilities in other subgraphs:

import { resolveAdminPermissions, generateToken, type AdminPermissionClaims } from '@mychelper/auth/package';

Environment Variables

• AUTH_PORT - Server port (default: 4003)
• DATABASE_URL - PostgreSQL connection string
• JWT_SECRET - Secret for JWT token signing
• SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS - Email configuration

Development

npm install
npm run dev

Build

npm run build