@danielhritcu/zenstack-orm 3.5.6 → 3.5.8

package/dist/index.d.cts

@@ -689,6 +689,10 @@ type ClientOptions<Schema extends SchemaDef> = QueryOptions<Schema> & {
          * for request-scoped values.
          */
         where?: DefaultWhereConfig | (() => DefaultWhereConfig);
+        /**
+         * Default page size for .paginate() calls. Defaults to 20 if not set.
+         */
+        pageSize?: number;
     };
     /**
      * Kysely dialect.
@@ -1185,7 +1189,7 @@ type WhereInput<Schema extends SchemaDef, Model extends GetModels<Schema>, Optio
     [Key in GetModelFields<Schema, Model> as ScalarOnly extends true ? Key extends RelationFields<Schema, Model> ? never : Key : Key]?: FieldFilter<Schema, Model, Key, Options, WithAggregations>;
 } & {
     $expr?: (eb: ExpressionBuilder<ToKyselySchema<Schema>, Model>) => OperandExpression<SqlBool>;
-    search?: SearchPayload;
+    search?: string | SearchPayload;
 } & {
     AND?: OrArray<WhereInput<Schema, Model, Options, ScalarOnly>>;
     OR?: WhereInput<Schema, Model, Options, ScalarOnly>[];
@@ -2238,6 +2242,47 @@ interface Diagnostics {
     slowQueries: QueryInfo[];
 }
 
+/**
+ * Offset pagination result.
+ */
+interface PaginatedOffset<T> {
+    items: T[];
+    pagination: {
+        count: number;
+        page: {
+            size: number;
+            current: number;
+            next: number | null;
+            prev: number | null;
+            total: number;
+        };
+        has: {
+            next: boolean;
+            prev: boolean;
+        };
+    };
+}
+/**
+ * Cursor pagination result.
+ */
+interface PaginatedCursor<T> {
+    items: T[];
+    pagination: {
+        count: number;
+        page: {
+            size: number;
+        };
+        has: {
+            next: boolean;
+            prev: boolean;
+        };
+        cursor: {
+            next: string | null;
+            prev: string | null;
+        };
+    };
+}
+
 /**
  * A promise that only executes when it's awaited or .then() is called.
  */
@@ -2998,6 +3043,29 @@ type CommonModelOperations<Schema extends SchemaDef, Model extends GetModels<Sch
      * }); // result: `boolean`
      */
     exists<T extends ExistsArgs<Schema, Model, Options, ExtQueryArgs>>(args?: Subset<T, ExistsArgs<Schema, Model, Options, ExtQueryArgs>>): ZenStackPromise<Schema, boolean>;
+    /**
+     * Returns paginated results with metadata.
+     *
+     * Offset mode (pass `page`):
+     * ```ts
+     * const result = await db.user.paginate({ page: 1, pageSize: 20 });
+     * // result.items, result.pagination.page.current, result.pagination.has.next
+     * ```
+     *
+     * Cursor mode (pass `cursor`):
+     * ```ts
+     * const result = await db.user.paginate({ cursor: lastId, pageSize: 20 });
+     * // result.items, result.pagination.cursor.next, result.pagination.has.next
+     * ```
+     */
+    paginate<T extends FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>(args: Omit<SelectSubset<T, FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>, 'skip' | 'take' | 'cursor'> & {
+        page: number;
+        pageSize?: number;
+    }): ZenStackPromise<Schema, PaginatedOffset<SimplifiedPlainResult<Schema, Model, T, Options, ExtResult>>>;
+    paginate<T extends FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>(args: Omit<SelectSubset<T, FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>, 'skip' | 'take' | 'cursor'> & {
+        cursor: string;
+        pageSize?: number;
+    }): ZenStackPromise<Schema, PaginatedCursor<SimplifiedPlainResult<Schema, Model, T, Options, ExtResult>>>;
 };
 type OperationsRequiringCreate = 'create' | 'createMany' | 'createManyAndReturn' | 'upsert';
 type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>, Options extends ClientOptions<Schema> = ClientOptions<Schema>, ExtQueryArgs extends ExtQueryArgsBase = {}, ExtResult extends ExtResultBase<Schema> = {}> = SliceOperations<AllModelOperations<Schema, Model, Options, ExtQueryArgs, ExtResult>, Schema, Model, Options>;
