@warlock.js/core 4.0.174 → 4.1.2

package/esm/repositories/adapters/cascade/cascade-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-adapter.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"sourcesContent":["import { type ChildModel, Model } from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n} from \"../../contracts\";\nimport { CascadeQueryBuilder } from \"./cascade-query-builder\";\n\n/**\n * Cascade adapter for Cascade-Next ORM\n * Implements RepositoryAdapterContract for @warlock.js/cascade\n *\n * @template T - The model instance type\n */\nexport class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {\n  /**\n   * Constructor\n   * @param model - Cascade-Next Model class\n   */\n  public constructor(private model: ChildModel<T>) {}\n\n  // ============================================================================\n  // QUERY BUILDING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.query}\n   */\n  public query(): QueryBuilderContract<T> {\n    return new CascadeQueryBuilder<T>(this.model.query());\n  }\n\n  /**\n   * Register all events\n   */\n  public registerEvents(eventsCallback: any): any[] {\n    const events: any[] = [];\n\n    const modelEvents = this.model.events();\n\n    events.push(\n      modelEvents.onCreated((model) => {\n        eventsCallback(model);\n      }),\n      modelEvents.onUpdated((model) => {\n        eventsCallback(model);\n      }),\n      modelEvents.onDeleted((model) => {\n        eventsCallback(model);\n      }),\n    );\n\n    return events;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.find}\n   */\n  public async find(id: any): Promise<T | null> {\n    return await this.model.find(id);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.findBy}\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return (await this.query().where(column, value).first()) as T | null;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.serializeModel}\n   */\n  public serializeModel(model: T): any {\n    return model.toSnapshot();\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deserializeModel}\n   */\n  public deserializeModel(data: any): T {\n    return this.model.fromSnapshot(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.resolveRepositoryName}\n   */\n  public resolveRepositoryName(): string {\n    return this.model.table;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.create}\n   */\n  public async create(data: any): Promise<T> {\n    return this.model.create(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.update}\n   */\n  public async update(id: any, data: any): Promise<T> {\n    const model = id instanceof Model ? id : await this.model.find(id);\n    if (!model) {\n      throw new Error(`Model not found with id ${id}`);\n    }\n\n    await model.save({ merge: data });\n    return model as T;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.delete}\n   */\n  public async delete(id: any): Promise<void> {\n    await this.model.delete({ id });\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.updateMany}\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Update each record\n    for (const record of records) {\n      await this.update(record.id, data);\n    }\n\n    return records.length;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deleteMany}\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Delete each record\n    for (const record of records) {\n      await record.destroy();\n    }\n\n    return records.length;\n  }\n\n  // ============================================================================\n  // COUNTING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.count}\n   */\n  public async count(filter?: any): Promise<number> {\n    const query = this.query();\n\n    if (filter && typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    return query.count();\n  }\n\n  // ============================================================================\n  // PAGINATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    return this.query().paginate(page, limit);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.cursorPaginate}\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    return this.query().cursorPaginate(options);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query().chunk(size, callback);\n  }\n\n  // ============================================================================\n  // MODEL CREATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.createModel}\n   */\n  public createModel(data: any): T {\n    return new (this.model as any)(data) as T;\n  }\n}\n"],"mappings":";;;;;;;;;;AAiBA,IAAa,iBAAb,MAA0F;;;;;CAKxF,AAAO,YAAY,AAAQ,OAAsB;EAAtB;CAAuB;;;;CASlD,AAAO,QAAiC;EACtC,OAAO,IAAI,oBAAuB,KAAK,MAAM,MAAM,CAAC;CACtD;;;;CAKA,AAAO,eAAe,gBAA4B;EAChD,MAAM,SAAgB,CAAC;EAEvB,MAAM,cAAc,KAAK,MAAM,OAAO;EAEtC,OAAO,KACL,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,GACD,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,GACD,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,CACH;EAEA,OAAO;CACT;;;;CASA,MAAa,KAAK,IAA4B;EAC5C,OAAO,MAAM,KAAK,MAAM,KAAK,EAAE;CACjC;;;;CAKA,MAAa,OAAO,QAAgB,OAA+B;EACjE,OAAQ,MAAM,KAAK,MAAM,EAAE,MAAM,QAAQ,KAAK,EAAE,MAAM;CACxD;;;;CAKA,AAAO,eAAe,OAAe;EACnC,OAAO,MAAM,WAAW;CAC1B;;;;CAKA,AAAO,iBAAiB,MAAc;EACpC,OAAO,KAAK,MAAM,aAAa,IAAI;CACrC;;;;CAKA,AAAO,wBAAgC;EACrC,OAAO,KAAK,MAAM;CACpB;;;;CAKA,MAAa,OAAO,MAAuB;EACzC,OAAO,KAAK,MAAM,OAAO,IAAI;CAC/B;;;;CAKA,MAAa,OAAO,IAAS,MAAuB;EAClD,MAAM,QAAQ,cAAc,QAAQ,KAAK,MAAM,KAAK,MAAM,KAAK,EAAE;EACjE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,2BAA2B,IAAI;EAGjD,MAAM,MAAM,KAAK,EAAE,OAAO,KAAK,CAAC;EAChC,OAAO;CACT;;;;CAKA,MAAa,OAAO,IAAwB;EAC1C,MAAM,KAAK,MAAM,OAAO,EAAE,GAAG,CAAC;CAChC;;;;CASA,MAAa,WAAW,QAAa,MAA4B;EAC/D,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,KAAK,OAAO,OAAO,IAAI,IAAI;EAGnC,OAAO,QAAQ;CACjB;;;;CAKA,MAAa,WAAW,QAA8B;EACpD,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,QAAQ;EAGvB,OAAO,QAAQ;CACjB;;;;CASA,MAAa,MAAM,QAA+B;EAChD,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,UAAU,OAAO,WAAW,UAC9B,MAAM,MAAM,MAAM;EAGpB,OAAO,MAAM,MAAM;CACrB;;;;CASA,MAAa,SAAS,MAAc,OAA6C;EAC/E,OAAO,KAAK,MAAM,EAAE,SAAS,MAAM,KAAK;CAC1C;;;;CAKA,MAAa,eACX,SACoC;EACpC,OAAO,KAAK,MAAM,EAAE,eAAe,OAAO;CAC5C;;;;CASA,MAAa,MAAM,MAAc,UAA2C;EAC1E,OAAO,KAAK,MAAM,EAAE,MAAM,MAAM,QAAQ;CAC1C;;;;CASA,AAAO,YAAY,MAAc;EAC/B,OAAO,IAAK,KAAK,MAAc,IAAI;CACrC;AACF"}

