@warlock.js/core 4.16.0 → 5.0.1

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

@@ -27,30 +27,35 @@ var FilterApplicator = class {
 		if (typeof rule === "function") return {
 			type: "function",
 			fn: rule,
-			column: key
+			column: key,
+			key
 		};
 		if (Array.isArray(rule)) {
 			const [operator, target] = rule;
 			if (target === void 0) return {
 				type: operator,
 				column: key,
-				columns: void 0
+				columns: void 0,
+				key
 			};
 			if (Array.isArray(target)) return {
 				type: operator,
 				column: void 0,
-				columns: target
+				columns: target,
+				key
 			};
 			return {
 				type: operator,
 				column: target,
-				columns: void 0
+				columns: void 0,
+				key
 			};
 		}
 		return {
 			type: rule,
 			column: key,
-			columns: void 0
+			columns: void 0,
+			key
 		};
 	}
 	/**
@@ -66,7 +71,7 @@ var FilterApplicator = class {
 			handler.call(this, query, rule.column, rule.columns, value, options);
 			return;
 		}
-		this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value);
+		this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value, rule.key);
 	}
 	/**
 	* Get filter handler for predefined types
@@ -114,7 +119,7 @@ var FilterApplicator = class {
 	/**
 	* Apply standard where operators
 	*/