@@ -3406,4 +3474,4 @@ declare namespace schemaUtils {
   export { schemaUtils_ExpressionVisitor as ExpressionVisitor, schemaUtils_MatchingExpressionVisitor as MatchingExpressionVisitor, type schemaUtils_VisitResult as VisitResult };
 }
 
-export { type AfterEntityMutationCallback, type AggregateArgs, type AggregateResult, AllCrudOperations, type AllModelOperations, AllReadOperations, AnyNull, AnyNullClass, type AnyPlugin, type AuthType, BaseCrudDialect, type BatchResult, type BeforeEntityMutationCallback, type BooleanFilter, type BytesFilter, CRUD, CRUD_EXT, type ClientConstructor, type ClientContract, type ClientOptions, type ComputedFieldsOptions, CoreCreateOperations, CoreCrudOperations, CoreDeleteOperations, CoreReadOperations, CoreUpdateOperations, CoreWriteOperations, type CountArgs, type CountResult, type CreateArgs, type CreateInput, type CreateManyAndReturnArgs, type CreateManyArgs, type CreateManyInput, type DateTimeFilter, DbNull, DbNullClass, type DefaultModelResult, type DefaultWhereConfig, type DeleteArgs, type DeleteManyArgs, type EntityMutationHooksDef, type ExistsArgs, type ExtClientMembersBase, type ExtQueryArgsBase, type ExtResultBase, type ExtResultInferenceArgs, type ExtResultSelectOmitFields, type ExtractExtResult, type FilterKind, type FindArgs, type FindFirstArgs, type FindManyArgs, type FindUniqueArgs, type GetAllIncludedOperations, type GetIncludedOperations, type GetProcedure, type GetProcedureNames, type GetProcedureParams, type GetQueryOptions, type GetSlicedFilterKindsForField, type GetSlicedModels, type GetSlicedOperations, type GetSlicedProcedures, type GroupByArgs, type GroupByResult, type HasComputedFields, type HasProcedures, type IncludeInput, InputValidator, type JsonArray, type JsonFilter, JsonNull, JsonNullClass, type JsonNullValues, type JsonObject, type JsonValue, kyselyUtils as KyselyUtils, LOGICAL_COMBINATORS, type MapModelFieldType, type ModelAllowsCreate, type ModelHasRequiredUnsupportedField, type ModelOperations, type ModelResult, type ModelSlicingOptions, type NullsOrder, type NumberFilter, ORMError, ORMErrorReason, type OmitConfig, type OmitInput, type OnKyselyQueryArgs, type OnKyselyQueryCallback, type OnProcedureHookContext, type OperationsRequiringCreate, type OrderBy, type PluginAfterEntityMutationArgs, type PluginBeforeEntityMutationArgs, type ProcedureEnvelope, type ProcedureFunc, type ProcedureHandlerFunc, type ProcedureOperations, type ProceduresOptions, type ProceedKyselyQueryFunction, type QueryOptions, queryUtils as QueryUtils, RejectedByPolicyReason, type RuntimePlugin, schemaUtils as SchemaUtils, type SearchFieldMap, type SearchMode, type SearchPayload, type SearchStrategy, type SelectAwareExtResult, type SelectIncludeOmit, type SelectInput, type SelectSubset, type SimplifiedPlainResult, type SimplifiedResult, type SlicingOptions, type SortOrder, type StringFilter, type Subset, type ToKysely, type TransactionClientContract, TransactionIsolationLevel, type TypeDefResult, type TypedJsonFilter, type UpdateArgs, type UpdateInput, type UpdateManyAndReturnArgs, type UpdateManyArgs, type UpsertArgs, type WhereInput, type WhereUniqueInput, ZENSTACK_QUERY_KIND_SYMBOL, ZENSTACK_QUERY_SYMBOL, type ZModelFunction, type ZModelFunctionContext, ZenStackClient, type ZenStackPromise, type ZenStackQueryKind, createQuerySchemaFactory, definePlugin, getCrudDialect };
+export { type AfterEntityMutationCallback, type AggregateArgs, type AggregateResult, AllCrudOperations, type AllModelOperations, AllReadOperations, AnyNull, AnyNullClass, type AnyPlugin, type AuthType, BaseCrudDialect, type BatchResult, type BeforeEntityMutationCallback, type BooleanFilter, type BytesFilter, CRUD, CRUD_EXT, type ClientConstructor, type ClientContract, type ClientOptions, type ComputedFieldsOptions, CoreCreateOperations, CoreCrudOperations, CoreDeleteOperations, CoreReadOperations, CoreUpdateOperations, CoreWriteOperations, type CountArgs, type CountResult, type CreateArgs, type CreateInput, type CreateManyAndReturnArgs, type CreateManyArgs, type CreateManyInput, type DateTimeFilter, DbNull, DbNullClass, type DefaultModelResult, type DefaultWhereConfig, type DeleteArgs, type DeleteManyArgs, type EntityMutationHooksDef, type ExistsArgs, type ExtClientMembersBase, type ExtQueryArgsBase, type ExtResultBase, type ExtResultInferenceArgs, type ExtResultSelectOmitFields, type ExtractExtResult, type FilterKind, type FindArgs, type FindFirstArgs, type FindManyArgs, type FindUniqueArgs, type GetAllIncludedOperations, type GetIncludedOperations, type GetProcedure, type GetProcedureNames, type GetProcedureParams, type GetQueryOptions, type GetSlicedFilterKindsForField, type GetSlicedModels, type GetSlicedOperations, type GetSlicedProcedures, type GroupByArgs, type GroupByResult, type HasComputedFields, type HasProcedures, type IncludeInput, InputValidator, type JsonArray, type JsonFilter, JsonNull, JsonNullClass, type JsonNullValues, type JsonObject, type JsonValue, kyselyUtils as KyselyUtils, LOGICAL_COMBINATORS, type MapModelFieldType, type ModelAllowsCreate, type ModelHasRequiredUnsupportedField, type ModelOperations, type ModelResult, type ModelSlicingOptions, type NullsOrder, type NumberFilter, ORMError, ORMErrorReason, type OmitConfig, type OmitInput, type OnKyselyQueryArgs, type OnKyselyQueryCallback, type OnProcedureHookContext, type OperationsRequiringCreate, type OrderBy, type PaginatedCursor, type PaginatedOffset, type PluginAfterEntityMutationArgs, type PluginBeforeEntityMutationArgs, type ProcedureEnvelope, type ProcedureFunc, type ProcedureHandlerFunc, type ProcedureOperations, type ProceduresOptions, type ProceedKyselyQueryFunction, type QueryOptions, queryUtils as QueryUtils, RejectedByPolicyReason, type RuntimePlugin, schemaUtils as SchemaUtils, type SearchFieldMap, type SearchMode, type SearchPayload, type SearchStrategy, type SelectAwareExtResult, type SelectIncludeOmit, type SelectInput, type SelectSubset, type SimplifiedPlainResult, type SimplifiedResult, type SlicingOptions, type SortOrder, type StringFilter, type Subset, type ToKysely, type TransactionClientContract, TransactionIsolationLevel, type TypeDefResult, type TypedJsonFilter, type UpdateArgs, type UpdateInput, type UpdateManyAndReturnArgs, type UpdateManyArgs, type UpsertArgs, type WhereInput, type WhereUniqueInput, ZENSTACK_QUERY_KIND_SYMBOL, ZENSTACK_QUERY_SYMBOL, type ZModelFunction, type ZModelFunctionContext, ZenStackClient, type ZenStackPromise, type ZenStackQueryKind, createQuerySchemaFactory, definePlugin, getCrudDialect };

