@meridianjs/user 0.1.7 → 0.1.9

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.d.mts

@@ -13,6 +13,11 @@ declare class UserModuleService extends UserModuleService_base {
     recordLogin(userId: string): Promise<void>;
     /** Deactivate a user account. */
     deactivateUser(userId: string): Promise<any>;
+    /**
+     * Restore a soft-deleted user account.
+     * Bypasses UPDATE_RESERVED to clear deleted_at directly via the repository.
+     */
+    restoreUser(userId: string, data?: Record<string, unknown>): Promise<any>;
     /** Return the total number of registered users. */
     countUsers(): Promise<number>;
     /** Store a new session record when a token is issued. */

package/dist/index.d.ts

@@ -13,6 +13,11 @@ declare class UserModuleService extends UserModuleService_base {
     recordLogin(userId: string): Promise<void>;
     /** Deactivate a user account. */
     deactivateUser(userId: string): Promise<any>;
+    /**
+     * Restore a soft-deleted user account.
+     * Bypasses UPDATE_RESERVED to clear deleted_at directly via the repository.
+     */
+    restoreUser(userId: string, data?: Record<string, unknown>): Promise<any>;
     /** Return the total number of registered users. */
     countUsers(): Promise<number>;
     /** Store a new session record when a token is issued. */

package/dist/index.js

@@ -112,6 +112,17 @@ var UserModuleService = class extends (0, import_framework_utils4.MeridianServic
   async deactivateUser(userId) {
     return this.updateUser(userId, { is_active: false });
   }
+  /**
+   * Restore a soft-deleted user account.
+   * Bypasses UPDATE_RESERVED to clear deleted_at directly via the repository.
+   */
+  async restoreUser(userId, data = {}) {
+    const repo = this.container.resolve("userRepository");
+    const user = await repo.findOneOrFail({ id: userId });
+    Object.assign(user, { ...data, deleted_at: null, is_active: true });
+    await repo.flush();
+    return user;
+  }
   /** Return the total number of registered users. */
   async countUsers() {
     const userRepository = this.container.resolve("userRepository");

package/dist/index.mjs

@@ -86,6 +86,17 @@ var UserModuleService = class extends MeridianService({ User: user_default, Team
   async deactivateUser(userId) {
     return this.updateUser(userId, { is_active: false });
   }
+  /**
+   * Restore a soft-deleted user account.
+   * Bypasses UPDATE_RESERVED to clear deleted_at directly via the repository.
+   */
+  async restoreUser(userId, data = {}) {
+    const repo = this.container.resolve("userRepository");
+    const user = await repo.findOneOrFail({ id: userId });
+    Object.assign(user, { ...data, deleted_at: null, is_active: true });
+    await repo.flush();
+    return user;
+  }
   /** Return the total number of registered users. */
   async countUsers() {
     const userRepository = this.container.resolve("userRepository");

package/package.json

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