dsqlbase 0.0.1 → 0.1.1

package/dist/client/model/base.d.ts

@@ -0,0 +1,330 @@
+import { SQLValue } from "@dsqlbase/core";
+import { AnyColumnDefinition, AnyNamespaceDefinition, AnyFieldRelation, AnyTableRelations, ColumnConfig, TableDefinition } from "@dsqlbase/core/definition";
+import { AnySchema, AnyTable, SchemaTableRelations, Table } from "@dsqlbase/core/runtime";
+import { Prettify } from "@dsqlbase/core/utils";
+export type FieldNamesOf<T extends AnyTable> = keyof T["__type"]["columns"] extends infer K ? K extends string ? T["__type"]["columns"][K] extends AnyColumnDefinition ? K : never : never : never;
+export type RelationFieldNamesOf<T extends AnyTable> = T["__type"]["relations"] extends AnyTableRelations ? keyof T["__type"]["relations"] extends infer K ? K extends string ? T["__type"]["relations"][K] extends AnyFieldRelation ? K : never : never : never : never;
+export type ColumnTypeOf<T extends AnyTable, K extends FieldNamesOf<T>> = T["__type"]["columns"] extends Record<K, infer TColumn> ? TColumn extends AnyColumnDefinition ? TColumn["__type"] : never : never;
+export type FieldRelationOf<T extends AnyTable, K extends RelationFieldNamesOf<T>> = T["__type"]["relations"] extends Record<K, infer R> ? R extends AnyFieldRelation ? R : never : never;
+export type ValueTypeOf<T extends ColumnConfig> = T extends ColumnConfig ? T["notNull"] extends true ? T["valueType"] : T["valueType"] | null : never;
+export type FieldSelectionOf<T extends AnyTable> = Partial<Record<FieldNamesOf<T>, boolean>>;
+export type SelectedFieldsOf<TTable extends AnyTable, TSelection extends FieldSelectionOf<TTable>> = {
+    [K in keyof TSelection]: TSelection[K] extends true ? K : never;
+}[keyof TSelection];
+export type RequiredFieldsOf<T extends AnyTable> = {
+    [K in FieldNamesOf<T>]: ColumnTypeOf<T, K> extends {
+        notNull: true;
+    } ? ColumnTypeOf<T, K> extends {
+        hasDefault: true;
+    } ? never : K : never;
+}[FieldNamesOf<T>];
+export type RelationTypeOf<T extends AnyTable, K extends RelationFieldNamesOf<T>> = FieldRelationOf<T, K>["type"];
+export type RelationTargetOf<T extends AnyTable, K extends RelationFieldNamesOf<T>> = FieldRelationOf<T, K>["target"];
+export type OptionalFieldsOf<T extends AnyTable> = {
+    [K in FieldNamesOf<T>]: ColumnTypeOf<T, K> extends {
+        notNull: true;
+    } ? ColumnTypeOf<T, K> extends {
+        hasDefault: true;
+    } ? K : never : K;
+}[FieldNamesOf<T>];
+export type CreateValuesOf<T extends AnyTable> = {
+    [K in RequiredFieldsOf<T>]: ValueTypeOf<ColumnTypeOf<T, K>>;
+} & {
+    [K in OptionalFieldsOf<T>]?: ValueTypeOf<ColumnTypeOf<T, K>>;
+};
+export type ReturningResultOf<T extends AnyTable, TArgs> = TArgs extends {
+    return?: infer R;
+} ? R extends FieldSelectionOf<T> ? {
+    [K in SelectedFieldsOf<T, R>]: K extends FieldNamesOf<T> ? ValueTypeOf<ColumnTypeOf<T, K>> : never;
+} : R extends true ? {
+    [K in FieldNamesOf<T>]: ValueTypeOf<ColumnTypeOf<T, K>>;
+} : Record<string, never> : never;
+export type CreateArgs<TTable extends AnyTable> = Prettify<{
+    data: CreateValuesOf<TTable>;
+    return?: FieldSelectionOf<TTable> | boolean | null | undefined;
+}>;
+export type UpdateValuesOf<T extends AnyTable> = {
+    [K in FieldNamesOf<T>]?: ValueTypeOf<ColumnTypeOf<T, K>>;
+};
+export type UpdateArgs<TTable extends AnyTable> = Prettify<{
+    set: UpdateValuesOf<TTable>;
+    where: WhereExpressionOf<TTable>;
+    return?: FieldSelectionOf<TTable> | boolean | null | undefined;
+}>;
+export type DeleteArgs<TTable extends AnyTable> = Prettify<{
+    where: WhereExpressionOf<TTable>;
+    return?: FieldSelectionOf<TTable> | boolean | null | undefined;
+}>;
+export interface QueryArgs<TTable extends AnyTable, TSchema extends AnySchema> {
+    /**
+     * Select specific fields to return in the query result. If not provided, all fields will be returned.
+     *
+     * @example
+     * ```ts
+     * client.findOne({
+     *   where: { id: { eq: "123" } },
+     *   select: {
+     *     id: true,
+     *     firstName: true,
+     *   },
+     * })
+     * ```
+     * @notes
+     * * The `select` clause allows you to specify which fields to retrieve, if not provided, all fields will be selected by default.
+     * * You can only select fields that exist on the table, attempting to select a non-existent field will result in a TypeScript error.
+     *
+     * @typeParam TTable - The table being queried, used for type inference of selectable fields.
+     * @typeParam TSchema - The overall schema, used for type inference of relations in join expressions.
+     */
+    select?: FieldSelectionOf<TTable>;
+    /**
+     * A filter expression to specify which records to retrieve. This is optional for `findMany`, if not provided, all records will be returned.
+     *
+     * @example
+     * ```ts
+     * client.findMany({
+     *   where: { published: true },
+     * });
+     * ```
+     * @notes
+     * * The `where` clause is optional for `findMany`, if not provided, all records will be returned.
+     * * The `where` clause supports various filter conditions such as equality, inequality, range queries, and more.
+     * * You can combine multiple conditions using logical operators like `and`, `or`, and `not`.
+     * * The fields used in the `where` clause must exist on the table, attempting to filter by a non-existent field will result in a TypeScript error.
+     *
+     * @typeParam TTable - The table being queried, used for type inference of filterable fields.
+     */
+    where?: WhereExpressionOf<TTable>;
+    /**
+     * Specify the order in which to return the records. The keys must be field names of the table, and the values must be either "asc" for ascending order or "desc" for descending order.
+     *
+     * @example
+     * ```ts
+     * client.findMany({
+     *   orderBy: { createdAt: "desc" },
+     * });
+     * ```
+     * @notes
+     * * The `orderBy` clause allows you to specify the order in which to return the records. The keys must be field names of the table, and the values must be either "asc" for ascending order or "desc" for descending order.
+     * * You can specify multiple fields to order by, in which case the records will be ordered by the first field, and then by the second field in case of ties, and so on.
+     * * The fields used in the `orderBy` clause must exist on the table, attempting to order by a non-existent field will result in a TypeScript error.
+     *
+     * @typeParam TTable - The table being queried, used for type inference of orderable fields.
+     */
+    orderBy?: OrderByExpressionOf<TTable>;
+    /**
+     * Specify that the query should return only distinct records based on the selected fields. This is useful when you want to eliminate duplicate records from the result set.
+     *
+     * @example
+     * ```ts
+     * client.findMany({
+     *   where: { published: true },
+     *   distinct: true,
+     * });
+     * ```
+     * @notes
+     * * The `distinct` flag indicates that the query should return only distinct records based on the selected fields. This is useful when you want to eliminate duplicate records from the result set.
+     * * When `distinct` is true, the database will ensure that the returned records are unique based on the fields specified in the `select` clause. If no `select` clause is provided, all fields will be considered for determining uniqueness.
+     * * The `distinct` flag is typically used in conjunction with the `select` clause to specify which fields should be considered when determining uniqueness. If you want to return distinct records based on specific fields, make sure to include those fields in the `select` clause.
+     * * The behavior of the `distinct` flag may vary depending on the underlying database and how it handles distinct queries, especially when combined with joins and other query features.
+     */
+    distinct?: boolean;
+    /**
+     * Specify the maximum number of records to return and the number of records to skip. This is useful for implementing pagination in your queries.
+     *
+     * @example
+     * ```ts
+     * client.findMany({
+     *   where: { published: true },
+     *   limit: 10,
+     *   offset: 20,
+     * });
+     * ```
+     * @notes
+     * * The `limit` parameter specifies the maximum number of records to return. If not provided, the default limit _(100)_ will be applied.
+     * * The `offset` parameter specifies the number of records to skip before starting to return records. This is useful for implementing pagination in your queries. If not provided, no records will be skipped.
+     * * When using `limit` and `offset` together, the query will return records starting from the `offset` position up to the number specified by `limit`. For example, if `offset` is 20 and `limit` is 10, the query will return records 21 through 30.
+     */
+    limit?: number;
+    /**
+     * The `offset` parameter specifies the number of records to skip before starting to return records. This is useful for implementing pagination in your queries. If not provided, no records will be skipped.
+     *
+     * @example
+     * ```ts
+     * client.findMany({
+     *   where: { published: true },
+     *   offset: 20,
+     * });
+     * ```
+     * @notes
+     * * The `offset` parameter specifies the number of records to skip before starting to return records. This is useful for implementing pagination in your queries. If not provided, no records will be skipped.
+     * * When using `limit` and `offset` together, the query will return records starting from the `offset` position up to the number specified by `limit`. For example, if `offset` is 20 and `limit` is 10, the query will return records 21 through 30.
+     */
+    offset?: number;
+    /**
+     * Join related records based on the relations defined in the schema. The value can be a boolean or a nested query object for more complex queries.
+     *
+     * @example
+     * ```ts
+     * client.findOne({
+     *   where: { id: "123" },
+     *   select: {
+     *     id: true,
+     *     firstName: true,
+     *   },
+     *   join: {
+     *     posts: {
+     *       where: { published: true },
+     *       select: {
+     *         title: true,
+     *       },
+     *     },
+     *     profile: true,
+     *   },
+     * })
+     * ```
+     */
+    join?: Prettify<JoinExpressionOf<TTable, TSchema>>;
+}
+export interface FindOneArgs<TTable extends AnyTable, TSchema extends AnySchema> extends Pick<QueryArgs<TTable, TSchema>, "select" | "join"> {
+    /**
+     * A filter expression to specify which record to retrieve. This is required for `findOne` to ensure that the operation is deterministic and does not accidentally return an unintended record.
+     *
+     * @example
+     * ```ts
+     * client.findOne({
+     *   where: { id: { eq: "123" } },
+     * });
+     * ```
+     * @notes
+     * * The `where` clause is required for `findOne` to ensure that the operation is deterministic and does not accidentally return an unintended record.
+     * * The `where` clause supports various filter conditions such as equality, inequality, range queries, and more.
+     * * You can combine multiple conditions using logical operators like `and`, `or`, and `not`.
+     * * The fields used in the `where` clause must exist on the table, attempting to filter by a non-existent field will result in a TypeScript error.
+     *
+     * @typeParam TTable - The table being queried, used for type inference of filterable fields.
+     */
+    where: WhereExpressionOf<TTable>;
+}
+export type RelationQueryOf<T extends AnyTable, S extends AnySchema, K extends RelationFieldNamesOf<T>> = RelationTargetOf<T, K> extends TableDefinition<infer TName, infer TCols, infer TSchema> ? RelationTypeOf<T, K> extends "has_many" ? QueryArgs<Table<TName, TCols, TSchema, SchemaTableRelations<S, TName>>, S> : Pick<QueryArgs<Table<TName, TCols, TSchema, SchemaTableRelations<S, TName>>, S>, "select" | "join"> : never;
+export type SelectionResultOf<TTable extends AnyTable, TSchema extends AnySchema, TArgs extends QueryArgs<TTable, TSchema>> = TArgs["select"] extends FieldSelectionOf<TTable> ? {
+    [K in SelectedFieldsOf<TTable, TArgs["select"]>]: K extends FieldNamesOf<TTable> ? ValueTypeOf<ColumnTypeOf<TTable, K>> : never;
+} : {
+    [K in FieldNamesOf<TTable>]: ValueTypeOf<ColumnTypeOf<TTable, K>>;
+};
+export type RelationJoinResultOf<TTable extends AnyTable, TSchema extends AnySchema, TArgs extends QueryArgs<TTable, TSchema>, TRelationField extends RelationFieldNamesOf<TTable>, TTargetName extends string, TTargetCols extends Record<string, AnyColumnDefinition>, TTargetSchema extends AnyNamespaceDefinition> = RelationTypeOf<TTable, TRelationField> extends "has_many" ? QueryResultOf<Table<TTargetName, TTargetCols, TTargetSchema, SchemaTableRelations<TSchema, TTargetName>>, TSchema, TArgs>[] : QueryResultOf<Table<TTargetName, TTargetCols, TTargetSchema, SchemaTableRelations<TSchema, TTargetName>>, TSchema, TArgs> | null;
+export type QueryResultOf<TTable extends AnyTable, TSchema extends AnySchema, TArgs extends QueryArgs<TTable, TSchema>> = Prettify<SelectionResultOf<TTable, TSchema, TArgs> & {
+    [K in keyof TArgs["join"]]: K extends RelationFieldNamesOf<TTable> ? RelationTargetOf<TTable, K> extends TableDefinition<infer TName, infer TCols, infer TNamespace> ? TArgs["join"][K] extends QueryArgs<Table<TName, TCols, TNamespace, SchemaTableRelations<TSchema, TName>>, TSchema> ? RelationJoinResultOf<TTable, TSchema, TArgs["join"][K], K, TName, TCols, TNamespace> : TArgs["join"][K] extends boolean ? TArgs["join"][K] extends true ? RelationJoinResultOf<TTable, TSchema, QueryArgs<Table<TName, TCols, TNamespace, SchemaTableRelations<TSchema, TName>>, TSchema>, K, TName, TCols, TNamespace> : never : never : never : never;
+}>;
+export interface FilterCondition<Value = unknown> {
+    /**
+     * Equality condition - matches records where the field is equal to the specified value.
+     *
+     * ```sql
+     * "table"."column" = value
+     * ```
+     */
+    eq?: Value;
+    /**
+     * Inequality condition - matches records where the field is not equal to the specified value.
+     *
+     * ```sql
+     * "table"."column" <> value
+     * ```
+     */
+    neq?: Value;
+    /**
+     * Greater than condition - matches records where the field is greater than the specified value.
+     *
+     * ```sql
+     * "table"."column" > value
+     * ```
+     */
+    gt?: Value;
+    /**
+     * Greater than or equal condition - matches records where the field is greater than or equal to the specified value.
+     *
+     * ```sql
+     * "table"."column" >= value
+     * ```
+     */
+    gte?: Value;
+    /**
+     * Less than condition - matches records where the field is less than the specified value.
+     *
+     * ```sql
+     * "table"."column" < value
+     * ```
+     */
+    lt?: Value;
+    /**
+     * Less than or equal condition - matches records where the field is less than or equal to the specified value.
+     *
+     * ```sql
+     * "table"."column" <= value
+     * ```
+     */
+    lte?: Value;
+    /**
+     * In condition - matches records where the field is equal to any of the values in the specified array.
+     *
+     * ```sql
+     * "table"."column" IN (value1, value2, ...)
+     * ```
+     */
+    in?: Value[];
+    /**
+     * Between condition - matches records where the field is between the two specified values (inclusive).
+     *
+     * ```sql
+     * "table"."column" BETWEEN value1 AND value2
+     * ```
+     */
+    between?: [Value, Value];
+    /**
+     * Exists condition - matches records where the field exists (is not null).
+     *
+     * ```sql
+     * "table"."column" IS NOT NULL
+     * ```
+     */
+    exists?: boolean;
+    /**
+     * Begins with condition - matches records where the field starts with the specified string.
+     *
+     * ```sql
+     * "table"."column" LIKE 'value%'
+     * ```
+     */
+    beginsWith?: string;
+    /**
+     * Ends with condition - matches records where the field ends with the specified string.
+     *
+     * ```sql
+     * "table"."column" LIKE '%value'
+     * ```
+     */
+    endsWith?: string;
+    /**
+     * Contains condition - matches records where the field contains the specified string.
+     *
+     * ```sql
+     * "table"."column" LIKE '%value%'
+     * ```
+     */
+    contains?: string;
+}
+export type WhereExpressionOf<T extends AnyTable> = {
+    [K in FieldNamesOf<T>]?: T["__type"]["columns"][K] extends AnyColumnDefinition ? FilterCondition<ValueTypeOf<ColumnTypeOf<T, K>>> | ValueTypeOf<ColumnTypeOf<T, K>> : never;
+} & {
+    and?: WhereExpressionOf<T>[];
+    or?: WhereExpressionOf<T>[];
+    not?: WhereExpressionOf<T>;
+};
+export type OrderByExpressionOf<T extends AnyTable> = Partial<Record<FieldNamesOf<T>, "asc" | "desc">>;
+export type JoinExpressionOf<T extends AnyTable, S extends AnySchema> = {
+    [K in RelationFieldNamesOf<T>]?: RelationQueryOf<T, S, K> | boolean | null | undefined;
+};
+export type AnyRelationQuery = RelationQueryOf<AnyTable, AnySchema, RelationFieldNamesOf<AnyTable>> | boolean;
+export declare function isFilterType<T extends keyof FilterCondition>(value: unknown, type: T): value is Required<Pick<FilterCondition<SQLValue>, T>>;
+//# sourceMappingURL=base.d.ts.map

