Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
✨ feat: Add cursor pagination utilities and refine user/group/role types in `@librechat/data-schemas` (#9218)
Marco Berettaac608ded4670
diff --git a/package-lock.json b/package-lock.jsonindex 502151b277..8fbb81d950 100644--- a/package-lock.json+++ b/package-lock.json@@ -51876,7 +51876,7 @@},"packages/data-schemas": {"name": "@librechat/data-schemas",- "version": "0.0.18",+ "version": "0.0.19","license": "MIT","devDependencies": {"@rollup/plugin-alias": "^5.1.0",diff --git a/packages/data-schemas/package.json b/packages/data-schemas/package.jsonindex 93bb9fd0ca..0001b60a42 100644--- a/packages/data-schemas/package.json+++ b/packages/data-schemas/package.json@@ -1,6 +1,6 @@{"name": "@librechat/data-schemas",- "version": "0.0.18",+ "version": "0.0.19","description": "Mongoose schemas and models for LibreChat","type": "module","main": "dist/index.cjs",diff --git a/packages/data-schemas/src/common/index.ts b/packages/data-schemas/src/common/index.tsindex bdd505d9ca..e990985eb2 100644--- a/packages/data-schemas/src/common/index.ts+++ b/packages/data-schemas/src/common/index.ts@@ -1 +1,2 @@export * from './enum';+export * from './pagination';diff --git a/packages/data-schemas/src/common/pagination.ts b/packages/data-schemas/src/common/pagination.tsnew file mode 100644index 0000000000..711e78a68e--- /dev/null+++ b/packages/data-schemas/src/common/pagination.ts@@ -0,0 +1,17 @@+export interface CursorPaginationParams {+ limit?: number;+ cursor?: string;+ sortBy?: string;+ sortOrder?: 'asc' | 'desc';+}++export interface CursorPaginationResponse<T> {+ data: T[];+ pagination: {+ hasNextPage: boolean;+ hasPreviousPage: boolean;+ nextCursor?: string;+ previousCursor?: string;+ totalCount?: number;+ };+}diff --git a/packages/data-schemas/src/methods/user.ts b/packages/data-schemas/src/methods/user.tsindex b1f4c82ce1..83a433da73 100644--- a/packages/data-schemas/src/methods/user.ts+++ b/packages/data-schemas/src/methods/user.ts@@ -1,5 +1,5 @@import mongoose, { FilterQuery } from 'mongoose';-import type { IUser, BalanceConfig, UserCreateData, UserUpdateResult } from '~/types';+import type { IUser, BalanceConfig, CreateUserRequest, UserDeleteResult } from '~/types';import { signPayload } from '~/crypto';/** Factory function that takes mongoose instance and returns the methods */@@ -31,7 +31,7 @@ export function createUserMethods(mongoose: typeof import('mongoose')) {* Creates a new user, optionally with a TTL of 1 week.*/async function createUser(- data: UserCreateData,+ data: CreateUserRequest,balanceConfig?: BalanceConfig,disableTTL: boolean = true,returnUser: boolean = false,@@ -123,7 +123,7 @@ export function createUserMethods(mongoose: typeof import('mongoose')) {/*** Delete a user by their unique ID.*/- async function deleteUserById(userId: string): Promise<UserUpdateResult> {+ async function deleteUserById(userId: string): Promise<UserDeleteResult> {try {const User = mongoose.models.User;const result = await User.deleteOne({ _id: userId });diff --git a/packages/data-schemas/src/schema/group.ts b/packages/data-schemas/src/schema/group.tsindex 7de514b776..55cb54e8b5 100644--- a/packages/data-schemas/src/schema/group.ts+++ b/packages/data-schemas/src/schema/group.ts@@ -24,6 +24,7 @@ const groupSchema = new Schema<IGroup>(memberIds: [{type: String,+ required: false,},],source: {diff --git a/packages/data-schemas/src/types/group.ts b/packages/data-schemas/src/types/group.tsindex 30c067664b..e0e622aca2 100644--- a/packages/data-schemas/src/types/group.ts+++ b/packages/data-schemas/src/types/group.ts@@ -1,22 +1,44 @@import type { Document, Types } from 'mongoose';+import { CursorPaginationParams } from '~/common';export interface IGroup extends Document {_id: Types.ObjectId;- /** The name of the group */name: string;- /** Optional description of the group */description?: string;- /** Optional email address for the group */email?: string;- /** Optional avatar URL for the group */avatar?: string;/** Array of member IDs (stores idOnTheSource values, not ObjectIds) */- memberIds: string[];- /** The source of the group ('local' or 'entra') */+ memberIds?: string[];source: 'local' | 'entra';/** External ID (e.g., Entra ID) - required for non-local sources */idOnTheSource?: string;- /** Timestamps */createdAt?: Date;updatedAt?: Date;}++export interface CreateGroupRequest {+ name: string;+ description?: string;+ email?: string;+ avatar?: string;+ memberIds?: string[];+ source: 'local' | 'entra';+ idOnTheSource?: string;+}++export interface UpdateGroupRequest {+ name?: string;+ description?: string;+ email?: string;+ avatar?: string;+ memberIds?: string[];+ source?: 'local' | 'entra' | 'ldap';+ idOnTheSource?: string;+}++export interface GroupFilterOptions extends CursorPaginationParams {+ // Includes email, name and description+ search?: string;+ source?: 'local' | 'entra' | 'ldap';+ hasMember?: string;+}diff --git a/packages/data-schemas/src/types/role.ts b/packages/data-schemas/src/types/role.tsindex 281b8b4239..5441847b93 100644--- a/packages/data-schemas/src/types/role.ts+++ b/packages/data-schemas/src/types/role.ts@@ -1,5 +1,6 @@-import { Document } from 'mongoose';import { PermissionTypes, Permissions } from 'librechat-data-provider';+import type { Document } from 'mongoose';+import { CursorPaginationParams } from '~/common';export interface IRole extends Document {name: string;@@ -48,3 +49,25 @@ export interface IRole extends Document {};};}++export type RolePermissions = IRole['permissions'];+type DeepPartial<T> = {+ [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];+};+export type RolePermissionsInput = DeepPartial<RolePermissions>;++export interface CreateRoleRequest {+ name: string;+ permissions: RolePermissionsInput;+}++export interface UpdateRoleRequest {+ name?: string;+ permissions?: RolePermissionsInput;+}++export interface RoleFilterOptions extends CursorPaginationParams {+ // Includes role name+ search?: string;+ hasPermission?: string;+}diff --git a/packages/data-schemas/src/types/user.ts b/packages/data-schemas/src/types/user.tsindex 6d27422294..ad86172d88 100644--- a/packages/data-schemas/src/types/user.ts+++ b/packages/data-schemas/src/types/user.ts@@ -1,4 +1,5 @@-import { Document, Types } from 'mongoose';+import type { Document, Types } from 'mongoose';+import { CursorPaginationParams } from '~/common';export interface IUser extends Document {name?: string;@@ -48,18 +49,39 @@ export interface BalanceConfig {refillAmount?: number;}-export interface UserCreateData extends Partial<IUser> {+export interface CreateUserRequest extends Partial<IUser> {email: string;}-export interface UserUpdateResult {+export interface UpdateUserRequest {+ name?: string;+ username?: string;+ email?: string;+ role?: string;+ emailVerified?: boolean;+ avatar?: string;+ plugins?: string[];+ twoFactorEnabled?: boolean;+ termsAccepted?: boolean;+ personalization?: {+ memories?: boolean;+ };+}++export interface UserDeleteResult {deletedCount: number;message: string;}-export interface UserSearchCriteria {- email?: string;- username?: string;+export interface UserFilterOptions extends CursorPaginationParams {+ _id?: Types.ObjectId | string;+ // Includes email, username and name+ search?: string;+ role?: string;+ emailVerified?: boolean;+ provider?: string;+ twoFactorEnabled?: boolean;+ // External IDsgoogleId?: string;facebookId?: string;openidId?: string;@@ -68,7 +90,9 @@ export interface UserSearchCriteria {githubId?: string;discordId?: string;appleId?: string;- _id?: Types.ObjectId | string;+ // Date filters+ createdAfter?: string;+ createdBefore?: string;}export interface UserQueryOptions {