@taylordb/query-builder 0.1.0

package/dist/sample/sample-1/taylorclient.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taylorclient.types.js","sourceRoot":"","sources":["../../../sample/sample-1/taylorclient.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/src/@types/aggregate.d.ts

@@ -0,0 +1,28 @@
+import { AggregationQueryMetaData, MetadataWithTableName } from '@taylordb/shared';
+import { AnyDB } from './internal-types.js';
+import { InferDataType } from './type-helpers.js';
+export type AggregationValue = number | null | object | undefined;
+export type Aggregates<DB extends AnyDB, TName extends keyof DB['tables'], TAggregations extends {
+    [K in keyof DB['tables'][TName] & string]?: readonly (keyof DB['aggregates'][DB['tables'][TName][K]['type']])[];
+}> = {
+    -readonly [K in keyof TAggregations & keyof DB['tables'][TName]]: {
+        -readonly [P in NonNullable<TAggregations[K]>[number]]: DB['aggregates'][DB['tables'][TName][K]['type']][P];
+    };
+};
+type Head<T extends readonly any[]> = T extends readonly [infer H, ...any[]] ? H : never;
+type Tail<T extends readonly any[]> = T extends readonly [any, ...infer R] ? R : never;
+export type AggregateRecord<DB extends AnyDB, TName extends keyof DB['tables'], TGroupBy extends readonly (keyof DB['tables'][TName] & string)[], TAggregations extends {
+    [K in keyof DB['tables'][TName] & string]?: readonly (keyof DB['aggregates'][DB['tables'][TName][K]['type']])[];
+}> = TGroupBy extends readonly [] ? {
+    count: number;
+    aggregates: Aggregates<DB, TName, TAggregations>;
+} : {
+    field: Head<TGroupBy>;
+    value: InferDataType<DB['tables'][TName][Head<TGroupBy>]>;
+    count: number;
+    aggregates: Aggregates<DB, TName, TAggregations>;
+} & (Tail<TGroupBy> extends readonly [] ? object : {
+    children: AggregateRecord<DB, TName, Tail<TGroupBy>, TAggregations>[];
+});
+export type AggregateNode = Omit<MetadataWithTableName<AggregationQueryMetaData>, 'fields'>;
+export {};

package/dist/src/@types/aggregate.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=aggregate.js.map

package/dist/src/@types/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../../src/@types/aggregate.ts"],"names":[],"mappings":""}

package/dist/src/@types/delete.d.ts

@@ -0,0 +1,2 @@
+import { DeleteMutationMetaData, MetadataWithTableName } from '@taylordb/shared';
+export type DeleteNode = MetadataWithTableName<DeleteMutationMetaData>;

package/dist/src/@types/delete.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=delete.js.map

package/dist/src/@types/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/@types/delete.ts"],"names":[],"mappings":""}

package/dist/src/@types/insert.d.ts

@@ -0,0 +1,8 @@
+import { ColumnType, CreateMutationMetaData, MetadataWithTableName } from '@taylordb/shared';
+import { QueryNode } from './internal-types.js';
+export type InsertNode = MetadataWithTableName<CreateMutationMetaData> & {
+    returning: (string | QueryNode)[];
+};
+export type Insertable<T> = {
+    [K in keyof T]?: T[K] extends ColumnType<any, any, infer I, any> ? I : never;
+};

package/dist/src/@types/insert.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=insert.js.map

package/dist/src/@types/insert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert.js","sourceRoot":"","sources":["../../../src/@types/insert.ts"],"names":[],"mappings":""}

package/dist/src/@types/internal-types.d.ts

@@ -0,0 +1,24 @@
+import { MetadataWithTableName, ObjConfigurationVisibleField, SelectQueryMetaData } from '@taylordb/shared';
+export type Filters = {
+    [key: string]: {
+        [key: string]: any;
+    };
+};
+export type Aggregates = {
+    [key: string]: {
+        [key: string]: any;
+    };
+};
+export type AnyDB = {
+    filters: Filters;
+    aggregates: Aggregates;
+    tables: any;
+};
+export type SelectionQueryNode = ObjConfigurationVisibleField<string> & {
+    queryType: 'link';
+};
+export type RootQueryNode = Omit<MetadataWithTableName<SelectQueryMetaData>, 'fields'> & {
+    fields?: ('*' | string | SelectionQueryNode)[];
+    queryType: 'root';
+};
+export type QueryNode = SelectionQueryNode | RootQueryNode;