package/esm/repositories/adapters/cascade/cascade-query-builder.d.mts

@@ -0,0 +1,146 @@
+import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterOptions, FilterRules, PaginationResult, WhereOperator } from "../../contracts/types.mjs";
+import { QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
+import { Model, QueryBuilderContract } from "@warlock.js/cascade";
+
+//#region ../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.d.ts
+/**
+ * Cascade query builder wrapper
+ * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract
+ *
+ * @template T - The model instance type
+ */
+declare class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract$1<T> {
+  private query;
+  /**
+   * Constructor
+   * @param query - Cascade-Next QueryBuilder instance
+   */
+  constructor(query: QueryBuilderContract<T>);
+  /**
+   * {@inheritDoc QueryBuilderContract.where}
+   */
+  where(field: string, value: any): this;
+  where(field: string, operator: WhereOperator, value: any): this;
+  where(conditions: Record<string, any>): this;
+  where(callback: (query: this) => void): this;
+  /**
+   * Pretty display the query in terminal
+   */
+  pretty(): any;
+  /**
+   * {@inheritDoc QueryBuilderContract.orWhere}
+   */
+  orWhere(field: string, value: any): this;
+  orWhere(field: string, operator: WhereOperator, value: any): this;
+  orWhere(conditions: Record<string, any>): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.whereIn}
+   */
+  whereIn(field: string, values: any[]): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.whereNotIn}
+   */
+  whereNotIn(field: string, values: any[]): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.whereNull}
+   */
+  whereNull(field: string): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.whereNotNull}
+   */
+  whereNotNull(field: string): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.whereBetween}
+   */
+  whereBetween(field: string, range: [any, any]): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.whereLike}
+   */
+  whereLike(field: string, pattern: string): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.similarTo}
+   */
+  similarTo(column: string, embedding: number[], alias?: string): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.select}
+   */
+  select(fields: string[]): this;
+  select(...fields: string[]): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.deselect}
+   */
+  deselect(fields: string[]): this;
+  deselect(...fields: string[]): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.orderBy}
+   */
+  orderBy(field: string, direction?: "asc" | "desc"): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.sortBy}
+   */
+  sortBy(orderBy: Record<string, "asc" | "desc">): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.random}
+   */
+  random(limit: number): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.limit}
+   */
+  limit(limit: number): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.offset}
+   */
+  offset(offset: number): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.skip}
+   */
+  skip(count: number): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.applyFilters}
+   */
+  applyFilters(filters: FilterRules<this>, data: any, options: FilterOptions): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.get}
+   */
+  get(): Promise<T[]>;
+  /**
+   * {@inheritDoc QueryBuilderContract.first}
+   */
+  first(): Promise<T | null>;
+  /**
+   * {@inheritDoc QueryBuilderContract.count}
+   */
+  count(): Promise<number>;
+  /**
+   * {@inheritDoc QueryBuilderContract.paginate}
+   */
+  paginate(page: number, limit: number): Promise<PaginationResult<T>>;
+  /**
+   * {@inheritDoc QueryBuilderContract.cursorPaginate}
+   *
+   * NOTE: This method is a pure executor.
+   * The caller (e.g. RepositoryManager._listImpl) is responsible for applying
+   * the cursor WHERE condition and ORDER BY BEFORE calling this method,
+   * so that the cursor column is always the primary sort key.
+   */
+  cursorPaginate(options: CursorPaginationOptions): Promise<CursorPaginationResult<T>>;
+  /**
+   * {@inheritDoc QueryBuilderContract.chunk}
+   */
+  chunk(size: number, callback: ChunkCallback<T>): Promise<void>;
+  /**
+   * {@inheritDoc QueryBuilderContract.with}
+   */
+  with(relation: string): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.joinWith}
+   */
+  joinWith(...relations: string[]): this;
+  /**
+   * {@inheritDoc QueryBuilderContract.clone}
+   */
+  clone(): this;
+}
+//#endregion
+export { CascadeQueryBuilder };
+//# sourceMappingURL=cascade-query-builder.d.mts.map

