@quvel-kit/core 1.3.20 → 1.3.21

package/dist/index.d.ts

@@ -42,6 +42,7 @@ export * from './utils/error.js';
 export * from './utils/scripts.js';
 export * from './utils/assets.js';
 export * from './utils/pagination.js';
+export * from './orm/index.js';
 export { defineQuvelBoot } from './boot/quvel.js';
 export { serviceContainerPlugin } from './stores/plugins/serviceContainer.js';
 export { defineQuvelModule } from './module.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EACV,OAAO,IAAI,QAAQ,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG7D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EACV,OAAO,IAAI,QAAQ,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG7D,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -53,6 +53,8 @@ export * from './utils/error.js';
 export * from './utils/scripts.js';
 export * from './utils/assets.js';
 export * from './utils/pagination.js';
+// ORM - Active Record pattern for models
+export * from './orm/index.js';
 // Boot
 export { defineQuvelBoot } from './boot/quvel.js';
 // Stores

package/dist/orm/QueryBuilder.d.ts

@@ -0,0 +1,410 @@
+import type { FilterOperator } from './types.js';
+import type { ServiceContainer } from '../container/ServiceContainer.js';
+import type { LengthAwarePaginatorResponse, SimplePaginatorResponse, CursorPaginatorResponse } from '../types/laravel.types.js';
+/**
+ * Fluent Query Builder for Models
+ *
+ * Builds Spatie Query Builder compatible query strings and executes queries.
+ *
+ * Supports:
+ * - Filtering: where(), whereIn(), whereNotNull()
+ * - Eager loading: with()
+ * - Field selection: fields()
+ * - Sorting: sort()
+ * - Pagination: page(), perPage(), paginate()
+ *
+ * @template T - Model class type
+ * @template A - API response interface type
+ *
+ * @example
+ * ```typescript
+ * const users = await User.query()
+ *   .where('status', 'active')
+ *   .where('age', '>', 18)
+ *   .with('posts.comments', 'profile')
+ *   .fields('users', ['id', 'name', 'email'])
+ *   .fields('posts', ['id', 'title'])
+ *   .sort('-created_at', 'name')
+ *   .paginate(20);
+ * ```
+ */
+export declare class QueryBuilder<T = any, A = any> {
+    private modelClass;
+    private container?;
+    /**
+     * Map of filters to apply
+     * Key: field name, Value: operator and value
+     */
+    private filters;
+    /**
+     * Set of relationships to eager load
+     */
+    private includes;
+    /**
+     * Map of field selections per resource type
+     * Key: resource name (e.g., 'users'), Value: array of field names
+     */
+    private fieldSelections;
+    /**
+     * Array of sort fields (prefix with - for descending)
+     */
+    private sortFields;
+    /**
+     * Page number for pagination
+     */
+    private pageNumber?;
+    /**
+     * Items per page
+     */
+    private perPage?;
+    /**
+     * Cursor value for cursor pagination
+     */
+    private cursorValue?;
+    /**
+     * Constructor
+     *
+     * @param modelClass - Model class constructor
+     * @param container - ServiceContainer instance
+     */
+    constructor(modelClass: new (attrs: Partial<A>, container?: ServiceContainer) => T, container?: ServiceContainer | undefined);
+    /**
+     * Get the API service
+     * @throws Error if no container provided
+     */
+    private get api();
+    /**
+     * Get model configuration
+     */
+    private get config();
+    /**
+     * Add a where clause
+     *
+     * Supports two syntaxes:
+     * - where(field, value) - Equality check
+     * - where(field, operator, value) - Custom operator
+     *
+     * @param field - Field name
+     * @param operatorOrValue - Operator or value (if using equality)
+     * @param value - Value (if using custom operator)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.where('status', 'active') // status = 'active'
+     * query.where('age', '>', 18) // age > 18
+     * query.where('name', 'like', '%john%') // name like '%john%'
+     * ```
+     */
+    where(field: string, operatorOrValue: FilterOperator | any, value?: any): this;
+    /**
+     * Add a whereIn clause (field IN values)
+     *
+     * @param field - Field name
+     * @param values - Array of values
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.whereIn('id', ['1', '2', '3'])
+     * ```
+     */
+    whereIn(field: string, values: any[]): this;
+    /**
+     * Add a whereNotNull clause
+     *
+     * @param field - Field name
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.whereNotNull('email_verified_at')
+     * ```
+     */
+    whereNotNull(field: string): this;
+    /**
+     * Add a whereNull clause
+     *
+     * @param field - Field name
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.whereNull('deleted_at')
+     * ```
+     */
+    whereNull(field: string): this;
+    /**
+     * Add eager loading relationships
+     *
+     * Supports nested relationships with dot notation
+     *
+     * @param relations - Relationship names (method names on model)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.with('posts', 'profile')
+     * query.with('posts.comments.author')
+     * query.with('posts.tags', 'posts.comments')
+     * ```
+     */
+    with(...relations: string[]): this;
+    /**
+     * Select specific fields for a resource type (sparse fieldsets)
+     *
+     * @param resource - Resource name (e.g., 'users', 'posts')
+     * @param fields - Array of field names to select
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.fields('users', ['id', 'name', 'email'])
+     * query.fields('posts', ['id', 'title', 'created_at'])
+     * ```
+     */
+    fields(resource: string, fields: string[]): this;
+    /**
+     * Add sorting (prefix with - for descending)
+     *
+     * @param fields - Field names (prefix with '-' for DESC)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.sort('name') // ASC
+     * query.sort('-created_at') // DESC
+     * query.sort('-created_at', 'name') // Multiple fields
+     * ```
+     */
+    sort(...fields: string[]): this;
+    /**
+     * Set page number for pagination
+     *
+     * @param page - Page number (1-indexed)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.page(2)
+     * ```
+     */
+    page(page: number): this;
+    /**
+     * Set items per page
+     *
+     * @param count - Number of items per page
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.perPage(50)
+     * ```
+     */
+    limit(count: number): this;
+    /**
+     * Set cursor for cursor pagination
+     *
+     * @param cursor - Cursor value from previous response
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.cursor(response.meta.next_cursor)
+     * ```
+     */
+    cursor(cursor: string): this;
+    /**
+     * Build query parameters for Spatie Query Builder
+     *
+     * Converts fluent API calls into URL query string format:
+     * - include=posts.comments,profile
+     * - filter[status]=active
+     * - filter[age]=>:18
+     * - fields[users]=id,name,email
+     * - sort=-created_at,name
+     * - page=1&per_page=20
+     *
+     * @returns Record of query parameters for Axios
+     */
+    private buildParams;
+    /**
+     * Execute query and get all results
+     *
+     * @returns Array of model instances
+     *
+     * @example
+     * ```typescript
+     * const users = await User.query().where('active', true).get();
+     * ```
+     */
+    get(): Promise<T[]>;
+    /**
+     * Execute query and get first result
+     *
+     * @returns First model instance or null if none found
+     *
+     * @example
+     * ```typescript
+     * const user = await User.query().where('email', 'john@example.com').first();
+     * if (user) {
+     *   console.log(user.name);
+     * }
+     * ```
+     */
+    first(): Promise<T | null>;
+    /**
+     * Execute query and get first result or fail
+     *
+     * @returns First model instance
+     * @throws Error if no results found
+     *
+     * @example
+     * ```typescript
+     * const user = await User.query().where('email', 'john@example.com').firstOrFail();
+     * // Throws if user not found
+     * ```
+     */
+    firstOrFail(): Promise<T>;
+    /**
+     * Execute query with length-aware pagination
+     *
+     * Returns paginated response with total count and page metadata
+     *
+     * @param perPageCount - Items per page (default: 15)
+     * @returns Paginated response with metadata
+     *
+     * @example
+     * ```typescript
+     * const paginated = await User.query().where('active', true).paginate(20);
+     * console.log(paginated.data); // Array of User models
+     * console.log(paginated.meta.total); // Total count
+     * console.log(paginated.meta.current_page); // Current page
+     * console.log(paginated.links.next); // Next page URL
+     * ```
+     */
+    paginate(perPageCount?: number): Promise<LengthAwarePaginatorResponse<T>>;
+    /**
+     * Execute query with simple pagination (no total count)
+     *
+     * @param perPageCount - Items per page (default: 15)
+     * @returns Paginated response without total count
+     *
+     * @example
+     * ```typescript
+     * const paginated = await User.query().simplePaginate(20);
+     * ```
+     */
+    simplePaginate(perPageCount?: number): Promise<SimplePaginatorResponse<T>>;
+    /**
+     * Execute query with cursor pagination
+     *
+     * @param perPageCount - Items per page (default: 15)
+     * @returns Cursor paginated response
+     *
+     * @example
+     * ```typescript
+     * const paginated = await User.query().cursorPaginate(20);
+     * console.log(paginated.meta.next_cursor);
+     * console.log(paginated.meta.prev_cursor);
+     * ```
+     */
+    cursorPaginate(perPageCount?: number): Promise<CursorPaginatorResponse<T>>;
+    /**
+     * Get count of matching records
+     *
+     * Note: This makes a paginated request with per_page=1 and reads the total
+     *
+     * @returns Total count of matching records
+     *
+     * @example
+     * ```typescript
+     * const activeUserCount = await User.query().where('active', true).count();
+     * ```
+     */
+    count(): Promise<number>;
+    /**
+     * Check if any records exist matching the query
+     *
+     * @returns true if at least one record exists
+     *
+     * @example
+     * ```typescript
+     * const hasActiveUsers = await User.query().where('active', true).exists();
+     * ```
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Hydrate models from API data
+     *
+     * Converts raw API response objects into model instances
+     *
+     * @param data - Array of raw API objects
+     * @returns Array of model instances
+     */
+    private hydrate;
+    /**
+     * Clone the query builder
+     *
+     * Creates a new instance with the same filters, includes, etc.
+     * Useful for creating base queries and extending them
+     *
+     * @returns Cloned QueryBuilder instance
+     *
+     * @example
+     * ```typescript
+     * const baseQuery = User.query().where('active', true);
+     * const admins = await baseQuery.clone().where('role', 'admin').get();
+     * const users = await baseQuery.clone().where('role', 'user').get();
+     * ```
+     */
+    clone(): QueryBuilder<T, A>;
+    /**
+     * Execute a callback with a fresh query clone
+     *
+     * @param callback - Function that modifies the query
+     * @returns Result of the callback
+     *
+     * @example
+     * ```typescript
+     * const baseQuery = User.query().where('active', true);
+     *
+     * const admins = await baseQuery.tap(q => q.where('role', 'admin')).get();
+     * const users = await baseQuery.tap(q => q.where('role', 'user')).get();
+     * ```
+     */
+    tap<R>(callback: (query: QueryBuilder<T, A>) => R): R;
+    /**
+     * Apply a callback if condition is true
+     *
+     * @param condition - Boolean condition
+     * @param callback - Function to apply if condition is true
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * const query = User.query()
+     *   .when(search, q => q.where('name', 'like', `%${search}%`))
+     *   .when(role, q => q.where('role', role));
+     * ```
+     */
+    when(condition: boolean | any, callback: (query: this) => void): this;
+    /**
+     * Dump the current query parameters (for debugging)
+     *
+     * @returns Query parameters object
+     *
+     * @example
+     * ```typescript
+     * const params = User.query()
+     *   .where('active', true)
+     *   .with('posts')
+     *   .dump();
+     *
+     * console.log(params);
+     * // { include: 'posts', 'filter[active]': true }
+     * ```
+     */
+    dump(): Record<string, any>;
+}
+//# sourceMappingURL=QueryBuilder.d.ts.map