package/dist/src/@types/internal-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=internal-types.js.map

package/dist/src/@types/internal-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-types.js","sourceRoot":"","sources":["../../../src/@types/internal-types.ts"],"names":[],"mappings":""}

package/dist/src/@types/query-builder.d.ts

@@ -0,0 +1,7 @@
+import { LinkColumnType } from '@taylordb/shared';
+export type NonLinkColumnNames<T> = {
+    [K in keyof T]: T[K] extends LinkColumnType<any> ? never : K;
+}[keyof T];
+export type LinkColumnNames<T> = {
+    [K in keyof T]: T[K] extends LinkColumnType<any> ? K : never;
+}[keyof T];

package/dist/src/@types/query-builder.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query-builder.js.map

package/dist/src/@types/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../../../src/@types/query-builder.ts"],"names":[],"mappings":""}

package/dist/src/@types/type-helpers.d.ts

@@ -0,0 +1,27 @@
+import { ColumnType, LinkColumnType } from '@taylordb/shared';
+import { QueryBuilder } from '../query-builder.js';
+import { AnyDB } from './internal-types.js';
+import { LinkColumnNames, NonLinkColumnNames } from './query-builder.js';
+export type InferDataType<TColumn> = TColumn extends ColumnType<any, any, any, infer D> ? D : never;
+export type TableShape<TTable> = {
+    [K in keyof TTable]: InferDataType<TTable[K]>;
+};
+type InferSubqueryResult<TSubquery> = TSubquery extends QueryBuilder<any, any, infer TSelection, any> ? TSelection[] : never;
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+type InferSubqueryShape<TFunc> = TFunc extends (b: any) => QueryBuilder<any, any, infer SubSelection, infer LinkName> ? {
+    [K in LinkName & string]: SubSelection[];
+} : object;
+export type ResolveSelection<DB extends AnyDB, TName extends keyof DB['tables'], TFields extends readonly any[], TCurrentSelection> = TCurrentSelection & UnionToIntersection<{
+    [I in keyof TFields]: TFields[I] extends NonLinkColumnNames<DB['tables'][TName]> ? {
+        [K in TFields[I]]: InferDataType<DB['tables'][TName][K]>;
+    } : TFields[I] extends (b: any) => QueryBuilder<any, any, any, any> ? InferSubqueryShape<TFields[I]> : object;
+}[number]>;
+export type ResolveWithPlain<DB extends AnyDB, TName extends keyof DB['tables'], TRelations extends (LinkColumnNames<DB['tables'][TName]> & string) | readonly (LinkColumnNames<DB['tables'][TName]> & string)[], TCurrentSelection> = TCurrentSelection & UnionToIntersection<{
+    [K in TRelations extends readonly any[] ? TRelations[number] : TRelations]: {
+        [P in K]: TableShape<DB['tables'][DB['tables'][TName][P] extends LinkColumnType<infer L> ? L : never]>[];
+    };
+}[TRelations extends readonly any[] ? TRelations[number] : TRelations]>;
+export type ResolveWithObject<TRelations extends Record<string, (qb: any) => QueryBuilder<any, any, any, any>>, TCurrentSelection> = TCurrentSelection & {
+    -readonly [K in keyof TRelations]: InferSubqueryResult<ReturnType<TRelations[K]>>;
+};
+export {};

package/dist/src/@types/type-helpers.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type-helpers.js.map

package/dist/src/@types/type-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.js","sourceRoot":"","sources":["../../../src/@types/type-helpers.ts"],"names":[],"mappings":""}

package/dist/src/@types/update.d.ts

@@ -0,0 +1,5 @@
+import { ColumnType, MetadataWithTableName, UpdateMutationMetaData } from '@taylordb/shared';
+export type UpdateNode = MetadataWithTableName<UpdateMutationMetaData>;
+export type Updatable<T> = {
+    [K in keyof T]?: T[K] extends ColumnType<any, any, infer I, any> ? I : never;
+};