package/esm/repositories/adapters/cascade/cascade-query-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-query-builder.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"mappings":";;;;;;;;;AAsBA;;cAAa,mBAAA,WAA8B,KAAA,aAAkB,sBAAA,CAAqB,CAAA;EAAA,QAKrD,KAAA;EALqD;;;;cAKrD,KAAA,EAAO,oBAAA,CAA4B,CAAA;EA8CtB;;;EArCjC,KAAA,CAAM,KAAA,UAAe,KAAA;EACrB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC9C,KAAA,CAAM,UAAA,EAAY,MAAA;EAClB,KAAA,CAAM,QAAA,GAAW,KAAA;EAiOM;;;EAvMvB,MAAA,CAAA;EAqNqD;;;EA9MrD,OAAA,CAAQ,KAAA,UAAe,KAAA;EACvB,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAChD,OAAA,CAAQ,UAAA,EAAY,MAAA;EAgQ8B;;;EA5OlD,OAAA,CAAQ,KAAA,UAAe,MAAA;EAxEiD;;;EAgFxE,UAAA,CAAW,KAAA,UAAe,MAAA;EAhF0B;;;EAwFpD,SAAA,CAAU,KAAA;EAnFiB;;;EA2F3B,YAAA,CAAa,KAAA;EAlFP;;;EA0FN,YAAA,CAAa,KAAA,UAAe,KAAA;EAzFG;;;EAiG/B,SAAA,CAAU,KAAA,UAAe,OAAA;EAhGP;;;EAwGlB,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;EAvGzC;;;EAmHN,MAAA,CAAO,MAAA;EACP,MAAA,CAAA,GAAU,MAAA;EAlFV;;;EA+FA,QAAA,CAAS,MAAA;EACT,QAAA,CAAA,GAAY,MAAA;EA/FZ;;;EAgHA,OAAA,CAAQ,KAAA,UAAe,SAAA;EA5Ff;;;EAoGR,MAAA,CAAO,OAAA,EAAS,MAAA;EA5FU;;;EAuG1B,MAAA,CAAO,KAAA;EAvFM;;;EAmGb,KAAA,CAAM,KAAA;EAnFN;;;EA2FA,MAAA,CAAO,MAAA;EAnFG;;;EA2FV,IAAA,CAAK,KAAA;EA/EE;;;EA0FP,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;EA5EpD;;;EAyFH,GAAA,CAAA,GAAO,OAAA,CAAQ,CAAA;EAvEb;;;EA8EF,KAAA,CAAA,GAAS,OAAA,CAAQ,CAAA;EAtEhB;;;EA6ED,KAAA,CAAA,GAAS,OAAA;EAtDT;;;EA6DA,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA7CjE;;;;;;;;EAkEC,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EA5CN;;;EAyEf,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EA3DjD;;;EAsEN,IAAA,CAAK,QAAA;EA/DwB;;;EAuE7B,QAAA,CAAA,GAAY,SAAA;EAlDN;;;EAmEN,KAAA,CAAA;AAAA"}

