suparisma 1.2.2 → 1.2.6

package/tmp/generated-test2/types/LessonPurchaseTypes.ts

@@ -0,0 +1,490 @@
+// THIS FILE IS AUTO-GENERATED - DO NOT EDIT DIRECTLY
+// Edit the generator script instead
+
+import type { LessonPurchase } from '@prisma/client';
+import type { ModelResult, SuparismaOptions, SearchQuery, SearchState, FilterOperators, IncludeValue } from '../utils/core';
+import type { CourseWithRelations, CourseSelectInput } from './CourseTypes';
+import type { LessonWithRelations, LessonSelectInput } from './LessonTypes';
+
+/**
+ * Extended LessonPurchase type that includes relation fields.
+ * This represents the complete shape of LessonPurchase records returned from the database.
+ */
+export interface LessonPurchaseWithRelations {
+  id: string;
+  studentId: string;
+  lessonId: string;
+  courseId: string;
+  paidAmount: number;
+  paymentId?: string;
+  purchasedAt: Date;
+  course?: CourseWithRelations;
+  lesson?: LessonWithRelations;
+}
+
+/**
+ * Input type for creating a new LessonPurchase record.
+ * Fields with default values are optional and will be filled automatically if not provided.
+ * 
+ * @example
+ * // Create a minimal lessonpurchase
+ * lessonpurchase.create({
+ *   // Required fields only
+ *   studentId: string,
+ *   lessonId: string,
+ * });
+ * 
+ * @example
+ * // Create with optional fields
+ * lessonpurchase.create({
+ *   // All fields including optional ones
+ *   id?: string,
+ *   studentId: string,
+ *   lessonId: string,
+ * });
+ */
+export interface LessonPurchaseCreateInput {
+  id?: string;
+  studentId: string;
+  lessonId: string;
+  courseId: string;
+  paidAmount: number;
+  paymentId?: string;
+  purchasedAt?: Date;
+}
+
+/**
+ * Input type for updating an existing LessonPurchase record.
+ * All fields are optional since you only need to specify the fields you want to change.
+ * 
+ * @example
+ * // Update a lessonpurchase's fields
+ * lessonpurchase.update({
+ *   where: { id: "123" },
+ *   data: {
+ *     id?: string,
+ *     studentId: string,
+ *   }
+ * });
+ */
+export type LessonPurchaseUpdateInput = Partial<LessonPurchaseCreateInput>;
+
+/**
+ * Filter type for querying LessonPurchase records.
+ * You can filter by any field in the model using equality or advanced filter operators.
+ * Supports OR and AND logical operations for complex queries.
+ * 
+ * @example
+ * // Basic filtering
+ * lessonpurchase.findMany({
+ *   where: {
+ *     id: "value",
+ *     studentId: "value"
+ *   }
+ * });
+ * 
+ * @example
+ * // Advanced filtering
+ * lessonpurchase.findMany({
+ *   where: {
+ *     // Use advanced operators
+ *     id: { contains: "partial" }
+ *   }
+ * });
+ * 
+ * @example
+ * // OR conditions - match ANY condition
+ * lessonpurchase.findMany({
+ *   where: {
+ *     OR: [
+ *       { id: "value1" },
+ *       { studentId: { contains: "value2" } }
+ *     ]
+ *   }
+ * });
+ * 
+ * @example
+ * // AND conditions - match ALL conditions
+ * lessonpurchase.findMany({
+ *   where: {
+ *     AND: [
+ *       { id: "value1" },
+ *       { studentId: { gt: 100 } }
+ *     ]
+ *   }
+ * });
+ * 
+ * @example
+ * // Complex nested logic
+ * lessonpurchase.findMany({
+ *   where: {
+ *     active: true, // Regular condition (implicit AND)
+ *     OR: [
+ *       { role: "admin" },
+ *       { role: "moderator" }
+ *     ]
+ *   }
+ * });
+ * 
+ * @example
+ * // Array filtering (for array fields)
+ * lessonpurchase.findMany({
+ *   where: {
+ *     // Array contains specific items
+
+ *   }
+ * });
+ */
+export type LessonPurchaseWhereInput = {
+  id?: string | FilterOperators<string>;
+  studentId?: string | FilterOperators<string>;
+  lessonId?: string | FilterOperators<string>;
+  courseId?: string | FilterOperators<string>;
+  paidAmount?: number | FilterOperators<number>;
+  paymentId?: string | FilterOperators<string>;
+  purchasedAt?: Date | FilterOperators<Date>;
+} & {
+  /** Match ANY of the provided conditions */
+  OR?: LessonPurchaseWhereInput[];
+  /** Match ALL of the provided conditions */
+  AND?: LessonPurchaseWhereInput[];
+};
+
+/**
+ * Unique identifier for finding a specific LessonPurchase record.
+ * Usually uses the ID field but can be any field marked as @unique in the schema.
+ * 
+ * @example
+ * // Find by ID
+ * lessonpurchase.findUnique({ id: "123" });
+ * 
+ * @example
+ * // Delete by ID
+ * lessonpurchase.delete({ id: "123" });
+ */
+export type LessonPurchaseWhereUniqueInput = { 
+  id: string;
+};
+
+/**
+ * Sort options for LessonPurchase queries.
+ * Specify the field to sort by and the direction ('asc' or 'desc').
+ * 
+ * @example
+ * // Sort by creation date, newest first
+ * lessonpurchase.findMany({
+ *   orderBy: { created_at: 'desc' }
+ * });
+ * 
+ * @example
+ * // Sort alphabetically
+ * lessonpurchase.findMany({
+ *   orderBy: { name: 'asc' }
+ * });
+ */
+export type LessonPurchaseOrderByInput = {
+  [key in keyof LessonPurchaseSelectInput]?: 'asc' | 'desc';
+};
+
+/**
+ * Select specific scalar fields to return from LessonPurchase queries.
+ * Relation fields are intentionally excluded; use `include` for relations.
+ */
+export type LessonPurchaseSelectInput = {
+    id?: boolean;
+  studentId?: boolean;
+  lessonId?: boolean;
+  courseId?: boolean;
+  paidAmount?: boolean;
+  paymentId?: boolean;
+  purchasedAt?: boolean;
+};
+
+/**
+ * Include related records when querying LessonPurchase.
+ * Only real Prisma relation fields are allowed here.
+ */
+export type LessonPurchaseIncludeInput = {
+    course?: IncludeValue | { select?: CourseSelectInput };
+  lesson?: IncludeValue | { select?: LessonSelectInput };
+};
+
+/**
+ * Result type for operations that return a single LessonPurchase record.
+ */
+export type LessonPurchaseSingleResult = ModelResult<LessonPurchaseWithRelations>;
+
+/**
+ * Result type for operations that return multiple LessonPurchase records.
+ */
+export type LessonPurchaseManyResult = ModelResult<LessonPurchaseWithRelations[]>;
+
+/**
+ * Configuration options for the LessonPurchase hook.
+ * Includes where filters, ordering, pagination, and field selection.
+ */
+export type UseLessonPurchaseOptions = SuparismaOptions<
+  LessonPurchaseWhereInput,
+  LessonPurchaseOrderByInput,
+  LessonPurchaseSelectInput,
+  LessonPurchaseIncludeInput
+>;
+
+/**
+ * The complete API for interacting with LessonPurchase records.
+ * This interface defines all available operations and state properties.
+ */
+export interface LessonPurchaseHookApi {
+  /**
+   * Current array of LessonPurchase records.
+   * This is automatically updated when:
+   * - The initial data is loaded
+   * - Mutations are performed (create, update, delete)
+   * - Real-time updates are received from other clients
+   * - The refresh method is called
+   * 
+   * @example
+   * // Render a list of lessonpurchase records
+   * const { data } = lessonpurchase;
+   * return (
+   *   <ul>
+   *     {data.map(item => (
+   *       <li key={item.id}>{item.name}</li>
+   *     ))}
+   *   </ul>
+   * );
+   */
+  data: LessonPurchaseWithRelations[];
+  
+  /**
+   * Error object if the last operation failed, null otherwise.
+   * 
+   * @example
+   * // Handle potential errors
+   * const { error } = lessonpurchase;
+   * if (error) {
+   *   return <div>Error: {error.message}</div>;
+   * }
+   */
+  error: Error | null;
+  
+  /**
+   * Boolean indicating if an operation is in progress.
+   * 
+   * @example
+   * // Show loading state
+   * const { loading } = lessonpurchase;
+   * if (loading) {
+   *   return <div>Loading...</div>;
+   * }
+   */
+  loading: boolean;
+  
+  /**
+   * The current count of records matching the filter criteria.
+   * This automatically updates with the data, including realtime updates.
+   * It always reflects the current length of the data array, respecting any filters.
+   * 
+   * @example
+   * // Display the count in the UI
+   * const { count } = lessonpurchase;
+   * return <div>Total records: {count}</div>;
+   */
+  count: number;
+  
+  
+  
+  /**
+   * Find a single LessonPurchase record by its unique identifier.
+   * 
+   * @param where - The unique identifier to find the record by
+   * @returns A promise with the found record or error
+   * 
+   * @example
+   * // Find lessonpurchase by ID
+   * const result = await lessonpurchase.findUnique({ id: "123" });
+   * if (result.data) {
+   *   console.log("Found lessonpurchase:", result.data);
+   * }
+   */
+  findUnique: (where: LessonPurchaseWhereUniqueInput) => LessonPurchaseSingleResult;
+  
+  /**
+   * Find multiple LessonPurchase records matching the filter criteria.
+   * Supports filtering, sorting, and pagination.
+   * 
+   * @param params - Optional query parameters
+   * @returns A promise with the matching records or error
+   * 
+   * @example
+   * // Get all lessonpurchase records
+   * const result = await lessonpurchase.findMany();
+   * 
+   * @example
+   * // Filter and sort records
+   * const result = await lessonpurchase.findMany({
+   *   where: { active: true },
+   *   orderBy: { created_at: 'desc' },
+   *   take: 10,
+   *   skip: 0
+   * });
+   */
+  findMany: (params?: {
+    where?: LessonPurchaseWhereInput;
+    orderBy?: LessonPurchaseOrderByInput;
+    take?: number;
+    skip?: number;
+  }) => LessonPurchaseManyResult;
+  
+  /**
+   * Find the first LessonPurchase record matching the filter criteria.
+   * 
+   * @param params - Optional query parameters
+   * @returns A promise with the first matching record or error
+   * 
+   * @example
+   * // Find the first active lessonpurchase
+   * const result = await lessonpurchase.findFirst({
+   *   where: { active: true }
+   * });
+   * 
+   * @example
+   * // Find the oldest lessonpurchase
+   * const result = await lessonpurchase.findFirst({
+   *   orderBy: { created_at: 'asc' }
+   * });
+   */
+  findFirst: (params?: {
+    where?: LessonPurchaseWhereInput;
+    orderBy?: LessonPurchaseOrderByInput;
+  }) => LessonPurchaseSingleResult;
+  
+  /**
+   * Create a new LessonPurchase record.
+   * Fields with default values are optional and will use their defaults if not provided.
+   * 
+   * @param data - The data for the new record
+   * @returns A promise with the created record or error
+   * 
+   * @example
+   * // Create a new lessonpurchase
+   * const result = await lessonpurchase.create({
+   *   studentId: "value",
+   *   lessonId: "value"
+   * });
+   * 
+   * @example
+   * // Create with custom ID (overriding default)
+   * const result = await lessonpurchase.create({
+   *   id: "custom-id",
+   *   studentId: "value"
+   * });
+   */
+  create: (data: LessonPurchaseCreateInput) => LessonPurchaseSingleResult;
+  
+  /**
+   * Update an existing LessonPurchase record.
+   * 
+   * @param params - Object with the record identifier and fields to update
+   * @returns A promise with the updated record or error
+   * 
+   * @example
+   * // Update a lessonpurchase's fields
+   * const result = await lessonpurchase.update({
+   *   where: { id: "123" },
+   *   data: {
+   *     id?: "updated value",
+   *     studentId: "updated value"
+   *   }
+   * });
+   */
+  update: (params: {
+    where: LessonPurchaseWhereUniqueInput;
+    data: LessonPurchaseUpdateInput;
+  }) => LessonPurchaseSingleResult;
+  
+  /**
+   * Delete a LessonPurchase record by its unique identifier.
+   * 
+   * @param where - The unique identifier of the record to delete
+   * @returns A promise with the deleted record or error
+   * 
+   * @example
+   * // Delete a lessonpurchase by ID
+   * const result = await lessonpurchase.delete({ id: "123" });
+   * if (result.data) {
+   *   console.log("Deleted lessonpurchase:", result.data);
+   * }
+   */
+  delete: (where: LessonPurchaseWhereUniqueInput) => LessonPurchaseSingleResult;
+  
+  /**
+   * Delete multiple LessonPurchase records matching the filter criteria.
+   * 
+   * @param params - Optional filter parameters
+   * @returns A promise with the count of deleted records or error
+   * 
+   * @example
+   * // Delete all inactive lessonpurchase records
+   * const result = await lessonpurchase.deleteMany({
+   *   where: { active: false }
+   * });
+   * console.log(`Deleted ${result.count} records`);
+   * 
+   * @example
+   * // Delete all lessonpurchase records (use with caution!)
+   * const result = await lessonpurchase.deleteMany();
+   */
+  deleteMany: (params?: {
+    where?: LessonPurchaseWhereInput;
+  }) => Promise<{ count: number; error: Error | null }>;
+  
+  /**
+   * Create a record if it doesn't exist, or update it if it does.
+   * 
+   * @param params - Object with the identifier, update data, and create data
+   * @returns A promise with the created or updated record or error
+   * 
+   * @example
+   * // Upsert a lessonpurchase by ID
+   * const result = await lessonpurchase.upsert({
+   *   where: { id: "123" },
+   *   update: { name: "Updated Name" },
+   *   create: {
+   *     id: "123",
+   *     name: "New Name",
+   *     studentId: "value"
+   *   }
+   * });
+   */
+  upsert: (params: {
+    where: LessonPurchaseWhereUniqueInput;
+    update: LessonPurchaseUpdateInput;
+    create: LessonPurchaseCreateInput;
+  }) => LessonPurchaseSingleResult;
+  
+  /**
+   * Manually refresh the data with current filter settings.
+   * Useful after external operations or when realtime is disabled.
+   * 
+   * @param params - Optional override parameters for this specific refresh
+   * @returns A promise with the refreshed data or error
+   * 
+   * @example
+   * // Refresh with current filter settings
+   * await lessonpurchase.refresh();
+   * 
+   * @example
+   * // Refresh with different filters for this call only
+   * await lessonpurchase.refresh({
+   *   where: { active: true },
+   *   orderBy: { name: 'asc' }
+   * });
+   */
+  refresh: (params?: {
+    where?: LessonPurchaseWhereInput;
+    orderBy?: LessonPurchaseOrderByInput;
+    take?: number;
+    skip?: number;
+  }) => LessonPurchaseManyResult;
+}