@proofkit/fmodata 0.1.0-beta.23 → 0.1.0-beta.24

package/dist/esm/orm/column.js.map

@@ -1 +1 @@
-{"version":3,"file":"column.js","sources":["../../../src/orm/column.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Column represents a type-safe reference to a table field.\n * Used in queries, filters, and operators to provide autocomplete and type checking.\n *\n * @template TOutput - The TypeScript type when reading from the database (output type)\n * @template TInput - The TypeScript type when writing to the database (input type, for filters)\n * @template TableName - The table name as a string literal type (for validation)\n * @template IsContainer - Whether this column represents a container field (cannot be selected)\n */\nexport class Column<\n  // biome-ignore lint/suspicious/noExplicitAny: Default type parameter for flexibility\n  TOutput = any,\n  TInput = TOutput,\n  TableName extends string = string,\n  IsContainer extends boolean = false,\n> {\n  readonly fieldName: string;\n  readonly entityId?: `FMFID:${string}`;\n  readonly tableName: TableName;\n  readonly tableEntityId?: `FMTID:${string}`;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  readonly inputValidator?: StandardSchemaV1<TInput, any>;\n\n  // Phantom types for TypeScript inference - never actually hold values\n  readonly _phantomOutput!: TOutput;\n  readonly _phantomInput!: TInput;\n  readonly _isContainer!: IsContainer;\n\n  constructor(config: {\n    fieldName: string;\n    entityId?: `FMFID:${string}`;\n    tableName: TableName;\n    tableEntityId?: `FMTID:${string}`;\n    // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n    inputValidator?: StandardSchemaV1<TInput, any>;\n  }) {\n    this.fieldName = config.fieldName;\n    this.entityId = config.entityId;\n    this.tableName = config.tableName;\n    this.tableEntityId = config.tableEntityId;\n    this.inputValidator = config.inputValidator;\n  }\n\n  /**\n   * Get the field identifier (entity ID if available, otherwise field name).\n   * Used when building OData queries.\n   */\n  getFieldIdentifier(useEntityIds?: boolean): string {\n    if (useEntityIds && this.entityId) {\n      return this.entityId;\n    }\n    return this.fieldName;\n  }\n\n  /**\n   * Get the table identifier (entity ID if available, otherwise table name).\n   * Used when building OData queries.\n   */\n  getTableIdentifier(useEntityIds?: boolean): string {\n    if (useEntityIds && this.tableEntityId) {\n      return this.tableEntityId;\n    }\n    return this.tableName;\n  }\n\n  /**\n   * Check if this column is from a specific table.\n   * Useful for validation in cross-table operations.\n   */\n  isFromTable(tableName: string): boolean {\n    return this.tableName === tableName;\n  }\n\n  /**\n   * Create a string representation for debugging.\n   */\n  toString(): string {\n    return `${this.tableName}.${this.fieldName}`;\n  }\n}\n\n/**\n * Type guard to check if a value is a Column instance.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Type guard accepting any value type, generic constraint accepting any Column configuration\nexport function isColumn(value: any): value is Column<any, any, any, any> {\n  return value instanceof Column;\n}\n\n/**\n * Create a Column with proper type inference from the inputValidator.\n * This helper ensures TypeScript can infer TInput from the validator's input type.\n * @internal\n */\nexport function createColumn<TOutput, TInput, TName extends string, IsContainer extends boolean = false>(config: {\n  fieldName: string;\n  entityId?: `FMFID:${string}`;\n  tableName: TName;\n  tableEntityId?: `FMTID:${string}`;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  inputValidator?: StandardSchemaV1<TInput, any>;\n}): Column<TOutput, TInput, TName, IsContainer> {\n  return new Column(config) as Column<TOutput, TInput, TName, IsContainer>;\n}\n"],"names":[],"mappings":";;;AAWO,MAAM,OAMX;AAAA,EAaA,YAAY,QAOT;AAnBM;AACA;AACA;AACA;AAEA;AAAA;AAGA;AAAA;AACA;AACA;AAUP,SAAK,YAAY,OAAO;AACxB,SAAK,WAAW,OAAO;AACvB,SAAK,YAAY,OAAO;AACxB,SAAK,gBAAgB,OAAO;AAC5B,SAAK,iBAAiB,OAAO;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/B,mBAAmB,cAAgC;AAC7C,QAAA,gBAAgB,KAAK,UAAU;AACjC,aAAO,KAAK;AAAA,IAAA;AAEd,WAAO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOd,mBAAmB,cAAgC;AAC7C,QAAA,gBAAgB,KAAK,eAAe;AACtC,aAAO,KAAK;AAAA,IAAA;AAEd,WAAO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOd,YAAY,WAA4B;AACtC,WAAO,KAAK,cAAc;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAM5B,WAAmB;AACjB,WAAO,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS;AAAA,EAAA;AAE9C;AAMO,SAAS,SAAS,OAAiD;AACxE,SAAO,iBAAiB;AAC1B;"}
+{"version":3,"file":"column.js","sources":["../../../src/orm/column.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Column represents a type-safe reference to a table field.\n * Used in queries, filters, and operators to provide autocomplete and type checking.\n *\n * @template TOutput - The TypeScript type when reading from the database (output type)\n * @template TInput - The TypeScript type when writing to the database (input type, for filters)\n * @template TableName - The table name as a string literal type (for validation)\n * @template IsContainer - Whether this column represents a container field (cannot be selected)\n */\nexport class Column<\n  // biome-ignore lint/suspicious/noExplicitAny: Default type parameter for flexibility\n  TOutput = any,\n  TInput = TOutput,\n  TableName extends string = string,\n  IsContainer extends boolean = false,\n> {\n  readonly fieldName: string;\n  readonly entityId?: `FMFID:${string}`;\n  readonly tableName: TableName;\n  readonly tableEntityId?: `FMTID:${string}`;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  readonly inputValidator?: StandardSchemaV1<TInput, any>;\n\n  // Phantom types for TypeScript inference - never actually hold values\n  readonly _phantomOutput!: TOutput;\n  readonly _phantomInput!: TInput;\n  readonly _isContainer!: IsContainer;\n\n  constructor(config: {\n    fieldName: string;\n    entityId?: `FMFID:${string}`;\n    tableName: TableName;\n    tableEntityId?: `FMTID:${string}`;\n    // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n    inputValidator?: StandardSchemaV1<TInput, any>;\n  }) {\n    this.fieldName = config.fieldName;\n    this.entityId = config.entityId;\n    this.tableName = config.tableName;\n    this.tableEntityId = config.tableEntityId;\n    this.inputValidator = config.inputValidator;\n  }\n\n  /**\n   * Get the field identifier (entity ID if available, otherwise field name).\n   * Used when building OData queries.\n   */\n  getFieldIdentifier(useEntityIds?: boolean): string {\n    if (useEntityIds && this.entityId) {\n      return this.entityId;\n    }\n    return this.fieldName;\n  }\n\n  /**\n   * Get the table identifier (entity ID if available, otherwise table name).\n   * Used when building OData queries.\n   */\n  getTableIdentifier(useEntityIds?: boolean): string {\n    if (useEntityIds && this.tableEntityId) {\n      return this.tableEntityId;\n    }\n    return this.tableName;\n  }\n\n  /**\n   * Check if this column is from a specific table.\n   * Useful for validation in cross-table operations.\n   */\n  isFromTable(tableName: string): boolean {\n    return this.tableName === tableName;\n  }\n\n  /**\n   * Create a string representation for debugging.\n   */\n  toString(): string {\n    return `${this.tableName}.${this.fieldName}`;\n  }\n}\n\n/**\n * Type guard to check if a value is a Column instance.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Type guard accepting any value type, generic constraint accepting any Column configuration\nexport function isColumn(value: any): value is Column<any, any, any, any> {\n  return value instanceof Column;\n}\n\n/**\n * Create a Column with proper type inference from the inputValidator.\n * This helper ensures TypeScript can infer TInput from the validator's input type.\n * @internal\n */\nexport function createColumn<TOutput, TInput, TName extends string, IsContainer extends boolean = false>(config: {\n  fieldName: string;\n  entityId?: `FMFID:${string}`;\n  tableName: TName;\n  tableEntityId?: `FMTID:${string}`;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  inputValidator?: StandardSchemaV1<TInput, any>;\n}): Column<TOutput, TInput, TName, IsContainer> {\n  return new Column(config) as Column<TOutput, TInput, TName, IsContainer>;\n}\n"],"names":[],"mappings":";;;AAWO,MAAM,OAMX;AAAA,EAaA,YAAY,QAOT;AAnBM;AACA;AACA;AACA;AAEA;AAAA;AAGA;AAAA;AACA;AACA;AAUP,SAAK,YAAY,OAAO;AACxB,SAAK,WAAW,OAAO;AACvB,SAAK,YAAY,OAAO;AACxB,SAAK,gBAAgB,OAAO;AAC5B,SAAK,iBAAiB,OAAO;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,mBAAmB,cAAgC;AACjD,QAAI,gBAAgB,KAAK,UAAU;AACjC,aAAO,KAAK;AAAA,IACd;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,mBAAmB,cAAgC;AACjD,QAAI,gBAAgB,KAAK,eAAe;AACtC,aAAO,KAAK;AAAA,IACd;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,WAA4B;AACtC,WAAO,KAAK,cAAc;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKA,WAAmB;AACjB,WAAO,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS;AAAA,EAC5C;AACF;AAMO,SAAS,SAAS,OAAiD;AACxE,SAAO,iBAAiB;AAC1B;"}

package/dist/esm/orm/field-builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-builders.js","sources":["../../../src/orm/field-builders.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Branded type for container field's database type.\n * This allows TypeScript to distinguish container fields from regular string fields\n * at the type level, enabling compile-time exclusion from select operations.\n */\nexport type ContainerDbType = string & { readonly __container: true };\n\n/**\n * FieldBuilder provides a fluent API for defining table fields with type-safe metadata.\n * Supports chaining methods to configure primary keys, nullability, read-only status, entity IDs, and validators.\n *\n * @template TOutput - The output type after applying outputValidator (what you get when reading)\n * @template TInput - The input type after applying inputValidator (what you pass when writing)\n * @template TDbType - The database type (what FileMaker stores/expects)\n * @template TReadOnly - Whether this field is read-only (for type-level exclusion from insert/update)\n */\n// biome-ignore lint/suspicious/noExplicitAny: Default type parameter for flexibility\nexport class FieldBuilder<TOutput = any, TInput = TOutput, TDbType = TOutput, TReadOnly extends boolean = false> {\n  private _primaryKey = false;\n  private _notNull = false;\n  private _readOnly = false;\n  private _entityId?: `FMFID:${string}`;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  private _outputValidator?: StandardSchemaV1<any, TOutput>;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  private _inputValidator?: StandardSchemaV1<TInput, any>;\n  private readonly _fieldType: string;\n  private _comment?: string;\n\n  constructor(fieldType: string) {\n    this._fieldType = fieldType;\n  }\n\n  /**\n   * Mark this field as the primary key for the table.\n   * Primary keys are automatically read-only and non-nullable.\n   */\n  primaryKey(): FieldBuilder<NonNullable<TOutput>, NonNullable<TInput>, NonNullable<TDbType>, true> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._primaryKey = true;\n    builder._notNull = true; // Primary keys are automatically non-nullable\n    builder._readOnly = true; // Primary keys are automatically read-only\n    return builder;\n  }\n\n  /**\n   * Mark this field as non-nullable.\n   * Updates the type to exclude null/undefined.\n   */\n  notNull(): FieldBuilder<NonNullable<TOutput>, NonNullable<TInput>, NonNullable<TDbType>, TReadOnly> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._notNull = true;\n    return builder;\n  }\n\n  /**\n   * Mark this field as read-only.\n   * Read-only fields are excluded from insert and update operations.\n   */\n  readOnly(): FieldBuilder<TOutput, TInput, TDbType, true> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._readOnly = true;\n    return builder;\n  }\n\n  /**\n   * Assign a FileMaker field ID (FMFID) to this field.\n   * When useEntityIds is enabled, this ID will be used in API requests instead of the field name.\n   */\n  entityId(id: `FMFID:${string}`): FieldBuilder<TOutput, TInput, TDbType, TReadOnly> {\n    const builder = this._clone();\n    builder._entityId = id;\n    return builder;\n  }\n\n  /**\n   * Set a validator for the output (reading from database).\n   * The output validator transforms/validates data coming FROM the database in list or get operations.\n   *\n   * @example\n   * numberField().readValidator(z.coerce.boolean())\n   * // FileMaker returns 0/1, you get true/false\n   */\n  readValidator<O, VInput = TDbType>(\n    validator: StandardSchemaV1<VInput, O>,\n  ): FieldBuilder<O, TInput, TDbType, TReadOnly> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._outputValidator = validator;\n    return builder;\n  }\n\n  /**\n   * Set a validator for the input (writing to database).\n   * The input validator transforms/validates data going TO the database in insert, update, and filter operations.\n   *\n   * @example\n   * numberField().writeValidator(z.boolean().transform(v => v ? 1 : 0))\n   * // You pass true/false, FileMaker gets 1/0\n   */\n  writeValidator<I>(validator: StandardSchemaV1<I, TDbType>): FieldBuilder<TOutput, I, TDbType, TReadOnly> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._inputValidator = validator;\n    return builder;\n  }\n\n  /**\n   * Add a comment to this field for metadata purposes.\n   * This helps future developers understand the purpose of the field.\n   *\n   * @example\n   * textField().comment(\"Account name of the user who last modified each record\")\n   */\n  comment(comment: string): FieldBuilder<TOutput, TInput, TDbType, TReadOnly> {\n    const builder = this._clone();\n    builder._comment = comment;\n    return builder;\n  }\n\n  /**\n   * Get the metadata configuration for this field.\n   * @internal Used by fmTableOccurrence to extract field configuration\n   */\n  _getConfig() {\n    return {\n      fieldType: this._fieldType,\n      primaryKey: this._primaryKey,\n      notNull: this._notNull,\n      readOnly: this._readOnly,\n      entityId: this._entityId,\n      outputValidator: this._outputValidator,\n      inputValidator: this._inputValidator,\n      comment: this._comment,\n    };\n  }\n\n  /**\n   * Clone this builder to allow immutable chaining.\n   * @private\n   */\n  private _clone(): FieldBuilder<TOutput, TInput, TDbType, TReadOnly> {\n    const builder = new FieldBuilder<TOutput, TInput, TDbType, TReadOnly>(this._fieldType);\n    builder._primaryKey = this._primaryKey;\n    builder._notNull = this._notNull;\n    builder._readOnly = this._readOnly;\n    builder._entityId = this._entityId;\n    builder._outputValidator = this._outputValidator;\n    builder._inputValidator = this._inputValidator;\n    builder._comment = this._comment;\n    return builder;\n  }\n}\n\n/**\n * Create a text field (Edm.String in FileMaker OData).\n * By default, text fields are nullable.\n *\n * @example\n * textField()                    // string | null\n * textField().notNull()          // string\n * textField().entityId(\"FMFID:1\") // with entity ID\n */\nexport function textField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"text\");\n}\n\n/**\n * Create a number field (Edm.Decimal in FileMaker OData).\n * By default, number fields are nullable.\n *\n * @example\n * numberField()                   // number | null\n * numberField().notNull()         // number\n * numberField().outputValidator(z.coerce.boolean()) // transform to boolean on read\n */\nexport function numberField(): FieldBuilder<number | null, number | null, number | null, false> {\n  return new FieldBuilder<number | null, number | null, number | null, false>(\"number\");\n}\n\n/**\n * Create a date field (Edm.Date in FileMaker OData).\n * By default, date fields are nullable and represented as ISO date strings (YYYY-MM-DD).\n *\n * @example\n * dateField()         // string | null (ISO date format)\n * dateField().notNull() // string\n */\nexport function dateField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"date\");\n}\n\n/**\n * Create a time field (Edm.TimeOfDay in FileMaker OData).\n * By default, time fields are nullable and represented as ISO time strings (HH:mm:ss).\n *\n * @example\n * timeField()         // string | null (ISO time format)\n * timeField().notNull() // string\n */\nexport function timeField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"time\");\n}\n\n/**\n * Create a timestamp field (Edm.DateTimeOffset in FileMaker OData).\n * By default, timestamp fields are nullable and represented as ISO 8601 strings.\n *\n * @example\n * timestampField()         // string | null (ISO 8601 format)\n * timestampField().notNull() // string\n * timestampField().readOnly() // typical for CreationTimestamp\n */\nexport function timestampField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"timestamp\");\n}\n\n/**\n * Create a container field (Edm.Stream in FileMaker OData).\n * Container fields store binary data and are represented as base64 strings in the API.\n * By default, container fields are nullable.\n *\n * Note: Container fields cannot be selected via .select() - they can only be accessed\n * via .getSingleField() due to FileMaker OData API limitations.\n *\n * @example\n * containerField()         // string | null (base64 encoded)\n * containerField().notNull() // string\n */\nexport function containerField(): FieldBuilder<string | null, string | null, ContainerDbType | null, false> {\n  return new FieldBuilder<string | null, string | null, ContainerDbType | null, false>(\"container\");\n}\n\n/**\n * Create a calculated field (read-only field computed by FileMaker).\n * Calculated fields are automatically marked as read-only.\n *\n * @example\n * calcField()         // string | null\n * calcField().notNull() // string\n */\nexport function calcField(): FieldBuilder<string | null, string | null, string | null, true> {\n  const builder = new FieldBuilder<string | null, string | null, string | null, false>(\"calculated\");\n  return builder.readOnly();\n}\n"],"names":[],"mappings":";;;AAmBO,MAAM,aAAoG;AAAA,EAY/G,YAAY,WAAmB;AAXvB,uCAAc;AACd,oCAAW;AACX,qCAAY;AACZ;AAEA;AAAA;AAEA;AAAA;AACS;AACT;AAGN,SAAK,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,aAAkG;AAE1F,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,cAAc;AACtB,YAAQ,WAAW;AACnB,YAAQ,YAAY;AACb,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,UAAoG;AAE5F,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,WAAW;AACZ,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAyD;AAEjD,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,YAAY;AACb,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,SAAS,IAA0E;AAC3E,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,YAAY;AACb,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWT,cACE,WAC6C;AAEvC,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,mBAAmB;AACpB,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWT,eAAkB,WAAuF;AAEjG,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,kBAAkB;AACnB,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUT,QAAQ,SAAoE;AACpE,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,WAAW;AACZ,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,aAAa;AACJ,WAAA;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,YAAY,KAAK;AAAA,MACjB,SAAS,KAAK;AAAA,MACd,UAAU,KAAK;AAAA,MACf,UAAU,KAAK;AAAA,MACf,iBAAiB,KAAK;AAAA,MACtB,gBAAgB,KAAK;AAAA,MACrB,SAAS,KAAK;AAAA,IAChB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOM,SAA4D;AAClE,UAAM,UAAU,IAAI,aAAkD,KAAK,UAAU;AACrF,YAAQ,cAAc,KAAK;AAC3B,YAAQ,WAAW,KAAK;AACxB,YAAQ,YAAY,KAAK;AACzB,YAAQ,YAAY,KAAK;AACzB,YAAQ,mBAAmB,KAAK;AAChC,YAAQ,kBAAkB,KAAK;AAC/B,YAAQ,WAAW,KAAK;AACjB,WAAA;AAAA,EAAA;AAEX;AAWO,SAAS,YAA8E;AACrF,SAAA,IAAI,aAAiE,MAAM;AACpF;AAWO,SAAS,cAAgF;AACvF,SAAA,IAAI,aAAiE,QAAQ;AACtF;AAUO,SAAS,YAA8E;AACrF,SAAA,IAAI,aAAiE,MAAM;AACpF;AAUO,SAAS,YAA8E;AACrF,SAAA,IAAI,aAAiE,MAAM;AACpF;AAWO,SAAS,iBAAmF;AAC1F,SAAA,IAAI,aAAiE,WAAW;AACzF;AAcO,SAAS,iBAA4F;AACnG,SAAA,IAAI,aAA0E,WAAW;AAClG;AAUO,SAAS,YAA6E;AACrF,QAAA,UAAU,IAAI,aAAiE,YAAY;AACjG,SAAO,QAAQ,SAAS;AAC1B;"}
+{"version":3,"file":"field-builders.js","sources":["../../../src/orm/field-builders.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Branded type for container field's database type.\n * This allows TypeScript to distinguish container fields from regular string fields\n * at the type level, enabling compile-time exclusion from select operations.\n */\nexport type ContainerDbType = string & { readonly __container: true };\n\n/**\n * FieldBuilder provides a fluent API for defining table fields with type-safe metadata.\n * Supports chaining methods to configure primary keys, nullability, read-only status, entity IDs, and validators.\n *\n * @template TOutput - The output type after applying outputValidator (what you get when reading)\n * @template TInput - The input type after applying inputValidator (what you pass when writing)\n * @template TDbType - The database type (what FileMaker stores/expects)\n * @template TReadOnly - Whether this field is read-only (for type-level exclusion from insert/update)\n */\n// biome-ignore lint/suspicious/noExplicitAny: Default type parameter for flexibility\nexport class FieldBuilder<TOutput = any, TInput = TOutput, TDbType = TOutput, TReadOnly extends boolean = false> {\n  private _primaryKey = false;\n  private _notNull = false;\n  private _readOnly = false;\n  private _entityId?: `FMFID:${string}`;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  private _outputValidator?: StandardSchemaV1<any, TOutput>;\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  private _inputValidator?: StandardSchemaV1<TInput, any>;\n  private readonly _fieldType: string;\n  private _comment?: string;\n\n  constructor(fieldType: string) {\n    this._fieldType = fieldType;\n  }\n\n  /**\n   * Mark this field as the primary key for the table.\n   * Primary keys are automatically read-only and non-nullable.\n   */\n  primaryKey(): FieldBuilder<NonNullable<TOutput>, NonNullable<TInput>, NonNullable<TDbType>, true> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._primaryKey = true;\n    builder._notNull = true; // Primary keys are automatically non-nullable\n    builder._readOnly = true; // Primary keys are automatically read-only\n    return builder;\n  }\n\n  /**\n   * Mark this field as non-nullable.\n   * Updates the type to exclude null/undefined.\n   */\n  notNull(): FieldBuilder<NonNullable<TOutput>, NonNullable<TInput>, NonNullable<TDbType>, TReadOnly> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._notNull = true;\n    return builder;\n  }\n\n  /**\n   * Mark this field as read-only.\n   * Read-only fields are excluded from insert and update operations.\n   */\n  readOnly(): FieldBuilder<TOutput, TInput, TDbType, true> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._readOnly = true;\n    return builder;\n  }\n\n  /**\n   * Assign a FileMaker field ID (FMFID) to this field.\n   * When useEntityIds is enabled, this ID will be used in API requests instead of the field name.\n   */\n  entityId(id: `FMFID:${string}`): FieldBuilder<TOutput, TInput, TDbType, TReadOnly> {\n    const builder = this._clone();\n    builder._entityId = id;\n    return builder;\n  }\n\n  /**\n   * Set a validator for the output (reading from database).\n   * The output validator transforms/validates data coming FROM the database in list or get operations.\n   *\n   * @example\n   * numberField().readValidator(z.coerce.boolean())\n   * // FileMaker returns 0/1, you get true/false\n   */\n  readValidator<O, VInput = TDbType>(\n    validator: StandardSchemaV1<VInput, O>,\n  ): FieldBuilder<O, TInput, TDbType, TReadOnly> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._outputValidator = validator;\n    return builder;\n  }\n\n  /**\n   * Set a validator for the input (writing to database).\n   * The input validator transforms/validates data going TO the database in insert, update, and filter operations.\n   *\n   * @example\n   * numberField().writeValidator(z.boolean().transform(v => v ? 1 : 0))\n   * // You pass true/false, FileMaker gets 1/0\n   */\n  writeValidator<I>(validator: StandardSchemaV1<I, TDbType>): FieldBuilder<TOutput, I, TDbType, TReadOnly> {\n    // biome-ignore lint/suspicious/noExplicitAny: Type assertion for internal class mutation\n    const builder = this._clone() as any;\n    builder._inputValidator = validator;\n    return builder;\n  }\n\n  /**\n   * Add a comment to this field for metadata purposes.\n   * This helps future developers understand the purpose of the field.\n   *\n   * @example\n   * textField().comment(\"Account name of the user who last modified each record\")\n   */\n  comment(comment: string): FieldBuilder<TOutput, TInput, TDbType, TReadOnly> {\n    const builder = this._clone();\n    builder._comment = comment;\n    return builder;\n  }\n\n  /**\n   * Get the metadata configuration for this field.\n   * @internal Used by fmTableOccurrence to extract field configuration\n   */\n  _getConfig() {\n    return {\n      fieldType: this._fieldType,\n      primaryKey: this._primaryKey,\n      notNull: this._notNull,\n      readOnly: this._readOnly,\n      entityId: this._entityId,\n      outputValidator: this._outputValidator,\n      inputValidator: this._inputValidator,\n      comment: this._comment,\n    };\n  }\n\n  /**\n   * Clone this builder to allow immutable chaining.\n   * @private\n   */\n  private _clone(): FieldBuilder<TOutput, TInput, TDbType, TReadOnly> {\n    const builder = new FieldBuilder<TOutput, TInput, TDbType, TReadOnly>(this._fieldType);\n    builder._primaryKey = this._primaryKey;\n    builder._notNull = this._notNull;\n    builder._readOnly = this._readOnly;\n    builder._entityId = this._entityId;\n    builder._outputValidator = this._outputValidator;\n    builder._inputValidator = this._inputValidator;\n    builder._comment = this._comment;\n    return builder;\n  }\n}\n\n/**\n * Create a text field (Edm.String in FileMaker OData).\n * By default, text fields are nullable.\n *\n * @example\n * textField()                    // string | null\n * textField().notNull()          // string\n * textField().entityId(\"FMFID:1\") // with entity ID\n */\nexport function textField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"text\");\n}\n\n/**\n * Create a number field (Edm.Decimal in FileMaker OData).\n * By default, number fields are nullable.\n *\n * @example\n * numberField()                   // number | null\n * numberField().notNull()         // number\n * numberField().outputValidator(z.coerce.boolean()) // transform to boolean on read\n */\nexport function numberField(): FieldBuilder<number | null, number | null, number | null, false> {\n  return new FieldBuilder<number | null, number | null, number | null, false>(\"number\");\n}\n\n/**\n * Create a date field (Edm.Date in FileMaker OData).\n * By default, date fields are nullable and represented as ISO date strings (YYYY-MM-DD).\n *\n * @example\n * dateField()         // string | null (ISO date format)\n * dateField().notNull() // string\n */\nexport function dateField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"date\");\n}\n\n/**\n * Create a time field (Edm.TimeOfDay in FileMaker OData).\n * By default, time fields are nullable and represented as ISO time strings (HH:mm:ss).\n *\n * @example\n * timeField()         // string | null (ISO time format)\n * timeField().notNull() // string\n */\nexport function timeField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"time\");\n}\n\n/**\n * Create a timestamp field (Edm.DateTimeOffset in FileMaker OData).\n * By default, timestamp fields are nullable and represented as ISO 8601 strings.\n *\n * @example\n * timestampField()         // string | null (ISO 8601 format)\n * timestampField().notNull() // string\n * timestampField().readOnly() // typical for CreationTimestamp\n */\nexport function timestampField(): FieldBuilder<string | null, string | null, string | null, false> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\"timestamp\");\n}\n\n/**\n * Create a container field (Edm.Stream in FileMaker OData).\n * Container fields store binary data and are represented as base64 strings in the API.\n * By default, container fields are nullable.\n *\n * Note: Container fields cannot be selected via .select() - they can only be accessed\n * via .getSingleField() due to FileMaker OData API limitations.\n *\n * @example\n * containerField()         // string | null (base64 encoded)\n * containerField().notNull() // string\n */\nexport function containerField(): FieldBuilder<string | null, string | null, ContainerDbType | null, false> {\n  return new FieldBuilder<string | null, string | null, ContainerDbType | null, false>(\"container\");\n}\n\n/**\n * Create a calculated field (read-only field computed by FileMaker).\n * Calculated fields are automatically marked as read-only.\n *\n * @example\n * calcField()         // string | null\n * calcField().notNull() // string\n */\nexport function calcField(): FieldBuilder<string | null, string | null, string | null, true> {\n  const builder = new FieldBuilder<string | null, string | null, string | null, false>(\"calculated\");\n  return builder.readOnly();\n}\n"],"names":[],"mappings":";;;AAmBO,MAAM,aAAoG;AAAA,EAY/G,YAAY,WAAmB;AAXvB,uCAAc;AACd,oCAAW;AACX,qCAAY;AACZ;AAEA;AAAA;AAEA;AAAA;AACS;AACT;AAGN,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAkG;AAEhG,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,cAAc;AACtB,YAAQ,WAAW;AACnB,YAAQ,YAAY;AACpB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAoG;AAElG,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,WAAW;AACnB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,WAAyD;AAEvD,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,YAAY;AACpB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,IAA0E;AACjF,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,YAAY;AACpB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,cACE,WAC6C;AAE7C,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,mBAAmB;AAC3B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,eAAkB,WAAuF;AAEvG,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,kBAAkB;AAC1B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,QAAQ,SAAoE;AAC1E,UAAM,UAAU,KAAK,OAAA;AACrB,YAAQ,WAAW;AACnB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa;AACX,WAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,YAAY,KAAK;AAAA,MACjB,SAAS,KAAK;AAAA,MACd,UAAU,KAAK;AAAA,MACf,UAAU,KAAK;AAAA,MACf,iBAAiB,KAAK;AAAA,MACtB,gBAAgB,KAAK;AAAA,MACrB,SAAS,KAAK;AAAA,IAAA;AAAA,EAElB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,SAA4D;AAClE,UAAM,UAAU,IAAI,aAAkD,KAAK,UAAU;AACrF,YAAQ,cAAc,KAAK;AAC3B,YAAQ,WAAW,KAAK;AACxB,YAAQ,YAAY,KAAK;AACzB,YAAQ,YAAY,KAAK;AACzB,YAAQ,mBAAmB,KAAK;AAChC,YAAQ,kBAAkB,KAAK;AAC/B,YAAQ,WAAW,KAAK;AACxB,WAAO;AAAA,EACT;AACF;AAWO,SAAS,YAA8E;AAC5F,SAAO,IAAI,aAAiE,MAAM;AACpF;AAWO,SAAS,cAAgF;AAC9F,SAAO,IAAI,aAAiE,QAAQ;AACtF;AAUO,SAAS,YAA8E;AAC5F,SAAO,IAAI,aAAiE,MAAM;AACpF;AAUO,SAAS,YAA8E;AAC5F,SAAO,IAAI,aAAiE,MAAM;AACpF;AAWO,SAAS,iBAAmF;AACjG,SAAO,IAAI,aAAiE,WAAW;AACzF;AAcO,SAAS,iBAA4F;AAC1G,SAAO,IAAI,aAA0E,WAAW;AAClG;AAUO,SAAS,YAA6E;AAC3F,QAAM,UAAU,IAAI,aAAiE,YAAY;AACjG,SAAO,QAAQ,SAAA;AACjB;"}

