@taylordb/query-builder 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# @taylordb/query-builder
+
+<img src="../../docs/media/logo.png" width="200" />
+
+This package contains the official TypeScript query builder for TaylorDB. It provides a type-safe and intuitive API for building and executing queries against your TaylorDB database.
+
+## Features
+
+- **Type-Safe Queries**: Leverage your database schema to get full type safety and autocompletion for your queries.
+- **Fluent API**: Chain methods together to build complex queries with ease.
+- **CRUD Operations**: Full support for `select`, `insert`, `update`, and `delete` operations.
+- **Advanced Filtering**: Filter your data with a rich set of operators and logical conjunctions.
+- **Pagination and Sorting**: Easily paginate and sort your query results.
+- **Batch Queries**: Execute multiple queries in a single request for improved performance.
+- **Aggregation Queries**: Perform powerful aggregation queries with grouping and aggregate functions.
+
+## Getting Started
+
+First, you'll need to generate a `taylorclient.types.ts` file from your TaylorDB schema. You can do this using the TaylorDB CLI:
+
+```bash
+npx @taylordb/cli generate-schema
+```
+
+Once you have your types file, you can create a new query builder instance:
+
+```typescript
+import { createQueryBuilder } from '@taylordb/query-builder';
+import { TaylorDatabase } from './taylorclient.types';
+
+const qb = createQueryBuilder<TaylorDatabase>({
+  baseUrl: 'YOUR_TAYLORDB_BASE_URL',
+  apiKey: 'YOUR_TAYLORDB_API_KEY',
+});
+```
+
+## Usage
+
+### Selecting Data
+
+You can select data from a table using the `selectFrom` method. You can specify which fields to return, and you can filter, sort, and paginate the results.
+
+```typescript
+const customers = await qb
+  .selectFrom('customers')
+  .select(['firstName', 'lastName'])
+  .where('firstName', '=', 'John')
+  .orderBy('lastName', 'asc')
+  .paginate(1, 10)
+  .execute();
+```
+
+### Inserting Data
+
+You can insert data into a table using the `insertInto` method.
+
+```typescript
+const newCustomer = await qb
+  .insertInto('customers')
+  .values({
+    firstName: 'Jane',
+    lastName: 'Doe',
+  })
+  .execute();
+```
+
+### Updating Data
+
+You can update data in a table using the `update` method.
+
+```typescript
+const updatedCustomer = await qb
+  .update('customers')
+  .set({ lastName: 'Smith' })
+  .where('id', '=', 1)
+  .execute();
+```
+
+### Deleting Data
+
+You can delete data from a table using the `deleteFrom` method.
+
+```typescript
+const result = await qb.deleteFrom('customers').where('id', '=', 1).execute();
+```
+
+### Batch Queries
+
+You can execute multiple queries in a single batch request for improved performance. The result will be a tuple that corresponds to the results of each query in the batch.
+
+```typescript
+const [customers, newCustomer] = await qb
+  .batch([
+    qb.selectFrom('customers').select(['firstName', 'lastName']),
+    qb.insertInto('customers').values({ firstName: 'John', lastName: 'Doe' }),
+  ])
+  .execute();
+```
+
+### Aggregation Queries
+
+You can perform powerful aggregation queries using the `aggregateFrom` method. You can group by one or more fields and specify aggregate functions to apply.
+
+```typescript
+const aggregates = await qb
+  .aggregateFrom('customers')
+  .groupBy('firstName', 'asc')
+  .groupBy('lastName', 'desc')
+  .withAggregates({
+    id: ['count', 'sum'],
+  })
+  .execute();
+```

package/dist/example.d.ts

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

package/dist/example.js

