@warlock.js/core 4.4.0 → 4.6.0

package/esm/repositories/repository.manager.mjs

@@ -61,9 +61,13 @@ var RepositoryManager = class {
 	* Register events
 	*/
 	registerEvents() {
-		this.eventsCallbacks.push(...this.adapter.registerEvents((source) => {
-			this.clearCache();
-		}));
+		try {
+			this.eventsCallbacks.push(...this.adapter.registerEvents((source) => {
+				this.clearCache();
+			}));
+		} catch (error) {
+			console.error(`[Repository] Failed to register events:`, error);
+		}
 	}
 	/**
 	* Unregister events
@@ -350,6 +354,7 @@ var RepositoryManager = class {
 	async all(options) {
 		const query = this.newQuery();
 		const opts = this.prepareOptions(options);
+		opts.paginate = false;
 		this.applyOptionsToQuery(query, opts);
 		return query.get();
 	}
@@ -459,10 +464,10 @@ var RepositoryManager = class {
 		if (options.deselect) query.deselect(options.deselect);
 		if (options.simpleSelect && this.simpleSelectColumns.length > 0) query.select(this.simpleSelectColumns);
 		if (options.orderBy) {
-			if (options.orderBy === "random") query.random();
+			if (options.orderBy === "random") query.random(options.limit);
 			else if (Array.isArray(options.orderBy)) query.orderBy(options.orderBy[0], options.orderBy[1]);
 			else if (typeof options.orderBy === "object") query.sortBy(options.orderBy);
-		}
+		} else if (options.sortBy) query.orderBy(options.sortBy, options.sortDirection ?? "asc");
 		if (options.limit && options.paginate === false) query.limit(options.limit);
 		if (options?.perform) options.perform(query, options);
 		return options;
@@ -474,7 +479,12 @@ var RepositoryManager = class {
 	* @public
 	*/
 	async create(data) {
-		return this.adapter.create(data);
+		await this.onSaving(data, "create");
+		await this.onCreating(data);
+		const result = await this.adapter.create(data);
+		await this.onCreate(result, data);
+		await this.onSave(result, data, "create");
+		return result;
 	}
 	/**
 	* Update a record by ID
@@ -484,7 +494,12 @@ var RepositoryManager = class {
 	* @public
 	*/
 	async update(id, data) {
-		return this.adapter.update(id, data);
+		await this.onSaving(data, "update");
+		await this.onUpdating(id, data);
+		const result = await this.adapter.update(id, data);
+		await this.onUpdate(result, data);
+		await this.onSave(result, data, "update");
+		return result;
 	}
 	/**
 	* Delete a record by ID
@@ -493,7 +508,9 @@ var RepositoryManager = class {
 	* @public
 	*/
 	async delete(id) {
-		return this.adapter.delete(id);
+		await this.onDeleting(id);
+		await this.adapter.delete(id);
+		await this.onDelete(id);
 	}
 	/**
 	* Update multiple records matching filter
@@ -669,9 +686,11 @@ var RepositoryManager = class {
 		if (!this.isCacheable || !this.cacheDriver) return await this.count(options);
 		const opts = this.prepareOptions(options);
 		const cacheKey = this.cacheKey("count", opts);
-		let count = await this.cacheDriver.get(cacheKey);
-		if (count !== void 0) return count;
-		count = await this.count(options);
+		if (!opts.purgeCache) {
+			const cachedCount = await this.cacheDriver.get(cacheKey);
+			if (cachedCount !== null && cachedCount !== void 0) return cachedCount;
+		}
+		const count = await this.count(options);
 		await this.cache(cacheKey, count);
 		return count;
 	}
@@ -688,6 +707,134 @@ var RepositoryManager = class {
 		}));
 	}
 	/**
+	* Sum a numeric field across records matching options.
+	*
+	* Applies `filterBy` (and its operator-injection guard), `where`, scopes and
+	* every other repository option to the query FIRST — exactly like `count()` —
+	* THEN runs the aggregate, so the sum is always scoped by the same filters
+	* the rest of the repository honors.
+	*
+	* @param field - Numeric field to sum
+	* @param options - Repository options (filter values, perform, etc.)
+	* @returns Promise resolving to the filtered numeric sum
+	* @public
+	*
+	* @example
+	* await ordersRepository.sum("total", { status: "paid" });
+	*/
+	async sum(field, options) {
+		const query = this.newQuery();
+		const opts = this.prepareOptions(options);
+		this.applyOptionsToQuery(query, opts);
+		return await query.sum(field);
+	}
+	/**
+	* Average a numeric field across records matching options.
+	*
+	* Options (including `filterBy`) are applied before the aggregate, mirroring
+	* `count()`.
+	*
+	* @param field - Numeric field to average
+	* @param options - Repository options
+	* @returns Promise resolving to the filtered numeric average
+	* @public
+	*/
+	async avg(field, options) {
+		const query = this.newQuery();
+		const opts = this.prepareOptions(options);
+		this.applyOptionsToQuery(query, opts);
+		return await query.avg(field);
+	}
+	/**
+	* Minimum value of a field across records matching options.
+	*
+	* Options (including `filterBy`) are applied before the aggregate, mirroring
+	* `count()`.
+	*
+	* @param field - Field name
+	* @param options - Repository options
+	* @returns Promise resolving to the filtered minimum value
+	* @public
+	*/
+	async min(field, options) {
+		const query = this.newQuery();
+		const opts = this.prepareOptions(options);
+		this.applyOptionsToQuery(query, opts);
+		return await query.min(field);
+	}
+	/**
+	* Maximum value of a field across records matching options.
+	*
+	* Options (including `filterBy`) are applied before the aggregate, mirroring
+	* `count()`.
+	*
+	* @param field - Field name
+	* @param options - Repository options
+	* @returns Promise resolving to the filtered maximum value
+	* @public
+	*/
+	async max(field, options) {
+		const query = this.newQuery();
+		const opts = this.prepareOptions(options);
+		this.applyOptionsToQuery(query, opts);
+		return await query.max(field);
+	}
+	/**
+	* Group records by one or more fields and compute aggregates.
+	*
+	* Repository options (including `filterBy`) are applied before the grouping,
+	* mirroring `count()`, so the grouped rows are always scoped by the same
+	* filters the rest of the repository honors.
+	*
+	* @template R - Shape of each grouped row
+	* @param fields - Field(s) to group by
+	* @param aggregates - Map of result aliases to aggregate expressions (e.g. `$agg.*`)
+	* @param options - Repository options
+	* @returns Promise resolving to the array of grouped rows
+	* @public
+	*
+	* @example
+	* import { $agg } from "@warlock.js/cascade";
+	*
+	* await ordersRepository.groupBy(
+	*   "status",
+	*   { count: $agg.count(), total: $agg.sum("total") },
+	*   { paidAfter: "2026-01-01" },
+	* );
+	*/
+	async groupBy(fields, aggregates, options) {
+		const query = this.newQuery();
+		const opts = this.prepareOptions(options);
+		this.applyOptionsToQuery(query, opts);
+		return await query.groupBy(fields, aggregates);
+	}
+	/**
+	* Compute aggregates over the whole matching set as a single summary row.
+	*
+	* Repository options (including `filterBy`) are applied before the aggregate,
+	* mirroring `count()`.
+	*
+	* @template R - Shape of the summary row
+	* @param aggregates - Map of result aliases to aggregate expressions (e.g. `$agg.*`)
+	* @param options - Repository options
+	* @returns Promise resolving to the single summary row (or `null` when empty)
+	* @public
+	*
+	* @example
+	* import { $agg } from "@warlock.js/cascade";
+	*
+	* await ordersRepository.aggregate(
+	*   { total: $agg.sum("total"), avg: $agg.avg("total") },
+	*   { status: "paid" },
+	* );
+	*/
+	async aggregate(aggregates, options) {
+		const query = this.newQuery();
+		const opts = this.prepareOptions(options);
+		this.applyOptionsToQuery(query, opts);
+		return await query.aggregate(aggregates);
+	}
+	/**
 	* Set cache driver
 	* @param driver - Cache driver instance
 	* @returns This repository for chaining
@@ -714,11 +861,37 @@ var RepositoryManager = class {
 	*/
 	cacheKey(key, moreOptions) {
 		let cacheKey = `repositories.${this.getName()}`;
-		if (key) cacheKey += "." + (typeof key === "string" ? key : JSON.stringify(key));
-		if (moreOptions) cacheKey += "." + JSON.stringify(moreOptions);
+		if (key) cacheKey += "." + (typeof key === "string" ? key : this.stableStringify(key));
+		if (moreOptions) {
+			const { purgeCache: _purgeCache, ...keyOptions } = moreOptions;
+			cacheKey += "." + this.stableStringify(keyOptions);
+		}
 		return cacheKey;
 	}
 	/**
+	* Deterministically serialize a value for use in a cache key.
+	*
+	* Unlike raw `JSON.stringify`, object keys are recursively sorted so that
+	* `{ a: 1, b: 2 }` and `{ b: 2, a: 1 }` produce the same key. Function-valued
+	* options (e.g. a `perform` callback) are represented by a stable marker
+	* (`[fn:<name>]`) rather than being silently dropped, so two distinct
+	* callbacks do not collide on the same cache key.
+	*/
+	stableStringify(value) {
+		const seen = /* @__PURE__ */ new WeakSet();
+		const normalize = (input) => {
+			if (typeof input === "function") return `[fn:${input.name || "anonymous"}]`;
+			if (input === null || typeof input !== "object") return input;
+			if (seen.has(input)) return "[circular]";
+			seen.add(input);
+			if (Array.isArray(input)) return input.map((item) => normalize(item));
+			const sorted = {};
+			for (const objectKey of Object.keys(input).sort()) sorted[objectKey] = normalize(input[objectKey]);
+			return sorted;
+		};
+		return JSON.stringify(normalize(value));
+	}
+	/**
 	* Cache a value
 	* @param key - Cache key
 	* @param value - Value to cache
@@ -726,7 +899,11 @@ var RepositoryManager = class {
 	*/
 	async cache(key, value) {
 		if (!this.isCacheable || !this.cacheDriver) return;
-		await this.cacheDriver.set(key, value);
+		try {
+			await this.cacheDriver.set(key, value);
+		} catch (error) {
+			console.error(`[Repository] Failed to write cache key "${key}":`, error);
+		}
 	}
 	/**
 	* Get cached record by ID
@@ -758,7 +935,7 @@ var RepositoryManager = class {
 		if (cachedData) return this.adapter.deserializeModel(cachedData);
 		const model = await this.findBy(column, value);
 		if (!model) return null;
-		this.cache(cacheKey, this.adapter.serializeModel(model));
+		await this.cache(cacheKey, this.adapter.serializeModel(model));
 		return model;
 	}
 	/**
@@ -771,8 +948,10 @@ var RepositoryManager = class {
 		if (!this.isCacheable || !this.cacheDriver) return await this.all(options);
 		const opts = this.prepareOptions(options);
 		const cacheKey = this.cacheKey("all", opts);
-		const cachedData = await this.cacheDriver.get(cacheKey);
-		if (cachedData) return cachedData.map((record) => this.adapter.deserializeModel(record));
+		if (!opts.purgeCache) {
+			const cachedData = await this.cacheDriver.get(cacheKey);
+			if (cachedData) return cachedData.map((record) => this.adapter.deserializeModel(record));
+		}
 		const records = await this.all(options);
 		await this.cache(cacheKey, records.map((record) => this.adapter.serializeModel(record)));
 		return records;
@@ -799,11 +978,13 @@ var RepositoryManager = class {
 		if (!this.isCacheable || !this.cacheDriver) return await this._listImpl(options);
 		const opts = this.prepareOptions(options);
 		const cacheKey = this.cacheKey("list", opts);
-		const cachedData = await this.cacheDriver.get(cacheKey);
-		if (cachedData) return {
-			data: (cachedData?.data || []).map((record) => this.adapter.deserializeModel(record)),
-			pagination: cachedData.pagination
-		};
+		if (!opts.purgeCache) {
+			const cachedData = await this.cacheDriver.get(cacheKey);
+			if (cachedData) return {
+				data: (cachedData?.data || []).map((record) => this.adapter.deserializeModel(record)),
+				pagination: cachedData.pagination
+			};
+		}
 		const result = await this._listImpl(options);
 		await this.cache(cacheKey, {
 			data: result.data.map((record) => this.adapter.serializeModel(record)),
@@ -865,9 +1046,10 @@ var RepositoryManager = class {
 	* exported as cleanup
 	* export const cleanup = usersRepository.cleanup.bind(usersRepository);
 	*/
-	$cleanup() {
-		this.cleanup();
-		this.cacheDriver.flush();
+	async $cleanup() {
+		await this.clearCache();
+		this.cleanuEvents();
+		if (this.cacheDriver) await this.cacheDriver.flush();
 	}
 	/**
 	* Clear all cache for this repository

package/esm/repositories/repository.manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"repository.manager.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/repositories/repository.manager.ts"],"sourcesContent":["import { cache, CacheKey, type CacheDriver } from \"@warlock.js/cache\";\nimport { config } from \"../config\";\nimport { CascadeAdapter } from \"./adapters/cascade\";\nimport type {\n  AllRepositoryOptions,\n  ChunkCallback,\n  CursorPaginationResult,\n  FilterRules,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n  RepositoryOptions,\n  SaveMode,\n  TypedAllRepositoryOptions,\n  TypedRepositoryOptions,\n  TypedRepositoryOptionsWithCursor,\n  TypedRepositoryOptionsWithPages,\n} from \"./contracts\";\n\n/**\n * Base repository manager class\n * Provides ORM-agnostic data access layer with support for listing, filtering,\n * caching, pagination, and CRUD operations\n *\n * @template T - The type of records managed by this repository\n *\n * @example\n * // Extend with source\n * class UserRepository extends RepositoryManager<User> {\n *   protected source = User;\n *   protected filterBy = { email: \"=\", role: [\"in\", \"role\"] };\n * }\n *\n * @example\n * // Direct instantiation with adapter\n * const userRepo = new RepositoryManager<User>(new PrismaAdapter(prisma.user));\n */\nexport class RepositoryManager<T = unknown, F = Record<string, any>> {\n  /**\n   * Adapter instance (lazy-loaded)\n   * @private\n   */\n  protected _adapter?: RepositoryAdapterContract<T>;\n\n  /**\n   * Data source reference (Model, Prisma client, table name, etc.)\n   * Used by createDefaultAdapter to instantiate the appropriate adapter\n   * @protected\n   */\n  protected source?: any;\n\n  // ============================================================================\n  // CONFIGURATION PROPERTIES\n  // ============================================================================\n\n  /**\n   * Filter definitions\n   * Maps filter keys to filter rules\n   * @protected\n   */\n  protected filterBy: FilterRules = {};\n\n  /**\n   * Get adapter instance (lazy-loaded)\n   * Resolution order:\n   * 1. Use injected adapter from constructor\n   * 2. Use config-based resolver if available\n   * 3. Use createDefaultAdapter\n   *\n   * @returns Adapter instance\n   * @protected\n   */\n  protected get adapter(): RepositoryAdapterContract<T> {\n    if (this._adapter) {\n      return this._adapter;\n    }\n\n    // Try config-based resolver\n    const resolver = config.key(\"repository.adapterResolver\");\n\n    if (resolver) {\n      this._adapter = resolver(this);\n    } else {\n      this._adapter = config.get(\"repository.defaultAdapter\") || this.createDefaultAdapter();\n    }\n\n    // Adapter is guaranteed to be set at this point\n    return this._adapter!;\n  }\n\n  /**\n   * Default repository options\n   * @protected\n   */\n  protected defaultOptions: Partial<RepositoryOptions> =\n    config.get(\"repository.defaultOptions\") || {};\n\n  /**\n   * Simple select columns (used with simple filter)\n   * @protected\n   */\n  protected simpleSelectColumns: string[] = [];\n\n  /**\n   * Active column name\n   * @default \"isActive\"\n   * @protected\n   */\n  protected isActiveColumn?: string;\n\n  /**\n   * Active column value\n   * @default true\n   * @protected\n   */\n  protected isActiveValue?: any;\n\n  /**\n   * Repository name (for events)\n   * @protected\n   */\n  protected name?: string;\n\n  /**\n   * Whether caching is enabled\n   * @default true\n   * @protected\n   */\n  protected isCacheable = config.get(\"repository.isCacheable\") ?? true;\n\n  /**\n   * Cache driver instance\n   * @protected\n   */\n  protected cacheDriver: CacheDriver<any, any> = config.get(\"repository.cacheDriver\") || cache;\n\n  /**\n   * List of all events callbacks\n   */\n  protected eventsCallbacks: any[] = [];\n\n  /**\n   * Constructor\n   * @param adapter - Optional adapter instance for direct injection\n   */\n  public constructor(adapter?: RepositoryAdapterContract<T>) {\n    if (adapter) {\n      this._adapter = adapter;\n    }\n\n    // Wait for constructor to finish and all properties are properly registered\n    // specially for adapter to get instanciated\n    setTimeout(() => {\n      this.registerEvents();\n    }, 0);\n  }\n\n  /**\n   * Register events\n   */\n  public registerEvents() {\n    this.eventsCallbacks.push(\n      ...this.adapter.registerEvents((source: any) => {\n        // this.clearCache({ id: source.id });\n        this.clearCache();\n      }),\n    );\n  }\n\n  /**\n   * Unregister events\n   */\n  public cleanuEvents() {\n    this.eventsCallbacks.forEach((callback) => {\n      callback();\n    });\n    this.eventsCallbacks = [];\n  }\n\n  /**\n   * Create default adapter instance\n   * Override this method to provide custom adapter creation logic\n   *\n   * @returns Adapter instance\n   * @throws Error if no source is configured\n   * @protected\n   */\n  protected createDefaultAdapter(): RepositoryAdapterContract<T> {\n    if (!this.source) {\n      throw new Error(\n        \"No adapter or source configured. Either pass an adapter to the constructor, \" +\n          \"set the 'source' property, or configure 'repository.adapterResolver' in config.\",\n      );\n    }\n\n    // Default: assume source is a Cascade Model\n    if (typeof this.source === \"function\") {\n      // Lazy import to avoid circular dependencies\n      return new CascadeAdapter(this.source) as unknown as RepositoryAdapterContract<T>;\n    }\n\n    throw new Error(\n      \"Cannot create default adapter for this source type. \" +\n        \"Please provide an adapter or configure repository.adapterResolver.\",\n    );\n  }\n\n  // ============================================================================\n  // UTILITY METHODS\n  // ============================================================================\n\n  /**\n   * Get repository name\n   * @returns Repository name\n   * @public\n   */\n  public getName(): string {\n    if (this.name) {\n      return this.name;\n    }\n\n    // Try to get collection name from source\n    this.name = this.adapter.resolveRepositoryName() || \"unknown\";\n\n    return this.name;\n  }\n\n  /**\n   * Get is active column\n   */\n  protected getIsActiveColumn(): string {\n    return this.isActiveColumn || config.key(\"repository.isActiveColumn\") || \"isActive\";\n  }\n\n  /**\n   * Get is active value\n   */\n  protected getIsActiveValue(): any {\n    return this.isActiveValue ?? config.key(\"repository.isActiveValue\") ?? true;\n  }\n\n  /**\n   * Create new query builder instance\n   * @returns Query builder\n   * @public\n   */\n  public newQuery() {\n    return this.adapter.query();\n  }\n\n  /**\n   * Create new model instance\n   * @param data - Model data\n   * @returns Model instance\n   * @public\n   */\n  public newModel(data?: any): T {\n    return this.adapter.createModel(data);\n  }\n\n  /**\n   * Get active filter object\n   * @returns Filter object for active records\n   * @protected\n   */\n  protected getIsActiveFilter() {\n    return {\n      [this.getIsActiveColumn()]: this.getIsActiveValue(),\n    };\n  }\n\n  // ============================================================================\n  // FINDING METHODS\n  // ============================================================================\n\n  /**\n   * Find a record by ID\n   * @param id - Record ID or model instance\n   * @returns Promise resolving to record or null\n   * @public\n   */\n  public async find(id: string | number | T): Promise<T | null> {\n    return this.adapter.find(id);\n  }\n\n  /**\n   * Find a record by column value\n   * @param column - Column name\n   * @param value - Value to search for\n   * @returns Promise resolving to record or null\n   * @public\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return this.adapter.findBy(column, value);\n  }\n\n  /**\n   * Find active record by ID\n   * @param id - Record ID or model instance\n   * @returns Promise resolving to active record or null\n   * @public\n   */\n  public async findActive(id: string | number | T): Promise<T | null> {\n    return this.newQuery()\n      .where({\n        id,\n        ...this.getIsActiveFilter(),\n      })\n      .first();\n  }\n\n  /**\n   * Find active record by column value\n   * @param column - Column name\n   * @param value - Value to search for\n   * @returns Promise resolving to active record or null\n   * @public\n   */\n  public async findByActive(column: string, value: any): Promise<T | null> {\n    return this.newQuery()\n      .where({\n        [column]: value,\n        ...this.getIsActiveFilter(),\n      })\n      .first();\n  }\n\n  /**\n   * Get first record matching options\n   * @param options - Repository options\n   * @returns Promise resolving to first record or null\n   * @public\n   */\n  public async first(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return query.limit(1).first();\n  }\n\n  /**\n   * Get id by the given filter\n   */\n  public async firstId(options?: TypedRepositoryOptions<F>): Promise<string | number | undefined> {\n    const record = await this.first(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first active id\n   */\n  public async firstActiveId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstActive(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first cached id\n   */\n  public async firstCachedId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstCached(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first active cached id\n   */\n  public async firstActiveCachedId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstActiveCached(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first uuid\n   */\n  public async firstUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.first(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first active uuid\n   */\n  public async firstActiveUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.firstActive(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first cached uuid\n   */\n  public async firstCachedUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.firstCached(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first active cached uuid\n   */\n  public async firstActiveCachedUuid(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | undefined> {\n    const record = await this.firstActiveCached(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first cached record\n   */\n  public async firstCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const results = await this.allCached({\n      ...options,\n      limit: 1,\n    } as TypedAllRepositoryOptions<F>);\n\n    return results[0] || null;\n  }\n\n  /**\n   * Get first active record\n   * @param options - Repository options\n   * @returns Promise resolving to first active record or null\n   * @public\n   */\n  public async firstActive(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.first({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get first active cached record\n   * @param options - Repository options\n   * @returns Promise resolving to first active cached record or null\n   * @public\n   */\n  public async firstActiveCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.firstCached({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last record matching options\n   * @param options - Repository options\n   * @returns Promise resolving to last record or null\n   * @public\n   */\n  public async last(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.first({\n      orderBy: {\n        id: \"desc\",\n      },\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last cached record\n   */\n  public async lastCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const results = await this.allCached(\n      this.asTypedAll({\n        ...options,\n        limit: 1,\n        orderBy: { id: \"desc\" },\n      }),\n    );\n\n    return results[0] || null;\n  }\n\n  /**\n   * Get last active record\n   * @param options - Repository options\n   * @returns Promise resolving to last active record or null\n   * @public\n   */\n  public async lastActive(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.last({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last active cached record\n   * @param options - Repository options\n   * @returns Promise resolving to last active cached record or null\n   * @public\n   */\n  public async lastActiveCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.lastCached({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  // ============================================================================\n  // LISTING METHODS\n  // ============================================================================\n\n  /**\n   * List records with pagination\n   * Supports both traditional page-based and cursor-based pagination\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   *\n   * @example\n   * // Traditional pagination (default)\n   * const result = await repo.list({ page: 2, limit: 10 });\n   *\n   * @example\n   * // Cursor pagination\n   * const result = await repo.list({\n   *   paginationMode: \"cursor\",\n   *   limit: 20,\n   *   cursor: lastId,\n   *   direction: \"next\"\n   * });\n   *\n   * @public\n   */\n  public async list(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async list(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async list(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl(options);\n  }\n\n  /**\n   * Internal list implementation - no overloads, handles union type\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @private\n   */\n  private async _listImpl(\n    options?: RepositoryOptions,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options as TypedRepositoryOptions<F>);\n    const paginationMode = opts.paginationMode || \"pages\";\n\n    // applyOptionsToQuery handles cursor phase 1 (WHERE + ORDER BY) internally\n    // when paginationMode === \"cursor\", ensuring the cursor column is always\n    // the primary sort key before any other options are applied.\n    this.applyOptionsToQuery(query, opts);\n\n    if (paginationMode === \"cursor\") {\n      return query.cursorPaginate({\n        limit: opts.limit || opts.defaultLimit || 15,\n        cursor: opts.cursor,\n        direction: opts.direction,\n        cursorColumn: opts.cursorColumn,\n      });\n    }\n\n    // Traditional page-based pagination (default)\n    const page = opts.page || 1;\n    const limit = opts.limit || opts.defaultLimit || 15;\n\n    return query.paginate(page, limit);\n  }\n\n  /**\n   * List all records without pagination\n   * @param options - Repository options\n   * @returns Promise resolving to array of records\n   * @public\n   */\n  public async all(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    const query = this.newQuery();\n\n    // Apply options\n    const opts = this.prepareOptions(options);\n    this.applyOptionsToQuery(query, opts);\n\n    return query.get();\n  }\n\n  /**\n   * List active records with pagination\n   * Supports both page-based and cursor-based pagination\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async listActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async listActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async listActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  /**\n   * List all active records without pagination\n   * @param options - Repository options\n   * @returns Promise resolving to array of active records\n   * @public\n   */\n  public async allActive(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    return this.all(this.asTypedAll({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // EXISTENCE CHECKS\n  // ============================================================================\n\n  /**\n   * Check if record exists matching filter\n   * @param filter - Repository options\n   * @returns Promise resolving to true if exists\n   * @public\n   */\n  public async exists(filter?: TypedRepositoryOptions<F>): Promise<boolean> {\n    return !!(await this.first(filter));\n  }\n\n  /**\n   * Check if active record exists matching filter\n   * @param filter - Repository options\n   * @returns Promise resolving to true if active record exists\n   * @public\n   */\n  public async existsActive(filter?: TypedRepositoryOptions<F>): Promise<boolean> {\n    return !!(await this.firstActive(filter));\n  }\n\n  /**\n   * Check if record exists by ID\n   * @param id - Record ID\n   * @returns Promise resolving to true if exists\n   * @public\n   */\n  public async idExists(id: number | string): Promise<boolean> {\n    return !!(await this.find(id));\n  }\n\n  /**\n   * Check if active record exists by ID\n   * @param id - Record ID\n   * @returns Promise resolving to true if active record exists\n   * @public\n   */\n  public async idExistsActive(id: number | string): Promise<boolean> {\n    return !!(await this.findActive(id));\n  }\n\n  /**\n   * Prepare options — merges defaultOptions with caller options.\n   * Returning as TypedRepositoryOptions<F> ensures internal composition\n   * (spread + forward) satisfies the typed public API without per-call casts.\n   */\n  protected prepareOptions(options?: TypedRepositoryOptions<F>): TypedRepositoryOptions<F> {\n    return { ...(this.defaultOptions || {}), ...(options || {}) } as TypedRepositoryOptions<F>;\n  }\n\n  /**\n   * Cast a plain `RepositoryOptions` spread to the typed variant.\n   * Used internally when composing options across method calls where the\n   * spread breaks the F-generic inference chain.\n   */\n  protected asTyped(opts: RepositoryOptions): TypedRepositoryOptions<F> {\n    return opts as TypedRepositoryOptions<F>;\n  }\n\n  protected asTypedAll(opts: AllRepositoryOptions): TypedAllRepositoryOptions<F> {\n    return opts as TypedAllRepositoryOptions<F>;\n  }\n\n  // ============================================================================\n  // HELPER METHODS\n  // ============================================================================\n\n  /**\n   * Apply repository options to query\n   * @param query - Query builder instance\n   * @param options - Repository options\n   * @protected\n   */\n  protected applyOptionsToQuery(\n    query: QueryBuilderContract<T>,\n    options: RepositoryOptions,\n  ): RepositoryOptions {\n    // ── Cursor phase 1: WHERE + ORDER BY ──────────────────────────────────────\n    // Must run first so the cursor column is always the PRIMARY sort key.\n    // Any orderBy appended below becomes a harmless secondary sort key.\n    if (options.paginationMode === \"cursor\") {\n      const cursorColumn = options.cursorColumn ?? \"id\";\n      const direction = options.direction ?? \"next\";\n\n      if (options.cursor) {\n        query.where(cursorColumn, direction === \"next\" ? \">\" : \"<\", options.cursor);\n      }\n\n      query.orderBy(cursorColumn, direction === \"next\" ? \"asc\" : \"desc\");\n\n      // Warn and strip orderBy that targets the same column as the cursor —\n      // it would produce a duplicate / conflicting sort clause.\n      if (options.orderBy) {\n        const conflictingKeys = Array.isArray(options.orderBy)\n          ? [options.orderBy[0]]\n          : typeof options.orderBy === \"object\"\n            ? Object.keys(options.orderBy)\n            : [];\n\n        if (conflictingKeys.includes(cursorColumn)) {\n          console.warn(\n            `[Repository] orderBy on \"${cursorColumn}\" conflicts with cursorColumn and will be ignored. ` +\n              `Cursor pagination owns the sort order for its cursor column.`,\n          );\n          options = { ...options, orderBy: undefined };\n        }\n      }\n    }\n\n    // Apply filters\n    if (this.filterBy && Object.keys(this.filterBy).length > 0) {\n      query.applyFilters(this.filterBy, options, {\n        dateFormat: \"DD-MM-YYYY\",\n        dateTimeFormat: \"DD-MM-YYYY HH:mm:ss\",\n      });\n    }\n\n    // Apply select\n    if (options.select) {\n      query.select(options.select);\n    }\n\n    // Apply deselect\n    if (options.deselect) {\n      query.deselect(options.deselect);\n    }\n\n    if (options.simpleSelect && this.simpleSelectColumns.length > 0) {\n      query.select(this.simpleSelectColumns);\n    }\n\n    // Apply ordering\n    if (options.orderBy) {\n      if (options.orderBy === \"random\") {\n        query.random();\n      } else if (Array.isArray(options.orderBy)) {\n        query.orderBy(options.orderBy[0], options.orderBy[1]);\n      } else if (typeof options.orderBy === \"object\") {\n        query.sortBy(options.orderBy);\n      }\n    }\n\n    // Apply limit (for non-paginated queries)\n    if (options.limit && options.paginate === false) {\n      query.limit(options.limit);\n    }\n\n    // Apply custom perform function\n    if (options?.perform) {\n      options.perform(query, options);\n    }\n\n    return options;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * Create a new record\n   * @param data - Record data\n   * @returns Promise resolving to created record\n   * @public\n   */\n  public async create(data: any): Promise<T> {\n    return this.adapter.create(data);\n  }\n\n  /**\n   * Update a record by ID\n   * @param id - Record ID\n   * @param data - Updated data\n   * @returns Promise resolving to updated record\n   * @public\n   */\n  public async update(id: string | number | any, data: any): Promise<T> {\n    return this.adapter.update(id, data);\n  }\n\n  /**\n   * Delete a record by ID\n   * @param id - Record ID\n   * @returns Promise that resolves when deletion is complete\n   * @public\n   */\n  public async delete(id: string | number): Promise<void> {\n    return this.adapter.delete(id);\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * Update multiple records matching filter\n   * @param filter - Filter criteria\n   * @param data - Updated data\n   * @returns Promise resolving to number of updated records\n   * @public\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    return this.adapter.updateMany(filter, data);\n  }\n\n  /**\n   * Delete multiple records matching filter\n   * @param filter - Filter criteria\n   * @returns Promise resolving to number of deleted records\n   * @public\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    return this.adapter.deleteMany(filter);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * Process records in chunks\n   * @param size - Chunk size\n   * @param callback - Function called for each chunk\n   * @param options - Repository options\n   * @returns Promise that resolves when chunking is complete\n   * @public\n   */\n  public async chunk(\n    size: number,\n    callback: ChunkCallback<T>,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<void> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return query.chunk(size, callback);\n  }\n\n  /**\n   * Process active records in chunks\n   * @param size - Chunk size\n   * @param callback - Function called for each chunk\n   * @param options - Repository options\n   * @returns Promise that resolves when chunking is complete\n   * @public\n   */\n  public async chunkActive(\n    size: number,\n    callback: ChunkCallback<T>,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<void> {\n    return this.chunk(size, callback, this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // CONVENIENCE METHODS\n  // ============================================================================\n\n  /**\n   * Get latest records (ordered by ID descending)\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async latest(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async latest(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async latest(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"desc\"],\n      ...options,\n    });\n  }\n\n  /**\n   * Get oldest records (ordered by ID ascending)\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async oldest(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async oldest(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async oldest(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"asc\"],\n      ...options,\n    });\n  }\n\n  /**\n   * Get latest active records\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async latestActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async latestActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async latestActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"desc\"],\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  /**\n   * Get oldest active records\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async oldestActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async oldestActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async oldestActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"asc\"],\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  // ============================================================================\n  // LIFECYCLE HOOKS (Override these in child classes)\n  // ============================================================================\n\n  /**\n   * Called before listing records\n   * @param options - Repository options\n   * @protected\n   */\n  protected async beforeListing(options: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after listing records\n   * @param result - Pagination result\n   * @param options - Repository options\n   * @protected\n   */\n  protected async onList(result: PaginationResult<T>, options: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before creating a record\n   * @param data - Record data\n   * @protected\n   */\n  protected async onCreating(data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after creating a record\n   * @param record - Created record\n   * @param data - Original data\n   * @protected\n   */\n  protected async onCreate(record: T, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before updating a record\n   * @param id - Record ID\n   * @param data - Updated data\n   * @protected\n   */\n  protected async onUpdating(id: string | number, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after updating a record\n   * @param record - Updated record\n   * @param data - Original data\n   * @protected\n   */\n  protected async onUpdate(record: T, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before saving a record (create or update)\n   * @param data - Record data\n   * @param mode - Save mode\n   * @protected\n   */\n  protected async onSaving(data: any, mode: SaveMode): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after saving a record (create or update)\n   * @param record - Saved record\n   * @param data - Original data\n   * @param mode - Save mode\n   * @protected\n   */\n  protected async onSave(record: T, data: any, mode: SaveMode): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before deleting a record\n   * @param id - Record ID\n   * @protected\n   */\n  protected async onDeleting(id: string | number): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after deleting a record\n   * @param id - Record ID\n   * @protected\n   */\n  protected async onDelete(id: string | number): Promise<void> {\n    // Override in child class\n  }\n\n  // ============================================================================\n  // COUNT METHODS\n  // ============================================================================\n\n  /**\n   * Count total records matching options\n   * @param options - Repository options\n   * @returns Promise resolving to count\n   * @public\n   */\n  public async count(options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.count();\n  }\n\n  /**\n   * Count total active records\n   * @param options - Repository options\n   * @returns Promise resolving to count of active records\n   * @public\n   */\n  public async countActive(options?: TypedRepositoryOptions<F>): Promise<number> {\n    return await this.count(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * Count records with caching\n   * @param options - Repository options\n   * @returns Promise resolving to cached count\n   * @public\n   */\n  public async countCached(options?: TypedRepositoryOptions<F>): Promise<number> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.count(options);\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"count\", opts);\n    let count = await this.cacheDriver.get(cacheKey);\n\n    if (count !== undefined) return count;\n\n    count = await this.count(options);\n    await this.cache(cacheKey, count);\n    return count;\n  }\n\n  /**\n   * Count active records with caching\n   * @param options - Repository options\n   * @returns Promise resolving to cached count of active records\n   * @public\n   */\n  public async countActiveCached(options?: TypedRepositoryOptions<F>): Promise<number> {\n    return await this.countCached(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // CACHING METHODS\n  // ============================================================================\n\n  /**\n   * Set cache driver\n   * @param driver - Cache driver instance\n   * @returns This repository for chaining\n   * @public\n   */\n  public setCacheDriver(driver: any): this {\n    this.cacheDriver = driver;\n    return this;\n  }\n\n  /**\n   * Get cache driver\n   * @returns Cache driver instance\n   * @public\n   */\n  public getCacheDriver(): any {\n    return this.cacheDriver;\n  }\n\n  /**\n   * Generate cache key\n   * @param key - Base key or object\n   * @param moreOptions - Additional options for key\n   * @returns Generated cache key\n   * @protected\n   */\n  protected cacheKey(key: string | Record<string, any>, moreOptions?: Record<string, any>): string {\n    let cacheKey = `repositories.${this.getName()}`;\n\n    if (key) {\n      cacheKey += \".\" + (typeof key === \"string\" ? key : JSON.stringify(key));\n    }\n\n    if (moreOptions) {\n      cacheKey += \".\" + JSON.stringify(moreOptions);\n    }\n\n    return cacheKey;\n  }\n\n  /**\n   * Cache a value\n   * @param key - Cache key\n   * @param value - Value to cache\n   * @protected\n   */\n  protected async cache(key: string, value: any): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n    await this.cacheDriver.set(key, value);\n  }\n\n  /**\n   * Get cached record by ID\n   * @param id - Record ID\n   * @returns Promise resolving to cached record or null\n   * @public\n   */\n  public async getCached(id: string | number): Promise<T | null> {\n    return await this.getCachedBy(\"id\", id);\n  }\n\n  /**\n   * @alias getCached\n   */\n  public async findCached(id: string | number): Promise<T | null> {\n    return await this.getCachedBy(\"id\", id);\n  }\n\n  /**\n   * Get cached record by column value\n   * @param column - Column name\n   * @param value - Column value\n   * @param cacheKeyOptions - Additional cache key options\n   * @returns Promise resolving to cached record or undefined\n   * @public\n   */\n  public async getCachedBy(\n    column: string,\n    value: any,\n    cacheKeyOptions?: Record<string, any>,\n  ): Promise<T | null> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.findBy(column, value);\n    }\n\n    const cacheKey = this.cacheKey(`${column}.${value}`, cacheKeyOptions);\n    const cachedData = await this.cacheDriver.get(cacheKey);\n\n    if (cachedData) {\n      return this.adapter.deserializeModel(cachedData);\n    }\n\n    const model = await this.findBy(column, value);\n\n    if (!model) return null;\n\n    this.cache(cacheKey, this.adapter.serializeModel(model));\n    return model;\n  }\n\n  /**\n   * Get all cached records\n   * @param options - Repository options\n   * @returns Promise resolving to array of cached records\n   * @public\n   */\n  public async allCached(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.all(options);\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"all\", opts);\n    const cachedData = await this.cacheDriver.get<T[]>(cacheKey);\n\n    if (cachedData) {\n      return cachedData.map((record) => this.adapter.deserializeModel(record));\n    }\n\n    const records = await this.all(options);\n    await this.cache(\n      cacheKey,\n      records.map((record) => this.adapter.serializeModel(record)),\n    );\n    return records;\n  }\n\n  /**\n   * Get all active cached records\n   * @param options - Repository options\n   * @returns Promise resolving to array of cached active records\n   * @public\n   */\n  public async allActiveCached(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    return await this.allCached(this.asTypedAll({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * List cached records with pagination\n   * @param options - Repository options\n   * @returns Promise resolving to cached pagination result\n   * @public\n   */\n  public async listCached(options?: TypedRepositoryOptions<F>): Promise<PaginationResult<T>> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return (await this._listImpl(options)) as PaginationResult<T>;\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"list\", opts);\n    const cachedData = await this.cacheDriver.get(cacheKey);\n\n    if (cachedData) {\n      return {\n        data: (cachedData?.data || []).map((record: T) => this.adapter.deserializeModel(record)),\n        pagination: cachedData.pagination,\n      };\n    }\n\n    const result = (await this._listImpl(options)) as PaginationResult<T>;\n\n    await this.cache(cacheKey, {\n      data: result.data.map((record) => this.adapter.serializeModel(record)),\n      pagination: result.pagination,\n    });\n    return result;\n  }\n\n  /**\n   * List active cached records with pagination\n   * @param options - Repository options\n   * @returns Promise resolving to cached pagination result of active records\n   * @public\n   */\n  public async listActiveCached(options?: TypedRepositoryOptions<F>): Promise<PaginationResult<T>> {\n    return await this.listCached(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * Get active cached record by ID\n   * @param id - Record ID\n   * @returns Promise resolving to cached active record or undefined\n   * @public\n   */\n  public async getActiveCached(id: string | number): Promise<T | undefined> {\n    const model = await this.getCached(id);\n    if (!model) return undefined;\n\n    if (typeof (model as any).get === \"function\") {\n      return (model as any).get(this.getIsActiveColumn()) === this.getIsActiveValue()\n        ? model\n        : undefined;\n    }\n\n    // Check if model is active\n    const isActive = (model as any)[this.getIsActiveColumn()] === this.getIsActiveValue();\n    return isActive ? model : undefined;\n  }\n\n  /**\n   * Cache a model\n   * @param model - Model to cache\n   * @public\n   */\n  public async cacheModel(model: T): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    const id = (model as any).id;\n    if (!id) return;\n\n    const cacheKey = this.cacheKey(`id.${id}`);\n    await this.cache(cacheKey, this.adapter.serializeModel(model));\n  }\n\n  /**\n   * Cleanup all events and cache as well\n   * Please note this is mostly used with development server to be\n   * exported as cleanup\n   *\n   * @example\n   * ```typescript\n   */\n  public cleanup() {\n    this.clearCache();\n    this.cleanuEvents();\n  }\n\n  /**\n   * Cleanup all events and cache as well\n   * Please note this is mostly used with development server to be\n   * exported as cleanup\n   * export const cleanup = usersRepository.cleanup.bind(usersRepository);\n   */\n  public $cleanup() {\n    this.cleanup();\n    this.cacheDriver.flush();\n  }\n\n  /**\n   * Clear all cache for this repository\n   * @public\n   */\n  public async clearCache(key?: CacheKey): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    await this.cacheDriver.removeNamespace(this.cacheKey(key || \"\"));\n  }\n\n  /**\n   * Clear cache for specific model\n   * @param model - Model to clear cache for\n   * @public\n   */\n  public async clearModelCache(model: T): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    const id = (model as any).id;\n    if (!id) return;\n\n    const cacheKey = this.cacheKey(`id.${id}`);\n    await this.cacheDriver.removeNamespace(cacheKey);\n  }\n\n  /**\n   * Map documents to models\n   * @param documents - Array of document data\n   * @returns Array of model instances\n   * @protected\n   */\n  protected mapModels(documents: any[]): T[] {\n    return documents.map((doc) => this.newModel(doc));\n  }\n\n  // ============================================================================\n  // CONVENIENCE METHODS\n  // ============================================================================\n\n  /**\n   * Find or create a record\n   * @param where - Conditions to find by\n   * @param data - Data to create if not found\n   * @returns Promise resolving to found or created record\n   * @public\n   */\n  public async findOrCreate(\n    where: TypedRepositoryOptions<F>,\n    data: Record<string, any>,\n  ): Promise<T> {\n    const model = await this.first(where);\n    return model || (await this.create(data));\n  }\n\n  /**\n   * Update or create a record\n   * @param where - Conditions to find by\n   * @param data - Data to update or create\n   * @returns Promise resolving to updated or created record\n   * @public\n   */\n  public async updateOrCreate(\n    where: TypedRepositoryOptions<F>,\n    data: Record<string, any>,\n  ): Promise<T> {\n    const model = await this.first(where);\n    if (model) {\n      return await this.update(model, data);\n    }\n    return await this.create(data);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,IAAa,oBAAb,MAAqE;;;;;;;;;;;CAmCnE,IAAc,UAAwC;EACpD,IAAI,KAAK,UACP,OAAO,KAAK;EAId,MAAM,WAAW,OAAO,IAAI,4BAA4B;EAExD,IAAI,UACF,KAAK,WAAW,SAAS,IAAI;OAE7B,KAAK,WAAW,OAAO,IAAI,2BAA2B,KAAK,KAAK,qBAAqB;EAIvF,OAAO,KAAK;CACd;;;;;CAyDA,AAAO,YAAY,SAAwC;kBArFzB,CAAC;wBAmCjC,OAAO,IAAI,2BAA2B,KAAK,CAAC;6BAMJ,CAAC;qBA2BnB,OAAO,IAAI,wBAAwB,KAAK;qBAMjB,OAAO,IAAI,wBAAwB,KAAK;yBAKpD,CAAC;EAOlC,IAAI,SACF,KAAK,WAAW;EAKlB,iBAAiB;GACf,KAAK,eAAe;EACtB,GAAG,CAAC;CACN;;;;CAKA,AAAO,iBAAiB;EACtB,KAAK,gBAAgB,KACnB,GAAG,KAAK,QAAQ,gBAAgB,WAAgB;GAE9C,KAAK,WAAW;EAClB,CAAC,CACH;CACF;;;;CAKA,AAAO,eAAe;EACpB,KAAK,gBAAgB,SAAS,aAAa;GACzC,SAAS;EACX,CAAC;EACD,KAAK,kBAAkB,CAAC;CAC1B;;;;;;;;;CAUA,AAAU,uBAAqD;EAC7D,IAAI,CAAC,KAAK,QACR,MAAM,IAAI,MACR,6JAEF;EAIF,IAAI,OAAO,KAAK,WAAW,YAEzB,OAAO,IAAI,eAAe,KAAK,MAAM;EAGvC,MAAM,IAAI,MACR,wHAEF;CACF;;;;;;CAWA,AAAO,UAAkB;EACvB,IAAI,KAAK,MACP,OAAO,KAAK;EAId,KAAK,OAAO,KAAK,QAAQ,sBAAsB,KAAK;EAEpD,OAAO,KAAK;CACd;;;;CAKA,AAAU,oBAA4B;EACpC,OAAO,KAAK,kBAAkB,OAAO,IAAI,2BAA2B,KAAK;CAC3E;;;;CAKA,AAAU,mBAAwB;EAChC,OAAO,KAAK,iBAAiB,OAAO,IAAI,0BAA0B,KAAK;CACzE;;;;;;CAOA,AAAO,WAAW;EAChB,OAAO,KAAK,QAAQ,MAAM;CAC5B;;;;;;;CAQA,AAAO,SAAS,MAAe;EAC7B,OAAO,KAAK,QAAQ,YAAY,IAAI;CACtC;;;;;;CAOA,AAAU,oBAAoB;EAC5B,OAAO,GACJ,KAAK,kBAAkB,IAAI,KAAK,iBAAiB,EACpD;CACF;;;;;;;CAYA,MAAa,KAAK,IAA4C;EAC5D,OAAO,KAAK,QAAQ,KAAK,EAAE;CAC7B;;;;;;;;CASA,MAAa,OAAO,QAAgB,OAA+B;EACjE,OAAO,KAAK,QAAQ,OAAO,QAAQ,KAAK;CAC1C;;;;;;;CAQA,MAAa,WAAW,IAA4C;EAClE,OAAO,KAAK,SAAS,CAAC,CACnB,MAAM;GACL;GACA,GAAG,KAAK,kBAAkB;EAC5B,CAAC,CAAC,CACD,MAAM;CACX;;;;;;;;CASA,MAAa,aAAa,QAAgB,OAA+B;EACvE,OAAO,KAAK,SAAS,CAAC,CACnB,MAAM;IACJ,SAAS;GACV,GAAG,KAAK,kBAAkB;EAC5B,CAAC,CAAC,CACD,MAAM;CACX;;;;;;;CAQA,MAAa,MAAM,SAAwD;EACzE,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,OAAO,KAAK,eAAe,OAAO;EAExC,KAAK,oBAAoB,OAAO,IAAI;EAEpC,OAAO,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM;CAC9B;;;;CAKA,MAAa,QAAQ,SAA2E;EAE9F,QAAQ,MADa,KAAK,MAAM,OAAO,EACzB,EAAU;CAC1B;;;;CAKA,MAAa,cACX,SACsC;EAEtC,QAAQ,MADa,KAAK,YAAY,OAAO,EAC/B,EAAU;CAC1B;;;;CAKA,MAAa,cACX,SACsC;EAEtC,QAAQ,MADa,KAAK,YAAY,OAAO,EAC/B,EAAU;CAC1B;;;;CAKA,MAAa,oBACX,SACsC;EAEtC,QAAQ,MADa,KAAK,kBAAkB,OAAO,EACrC,EAAU;CAC1B;;;;CAKA,MAAa,UAAU,SAAkE;EAEvF,QAAQ,MADa,KAAK,MAAM,OAAO,EACzB,EAAU;CAC1B;;;;CAKA,MAAa,gBAAgB,SAAkE;EAE7F,QAAQ,MADa,KAAK,YAAY,OAAO,EAC/B,EAAU;CAC1B;;;;CAKA,MAAa,gBAAgB,SAAkE;EAE7F,QAAQ,MADa,KAAK,YAAY,OAAO,EAC/B,EAAU;CAC1B;;;;CAKA,MAAa,sBACX,SAC6B;EAE7B,QAAQ,MADa,KAAK,kBAAkB,OAAO,EACrC,EAAU;CAC1B;;;;CAKA,MAAa,YAAY,SAAwD;EAM/E,QAAO,MALe,KAAK,UAAU;GACnC,GAAG;GACH,OAAO;EACT,CAAiC,EAEnB,CAAC,MAAM;CACvB;;;;;;;CAQA,MAAa,YAAY,SAAwD;EAC/E,OAAO,KAAK,MAAM;GAChB,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAA8B;CAChC;;;;;;;CAQA,MAAa,kBAAkB,SAAwD;EACrF,OAAO,KAAK,YAAY;GACtB,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAA8B;CAChC;;;;;;;CAQA,MAAa,KAAK,SAAwD;EACxE,OAAO,KAAK,MAAM;GAChB,SAAS,EACP,IAAI,OACN;GACA,GAAG;EACL,CAA8B;CAChC;;;;CAKA,MAAa,WAAW,SAAwD;EAS9E,QAAO,MARe,KAAK,UACzB,KAAK,WAAW;GACd,GAAG;GACH,OAAO;GACP,SAAS,EAAE,IAAI,OAAO;EACxB,CAAC,CACH,EAEc,CAAC,MAAM;CACvB;;;;;;;CAQA,MAAa,WAAW,SAAwD;EAC9E,OAAO,KAAK,KAAK;GACf,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAA8B;CAChC;;;;;;;CAQA,MAAa,iBAAiB,SAAwD;EACpF,OAAO,KAAK,WAAW;GACrB,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAA8B;CAChC;CAgCA,MAAa,KACX,SAC0D;EAC1D,OAAO,KAAK,UAAU,OAAO;CAC/B;;;;;;;CAQA,MAAc,UACZ,SAC0D;EAC1D,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,OAAO,KAAK,eAAe,OAAoC;EACrE,MAAM,iBAAiB,KAAK,kBAAkB;EAK9C,KAAK,oBAAoB,OAAO,IAAI;EAEpC,IAAI,mBAAmB,UACrB,OAAO,MAAM,eAAe;GAC1B,OAAO,KAAK,SAAS,KAAK,gBAAgB;GAC1C,QAAQ,KAAK;GACb,WAAW,KAAK;GAChB,cAAc,KAAK;EACrB,CAAC;EAIH,MAAM,OAAO,KAAK,QAAQ;EAC1B,MAAM,QAAQ,KAAK,SAAS,KAAK,gBAAgB;EAEjD,OAAO,MAAM,SAAS,MAAM,KAAK;CACnC;;;;;;;CAQA,MAAa,IAAI,SAAsD;EACrE,MAAM,QAAQ,KAAK,SAAS;EAG5B,MAAM,OAAO,KAAK,eAAe,OAAO;EACxC,KAAK,oBAAoB,OAAO,IAAI;EAEpC,OAAO,MAAM,IAAI;CACnB;CAgBA,MAAa,WACX,SAC0D;EAC1D,OAAO,KAAK,UAAU;GACpB,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAAC;CACH;;;;;;;CAQA,MAAa,UAAU,SAAsD;EAC3E,OAAO,KAAK,IAAI,KAAK,WAAW;GAAE,GAAG,KAAK,kBAAkB;GAAG,GAAG;EAAQ,CAAC,CAAC;CAC9E;;;;;;;CAYA,MAAa,OAAO,QAAsD;EACxE,OAAO,CAAC,CAAE,MAAM,KAAK,MAAM,MAAM;CACnC;;;;;;;CAQA,MAAa,aAAa,QAAsD;EAC9E,OAAO,CAAC,CAAE,MAAM,KAAK,YAAY,MAAM;CACzC;;;;;;;CAQA,MAAa,SAAS,IAAuC;EAC3D,OAAO,CAAC,CAAE,MAAM,KAAK,KAAK,EAAE;CAC9B;;;;;;;CAQA,MAAa,eAAe,IAAuC;EACjE,OAAO,CAAC,CAAE,MAAM,KAAK,WAAW,EAAE;CACpC;;;;;;CAOA,AAAU,eAAe,SAAgE;EACvF,OAAO;GAAE,GAAI,KAAK,kBAAkB,CAAC;GAAI,GAAI,WAAW,CAAC;EAAG;CAC9D;;;;;;CAOA,AAAU,QAAQ,MAAoD;EACpE,OAAO;CACT;CAEA,AAAU,WAAW,MAA0D;EAC7E,OAAO;CACT;;;;;;;CAYA,AAAU,oBACR,OACA,SACmB;EAInB,IAAI,QAAQ,mBAAmB,UAAU;GACvC,MAAM,eAAe,QAAQ,gBAAgB;GAC7C,MAAM,YAAY,QAAQ,aAAa;GAEvC,IAAI,QAAQ,QACV,MAAM,MAAM,cAAc,cAAc,SAAS,MAAM,KAAK,QAAQ,MAAM;GAG5E,MAAM,QAAQ,cAAc,cAAc,SAAS,QAAQ,MAAM;GAIjE,IAAI,QAAQ,SAOV;SANwB,MAAM,QAAQ,QAAQ,OAAO,IACjD,CAAC,QAAQ,QAAQ,EAAE,IACnB,OAAO,QAAQ,YAAY,WACzB,OAAO,KAAK,QAAQ,OAAO,IAC3B,CAAC,EAEY,CAAC,SAAS,YAAY,GAAG;KAC1C,QAAQ,KACN,4BAA4B,aAAa,gHAE3C;KACA,UAAU;MAAE,GAAG;MAAS,SAAS;KAAU;IAC7C;;EAEJ;EAGA,IAAI,KAAK,YAAY,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,SAAS,GACvD,MAAM,aAAa,KAAK,UAAU,SAAS;GACzC,YAAY;GACZ,gBAAgB;EAClB,CAAC;EAIH,IAAI,QAAQ,QACV,MAAM,OAAO,QAAQ,MAAM;EAI7B,IAAI,QAAQ,UACV,MAAM,SAAS,QAAQ,QAAQ;EAGjC,IAAI,QAAQ,gBAAgB,KAAK,oBAAoB,SAAS,GAC5D,MAAM,OAAO,KAAK,mBAAmB;EAIvC,IAAI,QAAQ,SACV;OAAI,QAAQ,YAAY,UACtB,MAAM,OAAO;QACR,IAAI,MAAM,QAAQ,QAAQ,OAAO,GACtC,MAAM,QAAQ,QAAQ,QAAQ,IAAI,QAAQ,QAAQ,EAAE;QAC/C,IAAI,OAAO,QAAQ,YAAY,UACpC,MAAM,OAAO,QAAQ,OAAO;EAC9B;EAIF,IAAI,QAAQ,SAAS,QAAQ,aAAa,OACxC,MAAM,MAAM,QAAQ,KAAK;EAI3B,IAAI,SAAS,SACX,QAAQ,QAAQ,OAAO,OAAO;EAGhC,OAAO;CACT;;;;;;;CAYA,MAAa,OAAO,MAAuB;EACzC,OAAO,KAAK,QAAQ,OAAO,IAAI;CACjC;;;;;;;;CASA,MAAa,OAAO,IAA2B,MAAuB;EACpE,OAAO,KAAK,QAAQ,OAAO,IAAI,IAAI;CACrC;;;;;;;CAQA,MAAa,OAAO,IAAoC;EACtD,OAAO,KAAK,QAAQ,OAAO,EAAE;CAC/B;;;;;;;;CAaA,MAAa,WAAW,QAAa,MAA4B;EAC/D,OAAO,KAAK,QAAQ,WAAW,QAAQ,IAAI;CAC7C;;;;;;;CAQA,MAAa,WAAW,QAA8B;EACpD,OAAO,KAAK,QAAQ,WAAW,MAAM;CACvC;;;;;;;;;CAcA,MAAa,MACX,MACA,UACA,SACe;EACf,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,OAAO,KAAK,eAAe,OAAO;EAExC,KAAK,oBAAoB,OAAO,IAAI;EAEpC,OAAO,MAAM,MAAM,MAAM,QAAQ;CACnC;;;;;;;;;CAUA,MAAa,YACX,MACA,UACA,SACe;EACf,OAAO,KAAK,MAAM,MAAM,UAAU,KAAK,QAAQ;GAAE,GAAG,KAAK,kBAAkB;GAAG,GAAG;EAAQ,CAAC,CAAC;CAC7F;CAkBA,MAAa,OACX,SAC0D;EAC1D,OAAO,KAAK,UAAU;GACpB,SAAS,CAAC,MAAM,MAAM;GACtB,GAAG;EACL,CAAC;CACH;CAcA,MAAa,OACX,SAC0D;EAC1D,OAAO,KAAK,UAAU;GACpB,SAAS,CAAC,MAAM,KAAK;GACrB,GAAG;EACL,CAAC;CACH;CAgBA,MAAa,aACX,SAC0D;EAC1D,OAAO,KAAK,UAAU;GACpB,SAAS,CAAC,MAAM,MAAM;GACtB,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAAC;CACH;CAgBA,MAAa,aACX,SAC0D;EAC1D,OAAO,KAAK,UAAU;GACpB,SAAS,CAAC,MAAM,KAAK;GACrB,GAAG,KAAK,kBAAkB;GAC1B,GAAG;EACL,CAAC;CACH;;;;;;CAWA,MAAgB,cAAc,SAA6B,CAE3D;;;;;;;CAQA,MAAgB,OAAO,QAA6B,SAA6B,CAEjF;;;;;;CAOA,MAAgB,WAAW,MAA0B,CAErD;;;;;;;CAQA,MAAgB,SAAS,QAAW,MAA0B,CAE9D;;;;;;;CAQA,MAAgB,WAAW,IAAqB,MAA0B,CAE1E;;;;;;;CAQA,MAAgB,SAAS,QAAW,MAA0B,CAE9D;;;;;;;CAQA,MAAgB,SAAS,MAAW,MAA+B,CAEnE;;;;;;;;CASA,MAAgB,OAAO,QAAW,MAAW,MAA+B,CAE5E;;;;;;CAOA,MAAgB,WAAW,IAAoC,CAE/D;;;;;;CAOA,MAAgB,SAAS,IAAoC,CAE7D;;;;;;;CAYA,MAAa,MAAM,SAAsD;EACvE,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,OAAO,KAAK,eAAe,OAAO;EAExC,KAAK,oBAAoB,OAAO,IAAI;EAEpC,OAAO,MAAM,MAAM,MAAM;CAC3B;;;;;;;CAQA,MAAa,YAAY,SAAsD;EAC7E,OAAO,MAAM,KAAK,MAAM,KAAK,QAAQ;GAAE,GAAG,KAAK,kBAAkB;GAAG,GAAG;EAAQ,CAAC,CAAC;CACnF;;;;;;;CAQA,MAAa,YAAY,SAAsD;EAC7E,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAC7B,OAAO,MAAM,KAAK,MAAM,OAAO;EAGjC,MAAM,OAAO,KAAK,eAAe,OAAO;EAExC,MAAM,WAAW,KAAK,SAAS,SAAS,IAAI;EAC5C,IAAI,QAAQ,MAAM,KAAK,YAAY,IAAI,QAAQ;EAE/C,IAAI,UAAU,QAAW,OAAO;EAEhC,QAAQ,MAAM,KAAK,MAAM,OAAO;EAChC,MAAM,KAAK,MAAM,UAAU,KAAK;EAChC,OAAO;CACT;;;;;;;CAQA,MAAa,kBAAkB,SAAsD;EACnF,OAAO,MAAM,KAAK,YAAY,KAAK,QAAQ;GAAE,GAAG,KAAK,kBAAkB;GAAG,GAAG;EAAQ,CAAC,CAAC;CACzF;;;;;;;CAYA,AAAO,eAAe,QAAmB;EACvC,KAAK,cAAc;EACnB,OAAO;CACT;;;;;;CAOA,AAAO,iBAAsB;EAC3B,OAAO,KAAK;CACd;;;;;;;;CASA,AAAU,SAAS,KAAmC,aAA2C;EAC/F,IAAI,WAAW,gBAAgB,KAAK,QAAQ;EAE5C,IAAI,KACF,YAAY,OAAO,OAAO,QAAQ,WAAW,MAAM,KAAK,UAAU,GAAG;EAGvE,IAAI,aACF,YAAY,MAAM,KAAK,UAAU,WAAW;EAG9C,OAAO;CACT;;;;;;;CAQA,MAAgB,MAAM,KAAa,OAA2B;EAC5D,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAAa;EAC5C,MAAM,KAAK,YAAY,IAAI,KAAK,KAAK;CACvC;;;;;;;CAQA,MAAa,UAAU,IAAwC;EAC7D,OAAO,MAAM,KAAK,YAAY,MAAM,EAAE;CACxC;;;;CAKA,MAAa,WAAW,IAAwC;EAC9D,OAAO,MAAM,KAAK,YAAY,MAAM,EAAE;CACxC;;;;;;;;;CAUA,MAAa,YACX,QACA,OACA,iBACmB;EACnB,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAC7B,OAAO,MAAM,KAAK,OAAO,QAAQ,KAAK;EAGxC,MAAM,WAAW,KAAK,SAAS,GAAG,OAAO,GAAG,SAAS,eAAe;EACpE,MAAM,aAAa,MAAM,KAAK,YAAY,IAAI,QAAQ;EAEtD,IAAI,YACF,OAAO,KAAK,QAAQ,iBAAiB,UAAU;EAGjD,MAAM,QAAQ,MAAM,KAAK,OAAO,QAAQ,KAAK;EAE7C,IAAI,CAAC,OAAO,OAAO;EAEnB,KAAK,MAAM,UAAU,KAAK,QAAQ,eAAe,KAAK,CAAC;EACvD,OAAO;CACT;;;;;;;CAQA,MAAa,UAAU,SAAsD;EAC3E,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAC7B,OAAO,MAAM,KAAK,IAAI,OAAO;EAG/B,MAAM,OAAO,KAAK,eAAe,OAAO;EAExC,MAAM,WAAW,KAAK,SAAS,OAAO,IAAI;EAC1C,MAAM,aAAa,MAAM,KAAK,YAAY,IAAS,QAAQ;EAE3D,IAAI,YACF,OAAO,WAAW,KAAK,WAAW,KAAK,QAAQ,iBAAiB,MAAM,CAAC;EAGzE,MAAM,UAAU,MAAM,KAAK,IAAI,OAAO;EACtC,MAAM,KAAK,MACT,UACA,QAAQ,KAAK,WAAW,KAAK,QAAQ,eAAe,MAAM,CAAC,CAC7D;EACA,OAAO;CACT;;;;;;;CAQA,MAAa,gBAAgB,SAAsD;EACjF,OAAO,MAAM,KAAK,UAAU,KAAK,WAAW;GAAE,GAAG,KAAK,kBAAkB;GAAG,GAAG;EAAQ,CAAC,CAAC;CAC1F;;;;;;;CAQA,MAAa,WAAW,SAAmE;EACzF,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAC7B,OAAQ,MAAM,KAAK,UAAU,OAAO;EAGtC,MAAM,OAAO,KAAK,eAAe,OAAO;EAExC,MAAM,WAAW,KAAK,SAAS,QAAQ,IAAI;EAC3C,MAAM,aAAa,MAAM,KAAK,YAAY,IAAI,QAAQ;EAEtD,IAAI,YACF,OAAO;GACL,OAAO,YAAY,QAAQ,CAAC,EAAC,CAAE,KAAK,WAAc,KAAK,QAAQ,iBAAiB,MAAM,CAAC;GACvF,YAAY,WAAW;EACzB;EAGF,MAAM,SAAU,MAAM,KAAK,UAAU,OAAO;EAE5C,MAAM,KAAK,MAAM,UAAU;GACzB,MAAM,OAAO,KAAK,KAAK,WAAW,KAAK,QAAQ,eAAe,MAAM,CAAC;GACrE,YAAY,OAAO;EACrB,CAAC;EACD,OAAO;CACT;;;;;;;CAQA,MAAa,iBAAiB,SAAmE;EAC/F,OAAO,MAAM,KAAK,WAAW,KAAK,QAAQ;GAAE,GAAG,KAAK,kBAAkB;GAAG,GAAG;EAAQ,CAAC,CAAC;CACxF;;;;;;;CAQA,MAAa,gBAAgB,IAA6C;EACxE,MAAM,QAAQ,MAAM,KAAK,UAAU,EAAE;EACrC,IAAI,CAAC,OAAO,OAAO;EAEnB,IAAI,OAAQ,MAAc,QAAQ,YAChC,OAAQ,MAAc,IAAI,KAAK,kBAAkB,CAAC,MAAM,KAAK,iBAAiB,IAC1E,QACA;EAKN,OADkB,MAAc,KAAK,kBAAkB,OAAO,KAAK,iBAAiB,IAClE,QAAQ;CAC5B;;;;;;CAOA,MAAa,WAAW,OAAyB;EAC/C,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAAa;EAE5C,MAAM,KAAM,MAAc;EAC1B,IAAI,CAAC,IAAI;EAET,MAAM,WAAW,KAAK,SAAS,MAAM,IAAI;EACzC,MAAM,KAAK,MAAM,UAAU,KAAK,QAAQ,eAAe,KAAK,CAAC;CAC/D;;;;;;;;;CAUA,AAAO,UAAU;EACf,KAAK,WAAW;EAChB,KAAK,aAAa;CACpB;;;;;;;CAQA,AAAO,WAAW;EAChB,KAAK,QAAQ;EACb,KAAK,YAAY,MAAM;CACzB;;;;;CAMA,MAAa,WAAW,KAA+B;EACrD,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAAa;EAE5C,MAAM,KAAK,YAAY,gBAAgB,KAAK,SAAS,OAAO,EAAE,CAAC;CACjE;;;;;;CAOA,MAAa,gBAAgB,OAAyB;EACpD,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,aAAa;EAE5C,MAAM,KAAM,MAAc;EAC1B,IAAI,CAAC,IAAI;EAET,MAAM,WAAW,KAAK,SAAS,MAAM,IAAI;EACzC,MAAM,KAAK,YAAY,gBAAgB,QAAQ;CACjD;;;;;;;CAQA,AAAU,UAAU,WAAuB;EACzC,OAAO,UAAU,KAAK,QAAQ,KAAK,SAAS,GAAG,CAAC;CAClD;;;;;;;;CAaA,MAAa,aACX,OACA,MACY;EAEZ,OAAO,MADa,KAAK,MAAM,KAAK,KACnB,MAAM,KAAK,OAAO,IAAI;CACzC;;;;;;;;CASA,MAAa,eACX,OACA,MACY;EACZ,MAAM,QAAQ,MAAM,KAAK,MAAM,KAAK;EACpC,IAAI,OACF,OAAO,MAAM,KAAK,OAAO,OAAO,IAAI;EAEtC,OAAO,MAAM,KAAK,OAAO,IAAI;CAC/B;AACF"}
+{"version":3,"file":"repository.manager.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/repositories/repository.manager.ts"],"sourcesContent":["import { cache, CacheKey, type CacheDriver } from \"@warlock.js/cache\";\nimport { config } from \"../config\";\nimport { CascadeAdapter } from \"./adapters/cascade\";\nimport type {\n  AggregateExpressions,\n  AllRepositoryOptions,\n  ChunkCallback,\n  CursorPaginationResult,\n  FilterRules,\n  GroupByFields,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n  RepositoryOptions,\n  SaveMode,\n  TypedAllRepositoryOptions,\n  TypedRepositoryOptions,\n  TypedRepositoryOptionsWithCursor,\n  TypedRepositoryOptionsWithPages,\n} from \"./contracts\";\n\n/**\n * Base repository manager class\n * Provides ORM-agnostic data access layer with support for listing, filtering,\n * caching, pagination, and CRUD operations\n *\n * @template T - The type of records managed by this repository\n *\n * @example\n * // Extend with source\n * class UserRepository extends RepositoryManager<User> {\n *   protected source = User;\n *   protected filterBy = { email: \"=\", role: [\"in\", \"role\"] };\n * }\n *\n * @example\n * // Direct instantiation with adapter\n * const userRepo = new RepositoryManager<User>(new PrismaAdapter(prisma.user));\n */\nexport class RepositoryManager<T = unknown, F = Record<string, any>> {\n  /**\n   * Adapter instance (lazy-loaded)\n   * @private\n   */\n  protected _adapter?: RepositoryAdapterContract<T>;\n\n  /**\n   * Data source reference (Model, Prisma client, table name, etc.)\n   * Used by createDefaultAdapter to instantiate the appropriate adapter\n   * @protected\n   */\n  protected source?: any;\n\n  // ============================================================================\n  // CONFIGURATION PROPERTIES\n  // ============================================================================\n\n  /**\n   * Filter definitions\n   * Maps filter keys to filter rules\n   * @protected\n   */\n  protected filterBy: FilterRules = {};\n\n  /**\n   * Get adapter instance (lazy-loaded)\n   * Resolution order:\n   * 1. Use injected adapter from constructor\n   * 2. Use config-based resolver if available\n   * 3. Use createDefaultAdapter\n   *\n   * @returns Adapter instance\n   * @protected\n   */\n  protected get adapter(): RepositoryAdapterContract<T> {\n    if (this._adapter) {\n      return this._adapter;\n    }\n\n    // Try config-based resolver\n    const resolver = config.key(\"repository.adapterResolver\");\n\n    if (resolver) {\n      this._adapter = resolver(this);\n    } else {\n      this._adapter = config.get(\"repository.defaultAdapter\") || this.createDefaultAdapter();\n    }\n\n    // Adapter is guaranteed to be set at this point\n    return this._adapter!;\n  }\n\n  /**\n   * Default repository options\n   * @protected\n   */\n  protected defaultOptions: Partial<RepositoryOptions> =\n    config.get(\"repository.defaultOptions\") || {};\n\n  /**\n   * Simple select columns (used with simple filter)\n   * @protected\n   */\n  protected simpleSelectColumns: string[] = [];\n\n  /**\n   * Active column name\n   * @default \"isActive\"\n   * @protected\n   */\n  protected isActiveColumn?: string;\n\n  /**\n   * Active column value\n   * @default true\n   * @protected\n   */\n  protected isActiveValue?: any;\n\n  /**\n   * Repository name (for events)\n   * @protected\n   */\n  protected name?: string;\n\n  /**\n   * Whether caching is enabled\n   * @default true\n   * @protected\n   */\n  protected isCacheable = config.get(\"repository.isCacheable\") ?? true;\n\n  /**\n   * Cache driver instance\n   * @protected\n   */\n  protected cacheDriver: CacheDriver<any, any> = config.get(\"repository.cacheDriver\") || cache;\n\n  /**\n   * List of all events callbacks\n   */\n  protected eventsCallbacks: any[] = [];\n\n  /**\n   * Constructor\n   * @param adapter - Optional adapter instance for direct injection\n   */\n  public constructor(adapter?: RepositoryAdapterContract<T>) {\n    if (adapter) {\n      this._adapter = adapter;\n    }\n\n    // Wait for constructor to finish and all properties are properly registered\n    // specially for adapter to get instanciated\n    setTimeout(() => {\n      this.registerEvents();\n    }, 0);\n  }\n\n  /**\n   * Register events\n   */\n  public registerEvents() {\n    // Scheduled via setTimeout(0) in the constructor, so this runs detached:\n    // the adapter getter (or its event wiring) can throw and there is no caller\n    // to catch it. Guard the whole body so a registration failure is logged\n    // instead of surfacing as an uncaught exception that crashes the process.\n    try {\n      this.eventsCallbacks.push(\n        ...this.adapter.registerEvents((source: any) => {\n          // this.clearCache({ id: source.id });\n          this.clearCache();\n        }),\n      );\n    } catch (error) {\n      console.error(`[Repository] Failed to register events:`, error);\n    }\n  }\n\n  /**\n   * Unregister events\n   */\n  public cleanuEvents() {\n    this.eventsCallbacks.forEach((callback) => {\n      callback();\n    });\n    this.eventsCallbacks = [];\n  }\n\n  /**\n   * Create default adapter instance\n   * Override this method to provide custom adapter creation logic\n   *\n   * @returns Adapter instance\n   * @throws Error if no source is configured\n   * @protected\n   */\n  protected createDefaultAdapter(): RepositoryAdapterContract<T> {\n    if (!this.source) {\n      throw new Error(\n        \"No adapter or source configured. Either pass an adapter to the constructor, \" +\n          \"set the 'source' property, or configure 'repository.adapterResolver' in config.\",\n      );\n    }\n\n    // Default: assume source is a Cascade Model\n    if (typeof this.source === \"function\") {\n      // Lazy import to avoid circular dependencies\n      return new CascadeAdapter(this.source) as unknown as RepositoryAdapterContract<T>;\n    }\n\n    throw new Error(\n      \"Cannot create default adapter for this source type. \" +\n        \"Please provide an adapter or configure repository.adapterResolver.\",\n    );\n  }\n\n  // ============================================================================\n  // UTILITY METHODS\n  // ============================================================================\n\n  /**\n   * Get repository name\n   * @returns Repository name\n   * @public\n   */\n  public getName(): string {\n    if (this.name) {\n      return this.name;\n    }\n\n    // Try to get collection name from source\n    this.name = this.adapter.resolveRepositoryName() || \"unknown\";\n\n    return this.name;\n  }\n\n  /**\n   * Get is active column\n   */\n  protected getIsActiveColumn(): string {\n    return this.isActiveColumn || config.key(\"repository.isActiveColumn\") || \"isActive\";\n  }\n\n  /**\n   * Get is active value\n   */\n  protected getIsActiveValue(): any {\n    return this.isActiveValue ?? config.key(\"repository.isActiveValue\") ?? true;\n  }\n\n  /**\n   * Create new query builder instance\n   * @returns Query builder\n   * @public\n   */\n  public newQuery() {\n    return this.adapter.query();\n  }\n\n  /**\n   * Create new model instance\n   * @param data - Model data\n   * @returns Model instance\n   * @public\n   */\n  public newModel(data?: any): T {\n    return this.adapter.createModel(data);\n  }\n\n  /**\n   * Get active filter object\n   * @returns Filter object for active records\n   * @protected\n   */\n  protected getIsActiveFilter() {\n    return {\n      [this.getIsActiveColumn()]: this.getIsActiveValue(),\n    };\n  }\n\n  // ============================================================================\n  // FINDING METHODS\n  // ============================================================================\n\n  /**\n   * Find a record by ID\n   * @param id - Record ID or model instance\n   * @returns Promise resolving to record or null\n   * @public\n   */\n  public async find(id: string | number | T): Promise<T | null> {\n    return this.adapter.find(id);\n  }\n\n  /**\n   * Find a record by column value\n   * @param column - Column name\n   * @param value - Value to search for\n   * @returns Promise resolving to record or null\n   * @public\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return this.adapter.findBy(column, value);\n  }\n\n  /**\n   * Find active record by ID\n   * @param id - Record ID or model instance\n   * @returns Promise resolving to active record or null\n   * @public\n   */\n  public async findActive(id: string | number | T): Promise<T | null> {\n    return this.newQuery()\n      .where({\n        id,\n        ...this.getIsActiveFilter(),\n      })\n      .first();\n  }\n\n  /**\n   * Find active record by column value\n   * @param column - Column name\n   * @param value - Value to search for\n   * @returns Promise resolving to active record or null\n   * @public\n   */\n  public async findByActive(column: string, value: any): Promise<T | null> {\n    return this.newQuery()\n      .where({\n        [column]: value,\n        ...this.getIsActiveFilter(),\n      })\n      .first();\n  }\n\n  /**\n   * Get first record matching options\n   * @param options - Repository options\n   * @returns Promise resolving to first record or null\n   * @public\n   */\n  public async first(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return query.limit(1).first();\n  }\n\n  /**\n   * Get id by the given filter\n   */\n  public async firstId(options?: TypedRepositoryOptions<F>): Promise<string | number | undefined> {\n    const record = await this.first(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first active id\n   */\n  public async firstActiveId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstActive(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first cached id\n   */\n  public async firstCachedId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstCached(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first active cached id\n   */\n  public async firstActiveCachedId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstActiveCached(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first uuid\n   */\n  public async firstUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.first(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first active uuid\n   */\n  public async firstActiveUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.firstActive(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first cached uuid\n   */\n  public async firstCachedUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.firstCached(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first active cached uuid\n   */\n  public async firstActiveCachedUuid(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | undefined> {\n    const record = await this.firstActiveCached(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first cached record\n   */\n  public async firstCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const results = await this.allCached({\n      ...options,\n      limit: 1,\n    } as TypedAllRepositoryOptions<F>);\n\n    return results[0] || null;\n  }\n\n  /**\n   * Get first active record\n   * @param options - Repository options\n   * @returns Promise resolving to first active record or null\n   * @public\n   */\n  public async firstActive(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.first({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get first active cached record\n   * @param options - Repository options\n   * @returns Promise resolving to first active cached record or null\n   * @public\n   */\n  public async firstActiveCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.firstCached({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last record matching options\n   * @param options - Repository options\n   * @returns Promise resolving to last record or null\n   * @public\n   */\n  public async last(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.first({\n      orderBy: {\n        id: \"desc\",\n      },\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last cached record\n   */\n  public async lastCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const results = await this.allCached(\n      this.asTypedAll({\n        ...options,\n        limit: 1,\n        orderBy: { id: \"desc\" },\n      }),\n    );\n\n    return results[0] || null;\n  }\n\n  /**\n   * Get last active record\n   * @param options - Repository options\n   * @returns Promise resolving to last active record or null\n   * @public\n   */\n  public async lastActive(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.last({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last active cached record\n   * @param options - Repository options\n   * @returns Promise resolving to last active cached record or null\n   * @public\n   */\n  public async lastActiveCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.lastCached({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  // ============================================================================\n  // LISTING METHODS\n  // ============================================================================\n\n  /**\n   * List records with pagination\n   * Supports both traditional page-based and cursor-based pagination\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   *\n   * @example\n   * // Traditional pagination (default)\n   * const result = await repo.list({ page: 2, limit: 10 });\n   *\n   * @example\n   * // Cursor pagination\n   * const result = await repo.list({\n   *   paginationMode: \"cursor\",\n   *   limit: 20,\n   *   cursor: lastId,\n   *   direction: \"next\"\n   * });\n   *\n   * @public\n   */\n  public async list(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async list(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async list(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl(options);\n  }\n\n  /**\n   * Internal list implementation - no overloads, handles union type\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @private\n   */\n  private async _listImpl(\n    options?: RepositoryOptions,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options as TypedRepositoryOptions<F>);\n    const paginationMode = opts.paginationMode || \"pages\";\n\n    // applyOptionsToQuery handles cursor phase 1 (WHERE + ORDER BY) internally\n    // when paginationMode === \"cursor\", ensuring the cursor column is always\n    // the primary sort key before any other options are applied.\n    this.applyOptionsToQuery(query, opts);\n\n    if (paginationMode === \"cursor\") {\n      return query.cursorPaginate({\n        limit: opts.limit || opts.defaultLimit || 15,\n        cursor: opts.cursor,\n        direction: opts.direction,\n        cursorColumn: opts.cursorColumn,\n      });\n    }\n\n    // Traditional page-based pagination (default)\n    const page = opts.page || 1;\n    const limit = opts.limit || opts.defaultLimit || 15;\n\n    return query.paginate(page, limit);\n  }\n\n  /**\n   * List all records without pagination\n   * @param options - Repository options\n   * @returns Promise resolving to array of records\n   * @public\n   */\n  public async all(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    const query = this.newQuery();\n\n    // Apply options. all() never paginates, so flag paginate:false explicitly —\n    // this lets applyOptionsToQuery honor a provided `limit` on this path (e.g.\n    // firstCached/lastCached call all({ limit: 1 }) and rely on LIMIT 1 being\n    // applied instead of fetching+caching the entire table).\n    const opts = this.prepareOptions(options);\n    opts.paginate = false;\n    this.applyOptionsToQuery(query, opts);\n\n    return query.get();\n  }\n\n  /**\n   * List active records with pagination\n   * Supports both page-based and cursor-based pagination\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async listActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async listActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async listActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  /**\n   * List all active records without pagination\n   * @param options - Repository options\n   * @returns Promise resolving to array of active records\n   * @public\n   */\n  public async allActive(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    return this.all(this.asTypedAll({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // EXISTENCE CHECKS\n  // ============================================================================\n\n  /**\n   * Check if record exists matching filter\n   * @param filter - Repository options\n   * @returns Promise resolving to true if exists\n   * @public\n   */\n  public async exists(filter?: TypedRepositoryOptions<F>): Promise<boolean> {\n    return !!(await this.first(filter));\n  }\n\n  /**\n   * Check if active record exists matching filter\n   * @param filter - Repository options\n   * @returns Promise resolving to true if active record exists\n   * @public\n   */\n  public async existsActive(filter?: TypedRepositoryOptions<F>): Promise<boolean> {\n    return !!(await this.firstActive(filter));\n  }\n\n  /**\n   * Check if record exists by ID\n   * @param id - Record ID\n   * @returns Promise resolving to true if exists\n   * @public\n   */\n  public async idExists(id: number | string): Promise<boolean> {\n    return !!(await this.find(id));\n  }\n\n  /**\n   * Check if active record exists by ID\n   * @param id - Record ID\n   * @returns Promise resolving to true if active record exists\n   * @public\n   */\n  public async idExistsActive(id: number | string): Promise<boolean> {\n    return !!(await this.findActive(id));\n  }\n\n  /**\n   * Prepare options — merges defaultOptions with caller options.\n   * Returning as TypedRepositoryOptions<F> ensures internal composition\n   * (spread + forward) satisfies the typed public API without per-call casts.\n   */\n  protected prepareOptions(options?: TypedRepositoryOptions<F>): TypedRepositoryOptions<F> {\n    return { ...(this.defaultOptions || {}), ...(options || {}) } as TypedRepositoryOptions<F>;\n  }\n\n  /**\n   * Cast a plain `RepositoryOptions` spread to the typed variant.\n   * Used internally when composing options across method calls where the\n   * spread breaks the F-generic inference chain.\n   */\n  protected asTyped(opts: RepositoryOptions): TypedRepositoryOptions<F> {\n    return opts as TypedRepositoryOptions<F>;\n  }\n\n  protected asTypedAll(opts: AllRepositoryOptions): TypedAllRepositoryOptions<F> {\n    return opts as TypedAllRepositoryOptions<F>;\n  }\n\n  // ============================================================================\n  // HELPER METHODS\n  // ============================================================================\n\n  /**\n   * Apply repository options to query\n   * @param query - Query builder instance\n   * @param options - Repository options\n   * @protected\n   */\n  protected applyOptionsToQuery(\n    query: QueryBuilderContract<T>,\n    options: RepositoryOptions,\n  ): RepositoryOptions {\n    // ── Cursor phase 1: WHERE + ORDER BY ──────────────────────────────────────\n    // Must run first so the cursor column is always the PRIMARY sort key.\n    // Any orderBy appended below becomes a harmless secondary sort key.\n    if (options.paginationMode === \"cursor\") {\n      const cursorColumn = options.cursorColumn ?? \"id\";\n      const direction = options.direction ?? \"next\";\n\n      if (options.cursor) {\n        query.where(cursorColumn, direction === \"next\" ? \">\" : \"<\", options.cursor);\n      }\n\n      query.orderBy(cursorColumn, direction === \"next\" ? \"asc\" : \"desc\");\n\n      // Warn and strip orderBy that targets the same column as the cursor —\n      // it would produce a duplicate / conflicting sort clause.\n      if (options.orderBy) {\n        const conflictingKeys = Array.isArray(options.orderBy)\n          ? [options.orderBy[0]]\n          : typeof options.orderBy === \"object\"\n            ? Object.keys(options.orderBy)\n            : [];\n\n        if (conflictingKeys.includes(cursorColumn)) {\n          console.warn(\n            `[Repository] orderBy on \"${cursorColumn}\" conflicts with cursorColumn and will be ignored. ` +\n              `Cursor pagination owns the sort order for its cursor column.`,\n          );\n          options = { ...options, orderBy: undefined };\n        }\n      }\n    }\n\n    // Apply filters\n    if (this.filterBy && Object.keys(this.filterBy).length > 0) {\n      query.applyFilters(this.filterBy, options, {\n        dateFormat: \"DD-MM-YYYY\",\n        dateTimeFormat: \"DD-MM-YYYY HH:mm:ss\",\n      });\n    }\n\n    // Apply select\n    if (options.select) {\n      query.select(options.select);\n    }\n\n    // Apply deselect\n    if (options.deselect) {\n      query.deselect(options.deselect);\n    }\n\n    if (options.simpleSelect && this.simpleSelectColumns.length > 0) {\n      query.select(this.simpleSelectColumns);\n    }\n\n    // Apply ordering\n    if (options.orderBy) {\n      if (options.orderBy === \"random\") {\n        // Pass the explicit limit through to random() when set. For the MongoDB\n        // driver `$sample` REQUIRES a size — with no argument it silently\n        // defaults to 1000, truncating larger result sets. Forwarding the\n        // caller's limit keeps the random sample bounded to what they asked for.\n        query.random(options.limit);\n      } else if (Array.isArray(options.orderBy)) {\n        query.orderBy(options.orderBy[0], options.orderBy[1]);\n      } else if (typeof options.orderBy === \"object\") {\n        query.sortBy(options.orderBy);\n      }\n    } else if (options.sortBy) {\n      // Honor the standalone sortBy/sortDirection pair as a single orderBy clause\n      // (only when no explicit orderBy was provided, which always wins).\n      query.orderBy(options.sortBy, options.sortDirection ?? \"asc\");\n    }\n\n    // Apply limit (for non-paginated queries).\n    // The all() path sets `paginate: false` explicitly so a provided `limit`\n    // is honored there (otherwise firstCached/lastCached, which delegate to\n    // all({ limit: 1 }), would drop the LIMIT and fetch the whole table).\n    // Page-based pagination leaves paginate undefined and owns LIMIT itself.\n    if (options.limit && options.paginate === false) {\n      query.limit(options.limit);\n    }\n\n    // Apply custom perform function\n    if (options?.perform) {\n      options.perform(query, options);\n    }\n\n    return options;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * Create a new record\n   * @param data - Record data\n   * @returns Promise resolving to created record\n   * @public\n   */\n  public async create(data: any): Promise<T> {\n    await this.onSaving(data, \"create\");\n    await this.onCreating(data);\n\n    const result = await this.adapter.create(data);\n\n    await this.onCreate(result, data);\n    await this.onSave(result, data, \"create\");\n\n    return result;\n  }\n\n  /**\n   * Update a record by ID\n   * @param id - Record ID\n   * @param data - Updated data\n   * @returns Promise resolving to updated record\n   * @public\n   */\n  public async update(id: string | number | any, data: any): Promise<T> {\n    await this.onSaving(data, \"update\");\n    await this.onUpdating(id, data);\n\n    const result = await this.adapter.update(id, data);\n\n    await this.onUpdate(result, data);\n    await this.onSave(result, data, \"update\");\n\n    return result;\n  }\n\n  /**\n   * Delete a record by ID\n   * @param id - Record ID\n   * @returns Promise that resolves when deletion is complete\n   * @public\n   */\n  public async delete(id: string | number): Promise<void> {\n    await this.onDeleting(id);\n\n    await this.adapter.delete(id);\n\n    await this.onDelete(id);\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * Update multiple records matching filter\n   * @param filter - Filter criteria\n   * @param data - Updated data\n   * @returns Promise resolving to number of updated records\n   * @public\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    return this.adapter.updateMany(filter, data);\n  }\n\n  /**\n   * Delete multiple records matching filter\n   * @param filter - Filter criteria\n   * @returns Promise resolving to number of deleted records\n   * @public\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    return this.adapter.deleteMany(filter);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * Process records in chunks\n   * @param size - Chunk size\n   * @param callback - Function called for each chunk\n   * @param options - Repository options\n   * @returns Promise that resolves when chunking is complete\n   * @public\n   */\n  public async chunk(\n    size: number,\n    callback: ChunkCallback<T>,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<void> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return query.chunk(size, callback);\n  }\n\n  /**\n   * Process active records in chunks\n   * @param size - Chunk size\n   * @param callback - Function called for each chunk\n   * @param options - Repository options\n   * @returns Promise that resolves when chunking is complete\n   * @public\n   */\n  public async chunkActive(\n    size: number,\n    callback: ChunkCallback<T>,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<void> {\n    return this.chunk(size, callback, this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // CONVENIENCE METHODS\n  // ============================================================================\n\n  /**\n   * Get latest records (ordered by ID descending)\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async latest(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async latest(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async latest(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"desc\"],\n      ...options,\n    });\n  }\n\n  /**\n   * Get oldest records (ordered by ID ascending)\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async oldest(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async oldest(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async oldest(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"asc\"],\n      ...options,\n    });\n  }\n\n  /**\n   * Get latest active records\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async latestActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async latestActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async latestActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"desc\"],\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  /**\n   * Get oldest active records\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async oldestActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async oldestActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async oldestActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"asc\"],\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  // ============================================================================\n  // LIFECYCLE HOOKS (Override these in child classes)\n  // ============================================================================\n\n  /**\n   * Called before listing records\n   * @param options - Repository options\n   * @protected\n   */\n  protected async beforeListing(options: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after listing records\n   * @param result - Pagination result\n   * @param options - Repository options\n   * @protected\n   */\n  protected async onList(result: PaginationResult<T>, options: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before creating a record\n   * @param data - Record data\n   * @protected\n   */\n  protected async onCreating(data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after creating a record\n   * @param record - Created record\n   * @param data - Original data\n   * @protected\n   */\n  protected async onCreate(record: T, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before updating a record\n   * @param id - Record ID\n   * @param data - Updated data\n   * @protected\n   */\n  protected async onUpdating(id: string | number, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after updating a record\n   * @param record - Updated record\n   * @param data - Original data\n   * @protected\n   */\n  protected async onUpdate(record: T, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before saving a record (create or update)\n   * @param data - Record data\n   * @param mode - Save mode\n   * @protected\n   */\n  protected async onSaving(data: any, mode: SaveMode): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after saving a record (create or update)\n   * @param record - Saved record\n   * @param data - Original data\n   * @param mode - Save mode\n   * @protected\n   */\n  protected async onSave(record: T, data: any, mode: SaveMode): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before deleting a record\n   * @param id - Record ID\n   * @protected\n   */\n  protected async onDeleting(id: string | number): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after deleting a record\n   * @param id - Record ID\n   * @protected\n   */\n  protected async onDelete(id: string | number): Promise<void> {\n    // Override in child class\n  }\n\n  // ============================================================================\n  // COUNT METHODS\n  // ============================================================================\n\n  /**\n   * Count total records matching options\n   * @param options - Repository options\n   * @returns Promise resolving to count\n   * @public\n   */\n  public async count(options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.count();\n  }\n\n  /**\n   * Count total active records\n   * @param options - Repository options\n   * @returns Promise resolving to count of active records\n   * @public\n   */\n  public async countActive(options?: TypedRepositoryOptions<F>): Promise<number> {\n    return await this.count(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * Count records with caching\n   * @param options - Repository options\n   * @returns Promise resolving to cached count\n   * @public\n   */\n  public async countCached(options?: TypedRepositoryOptions<F>): Promise<number> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.count(options);\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"count\", opts);\n\n    // Bypass + refresh the cache when purgeCache is requested.\n    if (!opts.purgeCache) {\n      const cachedCount = await this.cacheDriver.get(cacheKey);\n\n      // Treat BOTH null and undefined as a cache miss: every shipped cache\n      // driver returns `null` (not `undefined`) on a miss, so checking only\n      // for `undefined` would return that null as the count and never cache.\n      if (cachedCount !== null && cachedCount !== undefined) {\n        return cachedCount;\n      }\n    }\n\n    const count = await this.count(options);\n    await this.cache(cacheKey, count);\n    return count;\n  }\n\n  /**\n   * Count active records with caching\n   * @param options - Repository options\n   * @returns Promise resolving to cached count of active records\n   * @public\n   */\n  public async countActiveCached(options?: TypedRepositoryOptions<F>): Promise<number> {\n    return await this.countCached(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // AGGREGATION METHODS\n  // ============================================================================\n\n  /**\n   * Sum a numeric field across records matching options.\n   *\n   * Applies `filterBy` (and its operator-injection guard), `where`, scopes and\n   * every other repository option to the query FIRST — exactly like `count()` —\n   * THEN runs the aggregate, so the sum is always scoped by the same filters\n   * the rest of the repository honors.\n   *\n   * @param field - Numeric field to sum\n   * @param options - Repository options (filter values, perform, etc.)\n   * @returns Promise resolving to the filtered numeric sum\n   * @public\n   *\n   * @example\n   * await ordersRepository.sum(\"total\", { status: \"paid\" });\n   */\n  public async sum(field: string, options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.sum(field);\n  }\n\n  /**\n   * Average a numeric field across records matching options.\n   *\n   * Options (including `filterBy`) are applied before the aggregate, mirroring\n   * `count()`.\n   *\n   * @param field - Numeric field to average\n   * @param options - Repository options\n   * @returns Promise resolving to the filtered numeric average\n   * @public\n   */\n  public async avg(field: string, options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.avg(field);\n  }\n\n  /**\n   * Minimum value of a field across records matching options.\n   *\n   * Options (including `filterBy`) are applied before the aggregate, mirroring\n   * `count()`.\n   *\n   * @param field - Field name\n   * @param options - Repository options\n   * @returns Promise resolving to the filtered minimum value\n   * @public\n   */\n  public async min(field: string, options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.min(field);\n  }\n\n  /**\n   * Maximum value of a field across records matching options.\n   *\n   * Options (including `filterBy`) are applied before the aggregate, mirroring\n   * `count()`.\n   *\n   * @param field - Field name\n   * @param options - Repository options\n   * @returns Promise resolving to the filtered maximum value\n   * @public\n   */\n  public async max(field: string, options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.max(field);\n  }\n\n  /**\n   * Group records by one or more fields and compute aggregates.\n   *\n   * Repository options (including `filterBy`) are applied before the grouping,\n   * mirroring `count()`, so the grouped rows are always scoped by the same\n   * filters the rest of the repository honors.\n   *\n   * @template R - Shape of each grouped row\n   * @param fields - Field(s) to group by\n   * @param aggregates - Map of result aliases to aggregate expressions (e.g. `$agg.*`)\n   * @param options - Repository options\n   * @returns Promise resolving to the array of grouped rows\n   * @public\n   *\n   * @example\n   * import { $agg } from \"@warlock.js/cascade\";\n   *\n   * await ordersRepository.groupBy(\n   *   \"status\",\n   *   { count: $agg.count(), total: $agg.sum(\"total\") },\n   *   { paidAfter: \"2026-01-01\" },\n   * );\n   */\n  public async groupBy<R = Record<string, unknown>>(\n    fields: GroupByFields,\n    aggregates: AggregateExpressions,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<R[]> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.groupBy<R>(fields, aggregates);\n  }\n\n  /**\n   * Compute aggregates over the whole matching set as a single summary row.\n   *\n   * Repository options (including `filterBy`) are applied before the aggregate,\n   * mirroring `count()`.\n   *\n   * @template R - Shape of the summary row\n   * @param aggregates - Map of result aliases to aggregate expressions (e.g. `$agg.*`)\n   * @param options - Repository options\n   * @returns Promise resolving to the single summary row (or `null` when empty)\n   * @public\n   *\n   * @example\n   * import { $agg } from \"@warlock.js/cascade\";\n   *\n   * await ordersRepository.aggregate(\n   *   { total: $agg.sum(\"total\"), avg: $agg.avg(\"total\") },\n   *   { status: \"paid\" },\n   * );\n   */\n  public async aggregate<R = Record<string, unknown>>(\n    aggregates: AggregateExpressions,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<R | null> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.aggregate<R>(aggregates);\n  }\n\n  // ============================================================================\n  // CACHING METHODS\n  // ============================================================================\n\n  /**\n   * Set cache driver\n   * @param driver - Cache driver instance\n   * @returns This repository for chaining\n   * @public\n   */\n  public setCacheDriver(driver: any): this {\n    this.cacheDriver = driver;\n    return this;\n  }\n\n  /**\n   * Get cache driver\n   * @returns Cache driver instance\n   * @public\n   */\n  public getCacheDriver(): any {\n    return this.cacheDriver;\n  }\n\n  /**\n   * Generate cache key\n   * @param key - Base key or object\n   * @param moreOptions - Additional options for key\n   * @returns Generated cache key\n   * @protected\n   */\n  protected cacheKey(key: string | Record<string, any>, moreOptions?: Record<string, any>): string {\n    let cacheKey = `repositories.${this.getName()}`;\n\n    if (key) {\n      cacheKey += \".\" + (typeof key === \"string\" ? key : this.stableStringify(key));\n    }\n\n    if (moreOptions) {\n      // `purgeCache` is a control flag, not a query parameter — it must NOT\n      // affect the key, otherwise a purge would refresh a different key than a\n      // normal read consults, defeating the purpose.\n      const { purgeCache: _purgeCache, ...keyOptions } = moreOptions;\n      cacheKey += \".\" + this.stableStringify(keyOptions);\n    }\n\n    return cacheKey;\n  }\n\n  /**\n   * Deterministically serialize a value for use in a cache key.\n   *\n   * Unlike raw `JSON.stringify`, object keys are recursively sorted so that\n   * `{ a: 1, b: 2 }` and `{ b: 2, a: 1 }` produce the same key. Function-valued\n   * options (e.g. a `perform` callback) are represented by a stable marker\n   * (`[fn:<name>]`) rather than being silently dropped, so two distinct\n   * callbacks do not collide on the same cache key.\n   */\n  protected stableStringify(value: any): string {\n    const seen = new WeakSet<object>();\n\n    const normalize = (input: any): any => {\n      if (typeof input === \"function\") {\n        return `[fn:${input.name || \"anonymous\"}]`;\n      }\n\n      if (input === null || typeof input !== \"object\") {\n        return input;\n      }\n\n      // Guard against circular references — represent them with a stable marker.\n      if (seen.has(input)) {\n        return \"[circular]\";\n      }\n\n      seen.add(input);\n\n      if (Array.isArray(input)) {\n        return input.map((item) => normalize(item));\n      }\n\n      const sorted: Record<string, any> = {};\n\n      for (const objectKey of Object.keys(input).sort()) {\n        sorted[objectKey] = normalize(input[objectKey]);\n      }\n\n      return sorted;\n    };\n\n    return JSON.stringify(normalize(value));\n  }\n\n  /**\n   * Cache a value\n   * @param key - Cache key\n   * @param value - Value to cache\n   * @protected\n   */\n  protected async cache(key: string, value: any): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    // Swallow cache write failures so a flaky/unreachable remote cache (e.g.\n    // Redis) degrades gracefully to a cache miss instead of breaking the read.\n    try {\n      await this.cacheDriver.set(key, value);\n    } catch (error) {\n      console.error(`[Repository] Failed to write cache key \"${key}\":`, error);\n    }\n  }\n\n  /**\n   * Get cached record by ID\n   * @param id - Record ID\n   * @returns Promise resolving to cached record or null\n   * @public\n   */\n  public async getCached(id: string | number): Promise<T | null> {\n    return await this.getCachedBy(\"id\", id);\n  }\n\n  /**\n   * @alias getCached\n   */\n  public async findCached(id: string | number): Promise<T | null> {\n    return await this.getCachedBy(\"id\", id);\n  }\n\n  /**\n   * Get cached record by column value\n   * @param column - Column name\n   * @param value - Column value\n   * @param cacheKeyOptions - Additional cache key options\n   * @returns Promise resolving to cached record or undefined\n   * @public\n   */\n  public async getCachedBy(\n    column: string,\n    value: any,\n    cacheKeyOptions?: Record<string, any>,\n  ): Promise<T | null> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.findBy(column, value);\n    }\n\n    const cacheKey = this.cacheKey(`${column}.${value}`, cacheKeyOptions);\n    const cachedData = await this.cacheDriver.get(cacheKey);\n\n    if (cachedData) {\n      return this.adapter.deserializeModel(cachedData);\n    }\n\n    const model = await this.findBy(column, value);\n\n    if (!model) return null;\n\n    await this.cache(cacheKey, this.adapter.serializeModel(model));\n    return model;\n  }\n\n  /**\n   * Get all cached records\n   * @param options - Repository options\n   * @returns Promise resolving to array of cached records\n   * @public\n   */\n  public async allCached(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.all(options);\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"all\", opts);\n\n    // Bypass + refresh the cache when purgeCache is requested.\n    if (!opts.purgeCache) {\n      const cachedData = await this.cacheDriver.get<T[]>(cacheKey);\n\n      if (cachedData) {\n        return cachedData.map((record) => this.adapter.deserializeModel(record));\n      }\n    }\n\n    const records = await this.all(options);\n    await this.cache(\n      cacheKey,\n      records.map((record) => this.adapter.serializeModel(record)),\n    );\n    return records;\n  }\n\n  /**\n   * Get all active cached records\n   * @param options - Repository options\n   * @returns Promise resolving to array of cached active records\n   * @public\n   */\n  public async allActiveCached(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    return await this.allCached(this.asTypedAll({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * List cached records with pagination\n   * @param options - Repository options\n   * @returns Promise resolving to cached pagination result\n   * @public\n   */\n  public async listCached(options?: TypedRepositoryOptions<F>): Promise<PaginationResult<T>> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return (await this._listImpl(options)) as PaginationResult<T>;\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"list\", opts);\n\n    // Bypass + refresh the cache when purgeCache is requested.\n    if (!opts.purgeCache) {\n      const cachedData = await this.cacheDriver.get(cacheKey);\n\n      if (cachedData) {\n        return {\n          data: (cachedData?.data || []).map((record: T) => this.adapter.deserializeModel(record)),\n          pagination: cachedData.pagination,\n        };\n      }\n    }\n\n    const result = (await this._listImpl(options)) as PaginationResult<T>;\n\n    await this.cache(cacheKey, {\n      data: result.data.map((record) => this.adapter.serializeModel(record)),\n      pagination: result.pagination,\n    });\n    return result;\n  }\n\n  /**\n   * List active cached records with pagination\n   * @param options - Repository options\n   * @returns Promise resolving to cached pagination result of active records\n   * @public\n   */\n  public async listActiveCached(options?: TypedRepositoryOptions<F>): Promise<PaginationResult<T>> {\n    return await this.listCached(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * Get active cached record by ID\n   * @param id - Record ID\n   * @returns Promise resolving to cached active record or undefined\n   * @public\n   */\n  public async getActiveCached(id: string | number): Promise<T | undefined> {\n    const model = await this.getCached(id);\n    if (!model) return undefined;\n\n    if (typeof (model as any).get === \"function\") {\n      return (model as any).get(this.getIsActiveColumn()) === this.getIsActiveValue()\n        ? model\n        : undefined;\n    }\n\n    // Check if model is active\n    const isActive = (model as any)[this.getIsActiveColumn()] === this.getIsActiveValue();\n    return isActive ? model : undefined;\n  }\n\n  /**\n   * Cache a model\n   * @param model - Model to cache\n   * @public\n   */\n  public async cacheModel(model: T): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    const id = (model as any).id;\n    if (!id) return;\n\n    const cacheKey = this.cacheKey(`id.${id}`);\n    await this.cache(cacheKey, this.adapter.serializeModel(model));\n  }\n\n  /**\n   * Cleanup all events and cache as well\n   * Please note this is mostly used with development server to be\n   * exported as cleanup\n   *\n   * @example\n   * ```typescript\n   */\n  public cleanup() {\n    this.clearCache();\n    this.cleanuEvents();\n  }\n\n  /**\n   * Cleanup all events and cache as well\n   * Please note this is mostly used with development server to be\n   * exported as cleanup\n   * export const cleanup = usersRepository.cleanup.bind(usersRepository);\n   */\n  public async $cleanup(): Promise<void> {\n    await this.clearCache();\n    this.cleanuEvents();\n\n    if (this.cacheDriver) {\n      await this.cacheDriver.flush();\n    }\n  }\n\n  /**\n   * Clear all cache for this repository\n   * @public\n   */\n  public async clearCache(key?: CacheKey): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    await this.cacheDriver.removeNamespace(this.cacheKey(key || \"\"));\n  }\n\n  /**\n   * Clear cache for specific model\n   * @param model - Model to clear cache for\n   * @public\n   */\n  public async clearModelCache(model: T): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    const id = (model as any).id;\n    if (!id) return;\n\n    const cacheKey = this.cacheKey(`id.${id}`);\n    await this.cacheDriver.removeNamespace(cacheKey);\n  }\n\n  /**\n   * Map documents to models\n   * @param documents - Array of document data\n   * @returns Array of model instances\n   * @protected\n   */\n  protected mapModels(documents: any[]): T[] {\n    return documents.map((doc) => this.newModel(doc));\n  }\n\n  // ============================================================================\n  // CONVENIENCE METHODS\n  // ============================================================================\n\n  /**\n   * Find or create a record\n   * @param where - Conditions to find by\n   * @param data - Data to create if not found\n   * @returns Promise resolving to found or created record\n   * @public\n   */\n  public async findOrCreate(\n    where: TypedRepositoryOptions<F>,\n    data: Record<string, any>,\n  ): Promise<T> {\n    const model = await this.first(where);\n    return model || (await this.create(data));\n  }\n\n  /**\n   * Update or create a record\n   * @param where - Conditions to find by\n   * @param data - Data to update or create\n   * @returns Promise resolving to updated or created record\n   * @public\n   */\n  public async updateOrCreate(\n    where: TypedRepositoryOptions<F>,\n    data: Record<string, any>,\n  ): Promise<T> {\n    const model = await this.first(where);\n    if (model) {\n      return await this.update(model, data);\n    }\n    return await this.create(data);\n  }\n}\n"],"mappings":"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"}