package/dist/orm/QueryBuilder.d.ts.map

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

package/dist/orm/QueryBuilder.js

@@ -0,0 +1,569 @@
+/**
+ * Fluent Query Builder for Models
+ *
+ * Builds Spatie Query Builder compatible query strings and executes queries.
+ *
+ * Supports:
+ * - Filtering: where(), whereIn(), whereNotNull()
+ * - Eager loading: with()
+ * - Field selection: fields()
+ * - Sorting: sort()
+ * - Pagination: page(), perPage(), paginate()
+ *
+ * @template T - Model class type
+ * @template A - API response interface type
+ *
+ * @example
+ * ```typescript
+ * const users = await User.query()
+ *   .where('status', 'active')
+ *   .where('age', '>', 18)
+ *   .with('posts.comments', 'profile')
+ *   .fields('users', ['id', 'name', 'email'])
+ *   .fields('posts', ['id', 'title'])
+ *   .sort('-created_at', 'name')
+ *   .paginate(20);
+ * ```
+ */
+export class QueryBuilder {
+    modelClass;
+    container;
+    /**
+     * Map of filters to apply
+     * Key: field name, Value: operator and value
+     */
+    filters = new Map();
+    /**
+     * Set of relationships to eager load
+     */
+    includes = new Set();
+    /**
+     * Map of field selections per resource type
+     * Key: resource name (e.g., 'users'), Value: array of field names
+     */
+    fieldSelections = new Map();
+    /**
+     * Array of sort fields (prefix with - for descending)
+     */
+    sortFields = [];
+    /**
+     * Page number for pagination
+     */
+    pageNumber;
+    /**
+     * Items per page
+     */
+    perPage;
+    /**
+     * Cursor value for cursor pagination
+     */
+    cursorValue;
+    /**
+     * Constructor
+     *
+     * @param modelClass - Model class constructor
+     * @param container - ServiceContainer instance
+     */
+    constructor(modelClass, container) {
+        this.modelClass = modelClass;
+        this.container = container;
+    }
+    /**
+     * Get the API service
+     * @throws Error if no container provided
+     */
+    get api() {
+        if (!this.container) {
+            throw new Error('QueryBuilder requires ServiceContainer. ' +
+                'Pass container to query(): Model.query(container)');
+        }
+        return this.container.api;
+    }
+    /**
+     * Get model configuration
+     */
+    get config() {
+        return this.modelClass.config;
+    }
+    /**
+     * Add a where clause
+     *
+     * Supports two syntaxes:
+     * - where(field, value) - Equality check
+     * - where(field, operator, value) - Custom operator
+     *
+     * @param field - Field name
+     * @param operatorOrValue - Operator or value (if using equality)
+     * @param value - Value (if using custom operator)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.where('status', 'active') // status = 'active'
+     * query.where('age', '>', 18) // age > 18
+     * query.where('name', 'like', '%john%') // name like '%john%'
+     * ```
+     */
+    where(field, operatorOrValue, value) {
+        if (value === undefined) {
+            // where(field, value) syntax
+            this.filters.set(field, { operator: '=', value: operatorOrValue });
+        }
+        else {
+            // where(field, operator, value) syntax
+            this.filters.set(field, { operator: operatorOrValue, value });
+        }
+        return this;
+    }
+    /**
+     * Add a whereIn clause (field IN values)
+     *
+     * @param field - Field name
+     * @param values - Array of values
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.whereIn('id', ['1', '2', '3'])
+     * ```
+     */
+    whereIn(field, values) {
+        this.filters.set(field, { operator: 'in', value: values.join(',') });
+        return this;
+    }
+    /**
+     * Add a whereNotNull clause
+     *
+     * @param field - Field name
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.whereNotNull('email_verified_at')
+     * ```
+     */
+    whereNotNull(field) {
+        this.filters.set(field, { operator: '!=', value: 'null' });
+        return this;
+    }
+    /**
+     * Add a whereNull clause
+     *
+     * @param field - Field name
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.whereNull('deleted_at')
+     * ```
+     */
+    whereNull(field) {
+        this.filters.set(field, { operator: '=', value: 'null' });
+        return this;
+    }
+    /**
+     * Add eager loading relationships
+     *
+     * Supports nested relationships with dot notation
+     *
+     * @param relations - Relationship names (method names on model)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.with('posts', 'profile')
+     * query.with('posts.comments.author')
+     * query.with('posts.tags', 'posts.comments')
+     * ```
+     */
+    with(...relations) {
+        for (const relation of relations) {
+            this.includes.add(relation);
+        }
+        return this;
+    }
+    /**
+     * Select specific fields for a resource type (sparse fieldsets)
+     *
+     * @param resource - Resource name (e.g., 'users', 'posts')
+     * @param fields - Array of field names to select
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.fields('users', ['id', 'name', 'email'])
+     * query.fields('posts', ['id', 'title', 'created_at'])
+     * ```
+     */
+    fields(resource, fields) {
+        this.fieldSelections.set(resource, fields);
+        return this;
+    }
+    /**
+     * Add sorting (prefix with - for descending)
+     *
+     * @param fields - Field names (prefix with '-' for DESC)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.sort('name') // ASC
+     * query.sort('-created_at') // DESC
+     * query.sort('-created_at', 'name') // Multiple fields
+     * ```
+     */
+    sort(...fields) {
+        this.sortFields.push(...fields);
+        return this;
+    }
+    /**
+     * Set page number for pagination
+     *
+     * @param page - Page number (1-indexed)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.page(2)
+     * ```
+     */
+    page(page) {
+        this.pageNumber = page;
+        return this;
+    }
+    /**
+     * Set items per page
+     *
+     * @param count - Number of items per page
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.perPage(50)
+     * ```
+     */
+    limit(count) {
+        this.perPage = count;
+        return this;
+    }
+    /**
+     * Set cursor for cursor pagination
+     *
+     * @param cursor - Cursor value from previous response
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * query.cursor(response.meta.next_cursor)
+     * ```
+     */
+    cursor(cursor) {
+        this.cursorValue = cursor;
+        return this;
+    }
+    /**
+     * Build query parameters for Spatie Query Builder
+     *
+     * Converts fluent API calls into URL query string format:
+     * - include=posts.comments,profile
+     * - filter[status]=active
+     * - filter[age]=>:18
+     * - fields[users]=id,name,email
+     * - sort=-created_at,name
+     * - page=1&per_page=20
+     *
+     * @returns Record of query parameters for Axios
+     */
+    buildParams() {
+        const params = {};
+        // Include relationships
+        if (this.includes.size > 0) {
+            params.include = Array.from(this.includes).join(',');
+        }
+        // Filters
+        for (const [field, { operator, value }] of this.filters) {
+            if (operator === '=') {
+                // Simple equality
+                params[`filter[${field}]`] = value;
+            }
+            else {
+                // Custom operator
+                // Note: Format depends on your backend's Spatie Query Builder config
+                // Default format: filter[field]=operator:value
+                params[`filter[${field}]`] = `${operator}:${value}`;
+            }
+        }
+        // Field selections (sparse fieldsets)
+        for (const [resource, fields] of this.fieldSelections) {
+            params[`fields[${resource}]`] = fields.join(',');
+        }
+        // Sorting
+        if (this.sortFields.length > 0) {
+            params.sort = this.sortFields.join(',');
+        }
+        // Pagination
+        if (this.pageNumber !== undefined) {
+            params.page = this.pageNumber;
+        }
+        if (this.perPage !== undefined) {
+            params.per_page = this.perPage;
+        }
+        if (this.cursorValue !== undefined) {
+            params.cursor = this.cursorValue;
+        }
+        return params;
+    }
+    /**
+     * Execute query and get all results
+     *
+     * @returns Array of model instances
+     *
+     * @example
+     * ```typescript
+     * const users = await User.query().where('active', true).get();
+     * ```
+     */
+    async get() {
+        const params = this.buildParams();
+        const response = await this.api.get(this.config.endpoint, { params });
+        return this.hydrate(response.data);
+    }
+    /**
+     * Execute query and get first result
+     *
+     * @returns First model instance or null if none found
+     *
+     * @example
+     * ```typescript
+     * const user = await User.query().where('email', 'john@example.com').first();
+     * if (user) {
+     *   console.log(user.name);
+     * }
+     * ```
+     */
+    async first() {
+        const params = this.buildParams();
+        params.per_page = 1;
+        try {
+            const response = await this.api.get(this.config.endpoint, { params });
+            const models = this.hydrate(response.data);
+            return models[0] ?? null;
+        }
+        catch (error) {
+            // If 404 or other error, return null
+            return null;
+        }
+    }
+    /**
+     * Execute query and get first result or fail
+     *
+     * @returns First model instance
+     * @throws Error if no results found
+     *
+     * @example
+     * ```typescript
+     * const user = await User.query().where('email', 'john@example.com').firstOrFail();
+     * // Throws if user not found
+     * ```
+     */
+    async firstOrFail() {
+        const model = await this.first();
+        if (!model) {
+            throw new Error(`No ${this.modelClass.name} found matching query`);
+        }
+        return model;
+    }
+    /**
+     * Execute query with length-aware pagination
+     *
+     * Returns paginated response with total count and page metadata
+     *
+     * @param perPageCount - Items per page (default: 15)
+     * @returns Paginated response with metadata
+     *
+     * @example
+     * ```typescript
+     * const paginated = await User.query().where('active', true).paginate(20);
+     * console.log(paginated.data); // Array of User models
+     * console.log(paginated.meta.total); // Total count
+     * console.log(paginated.meta.current_page); // Current page
+     * console.log(paginated.links.next); // Next page URL
+     * ```
+     */
+    async paginate(perPageCount = 15) {
+        this.perPage = perPageCount;
+        const params = this.buildParams();
+        const response = await this.api.get(this.config.endpoint, { params });
+        return {
+            ...response,
+            data: this.hydrate(response.data),
+        };
+    }
+    /**
+     * Execute query with simple pagination (no total count)
+     *
+     * @param perPageCount - Items per page (default: 15)
+     * @returns Paginated response without total count
+     *
+     * @example
+     * ```typescript
+     * const paginated = await User.query().simplePaginate(20);
+     * ```
+     */
+    async simplePaginate(perPageCount = 15) {
+        this.perPage = perPageCount;
+        const params = this.buildParams();
+        const response = await this.api.get(this.config.endpoint, { params });
+        return {
+            ...response,
+            data: this.hydrate(response.data),
+        };
+    }
+    /**
+     * Execute query with cursor pagination
+     *
+     * @param perPageCount - Items per page (default: 15)
+     * @returns Cursor paginated response
+     *
+     * @example
+     * ```typescript
+     * const paginated = await User.query().cursorPaginate(20);
+     * console.log(paginated.meta.next_cursor);
+     * console.log(paginated.meta.prev_cursor);
+     * ```
+     */
+    async cursorPaginate(perPageCount = 15) {
+        this.perPage = perPageCount;
+        const params = this.buildParams();
+        const response = await this.api.get(this.config.endpoint, { params });
+        return {
+            ...response,
+            data: this.hydrate(response.data),
+        };
+    }
+    /**
+     * Get count of matching records
+     *
+     * Note: This makes a paginated request with per_page=1 and reads the total
+     *
+     * @returns Total count of matching records
+     *
+     * @example
+     * ```typescript
+     * const activeUserCount = await User.query().where('active', true).count();
+     * ```
+     */
+    async count() {
+        const params = this.buildParams();
+        params.per_page = 1;
+        const response = await this.api.get(this.config.endpoint, { params });
+        return response.meta.total;
+    }
+    /**
+     * Check if any records exist matching the query
+     *
+     * @returns true if at least one record exists
+     *
+     * @example
+     * ```typescript
+     * const hasActiveUsers = await User.query().where('active', true).exists();
+     * ```
+     */
+    async exists() {
+        const count = await this.count();
+        return count > 0;
+    }
+    /**
+     * Hydrate models from API data
+     *
+     * Converts raw API response objects into model instances
+     *
+     * @param data - Array of raw API objects
+     * @returns Array of model instances
+     */
+    hydrate(data) {
+        return data.map(attrs => new this.modelClass(attrs, this.container));
+    }
+    /**
+     * Clone the query builder
+     *
+     * Creates a new instance with the same filters, includes, etc.
+     * Useful for creating base queries and extending them
+     *
+     * @returns Cloned QueryBuilder instance
+     *
+     * @example
+     * ```typescript
+     * const baseQuery = User.query().where('active', true);
+     * const admins = await baseQuery.clone().where('role', 'admin').get();
+     * const users = await baseQuery.clone().where('role', 'user').get();
+     * ```
+     */
+    clone() {
+        const cloned = new QueryBuilder(this.modelClass, this.container);
+        cloned.filters = new Map(this.filters);
+        cloned.includes = new Set(this.includes);
+        cloned.fieldSelections = new Map(this.fieldSelections);
+        cloned.sortFields = [...this.sortFields];
+        cloned.pageNumber = this.pageNumber;
+        cloned.perPage = this.perPage;
+        cloned.cursorValue = this.cursorValue;
+        return cloned;
+    }
+    /**
+     * Execute a callback with a fresh query clone
+     *
+     * @param callback - Function that modifies the query
+     * @returns Result of the callback
+     *
+     * @example
+     * ```typescript
+     * const baseQuery = User.query().where('active', true);
+     *
+     * const admins = await baseQuery.tap(q => q.where('role', 'admin')).get();
+     * const users = await baseQuery.tap(q => q.where('role', 'user')).get();
+     * ```
+     */
+    tap(callback) {
+        return callback(this.clone());
+    }
+    /**
+     * Apply a callback if condition is true
+     *
+     * @param condition - Boolean condition
+     * @param callback - Function to apply if condition is true
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * const query = User.query()
+     *   .when(search, q => q.where('name', 'like', `%${search}%`))
+     *   .when(role, q => q.where('role', role));
+     * ```
+     */
+    when(condition, callback) {
+        if (condition) {
+            callback(this);
+        }
+        return this;
+    }
+    /**
+     * Dump the current query parameters (for debugging)
+     *
+     * @returns Query parameters object
+     *
+     * @example
+     * ```typescript
+     * const params = User.query()
+     *   .where('active', true)
+     *   .with('posts')
+     *   .dump();
+     *
+     * console.log(params);
+     * // { include: 'posts', 'filter[active]': true }
+     * ```
+     */
+    dump() {
+        return this.buildParams();
+    }
+}

