@proofkit/fmodata 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/esm/client/table-occurrence.js.map

@@ -1 +1 @@
-{"version":3,"file":"table-occurrence.js","sources":["../../../src/client/table-occurrence.ts"],"sourcesContent":["import { BaseTable } from \"./base-table\";\n\n// Helper type to extract schema from BaseTable\ntype ExtractSchema<BT> =\n  BT extends BaseTable<infer S, any, any, any> ? S : never;\n\n// Helper type to resolve navigation functions to their return types\ntype ResolveNavigation<T> = {\n  [K in keyof T]: T[K] extends () => infer R ? R : T[K];\n};\n\n// Helper to create a getter-based navigation object\nfunction createNavigationGetters<\n  Nav extends Record<\n    string,\n    | TableOccurrence<any, any, any, any>\n    | (() => TableOccurrence<any, any, any, any>)\n  >,\n>(navConfig: Nav): ResolveNavigation<Nav> {\n  const result: any = {};\n\n  for (const key in navConfig) {\n    Object.defineProperty(result, key, {\n      get() {\n        const navItem = navConfig[key];\n        return typeof navItem === \"function\" ? navItem() : navItem;\n      },\n      enumerable: true,\n      configurable: true,\n    });\n  }\n\n  return result as ResolveNavigation<Nav>;\n}\n\nexport class TableOccurrence<\n  BT extends BaseTable<any, any, any, any> = any,\n  Name extends string = string,\n  Nav extends Record<\n    string,\n    | TableOccurrence<any, any, any, any>\n    | (() => TableOccurrence<any, any, any, any>)\n  > = {},\n  DefSelect extends\n    | \"all\"\n    | \"schema\"\n    | readonly (keyof ExtractSchema<BT>)[] = \"schema\",\n> {\n  public readonly name: Name;\n  public readonly baseTable: BT;\n  private _navigationConfig: Nav;\n  public readonly navigation: ResolveNavigation<Nav>;\n  public readonly defaultSelect: DefSelect;\n\n  constructor(config: {\n    readonly name: Name;\n    readonly baseTable: BT;\n    readonly navigation?: Nav;\n    readonly defaultSelect?: DefSelect;\n  }) {\n    this.name = config.name;\n    this.baseTable = config.baseTable;\n    this._navigationConfig = (config.navigation ?? {}) as Nav;\n    this.defaultSelect = (config.defaultSelect ?? \"schema\") as DefSelect;\n\n    // Create navigation getters that lazily resolve functions\n    this.navigation = createNavigationGetters(this._navigationConfig);\n  }\n\n  addNavigation<\n    NewNav extends Record<\n      string,\n      | TableOccurrence<any, any, any, any>\n      | (() => TableOccurrence<any, any, any, any>)\n    >,\n  >(nav: NewNav): TableOccurrence<BT, Name, Nav & NewNav, DefSelect> {\n    return new TableOccurrence({\n      name: this.name,\n      baseTable: this.baseTable,\n      navigation: { ...this._navigationConfig, ...nav } as Nav & NewNav,\n      defaultSelect: this.defaultSelect,\n    });\n  }\n}\n\n// Helper function to create TableOccurrence with proper type inference\nexport function createTableOccurrence<\n  const Name extends string,\n  BT extends BaseTable<any, any, any, any>,\n  DefSelect extends\n    | \"all\"\n    | \"schema\"\n    | readonly (keyof ExtractSchema<BT>)[] = \"schema\",\n>(config: {\n  name: Name;\n  baseTable: BT;\n  defaultSelect?: DefSelect;\n}): TableOccurrence<BT, Name, {}, DefSelect> {\n  return new TableOccurrence(config);\n}\n"],"names":[],"mappings":";;;AAYA,SAAS,wBAMP,WAAwC;AACxC,QAAM,SAAc,CAAC;AAErB,aAAW,OAAO,WAAW;AACpB,WAAA,eAAe,QAAQ,KAAK;AAAA,MACjC,MAAM;AACE,cAAA,UAAU,UAAU,GAAG;AAC7B,eAAO,OAAO,YAAY,aAAa,QAAY,IAAA;AAAA,MACrD;AAAA,MACA,YAAY;AAAA,MACZ,cAAc;AAAA,IAAA,CACf;AAAA,EAAA;AAGI,SAAA;AACT;AAEO,MAAM,gBAYX;AAAA,EAOA,YAAY,QAKT;AAXa;AACA;AACR;AACQ;AACA;AAQd,SAAK,OAAO,OAAO;AACnB,SAAK,YAAY,OAAO;AACnB,SAAA,oBAAqB,OAAO,cAAc,CAAC;AAC3C,SAAA,gBAAiB,OAAO,iBAAiB;AAGzC,SAAA,aAAa,wBAAwB,KAAK,iBAAiB;AAAA,EAAA;AAAA,EAGlE,cAME,KAAiE;AACjE,WAAO,IAAI,gBAAgB;AAAA,MACzB,MAAM,KAAK;AAAA,MACX,WAAW,KAAK;AAAA,MAChB,YAAY,EAAE,GAAG,KAAK,mBAAmB,GAAG,IAAI;AAAA,MAChD,eAAe,KAAK;AAAA,IAAA,CACrB;AAAA,EAAA;AAEL;AAGO,SAAS,sBAOd,QAI2C;AACpC,SAAA,IAAI,gBAAgB,MAAM;AACnC;"}
+{"version":3,"file":"table-occurrence.js","sources":["../../../src/client/table-occurrence.ts"],"sourcesContent":["import { BaseTable, BaseTableWithIds } from \"./base-table\";\n\n// Helper type to extract schema from BaseTable\ntype ExtractSchema<BT> =\n  BT extends BaseTable<infer S, any, any, any> ? S : never;\n\n// Helper type to resolve navigation functions to their return types\ntype ResolveNavigation<T> = {\n  [K in keyof T]: T[K] extends () => infer R ? R : T[K];\n};\n\n// Helper to create a getter-based navigation object\nfunction createNavigationGetters<\n  Nav extends Record<\n    string,\n    | TableOccurrence<any, any, any, any>\n    | (() => TableOccurrence<any, any, any, any>)\n  >,\n>(navConfig: Nav): ResolveNavigation<Nav> {\n  const result: any = {};\n\n  for (const key in navConfig) {\n    Object.defineProperty(result, key, {\n      get() {\n        const navItem = navConfig[key];\n        return typeof navItem === \"function\" ? navItem() : navItem;\n      },\n      enumerable: true,\n      configurable: true,\n    });\n  }\n\n  return result as ResolveNavigation<Nav>;\n}\n\nexport class TableOccurrence<\n  BT extends BaseTable<any, any, any, any> = any,\n  Name extends string = string,\n  Nav extends Record<\n    string,\n    | TableOccurrence<any, any, any, any>\n    | (() => TableOccurrence<any, any, any, any>)\n  > = {},\n  DefSelect extends\n    | \"all\"\n    | \"schema\"\n    | readonly (keyof ExtractSchema<BT>)[] = \"schema\",\n> {\n  public readonly name: Name;\n  public readonly baseTable: BT;\n  protected _navigationConfig: Nav;\n  public readonly navigation: ResolveNavigation<Nav>;\n  public readonly defaultSelect: DefSelect;\n  constructor(config: {\n    readonly name: Name;\n    readonly baseTable: BT;\n    readonly navigation?: Nav;\n    readonly defaultSelect?: DefSelect;\n  }) {\n    this.name = config.name;\n    this.baseTable = config.baseTable;\n    this._navigationConfig = (config.navigation ?? {}) as Nav;\n    this.defaultSelect = (config.defaultSelect ?? \"schema\") as DefSelect;\n    // Create navigation getters that lazily resolve functions\n    this.navigation = createNavigationGetters(this._navigationConfig);\n  }\n\n  addNavigation<\n    NewNav extends Record<\n      string,\n      | TableOccurrence<any, any, any, any>\n      | (() => TableOccurrence<any, any, any, any>)\n    >,\n  >(nav: NewNav): TableOccurrence<BT, Name, Nav & NewNav, DefSelect> {\n    return new TableOccurrence({\n      name: this.name,\n      baseTable: this.baseTable,\n      navigation: { ...this._navigationConfig, ...nav } as Nav & NewNav,\n      defaultSelect: this.defaultSelect,\n    });\n  }\n\n  /**\n   * Returns the FileMaker table occurrence ID (FMTID) if available, or the table name.\n   * @returns The FMTID string or the table name\n   */\n  getTableId(): string {\n    // Check if fmtId exists (only on TableOccurrenceWithIds)\n    return \"fmtId\" in this && (this as any).fmtId\n      ? (this as any).fmtId\n      : this.name;\n  }\n\n  /**\n   * Returns the table occurrence name.\n   * @returns The table name\n   */\n  getTableName(): string {\n    return this.name;\n  }\n\n  /**\n   * Returns true if this TableOccurrence is using FileMaker table occurrence IDs.\n   */\n  isUsingTableId(): boolean {\n    return \"fmtId\" in this && this.fmtId !== undefined;\n  }\n}\n\n// Helper function to create TableOccurrence with proper type inference\nexport function createTableOccurrence<\n  const Name extends string,\n  BT extends BaseTable<any, any, any, any>,\n  DefSelect extends\n    | \"all\"\n    | \"schema\"\n    | readonly (keyof ExtractSchema<BT>)[] = \"schema\",\n>(config: {\n  name: Name;\n  baseTable: BT;\n  defaultSelect?: DefSelect;\n}): TableOccurrence<BT, Name, {}, DefSelect> {\n  return new TableOccurrence(config);\n}\n\n// Helper type to validate that all navigation values are TableOccurrenceWithIds\ntype ValidateNavWithIds<Nav> =\n  Nav extends Record<\n    string,\n    | TableOccurrenceWithIds<any, any, any, any>\n    | (() => TableOccurrenceWithIds<any, any, any, any>)\n  >\n    ? Nav\n    : \"Error: All navigation table occurrences must be TableOccurrenceWithIds when using TableOccurrenceWithIds\";\n\n/**\n * TableOccurrenceWithIds extends TableOccurrence to require:\n * 1. A BaseTableWithIds (which has fmfIds defined)\n * 2. A required fmtId for this table occurrence\n * 3. All navigation relationships must also be TableOccurrenceWithIds\n *\n * This ensures bidirectional type-level enforcement: if you use FileMaker IDs,\n * they must be defined on both the BaseTable (fmfIds) and TableOccurrence (fmtId),\n * and all related table occurrences in navigation must also have IDs.\n *\n * @template BT - Must be a BaseTableWithIds (enforced at type level)\n * @template Name - The name of this table occurrence\n * @template Nav - Navigation relationships (must all be TableOccurrenceWithIds)\n * @template DefSelect - Default select behavior\n *\n * @example\n * ```ts\n * const usersBaseWithIds = new BaseTableWithIds({\n *   schema: { id: z.string(), name: z.string() },\n *   idField: \"id\",\n *   fmfIds: { id: \"FMFID:1\", name: \"FMFID:2\" },\n * });\n *\n * const usersTO = new TableOccurrenceWithIds({\n *   name: \"users\",\n *   baseTable: usersBaseWithIds,\n *   fmtId: \"FMTID:100\",\n *   navigation: {\n *     contacts: () => contactsTO, // Must also be TableOccurrenceWithIds\n *   },\n * });\n * ```\n */\nexport class TableOccurrenceWithIds<\n  BT extends BaseTableWithIds<any, any, any, any> = any,\n  Name extends string = string,\n  Nav extends Record<\n    string,\n    | TableOccurrence<any, any, any, any>\n    | (() => TableOccurrence<any, any, any, any>)\n  > = {},\n  DefSelect extends\n    | \"all\"\n    | \"schema\"\n    | readonly (keyof ExtractSchema<BT>)[] = \"schema\",\n> extends TableOccurrence<BT, Name, Nav, DefSelect> {\n  public readonly fmtId: `FMTID:${string}`;\n\n  constructor(config: {\n    readonly name: Name;\n    readonly baseTable: BT;\n    readonly fmtId: `FMTID:${string}`;\n    readonly navigation?: ValidateNavWithIds<Nav>;\n    readonly defaultSelect?: DefSelect;\n  }) {\n    super({\n      ...config,\n      navigation: config.navigation as Nav,\n    });\n    this.fmtId = config.fmtId;\n  }\n}\n\n// Helper function to create TableOccurrenceWithIds with proper type inference\nexport function createTableOccurrenceWithIds<\n  const Name extends string,\n  BT extends BaseTableWithIds<any, any, any, any>,\n  DefSelect extends\n    | \"all\"\n    | \"schema\"\n    | readonly (keyof ExtractSchema<BT>)[] = \"schema\",\n>(config: {\n  name: Name;\n  baseTable: BT;\n  fmtId: `FMTID:${string}`;\n  defaultSelect?: DefSelect;\n}): TableOccurrenceWithIds<BT, Name, {}, DefSelect> {\n  return new TableOccurrenceWithIds(config);\n}\n"],"names":[],"mappings":";;;AAYA,SAAS,wBAMP,WAAwC;AACxC,QAAM,SAAc,CAAC;AAErB,aAAW,OAAO,WAAW;AACpB,WAAA,eAAe,QAAQ,KAAK;AAAA,MACjC,MAAM;AACE,cAAA,UAAU,UAAU,GAAG;AAC7B,eAAO,OAAO,YAAY,aAAa,QAAY,IAAA;AAAA,MACrD;AAAA,MACA,YAAY;AAAA,MACZ,cAAc;AAAA,IAAA,CACf;AAAA,EAAA;AAGI,SAAA;AACT;AAEO,MAAM,gBAYX;AAAA,EAMA,YAAY,QAKT;AAVa;AACA;AACN;AACM;AACA;AAOd,SAAK,OAAO,OAAO;AACnB,SAAK,YAAY,OAAO;AACnB,SAAA,oBAAqB,OAAO,cAAc,CAAC;AAC3C,SAAA,gBAAiB,OAAO,iBAAiB;AAEzC,SAAA,aAAa,wBAAwB,KAAK,iBAAiB;AAAA,EAAA;AAAA,EAGlE,cAME,KAAiE;AACjE,WAAO,IAAI,gBAAgB;AAAA,MACzB,MAAM,KAAK;AAAA,MACX,WAAW,KAAK;AAAA,MAChB,YAAY,EAAE,GAAG,KAAK,mBAAmB,GAAG,IAAI;AAAA,MAChD,eAAe,KAAK;AAAA,IAAA,CACrB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOH,aAAqB;AAEnB,WAAO,WAAW,QAAS,KAAa,QACnC,KAAa,QACd,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOX,eAAuB;AACrB,WAAO,KAAK;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMd,iBAA0B;AACjB,WAAA,WAAW,QAAQ,KAAK,UAAU;AAAA,EAAA;AAE7C;AAGO,SAAS,sBAOd,QAI2C;AACpC,SAAA,IAAI,gBAAgB,MAAM;AACnC;AA6CO,MAAM,+BAYH,gBAA0C;AAAA,EAGlD,YAAY,QAMT;AACK,UAAA;AAAA,MACJ,GAAG;AAAA,MACH,YAAY,OAAO;AAAA,IAAA,CACpB;AAZa;AAad,SAAK,QAAQ,OAAO;AAAA,EAAA;AAExB;AAGO,SAAS,6BAOd,QAKkD;AAC3C,SAAA,IAAI,uBAAuB,MAAM;AAC1C;"}

