@edium/halifax 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,293 @@
+import type { IQueryOptions } from '../interfaces/IQueryOptions.js';
+/** HTTP methods supported by Halifax routes. `'*'` matches any method (used for 405 fallbacks). */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | '*';
+/** Framework-agnostic representation of an incoming HTTP request. */
+export interface HttpRequest<TRaw = unknown> {
+    method: string;
+    params: Record<string, string>;
+    query: Record<string, unknown>;
+    body: unknown;
+    headers: Record<string, string | string[] | undefined>;
+    /** The underlying raw request object from the HTTP framework (e.g. Express `Request`). */
+    raw: TRaw;
+}
+/** Framework-agnostic representation of an outgoing HTTP response. */
+export interface HttpResponse<TRaw = unknown> {
+    /**
+     * Set the HTTP status code. Returns `this` for chaining.
+     * @param code - HTTP status code to send (e.g. `200`, `404`).
+     * @returns This response object for method chaining.
+     */
+    status(code: number): HttpResponse<TRaw>;
+    /**
+     * Serialize `payload` as JSON and send it as the response body.
+     * @param payload - Value to serialize and send.
+     */
+    json(payload: unknown): void | Promise<void>;
+    /**
+     * Send a raw response body.
+     * @param payload - Raw body to send.
+     */
+    send?(payload?: unknown): void | Promise<void>;
+    /**
+     * Set a response header.
+     * @param name - Header name (e.g. `'Content-Type'`).
+     * @param value - Header value.
+     */
+    setHeader?(name: string, value: string): void;
+    /** The underlying raw response object from the HTTP framework (e.g. Express `Response`). */
+    raw: TRaw;
+}
+/** A route handler function compatible with Halifax's framework-agnostic request/response types. */
+export type HttpRouteHandler = (req: HttpRequest, res: HttpResponse) => Promise<void> | void;
+/** Minimal interface an HTTP server adapter must implement for Halifax to register routes. */
+export interface HttpServer {
+    /**
+     * Register a route handler for the given method and path.
+     * @param method - HTTP method (or `'*'` for a catch-all fallback).
+     * @param path - Route path pattern (e.g. `'/users/:id'`).
+     * @param handler - Async handler function to invoke on matching requests.
+     */
+    registerRoute(method: HttpMethod, path: string, handler: HttpRouteHandler): void;
+    /**
+     * Start listening on the given port and optional host.
+     * @param port - TCP port number to bind to.
+     * @param host - Hostname or IP address to bind to (defaults to all interfaces).
+     */
+    start(port: number, host?: string): Promise<void> | void;
+}
+/** Flags indicating which optional repository operations the adapter supports. */
+export interface RepositoryCapabilities {
+    /** True when the adapter can execute raw SQL via the query builder. */
+    supportsNativeSql: boolean;
+    /** True when the adapter supports `?include=` for eager-loading relations. */
+    supportsIncludes: boolean;
+    /** True when the adapter can participate in database transactions. */
+    supportsTransactions: boolean;
+    /** True when `createMany` returns the created records rather than an empty array. */
+    supportsCreateManyReturn: boolean;
+    /** True when the adapter accepts a NoSQL-style query AST (non-SQL ORMs). */
+    supportsNoSqlQueryAst: boolean;
+}
+/** Options for paginated, filtered, and sorted list queries. */
+export interface ListOptions {
+    /** Columns to return. Returns all columns when omitted. */
+    fields?: string[] | undefined;
+    /** Key–value pairs applied as equality filters (or `{ in: [...] }` for multi-value). */
+    where?: Record<string, unknown>;
+    /** Maximum number of records to return. */
+    limit?: number | undefined;
+    /** Number of records to skip for pagination. */
+    offset?: number | undefined;
+    /** Sort expressions. Each entry specifies a field name and direction. */
+    orderBy?: Array<{
+        field: string;
+        direction: 'asc' | 'desc';
+    }> | undefined;
+    /** Relation names to eager-load. */
+    include?: string[] | undefined;
+}
+/** Paginated result envelope returned by `getMany`. */
+export interface ListResult<TRecord> {
+    /** Total number of matching records (before pagination). */
+    count: number;
+    /** Records for the current page. */
+    results: TRecord[];
+}
+/** Result envelope returned by `deleteMany`. */
+export interface DeleteManyResult {
+    /** IDs (or records) of the deleted rows. */
+    deleted: unknown[];
+}
+/** Result envelope returned by `updateMany`. */
+export interface UpdateManyResult<TRecord> {
+    /** IDs of the updated rows. */
+    updated: unknown[];
+    /** Updated records, when the adapter supports returning them. */
+    results?: TRecord[];
+}
+/** Result envelope returned by `executeQueryBuilder`. */
+export interface NativeQueryResult<TRecord> {
+    /** Total number of matching records (before pagination). */
+    count?: number;
+    /** Records for the current page. */
+    results: TRecord[];
+}
+/** Options passed to `createOne` / `createMany` for idempotent writes. */
+export interface CreateOptions {
+    /** An idempotency key — the adapter may de-duplicate requests with the same key. */
+    idempotencyKey?: string;
+}
+/** Core data-access contract that every Halifax repository adapter must satisfy. */
+export interface Repository<TRecord = unknown, TCreate = Partial<TRecord>, TUpdate = Partial<TRecord>> {
+    /** Optional capability flags used by Halifax to decide which routes to activate. */
+    readonly capabilities?: Partial<RepositoryCapabilities>;
+    /**
+     * Fetch a single record by its primary key.
+     * @param id - Primary key value (integer or UUID string).
+     * @param options - Optional field projection and relation includes.
+     * @returns The matching record, or `null` when not found.
+     */
+    getOne(id: string | number, options?: Pick<ListOptions, 'fields' | 'include'>): Promise<TRecord | null>;
+    /**
+     * Fetch a paginated, filtered list of records.
+     * @param options - Pagination, filtering, sorting, and projection options.
+     * @returns A count-and-results envelope for the current page.
+     */
+    getMany(options?: ListOptions): Promise<ListResult<TRecord>>;
+    /**
+     * Insert a single record and return it.
+     * @param data - Record fields to insert.
+     * @param options - Optional idempotency key.
+     * @returns The newly created record.
+     */
+    createOne(data: TCreate, options?: CreateOptions): Promise<TRecord>;
+    /**
+     * Insert multiple records. Returns created records when the adapter supports it.
+     * @param data - Array of record field objects to insert.
+     * @param options - Optional idempotency key.
+     * @returns The created records, or an empty array when the adapter uses bulk insert.
+     */
+    createMany(data: TCreate[], options?: CreateOptions): Promise<TRecord[]>;
+    /**
+     * Update a single record by its primary key.
+     * @param id - Primary key of the record to update.
+     * @param data - Fields to update.
+     * @returns The updated record, or `null` when not found.
+     */
+    updateOne(id: string | number, data: TUpdate): Promise<TRecord | null>;
+    /**
+     * Update multiple records matching the query.
+     * @param query - Query AST describing which rows to update.
+     * @param data - Fields to apply to all matching rows.
+     * @returns IDs of the updated rows (and optionally the updated records).
+     */
+    updateMany?(query: IQueryOptions, data: TUpdate): Promise<UpdateManyResult<TRecord>>;
+    /**
+     * Insert or update a single record by its primary key.
+     * @param id - Primary key to match for the update, or use for the insert.
+     * @param data - Fields to create or update.
+     * @returns The created or updated record.
+     */
+    upsertOne?(id: string | number, data: TCreate & TUpdate): Promise<TRecord>;
+    /**
+     * Delete a single record by its primary key.
+     * @param id - Primary key of the record to delete.
+     * @returns `true` when deleted, `false` when not found.
+     */
+    deleteOne(id: string | number): Promise<boolean>;
+    /**
+     * Delete multiple records matching the query.
+     * @param query - Query AST describing which rows to delete.
+     * @returns IDs of the deleted rows.
+     */
+    deleteMany?(query: IQueryOptions): Promise<DeleteManyResult>;
+    /**
+     * Execute a raw query-builder AST against the underlying data source.
+     * @param query - Full query AST including table name, filters, pagination, and sort.
+     * @returns A count-and-results envelope for the matching rows.
+     */
+    executeQueryBuilder?(query: IQueryOptions): Promise<NativeQueryResult<TRecord>>;
+}
+/** All CRUD action identifiers used for permissions and audit. */
+export type CrudAction = 'create' | 'readOne' | 'readMany' | 'readManyWithQueryBuilder' | 'updateOne' | 'updateMany' | 'upsertOne' | 'deleteOne' | 'deleteMany';
+/** Per-action toggles controlling which CRUD endpoints are registered for a resource. */
+export interface CrudPermissions {
+    allowCreate?: boolean;
+    allowReadOne?: boolean;
+    allowReadMany?: boolean;
+    allowReadManyWithQueryBuilder?: boolean;
+    allowUpdateOne?: boolean;
+    allowUpdateMany?: boolean;
+    allowUpsertOne?: boolean;
+    allowDeleteOne?: boolean;
+    allowDeleteMany?: boolean;
+}
+/** Minimal shape of a Prisma DMMF field — structurally compatible with `Prisma.DMMF.Field`. */
+export interface ModelField {
+    /** Column / property name. */
+    name: string;
+    /** Prisma field kind: `'scalar'`, `'object'` (relation), `'enum'`, or `'unsupported'`. */
+    kind: string;
+    /** True when this field is the model's primary key. */
+    isId: boolean;
+    /** True for fields that are auto-managed by Prisma (e.g. relation FKs, read-only scalars). */
+    isReadOnly: boolean;
+    /** True when Prisma provides a default value (e.g. `@default(autoincrement())`). */
+    hasDefault: boolean;
+}
+/** Minimal shape of a Prisma DMMF model — structurally compatible with `Prisma.DMMF.Model`. */
+export interface ModelSchema {
+    /** Prisma model name (PascalCase). */
+    name?: string;
+    /** Underlying database table name, or `null` to use the model name. */
+    dbName?: string | null;
+    fields: ModelField[];
+}
+/** Per-model overrides for {@link createPrismaResources}. */
+export interface ModelResourceOptions {
+    /** When true, this model is skipped entirely. */
+    exclude?: boolean;
+    /** Override the URL prefix (default: auto-derived kebab-plural of the model name). */
+    routePrefix?: string;
+    /** Override the database table name. */
+    tableName?: string;
+    /** Override the default CRUD permissions for this model. */
+    permissions?: CrudPermissions;
+    /** Required permission strings per action for fine-grained access control. */
+    requiredPermissions?: Partial<Record<CrudAction, string[]>>;
+    /** Default page size when the caller omits `?limit=`. */
+    defaultLimit?: number;
+    /** Hard cap on page size. Requests above this are silently capped. */
+    maxLimit?: number;
+    /** Maximum nesting depth for WHERE clause children (default: 3). */
+    maxFilterDepth?: number;
+}
+/** Describes a single column exposed through the Halifax API. */
+export interface FieldDefinition {
+    /** Column / property name. */
+    name: string;
+    /** When `false`, the field cannot be used in `?field=` filters. */
+    filterable?: boolean;
+    /** When `false`, the field cannot be used in `?order=` sorts. */
+    sortable?: boolean;
+    /** When `false`, the field is excluded from `?fields=` projections. */
+    selectable?: boolean;
+    /** When `false`, the field is stripped from POST/PATCH request bodies. */
+    writable?: boolean;
+}
+/** Describes a relation that callers may eagerly load via `?include=`. */
+export interface RelationDefinition {
+    /** Relation name as defined on the Prisma model. */
+    name: string;
+    /** When `false`, this relation cannot be requested via `?include=`. */
+    includable?: boolean;
+}
+/** Full definition of a Halifax resource: its repository, field schema, routing, and permissions. */
+export interface ResourceDefinition<TRecord = unknown, TCreate = Partial<TRecord>, TUpdate = Partial<TRecord>> {
+    /** Human-readable resource name (usually the Prisma model name). */
+    name: string;
+    /** URL path segment (e.g. `'users'`, `'blog-posts'`). */
+    routePrefix: string;
+    /** Database table name used by the query builder. */
+    tableName?: string;
+    /** Scalar field definitions — controls filtering, sorting, selection, and write access. */
+    fields: FieldDefinition[];
+    /** Relation definitions — controls `?include=` access. */
+    relations?: RelationDefinition[];
+    /** CRUD operation toggles. Defaults to {@link defaultCrudPermissions}. */
+    permissions?: CrudPermissions;
+    /** The data adapter that handles reads and writes for this resource. */
+    repository: Repository<TRecord, TCreate, TUpdate>;
+    /** Required permission strings per action (checked by the auth strategy). */
+    requiredPermissions?: Partial<Record<CrudAction, string[]>>;
+    /** Default page size when the caller omits `?limit=`. No limit applied when `undefined`. */
+    defaultLimit?: number;
+    /** Hard cap on page size. Requests over this are silently capped. No cap when `undefined`. */
+    maxLimit?: number;
+    /** Maximum nesting depth for WHERE clause children. Defaults to 3. */
+    maxFilterDepth?: number;
+}
+/** Default permissions applied to every resource — all CRUD operations enabled. */
+export declare const defaultCrudPermissions: Required<CrudPermissions>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,13 @@
+/** Default permissions applied to every resource — all CRUD operations enabled. */
+export const defaultCrudPermissions = {
+    allowCreate: true,
+    allowReadOne: true,
+    allowReadMany: true,
+    allowReadManyWithQueryBuilder: true,
+    allowUpdateOne: true,
+    allowUpdateMany: true,
+    allowUpsertOne: true,
+    allowDeleteOne: true,
+    allowDeleteMany: true
+};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AA+UA,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAA8B;IAC/D,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,6BAA6B,EAAE,IAAI;IACnC,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;CACtB,CAAA"}