package/dist/orm/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ORM Module - Front-End Active Record Pattern for Spatie Query Builder
+ *
+ * Provides QueryBuilder and types for building Active Record models.
+ * Apps should create their own base Model class - see app/src/models/BaseModel.ts
+ *
+ * @example
+ * ```typescript
+ * // In app/src/models/BaseModel.ts
+ * import { QueryBuilder, type ModelConfig } from '@quvel-kit/core/orm';
+ *
+ * export abstract class Model<T, A> {
+ *   // Your customizable base model
+ * }
+ * ```
+ */
+export { QueryBuilder } from './QueryBuilder.js';
+export type { ModelConfig, FilterOperator, ModelMetadata } from './types.js';
+export { type RelationshipType, type RelationshipDefinition, type RelationshipData, } from './relationships/types.js';
+export type { ServiceContainer } from '../container/ServiceContainer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/orm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/orm/index.js

@@ -0,0 +1,18 @@
+/**
+ * ORM Module - Front-End Active Record Pattern for Spatie Query Builder
+ *
+ * Provides QueryBuilder and types for building Active Record models.
+ * Apps should create their own base Model class - see app/src/models/BaseModel.ts
+ *
+ * @example
+ * ```typescript
+ * // In app/src/models/BaseModel.ts
+ * import { QueryBuilder, type ModelConfig } from '@quvel-kit/core/orm';
+ *
+ * export abstract class Model<T, A> {
+ *   // Your customizable base model
+ * }
+ * ```
+ */
+// Core classes
+export { QueryBuilder } from './QueryBuilder.js';