package/esm/repositories/adapters/cascade/cascade-query-builder.mjs

@@ -0,0 +1,238 @@
+import { FilterApplicator } from "./filter-applicator.mjs";
+
+//#region ../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts
+/**
+* Cascade query builder wrapper
+* Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract
+*
+* @template T - The model instance type
+*/
+var CascadeQueryBuilder = class CascadeQueryBuilder {
+	/**
+	* Constructor
+	* @param query - Cascade-Next QueryBuilder instance
+	*/
+	constructor(query) {
+		this.query = query;
+	}
+	where(fieldOrConditionsOrCallback, operatorOrValue, value) {
+		if (typeof fieldOrConditionsOrCallback === "function") fieldOrConditionsOrCallback(this);
+		else if (typeof fieldOrConditionsOrCallback === "object") this.query.where(fieldOrConditionsOrCallback);
+		else if (value !== void 0) this.query.where(fieldOrConditionsOrCallback, operatorOrValue, value);
+		else this.query.where(fieldOrConditionsOrCallback, operatorOrValue);
+		return this;
+	}
+	/**
+	* Pretty display the query in terminal
+	*/
+	pretty() {
+		return this.query.pretty();
+	}
+	orWhere(fieldOrConditions, operatorOrValue, value) {
+		if (typeof fieldOrConditions === "object") this.query.orWhere(fieldOrConditions);
+		else if (value !== void 0) this.query.orWhere(fieldOrConditions, operatorOrValue, value);
+		else this.query.orWhere(fieldOrConditions, operatorOrValue);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.whereIn}
+	*/
+	whereIn(field, values) {
+		this.query.whereIn(field, values);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.whereNotIn}
+	*/
+	whereNotIn(field, values) {
+		this.query.whereNotIn(field, values);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.whereNull}
+	*/
+	whereNull(field) {
+		this.query.whereNull(field);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.whereNotNull}
+	*/
+	whereNotNull(field) {
+		this.query.whereNotNull(field);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.whereBetween}
+	*/
+	whereBetween(field, range) {
+		this.query.whereBetween(field, range);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.whereLike}
+	*/
+	whereLike(field, pattern) {
+		this.query.whereLike(field, pattern);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.similarTo}
+	*/
+	similarTo(column, embedding, alias) {
+		this.query.similarTo(column, embedding, alias);
+		return this;
+	}
+	select(...fields) {
+		if (Array.isArray(fields[0])) this.query.select(fields[0]);
+		else this.query.select(fields);
+		return this;
+	}
+	deselect(...fields) {
+		if (Array.isArray(fields[0])) this.query.deselect(fields[0]);
+		else this.query.deselect(fields);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.orderBy}
+	*/
+	orderBy(field, direction = "asc") {
+		this.query.orderBy(field, direction);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.sortBy}
+	*/
+	sortBy(orderBy) {
+		for (const [field, direction] of Object.entries(orderBy)) this.query.orderBy(field, direction);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.random}
+	*/
+	random(limit) {
+		this.query.orderByRandom(limit);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.limit}
+	*/
+	limit(limit) {
+		this.query.limit(limit);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.offset}
+	*/
+	offset(offset) {
+		this.query.offset(offset);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.skip}
+	*/
+	skip(count) {
+		return this.offset(count);
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.applyFilters}
+	*/
+	applyFilters(filters, data, options) {
+		new FilterApplicator().apply(this.query, filters, data, options);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.get}
+	*/
+	async get() {
+		return this.query.get();
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.first}
+	*/
+	async first() {
+		return this.query.first();
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.count}
+	*/
+	async count() {
+		return this.query.count();
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.paginate}
+	*/
+	async paginate(page, limit) {
+		const result = await this.query.paginate({
+			limit,
+			page
+		});
+		return {
+			data: result.data,
+			pagination: {
+				...result.pagination,
+				result: result.data.length
+			}
+		};
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.cursorPaginate}
+	*
+	* NOTE: This method is a pure executor.
+	* The caller (e.g. RepositoryManager._listImpl) is responsible for applying
+	* the cursor WHERE condition and ORDER BY BEFORE calling this method,
+	* so that the cursor column is always the primary sort key.
+	*/
+	async cursorPaginate(options) {
+		const { limit, cursor, cursorColumn = "id" } = options;
+		this.limit(limit + 1);
+		const results = await this.get();
+		const hasMore = results.length > limit;
+		const documents = hasMore ? results.slice(0, limit) : results;
+		const nextCursor = hasMore ? documents[documents.length - 1][cursorColumn] : void 0;
+		return {
+			data: documents,
+			pagination: {
+				limit,
+				result: documents.length,
+				hasMore,
+				nextCursor,
+				prevCursor: cursor
+			}
+		};
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.chunk}
+	*/
+	async chunk(size, callback) {
+		return this.query.chunk(size, callback);
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.with}
+	*/
+	with(relation) {
+		this.query.with(relation);
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.joinWith}
+	*/
+	joinWith(...relations) {
+		if (this.query.joinWith) this.query.joinWith(...relations);
+		else {
+			console.warn("[Repository] joinWith is not supported by the underlying query builder. Falling back to with.");
+			for (const relation of relations) this.query.with(relation);
+		}
+		return this;
+	}
+	/**
+	* {@inheritDoc QueryBuilderContract.clone}
+	*/
+	clone() {
+		return new CascadeQueryBuilder(this.query.clone());
+	}
+};
+
+//#endregion
+export { CascadeQueryBuilder };
+//# sourceMappingURL=cascade-query-builder.mjs.map

