@proofkit/fmodata 0.1.0-alpha.13 → 0.1.0-alpha.14

package/dist/esm/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../../src/errors.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Base class for all fmodata errors\n */\nexport abstract class FMODataError extends Error {\n  abstract readonly kind: string;\n  readonly timestamp: Date;\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = this.constructor.name;\n    this.timestamp = new Date();\n  }\n}\n\n// ============================================\n// HTTP Errors (with status codes)\n// ============================================\n\nexport class HTTPError extends FMODataError {\n  readonly kind = \"HTTPError\" as const;\n  readonly url: string;\n  readonly status: number;\n  readonly statusText: string;\n  readonly response?: any;\n\n  constructor(url: string, status: number, statusText: string, response?: any) {\n    super(`HTTP ${status} ${statusText} for ${url}`);\n    this.url = url;\n    this.status = status;\n    this.statusText = statusText;\n    this.response = response;\n  }\n\n  // Helper methods for common status checks\n  is4xx(): boolean {\n    return this.status >= 400 && this.status < 500;\n  }\n\n  is5xx(): boolean {\n    return this.status >= 500 && this.status < 600;\n  }\n\n  isNotFound(): boolean {\n    return this.status === 404;\n  }\n\n  isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  isForbidden(): boolean {\n    return this.status === 403;\n  }\n}\n\n// ============================================\n// OData Specific Errors\n// ============================================\n\nexport class ODataError extends FMODataError {\n  readonly kind = \"ODataError\" as const;\n  readonly url: string;\n  readonly code?: string;\n  readonly details?: any;\n\n  constructor(url: string, message: string, code?: string, details?: any) {\n    super(`OData error: ${message}`);\n    this.url = url;\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport class SchemaLockedError extends FMODataError {\n  readonly kind = \"SchemaLockedError\" as const;\n  readonly url: string;\n  readonly code: string;\n  readonly details?: any;\n\n  constructor(url: string, message: string, details?: any) {\n    super(`OData error: ${message}`);\n    this.url = url;\n    this.code = \"303\";\n    this.details = details;\n  }\n}\n\n// ============================================\n// Validation Errors\n// ============================================\n\nexport class ValidationError extends FMODataError {\n  readonly kind = \"ValidationError\" as const;\n  readonly field?: string;\n  readonly issues: readonly StandardSchemaV1.Issue[];\n  readonly value?: unknown;\n\n  constructor(\n    message: string,\n    issues: readonly StandardSchemaV1.Issue[],\n    options?: {\n      field?: string;\n      value?: unknown;\n      cause?: Error[\"cause\"];\n    },\n  ) {\n    super(\n      message,\n      options?.cause !== undefined ? { cause: options.cause } : undefined,\n    );\n    this.field = options?.field;\n    this.issues = issues;\n    this.value = options?.value;\n  }\n}\n\nexport class ResponseStructureError extends FMODataError {\n  readonly kind = \"ResponseStructureError\" as const;\n  readonly expected: string;\n  readonly received: any;\n\n  constructor(expected: string, received: any) {\n    super(`Invalid response structure: expected ${expected}`);\n    this.expected = expected;\n    this.received = received;\n  }\n}\n\nexport class RecordCountMismatchError extends FMODataError {\n  readonly kind = \"RecordCountMismatchError\" as const;\n  readonly expected: number | \"one\" | \"at-most-one\";\n  readonly received: number;\n\n  constructor(expected: number | \"one\" | \"at-most-one\", received: number) {\n    const expectedStr = typeof expected === \"number\" ? expected : expected;\n    super(`Expected ${expectedStr} record(s), but received ${received}`);\n    this.expected = expected;\n    this.received = received;\n  }\n}\n\nexport class InvalidLocationHeaderError extends FMODataError {\n  readonly kind = \"InvalidLocationHeaderError\" as const;\n  readonly locationHeader?: string;\n\n  constructor(message: string, locationHeader?: string) {\n    super(message);\n    this.locationHeader = locationHeader;\n  }\n}\n\nexport class ResponseParseError extends FMODataError {\n  readonly kind = \"ResponseParseError\" as const;\n  readonly url: string;\n  readonly rawText?: string;\n\n  constructor(\n    url: string,\n    message: string,\n    options?: { rawText?: string; cause?: Error },\n  ) {\n    super(message, options?.cause ? { cause: options.cause } : undefined);\n    this.url = url;\n    this.rawText = options?.rawText;\n  }\n}\n\n// ============================================\n// Type Guards\n// ============================================\n\nexport function isHTTPError(error: unknown): error is HTTPError {\n  return error instanceof HTTPError;\n}\n\nexport function isValidationError(error: unknown): error is ValidationError {\n  return error instanceof ValidationError;\n}\n\nexport function isODataError(error: unknown): error is ODataError {\n  return error instanceof ODataError;\n}\n\nexport function isSchemaLockedError(\n  error: unknown,\n): error is SchemaLockedError {\n  return error instanceof SchemaLockedError;\n}\n\nexport function isResponseStructureError(\n  error: unknown,\n): error is ResponseStructureError {\n  return error instanceof ResponseStructureError;\n}\n\nexport function isRecordCountMismatchError(\n  error: unknown,\n): error is RecordCountMismatchError {\n  return error instanceof RecordCountMismatchError;\n}\n\nexport function isResponseParseError(\n  error: unknown,\n): error is ResponseParseError {\n  return error instanceof ResponseParseError;\n}\n\nexport function isFMODataError(error: unknown): error is FMODataError {\n  return error instanceof FMODataError;\n}\n\n// ============================================\n// Union type for all possible errors\n// ============================================\n\n// Re-export ffetch errors (they'll be imported from @fetchkit/ffetch)\nexport type {\n  TimeoutError,\n  AbortError,\n  NetworkError,\n  RetryLimitError,\n  CircuitOpenError,\n} from \"@fetchkit/ffetch\";\n\nexport type FMODataErrorType =\n  | import(\"@fetchkit/ffetch\").TimeoutError\n  | import(\"@fetchkit/ffetch\").AbortError\n  | import(\"@fetchkit/ffetch\").NetworkError\n  | import(\"@fetchkit/ffetch\").RetryLimitError\n  | import(\"@fetchkit/ffetch\").CircuitOpenError\n  | HTTPError\n  | ODataError\n  | SchemaLockedError\n  | ValidationError\n  | ResponseStructureError\n  | RecordCountMismatchError\n  | InvalidLocationHeaderError\n  | ResponseParseError;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sources":["../../src/errors.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Base class for all fmodata errors\n */\nexport abstract class FMODataError extends Error {\n  abstract readonly kind: string;\n  readonly timestamp: Date;\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = this.constructor.name;\n    this.timestamp = new Date();\n  }\n}\n\n// ============================================\n// HTTP Errors (with status codes)\n// ============================================\n\nexport class HTTPError extends FMODataError {\n  readonly kind = \"HTTPError\" as const;\n  readonly url: string;\n  readonly status: number;\n  readonly statusText: string;\n  readonly response?: any;\n\n  constructor(url: string, status: number, statusText: string, response?: any) {\n    super(`HTTP ${status} ${statusText} for ${url}`);\n    this.url = url;\n    this.status = status;\n    this.statusText = statusText;\n    this.response = response;\n  }\n\n  // Helper methods for common status checks\n  is4xx(): boolean {\n    return this.status >= 400 && this.status < 500;\n  }\n\n  is5xx(): boolean {\n    return this.status >= 500 && this.status < 600;\n  }\n\n  isNotFound(): boolean {\n    return this.status === 404;\n  }\n\n  isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  isForbidden(): boolean {\n    return this.status === 403;\n  }\n}\n\n// ============================================\n// OData Specific Errors\n// ============================================\n\nexport class ODataError extends FMODataError {\n  readonly kind = \"ODataError\" as const;\n  readonly url: string;\n  readonly code?: string;\n  readonly details?: any;\n\n  constructor(url: string, message: string, code?: string, details?: any) {\n    super(`OData error: ${message}`);\n    this.url = url;\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport class SchemaLockedError extends FMODataError {\n  readonly kind = \"SchemaLockedError\" as const;\n  readonly url: string;\n  readonly code: string;\n  readonly details?: any;\n\n  constructor(url: string, message: string, details?: any) {\n    super(`OData error: ${message}`);\n    this.url = url;\n    this.code = \"303\";\n    this.details = details;\n  }\n}\n\n// ============================================\n// Validation Errors\n// ============================================\n\nexport class ValidationError extends FMODataError {\n  readonly kind = \"ValidationError\" as const;\n  readonly field?: string;\n  readonly issues: readonly StandardSchemaV1.Issue[];\n  readonly value?: unknown;\n\n  constructor(\n    message: string,\n    issues: readonly StandardSchemaV1.Issue[],\n    options?: {\n      field?: string;\n      value?: unknown;\n      cause?: Error[\"cause\"];\n    },\n  ) {\n    super(\n      message,\n      options?.cause !== undefined ? { cause: options.cause } : undefined,\n    );\n    this.field = options?.field;\n    this.issues = issues;\n    this.value = options?.value;\n  }\n}\n\nexport class ResponseStructureError extends FMODataError {\n  readonly kind = \"ResponseStructureError\" as const;\n  readonly expected: string;\n  readonly received: any;\n\n  constructor(expected: string, received: any) {\n    super(`Invalid response structure: expected ${expected}`);\n    this.expected = expected;\n    this.received = received;\n  }\n}\n\nexport class RecordCountMismatchError extends FMODataError {\n  readonly kind = \"RecordCountMismatchError\" as const;\n  readonly expected: number | \"one\" | \"at-most-one\";\n  readonly received: number;\n\n  constructor(expected: number | \"one\" | \"at-most-one\", received: number) {\n    const expectedStr = typeof expected === \"number\" ? expected : expected;\n    super(`Expected ${expectedStr} record(s), but received ${received}`);\n    this.expected = expected;\n    this.received = received;\n  }\n}\n\nexport class InvalidLocationHeaderError extends FMODataError {\n  readonly kind = \"InvalidLocationHeaderError\" as const;\n  readonly locationHeader?: string;\n\n  constructor(message: string, locationHeader?: string) {\n    super(message);\n    this.locationHeader = locationHeader;\n  }\n}\n\nexport class ResponseParseError extends FMODataError {\n  readonly kind = \"ResponseParseError\" as const;\n  readonly url: string;\n  readonly rawText?: string;\n\n  constructor(\n    url: string,\n    message: string,\n    options?: { rawText?: string; cause?: Error },\n  ) {\n    super(message, options?.cause ? { cause: options.cause } : undefined);\n    this.url = url;\n    this.rawText = options?.rawText;\n  }\n}\n\nexport class BatchTruncatedError extends FMODataError {\n  readonly kind = \"BatchTruncatedError\" as const;\n  readonly operationIndex: number;\n  readonly failedAtIndex: number;\n\n  constructor(operationIndex: number, failedAtIndex: number) {\n    super(\n      `Operation ${operationIndex} was not executed because operation ${failedAtIndex} failed`,\n    );\n    this.operationIndex = operationIndex;\n    this.failedAtIndex = failedAtIndex;\n  }\n}\n\n// ============================================\n// Type Guards\n// ============================================\n\nexport function isHTTPError(error: unknown): error is HTTPError {\n  return error instanceof HTTPError;\n}\n\nexport function isValidationError(error: unknown): error is ValidationError {\n  return error instanceof ValidationError;\n}\n\nexport function isODataError(error: unknown): error is ODataError {\n  return error instanceof ODataError;\n}\n\nexport function isSchemaLockedError(\n  error: unknown,\n): error is SchemaLockedError {\n  return error instanceof SchemaLockedError;\n}\n\nexport function isResponseStructureError(\n  error: unknown,\n): error is ResponseStructureError {\n  return error instanceof ResponseStructureError;\n}\n\nexport function isRecordCountMismatchError(\n  error: unknown,\n): error is RecordCountMismatchError {\n  return error instanceof RecordCountMismatchError;\n}\n\nexport function isResponseParseError(\n  error: unknown,\n): error is ResponseParseError {\n  return error instanceof ResponseParseError;\n}\n\nexport function isBatchTruncatedError(\n  error: unknown,\n): error is BatchTruncatedError {\n  return error instanceof BatchTruncatedError;\n}\n\nexport function isFMODataError(error: unknown): error is FMODataError {\n  return error instanceof FMODataError;\n}\n\n// ============================================\n// Union type for all possible errors\n// ============================================\n\n// Re-export ffetch errors (they'll be imported from @fetchkit/ffetch)\nexport type {\n  TimeoutError,\n  AbortError,\n  NetworkError,\n  RetryLimitError,\n  CircuitOpenError,\n} from \"@fetchkit/ffetch\";\n\nexport type FMODataErrorType =\n  | import(\"@fetchkit/ffetch\").TimeoutError\n  | import(\"@fetchkit/ffetch\").AbortError\n  | import(\"@fetchkit/ffetch\").NetworkError\n  | import(\"@fetchkit/ffetch\").RetryLimitError\n  | import(\"@fetchkit/ffetch\").CircuitOpenError\n  | HTTPError\n  | ODataError\n  | SchemaLockedError\n  | ValidationError\n  | ResponseStructureError\n  | RecordCountMismatchError\n  | InvalidLocationHeaderError\n  | ResponseParseError\n  | BatchTruncatedError;\n"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -1,14 +1,10 @@
-export { defineBaseTable } from './client/base-table.js';
-export { defineTableOccurrence } from './client/table-occurrence.js';
-export { buildOccurrences } from './client/build-occurrences.js';
 export { FMServerConnection } from './client/filemaker-odata.js';