package/dist/index.d.ts

@@ -689,6 +689,10 @@ type ClientOptions<Schema extends SchemaDef> = QueryOptions<Schema> & {
          * for request-scoped values.
          */
         where?: DefaultWhereConfig | (() => DefaultWhereConfig);
+        /**
+         * Default page size for .paginate() calls. Defaults to 20 if not set.
+         */
+        pageSize?: number;
     };
     /**
      * Kysely dialect.
@@ -1185,7 +1189,7 @@ type WhereInput<Schema extends SchemaDef, Model extends GetModels<Schema>, Optio
     [Key in GetModelFields<Schema, Model> as ScalarOnly extends true ? Key extends RelationFields<Schema, Model> ? never : Key : Key]?: FieldFilter<Schema, Model, Key, Options, WithAggregations>;
 } & {
     $expr?: (eb: ExpressionBuilder<ToKyselySchema<Schema>, Model>) => OperandExpression<SqlBool>;
-    search?: SearchPayload;
+    search?: string | SearchPayload;
 } & {
     AND?: OrArray<WhereInput<Schema, Model, Options, ScalarOnly>>;
     OR?: WhereInput<Schema, Model, Options, ScalarOnly>[];
@@ -2238,6 +2242,47 @@ interface Diagnostics {
     slowQueries: QueryInfo[];
 }
 
+/**
+ * Offset pagination result.
+ */
+interface PaginatedOffset<T> {
+    items: T[];
+    pagination: {
+        count: number;
+        page: {
+            size: number;
+            current: number;
+            next: number | null;
+            prev: number | null;
+            total: number;
+        };
+        has: {
+            next: boolean;
+            prev: boolean;
+        };
+    };
+}
+/**
+ * Cursor pagination result.
+ */
+interface PaginatedCursor<T> {
+    items: T[];
+    pagination: {
+        count: number;
+        page: {
+            size: number;
+        };
+        has: {
+            next: boolean;
+            prev: boolean;
+        };
+        cursor: {
+            next: string | null;
+            prev: string | null;
+        };
+    };
+}
+
 /**
  * A promise that only executes when it's awaited or .then() is called.
  */