package/dist/orm/relationships/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Relationship types supported by the ORM
+ */
+export type RelationshipType = 'hasMany' | 'belongsTo' | 'hasOne';
+/**
+ * Relationship definition returned by relationship methods
+ *
+ * This interface defines the metadata for a relationship but does NOT
+ * implement lazy loading. Relationships must be eager-loaded via the
+ * query builder's `with()` method.
+ *
+ * The generic parameter R is used for type safety at call sites but not
+ * in the interface properties themselves.
+ *
+ * @example
+ * ```typescript
+ * export class User extends Model<User, IUser> {
+ *   posts() {
+ *     return this.hasMany(Post, 'user_id');
+ *   }
+ * }
+ *
+ * // Eager load:
+ * const users = await User.query().with('posts').get();
+ * const posts = users[0].getRelation<Post[]>('posts');
+ * ```
+ */
+export interface RelationshipDefinition<R = any> {
+    /** Phantom type for type safety - not used at runtime */
+    __relationshipType?: R;
+    /**
+     * Type of relationship
+     */
+    type: RelationshipType;
+    /**
+     * Related model class constructor
+     */
+    related: new (...args: any[]) => any;
+    /**
+     * Foreign key field name on the related model (hasMany, hasOne)
+     * or on this model (belongsTo)
+     */
+    foreignKey: string;
+    /**
+     * Local key field name on this model (hasMany, hasOne)
+     * Usually the primary key
+     */
+    localKey?: string;
+    /**
+     * Owner key field name on the related model (belongsTo)
+     * Usually the primary key of the related model
+     */
+    ownerKey?: string;
+}
+/**
+ * Relationship data type helper
+ * Unwraps array types for type safety
+ */
+export type RelationshipData<R> = R extends (infer U)[] ? U[] : R | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/orm/relationships/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/orm/relationships/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,GAAG;IAC7C,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAErC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC"}

