@librechat/data-schemas 0.0.39 → 0.0.42

package/dist/types/types/config.d.ts

@@ -0,0 +1,58 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import { PrincipalType, PrincipalModel } from 'librechat-data-provider';
+import type { TCustomConfig } from 'librechat-data-provider';
+import type { Document, Types } from 'mongoose';
+/**
+ * Configuration override for a principal (user, group, or role).
+ * Stores partial overrides at the TCustomConfig (YAML) level,
+ * which are merged with the base config before processing through AppService.
+ */
+export type Config = {
+    /** The type of principal (user, group, role) */
+    principalType: PrincipalType;
+    /** The ID of the principal (ObjectId for users/groups, string for roles) */
+    principalId: Types.ObjectId | string;
+    /** The model name for the principal */
+    principalModel: PrincipalModel;
+    /** Priority level for determining merge order (higher = more specific) */
+    priority: number;
+    /** Configuration overrides matching librechat.yaml structure */
+    overrides: Partial<TCustomConfig>;
+    /** Whether this config override is currently active */
+    isActive: boolean;
+    /** Version number for cache invalidation, auto-increments on overrides change */
+    configVersion: number;
+    /** Tenant identifier for multi-tenancy isolation */
+    tenantId?: string;
+    /** When this config was created */
+    createdAt?: Date;
+    /** When this config was last updated */
+    updatedAt?: Date;
+};
+export type IConfig = Config & Document & {
+    _id: Types.ObjectId;
+};

package/dist/types/types/convo.d.ts

@@ -77,4 +77,5 @@ export interface IConversation extends Document {
     expiredAt?: Date;
     createdAt?: Date;
     updatedAt?: Date;
+    tenantId?: string;
 }

package/dist/types/types/file.d.ts

@@ -49,4 +49,5 @@ export interface IMongoFile extends Omit<Document, 'model'> {
     expiresAt?: Date;
     createdAt?: Date;
     updatedAt?: Date;
+    tenantId?: string;
 }

package/dist/types/types/group.d.ts