@@ -2998,6 +3043,29 @@ type CommonModelOperations<Schema extends SchemaDef, Model extends GetModels<Sch
      * }); // result: `boolean`
      */
     exists<T extends ExistsArgs<Schema, Model, Options, ExtQueryArgs>>(args?: Subset<T, ExistsArgs<Schema, Model, Options, ExtQueryArgs>>): ZenStackPromise<Schema, boolean>;
+    /**
+     * Returns paginated results with metadata.
+     *
+     * Offset mode (pass `page`):
+     * ```ts
+     * const result = await db.user.paginate({ page: 1, pageSize: 20 });
+     * // result.items, result.pagination.page.current, result.pagination.has.next
+     * ```
+     *
+     * Cursor mode (pass `cursor`):
+     * ```ts
+     * const result = await db.user.paginate({ cursor: lastId, pageSize: 20 });
+     * // result.items, result.pagination.cursor.next, result.pagination.has.next
+     * ```
+     */
+    paginate<T extends FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>(args: Omit<SelectSubset<T, FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>, 'skip' | 'take' | 'cursor'> & {
+        page: number;
+        pageSize?: number;
+    }): ZenStackPromise<Schema, PaginatedOffset<SimplifiedPlainResult<Schema, Model, T, Options, ExtResult>>>;
+    paginate<T extends FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>(args: Omit<SelectSubset<T, FindManyArgs<Schema, Model, Options, ExtQueryArgs, ExtResult>>, 'skip' | 'take' | 'cursor'> & {
+        cursor: string;
+        pageSize?: number;
+    }): ZenStackPromise<Schema, PaginatedCursor<SimplifiedPlainResult<Schema, Model, T, Options, ExtResult>>>;
 };
 type OperationsRequiringCreate = 'create' | 'createMany' | 'createManyAndReturn' | 'upsert';
 type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>, Options extends ClientOptions<Schema> = ClientOptions<Schema>, ExtQueryArgs extends ExtQueryArgsBase = {}, ExtResult extends ExtResultBase<Schema> = {}> = SliceOperations<AllModelOperations<Schema, Model, Options, ExtQueryArgs, ExtResult>, Schema, Model, Options>;
@@ -3406,4 +3474,4 @@ declare namespace schemaUtils {
   export { schemaUtils_ExpressionVisitor as ExpressionVisitor, schemaUtils_MatchingExpressionVisitor as MatchingExpressionVisitor, type schemaUtils_VisitResult as VisitResult };
 }
 
