@classytic/mongokit 3.10.0 → 3.10.2

package/dist/actions/index.d.mts

@@ -1,2 +1,2 @@
-import { a as create_d_exports, i as delete_d_exports, n as update_d_exports, o as aggregate_d_exports, r as read_d_exports } from "../index-C7WmYP6F.mjs";
+import { a as create_d_exports, i as delete_d_exports, n as update_d_exports, o as aggregate_d_exports, r as read_d_exports } from "../index-CNNavGpM.mjs";
 export { aggregate_d_exports as aggregate, create_d_exports as create, delete_d_exports as deleteActions, read_d_exports as read, update_d_exports as update };

package/dist/ai/index.d.mts

@@ -1,5 +1,5 @@
-import { K as Plugin } from "../types-BUS0Zj8y.mjs";
-import { ClientSession, PipelineStage } from "mongoose";
+import { K as Plugin } from "../types-CYFJa36g.mjs";
+import { PipelineStage } from "mongoose";
 
 //#region src/ai/types.d.ts
 /** Supported similarity metrics for vector search */
@@ -73,7 +73,7 @@ interface VectorSearchParams {
   /** Which vector field config to use (default: first configured) */
   field?: string;
   /** MongoDB session for transactions */
-  session?: ClientSession;
+  session?: unknown;
   /** Fields to include/exclude in results */
   project?: Record<string, 0 | 1>;
   /** Include similarity score in results */

package/dist/{index-C7WmYP6F.d.mts → index-CNNavGpM.d.mts}

@@ -1,5 +1,5 @@
-import { Dt as LookupOptions, E as GroupResult, H as OperationOptions, L as MinMaxResult, Q as ReadPreferenceType, T as FindOneAndUpdateOptions, Y as PopulateSpec, a as AnyDocument, at as SelectSpec, dt as SortSpec, g as CreateOptions, gt as UpdateWithValidationResult, ht as UpdateOptions, mt as UpdateManyResult, y as DeleteResult, z as ObjectId } from "./types-BUS0Zj8y.mjs";
-import { ClientSession, Model, PipelineStage } from "mongoose";
+import { Dt as LookupOptions, E as GroupResult, H as OperationOptions, L as MinMaxResult, Q as ReadPreferenceType, T as FindOneAndUpdateOptions, Y as PopulateSpec, a as AnyDocument, at as SelectSpec, dt as SortSpec, g as CreateOptions, gt as UpdateWithValidationResult, ht as UpdateOptions, mt as UpdateManyResult, y as DeleteResult, z as ObjectId } from "./types-CYFJa36g.mjs";
+import { Model, PipelineStage } from "mongoose";
 
 //#region src/actions/aggregate.d.ts
 declare namespace aggregate_d_exports {
@@ -9,7 +9,7 @@ declare namespace aggregate_d_exports {
  * Execute aggregation pipeline
  */
 declare function aggregate<TResult = unknown>(Model: Model<any>, pipeline: PipelineStage[], options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<TResult[]>;
 /**
  * Aggregate with pagination using native MongoDB $facet
@@ -19,7 +19,7 @@ declare function aggregate<TResult = unknown>(Model: Model<any>, pipeline: Pipel
 declare function aggregatePaginate<TDoc = AnyDocument>(Model: Model<TDoc>, pipeline: PipelineStage[], options?: {
   page?: number;
   limit?: number;
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<{
   docs: TDoc[];
   total: number;
@@ -34,13 +34,13 @@ declare function aggregatePaginate<TDoc = AnyDocument>(Model: Model<TDoc>, pipel
  */
 declare function groupBy(Model: Model<any>, field: string, options?: {
   limit?: number;
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<GroupResult[]>;
 /**
  * Count by field values
  */
 declare function countBy(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<GroupResult[]>;
 /**
  * Lookup (join) with another collection
@@ -57,38 +57,38 @@ declare function lookup<TDoc = AnyDocument>(Model: Model<TDoc>, lookupOptions: L
  */
 declare function unwind<TDoc = AnyDocument>(Model: Model<TDoc>, field: string, options?: {
   preserveEmpty?: boolean;
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<TDoc[]>;
 /**
  * Facet search (multiple aggregations in one query)
  */
 declare function facet<TResult = Record<string, unknown[]>>(Model: Model<any>, facets: Record<string, PipelineStage[]>, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<TResult[]>;
 /**
  * Get distinct values
  */
 declare function distinct<T = unknown>(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   readPreference?: string;
 }): Promise<T[]>;
 /**
  * Calculate sum
  */
 declare function sum(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<number>;
 /**
  * Calculate average
  */
 declare function average(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<number>;
 /**
  * Min/Max
  */
 declare function minMax(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<MinMaxResult>;
 declare namespace create_d_exports {
   export { create, createDefault, createMany, upsert };
@@ -109,7 +109,7 @@ declare function createDefault<TDoc = AnyDocument>(Model: Model<TDoc>, overrides
  * Upsert (create or update)
  */
 declare function upsert<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, data: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   updatePipeline?: boolean;
 }): Promise<TDoc | null>;
 declare namespace delete_d_exports {
@@ -119,34 +119,34 @@ declare namespace delete_d_exports {
  * Delete by ID
  */
 declare function deleteById<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, options?: {
-  session?: ClientSession;
+  session?: unknown;
   query?: Record<string, unknown>;
 }): Promise<DeleteResult>;
 /**
  * Delete many documents
  */
 declare function deleteMany<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<DeleteResult>;
 /**
  * Delete by query
  */
 declare function deleteByQuery(Model: Model<any>, query: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   throwOnNotFound?: boolean;
 }): Promise<DeleteResult>;
 /**
  * Soft delete (set deleted flag)
  */
 declare function softDelete<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, options?: {
-  session?: ClientSession;
+  session?: unknown;
   userId?: string;
 }): Promise<DeleteResult>;
 /**
  * Restore soft deleted document
  */
 declare function restore<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, options?: {
-  session?: ClientSession;
+  session?: unknown;
 }): Promise<DeleteResult>;
 declare namespace read_d_exports {
   export { count, exists, getAll, getById, getByQuery, getOrCreate, tryGetByQuery };
@@ -186,28 +186,28 @@ declare function getAll<TDoc = AnyDocument>(Model: Model<TDoc>, query?: Record<s
   limit?: number;
   skip?: number;
   lean?: boolean;
-  session?: ClientSession;
+  session?: unknown;
   readPreference?: ReadPreferenceType;
 }): Promise<TDoc[]>;
 /**
  * Get or create document (upsert)
  */
 declare function getOrCreate<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, createData: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   updatePipeline?: boolean;
 }): Promise<TDoc | null>;
 /**
  * Count documents matching query
  */
 declare function count<TDoc = AnyDocument>(Model: Model<TDoc>, query?: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   readPreference?: ReadPreferenceType;
 }): Promise<number>;
 /**
  * Check if document exists
  */
 declare function exists<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   readPreference?: ReadPreferenceType;
 }): Promise<{
   _id: unknown;
@@ -247,7 +247,7 @@ declare function updateWithValidation<TDoc = AnyDocument>(Model: Model<TDoc>, id
  * Update many documents
  */
 declare function updateMany(Model: Model<unknown>, query: Record<string, unknown>, data: Record<string, unknown>, options?: {
-  session?: ClientSession;
+  session?: unknown;
   updatePipeline?: boolean;
   arrayFilters?: Record<string, unknown>[];
 }): Promise<UpdateManyResult>;

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { $ as RepositoryContext, A as InferRawDoc, B as OffsetPaginationOptions, C as EventPhase, Ct as IControllerResponse, D as HookMode, Dt as LookupOptions, E as GroupResult, Et as LookupBuilder, F as LookupPopulateOptions, G as PartialBy, H as OperationOptions, I as LookupPopulateResult, J as PluginType, K as Plugin, L as MinMaxResult, M as KeysetPaginationOptions, N as KeysetPaginationResult, O as HttpError, P as Logger, Q as ReadPreferenceType, R as NonNullableFields, S as EventPayload, St as IController, T as FindOneAndUpdateOptions, Tt as IResponseFormatter, U as PaginationConfig, V as OffsetPaginationResult, W as PaginationResult, X as PrioritizedHook, Y as PopulateSpec, Z as ReadOptions, _ as DecodedCursor, _t as UserContext, a as AnyDocument, at as SelectSpec, b as DocField, bt as WithPlugins, c as CacheOperationOptions, ct as SoftDeleteOptions, d as CacheableOptions, dt as SortSpec, et as RepositoryEvent, f as CascadeOptions, ft as Strict, g as CreateOptions, gt as UpdateWithValidationResult, h as CreateInput, ht as UpdateOptions, i as AllPluginMethods, it as RequiredBy, j as KeysOfType, k as InferDocument, l as CacheOptions, lt as SoftDeleteRepository, m as CollationOptions, mt as UpdateManyResult, n as AggregatePaginationOptions, nt as RepositoryOperation, o as AnyModel, ot as SessionOptions, p as CascadeRelation, pt as UpdateInput, q as PluginFunction, r as AggregatePaginationResult, rt as RepositoryOptions, s as CacheAdapter, st as SoftDeleteFilterMode, t as AggregateOptions, tt as RepositoryInstance, u as CacheStats, ut as SortDirection, v as DeepPartial, vt as ValidationChainOptions, w as FieldPreset, wt as IRequestContext, x as EventHandlers, xt as WithTransactionOptions, y as DeleteResult, yt as ValidatorDefinition, z as ObjectId } from "./types-BUS0Zj8y.mjs";
-import { t as index_d_exports } from "./index-C7WmYP6F.mjs";
+import { $ as RepositoryContext, A as InferRawDoc, B as OffsetPaginationOptions, C as EventPhase, Ct as IControllerResponse, D as HookMode, Dt as LookupOptions, E as GroupResult, Et as LookupBuilder, F as LookupPopulateOptions, G as PartialBy, H as OperationOptions, I as LookupPopulateResult, J as PluginType, K as Plugin, L as MinMaxResult, M as KeysetPaginationOptions, N as KeysetPaginationResult, O as HttpError, P as Logger, Q as ReadPreferenceType, R as NonNullableFields, S as EventPayload, St as IController, T as FindOneAndUpdateOptions, Tt as IResponseFormatter, U as PaginationConfig, V as OffsetPaginationResult, W as PaginationResult, X as PrioritizedHook, Y as PopulateSpec, Z as ReadOptions, _ as DecodedCursor, _t as UserContext, a as AnyDocument, at as SelectSpec, b as DocField, bt as WithPlugins, c as CacheOperationOptions, ct as SoftDeleteOptions, d as CacheableOptions, dt as SortSpec, et as RepositoryEvent, f as CascadeOptions, ft as Strict, g as CreateOptions, gt as UpdateWithValidationResult, h as CreateInput, ht as UpdateOptions, i as AllPluginMethods, it as RequiredBy, j as KeysOfType, k as InferDocument, l as CacheOptions, lt as SoftDeleteRepository, m as CollationOptions, mt as UpdateManyResult, n as AggregatePaginationOptions, nt as RepositoryOperation, o as AnyModel, ot as SessionOptions, p as CascadeRelation, pt as UpdateInput, q as PluginFunction, r as AggregatePaginationResult, rt as RepositoryOptions, s as CacheAdapter, st as SoftDeleteFilterMode, t as AggregateOptions, tt as RepositoryInstance, u as CacheStats, ut as SortDirection, v as DeepPartial, vt as ValidationChainOptions, w as FieldPreset, wt as IRequestContext, x as EventHandlers, xt as WithTransactionOptions, y as DeleteResult, yt as ValidatorDefinition, z as ObjectId } from "./types-CYFJa36g.mjs";
+import { t as index_d_exports } from "./index-CNNavGpM.mjs";
 import { PaginationEngine } from "./pagination/PaginationEngine.mjs";
-import { $ as aggregateHelpersPlugin, A as PrefixedIdOptions, B as BatchOperationsMethods, C as methodRegistryPlugin, D as CustomIdOptions, E as elasticSearchPlugin, F as prefixedId, G as AuditQueryOptions, H as batchOperationsPlugin, I as sequentialId, J as AuditTrailOptions, K as AuditQueryResult, L as cascadePlugin, M as customIdPlugin, N as dateSequentialId, O as DateSequentialIdOptions, P as getNextSequence, Q as AggregateHelpersMethods, R as CacheMethods, T as ElasticSearchOptions, U as AuditEntry, V as BulkWriteResult, W as AuditOperation, X as auditTrailPlugin, Y as AuditTrailQuery, Z as auditLogPlugin, _ as observabilityPlugin, a as uniqueField, b as MongoOperationsMethods, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as SequentialIdOptions, k as IdGenerator, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, q as AuditTrailMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MultiTenantOptions, w as fieldFilterPlugin, x as mongoOperationsPlugin, y as multiTenantPlugin, z as cachePlugin } from "./validation-chain.plugin-JkipjuOR.mjs";
+import { $ as aggregateHelpersPlugin, A as PrefixedIdOptions, B as BatchOperationsMethods, C as methodRegistryPlugin, D as CustomIdOptions, E as elasticSearchPlugin, F as prefixedId, G as AuditQueryOptions, H as batchOperationsPlugin, I as sequentialId, J as AuditTrailOptions, K as AuditQueryResult, L as cascadePlugin, M as customIdPlugin, N as dateSequentialId, O as DateSequentialIdOptions, P as getNextSequence, Q as AggregateHelpersMethods, R as CacheMethods, T as ElasticSearchOptions, U as AuditEntry, V as BulkWriteResult, W as AuditOperation, X as auditTrailPlugin, Y as AuditTrailQuery, Z as auditLogPlugin, _ as observabilityPlugin, a as uniqueField, b as MongoOperationsMethods, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as SequentialIdOptions, k as IdGenerator, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, q as AuditTrailMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MultiTenantOptions, w as fieldFilterPlugin, x as mongoOperationsPlugin, y as multiTenantPlugin, z as cachePlugin } from "./validation-chain.plugin-BNG3coI0.mjs";
 import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-oM8G4b6m.mjs";
 import { n as SchemaIndexes } from "./indexes-C26GNZRU.mjs";
-import { a as createFieldPreset, c as getMongooseProjection, d as parseDuplicateKeyError, i as configureLogger, l as createError, n as buildCrudSchemasFromMongooseSchema, o as filterResponseData, r as createMemoryCache, s as getFieldsForUser, t as buildCrudSchemasFromModel, u as isDuplicateKeyError } from "./mongooseToJsonSchema-t-MoVleF.mjs";
+import { a as createFieldPreset, c as getMongooseProjection, d as parseDuplicateKeyError, i as configureLogger, l as createError, n as buildCrudSchemasFromMongooseSchema, o as filterResponseData, r as createMemoryCache, s as getFieldsForUser, t as buildCrudSchemasFromModel, u as isDuplicateKeyError } from "./mongooseToJsonSchema-Bi8hNbj8.mjs";
 import * as _$mongoose from "mongoose";
 import { ClientSession, Expression, Model, PipelineStage, PopulateOptions } from "mongoose";
 import { AggPaginationRequest, AggRequest, AggResult, RepositoryBase } from "@classytic/repo-core/repository";
@@ -1193,7 +1193,7 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * });
    * ```
    */
-  lookupPopulate(options: LookupPopulateOptions): Promise<LookupPopulateResult<TDoc>>;
+  lookupPopulate<TExtra extends Record<string, unknown> = Record<string, unknown>>(options: LookupPopulateOptions<TDoc>): Promise<LookupPopulateResult<TDoc, TExtra>>;
   /**
    * Create an aggregation builder for this model
    * Useful for building complex custom aggregations

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { r as warn, t as configureLogger } from "./logger-DJ7egMnd.mjs";
 import { b as LookupBuilder } from "./update-CWXfFC6O.mjs";
 import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-CzYwrfUP.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
-import { A as AuditTrailQuery, C as cachePlugin, D as withTransaction, E as isTransactionUnsupported, F as MUTATING_OPERATIONS, I as OP_REGISTRY, L as READ_OPERATIONS, M as auditLogPlugin, N as aggregateHelpersPlugin, O as AggregationBuilder, P as ALL_OPERATIONS, R as operationsByPolicyKey, S as cascadePlugin, T as Repository, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, w as HOOK_PRIORITY, x as sequentialId, y as getNextSequence } from "./validation-chain.plugin-Ccu6irtx.mjs";
+import { A as AuditTrailQuery, C as cachePlugin, D as withTransaction, E as isTransactionUnsupported, F as MUTATING_OPERATIONS, I as OP_REGISTRY, L as READ_OPERATIONS, M as auditLogPlugin, N as aggregateHelpersPlugin, O as AggregationBuilder, P as ALL_OPERATIONS, R as operationsByPolicyKey, S as cascadePlugin, T as Repository, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, w as HOOK_PRIORITY, x as sequentialId, y as getNextSequence } from "./validation-chain.plugin-Bt8HepWW.mjs";
 import { t as PaginationEngine } from "./PaginationEngine-B93fLCcO.mjs";
 import { isGeoOperator, parseGeoFilter } from "./query/primitives/geo.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-dI0m4RBs.mjs";

package/dist/{mongooseToJsonSchema-t-MoVleF.d.mts → mongooseToJsonSchema-Bi8hNbj8.d.mts}

@@ -1,4 +1,4 @@
-import { O as HttpError, _t as UserContext, s as CacheAdapter, w as FieldPreset } from "./types-BUS0Zj8y.mjs";
+import { O as HttpError, _t as UserContext, s as CacheAdapter, w as FieldPreset } from "./types-CYFJa36g.mjs";
 import mongoose, { Schema } from "mongoose";
 import { CrudSchemas, SchemaBuilderOptions } from "@classytic/repo-core/schema";
 

package/dist/pagination/PaginationEngine.d.mts

@@ -1,4 +1,4 @@
-import { B as OffsetPaginationOptions, M as KeysetPaginationOptions, N as KeysetPaginationResult, U as PaginationConfig, V as OffsetPaginationResult, a as AnyDocument, n as AggregatePaginationOptions, r as AggregatePaginationResult } from "../types-BUS0Zj8y.mjs";
+import { B as OffsetPaginationOptions, M as KeysetPaginationOptions, N as KeysetPaginationResult, U as PaginationConfig, V as OffsetPaginationResult, a as AnyDocument, n as AggregatePaginationOptions, r as AggregatePaginationResult } from "../types-CYFJa36g.mjs";
 import { Model } from "mongoose";
 
 //#region src/pagination/PaginationEngine.d.ts

package/dist/plugins/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as aggregateHelpersPlugin, A as PrefixedIdOptions, B as BatchOperationsMethods, C as methodRegistryPlugin, D as CustomIdOptions, E as elasticSearchPlugin, F as prefixedId, G as AuditQueryOptions, H as batchOperationsPlugin, I as sequentialId, J as AuditTrailOptions, K as AuditQueryResult, L as cascadePlugin, M as customIdPlugin, N as dateSequentialId, O as DateSequentialIdOptions, P as getNextSequence, Q as AggregateHelpersMethods, R as CacheMethods, S as MethodRegistryRepository, T as ElasticSearchOptions, U as AuditEntry, W as AuditOperation, X as auditTrailPlugin, Y as AuditTrailQuery, Z as auditLogPlugin, _ as observabilityPlugin, a as uniqueField, b as MongoOperationsMethods, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as SequentialIdOptions, k as IdGenerator, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, q as AuditTrailMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MultiTenantOptions, w as fieldFilterPlugin, x as mongoOperationsPlugin, y as multiTenantPlugin, z as cachePlugin } from "../validation-chain.plugin-JkipjuOR.mjs";
+import { $ as aggregateHelpersPlugin, A as PrefixedIdOptions, B as BatchOperationsMethods, C as methodRegistryPlugin, D as CustomIdOptions, E as elasticSearchPlugin, F as prefixedId, G as AuditQueryOptions, H as batchOperationsPlugin, I as sequentialId, J as AuditTrailOptions, K as AuditQueryResult, L as cascadePlugin, M as customIdPlugin, N as dateSequentialId, O as DateSequentialIdOptions, P as getNextSequence, Q as AggregateHelpersMethods, R as CacheMethods, S as MethodRegistryRepository, T as ElasticSearchOptions, U as AuditEntry, W as AuditOperation, X as auditTrailPlugin, Y as AuditTrailQuery, Z as auditLogPlugin, _ as observabilityPlugin, a as uniqueField, b as MongoOperationsMethods, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as SequentialIdOptions, k as IdGenerator, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, q as AuditTrailMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MultiTenantOptions, w as fieldFilterPlugin, x as mongoOperationsPlugin, y as multiTenantPlugin, z as cachePlugin } from "../validation-chain.plugin-BNG3coI0.mjs";
 export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheMethods, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,2 +1,2 @@
-import { A as AuditTrailQuery, C as cachePlugin, M as auditLogPlugin, N as aggregateHelpersPlugin, S as cascadePlugin, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, x as sequentialId, y as getNextSequence } from "../validation-chain.plugin-Ccu6irtx.mjs";
+import { A as AuditTrailQuery, C as cachePlugin, M as auditLogPlugin, N as aggregateHelpersPlugin, S as cascadePlugin, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, x as sequentialId, y as getNextSequence } from "../validation-chain.plugin-Bt8HepWW.mjs";
 export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/{types-BUS0Zj8y.d.mts → types-CYFJa36g.d.mts}

@@ -1,5 +1,6 @@
 import * as _$mongoose from "mongoose";
-import { ClientSession, Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
+import { Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
+import * as _$_classytic_repo_core_filter0 from "@classytic/repo-core/filter";
 import * as _$_classytic_repo_core_repository0 from "@classytic/repo-core/repository";
 import { DeleteResult, LookupPopulateResult, UpdateManyResult } from "@classytic/repo-core/repository";
 import { ValidationResult } from "@classytic/repo-core/schema";
@@ -26,7 +27,7 @@ interface LookupOptions {
   query?: Record<string, unknown>;
   /** Query options (legacy, for aggregate.ts compatibility) */
   options?: {
-    session?: ClientSession;
+    session?: unknown;
   };
   /** Sanitize pipeline stages (default: true). Set false only for trusted server-side pipelines */
   sanitize?: boolean;
@@ -495,8 +496,15 @@ type SortDirection = 1 | -1;
 type SortSpec = Record<string, SortDirection>;
 /** Populate specification */
 type PopulateSpec = string | string[] | PopulateOptions | PopulateOptions[];
-/** Select specification */
-type SelectSpec = string | string[] | Record<string, 0 | 1>;
+/**
+ * Select specification. `readonly string[]` widens the legacy `string[]`
+ * form to also accept the immutable variant repo-core's contract uses
+ * (`LookupPopulateOptions.select: readonly string[] | Record<string, 0
+ * | 1>`), so `Repository<TDoc>` assigns to `StandardRepo<TDoc>` without
+ * TS2322 on the `select` field. Any existing mutable-array caller stays
+ * compatible — `string[]` is assignable to `readonly string[]`.
+ */
+type SelectSpec = string | readonly string[] | Record<string, 0 | 1>;
 /** Filter query type for MongoDB queries (compatible with Mongoose 8 & 9) */
 type FilterQuery<_T = unknown> = Record<string, unknown>;
 /**
@@ -651,7 +659,7 @@ interface BasePaginationOptions {
   /** Return plain JavaScript objects */
   lean?: boolean;
   /** MongoDB session for transactions */
-  session?: ClientSession;
+  session?: unknown;
   /** Query hint (index name or document) */
   hint?: string | Record<string, 1 | -1>;
   /** Maximum execution time in milliseconds */
@@ -692,7 +700,7 @@ interface AggregatePaginationOptions {
   /** Number of documents per page */
   limit?: number;
   /** MongoDB session for transactions */
-  session?: ClientSession;
+  session?: unknown;
   /** Query hint (index name or document) for aggregation */
   hint?: string | Record<string, 1 | -1>;
   /** Maximum execution time in milliseconds */
@@ -766,7 +774,7 @@ type PaginationResult<T = unknown> = OffsetPaginationResult<T> | KeysetPaginatio
 /** Session-only options — shared base for lightweight operations */
 interface SessionOptions {
   /** MongoDB session for transactions */
-  session?: ClientSession;
+  session?: unknown;
   /** Organization/tenant ID for multi-tenant plugin scoping */
   organizationId?: string | ObjectId;
   /** Extensible — plugins can read custom fields from options */
@@ -870,8 +878,12 @@ interface AggregateOptions extends ReadOptions {
 /** Lookup populate options */
 /**
  * Mongokit's `lookupPopulate` options — kit-native superset of the
- * portable `LookupPopulateOptions` from repo-core. Widens two slots:
+ * portable `LookupPopulateOptions<TBase>` from repo-core. Widens three
+ * slots so arc / mongoose consumers compose cleanly:
  *
+ *   - `filters`: accepts Filter IR, a `Partial<TBase> & Record<string,
+ *     unknown>` literal (same shape repo-core's contract uses), or a
+ *     plain `Record<string, unknown>` for legacy callers.
  *   - `lookups`: accepts either the portable `LookupSpec[]` (works on
  *     every kit) or mongokit's `LookupOptions[]` (adds `pipeline` /
  *     `let` / `sanitize` for mongo-correlated joins).
@@ -879,13 +891,19 @@ interface AggregateOptions extends ReadOptions {
  *     (`'name email'`) in addition to the portable array / inclusion
  *     map. Kept for arc + existing controller convenience.
  *
- * For cross-kit code: type the variable as
- * `import('@classytic/repo-core/repository').LookupPopulateOptions<TDoc>`
- * — every kit's `lookupPopulate` accepts that shape.
+ * `TBase` defaults to `unknown` so legacy non-generic usage still
+ * compiles; pass the doc type for arc `RepositoryLike<TDoc>` structural
+ * assignment — `LookupPopulateOptions<TDoc>` is bit-compatible with
+ * `import('@classytic/repo-core/repository').LookupPopulateOptions<TDoc>`.
  */
-interface LookupPopulateOptions extends ReadOptions {
-  /** MongoDB query filters */
-  filters?: Record<string, unknown>;
+interface LookupPopulateOptions<TBase = unknown> {
+  /**
+   * Base-table filter. Accepts Filter IR from repo-core, a typed
+   * `Partial<TBase> & Record<string, unknown>` literal (what arc
+   * controllers produce when typed against `StandardRepo<TDoc>`), or
+   * a plain `Record<string, unknown>` for ad-hoc callers.
+   */
+  filters?: _$_classytic_repo_core_filter0.Filter | (Partial<TBase> & Record<string, unknown>) | Record<string, unknown>;
   /**
    * Portable `LookupSpec[]` (cross-kit) or mongokit-native
    * `LookupOptions[]` (with `pipeline` / `let` / `sanitize`). The
@@ -906,6 +924,19 @@ interface LookupPopulateOptions extends ReadOptions {
   collation?: CollationOptions;
   /** Count strategy for offset pagination */
   countStrategy?: 'exact' | 'estimated' | 'none';
+  /**
+   * Transaction session. Typed `unknown` to match repo-core's
+   * `RepositorySession` contract — mongokit narrows to `ClientSession`
+   * internally. Not inherited from `ReadOptions` because the repo-core
+   * contract type has no `[key: string]: unknown` escape hatch, and
+   * arc's `Partial<StandardRepo<TDoc>>` boundary rejects index-signature
+   * drift under strict function-type variance.
+   */
+  session?: unknown;
+  /** Read preference for replica sets (e.g. 'secondaryPreferred') */
+  readPreference?: ReadPreferenceType;
+  /** Multi-tenant plugin scoping (applied via before:lookupPopulate hook). */
+  organizationId?: string | ObjectId;
 }
 /**
  * Union emitted by the validation-chain plugin. Keeps the violation shape
@@ -957,7 +988,7 @@ interface RepositoryContext {
   /** Return lean documents */
   lean?: boolean;
   /** MongoDB session */
-  session?: ClientSession;
+  session?: unknown;
   /** Read preference for replica sets */
   readPreference?: ReadPreferenceType;
   /** Pagination filters */
@@ -1157,7 +1188,7 @@ interface SoftDeleteRepository<TDoc = unknown> {
    * @returns The restored document
    */
   restore(id: string | ObjectId, options?: {
-    session?: ClientSession;
+    session?: unknown;
   }): Promise<TDoc>;
   /**
    * Get all soft-deleted documents
@@ -1174,7 +1205,7 @@ interface SoftDeleteRepository<TDoc = unknown> {
     select?: SelectSpec;
     populate?: PopulateSpec;
     lean?: boolean;
-    session?: ClientSession;
+    session?: unknown;
   }): Promise<OffsetPaginationResult<TDoc>>;
 }
 /** Group result */
@@ -1370,7 +1401,7 @@ type AllPluginMethods<TDoc> = {
   setMax(id: string | ObjectId, field: DocField<TDoc>, value: unknown, options?: Record<string, unknown>): Promise<TDoc>;
   atomicUpdate(id: string | ObjectId, operators: Record<string, Record<string, unknown>>, options?: Record<string, unknown>): Promise<TDoc>;
   updateMany(query: Record<string, unknown>, data: Record<string, unknown>, options?: {
-    session?: ClientSession;
+    session?: unknown;
     updatePipeline?: boolean;
   }): Promise<{
     acknowledged: boolean;
@@ -1384,7 +1415,7 @@ type AllPluginMethods<TDoc> = {
     deletedCount: number;
   }>;
   bulkWrite(operations: Record<string, unknown>[], options?: {
-    session?: ClientSession;
+    session?: unknown;
     ordered?: boolean;
   }): Promise<{
     ok: number;
@@ -1417,7 +1448,7 @@ type AllPluginMethods<TDoc> = {
   }): Promise<TDoc>;
   deleteSubdocument(parentId: string | ObjectId, arrayPath: DocField<TDoc>, subId: string | ObjectId, options?: Record<string, unknown>): Promise<TDoc>;
   restore(id: string | ObjectId, options?: {
-    session?: ClientSession;
+    session?: unknown;
   }): Promise<TDoc>;
   getDeleted(params?: {
     filters?: Record<string, unknown>;
@@ -1428,7 +1459,7 @@ type AllPluginMethods<TDoc> = {
     select?: SelectSpec;
     populate?: PopulateSpec;
     lean?: boolean;
-    session?: ClientSession;
+    session?: unknown;
   }): Promise<OffsetPaginationResult<TDoc>>;
   invalidateCache(id: string): Promise<void>;
   invalidateListCache(): Promise<void>;

package/dist/utils/index.d.mts

@@ -1,5 +1,5 @@
-import { Y as PopulateSpec, at as SelectSpec, dt as SortSpec } from "../types-BUS0Zj8y.mjs";
-import { a as createFieldPreset, c as getMongooseProjection, i as configureLogger, l as createError, n as buildCrudSchemasFromMongooseSchema, o as filterResponseData, r as createMemoryCache, s as getFieldsForUser, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-t-MoVleF.mjs";
+import { Y as PopulateSpec, at as SelectSpec, dt as SortSpec } from "../types-CYFJa36g.mjs";
+import { a as createFieldPreset, c as getMongooseProjection, i as configureLogger, l as createError, n as buildCrudSchemasFromMongooseSchema, o as filterResponseData, r as createMemoryCache, s as getFieldsForUser, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-Bi8hNbj8.mjs";
 
 //#region src/utils/cache-keys.d.ts
 /**

package/dist/{validation-chain.plugin-JkipjuOR.d.mts → validation-chain.plugin-BNG3coI0.d.mts}

@@ -1,5 +1,5 @@
-import { $ as RepositoryContext, K as Plugin, P as Logger, V as OffsetPaginationResult, Y as PopulateSpec, at as SelectSpec, ct as SoftDeleteOptions, dt as SortSpec, f as CascadeOptions, l as CacheOptions, tt as RepositoryInstance, u as CacheStats, vt as ValidationChainOptions, w as FieldPreset, yt as ValidatorDefinition, z as ObjectId } from "./types-BUS0Zj8y.mjs";
-import mongoose, { ClientSession } from "mongoose";
+import { $ as RepositoryContext, K as Plugin, P as Logger, V as OffsetPaginationResult, Y as PopulateSpec, at as SelectSpec, ct as SoftDeleteOptions, dt as SortSpec, f as CascadeOptions, l as CacheOptions, tt as RepositoryInstance, u as CacheStats, vt as ValidationChainOptions, w as FieldPreset, yt as ValidatorDefinition, z as ObjectId } from "./types-CYFJa36g.mjs";
+import mongoose from "mongoose";
 import { BulkWriteResult } from "@classytic/repo-core/repository";
 import { AsyncLocalStorage } from "node:async_hooks";
 
@@ -266,7 +266,7 @@ interface BatchOperationsMethods {
    * @returns Update result with matchedCount, modifiedCount, etc.
    */
   updateMany(query: Record<string, unknown>, data: Record<string, unknown>, options?: {
-    session?: ClientSession;
+    session?: unknown;
     updatePipeline?: boolean;
   }): Promise<{
     acknowledged: boolean;
@@ -287,7 +287,7 @@ interface BatchOperationsMethods {
    * @returns Delete result with deletedCount
    */
   deleteMany(query: Record<string, unknown>, options?: {
-    session?: ClientSession;
+    session?: unknown;
     mode?: 'hard' | 'soft';
     [key: string]: unknown;
   }): Promise<{
@@ -311,7 +311,7 @@ interface BatchOperationsMethods {
    * console.log(result.insertedCount, result.modifiedCount, result.deletedCount);
    */
   bulkWrite(operations: Record<string, unknown>[], options?: {
-    session?: ClientSession;
+    session?: unknown;
     ordered?: boolean;
   }): Promise<BulkWriteResult>;
 }
@@ -928,7 +928,7 @@ interface SoftDeleteMethods<TDoc> {
    * @returns Restored document
    */
   restore(id: string | ObjectId, options?: {
-    session?: ClientSession;
+    session?: unknown;
   }): Promise<TDoc>;
   /**
    * Get paginated list of soft-deleted documents
@@ -945,7 +945,7 @@ interface SoftDeleteMethods<TDoc> {
     select?: SelectSpec;
     populate?: PopulateSpec;
     lean?: boolean;
-    session?: ClientSession;
+    session?: unknown;
   }): Promise<OffsetPaginationResult<TDoc>>;
 }
 //#endregion

package/dist/{validation-chain.plugin-Ccu6irtx.mjs → validation-chain.plugin-Bt8HepWW.mjs}

@@ -985,12 +985,13 @@ function buildAggPipeline(req) {
 //#endregion
 //#region src/actions/aggregate-ir/count.ts
 async function countAggGroups(Model, req, options = {}) {
+	const session = options.session;
 	const groupCols = normalizeGroupBy(req.groupBy);
 	if (req.having) {
 		const { pipeline, prePaginationIndex } = buildAggPipeline(req);
 		const finalPipeline = [...pipeline.slice(0, prePaginationIndex), { $count: "n" }];
 		const aggregation = Model.aggregate(finalPipeline);
-		if (options.session) aggregation.session(options.session);
+		if (session) aggregation.session(session);
 		const [row] = await aggregation.exec();
 		return row?.n ?? 0;
 	}
@@ -1001,7 +1002,7 @@ async function countAggGroups(Model, req, options = {}) {
 		pipeline.push({ $limit: 1 });
 		pipeline.push({ $count: "n" });
 		const aggregation = Model.aggregate(pipeline);
-		if (options.session) aggregation.session(options.session);
+		if (session) aggregation.session(session);
 		const [row] = await aggregation.exec();
 		return row?.n ?? 0;
 	}
@@ -1014,16 +1015,17 @@ async function countAggGroups(Model, req, options = {}) {
 	pipeline.push({ $group: { _id: groupId } });
 	pipeline.push({ $count: "n" });
 	const aggregation = Model.aggregate(pipeline);
-	if (options.session) aggregation.session(options.session);
+	if (session) aggregation.session(session);
 	const [row] = await aggregation.exec();
 	return row?.n ?? 0;
 }
 //#endregion
 //#region src/actions/aggregate-ir/execute.ts
 async function executeAgg(Model, req, options = {}) {
+	const session = options.session;
 	const { pipeline } = buildAggPipeline(req);
 	const aggregation = Model.aggregate(pipeline);
-	if (options.session) aggregation.session(options.session);
+	if (session) aggregation.session(session);
 	return await aggregation.exec();
 }
 //#endregion
@@ -2712,9 +2714,11 @@ var Repository = class extends RepositoryBase {
 					for (const field of selectSpec) if (field.startsWith("-")) projection[field.substring(1)] = 0;
 					else projection[field] = 1;
 				} else projection = { ...selectSpec };
-				if (Object.values(projection).some((v) => v === 1)) for (const lookup of lookups) {
-					const asField = lookup.as || lookup.from;
-					if (!(asField in projection)) projection[asField] = 1;
+				if (projection) {
+					if (Object.values(projection).some((v) => v === 1)) for (const lookup of lookups) {
+						const asField = lookup.as || lookup.from;
+						if (!(asField in projection)) projection[asField] = 1;
+					}
 				}
 			}
 			const appendLookupStages = (pipeline) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.10.0",
+  "version": "3.10.2",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -110,14 +110,15 @@
     "test:watch": "vitest --project unit --project integration",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
     "lint": "biome check src/",
     "lint:fix": "biome check src/ --write",
     "format": "biome format src/ --write",
     "check": "biome ci src/ --diagnostic-level=error",
-    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm test",
+    "prepublishOnly": "npm run check && npm run build && npm run typecheck && npm run typecheck:tests && npm test",
     "publish:dry": "npm publish --dry-run --access public",
     "publish:npm": "npm publish --access public",
-    "release": "npm run check && npm run build && npm run typecheck && npm test && npm publish --access public",
+    "release": "npm run check && npm run build && npm run typecheck && npm run typecheck:tests && npm test && npm publish --access public",
     "release:patch": "npm version patch && npm run release",
     "release:minor": "npm version minor && npm run release",
     "release:major": "npm version major && npm run release"