-	applyWhereOperator(query, operator, column, columns, value) {
+	applyWhereOperator(query, operator, column, columns, value, ruleName) {
 		if (operator.startsWith("in") && operator !== "int" && !Array.isArray(value)) value = [value];
 		if (column) switch (operator) {
 			case "=":
@@ -149,11 +154,17 @@ var FilterApplicator = class {
 				query.whereNotBetween(column, value);
 				break;
 		}
-		else if (columns) {
+		else if (columns) if (operator === "=") {
 			const conditions = {};
 			for (const col of columns) conditions[col] = value;
 			query.orWhere(conditions);
-		}
+		} else if (operator === "like") query.orWhere((sub) => {
+			columns.forEach((col, index) => {
+				if (index === 0) sub.where(col, "like", value);
+				else sub.orWhere(col, "like", value);
+			});
+		});
+		else throw new Error(`Unsupported multi-column filter operator "${operator}" for rule "${ruleName ?? columns.join(",")}". Multi-column filters only support "=" and "like".`);
 	}
 	/**
 	* Coerce a filter value to a boolean.

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

@@ -1 +1 @@
-{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../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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"}
+{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../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, 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, key };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target, key };\n      }\n\n      return { type: operator, column: target, columns: undefined, key };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined, key };\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, rule.key);\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    ruleName?: string,\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      if (operator === \"=\") {\n        const conditions: any = {};\n        for (const col of columns) {\n          conditions[col] = value;\n        }\n        query.orWhere(conditions);\n      } else if (operator === \"like\") {\n        // (col0 LIKE value OR col1 LIKE value OR ...), OR'd with prior conditions —\n        // the object form of orWhere() only ever emits \"=\", so \"like\" needs the\n        // callback/group form to keep the operator instead of silently degrading\n        // to equality (D1).\n        query.orWhere((sub: QueryBuilderContract) => {\n          columns.forEach((col, index) => {\n            if (index === 0) {\n              sub.where(col, \"like\", value);\n            } else {\n              sub.orWhere(col, \"like\", value);\n            }\n          });\n        });\n      } else {\n        // Every other operator silently degraded to equality via the object form\n        // of orWhere() — refuse instead of returning a correct-looking, wrong query.\n        throw new Error(\n          `Unsupported multi-column filter operator \"${operator}\" for rule \"${ruleName ?? columns.join(\",\")}\". ` +\n            `Multi-column filters only support \"=\" and \"like\".`,\n        );\n      }\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/restful/restful.d.mts

@@ -1,6 +1,6 @@
 import { Request } from "../http/request.mjs";
 import { Response } from "../http/response.mjs";
-import { RestfulMiddleware, RouteResource } from "../router/types.mjs";
+import { HttpContext, RestfulMiddleware, RouteResource } from "../router/types.mjs";
 import { RepositoryManager } from "../repositories/repository.manager.mjs";
 import { Model } from "@warlock.js/cascade";
 
@@ -39,31 +39,52 @@ declare abstract class Restful<T extends Model> implements RouteResource {
   /**
    * List records
    */
-  list(request: Request, response: Response): Promise<Response | undefined>;
+  list({
+    request,
+    response
+  }: HttpContext): Promise<Response | undefined>;
   /**
    * Get single record
    */
-  get(request: Request, response: Response): Promise<Response | undefined>;
+  get({
+    request,
+    response
+  }: HttpContext): Promise<Response | undefined>;
   /**
    * Create a new record
    */
-  create(request: Request, response: Response): Promise<any>;
+  create({
+    request,
+    response
+  }: HttpContext): Promise<any>;
   /**
    * Update record
    */
-  update(request: Request, response: Response): Promise<any>;
+  update({
+    request,
+    response
+  }: HttpContext): Promise<any>;
   /**
    * Patch record
    */
-  patch(request: Request, response: Response): Promise<Response | undefined>;
+  patch({
+    request,
+    response
+  }: HttpContext): Promise<Response | undefined>;
   /**
    * Delete record
    */
-  delete(request: Request, response: Response): Promise<Response | undefined>;
+  delete({
+    request,
+    response
+  }: HttpContext): Promise<Response | undefined>;
   /**
    * Bulk delete records
    */
-  bulkDelete(request: Request, response: Response): Promise<Response | undefined>;
+  bulkDelete({
+    request,
+    response
+  }: HttpContext): Promise<Response | undefined>;
   /**
    * Before create
    */

package/esm/restful/restful.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"restful.d.mts","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"mappings":";;;;;;;uBAOsB,OAAA,WAAkB,KAAA,aAAkB,aAAA;;;;YAI9C,UAAA,EAAY,iBAAA;;AAJxB;;YASY,UAAA;EAT4B;;;EAAA,UAc5B,eAAA;EAUU;;;EAAA,mBALD,UAAA,EAAY,iBAAA,CAAkB,CAAA;EA8BH;;;EAAA,UAzBpC,QAAA,EAAU,MAAA;EAyDyB;;;;;EA7CtC,KAAA;EAkHsB;;;EA7GhB,IAAA,CAAK,EAAA,WAAU,OAAA,CAAA,CAAA;EAyJmB;;;EAjJlC,IAAA,CAAK,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA,CAAA,QAAA;EAoLN;;;EApJnC,GAAA,CAAI,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA,CAAA,QAAA;EAqLD;;;EAhKvC,MAAA,CAAO,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA;EAgNG;;;EAhK9C,MAAA,CAAO,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA;EAuKD;;;EA3H1C,KAAA,CAAM,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA,CAAA,QAAA;EAoI1C;;;EAjGA,MAAA,CAAO,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA,CAAA,QAAA;EA4G5C;;;EA3EC,UAAA,CAAW,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,GAAQ,OAAA,CAAA,QAAA;EA+EzD;;;EAAA,UA/Ba,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAsCA;;;EAAA,UA/BlE,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAsCA;;;EAAA,UA/B9D,YAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAqCY;;;EAAA,UA9BC,QAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAoCQ;;;EAAA,UA7BK,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAwCrE;;;EAAA,UAjCG,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA4ClE;;;EAAA,UArCI,WAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAoCA;;;EAAA,UA7Ba,OAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAoCY;;;EAAA,UA7BC,UAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,GAAU,CAAA,EACV,UAAA,GAAa,CAAA,GACZ,OAAA;EAvYkE;;;EAAA,UA8YrD,MAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EA/YO;;;;EAAA,UAuZM,cAAA,CACd,MAAA,UACA,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,QAAA,EACV,OAAA,SAAa,OAAA,SAAA,MAAA,gBAAA,QAAA;AAAA"}
+{"version":3,"file":"restful.d.mts","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"mappings":";;;;;;;uBAOsB,OAAA,WAAkB,KAAA,aAAkB,aAAA;;;;YAI9C,UAAA,EAAY,iBAAA;;AAJxB;;YASY,UAAA;EAT4B;;;EAAA,UAc5B,eAAA;EAUU;;;EAAA,mBALD,UAAA,EAAY,iBAAA,CAAkB,CAAA;EA8BpB;;;EAAA,UAzBnB,QAAA,EAAU,MAAA;EAyDD;;;;;EA7CZ,KAAA;EAkEwB;;;EA7DlB,IAAA,CAAK,EAAA,WAAU,OAAA,CAAA,CAAA;EA6GG;;;EArGlB,IAAA;IAAO,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAiJtB;;;EAjHjB,GAAA;IAAM,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAoJ7B;;;EA/HT,MAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA;EA+HA;;;EA/EzC,MAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA;EAgHI;;;EApE7C,KAAA;IAAQ,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAoHyB;;;EAjFjE,MAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAwFoB;;;EAvD7D,UAAA;IAAa,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAiE/C;;;EAAA,UAjBK,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA4BrE;;;EAAA,UArBG,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA+BvC;;;EAAA,UAxBvB,YAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EA0BgC;;;EAAA,UAnBnB,QAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAsBS;;;EAAA,UAfI,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAmB/E;;;EAAA,UAZa,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAuBhE;;;EAAA,UAhBE,WAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAsBS;;;EAAA,UAfI,OAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAqBU;;;EAAA,UAdG,UAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,GAAU,CAAA,EACV,UAAA,GAAa,CAAA,GACZ,OAAA;EAsBQ;;;EAAA,UAfK,MAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAYY;;;;EAAA,UAJC,cAAA,CACd,MAAA,UACA,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,QAAA,EACV,OAAA,SAAa,OAAA,SAAA,MAAA,gBAAA,QAAA;AAAA"}

package/esm/restful/restful.mjs

@@ -24,7 +24,7 @@ var Restful = class {
 	/**
 	* List records
 	*/
-	async list(request, response) {
+	async list({ request, response }) {
 		try {
 			if (await this.callMiddleware("list", request, response)) return;
 			const responseDocument = {};
@@ -43,7 +43,7 @@ var Restful = class {
 	/**
 	* Get single record
 	*/
-	async get(request, response) {
+	async get({ request, response }) {
 		try {
 			if (await this.callMiddleware("get", request, response)) return;
 			const record = await this.find(request.input("id"));
@@ -56,7 +56,7 @@ var Restful = class {
 	/**
 	* Create a new record
 	*/
-	async create(request, response) {
+	async create({ request, response }) {
 		try {
 			const model = this.repository.newModel();
 			const beforeCreate = await this.beforeCreate(request, response, model);
@@ -68,7 +68,10 @@ var Restful = class {
 			if (createOutput) return createOutput;
 			const saveOutput = await this.onSave(request, response, record);
 			if (saveOutput) return saveOutput;
-			if (this.returnOn.create === "records") return this.list(request, response);
+			if (this.returnOn.create === "records") return this.list({
+				request,
+				response
+			});
 			return response.successCreate({ [this.recordName]: record });
 		} catch (error) {
 			log.error("restful", "create", error);
@@ -78,7 +81,7 @@ var Restful = class {
 	/**
 	* Update record
 	*/
-	async update(request, response) {
+	async update({ request, response }) {
 		try {
 			const record = await this.find(request.input("id"));
 			if (!record) return response.notFound({ error: "Record not found" });
@@ -90,7 +93,10 @@ var Restful = class {
 			await record.save(request.allExceptParams());
 			this.onUpdate(request, response, record, oldRecord);
 			this.onSave(request, response, record, oldRecord);
-			if (this.returnOn.update === "records") return this.list(request, response);
+			if (this.returnOn.update === "records") return this.list({
+				request,
+				response
+			});
 			return response.success({ [this.recordName]: record });
 		} catch (error) {
 			log.error("restful", "update", error);
@@ -99,7 +105,7 @@ var Restful = class {
 	/**
 	* Patch record
 	*/
-	async patch(request, response) {
+	async patch({ request, response }) {
 		try {
 			const record = await this.find(request.input("id"));
 			if (!record) return response.notFound({ error: "Record not found" });
@@ -109,7 +115,10 @@ var Restful = class {
 			await record.save(request.heavyExceptParams());
 			this.onPatch(request, response, record, oldRecord);
 			this.onSave(request, response, record, oldRecord);
-			if (this.returnOn.patch === "records") return this.list(request, response);
+			if (this.returnOn.patch === "records") return this.list({
+				request,
+				response
+			});
 			return response.success({ [this.recordName]: record });
 		} catch (error) {
 			log.error("restful", "patch", error);
@@ -118,7 +127,7 @@ var Restful = class {
 	/**
 	* Delete record
 	*/
-	async delete(request, response) {
+	async delete({ request, response }) {
 		try {
 			const record = await this.find(request.input("id"));
 			if (!record) return response.notFound();
@@ -126,7 +135,10 @@ var Restful = class {
 			await this.beforeDelete(request, response, record);
 			await record.destroy();
 			this.onDelete(request, response, record);
-			if (this.returnOn.delete === "records") return this.list(request, response);
+			if (this.returnOn.delete === "records") return this.list({
+				request,
+				response
+			});
 			return response.success();
 		} catch (error) {
 			log.error("restful", "delete", error);
@@ -136,7 +148,7 @@ var Restful = class {
 	/**
 	* Bulk delete records
 	*/
-	async bulkDelete(request, response) {
+	async bulkDelete({ request, response }) {
 		try {
 			const ids = request.input("id");
 			if (!Array.isArray(ids)) return response.badRequest({ error: "id must be an array" });
@@ -147,7 +159,10 @@ var Restful = class {
 				await record.destroy();
 				this.onDelete(request, response, record);
 			}));
-			if (this.returnOn.delete === "records") return this.list(request, response);
+			if (this.returnOn.delete === "records") return this.list({
+				request,
+				response
+			});
 			return response.success({ deleted: records.length });
 		} catch (error) {
 			log.error("restful", "bulkDelete", error);
@@ -201,7 +216,10 @@ var Restful = class {
 	async callMiddleware(method, request, response, _record) {
 		if (!this.middleware[method]) return;
 		for (const middleware of this.middleware[method]) {
-			const output = await middleware(request, response);
+			const output = await middleware({
+				request,
+				response
+			});
 			if (output) return output;
 		}
 	}

package/esm/restful/restful.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"restful.mjs","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"sourcesContent":["import type { GenericObject } from \"@mongez/reinforcements\";\nimport type { Model } from \"@warlock.js/cascade\";\nimport { log } from \"@warlock.js/logger\";\nimport type { Request, Response } from \"../http\";\nimport type { QueryBuilderContract, RepositoryManager } from \"../repositories\";\nimport type { RestfulMiddleware, RouteResource } from \"../router\";\n\nexport abstract class Restful<T extends Model> implements RouteResource {\n  /**\n   * Middleware for each method\n   */\n  protected middleware: RestfulMiddleware = {};\n\n  /**\n   * Record name\n   */\n  protected recordName = \"record\";\n\n  /**\n   * Records list name\n   */\n  protected recordsListName = \"records\";\n\n  /**\n   * Repository\n   */\n  protected abstract repository: RepositoryManager<T>;\n\n  /**\n   * Define what to be returned when a record is created|updated|deleted|patched\n   */\n  protected returnOn: Record<string, \"record\" | \"records\"> = {\n    create: \"record\",\n    update: \"record\",\n    delete: \"record\",\n    patch: \"record\",\n  };\n\n  /**\n   * Enable fetching cache\n   *\n   * @default true\n   */\n  public cache = true;\n\n  /**\n   * Find record instance by id\n   */\n  public async find(id: number) {\n    const findMethod = this.cache ? \"getCached\" : \"find\";\n    return this.repository[findMethod](id);\n  }\n\n  /**\n   * List records\n   */\n  public async list(request: Request, response: Response) {\n    try {\n      if (await this.callMiddleware(\"list\", request, response)) return;\n\n      const responseDocument: GenericObject = {};\n\n      const data = request.heavy();\n\n      if (data.paginate === \"false\") {\n        data.paginate = false;\n      }\n\n      const listMethod = this.cache ? \"listCached\" : \"list\";\n\n      const { data: documents, pagination } = await this.repository[listMethod](data);\n\n      responseDocument[this.recordsListName] = documents;\n\n      if (pagination) {\n        responseDocument.pagination = pagination;\n      }\n\n      return response.success(responseDocument);\n    } catch (error: any) {\n      log.error(\"restful\", \"list\", error);\n      return response.serverError(error);\n    }\n  }\n\n  /**\n   * Get single record\n   */\n  public async get(request: Request, response: Response) {\n    try {\n      if (await this.callMiddleware(\"get\", request, response)) return;\n\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"get\", error);\n    }\n  }\n\n  /**\n   * Create a new record\n   */\n  public async create(request: Request, response: Response) {\n    try {\n      const model = this.repository.newModel();\n      const beforeCreate = await this.beforeCreate(request, response, model);\n\n      if (beforeCreate) {\n        return beforeCreate;\n      }\n\n      const beforeSave = await this.beforeSave(request, response, model);\n\n      if (beforeSave) {\n        return beforeSave;\n      }\n\n      const record = await this.repository.create(request.all());\n\n      const createOutput = await this.onCreate(request, response, record);\n\n      if (createOutput) {\n        return createOutput;\n      }\n\n      const saveOutput = await this.onSave(request, response, record);\n\n      if (saveOutput) {\n        return saveOutput;\n      }\n\n      if (this.returnOn.create === \"records\") {\n        return this.list(request, response);\n      }\n\n      return response.successCreate({\n        [this.recordName]: record,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"create\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Update record\n   */\n  public async update(request: Request, response: Response) {\n    try {\n      // Find record\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const beforeOutput = await this.beforeUpdate(request, response, record);\n      if (beforeOutput) {\n        return beforeOutput;\n      }\n\n      const beforeSafe = await this.beforeSave(request, response, record);\n\n      if (beforeSafe) {\n        return beforeSafe;\n      }\n\n      const oldRecord = record.clone();\n\n      await record.save(request.allExceptParams());\n\n      this.onUpdate(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.update === \"records\") {\n        return this.list(request, response);\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"update\", error);\n    }\n  }\n\n  /**\n   * Patch record\n   */\n  public async patch(request: Request, response: Response) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const oldRecord = record.clone();\n\n      await this.beforePatch(request, response, record, oldRecord);\n      await this.beforeSave(request, response, record, oldRecord);\n\n      await record.save(request.heavyExceptParams());\n\n      this.onPatch(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.patch === \"records\") {\n        return this.list(request, response);\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"patch\", error);\n    }\n  }\n\n  /**\n   * Delete record\n   */\n  public async delete(request: Request, response: Response) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      if (await this.callMiddleware(\"delete\", request, response, record)) return;\n\n      await this.beforeDelete(request, response, record);\n\n      await record.destroy();\n\n      this.onDelete(request, response, record);\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list(request, response);\n      }\n\n      return response.success();\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"delete\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Bulk delete records\n   */\n  public async bulkDelete(request: Request, response: Response) {\n    try {\n      const ids = request.input(\"id\");\n\n      if (!Array.isArray(ids)) {\n        return response.badRequest({\n          error: \"id must be an array\",\n        });\n      }\n\n      const records = await this.repository.all({\n        perform: (query: QueryBuilderContract<T>) =>\n          query.whereIn(\n            \"id\",\n            ids.map((id) => parseInt(id)),\n          ),\n      });\n\n      await Promise.all(\n        records.map(async (record) => {\n          if (await this.callMiddleware(\"delete\", request, response, record)) {\n            return;\n          }\n\n          await this.beforeDelete(request, response, record);\n          await record.destroy();\n          this.onDelete(request, response, record);\n        }),\n      );\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list(request, response);\n      }\n\n      return response.success({\n        deleted: records.length,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"bulkDelete\", error);\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Before create\n   */\n  protected async beforeCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On create\n   */\n  protected async onCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before update\n   */\n  protected async beforeUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On update\n   */\n  protected async onUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before delete\n   */\n  protected async beforeDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On delete\n   */\n  protected async onDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before patch\n   */\n  protected async beforePatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On patch\n   */\n  protected async onPatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before save\n   */\n  protected async beforeSave(\n    _request: Request,\n    _response: Response,\n    _record?: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On save\n   */\n  protected async onSave(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Call middleware for the given method\n   *\n   */\n  protected async callMiddleware(\n    method: string,\n    request: Request,\n    response: Response,\n    _record?: any,\n  ) {\n    if (!this.middleware[method]) return;\n\n    for (const middleware of this.middleware[method]) {\n      const output = await middleware(request, response);\n\n      if (output) {\n        return output;\n      }\n    }\n\n    return;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"restful.mjs","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"sourcesContent":["import type { GenericObject } from \"@mongez/reinforcements\";\nimport type { Model } from \"@warlock.js/cascade\";\nimport { log } from \"@warlock.js/logger\";\nimport type { Request, Response } from \"../http\";\nimport type { QueryBuilderContract, RepositoryManager } from \"../repositories\";\nimport type { HttpContext, RestfulMiddleware, RouteResource } from \"../router\";\n\nexport abstract class Restful<T extends Model> implements RouteResource {\n  /**\n   * Middleware for each method\n   */\n  protected middleware: RestfulMiddleware = {};\n\n  /**\n   * Record name\n   */\n  protected recordName = \"record\";\n\n  /**\n   * Records list name\n   */\n  protected recordsListName = \"records\";\n\n  /**\n   * Repository\n   */\n  protected abstract repository: RepositoryManager<T>;\n\n  /**\n   * Define what to be returned when a record is created|updated|deleted|patched\n   */\n  protected returnOn: Record<string, \"record\" | \"records\"> = {\n    create: \"record\",\n    update: \"record\",\n    delete: \"record\",\n    patch: \"record\",\n  };\n\n  /**\n   * Enable fetching cache\n   *\n   * @default true\n   */\n  public cache = true;\n\n  /**\n   * Find record instance by id\n   */\n  public async find(id: number) {\n    const findMethod = this.cache ? \"getCached\" : \"find\";\n    return this.repository[findMethod](id);\n  }\n\n  /**\n   * List records\n   */\n  public async list({ request, response }: HttpContext) {\n    try {\n      if (await this.callMiddleware(\"list\", request, response)) return;\n\n      const responseDocument: GenericObject = {};\n\n      const data = request.heavy();\n\n      if (data.paginate === \"false\") {\n        data.paginate = false;\n      }\n\n      const listMethod = this.cache ? \"listCached\" : \"list\";\n\n      const { data: documents, pagination } = await this.repository[listMethod](data);\n\n      responseDocument[this.recordsListName] = documents;\n\n      if (pagination) {\n        responseDocument.pagination = pagination;\n      }\n\n      return response.success(responseDocument);\n    } catch (error: any) {\n      log.error(\"restful\", \"list\", error);\n      return response.serverError(error);\n    }\n  }\n\n  /**\n   * Get single record\n   */\n  public async get({ request, response }: HttpContext) {\n    try {\n      if (await this.callMiddleware(\"get\", request, response)) return;\n\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"get\", error);\n    }\n  }\n\n  /**\n   * Create a new record\n   */\n  public async create({ request, response }: HttpContext) {\n    try {\n      const model = this.repository.newModel();\n      const beforeCreate = await this.beforeCreate(request, response, model);\n\n      if (beforeCreate) {\n        return beforeCreate;\n      }\n\n      const beforeSave = await this.beforeSave(request, response, model);\n\n      if (beforeSave) {\n        return beforeSave;\n      }\n\n      const record = await this.repository.create(request.all());\n\n      const createOutput = await this.onCreate(request, response, record);\n\n      if (createOutput) {\n        return createOutput;\n      }\n\n      const saveOutput = await this.onSave(request, response, record);\n\n      if (saveOutput) {\n        return saveOutput;\n      }\n\n      if (this.returnOn.create === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.successCreate({\n        [this.recordName]: record,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"create\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Update record\n   */\n  public async update({ request, response }: HttpContext) {\n    try {\n      // Find record\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const beforeOutput = await this.beforeUpdate(request, response, record);\n      if (beforeOutput) {\n        return beforeOutput;\n      }\n\n      const beforeSafe = await this.beforeSave(request, response, record);\n\n      if (beforeSafe) {\n        return beforeSafe;\n      }\n\n      const oldRecord = record.clone();\n\n      await record.save(request.allExceptParams());\n\n      this.onUpdate(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.update === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"update\", error);\n    }\n  }\n\n  /**\n   * Patch record\n   */\n  public async patch({ request, response }: HttpContext) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const oldRecord = record.clone();\n\n      await this.beforePatch(request, response, record, oldRecord);\n      await this.beforeSave(request, response, record, oldRecord);\n\n      await record.save(request.heavyExceptParams());\n\n      this.onPatch(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.patch === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"patch\", error);\n    }\n  }\n\n  /**\n   * Delete record\n   */\n  public async delete({ request, response }: HttpContext) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      if (await this.callMiddleware(\"delete\", request, response, record)) return;\n\n      await this.beforeDelete(request, response, record);\n\n      await record.destroy();\n\n      this.onDelete(request, response, record);\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success();\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"delete\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Bulk delete records\n   */\n  public async bulkDelete({ request, response }: HttpContext) {\n    try {\n      const ids = request.input(\"id\");\n\n      if (!Array.isArray(ids)) {\n        return response.badRequest({\n          error: \"id must be an array\",\n        });\n      }\n\n      const records = await this.repository.all({\n        perform: (query: QueryBuilderContract<T>) =>\n          query.whereIn(\n            \"id\",\n            ids.map((id) => parseInt(id)),\n          ),\n      });\n\n      await Promise.all(\n        records.map(async (record) => {\n          if (await this.callMiddleware(\"delete\", request, response, record)) {\n            return;\n          }\n\n          await this.beforeDelete(request, response, record);\n          await record.destroy();\n          this.onDelete(request, response, record);\n        }),\n      );\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        deleted: records.length,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"bulkDelete\", error);\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Before create\n   */\n  protected async beforeCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On create\n   */\n  protected async onCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before update\n   */\n  protected async beforeUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On update\n   */\n  protected async onUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before delete\n   */\n  protected async beforeDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On delete\n   */\n  protected async onDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before patch\n   */\n  protected async beforePatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On patch\n   */\n  protected async onPatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before save\n   */\n  protected async beforeSave(\n    _request: Request,\n    _response: Response,\n    _record?: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On save\n   */\n  protected async onSave(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Call middleware for the given method\n   *\n   */\n  protected async callMiddleware(\n    method: string,\n    request: Request,\n    response: Response,\n    _record?: any,\n  ) {\n    if (!this.middleware[method]) return;\n\n    for (const middleware of this.middleware[method]) {\n      const output = await middleware({ request, response });\n\n      if (output) {\n        return output;\n      }\n    }\n\n    return;\n  }\n}\n"],"mappings":"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"}

package/esm/router/describe-route-for-log.mjs

@@ -0,0 +1,29 @@
+//#region ../core/src/router/describe-route-for-log.ts
+/**
+* The `[GET /products]` label that identifies a route in the request log.
+*
+* A trailing `/*` is stripped because a prefixed route is more readable as the
+* prefix it serves — `/products/*` is `/products` to anyone reading a log.
+*
+* Two things the previous one-liner (`path.replace("/*", "")`) got wrong:
+*
+* 1. The BARE catch-all `/*` became the empty string, so every unmatched
+*    request logged as `[GET ]`. The reader is looking for which route
+*    matched; a blank is the one answer that helps nobody.
+* 2. `replace` removes the FIRST occurrence wherever it sits, so a `/*` in the
+*    middle of a path would have been silently deleted from the label. Nothing
+*    declares such a route today — which is exactly why it would go unnoticed
+*    if something did.
+*/
+function describeRouteForLog(method, path) {
+	return `${method} ${stripTrailingWildcard(path)}`;
+}
+function stripTrailingWildcard(path) {
+	if (!path.endsWith("/*")) return path;
+	const withoutWildcard = path.slice(0, -2);
+	return withoutWildcard.length > 0 ? withoutWildcard : path;
+}
+
+//#endregion
+export { describeRouteForLog };
+//# sourceMappingURL=describe-route-for-log.mjs.map

package/esm/router/describe-route-for-log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-route-for-log.mjs","names":[],"sources":["../../../../../../../core/src/router/describe-route-for-log.ts"],"sourcesContent":["/**\n * The `[GET /products]` label that identifies a route in the request log.\n *\n * A trailing `/*` is stripped because a prefixed route is more readable as the\n * prefix it serves — `/products/*` is `/products` to anyone reading a log.\n *\n * Two things the previous one-liner (`path.replace(\"/*\", \"\")`) got wrong:\n *\n * 1. The BARE catch-all `/*` became the empty string, so every unmatched\n *    request logged as `[GET ]`. The reader is looking for which route\n *    matched; a blank is the one answer that helps nobody.\n * 2. `replace` removes the FIRST occurrence wherever it sits, so a `/*` in the\n *    middle of a path would have been silently deleted from the label. Nothing\n *    declares such a route today — which is exactly why it would go unnoticed\n *    if something did.\n */\nexport function describeRouteForLog(method: string, path: string): string {\n  return `${method} ${stripTrailingWildcard(path)}`;\n}\n\nfunction stripTrailingWildcard(path: string): string {\n  if (!path.endsWith(\"/*\")) return path;\n\n  const withoutWildcard = path.slice(0, -\"/*\".length);\n\n  // `/*` alone leaves nothing behind. Show the route's own declared path\n  // instead of a blank.\n  return withoutWildcard.length > 0 ? withoutWildcard : path;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,oBAAoB,QAAgB,MAAsB;CACxE,OAAO,GAAG,OAAO,GAAG,sBAAsB,IAAI;AAChD;AAEA,SAAS,sBAAsB,MAAsB;CACnD,IAAI,CAAC,KAAK,SAAS,IAAI,GAAG,OAAO;CAEjC,MAAM,kBAAkB,KAAK,MAAM,GAAG,EAAY;CAIlD,OAAO,gBAAgB,SAAS,IAAI,kBAAkB;AACxD"}

package/esm/router/index.d.mts

@@ -1,2 +1,4 @@
-import { GroupedRoutesOptions, Middleware, MiddlewareResponse, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
+import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
+import { PositionalHandlerSuspect, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./positional-handler-diagnostics.mjs";
+import { RouteRegistry } from "./route-registry.mjs";
 import { Router, router } from "./router.mjs";

package/esm/router/index.mjs

@@ -1,3 +1,5 @@
+import { clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./positional-handler-diagnostics.mjs";
+import { RouteRegistry } from "./route-registry.mjs";
 import { Router, router } from "./router.mjs";
 
 export {  };

package/esm/router/log-request-lifecycle.mjs

@@ -0,0 +1,38 @@
+//#region ../core/src/router/log-request-lifecycle.ts
+function levelForStatus(statusCode) {
+	if (statusCode === void 0) return "info";
+	if (statusCode >= 500) return "error";
+	if (statusCode >= 400) return "warn";
+	return "info";
+}
+async function logRequestLifecycle(ports, descriptor, run) {
+	const startedAt = ports.now();
+	ports.info({
+		module: descriptor.module,
+		action: descriptor.action,
+		message: `Starting Request: ${descriptor.requestId}`,
+		context: descriptor.context
+	});
+	const finish = (level, outcome) => {
+		const duration = Math.round(ports.now() - startedAt);
+		ports[level]({
+			module: descriptor.module,
+			action: descriptor.action,
+			message: `Completed Request: ${descriptor.requestId} — ${outcome} in ${duration}ms`,
+			context: descriptor.context
+		});
+	};
+	try {
+		const result = await run();
+		const statusCode = descriptor.statusCode();
+		finish(levelForStatus(statusCode), statusCode === void 0 ? "no status" : String(statusCode));
+		return result;
+	} catch (error) {
+		finish("error", `threw ${error instanceof Error ? error.name : typeof error}`);
+		throw error;
+	}
+}
+
+//#endregion
+export { logRequestLifecycle };
+//# sourceMappingURL=log-request-lifecycle.mjs.map

package/esm/router/log-request-lifecycle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-request-lifecycle.mjs","names":[],"sources":["../../../../../../../core/src/router/log-request-lifecycle.ts"],"sourcesContent":["/**\n * Both ends of a request's log entry.\n *\n * ## Why the completion line exists\n *\n * The router logged `Starting Request: <id>` and nothing else. A request that\n * hung for thirty seconds and one that returned in two milliseconds produced\n * **byte-identical output**, so the log could not answer the one question\n * anyone opens it to ask.\n *\n * Note what \"detecting a hang\" actually means. Nothing can log the completion\n * of a request that never completes — the mechanism is the **absence** of a\n * completion line beside a start line that has one. That only works if the\n * completion line is emitted on every settled path, **including a throw**,\n * which is why the error path here is not an afterthought.\n *\n * ## Why the level tracks the status\n *\n * A handled 500 does not throw; it returns a response. Logging it at `info`\n * would bury the exact entries someone scanning the log is hunting for, so the\n * level is derived from the outcome: informational below 400, a warning for\n * client errors, an error for server errors and for anything that threw.\n *\n * ## Ports rather than a direct `log` import\n *\n * The behaviour worth pinning down is *which lines come out, in which order,\n * at which level, when the run throws*. Injecting the sink and the clock makes\n * that assertable without a server, a socket or a fake timer.\n */\n\nexport type RequestLogEntry = {\n  module: string;\n  action: string;\n  message: string;\n  context?: unknown;\n};\n\nexport type RequestLogPorts = {\n  info(entry: RequestLogEntry): void;\n  warn(entry: RequestLogEntry): void;\n  error(entry: RequestLogEntry): void;\n  /** Monotonic milliseconds. Called exactly twice per request. */\n  now(): number;\n};\n\nexport type RequestLogDescriptor = {\n  module: string;\n  action: string;\n  requestId: string;\n  context?: unknown;\n  /**\n   * Read AFTER the run settles — the status is decided during the request, so\n   * capturing it up front would report the default on every entry.\n   */\n  statusCode(): number | undefined;\n};\n\ntype Level = \"info\" | \"warn\" | \"error\";\n\nfunction levelForStatus(statusCode: number | undefined): Level {\n  // An unknown status is not evidence of a problem; saying \"error\" because we\n  // failed to read a number would be inventing a defect.\n  if (statusCode === undefined) return \"info\";\n\n  if (statusCode >= 500) return \"error\";\n\n  if (statusCode >= 400) return \"warn\";\n\n  return \"info\";\n}\n\nexport async function logRequestLifecycle<TResult>(\n  ports: RequestLogPorts,\n  descriptor: RequestLogDescriptor,\n  run: () => Promise<TResult>,\n): Promise<TResult> {\n  const startedAt = ports.now();\n\n  ports.info({\n    module: descriptor.module,\n    action: descriptor.action,\n    message: `Starting Request: ${descriptor.requestId}`,\n    context: descriptor.context,\n  });\n\n  const finish = (level: Level, outcome: string): void => {\n    const duration = Math.round(ports.now() - startedAt);\n\n    ports[level]({\n      module: descriptor.module,\n      action: descriptor.action,\n      message: `Completed Request: ${descriptor.requestId} — ${outcome} in ${duration}ms`,\n      context: descriptor.context,\n    });\n  };\n\n  try {\n    const result = await run();\n\n    const statusCode = descriptor.statusCode();\n\n    finish(levelForStatus(statusCode), statusCode === undefined ? \"no status\" : String(statusCode));\n\n    return result;\n  } catch (error) {\n    // The throw is reported and then re-thrown untouched: this function\n    // observes the request, it does not own its error handling.\n    finish(\"error\", `threw ${error instanceof Error ? error.name : typeof error}`);\n\n    throw error;\n  }\n}\n"],"mappings":";AA2DA,SAAS,eAAe,YAAuC;CAG7D,IAAI,eAAe,QAAW,OAAO;CAErC,IAAI,cAAc,KAAK,OAAO;CAE9B,IAAI,cAAc,KAAK,OAAO;CAE9B,OAAO;AACT;AAEA,eAAsB,oBACpB,OACA,YACA,KACkB;CAClB,MAAM,YAAY,MAAM,IAAI;CAE5B,MAAM,KAAK;EACT,QAAQ,WAAW;EACnB,QAAQ,WAAW;EACnB,SAAS,qBAAqB,WAAW;EACzC,SAAS,WAAW;CACtB,CAAC;CAED,MAAM,UAAU,OAAc,YAA0B;EACtD,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI,IAAI,SAAS;EAEnD,MAAM,MAAM,CAAC;GACX,QAAQ,WAAW;GACnB,QAAQ,WAAW;GACnB,SAAS,sBAAsB,WAAW,UAAU,KAAK,QAAQ,MAAM,SAAS;GAChF,SAAS,WAAW;EACtB,CAAC;CACH;CAEA,IAAI;EACF,MAAM,SAAS,MAAM,IAAI;EAEzB,MAAM,aAAa,WAAW,WAAW;EAEzC,OAAO,eAAe,UAAU,GAAG,eAAe,SAAY,cAAc,OAAO,UAAU,CAAC;EAE9F,OAAO;CACT,SAAS,OAAO;EAGd,OAAO,SAAS,SAAS,iBAAiB,QAAQ,MAAM,OAAO,OAAO,OAAO;EAE7E,MAAM;CACR;AACF"}