@@ -0,0 +1,51 @@
+import { createQueryBuilder } from './query-builder';
+// --- End of Sample Database Definition ---
+const qb = createQueryBuilder();
+// Example 1: Simple select with a where clause
+const simpleSelect = qb
+    .selectFrom('customers')
+    .select(['id', 'name', 'email'])
+    .where('email', '=', 'test@example.com')
+    .compile();
+console.log('--- Simple Select ---');
+console.log(simpleSelect);
+// Example 2: Select with multiple conditions (AND)
+const andConditions = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where('name', '=', 'John Doe')
+    .where('phone', '!=', '555-1234')
+    .compile();
+console.log('\n--- AND Conditions ---');
+console.log(andConditions);
+// Example 3: Select with OR conditions
+const orConditions = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where('name', '=', 'John Doe')
+    .orWhere('email', 'contains', '@example.com')
+    .compile();
+console.log('\n--- OR Conditions ---');
+console.log(orConditions);
+// Example 4: Nested conditions
+const nestedConditions = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where(qb => qb.where('name', 'startsWith', 'J').where('email', 'endsWith', '.com'))
+    .orWhere(qb => qb.where('phone', 'contains', '555'))
+    .compile();
+console.log('\n--- Nested Conditions ---');
+console.log(nestedConditions);
+// Example 5: Relational select
+const relationalSelect = qb
+    .selectFrom('customers')
+    .select([
+    'id',
+    'name',
+    qb => qb.selectFrom('orders').select(['id', 'address']),
+])
+    .where('id', '=', 1)
+    .compile();
+console.log('\n--- Relational Select ---');
+console.log(relationalSelect);
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAuBnD,4CAA4C;AAE5C,MAAM,EAAE,GAAG,kBAAkB,EAAkB,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,YAAY,GAAG,EAAE;KACpB,UAAU,CAAC,WAAW,CAAC;KACvB,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC;KACvC,OAAO,EAAE,CAAC;AAEb,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AACrC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAE1B,mDAAmD;AACnD,MAAM,aAAa,GAAG,EAAE;KACrB,UAAU,CAAC,WAAW,CAAC;KACvB,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;KACtB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC;KAC9B,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC;KAChC,OAAO,EAAE,CAAC;AAEb,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACxC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAE3B,uCAAuC;AACvC,MAAM,YAAY,GAAG,EAAE;KACpB,UAAU,CAAC,WAAW,CAAC;KACvB,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;KACtB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC;KAC9B,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC;KAC5C,OAAO,EAAE,CAAC;AAEb,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACvC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAE1B,+BAA+B;AAC/B,MAAM,gBAAgB,GAAG,EAAE;KACxB,UAAU,CAAC,WAAW,CAAC;KACvB,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;KACtB,KAAK,CAAC,EAAE,CAAC,EAAE,CACV,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CACvE;KACA,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;KACnD,OAAO,EAAE,CAAC;AAEb,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE9B,+BAA+B;AAC/B,MAAM,gBAAgB,GAAG,EAAE;KACxB,UAAU,CAAC,WAAW,CAAC;KACvB,MAAM,CAAC;IACN,IAAI;IACJ,MAAM;IACN,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;CACxD,CAAC;KACD,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;KACnB,OAAO,EAAE,CAAC;AAEb,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { createQueryBuilder } from './query-builder';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createQueryBuilder } from './query-builder';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC"}

package/dist/insert-query-builder.d.ts

@@ -0,0 +1,6 @@
+import type { AnyDB } from './internal-types';
+export declare class InsertQueryBuilder<DB extends AnyDB, TableName extends keyof DB> {
+    values(_data: Partial<DB[TableName]>): {
+        compile: () => string;
+    };
+}

package/dist/insert-query-builder.js

@@ -0,0 +1,9 @@
+export class InsertQueryBuilder {
+    values(_data) {
+        console.log('Insert functionality not yet implemented.');
+        return {
+            compile: () => 'mutation { ... }',
+        };
+    }
+}
+//# sourceMappingURL=insert-query-builder.js.map

package/dist/insert-query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-query-builder.js","sourceRoot":"","sources":["../src/insert-query-builder.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IAI7B,MAAM,CAAC,KAA6B;QAClC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB;SAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/internal-types.d.ts

@@ -0,0 +1,19 @@
+export type AnyDB = Record<string, Record<string, any>>;
+export type WhereClause = {
+    field: string;
+    operator: string;
+    value: any;
+};
+export type FilterGroup = {
+    conjunction: 'and' | 'or';
+    filters: (WhereClause | FilterGroup)[];
+};
+export type QueryNode = {
+    from: string;
+    selects: (string | QueryNode)[];
+    filters: FilterGroup;
+    pagination?: {
+        limit?: number;
+        offset?: number;
+    };
+};

package/dist/internal-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=internal-types.js.map

package/dist/internal-types.js.map

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

package/dist/query-builder.d.ts

@@ -0,0 +1,15 @@
+import type { AnyDB } from './internal-types';
+import { FilterableQueryBuilder } from './where-query-builder';
+import { InsertQueryBuilder } from './insert-query-builder';
+export declare class QueryBuilder<DB extends AnyDB, TableName extends keyof DB> extends FilterableQueryBuilder<DB, TableName> {
+    select<K extends keyof DB[TableName] | ((builder: RootQueryBuilder<DB>) => any)>(fields: K[]): QueryBuilder<DB, TableName>;
+    limit(count: number): QueryBuilder<DB, TableName>;
+    offset(count: number): QueryBuilder<DB, TableName>;
+    paginate(page: number, limit: number): QueryBuilder<DB, TableName>;
+    compile(): string;
+}
+export declare class RootQueryBuilder<DB extends AnyDB> {
+    selectFrom<TableName extends keyof DB & string>(from: TableName): QueryBuilder<DB, TableName>;
+    insertInto<TableName extends keyof DB & string>(_from: TableName): InsertQueryBuilder<DB, TableName>;
+}
+export declare function createQueryBuilder<DB extends AnyDB>(): RootQueryBuilder<DB>;