package/dist/core/validation.d.ts

@@ -0,0 +1,75 @@
+import type { IQueryFilter } from '../interfaces/IQueryFilter.js';
+import type { IQueryOptions } from '../interfaces/IQueryOptions.js';
+import type { ResourceDefinition } from '../core/types.js';
+/**
+ * Returns `true` when `value` is a safe 32-bit integer >= `min`.
+ * @param value - Raw value to test (string or number).
+ * @param min - Inclusive lower bound (default: `1`).
+ * @returns `true` when value is a valid integer within the 32-bit range and >= min.
+ */
+export declare function isValidInt32(value: string | number | null, min?: number): boolean;
+/**
+ * Returns `true` when `value` is a valid RFC 4122 UUID.
+ * @param value - String to test.
+ * @returns `true` when `value` matches the UUID format.
+ */
+export declare function isValidUuid(value: string): boolean;
+/**
+ * Asserts that `value` is a valid integer ID or UUID string.
+ * Throws {@link BadRequestError} when validation fails.
+ * @param value - Raw `:id` route parameter to validate.
+ */
+export declare function validateId(value: string | number | undefined): asserts value is string | number;
+/**
+ * Returns the list of field names defined on a resource.
+ * @param resource - The resource definition to extract field names from.
+ * @returns Array of field name strings.
+ */
+export declare function getFieldNames(resource: ResourceDefinition): string[];
+/**
+ * Throws {@link UnprocessableEntityError} when any of `fields` are not defined on the resource.
+ * @param resource - The resource definition to validate against.
+ * @param fields - Field names to validate (empty array is a no-op).
+ */
+export declare function validateFields(resource: ResourceDefinition, fields?: string[]): void;
+/**
+ * Throws {@link UnprocessableEntityError} when any of `fields` have `selectable: false`.
+ * @param resource - The resource definition to validate against.
+ * @param fields - Field names to check for selectability.
+ */
+export declare function validateSelectableFields(resource: ResourceDefinition, fields: string[]): void;
+/**
+ * Throws {@link UnprocessableEntityError} when any of `fields` have `sortable: false`.
+ * @param resource - The resource definition to validate against.
+ * @param fields - Field names to check for sortability.
+ */
+export declare function validateSortableFields(resource: ResourceDefinition, fields: string[]): void;
+/**
+ * Throws {@link UnprocessableEntityError} when any of `includes` reference non-includable relations.
+ * @param resource - The resource definition whose relations are checked.
+ * @param includes - Relation names to validate.
+ */
+export declare function validateIncludes(resource: ResourceDefinition, includes?: string[]): void;
+/**
+ * Validates that every query-string key is either a reserved parameter or a filterable field.
+ * Throws {@link UnprocessableEntityError} for non-filterable fields or unknown properties.
+ * @param resource - The resource definition whose fields are checked.
+ * @param query - The raw query-string object from the HTTP request.
+ */
+export declare function validateQueryString(resource: ResourceDefinition, query: Record<string, unknown>): void;
+/**
+ * Validates a WHERE clause filter tree against the resource's field definitions.
+ * Throws {@link UnprocessableEntityError} on invalid fields, comparisons, operators, or exceeded nesting depth.
+ * @param resource - The resource definition whose fields and depth limit are used.
+ * @param where - Array of filter conditions to validate.
+ * @param depth - Current recursion depth (used for nesting-limit enforcement; start at `0`).
+ */
+export declare function validateWhere(resource: ResourceDefinition, where?: IQueryFilter[], depth?: number): void;
+/**
+ * Validates a full query-builder AST (fields, orderBy, where) against the resource's schema.
+ * Throws {@link UnprocessableEntityError} on any invalid input.
+ * @param resource - The resource definition used for field and relation validation.
+ * @param query - The query AST to validate.
+ */
+export declare function validateAdvancedQuery(resource: ResourceDefinition, query: IQueryOptions): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIzD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,GAAG,SAAI,GAAG,OAAO,CAM5E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,MAAM,CAS/F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,IAAI,CASxF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAQ7F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAQ3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,IAAI,CAkB5F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CA0BN;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,GAAE,YAAY,EAAO,EAC1B,KAAK,SAAI,GACR,IAAI,CAsCN;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAmB9F"}