package/dist/src/@types/update.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=update.js.map

package/dist/src/@types/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/@types/update.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/query-builder.spec.d.ts

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

package/dist/src/__tests__/query-builder.spec.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../index.js");
+describe('QueryBuilder', () => {
+    // @ts-ignore
+    const qb = (0, index_js_1.createQueryBuilder)({
+        baseUrl: 'http://localhost',
+        apiKey: 'test',
+    });
+    it('should compile a select query', () => {
+        const { variables } = qb
+            .selectFrom('customers')
+            .select(['firstName', 'lastName'])
+            .where('firstName', '=', 'John')
+            .orderBy('lastName', 'asc')
+            .paginate(1, 10)
+            .compile();
+        expect(variables.metadata[0]).toMatchObject({
+            type: 'select',
+            tableName: 'customers',
+            fields: ['firstName', 'lastName'],
+            filtersSet: {
+                conjunction: 'and',
+                filtersSet: [
+                    {
+                        field: 'firstName',
+                        operator: '=',
+                        value: 'John',
+                    },
+                ],
+            },
+            sorting: [{ field: 'lastName', direction: 'asc' }],
+            pagination: { offset: 0, limit: 10 },
+        });
+    });
+    it('should compile an insert query', () => {
+        const { variables } = qb
+            .insertInto('customers')
+            .values({
+            firstName: 'Jane',
+            lastName: 'Doe',
+        })
+            .compile();
+        expect(variables.metadata[0]).toMatchObject({
+            type: 'create',
+            tableName: 'customers',
+            createdRecords: [{ firstName: 'Jane', lastName: 'Doe' }],
+        });
+    });
+    it('should compile an update query', () => {
+        const { variables } = qb
+            .update('customers')
+            .set({ lastName: 'Smith' })
+            .where('id', '=', 1)
+            .compile();
+        expect(variables.metadata[0]).toMatchObject({
+            type: 'update',
+            tableName: 'customers',
+            values: { lastName: 'Smith' },
+            filtersSet: {
+                conjunction: 'and',
+                filtersSet: [
+                    {
+                        field: 'id',
+                        operator: '=',
+                        value: 1,
+                    },
+                ],
+            },
+        });
+    });
+    it('should compile a delete query', () => {
+        const { variables } = qb
+            .deleteFrom('customers')
+            .where('id', '=', 1)
+            .compile();
+        expect(variables.metadata[0]).toMatchObject({
+            type: 'delete',
+            tableName: 'customers',
+            filtersSet: {
+                conjunction: 'and',
+                filtersSet: [
+                    {
+                        field: 'id',
+                        operator: '=',
+                        value: 1,
+                    },
+                ],
+            },
+        });
+    });
+    it('should compile a batch query', () => {
+        const { variables } = qb
+            .batch([
+            qb.selectFrom('customers').select(['firstName', 'lastName']),
+            qb
+                .insertInto('customers')
+                .values({ firstName: 'John', lastName: 'Doe' }),
+        ])
+            .compile();
+        expect(variables.metadata).toHaveLength(2);
+        expect(variables.metadata[0]).toMatchObject({
+            type: 'select',
+            tableName: 'customers',
+        });
+        expect(variables.metadata[1]).toMatchObject({
+            type: 'create',
+            tableName: 'customers',
+        });
+    });
+    it('should compile an aggregate query', () => {
+        const { variables } = qb
+            .aggregateFrom('customers')
+            .groupBy('firstName', 'asc')
+            .withAggregates({
+            id: ['sum'],
+        })
+            .compile();
+        expect(variables.metadata[0]).toMatchObject({
+            type: 'aggregate',
+            tableName: 'customers',
+            groupings: [{ field: 'firstName', direction: 'asc' }],
+            aggregations: {
+                id: ['sum'],
+            },
+        });
+    });
+});
+//# sourceMappingURL=query-builder.spec.js.map

package/dist/src/__tests__/query-builder.spec.js.map

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