package/dist/esm/orm/operators.js.map

@@ -1 +1 @@
-{"version":3,"file":"operators.js","sources":["../../../src/orm/operators.ts"],"sourcesContent":["import { needsFieldQuoting } from \"../client/builders/select-utils\";\nimport type { Column } from \"./column\";\nimport { isColumn } from \"./column\";\n\n/**\n * FilterExpression represents a filter condition that can be used in where() clauses.\n * Internal representation of operator expressions that get converted to OData filter syntax.\n */\nexport class FilterExpression {\n  readonly operator: string;\n  // biome-ignore lint/suspicious/noExplicitAny: Operands can be Column, FilterExpression, or any value type\n  readonly operands: (Column | any | FilterExpression)[];\n\n  // biome-ignore lint/suspicious/noExplicitAny: Operands can be Column, FilterExpression, or any value type\n  constructor(operator: string, operands: (Column | any | FilterExpression)[]) {\n    this.operator = operator;\n    this.operands = operands;\n  }\n\n  /**\n   * Convert this expression to OData filter syntax.\n   * @internal Used by QueryBuilder\n   */\n  toODataFilter(useEntityIds?: boolean): string {\n    switch (this.operator) {\n      // Comparison operators\n      case \"eq\":\n        return this._binaryOp(\"eq\", useEntityIds);\n      case \"ne\":\n        return this._binaryOp(\"ne\", useEntityIds);\n      case \"gt\":\n        return this._binaryOp(\"gt\", useEntityIds);\n      case \"gte\":\n        return this._binaryOp(\"ge\", useEntityIds);\n      case \"lt\":\n        return this._binaryOp(\"lt\", useEntityIds);\n      case \"lte\":\n        return this._binaryOp(\"le\", useEntityIds);\n      case \"in\":\n        return this._inOp(useEntityIds);\n      case \"notIn\":\n        return this._notInOp(useEntityIds);\n\n      // String operators\n      case \"contains\":\n        return this._functionOp(\"contains\", useEntityIds);\n      case \"startsWith\":\n        return this._functionOp(\"startswith\", useEntityIds);\n      case \"endsWith\":\n        return this._functionOp(\"endswith\", useEntityIds);\n\n      // Null checks\n      case \"isNull\":\n        return this._isNullOp(useEntityIds);\n      case \"isNotNull\":\n        return this._isNotNullOp(useEntityIds);\n\n      // Logical operators\n      case \"and\":\n        return this._logicalOp(\"and\", useEntityIds);\n      case \"or\":\n        return this._logicalOp(\"or\", useEntityIds);\n      case \"not\":\n        return this._notOp(useEntityIds);\n\n      default:\n        throw new Error(`Unknown operator: ${this.operator}`);\n    }\n  }\n\n  private _binaryOp(op: string, useEntityIds?: boolean): string {\n    const [left, right] = this.operands;\n    // For binary ops, the column is typically the first operand and value is the second\n    // But we also support column-to-column comparisons, so check both\n    let columnForValue: typeof left | typeof right | undefined;\n    if (isColumn(left) && !isColumn(right)) {\n      columnForValue = left;\n    } else if (isColumn(right) && !isColumn(left)) {\n      columnForValue = right;\n    } else {\n      columnForValue = undefined;\n    }\n    const leftStr = this._operandToString(left, useEntityIds, columnForValue);\n    const rightStr = this._operandToString(right, useEntityIds, columnForValue);\n    return `${leftStr} ${op} ${rightStr}`;\n  }\n\n  private _functionOp(fnName: string, useEntityIds?: boolean): string {\n    const [column, value] = this.operands;\n    const columnInstance = isColumn(column) ? column : undefined;\n    const columnStr = this._operandToString(column, useEntityIds);\n    const valueStr = this._operandToString(value, useEntityIds, columnInstance);\n    return `${fnName}(${columnStr}, ${valueStr})`;\n  }\n\n  private _inOp(useEntityIds?: boolean): string {\n    const [column, values] = this.operands;\n    const columnInstance = isColumn(column) ? column : undefined;\n    const columnStr = this._operandToString(column, useEntityIds);\n    // biome-ignore lint/suspicious/noExplicitAny: Dynamic array of values from user input\n    const valuesStr = (values as any[]).map((v) => this._operandToString(v, useEntityIds, columnInstance)).join(\", \");\n    return `${columnStr} in (${valuesStr})`;\n  }\n\n  private _notInOp(useEntityIds?: boolean): string {\n    const [column, values] = this.operands;\n    const columnInstance = isColumn(column) ? column : undefined;\n    const columnStr = this._operandToString(column, useEntityIds);\n    // biome-ignore lint/suspicious/noExplicitAny: Dynamic array of values from user input\n    const valuesStr = (values as any[]).map((v) => this._operandToString(v, useEntityIds, columnInstance)).join(\", \");\n    return `not (${columnStr} in (${valuesStr}))`;\n  }\n\n  private _isNullOp(useEntityIds?: boolean): string {\n    const [column] = this.operands;\n    const columnStr = this._operandToString(column, useEntityIds);\n    return `${columnStr} eq null`;\n  }\n\n  private _isNotNullOp(useEntityIds?: boolean): string {\n    const [column] = this.operands;\n    const columnStr = this._operandToString(column, useEntityIds);\n    return `${columnStr} ne null`;\n  }\n\n  private _logicalOp(op: string, useEntityIds?: boolean): string {\n    const expressions = this.operands.map((expr) => {\n      if (expr instanceof FilterExpression) {\n        const innerExpr = expr.toODataFilter(useEntityIds);\n        // Wrap in parens if it's a logical expression to ensure precedence\n        if (expr.operator === \"and\" || expr.operator === \"or\") {\n          return `(${innerExpr})`;\n        }\n        return innerExpr;\n      }\n      throw new Error(\"Logical operators require FilterExpression operands\");\n    });\n    return expressions.join(` ${op} `);\n  }\n\n  private _notOp(useEntityIds?: boolean): string {\n    const [expr] = this.operands;\n    if (expr instanceof FilterExpression) {\n      return `not (${expr.toODataFilter(useEntityIds)})`;\n    }\n    throw new Error(\"NOT operator requires a FilterExpression operand\");\n  }\n\n  private _operandToString(\n    // biome-ignore lint/suspicious/noExplicitAny: Operand can be Column, FilterExpression, or any value type\n    operand: any,\n    useEntityIds?: boolean, // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n    column?: Column<any, any, any, any>,\n  ): string {\n    if (isColumn(operand)) {\n      const fieldIdentifier = operand.getFieldIdentifier(useEntityIds);\n      // Quote field names in OData filters per FileMaker OData API requirements\n      return needsFieldQuoting(fieldIdentifier) ? `\"${fieldIdentifier}\"` : fieldIdentifier;\n    }\n\n    // If we have a column with an input validator, apply it to transform the value\n    let value = operand;\n    if (column?.inputValidator) {\n      try {\n        const result = column.inputValidator[\"~standard\"].validate(value);\n        // Handle async validators (though they shouldn't be async for filters)\n        if (result instanceof Promise) {\n          // For filters, we can't use async validators, so skip transformation\n          // This is a limitation - async validators won't work in filters\n          value = operand;\n        } else if (\"issues\" in result && result.issues) {\n          // Validation failed, use original value\n          value = operand;\n        } else if (\"value\" in result) {\n          // Validation succeeded, use transformed value\n          value = result.value;\n        }\n      } catch (_error) {\n        // If validation throws, use the original value (will likely cause a query error)\n        // This maintains backward compatibility and allows the server to handle validation\n        value = operand;\n      }\n    }\n\n    if (typeof value === \"string\") {\n      return `'${value.replace(/'/g, \"''\")}'`; // Escape single quotes\n    }\n    if (value === null || value === undefined) {\n      return \"null\";\n    }\n    if (value instanceof Date) {\n      return value.toISOString();\n    }\n    return String(value);\n  }\n}\n\n// ============================================================================\n// Comparison Operators\n// ============================================================================\n\n/**\n * Equal operator - checks if column equals a value or another column.\n *\n * @example\n * eq(users.name, \"John\")           // name equals \"John\"\n * eq(users.id, contacts.id_user)   // cross-table comparison\n */\nexport function eq<TOutput, TInput>(\n  column1: Column<TOutput, TInput>,\n  column2: Column<TOutput, TInput> | NoInfer<TInput>,\n): FilterExpression;\n// biome-ignore lint/suspicious/noExplicitAny: Implementation signature for overloads\nexport function eq(column: Column, value: any): FilterExpression {\n  return new FilterExpression(\"eq\", [column, value]);\n}\n\n/**\n * Not equal operator - checks if column does not equal a value or another column.\n *\n * @example\n * ne(users.status, \"inactive\")     // status not equal to \"inactive\"\n * ne(users.id, contacts.id_user)   // cross-table comparison\n */\nexport function ne<TOutput, TInput>(\n  column1: Column<TOutput, TInput>,\n  column2: Column<TOutput, TInput> | NoInfer<TInput>,\n): FilterExpression;\n// biome-ignore lint/suspicious/noExplicitAny: Implementation signature for overloads\nexport function ne(column: Column, value: any): FilterExpression {\n  return new FilterExpression(\"ne\", [column, value]);\n}\n\n/**\n * Greater than operator - checks if column is greater than a value.\n *\n * @example\n * gt(users.age, 18)               // age greater than 18\n */\nexport function gt<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"gt\", [column, value]);\n}\n\n/**\n * Greater than or equal operator - checks if column is >= a value.\n *\n * @example\n * gte(users.age, 18)              // age >= 18\n */\nexport function gte<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"gte\", [column, value]);\n}\n\n/**\n * Less than operator - checks if column is less than a value.\n *\n * @example\n * lt(users.age, 65)               // age less than 65\n */\nexport function lt<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"lt\", [column, value]);\n}\n\n/**\n * Less than or equal operator - checks if column is <= a value.\n *\n * @example\n * lte(users.age, 65)              // age <= 65\n */\nexport function lte<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"lte\", [column, value]);\n}\n\n// ============================================================================\n// String Operators\n// ============================================================================\n\n/**\n * Contains operator - checks if a string column contains a substring.\n *\n * @example\n * contains(users.name, \"John\")    // name contains \"John\"\n */\nexport function contains<TOutput, TInput>(column: Column<TOutput, TInput>, value: NoInfer<TInput>): FilterExpression {\n  return new FilterExpression(\"contains\", [column, value]);\n}\n\n/**\n * Starts with operator - checks if a string column starts with a prefix.\n *\n * @example\n * startsWith(users.email, \"admin\") // email starts with \"admin\"\n */\nexport function startsWith<TOutput, TInput>(column: Column<TOutput, TInput>, value: NoInfer<TInput>): FilterExpression {\n  return new FilterExpression(\"startsWith\", [column, value]);\n}\n\n/**\n * Ends with operator - checks if a string column ends with a suffix.\n *\n * @example\n * endsWith(users.email, \"@example.com\") // email ends with \"@example.com\"\n */\nexport function endsWith<TOutput, TInput>(column: Column<TOutput, TInput>, value: NoInfer<TInput>): FilterExpression {\n  return new FilterExpression(\"endsWith\", [column, value]);\n}\n\n// ============================================================================\n// Array Operators\n// ============================================================================\n\n/**\n * In array operator - checks if column value is in an array of values.\n *\n * @example\n * inArray(users.status, [\"active\", \"pending\"]) // status is \"active\" or \"pending\"\n */\nexport function inArray<TOutput, TInput>(column: Column<TOutput, TInput>, values: NoInfer<TInput>[]): FilterExpression {\n  return new FilterExpression(\"in\", [column, values]);\n}\n\n/**\n * Not in array operator - checks if column value is not in an array of values.\n *\n * @example\n * notInArray(users.status, [\"deleted\", \"banned\"]) // status is neither \"deleted\" nor \"banned\"\n */\nexport function notInArray<TOutput, TInput>(\n  column: Column<TOutput, TInput>,\n  values: NoInfer<TInput>[],\n): FilterExpression {\n  return new FilterExpression(\"notIn\", [column, values]);\n}\n\n// ============================================================================\n// Null Check Operators\n// ============================================================================\n\n/**\n * Is null operator - checks if column value is null.\n *\n * @example\n * isNull(users.deletedAt)         // deletedAt is null\n */\nexport function isNull<TOutput, TInput>(column: Column<TOutput, TInput>): FilterExpression {\n  return new FilterExpression(\"isNull\", [column]);\n}\n\n/**\n * Is not null operator - checks if column value is not null.\n *\n * @example\n * isNotNull(users.email)          // email is not null\n */\nexport function isNotNull<TOutput, TInput>(column: Column<TOutput, TInput>): FilterExpression {\n  return new FilterExpression(\"isNotNull\", [column]);\n}\n\n// ============================================================================\n// Logical Operators\n// ============================================================================\n\n/**\n * AND operator - combines multiple filter expressions with logical AND.\n * All expressions must be true for the record to match.\n *\n * @example\n * and(\n *   eq(users.active, true),\n *   gt(users.age, 18)\n * ) // active is true AND age > 18\n */\nexport function and(...expressions: FilterExpression[]): FilterExpression {\n  if (expressions.length === 0) {\n    throw new Error(\"AND operator requires at least one expression\");\n  }\n  if (expressions.length === 1 && expressions[0] !== undefined) {\n    return expressions[0];\n  }\n  return new FilterExpression(\"and\", expressions);\n}\n\n/**\n * OR operator - combines multiple filter expressions with logical OR.\n * At least one expression must be true for the record to match.\n *\n * @example\n * or(\n *   eq(users.role, \"admin\"),\n *   eq(users.role, \"moderator\")\n * ) // role is \"admin\" OR \"moderator\"\n */\nexport function or(...expressions: FilterExpression[]): FilterExpression {\n  if (expressions.length === 0) {\n    throw new Error(\"OR operator requires at least one expression\");\n  }\n  if (expressions.length === 1 && expressions[0] !== undefined) {\n    return expressions[0];\n  }\n  return new FilterExpression(\"or\", expressions);\n}\n\n/**\n * NOT operator - negates a filter expression.\n *\n * @example\n * not(eq(users.status, \"deleted\")) // status is NOT \"deleted\"\n */\nexport function not(expression: FilterExpression): FilterExpression {\n  return new FilterExpression(\"not\", [expression]);\n}\n\n// ============================================================================\n// OrderBy Operators\n// ============================================================================\n\n/**\n * OrderByExpression represents a sort order specification for a column.\n * Used in orderBy() clauses to provide type-safe sorting with direction.\n */\nexport class OrderByExpression<TableName extends string = string> {\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  readonly column: Column<any, any, TableName>;\n  readonly direction: \"asc\" | \"desc\";\n\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  constructor(column: Column<any, any, TableName>, direction: \"asc\" | \"desc\") {\n    this.column = column;\n    this.direction = direction;\n  }\n}\n\n/**\n * Type guard to check if a value is an OrderByExpression instance.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Type guard accepting any value type\nexport function isOrderByExpression(value: any): value is OrderByExpression {\n  return value instanceof OrderByExpression;\n}\n\n/**\n * Ascending order operator - sorts a column in ascending order.\n *\n * @example\n * asc(users.name)  // Sort by name ascending\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\nexport function asc<TableName extends string>(column: Column<any, any, TableName>): OrderByExpression<TableName> {\n  return new OrderByExpression(column, \"asc\");\n}\n\n/**\n * Descending order operator - sorts a column in descending order.\n *\n * @example\n * desc(users.age)  // Sort by age descending\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\nexport function desc<TableName extends string>(column: Column<any, any, TableName>): OrderByExpression<TableName> {\n  return new OrderByExpression(column, \"desc\");\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"operators.js","sources":["../../../src/orm/operators.ts"],"sourcesContent":["import { needsFieldQuoting } from \"../client/builders/select-utils\";\nimport type { Column } from \"./column\";\nimport { isColumn } from \"./column\";\n\n/**\n * FilterExpression represents a filter condition that can be used in where() clauses.\n * Internal representation of operator expressions that get converted to OData filter syntax.\n */\nexport class FilterExpression {\n  readonly operator: string;\n  // biome-ignore lint/suspicious/noExplicitAny: Operands can be Column, FilterExpression, or any value type\n  readonly operands: (Column | any | FilterExpression)[];\n\n  // biome-ignore lint/suspicious/noExplicitAny: Operands can be Column, FilterExpression, or any value type\n  constructor(operator: string, operands: (Column | any | FilterExpression)[]) {\n    this.operator = operator;\n    this.operands = operands;\n  }\n\n  /**\n   * Convert this expression to OData filter syntax.\n   * @internal Used by QueryBuilder\n   */\n  toODataFilter(useEntityIds?: boolean): string {\n    switch (this.operator) {\n      // Comparison operators\n      case \"eq\":\n        return this._binaryOp(\"eq\", useEntityIds);\n      case \"ne\":\n        return this._binaryOp(\"ne\", useEntityIds);\n      case \"gt\":\n        return this._binaryOp(\"gt\", useEntityIds);\n      case \"gte\":\n        return this._binaryOp(\"ge\", useEntityIds);\n      case \"lt\":\n        return this._binaryOp(\"lt\", useEntityIds);\n      case \"lte\":\n        return this._binaryOp(\"le\", useEntityIds);\n      case \"in\":\n        return this._inOp(useEntityIds);\n      case \"notIn\":\n        return this._notInOp(useEntityIds);\n\n      // String operators\n      case \"contains\":\n        return this._functionOp(\"contains\", useEntityIds);\n      case \"startsWith\":\n        return this._functionOp(\"startswith\", useEntityIds);\n      case \"endsWith\":\n        return this._functionOp(\"endswith\", useEntityIds);\n\n      // Null checks\n      case \"isNull\":\n        return this._isNullOp(useEntityIds);\n      case \"isNotNull\":\n        return this._isNotNullOp(useEntityIds);\n\n      // Logical operators\n      case \"and\":\n        return this._logicalOp(\"and\", useEntityIds);\n      case \"or\":\n        return this._logicalOp(\"or\", useEntityIds);\n      case \"not\":\n        return this._notOp(useEntityIds);\n\n      default:\n        throw new Error(`Unknown operator: ${this.operator}`);\n    }\n  }\n\n  private _binaryOp(op: string, useEntityIds?: boolean): string {\n    const [left, right] = this.operands;\n    // For binary ops, the column is typically the first operand and value is the second\n    // But we also support column-to-column comparisons, so check both\n    let columnForValue: typeof left | typeof right | undefined;\n    if (isColumn(left) && !isColumn(right)) {\n      columnForValue = left;\n    } else if (isColumn(right) && !isColumn(left)) {\n      columnForValue = right;\n    } else {\n      columnForValue = undefined;\n    }\n    const leftStr = this._operandToString(left, useEntityIds, columnForValue);\n    const rightStr = this._operandToString(right, useEntityIds, columnForValue);\n    return `${leftStr} ${op} ${rightStr}`;\n  }\n\n  private _functionOp(fnName: string, useEntityIds?: boolean): string {\n    const [column, value] = this.operands;\n    const columnInstance = isColumn(column) ? column : undefined;\n    const columnStr = this._operandToString(column, useEntityIds);\n    const valueStr = this._operandToString(value, useEntityIds, columnInstance);\n    return `${fnName}(${columnStr}, ${valueStr})`;\n  }\n\n  private _inOp(useEntityIds?: boolean): string {\n    const [column, values] = this.operands;\n    const columnInstance = isColumn(column) ? column : undefined;\n    const columnStr = this._operandToString(column, useEntityIds);\n    // biome-ignore lint/suspicious/noExplicitAny: Dynamic array of values from user input\n    const valuesStr = (values as any[]).map((v) => this._operandToString(v, useEntityIds, columnInstance)).join(\", \");\n    return `${columnStr} in (${valuesStr})`;\n  }\n\n  private _notInOp(useEntityIds?: boolean): string {\n    const [column, values] = this.operands;\n    const columnInstance = isColumn(column) ? column : undefined;\n    const columnStr = this._operandToString(column, useEntityIds);\n    // biome-ignore lint/suspicious/noExplicitAny: Dynamic array of values from user input\n    const valuesStr = (values as any[]).map((v) => this._operandToString(v, useEntityIds, columnInstance)).join(\", \");\n    return `not (${columnStr} in (${valuesStr}))`;\n  }\n\n  private _isNullOp(useEntityIds?: boolean): string {\n    const [column] = this.operands;\n    const columnStr = this._operandToString(column, useEntityIds);\n    return `${columnStr} eq null`;\n  }\n\n  private _isNotNullOp(useEntityIds?: boolean): string {\n    const [column] = this.operands;\n    const columnStr = this._operandToString(column, useEntityIds);\n    return `${columnStr} ne null`;\n  }\n\n  private _logicalOp(op: string, useEntityIds?: boolean): string {\n    const expressions = this.operands.map((expr) => {\n      if (expr instanceof FilterExpression) {\n        const innerExpr = expr.toODataFilter(useEntityIds);\n        // Wrap in parens if it's a logical expression to ensure precedence\n        if (expr.operator === \"and\" || expr.operator === \"or\") {\n          return `(${innerExpr})`;\n        }\n        return innerExpr;\n      }\n      throw new Error(\"Logical operators require FilterExpression operands\");\n    });\n    return expressions.join(` ${op} `);\n  }\n\n  private _notOp(useEntityIds?: boolean): string {\n    const [expr] = this.operands;\n    if (expr instanceof FilterExpression) {\n      return `not (${expr.toODataFilter(useEntityIds)})`;\n    }\n    throw new Error(\"NOT operator requires a FilterExpression operand\");\n  }\n\n  private _operandToString(\n    // biome-ignore lint/suspicious/noExplicitAny: Operand can be Column, FilterExpression, or any value type\n    operand: any,\n    useEntityIds?: boolean, // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n    column?: Column<any, any, any, any>,\n  ): string {\n    if (isColumn(operand)) {\n      const fieldIdentifier = operand.getFieldIdentifier(useEntityIds);\n      // Quote field names in OData filters per FileMaker OData API requirements\n      return needsFieldQuoting(fieldIdentifier) ? `\"${fieldIdentifier}\"` : fieldIdentifier;\n    }\n\n    // If we have a column with an input validator, apply it to transform the value\n    let value = operand;\n    if (column?.inputValidator) {\n      try {\n        const result = column.inputValidator[\"~standard\"].validate(value);\n        // Handle async validators (though they shouldn't be async for filters)\n        if (result instanceof Promise) {\n          // For filters, we can't use async validators, so skip transformation\n          // This is a limitation - async validators won't work in filters\n          value = operand;\n        } else if (\"issues\" in result && result.issues) {\n          // Validation failed, use original value\n          value = operand;\n        } else if (\"value\" in result) {\n          // Validation succeeded, use transformed value\n          value = result.value;\n        }\n      } catch (_error) {\n        // If validation throws, use the original value (will likely cause a query error)\n        // This maintains backward compatibility and allows the server to handle validation\n        value = operand;\n      }\n    }\n\n    if (typeof value === \"string\") {\n      return `'${value.replace(/'/g, \"''\")}'`; // Escape single quotes\n    }\n    if (value === null || value === undefined) {\n      return \"null\";\n    }\n    if (value instanceof Date) {\n      return value.toISOString();\n    }\n    return String(value);\n  }\n}\n\n// ============================================================================\n// Comparison Operators\n// ============================================================================\n\n/**\n * Equal operator - checks if column equals a value or another column.\n *\n * @example\n * eq(users.name, \"John\")           // name equals \"John\"\n * eq(users.id, contacts.id_user)   // cross-table comparison\n */\nexport function eq<TOutput, TInput>(\n  column1: Column<TOutput, TInput>,\n  column2: Column<TOutput, TInput> | NoInfer<TInput>,\n): FilterExpression;\n// biome-ignore lint/suspicious/noExplicitAny: Implementation signature for overloads\nexport function eq(column: Column, value: any): FilterExpression {\n  return new FilterExpression(\"eq\", [column, value]);\n}\n\n/**\n * Not equal operator - checks if column does not equal a value or another column.\n *\n * @example\n * ne(users.status, \"inactive\")     // status not equal to \"inactive\"\n * ne(users.id, contacts.id_user)   // cross-table comparison\n */\nexport function ne<TOutput, TInput>(\n  column1: Column<TOutput, TInput>,\n  column2: Column<TOutput, TInput> | NoInfer<TInput>,\n): FilterExpression;\n// biome-ignore lint/suspicious/noExplicitAny: Implementation signature for overloads\nexport function ne(column: Column, value: any): FilterExpression {\n  return new FilterExpression(\"ne\", [column, value]);\n}\n\n/**\n * Greater than operator - checks if column is greater than a value.\n *\n * @example\n * gt(users.age, 18)               // age greater than 18\n */\nexport function gt<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"gt\", [column, value]);\n}\n\n/**\n * Greater than or equal operator - checks if column is >= a value.\n *\n * @example\n * gte(users.age, 18)              // age >= 18\n */\nexport function gte<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"gte\", [column, value]);\n}\n\n/**\n * Less than operator - checks if column is less than a value.\n *\n * @example\n * lt(users.age, 65)               // age less than 65\n */\nexport function lt<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"lt\", [column, value]);\n}\n\n/**\n * Less than or equal operator - checks if column is <= a value.\n *\n * @example\n * lte(users.age, 65)              // age <= 65\n */\nexport function lte<TOutput extends number | string | Date | null, TInput>(\n  column: Column<TOutput, TInput>,\n  value: NoInfer<TInput>,\n): FilterExpression {\n  return new FilterExpression(\"lte\", [column, value]);\n}\n\n// ============================================================================\n// String Operators\n// ============================================================================\n\n/**\n * Contains operator - checks if a string column contains a substring.\n *\n * @example\n * contains(users.name, \"John\")    // name contains \"John\"\n */\nexport function contains<TOutput, TInput>(column: Column<TOutput, TInput>, value: NoInfer<TInput>): FilterExpression {\n  return new FilterExpression(\"contains\", [column, value]);\n}\n\n/**\n * Starts with operator - checks if a string column starts with a prefix.\n *\n * @example\n * startsWith(users.email, \"admin\") // email starts with \"admin\"\n */\nexport function startsWith<TOutput, TInput>(column: Column<TOutput, TInput>, value: NoInfer<TInput>): FilterExpression {\n  return new FilterExpression(\"startsWith\", [column, value]);\n}\n\n/**\n * Ends with operator - checks if a string column ends with a suffix.\n *\n * @example\n * endsWith(users.email, \"@example.com\") // email ends with \"@example.com\"\n */\nexport function endsWith<TOutput, TInput>(column: Column<TOutput, TInput>, value: NoInfer<TInput>): FilterExpression {\n  return new FilterExpression(\"endsWith\", [column, value]);\n}\n\n// ============================================================================\n// Array Operators\n// ============================================================================\n\n/**\n * In array operator - checks if column value is in an array of values.\n *\n * @example\n * inArray(users.status, [\"active\", \"pending\"]) // status is \"active\" or \"pending\"\n */\nexport function inArray<TOutput, TInput>(column: Column<TOutput, TInput>, values: NoInfer<TInput>[]): FilterExpression {\n  return new FilterExpression(\"in\", [column, values]);\n}\n\n/**\n * Not in array operator - checks if column value is not in an array of values.\n *\n * @example\n * notInArray(users.status, [\"deleted\", \"banned\"]) // status is neither \"deleted\" nor \"banned\"\n */\nexport function notInArray<TOutput, TInput>(\n  column: Column<TOutput, TInput>,\n  values: NoInfer<TInput>[],\n): FilterExpression {\n  return new FilterExpression(\"notIn\", [column, values]);\n}\n\n// ============================================================================\n// Null Check Operators\n// ============================================================================\n\n/**\n * Is null operator - checks if column value is null.\n *\n * @example\n * isNull(users.deletedAt)         // deletedAt is null\n */\nexport function isNull<TOutput, TInput>(column: Column<TOutput, TInput>): FilterExpression {\n  return new FilterExpression(\"isNull\", [column]);\n}\n\n/**\n * Is not null operator - checks if column value is not null.\n *\n * @example\n * isNotNull(users.email)          // email is not null\n */\nexport function isNotNull<TOutput, TInput>(column: Column<TOutput, TInput>): FilterExpression {\n  return new FilterExpression(\"isNotNull\", [column]);\n}\n\n// ============================================================================\n// Logical Operators\n// ============================================================================\n\n/**\n * AND operator - combines multiple filter expressions with logical AND.\n * All expressions must be true for the record to match.\n *\n * @example\n * and(\n *   eq(users.active, true),\n *   gt(users.age, 18)\n * ) // active is true AND age > 18\n */\nexport function and(...expressions: FilterExpression[]): FilterExpression {\n  if (expressions.length === 0) {\n    throw new Error(\"AND operator requires at least one expression\");\n  }\n  if (expressions.length === 1 && expressions[0] !== undefined) {\n    return expressions[0];\n  }\n  return new FilterExpression(\"and\", expressions);\n}\n\n/**\n * OR operator - combines multiple filter expressions with logical OR.\n * At least one expression must be true for the record to match.\n *\n * @example\n * or(\n *   eq(users.role, \"admin\"),\n *   eq(users.role, \"moderator\")\n * ) // role is \"admin\" OR \"moderator\"\n */\nexport function or(...expressions: FilterExpression[]): FilterExpression {\n  if (expressions.length === 0) {\n    throw new Error(\"OR operator requires at least one expression\");\n  }\n  if (expressions.length === 1 && expressions[0] !== undefined) {\n    return expressions[0];\n  }\n  return new FilterExpression(\"or\", expressions);\n}\n\n/**\n * NOT operator - negates a filter expression.\n *\n * @example\n * not(eq(users.status, \"deleted\")) // status is NOT \"deleted\"\n */\nexport function not(expression: FilterExpression): FilterExpression {\n  return new FilterExpression(\"not\", [expression]);\n}\n\n// ============================================================================\n// OrderBy Operators\n// ============================================================================\n\n/**\n * OrderByExpression represents a sort order specification for a column.\n * Used in orderBy() clauses to provide type-safe sorting with direction.\n */\nexport class OrderByExpression<TableName extends string = string> {\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  readonly column: Column<any, any, TableName>;\n  readonly direction: \"asc\" | \"desc\";\n\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  constructor(column: Column<any, any, TableName>, direction: \"asc\" | \"desc\") {\n    this.column = column;\n    this.direction = direction;\n  }\n}\n\n/**\n * Type guard to check if a value is an OrderByExpression instance.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Type guard accepting any value type\nexport function isOrderByExpression(value: any): value is OrderByExpression {\n  return value instanceof OrderByExpression;\n}\n\n/**\n * Ascending order operator - sorts a column in ascending order.\n *\n * @example\n * asc(users.name)  // Sort by name ascending\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\nexport function asc<TableName extends string>(column: Column<any, any, TableName>): OrderByExpression<TableName> {\n  return new OrderByExpression(column, \"asc\");\n}\n\n/**\n * Descending order operator - sorts a column in descending order.\n *\n * @example\n * desc(users.age)  // Sort by age descending\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\nexport function desc<TableName extends string>(column: Column<any, any, TableName>): OrderByExpression<TableName> {\n  return new OrderByExpression(column, \"desc\");\n}\n"],"names":[],"mappings":";;;;;AAQO,MAAM,iBAAiB;AAAA;AAAA,EAM5B,YAAY,UAAkB,UAA+C;AALpE;AAEA;AAAA;AAIP,SAAK,WAAW;AAChB,SAAK,WAAW;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,cAAc,cAAgC;AAC5C,YAAQ,KAAK,UAAA;AAAA;AAAA,MAEX,KAAK;AACH,eAAO,KAAK,UAAU,MAAM,YAAY;AAAA,MAC1C,KAAK;AACH,eAAO,KAAK,UAAU,MAAM,YAAY;AAAA,MAC1C,KAAK;AACH,eAAO,KAAK,UAAU,MAAM,YAAY;AAAA,MAC1C,KAAK;AACH,eAAO,KAAK,UAAU,MAAM,YAAY;AAAA,MAC1C,KAAK;AACH,eAAO,KAAK,UAAU,MAAM,YAAY;AAAA,MAC1C,KAAK;AACH,eAAO,KAAK,UAAU,MAAM,YAAY;AAAA,MAC1C,KAAK;AACH,eAAO,KAAK,MAAM,YAAY;AAAA,MAChC,KAAK;AACH,eAAO,KAAK,SAAS,YAAY;AAAA;AAAA,MAGnC,KAAK;AACH,eAAO,KAAK,YAAY,YAAY,YAAY;AAAA,MAClD,KAAK;AACH,eAAO,KAAK,YAAY,cAAc,YAAY;AAAA,MACpD,KAAK;AACH,eAAO,KAAK,YAAY,YAAY,YAAY;AAAA;AAAA,MAGlD,KAAK;AACH,eAAO,KAAK,UAAU,YAAY;AAAA,MACpC,KAAK;AACH,eAAO,KAAK,aAAa,YAAY;AAAA;AAAA,MAGvC,KAAK;AACH,eAAO,KAAK,WAAW,OAAO,YAAY;AAAA,MAC5C,KAAK;AACH,eAAO,KAAK,WAAW,MAAM,YAAY;AAAA,MAC3C,KAAK;AACH,eAAO,KAAK,OAAO,YAAY;AAAA,MAEjC;AACE,cAAM,IAAI,MAAM,qBAAqB,KAAK,QAAQ,EAAE;AAAA,IAAA;AAAA,EAE1D;AAAA,EAEQ,UAAU,IAAY,cAAgC;AAC5D,UAAM,CAAC,MAAM,KAAK,IAAI,KAAK;AAG3B,QAAI;AACJ,QAAI,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,GAAG;AACtC,uBAAiB;AAAA,IACnB,WAAW,SAAS,KAAK,KAAK,CAAC,SAAS,IAAI,GAAG;AAC7C,uBAAiB;AAAA,IACnB,OAAO;AACL,uBAAiB;AAAA,IACnB;AACA,UAAM,UAAU,KAAK,iBAAiB,MAAM,cAAc,cAAc;AACxE,UAAM,WAAW,KAAK,iBAAiB,OAAO,cAAc,cAAc;AAC1E,WAAO,GAAG,OAAO,IAAI,EAAE,IAAI,QAAQ;AAAA,EACrC;AAAA,EAEQ,YAAY,QAAgB,cAAgC;AAClE,UAAM,CAAC,QAAQ,KAAK,IAAI,KAAK;AAC7B,UAAM,iBAAiB,SAAS,MAAM,IAAI,SAAS;AACnD,UAAM,YAAY,KAAK,iBAAiB,QAAQ,YAAY;AAC5D,UAAM,WAAW,KAAK,iBAAiB,OAAO,cAAc,cAAc;AAC1E,WAAO,GAAG,MAAM,IAAI,SAAS,KAAK,QAAQ;AAAA,EAC5C;AAAA,EAEQ,MAAM,cAAgC;AAC5C,UAAM,CAAC,QAAQ,MAAM,IAAI,KAAK;AAC9B,UAAM,iBAAiB,SAAS,MAAM,IAAI,SAAS;AACnD,UAAM,YAAY,KAAK,iBAAiB,QAAQ,YAAY;AAE5D,UAAM,YAAa,OAAiB,IAAI,CAAC,MAAM,KAAK,iBAAiB,GAAG,cAAc,cAAc,CAAC,EAAE,KAAK,IAAI;AAChH,WAAO,GAAG,SAAS,QAAQ,SAAS;AAAA,EACtC;AAAA,EAEQ,SAAS,cAAgC;AAC/C,UAAM,CAAC,QAAQ,MAAM,IAAI,KAAK;AAC9B,UAAM,iBAAiB,SAAS,MAAM,IAAI,SAAS;AACnD,UAAM,YAAY,KAAK,iBAAiB,QAAQ,YAAY;AAE5D,UAAM,YAAa,OAAiB,IAAI,CAAC,MAAM,KAAK,iBAAiB,GAAG,cAAc,cAAc,CAAC,EAAE,KAAK,IAAI;AAChH,WAAO,QAAQ,SAAS,QAAQ,SAAS;AAAA,EAC3C;AAAA,EAEQ,UAAU,cAAgC;AAChD,UAAM,CAAC,MAAM,IAAI,KAAK;AACtB,UAAM,YAAY,KAAK,iBAAiB,QAAQ,YAAY;AAC5D,WAAO,GAAG,SAAS;AAAA,EACrB;AAAA,EAEQ,aAAa,cAAgC;AACnD,UAAM,CAAC,MAAM,IAAI,KAAK;AACtB,UAAM,YAAY,KAAK,iBAAiB,QAAQ,YAAY;AAC5D,WAAO,GAAG,SAAS;AAAA,EACrB;AAAA,EAEQ,WAAW,IAAY,cAAgC;AAC7D,UAAM,cAAc,KAAK,SAAS,IAAI,CAAC,SAAS;AAC9C,UAAI,gBAAgB,kBAAkB;AACpC,cAAM,YAAY,KAAK,cAAc,YAAY;AAEjD,YAAI,KAAK,aAAa,SAAS,KAAK,aAAa,MAAM;AACrD,iBAAO,IAAI,SAAS;AAAA,QACtB;AACA,eAAO;AAAA,MACT;AACA,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE,CAAC;AACD,WAAO,YAAY,KAAK,IAAI,EAAE,GAAG;AAAA,EACnC;AAAA,EAEQ,OAAO,cAAgC;AAC7C,UAAM,CAAC,IAAI,IAAI,KAAK;AACpB,QAAI,gBAAgB,kBAAkB;AACpC,aAAO,QAAQ,KAAK,cAAc,YAAY,CAAC;AAAA,IACjD;AACA,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAAA,EAEQ,iBAEN,SACA,cACA,QACQ;AACR,QAAI,SAAS,OAAO,GAAG;AACrB,YAAM,kBAAkB,QAAQ,mBAAmB,YAAY;AAE/D,aAAO,kBAAkB,eAAe,IAAI,IAAI,eAAe,MAAM;AAAA,IACvE;AAGA,QAAI,QAAQ;AACZ,QAAI,iCAAQ,gBAAgB;AAC1B,UAAI;AACF,cAAM,SAAS,OAAO,eAAe,WAAW,EAAE,SAAS,KAAK;AAEhE,YAAI,kBAAkB,SAAS;AAG7B,kBAAQ;AAAA,QACV,WAAW,YAAY,UAAU,OAAO,QAAQ;AAE9C,kBAAQ;AAAA,QACV,WAAW,WAAW,QAAQ;AAE5B,kBAAQ,OAAO;AAAA,QACjB;AAAA,MACF,SAAS,QAAQ;AAGf,gBAAQ;AAAA,MACV;AAAA,IACF;AAEA,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,IAAI,MAAM,QAAQ,MAAM,IAAI,CAAC;AAAA,IACtC;AACA,QAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,aAAO;AAAA,IACT;AACA,QAAI,iBAAiB,MAAM;AACzB,aAAO,MAAM,YAAA;AAAA,IACf;AACA,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAkBO,SAAS,GAAG,QAAgB,OAA8B;AAC/D,SAAO,IAAI,iBAAiB,MAAM,CAAC,QAAQ,KAAK,CAAC;AACnD;AAcO,SAAS,GAAG,QAAgB,OAA8B;AAC/D,SAAO,IAAI,iBAAiB,MAAM,CAAC,QAAQ,KAAK,CAAC;AACnD;AAQO,SAAS,GACd,QACA,OACkB;AAClB,SAAO,IAAI,iBAAiB,MAAM,CAAC,QAAQ,KAAK,CAAC;AACnD;AAQO,SAAS,IACd,QACA,OACkB;AAClB,SAAO,IAAI,iBAAiB,OAAO,CAAC,QAAQ,KAAK,CAAC;AACpD;AAQO,SAAS,GACd,QACA,OACkB;AAClB,SAAO,IAAI,iBAAiB,MAAM,CAAC,QAAQ,KAAK,CAAC;AACnD;AAQO,SAAS,IACd,QACA,OACkB;AAClB,SAAO,IAAI,iBAAiB,OAAO,CAAC,QAAQ,KAAK,CAAC;AACpD;AAYO,SAAS,SAA0B,QAAiC,OAA0C;AACnH,SAAO,IAAI,iBAAiB,YAAY,CAAC,QAAQ,KAAK,CAAC;AACzD;AAQO,SAAS,WAA4B,QAAiC,OAA0C;AACrH,SAAO,IAAI,iBAAiB,cAAc,CAAC,QAAQ,KAAK,CAAC;AAC3D;AAQO,SAAS,SAA0B,QAAiC,OAA0C;AACnH,SAAO,IAAI,iBAAiB,YAAY,CAAC,QAAQ,KAAK,CAAC;AACzD;AAYO,SAAS,QAAyB,QAAiC,QAA6C;AACrH,SAAO,IAAI,iBAAiB,MAAM,CAAC,QAAQ,MAAM,CAAC;AACpD;AAQO,SAAS,WACd,QACA,QACkB;AAClB,SAAO,IAAI,iBAAiB,SAAS,CAAC,QAAQ,MAAM,CAAC;AACvD;AAYO,SAAS,OAAwB,QAAmD;AACzF,SAAO,IAAI,iBAAiB,UAAU,CAAC,MAAM,CAAC;AAChD;AAQO,SAAS,UAA2B,QAAmD;AAC5F,SAAO,IAAI,iBAAiB,aAAa,CAAC,MAAM,CAAC;AACnD;AAgBO,SAAS,OAAO,aAAmD;AACxE,MAAI,YAAY,WAAW,GAAG;AAC5B,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACjE;AACA,MAAI,YAAY,WAAW,KAAK,YAAY,CAAC,MAAM,QAAW;AAC5D,WAAO,YAAY,CAAC;AAAA,EACtB;AACA,SAAO,IAAI,iBAAiB,OAAO,WAAW;AAChD;AAYO,SAAS,MAAM,aAAmD;AACvE,MAAI,YAAY,WAAW,GAAG;AAC5B,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,MAAI,YAAY,WAAW,KAAK,YAAY,CAAC,MAAM,QAAW;AAC5D,WAAO,YAAY,CAAC;AAAA,EACtB;AACA,SAAO,IAAI,iBAAiB,MAAM,WAAW;AAC/C;AAQO,SAAS,IAAI,YAAgD;AAClE,SAAO,IAAI,iBAAiB,OAAO,CAAC,UAAU,CAAC;AACjD;AAUO,MAAM,kBAAqD;AAAA;AAAA,EAMhE,YAAY,QAAqC,WAA2B;AAJnE;AAAA;AACA;AAIP,SAAK,SAAS;AACd,SAAK,YAAY;AAAA,EACnB;AACF;AAMO,SAAS,oBAAoB,OAAwC;AAC1E,SAAO,iBAAiB;AAC1B;AASO,SAAS,IAA8B,QAAmE;AAC/G,SAAO,IAAI,kBAAkB,QAAQ,KAAK;AAC5C;AASO,SAAS,KAA+B,QAAmE;AAChH,SAAO,IAAI,kBAAkB,QAAQ,MAAM;AAC7C;"}

