@warlock.js/core 4.4.0 → 4.6.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/contracts/index.d.mts

@@ -1,3 +1,3 @@
 import { RepositoryAdapterContract } from "./repository-adapter.contract.mjs";
 import { AllRepositoryOptions, CachedRepositoryOptions, ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, PaginationMode, PaginationResult, RepositoryConfigurations, RepositoryEvent, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, SaveMode, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, WhereOperator } from "./types.mjs";
-import { QueryBuilderContract } from "./query-builder.contract.mjs";
+import { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract } from "./query-builder.contract.mjs";

package/esm/repositories/contracts/query-builder.contract.d.mts

@@ -1,6 +1,29 @@
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterOptions, FilterRules, PaginationResult, WhereOperator } from "./types.mjs";
 
 //#region ../@warlock.js/core/src/repositories/contracts/query-builder.contract.d.ts
+/**
+ * Field(s) to group aggregated results by.
+ *
+ * ORM-agnostic mirror of the underlying driver's group-by payload: a single
+ * field name, a list of field names, or a driver-specific object form.
+ */
+type GroupByFields = string | string[] | Record<string, unknown> | Array<Record<string, unknown>>;
+/**
+ * A single aggregate expression in a `groupBy` / `aggregate` projection.
+ *
+ * Either an abstract, cross-driver expression (e.g. produced by Cascade's
+ * `$agg.count()` / `$agg.sum("amount")`) or a raw, driver-specific shape
+ * (e.g. MongoDB `{ $sum: "$amount" }`, SQL `"SUM(amount)"`). The repository
+ * layer is agnostic to which form is used and forwards it verbatim.
+ */
+type AggregateExpressionInput = string | Record<string, unknown> | unknown;
+/**
+ * Map of result aliases to aggregate expressions.
+ *
+ * @example
+ * { count: $agg.count(), total: $agg.sum("total") }
+ */
+type AggregateExpressions = Record<string, AggregateExpressionInput>;
 /**
  * Query builder contract for building database queries
  * This interface is ORM-agnostic and can be implemented by any data source adapter
@@ -244,6 +267,69 @@ interface QueryBuilderContract<T> {
    * @returns Promise resolving to count
    */
   count(): Promise<number>;