package/dist/src/__tests__/taylorclient.types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Copyright (c) 2025 TaylorDB
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+type IsWithinOperatorValue = 'pastWeek' | 'pastMonth' | 'pastYear' | 'nextWeek' | 'nextMonth' | 'nextYear' | 'daysFromNow' | 'daysAgo' | 'currentWeek' | 'currentMonth' | 'currentYear';
+type DefaultDateFilterValue = ('today' | 'tomorrow' | 'yesterday' | 'oneWeekAgo' | 'oneWeekFromNow' | 'oneMonthAgo' | 'oneMonthFromNow') | ['exactDay' | 'exactTimestamp', string] | ['daysAgo' | 'daysFromNow', number];
+export type Filters = {
+    text: {
+        '=': string;
+        '!=': string;
+        caseEqual: string;
+        hasAnyOf: string[];
+        contains: string;
+        startsWith: string;
+        endsWith: string;
+        doesNotContain: string;
+    };
+    number: {
+        '=': number;
+        '!=': number;
+        '>': number;
+        '>=': number;
+        '<': number;
+        '<=': number;
+        hasAnyOf: number[];
+        hasNoneOf: number[];
+    };
+    checkbox: {
+        '=': number;
+    };
+    link: {
+        hasAnyOf: number[];
+        hasAllOf: number[];
+        isExactly: number[];
+        '=': number;
+        hasNoneOf: number[];
+    };
+    date: {
+        '=': DefaultDateFilterValue;
+        '!=': DefaultDateFilterValue;
+        '<': DefaultDateFilterValue;
+        '>': DefaultDateFilterValue;
+        '<=': DefaultDateFilterValue;
+        '>=': DefaultDateFilterValue;
+        isWithIn: IsWithinOperatorValue | {
+            value: 'daysAgo' | 'daysFromNow';
+            date: number;
+        };
+        isEmpty: boolean;
+        isNotEmpty: boolean;
+    };
+};
+type Aggregates = {
+    number: {
+        sum: number;
+        average: number;
+        median: number;
+        min: number | null;
+        max: number | null;
+        range: number;
+        standardDeviation: number;
+        histogram: Record<string, number>;
+        empty: number;
+        filled: number;
+        unique: number;
+        percentEmpty: number;
+        percentFilled: number;
+        percentUnique: number;
+    };
+    date: {
+        empty: number;
+        filled: number;
+        unique: number;
+        percentEmpty: number;
+        percentFilled: number;
+        percentUnique: number;
+        min: number | null;
+        max: number | null;
+        daysRange: number | null;
+        monthRange: number | null;
+    };
+    link: {
+        empty: number;
+        filled: number;
+        percentEmpty: number;
+        percentFilled: number;
+    };
+};
+export type ColumnType<S, U, I, T> = {
+    raw: S;
+    insert: I;
+    update: U;
+    type: T;
+};
+export type DateColumnType = ColumnType<string | undefined, string | undefined, string | undefined, 'date'>;
+export type TextColumnType = ColumnType<string | undefined, string | undefined, string | null, 'text'>;
+export type LinkColumnType<T extends string> = ColumnType<object, number[] | {
+    newIds: number[];
+    deletedIds: number[];
+} | undefined, number[] | undefined, 'link'> & {
+    linkedTo: T;
+};
+export type NumberColumnType = ColumnType<number | undefined, number | undefined, number | undefined, 'number'>;
+export type CheckboxColumnType = ColumnType<boolean | undefined, boolean | undefined, boolean | undefined, 'checkbox'>;
+export type SelectTable = {
+    id: NumberColumnType;
+    name: TextColumnType;
+    color: TextColumnType;
+};
+export type AttachmentTable = {
+    id: NumberColumnType;
+    name: TextColumnType;
+    metadata: TextColumnType;
+    size: NumberColumnType;
+    fileType: TextColumnType;
+    url: TextColumnType;
+};
+export type CollaboratorsTable = {
+    id: NumberColumnType;
+    name: TextColumnType;
+    emailAddress: TextColumnType;
+    avatar: TextColumnType;
+};
+export interface Tables {
+    /**
+     *
+     *
+     * Internal tables, these tables can not be queried directly.
+     *
+     */
+    selectTable: SelectTable;
+    attachmentTable: AttachmentTable;
+    collaboratorsTable: CollaboratorsTable;
+    customers: CustomersTable;
+}
+export interface TaylorDatabase {
+    filters: Filters;
+    aggregates: Aggregates;
+    tables: Tables;
+}
+interface CustomersTable {
+    id: NumberColumnType;
+    createdAt: DateColumnType;
+    updatedAt: DateColumnType;
+    firstName: TextColumnType;
+    lastName: TextColumnType;
+}
+export {};