package/dist/esm/orm/table.js.map

@@ -1 +1 @@
-{"version":3,"file":"table.js","sources":["../../../src/orm/table.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { Column } from \"./column\";\nimport type { ContainerDbType, FieldBuilder, FieldBuilder as FieldBuilderType } from \"./field-builders\";\n// import { z } from \"zod/v4\";\n\n/**\n * Extract the output type from a FieldBuilder.\n * This is what you get when reading from the database.\n *\n * This type extracts the TOutput type parameter, which is set by readValidator()\n * and represents the transformed/validated output type.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\nexport type InferFieldOutput<F> = F extends FieldBuilder<infer TOutput, any, any, any> ? TOutput : never;\n\n/**\n * Extract the input type from a FieldBuilder.\n * This is what you pass when writing to the database.\n *\n * This type extracts the TInput type parameter, which is set by writeValidator()\n * and represents the transformed/validated input type.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\ntype InferFieldInput<F> = F extends FieldBuilder<any, infer TInput, any, any> ? TInput : never;\n\n/**\n * Build a schema type from field builders (output/read types).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype InferSchemaFromFields<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in keyof TFields]: InferFieldOutput<TFields[K]>;\n};\n\n/**\n * Build an input schema type from field builders (input/write types).\n * Used for insert and update operations.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype InferInputSchemaFromFields<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in keyof TFields]: InferFieldInput<TFields[K]>;\n};\n\n/**\n * Check if a field is a container field by inspecting its TDbType.\n * Container fields have a branded TDbType that extends ContainerDbType.\n */\ntype IsContainerField<F> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  F extends FieldBuilder<any, any, infer TDbType, any>\n    ? NonNullable<TDbType> extends ContainerDbType\n      ? true\n      : false\n    : false;\n\n/**\n * Extract only selectable (non-container) field keys from a fields record.\n * Container fields are excluded because they cannot be selected via $select in FileMaker OData.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype SelectableFieldKeys<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in keyof TFields]: IsContainerField<TFields[K]> extends true ? never : K;\n}[keyof TFields];\n\n/**\n * Build a schema type excluding container fields (for query return types).\n * This is used to ensure container fields don't appear in the return type\n * when using defaultSelect: \"schema\" or \"all\".\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype _InferSelectableSchemaFromFields<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in SelectableFieldKeys<TFields>]: InferFieldOutput<TFields[K]>;\n};\n\n/**\n * Internal Symbols for table properties (hidden from IDE autocomplete).\n * These are used to store internal configuration that shouldn't be visible\n * when users access table columns.\n * @internal - Not exported from public API, only accessible via FMTable.Symbol\n */\nconst FMTableName = Symbol.for(\"fmodata:FMTableName\");\nconst FMTableEntityId = Symbol.for(\"fmodata:FMTableEntityId\");\nconst FMTableSchema = Symbol.for(\"fmodata:FMTableSchema\");\nconst FMTableFields = Symbol.for(\"fmodata:FMTableFields\");\nconst FMTableNavigationPaths = Symbol.for(\"fmodata:FMTableNavigationPaths\");\nconst FMTableDefaultSelect = Symbol.for(\"fmodata:FMTableDefaultSelect\");\nconst FMTableBaseTableConfig = Symbol.for(\"fmodata:FMTableBaseTableConfig\");\nconst FMTableUseEntityIds = Symbol.for(\"fmodata:FMTableUseEntityIds\");\nconst FMTableComment = Symbol.for(\"fmodata:FMTableComment\");\n\n/**\n * Base table class with Symbol-based internal properties.\n * This follows the Drizzle ORM pattern where internal configuration\n * is stored via Symbols, keeping it hidden from IDE autocomplete.\n */\nexport class FMTable<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration, default allows untyped tables\n  TFields extends Record<string, FieldBuilder<any, any, any, any>> = any,\n  TName extends string = string,\n  TNavigationPaths extends readonly string[] = readonly string[],\n> {\n  /**\n   * Internal Symbols for accessing table metadata.\n   * @internal - Not intended for public use. Access table properties via columns instead.\n   */\n  static readonly Symbol = {\n    Name: FMTableName,\n    EntityId: FMTableEntityId,\n    UseEntityIds: FMTableUseEntityIds,\n    Schema: FMTableSchema,\n    Fields: FMTableFields,\n    NavigationPaths: FMTableNavigationPaths,\n    DefaultSelect: FMTableDefaultSelect,\n    BaseTableConfig: FMTableBaseTableConfig,\n    Comment: FMTableComment,\n  };\n\n  /** @internal */\n  [FMTableName]: TName;\n\n  /** @internal */\n  [FMTableEntityId]?: `FMTID:${string}`;\n\n  /** @internal */\n  [FMTableUseEntityIds]?: boolean;\n\n  /** @internal */\n  [FMTableComment]?: string;\n\n  /** @internal */\n  [FMTableSchema]: Partial<Record<keyof TFields, StandardSchemaV1>>;\n\n  /** @internal */\n  [FMTableFields]: TFields;\n\n  /** @internal */\n  [FMTableNavigationPaths]: TNavigationPaths;\n\n  /** @internal */\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  [FMTableDefaultSelect]: \"all\" | \"schema\" | Record<string, Column<any, any, TName>>;\n\n  /** @internal */\n  [FMTableBaseTableConfig]: {\n    schema: Partial<Record<keyof TFields, StandardSchemaV1>>;\n    inputSchema?: Partial<Record<keyof TFields, StandardSchemaV1>>;\n    idField?: keyof TFields;\n    required: readonly (keyof TFields)[];\n    readOnly: readonly (keyof TFields)[];\n    containerFields: readonly (keyof TFields)[];\n    fmfIds?: Record<keyof TFields, `FMFID:${string}`>;\n  };\n\n  constructor(config: {\n    name: TName;\n    entityId?: `FMTID:${string}`;\n    useEntityIds?: boolean;\n    comment?: string;\n    schema: Partial<Record<keyof TFields, StandardSchemaV1>>;\n    fields: TFields;\n    navigationPaths: TNavigationPaths;\n    // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n    defaultSelect: \"all\" | \"schema\" | Record<string, Column<any, any, TName>>;\n    baseTableConfig: {\n      schema: Partial<Record<keyof TFields, StandardSchemaV1>>;\n      inputSchema?: Partial<Record<keyof TFields, StandardSchemaV1>>;\n      idField?: keyof TFields;\n      required: readonly (keyof TFields)[];\n      readOnly: readonly (keyof TFields)[];\n      containerFields: readonly (keyof TFields)[];\n      fmfIds?: Record<keyof TFields, `FMFID:${string}`>;\n    };\n  }) {\n    this[FMTableName] = config.name;\n    this[FMTableEntityId] = config.entityId;\n    this[FMTableUseEntityIds] = config.useEntityIds;\n    this[FMTableComment] = config.comment;\n    this[FMTableSchema] = config.schema;\n    this[FMTableFields] = config.fields;\n    this[FMTableNavigationPaths] = config.navigationPaths;\n    this[FMTableDefaultSelect] = config.defaultSelect;\n    this[FMTableBaseTableConfig] = config.baseTableConfig;\n  }\n}\n\n/**\n * Type helper to extract the column map from fields.\n * Table name is baked into each column type for validation.\n * Container fields are marked with IsContainer=true.\n * Columns include both output type (for reading) and input type (for writing/filtering).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\nexport type ColumnMap<TFields extends Record<string, FieldBuilder<any, any, any, any>>, TName extends string> = {\n  [K in keyof TFields]: Column<\n    InferFieldOutput<TFields[K]>,\n    InferFieldInput<TFields[K]>,\n    TName,\n    IsContainerField<TFields[K]>\n  >;\n};\n\n/**\n * Extract only selectable (non-container) columns from a table.\n * This is used to prevent selecting container fields in queries.\n */\nexport type SelectableColumnMap<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n> = {\n  [K in SelectableFieldKeys<TFields>]: Column<InferFieldOutput<TFields[K]>, InferFieldInput<TFields[K]>, TName, false>;\n};\n\n/**\n * Validates that a select object doesn't contain container field columns.\n * Returns never if any container fields are found, otherwise returns the original type.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\nexport type ValidateNoContainerFields<TSelect extends Record<string, Column<any, any, any, any>>> = {\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  [K in keyof TSelect]: TSelect[K] extends Column<any, any, any, true> ? never : TSelect[K];\n} extends TSelect\n  ? TSelect\n  : {\n      // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n      [K in keyof TSelect]: TSelect[K] extends Column<any, any, any, true>\n        ? \"❌ Container fields cannot be selected. Use .getSingleField() instead.\"\n        : TSelect[K];\n    };\n\n/**\n * Extract the keys from a defaultSelect function's return type.\n * Used to infer which fields are selected by default for type narrowing.\n */\ntype _ExtractDefaultSelectKeys<\n  TDefaultSelect,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n> = TDefaultSelect extends (columns: ColumnMap<TFields, TName>) => infer R\n  ? keyof R\n  : TDefaultSelect extends \"schema\"\n    ? keyof TFields\n    : keyof TFields; // \"all\" defaults to all keys\n\n/**\n * Complete table type with both metadata (via Symbols) and column accessors.\n * This is the return type of fmTableOccurrence - users see columns directly,\n * but internal config is hidden via Symbols.\n */\nexport type FMTableWithColumns<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n  TNavigationPaths extends readonly string[] = readonly string[],\n> = FMTable<TFields, TName, TNavigationPaths> & ColumnMap<TFields, TName>;\n\n/**\n * Options for fmTableOccurrence function.\n * Provides autocomplete-friendly typing while preserving inference for navigationPaths.\n */\nexport interface FMTableOccurrenceOptions<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n> {\n  /** The entity ID (FMTID) for this table occurrence */\n  entityId?: `FMTID:${string}`;\n\n  /** The comment for this table */\n  comment?: string;\n\n  /**\n   * Default select behavior:\n   * - \"all\": Select all fields (including related tables)\n   * - \"schema\": Select only schema-defined fields (default)\n   * - function: Custom selection from columns\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  defaultSelect?: \"all\" | \"schema\" | ((columns: ColumnMap<TFields, TName>) => Record<string, Column<any, any, TName>>);\n\n  /** Navigation paths available from this table (for expand operations) */\n  navigationPaths?: readonly string[];\n\n  /** Whether to use entity IDs (FMTID/FMFID) instead of names in queries */\n  useEntityIds?: boolean;\n}\n\n/**\n * Create a table occurrence with field builders.\n * This is the main API for defining tables in the new ORM style.\n *\n * @example\n * const users = fmTableOccurrence(\"users\", {\n *   id: textField().primaryKey().entityId(\"FMFID:1\"),\n *   name: textField().notNull().entityId(\"FMFID:6\"),\n *   active: numberField()\n *     .outputValidator(z.coerce.boolean())\n *     .inputValidator(z.boolean().transform(v => v ? 1 : 0))\n *     .entityId(\"FMFID:7\"),\n * }, {\n *   entityId: \"FMTID:100\",\n *   defaultSelect: \"schema\",\n *   navigationPaths: [\"contacts\"],\n * });\n *\n * // Access columns\n * users.id    // Column<string, \"id\">\n * users.name  // Column<string, \"name\">\n *\n * // Use in queries\n * db.from(users).select(\"id\", \"name\").where(eq(users.active, true))\n */\nexport function fmTableOccurrence<\n  const TName extends string,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  const TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  const TNavPaths extends readonly string[] = readonly [],\n>(\n  name: TName,\n  fields: TFields,\n  options?: FMTableOccurrenceOptions<TFields, TName> & {\n    /** Navigation paths available from this table (for expand operations) */\n    navigationPaths?: TNavPaths;\n  },\n): FMTableWithColumns<TFields, TName, TNavPaths> {\n  // Extract configuration from field builders\n  const fieldConfigs = Object.entries(fields).map(([fieldName, builder]) => ({\n    fieldName,\n    // biome-ignore lint/suspicious/noExplicitAny: Internal property access for builder pattern\n    config: (builder as any)._getConfig(),\n  }));\n\n  // Find primary key field\n  const primaryKeyField = fieldConfigs.find((f) => f.config.primaryKey);\n  const idField = primaryKeyField?.fieldName;\n\n  // Collect required fields (notNull fields)\n  const required = fieldConfigs.filter((f) => f.config.notNull).map((f) => f.fieldName);\n\n  // Collect read-only fields\n  const readOnly = fieldConfigs.filter((f) => f.config.readOnly).map((f) => f.fieldName);\n\n  // Collect container fields (cannot be selected via $select)\n  const containerFields = fieldConfigs.filter((f) => f.config.fieldType === \"container\").map((f) => f.fieldName);\n\n  // Collect entity IDs\n  const fmfIds: Record<string, `FMFID:${string}`> = {};\n  for (const { fieldName, config } of fieldConfigs) {\n    if (config.entityId) {\n      fmfIds[fieldName] = config.entityId;\n    }\n  }\n\n  // Build Zod schema from field builders (output/read validators)\n  const outputSchema: Partial<Record<keyof TFields, StandardSchemaV1>> = {};\n  // Build input schema from field builders (input/write validators)\n  const inputSchema: Record<string, StandardSchemaV1> = {};\n\n  for (const { fieldName, config } of fieldConfigs) {\n    // Use outputValidator if provided\n    if (config.outputValidator) {\n      outputSchema[fieldName as keyof TFields] = config.outputValidator;\n    }\n\n    // Store inputValidator if provided (for write operations)\n    if (config.inputValidator) {\n      inputSchema[fieldName] = config.inputValidator;\n    }\n  }\n\n  // Build BaseTable-compatible config\n  const baseTableConfig = {\n    schema: outputSchema as Partial<Record<keyof TFields, StandardSchemaV1>>,\n    inputSchema:\n      Object.keys(inputSchema).length > 0\n        ? (inputSchema as Partial<Record<keyof TFields, StandardSchemaV1>>)\n        : undefined,\n    idField: idField as keyof TFields | undefined,\n    required: required as readonly (keyof TFields)[],\n    readOnly: readOnly as readonly (keyof TFields)[],\n    containerFields: containerFields as readonly (keyof TFields)[],\n    fmfIds: (Object.keys(fmfIds).length > 0 ? fmfIds : undefined) as\n      | Record<keyof TFields, `FMFID:${string}`>\n      | undefined,\n  };\n\n  // Create column instances\n  const columns = {} as ColumnMap<TFields, TName>;\n  for (const [fieldName, builder] of Object.entries(fields)) {\n    // biome-ignore lint/suspicious/noExplicitAny: Internal property access for builder pattern\n    const config = (builder as any)._getConfig();\n    // biome-ignore lint/suspicious/noExplicitAny: Mutation of readonly properties for builder pattern\n    (columns as any)[fieldName] = new Column({\n      fieldName: String(fieldName),\n      entityId: config.entityId,\n      tableName: name,\n      tableEntityId: options?.entityId,\n      inputValidator: config.inputValidator,\n    });\n  }\n\n  // Resolve defaultSelect: if it's a function, call it with columns; otherwise use as-is\n  const defaultSelectOption = options?.defaultSelect ?? \"schema\";\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  const resolvedDefaultSelect: \"all\" | \"schema\" | Record<string, Column<any, any, TName>> =\n    typeof defaultSelectOption === \"function\"\n      ? defaultSelectOption(columns as ColumnMap<TFields, TName>)\n      : defaultSelectOption;\n\n  // Create the FMTable instance with Symbol-based internal properties\n  const navigationPaths = (options?.navigationPaths ?? []) as TNavPaths;\n  const table = new FMTable<TFields, TName, TNavPaths>({\n    name,\n    entityId: options?.entityId,\n    useEntityIds: options?.useEntityIds,\n    comment: options?.comment,\n    schema: outputSchema,\n    fields,\n    navigationPaths,\n    defaultSelect: resolvedDefaultSelect,\n    baseTableConfig,\n  });\n\n  // Assign columns to the table instance (making them accessible directly)\n  Object.assign(table, columns);\n\n  return table as FMTableWithColumns<TFields, TName, TNavPaths>;\n}\n\n// /**\n//  * Type guard to check if a value is a TableOccurrence or FMTable.\n//  * Supports both Symbol-based (new) and underscore-prefixed (legacy) formats.\n//  */\n// function isTableOccurrence(value: any): value is TableOccurrence {\n//   if (!value || typeof value !== \"object\") {\n//     return false;\n//   }\n\n//   // Check for Symbol-based format (new FMTable class)\n//   if (\n//     FMTableName in value &&\n//     FMTableSchema in value &&\n//     FMTableFields in value\n//   ) {\n//     return typeof value[FMTableName] === \"string\";\n//   }\n\n//   // Check for underscore-prefixed format (legacy interface)\n//   if (\"_name\" in value && \"_schema\" in value && \"_fields\" in value) {\n//     return typeof value._name === \"string\";\n//   }\n\n//   return false;\n// }\n\n/**\n * Helper to extract the schema type from a TableOccurrence or FMTable.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\nexport type InferTableSchema<T> = T extends FMTable<infer TFields, any> ? InferSchemaFromFields<TFields> : never;\n\n/**\n * Extract the schema type from an FMTable instance.\n * This is used to infer the schema from table objects passed to db.from(), expand(), etc.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type InferSchemaOutputFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any> ? InferSchemaFromFields<TFields> : never;\n\n/**\n * Extract the input schema type from an FMTable instance.\n * This is used for insert and update operations where we need write types.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type InferInputSchemaFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any> ? InferInputSchemaFromFields<TFields> : never;\n\n/**\n * Helper type to check if a FieldBuilder's input type excludes null and undefined.\n * This checks the TInput type parameter, which preserves nullability from notNull().\n */\ntype FieldInputExcludesNullish<F> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  F extends FieldBuilder<any, infer TInput, any>\n    ? null extends TInput\n      ? false\n      : undefined extends TInput\n        ? false\n        : true\n    : false;\n\n/**\n * Check if a FieldBuilder is readOnly at the type level\n */\ntype IsFieldReadOnly<F> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  F extends FieldBuilderType<any, any, any, infer ReadOnly> ? (ReadOnly extends true ? true : false) : false;\n\n/**\n * Compute insert data type from FMTable, making notNull fields required.\n * Fields are required if their FieldBuilder's TInput type excludes null/undefined.\n * All other fields are optional (can be omitted).\n * readOnly fields are excluded (including primaryKey/idField since they're automatically readOnly).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type InsertDataFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any>\n    ? {\n        [K in keyof TFields as IsFieldReadOnly<TFields[K]> extends true\n          ? never\n          : FieldInputExcludesNullish<TFields[K]> extends true\n            ? K\n            : never]: InferFieldInput<TFields[K]>;\n      } & {\n        [K in keyof TFields as IsFieldReadOnly<TFields[K]> extends true\n          ? never\n          : FieldInputExcludesNullish<TFields[K]> extends true\n            ? never\n            : K]?: InferFieldInput<TFields[K]>;\n      }\n    : never;\n\n/**\n * Compute update data type from FMTable.\n * All fields are optional, but readOnly fields are excluded (including primaryKey/idField).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type UpdateDataFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any>\n    ? {\n        [K in keyof TFields as IsFieldReadOnly<TFields[K]> extends true ? never : K]?: InferFieldInput<TFields[K]>;\n      }\n    : never;\n\n/**\n * Extract the table name type from an FMTable.\n * This is a workaround since we can't directly index Symbols in types.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration, required for type inference with infer\nexport type ExtractTableName<T extends FMTable<any, any>> = T extends FMTable<any, infer Name> ? Name : never;\n\n/**\n * Validates that a target table's name matches one of the source table's navigationPaths.\n * Used to ensure type-safe expand/navigate operations.\n */\nexport type ValidExpandTarget<\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  SourceTable extends FMTable<any, any, any> | undefined,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  TargetTable extends FMTable<any, any, any>,\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n> = SourceTable extends FMTable<any, any, infer SourceNavPaths>\n  ? ExtractTableName<TargetTable> extends SourceNavPaths[number]\n    ? TargetTable\n    : never\n  : TargetTable;\n\n// ============================================================================\n// Helper Functions for Accessing FMTable Internal Properties\n// ============================================================================\n\n/**\n * Get the table name from an FMTable instance.\n * @param table - FMTable instance\n * @returns The table name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableName<T extends FMTable<any, any>>(table: T): string {\n  return table[FMTableName];\n}\n\n/**\n * Get the entity ID (FMTID) from an FMTable instance.\n * @param table - FMTable instance\n * @returns The entity ID or undefined if not using entity IDs\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableEntityId<T extends FMTable<any, any>>(table: T): string | undefined {\n  return table[FMTableEntityId];\n}\n\n/**\n * Get the schema validator from an FMTable instance.\n * @param table - FMTable instance\n * @returns The StandardSchemaV1 validator record (partial - only fields with validators)\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableSchema<T extends FMTable<any, any>>(\n  table: T,\n): Partial<Record<keyof T[typeof FMTableFields], StandardSchemaV1>> {\n  return table[FMTableSchema];\n}\n\n/**\n * Get the fields from an FMTable instance.\n * @param table - FMTable instance\n * @returns The fields record\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableFields<T extends FMTable<any, any>>(table: T) {\n  return table[FMTableFields];\n}\n\n/**\n * Get the navigation paths from an FMTable instance.\n * @param table - FMTable instance\n * @returns Array of navigation path names\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getNavigationPaths<T extends FMTable<any, any>>(table: T): readonly string[] {\n  return table[FMTableNavigationPaths];\n}\n\n/**\n * Get the default select configuration from an FMTable instance.\n * @param table - FMTable instance\n * @returns Default select configuration\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getDefaultSelect<T extends FMTable<any, any>>(table: T) {\n  return table[FMTableDefaultSelect];\n}\n\n/**\n * Get the base table configuration from an FMTable instance.\n * This provides access to schema, idField, required fields, readOnly fields, and field IDs.\n * @param table - FMTable instance\n * @returns Base table configuration object\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getBaseTableConfig<T extends FMTable<any, any>>(table: T) {\n  return table[FMTableBaseTableConfig];\n}\n\n/**\n * Check if an FMTable instance is using entity IDs (both FMTID and FMFIDs).\n * @param table - FMTable instance\n * @returns True if using entity IDs, false otherwise\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function isUsingEntityIds<T extends FMTable<any, any>>(table: T): boolean {\n  return table[FMTableEntityId] !== undefined && table[FMTableBaseTableConfig].fmfIds !== undefined;\n}\n\n/**\n * Get the field ID (FMFID) for a given field name, or the field name itself if not using IDs.\n * @param table - FMTable instance\n * @param fieldName - Field name to get the ID for\n * @returns The FMFID string or the original field name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getFieldId<T extends FMTable<any, any>>(table: T, fieldName: string): string {\n  const config = table[FMTableBaseTableConfig];\n  if (config.fmfIds && fieldName in config.fmfIds) {\n    const fieldId = config.fmfIds[fieldName];\n    if (fieldId) {\n      return fieldId;\n    }\n  }\n  return fieldName;\n}\n\n/**\n * Get the field name for a given field ID (FMFID), or the ID itself if not found.\n * @param table - FMTable instance\n * @param fieldId - The FMFID to get the field name for\n * @returns The field name or the original ID\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getFieldName<T extends FMTable<any, any>>(table: T, fieldId: string): string {\n  const config = table[FMTableBaseTableConfig];\n  if (config.fmfIds) {\n    for (const [fieldName, fmfId] of Object.entries(config.fmfIds)) {\n      if (fmfId === fieldId) {\n        return fieldName;\n      }\n    }\n  }\n  return fieldId;\n}\n/**\n * Get the table ID (FMTID or name) from an FMTable instance.\n * Returns the FMTID if available, otherwise returns the table name.\n * @param table - FMTable instance\n * @returns The FMTID string or the table name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableId<T extends FMTable<any, any>>(table: T): string {\n  return table[FMTableEntityId] ?? table[FMTableName];\n}\n\n/**\n * Get the comment from an FMTable instance.\n * @param table - FMTable instance\n * @returns The comment string or undefined if not set\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableComment<T extends FMTable<any, any>>(table: T): string | undefined {\n  return table[FMTableComment];\n}\n\n/**\n * Get all columns from a table as an object.\n * Useful for selecting all fields except some using destructuring.\n *\n * @example\n * const { password, ...cols } = getTableColumns(users)\n * db.from(users).list().select(cols)\n *\n * @param table - FMTable instance\n * @returns Object with all columns from the table\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableColumns<T extends FMTable<any, any>>(\n  table: T,\n): ColumnMap<T[typeof FMTableFields], ExtractTableName<T>> {\n  const fields = table[FMTableFields];\n  const tableName = table[FMTableName];\n  const tableEntityId = table[FMTableEntityId];\n  const baseConfig = table[FMTableBaseTableConfig];\n\n  const columns = {} as ColumnMap<T[typeof FMTableFields], ExtractTableName<T>>;\n  for (const [fieldName, builder] of Object.entries(fields)) {\n    // biome-ignore lint/suspicious/noExplicitAny: Internal property access for builder pattern\n    const config = (builder as any)._getConfig();\n    // biome-ignore lint/suspicious/noExplicitAny: Mutation of readonly properties for builder pattern\n    (columns as any)[fieldName] = new Column({\n      fieldName: String(fieldName),\n      entityId: baseConfig.fmfIds?.[fieldName],\n      tableName,\n      tableEntityId,\n      inputValidator: config.inputValidator,\n    });\n  }\n\n  return columns;\n}\n"],"names":["_a"],"mappings":"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"}
+{"version":3,"file":"table.js","sources":["../../../src/orm/table.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { Column } from \"./column\";\nimport type { ContainerDbType, FieldBuilder, FieldBuilder as FieldBuilderType } from \"./field-builders\";\n// import { z } from \"zod/v4\";\n\n/**\n * Extract the output type from a FieldBuilder.\n * This is what you get when reading from the database.\n *\n * This type extracts the TOutput type parameter, which is set by readValidator()\n * and represents the transformed/validated output type.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\nexport type InferFieldOutput<F> = F extends FieldBuilder<infer TOutput, any, any, any> ? TOutput : never;\n\n/**\n * Extract the input type from a FieldBuilder.\n * This is what you pass when writing to the database.\n *\n * This type extracts the TInput type parameter, which is set by writeValidator()\n * and represents the transformed/validated input type.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\ntype InferFieldInput<F> = F extends FieldBuilder<any, infer TInput, any, any> ? TInput : never;\n\n/**\n * Build a schema type from field builders (output/read types).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype InferSchemaFromFields<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in keyof TFields]: InferFieldOutput<TFields[K]>;\n};\n\n/**\n * Build an input schema type from field builders (input/write types).\n * Used for insert and update operations.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype InferInputSchemaFromFields<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in keyof TFields]: InferFieldInput<TFields[K]>;\n};\n\n/**\n * Check if a field is a container field by inspecting its TDbType.\n * Container fields have a branded TDbType that extends ContainerDbType.\n */\ntype IsContainerField<F> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  F extends FieldBuilder<any, any, infer TDbType, any>\n    ? NonNullable<TDbType> extends ContainerDbType\n      ? true\n      : false\n    : false;\n\n/**\n * Extract only selectable (non-container) field keys from a fields record.\n * Container fields are excluded because they cannot be selected via $select in FileMaker OData.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype SelectableFieldKeys<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in keyof TFields]: IsContainerField<TFields[K]> extends true ? never : K;\n}[keyof TFields];\n\n/**\n * Build a schema type excluding container fields (for query return types).\n * This is used to ensure container fields don't appear in the return type\n * when using defaultSelect: \"schema\" or \"all\".\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\ntype _InferSelectableSchemaFromFields<TFields extends Record<string, FieldBuilder<any, any, any, any>>> = {\n  [K in SelectableFieldKeys<TFields>]: InferFieldOutput<TFields[K]>;\n};\n\n/**\n * Internal Symbols for table properties (hidden from IDE autocomplete).\n * These are used to store internal configuration that shouldn't be visible\n * when users access table columns.\n * @internal - Not exported from public API, only accessible via FMTable.Symbol\n */\nconst FMTableName = Symbol.for(\"fmodata:FMTableName\");\nconst FMTableEntityId = Symbol.for(\"fmodata:FMTableEntityId\");\nconst FMTableSchema = Symbol.for(\"fmodata:FMTableSchema\");\nconst FMTableFields = Symbol.for(\"fmodata:FMTableFields\");\nconst FMTableNavigationPaths = Symbol.for(\"fmodata:FMTableNavigationPaths\");\nconst FMTableDefaultSelect = Symbol.for(\"fmodata:FMTableDefaultSelect\");\nconst FMTableBaseTableConfig = Symbol.for(\"fmodata:FMTableBaseTableConfig\");\nconst FMTableUseEntityIds = Symbol.for(\"fmodata:FMTableUseEntityIds\");\nconst FMTableComment = Symbol.for(\"fmodata:FMTableComment\");\n\n/**\n * Base table class with Symbol-based internal properties.\n * This follows the Drizzle ORM pattern where internal configuration\n * is stored via Symbols, keeping it hidden from IDE autocomplete.\n */\nexport class FMTable<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration, default allows untyped tables\n  TFields extends Record<string, FieldBuilder<any, any, any, any>> = any,\n  TName extends string = string,\n  TNavigationPaths extends readonly string[] = readonly string[],\n> {\n  /**\n   * Internal Symbols for accessing table metadata.\n   * @internal - Not intended for public use. Access table properties via columns instead.\n   */\n  static readonly Symbol = {\n    Name: FMTableName,\n    EntityId: FMTableEntityId,\n    UseEntityIds: FMTableUseEntityIds,\n    Schema: FMTableSchema,\n    Fields: FMTableFields,\n    NavigationPaths: FMTableNavigationPaths,\n    DefaultSelect: FMTableDefaultSelect,\n    BaseTableConfig: FMTableBaseTableConfig,\n    Comment: FMTableComment,\n  };\n\n  /** @internal */\n  [FMTableName]: TName;\n\n  /** @internal */\n  [FMTableEntityId]?: `FMTID:${string}`;\n\n  /** @internal */\n  [FMTableUseEntityIds]?: boolean;\n\n  /** @internal */\n  [FMTableComment]?: string;\n\n  /** @internal */\n  [FMTableSchema]: Partial<Record<keyof TFields, StandardSchemaV1>>;\n\n  /** @internal */\n  [FMTableFields]: TFields;\n\n  /** @internal */\n  [FMTableNavigationPaths]: TNavigationPaths;\n\n  /** @internal */\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  [FMTableDefaultSelect]: \"all\" | \"schema\" | Record<string, Column<any, any, TName>>;\n\n  /** @internal */\n  [FMTableBaseTableConfig]: {\n    schema: Partial<Record<keyof TFields, StandardSchemaV1>>;\n    inputSchema?: Partial<Record<keyof TFields, StandardSchemaV1>>;\n    idField?: keyof TFields;\n    required: readonly (keyof TFields)[];\n    readOnly: readonly (keyof TFields)[];\n    containerFields: readonly (keyof TFields)[];\n    fmfIds?: Record<keyof TFields, `FMFID:${string}`>;\n  };\n\n  constructor(config: {\n    name: TName;\n    entityId?: `FMTID:${string}`;\n    useEntityIds?: boolean;\n    comment?: string;\n    schema: Partial<Record<keyof TFields, StandardSchemaV1>>;\n    fields: TFields;\n    navigationPaths: TNavigationPaths;\n    // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n    defaultSelect: \"all\" | \"schema\" | Record<string, Column<any, any, TName>>;\n    baseTableConfig: {\n      schema: Partial<Record<keyof TFields, StandardSchemaV1>>;\n      inputSchema?: Partial<Record<keyof TFields, StandardSchemaV1>>;\n      idField?: keyof TFields;\n      required: readonly (keyof TFields)[];\n      readOnly: readonly (keyof TFields)[];\n      containerFields: readonly (keyof TFields)[];\n      fmfIds?: Record<keyof TFields, `FMFID:${string}`>;\n    };\n  }) {\n    this[FMTableName] = config.name;\n    this[FMTableEntityId] = config.entityId;\n    this[FMTableUseEntityIds] = config.useEntityIds;\n    this[FMTableComment] = config.comment;\n    this[FMTableSchema] = config.schema;\n    this[FMTableFields] = config.fields;\n    this[FMTableNavigationPaths] = config.navigationPaths;\n    this[FMTableDefaultSelect] = config.defaultSelect;\n    this[FMTableBaseTableConfig] = config.baseTableConfig;\n  }\n}\n\n/**\n * Type helper to extract the column map from fields.\n * Table name is baked into each column type for validation.\n * Container fields are marked with IsContainer=true.\n * Columns include both output type (for reading) and input type (for writing/filtering).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\nexport type ColumnMap<TFields extends Record<string, FieldBuilder<any, any, any, any>>, TName extends string> = {\n  [K in keyof TFields]: Column<\n    InferFieldOutput<TFields[K]>,\n    InferFieldInput<TFields[K]>,\n    TName,\n    IsContainerField<TFields[K]>\n  >;\n};\n\n/**\n * Extract only selectable (non-container) columns from a table.\n * This is used to prevent selecting container fields in queries.\n */\nexport type SelectableColumnMap<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n> = {\n  [K in SelectableFieldKeys<TFields>]: Column<InferFieldOutput<TFields[K]>, InferFieldInput<TFields[K]>, TName, false>;\n};\n\n/**\n * Validates that a select object doesn't contain container field columns.\n * Returns never if any container fields are found, otherwise returns the original type.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\nexport type ValidateNoContainerFields<TSelect extends Record<string, Column<any, any, any, any>>> = {\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  [K in keyof TSelect]: TSelect[K] extends Column<any, any, any, true> ? never : TSelect[K];\n} extends TSelect\n  ? TSelect\n  : {\n      // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n      [K in keyof TSelect]: TSelect[K] extends Column<any, any, any, true>\n        ? \"❌ Container fields cannot be selected. Use .getSingleField() instead.\"\n        : TSelect[K];\n    };\n\n/**\n * Extract the keys from a defaultSelect function's return type.\n * Used to infer which fields are selected by default for type narrowing.\n */\ntype _ExtractDefaultSelectKeys<\n  TDefaultSelect,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n> = TDefaultSelect extends (columns: ColumnMap<TFields, TName>) => infer R\n  ? keyof R\n  : TDefaultSelect extends \"schema\"\n    ? keyof TFields\n    : keyof TFields; // \"all\" defaults to all keys\n\n/**\n * Complete table type with both metadata (via Symbols) and column accessors.\n * This is the return type of fmTableOccurrence - users see columns directly,\n * but internal config is hidden via Symbols.\n */\nexport type FMTableWithColumns<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n  TNavigationPaths extends readonly string[] = readonly string[],\n> = FMTable<TFields, TName, TNavigationPaths> & ColumnMap<TFields, TName>;\n\n/**\n * Options for fmTableOccurrence function.\n * Provides autocomplete-friendly typing while preserving inference for navigationPaths.\n */\nexport interface FMTableOccurrenceOptions<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  TName extends string,\n> {\n  /** The entity ID (FMTID) for this table occurrence */\n  entityId?: `FMTID:${string}`;\n\n  /** The comment for this table */\n  comment?: string;\n\n  /**\n   * Default select behavior:\n   * - \"all\": Select all fields (including related tables)\n   * - \"schema\": Select only schema-defined fields (default)\n   * - function: Custom selection from columns\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  defaultSelect?: \"all\" | \"schema\" | ((columns: ColumnMap<TFields, TName>) => Record<string, Column<any, any, TName>>);\n\n  /** Navigation paths available from this table (for expand operations) */\n  navigationPaths?: readonly string[];\n\n  /** Whether to use entity IDs (FMTID/FMFID) instead of names in queries */\n  useEntityIds?: boolean;\n}\n\n/**\n * Create a table occurrence with field builders.\n * This is the main API for defining tables in the new ORM style.\n *\n * @example\n * const users = fmTableOccurrence(\"users\", {\n *   id: textField().primaryKey().entityId(\"FMFID:1\"),\n *   name: textField().notNull().entityId(\"FMFID:6\"),\n *   active: numberField()\n *     .outputValidator(z.coerce.boolean())\n *     .inputValidator(z.boolean().transform(v => v ? 1 : 0))\n *     .entityId(\"FMFID:7\"),\n * }, {\n *   entityId: \"FMTID:100\",\n *   defaultSelect: \"schema\",\n *   navigationPaths: [\"contacts\"],\n * });\n *\n * // Access columns\n * users.id    // Column<string, \"id\">\n * users.name  // Column<string, \"name\">\n *\n * // Use in queries\n * db.from(users).select(\"id\", \"name\").where(eq(users.active, true))\n */\nexport function fmTableOccurrence<\n  const TName extends string,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any FieldBuilder configuration\n  const TFields extends Record<string, FieldBuilder<any, any, any, any>>,\n  const TNavPaths extends readonly string[] = readonly [],\n>(\n  name: TName,\n  fields: TFields,\n  options?: FMTableOccurrenceOptions<TFields, TName> & {\n    /** Navigation paths available from this table (for expand operations) */\n    navigationPaths?: TNavPaths;\n  },\n): FMTableWithColumns<TFields, TName, TNavPaths> {\n  // Extract configuration from field builders\n  const fieldConfigs = Object.entries(fields).map(([fieldName, builder]) => ({\n    fieldName,\n    // biome-ignore lint/suspicious/noExplicitAny: Internal property access for builder pattern\n    config: (builder as any)._getConfig(),\n  }));\n\n  // Find primary key field\n  const primaryKeyField = fieldConfigs.find((f) => f.config.primaryKey);\n  const idField = primaryKeyField?.fieldName;\n\n  // Collect required fields (notNull fields)\n  const required = fieldConfigs.filter((f) => f.config.notNull).map((f) => f.fieldName);\n\n  // Collect read-only fields\n  const readOnly = fieldConfigs.filter((f) => f.config.readOnly).map((f) => f.fieldName);\n\n  // Collect container fields (cannot be selected via $select)\n  const containerFields = fieldConfigs.filter((f) => f.config.fieldType === \"container\").map((f) => f.fieldName);\n\n  // Collect entity IDs\n  const fmfIds: Record<string, `FMFID:${string}`> = {};\n  for (const { fieldName, config } of fieldConfigs) {\n    if (config.entityId) {\n      fmfIds[fieldName] = config.entityId;\n    }\n  }\n\n  // Build Zod schema from field builders (output/read validators)\n  const outputSchema: Partial<Record<keyof TFields, StandardSchemaV1>> = {};\n  // Build input schema from field builders (input/write validators)\n  const inputSchema: Record<string, StandardSchemaV1> = {};\n\n  for (const { fieldName, config } of fieldConfigs) {\n    // Use outputValidator if provided\n    if (config.outputValidator) {\n      outputSchema[fieldName as keyof TFields] = config.outputValidator;\n    }\n\n    // Store inputValidator if provided (for write operations)\n    if (config.inputValidator) {\n      inputSchema[fieldName] = config.inputValidator;\n    }\n  }\n\n  // Build BaseTable-compatible config\n  const baseTableConfig = {\n    schema: outputSchema as Partial<Record<keyof TFields, StandardSchemaV1>>,\n    inputSchema:\n      Object.keys(inputSchema).length > 0\n        ? (inputSchema as Partial<Record<keyof TFields, StandardSchemaV1>>)\n        : undefined,\n    idField: idField as keyof TFields | undefined,\n    required: required as readonly (keyof TFields)[],\n    readOnly: readOnly as readonly (keyof TFields)[],\n    containerFields: containerFields as readonly (keyof TFields)[],\n    fmfIds: (Object.keys(fmfIds).length > 0 ? fmfIds : undefined) as\n      | Record<keyof TFields, `FMFID:${string}`>\n      | undefined,\n  };\n\n  // Create column instances\n  const columns = {} as ColumnMap<TFields, TName>;\n  for (const [fieldName, builder] of Object.entries(fields)) {\n    // biome-ignore lint/suspicious/noExplicitAny: Internal property access for builder pattern\n    const config = (builder as any)._getConfig();\n    // biome-ignore lint/suspicious/noExplicitAny: Mutation of readonly properties for builder pattern\n    (columns as any)[fieldName] = new Column({\n      fieldName: String(fieldName),\n      entityId: config.entityId,\n      tableName: name,\n      tableEntityId: options?.entityId,\n      inputValidator: config.inputValidator,\n    });\n  }\n\n  // Resolve defaultSelect: if it's a function, call it with columns; otherwise use as-is\n  const defaultSelectOption = options?.defaultSelect ?? \"schema\";\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any Column configuration\n  const resolvedDefaultSelect: \"all\" | \"schema\" | Record<string, Column<any, any, TName>> =\n    typeof defaultSelectOption === \"function\"\n      ? defaultSelectOption(columns as ColumnMap<TFields, TName>)\n      : defaultSelectOption;\n\n  // Create the FMTable instance with Symbol-based internal properties\n  const navigationPaths = (options?.navigationPaths ?? []) as TNavPaths;\n  const table = new FMTable<TFields, TName, TNavPaths>({\n    name,\n    entityId: options?.entityId,\n    useEntityIds: options?.useEntityIds,\n    comment: options?.comment,\n    schema: outputSchema,\n    fields,\n    navigationPaths,\n    defaultSelect: resolvedDefaultSelect,\n    baseTableConfig,\n  });\n\n  // Assign columns to the table instance (making them accessible directly)\n  Object.assign(table, columns);\n\n  return table as FMTableWithColumns<TFields, TName, TNavPaths>;\n}\n\n// /**\n//  * Type guard to check if a value is a TableOccurrence or FMTable.\n//  * Supports both Symbol-based (new) and underscore-prefixed (legacy) formats.\n//  */\n// function isTableOccurrence(value: any): value is TableOccurrence {\n//   if (!value || typeof value !== \"object\") {\n//     return false;\n//   }\n\n//   // Check for Symbol-based format (new FMTable class)\n//   if (\n//     FMTableName in value &&\n//     FMTableSchema in value &&\n//     FMTableFields in value\n//   ) {\n//     return typeof value[FMTableName] === \"string\";\n//   }\n\n//   // Check for underscore-prefixed format (legacy interface)\n//   if (\"_name\" in value && \"_schema\" in value && \"_fields\" in value) {\n//     return typeof value._name === \"string\";\n//   }\n\n//   return false;\n// }\n\n/**\n * Helper to extract the schema type from a TableOccurrence or FMTable.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\nexport type InferTableSchema<T> = T extends FMTable<infer TFields, any> ? InferSchemaFromFields<TFields> : never;\n\n/**\n * Extract the schema type from an FMTable instance.\n * This is used to infer the schema from table objects passed to db.from(), expand(), etc.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type InferSchemaOutputFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any> ? InferSchemaFromFields<TFields> : never;\n\n/**\n * Extract the input schema type from an FMTable instance.\n * This is used for insert and update operations where we need write types.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type InferInputSchemaFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any> ? InferInputSchemaFromFields<TFields> : never;\n\n/**\n * Helper type to check if a FieldBuilder's input type excludes null and undefined.\n * This checks the TInput type parameter, which preserves nullability from notNull().\n */\ntype FieldInputExcludesNullish<F> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  F extends FieldBuilder<any, infer TInput, any>\n    ? null extends TInput\n      ? false\n      : undefined extends TInput\n        ? false\n        : true\n    : false;\n\n/**\n * Check if a FieldBuilder is readOnly at the type level\n */\ntype IsFieldReadOnly<F> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  F extends FieldBuilderType<any, any, any, infer ReadOnly> ? (ReadOnly extends true ? true : false) : false;\n\n/**\n * Compute insert data type from FMTable, making notNull fields required.\n * Fields are required if their FieldBuilder's TInput type excludes null/undefined.\n * All other fields are optional (can be omitted).\n * readOnly fields are excluded (including primaryKey/idField since they're automatically readOnly).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type InsertDataFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any>\n    ? {\n        [K in keyof TFields as IsFieldReadOnly<TFields[K]> extends true\n          ? never\n          : FieldInputExcludesNullish<TFields[K]> extends true\n            ? K\n            : never]: InferFieldInput<TFields[K]>;\n      } & {\n        [K in keyof TFields as IsFieldReadOnly<TFields[K]> extends true\n          ? never\n          : FieldInputExcludesNullish<TFields[K]> extends true\n            ? never\n            : K]?: InferFieldInput<TFields[K]>;\n      }\n    : never;\n\n/**\n * Compute update data type from FMTable.\n * All fields are optional, but readOnly fields are excluded (including primaryKey/idField).\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport type UpdateDataFromFMTable<T extends FMTable<any, any>> =\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  T extends FMTable<infer TFields, any>\n    ? {\n        [K in keyof TFields as IsFieldReadOnly<TFields[K]> extends true ? never : K]?: InferFieldInput<TFields[K]>;\n      }\n    : never;\n\n/**\n * Extract the table name type from an FMTable.\n * This is a workaround since we can't directly index Symbols in types.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration, required for type inference with infer\nexport type ExtractTableName<T extends FMTable<any, any>> = T extends FMTable<any, infer Name> ? Name : never;\n\n/**\n * Validates that a target table's name matches one of the source table's navigationPaths.\n * Used to ensure type-safe expand/navigate operations.\n */\nexport type ValidExpandTarget<\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  SourceTable extends FMTable<any, any, any> | undefined,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  TargetTable extends FMTable<any, any, any>,\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n> = SourceTable extends FMTable<any, any, infer SourceNavPaths>\n  ? ExtractTableName<TargetTable> extends SourceNavPaths[number]\n    ? TargetTable\n    : never\n  : TargetTable;\n\n// ============================================================================\n// Helper Functions for Accessing FMTable Internal Properties\n// ============================================================================\n\n/**\n * Get the table name from an FMTable instance.\n * @param table - FMTable instance\n * @returns The table name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableName<T extends FMTable<any, any>>(table: T): string {\n  return table[FMTableName];\n}\n\n/**\n * Get the entity ID (FMTID) from an FMTable instance.\n * @param table - FMTable instance\n * @returns The entity ID or undefined if not using entity IDs\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableEntityId<T extends FMTable<any, any>>(table: T): string | undefined {\n  return table[FMTableEntityId];\n}\n\n/**\n * Get the schema validator from an FMTable instance.\n * @param table - FMTable instance\n * @returns The StandardSchemaV1 validator record (partial - only fields with validators)\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableSchema<T extends FMTable<any, any>>(\n  table: T,\n): Partial<Record<keyof T[typeof FMTableFields], StandardSchemaV1>> {\n  return table[FMTableSchema];\n}\n\n/**\n * Get the fields from an FMTable instance.\n * @param table - FMTable instance\n * @returns The fields record\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableFields<T extends FMTable<any, any>>(table: T) {\n  return table[FMTableFields];\n}\n\n/**\n * Get the navigation paths from an FMTable instance.\n * @param table - FMTable instance\n * @returns Array of navigation path names\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getNavigationPaths<T extends FMTable<any, any>>(table: T): readonly string[] {\n  return table[FMTableNavigationPaths];\n}\n\n/**\n * Get the default select configuration from an FMTable instance.\n * @param table - FMTable instance\n * @returns Default select configuration\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getDefaultSelect<T extends FMTable<any, any>>(table: T) {\n  return table[FMTableDefaultSelect];\n}\n\n/**\n * Get the base table configuration from an FMTable instance.\n * This provides access to schema, idField, required fields, readOnly fields, and field IDs.\n * @param table - FMTable instance\n * @returns Base table configuration object\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getBaseTableConfig<T extends FMTable<any, any>>(table: T) {\n  return table[FMTableBaseTableConfig];\n}\n\n/**\n * Check if an FMTable instance is using entity IDs (both FMTID and FMFIDs).\n * @param table - FMTable instance\n * @returns True if using entity IDs, false otherwise\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function isUsingEntityIds<T extends FMTable<any, any>>(table: T): boolean {\n  return table[FMTableEntityId] !== undefined && table[FMTableBaseTableConfig].fmfIds !== undefined;\n}\n\n/**\n * Get the field ID (FMFID) for a given field name, or the field name itself if not using IDs.\n * @param table - FMTable instance\n * @param fieldName - Field name to get the ID for\n * @returns The FMFID string or the original field name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getFieldId<T extends FMTable<any, any>>(table: T, fieldName: string): string {\n  const config = table[FMTableBaseTableConfig];\n  if (config.fmfIds && fieldName in config.fmfIds) {\n    const fieldId = config.fmfIds[fieldName];\n    if (fieldId) {\n      return fieldId;\n    }\n  }\n  return fieldName;\n}\n\n/**\n * Get the field name for a given field ID (FMFID), or the ID itself if not found.\n * @param table - FMTable instance\n * @param fieldId - The FMFID to get the field name for\n * @returns The field name or the original ID\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getFieldName<T extends FMTable<any, any>>(table: T, fieldId: string): string {\n  const config = table[FMTableBaseTableConfig];\n  if (config.fmfIds) {\n    for (const [fieldName, fmfId] of Object.entries(config.fmfIds)) {\n      if (fmfId === fieldId) {\n        return fieldName;\n      }\n    }\n  }\n  return fieldId;\n}\n/**\n * Get the table ID (FMTID or name) from an FMTable instance.\n * Returns the FMTID if available, otherwise returns the table name.\n * @param table - FMTable instance\n * @returns The FMTID string or the table name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableId<T extends FMTable<any, any>>(table: T): string {\n  return table[FMTableEntityId] ?? table[FMTableName];\n}\n\n/**\n * Get the comment from an FMTable instance.\n * @param table - FMTable instance\n * @returns The comment string or undefined if not set\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableComment<T extends FMTable<any, any>>(table: T): string | undefined {\n  return table[FMTableComment];\n}\n\n/**\n * Get all columns from a table as an object.\n * Useful for selecting all fields except some using destructuring.\n *\n * @example\n * const { password, ...cols } = getTableColumns(users)\n * db.from(users).list().select(cols)\n *\n * @param table - FMTable instance\n * @returns Object with all columns from the table\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableColumns<T extends FMTable<any, any>>(\n  table: T,\n): ColumnMap<T[typeof FMTableFields], ExtractTableName<T>> {\n  const fields = table[FMTableFields];\n  const tableName = table[FMTableName];\n  const tableEntityId = table[FMTableEntityId];\n  const baseConfig = table[FMTableBaseTableConfig];\n\n  const columns = {} as ColumnMap<T[typeof FMTableFields], ExtractTableName<T>>;\n  for (const [fieldName, builder] of Object.entries(fields)) {\n    // biome-ignore lint/suspicious/noExplicitAny: Internal property access for builder pattern\n    const config = (builder as any)._getConfig();\n    // biome-ignore lint/suspicious/noExplicitAny: Mutation of readonly properties for builder pattern\n    (columns as any)[fieldName] = new Column({\n      fieldName: String(fieldName),\n      entityId: baseConfig.fmfIds?.[fieldName],\n      tableName,\n      tableEntityId,\n      inputValidator: config.inputValidator,\n    });\n  }\n\n  return columns;\n}\n"],"names":["_a"],"mappings":";;;;;AA+EA,MAAM,cAAc,OAAO,IAAI,qBAAqB;AACpD,MAAM,kBAAkB,OAAO,IAAI,yBAAyB;AAC5D,MAAM,gBAAgB,OAAO,IAAI,uBAAuB;AACxD,MAAM,gBAAgB,OAAO,IAAI,uBAAuB;AACxD,MAAM,yBAAyB,OAAO,IAAI,gCAAgC;AAC1E,MAAM,uBAAuB,OAAO,IAAI,8BAA8B;AACtE,MAAM,yBAAyB,OAAO,IAAI,gCAAgC;AAC1E,MAAM,sBAAsB,OAAO,IAAI,6BAA6B;AACpE,MAAM,iBAAiB,OAAO,IAAI,wBAAwB;AA8BvD,kBAGA,sBAGA,0BAGA,qBAGA,oBAGA,oBAGA,6BAIA,2BAGA;AAhDI,MAAM,QAKX;AAAA,EAqDA,YAAY,QAmBT;AAtDH;AAAA,wBAAC;AAGD;AAAA,wBAAC;AAGD;AAAA,wBAAC;AAGD;AAAA,wBAAC;AAGD;AAAA,wBAAC;AAGD;AAAA,wBAAC;AAGD;AAAA,wBAAC;AAID;AAAA;AAAA,wBAAC;AAGD;AAAA,wBAAC;AA8BC,SAAK,WAAW,IAAI,OAAO;AAC3B,SAAK,eAAe,IAAI,OAAO;AAC/B,SAAK,mBAAmB,IAAI,OAAO;AACnC,SAAK,cAAc,IAAI,OAAO;AAC9B,SAAK,aAAa,IAAI,OAAO;AAC7B,SAAK,aAAa,IAAI,OAAO;AAC7B,SAAK,sBAAsB,IAAI,OAAO;AACtC,SAAK,oBAAoB,IAAI,OAAO;AACpC,SAAK,sBAAsB,IAAI,OAAO;AAAA,EACxC;AACF;AAAA;AAAA;AAAA;AAAA;AA9EE,cAVW,SAUK,UAAS;AAAA,EACvB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,SAAS;AAAA;AAuMN,SAAS,kBAMd,MACA,QACA,SAI+C;AAE/C,QAAM,eAAe,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,WAAW,OAAO,OAAO;AAAA,IACzE;AAAA;AAAA,IAEA,QAAS,QAAgB,WAAA;AAAA,EAAW,EACpC;AAGF,QAAM,kBAAkB,aAAa,KAAK,CAAC,MAAM,EAAE,OAAO,UAAU;AACpE,QAAM,UAAU,mDAAiB;AAGjC,QAAM,WAAW,aAAa,OAAO,CAAC,MAAM,EAAE,OAAO,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS;AAGpF,QAAM,WAAW,aAAa,OAAO,CAAC,MAAM,EAAE,OAAO,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS;AAGrF,QAAM,kBAAkB,aAAa,OAAO,CAAC,MAAM,EAAE,OAAO,cAAc,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS;AAG7G,QAAM,SAA4C,CAAA;AAClD,aAAW,EAAE,WAAW,OAAA,KAAY,cAAc;AAChD,QAAI,OAAO,UAAU;AACnB,aAAO,SAAS,IAAI,OAAO;AAAA,IAC7B;AAAA,EACF;AAGA,QAAM,eAAiE,CAAA;AAEvE,QAAM,cAAgD,CAAA;AAEtD,aAAW,EAAE,WAAW,OAAA,KAAY,cAAc;AAEhD,QAAI,OAAO,iBAAiB;AAC1B,mBAAa,SAA0B,IAAI,OAAO;AAAA,IACpD;AAGA,QAAI,OAAO,gBAAgB;AACzB,kBAAY,SAAS,IAAI,OAAO;AAAA,IAClC;AAAA,EACF;AAGA,QAAM,kBAAkB;AAAA,IACtB,QAAQ;AAAA,IACR,aACE,OAAO,KAAK,WAAW,EAAE,SAAS,IAC7B,cACD;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAS,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AAAA,EAAA;AAMrD,QAAM,UAAU,CAAA;AAChB,aAAW,CAAC,WAAW,OAAO,KAAK,OAAO,QAAQ,MAAM,GAAG;AAEzD,UAAM,SAAU,QAAgB,WAAA;AAE/B,YAAgB,SAAS,IAAI,IAAI,OAAO;AAAA,MACvC,WAAW,OAAO,SAAS;AAAA,MAC3B,UAAU,OAAO;AAAA,MACjB,WAAW;AAAA,MACX,eAAe,mCAAS;AAAA,MACxB,gBAAgB,OAAO;AAAA,IAAA,CACxB;AAAA,EACH;AAGA,QAAM,uBAAsB,mCAAS,kBAAiB;AAEtD,QAAM,wBACJ,OAAO,wBAAwB,aAC3B,oBAAoB,OAAoC,IACxD;AAGN,QAAM,mBAAmB,mCAAS,oBAAmB,CAAA;AACrD,QAAM,QAAQ,IAAI,QAAmC;AAAA,IACnD;AAAA,IACA,UAAU,mCAAS;AAAA,IACnB,cAAc,mCAAS;AAAA,IACvB,SAAS,mCAAS;AAAA,IAClB,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf;AAAA,EAAA,CACD;AAGD,SAAO,OAAO,OAAO,OAAO;AAE5B,SAAO;AACT;AAgJO,SAAS,aAA0C,OAAkB;AAC1E,SAAO,MAAM,WAAW;AAC1B;AAkBO,SAAS,eACd,OACkE;AAClE,SAAO,MAAM,aAAa;AAC5B;AAkBO,SAAS,mBAAgD,OAA6B;AAC3F,SAAO,MAAM,sBAAsB;AACrC;AAQO,SAAS,iBAA8C,OAAU;AACtE,SAAO,MAAM,oBAAoB;AACnC;AASO,SAAS,mBAAgD,OAAU;AACxE,SAAO,MAAM,sBAAsB;AACrC;AAQO,SAAS,iBAA8C,OAAmB;AAC/E,SAAO,MAAM,eAAe,MAAM,UAAa,MAAM,sBAAsB,EAAE,WAAW;AAC1F;AASO,SAAS,WAAwC,OAAU,WAA2B;AAC3F,QAAM,SAAS,MAAM,sBAAsB;AAC3C,MAAI,OAAO,UAAU,aAAa,OAAO,QAAQ;AAC/C,UAAM,UAAU,OAAO,OAAO,SAAS;AACvC,QAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AASO,SAAS,aAA0C,OAAU,SAAyB;AAC3F,QAAM,SAAS,MAAM,sBAAsB;AAC3C,MAAI,OAAO,QAAQ;AACjB,eAAW,CAAC,WAAW,KAAK,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAC9D,UAAI,UAAU,SAAS;AACrB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAQO,SAAS,WAAwC,OAAkB;AACxE,SAAO,MAAM,eAAe,KAAK,MAAM,WAAW;AACpD;AAwBO,SAAS,gBACd,OACyD;;AACzD,QAAM,SAAS,MAAM,aAAa;AAClC,QAAM,YAAY,MAAM,WAAW;AACnC,QAAM,gBAAgB,MAAM,eAAe;AAC3C,QAAM,aAAa,MAAM,sBAAsB;AAE/C,QAAM,UAAU,CAAA;AAChB,aAAW,CAAC,WAAW,OAAO,KAAK,OAAO,QAAQ,MAAM,GAAG;AAEzD,UAAM,SAAU,QAAgB,WAAA;AAE/B,YAAgB,SAAS,IAAI,IAAI,OAAO;AAAA,MACvC,WAAW,OAAO,SAAS;AAAA,MAC3B,WAAUA,MAAA,WAAW,WAAX,gBAAAA,IAAoB;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,gBAAgB,OAAO;AAAA,IAAA,CACxB;AAAA,EACH;AAEA,SAAO;AACT;"}