package/dist/orm/relationships/types.js

@@ -0,0 +1 @@
+export {};

package/dist/orm/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Shared ORM type definitions
+ * Prevents circular dependencies between Model and QueryBuilder
+ */
+/**
+ * Model configuration interface
+ * Subclasses must implement this static configuration
+ */
+export interface ModelConfig {
+    /**
+     * API endpoint for this model (e.g., '/api/v1/users', '/users')
+     */
+    endpoint: string;
+    /**
+     * Primary key field name
+     * @default 'id'
+     */
+    primaryKey?: string;
+    /**
+     * Timestamp fields to parse as Date objects
+     * @example ['created_at', 'updated_at', 'email_verified_at']
+     */
+    dates?: string[];
+}
+/**
+ * Filter operator types supported by Spatie Query Builder
+ */
+export type FilterOperator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'like' | 'in';
+/**
+ * Model metadata stored on each instance
+ * Internal state tracking for the Active Record pattern
+ */
+export interface ModelMetadata {
+    /**
+     * Is this a new record (not yet persisted)?
+     * New records use POST, existing records use PUT
+     */
+    isNew: boolean;
+    /**
+     * Original attributes from API (for dirty checking)
+     * Used to determine what changed for optimistic updates
+     */
+    original: Record<string, any>;
+    /**
+     * Loaded relationships map
+     * Key: relationship name, Value: related model(s)
+     */
+    relations: Map<string, any>;
+    /**
+     * Model is currently being saved
+     * Prevents concurrent save operations
+     */
+    isSaving: boolean;
+    /**
+     * Model is currently being deleted
+     * Prevents concurrent delete operations
+     */
+    isDeleting: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/orm/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE5B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/dist/orm/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared ORM type definitions
+ * Prevents circular dependencies between Model and QueryBuilder
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quvel-kit/core",
-  "version": "1.3.20",
+  "version": "1.3.21",
   "description": "Core utilities for Quvel UI",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,6 +39,10 @@
       "import": "./dist/composables/index.js",
       "types": "./dist/composables/index.d.ts"
     },
+    "./orm": {
+      "import": "./dist/orm/index.js",
+      "types": "./dist/orm/index.d.ts"
+    },
     "./global": {
       "types": "./global.d.ts"
     }