-export type { BaseTable } from './client/base-table.js';
-export type { TableOccurrence } from './client/table-occurrence.js';
+export { textField, numberField, dateField, timeField, timestampField, containerField, calcField, type FieldBuilder, fmTableOccurrence, FMTable, type FMTableWithColumns as TableOccurrenceResult, type InferTableSchema, getTableColumns, type Column, isColumn, type FilterExpression, eq, ne, gt, gte, lt, lte, contains, startsWith, endsWith, inArray, notInArray, isNull, isNotNull, and, or, not, type OrderByExpression, asc, desc, } from './orm/index.js';
 export type { Database } from './client/database.js';
 export type { EntitySet } from './client/entity-set.js';
 export type { SchemaManager, Field, StringField, NumericField, DateField, TimeField, TimestampField, ContainerField, } from './client/schema-manager.js';
-export type { Result, InferSchemaType, InsertData, UpdateData, ODataRecordMetadata, Metadata, } from './types.js';
+export type { Result, BatchResult, BatchItemResult, InferSchemaType, InsertData, UpdateData, ODataRecordMetadata, Metadata, } from './types.js';
 export type { Filter, TypedFilter, FieldFilter, StringOperators, NumberOperators, BooleanOperators, DateOperators, LogicalFilter, } from './filter-types.js';
 export { TimeoutError, AbortError, NetworkError, RetryLimitError, CircuitOpenError, } from '@fetchkit/ffetch';
