@promakeai/orm 1.0.5 → 1.3.0

package/src/schema/fieldBuilder.ts

@@ -1,293 +0,0 @@
-/**
- * Field Builder DSL
- *
- * Type-safe fluent API for field definitions.
- *
- * @example
- * ```typescript
- * import { f } from '@promakeai/orm';
- *
- * const schema = defineSchema({
- *   tables: {
- *     products: {
- *       id: f.id(),
- *       price: f.decimal().required().min(0),
- *       name: f.string().translatable().required().trim(),
- *       email: f.string().lowercase().trim().unique(),
- *       categoryId: f.int().ref('categories'),
- *       brandId: f.int().ref({ table: 'brands', onDelete: 'SET_NULL' }),
- *     },
- *   },
- * });
- * ```
- */
-
-import type { FieldDefinition, FieldType, FieldReference } from "../types";
-
-/**
- * Fluent builder for field definitions
- */
-export class FieldBuilder {
-  protected definition: FieldDefinition;
-
-  constructor(type: FieldType) {
-    this.definition = {
-      type,
-      nullable: true, // Default nullable
-      unique: false,
-      primary: false,
-      translatable: false,
-    };
-  }
-
-  /**
-   * Mark field as NOT NULL
-   */
-  required(): this {
-    this.definition.nullable = false;
-    return this;
-  }
-
-  /**
-   * Mark field as nullable (default)
-   */
-  nullable(): this {
-    this.definition.nullable = true;
-    return this;
-  }
-
-  /**
-   * Mark field as UNIQUE
-   */
-  unique(): this {
-    this.definition.unique = true;
-    return this;
-  }
-
-  /**
-   * Set default value
-   */
-  default(value: unknown): this {
-    this.definition.default = value;
-    return this;
-  }
-
-  /**
-   * Mark field as translatable (stored in translation table)
-   * Only valid for string/text fields
-   */
-  translatable(): this {
-    this.definition.translatable = true;
-    return this;
-  }
-
-  /**
-   * Add reference to another table (MongoDB-style)
-   * @param tableOrOptions - Table name or options object
-   */
-  ref(
-    tableOrOptions:
-      | string
-      | {
-          table: string;
-          field?: string;
-          onDelete?: "CASCADE" | "SET_NULL" | "RESTRICT" | "NO_ACTION";
-          onUpdate?: "CASCADE" | "SET_NULL" | "RESTRICT" | "NO_ACTION";
-        }
-  ): this {
-    this.definition.ref = tableOrOptions;
-    return this;
-  }
-
-  /**
-   * Trim whitespace from string values
-   */
-  trim(): this {
-    this.definition.trim = true;
-    return this;
-  }
-
-  /**
-   * Convert string to lowercase
-   */
-  lowercase(): this {
-    this.definition.lowercase = true;
-    return this;
-  }
-
-  /**
-   * Convert string to uppercase
-   */
-  uppercase(): this {
-    this.definition.uppercase = true;
-    return this;
-  }
-
-  /**
-   * Minimum string length
-   */
-  minLength(value: number): this {
-    this.definition.minLength = value;
-    return this;
-  }
-
-  /**
-   * Maximum string length
-   */
-  maxLength(value: number): this {
-    this.definition.maxLength = value;
-    return this;
-  }
-
-  /**
-   * Minimum numeric value
-   */
-  min(value: number): this {
-    this.definition.min = value;
-    return this;
-  }
-
-  /**
-   * Maximum numeric value
-   */
-  max(value: number): this {
-    this.definition.max = value;
-    return this;
-  }
-
-  /**
-   * Enum values (allowed values)
-   */
-  enum(values: string[]): this {
-    this.definition.enum = values;
-    return this;
-  }
-
-  /**
-   * RegExp pattern to match
-   */
-  match(pattern: string): this {
-    this.definition.match = pattern;
-    return this;
-  }
-
-  /**
-   * Build the final field definition
-   * @internal
-   */
-  build(): FieldDefinition {
-    return { ...this.definition };
-  }
-}
-
-/**
- * Factory object for creating field builders
- *
- * @example
- * ```typescript
- * f.id()                              // Primary key
- * f.string().required().trim()        // NOT NULL trimmed string
- * f.int().default(0).min(0)           // Non-negative integer
- * f.string().unique().lowercase()     // Unique lowercase string
- * f.string().translatable().required() // Translatable NOT NULL
- * f.int().ref('users')                // Foreign key to users
- * f.int().ref({ table: 'users', onDelete: 'CASCADE' }) // With constraint
- * f.json().ref('categories')          // Array of category IDs
- * ```
- */
-export const f = {
-  /**
-   * Primary key field (INTEGER PRIMARY KEY AUTOINCREMENT)
-   */
-  id: (): FieldBuilder => {
-    const builder = new FieldBuilder("id");
-    builder["definition"].primary = true;
-    builder["definition"].nullable = false;
-    return builder;
-  },
-
-  /**
-   * String field (VARCHAR/TEXT)
-   */
-  string: (): FieldBuilder => new FieldBuilder("string"),
-
-  /**
-   * Text field (TEXT/LONGTEXT)
-   */
-  text: (): FieldBuilder => new FieldBuilder("text"),
-
-  /**
-   * Integer field (INTEGER)
-   */
-  int: (): FieldBuilder => new FieldBuilder("int"),
-
-  /**
-   * Decimal field (REAL/DECIMAL)
-   */
-  decimal: (): FieldBuilder => new FieldBuilder("decimal"),
-
-  /**
-   * Boolean field (INTEGER 0/1 in SQLite)
-   */
-  bool: (): FieldBuilder => new FieldBuilder("bool"),
-
-  /**
-   * Timestamp field (TEXT in ISO format)
-   */
-  timestamp: (): FieldBuilder => new FieldBuilder("timestamp"),
-
-  /**
-   * JSON field (TEXT with JSON serialization) — untyped, generates Record<string, unknown>
-   */
-  json: (): FieldBuilder => new FieldBuilder("json"),
-
-  /**
-   * String array field — stored as JSON TEXT, generates string[]
-   */
-  stringArray: (): FieldBuilder => new FieldBuilder("string[]"),
-
-  /**
-   * Number array field — stored as JSON TEXT, generates number[]
-   */
-  numberArray: (): FieldBuilder => new FieldBuilder("number[]"),
-
-  /**
-   * Boolean array field — stored as JSON TEXT, generates boolean[]
-   */
-  boolArray: (): FieldBuilder => new FieldBuilder("boolean[]"),
-
-  /**
-   * Typed object field — stored as JSON TEXT, generates typed interface
-   * @param properties - Property definitions. Keys ending with "?" are optional.
-   *   Values: "string" | "number" | "boolean"
-   *
-   * @example
-   * ```typescript
-   * f.object({ key: "string", value: "number" })
-   * // Generates: { key: string; value: number }
-   * ```
-   */
-  object: (properties: Record<string, string>): FieldBuilder => {
-    const builder = new FieldBuilder("object");
-    builder["definition"].properties = properties;
-    return builder;
-  },
-
-  /**
-   * Typed object array field — stored as JSON TEXT, generates Array<{...}>
-   * @param properties - Property definitions. Keys ending with "?" are optional.
-   *   Values: "string" | "number" | "boolean"
-   *
-   * @example
-   * ```typescript
-   * f.objectArray({ id: "number", slug: "string", "name?": "string" })
-   * // Generates: Array<{ id: number; slug: string; name?: string }>
-   * ```
-   */
-  objectArray: (properties: Record<string, string>): FieldBuilder => {
-    const builder = new FieldBuilder("object[]");
-    builder["definition"].properties = properties;
-    return builder;
-  },
-};
-