-export { type AfterEntityMutationCallback, type AggregateArgs, type AggregateResult, AllCrudOperations, type AllModelOperations, AllReadOperations, AnyNull, AnyNullClass, type AnyPlugin, type AuthType, BaseCrudDialect, type BatchResult, type BeforeEntityMutationCallback, type BooleanFilter, type BytesFilter, CRUD, CRUD_EXT, type ClientConstructor, type ClientContract, type ClientOptions, type ComputedFieldsOptions, CoreCreateOperations, CoreCrudOperations, CoreDeleteOperations, CoreReadOperations, CoreUpdateOperations, CoreWriteOperations, type CountArgs, type CountResult, type CreateArgs, type CreateInput, type CreateManyAndReturnArgs, type CreateManyArgs, type CreateManyInput, type DateTimeFilter, DbNull, DbNullClass, type DefaultModelResult, type DefaultWhereConfig, type DeleteArgs, type DeleteManyArgs, type EntityMutationHooksDef, type ExistsArgs, type ExtClientMembersBase, type ExtQueryArgsBase, type ExtResultBase, type ExtResultInferenceArgs, type ExtResultSelectOmitFields, type ExtractExtResult, type FilterKind, type FindArgs, type FindFirstArgs, type FindManyArgs, type FindUniqueArgs, type GetAllIncludedOperations, type GetIncludedOperations, type GetProcedure, type GetProcedureNames, type GetProcedureParams, type GetQueryOptions, type GetSlicedFilterKindsForField, type GetSlicedModels, type GetSlicedOperations, type GetSlicedProcedures, type GroupByArgs, type GroupByResult, type HasComputedFields, type HasProcedures, type IncludeInput, InputValidator, type JsonArray, type JsonFilter, JsonNull, JsonNullClass, type JsonNullValues, type JsonObject, type JsonValue, kyselyUtils as KyselyUtils, LOGICAL_COMBINATORS, type MapModelFieldType, type ModelAllowsCreate, type ModelHasRequiredUnsupportedField, type ModelOperations, type ModelResult, type ModelSlicingOptions, type NullsOrder, type NumberFilter, ORMError, ORMErrorReason, type OmitConfig, type OmitInput, type OnKyselyQueryArgs, type OnKyselyQueryCallback, type OnProcedureHookContext, type OperationsRequiringCreate, type OrderBy, type PluginAfterEntityMutationArgs, type PluginBeforeEntityMutationArgs, type ProcedureEnvelope, type ProcedureFunc, type ProcedureHandlerFunc, type ProcedureOperations, type ProceduresOptions, type ProceedKyselyQueryFunction, type QueryOptions, queryUtils as QueryUtils, RejectedByPolicyReason, type RuntimePlugin, schemaUtils as SchemaUtils, type SearchFieldMap, type SearchMode, type SearchPayload, type SearchStrategy, type SelectAwareExtResult, type SelectIncludeOmit, type SelectInput, type SelectSubset, type SimplifiedPlainResult, type SimplifiedResult, type SlicingOptions, type SortOrder, type StringFilter, type Subset, type ToKysely, type TransactionClientContract, TransactionIsolationLevel, type TypeDefResult, type TypedJsonFilter, type UpdateArgs, type UpdateInput, type UpdateManyAndReturnArgs, type UpdateManyArgs, type UpsertArgs, type WhereInput, type WhereUniqueInput, ZENSTACK_QUERY_KIND_SYMBOL, ZENSTACK_QUERY_SYMBOL, type ZModelFunction, type ZModelFunctionContext, ZenStackClient, type ZenStackPromise, type ZenStackQueryKind, createQuerySchemaFactory, definePlugin, getCrudDialect };
+export { type AfterEntityMutationCallback, type AggregateArgs, type AggregateResult, AllCrudOperations, type AllModelOperations, AllReadOperations, AnyNull, AnyNullClass, type AnyPlugin, type AuthType, BaseCrudDialect, type BatchResult, type BeforeEntityMutationCallback, type BooleanFilter, type BytesFilter, CRUD, CRUD_EXT, type ClientConstructor, type ClientContract, type ClientOptions, type ComputedFieldsOptions, CoreCreateOperations, CoreCrudOperations, CoreDeleteOperations, CoreReadOperations, CoreUpdateOperations, CoreWriteOperations, type CountArgs, type CountResult, type CreateArgs, type CreateInput, type CreateManyAndReturnArgs, type CreateManyArgs, type CreateManyInput, type DateTimeFilter, DbNull, DbNullClass, type DefaultModelResult, type DefaultWhereConfig, type DeleteArgs, type DeleteManyArgs, type EntityMutationHooksDef, type ExistsArgs, type ExtClientMembersBase, type ExtQueryArgsBase, type ExtResultBase, type ExtResultInferenceArgs, type ExtResultSelectOmitFields, type ExtractExtResult, type FilterKind, type FindArgs, type FindFirstArgs, type FindManyArgs, type FindUniqueArgs, type GetAllIncludedOperations, type GetIncludedOperations, type GetProcedure, type GetProcedureNames, type GetProcedureParams, type GetQueryOptions, type GetSlicedFilterKindsForField, type GetSlicedModels, type GetSlicedOperations, type GetSlicedProcedures, type GroupByArgs, type GroupByResult, type HasComputedFields, type HasProcedures, type IncludeInput, InputValidator, type JsonArray, type JsonFilter, JsonNull, JsonNullClass, type JsonNullValues, type JsonObject, type JsonValue, kyselyUtils as KyselyUtils, LOGICAL_COMBINATORS, type MapModelFieldType, type ModelAllowsCreate, type ModelHasRequiredUnsupportedField, type ModelOperations, type ModelResult, type ModelSlicingOptions, type NullsOrder, type NumberFilter, ORMError, ORMErrorReason, type OmitConfig, type OmitInput, type OnKyselyQueryArgs, type OnKyselyQueryCallback, type OnProcedureHookContext, type OperationsRequiringCreate, type OrderBy, type PaginatedCursor, type PaginatedOffset, type PluginAfterEntityMutationArgs, type PluginBeforeEntityMutationArgs, type ProcedureEnvelope, type ProcedureFunc, type ProcedureHandlerFunc, type ProcedureOperations, type ProceduresOptions, type ProceedKyselyQueryFunction, type QueryOptions, queryUtils as QueryUtils, RejectedByPolicyReason, type RuntimePlugin, schemaUtils as SchemaUtils, type SearchFieldMap, type SearchMode, type SearchPayload, type SearchStrategy, type SelectAwareExtResult, type SelectIncludeOmit, type SelectInput, type SelectSubset, type SimplifiedPlainResult, type SimplifiedResult, type SlicingOptions, type SortOrder, type StringFilter, type Subset, type ToKysely, type TransactionClientContract, TransactionIsolationLevel, type TypeDefResult, type TypedJsonFilter, type UpdateArgs, type UpdateInput, type UpdateManyAndReturnArgs, type UpdateManyArgs, type UpsertArgs, type WhereInput, type WhereUniqueInput, ZENSTACK_QUERY_KIND_SYMBOL, ZENSTACK_QUERY_SYMBOL, type ZModelFunction, type ZModelFunctionContext, ZenStackClient, type ZenStackPromise, type ZenStackQueryKind, createQuerySchemaFactory, definePlugin, getCrudDialect };