package/dist/core/validation.js

@@ -0,0 +1,206 @@
+import { validate as uuidValidate } from 'uuid';
+import { SqlComparison } from '../enums/SqlComparison.js';
+import { SqlOperator } from '../enums/SqlOperator.js';
+import { SqlOrder } from '../enums/SqlOrder.js';
+import { BadRequestError } from '../errors/BadRequestError.js';
+import { UnprocessableEntityError } from '../errors/UnprocessableEntityError.js';
+const reservedQueryStringProperties = ['fields', 'limit', 'offset', 'order', 'include'];
+/**
+ * Returns `true` when `value` is a safe 32-bit integer >= `min`.
+ * @param value - Raw value to test (string or number).
+ * @param min - Inclusive lower bound (default: `1`).
+ * @returns `true` when value is a valid integer within the 32-bit range and >= min.
+ */
+export function isValidInt32(value, min = 1) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    const normalized = typeof value === 'string' ? Number(value.trim()) : value;
+    return Number.isSafeInteger(normalized) && normalized >= min && normalized <= 2147483647;
+}
+/**
+ * Returns `true` when `value` is a valid RFC 4122 UUID.
+ * @param value - String to test.
+ * @returns `true` when `value` matches the UUID format.
+ */
+export function isValidUuid(value) {
+    return uuidValidate(value);
+}
+/**
+ * Asserts that `value` is a valid integer ID or UUID string.
+ * Throws {@link BadRequestError} when validation fails.
+ * @param value - Raw `:id` route parameter to validate.
+ */
+export function validateId(value) {
+    if (value === undefined) {
+        throw new BadRequestError('Id parameter must be an integer (1–2147483647) or a valid UUID.');
+    }
+    const isInt = isValidInt32(value);
+    const isUuid = typeof value === 'string' && isValidUuid(value);
+    if (!isInt && !isUuid) {
+        throw new BadRequestError('Id parameter must be an integer (1–2147483647) or a valid UUID.');
+    }
+}
+/**
+ * Returns the list of field names defined on a resource.
+ * @param resource - The resource definition to extract field names from.
+ * @returns Array of field name strings.
+ */
+export function getFieldNames(resource) {
+    return resource.fields.map((field) => {
+        return field.name;
+    });
+}
+/**
+ * Throws {@link UnprocessableEntityError} when any of `fields` are not defined on the resource.
+ * @param resource - The resource definition to validate against.
+ * @param fields - Field names to validate (empty array is a no-op).
+ */
+export function validateFields(resource, fields = []) {
+    const validFields = new Set(getFieldNames(resource));
+    const invalidFields = fields.filter((field) => {
+        return !validFields.has(field);
+    });
+    if (invalidFields.length) {
+        throw new UnprocessableEntityError(`Invalid field(s): ${invalidFields.join(', ')}.`);
+    }
+}
+/**
+ * Throws {@link UnprocessableEntityError} when any of `fields` have `selectable: false`.
+ * @param resource - The resource definition to validate against.
+ * @param fields - Field names to check for selectability.
+ */
+export function validateSelectableFields(resource, fields) {
+    const nonSelectable = fields.filter((name) => {
+        const field = resource.fields.find((f) => f.name === name);
+        return field?.selectable === false;
+    });
+    if (nonSelectable.length) {
+        throw new UnprocessableEntityError(`Field(s) not selectable: ${nonSelectable.join(', ')}.`);
+    }
+}
+/**
+ * Throws {@link UnprocessableEntityError} when any of `fields` have `sortable: false`.
+ * @param resource - The resource definition to validate against.
+ * @param fields - Field names to check for sortability.
+ */
+export function validateSortableFields(resource, fields) {
+    const nonSortable = fields.filter((name) => {
+        const field = resource.fields.find((f) => f.name === name);
+        return field?.sortable === false;
+    });
+    if (nonSortable.length) {
+        throw new UnprocessableEntityError(`Field(s) not sortable: ${nonSortable.join(', ')}.`);
+    }
+}
+/**
+ * Throws {@link UnprocessableEntityError} when any of `includes` reference non-includable relations.
+ * @param resource - The resource definition whose relations are checked.
+ * @param includes - Relation names to validate.
+ */
+export function validateIncludes(resource, includes = []) {
+    const validIncludes = new Set((resource.relations ?? [])
+        .filter((relation) => {
+        return relation.includable !== false;
+    })
+        .map((relation) => {
+        return relation.name;
+    }));
+    const invalidIncludes = includes.filter((include) => {
+        return !validIncludes.has(include);
+    });
+    if (invalidIncludes.length) {
+        throw new UnprocessableEntityError(`Invalid include(s): ${invalidIncludes.join(', ')}.`);
+    }
+}
+/**
+ * Validates that every query-string key is either a reserved parameter or a filterable field.
+ * Throws {@link UnprocessableEntityError} for non-filterable fields or unknown properties.
+ * @param resource - The resource definition whose fields are checked.
+ * @param query - The raw query-string object from the HTTP request.
+ */
+export function validateQueryString(resource, query) {
+    const filterableFieldNames = resource.fields
+        .filter((f) => f.filterable !== false)
+        .map((f) => f.name);
+    const allFieldNames = new Set(getFieldNames(resource));
+    const validProps = new Set([...filterableFieldNames, ...reservedQueryStringProperties]);
+    const nonFilterable = [];
+    const unknown = [];
+    for (const prop of Object.keys(query)) {
+        if (!validProps.has(prop)) {
+            if (allFieldNames.has(prop)) {
+                nonFilterable.push(prop);
+            }
+            else {
+                unknown.push(prop);
+            }
+        }
+    }
+    if (nonFilterable.length) {
+        throw new UnprocessableEntityError(`Field(s) not filterable: ${nonFilterable.join(', ')}.`);
+    }
+    if (unknown.length) {
+        throw new UnprocessableEntityError(`Invalid query-string properties: ${unknown.join(', ')}.`);
+    }
+}
+/**
+ * Validates a WHERE clause filter tree against the resource's field definitions.
+ * Throws {@link UnprocessableEntityError} on invalid fields, comparisons, operators, or exceeded nesting depth.
+ * @param resource - The resource definition whose fields and depth limit are used.
+ * @param where - Array of filter conditions to validate.
+ * @param depth - Current recursion depth (used for nesting-limit enforcement; start at `0`).
+ */
+export function validateWhere(resource, where = [], depth = 0) {
+    const maxDepth = resource.maxFilterDepth ?? 3;
+    if (depth > maxDepth) {
+        throw new UnprocessableEntityError(`Filter nesting exceeds the maximum allowed depth of ${maxDepth}.`);
+    }
+    const validComparisons = new Set(Object.values(SqlComparison));
+    const validOperators = new Set(Object.values(SqlOperator));
+    where.forEach((filter, index) => {
+        if (!filter.field) {
+            throw new UnprocessableEntityError('WHERE clause must have a field.');
+        }
+        validateFields(resource, [filter.field]);
+        const comparison = filter.comparison?.toUpperCase();
+        if (!comparison || !validComparisons.has(comparison)) {
+            throw new UnprocessableEntityError(`Invalid comparison: '${filter.comparison}'.`);
+        }
+        const operator = filter.operator?.toUpperCase();
+        if (operator && !validOperators.has(operator)) {
+            throw new UnprocessableEntityError(`Invalid operator: '${filter.operator}'.`);
+        }
+        if (index + 1 < where.length && !operator) {
+            throw new UnprocessableEntityError('Operator is required for all but the last item in the WHERE clause.');
+        }
+        if (filter.children?.length) {
+            validateWhere(resource, filter.children, depth + 1);
+        }
+    });
+}
+/**
+ * Validates a full query-builder AST (fields, orderBy, where) against the resource's schema.
+ * Throws {@link UnprocessableEntityError} on any invalid input.
+ * @param resource - The resource definition used for field and relation validation.
+ * @param query - The query AST to validate.
+ */
+export function validateAdvancedQuery(resource, query) {
+    if (query.fields) {
+        validateFields(resource, query.fields);
+        validateSelectableFields(resource, query.fields);
+    }
+    if (query.orderBy) {
+        const validOrders = new Set(Object.values(SqlOrder));
+        const sortFields = query.orderBy.map((s) => s.field);
+        validateFields(resource, sortFields);
+        validateSortableFields(resource, sortFields);
+        query.orderBy.forEach((sort) => {
+            if (!validOrders.has(sort.order.toUpperCase())) {
+                throw new UnprocessableEntityError(`Invalid sort order: '${sort.order}'.`);
+            }
+        });
+    }
+    validateWhere(resource, query.where);
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"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"}