-export { FMODataError, HTTPError, ODataError, SchemaLockedError, ValidationError, ResponseStructureError, RecordCountMismatchError, ResponseParseError, isHTTPError, isValidationError, isODataError, isSchemaLockedError, isResponseStructureError, isRecordCountMismatchError, isResponseParseError, isFMODataError, } from './errors.js';
+export { FMODataError, HTTPError, ODataError, SchemaLockedError, ValidationError, ResponseStructureError, RecordCountMismatchError, ResponseParseError, BatchTruncatedError, isHTTPError, isValidationError, isODataError, isSchemaLockedError, isResponseStructureError, isRecordCountMismatchError, isResponseParseError, isBatchTruncatedError, isFMODataError, } from './errors.js';
 export type { FMODataErrorType } from './errors.js';

package/dist/esm/index.js

@@ -1,14 +1,17 @@
-import { defineBaseTable } from "./client/base-table.js";
-import { defineTableOccurrence } from "./client/table-occurrence.js";
-import { buildOccurrences } from "./client/build-occurrences.js";
 import { FMServerConnection } from "./client/filemaker-odata.js";
+import { calcField, containerField, dateField, numberField, textField, timeField, timestampField } from "./orm/field-builders.js";
+import { isColumn } from "./orm/column.js";
+import { and, asc, contains, desc, endsWith, eq, gt, gte, inArray, isNotNull, isNull, lt, lte, ne, not, notInArray, or, startsWith } from "./orm/operators.js";
+import { FMTable, fmTableOccurrence, getTableColumns } from "./orm/table.js";
 import { AbortError, CircuitOpenError, NetworkError, RetryLimitError, TimeoutError } from "@fetchkit/ffetch";