package/dist/esm/client/update-builder.js

@@ -2,6 +2,7 @@ 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);
 import { QueryBuilder } from "./query-builder.js";
+import { transformTableName, transformFieldNamesToIds } from "../transform.js";
 class UpdateBuilder {
   constructor(config) {
     __publicField(this, "tableName");
@@ -74,56 +75,59 @@ class ExecutableUpdateBuilder {
     this.queryBuilder = config.queryBuilder;
   }
   async execute(options) {
-    try {
-      let url;
-      if (this.mode === "byId") {
-        url = `/${this.databaseName}/${this.tableName}('${this.recordId}')`;
-      } else {
-        if (!this.queryBuilder) {
-          throw new Error("Query builder is required for filter-based update");
-        }
-        const queryString = this.queryBuilder.getQueryString();
-        const queryParams = queryString.startsWith(`/${this.tableName}`) ? queryString.slice(`/${this.tableName}`.length) : queryString;
-        url = `/${this.databaseName}/${this.tableName}${queryParams}`;
-      }
-      const response = await this.context._makeRequest(url, {
-        method: "PATCH",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(this.data),
-        ...options
-      });
-      let updatedCount = 0;
-      if (typeof response === "number") {
-        updatedCount = response;
-      } else if (response && typeof response === "object") {
-        updatedCount = response.updatedCount || 0;
+    var _a;
+    const tableId = this.occurrence ? transformTableName(this.occurrence) : this.tableName;
+    const transformedData = ((_a = this.occurrence) == null ? void 0 : _a.baseTable) ? transformFieldNamesToIds(this.data, this.occurrence.baseTable) : this.data;
+    let url;
+    if (this.mode === "byId") {
+      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;
+    } else {
+      if (!this.queryBuilder) {
+        throw new Error("Query builder is required for filter-based update");
       }
-      return { data: { updatedCount }, error: void 0 };
-    } catch (error) {
-      return {
-        data: void 0,
-        error: error instanceof Error ? error : new Error(String(error))
-      };
+      const queryString = this.queryBuilder.getQueryString();
+      const queryParams = queryString.startsWith(`/${tableId}`) ? queryString.slice(`/${tableId}`.length) : queryString.startsWith(`/${this.tableName}`) ? queryString.slice(`/${this.tableName}`.length) : queryString;
+      url = `/${this.databaseName}/${tableId}${queryParams}`;
+    }
+    const result = await this.context._makeRequest(url, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(transformedData),
+      ...options
+    });
+    if (result.error) {
+      return { data: void 0, error: result.error };
+    }
+    const response = result.data;
+    let updatedCount = 0;
+    if (typeof response === "number") {
+      updatedCount = response;
+    } else if (response && typeof response === "object") {
+      updatedCount = response.updatedCount || 0;
     }
+    return { data: { updatedCount }, error: void 0 };
   }
   getRequestConfig() {
+    var _a;
+    const tableId = this.occurrence ? transformTableName(this.occurrence) : this.tableName;
+    const transformedData = ((_a = this.occurrence) == null ? void 0 : _a.baseTable) ? transformFieldNamesToIds(this.data, this.occurrence.baseTable) : this.data;
     let url;
     if (this.mode === "byId") {
-      url = `/${this.databaseName}/${this.tableName}('${this.recordId}')`;
+      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;
     } else {
       if (!this.queryBuilder) {
         throw new Error("Query builder is required for filter-based update");
       }
       const queryString = this.queryBuilder.getQueryString();
-      const queryParams = queryString.startsWith(`/${this.tableName}`) ? queryString.slice(`/${this.tableName}`.length) : queryString;
-      url = `/${this.databaseName}/${this.tableName}${queryParams}`;
+      const queryParams = queryString.startsWith(`/${tableId}`) ? queryString.slice(`/${tableId}`.length) : queryString.startsWith(`/${this.tableName}`) ? queryString.slice(`/${this.tableName}`.length) : queryString;
+      url = `/${this.databaseName}/${tableId}${queryParams}`;
     }
     return {
       method: "PATCH",
       url,
-      body: JSON.stringify(this.data)
+      body: JSON.stringify(transformedData)
     };
   }
 }

package/dist/esm/client/update-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-builder.js","sources":["../../../src/client/update-builder.ts"],"sourcesContent":["import type {\n  ExecutionContext,\n  ExecutableBuilder,\n  Result,\n  WithSystemFields,\n} from \"../types\";\nimport type { TableOccurrence } from \"./table-occurrence\";\nimport type { BaseTable } from \"./base-table\";\nimport { QueryBuilder } from \"./query-builder\";\nimport { type FFetchOptions } from \"@fetchkit/ffetch\";\n\n/**\n * Initial update builder returned from EntitySet.update(data)\n * Requires calling .byId() or .where() before .execute() is available\n */\nexport class UpdateBuilder<\n  T extends Record<string, any>,\n  BT extends BaseTable<any, any, any, any>,\n> {\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private occurrence?: TableOccurrence<any, any, any, any>;\n  private data: Partial<T>;\n\n  constructor(config: {\n    occurrence?: TableOccurrence<any, any, any, any>;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    data: Partial<T>;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.data = config.data;\n  }\n\n  /**\n   * Update a single record by ID\n   * Returns the count of updated records (0 or 1)\n   */\n  byId(id: string | number): ExecutableUpdateBuilder<T, true> {\n    return new ExecutableUpdateBuilder<T, true>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      data: this.data,\n      mode: \"byId\",\n      recordId: id,\n    });\n  }\n\n  /**\n   * Update records matching a filter query\n   * Returns the count of updated records\n   * @param fn Callback that receives a QueryBuilder for building the filter\n   */\n  where(\n    fn: (\n      q: QueryBuilder<WithSystemFields<T>>,\n    ) => QueryBuilder<WithSystemFields<T>>,\n  ): ExecutableUpdateBuilder<T, true> {\n    // Create a QueryBuilder for the user to configure\n    const queryBuilder = new QueryBuilder<\n      WithSystemFields<T>,\n      keyof WithSystemFields<T>,\n      false,\n      false,\n      undefined\n    >({\n      occurrence: undefined,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n    });\n\n    // Let the user configure it\n    const configuredBuilder = fn(queryBuilder);\n\n    return new ExecutableUpdateBuilder<T, true>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      data: this.data,\n      mode: \"byFilter\",\n      queryBuilder: configuredBuilder,\n    });\n  }\n}\n\n/**\n * Executable update builder - has execute() method\n * Returned after calling .byId() or .where()\n * Both modes return the count of updated records\n */\nexport class ExecutableUpdateBuilder<\n  T extends Record<string, any>,\n  IsByFilter extends boolean,\n> implements ExecutableBuilder<{ updatedCount: number }>\n{\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private occurrence?: TableOccurrence<any, any, any, any>;\n  private data: Partial<T>;\n  private mode: \"byId\" | \"byFilter\";\n  private recordId?: string | number;\n  private queryBuilder?: QueryBuilder<any>;\n\n  constructor(config: {\n    occurrence?: TableOccurrence<any, any, any, any>;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    data: Partial<T>;\n    mode: \"byId\" | \"byFilter\";\n    recordId?: string | number;\n    queryBuilder?: QueryBuilder<any>;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.data = config.data;\n    this.mode = config.mode;\n    this.recordId = config.recordId;\n    this.queryBuilder = config.queryBuilder;\n  }\n\n  async execute(\n    options?: RequestInit & FFetchOptions,\n  ): Promise<Result<{ updatedCount: number }>> {\n    try {\n      let url: string;\n\n      if (this.mode === \"byId\") {\n        // Update single record by ID: PATCH /{database}/{table}('id')\n        url = `/${this.databaseName}/${this.tableName}('${this.recordId}')`;\n      } else {\n        // Update by filter: PATCH /{database}/{table}?$filter=...\n        if (!this.queryBuilder) {\n          throw new Error(\"Query builder is required for filter-based update\");\n        }\n\n        // Get the query string from the configured QueryBuilder\n        const queryString = this.queryBuilder.getQueryString();\n        // Remove the leading \"/\" from the query string as we'll build our own URL\n        const queryParams = queryString.startsWith(`/${this.tableName}`)\n          ? queryString.slice(`/${this.tableName}`.length)\n          : queryString;\n\n        url = `/${this.databaseName}/${this.tableName}${queryParams}`;\n      }\n\n      // Make PATCH request with JSON body\n      const response = await this.context._makeRequest(url, {\n        method: \"PATCH\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(this.data),\n        ...options,\n      });\n\n      // Both byId and byFilter return affected row count\n      let updatedCount = 0;\n\n      if (typeof response === \"number\") {\n        updatedCount = response;\n      } else if (response && typeof response === \"object\") {\n        // Check if the response has a count property (fallback)\n        updatedCount = (response as any).updatedCount || 0;\n      }\n\n      return { data: { updatedCount }, error: undefined };\n    } catch (error) {\n      return {\n        data: undefined,\n        error: error instanceof Error ? error : new Error(String(error)),\n      };\n    }\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    let url: string;\n\n    if (this.mode === \"byId\") {\n      url = `/${this.databaseName}/${this.tableName}('${this.recordId}')`;\n    } else {\n      if (!this.queryBuilder) {\n        throw new Error(\"Query builder is required for filter-based update\");\n      }\n\n      const queryString = this.queryBuilder.getQueryString();\n      const queryParams = queryString.startsWith(`/${this.tableName}`)\n        ? queryString.slice(`/${this.tableName}`.length)\n        : queryString;\n\n      url = `/${this.databaseName}/${this.tableName}${queryParams}`;\n    }\n\n    return {\n      method: \"PATCH\",\n      url,\n      body: JSON.stringify(this.data),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-builder.js","sources":["../../../src/client/update-builder.ts"],"sourcesContent":["import type {\n  ExecutionContext,\n  ExecutableBuilder,\n  Result,\n  WithSystemFields,\n} from \"../types\";\nimport type { TableOccurrence } from \"./table-occurrence\";\nimport type { BaseTable } from \"./base-table\";\nimport { QueryBuilder } from \"./query-builder\";\nimport { type FFetchOptions } from \"@fetchkit/ffetch\";\nimport {\n  transformFieldNamesToIds,\n  transformTableName,\n} from \"../transform\";\n\n/**\n * Initial update builder returned from EntitySet.update(data)\n * Requires calling .byId() or .where() before .execute() is available\n */\nexport class UpdateBuilder<\n  T extends Record<string, any>,\n  BT extends BaseTable<any, any, any, any>,\n> {\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private occurrence?: TableOccurrence<any, any, any, any>;\n  private data: Partial<T>;\n\n  constructor(config: {\n    occurrence?: TableOccurrence<any, any, any, any>;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    data: Partial<T>;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.data = config.data;\n  }\n\n  /**\n   * Update a single record by ID\n   * Returns the count of updated records (0 or 1)\n   */\n  byId(id: string | number): ExecutableUpdateBuilder<T, true> {\n    return new ExecutableUpdateBuilder<T, true>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      data: this.data,\n      mode: \"byId\",\n      recordId: id,\n    });\n  }\n\n  /**\n   * Update records matching a filter query\n   * Returns the count of updated records\n   * @param fn Callback that receives a QueryBuilder for building the filter\n   */\n  where(\n    fn: (\n      q: QueryBuilder<WithSystemFields<T>>,\n    ) => QueryBuilder<WithSystemFields<T>>,\n  ): ExecutableUpdateBuilder<T, true> {\n    // Create a QueryBuilder for the user to configure\n    const queryBuilder = new QueryBuilder<\n      WithSystemFields<T>,\n      keyof WithSystemFields<T>,\n      false,\n      false,\n      undefined\n    >({\n      occurrence: undefined,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n    });\n\n    // Let the user configure it\n    const configuredBuilder = fn(queryBuilder);\n\n    return new ExecutableUpdateBuilder<T, true>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      data: this.data,\n      mode: \"byFilter\",\n      queryBuilder: configuredBuilder,\n    });\n  }\n}\n\n/**\n * Executable update builder - has execute() method\n * Returned after calling .byId() or .where()\n * Both modes return the count of updated records\n */\nexport class ExecutableUpdateBuilder<\n  T extends Record<string, any>,\n  IsByFilter extends boolean,\n> implements ExecutableBuilder<{ updatedCount: number }>\n{\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private occurrence?: TableOccurrence<any, any, any, any>;\n  private data: Partial<T>;\n  private mode: \"byId\" | \"byFilter\";\n  private recordId?: string | number;\n  private queryBuilder?: QueryBuilder<any>;\n\n  constructor(config: {\n    occurrence?: TableOccurrence<any, any, any, any>;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    data: Partial<T>;\n    mode: \"byId\" | \"byFilter\";\n    recordId?: string | number;\n    queryBuilder?: QueryBuilder<any>;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.data = config.data;\n    this.mode = config.mode;\n    this.recordId = config.recordId;\n    this.queryBuilder = config.queryBuilder;\n  }\n\n  async execute(\n    options?: RequestInit & FFetchOptions,\n  ): Promise<Result<{ updatedCount: number }>> {\n    // Transform table name to FMTID if using entity IDs\n    const tableId = this.occurrence\n      ? transformTableName(this.occurrence)\n      : this.tableName;\n\n    // Transform field names to FMFIDs if using entity IDs\n    const transformedData = this.occurrence?.baseTable\n      ? transformFieldNamesToIds(this.data, this.occurrence.baseTable)\n      : this.data;\n\n    let url: string;\n\n    if (this.mode === \"byId\") {\n      // Update single record by ID: PATCH /{database}/{table}('id')\n      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;\n    } else {\n      // Update by filter: PATCH /{database}/{table}?$filter=...\n      if (!this.queryBuilder) {\n        throw new Error(\"Query builder is required for filter-based update\");\n      }\n\n      // Get the query string from the configured QueryBuilder\n      const queryString = this.queryBuilder.getQueryString();\n      // The query string will have the tableId already transformed by QueryBuilder\n      // Remove the leading \"/\" and table name from the query string as we'll build our own URL\n      const queryParams = queryString.startsWith(`/${tableId}`)\n        ? queryString.slice(`/${tableId}`.length)\n        : queryString.startsWith(`/${this.tableName}`)\n          ? queryString.slice(`/${this.tableName}`.length)\n          : queryString;\n\n      url = `/${this.databaseName}/${tableId}${queryParams}`;\n    }\n\n    // Make PATCH request with JSON body\n    const result = await this.context._makeRequest(url, {\n      method: \"PATCH\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(transformedData),\n      ...options,\n    });\n\n    if (result.error) {\n      return { data: undefined, error: result.error };\n    }\n\n    const response = result.data;\n\n    // Both byId and byFilter return affected row count\n    let updatedCount = 0;\n\n    if (typeof response === \"number\") {\n      updatedCount = response;\n    } else if (response && typeof response === \"object\") {\n      // Check if the response has a count property (fallback)\n      updatedCount = (response as any).updatedCount || 0;\n    }\n\n    return { data: { updatedCount }, error: undefined };\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    // Transform table name to FMTID if using entity IDs\n    const tableId = this.occurrence\n      ? transformTableName(this.occurrence)\n      : this.tableName;\n\n    // Transform field names to FMFIDs if using entity IDs\n    const transformedData = this.occurrence?.baseTable\n      ? transformFieldNamesToIds(this.data, this.occurrence.baseTable)\n      : this.data;\n\n    let url: string;\n\n    if (this.mode === \"byId\") {\n      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;\n    } else {\n      if (!this.queryBuilder) {\n        throw new Error(\"Query builder is required for filter-based update\");\n      }\n\n      const queryString = this.queryBuilder.getQueryString();\n      const queryParams = queryString.startsWith(`/${tableId}`)\n        ? queryString.slice(`/${tableId}`.length)\n        : queryString.startsWith(`/${this.tableName}`)\n          ? queryString.slice(`/${this.tableName}`.length)\n          : queryString;\n\n      url = `/${this.databaseName}/${tableId}${queryParams}`;\n    }\n\n    return {\n      method: \"PATCH\",\n      url,\n      body: JSON.stringify(transformedData),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,60 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+/**
+ * Base class for all fmodata errors
+ */
+export declare abstract class FMODataError extends Error {
+    abstract readonly kind: string;
+    readonly timestamp: Date;
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class HTTPError extends FMODataError {
+    readonly kind: "HTTPError";
+    readonly url: string;
+    readonly status: number;
+    readonly statusText: string;
+    readonly response?: any;
+    constructor(url: string, status: number, statusText: string, response?: any);
+    is4xx(): boolean;
+    is5xx(): boolean;
+    isNotFound(): boolean;
+    isUnauthorized(): boolean;
+    isForbidden(): boolean;
+}
+export declare class ODataError extends FMODataError {
+    readonly kind: "ODataError";
+    readonly url: string;
+    readonly code?: string;
+    readonly details?: any;
+    constructor(url: string, message: string, code?: string, details?: any);
+}
+export declare class ValidationError extends FMODataError {
+    readonly kind: "ValidationError";
+    readonly field?: string;
+    readonly issues: readonly StandardSchemaV1.Issue[];
+    readonly value?: unknown;
+    constructor(message: string, issues: readonly StandardSchemaV1.Issue[], options?: {
+        field?: string;
+        value?: unknown;
+        cause?: Error["cause"];
+    });
+}
+export declare class ResponseStructureError extends FMODataError {
+    readonly kind: "ResponseStructureError";
+    readonly expected: string;
+    readonly received: any;
+    constructor(expected: string, received: any);
+}
+export declare class RecordCountMismatchError extends FMODataError {
+    readonly kind: "RecordCountMismatchError";
+    readonly expected: number | "one" | "at-most-one";
+    readonly received: number;
+    constructor(expected: number | "one" | "at-most-one", received: number);
+}
+export declare function isHTTPError(error: unknown): error is HTTPError;
+export declare function isValidationError(error: unknown): error is ValidationError;
+export declare function isODataError(error: unknown): error is ODataError;
+export declare function isResponseStructureError(error: unknown): error is ResponseStructureError;
+export declare function isRecordCountMismatchError(error: unknown): error is RecordCountMismatchError;
+export declare function isFMODataError(error: unknown): error is FMODataError;
+export type { TimeoutError, AbortError, NetworkError, RetryLimitError, CircuitOpenError, } from '@fetchkit/ffetch';
+export type FMODataErrorType = import('@fetchkit/ffetch').TimeoutError | import('@fetchkit/ffetch').AbortError | import('@fetchkit/ffetch').NetworkError | import('@fetchkit/ffetch').RetryLimitError | import('@fetchkit/ffetch').CircuitOpenError | HTTPError | ODataError | ValidationError | ResponseStructureError | RecordCountMismatchError;

package/dist/esm/errors.js

@@ -0,0 +1,122 @@
+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 FMODataError extends Error {
+  constructor(message, options) {
+    super(message, options);
+    __publicField(this, "timestamp");
+    this.name = this.constructor.name;
+    this.timestamp = /* @__PURE__ */ new Date();
+  }
+}
+class HTTPError extends FMODataError {
+  constructor(url, status, statusText, response) {
+    super(`HTTP ${status} ${statusText} for ${url}`);
+    __publicField(this, "kind", "HTTPError");
+    __publicField(this, "url");
+    __publicField(this, "status");
+    __publicField(this, "statusText");
+    __publicField(this, "response");
+    this.url = url;
+    this.status = status;
+    this.statusText = statusText;
+    this.response = response;
+  }
+  // Helper methods for common status checks
+  is4xx() {
+    return this.status >= 400 && this.status < 500;
+  }
+  is5xx() {
+    return this.status >= 500 && this.status < 600;
+  }
+  isNotFound() {
+    return this.status === 404;
+  }
+  isUnauthorized() {
+    return this.status === 401;
+  }
+  isForbidden() {
+    return this.status === 403;
+  }
+}
+class ODataError extends FMODataError {
+  constructor(url, message, code, details) {
+    super(`OData error: ${message}`);
+    __publicField(this, "kind", "ODataError");
+    __publicField(this, "url");
+    __publicField(this, "code");
+    __publicField(this, "details");
+    this.url = url;
+    this.code = code;
+    this.details = details;
+  }
+}
+class ValidationError extends FMODataError {
+  constructor(message, issues, options) {
+    super(
+      message,
+      (options == null ? void 0 : options.cause) !== void 0 ? { cause: options.cause } : void 0
+    );
+    __publicField(this, "kind", "ValidationError");
+    __publicField(this, "field");
+    __publicField(this, "issues");
+    __publicField(this, "value");
+    this.field = options == null ? void 0 : options.field;
+    this.issues = issues;
+    this.value = options == null ? void 0 : options.value;
+  }
+}
+class ResponseStructureError extends FMODataError {
+  constructor(expected, received) {
+    super(`Invalid response structure: expected ${expected}`);
+    __publicField(this, "kind", "ResponseStructureError");
+    __publicField(this, "expected");
+    __publicField(this, "received");
+    this.expected = expected;
+    this.received = received;
+  }
+}
+class RecordCountMismatchError extends FMODataError {
+  constructor(expected, received) {
+    const expectedStr = typeof expected === "number" ? expected : expected;
+    super(`Expected ${expectedStr} record(s), but received ${received}`);
+    __publicField(this, "kind", "RecordCountMismatchError");
+    __publicField(this, "expected");
+    __publicField(this, "received");
+    this.expected = expected;
+    this.received = received;
+  }
+}
+function isHTTPError(error) {
+  return error instanceof HTTPError;
+}
+function isValidationError(error) {
+  return error instanceof ValidationError;
+}
+function isODataError(error) {
+  return error instanceof ODataError;
+}
+function isResponseStructureError(error) {
+  return error instanceof ResponseStructureError;
+}
+function isRecordCountMismatchError(error) {
+  return error instanceof RecordCountMismatchError;
+}
+function isFMODataError(error) {
+  return error instanceof FMODataError;
+}
+export {
+  FMODataError,
+  HTTPError,
+  ODataError,
+  RecordCountMismatchError,
+  ResponseStructureError,
+  ValidationError,
+  isFMODataError,
+  isHTTPError,
+  isODataError,
+  isRecordCountMismatchError,
+  isResponseStructureError,
+  isValidationError
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +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\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\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 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 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  | ValidationError\n  | ResponseStructureError\n  | RecordCountMismatchError;\n"],"names":[],"mappings":";;;AAKO,MAAe,qBAAqB,MAAM;AAAA,EAI/C,YAAY,SAAiB,SAAwB;AACnD,UAAM,SAAS,OAAO;AAHf;AAIF,SAAA,OAAO,KAAK,YAAY;AACxB,SAAA,gCAAgB,KAAK;AAAA,EAAA;AAE9B;AAMO,MAAM,kBAAkB,aAAa;AAAA,EAO1C,YAAY,KAAa,QAAgB,YAAoB,UAAgB;AAC3E,UAAM,QAAQ,MAAM,IAAI,UAAU,QAAQ,GAAG,EAAE;AAPxC,gCAAO;AACP;AACA;AACA;AACA;AAIP,SAAK,MAAM;AACX,SAAK,SAAS;AACd,SAAK,aAAa;AAClB,SAAK,WAAW;AAAA,EAAA;AAAA;AAAA,EAIlB,QAAiB;AACf,WAAO,KAAK,UAAU,OAAO,KAAK,SAAS;AAAA,EAAA;AAAA,EAG7C,QAAiB;AACf,WAAO,KAAK,UAAU,OAAO,KAAK,SAAS;AAAA,EAAA;AAAA,EAG7C,aAAsB;AACpB,WAAO,KAAK,WAAW;AAAA,EAAA;AAAA,EAGzB,iBAA0B;AACxB,WAAO,KAAK,WAAW;AAAA,EAAA;AAAA,EAGzB,cAAuB;AACrB,WAAO,KAAK,WAAW;AAAA,EAAA;AAE3B;AAMO,MAAM,mBAAmB,aAAa;AAAA,EAM3C,YAAY,KAAa,SAAiB,MAAe,SAAe;AAChE,UAAA,gBAAgB,OAAO,EAAE;AANxB,gCAAO;AACP;AACA;AACA;AAIP,SAAK,MAAM;AACX,SAAK,OAAO;AACZ,SAAK,UAAU;AAAA,EAAA;AAEnB;AAMO,MAAM,wBAAwB,aAAa;AAAA,EAMhD,YACE,SACA,QACA,SAKA;AACA;AAAA,MACE;AAAA,OACA,mCAAS,WAAU,SAAY,EAAE,OAAO,QAAQ,UAAU;AAAA,IAC5D;AAjBO,gCAAO;AACP;AACA;AACA;AAeP,SAAK,QAAQ,mCAAS;AACtB,SAAK,SAAS;AACd,SAAK,QAAQ,mCAAS;AAAA,EAAA;AAE1B;AAEO,MAAM,+BAA+B,aAAa;AAAA,EAKvD,YAAY,UAAkB,UAAe;AACrC,UAAA,wCAAwC,QAAQ,EAAE;AALjD,gCAAO;AACP;AACA;AAIP,SAAK,WAAW;AAChB,SAAK,WAAW;AAAA,EAAA;AAEpB;AAEO,MAAM,iCAAiC,aAAa;AAAA,EAKzD,YAAY,UAA0C,UAAkB;AACtE,UAAM,cAAc,OAAO,aAAa,WAAW,WAAW;AAC9D,UAAM,YAAY,WAAW,4BAA4B,QAAQ,EAAE;AAN5D,gCAAO;AACP;AACA;AAKP,SAAK,WAAW;AAChB,SAAK,WAAW;AAAA,EAAA;AAEpB;AAMO,SAAS,YAAY,OAAoC;AAC9D,SAAO,iBAAiB;AAC1B;AAEO,SAAS,kBAAkB,OAA0C;AAC1E,SAAO,iBAAiB;AAC1B;AAEO,SAAS,aAAa,OAAqC;AAChE,SAAO,iBAAiB;AAC1B;AAEO,SAAS,yBACd,OACiC;AACjC,SAAO,iBAAiB;AAC1B;AAEO,SAAS,2BACd,OACmC;AACnC,SAAO,iBAAiB;AAC1B;AAEO,SAAS,eAAe,OAAuC;AACpE,SAAO,iBAAiB;AAC1B;"}

package/dist/esm/index.d.ts

@@ -1,7 +1,10 @@
-export { BaseTable } from './client/base-table.js';
-export { TableOccurrence, createTableOccurrence, } from './client/table-occurrence.js';
+export { BaseTable, BaseTableWithIds } from './client/base-table.js';
+export { TableOccurrence, createTableOccurrence, TableOccurrenceWithIds, createTableOccurrenceWithIds, } from './client/table-occurrence.js';
 export { FMServerConnection } from './client/filemaker-odata.js';
 export type { Database } from './client/database.js';
 export type { EntitySet } from './client/entity-set.js';
 export type { Result, InferSchemaType, InsertData, UpdateData, ODataRecordMetadata, } 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, ValidationError, ResponseStructureError, RecordCountMismatchError, isHTTPError, isValidationError, isODataError, isResponseStructureError, isRecordCountMismatchError, isFMODataError, } from './errors.js';
+export type { FMODataErrorType } from './errors.js';

package/dist/esm/index.js

@@ -1,10 +1,32 @@
-import { BaseTable } from "./client/base-table.js";
-import { TableOccurrence, createTableOccurrence } from "./client/table-occurrence.js";
+import { BaseTable, BaseTableWithIds } from "./client/base-table.js";
+import { TableOccurrence, TableOccurrenceWithIds, createTableOccurrence, createTableOccurrenceWithIds } from "./client/table-occurrence.js";
 import { FMServerConnection } from "./client/filemaker-odata.js";
+import { AbortError, CircuitOpenError, NetworkError, RetryLimitError, TimeoutError } from "@fetchkit/ffetch";
+import { FMODataError, HTTPError, ODataError, RecordCountMismatchError, ResponseStructureError, ValidationError, isFMODataError, isHTTPError, isODataError, isRecordCountMismatchError, isResponseStructureError, isValidationError } from "./errors.js";
 export {
+  AbortError,
   BaseTable,
+  BaseTableWithIds,
+  CircuitOpenError,
+  FMODataError,
   FMServerConnection,
+  HTTPError,
+  NetworkError,
+  ODataError,
+  RecordCountMismatchError,
+  ResponseStructureError,
+  RetryLimitError,
   TableOccurrence,
-  createTableOccurrence
+  TableOccurrenceWithIds,
+  TimeoutError,
+  ValidationError,
+  createTableOccurrence,
+  createTableOccurrenceWithIds,
+  isFMODataError,
+  isHTTPError,
+  isODataError,
+  isRecordCountMismatchError,
+  isResponseStructureError,
+  isValidationError
 };
 //# 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/transform.d.ts

@@ -0,0 +1,56 @@
+import { BaseTable } from './client/base-table.js';
+import { TableOccurrence } from './client/table-occurrence.js';
+/**
+ * Transforms field names to FileMaker field IDs (FMFID) in an object
+ * @param data - Object with field names as keys
+ * @param baseTable - BaseTable instance to get field IDs from
+ * @returns Object with FMFID keys instead of field names
+ */
+export declare function transformFieldNamesToIds<T extends Record<string, any>>(data: T, baseTable: BaseTable<any, any, any, any>): Record<string, any>;
+/**
+ * Transforms FileMaker field IDs (FMFID) to field names in an object
+ * @param data - Object with FMFID keys
+ * @param baseTable - BaseTable instance to get field names from
+ * @returns Object with field names as keys instead of FMFIDs
+ */
+export declare function transformFieldIdsToNames<T extends Record<string, any>>(data: T, baseTable: BaseTable<any, any, any, any>): Record<string, any>;
+/**
+ * Transforms a field name to FMFID or returns the field name if not using IDs
+ * @param fieldName - The field name to transform
+ * @param baseTable - BaseTable instance to get field ID from
+ * @returns The FMFID or field name
+ */
+export declare function transformFieldName(fieldName: string, baseTable: BaseTable<any, any, any, any>): string;
+/**
+ * Transforms a table occurrence name to FMTID or returns the name if not using IDs
+ * @param occurrence - TableOccurrence instance to get table ID from
+ * @returns The FMTID or table name
+ */
+export declare function transformTableName(occurrence: TableOccurrence<any, any, any, any>): string;
+/**
+ * Transforms response data by converting field IDs back to field names recursively.
+ * Handles both single records and arrays of records, as well as nested expand relationships.
+ *
+ * @param data - Response data from FileMaker (can be single record, array, or wrapped in value property)
+ * @param baseTable - BaseTable instance for the main table
+ * @param expandConfigs - Configuration for expanded relations (optional)
+ * @returns Transformed data with field names instead of IDs
+ */
+export declare function transformResponseFields(data: any, baseTable: BaseTable<any, any, any, any>, expandConfigs?: Array<{
+    relation: string;
+    occurrence?: TableOccurrence<any, any, any, any>;
+}>): any;
+/**
+ * Transforms an array of field names to FMFIDs
+ * @param fieldNames - Array of field names
+ * @param baseTable - BaseTable instance to get field IDs from
+ * @returns Array of FMFIDs or field names
+ */
+export declare function transformFieldNamesArray(fieldNames: string[], baseTable: BaseTable<any, any, any, any>): string[];
+/**
+ * Transforms a field name in an orderBy string (e.g., "name desc" -> "FMFID:1 desc")
+ * @param orderByString - The orderBy string (field name with optional asc/desc)
+ * @param baseTable - BaseTable instance to get field ID from
+ * @returns Transformed orderBy string with FMFID
+ */
+export declare function transformOrderByField(orderByString: string, baseTable: BaseTable<any, any, any, any>): string;

package/dist/esm/transform.js

@@ -0,0 +1,107 @@
+function transformFieldNamesToIds(data, baseTable) {
+  if (!baseTable.isUsingFieldIds()) {
+    return data;
+  }
+  const transformed = {};
+  for (const [fieldName, value] of Object.entries(data)) {
+    const fieldId = baseTable.getFieldId(fieldName);
+    transformed[fieldId] = value;
+  }
+  return transformed;
+}
+function transformFieldName(fieldName, baseTable) {
+  return baseTable.getFieldId(fieldName);
+}
+function transformTableName(occurrence) {
+  return occurrence.getTableId();
+}
+function transformResponseFields(data, baseTable, expandConfigs) {
+  if (!baseTable.isUsingFieldIds()) {
+    return data;
+  }
+  if (data === null || data === void 0) {
+    return data;
+  }
+  if (data.value && Array.isArray(data.value)) {
+    return {
+      ...data,
+      value: data.value.map(
+        (record) => transformSingleRecord(record, baseTable, expandConfigs)
+      )
+    };
+  }
+  if (Array.isArray(data)) {
+    return data.map(
+      (record) => transformSingleRecord(record, baseTable, expandConfigs)
+    );
+  }
+  return transformSingleRecord(data, baseTable, expandConfigs);
+}
+function transformSingleRecord(record, baseTable, expandConfigs) {
+  if (!record || typeof record !== "object") {
+    return record;
+  }
+  const transformed = {};
+  for (const [key, value] of Object.entries(record)) {
+    if (key.startsWith("@")) {
+      transformed[key] = value;
+      continue;
+    }
+    let expandConfig = expandConfigs == null ? void 0 : expandConfigs.find((ec) => ec.relation === key);
+    if (!expandConfig && key.startsWith("FMTID:")) {
+      expandConfig = expandConfigs == null ? void 0 : expandConfigs.find(
+        (ec) => ec.occurrence && ec.occurrence.isUsingTableId() && ec.occurrence.getTableId() === key
+      );
+    }
+    if (expandConfig && expandConfig.occurrence) {
+      const relationKey = expandConfig.relation;
+      if (Array.isArray(value)) {
+        transformed[relationKey] = value.map(
+          (nestedRecord) => transformSingleRecord(
+            nestedRecord,
+            expandConfig.occurrence.baseTable,
+            void 0
+            // Don't pass nested expand configs for now
+          )
+        );
+      } else if (value && typeof value === "object") {
+        transformed[relationKey] = transformSingleRecord(
+          value,
+          expandConfig.occurrence.baseTable,
+          void 0
+        );
+      } else {
+        transformed[relationKey] = value;
+      }
+      continue;
+    }
+    const fieldName = baseTable.getFieldName(key);
+    transformed[fieldName] = value;
+  }
+  return transformed;
+}
+function transformFieldNamesArray(fieldNames, baseTable) {
+  if (!baseTable.isUsingFieldIds()) {
+    return fieldNames;
+  }
+  return fieldNames.map((fieldName) => baseTable.getFieldId(fieldName));
+}
+function transformOrderByField(orderByString, baseTable) {
+  if (!baseTable.isUsingFieldIds()) {
+    return orderByString;
+  }
+  const parts = orderByString.trim().split(/\s+/);
+  const fieldName = parts[0];
+  const direction = parts[1];
+  const fieldId = baseTable.getFieldId(fieldName);
+  return direction ? `${fieldId} ${direction}` : fieldId;
+}
+export {
+  transformFieldName,
+  transformFieldNamesArray,
+  transformFieldNamesToIds,
+  transformOrderByField,
+  transformResponseFields,
+  transformTableName
+};
+//# sourceMappingURL=transform.js.map

package/dist/esm/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sources":["../../src/transform.ts"],"sourcesContent":["import type { BaseTable } from \"./client/base-table\";\nimport type { TableOccurrence } from \"./client/table-occurrence\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\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 baseTable - BaseTable instance to get field IDs from\n * @returns Object with FMFID keys instead of field names\n */\nexport function transformFieldNamesToIds<T extends Record<string, any>>(\n  data: T,\n  baseTable: BaseTable<any, any, any, any>,\n): Record<string, any> {\n  if (!baseTable.isUsingFieldIds()) {\n    return data;\n  }\n\n  const transformed: Record<string, any> = {};\n  for (const [fieldName, value] of Object.entries(data)) {\n    const fieldId = baseTable.getFieldId(fieldName as any);\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 baseTable - BaseTable instance to get field names from\n * @returns Object with field names as keys instead of FMFIDs\n */\nexport function transformFieldIdsToNames<T extends Record<string, any>>(\n  data: T,\n  baseTable: BaseTable<any, any, any, any>,\n): Record<string, any> {\n  if (!baseTable.isUsingFieldIds()) {\n    return data;\n  }\n\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 = baseTable.getFieldName(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 baseTable - BaseTable instance to get field ID from\n * @returns The FMFID or field name\n */\nexport function transformFieldName(\n  fieldName: string,\n  baseTable: BaseTable<any, any, any, any>,\n): string {\n  return baseTable.getFieldId(fieldName as any);\n}\n\n/**\n * Transforms a table occurrence name to FMTID or returns the name if not using IDs\n * @param occurrence - TableOccurrence instance to get table ID from\n * @returns The FMTID or table name\n */\nexport function transformTableName(\n  occurrence: TableOccurrence<any, any, any, any>,\n): string {\n  return occurrence.getTableId();\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 baseTable - BaseTable 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  data: any,\n  baseTable: BaseTable<any, any, any, any>,\n  expandConfigs?: Array<{\n    relation: string;\n    occurrence?: TableOccurrence<any, any, any, any>;\n  }>,\n): any {\n  if (!baseTable.isUsingFieldIds()) {\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      value: data.value.map((record: any) =>\n        transformSingleRecord(record, baseTable, expandConfigs),\n      ),\n    };\n  }\n\n  // Handle array of records\n  if (Array.isArray(data)) {\n    return data.map((record) =>\n      transformSingleRecord(record, baseTable, expandConfigs),\n    );\n  }\n\n  // Handle single record\n  return transformSingleRecord(data, baseTable, expandConfigs);\n}\n\n/**\n * Transforms a single record, converting field IDs to names and handling nested expands\n */\nfunction transformSingleRecord(\n  record: any,\n  baseTable: BaseTable<any, any, any, any>,\n  expandConfigs?: Array<{\n    relation: string;\n    occurrence?: TableOccurrence<any, any, any, any>;\n  }>,\n): any {\n  if (!record || typeof record !== \"object\") {\n    return record;\n  }\n\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) =>\n          ec.occurrence &&\n          ec.occurrence.isUsingTableId() &&\n          ec.occurrence.getTableId() === key,\n      );\n    }\n    \n    if (expandConfig && expandConfig.occurrence) {\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        transformed[relationKey] = value.map((nestedRecord) =>\n          transformSingleRecord(\n            nestedRecord,\n            expandConfig.occurrence!.baseTable,\n            undefined, // Don't pass nested expand configs for now\n          ),\n        );\n      } else if (value && typeof value === \"object\") {\n        transformed[relationKey] = transformSingleRecord(\n          value,\n          expandConfig.occurrence.baseTable,\n          undefined,\n        );\n      } else {\n        transformed[relationKey] = value;\n      }\n      continue;\n    }\n\n    // Transform field ID to field name\n    const fieldName = baseTable.getFieldName(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 baseTable - BaseTable instance to get field IDs from\n * @returns Array of FMFIDs or field names\n */\nexport function transformFieldNamesArray(\n  fieldNames: string[],\n  baseTable: BaseTable<any, any, any, any>,\n): string[] {\n  if (!baseTable.isUsingFieldIds()) {\n    return fieldNames;\n  }\n\n  return fieldNames.map((fieldName) => baseTable.getFieldId(fieldName as any));\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 baseTable - BaseTable instance to get field ID from\n * @returns Transformed orderBy string with FMFID\n */\nexport function transformOrderByField(\n  orderByString: string,\n  baseTable: BaseTable<any, any, any, any>,\n): string {\n  if (!baseTable.isUsingFieldIds()) {\n    return orderByString;\n  }\n\n  // Parse the orderBy string to extract field name and direction\n  const parts = orderByString.trim().split(/\\s+/);\n  const fieldName = parts[0];\n  const direction = parts[1]; // \"asc\" or \"desc\" or undefined\n\n  const fieldId = baseTable.getFieldId(fieldName as any);\n  return direction ? `${fieldId} ${direction}` : fieldId;\n}\n\n"],"names":[],"mappings":"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"}