package/dist/enums/SqlComparison.d.ts

@@ -0,0 +1,18 @@
+/** SQL comparison operators used in query-builder WHERE clauses. */
+export declare enum SqlComparison {
+    Between = "BETWEEN",
+    Equal = "=",
+    GreaterThan = ">",
+    GreaterThanOrEqual = ">=",
+    In = "IN",
+    IsNotNull = "IS NOT NULL",
+    IsNull = "IS NULL",
+    LessThan = "<",
+    LessThanOrEqual = "<=",
+    Like = "LIKE",
+    NotBetween = "NOT BETWEEN",
+    NotEqual = "<>",
+    NotIn = "NOT IN",
+    NotLike = "NOT LIKE"
+}
+//# sourceMappingURL=SqlComparison.d.ts.map

package/dist/enums/SqlComparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlComparison.d.ts","sourceRoot":"","sources":["../../src/enums/SqlComparison.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,KAAK,MAAM;IACX,WAAW,MAAM;IACjB,kBAAkB,OAAO;IACzB,EAAE,OAAO;IACT,SAAS,gBAAgB;IACzB,MAAM,YAAY;IAClB,QAAQ,MAAM;IACd,eAAe,OAAO;IACtB,IAAI,SAAS;IACb,UAAU,gBAAgB;IAC1B,QAAQ,OAAO;IACf,KAAK,WAAW;IAChB,OAAO,aAAa;CACrB"}