package/dist/query-builder.js

@@ -0,0 +1,101 @@
+import { jsonToGraphQLQuery } from 'json-to-graphql-query';
+import { FilterableQueryBuilder } from './where-query-builder';
+import { InsertQueryBuilder } from './insert-query-builder';
+export class QueryBuilder extends FilterableQueryBuilder {
+    select(fields) {
+        const newSelects = fields.map(field => {
+            if (typeof field === 'function') {
+                const builder = createQueryBuilder();
+                const subQuery = field(builder);
+                return subQuery._node;
+            }
+            return field;
+        });
+        return new QueryBuilder({
+            ...this._node,
+            selects: [...this._node.selects, ...newSelects],
+        });
+    }
+    limit(count) {
+        return new QueryBuilder({
+            ...this._node,
+            pagination: { ...this._node.pagination, limit: count },
+        });
+    }
+    offset(count) {
+        return new QueryBuilder({
+            ...this._node,
+            pagination: { ...this._node.pagination, offset: count },
+        });
+    }
+    paginate(page, limit) {
+        return this.offset((page - 1) * limit).limit(limit);
+    }
+    compile() {
+        const buildFilters = (group) => {
+            if (group.filters.length === 0)
+                return undefined;
+            return {
+                conjunction: group.conjunction,
+                filtersSet: group.filters.map(f => {
+                    if ('conjunction' in f) {
+                        return buildFilters(f);
+                    }
+                    return { field: f.field, operator: f.operator, value: f.value };
+                }),
+            };
+        };
+        const buildSelects = (selects) => {
+            return selects.reduce((acc, field) => {
+                if (typeof field === 'string') {
+                    acc[field] = true;
+                }
+                else {
+                    const subQuery = new QueryBuilder(field).compile();
+                    // This is a simplification; parsing the compiled subquery would be complex.
+                    const from = field.from;
+                    const subSelects = buildSelects(field.selects);
+                    const filters = buildFilters(field.filters);
+                    const pagination = field.pagination;
+                    acc[from] = {
+                        ...(Object.keys(subSelects).length > 0 && { records: subSelects }),
+                        ...(filters && { __args: { filtersSet: filters } }),
+                        ...(pagination && { __args: { pagination } }),
+                    };
+                }
+                return acc;
+            }, {});
+        };
+        const mainSelects = buildSelects(this._node.selects);
+        const mainFilters = buildFilters(this._node.filters);
+        const mainPagination = this._node.pagination;
+        const query = {
+            query: {
+                [this._node.from]: {
+                    ...(Object.keys(mainSelects).length > 0 && { records: mainSelects }),
+                    __args: {
+                        ...(mainFilters && { filtersSet: mainFilters }),
+                        ...(mainPagination && { pagination: mainPagination }),
+                    },
+                },
+            },
+        };
+        return jsonToGraphQLQuery(query, { pretty: true });
+    }
+}
+export class RootQueryBuilder {
+    selectFrom(from) {
+        return new QueryBuilder({
+            from: from,
+            selects: [],
+            filters: { conjunction: 'and', filters: [] },
+        });
+    }
+    insertInto(_from) {
+        return new InsertQueryBuilder();
+    }
+}
+export function createQueryBuilder() {
+    return new RootQueryBuilder();
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/query-builder.js.map

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

package/dist/sample/basic-example.d.ts

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

package/dist/sample/basic-example.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../src/index.js");
+// --- End of Sample Database Definition ---
+const qb = (0, index_js_1.createQueryBuilder)({
+    baseUrl: process.env.TAYLORDB_BASE_URL,
+    apiKey: process.env.TAYLORDB_API_KEY,
+});
+// Example 1: Simple select with a where clause
+const simpleSelect = qb
+    .selectFrom('customers')
+    .select(['id', 'name', 'email'])
+    .where('email', '=', 'test@example.com')
+    .compile();
+console.log('--- Simple Select ---');
+console.log(simpleSelect);
+// Example 2: Select with multiple conditions (AND)
+const andConditions = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where('name', '=', 'John Doe')
+    .where('phone', '!=', '555-1234')
+    .compile();
+console.log('\n--- AND Conditions ---');
+console.log(andConditions);
+// Example 3: Select with OR conditions
+const orConditions = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where('name', '=', '2')
+    .where(qb => qb.where('name', '=', '3').orWhere('name', '=', '4'))
+    .orWhere('email', 'contains', '@example.com')
+    .compile();
+console.log('\n--- OR Conditions ---');
+console.log(orConditions);
+// Example 4: Nested conditions
+const nestedConditions = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where(qb => qb.where('name', 'startsWith', 'J').where('email', 'endsWith', '.com'))
+    .orWhere(qb => qb.where('phone', 'contains', '555'))
+    .compile();
+console.log('\n--- Nested Conditions ---');
+console.log(nestedConditions);
+// Example 5: Relational select with useLink
+const relationalSelect = qb
+    .selectFrom('customers')
+    .select(['id', 'name'])
+    .where(qb => qb.where('name', 'startsWith', 'J').where('email', 'endsWith', '.com'))
+    .where('id', '=', 1)
+    .paginate(1, 10)
+    .compile();
+console.log('\n--- Relational Select ---');
+console.log(relationalSelect);
+//# sourceMappingURL=basic-example.js.map

package/dist/sample/basic-example.js.map

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

package/dist/sample/sample-1/index.d.ts

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

package/dist/sample/sample-1/index.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const query_builder_js_1 = require("../../src/query-builder.js");
+async function main() {
+    const qb = (0, query_builder_js_1.createQueryBuilder)({
+        baseUrl: process.env.TAYLORDB_BASE_URL,
+        apiKey: process.env.TAYLORDB_API_KEY,
+    });
+    // Example 1: Selecting data with filtering, sorting, and pagination
+    console.log('--- Selecting Customers ---');
+    const customers = await qb
+        .selectFrom('customers')
+        .select(['firstName', 'lastName'])
+        .where('firstName', 'contains', 'J')
+        .orderBy('lastName', 'asc')
+        .paginate(1, 10)
+        .execute();
+    console.log(customers);
+    // Example 2: Inserting a new customer
+    console.log('\n--- Inserting a Customer ---');
+    const newCustomer = await qb
+        .insertInto('customers')
+        .values({
+        firstName: 'John',
+        lastName: 'Doe',
+    })
+        .execute();
+    console.log(newCustomer);
+    // Example 3: Updating a customer
+    console.log('\n--- Updating a Customer ---');
+    const updatedCustomer = await qb
+        .update('customers')
+        .set({ lastName: 'Smith' })
+        .where('id', '=', newCustomer[0].id)
+        .execute();
+    console.log(updatedCustomer);
+    // Example 4: Deleting a customer
+    console.log('\n--- Deleting a Customer ---');
+    const deleteResult = await qb
+        .deleteFrom('customers')
+        .where('id', '=', newCustomer[0].id)
+        .execute();
+    console.log(deleteResult);
+    // Example 5: Batching queries
+    console.log('\n--- Batching Queries ---');
+    await qb
+        .batch([
+        qb.selectFrom('customers').select(['firstName', 'lastName']),
+        qb
+            .insertInto('customers')
+            .values({ firstName: 'Batch', lastName: 'User' }),
+    ])
+        .execute();
+    // Example 6: Aggregation query
+    console.log('\n--- Aggregation Query ---');
+    const aggregates = await qb
+        .aggregateFrom('customers')
+        .groupBy('firstName', 'asc')
+        .groupBy('lastName', 'desc')
+        .withAggregates({
+        id: ['sum', 'empty'],
+        updatedAt: ['daysRange'],
+    })
+        .execute();
+    console.log(JSON.stringify(aggregates, null, 2));
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/sample/sample-1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../sample/sample-1/index.ts"],"names":[],"mappings":";;AAAA,iEAAgE;AAGhE,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,IAAA,qCAAkB,EAAiB;QAC5C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAkB;QACvC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAiB;KACtC,CAAC,CAAC;IAEH,oEAAoE;IACpE,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,EAAE;SACvB,UAAU,CAAC,WAAW,CAAC;SACvB,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;SACjC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC;SACnC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC;SACf,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvB,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,EAAE;SACzB,UAAU,CAAC,WAAW,CAAC;SACvB,MAAM,CAAC;QACN,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC;SACD,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEzB,iCAAiC;IACjC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,MAAM,eAAe,GAAG,MAAM,EAAE;SAC7B,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;SAC1B,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACnC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAE7B,iCAAiC;IACjC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,EAAE;SAC1B,UAAU,CAAC,WAAW,CAAC;SACvB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACnC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE1B,8BAA8B;IAC9B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,MAAM,EAAE;SACL,KAAK,CAAC;QACL,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC5D,EAAE;aACC,UAAU,CAAC,WAAW,CAAC;aACvB,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpD,CAAC;SACD,OAAO,EAAE,CAAC;IAEb,+BAA+B;IAC/B,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,EAAE;SACxB,aAAa,CAAC,WAAW,CAAC;SAC1B,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC;SAC3B,cAAc,CAAC;QACd,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,CAAC,WAAW,CAAC;KACzB,CAAC;SACD,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/sample/sample-1/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/sample/sample-1/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