+  /**
+   * Sum a numeric field across all matching records.
+   *
+   * @param field - Field name to sum
+   * @returns Promise resolving to the numeric sum (0 when no records match)
+   *
+   * @example
+   * await query.where("status", "paid").sum("total")
+   */
+  sum(field: string): Promise<number>;
+  /**
+   * Average a numeric field across all matching records.
+   *
+   * @param field - Field name to average
+   * @returns Promise resolving to the numeric average (0 when no records match)
+   *
+   * @example
+   * await query.where("status", "paid").avg("total")
+   */
+  avg(field: string): Promise<number>;
+  /**
+   * Minimum value of a field across all matching records.
+   *
+   * @param field - Field name
+   * @returns Promise resolving to the minimum value (0 when no records match)
+   */
+  min(field: string): Promise<number>;
+  /**
+   * Maximum value of a field across all matching records.
+   *
+   * @param field - Field name
+   * @returns Promise resolving to the maximum value (0 when no records match)
+   */
+  max(field: string): Promise<number>;
+  /**
+   * Group matching records by one or more fields and compute aggregates.
+   *
+   * This is a terminal executor: it applies the grouping + aggregate
+   * projection and returns the grouped rows.
+   *
+   * @template R - Shape of each grouped row
+   * @param fields - Field(s) to group by
+   * @param aggregates - Map of result aliases to aggregate expressions
+   * @returns Promise resolving to the array of grouped rows
+   *
+   * @example
+   * await query.groupBy("status", { count: $agg.count(), total: $agg.sum("total") })
+   */
+  groupBy<R = Record<string, unknown>>(fields: GroupByFields, aggregates: AggregateExpressions): Promise<R[]>;
+  /**
+   * Compute aggregates over the whole matching set as a single summary row.
+   *
+   * Equivalent to a `groupBy` with no group key — every matching record falls
+   * into one group and the aggregate projection is returned as one object.
+   *
+   * @template R - Shape of the summary row
+   * @param aggregates - Map of result aliases to aggregate expressions
+   * @returns Promise resolving to the single summary row (or `null` when empty)
+   *
+   * @example
+   * await query.aggregate({ total: $agg.sum("total"), avg: $agg.avg("total") })
+   */
+  aggregate<R = Record<string, unknown>>(aggregates: AggregateExpressions): Promise<R | null>;
   /**
    * Execute query with pagination
    *
@@ -320,5 +406,5 @@ interface QueryBuilderContract<T> {
   similarTo(column: string, embedding: number[], alias?: string): this;
 }
 //#endregion
-export { QueryBuilderContract };
+export { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract };
 //# sourceMappingURL=query-builder.contract.d.mts.map

package/esm/repositories/contracts/query-builder.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/contracts/query-builder.contract.ts"],"mappings":";;;;;AAgBA;;;;UAAiB,oBAAA;EAqEkB;;;;;;;;;;EAtDjC,KAAA,CAAM,KAAA,UAAe,KAAA;EAyR0B;;;;;;;;;;;EA5Q/C,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAb9C;;;;;;;;;EAwBA,KAAA,CAAM,UAAA,EAAY,MAAA;EAAZ;;;;;;;;;EAWN,KAAA,CAAM,QAAA,GAAW,KAAA;EAmBM;;;;;;;EAVvB,OAAA,CAAQ,KAAA,UAAe,KAAA;EAuCvB;;;;;;;;EA7BA,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAyDpB;;;;;;EAjD5B,OAAA,CAAQ,UAAA,EAAY,MAAA;EA4FpB;;;;;;;;;;EAhFA,OAAA,CAAQ,KAAA,UAAe,MAAA;EA2HhB;;;;;;;EAlHP,UAAA,CAAW,KAAA,UAAe,MAAA;EAsJrB;;;;;;EA9IL,SAAA,CAAU,KAAA;EAuKV;;;;;;EA/JA,YAAA,CAAa,KAAA;EA6KJ;;;;;;;;;;EAjKT,YAAA,CAAa,KAAA,UAAe,KAAA;EAsL8B;;;;;;;;;;EA1K1D,SAAA,CAAU,KAAA,UAAe,OAAA;EA6MZ;;;EAxMb,MAAA;EAqO0B;;;AAAmC;;;;;;EAtN7D,MAAA,CAAO,MAAA;;;;;;;;;;EAWP,MAAA,IAAU,MAAA;;;;;;;EAQV,QAAA,CAAS,MAAA;;;;;;;EAQT,QAAA,IAAY,MAAA;;;;;;;;;;;EAgBZ,OAAA,CAAQ,KAAA,UAAe,SAAA;;;;;;;;;;EAWvB,MAAA,CAAO,OAAA,EAAS,MAAA;;;;;;;EAQhB,MAAA,CAAO,KAAA;;;;;;;EAYP,KAAA,CAAM,KAAA;;;;;;;EAQN,MAAA,CAAO,MAAA;;;;;;;EAQP,IAAA,CAAK,KAAA;;;;;;;;;EAcL,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;;;;;;EAW7D,GAAA,IAAO,OAAA,CAAQ,CAAA;;;;;;EAOf,KAAA,IAAS,OAAA,CAAQ,CAAA;;;;;;EAOjB,KAAA,IAAS,OAAA;;;;;;;;EAST,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;;;;;;;;;;;EAYhE,cAAA,CAAe,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,sBAAA,CAAuB,CAAA;;;;;;;;EASjF,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;;;;;;;;;;EAejD,IAAA,EAAM,QAAA;;;;;;;;;;EAWN,QAAA,KAAa,SAAA;;;;;;EAOb,KAAA;;;;;;;;;;;;;;;;;;;;;EAsBA,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;AAAA"}
+{"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/contracts/query-builder.contract.ts"],"mappings":";;;;;AAgBA;;;;KAAY,aAAA,uBAAoC,MAAA,oBAA0B,KAAA,CAAM,MAAA;;;;;;;;AAAM;KAU1E,wBAAA,YAAoC,MAAM;;;;AAAA;AAQtD;;KAAY,oBAAA,GAAuB,MAAM,SAAS,wBAAA;;AAAwB;AAQ1E;;;;UAAiB,oBAAA;EAqEkB;;;;;;;;;;EAtDjC,KAAA,CAAM,KAAA,UAAe,KAAA;EAsSD;;;;;;;;;;;EAzRpB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAoVkB;;;;;;;;;EAzUhE,KAAA,CAAM,UAAA,EAAY,MAAA;EA8VsC;;;;;;;;;EAnVxD,KAAA,CAAM,QAAA,GAAW,KAAA;EAtB6B;;;;;;;EA+B9C,OAAA,CAAQ,KAAA,UAAe,KAAA;EAAf;;;;;;;;EAUR,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAQxC;;;;;;EAAR,OAAA,CAAQ,UAAA,EAAY,MAAA;EA6BpB;;;;;;;;;;EAjBA,OAAA,CAAQ,KAAA,UAAe,MAAA;EAqEvB;;;;;;;EA5DA,UAAA,CAAW,KAAA,UAAe,MAAA;EAuG1B;;;;;;EA/FA,SAAA,CAAU,KAAA;EAkHH;;;;;;EA1GP,YAAA,CAAa,KAAA;EAoJb;;;;;;;;;;EAxIA,YAAA,CAAa,KAAA,UAAe,KAAA;EA0JX;;;;;;;;;;EA9IjB,SAAA,CAAU,KAAA,UAAe,OAAA;EAmLL;;;EA9KpB,MAAA;EAsMA;;;;;;;;;EAvLA,MAAA,CAAO,MAAA;EAyMG;;;;;;;;;EA9LV,MAAA,IAAU,MAAA;EAuMqC;;;;;;EA/L/C,QAAA,CAAS,MAAA;EA2MwE;;;;;;EAnMjF,QAAA,IAAY,MAAA;EA2NZ;;;;;;;;;;EA3MA,OAAA,CAAQ,KAAA,UAAe,SAAA;;;;;;;;;;EAWvB,MAAA,CAAO,OAAA,EAAS,MAAA;;;;;;;EAQhB,MAAA,CAAO,KAAA;;;;;;;EAYP,KAAA,CAAM,KAAA;;;;;;;EAQN,MAAA,CAAO,MAAA;;;;;;;EAQP,IAAA,CAAK,KAAA;;;;;;;;;EAcL,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;;;;;;EAW7D,GAAA,IAAO,OAAA,CAAQ,CAAA;;;;;;EAOf,KAAA,IAAS,OAAA,CAAQ,CAAA;;;;;;EAOjB,KAAA,IAAS,OAAA;;;;;;;;;;EAWT,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;;;;EAWpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;;;;;;;;;EAgBpB,OAAA,KAAY,MAAA,mBACV,MAAA,EAAQ,aAAA,EACR,UAAA,EAAY,oBAAA,GACX,OAAA,CAAQ,CAAA;;;;;;;;;;;;;;EAeX,SAAA,KAAc,MAAA,mBAAyB,UAAA,EAAY,oBAAA,GAAuB,OAAA,CAAQ,CAAA;;;;;;;;EASlF,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;;;;;;;;;;;EAYhE,cAAA,CAAe,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,sBAAA,CAAuB,CAAA;;;;;;;;EASjF,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;;;;;;;;;;EAejD,IAAA,EAAM,QAAA;;;;;;;;;;EAWN,QAAA,KAAa,SAAA;;;;;;EAOb,KAAA;;;;;;;;;;;;;;;;;;;;;EAsBA,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;AAAA"}

package/esm/repositories/index.d.mts

@@ -1,6 +1,6 @@
 import { RepositoryManager } from "./repository.manager.mjs";
 import { RepositoryAdapterContract } from "./contracts/repository-adapter.contract.mjs";
 import { AllRepositoryOptions, CachedRepositoryOptions, ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, PaginationMode, PaginationResult, RepositoryConfigurations, RepositoryEvent, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, SaveMode, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, WhereOperator } from "./contracts/types.mjs";
-import { QueryBuilderContract } from "./contracts/query-builder.contract.mjs";
+import { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract } from "./contracts/query-builder.contract.mjs";
 import { CascadeAdapter } from "./adapters/cascade/cascade-adapter.mjs";
 import { CascadeQueryBuilder } from "./adapters/cascade/cascade-query-builder.mjs";

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

@@ -1,6 +1,6 @@
 import { RepositoryAdapterContract } from "./contracts/repository-adapter.contract.mjs";
 import { AllRepositoryOptions, ChunkCallback, CursorPaginationResult, FilterRules, PaginationResult, RepositoryOptions, SaveMode, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages } from "./contracts/types.mjs";
-import { QueryBuilderContract } from "./contracts/query-builder.contract.mjs";
+import { AggregateExpressions, GroupByFields, QueryBuilderContract } from "./contracts/query-builder.contract.mjs";
 import { CacheDriver, CacheKey } from "@warlock.js/cache";
 
 //#region ../@warlock.js/core/src/repositories/repository.manager.d.ts
@@ -555,6 +555,104 @@ declare class RepositoryManager<T = unknown, F = Record<string, any>> {
    * @public
    */
   countActiveCached(options?: TypedRepositoryOptions<F>): Promise<number>;