package/esm/repositories/adapters/cascade/cascade-query-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-query-builder.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilderContract,\n  Model,\n} from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  FilterOptions,\n  FilterRules,\n  PaginationResult,\n  QueryBuilderContract,\n  WhereOperator,\n} from \"../../contracts\";\nimport { FilterApplicator } from \"./filter-applicator\";\n\n/**\n * Cascade query builder wrapper\n * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract\n *\n * @template T - The model instance type\n */\nexport class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract<T> {\n  /**\n   * Constructor\n   * @param query - Cascade-Next QueryBuilder instance\n   */\n  public constructor(private query: CascadeQueryBuilderContract<T>) {}\n\n  // ============================================================================\n  // WHERE CLAUSES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.where}\n   */\n  public where(field: string, value: any): this;\n  public where(field: string, operator: WhereOperator, value: any): this;\n  public where(conditions: Record<string, any>): this;\n  public where(callback: (query: this) => void): this;\n  public where(\n    fieldOrConditionsOrCallback: string | Record<string, any> | ((query: this) => void),\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditionsOrCallback === \"function\") {\n      // Callback\n      fieldOrConditionsOrCallback(this);\n    } else if (typeof fieldOrConditionsOrCallback === \"object\") {\n      // Object conditions\n      this.query.where(fieldOrConditionsOrCallback);\n    } else if (value !== undefined) {\n      // Field, operator, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue, value);\n    } else {\n      // Field, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * Pretty display the query in terminal\n   */\n  public pretty() {\n    return this.query.pretty();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orWhere}\n   */\n  public orWhere(field: string, value: any): this;\n  public orWhere(field: string, operator: WhereOperator, value: any): this;\n  public orWhere(conditions: Record<string, any>): this;\n  public orWhere(\n    fieldOrConditions: string | Record<string, any>,\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditions === \"object\") {\n      this.query.orWhere(fieldOrConditions);\n    } else if (value !== undefined) {\n      this.query.orWhere(fieldOrConditions, operatorOrValue, value);\n    } else {\n      this.query.orWhere(fieldOrConditions, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereIn}\n   */\n  public whereIn(field: string, values: any[]): this {\n    this.query.whereIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotIn}\n   */\n  public whereNotIn(field: string, values: any[]): this {\n    this.query.whereNotIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNull}\n   */\n  public whereNull(field: string): this {\n    this.query.whereNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotNull}\n   */\n  public whereNotNull(field: string): this {\n    this.query.whereNotNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereBetween}\n   */\n  public whereBetween(field: string, range: [any, any]): this {\n    this.query.whereBetween(field, range);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereLike}\n   */\n  public whereLike(field: string, pattern: string): this {\n    this.query.whereLike(field, pattern);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.similarTo}\n   */\n  public similarTo(column: string, embedding: number[], alias?: string): this {\n    this.query.similarTo(column, embedding, alias);\n    return this;\n  }\n\n  // ============================================================================\n  // SELECT / PROJECTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.select}\n   */\n  public select(fields: string[]): this;\n  public select(...fields: string[]): this;\n  public select(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.select(fields[0]);\n    } else {\n      this.query.select(fields);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.deselect}\n   */\n  public deselect(fields: string[]): this;\n  public deselect(...fields: string[]): this;\n  public deselect(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.deselect(fields[0]);\n    } else {\n      this.query.deselect(fields);\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ORDERING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orderBy}\n   */\n  public orderBy(field: string, direction: \"asc\" | \"desc\" = \"asc\"): this {\n    this.query.orderBy(field, direction);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sortBy}\n   */\n  public sortBy(orderBy: Record<string, \"asc\" | \"desc\">): this {\n    // Apply each order clause individually\n    for (const [field, direction] of Object.entries(orderBy)) {\n      this.query.orderBy(field, direction);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.random}\n   */\n  public random(limit: number): this {\n    this.query.orderByRandom(limit);\n    return this;\n  }\n\n  // ============================================================================\n  // LIMITING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.limit}\n   */\n  public limit(limit: number): this {\n    this.query.limit(limit);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.offset}\n   */\n  public offset(offset: number): this {\n    this.query.offset(offset);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.skip}\n   */\n  public skip(count: number): this {\n    return this.offset(count);\n  }\n\n  // ============================================================================\n  // FILTERING (Repository-specific)\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.applyFilters}\n   */\n  public applyFilters(filters: FilterRules<this>, data: any, options: FilterOptions): this {\n    const applicator = new FilterApplicator();\n    applicator.apply(this.query as any, filters, data, options);\n    return this;\n  }\n\n  // ============================================================================\n  // EXECUTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.get}\n   */\n  public async get(): Promise<T[]> {\n    return this.query.get();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.first}\n   */\n  public async first(): Promise<T | null> {\n    return this.query.first();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.count}\n   */\n  public async count(): Promise<number> {\n    return this.query.count();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    const result = await this.query.paginate({ limit, page });\n\n    // Convert Cascade-Next pagination to repository format\n    return {\n      data: result.data,\n      pagination: {\n        ...result.pagination,\n        result: result.data.length,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.cursorPaginate}\n   *\n   * NOTE: This method is a pure executor.\n   * The caller (e.g. RepositoryManager._listImpl) is responsible for applying\n   * the cursor WHERE condition and ORDER BY BEFORE calling this method,\n   * so that the cursor column is always the primary sort key.\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    const { limit, cursor, cursorColumn = \"id\" } = options;\n\n    // Fetch limit + 1 to detect whether more pages exist\n    this.limit(limit + 1);\n\n    const results = await this.get();\n    const hasMore = results.length > limit;\n\n    // Drop the extra record used for the hasMore check\n    const documents = hasMore ? results.slice(0, limit) : results;\n\n    const nextCursor = hasMore ? (documents[documents.length - 1] as any)[cursorColumn] : undefined;\n\n    return {\n      data: documents,\n      pagination: {\n        limit,\n        result: documents.length,\n        hasMore,\n        nextCursor,\n        prevCursor: cursor,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query.chunk(size, callback);\n  }\n\n  // ============================================================================\n  // UTILITIES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.with}\n   */\n  public with(relation: string): this {\n    this.query.with(relation);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.joinWith}\n   */\n  public joinWith(...relations: string[]): this {\n    if (this.query.joinWith) {\n      this.query.joinWith(...relations);\n    } else {\n      console.warn(\n        \"[Repository] joinWith is not supported by the underlying query builder. Falling back to with.\",\n      );\n      for (const relation of relations) {\n        this.query.with(relation);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.clone}\n   */\n  public clone(): this {\n    return new CascadeQueryBuilder(this.query.clone()) as this;\n  }\n}\n"],"mappings":"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"}