package/dist/esm/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sources":["../../src/transform.ts"],"sourcesContent":["import type { FMTable } from \"./orm/table\";\nimport { getBaseTableConfig, getFieldId, getFieldName, getTableId, getTableName, isUsingEntityIds } from \"./orm/table\";\n\nconst WHITESPACE_SPLIT_REGEX = /\\s+/;\n\n/**\n * Transforms field names to FileMaker field IDs (FMFID) in an object\n * @param data - Object with field names as keys\n * @param table - FMTable instance to get field IDs from\n * @returns Object with FMFID keys instead of field names\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\nexport function transformFieldNamesToIds<T extends Record<string, any>>(\n  data: T,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n): Record<string, any> {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return data;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n  const transformed: Record<string, any> = {};\n  for (const [fieldName, value] of Object.entries(data)) {\n    const fieldId = getFieldId(table, fieldName);\n    transformed[fieldId] = value;\n  }\n  return transformed;\n}\n\n/**\n * Transforms FileMaker field IDs (FMFID) to field names in an object\n * @param data - Object with FMFID keys\n * @param table - FMTable instance to get field names from\n * @returns Object with field names as keys instead of FMFIDs\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\nexport function transformFieldIdsToNames<T extends Record<string, any>>(\n  data: T,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n): Record<string, any> {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return data;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n  const transformed: Record<string, any> = {};\n  for (const [key, value] of Object.entries(data)) {\n    // Check if this is an OData metadata field (starts with @)\n    if (key.startsWith(\"@\")) {\n      transformed[key] = value;\n      continue;\n    }\n\n    const fieldName = getFieldName(table, key);\n    transformed[fieldName] = value;\n  }\n  return transformed;\n}\n\n/**\n * Transforms a field name to FMFID or returns the field name if not using IDs\n * @param fieldName - The field name to transform\n * @param table - FMTable instance to get field ID from\n * @returns The FMFID or field name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformFieldName(fieldName: string, table: FMTable<any, any>): string {\n  return getFieldId(table, fieldName);\n}\n\n/**\n * Transforms a table name to FMTID or returns the name if not using IDs\n * @param table - FMTable instance to get table ID from\n * @returns The FMTID or table name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformTableName(table: FMTable<any, any>): string {\n  return getTableId(table);\n}\n\n/**\n * Gets both table name and ID from a table\n * @param table - FMTable instance\n * @returns Object with name (always present) and id (may be undefined if not using IDs)\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableIdentifiers(table: FMTable<any, any>): { name: string; id: string | undefined } {\n  return {\n    name: getTableName(table),\n    id: isUsingEntityIds(table) ? getTableId(table) : undefined,\n  };\n}\n\n/**\n * Transforms response data by converting field IDs back to field names recursively.\n * Handles both single records and arrays of records, as well as nested expand relationships.\n *\n * @param data - Response data from FileMaker (can be single record, array, or wrapped in value property)\n * @param table - FMTable instance for the main table\n * @param expandConfigs - Configuration for expanded relations (optional)\n * @returns Transformed data with field names instead of IDs\n */\nexport function transformResponseFields(\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic response data transformation\n  data: any,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  expandConfigs?: Array<{\n    relation: string;\n    // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n    table?: FMTable<any, any>;\n  }>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic response data transformation\n): any {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return data;\n  }\n\n  // Handle null/undefined\n  if (data === null || data === undefined) {\n    return data;\n  }\n\n  // Handle OData list response with value array\n  if (data.value && Array.isArray(data.value)) {\n    return {\n      ...data,\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic record transformation\n      value: data.value.map((record: any) => transformSingleRecord(record, table, expandConfigs)),\n    };\n  }\n\n  // Handle array of records\n  if (Array.isArray(data)) {\n    return data.map((record) => transformSingleRecord(record, table, expandConfigs));\n  }\n\n  // Handle single record\n  return transformSingleRecord(data, table, expandConfigs);\n}\n\n/**\n * Transforms a single record, converting field IDs to names and handling nested expands\n */\nfunction transformSingleRecord(\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic record transformation\n  record: any,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  expandConfigs?: Array<{\n    relation: string;\n    // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n    table?: FMTable<any, any>;\n  }>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic record transformation\n): any {\n  if (!record || typeof record !== \"object\") {\n    return record;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n  const transformed: Record<string, any> = {};\n\n  for (const [key, value] of Object.entries(record)) {\n    // Preserve OData metadata fields\n    if (key.startsWith(\"@\")) {\n      transformed[key] = value;\n      continue;\n    }\n\n    // Check if this is an expanded relation (by relation name)\n    let expandConfig = expandConfigs?.find((ec) => ec.relation === key);\n\n    // If not found by relation name, check if this key is a FMTID\n    // (FileMaker returns expanded relations with FMTID keys when using entity IDs)\n    if (!expandConfig && key.startsWith(\"FMTID:\")) {\n      expandConfig = expandConfigs?.find(\n        (ec) => ec.table && isUsingEntityIds(ec.table) && getTableId(ec.table) === key,\n      );\n    }\n\n    if (expandConfig?.table) {\n      // Transform the expanded relation data recursively\n      // Use the relation name (not the FMTID) as the key\n      const relationKey = expandConfig.relation;\n\n      if (Array.isArray(value)) {\n        if (!expandConfig.table) {\n          transformed[relationKey] = value;\n          continue;\n        }\n        const nestedTable = expandConfig.table;\n        transformed[relationKey] = value.map((nestedRecord) =>\n          transformSingleRecord(\n            nestedRecord,\n            nestedTable,\n            undefined, // Don't pass nested expand configs for now\n          ),\n        );\n      } else if (value && typeof value === \"object\") {\n        if (!expandConfig.table) {\n          transformed[relationKey] = value;\n          continue;\n        }\n        transformed[relationKey] = transformSingleRecord(value, expandConfig.table, undefined);\n      } else {\n        transformed[relationKey] = value;\n      }\n      continue;\n    }\n\n    // Transform field ID to field name\n    const fieldName = getFieldName(table, key);\n    transformed[fieldName] = value;\n  }\n\n  return transformed;\n}\n\n/**\n * Transforms an array of field names to FMFIDs\n * @param fieldNames - Array of field names\n * @param table - FMTable instance to get field IDs from\n * @returns Array of FMFIDs or field names\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformFieldNamesArray(fieldNames: string[], table: FMTable<any, any>): string[] {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return fieldNames;\n  }\n\n  return fieldNames.map((fieldName) => getFieldId(table, fieldName));\n}\n\n/**\n * Transforms a field name in an orderBy string (e.g., \"name desc\" -> \"FMFID:1 desc\")\n * @param orderByString - The orderBy string (field name with optional asc/desc)\n * @param table - FMTable instance to get field ID from\n * @returns Transformed orderBy string with FMFID\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformOrderByField(orderByString: string, table: FMTable<any, any> | undefined): string {\n  if (!table) {\n    return orderByString;\n  }\n  const config = getBaseTableConfig(table);\n  if (!config?.fmfIds) {\n    return orderByString;\n  }\n\n  // Parse the orderBy string to extract field name and direction\n  const parts = orderByString.trim().split(WHITESPACE_SPLIT_REGEX);\n  const fieldName = parts[0];\n  if (!fieldName) {\n    return orderByString;\n  }\n  const direction = parts[1]; // \"asc\" or \"desc\" or undefined\n\n  const fieldId = getFieldId(table, fieldName);\n  return direction ? `${fieldId} ${direction}` : fieldId;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"transform.js","sources":["../../src/transform.ts"],"sourcesContent":["import type { FMTable } from \"./orm/table\";\nimport { getBaseTableConfig, getFieldId, getFieldName, getTableId, getTableName, isUsingEntityIds } from \"./orm/table\";\n\nconst WHITESPACE_SPLIT_REGEX = /\\s+/;\n\n/**\n * Transforms field names to FileMaker field IDs (FMFID) in an object\n * @param data - Object with field names as keys\n * @param table - FMTable instance to get field IDs from\n * @returns Object with FMFID keys instead of field names\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\nexport function transformFieldNamesToIds<T extends Record<string, any>>(\n  data: T,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n): Record<string, any> {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return data;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n  const transformed: Record<string, any> = {};\n  for (const [fieldName, value] of Object.entries(data)) {\n    const fieldId = getFieldId(table, fieldName);\n    transformed[fieldId] = value;\n  }\n  return transformed;\n}\n\n/**\n * Transforms FileMaker field IDs (FMFID) to field names in an object\n * @param data - Object with FMFID keys\n * @param table - FMTable instance to get field names from\n * @returns Object with field names as keys instead of FMFIDs\n */\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\nexport function transformFieldIdsToNames<T extends Record<string, any>>(\n  data: T,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n): Record<string, any> {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return data;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n  const transformed: Record<string, any> = {};\n  for (const [key, value] of Object.entries(data)) {\n    // Check if this is an OData metadata field (starts with @)\n    if (key.startsWith(\"@\")) {\n      transformed[key] = value;\n      continue;\n    }\n\n    const fieldName = getFieldName(table, key);\n    transformed[fieldName] = value;\n  }\n  return transformed;\n}\n\n/**\n * Transforms a field name to FMFID or returns the field name if not using IDs\n * @param fieldName - The field name to transform\n * @param table - FMTable instance to get field ID from\n * @returns The FMFID or field name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformFieldName(fieldName: string, table: FMTable<any, any>): string {\n  return getFieldId(table, fieldName);\n}\n\n/**\n * Transforms a table name to FMTID or returns the name if not using IDs\n * @param table - FMTable instance to get table ID from\n * @returns The FMTID or table name\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformTableName(table: FMTable<any, any>): string {\n  return getTableId(table);\n}\n\n/**\n * Gets both table name and ID from a table\n * @param table - FMTable instance\n * @returns Object with name (always present) and id (may be undefined if not using IDs)\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function getTableIdentifiers(table: FMTable<any, any>): { name: string; id: string | undefined } {\n  return {\n    name: getTableName(table),\n    id: isUsingEntityIds(table) ? getTableId(table) : undefined,\n  };\n}\n\n/**\n * Transforms response data by converting field IDs back to field names recursively.\n * Handles both single records and arrays of records, as well as nested expand relationships.\n *\n * @param data - Response data from FileMaker (can be single record, array, or wrapped in value property)\n * @param table - FMTable instance for the main table\n * @param expandConfigs - Configuration for expanded relations (optional)\n * @returns Transformed data with field names instead of IDs\n */\nexport function transformResponseFields(\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic response data transformation\n  data: any,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  expandConfigs?: Array<{\n    relation: string;\n    // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n    table?: FMTable<any, any>;\n  }>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic response data transformation\n): any {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return data;\n  }\n\n  // Handle null/undefined\n  if (data === null || data === undefined) {\n    return data;\n  }\n\n  // Handle OData list response with value array\n  if (data.value && Array.isArray(data.value)) {\n    return {\n      ...data,\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic record transformation\n      value: data.value.map((record: any) => transformSingleRecord(record, table, expandConfigs)),\n    };\n  }\n\n  // Handle array of records\n  if (Array.isArray(data)) {\n    return data.map((record) => transformSingleRecord(record, table, expandConfigs));\n  }\n\n  // Handle single record\n  return transformSingleRecord(data, table, expandConfigs);\n}\n\n/**\n * Transforms a single record, converting field IDs to names and handling nested expands\n */\nfunction transformSingleRecord(\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic record transformation\n  record: any,\n  // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n  table: FMTable<any, any>,\n  expandConfigs?: Array<{\n    relation: string;\n    // biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\n    table?: FMTable<any, any>;\n  }>,\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic record transformation\n): any {\n  if (!record || typeof record !== \"object\") {\n    return record;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Dynamic field transformation\n  const transformed: Record<string, any> = {};\n\n  for (const [key, value] of Object.entries(record)) {\n    // Preserve OData metadata fields\n    if (key.startsWith(\"@\")) {\n      transformed[key] = value;\n      continue;\n    }\n\n    // Check if this is an expanded relation (by relation name)\n    let expandConfig = expandConfigs?.find((ec) => ec.relation === key);\n\n    // If not found by relation name, check if this key is a FMTID\n    // (FileMaker returns expanded relations with FMTID keys when using entity IDs)\n    if (!expandConfig && key.startsWith(\"FMTID:\")) {\n      expandConfig = expandConfigs?.find(\n        (ec) => ec.table && isUsingEntityIds(ec.table) && getTableId(ec.table) === key,\n      );\n    }\n\n    if (expandConfig?.table) {\n      // Transform the expanded relation data recursively\n      // Use the relation name (not the FMTID) as the key\n      const relationKey = expandConfig.relation;\n\n      if (Array.isArray(value)) {\n        if (!expandConfig.table) {\n          transformed[relationKey] = value;\n          continue;\n        }\n        const nestedTable = expandConfig.table;\n        transformed[relationKey] = value.map((nestedRecord) =>\n          transformSingleRecord(\n            nestedRecord,\n            nestedTable,\n            undefined, // Don't pass nested expand configs for now\n          ),\n        );\n      } else if (value && typeof value === \"object\") {\n        if (!expandConfig.table) {\n          transformed[relationKey] = value;\n          continue;\n        }\n        transformed[relationKey] = transformSingleRecord(value, expandConfig.table, undefined);\n      } else {\n        transformed[relationKey] = value;\n      }\n      continue;\n    }\n\n    // Transform field ID to field name\n    const fieldName = getFieldName(table, key);\n    transformed[fieldName] = value;\n  }\n\n  return transformed;\n}\n\n/**\n * Transforms an array of field names to FMFIDs\n * @param fieldNames - Array of field names\n * @param table - FMTable instance to get field IDs from\n * @returns Array of FMFIDs or field names\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformFieldNamesArray(fieldNames: string[], table: FMTable<any, any>): string[] {\n  const config = getBaseTableConfig(table);\n  if (!config.fmfIds) {\n    return fieldNames;\n  }\n\n  return fieldNames.map((fieldName) => getFieldId(table, fieldName));\n}\n\n/**\n * Transforms a field name in an orderBy string (e.g., \"name desc\" -> \"FMFID:1 desc\")\n * @param orderByString - The orderBy string (field name with optional asc/desc)\n * @param table - FMTable instance to get field ID from\n * @returns Transformed orderBy string with FMFID\n */\n// biome-ignore lint/suspicious/noExplicitAny: Accepts any FMTable configuration\nexport function transformOrderByField(orderByString: string, table: FMTable<any, any> | undefined): string {\n  if (!table) {\n    return orderByString;\n  }\n  const config = getBaseTableConfig(table);\n  if (!config?.fmfIds) {\n    return orderByString;\n  }\n\n  // Parse the orderBy string to extract field name and direction\n  const parts = orderByString.trim().split(WHITESPACE_SPLIT_REGEX);\n  const fieldName = parts[0];\n  if (!fieldName) {\n    return orderByString;\n  }\n  const direction = parts[1]; // \"asc\" or \"desc\" or undefined\n\n  const fieldId = getFieldId(table, fieldName);\n  return direction ? `${fieldId} ${direction}` : fieldId;\n}\n"],"names":[],"mappings":";AAGA,MAAM,yBAAyB;AASxB,SAAS,yBACd,MAEA,OAEqB;AACrB,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO;AAAA,EACT;AAGA,QAAM,cAAmC,CAAA;AACzC,aAAW,CAAC,WAAW,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AACrD,UAAM,UAAU,WAAW,OAAO,SAAS;AAC3C,gBAAY,OAAO,IAAI;AAAA,EACzB;AACA,SAAO;AACT;AA8EO,SAAS,wBAEd,MAEA,OACA,eAMK;AACL,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO;AAAA,EACT;AAGA,MAAI,SAAS,QAAQ,SAAS,QAAW;AACvC,WAAO;AAAA,EACT;AAGA,MAAI,KAAK,SAAS,MAAM,QAAQ,KAAK,KAAK,GAAG;AAC3C,WAAO;AAAA,MACL,GAAG;AAAA;AAAA,MAEH,OAAO,KAAK,MAAM,IAAI,CAAC,WAAgB,sBAAsB,QAAQ,OAAO,aAAa,CAAC;AAAA,IAAA;AAAA,EAE9F;AAGA,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAO,KAAK,IAAI,CAAC,WAAW,sBAAsB,QAAQ,OAAO,aAAa,CAAC;AAAA,EACjF;AAGA,SAAO,sBAAsB,MAAM,OAAO,aAAa;AACzD;AAKA,SAAS,sBAEP,QAEA,OACA,eAMK;AACL,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AAGA,QAAM,cAAmC,CAAA;AAEzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAEjD,QAAI,IAAI,WAAW,GAAG,GAAG;AACvB,kBAAY,GAAG,IAAI;AACnB;AAAA,IACF;AAGA,QAAI,eAAe,+CAAe,KAAK,CAAC,OAAO,GAAG,aAAa;AAI/D,QAAI,CAAC,gBAAgB,IAAI,WAAW,QAAQ,GAAG;AAC7C,qBAAe,+CAAe;AAAA,QAC5B,CAAC,OAAO,GAAG,SAAS,iBAAiB,GAAG,KAAK,KAAK,WAAW,GAAG,KAAK,MAAM;AAAA;AAAA,IAE/E;AAEA,QAAI,6CAAc,OAAO;AAGvB,YAAM,cAAc,aAAa;AAEjC,UAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,YAAI,CAAC,aAAa,OAAO;AACvB,sBAAY,WAAW,IAAI;AAC3B;AAAA,QACF;AACA,cAAM,cAAc,aAAa;AACjC,oBAAY,WAAW,IAAI,MAAM;AAAA,UAAI,CAAC,iBACpC;AAAA,YACE;AAAA,YACA;AAAA,YACA;AAAA;AAAA,UAAA;AAAA,QACF;AAAA,MAEJ,WAAW,SAAS,OAAO,UAAU,UAAU;AAC7C,YAAI,CAAC,aAAa,OAAO;AACvB,sBAAY,WAAW,IAAI;AAC3B;AAAA,QACF;AACA,oBAAY,WAAW,IAAI,sBAAsB,OAAO,aAAa,OAAO,MAAS;AAAA,MACvF,OAAO;AACL,oBAAY,WAAW,IAAI;AAAA,MAC7B;AACA;AAAA,IACF;AAGA,UAAM,YAAY,aAAa,OAAO,GAAG;AACzC,gBAAY,SAAS,IAAI;AAAA,EAC3B;AAEA,SAAO;AACT;AASO,SAAS,yBAAyB,YAAsB,OAAoC;AACjG,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO;AAAA,EACT;AAEA,SAAO,WAAW,IAAI,CAAC,cAAc,WAAW,OAAO,SAAS,CAAC;AACnE;AASO,SAAS,sBAAsB,eAAuB,OAA8C;AACzG,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI,EAAC,iCAAQ,SAAQ;AACnB,WAAO;AAAA,EACT;AAGA,QAAM,QAAQ,cAAc,KAAA,EAAO,MAAM,sBAAsB;AAC/D,QAAM,YAAY,MAAM,CAAC;AACzB,MAAI,CAAC,WAAW;AACd,WAAO;AAAA,EACT;AACA,QAAM,YAAY,MAAM,CAAC;AAEzB,QAAM,UAAU,WAAW,OAAO,SAAS;AAC3C,SAAO,YAAY,GAAG,OAAO,IAAI,SAAS,KAAK;AACjD;"}

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["import type { FFetchOptions } from \"@fetchkit/ffetch\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { InternalLogger } from \"./logger\";\n\nexport type Auth = { username: string; password: string } | { apiKey: string };\n\nexport interface ExecutableBuilder<T> {\n  execute(): Promise<Result<T>>;\n  // biome-ignore lint/suspicious/noExplicitAny: Request body can be any JSON-serializable value\n  getRequestConfig(): { method: string; url: string; body?: any };\n\n  /**\n   * Convert this builder to a native Request object for batch processing.\n   * @param baseUrl - The base URL for the OData service\n   * @param options - Optional execution options (e.g., includeODataAnnotations)\n   * @returns A native Request object\n   */\n  toRequest(baseUrl: string, options?: ExecuteOptions): Request;\n\n  /**\n   * Process a raw Response object into a typed Result.\n   * This allows builders to apply their own validation and transformation logic.\n   * @param response - The native Response object from the batch operation\n   * @param options - Optional execution options (e.g., skipValidation, includeODataAnnotations)\n   * @returns A typed Result with the builder's expected return type\n   */\n  processResponse(response: Response, options?: ExecuteOptions): Promise<Result<T>>;\n}\n\nexport interface ExecutionContext {\n  _makeRequest<T>(\n    url: string,\n    options?: RequestInit &\n      FFetchOptions & {\n        useEntityIds?: boolean;\n        includeSpecialColumns?: boolean;\n      },\n  ): Promise<Result<T>>;\n  _setUseEntityIds?(useEntityIds: boolean): void;\n  _getUseEntityIds?(): boolean;\n  _setIncludeSpecialColumns?(includeSpecialColumns: boolean): void;\n  _getIncludeSpecialColumns?(): boolean;\n  _getBaseUrl?(): string;\n  _getLogger?(): InternalLogger;\n}\n\nexport type InferSchemaType<Schema extends Record<string, StandardSchemaV1>> = {\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  [K in keyof Schema]: Schema[K] extends StandardSchemaV1<any, infer Output> ? Output : never;\n};\n\nexport type WithSpecialColumns<T> =\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\n  T extends Record<string, any>\n    ? T & {\n        ROWID: number;\n        ROWMODID: number;\n      }\n    : never;\n\n// Helper type to exclude special columns from a union of keys\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any key type\nexport type ExcludeSystemFields<T extends keyof any> = Exclude<T, \"ROWID\" | \"ROWMODID\">;\n\n// OData record metadata fields (present on each record)\nexport interface ODataRecordMetadata {\n  \"@id\": string;\n  \"@editLink\": string;\n}\n\n// OData response wrapper (top-level, internal use only)\nexport interface ODataListResponse<T> {\n  \"@context\": string;\n  value: (T & ODataRecordMetadata)[];\n}\n\nexport type ODataSingleResponse<T> = T &\n  ODataRecordMetadata & {\n    \"@context\": string;\n  };\n\n// OData response for single field values\nexport interface ODataFieldResponse<T> {\n  \"@context\": string;\n  value: T;\n}\n\n// Result pattern for execute responses\nexport type Result<T, E = import(\"./errors\").FMODataErrorType> =\n  | { data: T; error: undefined }\n  | { data: undefined; error: E };\n\n// Batch operation result types\nexport interface BatchItemResult<T> {\n  data: T | undefined;\n  error: import(\"./errors\").FMODataErrorType | undefined;\n  status: number; // HTTP status code (0 for truncated)\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any tuple type\nexport interface BatchResult<T extends readonly any[]> {\n  results: { [K in keyof T]: BatchItemResult<T[K]> };\n  successCount: number;\n  errorCount: number;\n  truncated: boolean;\n  firstErrorIndex: number | null;\n}\n\n// Make specific keys required, rest optional\nexport type MakeFieldsRequired<T, Keys extends keyof T> = Partial<T> & Required<Pick<T, Keys>>;\n\n// Extract keys from schema where validator doesn't allow null/undefined (auto-required fields)\nexport type AutoRequiredKeys<Schema extends Record<string, StandardSchemaV1>> = {\n  [K in keyof Schema]: Extract<StandardSchemaV1.InferOutput<Schema[K]>, null | undefined> extends never ? K : never;\n}[keyof Schema];\n\n// Helper type to compute excluded fields (readOnly fields + idField)\nexport type ExcludedFields<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any key type\n  IdField extends keyof any | undefined,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any array type\n  ReadOnly extends readonly any[],\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any key type\n> = IdField extends keyof any ? IdField | ReadOnly[number] : ReadOnly[number];\n\n// Helper type for InsertData computation\ntype _ComputeInsertData<\n  Schema extends Record<string, StandardSchemaV1>,\n  IdField extends keyof Schema | undefined,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any array type\n  Required extends readonly any[],\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any array type\n  ReadOnly extends readonly any[],\n> = [Required[number]] extends [keyof InferSchemaType<Schema>]\n  ? Required extends readonly (keyof InferSchemaType<Schema>)[]\n    ? MakeFieldsRequired<\n        Omit<InferSchemaType<Schema>, ExcludedFields<IdField, ReadOnly>>,\n        Exclude<AutoRequiredKeys<Schema> | Required[number], ExcludedFields<IdField, ReadOnly>>\n      >\n    : MakeFieldsRequired<\n        Omit<InferSchemaType<Schema>, ExcludedFields<IdField, ReadOnly>>,\n        Exclude<AutoRequiredKeys<Schema>, ExcludedFields<IdField, ReadOnly>>\n      >\n  : MakeFieldsRequired<\n      Omit<InferSchemaType<Schema>, ExcludedFields<IdField, ReadOnly>>,\n      Exclude<AutoRequiredKeys<Schema>, ExcludedFields<IdField, ReadOnly>>\n    >;\n\nexport interface ExecuteOptions {\n  includeODataAnnotations?: boolean;\n  skipValidation?: boolean;\n  /**\n   * Overrides the default behavior of the database to use entity IDs (rather than field names) in THIS REQUEST ONLY\n   */\n  useEntityIds?: boolean;\n  /**\n   * Overrides the default behavior of the database to include special columns (ROWID and ROWMODID) in THIS REQUEST ONLY.\n   * Note: Special columns are only included when there is no $select query.\n   */\n  includeSpecialColumns?: boolean;\n}\n\n/**\n * Type for the fetchHandler callback function.\n * This is a convenience type export that matches the fetchHandler signature in FFetchOptions.\n *\n * @example\n * ```typescript\n * import type { FetchHandler } from '@proofkit/fmodata';\n *\n * const myFetchHandler: FetchHandler = (input, init) => {\n *   console.log('Custom fetch:', input);\n *   return fetch(input, init);\n * };\n *\n * await query.execute({\n *   fetchHandler: myFetchHandler\n * });\n * ```\n */\nexport type FetchHandler = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\n/**\n * Combined type for execute() method options.\n *\n * Uses FFetchOptions from @fetchkit/ffetch to ensure proper type inference.\n * FFetchOptions is re-exported in the package to ensure type availability in consuming packages.\n */\nexport type ExecuteMethodOptions<EO extends ExecuteOptions = ExecuteOptions> = RequestInit &\n  FFetchOptions &\n  ExecuteOptions &\n  EO;\n\n/**\n * Get the Accept header value based on includeODataAnnotations option\n * @param includeODataAnnotations - Whether to include OData annotations\n * @returns Accept header value\n */\nexport function getAcceptHeader(includeODataAnnotations?: boolean): string {\n  return includeODataAnnotations === true ? \"application/json\" : \"application/json;odata.metadata=none\";\n}\n\nexport type ConditionallyWithODataAnnotations<\n  T,\n  IncludeODataAnnotations extends boolean,\n> = IncludeODataAnnotations extends true\n  ? T & {\n      \"@id\": string;\n      \"@editLink\": string;\n    }\n  : T;\n\n/**\n * Normalizes includeSpecialColumns with a database-level default.\n * Uses distributive conditional types to handle unions correctly.\n * @template IncludeSpecialColumns - The includeSpecialColumns value from execute options\n * @template DatabaseDefault - The database-level includeSpecialColumns setting (defaults to false)\n */\nexport type NormalizeIncludeSpecialColumns<\n  IncludeSpecialColumns extends boolean | undefined,\n  DatabaseDefault extends boolean = false,\n> = [IncludeSpecialColumns] extends [true] ? true : [IncludeSpecialColumns] extends [false] ? false : DatabaseDefault; // When undefined, use database-level default\n\n/**\n * Conditionally adds ROWID and ROWMODID special columns to a type.\n * Special columns are only included when:\n * - includeSpecialColumns is true AND\n * - hasSelect is false (no $select query was applied) AND\n * - T is an object type (not a primitive like string or number)\n *\n * Handles both single objects and arrays of objects.\n */\nexport type ConditionallyWithSpecialColumns<\n  T,\n  IncludeSpecialColumns extends boolean,\n  HasSelect extends boolean,\n> = IncludeSpecialColumns extends true\n  ? HasSelect extends false\n    ? // Handle array types\n      T extends readonly (infer U)[]\n      ? // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\n        U extends Record<string, any>\n        ? (U & {\n            ROWID: number;\n            ROWMODID: number;\n          })[]\n        : T\n      : // Handle single object types\n        // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\n        T extends Record<string, any>\n        ? T & {\n            ROWID: number;\n            ROWMODID: number;\n          }\n        : T // Don't add special columns to primitives (e.g., single field queries)\n    : T\n  : T;\n\n// Helper type to extract schema from a FMTable\nexport type ExtractSchemaFromOccurrence<Occ> = Occ extends {\n  baseTable: { schema: infer S };\n}\n  ? S extends Record<string, StandardSchemaV1>\n    ? S\n    : Record<string, StandardSchemaV1>\n  : Record<string, StandardSchemaV1>;\n\nexport interface GenericFieldMetadata {\n  $Nullable?: boolean;\n  \"@Index\"?: boolean;\n  \"@Calculation\"?: boolean;\n  \"@Summary\"?: boolean;\n  \"@Global\"?: boolean;\n  \"@Org.OData.Core.V1.Permissions\"?: \"Org.OData.Core.V1.Permission@Read\";\n}\n\nexport type StringFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.String\";\n  $DefaultValue?: \"USER\" | \"USERNAME\" | \"CURRENT_USER\";\n  $MaxLength?: number;\n};\n\nexport type DecimalFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.Decimal\";\n  \"@AutoGenerated\"?: boolean;\n};\n\nexport type DateFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.Date\";\n  $DefaultValue?: \"CURDATE\" | \"CURRENT_DATE\";\n};\n\nexport type TimeOfDayFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.TimeOfDay\";\n  $DefaultValue?: \"CURTIME\" | \"CURRENT_TIME\";\n};\n\nexport type DateTimeOffsetFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.Date\";\n  $DefaultValue?: \"CURTIMESTAMP\" | \"CURRENT_TIMESTAMP\";\n  \"@VersionId\"?: boolean;\n};\n\nexport interface StreamFieldMetadata {\n  $Type: \"Edm.Stream\";\n  $Nullable?: boolean;\n  \"@EnclosedPath\": string;\n  \"@ExternalOpenPath\": string;\n  \"@ExternalSecurePath\"?: string;\n}\n\nexport type FieldMetadata =\n  | StringFieldMetadata\n  | DecimalFieldMetadata\n  | DateFieldMetadata\n  | TimeOfDayFieldMetadata\n  | DateTimeOffsetFieldMetadata\n  | StreamFieldMetadata;\n\nexport type EntityType = {\n  $Kind: \"EntityType\";\n  $Key: string[];\n} & Record<string, FieldMetadata>;\n\nexport interface EntitySet {\n  $Kind: \"EntitySet\";\n  $Type: string;\n}\n\nexport type Metadata = Record<string, EntityType | EntitySet>;\n"],"names":[],"mappings":"AAsMO,SAAS,gBAAgB,yBAA2C;AAClE,SAAA,4BAA4B,OAAO,qBAAqB;AACjE;"}
+{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":["import type { FFetchOptions } from \"@fetchkit/ffetch\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { InternalLogger } from \"./logger\";\n\nexport type Auth = { username: string; password: string } | { apiKey: string };\n\nexport interface ExecutableBuilder<T> {\n  execute(): Promise<Result<T>>;\n  // biome-ignore lint/suspicious/noExplicitAny: Request body can be any JSON-serializable value\n  getRequestConfig(): { method: string; url: string; body?: any };\n\n  /**\n   * Convert this builder to a native Request object for batch processing.\n   * @param baseUrl - The base URL for the OData service\n   * @param options - Optional execution options (e.g., includeODataAnnotations)\n   * @returns A native Request object\n   */\n  toRequest(baseUrl: string, options?: ExecuteOptions): Request;\n\n  /**\n   * Process a raw Response object into a typed Result.\n   * This allows builders to apply their own validation and transformation logic.\n   * @param response - The native Response object from the batch operation\n   * @param options - Optional execution options (e.g., skipValidation, includeODataAnnotations)\n   * @returns A typed Result with the builder's expected return type\n   */\n  processResponse(response: Response, options?: ExecuteOptions): Promise<Result<T>>;\n}\n\nexport interface ExecutionContext {\n  _makeRequest<T>(\n    url: string,\n    options?: RequestInit &\n      FFetchOptions & {\n        useEntityIds?: boolean;\n        includeSpecialColumns?: boolean;\n      },\n  ): Promise<Result<T>>;\n  _setUseEntityIds?(useEntityIds: boolean): void;\n  _getUseEntityIds?(): boolean;\n  _setIncludeSpecialColumns?(includeSpecialColumns: boolean): void;\n  _getIncludeSpecialColumns?(): boolean;\n  _getBaseUrl?(): string;\n  _getLogger?(): InternalLogger;\n}\n\nexport type InferSchemaType<Schema extends Record<string, StandardSchemaV1>> = {\n  // biome-ignore lint/suspicious/noExplicitAny: Required for type inference with infer\n  [K in keyof Schema]: Schema[K] extends StandardSchemaV1<any, infer Output> ? Output : never;\n};\n\nexport type WithSpecialColumns<T> =\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\n  T extends Record<string, any>\n    ? T & {\n        ROWID: number;\n        ROWMODID: number;\n      }\n    : never;\n\n// Helper type to exclude special columns from a union of keys\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any key type\nexport type ExcludeSystemFields<T extends keyof any> = Exclude<T, \"ROWID\" | \"ROWMODID\">;\n\n// OData record metadata fields (present on each record)\nexport interface ODataRecordMetadata {\n  \"@id\": string;\n  \"@editLink\": string;\n}\n\n// OData response wrapper (top-level, internal use only)\nexport interface ODataListResponse<T> {\n  \"@context\": string;\n  value: (T & ODataRecordMetadata)[];\n}\n\nexport type ODataSingleResponse<T> = T &\n  ODataRecordMetadata & {\n    \"@context\": string;\n  };\n\n// OData response for single field values\nexport interface ODataFieldResponse<T> {\n  \"@context\": string;\n  value: T;\n}\n\n// Result pattern for execute responses\nexport type Result<T, E = import(\"./errors\").FMODataErrorType> =\n  | { data: T; error: undefined }\n  | { data: undefined; error: E };\n\n// Batch operation result types\nexport interface BatchItemResult<T> {\n  data: T | undefined;\n  error: import(\"./errors\").FMODataErrorType | undefined;\n  status: number; // HTTP status code (0 for truncated)\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any tuple type\nexport interface BatchResult<T extends readonly any[]> {\n  results: { [K in keyof T]: BatchItemResult<T[K]> };\n  successCount: number;\n  errorCount: number;\n  truncated: boolean;\n  firstErrorIndex: number | null;\n}\n\n// Make specific keys required, rest optional\nexport type MakeFieldsRequired<T, Keys extends keyof T> = Partial<T> & Required<Pick<T, Keys>>;\n\n// Extract keys from schema where validator doesn't allow null/undefined (auto-required fields)\nexport type AutoRequiredKeys<Schema extends Record<string, StandardSchemaV1>> = {\n  [K in keyof Schema]: Extract<StandardSchemaV1.InferOutput<Schema[K]>, null | undefined> extends never ? K : never;\n}[keyof Schema];\n\n// Helper type to compute excluded fields (readOnly fields + idField)\nexport type ExcludedFields<\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any key type\n  IdField extends keyof any | undefined,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any array type\n  ReadOnly extends readonly any[],\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any key type\n> = IdField extends keyof any ? IdField | ReadOnly[number] : ReadOnly[number];\n\n// Helper type for InsertData computation\ntype _ComputeInsertData<\n  Schema extends Record<string, StandardSchemaV1>,\n  IdField extends keyof Schema | undefined,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any array type\n  Required extends readonly any[],\n  // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any array type\n  ReadOnly extends readonly any[],\n> = [Required[number]] extends [keyof InferSchemaType<Schema>]\n  ? Required extends readonly (keyof InferSchemaType<Schema>)[]\n    ? MakeFieldsRequired<\n        Omit<InferSchemaType<Schema>, ExcludedFields<IdField, ReadOnly>>,\n        Exclude<AutoRequiredKeys<Schema> | Required[number], ExcludedFields<IdField, ReadOnly>>\n      >\n    : MakeFieldsRequired<\n        Omit<InferSchemaType<Schema>, ExcludedFields<IdField, ReadOnly>>,\n        Exclude<AutoRequiredKeys<Schema>, ExcludedFields<IdField, ReadOnly>>\n      >\n  : MakeFieldsRequired<\n      Omit<InferSchemaType<Schema>, ExcludedFields<IdField, ReadOnly>>,\n      Exclude<AutoRequiredKeys<Schema>, ExcludedFields<IdField, ReadOnly>>\n    >;\n\nexport interface ExecuteOptions {\n  includeODataAnnotations?: boolean;\n  skipValidation?: boolean;\n  /**\n   * Overrides the default behavior of the database to use entity IDs (rather than field names) in THIS REQUEST ONLY\n   */\n  useEntityIds?: boolean;\n  /**\n   * Overrides the default behavior of the database to include special columns (ROWID and ROWMODID) in THIS REQUEST ONLY.\n   * Note: Special columns are only included when there is no $select query.\n   */\n  includeSpecialColumns?: boolean;\n}\n\n/**\n * Type for the fetchHandler callback function.\n * This is a convenience type export that matches the fetchHandler signature in FFetchOptions.\n *\n * @example\n * ```typescript\n * import type { FetchHandler } from '@proofkit/fmodata';\n *\n * const myFetchHandler: FetchHandler = (input, init) => {\n *   console.log('Custom fetch:', input);\n *   return fetch(input, init);\n * };\n *\n * await query.execute({\n *   fetchHandler: myFetchHandler\n * });\n * ```\n */\nexport type FetchHandler = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\n/**\n * Combined type for execute() method options.\n *\n * Uses FFetchOptions from @fetchkit/ffetch to ensure proper type inference.\n * FFetchOptions is re-exported in the package to ensure type availability in consuming packages.\n */\nexport type ExecuteMethodOptions<EO extends ExecuteOptions = ExecuteOptions> = RequestInit &\n  FFetchOptions &\n  ExecuteOptions &\n  EO;\n\n/**\n * Get the Accept header value based on includeODataAnnotations option\n * @param includeODataAnnotations - Whether to include OData annotations\n * @returns Accept header value\n */\nexport function getAcceptHeader(includeODataAnnotations?: boolean): string {\n  return includeODataAnnotations === true ? \"application/json\" : \"application/json;odata.metadata=none\";\n}\n\nexport type ConditionallyWithODataAnnotations<\n  T,\n  IncludeODataAnnotations extends boolean,\n> = IncludeODataAnnotations extends true\n  ? T & {\n      \"@id\": string;\n      \"@editLink\": string;\n    }\n  : T;\n\n/**\n * Normalizes includeSpecialColumns with a database-level default.\n * Uses distributive conditional types to handle unions correctly.\n * @template IncludeSpecialColumns - The includeSpecialColumns value from execute options\n * @template DatabaseDefault - The database-level includeSpecialColumns setting (defaults to false)\n */\nexport type NormalizeIncludeSpecialColumns<\n  IncludeSpecialColumns extends boolean | undefined,\n  DatabaseDefault extends boolean = false,\n> = [IncludeSpecialColumns] extends [true] ? true : [IncludeSpecialColumns] extends [false] ? false : DatabaseDefault; // When undefined, use database-level default\n\n/**\n * Conditionally adds ROWID and ROWMODID special columns to a type.\n * Special columns are only included when:\n * - includeSpecialColumns is true AND\n * - hasSelect is false (no $select query was applied) AND\n * - T is an object type (not a primitive like string or number)\n *\n * Handles both single objects and arrays of objects.\n */\nexport type ConditionallyWithSpecialColumns<\n  T,\n  IncludeSpecialColumns extends boolean,\n  HasSelect extends boolean,\n> = IncludeSpecialColumns extends true\n  ? HasSelect extends false\n    ? // Handle array types\n      T extends readonly (infer U)[]\n      ? // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\n        U extends Record<string, any>\n        ? (U & {\n            ROWID: number;\n            ROWMODID: number;\n          })[]\n        : T\n      : // Handle single object types\n        // biome-ignore lint/suspicious/noExplicitAny: Generic constraint accepting any record shape\n        T extends Record<string, any>\n        ? T & {\n            ROWID: number;\n            ROWMODID: number;\n          }\n        : T // Don't add special columns to primitives (e.g., single field queries)\n    : T\n  : T;\n\n// Helper type to extract schema from a FMTable\nexport type ExtractSchemaFromOccurrence<Occ> = Occ extends {\n  baseTable: { schema: infer S };\n}\n  ? S extends Record<string, StandardSchemaV1>\n    ? S\n    : Record<string, StandardSchemaV1>\n  : Record<string, StandardSchemaV1>;\n\nexport interface GenericFieldMetadata {\n  $Nullable?: boolean;\n  \"@Index\"?: boolean;\n  \"@Calculation\"?: boolean;\n  \"@Summary\"?: boolean;\n  \"@Global\"?: boolean;\n  \"@Org.OData.Core.V1.Permissions\"?: \"Org.OData.Core.V1.Permission@Read\";\n}\n\nexport type StringFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.String\";\n  $DefaultValue?: \"USER\" | \"USERNAME\" | \"CURRENT_USER\";\n  $MaxLength?: number;\n};\n\nexport type DecimalFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.Decimal\";\n  \"@AutoGenerated\"?: boolean;\n};\n\nexport type DateFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.Date\";\n  $DefaultValue?: \"CURDATE\" | \"CURRENT_DATE\";\n};\n\nexport type TimeOfDayFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.TimeOfDay\";\n  $DefaultValue?: \"CURTIME\" | \"CURRENT_TIME\";\n};\n\nexport type DateTimeOffsetFieldMetadata = GenericFieldMetadata & {\n  $Type: \"Edm.Date\";\n  $DefaultValue?: \"CURTIMESTAMP\" | \"CURRENT_TIMESTAMP\";\n  \"@VersionId\"?: boolean;\n};\n\nexport interface StreamFieldMetadata {\n  $Type: \"Edm.Stream\";\n  $Nullable?: boolean;\n  \"@EnclosedPath\": string;\n  \"@ExternalOpenPath\": string;\n  \"@ExternalSecurePath\"?: string;\n}\n\nexport type FieldMetadata =\n  | StringFieldMetadata\n  | DecimalFieldMetadata\n  | DateFieldMetadata\n  | TimeOfDayFieldMetadata\n  | DateTimeOffsetFieldMetadata\n  | StreamFieldMetadata;\n\nexport type EntityType = {\n  $Kind: \"EntityType\";\n  $Key: string[];\n} & Record<string, FieldMetadata>;\n\nexport interface EntitySet {\n  $Kind: \"EntitySet\";\n  $Type: string;\n}\n\nexport type Metadata = Record<string, EntityType | EntitySet>;\n"],"names":[],"mappings":"AAsMO,SAAS,gBAAgB,yBAA2C;AACzE,SAAO,4BAA4B,OAAO,qBAAqB;AACjE;"}