package/dist/src/__tests__/taylorclient.types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Copyright (c) 2025 TaylorDB
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=taylorclient.types.js.map

package/dist/src/__tests__/taylorclient.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taylorclient.types.js","sourceRoot":"","sources":["../../../src/__tests__/taylorclient.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/src/aggregation-query-builder.d.ts

@@ -0,0 +1,27 @@
+import type { AggregateNode, AggregateRecord } from './@types/aggregate.js';
+import type { AnyDB } from './@types/internal-types.js';
+import { Executor } from './executor.js';
+import { FilterableQueryBuilder } from './where-query-builder.js';
+export declare class AggregationQueryBuilder<DB extends AnyDB, TableName extends keyof DB['tables'], TGroupBy extends readonly (keyof DB['tables'][TableName] & string)[] = [], TAggregations extends {
+    [K in keyof DB['tables'][TableName] & string]?: readonly (keyof DB['aggregates'][DB['tables'][TableName][K]['type']])[];
+} = object> extends FilterableQueryBuilder<DB, TableName> {
+    #private;
+    constructor(node: AggregateNode, executor: Executor);
+    groupBy<const TField extends keyof DB['tables'][TableName] & string>(field: TField, direction?: 'asc' | 'desc'): AggregationQueryBuilder<DB, TableName, [
+        ...TGroupBy,
+        TField
+    ], TAggregations>;
+    withAggregates<const T extends {
+        [K in keyof DB['tables'][TableName] & string]?: readonly (keyof DB['aggregates'][DB['tables'][TableName][K]['type']])[];
+    }>(aggregates: T): AggregationQueryBuilder<DB, TableName, TGroupBy, TAggregations & T>;
+    limit(count: number): AggregationQueryBuilder<DB, TableName, TGroupBy, TAggregations>;
+    offset(count: number): AggregationQueryBuilder<DB, TableName, TGroupBy, TAggregations>;
+    paginate(page: number, limit: number): AggregationQueryBuilder<DB, TableName, TGroupBy, TAggregations>;
+    orderBy(field: keyof DB['tables'][TableName], direction?: 'asc' | 'desc'): AggregationQueryBuilder<DB, TableName, TGroupBy, TAggregations>;
+    execute(): Promise<AggregateRecord<DB, TableName, TGroupBy, TAggregations>[]>;
+    compile(): {
+        query: string;
+        variables: Record<string, any>;
+    };
+    _prepareMetadata(): any;
+}

