@eienjs/adonisjs-api-query 1.1.1 → 2.0.0

package/{LICENSE.md → LICENSE}

@@ -1,6 +1,6 @@
 # The MIT License
 
-Copyright (c) 2025 - EienJS
+Copyright (c) 2025 - 2026 | EienJS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -7,12 +7,38 @@
 [![Build Status][badge-build]][build]
 [![Total Downloads][badge-downloads]][downloads]
 
-> Easily build Lucid queries from API requests
+> Easily build Lucid queries from API requests for your AdonisJS v7 application.
 
 ## Introduction
 
 This package provides a set of macros on `ModelQueryBuilder` to build [Lucid](https://adonisjs.com/docs/lucid) queries from API requests. Inspired by [Spatie's Laravel Query Builder](https://github.com/spatie/laravel-query-builder).
 
+## Quick Start
+
+Install the package using the following command:
+
+```sh
+node ace add @eienjs/adonisjs-api-query
+```
+
+Automatically the command will register the provider. Now you can use with your controller response:
+
+```typescript
+import type { HttpContext } from '@adonisjs/core/http';
+import User from '#models/user';
+
+// inside a controller
+export default class MyController {
+  public async handle({ request }: HttpContext) {
+    const users = await User.query()
+      .withRequest(request) // Pass the request to the query builder if async local storage is not enabled
+      .allowedFilters('name')
+      .allowedIncludes('posts')
+      .allowedSorts('id');
+  }
+}
+```
+
 ## Documentation
 
 The documentation is available on [EienJS](https://eienjs.com/packages/adonisjs-api-query/getting-started/).
@@ -30,7 +56,7 @@ The `@eienjs/adonisjs-api-query` library is licensed for use under the MIT Licen
 [source]: https://github.com/eienjs/adonisjs-api-query
 [node-version]: https://www.npmjs.com/package/@eienjs/adonisjs-api-query
 [release]: https://www.npmjs.com/package/@eienjs/adonisjs-api-query
-[license]: https://github.com/eienjs/adonisjs-api-query/blob/main/LICENSE.md
+[license]: https://github.com/eienjs/adonisjs-api-query/blob/main/LICENSE
 [build]: https://github.com/eienjs/adonisjs-api-query/actions/workflows/build.yml?query=branch:main
 [downloads]: https://www.npmjs.com/package/@eienjs/adonisjs-api-query
 [badge-source]: https://img.shields.io/badge/source-eienjs/adonisjs--api--query-blue.svg?logo=github

package/build/configure.d.ts

@@ -1,2 +1,6 @@
-import type Configure from '@adonisjs/core/commands/configure';
-export declare const configure: (command: Configure) => Promise<void>;
+import Configure from "@adonisjs/core/commands/configure";
+
+//#region configure.d.ts
+declare const configure: (command: Configure) => Promise<void>;
+//#endregion
+export { configure };

package/build/configure.js

@@ -0,0 +1,11 @@
+import { stubsRoot } from "./stubs/main.js";
+//#region configure.ts
+const configure = async (command) => {
+	const codemods = await command.createCodemods();
+	await codemods.updateRcFile((rcFile) => {
+		rcFile.addProvider("@eienjs/adonisjs-api-query/providers/api_query_provider");
+	});
+	await codemods.makeUsingStub(stubsRoot, "config.stub", {});
+};
+//#endregion
+export { configure };

package/build/index.d.ts

@@ -1,31 +1,32 @@
-export { configure } from './configure.js';
-export { AllowedFilter } from './src/allowed_filter.js';
-export { AllowedInclude } from './src/allowed_include.js';
-export { AllowedSort } from './src/allowed_sort.js';
-export { ApiQueryBuilderRequest } from './src/api_query_builder_request.js';
-export { defineConfig } from './src/define_config.js';
-export { FilterOperator } from './src/enums/filter_operator.js';
-export { SortDirection } from './src/enums/sort_direction.js';
-export { AllowedFieldsMustBeCalledBeforeAllowedIncludes } from './src/exceptions/allowed_fields_must_be_called_before_allowed_includes.js';
-export { InvalidAppendQuery } from './src/exceptions/invalid_append_query.js';
-export { InvalidDirection } from './src/exceptions/invalid_direction.js';
-export { InvalidFilterQuery } from './src/exceptions/invalid_filter_query.js';
-export { InvalidFilterValue } from './src/exceptions/invalid_filter_value.js';
-export { InvalidIncludeQuery } from './src/exceptions/invalid_include_query.js';
-export { InvalidQuery } from './src/exceptions/invalid_query.js';
-export { InvalidSortQuery } from './src/exceptions/invalid_sort_query.js';
-export { UnknownIncludedFieldsQuery } from './src/exceptions/unknown_included_fields_query.js';
-export { stubsRoot } from './stubs/main.js';
-export * from 'collect.js';
-export { FiltersBeginWithStrict } from './src/filters/filters_begin_with_strict.js';
-export { FiltersCallback } from './src/filters/filters_callback.js';
-export { FiltersEndsWithStrict } from './src/filters/filters_ends_with_strict.js';
-export { FiltersExact } from './src/filters/filters_exact.js';
-export { FiltersOperator } from './src/filters/filters_operator.js';
-export { FiltersPartial } from './src/filters/filters_partial.js';
-export { FiltersTrashed } from './src/filters/filters_trashed.js';
-export { IncludedCallback } from './src/includes/included_callback.js';
-export { IncludedCount } from './src/includes/included_count.js';
-export { IncludedRelationship } from './src/includes/included_relationship.js';
-export { SortsCallback } from './src/sorts/sorts_callback.js';
-export { SortsField } from './src/sorts/sorts_field.js';
+import { configure } from "./configure.js";
+import { FilterOperator } from "./src/enums/filter_operator.js";
+import { AllowedFilter } from "./src/allowed_filter.js";
+import { AllowedInclude } from "./src/allowed_include.js";
+import { AllowedSort } from "./src/allowed_sort.js";
+import { ApiQueryBuilderRequest } from "./src/api_query_builder_request.js";
+import { defineConfig } from "./src/define_config.js";
+import { SortDirection } from "./src/enums/sort_direction.js";
+import { AllowedFieldsMustBeCalledBeforeAllowedIncludes } from "./src/exceptions/allowed_fields_must_be_called_before_allowed_includes.js";
+import { InvalidQuery } from "./src/exceptions/invalid_query.js";
+import { InvalidAppendQuery } from "./src/exceptions/invalid_append_query.js";
+import { InvalidDirection } from "./src/exceptions/invalid_direction.js";
+import { InvalidFilterQuery } from "./src/exceptions/invalid_filter_query.js";
+import { InvalidFilterValue } from "./src/exceptions/invalid_filter_value.js";
+import { InvalidIncludeQuery } from "./src/exceptions/invalid_include_query.js";
+import { InvalidSortQuery } from "./src/exceptions/invalid_sort_query.js";
+import { UnknownIncludedFieldsQuery } from "./src/exceptions/unknown_included_fields_query.js";
+import { FiltersExact } from "./src/filters/filters_exact.js";
+import { FiltersPartial } from "./src/filters/filters_partial.js";
+import { FiltersBeginWithStrict } from "./src/filters/filters_begin_with_strict.js";
+import { FiltersCallback } from "./src/filters/filters_callback.js";
+import { FiltersEndsWithStrict } from "./src/filters/filters_ends_with_strict.js";
+import { FiltersOperator } from "./src/filters/filters_operator.js";
+import { FiltersTrashed } from "./src/filters/filters_trashed.js";
+import { IncludedCallback } from "./src/includes/included_callback.js";
+import { IncludedCount } from "./src/includes/included_count.js";
+import { IncludedRelationship } from "./src/includes/included_relationship.js";
+import { SortsCallback } from "./src/sorts/sorts_callback.js";
+import { SortsField } from "./src/sorts/sorts_field.js";
+import { stubsRoot } from "./stubs/main.js";
+export * from "collect.js";
+export { AllowedFieldsMustBeCalledBeforeAllowedIncludes, AllowedFilter, AllowedInclude, AllowedSort, ApiQueryBuilderRequest, FilterOperator, FiltersBeginWithStrict, FiltersCallback, FiltersEndsWithStrict, FiltersExact, FiltersOperator, FiltersPartial, FiltersTrashed, IncludedCallback, IncludedCount, IncludedRelationship, InvalidAppendQuery, InvalidDirection, InvalidFilterQuery, InvalidFilterValue, InvalidIncludeQuery, InvalidQuery, InvalidSortQuery, SortDirection, SortsCallback, SortsField, UnknownIncludedFieldsQuery, configure, defineConfig, stubsRoot };

package/build/index.js

@@ -1,154 +1,32 @@
-import {
-  AllowedSort,
-  InvalidDirection,
-  InvalidSortQuery,
-  SortDirection,
-  SortsCallback,
-  SortsField
-} from "./chunk-3ITWUZL5.js";
-import {
-  AllowedFilter,
-  FilterOperator,
-  FiltersBeginWithStrict,
-  FiltersCallback,
-  FiltersEndsWithStrict,
-  FiltersExact,
-  FiltersOperator,
-  FiltersPartial,
-  FiltersTrashed,
-  InvalidFilterQuery
-} from "./chunk-54HNQTDY.js";
-import {
-  ApiQueryBuilderRequest
-} from "./chunk-MKQ3HMMA.js";
-import {
-  AllowedInclude,
-  IncludedCallback,
-  IncludedCount,
-  IncludedRelationship,
-  InvalidIncludeQuery
-} from "./chunk-IV3B5WO7.js";
-import {
-  InvalidQuery
-} from "./chunk-XIRHVLVQ.js";
-
-// stubs/main.ts
-import path from "path";
-import { fileURLToPath } from "url";
-var stubsRoot = path.dirname(fileURLToPath(import.meta.url));
-
-// configure.ts
-var configure = async (command) => {
-  const codemods = await command.createCodemods();
-  await codemods.updateRcFile((rcFile) => {
-    rcFile.addProvider("@eienjs/adonisjs-api-query/api_query_provider");
-  });
-  await codemods.makeUsingStub(stubsRoot, "config.stub", {});
-};
-
-// src/define_config.ts
-import { configProvider } from "@adonisjs/core";
-var defineConfig = function(config) {
-  return configProvider.create(async (_) => {
-    return {
-      parameters: {
-        include: config.parameters?.include ?? "include",
-        filter: config.parameters?.filter ?? "filter",
-        sort: config.parameters?.sort ?? "sort",
-        fields: config.parameters?.fields ?? "fields",
-        append: config.parameters?.append ?? "append"
-      },
-      countSuffix: config.countSuffix ?? "Count",
-      existsSuffix: config.existsSuffix ?? "Exists",
-      disableInvalidFilterQueryException: config.disableInvalidFilterQueryException ?? false,
-      disableInvalidSortQueryException: config.disableInvalidSortQueryException ?? false,
-      disableInvalidIncludesQueryException: config.disableInvalidIncludesQueryException ?? false,
-      convertRelationNamesToSnakeCasePlural: config.convertRelationNamesToSnakeCasePlural ?? false,
-      convertRelationTableNameStrategy: config.convertRelationTableNameStrategy ?? false,
-      convertFieldNamesToSnakeCase: config.convertFieldNamesToSnakeCase ?? false
-    };
-  });
-};
-
-// src/exceptions/allowed_fields_must_be_called_before_allowed_includes.ts
-import { Exception } from "@adonisjs/core/exceptions";
-var AllowedFieldsMustBeCalledBeforeAllowedIncludes = class extends Exception {
-  static code;
-  static status;
-  constructor() {
-    super("The QueryBuilder's `allowedFields` method must be called before the `allowedIncludes` method");
-  }
-};
-
-// src/exceptions/invalid_append_query.ts
-import { ResponseStatus } from "@adonisjs/core/http";
-var InvalidAppendQuery = class _InvalidAppendQuery extends InvalidQuery {
-  constructor(appendsNotAllowed, allowedAppends) {
-    const notAllowed = appendsNotAllowed.join(", ");
-    const allowed = allowedAppends.join(", ");
-    const message = `Requested append(s) \`${notAllowed}\` are not allowed. Allowed append(s) are \`${allowed}\``;
-    super(message, { status: ResponseStatus.BadRequest });
-  }
-  static appendsNotAllowed(appendsNotAllowed, allowedAppends) {
-    return new _InvalidAppendQuery(appendsNotAllowed, allowedAppends);
-  }
-};
-
-// src/exceptions/invalid_filter_value.ts
-import { Exception as Exception2 } from "@adonisjs/core/exceptions";
-var InvalidFilterValue = class _InvalidFilterValue extends Exception2 {
-  static make(value) {
-    return new _InvalidFilterValue(`Filter value \`${value}\` is invalid`);
-  }
-};
-
-// src/exceptions/unknown_included_fields_query.ts
-import { ResponseStatus as ResponseStatus2 } from "@adonisjs/core/http";
-var UnknownIncludedFieldsQuery = class extends InvalidQuery {
-  unknownFields;
-  constructor(unknownFields) {
-    const notAllowed = unknownFields.join(", ");
-    const message = [
-      `Requested field(s) \`${notAllowed}\` are not allowed (yet). `,
-      "If you want to allow these fields, please make sure to call the QueryBuilder's `allowedFields` method before the `allowedIncludes` method"
-    ].join("");
-    super(message, { status: ResponseStatus2.BadRequest });
-    this.unknownFields = unknownFields;
-  }
-};
-
-// index.ts
+import { stubsRoot } from "./stubs/main.js";
+import { configure } from "./configure.js";
+import { ApiQueryBuilderRequest } from "./src/api_query_builder_request.js";
+import { FiltersExact } from "./src/filters/filters_exact.js";
+import { FiltersPartial } from "./src/filters/filters_partial.js";
+import { FiltersBeginWithStrict } from "./src/filters/filters_begin_with_strict.js";
+import { FiltersCallback } from "./src/filters/filters_callback.js";
+import { FiltersEndsWithStrict } from "./src/filters/filters_ends_with_strict.js";
+import { FilterOperator } from "./src/enums/filter_operator.js";
+import { FiltersOperator } from "./src/filters/filters_operator.js";
+import { FiltersTrashed } from "./src/filters/filters_trashed.js";
+import { AllowedFilter } from "./src/allowed_filter.js";
+import { IncludedCallback } from "./src/includes/included_callback.js";
+import { IncludedCount } from "./src/includes/included_count.js";
+import { IncludedRelationship } from "./src/includes/included_relationship.js";
+import { AllowedInclude } from "./src/allowed_include.js";
+import { SortDirection } from "./src/enums/sort_direction.js";
+import { InvalidDirection } from "./src/exceptions/invalid_direction.js";
+import { SortsCallback } from "./src/sorts/sorts_callback.js";
+import { SortsField } from "./src/sorts/sorts_field.js";
+import { AllowedSort } from "./src/allowed_sort.js";
+import { defineConfig } from "./src/define_config.js";
+import { AllowedFieldsMustBeCalledBeforeAllowedIncludes } from "./src/exceptions/allowed_fields_must_be_called_before_allowed_includes.js";
+import { InvalidQuery } from "./src/exceptions/invalid_query.js";
+import { InvalidAppendQuery } from "./src/exceptions/invalid_append_query.js";
+import { InvalidFilterQuery } from "./src/exceptions/invalid_filter_query.js";
+import { InvalidFilterValue } from "./src/exceptions/invalid_filter_value.js";
+import { InvalidIncludeQuery } from "./src/exceptions/invalid_include_query.js";
+import { InvalidSortQuery } from "./src/exceptions/invalid_sort_query.js";
+import { UnknownIncludedFieldsQuery } from "./src/exceptions/unknown_included_fields_query.js";
 export * from "collect.js";
-export {
-  AllowedFieldsMustBeCalledBeforeAllowedIncludes,
-  AllowedFilter,
-  AllowedInclude,
-  AllowedSort,
-  ApiQueryBuilderRequest,
-  FilterOperator,
-  FiltersBeginWithStrict,
-  FiltersCallback,
-  FiltersEndsWithStrict,
-  FiltersExact,
-  FiltersOperator,
-  FiltersPartial,
-  FiltersTrashed,
-  IncludedCallback,
-  IncludedCount,
-  IncludedRelationship,
-  InvalidAppendQuery,
-  InvalidDirection,
-  InvalidFilterQuery,
-  InvalidFilterValue,
-  InvalidIncludeQuery,
-  InvalidQuery,
-  InvalidSortQuery,
-  SortDirection,
-  SortsCallback,
-  SortsField,
-  UnknownIncludedFieldsQuery,
-  configure,
-  defineConfig,
-  stubsRoot
-};
-//# sourceMappingURL=index.js.map
+export { AllowedFieldsMustBeCalledBeforeAllowedIncludes, AllowedFilter, AllowedInclude, AllowedSort, ApiQueryBuilderRequest, FilterOperator, FiltersBeginWithStrict, FiltersCallback, FiltersEndsWithStrict, FiltersExact, FiltersOperator, FiltersPartial, FiltersTrashed, IncludedCallback, IncludedCount, IncludedRelationship, InvalidAppendQuery, InvalidDirection, InvalidFilterQuery, InvalidFilterValue, InvalidIncludeQuery, InvalidQuery, InvalidSortQuery, SortDirection, SortsCallback, SortsField, UnknownIncludedFieldsQuery, configure, defineConfig, stubsRoot };

package/build/providers/api_query_provider.d.ts

@@ -1,42 +1,46 @@
-import { type Request } from '@adonisjs/core/http';
-import { type ApplicationService } from '@adonisjs/core/types';
-import { type LucidModel } from '@adonisjs/lucid/types/model';
-import { type ExtractModelRelations } from '@adonisjs/lucid/types/relations';
-import { type Collection } from 'collect.js';
-import { type AllowedFilter } from '../src/allowed_filter.js';
-import { type AllowedInclude } from '../src/allowed_include.js';
-import { type AllowedSort } from '../src/allowed_sort.js';
-import { type ApiQueryBuilderRequest } from '../src/api_query_builder_request.js';
-import { type ExtractKeys, type HintedString, type SortUnionKeyParams } from '../src/types.js';
-export default class ApiQueryProvider {
-    protected app: ApplicationService;
-    constructor(app: ApplicationService);
-    boot(): Promise<void>;
+import { ExtractKeys, HintedString, SortUnionKeyParams } from "../types.js";
+import { AllowedFilter } from "../src/allowed_filter.js";
+import { AllowedInclude } from "../src/allowed_include.js";
+import { AllowedSort } from "../src/allowed_sort.js";
+import { ApiQueryBuilderRequest } from "../src/api_query_builder_request.js";
+import { Collection } from "collect.js";
+import { HttpRequest } from "@adonisjs/core/http";
+import { LucidModel } from "@adonisjs/lucid/types/model";
+import { ExtractModelRelations } from "@adonisjs/lucid/types/relations";
+import { ApplicationService } from "@adonisjs/core/types";
+
+//#region providers/api_query_provider.d.ts
+declare class ApiQueryProvider {
+  protected app: ApplicationService;
+  constructor(app: ApplicationService);
+  boot(): Promise<void>;
 }
 declare module '@adonisjs/lucid/orm' {
-    interface ModelQueryBuilder {
-        withRequest(request: Request): this;
-        $apiQueryBuilderRequest: ApiQueryBuilderRequest;
-        allowedSorts(...sorts: (AllowedSort<LucidModel> | string)[]): this;
-        allowedSorts(sorts: (AllowedSort<LucidModel> | string)[]): this;
-        defaultSort(...sorts: (AllowedSort<LucidModel> | string)[]): this;
-        defaultSort(sorts: (AllowedSort<LucidModel> | string)[]): this;
-        allowedFilters(...filters: (AllowedFilter<LucidModel> | string)[]): this;
-        allowedFilters(filters: (AllowedFilter<LucidModel> | string)[]): this;
-        allowedIncludes(...includes: (Collection<AllowedInclude<LucidModel>> | string)[]): this;
-        allowedIncludes(includes: (Collection<AllowedInclude<LucidModel>> | string)[]): this;
-    }
+  interface ModelQueryBuilder {
+    withRequest(request: HttpRequest): this;
+    $apiQueryBuilderRequest: ApiQueryBuilderRequest;
+    allowedSorts(...sorts: (AllowedSort<LucidModel> | string)[]): this;
+    allowedSorts(sorts: (AllowedSort<LucidModel> | string)[]): this;
+    defaultSort(...sorts: (AllowedSort<LucidModel> | string)[]): this;
+    defaultSort(sorts: (AllowedSort<LucidModel> | string)[]): this;
+    allowedFilters(...filters: (AllowedFilter<LucidModel> | string)[]): this;
+    allowedFilters(filters: (AllowedFilter<LucidModel> | string)[]): this;
+    allowedIncludes(...includes: (Collection<AllowedInclude<LucidModel>> | string)[]): this;
+    allowedIncludes(includes: (Collection<AllowedInclude<LucidModel>> | string)[]): this;
+  }
 }
 declare module '@adonisjs/lucid/types/model' {
-    interface ModelQueryBuilderContract<Model extends LucidModel, Result = InstanceType<Model>> {
-        withRequest(request: Request): this;
-        allowedSorts(...sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
-        allowedSorts(sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
-        defaultSort(...sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
-        defaultSort(sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
-        allowedFilters(...filters: (AllowedFilter<Model> | HintedString<ExtractKeys<ModelAttributes<InstanceType<Model>>>>)[]): this;
-        allowedFilters(filters: (AllowedFilter<Model> | HintedString<ExtractKeys<ModelAttributes<InstanceType<Model>>>>)[]): this;
-        allowedIncludes(...includes: (Collection<AllowedInclude<Model>> | HintedString<ExtractModelRelations<InstanceType<Model>>>)[]): this;
-        allowedIncludes(includes: (Collection<AllowedInclude<Model>> | HintedString<ExtractModelRelations<InstanceType<Model>>>)[]): this;
-    }
+  interface ModelQueryBuilderContract<Model extends LucidModel, Result = InstanceType<Model>> {
+    withRequest(request: HttpRequest): this;
+    allowedSorts(...sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
+    allowedSorts(sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
+    defaultSort(...sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
+    defaultSort(sorts: (AllowedSort<Model> | HintedString<SortUnionKeyParams<Model>>)[]): this;
+    allowedFilters(...filters: (AllowedFilter<Model> | HintedString<ExtractKeys<ModelAttributes<InstanceType<Model>>>>)[]): this;
+    allowedFilters(filters: (AllowedFilter<Model> | HintedString<ExtractKeys<ModelAttributes<InstanceType<Model>>>>)[]): this;
+    allowedIncludes(...includes: (Collection<AllowedInclude<Model>> | HintedString<ExtractModelRelations<InstanceType<Model>>>)[]): this;
+    allowedIncludes(includes: (Collection<AllowedInclude<Model>> | HintedString<ExtractModelRelations<InstanceType<Model>>>)[]): this;
+  }
 }
+//#endregion
+export { ApiQueryProvider as default };

package/build/providers/api_query_provider.js

@@ -1,30 +1,25 @@
-// providers/api_query_provider.ts
-import { configProvider } from "@adonisjs/core";
 import { RuntimeException } from "@adonisjs/core/exceptions";
+import { configProvider } from "@adonisjs/core";
 import { ModelQueryBuilder } from "@adonisjs/lucid/orm";
+//#region providers/api_query_provider.ts
 var ApiQueryProvider = class {
-  constructor(app) {
-    this.app = app;
-  }
-  async boot() {
-    const { extendModelQueryBuilderWithRequest } = await import("../api_query_request-QXOB4BN6.js");
-    const { extendModelQueryBuilderWithSortsQuery } = await import("../sorts_query-NJTC5UXX.js");
-    const { extendModelQueryBuilderWithFiltersQuery } = await import("../filters_query-LCFH2F2X.js");
-    const { extendModelQueryBuilderWithIncludesQuery } = await import("../includes_query-PVONWQMC.js");
-    const apiQueryConfigProvider = this.app.config.get("apiquery");
-    const config = await configProvider.resolve(this.app, apiQueryConfigProvider);
-    if (!config) {
-      throw new RuntimeException(
-        'Invalid "config/apiquery.ts" file. Make sure you are using the "defineConfig" method'
-      );
-    }
-    extendModelQueryBuilderWithRequest(ModelQueryBuilder);
-    extendModelQueryBuilderWithSortsQuery(ModelQueryBuilder, config);
-    extendModelQueryBuilderWithFiltersQuery(ModelQueryBuilder, config);
-    extendModelQueryBuilderWithIncludesQuery(ModelQueryBuilder, config);
-  }
-};
-export {
-  ApiQueryProvider as default
+	app;
+	constructor(app) {
+		this.app = app;
+	}
+	async boot() {
+		const { extendModelQueryBuilderWithRequest } = await import("../src/bindings/api_query_request.js");
+		const { extendModelQueryBuilderWithSortsQuery } = await import("../src/bindings/sorts_query.js");
+		const { extendModelQueryBuilderWithFiltersQuery } = await import("../src/bindings/filters_query.js");
+		const { extendModelQueryBuilderWithIncludesQuery } = await import("../src/bindings/includes_query.js");
+		const apiQueryConfigProvider = this.app.config.get("apiquery");
+		const config = await configProvider.resolve(this.app, apiQueryConfigProvider);
+		if (!config) throw new RuntimeException("Invalid \"config/apiquery.ts\" file. Make sure you are using the \"defineConfig\" method");
+		extendModelQueryBuilderWithRequest(ModelQueryBuilder);
+		extendModelQueryBuilderWithSortsQuery(ModelQueryBuilder, config);
+		extendModelQueryBuilderWithFiltersQuery(ModelQueryBuilder, config);
+		extendModelQueryBuilderWithIncludesQuery(ModelQueryBuilder, config);
+	}
 };
-//# sourceMappingURL=api_query_provider.js.map
+//#endregion
+export { ApiQueryProvider as default };

package/build/src/allowed_filter.d.ts

@@ -1,37 +1,41 @@
-import { type LucidModel, type ModelAttributes, type ModelQueryBuilderContract } from '@adonisjs/lucid/types/model';
-import { type StrictValuesWithoutRaw } from '@adonisjs/lucid/types/querybuilder';
-import { Collection } from 'collect.js';
-import { type FilterOperator } from './enums/filter_operator.js';
-import { type ExtractKeys, type Filter } from './types.js';
-export declare class AllowedFilter<Model extends LucidModel> {
-    static setFilterArrayValueDelimiter(delimiter?: string): void;
-    static exact<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, addRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    static partial<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, addRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    static beginsWithStrict<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, addRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    static endsWithStrict<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, addRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    static callback<Model extends LucidModel>(name: string, callback: (query: ModelQueryBuilderContract<Model>, value: unknown, property: string) => void, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    static trashed<Model extends LucidModel>(name?: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>): AllowedFilter<Model>;
-    static custom<Model extends LucidModel>(name: string, filterClass: Filter<Model>, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    static operator<Model extends LucidModel>(name: string, filterOperator: FilterOperator, boolean?: 'and' | 'or', internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, addRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
-    protected name: string;
-    protected filterClass: Filter<Model>;
-    protected internalName: string;
-    protected ignored: Collection<unknown>;
-    protected default: unknown;
-    protected $hasDefault: boolean;
-    protected nullable: boolean;
-    constructor(name: string, filterClass: Filter<Model>, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>);
-    filter(query: ModelQueryBuilderContract<Model>, value: unknown): void;
-    getFilterClass(): Filter<Model>;
-    getName(): string;
-    isForFilter(filterName: string): boolean;
-    ignore(...values: unknown[]): this;
-    getIgnored(): unknown[];
-    getInternalName(): string;
-    setDefault(defaultValue: unknown): this;
-    getDefault(): unknown;
-    hasDefault(): boolean;
-    setNullable(nullable?: boolean): this;
-    unsetDefault(): this;
-    protected resolveValueForFiltering(value: unknown): StrictValuesWithoutRaw | null;
+import { FilterOperator } from "./enums/filter_operator.js";
+import { EnumType, ExtractKeys, Filter } from "../types.js";
+import { Collection } from "collect.js";
+import { LucidModel, ModelAttributes, ModelQueryBuilderContract } from "@adonisjs/lucid/types/model";
+import { StrictValuesWithoutRaw } from "@adonisjs/lucid/types/querybuilder";
+
+//#region src/allowed_filter.d.ts
+declare class AllowedFilter<Model extends LucidModel> {
+  protected name: string;
+  protected filterClass: Filter<Model>;
+  protected internalName: string;
+  protected ignored: Collection<unknown>;
+  protected default: unknown;
+  protected $hasDefault: boolean;
+  protected nullable: boolean;
+  constructor(name: string, filterClass: Filter<Model>, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>);
+  filter(query: ModelQueryBuilderContract<Model>, value: unknown): void;
+  getFilterClass(): Filter<Model>;
+  getName(): string;
+  isForFilter(filterName: string): boolean;
+  ignore(...values: unknown[]): this;
+  getIgnored(): unknown[];
+  getInternalName(): string;
+  setDefault(defaultValue: unknown): this;
+  getDefault(): unknown;
+  hasDefault(): boolean;
+  setNullable(isNullable?: boolean): this;
+  unsetDefault(): this;
+  protected resolveValueForFiltering(value: unknown): StrictValuesWithoutRaw | null;
+  static setFilterArrayValueDelimiter(delimiter?: string): void;
+  static exact<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, shouldAddRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
+  static partial<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, shouldAddRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
+  static beginsWithStrict<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, shouldAddRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
+  static endsWithStrict<Model extends LucidModel>(name: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, shouldAddRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
+  static callback<Model extends LucidModel>(name: string, callback: (query: ModelQueryBuilderContract<Model>, value: unknown, property: string) => void, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, arrayValueDelimiter?: string): AllowedFilter<Model>;
+  static trashed<Model extends LucidModel>(name?: string, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>): AllowedFilter<Model>;
+  static custom<Model extends LucidModel>(name: string, filterClass: Filter<Model>, internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, arrayValueDelimiter?: string): AllowedFilter<Model>;
+  static operator<Model extends LucidModel>(name: string, filterOperator: EnumType<typeof FilterOperator>, boolean?: 'and' | 'or', internalName?: ExtractKeys<ModelAttributes<InstanceType<Model>>>, shouldAddRelationConstraint?: boolean, arrayValueDelimiter?: string): AllowedFilter<Model>;
 }
+//#endregion
+export { AllowedFilter };