+  /**
+   * 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" });
+   */
+  sum(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  /**
+   * 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
+   */
+  avg(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  /**
+   * 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
+   */
+  min(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  /**
+   * 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
+   */
+  max(field: string, options?: TypedRepositoryOptions<F>): Promise<number>;
+  /**
+   * 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" },
+   * );
+   */
+  groupBy<R = Record<string, unknown>>(fields: GroupByFields, aggregates: AggregateExpressions, options?: TypedRepositoryOptions<F>): Promise<R[]>;
+  /**
+   * 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" },
+   * );
+   */
+  aggregate<R = Record<string, unknown>>(aggregates: AggregateExpressions, options?: TypedRepositoryOptions<F>): Promise<R | null>;
   /**
    * Set cache driver
    * @param driver - Cache driver instance
@@ -576,6 +674,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 +767,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":";;;;;;;;;;;AAuCA;;;;;;;;;;;;;cAAa,iBAAA,kBAAmC,MAAA;EA8Jc;;;;EAAA,UAzJlD,QAAA,GAAW,yBAAA,CAA0B,CAAA;EAuPP;;;;;EAAA,UAhP9B,MAAA;EAqQgD;;;;;EAAA,UA1PhD,QAAA,EAAU,WAAA;EAyR6C;;;;;;;;;;EAAA,cA7QnD,OAAA,IAAW,yBAAA,CAA0B,CAAA;EAsThB;;;;EAAA,UAhSzB,cAAA,EAAgB,OAAA,CAAQ,iBAAA;EAyS2B;;;;EAAA,UAlSnD,mBAAA;EAkT6B;;;;;EAAA,UA3S7B,cAAA;EA6TyB;;;;;EAAA,UAtTzB,aAAA;EAqUqD;;;;EAAA,UA/TrD,IAAA;EAyVyC;;;;;EAAA,UAlVzC,WAAA;EA8V4D;;;;EAAA,UAxV5D,WAAA,EAAa,WAAA;EA0WuC;;;EAAA,UArWpD,eAAA;EAkX0D;;;;cA5WjD,OAAA,GAAU,yBAAA,CAA0B,CAAA;EA6YU;;;EA9X1D,cAAA;EAiYI;;;EA7WJ,YAAA;EA4Z2D;;;;;;;;EAAA,UA7YxD,oBAAA,IAAwB,yBAAA,CAA0B,CAAA;EAwa1B;;;;;EA3Y3B,OAAA;EA2ZyD;;;EAAA,UA7YtD,iBAAA;EAqagD;;;EAAA,UA9ZhD,gBAAA;EAkbwC;;;;;EAza3C,QAAA,IAAQ,oBAAA,CAAA,CAAA;EA2boD;;;;;;EAjb5D,QAAA,CAAS,IAAA,SAAa,CAAA;EAqclB;;;;;EAAA,UA5bD,iBAAA;IAAA;;EAomB4B;;;;;;EAplBzB,IAAA,CAAK,EAAA,oBAAsB,CAAA,GAAI,OAAA,CAAQ,CAAA;EA2nBxC;;;;;;;EAhnBC,MAAA,CAAO,MAAA,UAAgB,KAAA,QAAa,OAAA,CAAQ,CAAA;EAkoBU;;;;;;EAxnBtD,UAAA,CAAW,EAAA,oBAAsB,CAAA,GAAI,OAAA,CAAQ,CAAA;EA6oB5B;;;;;;;EA7nBjB,YAAA,CAAa,MAAA,UAAgB,KAAA,QAAa,OAAA,CAAQ,CAAA;EAgoB5D;;;;;;EAjnBU,KAAA,CAAM,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAuoBtD;;;EA3nBE,OAAA,CAAQ,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAgpBf;;;EAxoB/B,aAAA,CACX,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA;EAuoBA;;;EA/nBU,aAAA,CACX,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA;EAgoBQ;;;EAxnBE,mBAAA,CACX,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA;EAopB4B;;;EA5oBlB,SAAA,CAAU,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EA+pBb;;;EAvpBnC,eAAA,CAAgB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAqrBzB;;;EA7qB7B,eAAA,CAAgB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAwrBL;;;EAhrBjD,qBAAA,CACX,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA;EA8sB0B;;;EAtsBhB,WAAA,CAAY,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAqtBR;;;;;;EAtsBlD,WAAA,CAAY,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAwwBN;;;;;;EA3vBpD,iBAAA,CAAkB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAmyBnC;;;;;;EAtxB7B,IAAA,CAAK,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EA40BlD;;;EAh0BD,UAAA,CAAW,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAk0BnE;;;;;;EAhzBU,UAAA,CAAW,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAw3BrC;;;;;;EA32BpB,gBAAA,CAAiB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,CAAA;EAu9BxD;;;;;;;;;;;;;;;;;;;;;;EAt7BP,IAAA,CAAK,OAAA,GAAU,+BAAA,CAAgC,CAAA,IAAK,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EAC7E,IAAA,CACX,OAAA,EAAS,gCAAA,CAAiC,CAAA,IACzC,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EA0jCC;;;;;;EAAA,QA7iCrB,SAAA;EAkoCkB;;;;;;EAhmCnB,GAAA,CAAI,OAAA,GAAU,yBAAA,CAA0B,CAAA,IAAK,OAAA,CAAQ,CAAA;EAgnC1D;;;;;;;;EA1lCK,UAAA,CACX,OAAA,GAAU,+BAAA,CAAgC,CAAA,IACzC,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EACf,UAAA,CACX,OAAA,EAAS,gCAAA,CAAiC,CAAA,IACzC,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EAjkBa;;;;;;EAilBlC,SAAA,CAAU,OAAA,GAAU,yBAAA,CAA0B,CAAA,IAAK,OAAA,CAAQ,CAAA;EA7hB9D;;;;;;EA2iBG,MAAA,CAAO,MAAA,GAAS,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAzgB/C;;;;;;EAmhBG,YAAA,CAAa,MAAA,GAAS,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAlgB5C;;;;;;EA4gBN,QAAA,CAAS,EAAA,oBAAsB,OAAA;EA/alC;;;;;;EAybG,cAAA,CAAe,EAAA,oBAAsB,OAAA;EA/ZrB;;;;;EAAA,UAwanB,cAAA,CAAe,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,sBAAA,CAAuB,CAAA;EA/Y1C;;;;;EAAA,UAwZlC,OAAA,CAAQ,IAAA,EAAM,iBAAA,GAAoB,sBAAA,CAAuB,CAAA;EAAA,UAIzD,UAAA,CAAW,IAAA,EAAM,oBAAA,GAAuB,yBAAA,CAA0B,CAAA;EAvY/D;;;;;;EAAA,UAqZH,mBAAA,CACR,KAAA,EAAO,oBAAA,CAAqB,CAAA,GAC5B,OAAA,EAAS,iBAAA,GACR,iBAAA;EAxYuC;;;;;;EA6e7B,MAAA,CAAO,IAAA,QAAY,OAAA,CAAQ,CAAA;EA9diB;;;;;;;EAif5C,MAAA,CAAO,EAAA,yBAA2B,IAAA,QAAY,OAAA,CAAQ,CAAA;EA5dvD;;;;;;EA8eC,MAAA,CAAO,EAAA,oBAAsB,OAAA;EApexC;;;;;;;EAufW,UAAA,CAAW,MAAA,OAAa,IAAA,QAAY,OAAA;EApehB;;;;;;EA8epB,UAAA,CAAW,MAAA,QAAc,OAAA;EAteT;;;;;;;;EAsfhB,KAAA,CACX,IAAA,UACA,QAAA,EAAU,aAAA,CAAc,CAAA,GACxB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA;EAzegC;;;;;;;;EA0ftB,WAAA,CACX,IAAA,UACA,QAAA,EAAU,aAAA,CAAc,CAAA,GACxB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA;EAteU;;;;;;;;EAsfA,MAAA,CAAO,OAAA,GAAU,+BAAA,CAAgC,CAAA,IAAK,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EAC/E,MAAA,CACX,OAAA,EAAS,gCAAA,CAAiC,CAAA,IACzC,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EA5emC;;;;;;;;EA8fxD,MAAA,CAAO,OAAA,GAAU,+BAAA,CAAgC,CAAA,IAAK,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EAC/E,MAAA,CACX,OAAA,EAAS,gCAAA,CAAiC,CAAA,IACzC,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EAxeuB;;;;;;;;EA0f5C,YAAA,CACX,OAAA,GAAU,+BAAA,CAAgC,CAAA,IACzC,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EACf,YAAA,CACX,OAAA,EAAS,gCAAA,CAAiC,CAAA,IACzC,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EAherB;;;;;;;;EAmfA,YAAA,CACX,OAAA,GAAU,+BAAA,CAAgC,CAAA,IACzC,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EACf,YAAA,CACX,OAAA,EAAS,gCAAA,CAAiC,CAAA,IACzC,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EAvd+B;;;;;EAAA,UA2ejD,aAAA,CAAc,OAAA,QAAe,OAAA;EAze3C;;;;;;EAAA,UAmfc,MAAA,CAAO,MAAA,EAAQ,gBAAA,CAAiB,CAAA,GAAI,OAAA,QAAe,OAAA;EAncd;;;;;EAAA,UA4crC,UAAA,CAAW,IAAA,QAAY,OAAA;EArbK;;;;;;EAAA,UA+b5B,QAAA,CAAS,MAAA,EAAQ,CAAA,EAAG,IAAA,QAAY,OAAA;EA5bJ;;;;;;EAAA,UAsc5B,UAAA,CAAW,EAAA,mBAAqB,IAAA,QAAY,OAAA;EArbD;;;;;;EAAA,UA+b3C,QAAA,CAAS,MAAA,EAAQ,CAAA,EAAG,IAAA,QAAY,OAAA;EAjb5B;;;;;;EAAA,UA2bJ,QAAA,CAAS,IAAA,OAAW,IAAA,EAAM,QAAA,GAAW,OAAA;EAvaxC;;;;;;;EAAA,UAkbG,MAAA,CAAO,MAAA,EAAQ,CAAA,EAAG,IAAA,OAAW,IAAA,EAAM,QAAA,GAAW,OAAA;EA/ZJ;;;;;EAAA,UAwa1C,UAAA,CAAW,EAAA,oBAAsB,OAAA;EA/Z/B;;;;;EAAA,UAwaF,QAAA,CAAS,EAAA,oBAAsB,OAAA;EApaG;;;;;;EAkbrC,KAAA,CAAM,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAlavD;;;;;;EAibW,WAAA,CAAY,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAxT3C;;;;;;EAkUP,WAAA,CAAY,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EA7RlD;;;;;;EA6TA,iBAAA,CAAkB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAnSxD;;;;;;;;;;;;;;;;EA2TA,GAAA,CAAI,KAAA,UAAe,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAlSnE;;;;;;;;;;;EAsTU,GAAA,CAAI,KAAA,UAAe,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAnSnE;;;;;;;;;;;EAuTU,GAAA,CAAI,KAAA,UAAe,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAnS1B;;;;;;;;;;;EAuT/B,GAAA,CAAI,KAAA,UAAe,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA;EAjSzD;;;;;;;;;;;;;;;;;;;;;;;EAiUA,OAAA,KAAY,MAAA,mBACvB,MAAA,EAAQ,aAAA,EACR,UAAA,EAAY,oBAAA,EACZ,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA,CAAQ,CAAA;EA7QK;;;;;;;;;;;;;;;;;;;;EA0SH,SAAA,KAAc,MAAA,mBACzB,UAAA,EAAY,oBAAA,EACZ,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAChC,OAAA,CAAQ,CAAA;EAtQyB;;;;;;EAyR7B,cAAA,CAAe,MAAA;EApQN;;;;;EA8QT,cAAA;EA9QuD;;;;;;;EAAA,UAyRpD,QAAA,CAAS,GAAA,WAAc,MAAA,eAAqB,WAAA,GAAc,MAAA;EAzPvC;;;;;;;;;EAAA,UAoRnB,eAAA,CAAgB,KAAA;EA3PS;;;;;;EAAA,UAoSnB,KAAA,CAAM,GAAA,UAAa,KAAA,QAAa,OAAA;EApQjB;;;;;;EAsRlB,SAAA,CAAU,EAAA,oBAAsB,OAAA,CAAQ,CAAA;EA9PiB;;;EAqQzD,UAAA,CAAW,EAAA,oBAAsB,OAAA,CAAQ,CAAA;EAjPW;;;;;;;;EA6PpD,WAAA,CACX,MAAA,UACA,KAAA,OACA,eAAA,GAAkB,MAAA,gBACjB,OAAA,CAAQ,CAAA;EAzNE;;;;;;EAmPA,SAAA,CAAU,OAAA,GAAU,yBAAA,CAA0B,CAAA,IAAK,OAAA,CAAQ,CAAA;EAnNnD;;;;;;EAmPR,eAAA,CAAgB,OAAA,GAAU,yBAAA,CAA0B,CAAA,IAAK,OAAA,CAAQ,CAAA;EAhP3C;;;;;;EA0PtB,UAAA,CAAW,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA3NzE;;;;;;EA+PD,gBAAA,CAAiB,OAAA,GAAU,sBAAA,CAAuB,CAAA,IAAK,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA1OtF;;;;;;EAoPM,eAAA,CAAgB,EAAA,oBAAsB,OAAA,CAAQ,CAAA;EA/NL;;;;;EAmPzC,UAAA,CAAW,KAAA,EAAO,CAAA,GAAI,OAAA;EA/Ka;;;;;;;;EAiMzC,OAAA;EA5JM;;;;;;EAuKA,QAAA,IAAY,OAAA;EAzIZ;;;;EAsJA,UAAA,CAAW,GAAA,GAAM,QAAA,GAAW,OAAA;EAtJ+B;;;;;EAiK3D,eAAA,CAAgB,KAAA,EAAO,CAAA,GAAI,OAAA;EAjIsC;;;;;;EAAA,UAiJpE,SAAA,CAAU,SAAA,UAAmB,CAAA;EAvIgD;;;;;;;EAsJ1E,YAAA,CACX,KAAA,EAAO,sBAAA,CAAuB,CAAA,GAC9B,IAAA,EAAM,MAAA,gBACL,OAAA,CAAQ,CAAA;EA3GE;;;;;;;EAuHA,cAAA,CACX,KAAA,EAAO,sBAAA,CAAuB,CAAA,GAC9B,IAAA,EAAM,MAAA,gBACL,OAAA,CAAQ,CAAA;AAAA"}