package/dist/index.js

@@ -2825,9 +2825,18 @@ function extractSearch(where) {
   let found;
   const cleaned = {};
   for (const [key, value] of Object.entries(obj)) {
-    if (key === "search" && isSearchPayload(value)) {
-      found = value;
-      continue;
+    if (key === "search") {
+      if (typeof value === "string") {
+        found = {
+          q: value,
+          profile: "default"
+        };
+        continue;
+      }
+      if (isSearchPayload(value)) {
+        found = value;
+        continue;
+      }
     }
     if (key === "AND" || key === "OR") {
       const result = extractSearch(value);
@@ -2959,9 +2968,9 @@ function expandSearch(model, where, searchDefaults, schemaModels, virtualRelatio
   };
   const profile = search2.profile ? searchDefaults?.[model]?.[search2.profile] : void 0;
   const fields = search2.fields ?? profile?.fields;
-  if (!fields) return {
-    where: remaining
-  };
+  if (!fields) {
+    throw new Error(`Search on "${model}" requires a "default" search profile or explicit fields.`);
+  }
   const mode = search2.mode ?? profile?.mode ?? "contains";
   const strategy = search2.strategy ?? profile?.strategy ?? "all";
   const tokens = unique(search2.q.trim().split(/\s+/).map((t) => t.toLowerCase()).filter(Boolean));
@@ -5790,7 +5799,28 @@ var ZodSchemaFactory = class {
     }).optional();
     const searchDefaults = this.schema.plugins?.searchDefaults?.[model];
     if (searchDefaults) {
-      fields["search"] = z.any().optional();
+      const searchFieldMapSchema = z.lazy(() => z.record(z.string(), z.union([
+        z.literal(true),
+        searchFieldMapSchema
+      ])));
+      const searchPayloadSchema = zLooseObject({
+        q: z.string(),
+        fields: searchFieldMapSchema.optional(),
+        profile: z.string().optional(),
+        mode: z.enum([
+          "contains",
+          "startsWith",
+          "equals"
+        ]).optional(),
+        strategy: z.enum([
+          "all",
+          "any"
+        ]).optional()
+      });
+      fields["search"] = z.union([
+        z.string(),
+        searchPayloadSchema
+      ]).optional();
     }
     fields["AND"] = this.orArray(z.lazy(() => this.makeWhereSchema(model, false, withoutRelationFields, false, options)), true).optional();
     fields["OR"] = z.lazy(() => this.makeWhereSchema(model, false, withoutRelationFields, false, options)).array().optional();
@@ -10126,7 +10156,87 @@ function createModelCrudHandler(client, model, inputValidator, resultProcessor)
     }, "groupBy"),
     exists: /* @__PURE__ */ __name((args) => {
       return createPromise("exists", "exists", args, new ExistsOperationHandler(client, model, inputValidator), false);
-    }, "exists")
+    }, "exists"),
+    paginate: /* @__PURE__ */ __name((args) => {
+      return createZenStackPromise(async () => {
+        const rawArgs = args ?? {};
+        const pageSize = rawArgs["pageSize"] ?? client.$options?.default?.pageSize ?? 20;
+        const page = rawArgs["page"];
+        const cursorId = rawArgs["cursor"];
+        const findBaseArgs = {};
+        for (const [k, v] of Object.entries(rawArgs)) {
+          if (k !== "page" && k !== "cursor" && k !== "pageSize") {
+            findBaseArgs[k] = v;
+          }
+        }
+        const countResult = await operations.count({
+          where: findBaseArgs["where"]
+        });
+        let items;
+        if (page !== void 0) {
+          items = await operations.findMany({
+            ...findBaseArgs,
+            skip: (page - 1) * pageSize,
+            take: pageSize
+          });
+        } else {
+          items = await operations.findMany({
+            ...findBaseArgs,
+            ...cursorId ? {
+              cursor: {
+                id: cursorId
+              },
+              skip: 1
+            } : {},
+            take: pageSize + 1
+          });
+        }
+        const count = countResult;
+        if (page !== void 0) {
+          const total = Math.ceil(count / pageSize);
+          const hasNext = page < total;
+          const hasPrev = page > 1;
+          return {
+            items,
+            pagination: {
+              count,
+              page: {
+                size: pageSize,
+                current: page,
+                next: hasNext ? page + 1 : null,
+                prev: hasPrev ? page - 1 : null,
+                total
+              },
+              has: {
+                next: hasNext,
+                prev: hasPrev
+              }
+            }
+          };
+        } else {
+          const hasNext = items.length > pageSize;
+          if (hasNext) items = items.slice(0, pageSize);
+          const hasPrev = cursorId != null;
+          return {
+            items,
+            pagination: {
+              count,
+              page: {
+                size: pageSize
+              },
+              has: {
+                next: hasNext,
+                prev: hasPrev
+              },
+              cursor: {
+                next: hasNext && items.length > 0 ? items[items.length - 1].id : null,
+                prev: hasPrev && items.length > 0 ? items[0].id : null
+              }
+            }
+          };
+        }
+      });
+    }, "paginate")
   };
   const slicing = client.$options.slicing;
   if (slicing?.models) {