package/dist/src/aggregation-query-builder.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregationQueryBuilder = void 0;
+const where_query_builder_js_1 = require("./where-query-builder.js");
+class AggregationQueryBuilder extends where_query_builder_js_1.FilterableQueryBuilder {
+    #node;
+    constructor(node, executor) {
+        super(node, executor);
+        this.#node = node;
+    }
+    groupBy(field, direction = 'asc') {
+        const newGrouping = {
+            field,
+            direction,
+        };
+        return new AggregationQueryBuilder({
+            ...this.#node,
+            groupings: [...(this.#node.groupings || []), newGrouping],
+        }, this._executor);
+    }
+    withAggregates(aggregates) {
+        const newAggregates = { ...this.#node.aggregations };
+        for (const key in aggregates) {
+            newAggregates[key] = aggregates[key].map(aggregate => aggregate);
+        }
+        return new AggregationQueryBuilder({
+            ...this.#node,
+            aggregations: newAggregates,
+        }, this._executor);
+    }
+    limit(count) {
+        return new AggregationQueryBuilder({
+            ...this.#node,
+            pagination: { ...this.#node.pagination, limit: count },
+        }, this._executor);
+    }
+    offset(count) {
+        return new AggregationQueryBuilder({
+            ...this.#node,
+            pagination: { ...this.#node.pagination, offset: count },
+        }, this._executor);
+    }
+    paginate(page, limit) {
+        return this.offset((page - 1) * limit).limit(limit);
+    }
+    orderBy(field, direction = 'asc') {
+        const newSorting = {
+            field: field,
+            direction,
+        };
+        return new AggregationQueryBuilder({
+            ...this.#node,
+            sorting: [...(this.#node.sorting || []), newSorting],
+        }, this._executor);
+    }
+    async execute() {
+        const response = await this._executor.execute(this);
+        return response;
+    }
+    compile() {
+        const query = 'mutation ($metadata: JSON) { execute(metadata: $metadata) }';
+        const metadata = [this._prepareMetadata()];
+        return { query, variables: { metadata } };
+    }
+    _prepareMetadata() {
+        return {
+            type: 'aggregate',
+            tableName: this.#node.tableName,
+            groupings: this.#node.groupings,
+            aggregations: this.#node.aggregations,
+            ...(this.#node.filtersSet.filtersSet.length > 0
+                ? { filtersSet: this.#node.filtersSet }
+                : {}),
+            ...(this.#node.pagination ? { pagination: this.#node.pagination } : {}),
+            ...(this.#node.sorting ? { sorting: this.#node.sorting } : {}),
+        };
+    }
+}
+exports.AggregationQueryBuilder = AggregationQueryBuilder;
+//# sourceMappingURL=aggregation-query-builder.js.map

package/dist/src/aggregation-query-builder.js.map

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

package/dist/src/batch-query-builder.d.ts

@@ -0,0 +1,16 @@
+import { AggregationQueryBuilder } from './aggregation-query-builder.js';
+import { DeleteQueryBuilder } from './delete-query-builder.js';
+import { Executor } from './executor.js';
+import { InsertQueryBuilder } from './insert-query-builder.js';
+import { QueryBuilder } from './query-builder.js';
+import { UpdateQueryBuilder } from './update-query-builder.js';
+export type AnyQueryBuilder = QueryBuilder<any, any> | InsertQueryBuilder<any, any> | UpdateQueryBuilder<any, any> | DeleteQueryBuilder<any, any> | AggregationQueryBuilder<any, any>;
+export declare class BatchQueryBuilder {
+    #private;
+    constructor(builders: AnyQueryBuilder[], executor: Executor);
+    execute<T>(): Promise<T>;
+    compile(): {
+        query: string;
+        variables: Record<string, any>;
+    };
+}

package/dist/src/batch-query-builder.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchQueryBuilder = void 0;
+class BatchQueryBuilder {
+    #builders;
+    #executor;
+    constructor(builders, executor) {
+        this.#builders = builders;
+        this.#executor = executor;
+    }
+    async execute() {
+        return this.#executor.execute(this);
+    }
+    compile() {
+        const query = 'mutation ($metadata: JSON) { execute(metadata: $metadata) }';
+        const metadata = this.#builders.map(builder => {
+            return builder._prepareMetadata();
+        });
+        return {
+            query,
+            variables: {
+                metadata,
+            },
+        };
+    }
+}
+exports.BatchQueryBuilder = BatchQueryBuilder;
+//# sourceMappingURL=batch-query-builder.js.map

package/dist/src/batch-query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-query-builder.js","sourceRoot":"","sources":["../../src/batch-query-builder.ts"],"names":[],"mappings":";;;AAcA,MAAa,iBAAiB;IAC5B,SAAS,CAAoB;IAC7B,SAAS,CAAW;IAEpB,YAAY,QAA2B,EAAE,QAAkB;QACzD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAI,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,MAAM,KAAK,GAAG,6DAA6D,CAAC;QAE5E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YAC5C,OAAO,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,KAAK;YACL,SAAS,EAAE;gBACT,QAAQ;aACT;SACF,CAAC;IACJ,CAAC;CACF;AA3BD,8CA2BC"}