-import { FMODataError, HTTPError, ODataError, RecordCountMismatchError, ResponseParseError, ResponseStructureError, SchemaLockedError, ValidationError, isFMODataError, isHTTPError, isODataError, isRecordCountMismatchError, isResponseParseError, isResponseStructureError, isSchemaLockedError, isValidationError } from "./errors.js";
+import { BatchTruncatedError, FMODataError, HTTPError, ODataError, RecordCountMismatchError, ResponseParseError, ResponseStructureError, SchemaLockedError, ValidationError, isBatchTruncatedError, isFMODataError, isHTTPError, isODataError, isRecordCountMismatchError, isResponseParseError, isResponseStructureError, isSchemaLockedError, isValidationError } from "./errors.js";
 export {
   AbortError,
+  BatchTruncatedError,
   CircuitOpenError,
   FMODataError,
   FMServerConnection,
+  FMTable,
   HTTPError,
   NetworkError,
   ODataError,
@@ -19,16 +22,42 @@ export {
   SchemaLockedError,
   TimeoutError,
   ValidationError,
-  buildOccurrences,
-  defineBaseTable,
-  defineTableOccurrence,
+  and,
+  asc,
+  calcField,
+  containerField,
+  contains,
+  dateField,
+  desc,
+  endsWith,
+  eq,
+  fmTableOccurrence,
+  getTableColumns,
+  gt,
+  gte,
+  inArray,
+  isBatchTruncatedError,
+  isColumn,
   isFMODataError,
   isHTTPError,
+  isNotNull,
+  isNull,
   isODataError,
   isRecordCountMismatchError,
   isResponseParseError,
   isResponseStructureError,
   isSchemaLockedError,
-  isValidationError
+  isValidationError,
+  lt,
+  lte,
+  ne,
+  not,
+  notInArray,
+  numberField,
+  or,
+  startsWith,
+  textField,
+  timeField,
+  timestampField
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/dist/esm/orm/column.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Column represents a type-safe reference to a table field.
+ * Used in queries, filters, and operators to provide autocomplete and type checking.
+ *
+ * @template T - The TypeScript type of the column's value
+ * @template TableName - The table name as a string literal type (for validation)
+ * @template IsContainer - Whether this column represents a container field (cannot be selected)
+ */
+export declare class Column<T = any, TableName extends string = string, IsContainer extends boolean = false> {
+    readonly fieldName: string;
+    readonly entityId?: `FMFID:${string}`;
+    readonly tableName: TableName;
+    readonly tableEntityId?: `FMTID:${string}`;
+    readonly _phantom: T;
+    readonly _isContainer: IsContainer;
+    constructor(config: {
+        fieldName: string;
+        entityId?: `FMFID:${string}`;
+        tableName: TableName;
+        tableEntityId?: `FMTID:${string}`;
+    });
+    /**
+     * Get the field identifier (entity ID if available, otherwise field name).
+     * Used when building OData queries.
+     */
+    getFieldIdentifier(useEntityIds?: boolean): string;
+    /**
+     * Get the table identifier (entity ID if available, otherwise table name).
+     * Used when building OData queries.
+     */
+    getTableIdentifier(useEntityIds?: boolean): string;
+    /**
+     * Check if this column is from a specific table.
+     * Useful for validation in cross-table operations.
+     */
+    isFromTable(tableName: string): boolean;
+    /**
+     * Create a string representation for debugging.
+     */
+    toString(): string;
+}
+/**
+ * Type guard to check if a value is a Column instance.
+ */
+export declare function isColumn(value: any): value is Column<any, any, any>;

package/dist/esm/orm/column.js

@@ -0,0 +1,59 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class Column {
+  constructor(config) {
+    __publicField(this, "fieldName");
+    __publicField(this, "entityId");
+    __publicField(this, "tableName");
+    __publicField(this, "tableEntityId");
+    // Phantom type for TypeScript inference - never actually holds a value
+    __publicField(this, "_phantom");
+    __publicField(this, "_isContainer");
+    this.fieldName = config.fieldName;
+    this.entityId = config.entityId;
+    this.tableName = config.tableName;
+    this.tableEntityId = config.tableEntityId;
+  }
+  /**
+   * Get the field identifier (entity ID if available, otherwise field name).
+   * Used when building OData queries.
+   */
+  getFieldIdentifier(useEntityIds) {
+    if (useEntityIds && this.entityId) {
+      return this.entityId;
+    }
+    return this.fieldName;
+  }
+  /**
+   * Get the table identifier (entity ID if available, otherwise table name).
+   * Used when building OData queries.
+   */
+  getTableIdentifier(useEntityIds) {
+    if (useEntityIds && this.tableEntityId) {
+      return this.tableEntityId;
+    }
+    return this.tableName;
+  }
+  /**
+   * Check if this column is from a specific table.
+   * Useful for validation in cross-table operations.
+   */
+  isFromTable(tableName) {
+    return this.tableName === tableName;
+  }
+  /**
+   * Create a string representation for debugging.
+   */
+  toString() {
+    return `${this.tableName}.${this.fieldName}`;
+  }
+}
+function isColumn(value) {
+  return value instanceof Column;
+}
+export {
+  Column,
+  isColumn
+};
+//# sourceMappingURL=column.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","sources":["../../../src/orm/column.ts"],"sourcesContent":["/**\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 T - The TypeScript type of the column's value\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  T = any,\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\n  // Phantom type for TypeScript inference - never actually holds a value\n  readonly _phantom!: T;\n  readonly _isContainer!: IsContainer;\n\n  constructor(config: {\n    fieldName: string;\n    entityId?: `FMFID:${string}`;\n    tableName: TableName;\n    tableEntityId?: `FMTID:${string}`;\n  }) {\n    this.fieldName = config.fieldName;\n    this.entityId = config.entityId;\n    this.tableName = config.tableName;\n    this.tableEntityId = config.tableEntityId;\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 */\nexport function isColumn(value: any): value is Column<any, any, any> {\n  return value instanceof Column;\n}\n"],"names":[],"mappings":";;;AAQO,MAAM,OAIX;AAAA,EAUA,YAAY,QAKT;AAdM;AACA;AACA;AACA;AAGA;AAAA;AACA;AAQP,SAAK,YAAY,OAAO;AACxB,SAAK,WAAW,OAAO;AACvB,SAAK,YAAY,OAAO;AACxB,SAAK,gBAAgB,OAAO;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO9B,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;AAKO,SAAS,SAAS,OAA4C;AACnE,SAAO,iBAAiB;AAC1B;"}

package/dist/esm/orm/field-builders.d.ts

@@ -0,0 +1,154 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+/**
+ * Branded type for container field's database type.
+ * This allows TypeScript to distinguish container fields from regular string fields
+ * at the type level, enabling compile-time exclusion from select operations.
+ */
+export type ContainerDbType = string & {
+    readonly __container: true;
+};
+/**
+ * FieldBuilder provides a fluent API for defining table fields with type-safe metadata.
+ * Supports chaining methods to configure primary keys, nullability, read-only status, entity IDs, and validators.
+ *
+ * @template TOutput - The output type after applying outputValidator (what you get when reading)
+ * @template TInput - The input type after applying inputValidator (what you pass when writing)
+ * @template TDbType - The database type (what FileMaker stores/expects)
+ * @template TReadOnly - Whether this field is read-only (for type-level exclusion from insert/update)
+ */
+export declare class FieldBuilder<TOutput = any, TInput = TOutput, TDbType = TOutput, TReadOnly extends boolean = false> {
+    private _primaryKey;
+    private _notNull;
+    private _readOnly;
+    private _entityId?;
+    private _outputValidator?;
+    private _inputValidator?;
+    private _fieldType;
+    constructor(fieldType: string);
+    /**
+     * Mark this field as the primary key for the table.
+     * Primary keys are automatically read-only.
+     */
+    primaryKey(): FieldBuilder<TOutput, TInput, TDbType, true>;
+    /**
+     * Mark this field as non-nullable.
+     * Updates the type to exclude null/undefined.
+     */
+    notNull(): FieldBuilder<NonNullable<TOutput>, NonNullable<TInput>, NonNullable<TDbType>, TReadOnly>;
+    /**
+     * Mark this field as read-only.
+     * Read-only fields are excluded from insert and update operations.
+     */
+    readOnly(): FieldBuilder<TOutput, TInput, TDbType, true>;
+    /**
+     * Assign a FileMaker field ID (FMFID) to this field.
+     * When useEntityIds is enabled, this ID will be used in API requests instead of the field name.
+     */
+    entityId(id: `FMFID:${string}`): FieldBuilder<TOutput, TInput, TDbType, TReadOnly>;
+    /**
+     * Set a validator for the output (reading from database).
+     * The output validator transforms/validates data coming FROM the database in list or get operations.
+     *
+     * @example
+     * numberField().readValidator(z.coerce.boolean())
+     * // FileMaker returns 0/1, you get true/false
+     */
+    readValidator<O, VInput = TDbType>(validator: StandardSchemaV1<VInput, O>): FieldBuilder<O, TInput, TDbType, TReadOnly>;
+    /**
+     * Set a validator for the input (writing to database).
+     * The input validator transforms/validates data going TO the database in insert and update operations.
+     *
+     * @example
+     * numberField().writeValidator(z.boolean().transform(v => v ? 1 : 0))
+     * // You pass true/false, FileMaker gets 1/0
+     */
+    writeValidator<I>(validator: StandardSchemaV1<I, TDbType>): FieldBuilder<TOutput, I, TDbType, TReadOnly>;
+    /**
+     * Get the metadata configuration for this field.
+     * @internal Used by fmTableOccurrence to extract field configuration
+     */
+    _getConfig(): {
+        fieldType: string;
+        primaryKey: boolean;
+        notNull: boolean;
+        readOnly: boolean;
+        entityId: `FMFID:${string}` | undefined;
+        outputValidator: StandardSchemaV1<any, TOutput> | undefined;
+        inputValidator: StandardSchemaV1<TInput, any> | undefined;
+    };
+    /**
+     * Clone this builder to allow immutable chaining.
+     * @private
+     */
+    private _clone;
+}
+/**
+ * Create a text field (Edm.String in FileMaker OData).
+ * By default, text fields are nullable.
+ *
+ * @example
+ * textField()                    // string | null
+ * textField().notNull()          // string
+ * textField().entityId("FMFID:1") // with entity ID
+ */
+export declare function textField(): FieldBuilder<string | null, string | null, string | null, false>;
+/**
+ * Create a number field (Edm.Decimal in FileMaker OData).
+ * By default, number fields are nullable.
+ *
+ * @example
+ * numberField()                   // number | null
+ * numberField().notNull()         // number
+ * numberField().outputValidator(z.coerce.boolean()) // transform to boolean on read
+ */
+export declare function numberField(): FieldBuilder<number | null, number | null, number | null, false>;
+/**
+ * Create a date field (Edm.Date in FileMaker OData).
+ * By default, date fields are nullable and represented as ISO date strings (YYYY-MM-DD).
+ *
+ * @example
+ * dateField()         // string | null (ISO date format)
+ * dateField().notNull() // string
+ */
+export declare function dateField(): FieldBuilder<string | null, string | null, string | null, false>;
+/**
+ * Create a time field (Edm.TimeOfDay in FileMaker OData).
+ * By default, time fields are nullable and represented as ISO time strings (HH:mm:ss).
+ *
+ * @example
+ * timeField()         // string | null (ISO time format)
+ * timeField().notNull() // string
+ */
+export declare function timeField(): FieldBuilder<string | null, string | null, string | null, false>;
+/**
+ * Create a timestamp field (Edm.DateTimeOffset in FileMaker OData).
+ * By default, timestamp fields are nullable and represented as ISO 8601 strings.
+ *
+ * @example
+ * timestampField()         // string | null (ISO 8601 format)
+ * timestampField().notNull() // string
+ * timestampField().readOnly() // typical for CreationTimestamp
+ */
+export declare function timestampField(): FieldBuilder<string | null, string | null, string | null, false>;
+/**
+ * Create a container field (Edm.Stream in FileMaker OData).
+ * Container fields store binary data and are represented as base64 strings in the API.
+ * By default, container fields are nullable.
+ *
+ * Note: Container fields cannot be selected via .select() - they can only be accessed
+ * via .getSingleField() due to FileMaker OData API limitations.
+ *
+ * @example
+ * containerField()         // string | null (base64 encoded)
+ * containerField().notNull() // string
+ */
+export declare function containerField(): FieldBuilder<string | null, string | null, ContainerDbType | null, false>;
+/**
+ * Create a calculated field (read-only field computed by FileMaker).
+ * Calculated fields are automatically marked as read-only.
+ *
+ * @example
+ * calcField()         // string | null
+ * calcField().notNull() // string
+ */
+export declare function calcField(): FieldBuilder<string | null, string | null, string | null, true>;

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

@@ -0,0 +1,152 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class FieldBuilder {
+  constructor(fieldType) {
+    __publicField(this, "_primaryKey", false);
+    __publicField(this, "_notNull", false);
+    __publicField(this, "_readOnly", false);
+    __publicField(this, "_entityId");
+    __publicField(this, "_outputValidator");
+    __publicField(this, "_inputValidator");
+    __publicField(this, "_fieldType");
+    this._fieldType = fieldType;
+  }
+  /**
+   * Mark this field as the primary key for the table.
+   * Primary keys are automatically read-only.
+   */
+  primaryKey() {
+    const builder = this._clone();
+    builder._primaryKey = true;
+    builder._readOnly = true;
+    return builder;
+  }
+  /**
+   * Mark this field as non-nullable.
+   * Updates the type to exclude null/undefined.
+   */
+  notNull() {
+    const builder = this._clone();
+    builder._notNull = true;
+    return builder;
+  }
+  /**
+   * Mark this field as read-only.
+   * Read-only fields are excluded from insert and update operations.
+   */
+  readOnly() {
+    const builder = this._clone();
+    builder._readOnly = true;
+    return builder;
+  }
+  /**
+   * Assign a FileMaker field ID (FMFID) to this field.
+   * When useEntityIds is enabled, this ID will be used in API requests instead of the field name.
+   */
+  entityId(id) {
+    const builder = this._clone();
+    builder._entityId = id;
+    return builder;
+  }
+  /**
+   * Set a validator for the output (reading from database).
+   * The output validator transforms/validates data coming FROM the database in list or get operations.
+   *
+   * @example
+   * numberField().readValidator(z.coerce.boolean())
+   * // FileMaker returns 0/1, you get true/false
+   */
+  readValidator(validator) {
+    const builder = this._clone();
+    builder._outputValidator = validator;
+    return builder;
+  }
+  /**
+   * Set a validator for the input (writing to database).
+   * The input validator transforms/validates data going TO the database in insert and update operations.
+   *
+   * @example
+   * numberField().writeValidator(z.boolean().transform(v => v ? 1 : 0))
+   * // You pass true/false, FileMaker gets 1/0
+   */
+  writeValidator(validator) {
+    const builder = this._clone();
+    builder._inputValidator = validator;
+    return builder;
+  }
+  /**
+   * Get the metadata configuration for this field.
+   * @internal Used by fmTableOccurrence to extract field configuration
+   */
+  _getConfig() {
+    return {
+      fieldType: this._fieldType,
+      primaryKey: this._primaryKey,
+      notNull: this._notNull,
+      readOnly: this._readOnly,
+      entityId: this._entityId,
+      outputValidator: this._outputValidator,
+      inputValidator: this._inputValidator
+    };
+  }
+  /**
+   * Clone this builder to allow immutable chaining.
+   * @private
+   */
+  _clone() {
+    const builder = new FieldBuilder(
+      this._fieldType
+    );
+    builder._primaryKey = this._primaryKey;
+    builder._notNull = this._notNull;
+    builder._readOnly = this._readOnly;
+    builder._entityId = this._entityId;
+    builder._outputValidator = this._outputValidator;
+    builder._inputValidator = this._inputValidator;
+    return builder;
+  }
+}
+function textField() {
+  return new FieldBuilder(
+    "text"
+  );
+}
+function numberField() {
+  return new FieldBuilder(
+    "number"
+  );
+}
+function dateField() {
+  return new FieldBuilder(
+    "date"
+  );
+}
+function timeField() {
+  return new FieldBuilder(
+    "time"
+  );
+}
+function timestampField() {
+  return new FieldBuilder(
+    "timestamp"
+  );
+}
+function containerField() {
+  return new FieldBuilder("container");
+}
+function calcField() {
+  const builder = new FieldBuilder("calculated");
+  return builder.readOnly();
+}
+export {
+  FieldBuilder,
+  calcField,
+  containerField,
+  dateField,
+  numberField,
+  textField,
+  timeField,
+  timestampField
+};
+//# sourceMappingURL=field-builders.js.map

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

@@ -0,0 +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 */\nexport class FieldBuilder<\n  TOutput = any,\n  TInput = TOutput,\n  TDbType = TOutput,\n  TReadOnly extends boolean = false,\n> {\n  private _primaryKey = false;\n  private _notNull = false;\n  private _readOnly = false;\n  private _entityId?: `FMFID:${string}`;\n  private _outputValidator?: StandardSchemaV1<any, TOutput>;\n  private _inputValidator?: StandardSchemaV1<TInput, any>;\n  private _fieldType: 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.\n   */\n  primaryKey(): FieldBuilder<TOutput, TInput, TDbType, true> {\n    const builder = this._clone() as any;\n    builder._primaryKey = true;\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<\n    NonNullable<TOutput>,\n    NonNullable<TInput>,\n    NonNullable<TDbType>,\n    TReadOnly\n  > {\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    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(\n    id: `FMFID:${string}`,\n  ): 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    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 and update 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>(\n    validator: StandardSchemaV1<I, TDbType>,\n  ): FieldBuilder<TOutput, I, TDbType, TReadOnly> {\n    const builder = this._clone() as any;\n    builder._inputValidator = validator;\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    };\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>(\n      this._fieldType,\n    );\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    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<\n  string | null,\n  string | null,\n  string | null,\n  false\n> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\n    \"text\",\n  );\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<\n  number | null,\n  number | null,\n  number | null,\n  false\n> {\n  return new FieldBuilder<number | null, number | null, number | null, false>(\n    \"number\",\n  );\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<\n  string | null,\n  string | null,\n  string | null,\n  false\n> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\n    \"date\",\n  );\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<\n  string | null,\n  string | null,\n  string | null,\n  false\n> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\n    \"time\",\n  );\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<\n  string | null,\n  string | null,\n  string | null,\n  false\n> {\n  return new FieldBuilder<string | null, string | null, string | null, false>(\n    \"timestamp\",\n  );\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<\n  string | null,\n  string | null,\n  ContainerDbType | null,\n  false\n> {\n  return new FieldBuilder<\n    string | null,\n    string | null,\n    ContainerDbType | null,\n    false\n  >(\"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<\n  string | null,\n  string | null,\n  string | null,\n  true\n> {\n  const builder = new FieldBuilder<\n    string | null,\n    string | null,\n    string | null,\n    false\n  >(\"calculated\");\n  return builder.readOnly();\n}\n"],"names":[],"mappings":";;;AAkBO,MAAM,aAKX;AAAA,EASA,YAAY,WAAmB;AARvB,uCAAc;AACd,oCAAW;AACX,qCAAY;AACZ;AACA;AACA;AACA;AAGN,SAAK,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,aAA2D;AACnD,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,cAAc;AACtB,YAAQ,YAAY;AACb,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,UAKE;AACM,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,WAAW;AACZ,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAyD;AACjD,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,YAAY;AACb,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,SACE,IACmD;AAC7C,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,YAAY;AACb,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWT,cACE,WAC6C;AACvC,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,mBAAmB;AACpB,WAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWT,eACE,WAC8C;AACxC,UAAA,UAAU,KAAK,OAAO;AAC5B,YAAQ,kBAAkB;AACnB,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,IACvB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOM,SAA4D;AAClE,UAAM,UAAU,IAAI;AAAA,MAClB,KAAK;AAAA,IACP;AACA,YAAQ,cAAc,KAAK;AAC3B,YAAQ,WAAW,KAAK;AACxB,YAAQ,YAAY,KAAK;AACzB,YAAQ,YAAY,KAAK;AACzB,YAAQ,mBAAmB,KAAK;AAChC,YAAQ,kBAAkB,KAAK;AACxB,WAAA;AAAA,EAAA;AAEX;AAWO,SAAS,YAKd;AACA,SAAO,IAAI;AAAA,IACT;AAAA,EACF;AACF;AAWO,SAAS,cAKd;AACA,SAAO,IAAI;AAAA,IACT;AAAA,EACF;AACF;AAUO,SAAS,YAKd;AACA,SAAO,IAAI;AAAA,IACT;AAAA,EACF;AACF;AAUO,SAAS,YAKd;AACA,SAAO,IAAI;AAAA,IACT;AAAA,EACF;AACF;AAWO,SAAS,iBAKd;AACA,SAAO,IAAI;AAAA,IACT;AAAA,EACF;AACF;AAcO,SAAS,iBAKd;AACO,SAAA,IAAI,aAKT,WAAW;AACf;AAUO,SAAS,YAKd;AACM,QAAA,UAAU,IAAI,aAKlB,YAAY;AACd,SAAO,QAAQ,SAAS;AAC1B;"}

package/dist/esm/orm/index.d.ts

@@ -0,0 +1,4 @@
+export { FieldBuilder, textField, numberField, dateField, timeField, timestampField, containerField, calcField, type ContainerDbType, } from './field-builders.js';
+export { Column, isColumn } from './column.js';
+export { FilterExpression, eq, ne, gt, gte, lt, lte, contains, startsWith, endsWith, inArray, notInArray, isNull, isNotNull, and, or, not, OrderByExpression, isOrderByExpression, asc, desc, } from './operators.js';
+export { fmTableOccurrence, FMTable, type FMTableWithColumns, type InferTableSchema, getTableName, getTableEntityId, getDefaultSelect, getBaseTableConfig, isUsingEntityIds, getFieldId, getFieldName, getTableId, getTableColumns, } from './table.js';