@warlock.js/core 4.3.0 → 4.5.0

package/esm/repositories/adapters/cascade/filter-applicator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/filter-applicator.ts"],"sourcesContent":["import { isEmpty } from \"@mongez/supportive-is\";\nimport type {\n  QueryBuilderContract as CascadeQueryBuilder,\n  QueryBuilderContract,\n} from \"@warlock.js/cascade\";\nimport type { FilterOptions, FilterRule, FilterRules } from \"../../contracts\";\n\n/**\n * Applies repository filters to a Cascade-Next query builder\n * Translates repository filter rules into Cascade query builder method calls\n */\nexport class FilterApplicator {\n  /**\n   * Apply filters to a Cascade query builder\n   *\n   * @param query - Cascade query builder instance\n   * @param filters - Filter structure defining how to filter\n   * @param data - Data containing filter values\n   * @param options - Additional filter options (date formats, etc.)\n   */\n  public apply(\n    query: CascadeQueryBuilder<any>,\n    filters: FilterRules,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    for (const key in filters) {\n      const value = data[key];\n      if (value === undefined) continue;\n\n      const rule = this.parseFilterRule(key, filters[key]);\n      this.applyFilterRule(query, rule, value, data, options);\n    }\n  }\n\n  /**\n   * Parse a filter rule into a structured format\n   */\n  private parseFilterRule(key: string, rule: FilterRule) {\n    // Handle custom function\n    if (typeof rule === \"function\") {\n      return { type: \"function\", fn: rule, column: key };\n    }\n\n    // Handle array format: [\"operator\"] or [\"operator\", \"column\"] or [\"operator\", [\"col1\", \"col2\"]]\n    if (Array.isArray(rule)) {\n      const [operator, target] = rule;\n\n      if (target === undefined) {\n        return { type: operator, column: key, columns: undefined };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target };\n      }\n\n      return { type: operator, column: target, columns: undefined };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined };\n  }\n\n  /**\n   * Apply a single filter rule to the query\n   */\n  private applyFilterRule(\n    query: CascadeQueryBuilder<any>,\n    rule: any,\n    value: any,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // 1. Custom function filter\n    if (rule.type === \"function\") {\n      rule.fn(value, query, data);\n      return;\n    }\n\n    // 2. Predefined filter types\n    const handler = this.getFilterHandler(rule.type);\n    if (handler) {\n      handler.call(this, query, rule.column, rule.columns, value, options);\n      return;\n    }\n\n    // 3. Standard where operators\n    this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value);\n  }\n\n  /**\n   * Get filter handler for predefined types\n   */\n  private getFilterHandler(type: string): Function | undefined {\n    const handlers: Record<string, Function> = {\n      // Boolean filters\n      bool: this.handleBoolean,\n      boolean: this.handleBoolean,\n\n      // Numeric filters\n      int: this.handleInt,\n      integer: this.handleInt,\n      \"!int\": this.handleNotInt,\n      \"int>\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">\"),\n      \"int>=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">=\"),\n      \"int<\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<\"),\n      \"int<=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<=\"),\n      inInt: this.handleInInt,\n      number: this.handleNumber,\n      inNumber: this.handleInNumber,\n      float: this.handleFloat,\n      double: this.handleFloat,\n      inFloat: this.handleInNumber,\n\n      // Null filters\n      null: this.handleNull,\n      notNull: this.handleNotNull,\n      \"!null\": this.handleNotNull,\n\n      // Date filters\n      date: this.handleDate,\n      \"date>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">\"),\n      \"date>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">=\"),\n      \"date<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<\"),\n      \"date<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<=\"),\n      dateBetween: this.handleDateBetween,\n      inDate: this.handleInDate,\n\n      // DateTime filters\n      dateTime: this.handleDateTime,\n      \"dateTime>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">\"),\n      \"dateTime>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">=\"),\n      \"dateTime<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<\"),\n      \"dateTime<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<=\"),\n      dateTimeBetween: this.handleDateTimeBetween,\n      inDateTime: this.handleInDateTime,\n\n      // Scope filter - applies local scope when value is truthy\n      scope: this.handleScope,\n\n      // With filter - eager-loads a relation when value is truthy\n      with: this.handleWith,\n\n      // JoinWith filter - eager-loads a relation via SQL JOIN when value is truthy\n      joinWith: this.handleJoinWith,\n\n      // Vector similarity search — calls similarTo(column, embedding[])\n      similarTo: this.handleSimilarTo,\n    };\n\n    return handlers[type];\n  }\n\n  /**\n   * Apply standard where operators\n   */\n  private applyWhereOperator(\n    query: QueryBuilderContract,\n    operator: string,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ): void {\n    // Handle \"in\" prefix for array values\n    if (operator.startsWith(\"in\") && operator !== \"int\" && !Array.isArray(value)) {\n      value = [value];\n    }\n\n    // Single column\n    if (column) {\n      switch (operator) {\n        case \"=\":\n          query.where(column, value);\n          break;\n        case \"!=\":\n        case \"<>\":\n          query.where(column, \"!=\", value);\n          break;\n        case \">\":\n        case \">=\":\n        case \"<\":\n        case \"<=\":\n          query.where(column, operator, value);\n          break;\n        case \"in\":\n          query.whereIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"not in\":\n          query.whereNotIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"like\":\n          query.whereLike(column, value);\n          break;\n        case \"not like\":\n          query.whereNotLike(column, value);\n          break;\n        case \"between\":\n          query.whereBetween(column, value);\n          break;\n        case \"not between\":\n          query.whereNotBetween(column, value);\n          break;\n      }\n    }\n    // Multiple columns (OR condition)\n    else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = value;\n      }\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // BOOLEAN FILTERS\n  // ============================================================================\n\n  private handleBoolean(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const boolValue =\n      value === \"true\" || value === true || value === 1 || value === \"1\" || !isEmpty(value);\n    if (column) {\n      query.where(column, boolValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = boolValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // NUMERIC FILTERS\n  // ============================================================================\n  private handleInt(query: QueryBuilderContract, column?: string, columns?: string[], value?: any) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, intValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = intValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleNotInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, \"!=\", intValue);\n    } else if (columns) {\n      // Use multiple orWhere calls for OR logic across columns\n      for (const col of columns) {\n        query.orWhere(col, \"!=\", intValue);\n      }\n    }\n  }\n\n  private handleIntComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    operator: string,\n  ) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, operator, intValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere(col, operator, intValue);\n      }\n    }\n  }\n\n  private handleInInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => parseInt(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, values));\n      }\n    }\n  }\n\n  private handleNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const numValue = Number(value);\n    if (column) {\n      query.where(column, numValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = numValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleInNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => Number(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, values));\n      }\n    }\n  }\n\n  private handleFloat(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const floatValue = parseFloat(value);\n    if (column) {\n      query.where(column, floatValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = floatValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // NULL FILTERS\n  // ============================================================================\n\n  private handleNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNull(column);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere({ [col]: null });\n      }\n    }\n  }\n\n  private handleNotNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNotNull(column);\n    } else if (columns) {\n      // Use whereNotNull for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereNotNull(col));\n      }\n    }\n  }\n\n  // ============================================================================\n  // SCOPE FILTER\n  // ============================================================================\n\n  /**\n   * Handle scope filter - applies local scope and passes the filter value.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   active: \"scope\",           // Uses the filter key as scope name\n   *   isAdmin: [\"scope\", \"admin\"] // Uses custom scope name\n   * }\n   * ```\n   *\n   * When list({ active: true }) is called, it will call query.scope(\"active\", true)\n   * When list({ status: \"pending\" }) is called, it will call query.scope(\"status\", \"pending\")\n   */\n  private handleScope(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    // column holds the scope name (either the filter key or custom name from array format)\n    if (column) {\n      query.scope(column, value);\n    }\n  }\n\n  // ============================================================================\n  // WITH (EAGER LOAD) FILTER\n  // ============================================================================\n\n  /**\n   * Handle with filter - eager-loads a relation when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"with\", \"ai_model\"],         // load single relation\n   *   with_all:      [\"with\", [\"ai_model\", \"unit\"]] // load multiple relations\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.with(\"ai_model\")\n   */\n  private handleWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    // Load a single named relation\n    if (column) {\n      if (query.with) {\n        query.with(column);\n      }\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      for (const relation of columns) {\n        if (query.with) {\n          query.with(relation);\n        }\n      }\n    }\n  }\n\n  /**\n   * Handle joinWith filter - eager-loads a relation via SQL JOIN when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"joinWith\", \"ai_model\"],         // load single relation via join\n   *   with_all:      [\"joinWith\", [\"ai_model\", \"unit\"]] // load multiple relations via join\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.joinWith(\"ai_model\")\n   */\n  private handleJoinWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    if (!query.joinWith) {\n      console.warn(\n        \"[Repository] joinWith is not supported by the query builder. using with instead.\",\n      );\n      return this.handleWith(query, column, columns, value);\n    }\n\n    // Load a single named relation\n    if (column) {\n      query.joinWith(column);\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      query.joinWith(...columns);\n    }\n  }\n\n  // ============================================================================\n  // VECTOR FILTER\n  // ============================================================================\n\n  /**\n   * Handle similarTo filter — performs vector similarity search.\n   *\n   * The filter value must be a `number[]` (pre-computed embedding).\n   * Delegates to `query.similarTo(column, embedding)` which is handled\n   * driver-specifically (pgvector or MongoDB Atlas $vectorSearch).\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   organization_id: \"=\",\n   *   embedding: \"similarTo\",\n   * }\n   * ```\n   *\n   * Then in the service:\n   * ```typescript\n   * await vectorsRepository.list({ embedding: queryEmbedding, organization_id: orgId });\n   * ```\n   */\n  private handleSimilarTo(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    if (!column || !Array.isArray(value)) return;\n\n    // Cast to any: Cascade's internal QueryBuilderContract still uses nearestTo;\n    // our wrapper (CascadeQueryBuilder.similarTo) delegates to it correctly.\n    (query as any).similarTo(column, value);\n  }\n\n  // ============================================================================\n  // DATE FILTERS\n  // ============================================================================\n\n  private handleDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      query.whereDate(column, dateValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereDate(col, dateValue));\n      }\n    }\n  }\n\n  private handleDateComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      if (operator === \">\" || operator === \">=\") {\n        query.whereDateAfter(column, dateValue);\n      } else {\n        query.whereDateBefore(column, dateValue);\n      }\n    } else if (columns) {\n      for (const col of columns) {\n        if (operator === \">\" || operator === \">=\") {\n          query.orWhere((q: any) => q.whereDateAfter(col, dateValue));\n        } else {\n          query.orWhere((q: any) => q.whereDateBefore(col, dateValue));\n        }\n      }\n    }\n  }\n\n  private handleDateBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDate(v, options?.dateFormat));\n    if (column) {\n      query.whereDateBetween(column, [start, end]);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereDateBetween(col, [start, end]));\n      }\n    }\n  }\n\n  private handleInDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDate(v, options?.dateFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, dates));\n      }\n    }\n  }\n\n  // ============================================================================\n  // DATETIME FILTERS\n  // ============================================================================\n\n  private handleDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, dateValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = dateValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleDateTimeComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, operator, dateValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere(col, operator, dateValue);\n      }\n    }\n  }\n\n  private handleDateTimeBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDateTime(v, options?.dateTimeFormat));\n    if (column) {\n      query.whereBetween(column, [start, end]);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereBetween(col, [start, end]));\n      }\n    }\n  }\n\n  private handleInDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDateTime(v, options?.dateTimeFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, dates));\n      }\n    }\n  }\n\n  // ============================================================================\n  // DATE PARSING UTILITIES\n  // ============================================================================\n\n  /**\n   * Parse date string to Date object\n   * TODO: Implement proper date parsing with format support\n   */\n  private parseDate(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n    return new Date(value);\n  }\n\n  /**\n   * Parse datetime string to Date object\n   * TODO: Implement proper datetime parsing with format support\n   */\n  private parseDateTime(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n    return new Date(value);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/filter-applicator.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilder,\n  QueryBuilderContract,\n} from \"@warlock.js/cascade\";\nimport type { FilterOptions, FilterRule, FilterRules } from \"../../contracts\";\n\n/**\n * Applies repository filters to a Cascade-Next query builder\n * Translates repository filter rules into Cascade query builder method calls\n */\nexport class FilterApplicator {\n  /**\n   * Apply filters to a Cascade query builder\n   *\n   * @param query - Cascade query builder instance\n   * @param filters - Filter structure defining how to filter\n   * @param data - Data containing filter values\n   * @param options - Additional filter options (date formats, etc.)\n   */\n  public apply(\n    query: CascadeQueryBuilder<any>,\n    filters: FilterRules,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    for (const key in filters) {\n      const value = data[key];\n      if (value === undefined) continue;\n\n      const rule = this.parseFilterRule(key, filters[key]);\n      this.applyFilterRule(query, rule, value, data, options);\n    }\n  }\n\n  /**\n   * Parse a filter rule into a structured format\n   */\n  private parseFilterRule(key: string, rule: FilterRule) {\n    // Handle custom function\n    if (typeof rule === \"function\") {\n      return { type: \"function\", fn: rule, column: key };\n    }\n\n    // Handle array format: [\"operator\"] or [\"operator\", \"column\"] or [\"operator\", [\"col1\", \"col2\"]]\n    if (Array.isArray(rule)) {\n      const [operator, target] = rule;\n\n      if (target === undefined) {\n        return { type: operator, column: key, columns: undefined };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target };\n      }\n\n      return { type: operator, column: target, columns: undefined };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined };\n  }\n\n  /**\n   * Apply a single filter rule to the query\n   */\n  private applyFilterRule(\n    query: CascadeQueryBuilder<any>,\n    rule: any,\n    value: any,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // 1. Custom function filter\n    if (rule.type === \"function\") {\n      rule.fn(value, query, data);\n      return;\n    }\n\n    // 2. Predefined filter types\n    const handler = this.getFilterHandler(rule.type);\n    if (handler) {\n      handler.call(this, query, rule.column, rule.columns, value, options);\n      return;\n    }\n\n    // 3. Standard where operators\n    this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value);\n  }\n\n  /**\n   * Get filter handler for predefined types\n   */\n  private getFilterHandler(type: string): Function | undefined {\n    const handlers: Record<string, Function> = {\n      // Boolean filters\n      bool: this.handleBoolean,\n      boolean: this.handleBoolean,\n\n      // Numeric filters\n      int: this.handleInt,\n      integer: this.handleInt,\n      \"!int\": this.handleNotInt,\n      \"int>\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">\"),\n      \"int>=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">=\"),\n      \"int<\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<\"),\n      \"int<=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<=\"),\n      inInt: this.handleInInt,\n      number: this.handleNumber,\n      inNumber: this.handleInNumber,\n      float: this.handleFloat,\n      double: this.handleFloat,\n      inFloat: this.handleInNumber,\n\n      // Null filters\n      null: this.handleNull,\n      notNull: this.handleNotNull,\n      \"!null\": this.handleNotNull,\n\n      // Date filters\n      date: this.handleDate,\n      \"date>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">\"),\n      \"date>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">=\"),\n      \"date<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<\"),\n      \"date<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<=\"),\n      dateBetween: this.handleDateBetween,\n      inDate: this.handleInDate,\n\n      // DateTime filters\n      dateTime: this.handleDateTime,\n      \"dateTime>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">\"),\n      \"dateTime>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">=\"),\n      \"dateTime<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<\"),\n      \"dateTime<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<=\"),\n      dateTimeBetween: this.handleDateTimeBetween,\n      inDateTime: this.handleInDateTime,\n\n      // Scope filter - applies local scope when value is truthy\n      scope: this.handleScope,\n\n      // With filter - eager-loads a relation when value is truthy\n      with: this.handleWith,\n\n      // JoinWith filter - eager-loads a relation via SQL JOIN when value is truthy\n      joinWith: this.handleJoinWith,\n\n      // Vector similarity search — calls similarTo(column, embedding[])\n      similarTo: this.handleSimilarTo,\n    };\n\n    return handlers[type];\n  }\n\n  /**\n   * Apply standard where operators\n   */\n  private applyWhereOperator(\n    query: QueryBuilderContract,\n    operator: string,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ): void {\n    // Handle \"in\" prefix for array values\n    if (operator.startsWith(\"in\") && operator !== \"int\" && !Array.isArray(value)) {\n      value = [value];\n    }\n\n    // Single column\n    if (column) {\n      switch (operator) {\n        case \"=\":\n          query.where(column, value);\n          break;\n        case \"!=\":\n        case \"<>\":\n          query.where(column, \"!=\", value);\n          break;\n        case \">\":\n        case \">=\":\n        case \"<\":\n        case \"<=\":\n          query.where(column, operator, value);\n          break;\n        case \"in\":\n          query.whereIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"not in\":\n          query.whereNotIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"like\":\n          query.whereLike(column, value);\n          break;\n        case \"not like\":\n          query.whereNotLike(column, value);\n          break;\n        case \"between\":\n          query.whereBetween(column, value);\n          break;\n        case \"not between\":\n          query.whereNotBetween(column, value);\n          break;\n      }\n    }\n    // Multiple columns (OR condition)\n    else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = value;\n      }\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // BOOLEAN FILTERS\n  // ============================================================================\n\n  /**\n   * Coerce a filter value to a boolean.\n   *\n   * Recognized truthy forms: `true`, `1`, `\"true\"`, `\"1\"`.\n   * Recognized falsy forms:  `false`, `0`, `\"false\"`, `\"0\"`.\n   * Anything else falls back to `Boolean(value)`.\n   *\n   * NOTE: this intentionally does NOT treat \"non-empty\" as true — the previous\n   * `|| !isEmpty(value)` fallback coerced `false`/`0` to `true`, inverting the\n   * filter for explicitly-false values.\n   */\n  private coerceBoolean(value: any): boolean {\n    if (value === true || value === 1 || value === \"true\" || value === \"1\") {\n      return true;\n    }\n\n    if (value === false || value === 0 || value === \"false\" || value === \"0\") {\n      return false;\n    }\n\n    return Boolean(value);\n  }\n\n  private handleBoolean(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const boolValue = this.coerceBoolean(value);\n    if (column) {\n      query.where(column, boolValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = boolValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // NUMERIC FILTERS\n  // ============================================================================\n  private handleInt(query: QueryBuilderContract, column?: string, columns?: string[], value?: any) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, intValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = intValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleNotInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, \"!=\", intValue);\n    } else if (columns) {\n      // Use multiple orWhere calls for OR logic across columns\n      for (const col of columns) {\n        query.orWhere(col, \"!=\", intValue);\n      }\n    }\n  }\n\n  private handleIntComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    operator: string,\n  ) {\n    const intValue = parseInt(value);\n    if (column) {\n      query.where(column, operator, intValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere(col, operator, intValue);\n      }\n    }\n  }\n\n  private handleInInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => parseInt(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, values));\n      }\n    }\n  }\n\n  private handleNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const numValue = Number(value);\n    if (column) {\n      query.where(column, numValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = numValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleInNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => Number(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, values));\n      }\n    }\n  }\n\n  private handleFloat(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const floatValue = parseFloat(value);\n    if (column) {\n      query.where(column, floatValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = floatValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  // ============================================================================\n  // NULL FILTERS\n  // ============================================================================\n\n  private handleNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNull(column);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere({ [col]: null });\n      }\n    }\n  }\n\n  private handleNotNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNotNull(column);\n    } else if (columns) {\n      // Use whereNotNull for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereNotNull(col));\n      }\n    }\n  }\n\n  // ============================================================================\n  // SCOPE FILTER\n  // ============================================================================\n\n  /**\n   * Handle scope filter - applies local scope and passes the filter value.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   active: \"scope\",           // Uses the filter key as scope name\n   *   isAdmin: [\"scope\", \"admin\"] // Uses custom scope name\n   * }\n   * ```\n   *\n   * When list({ active: true }) is called, it will call query.scope(\"active\", true)\n   * When list({ status: \"pending\" }) is called, it will call query.scope(\"status\", \"pending\")\n   */\n  private handleScope(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    // column holds the scope name (either the filter key or custom name from array format)\n    if (column) {\n      query.scope(column, value);\n    }\n  }\n\n  // ============================================================================\n  // WITH (EAGER LOAD) FILTER\n  // ============================================================================\n\n  /**\n   * Handle with filter - eager-loads a relation when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"with\", \"ai_model\"],         // load single relation\n   *   with_all:      [\"with\", [\"ai_model\", \"unit\"]] // load multiple relations\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.with(\"ai_model\")\n   */\n  private handleWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    // Load a single named relation\n    if (column) {\n      if (query.with) {\n        query.with(column);\n      }\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      for (const relation of columns) {\n        if (query.with) {\n          query.with(relation);\n        }\n      }\n    }\n  }\n\n  /**\n   * Handle joinWith filter - eager-loads a relation via SQL JOIN when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"joinWith\", \"ai_model\"],         // load single relation via join\n   *   with_all:      [\"joinWith\", [\"ai_model\", \"unit\"]] // load multiple relations via join\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.joinWith(\"ai_model\")\n   */\n  private handleJoinWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    if (!query.joinWith) {\n      console.warn(\n        \"[Repository] joinWith is not supported by the query builder. using with instead.\",\n      );\n      return this.handleWith(query, column, columns, value);\n    }\n\n    // Load a single named relation\n    if (column) {\n      query.joinWith(column);\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      query.joinWith(...columns);\n    }\n  }\n\n  // ============================================================================\n  // VECTOR FILTER\n  // ============================================================================\n\n  /**\n   * Handle similarTo filter — performs vector similarity search.\n   *\n   * The filter value must be a `number[]` (pre-computed embedding).\n   * Delegates to `query.similarTo(column, embedding)` which is handled\n   * driver-specifically (pgvector or MongoDB Atlas $vectorSearch).\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   organization_id: \"=\",\n   *   embedding: \"similarTo\",\n   * }\n   * ```\n   *\n   * Then in the service:\n   * ```typescript\n   * await vectorsRepository.list({ embedding: queryEmbedding, organization_id: orgId });\n   * ```\n   */\n  private handleSimilarTo(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    if (!column || !Array.isArray(value)) return;\n\n    // Cast to any: Cascade's internal QueryBuilderContract still uses nearestTo;\n    // our wrapper (CascadeQueryBuilder.similarTo) delegates to it correctly.\n    (query as any).similarTo(column, value);\n  }\n\n  // ============================================================================\n  // DATE FILTERS\n  // ============================================================================\n\n  private handleDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      query.whereDate(column, dateValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereDate(col, dateValue));\n      }\n    }\n  }\n\n  private handleDateComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      if (operator === \">\" || operator === \">=\") {\n        query.whereDateAfter(column, dateValue);\n      } else {\n        query.whereDateBefore(column, dateValue);\n      }\n    } else if (columns) {\n      for (const col of columns) {\n        if (operator === \">\" || operator === \">=\") {\n          query.orWhere((q: any) => q.whereDateAfter(col, dateValue));\n        } else {\n          query.orWhere((q: any) => q.whereDateBefore(col, dateValue));\n        }\n      }\n    }\n  }\n\n  private handleDateBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDate(v, options?.dateFormat));\n    if (column) {\n      query.whereDateBetween(column, [start, end]);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereDateBetween(col, [start, end]));\n      }\n    }\n  }\n\n  private handleInDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDate(v, options?.dateFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, dates));\n      }\n    }\n  }\n\n  // ============================================================================\n  // DATETIME FILTERS\n  // ============================================================================\n\n  private handleDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, dateValue);\n    } else if (columns) {\n      const conditions: any = {};\n      for (const col of columns) {\n        conditions[col] = dateValue;\n      }\n\n      query.orWhere(conditions);\n    }\n  }\n\n  private handleDateTimeComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, operator, dateValue);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere(col, operator, dateValue);\n      }\n    }\n  }\n\n  private handleDateTimeBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDateTime(v, options?.dateTimeFormat));\n    if (column) {\n      query.whereBetween(column, [start, end]);\n    } else if (columns) {\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereBetween(col, [start, end]));\n      }\n    }\n  }\n\n  private handleInDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDateTime(v, options?.dateTimeFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Use multiple orWhere calls with whereIn for each column\n      for (const col of columns) {\n        query.orWhere((q: any) => q.whereIn(col, dates));\n      }\n    }\n  }\n\n  // ============================================================================\n  // DATE PARSING UTILITIES\n  // ============================================================================\n\n  /**\n   * Parse date string to Date object\n   * TODO: Implement proper date parsing with format support\n   */\n  private parseDate(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n    return new Date(value);\n  }\n\n  /**\n   * Parse datetime string to Date object\n   * TODO: Implement proper datetime parsing with format support\n   */\n  private parseDateTime(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n    return new Date(value);\n  }\n}\n"],"mappings":"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"}

package/esm/repositories/repository.manager.d.mts

@@ -576,6 +576,16 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @protected
    */
   protected cacheKey(key: string | Record<string, any>, moreOptions?: Record<string, any>): string;
+  /**
+   * 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.
+   */
+  protected stableStringify(value: any): string;
   /**
    * Cache a value
    * @param key - Cache key
@@ -659,7 +669,7 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * exported as cleanup
    * export const cleanup = usersRepository.cleanup.bind(usersRepository);
    */
-  $cleanup(): void;
+  $cleanup(): Promise<void>;
   /**
    * Clear all cache for this repository
    * @public

package/esm/repositories/repository.manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/repositories/repository.manager.ts"],"mappings":"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"}
+{"version":3,"file":"repository.manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/repositories/repository.manager.ts"],"mappings":"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"}

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;
 	}
@@ -714,11 +733,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 +771,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 +807,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 +820,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 +850,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 +918,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