package/dist/client/model/base.d.ts.map

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

package/dist/client/model/base.js

@@ -0,0 +1,7 @@
+export function isFilterType(value, type) {
+    return (typeof value === "object" &&
+        value !== null &&
+        type in value &&
+        value[type] !== undefined);
+}
+//# sourceMappingURL=base.js.map

package/dist/client/model/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/client/model/base.ts"],"names":[],"mappings":"AA0fA,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,IAAO;IAEP,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,IAAI,IAAI,KAAK;QACb,KAAK,CAAC,IAA0B,CAAC,KAAK,SAAS,CAChD,CAAC;AACJ,CAAC"}

package/dist/client/model/client.d.ts

@@ -0,0 +1,102 @@
+import { DefinitionSchema } from "@dsqlbase/core";
+import { TypedObject } from "@dsqlbase/core/utils";
+import { AnyTable, ExecutableQuery, ExecutionContext, OperationResult, Schema } from "@dsqlbase/core/runtime";
+import { FindOneArgs, QueryArgs, CreateArgs, UpdateArgs, DeleteArgs, QueryResultOf, ReturningResultOf } from "./base.js";
+export declare class ModelClient<TTable extends AnyTable, TDefinition extends DefinitionSchema> implements TypedObject<Schema<TDefinition>> {
+    readonly __type: Schema<TDefinition>;
+    private readonly _ctx;
+    private readonly _table;
+    private readonly _normalizer;
+    constructor(ctx: ExecutionContext<TDefinition>, table: TTable);
+    /**
+     * Finds a single record matching the specified criteria.
+     *
+     * @example
+     * ```ts
+     * const user = await dsql.users.findOne({
+     *   where: { id: "123" },
+     *   select: { id: true, name: true },
+     *   join: {
+     *     profile: {
+     *       select: { bio: true }
+     *     }
+     *   }
+     * });
+     * ```
+     * @notes
+     * * The `where` clause is required to ensure that the operation is deterministic and does not accidentally return an unintended record.
+     * * The `select` clause allows you to specify which fields to retrieve, if not provided, all fields will be selected by default.
+     *
+     * @param args
+     * @returns An executable query that can be awaited.
+     *
+     */
+    findOne<TArgs extends FindOneArgs<TTable, this["__type"]>>(args: TArgs): ExecutableQuery<OperationResult<"one", QueryResultOf<TTable, this["__type"], TArgs>>>;
+    /**
+     * Finds multiple records matching the specified criteria.
+     *
+     * @example
+     * ```ts
+     * const users = await dsql.users.findMany({
+     *   where: { age: { gt: 18 } },
+     *   orderBy: [{ age: "desc" }],
+     *   limit: 10,
+     * });
+     * ```
+     * @param args The query arguments, including filtering, ordering, pagination, and field selection options.
+     * @returns An executable query that can be awaited to retrieve the matching records.
+     */
+    findMany<TArgs extends QueryArgs<TTable, this["__type"]>>(args: TArgs): ExecutableQuery<OperationResult<"many", QueryResultOf<TTable, this["__type"], TArgs>>>;
+    /**
+     * Creates a new record in the database with the specified values.
+     *
+     * @example
+     * ```ts
+     * const newUser = await dsql.users.create({
+     *   data: {
+     *     firstName: "John",
+     *     lastName: "Doe",
+     *     emailAddress: "john.doe@example.com"
+     *   }
+     * });
+     * ```
+     * @param args The arguments for creating a new record, including the data to be inserted.
+     * @returns An executable query that can be awaited to retrieve the newly created record.
+     */
+    create<TArgs extends CreateArgs<TTable>>(args: TArgs): ExecutableQuery<OperationResult<"one", ReturningResultOf<TTable, TArgs>>>;
+    /**
+     * Updates records in the database matching the specified criteria with the provided values.
+     *
+     * @example
+     * ```ts
+     * const updatedUser = await dsql.users.update({
+     *   where: { id: "123" },
+     *   set: { emailAddress: "new.email@example.com" }
+     * });
+     * ```
+     * @param args The arguments for updating records, including the criteria for selecting records and the values to be updated.
+     * @returns An executable query that can be awaited to retrieve the updated record.
+     */
+    update<TArgs extends UpdateArgs<TTable>>(args: TArgs): ExecutableQuery<OperationResult<"one", ReturningResultOf<TTable, TArgs>>>;
+    /**
+     * Deletes records from the database matching the specified criteria.
+     *
+     * @example
+     * ```ts
+     * const deletedUser = await dsql.users.delete({
+     *   where: { id: "123" }
+     *   return: {
+     *     id: true,
+     *     name: true
+     *   }
+     * });
+     * ```
+     * @notes
+     * * The `where` clause is required to ensure that the operation is deterministic and does not accidentally delete unintended records.
+     *
+     * @param args The arguments for deleting records, including the criteria for selecting records to delete.
+     * @returns An executable query that can be awaited to retrieve the deleted record.
+     */
+    delete<TArgs extends DeleteArgs<TTable>>(args: TArgs): ExecutableQuery<OperationResult<"one", ReturningResultOf<TTable, TArgs>>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client/model/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/model/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,MAAM,EACP,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAGnB,qBAAa,WAAW,CACtB,MAAM,SAAS,QAAQ,EACvB,WAAW,SAAS,gBAAgB,CACpC,YAAW,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,SAAiB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;gBAEjD,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM;IAM7D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAEI,OAAO,CAAC,KAAK,SAAS,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAC9D,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAOxF;;;;;;;;;;;;;OAaG;IAEI,QAAQ,CAAC,KAAK,SAAS,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAC7D,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAOzF;;;;;;;;;;;;;;;OAeG;IAEI,MAAM,CAAC,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,EAC5C,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAO5E;;;;;;;;;;;;OAYG;IAEI,MAAM,CAAC,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,EAC5C,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAO5E;;;;;;;;;;;;;;;;;;OAkBG;IAEI,MAAM,CAAC,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,EAC5C,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;CAM7E"}

package/dist/client/model/client.js

@@ -0,0 +1,123 @@
+import { ExecutableQuery, } from "@dsqlbase/core/runtime";
+import { RequestNormalizer } from "./normalizer.js";
+export class ModelClient {
+    _ctx;
+    _table;
+    _normalizer;
+    constructor(ctx, table) {
+        this._ctx = ctx;
+        this._table = table;
+        this._normalizer = new RequestNormalizer(ctx);
+    }
+    /**
+     * Finds a single record matching the specified criteria.
+     *
+     * @example
+     * ```ts
+     * const user = await dsql.users.findOne({
+     *   where: { id: "123" },
+     *   select: { id: true, name: true },
+     *   join: {
+     *     profile: {
+     *       select: { bio: true }
+     *     }
+     *   }
+     * });
+     * ```
+     * @notes
+     * * The `where` clause is required to ensure that the operation is deterministic and does not accidentally return an unintended record.
+     * * The `select` clause allows you to specify which fields to retrieve, if not provided, all fields will be selected by default.
+     *
+     * @param args
+     * @returns An executable query that can be awaited.
+     *
+     */
+    findOne(args) {
+        const request = this._normalizer.normalizeSelect(this._table, args, "one");
+        const operation = this._ctx.operations.createSelectOperation(this._table, request);
+        return new ExecutableQuery(operation, this._ctx.session);
+    }
+    /**
+     * Finds multiple records matching the specified criteria.
+     *
+     * @example
+     * ```ts
+     * const users = await dsql.users.findMany({
+     *   where: { age: { gt: 18 } },
+     *   orderBy: [{ age: "desc" }],
+     *   limit: 10,
+     * });
+     * ```
+     * @param args The query arguments, including filtering, ordering, pagination, and field selection options.
+     * @returns An executable query that can be awaited to retrieve the matching records.
+     */
+    findMany(args) {
+        const request = this._normalizer.normalizeSelect(this._table, args, "many");
+        const operation = this._ctx.operations.createSelectOperation(this._table, request);
+        return new ExecutableQuery(operation, this._ctx.session);
+    }
+    /**
+     * Creates a new record in the database with the specified values.
+     *
+     * @example
+     * ```ts
+     * const newUser = await dsql.users.create({
+     *   data: {
+     *     firstName: "John",
+     *     lastName: "Doe",
+     *     emailAddress: "john.doe@example.com"
+     *   }
+     * });
+     * ```
+     * @param args The arguments for creating a new record, including the data to be inserted.
+     * @returns An executable query that can be awaited to retrieve the newly created record.
+     */
+    create(args) {
+        const request = this._normalizer.normalizeInsert(this._table, args, "one");
+        const operation = this._ctx.operations.createInsertOperation(this._table, request);
+        return new ExecutableQuery(operation, this._ctx.session);
+    }
+    /**
+     * Updates records in the database matching the specified criteria with the provided values.
+     *
+     * @example
+     * ```ts
+     * const updatedUser = await dsql.users.update({
+     *   where: { id: "123" },
+     *   set: { emailAddress: "new.email@example.com" }
+     * });
+     * ```
+     * @param args The arguments for updating records, including the criteria for selecting records and the values to be updated.
+     * @returns An executable query that can be awaited to retrieve the updated record.
+     */
+    update(args) {
+        const request = this._normalizer.normalizeUpdate(this._table, args, "one");
+        const operation = this._ctx.operations.createUpdateOperation(this._table, request);
+        return new ExecutableQuery(operation, this._ctx.session);
+    }
+    /**
+     * Deletes records from the database matching the specified criteria.
+     *
+     * @example
+     * ```ts
+     * const deletedUser = await dsql.users.delete({
+     *   where: { id: "123" }
+     *   return: {
+     *     id: true,
+     *     name: true
+     *   }
+     * });
+     * ```
+     * @notes
+     * * The `where` clause is required to ensure that the operation is deterministic and does not accidentally delete unintended records.
+     *
+     * @param args The arguments for deleting records, including the criteria for selecting records to delete.
+     * @returns An executable query that can be awaited to retrieve the deleted record.
+     */
+    delete(args) {
+        const request = this._normalizer.normalizeDelete(this._table, args, "one");
+        const operation = this._ctx.operations.createDeleteOperation(this._table, request);
+        return new ExecutableQuery(operation, this._ctx.session);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client/model/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/model/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,eAAe,GAIhB,MAAM,wBAAwB,CAAC;AAUhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,OAAO,WAAW;IAML,IAAI,CAAgC;IACpC,MAAM,CAAS;IACf,WAAW,CAAiC;IAE7D,YAAY,GAAkC,EAAE,KAAa;QAC3D,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAc,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAEI,OAAO,CACZ,IAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnF,OAAO,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;OAaG;IAEI,QAAQ,CACb,IAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnF,OAAO,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IAEI,MAAM,CACX,IAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnF,OAAO,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;OAYG;IAEI,MAAM,CACX,IAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnF,OAAO,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IAEI,MAAM,CACX,IAAW;QAEX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnF,OAAO,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/client/model/normalizer.d.ts

@@ -0,0 +1,19 @@
+import { TypedObject } from "@dsqlbase/core/utils";
+import { AnyTable, DefinitionSchema, DeleteOperationArgs, ExecutionContext, InsertOperationArgs, OperationMode, OperationRequest, Schema, SelectOperationArgs, UpdateOperationArgs } from "@dsqlbase/core";
+import { CreateArgs, DeleteArgs, QueryArgs, UpdateArgs } from "./base.js";
+export declare class RequestNormalizer<TDefinition extends DefinitionSchema> implements TypedObject<Schema<TDefinition>> {
+    readonly __type: Schema<TDefinition>;
+    private readonly _ctx;
+    constructor(context: ExecutionContext);
+    private _getWhereExpression;
+    private _getSelectionEntries;
+    private _getOrderByEntries;
+    private _getJoinEntries;
+    private _getMutationEntries;
+    private _getSelectArgs;
+    normalizeSelect<TTable extends AnyTable, TArgs extends QueryArgs<TTable, this["__type"]>, TMode extends OperationMode>(table: TTable, args: TArgs, mode: TMode): OperationRequest<SelectOperationArgs, TMode>;
+    normalizeInsert<TTable extends AnyTable, TArgs extends CreateArgs<TTable>, TMode extends OperationMode>(table: TTable, args: TArgs, mode: TMode): OperationRequest<InsertOperationArgs, TMode>;
+    normalizeUpdate<TTable extends AnyTable, TArgs extends UpdateArgs<TTable>, TMode extends OperationMode>(table: TTable, args: TArgs, mode: TMode): OperationRequest<UpdateOperationArgs, TMode>;
+    normalizeDelete<TTable extends AnyTable, TArgs extends DeleteArgs<TTable>, TMode extends OperationMode>(table: TTable, args: TArgs, mode: TMode): OperationRequest<DeleteOperationArgs, TMode>;
+}
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/client/model/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/client/model/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAGhB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,MAAM,EACN,mBAAmB,EAInB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,UAAU,EACV,UAAU,EAKV,SAAS,EACT,UAAU,EAGX,MAAM,WAAW,CAAC;AAEnB,qBAAa,iBAAiB,CAAC,WAAW,SAAS,gBAAgB,CAAE,YAAW,WAAW,CACzF,MAAM,CAAC,WAAW,CAAC,CACpB;IACC,SAAiB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;gBAE5B,OAAO,EAAE,gBAAgB;IAIrC,OAAO,CAAC,mBAAmB;IAiI3B,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,cAAc;IAoBf,eAAe,CACpB,MAAM,SAAS,QAAQ,EACvB,KAAK,SAAS,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAC/C,KAAK,SAAS,aAAa,EAC3B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,KAAK,CAAC;IAOjF,eAAe,CACpB,MAAM,SAAS,QAAQ,EACvB,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,EAChC,KAAK,SAAS,aAAa,EAC3B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,KAAK,CAAC;IAajF,eAAe,CACpB,MAAM,SAAS,QAAQ,EACvB,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,EAChC,KAAK,SAAS,aAAa,EAC3B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,KAAK,CAAC;IAejF,eAAe,CACpB,MAAM,SAAS,QAAQ,EACvB,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,EAChC,KAAK,SAAS,aAAa,EAC3B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,KAAK,CAAC;CAYzF"}