@meridianjs/user 0.1.6 → 0.1.8

package/README.md

@@ -0,0 +1,89 @@
+# @meridianjs/user
+
+User, Team, and session management module for MeridianJS. Provides the `User` and `Team` data models, auto-generated CRUD, and custom helpers for email/Google ID lookups, login tracking, and session management.
+
+Auto-loaded by `@meridianjs/meridian` — you do not need to add this to `modules[]` yourself.
+
+## Service: `userModuleService`
+
+Resolve from the DI container in a route handler:
+
+```typescript
+const svc = req.scope.resolve("userModuleService") as any
+```
+
+### Auto-generated CRUD
+
+```typescript
+// Users
+await svc.listUsers(filters?, options?)
+await svc.listAndCountUsers(filters?, options?)
+await svc.retrieveUser(id)
+await svc.createUser(data)
+await svc.updateUser(id, data)
+await svc.deleteUser(id)
+await svc.softDeleteUser(id)
+
+// Teams
+await svc.listTeams(filters?, options?)
+await svc.retrieveTeam(id)
+await svc.createTeam(data)
+await svc.updateTeam(id, data)
+await svc.deleteTeam(id)
+```
+
+### Custom Methods
+
+```typescript
+// Find a user by email address (returns null if not found)
+const user = await svc.retrieveUserByEmail("alice@example.com")
+
+// Find a user by their Google OAuth ID
+const user = await svc.retrieveUserByGoogleId(googleId)
+
+// Update last_login_at timestamp
+await svc.recordLogin(userId)
+
+// Deactivate an account (sets is_active: false)
+await svc.deactivateUser(userId)
+
+// Total registered user count
+const count = await svc.countUsers()
+
+// Session management (for JWT revocation)
+await svc.createSession(jti, userId, expiresAt)
+await svc.retrieveValidSession(jti)
+await svc.revokeSession(jti)
+```
+
+## Data Models
+
+### User
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | `uuid` | Primary key |
+| `email` | `text` | Unique email address |
+| `password_hash` | `text` | bcrypt hash (nullable for OAuth users) |
+| `first_name` | `text` | — |
+| `last_name` | `text` | — |
+| `google_id` | `text` | Google OAuth ID (nullable) |
+| `picture` | `text` | Profile picture URL (nullable) |
+| `is_active` | `boolean` | Account active flag |
+| `last_login_at` | `datetime` | Last successful login |
+| `app_role_id` | `text` | Optional custom RBAC role |
+| `created_at` | `datetime` | — |
+| `updated_at` | `datetime` | — |
+
+### Team
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | `uuid` | Primary key |
+| `name` | `text` | Team name |
+| `workspace_id` | `text` | Owning workspace |
+| `created_at` | `datetime` | — |
+
+## License
+
+MIT

package/dist/index.js

@@ -39,6 +39,8 @@ var User = import_framework_utils.model.define("user", {
   first_name: import_framework_utils.model.text().nullable(),
   last_name: import_framework_utils.model.text().nullable(),
   avatar_url: import_framework_utils.model.text().nullable(),
+  designation: import_framework_utils.model.text().nullable(),
+  phone_number: import_framework_utils.model.text().nullable(),
   role: import_framework_utils.model.enum(["super-admin", "admin", "moderator", "member"]).default("member"),
   is_active: import_framework_utils.model.boolean().default(true),
   last_login_at: import_framework_utils.model.date().nullable(),

package/dist/index.mjs

@@ -13,6 +13,8 @@ var User = model.define("user", {
   first_name: model.text().nullable(),
   last_name: model.text().nullable(),
   avatar_url: model.text().nullable(),
+  designation: model.text().nullable(),
+  phone_number: model.text().nullable(),
   role: model.enum(["super-admin", "admin", "moderator", "member"]).default("member"),
   is_active: model.boolean().default(true),
   last_login_at: model.date().nullable(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meridianjs/user",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Meridian user module — User and Team domain models",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",