@orchestr-sh/orchestr 1.0.1 → 1.1.0

package/dist/Database/Query/Builder.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Query Builder
+ *
+ * Fluent query builder for constructing database queries
+ */
+import { DatabaseAdapter } from '../Contracts/DatabaseAdapter';
+import { QueryBuilderInterface, WhereOperator, OrderDirection, WhereClause, JoinClause, OrderByClause } from '../Contracts/QueryBuilderInterface';
+export declare class Builder<T = any> implements QueryBuilderInterface<T> {
+    protected adapter: DatabaseAdapter;
+    protected _columns: string[];
+    protected _distinct: boolean;
+    protected _table?: string;
+    protected _wheres: WhereClause[];
+    protected _joins: JoinClause[];
+    protected _orders: OrderByClause[];
+    protected _groups: string[];
+    protected _havings: any[];
+    protected _limit?: number;
+    protected _offset?: number;
+    protected _bindings: any[];
+    constructor(adapter: DatabaseAdapter);
+    /**
+     * Set the columns to be selected
+     */
+    select(...columns: string[]): this;
+    /**
+     * Add a raw select expression
+     */
+    selectRaw(sql: string, bindings?: any[]): this;
+    /**
+     * Force the query to only return distinct results
+     */
+    distinct(): this;
+    /**
+     * Set the table which the query is targeting
+     */
+    from(table: string): this;
+    /**
+     * Add a basic where clause
+     */
+    where(column: string, operator?: WhereOperator | any, value?: any): this;
+    /**
+     * Add an "or where" clause
+     */
+    orWhere(column: string, operator?: WhereOperator | any, value?: any): this;
+    /**
+     * Add a where in clause
+     */
+    whereIn(column: string, values: any[]): this;
+    /**
+     * Add a where not in clause
+     */
+    whereNotIn(column: string, values: any[]): this;
+    /**
+     * Add a where null clause
+     */
+    whereNull(column: string): this;
+    /**
+     * Add a where not null clause
+     */
+    whereNotNull(column: string): this;
+    /**
+     * Add a where between clause
+     */
+    whereBetween(column: string, values: [any, any]): this;
+    /**
+     * Add a raw where clause
+     */
+    whereRaw(sql: string, bindings?: any[]): this;
+    /**
+     * Add a join clause
+     */
+    join(table: string, first: string, operator?: string, second?: string): this;
+    /**
+     * Add a left join clause
+     */
+    leftJoin(table: string, first: string, operator?: string, second?: string): this;
+    /**
+     * Add a right join clause
+     */
+    rightJoin(table: string, first: string, operator?: string, second?: string): this;
+    /**
+     * Add an order by clause
+     */
+    orderBy(column: string, direction?: OrderDirection): this;
+    /**
+     * Order by latest (descending created_at)
+     */
+    latest(column?: string): this;
+    /**
+     * Order by oldest (ascending created_at)
+     */
+    oldest(column?: string): this;
+    /**
+     * Add a group by clause
+     */
+    groupBy(...columns: string[]): this;
+    /**
+     * Add a having clause
+     */
+    having(column: string, operator?: string, value?: any): this;
+    /**
+     * Set the limit
+     */
+    limit(value: number): this;
+    /**
+     * Alias for limit
+     */
+    take(value: number): this;
+    /**
+     * Set the offset
+     */
+    offset(value: number): this;
+    /**
+     * Alias for offset
+     */
+    skip(value: number): this;
+    /**
+     * Get all records
+     */
+    get(): Promise<T[]>;
+    /**
+     * Get the first record
+     */
+    first(): Promise<T | null>;
+    /**
+     * Find a record by ID
+     */
+    find(id: any): Promise<T | null>;
+    /**
+     * Get a single column's value
+     */
+    value(column: string): Promise<any>;
+    /**
+     * Get an array of column values
+     */
+    pluck(column: string): Promise<any[]>;
+    /**
+     * Determine if any rows exist
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Get the count of records
+     */
+    count(column?: string): Promise<number>;
+    /**
+     * Get the maximum value of a column
+     */
+    max(column: string): Promise<number | null>;
+    /**
+     * Get the minimum value of a column
+     */
+    min(column: string): Promise<number | null>;
+    /**
+     * Get the average value of a column
+     */
+    avg(column: string): Promise<number | null>;
+    /**
+     * Get the sum of a column's values
+     */
+    sum(column: string): Promise<number>;
+    /**
+     * Execute an aggregate function
+     */
+    protected aggregate(func: string, column: string): Promise<any>;
+    /**
+     * Insert a new record
+     */
+    insert(values: Record<string, any> | Record<string, any>[]): Promise<boolean>;
+    /**
+     * Insert a new record and get the ID
+     */
+    insertGetId(values: Record<string, any>, sequence?: string): Promise<any>;
+    /**
+     * Update records
+     */
+    update(values: Record<string, any>): Promise<number>;
+    /**
+     * Delete records
+     */
+    delete(): Promise<number>;
+    /**
+     * Truncate the table
+     */
+    truncate(): Promise<void>;
+    /**
+     * Get the SQL query string
+     */
+    toSql(): string;
+    /**
+     * Compile the columns
+     */
+    protected compileColumns(): string;
+    /**
+     * Compile the where clauses
+     */
+    protected compileWheres(): string;
+    /**
+     * Compile the join clauses
+     */
+    protected compileJoins(): string;
+    /**
+     * Compile the order by clauses
+     */
+    protected compileOrders(): string;
+    /**
+     * Compile the having clauses
+     */
+    protected compileHavings(): string;
+    /**
+     * Get the bindings for the query
+     */
+    getBindings(): any[];
+    /**
+     * Clone the query builder
+     */
+    clone(): Builder<T>;
+}
+//# sourceMappingURL=Builder.d.ts.map

package/dist/Database/Query/Builder.d.ts.map

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