@@ -38,6 +38,7 @@ export interface IGroup extends Document {
     idOnTheSource?: string;
     createdAt?: Date;
     updatedAt?: Date;
+    tenantId?: string;
 }
 export interface CreateGroupRequest {
     name: string;

package/dist/types/types/index.d.ts

@@ -47,6 +47,9 @@ export * from './memory';
 export * from './prompts';
 export * from './accessRole';
 export * from './aclEntry';
+export * from './systemGrant';
 export * from './group';
+export * from './config';
+export * from './admin';
 export * from './web';
 export * from './mcp';

package/dist/types/types/mcp.d.ts

@@ -31,4 +31,5 @@ import type { MCPServerDB } from 'librechat-data-provider';
  */
 export interface MCPServerDocument extends Omit<MCPServerDB, 'author' | '_id'>, Document<Types.ObjectId> {
     author: Types.ObjectId;
+    tenantId?: string;
 }

package/dist/types/types/memory.d.ts

@@ -30,6 +30,7 @@ export interface IMemoryEntry extends Document {
     value: string;
     tokenCount?: number;
     updated_at?: Date;
+    tenantId?: string;
 }
 export interface IMemoryEntryLean {
     _id: Types.ObjectId;

package/dist/types/types/message.d.ts

@@ -34,7 +34,7 @@ export interface IMessage extends Document {
     conversationSignature?: string;
     clientId?: string;
     invocationId?: number;
-    parentMessageId?: string;
+    parentMessageId?: string | null;
     tokenCount?: number;
     summaryTokenCount?: number;
     sender?: string;
@@ -62,8 +62,13 @@ export interface IMessage extends Document {
     iconURL?: string;
     addedConvo?: boolean;
     metadata?: Record<string, unknown>;
+    contextMeta?: {
+        calibrationRatio?: number;
+        encoding?: string;
+    };
     attachments?: unknown[];
-    expiredAt?: Date;
+    expiredAt?: Date | null;
     createdAt?: Date;
     updatedAt?: Date;
+    tenantId?: string;
 }

package/dist/types/types/pluginAuth.d.ts

@@ -31,6 +31,7 @@ export interface IPluginAuth extends Document {
     pluginKey?: string;
     createdAt?: Date;
     updatedAt?: Date;
+    tenantId?: string;
 }
 export interface PluginAuthQuery {
     userId: string;

package/dist/types/types/prompts.d.ts

@@ -31,13 +31,13 @@ export interface IPrompt extends Document {
     type: 'text' | 'chat';
     createdAt?: Date;
     updatedAt?: Date;
+    tenantId?: string;
 }
 export interface IPromptGroup {
     name: string;
     numberOfGenerations: number;
     oneliner: string;
     category: string;
-    projectIds: Types.ObjectId[];
     productionId: Types.ObjectId;
     author: Types.ObjectId;
     authorName: string;
@@ -45,6 +45,7 @@ export interface IPromptGroup {
     createdAt?: Date;
     updatedAt?: Date;
     isPublic?: boolean;
+    tenantId?: string;
 }
 export interface IPromptGroupDocument extends IPromptGroup, Document {
 }

package/dist/types/types/role.d.ts

@@ -29,6 +29,7 @@ import { CursorPaginationParams } from '~/common';
 export interface IRole extends Document {
     name: string;
     permissions: {};
+    tenantId?: string;
 }
 export type RolePermissions = IRole['permissions'];
 export type RolePermissionsInput = DeepPartial<RolePermissions>;

package/dist/types/types/session.d.ts

@@ -28,6 +28,7 @@ export interface ISession extends Document {
     refreshTokenHash: string;
     expiration: Date;
     user: Types.ObjectId;
+    tenantId?: string;
 }
 export interface CreateSessionOptions {
     expiration?: Date;

package/dist/types/types/systemGrant.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import type { Document, Types } from 'mongoose';
+import type { PrincipalType } from 'librechat-data-provider';
+import type { SystemCapability } from '~/types/admin';
+export type SystemGrant = {
+    /** The type of principal — matches PrincipalType enum values */
+    principalType: PrincipalType;
+    /** ObjectId string for user/group, role name string for role */
+    principalId: string | Types.ObjectId;
+    /** The capability being granted */
+    capability: SystemCapability;
+    /** Absent = platform-operator, present = tenant-scoped */
+    tenantId?: string;
+    /** ID of the user who granted this capability */
+    grantedBy?: Types.ObjectId;
+    /** When this capability was granted */
+    grantedAt?: Date;
+    /** Reserved for future TTL enforcement — time-bounded / temporary grants. */
+    expiresAt?: Date;
+};
+export type ISystemGrant = SystemGrant & Document & {
+    _id: Types.ObjectId;
+};

package/dist/types/types/token.d.ts

@@ -33,6 +33,7 @@ export interface IToken extends Document {
     createdAt: Date;
     expiresAt: Date;
     metadata?: Map<string, unknown>;
+    tenantId?: string;
 }
 export interface TokenCreateData {
     userId: Types.ObjectId | string;
@@ -47,6 +48,7 @@ export interface TokenQuery {
     userId?: Types.ObjectId | string;
     token?: string;
     email?: string;
+    type?: string;
     identifier?: string;
 }
 export interface TokenUpdateData {

package/dist/types/types/user.d.ts

@@ -73,6 +73,7 @@ export interface IUser extends Document {
     updatedAt?: Date;
     /** Field for external source identification (for consistency with TPrincipal schema) */
     idOnTheSource?: string;
+    tenantId?: string;
 }
 export interface BalanceConfig {
     enabled?: boolean;

package/dist/types/utils/index.d.ts

@@ -1 +1,4 @@
+export * from './principal';
+export * from './string';
+export * from './tempChatRetention';
 export * from './transactions';

package/dist/types/utils/principal.d.ts

@@ -0,0 +1,34 @@
+/// <reference types="mongoose/types/aggregate" />
+/// <reference types="mongoose/types/callback" />
+/// <reference types="mongoose/types/collection" />
+/// <reference types="mongoose/types/connection" />
+/// <reference types="mongoose/types/cursor" />
+/// <reference types="mongoose/types/document" />
+/// <reference types="mongoose/types/error" />
+/// <reference types="mongoose/types/expressions" />
+/// <reference types="mongoose/types/helpers" />
+/// <reference types="mongoose/types/middlewares" />
+/// <reference types="mongoose/types/indexes" />
+/// <reference types="mongoose/types/models" />
+/// <reference types="mongoose/types/mongooseoptions" />
+/// <reference types="mongoose/types/pipelinestage" />
+/// <reference types="mongoose/types/populate" />
+/// <reference types="mongoose/types/query" />
+/// <reference types="mongoose/types/schemaoptions" />
+/// <reference types="mongoose/types/schematypes" />
+/// <reference types="mongoose/types/session" />
+/// <reference types="mongoose/types/types" />
+/// <reference types="mongoose/types/utility" />
+/// <reference types="mongoose/types/validation" />
+/// <reference types="mongoose/types/virtuals" />
+/// <reference types="mongoose/types/inferschematype" />
+/// <reference types="mongoose/types/inferrawdoctype" />
+import { Types } from 'mongoose';
+/**
+ * Normalizes a principalId to the correct type for MongoDB queries and storage.
+ * USER and GROUP principals are stored as ObjectIds; ROLE principals are strings.
+ * Ensures a string caller ID is cast to ObjectId so it matches documents written
+ * by `grantCapability` — which always stores user/group IDs as ObjectIds to match
+ * what `getUserPrincipals` returns.
+ */
+export declare const normalizePrincipalId: (principalId: string | Types.ObjectId, principalType: PrincipalType) => string | Types.ObjectId;

package/dist/types/utils/retry.d.ts

@@ -0,0 +1,41 @@
+interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+    retryableErrors?: string[];
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+}
+/**
+ * Executes an async operation with exponential backoff + jitter retry
+ * on transient errors (deadlocks, connection resets, lock timeouts).
+ *
+ * Designed for FerretDB/DocumentDB operations where concurrent index
+ * creation or bulk writes can trigger PostgreSQL-level deadlocks.
+ */
+export declare function retryWithBackoff<T>(operation: () => Promise<T>, label: string, options?: RetryOptions): Promise<T | undefined>;
+/**
+ * Creates all indexes for a Mongoose model with deadlock retry.
+ * Use this instead of raw `model.createIndexes()` on FerretDB.
+ */
+export declare function createIndexesWithRetry(model: {
+    createIndexes: () => Promise<unknown>;
+    modelName: string;
+}, options?: RetryOptions): Promise<void>;
+/**
+ * Initializes all collections and indexes for a set of models on a connection,
+ * with per-model deadlock retry. Models are processed sequentially to minimize
+ * contention on the DocumentDB catalog.
+ */
+export declare function initializeOrgCollections(models: Record<string, {
+    createCollection: () => Promise<unknown>;
+    createIndexes: () => Promise<unknown>;
+    modelName: string;
+}>, options?: RetryOptions): Promise<{
+    totalMs: number;
+    perModel: Array<{
+        name: string;
+        ms: number;
+    }>;
+}>;
+export {};

package/dist/types/utils/string.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Escapes special regex characters in a string.
+ */
+export declare function escapeRegExp(str: string): string;

package/dist/types/utils/tempChatRetention.d.ts

@@ -0,0 +1,25 @@
+import type { AppConfig } from '~/types';
+/**
+ * Default retention period for temporary chats in hours
+ */
+export declare const DEFAULT_RETENTION_HOURS: number;
+/**
+ * Minimum allowed retention period in hours
+ */
+export declare const MIN_RETENTION_HOURS = 1;
+/**
+ * Maximum allowed retention period in hours (1 year = 8760 hours)
+ */
+export declare const MAX_RETENTION_HOURS = 8760;
+/**
+ * Gets the temporary chat retention period from environment variables or config
+ * @param interfaceConfig - The custom configuration object
+ * @returns The retention period in hours
+ */
+export declare function getTempChatRetentionHours(interfaceConfig?: AppConfig['interfaceConfig'] | null): number;
+/**
+ * Creates an expiration date for temporary chats
+ * @param interfaceConfig - The custom configuration object
+ * @returns The expiration date
+ */
+export declare function createTempChatExpirationDate(interfaceConfig?: AppConfig['interfaceConfig']): Date;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/data-schemas",
-  "version": "0.0.39",
+  "version": "0.0.42",
   "description": "Mongoose schemas and models for LibreChat",
   "type": "module",
   "main": "dist/index.cjs",

package/dist/types/app/web.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/accessRole.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/aclEntry.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/file.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/mcpServer.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/token.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/user.methods.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/userGroup.methods.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/userGroup.roles.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/methods/userGroup.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/models/plugins/mongoMeili.spec.d.ts

@@ -1 +0,0 @@
-export {};