@proofkit/fmodata 0.1.0-alpha.11 → 0.1.0-alpha.12

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

@@ -1 +1 @@
-{"version":3,"file":"record-builder.js","sources":["../../../src/client/record-builder.ts"],"sourcesContent":["import type {\n  ExecutionContext,\n  ExecutableBuilder,\n  Result,\n  ODataRecordMetadata,\n  ODataFieldResponse,\n  InferSchemaType,\n  ExecuteOptions,\n  WithSystemFields,\n  ConditionallyWithODataAnnotations,\n} from \"../types\";\nimport type { TableOccurrence } from \"./table-occurrence\";\nimport type { BaseTable } from \"./base-table\";\nimport {\n  transformTableName,\n  transformResponseFields,\n  getTableIdentifiers,\n  transformFieldNamesArray,\n} from \"../transform\";\nimport { QueryBuilder } from \"./query-builder\";\nimport { validateSingleResponse, type ExpandValidationConfig } from \"../validation\";\nimport { type FFetchOptions } from \"@fetchkit/ffetch\";\nimport { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { QueryOptions } from \"odata-query\";\nimport buildQuery from \"odata-query\";\n\n// Helper type to extract schema from a TableOccurrence\ntype ExtractSchemaFromOccurrence<O> =\n  O extends TableOccurrence<infer BT, any, any, any>\n    ? BT extends BaseTable<infer S, any, any, any>\n      ? S\n      : never\n    : never;\n\n// Helper type to extract navigation relation names from an occurrence\ntype ExtractNavigationNames<\n  O extends TableOccurrence<any, any, any, any> | undefined,\n> =\n  O extends TableOccurrence<any, any, infer Nav, any>\n    ? Nav extends Record<string, any>\n      ? keyof Nav & string\n      : never\n    : never;\n\n// Helper type to find target occurrence by relation name\ntype FindNavigationTarget<\n  O extends TableOccurrence<any, any, any, any> | undefined,\n  Name extends string,\n> =\n  O extends TableOccurrence<any, any, infer Nav, any>\n    ? Nav extends Record<string, any>\n      ? Name extends keyof Nav\n        ? Nav[Name]\n        : TableOccurrence<\n            BaseTable<Record<string, StandardSchemaV1>, any, any, any>,\n            any,\n            any,\n            any\n          >\n      : TableOccurrence<\n          BaseTable<Record<string, StandardSchemaV1>, any, any, any>,\n          any,\n          any,\n          any\n        >\n    : TableOccurrence<\n        BaseTable<Record<string, StandardSchemaV1>, any, any, any>,\n        any,\n        any,\n        any\n      >;\n\n// Helper type to get the inferred schema type from a target occurrence\ntype GetTargetSchemaType<\n  O extends TableOccurrence<any, any, any, any> | undefined,\n  Rel extends string,\n> = [FindNavigationTarget<O, Rel>] extends [\n  TableOccurrence<infer BT, any, any, any>,\n]\n  ? [BT] extends [BaseTable<infer S, any, any, any>]\n    ? [S] extends [Record<string, StandardSchemaV1>]\n      ? InferSchemaType<S>\n      : Record<string, any>\n    : Record<string, any>\n  : Record<string, any>;\n\n// Internal type for expand configuration\ntype ExpandConfig = {\n  relation: string;\n  options?: Partial<QueryOptions<any>>;\n};\n\n// Type to represent expanded relations\nexport type ExpandedRelations = Record<string, { schema: any; selected: any }>;\n\n// Return type for RecordBuilder execute\nexport type RecordReturnType<\n  T extends Record<string, any>,\n  IsSingleField extends boolean,\n  FieldKey extends keyof T,\n  Selected extends keyof T,\n  Expands extends ExpandedRelations,\n> = IsSingleField extends true\n  ? T[FieldKey]\n  : Pick<T, Selected> & {\n      [K in keyof Expands]: Pick<\n        Expands[K][\"schema\"],\n        Expands[K][\"selected\"]\n      >[];\n    };\n\nexport class RecordBuilder<\n  T extends Record<string, any>,\n  IsSingleField extends boolean = false,\n  FieldKey extends keyof T = keyof T,\n  Occ extends TableOccurrence<any, any, any, any> | undefined =\n    | TableOccurrence<any, any, any, any>\n    | undefined,\n  Selected extends keyof T = keyof T,\n  Expands extends ExpandedRelations = {},\n> implements\n    ExecutableBuilder<\n      RecordReturnType<T, IsSingleField, FieldKey, Selected, Expands>\n    >\n{\n  private occurrence?: Occ;\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private recordId: string | number;\n  private operation?: \"getSingleField\" | \"navigate\";\n  private operationParam?: string;\n  private isNavigateFromEntitySet?: boolean;\n  private navigateRelation?: string;\n  private navigateSourceTableName?: string;\n\n  private databaseUseEntityIds: boolean;\n\n  // New properties for select/expand support\n  private selectedFields?: string[];\n  private expandConfigs: ExpandConfig[] = [];\n\n  constructor(config: {\n    occurrence?: Occ;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    recordId: string | number;\n    databaseUseEntityIds?: boolean;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.recordId = config.recordId;\n    this.databaseUseEntityIds = config.databaseUseEntityIds ?? false;\n  }\n\n  /**\n   * Helper to merge database-level useEntityIds with per-request options\n   */\n  private mergeExecuteOptions(\n    options?: RequestInit & FFetchOptions & ExecuteOptions,\n  ): RequestInit & FFetchOptions & { useEntityIds?: boolean } {\n    // If useEntityIds is not set in options, use the database-level setting\n    return {\n      ...options,\n      useEntityIds: options?.useEntityIds ?? this.databaseUseEntityIds,\n    };\n  }\n\n  /**\n   * Gets the table ID (FMTID) if using entity IDs, otherwise returns the table name\n   * @param useEntityIds - Optional override for entity ID usage\n   */\n  private getTableId(useEntityIds?: boolean): string {\n    if (!this.occurrence) {\n      return this.tableName;\n    }\n\n    const contextDefault = this.context._getUseEntityIds?.() ?? false;\n    const shouldUseIds = useEntityIds ?? contextDefault;\n\n    if (shouldUseIds) {\n      const identifiers = getTableIdentifiers(this.occurrence);\n      if (!identifiers.id) {\n        throw new Error(\n          `useEntityIds is true but TableOccurrence \"${identifiers.name}\" does not have an fmtId defined`\n        );\n      }\n      return identifiers.id;\n    }\n\n    return this.occurrence.getTableName();\n  }\n\n  getSingleField<K extends keyof T>(\n    field: K,\n  ): RecordBuilder<T, true, K, Occ, keyof T, {}> {\n    const newBuilder = new RecordBuilder<T, true, K, Occ, keyof T, {}>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      recordId: this.recordId,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n    newBuilder.operation = \"getSingleField\";\n    newBuilder.operationParam = field.toString();\n    // Preserve navigation context\n    newBuilder.isNavigateFromEntitySet = this.isNavigateFromEntitySet;\n    newBuilder.navigateRelation = this.navigateRelation;\n    newBuilder.navigateSourceTableName = this.navigateSourceTableName;\n    return newBuilder;\n  }\n\n  /**\n   * Select specific fields to retrieve from the record.\n   * Only the selected fields will be returned in the response.\n   *\n   * @example\n   * ```typescript\n   * const contact = await db.from(\"contacts\").get(\"uuid\").select(\"name\", \"email\").execute();\n   * // contact.data has type { name: string; email: string }\n   * ```\n   */\n  select<K extends keyof T>(\n    ...fields: K[]\n  ): RecordBuilder<T, false, FieldKey, Occ, K, Expands> {\n    const uniqueFields = [...new Set(fields)];\n    const newBuilder = new RecordBuilder<T, false, FieldKey, Occ, K, Expands>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      recordId: this.recordId,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n    newBuilder.selectedFields = uniqueFields.map((f) => String(f));\n    newBuilder.expandConfigs = [...this.expandConfigs];\n    // Preserve navigation context\n    newBuilder.isNavigateFromEntitySet = this.isNavigateFromEntitySet;\n    newBuilder.navigateRelation = this.navigateRelation;\n    newBuilder.navigateSourceTableName = this.navigateSourceTableName;\n    return newBuilder;\n  }\n\n  /**\n   * Expand a navigation property to include related records.\n   * Supports nested select, filter, orderBy, and expand operations.\n   *\n   * @example\n   * ```typescript\n   * // Simple expand\n   * const contact = await db.from(\"contacts\").get(\"uuid\").expand(\"users\").execute();\n   *\n   * // Expand with select\n   * const contact = await db.from(\"contacts\").get(\"uuid\")\n   *   .expand(\"users\", b => b.select(\"username\", \"email\"))\n   *   .execute();\n   * ```\n   */\n  expand<\n    Rel extends ExtractNavigationNames<Occ> | (string & {}),\n    TargetOcc extends FindNavigationTarget<Occ, Rel> = FindNavigationTarget<\n      Occ,\n      Rel\n    >,\n    TargetSchema extends GetTargetSchemaType<Occ, Rel> = GetTargetSchemaType<\n      Occ,\n      Rel\n    >,\n    TargetSelected extends keyof TargetSchema = keyof TargetSchema,\n  >(\n    relation: Rel,\n    callback?: (\n      builder: QueryBuilder<\n        TargetSchema,\n        keyof TargetSchema,\n        false,\n        false,\n        TargetOcc extends TableOccurrence<any, any, any, any>\n          ? TargetOcc\n          : undefined\n      >,\n    ) => QueryBuilder<\n      WithSystemFields<TargetSchema>,\n      TargetSelected,\n      any,\n      any,\n      any\n    >,\n  ): RecordBuilder<\n    T,\n    false,\n    FieldKey,\n    Occ,\n    Selected,\n    Expands & {\n      [K in Rel]: { schema: TargetSchema; selected: TargetSelected };\n    }\n  > {\n    // Look up target occurrence from navigation\n    const targetOccurrence = this.occurrence?.navigation[relation as string];\n\n    // Create new builder with updated types\n    const newBuilder = new RecordBuilder<\n      T,\n      false,\n      FieldKey,\n      Occ,\n      Selected,\n      Expands & {\n        [K in Rel]: { schema: TargetSchema; selected: TargetSelected };\n      }\n    >({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      recordId: this.recordId,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n\n    // Copy existing state\n    newBuilder.selectedFields = this.selectedFields;\n    newBuilder.expandConfigs = [...this.expandConfigs];\n    newBuilder.isNavigateFromEntitySet = this.isNavigateFromEntitySet;\n    newBuilder.navigateRelation = this.navigateRelation;\n    newBuilder.navigateSourceTableName = this.navigateSourceTableName;\n\n    if (callback) {\n      // Create a new QueryBuilder for the target occurrence\n      const targetBuilder = new QueryBuilder<any>({\n        occurrence: targetOccurrence,\n        tableName: targetOccurrence?.name ?? (relation as string),\n        databaseName: this.databaseName,\n        context: this.context,\n        databaseUseEntityIds: this.databaseUseEntityIds,\n      });\n\n      // Cast to the expected type for the callback\n      // At runtime, the builder is untyped (any), but at compile-time we enforce proper types\n      const typedBuilder = targetBuilder as QueryBuilder<\n        TargetSchema,\n        keyof TargetSchema,\n        false,\n        false,\n        TargetOcc extends TableOccurrence<any, any, any, any>\n          ? TargetOcc\n          : undefined\n      >;\n\n      // Pass to callback and get configured builder\n      const configuredBuilder = callback(typedBuilder);\n\n      // Extract the builder's query options\n      const expandOptions: Partial<QueryOptions<any>> = {\n        ...(configuredBuilder as any).queryOptions,\n      };\n\n      // If the configured builder has nested expands, we need to include them\n      if ((configuredBuilder as any).expandConfigs?.length > 0) {\n        // Build nested expand string from the configured builder's expand configs\n        const nestedExpandString = this.buildExpandString(\n          (configuredBuilder as any).expandConfigs,\n        );\n        if (nestedExpandString) {\n          // Add nested expand to options\n          expandOptions.expand = nestedExpandString as any;\n        }\n      }\n\n      const expandConfig: ExpandConfig = {\n        relation: relation as string,\n        options: expandOptions,\n      };\n\n      newBuilder.expandConfigs.push(expandConfig);\n    } else {\n      // Simple expand without callback\n      newBuilder.expandConfigs.push({ relation: relation as string });\n    }\n\n    return newBuilder;\n  }\n\n  // Overload for valid relation names - returns typed QueryBuilder\n  navigate<RelationName extends ExtractNavigationNames<Occ>>(\n    relationName: RelationName,\n  ): QueryBuilder<\n    ExtractSchemaFromOccurrence<\n      FindNavigationTarget<Occ, RelationName>\n    > extends Record<string, StandardSchemaV1>\n      ? InferSchemaType<\n          ExtractSchemaFromOccurrence<FindNavigationTarget<Occ, RelationName>>\n        >\n      : Record<string, any>\n  >;\n  // Overload for arbitrary strings - returns generic QueryBuilder with system fields\n  navigate(\n    relationName: string,\n  ): QueryBuilder<{ ROWID: number; ROWMODID: number; [key: string]: any }>;\n  // Implementation\n  navigate(relationName: string): QueryBuilder<any> {\n    // Use the target occurrence if available, otherwise allow untyped navigation\n    // (useful when types might be incomplete)\n    const targetOccurrence = this.occurrence?.navigation[relationName];\n    const builder = new QueryBuilder<any>({\n      occurrence: targetOccurrence,\n      tableName: targetOccurrence?.name ?? relationName,\n      databaseName: this.databaseName,\n      context: this.context,\n    });\n    // Store the navigation info - we'll use it in execute\n    // Transform relation name to FMTID if using entity IDs\n    const relationId = targetOccurrence\n      ? transformTableName(targetOccurrence)\n      : relationName;\n\n    (builder as any).isNavigate = true;\n    (builder as any).navigateRecordId = this.recordId;\n    (builder as any).navigateRelation = relationId;\n\n    // If this RecordBuilder came from a navigated EntitySet, we need to preserve that base path\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      // Build the base path: /sourceTable/relation('recordId')/newRelation\n      (builder as any).navigateSourceTableName = this.navigateSourceTableName;\n      (builder as any).navigateBaseRelation = this.navigateRelation;\n    } else {\n      // Normal record navigation: /tableName('recordId')/relation\n      // Transform source table name to FMTID if using entity IDs\n      const sourceTableId = this.occurrence\n        ? transformTableName(this.occurrence)\n        : this.tableName;\n      (builder as any).navigateSourceTableName = sourceTableId;\n    }\n\n    return builder;\n  }\n\n  /**\n   * Formats select fields for use in query strings.\n   * - Transforms field names to FMFIDs if using entity IDs\n   * - Wraps \"id\" fields in double quotes\n   * - URL-encodes special characters but preserves spaces\n   */\n  private formatSelectFields(\n    select: string[] | undefined,\n    baseTable?: BaseTable<any, any, any, any>,\n  ): string {\n    if (!select || select.length === 0) return \"\";\n\n    // Transform to field IDs if using entity IDs\n    const transformedFields = baseTable\n      ? transformFieldNamesArray(select, baseTable)\n      : select;\n\n    return transformedFields\n      .map((field) => {\n        if (field === \"id\") return `\"id\"`;\n        const encodedField = encodeURIComponent(String(field));\n        return encodedField.replace(/%20/g, \" \");\n      })\n      .join(\",\");\n  }\n\n  /**\n   * Builds expand validation configs from internal expand configurations.\n   * These are used to validate expanded navigation properties.\n   */\n  private buildExpandValidationConfigs(\n    configs: ExpandConfig[],\n  ): ExpandValidationConfig[] {\n    return configs.map((config) => {\n      // Look up target occurrence from navigation\n      const targetOccurrence = this.occurrence?.navigation[config.relation];\n      const targetSchema = targetOccurrence?.baseTable?.schema;\n\n      // Extract selected fields from options\n      const selectedFields = config.options?.select\n        ? Array.isArray(config.options.select)\n          ? config.options.select.map((f) => String(f))\n          : [String(config.options.select)]\n        : undefined;\n\n      return {\n        relation: config.relation,\n        targetSchema: targetSchema,\n        targetOccurrence: targetOccurrence,\n        targetBaseTable: targetOccurrence?.baseTable,\n        occurrence: targetOccurrence, // For transformation\n        selectedFields: selectedFields,\n        nestedExpands: undefined, // TODO: Handle nested expands if needed\n      };\n    });\n  }\n\n  /**\n   * Builds OData expand query string from expand configurations.\n   * Handles nested expands recursively.\n   * Transforms relation names to FMTIDs if using entity IDs.\n   */\n  private buildExpandString(configs: ExpandConfig[]): string {\n    if (configs.length === 0) {\n      return \"\";\n    }\n\n    return configs\n      .map((config) => {\n        // Get target occurrence for this relation\n        const targetOccurrence = this.occurrence?.navigation[config.relation];\n\n        // When using entity IDs, use the target table's FMTID in the expand parameter\n        // FileMaker expects FMTID in $expand when Prefer header is set\n        const relationName =\n          targetOccurrence && targetOccurrence.isUsingTableId?.()\n            ? targetOccurrence.getTableId()\n            : config.relation;\n\n        if (!config.options || Object.keys(config.options).length === 0) {\n          // Simple expand without options\n          return relationName;\n        }\n\n        // Build query options for this expand\n        const parts: string[] = [];\n\n        if (config.options.select) {\n          // Pass target base table for field transformation\n          const selectFields = this.formatSelectFields(\n            Array.isArray(config.options.select)\n              ? config.options.select.map((f) => String(f))\n              : [String(config.options.select)],\n            targetOccurrence?.baseTable,\n          );\n          parts.push(`$select=${selectFields}`);\n        }\n\n        if (config.options.filter) {\n          // Filter should already be transformed by the nested builder\n          // Use odata-query to build filter string\n          const filterQuery = buildQuery({ filter: config.options.filter });\n          const filterMatch = filterQuery.match(/\\$filter=([^&]+)/);\n          if (filterMatch) {\n            parts.push(`$filter=${filterMatch[1]}`);\n          }\n        }\n\n        if (config.options.orderBy) {\n          const orderByQuery = buildQuery({ orderBy: config.options.orderBy });\n          const orderByMatch = orderByQuery.match(/\\$orderby=([^&]+)/);\n          if (orderByMatch) {\n            parts.push(`$orderby=${orderByMatch[1]}`);\n          }\n        }\n\n        if (config.options.top !== undefined) {\n          parts.push(`$top=${config.options.top}`);\n        }\n\n        if (config.options.skip !== undefined) {\n          parts.push(`$skip=${config.options.skip}`);\n        }\n\n        // Handle nested expand\n        if (config.options.expand) {\n          // Nested expand is already a string from buildExpandString\n          parts.push(`$expand=${String(config.options.expand)}`);\n        }\n\n        if (parts.length === 0) {\n          return relationName;\n        }\n\n        return `${relationName}(${parts.join(\";\")})`;\n      })\n      .join(\",\");\n  }\n\n  /**\n   * Builds the complete query string including $select and $expand parameters.\n   */\n  private buildQueryString(): string {\n    const parts: string[] = [];\n\n    // Build $select\n    if (this.selectedFields && this.selectedFields.length > 0) {\n      const selectString = this.formatSelectFields(\n        this.selectedFields,\n        this.occurrence?.baseTable,\n      );\n      if (selectString) {\n        parts.push(`$select=${selectString}`);\n      }\n    }\n\n    // Build $expand\n    const expandString = this.buildExpandString(this.expandConfigs);\n    if (expandString) {\n      parts.push(`$expand=${expandString}`);\n    }\n\n    if (parts.length === 0) {\n      return \"\";\n    }\n\n    return `?${parts.join(\"&\")}`;\n  }\n\n  /**\n   * Helper to conditionally strip OData annotations based on options\n   */\n  private stripODataAnnotationsIfNeeded<R extends Record<string, any>>(\n    data: R,\n    options?: ExecuteOptions,\n  ): R {\n    // Only include annotations if explicitly requested\n    if (options?.includeODataAnnotations === true) {\n      return data;\n    }\n\n    // Strip OData annotations\n    const { \"@id\": _id, \"@editLink\": _editLink, ...rest } = data;\n    return rest as R;\n  }\n\n  async execute<EO extends ExecuteOptions>(\n    options?: RequestInit & FFetchOptions & EO,\n  ): Promise<\n    Result<\n      ConditionallyWithODataAnnotations<\n        RecordReturnType<T, IsSingleField, FieldKey, Selected, Expands>,\n        EO[\"includeODataAnnotations\"] extends true ? true : false\n      >\n    >\n  > {\n    let url: string;\n\n    // Build the base URL depending on whether this came from a navigated EntitySet\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      // From navigated EntitySet: /sourceTable/relation('recordId')\n      url = `/${this.databaseName}/${this.navigateSourceTableName}/${this.navigateRelation}('${this.recordId}')`;\n    } else {\n      // Normal record: /tableName('recordId') - use FMTID if configured\n      const tableId = this.getTableId(\n        options?.useEntityIds ?? this.databaseUseEntityIds,\n      );\n      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;\n    }\n\n    if (this.operation === \"getSingleField\" && this.operationParam) {\n      url += `/${this.operationParam}`;\n    } else {\n      // Add query string for select/expand (only when not getting a single field)\n      const queryString = this.buildQueryString();\n      url += queryString;\n    }\n\n    const mergedOptions = this.mergeExecuteOptions(options);\n    const result = await this.context._makeRequest(url, mergedOptions);\n\n    if (result.error) {\n      return { data: undefined, error: result.error };\n    }\n\n    let response = result.data;\n\n    // Handle single field operation\n    if (this.operation === \"getSingleField\") {\n      // Single field returns a JSON object with @context and value\n      const fieldResponse = response as ODataFieldResponse<T>;\n      return { data: fieldResponse.value as any, error: undefined };\n    }\n\n    // Transform response field IDs back to names if using entity IDs\n    // Only transform if useEntityIds resolves to true (respects per-request override)\n    const shouldUseIds = mergedOptions.useEntityIds ?? false;\n\n    // Build expand validation configs for transformation and validation\n    const expandValidationConfigs =\n      this.expandConfigs.length > 0\n        ? this.buildExpandValidationConfigs(this.expandConfigs)\n        : undefined;\n\n    if (this.occurrence?.baseTable && shouldUseIds) {\n      response = transformResponseFields(\n        response,\n        this.occurrence.baseTable,\n        expandValidationConfigs,\n      );\n    }\n\n    // Get schema from occurrence if available\n    const schema = this.occurrence?.baseTable?.schema;\n\n    // Validate the single record response\n    const validation = await validateSingleResponse<any>(\n      response,\n      schema,\n      this.selectedFields as (keyof T)[] | undefined,\n      expandValidationConfigs,\n      \"exact\", // Expect exactly one record\n    );\n\n    if (!validation.valid) {\n      return { data: undefined, error: validation.error };\n    }\n\n    // Handle null response\n    if (validation.data === null) {\n      return { data: null as any, error: undefined };\n    }\n\n    // Strip OData annotations if not requested\n    const stripped = this.stripODataAnnotationsIfNeeded(\n      validation.data,\n      options,\n    );\n\n    return { data: stripped as any, error: undefined };\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    let url: string;\n\n    // Build the base URL depending on whether this came from a navigated EntitySet\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      // From navigated EntitySet: /sourceTable/relation('recordId')\n      url = `/${this.databaseName}/${this.navigateSourceTableName}/${this.navigateRelation}('${this.recordId}')`;\n    } else {\n      // For batch operations, use database-level setting (no per-request override available here)\n      const tableId = this.getTableId(this.databaseUseEntityIds);\n      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;\n    }\n\n    if (this.operation === \"getSingleField\" && this.operationParam) {\n      url += `/${this.operationParam}`;\n    } else {\n      // Add query string for select/expand (only when not getting a single field)\n      const queryString = this.buildQueryString();\n      url += queryString;\n    }\n\n    return {\n      method: \"GET\",\n      url,\n    };\n  }\n\n  /**\n   * Returns the query string for this record builder (for testing purposes).\n   */\n  getQueryString(): string {\n    let path: string;\n\n    // Build the path depending on navigation context\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      path = `/${this.navigateSourceTableName}/${this.navigateRelation}('${this.recordId}')`;\n    } else {\n      path = `/${this.tableName}('${this.recordId}')`;\n    }\n\n    if (this.operation === \"getSingleField\" && this.operationParam) {\n      return `${path}/${this.operationParam}`;\n    }\n\n    const queryString = this.buildQueryString();\n    return `${path}${queryString}`;\n  }\n\n  toRequest(baseUrl: string): Request {\n    const config = this.getRequestConfig();\n    const fullUrl = `${baseUrl}${config.url}`;\n\n    return new Request(fullUrl, {\n      method: config.method,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json\",\n      },\n    });\n  }\n\n  async processResponse(\n    response: Response,\n    options?: ExecuteOptions,\n  ): Promise<\n    Result<RecordReturnType<T, IsSingleField, FieldKey, Selected, Expands>>\n  > {\n    const rawResponse = await response.json();\n\n    // Handle single field operation\n    if (this.operation === \"getSingleField\") {\n      // Single field returns a JSON object with @context and value\n      const fieldResponse = rawResponse as ODataFieldResponse<T>;\n      return { data: fieldResponse.value as any, error: undefined };\n    }\n\n    // Transform response field IDs back to names if using entity IDs\n    // Only transform if useEntityIds resolves to true (respects per-request override)\n    const shouldUseIds = options?.useEntityIds ?? this.databaseUseEntityIds;\n\n    // Build expand validation configs for transformation and validation\n    const expandValidationConfigs =\n      this.expandConfigs.length > 0\n        ? this.buildExpandValidationConfigs(this.expandConfigs)\n        : undefined;\n\n    let transformedResponse = rawResponse;\n    if (this.occurrence?.baseTable && shouldUseIds) {\n      transformedResponse = transformResponseFields(\n        rawResponse,\n        this.occurrence.baseTable,\n        expandValidationConfigs,\n      );\n    }\n\n    // Get schema from occurrence if available\n    const schema = this.occurrence?.baseTable?.schema;\n\n    // Validate the single record response\n    const validation = await validateSingleResponse<any>(\n      transformedResponse,\n      schema,\n      this.selectedFields as (keyof T)[] | undefined,\n      expandValidationConfigs,\n      \"exact\", // Expect exactly one record\n    );\n\n    if (!validation.valid) {\n      return { data: undefined, error: validation.error };\n    }\n\n    // Handle null response\n    if (validation.data === null) {\n      return { data: null as any, error: undefined };\n    }\n\n    // Strip OData annotations if not requested\n    const stripped = this.stripODataAnnotationsIfNeeded(\n      validation.data,\n      options,\n    );\n\n    return { data: stripped as any, error: undefined };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"record-builder.js","sources":["../../../src/client/record-builder.ts"],"sourcesContent":["import type {\n  ExecutionContext,\n  ExecutableBuilder,\n  Result,\n  ODataRecordMetadata,\n  ODataFieldResponse,\n  InferSchemaType,\n  ExecuteOptions,\n  WithSystemFields,\n  ConditionallyWithODataAnnotations,\n} from \"../types\";\nimport { getAcceptHeader } from \"../types\";\nimport type { TableOccurrence } from \"./table-occurrence\";\nimport type { BaseTable } from \"./base-table\";\nimport {\n  transformTableName,\n  transformResponseFields,\n  getTableIdentifiers,\n  transformFieldNamesArray,\n} from \"../transform\";\nimport { safeJsonParse } from \"./sanitize-json\";\nimport { QueryBuilder } from \"./query-builder\";\nimport {\n  validateSingleResponse,\n  type ExpandValidationConfig,\n} from \"../validation\";\nimport { type FFetchOptions } from \"@fetchkit/ffetch\";\nimport { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { QueryOptions } from \"odata-query\";\nimport buildQuery from \"odata-query\";\n\n// Helper type to extract schema from a TableOccurrence\ntype ExtractSchemaFromOccurrence<O> =\n  O extends TableOccurrence<infer BT, any, any, any>\n    ? BT extends BaseTable<infer S, any, any, any>\n      ? S\n      : never\n    : never;\n\n// Helper type to extract navigation relation names from an occurrence\ntype ExtractNavigationNames<\n  O extends TableOccurrence<any, any, any, any> | undefined,\n> =\n  O extends TableOccurrence<any, any, infer Nav, any>\n    ? Nav extends Record<string, any>\n      ? keyof Nav & string\n      : never\n    : never;\n\n// Helper type to find target occurrence by relation name\ntype FindNavigationTarget<\n  O extends TableOccurrence<any, any, any, any> | undefined,\n  Name extends string,\n> =\n  O extends TableOccurrence<any, any, infer Nav, any>\n    ? Nav extends Record<string, any>\n      ? Name extends keyof Nav\n        ? Nav[Name]\n        : TableOccurrence<\n            BaseTable<Record<string, StandardSchemaV1>, any, any, any>,\n            any,\n            any,\n            any\n          >\n      : TableOccurrence<\n          BaseTable<Record<string, StandardSchemaV1>, any, any, any>,\n          any,\n          any,\n          any\n        >\n    : TableOccurrence<\n        BaseTable<Record<string, StandardSchemaV1>, any, any, any>,\n        any,\n        any,\n        any\n      >;\n\n// Helper type to get the inferred schema type from a target occurrence\ntype GetTargetSchemaType<\n  O extends TableOccurrence<any, any, any, any> | undefined,\n  Rel extends string,\n> = [FindNavigationTarget<O, Rel>] extends [\n  TableOccurrence<infer BT, any, any, any>,\n]\n  ? [BT] extends [BaseTable<infer S, any, any, any>]\n    ? [S] extends [Record<string, StandardSchemaV1>]\n      ? InferSchemaType<S>\n      : Record<string, any>\n    : Record<string, any>\n  : Record<string, any>;\n\n// Internal type for expand configuration\ntype ExpandConfig = {\n  relation: string;\n  options?: Partial<QueryOptions<any>>;\n};\n\n// Type to represent expanded relations\nexport type ExpandedRelations = Record<string, { schema: any; selected: any }>;\n\n// Return type for RecordBuilder execute\nexport type RecordReturnType<\n  T extends Record<string, any>,\n  IsSingleField extends boolean,\n  FieldKey extends keyof T,\n  Selected extends keyof T,\n  Expands extends ExpandedRelations,\n> = IsSingleField extends true\n  ? T[FieldKey]\n  : Pick<T, Selected> & {\n      [K in keyof Expands]: Pick<\n        Expands[K][\"schema\"],\n        Expands[K][\"selected\"]\n      >[];\n    };\n\nexport class RecordBuilder<\n  T extends Record<string, any>,\n  IsSingleField extends boolean = false,\n  FieldKey extends keyof T = keyof T,\n  Occ extends TableOccurrence<any, any, any, any> | undefined =\n    | TableOccurrence<any, any, any, any>\n    | undefined,\n  Selected extends keyof T = keyof T,\n  Expands extends ExpandedRelations = {},\n> implements\n    ExecutableBuilder<\n      RecordReturnType<T, IsSingleField, FieldKey, Selected, Expands>\n    >\n{\n  private occurrence?: Occ;\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private recordId: string | number;\n  private operation?: \"getSingleField\" | \"navigate\";\n  private operationParam?: string;\n  private isNavigateFromEntitySet?: boolean;\n  private navigateRelation?: string;\n  private navigateSourceTableName?: string;\n\n  private databaseUseEntityIds: boolean;\n\n  // New properties for select/expand support\n  private selectedFields?: string[];\n  private expandConfigs: ExpandConfig[] = [];\n\n  constructor(config: {\n    occurrence?: Occ;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    recordId: string | number;\n    databaseUseEntityIds?: boolean;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.recordId = config.recordId;\n    this.databaseUseEntityIds = config.databaseUseEntityIds ?? false;\n  }\n\n  /**\n   * Helper to merge database-level useEntityIds with per-request options\n   */\n  private mergeExecuteOptions(\n    options?: RequestInit & FFetchOptions & ExecuteOptions,\n  ): RequestInit & FFetchOptions & { useEntityIds?: boolean } {\n    // If useEntityIds is not set in options, use the database-level setting\n    return {\n      ...options,\n      useEntityIds: options?.useEntityIds ?? this.databaseUseEntityIds,\n    };\n  }\n\n  /**\n   * Gets the table ID (FMTID) if using entity IDs, otherwise returns the table name\n   * @param useEntityIds - Optional override for entity ID usage\n   */\n  private getTableId(useEntityIds?: boolean): string {\n    if (!this.occurrence) {\n      return this.tableName;\n    }\n\n    const contextDefault = this.context._getUseEntityIds?.() ?? false;\n    const shouldUseIds = useEntityIds ?? contextDefault;\n\n    if (shouldUseIds) {\n      const identifiers = getTableIdentifiers(this.occurrence);\n      if (!identifiers.id) {\n        throw new Error(\n          `useEntityIds is true but TableOccurrence \"${identifiers.name}\" does not have an fmtId defined`,\n        );\n      }\n      return identifiers.id;\n    }\n\n    return this.occurrence.getTableName();\n  }\n\n  getSingleField<K extends keyof T>(\n    field: K,\n  ): RecordBuilder<T, true, K, Occ, keyof T, {}> {\n    const newBuilder = new RecordBuilder<T, true, K, Occ, keyof T, {}>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      recordId: this.recordId,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n    newBuilder.operation = \"getSingleField\";\n    newBuilder.operationParam = field.toString();\n    // Preserve navigation context\n    newBuilder.isNavigateFromEntitySet = this.isNavigateFromEntitySet;\n    newBuilder.navigateRelation = this.navigateRelation;\n    newBuilder.navigateSourceTableName = this.navigateSourceTableName;\n    return newBuilder;\n  }\n\n  /**\n   * Select specific fields to retrieve from the record.\n   * Only the selected fields will be returned in the response.\n   *\n   * @example\n   * ```typescript\n   * const contact = await db.from(\"contacts\").get(\"uuid\").select(\"name\", \"email\").execute();\n   * // contact.data has type { name: string; email: string }\n   * ```\n   */\n  select<K extends keyof T>(\n    ...fields: K[]\n  ): RecordBuilder<T, false, FieldKey, Occ, K, Expands> {\n    const uniqueFields = [...new Set(fields)];\n    const newBuilder = new RecordBuilder<T, false, FieldKey, Occ, K, Expands>({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      recordId: this.recordId,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n    newBuilder.selectedFields = uniqueFields.map((f) => String(f));\n    newBuilder.expandConfigs = [...this.expandConfigs];\n    // Preserve navigation context\n    newBuilder.isNavigateFromEntitySet = this.isNavigateFromEntitySet;\n    newBuilder.navigateRelation = this.navigateRelation;\n    newBuilder.navigateSourceTableName = this.navigateSourceTableName;\n    return newBuilder;\n  }\n\n  /**\n   * Expand a navigation property to include related records.\n   * Supports nested select, filter, orderBy, and expand operations.\n   *\n   * @example\n   * ```typescript\n   * // Simple expand\n   * const contact = await db.from(\"contacts\").get(\"uuid\").expand(\"users\").execute();\n   *\n   * // Expand with select\n   * const contact = await db.from(\"contacts\").get(\"uuid\")\n   *   .expand(\"users\", b => b.select(\"username\", \"email\"))\n   *   .execute();\n   * ```\n   */\n  expand<\n    Rel extends ExtractNavigationNames<Occ> | (string & {}),\n    TargetOcc extends FindNavigationTarget<Occ, Rel> = FindNavigationTarget<\n      Occ,\n      Rel\n    >,\n    TargetSchema extends GetTargetSchemaType<Occ, Rel> = GetTargetSchemaType<\n      Occ,\n      Rel\n    >,\n    TargetSelected extends keyof TargetSchema = keyof TargetSchema,\n  >(\n    relation: Rel,\n    callback?: (\n      builder: QueryBuilder<\n        TargetSchema,\n        keyof TargetSchema,\n        false,\n        false,\n        TargetOcc extends TableOccurrence<any, any, any, any>\n          ? TargetOcc\n          : undefined\n      >,\n    ) => QueryBuilder<\n      WithSystemFields<TargetSchema>,\n      TargetSelected,\n      any,\n      any,\n      any\n    >,\n  ): RecordBuilder<\n    T,\n    false,\n    FieldKey,\n    Occ,\n    Selected,\n    Expands & {\n      [K in Rel]: { schema: TargetSchema; selected: TargetSelected };\n    }\n  > {\n    // Look up target occurrence from navigation\n    const targetOccurrence = this.occurrence?.navigation[relation as string];\n\n    // Helper function to get defaultSelect fields from target occurrence\n    const getDefaultSelectFields = (): string[] | undefined => {\n      if (!targetOccurrence) return undefined;\n      const defaultSelect = targetOccurrence.defaultSelect;\n      if (defaultSelect === \"schema\") {\n        const schema = targetOccurrence.baseTable?.schema;\n        if (schema) {\n          return [...new Set(Object.keys(schema))];\n        }\n      } else if (Array.isArray(defaultSelect)) {\n        return [...new Set(defaultSelect)];\n      }\n      // If \"all\", return undefined (no select restriction)\n      return undefined;\n    };\n\n    // Create new builder with updated types\n    const newBuilder = new RecordBuilder<\n      T,\n      false,\n      FieldKey,\n      Occ,\n      Selected,\n      Expands & {\n        [K in Rel]: { schema: TargetSchema; selected: TargetSelected };\n      }\n    >({\n      occurrence: this.occurrence,\n      tableName: this.tableName,\n      databaseName: this.databaseName,\n      context: this.context,\n      recordId: this.recordId,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n\n    // Copy existing state\n    newBuilder.selectedFields = this.selectedFields;\n    newBuilder.expandConfigs = [...this.expandConfigs];\n    newBuilder.isNavigateFromEntitySet = this.isNavigateFromEntitySet;\n    newBuilder.navigateRelation = this.navigateRelation;\n    newBuilder.navigateSourceTableName = this.navigateSourceTableName;\n\n    if (callback) {\n      // Create a new QueryBuilder for the target occurrence\n      const targetBuilder = new QueryBuilder<any>({\n        occurrence: targetOccurrence,\n        tableName: targetOccurrence?.name ?? (relation as string),\n        databaseName: this.databaseName,\n        context: this.context,\n        databaseUseEntityIds: this.databaseUseEntityIds,\n      });\n\n      // Cast to the expected type for the callback\n      // At runtime, the builder is untyped (any), but at compile-time we enforce proper types\n      const typedBuilder = targetBuilder as QueryBuilder<\n        TargetSchema,\n        keyof TargetSchema,\n        false,\n        false,\n        TargetOcc extends TableOccurrence<any, any, any, any>\n          ? TargetOcc\n          : undefined\n      >;\n\n      // Pass to callback and get configured builder\n      const configuredBuilder = callback(typedBuilder);\n\n      // Extract the builder's query options\n      const expandOptions: Partial<QueryOptions<any>> = {\n        ...(configuredBuilder as any).queryOptions,\n      };\n\n      // If callback didn't provide select, apply defaultSelect from target occurrence\n      if (!expandOptions.select) {\n        const defaultFields = getDefaultSelectFields();\n        if (defaultFields) {\n          expandOptions.select = defaultFields;\n        }\n      }\n\n      // If the configured builder has nested expands, we need to include them\n      if ((configuredBuilder as any).expandConfigs?.length > 0) {\n        // Build nested expand string from the configured builder's expand configs\n        const nestedExpandString = this.buildExpandString(\n          (configuredBuilder as any).expandConfigs,\n        );\n        if (nestedExpandString) {\n          // Add nested expand to options\n          expandOptions.expand = nestedExpandString as any;\n        }\n      }\n\n      const expandConfig: ExpandConfig = {\n        relation: relation as string,\n        options: expandOptions,\n      };\n\n      newBuilder.expandConfigs.push(expandConfig);\n    } else {\n      // Simple expand without callback - apply defaultSelect if available\n      const defaultFields = getDefaultSelectFields();\n      if (defaultFields) {\n        newBuilder.expandConfigs.push({\n          relation: relation as string,\n          options: { select: defaultFields },\n        });\n      } else {\n        newBuilder.expandConfigs.push({ relation: relation as string });\n      }\n    }\n\n    return newBuilder;\n  }\n\n  // Overload for valid relation names - returns typed QueryBuilder\n  navigate<RelationName extends ExtractNavigationNames<Occ>>(\n    relationName: RelationName,\n  ): QueryBuilder<\n    ExtractSchemaFromOccurrence<\n      FindNavigationTarget<Occ, RelationName>\n    > extends Record<string, StandardSchemaV1>\n      ? InferSchemaType<\n          ExtractSchemaFromOccurrence<FindNavigationTarget<Occ, RelationName>>\n        >\n      : Record<string, any>\n  >;\n  // Overload for arbitrary strings - returns generic QueryBuilder with system fields\n  navigate(\n    relationName: string,\n  ): QueryBuilder<{ ROWID: number; ROWMODID: number; [key: string]: any }>;\n  // Implementation\n  navigate(relationName: string): QueryBuilder<any> {\n    // Use the target occurrence if available, otherwise allow untyped navigation\n    // (useful when types might be incomplete)\n    const targetOccurrence = this.occurrence?.navigation[relationName];\n    const builder = new QueryBuilder<any>({\n      occurrence: targetOccurrence,\n      tableName: targetOccurrence?.name ?? relationName,\n      databaseName: this.databaseName,\n      context: this.context,\n    });\n    // Store the navigation info - we'll use it in execute\n    // Transform relation name to FMTID if using entity IDs\n    const relationId = targetOccurrence\n      ? transformTableName(targetOccurrence)\n      : relationName;\n\n    (builder as any).isNavigate = true;\n    (builder as any).navigateRecordId = this.recordId;\n    (builder as any).navigateRelation = relationId;\n\n    // If this RecordBuilder came from a navigated EntitySet, we need to preserve that base path\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      // Build the base path: /sourceTable/relation('recordId')/newRelation\n      (builder as any).navigateSourceTableName = this.navigateSourceTableName;\n      (builder as any).navigateBaseRelation = this.navigateRelation;\n    } else {\n      // Normal record navigation: /tableName('recordId')/relation\n      // Transform source table name to FMTID if using entity IDs\n      const sourceTableId = this.occurrence\n        ? transformTableName(this.occurrence)\n        : this.tableName;\n      (builder as any).navigateSourceTableName = sourceTableId;\n    }\n\n    return builder;\n  }\n\n  /**\n   * Formats select fields for use in query strings.\n   * - Transforms field names to FMFIDs if using entity IDs\n   * - Wraps \"id\" fields in double quotes\n   * - URL-encodes special characters but preserves spaces\n   */\n  private formatSelectFields(\n    select: string[] | undefined,\n    baseTable?: BaseTable<any, any, any, any>,\n  ): string {\n    if (!select || select.length === 0) return \"\";\n\n    // Transform to field IDs if using entity IDs\n    const transformedFields = baseTable\n      ? transformFieldNamesArray(select, baseTable)\n      : select;\n\n    return transformedFields\n      .map((field) => {\n        if (field === \"id\") return `\"id\"`;\n        const encodedField = encodeURIComponent(String(field));\n        return encodedField.replace(/%20/g, \" \");\n      })\n      .join(\",\");\n  }\n\n  /**\n   * Builds expand validation configs from internal expand configurations.\n   * These are used to validate expanded navigation properties.\n   */\n  private buildExpandValidationConfigs(\n    configs: ExpandConfig[],\n  ): ExpandValidationConfig[] {\n    return configs.map((config) => {\n      // Look up target occurrence from navigation\n      const targetOccurrence = this.occurrence?.navigation[config.relation];\n      const targetSchema = targetOccurrence?.baseTable?.schema;\n\n      // Extract selected fields from options\n      const selectedFields = config.options?.select\n        ? Array.isArray(config.options.select)\n          ? config.options.select.map((f) => String(f))\n          : [String(config.options.select)]\n        : undefined;\n\n      return {\n        relation: config.relation,\n        targetSchema: targetSchema,\n        targetOccurrence: targetOccurrence,\n        targetBaseTable: targetOccurrence?.baseTable,\n        occurrence: targetOccurrence, // For transformation\n        selectedFields: selectedFields,\n        nestedExpands: undefined, // TODO: Handle nested expands if needed\n      };\n    });\n  }\n\n  /**\n   * Builds OData expand query string from expand configurations.\n   * Handles nested expands recursively.\n   * Transforms relation names to FMTIDs if using entity IDs.\n   */\n  private buildExpandString(configs: ExpandConfig[]): string {\n    if (configs.length === 0) {\n      return \"\";\n    }\n\n    return configs\n      .map((config) => {\n        // Get target occurrence for this relation\n        const targetOccurrence = this.occurrence?.navigation[config.relation];\n\n        // When using entity IDs, use the target table's FMTID in the expand parameter\n        // FileMaker expects FMTID in $expand when Prefer header is set\n        const relationName =\n          targetOccurrence && targetOccurrence.isUsingTableId?.()\n            ? targetOccurrence.getTableId()\n            : config.relation;\n\n        if (!config.options || Object.keys(config.options).length === 0) {\n          // Simple expand without options\n          return relationName;\n        }\n\n        // Build query options for this expand\n        const parts: string[] = [];\n\n        if (config.options.select) {\n          // Pass target base table for field transformation\n          const selectFields = this.formatSelectFields(\n            Array.isArray(config.options.select)\n              ? config.options.select.map((f) => String(f))\n              : [String(config.options.select)],\n            targetOccurrence?.baseTable,\n          );\n          parts.push(`$select=${selectFields}`);\n        }\n\n        if (config.options.filter) {\n          // Filter should already be transformed by the nested builder\n          // Use odata-query to build filter string\n          const filterQuery = buildQuery({ filter: config.options.filter });\n          const filterMatch = filterQuery.match(/\\$filter=([^&]+)/);\n          if (filterMatch) {\n            parts.push(`$filter=${filterMatch[1]}`);\n          }\n        }\n\n        if (config.options.orderBy) {\n          const orderByQuery = buildQuery({ orderBy: config.options.orderBy });\n          const orderByMatch = orderByQuery.match(/\\$orderby=([^&]+)/);\n          if (orderByMatch) {\n            parts.push(`$orderby=${orderByMatch[1]}`);\n          }\n        }\n\n        if (config.options.top !== undefined) {\n          parts.push(`$top=${config.options.top}`);\n        }\n\n        if (config.options.skip !== undefined) {\n          parts.push(`$skip=${config.options.skip}`);\n        }\n\n        // Handle nested expand\n        if (config.options.expand) {\n          // Nested expand is already a string from buildExpandString\n          parts.push(`$expand=${String(config.options.expand)}`);\n        }\n\n        if (parts.length === 0) {\n          return relationName;\n        }\n\n        return `${relationName}(${parts.join(\";\")})`;\n      })\n      .join(\",\");\n  }\n\n  /**\n   * Builds the complete query string including $select and $expand parameters.\n   */\n  private buildQueryString(): string {\n    const parts: string[] = [];\n\n    // Build $select\n    if (this.selectedFields && this.selectedFields.length > 0) {\n      const selectString = this.formatSelectFields(\n        this.selectedFields,\n        this.occurrence?.baseTable,\n      );\n      if (selectString) {\n        parts.push(`$select=${selectString}`);\n      }\n    }\n\n    // Build $expand\n    const expandString = this.buildExpandString(this.expandConfigs);\n    if (expandString) {\n      parts.push(`$expand=${expandString}`);\n    }\n\n    if (parts.length === 0) {\n      return \"\";\n    }\n\n    return `?${parts.join(\"&\")}`;\n  }\n\n\n  async execute<EO extends ExecuteOptions>(\n    options?: RequestInit & FFetchOptions & EO,\n  ): Promise<\n    Result<\n      ConditionallyWithODataAnnotations<\n        RecordReturnType<T, IsSingleField, FieldKey, Selected, Expands>,\n        EO[\"includeODataAnnotations\"] extends true ? true : false\n      >\n    >\n  > {\n    let url: string;\n\n    // Build the base URL depending on whether this came from a navigated EntitySet\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      // From navigated EntitySet: /sourceTable/relation('recordId')\n      url = `/${this.databaseName}/${this.navigateSourceTableName}/${this.navigateRelation}('${this.recordId}')`;\n    } else {\n      // Normal record: /tableName('recordId') - use FMTID if configured\n      const tableId = this.getTableId(\n        options?.useEntityIds ?? this.databaseUseEntityIds,\n      );\n      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;\n    }\n\n    if (this.operation === \"getSingleField\" && this.operationParam) {\n      url += `/${this.operationParam}`;\n    } else {\n      // Add query string for select/expand (only when not getting a single field)\n      const queryString = this.buildQueryString();\n      url += queryString;\n    }\n\n    const mergedOptions = this.mergeExecuteOptions(options);\n    const result = await this.context._makeRequest(url, mergedOptions);\n\n    if (result.error) {\n      return { data: undefined, error: result.error };\n    }\n\n    let response = result.data;\n\n    // Handle single field operation\n    if (this.operation === \"getSingleField\") {\n      // Single field returns a JSON object with @context and value\n      const fieldResponse = response as ODataFieldResponse<T>;\n      return { data: fieldResponse.value as any, error: undefined };\n    }\n\n    // Transform response field IDs back to names if using entity IDs\n    // Only transform if useEntityIds resolves to true (respects per-request override)\n    const shouldUseIds = mergedOptions.useEntityIds ?? false;\n\n    // Build expand validation configs for transformation and validation\n    const expandValidationConfigs =\n      this.expandConfigs.length > 0\n        ? this.buildExpandValidationConfigs(this.expandConfigs)\n        : undefined;\n\n    if (this.occurrence?.baseTable && shouldUseIds) {\n      response = transformResponseFields(\n        response,\n        this.occurrence.baseTable,\n        expandValidationConfigs,\n      );\n    }\n\n    // Get schema from occurrence if available\n    const schema = this.occurrence?.baseTable?.schema;\n\n    // Validate the single record response\n    const validation = await validateSingleResponse<any>(\n      response,\n      schema,\n      this.selectedFields as (keyof T)[] | undefined,\n      expandValidationConfigs,\n      \"exact\", // Expect exactly one record\n    );\n\n    if (!validation.valid) {\n      return { data: undefined, error: validation.error };\n    }\n\n    // Handle null response\n    if (validation.data === null) {\n      return { data: null as any, error: undefined };\n    }\n\n    return { data: validation.data as any, error: undefined };\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    let url: string;\n\n    // Build the base URL depending on whether this came from a navigated EntitySet\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      // From navigated EntitySet: /sourceTable/relation('recordId')\n      url = `/${this.databaseName}/${this.navigateSourceTableName}/${this.navigateRelation}('${this.recordId}')`;\n    } else {\n      // For batch operations, use database-level setting (no per-request override available here)\n      const tableId = this.getTableId(this.databaseUseEntityIds);\n      url = `/${this.databaseName}/${tableId}('${this.recordId}')`;\n    }\n\n    if (this.operation === \"getSingleField\" && this.operationParam) {\n      url += `/${this.operationParam}`;\n    } else {\n      // Add query string for select/expand (only when not getting a single field)\n      const queryString = this.buildQueryString();\n      url += queryString;\n    }\n\n    return {\n      method: \"GET\",\n      url,\n    };\n  }\n\n  /**\n   * Returns the query string for this record builder (for testing purposes).\n   */\n  getQueryString(): string {\n    let path: string;\n\n    // Build the path depending on navigation context\n    if (\n      this.isNavigateFromEntitySet &&\n      this.navigateSourceTableName &&\n      this.navigateRelation\n    ) {\n      path = `/${this.navigateSourceTableName}/${this.navigateRelation}('${this.recordId}')`;\n    } else {\n      // Use getTableId to respect entity ID settings (same as getRequestConfig)\n      const tableId = this.getTableId(this.databaseUseEntityIds);\n      path = `/${tableId}('${this.recordId}')`;\n    }\n\n    if (this.operation === \"getSingleField\" && this.operationParam) {\n      return `${path}/${this.operationParam}`;\n    }\n\n    const queryString = this.buildQueryString();\n    return `${path}${queryString}`;\n  }\n\n  toRequest(baseUrl: string, options?: ExecuteOptions): Request {\n    const config = this.getRequestConfig();\n    const fullUrl = `${baseUrl}${config.url}`;\n\n    return new Request(fullUrl, {\n      method: config.method,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Accept: getAcceptHeader(options?.includeODataAnnotations),\n      },\n    });\n  }\n\n  async processResponse(\n    response: Response,\n    options?: ExecuteOptions,\n  ): Promise<\n    Result<RecordReturnType<T, IsSingleField, FieldKey, Selected, Expands>>\n  > {\n    // Use safeJsonParse to handle FileMaker's invalid JSON with unquoted ? values\n    const rawResponse = await safeJsonParse(response);\n\n    // Handle single field operation\n    if (this.operation === \"getSingleField\") {\n      // Single field returns a JSON object with @context and value\n      const fieldResponse = rawResponse as ODataFieldResponse<T>;\n      return { data: fieldResponse.value as any, error: undefined };\n    }\n\n    // Transform response field IDs back to names if using entity IDs\n    // Only transform if useEntityIds resolves to true (respects per-request override)\n    const shouldUseIds = options?.useEntityIds ?? this.databaseUseEntityIds;\n\n    // Build expand validation configs for transformation and validation\n    const expandValidationConfigs =\n      this.expandConfigs.length > 0\n        ? this.buildExpandValidationConfigs(this.expandConfigs)\n        : undefined;\n\n    let transformedResponse = rawResponse;\n    if (this.occurrence?.baseTable && shouldUseIds) {\n      transformedResponse = transformResponseFields(\n        rawResponse,\n        this.occurrence.baseTable,\n        expandValidationConfigs,\n      );\n    }\n\n    // Get schema from occurrence if available\n    const schema = this.occurrence?.baseTable?.schema;\n\n    // Validate the single record response\n    const validation = await validateSingleResponse<any>(\n      transformedResponse,\n      schema,\n      this.selectedFields as (keyof T)[] | undefined,\n      expandValidationConfigs,\n      \"exact\", // Expect exactly one record\n    );\n\n    if (!validation.valid) {\n      return { data: undefined, error: validation.error };\n    }\n\n    // Handle null response\n    if (validation.data === null) {\n      return { data: null as any, error: undefined };\n    }\n\n    return { data: validation.data as any, error: undefined };\n  }\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/esm/client/response-processor.d.ts

@@ -1,6 +1,5 @@
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { BaseTable } from './base-table.js';
-import { ExecuteOptions } from '../types.js';
 import { ExpandValidationConfig } from '../validation.js';
 import { ValidationError, ResponseStructureError } from '../errors.js';
 export type ODataResponse<T = unknown> = T & {
@@ -14,10 +13,6 @@ export type ODataRecordResponse<T = unknown> = ODataResponse<T & {
     "@id"?: string;
     "@editLink"?: string;
 }>;
-/**
- * Strip OData annotations from a single record
- */
-export declare function stripODataAnnotations<T extends Record<string, unknown>>(record: ODataRecordResponse<T>, options?: ExecuteOptions): T;
 /**
  * Transform field IDs back to names using the base table configuration
  */

package/dist/esm/client/sanitize-json.d.ts

@@ -0,0 +1,35 @@
+/**
+ * FileMaker OData API sometimes returns invalid JSON containing unquoted `?`
+ * characters as field values (e.g., `"fieldName": ?`), which causes JSON.parse()
+ * to fail. This module provides utilities to sanitize such responses before parsing.
+ */
+/**
+ * Sanitizes FileMaker OData JSON responses by replacing unquoted `?` values with `null`.
+ *
+ * FileMaker uses `?` to represent undefined/null values in its OData responses,
+ * but this is not valid JSON. This function converts those to proper `null` values.
+ *
+ * The regex uses two patterns:
+ * 1. `/:\s*\?(?=\s*[,}\]])/g` - for values in objects (after `:`)
+ * 2. `/(?<=[\[,])\s*\?(?=\s*[,\]])/g` - for values in arrays (after `[` or `,`)
+ *
+ * @param text - The raw response text from FileMaker OData API
+ * @returns Sanitized JSON string with `?` values replaced by `null`
+ *
+ * @example
+ * sanitizeFileMakerJson('{"field1": "valid", "field2": ?, "field3": null}')
+ * // Returns: '{"field1": "valid", "field2": null, "field3": null}'
+ */
+export declare function sanitizeFileMakerJson(text: string): string;
+/**
+ * Safely parses a Response body as JSON, handling FileMaker's invalid JSON responses.
+ *
+ * This function reads the response as text first, sanitizes any invalid `?` values,
+ * and then parses the sanitized JSON. This approach handles the case where FileMaker
+ * returns a Content-Type of application/json but the body contains invalid JSON.
+ *
+ * @param response - The fetch Response object
+ * @returns Parsed JSON data
+ * @throws ResponseParseError if the JSON is still invalid after sanitization (includes sanitized text for debugging)
+ */
+export declare function safeJsonParse<T = unknown>(response: Response): Promise<T>;

package/dist/esm/client/sanitize-json.js

@@ -0,0 +1,27 @@
+import { ResponseParseError } from "../errors.js";
+function sanitizeFileMakerJson(text) {
+  let result = text.replace(/:\s*\?(?=\s*[,}\]])/g, ": null");
+  result = result.replace(new RegExp("(?<=[\\[,])\\s*\\?(?=\\s*[,\\]])", "g"), " null");
+  return result;
+}
+async function safeJsonParse(response) {
+  const text = await response.text();
+  const sanitized = sanitizeFileMakerJson(text);
+  try {
+    return JSON.parse(sanitized);
+  } catch (err) {
+    throw new ResponseParseError(
+      response.url,
+      `Failed to parse response as JSON: ${err instanceof Error ? err.message : "Unknown error"}`,
+      {
+        rawText: sanitized,
+        cause: err instanceof Error ? err : void 0
+      }
+    );
+  }
+}
+export {
+  safeJsonParse,
+  sanitizeFileMakerJson
+};
+//# sourceMappingURL=sanitize-json.js.map

package/dist/esm/client/sanitize-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-json.js","sources":["../../../src/client/sanitize-json.ts"],"sourcesContent":["/**\n * FileMaker OData API sometimes returns invalid JSON containing unquoted `?`\n * characters as field values (e.g., `\"fieldName\": ?`), which causes JSON.parse()\n * to fail. This module provides utilities to sanitize such responses before parsing.\n */\n\nimport { ResponseParseError } from \"../errors\";\n\n/**\n * Sanitizes FileMaker OData JSON responses by replacing unquoted `?` values with `null`.\n *\n * FileMaker uses `?` to represent undefined/null values in its OData responses,\n * but this is not valid JSON. This function converts those to proper `null` values.\n *\n * The regex uses two patterns:\n * 1. `/:\\s*\\?(?=\\s*[,}\\]])/g` - for values in objects (after `:`)\n * 2. `/(?<=[\\[,])\\s*\\?(?=\\s*[,\\]])/g` - for values in arrays (after `[` or `,`)\n *\n * @param text - The raw response text from FileMaker OData API\n * @returns Sanitized JSON string with `?` values replaced by `null`\n *\n * @example\n * sanitizeFileMakerJson('{\"field1\": \"valid\", \"field2\": ?, \"field3\": null}')\n * // Returns: '{\"field1\": \"valid\", \"field2\": null, \"field3\": null}'\n */\nexport function sanitizeFileMakerJson(text: string): string {\n  // Replace unquoted ? values in objects (after colon)\n  // Also handles arrays when the array is a value in an object\n  let result = text.replace(/:\\s*\\?(?=\\s*[,}\\]])/g, \": null\");\n\n  // Replace unquoted ? values directly in arrays (not after colon)\n  // e.g., [1, ?, 3] -> [1, null, 3]\n  result = result.replace(/(?<=[\\[,])\\s*\\?(?=\\s*[,\\]])/g, \" null\");\n\n  return result;\n}\n\n/**\n * Safely parses a Response body as JSON, handling FileMaker's invalid JSON responses.\n *\n * This function reads the response as text first, sanitizes any invalid `?` values,\n * and then parses the sanitized JSON. This approach handles the case where FileMaker\n * returns a Content-Type of application/json but the body contains invalid JSON.\n *\n * @param response - The fetch Response object\n * @returns Parsed JSON data\n * @throws ResponseParseError if the JSON is still invalid after sanitization (includes sanitized text for debugging)\n */\nexport async function safeJsonParse<T = unknown>(\n  response: Response,\n): Promise<T> {\n  const text = await response.text();\n  const sanitized = sanitizeFileMakerJson(text);\n  try {\n    return JSON.parse(sanitized) as T;\n  } catch (err) {\n    throw new ResponseParseError(\n      response.url,\n      `Failed to parse response as JSON: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n      {\n        rawText: sanitized,\n        cause: err instanceof Error ? err : undefined,\n      },\n    );\n  }\n}\n"],"names":[],"mappings":";AAyBO,SAAS,sBAAsB,MAAsB;AAG1D,MAAI,SAAS,KAAK,QAAQ,wBAAwB,QAAQ;AAIjD,WAAA,OAAO,QAAQ,WAAA,oCAAA,GAAA,GAAgC,OAAO;AAExD,SAAA;AACT;AAaA,eAAsB,cACpB,UACY;AACN,QAAA,OAAO,MAAM,SAAS,KAAK;AAC3B,QAAA,YAAY,sBAAsB,IAAI;AACxC,MAAA;AACK,WAAA,KAAK,MAAM,SAAS;AAAA,WACpB,KAAK;AACZ,UAAM,IAAI;AAAA,MACR,SAAS;AAAA,MACT,qCAAqC,eAAe,QAAQ,IAAI,UAAU,eAAe;AAAA,MACzF;AAAA,QACE,SAAS;AAAA,QACT,OAAO,eAAe,QAAQ,MAAM;AAAA,MAAA;AAAA,IAExC;AAAA,EAAA;AAEJ;"}

package/dist/esm/client/update-builder.d.ts

@@ -85,7 +85,7 @@ export declare class ExecutableUpdateBuilder<T extends Record<string, any>, IsBy
         url: string;
         body?: any;
     };
-    toRequest(baseUrl: string): Request;
+    toRequest(baseUrl: string, options?: ExecuteOptions): Request;
     processResponse(response: Response, options?: ExecuteOptions): Promise<Result<ReturnPreference extends "minimal" ? {
         updatedCount: number;
     } : T>>;

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

@@ -1,6 +1,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 { getAcceptHeader } from "../types.js";
 import { QueryBuilder } from "./query-builder.js";
 import { getTableIdentifiers, transformFieldNamesToIds } from "../transform.js";
 class UpdateBuilder {
@@ -189,14 +190,14 @@ class ExecutableUpdateBuilder {
       body: JSON.stringify(transformedData)
     };
   }
-  toRequest(baseUrl) {
+  toRequest(baseUrl, options) {
     const config = this.getRequestConfig();
     const fullUrl = `${baseUrl}${config.url}`;
     return new Request(fullUrl, {
       method: config.method,
       headers: {
         "Content-Type": "application/json",
-        Accept: "application/json"
+        Accept: getAcceptHeader(options == null ? void 0 : options.includeODataAnnotations)
       },
       body: config.body
     });

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  ExecuteOptions,\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  getTableIdentifiers,\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  ReturnPreference extends \"minimal\" | \"representation\" = \"minimal\",\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 returnPreference: ReturnPreference;\n\n  private databaseUseEntityIds: boolean;\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    returnPreference: ReturnPreference;\n    databaseUseEntityIds?: boolean;\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.returnPreference = config.returnPreference;\n    this.databaseUseEntityIds = config.databaseUseEntityIds ?? false;\n  }\n\n  /**\n   * Update a single record by ID\n   * Returns updated count by default, or full record if returnFullRecord was set to true\n   */\n  byId(\n    id: string | number,\n  ): ExecutableUpdateBuilder<T, true, ReturnPreference> {\n    return new ExecutableUpdateBuilder<T, true, ReturnPreference>({\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      returnPreference: this.returnPreference,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n  }\n\n  /**\n   * Update records matching a filter query\n   * Returns updated count by default, or full record if returnFullRecord was set to true\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, ReturnPreference> {\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, ReturnPreference>({\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      returnPreference: this.returnPreference,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n  }\n}\n\n/**\n * Executable update builder - has execute() method\n * Returned after calling .byId() or .where()\n * Can return either updated count or full record based on returnFullRecord option\n */\nexport class ExecutableUpdateBuilder<\n  T extends Record<string, any>,\n  IsByFilter extends boolean,\n  ReturnPreference extends \"minimal\" | \"representation\" = \"minimal\",\n> implements\n    ExecutableBuilder<\n      ReturnPreference extends \"minimal\" ? { updatedCount: number } : T\n    >\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  private returnPreference: ReturnPreference;\n  private databaseUseEntityIds: boolean;\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    returnPreference: ReturnPreference;\n    databaseUseEntityIds?: boolean;\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    this.returnPreference = config.returnPreference;\n    this.databaseUseEntityIds = config.databaseUseEntityIds ?? false;\n  }\n\n  /**\n   * Helper to merge database-level useEntityIds with per-request options\n   */\n  private mergeExecuteOptions(\n    options?: RequestInit & FFetchOptions & ExecuteOptions,\n  ): RequestInit & FFetchOptions & { useEntityIds?: boolean } {\n    // If useEntityIds is not set in options, use the database-level setting\n    return {\n      ...options,\n      useEntityIds: options?.useEntityIds ?? this.databaseUseEntityIds,\n    };\n  }\n\n  /**\n   * Gets the table ID (FMTID) if using entity IDs, otherwise returns the table name\n   * @param useEntityIds - Optional override for entity ID usage\n   */\n  private getTableId(useEntityIds?: boolean): string {\n    if (!this.occurrence) {\n      return this.tableName;\n    }\n\n    const contextDefault = this.context._getUseEntityIds?.() ?? false;\n    const shouldUseIds = useEntityIds ?? contextDefault;\n\n    if (shouldUseIds) {\n      const identifiers = getTableIdentifiers(this.occurrence);\n      if (!identifiers.id) {\n        throw new Error(\n          `useEntityIds is true but TableOccurrence \"${identifiers.name}\" does not have an fmtId defined`,\n        );\n      }\n      return identifiers.id;\n    }\n\n    return this.occurrence.getTableName();\n  }\n\n  async execute(\n    options?: RequestInit & FFetchOptions & { useEntityIds?: boolean },\n  ): Promise<\n    Result<ReturnPreference extends \"minimal\" ? { updatedCount: number } : T>\n  > {\n    // Merge database-level useEntityIds with per-request options\n    const mergedOptions = this.mergeExecuteOptions(options);\n\n    // Get table identifier with override support\n    const tableId = this.getTableId(mergedOptions.useEntityIds);\n\n    // Transform field names to FMFIDs if using entity IDs\n    // Only transform if useEntityIds resolves to true (respects per-request override)\n    const shouldUseIds = mergedOptions.useEntityIds ?? false;\n\n    const transformedData =\n      this.occurrence?.baseTable && shouldUseIds\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    // Set Prefer header based on returnPreference\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.returnPreference === \"representation\") {\n      headers[\"Prefer\"] = \"return=representation\";\n    }\n\n    // Make PATCH request with JSON body\n    const result = await this.context._makeRequest(url, {\n      method: \"PATCH\",\n      headers,\n      body: JSON.stringify(transformedData),\n      ...mergedOptions,\n    });\n\n    if (result.error) {\n      return { data: undefined, error: result.error };\n    }\n\n    const response = result.data;\n\n    // Handle based on return preference\n    if (this.returnPreference === \"representation\") {\n      // Return the full updated record\n      return {\n        data: response as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    } else {\n      // Return updated count (minimal)\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 {\n        data: { updatedCount } as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    }\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    // For batch operations, use database-level setting (no per-request override available here)\n    const tableId = this.getTableId(this.databaseUseEntityIds);\n\n    // Transform field names to FMFIDs if using entity IDs\n    const transformedData =\n      this.occurrence?.baseTable && this.databaseUseEntityIds\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  toRequest(baseUrl: string): Request {\n    const config = this.getRequestConfig();\n    const fullUrl = `${baseUrl}${config.url}`;\n\n    return new Request(fullUrl, {\n      method: config.method,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json\",\n      },\n      body: config.body,\n    });\n  }\n\n  async processResponse(\n    response: Response,\n    options?: ExecuteOptions,\n  ): Promise<\n    Result<ReturnPreference extends \"minimal\" ? { updatedCount: number } : T>\n  > {\n    // Check for empty response (204 No Content)\n    const text = await response.text();\n    if (!text || text.trim() === \"\") {\n      // For 204 No Content, check the fmodata.affected_rows header\n      const affectedRows = response.headers.get(\"fmodata.affected_rows\");\n      const updatedCount = affectedRows ? parseInt(affectedRows, 10) : 1;\n      return {\n        data: { updatedCount } as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    }\n\n    const rawResponse = JSON.parse(text);\n\n    // Handle based on return preference\n    if (this.returnPreference === \"representation\") {\n      // Return the full updated record\n      return {\n        data: rawResponse as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    } else {\n      // Return updated count (minimal)\n      let updatedCount = 0;\n\n      if (typeof rawResponse === \"number\") {\n        updatedCount = rawResponse;\n      } else if (rawResponse && typeof rawResponse === \"object\") {\n        // Check if the response has a count property (fallback)\n        updatedCount = (rawResponse as any).updatedCount || 0;\n      }\n\n      return {\n        data: { updatedCount } as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\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  ExecuteOptions,\n} from \"../types\";\nimport { getAcceptHeader } 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  getTableIdentifiers,\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  ReturnPreference extends \"minimal\" | \"representation\" = \"minimal\",\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 returnPreference: ReturnPreference;\n\n  private databaseUseEntityIds: boolean;\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    returnPreference: ReturnPreference;\n    databaseUseEntityIds?: boolean;\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.returnPreference = config.returnPreference;\n    this.databaseUseEntityIds = config.databaseUseEntityIds ?? false;\n  }\n\n  /**\n   * Update a single record by ID\n   * Returns updated count by default, or full record if returnFullRecord was set to true\n   */\n  byId(\n    id: string | number,\n  ): ExecutableUpdateBuilder<T, true, ReturnPreference> {\n    return new ExecutableUpdateBuilder<T, true, ReturnPreference>({\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      returnPreference: this.returnPreference,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n  }\n\n  /**\n   * Update records matching a filter query\n   * Returns updated count by default, or full record if returnFullRecord was set to true\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, ReturnPreference> {\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, ReturnPreference>({\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      returnPreference: this.returnPreference,\n      databaseUseEntityIds: this.databaseUseEntityIds,\n    });\n  }\n}\n\n/**\n * Executable update builder - has execute() method\n * Returned after calling .byId() or .where()\n * Can return either updated count or full record based on returnFullRecord option\n */\nexport class ExecutableUpdateBuilder<\n  T extends Record<string, any>,\n  IsByFilter extends boolean,\n  ReturnPreference extends \"minimal\" | \"representation\" = \"minimal\",\n> implements\n    ExecutableBuilder<\n      ReturnPreference extends \"minimal\" ? { updatedCount: number } : T\n    >\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  private returnPreference: ReturnPreference;\n  private databaseUseEntityIds: boolean;\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    returnPreference: ReturnPreference;\n    databaseUseEntityIds?: boolean;\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    this.returnPreference = config.returnPreference;\n    this.databaseUseEntityIds = config.databaseUseEntityIds ?? false;\n  }\n\n  /**\n   * Helper to merge database-level useEntityIds with per-request options\n   */\n  private mergeExecuteOptions(\n    options?: RequestInit & FFetchOptions & ExecuteOptions,\n  ): RequestInit & FFetchOptions & { useEntityIds?: boolean } {\n    // If useEntityIds is not set in options, use the database-level setting\n    return {\n      ...options,\n      useEntityIds: options?.useEntityIds ?? this.databaseUseEntityIds,\n    };\n  }\n\n  /**\n   * Gets the table ID (FMTID) if using entity IDs, otherwise returns the table name\n   * @param useEntityIds - Optional override for entity ID usage\n   */\n  private getTableId(useEntityIds?: boolean): string {\n    if (!this.occurrence) {\n      return this.tableName;\n    }\n\n    const contextDefault = this.context._getUseEntityIds?.() ?? false;\n    const shouldUseIds = useEntityIds ?? contextDefault;\n\n    if (shouldUseIds) {\n      const identifiers = getTableIdentifiers(this.occurrence);\n      if (!identifiers.id) {\n        throw new Error(\n          `useEntityIds is true but TableOccurrence \"${identifiers.name}\" does not have an fmtId defined`,\n        );\n      }\n      return identifiers.id;\n    }\n\n    return this.occurrence.getTableName();\n  }\n\n  async execute(\n    options?: RequestInit & FFetchOptions & { useEntityIds?: boolean },\n  ): Promise<\n    Result<ReturnPreference extends \"minimal\" ? { updatedCount: number } : T>\n  > {\n    // Merge database-level useEntityIds with per-request options\n    const mergedOptions = this.mergeExecuteOptions(options);\n\n    // Get table identifier with override support\n    const tableId = this.getTableId(mergedOptions.useEntityIds);\n\n    // Transform field names to FMFIDs if using entity IDs\n    // Only transform if useEntityIds resolves to true (respects per-request override)\n    const shouldUseIds = mergedOptions.useEntityIds ?? false;\n\n    const transformedData =\n      this.occurrence?.baseTable && shouldUseIds\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    // Set Prefer header based on returnPreference\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n\n    if (this.returnPreference === \"representation\") {\n      headers[\"Prefer\"] = \"return=representation\";\n    }\n\n    // Make PATCH request with JSON body\n    const result = await this.context._makeRequest(url, {\n      method: \"PATCH\",\n      headers,\n      body: JSON.stringify(transformedData),\n      ...mergedOptions,\n    });\n\n    if (result.error) {\n      return { data: undefined, error: result.error };\n    }\n\n    const response = result.data;\n\n    // Handle based on return preference\n    if (this.returnPreference === \"representation\") {\n      // Return the full updated record\n      return {\n        data: response as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    } else {\n      // Return updated count (minimal)\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 {\n        data: { updatedCount } as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    }\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    // For batch operations, use database-level setting (no per-request override available here)\n    const tableId = this.getTableId(this.databaseUseEntityIds);\n\n    // Transform field names to FMFIDs if using entity IDs\n    const transformedData =\n      this.occurrence?.baseTable && this.databaseUseEntityIds\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  toRequest(baseUrl: string, options?: ExecuteOptions): Request {\n    const config = this.getRequestConfig();\n    const fullUrl = `${baseUrl}${config.url}`;\n\n    return new Request(fullUrl, {\n      method: config.method,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Accept: getAcceptHeader(options?.includeODataAnnotations),\n      },\n      body: config.body,\n    });\n  }\n\n  async processResponse(\n    response: Response,\n    options?: ExecuteOptions,\n  ): Promise<\n    Result<ReturnPreference extends \"minimal\" ? { updatedCount: number } : T>\n  > {\n    // Check for empty response (204 No Content)\n    const text = await response.text();\n    if (!text || text.trim() === \"\") {\n      // For 204 No Content, check the fmodata.affected_rows header\n      const affectedRows = response.headers.get(\"fmodata.affected_rows\");\n      const updatedCount = affectedRows ? parseInt(affectedRows, 10) : 1;\n      return {\n        data: { updatedCount } as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    }\n\n    const rawResponse = JSON.parse(text);\n\n    // Handle based on return preference\n    if (this.returnPreference === \"representation\") {\n      // Return the full updated record\n      return {\n        data: rawResponse as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    } else {\n      // Return updated count (minimal)\n      let updatedCount = 0;\n\n      if (typeof rawResponse === \"number\") {\n        updatedCount = rawResponse;\n      } else if (rawResponse && typeof rawResponse === \"object\") {\n        // Check if the response has a count property (fallback)\n        updatedCount = (rawResponse as any).updatedCount || 0;\n      }\n\n      return {\n        data: { updatedCount } as ReturnPreference extends \"minimal\"\n          ? { updatedCount: number }\n          : T,\n        error: undefined,\n      };\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;AAsBO,MAAM,cAIX;AAAA,EAUA,YAAY,QAQT;AAjBK;AACA;AACA;AACA;AACA;AACA;AAEA;AAWN,SAAK,aAAa,OAAO;AACzB,SAAK,YAAY,OAAO;AACxB,SAAK,eAAe,OAAO;AAC3B,SAAK,UAAU,OAAO;AACtB,SAAK,OAAO,OAAO;AACnB,SAAK,mBAAmB,OAAO;AAC1B,SAAA,uBAAuB,OAAO,wBAAwB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7D,KACE,IACoD;AACpD,WAAO,IAAI,wBAAmD;AAAA,MAC5D,YAAY,KAAK;AAAA,MACjB,WAAW,KAAK;AAAA,MAChB,cAAc,KAAK;AAAA,MACnB,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,MAAM;AAAA,MACN,UAAU;AAAA,MACV,kBAAkB,KAAK;AAAA,MACvB,sBAAsB,KAAK;AAAA,IAAA,CAC5B;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQH,MACE,IAGoD;AAE9C,UAAA,eAAe,IAAI,aAMvB;AAAA,MACA,YAAY;AAAA,MACZ,WAAW,KAAK;AAAA,MAChB,cAAc,KAAK;AAAA,MACnB,SAAS,KAAK;AAAA,IAAA,CACf;AAGK,UAAA,oBAAoB,GAAG,YAAY;AAEzC,WAAO,IAAI,wBAAmD;AAAA,MAC5D,YAAY,KAAK;AAAA,MACjB,WAAW,KAAK;AAAA,MAChB,cAAc,KAAK;AAAA,MACnB,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,MAAM;AAAA,MACN,cAAc;AAAA,MACd,kBAAkB,KAAK;AAAA,MACvB,sBAAsB,KAAK;AAAA,IAAA,CAC5B;AAAA,EAAA;AAEL;AAOO,MAAM,wBAQb;AAAA,EAYE,YAAY,QAWT;AAtBK;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAcN,SAAK,aAAa,OAAO;AACzB,SAAK,YAAY,OAAO;AACxB,SAAK,eAAe,OAAO;AAC3B,SAAK,UAAU,OAAO;AACtB,SAAK,OAAO,OAAO;AACnB,SAAK,OAAO,OAAO;AACnB,SAAK,WAAW,OAAO;AACvB,SAAK,eAAe,OAAO;AAC3B,SAAK,mBAAmB,OAAO;AAC1B,SAAA,uBAAuB,OAAO,wBAAwB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMrD,oBACN,SAC0D;AAEnD,WAAA;AAAA,MACL,GAAG;AAAA,MACH,eAAc,mCAAS,iBAAgB,KAAK;AAAA,IAC9C;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOM,WAAW,cAAgC;;AAC7C,QAAA,CAAC,KAAK,YAAY;AACpB,aAAO,KAAK;AAAA,IAAA;AAGd,UAAM,mBAAiB,gBAAK,SAAQ,qBAAb,gCAAqC;AAC5D,UAAM,eAAe,gBAAgB;AAErC,QAAI,cAAc;AACV,YAAA,cAAc,oBAAoB,KAAK,UAAU;AACnD,UAAA,CAAC,YAAY,IAAI;AACnB,cAAM,IAAI;AAAA,UACR,6CAA6C,YAAY,IAAI;AAAA,QAC/D;AAAA,MAAA;AAEF,aAAO,YAAY;AAAA,IAAA;AAGd,WAAA,KAAK,WAAW,aAAa;AAAA,EAAA;AAAA,EAGtC,MAAM,QACJ,SAGA;;AAEM,UAAA,gBAAgB,KAAK,oBAAoB,OAAO;AAGtD,UAAM,UAAU,KAAK,WAAW,cAAc,YAAY;AAIpD,UAAA,eAAe,cAAc,gBAAgB;AAEnD,UAAM,oBACJ,UAAK,eAAL,mBAAiB,cAAa,eAC1B,yBAAyB,KAAK,MAAM,KAAK,WAAW,SAAS,IAC7D,KAAK;AAEP,QAAA;AAEA,QAAA,KAAK,SAAS,QAAQ;AAExB,YAAM,IAAI,KAAK,YAAY,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAA,IAAA,OACnD;AAED,UAAA,CAAC,KAAK,cAAc;AAChB,cAAA,IAAI,MAAM,mDAAmD;AAAA,MAAA;AAI/D,YAAA,cAAc,KAAK,aAAa,eAAe;AAGrD,YAAM,cAAc,YAAY,WAAW,IAAI,OAAO,EAAE,IACpD,YAAY,MAAM,IAAI,OAAO,GAAG,MAAM,IACtC,YAAY,WAAW,IAAI,KAAK,SAAS,EAAE,IACzC,YAAY,MAAM,IAAI,KAAK,SAAS,GAAG,MAAM,IAC7C;AAEN,YAAM,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,WAAW;AAAA,IAAA;AAItD,UAAM,UAAkC;AAAA,MACtC,gBAAgB;AAAA,IAClB;AAEI,QAAA,KAAK,qBAAqB,kBAAkB;AAC9C,cAAQ,QAAQ,IAAI;AAAA,IAAA;AAItB,UAAM,SAAS,MAAM,KAAK,QAAQ,aAAa,KAAK;AAAA,MAClD,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU,eAAe;AAAA,MACpC,GAAG;AAAA,IAAA,CACJ;AAED,QAAI,OAAO,OAAO;AAChB,aAAO,EAAE,MAAM,QAAW,OAAO,OAAO,MAAM;AAAA,IAAA;AAGhD,UAAM,WAAW,OAAO;AAGpB,QAAA,KAAK,qBAAqB,kBAAkB;AAEvC,aAAA;AAAA,QACL,MAAM;AAAA,QAGN,OAAO;AAAA,MACT;AAAA,IAAA,OACK;AAEL,UAAI,eAAe;AAEf,UAAA,OAAO,aAAa,UAAU;AACjB,uBAAA;AAAA,MACN,WAAA,YAAY,OAAO,aAAa,UAAU;AAEnD,uBAAgB,SAAiB,gBAAgB;AAAA,MAAA;AAG5C,aAAA;AAAA,QACL,MAAM,EAAE,aAAa;AAAA,QAGrB,OAAO;AAAA,MACT;AAAA,IAAA;AAAA,EACF;AAAA,EAGF,mBAAgE;;AAE9D,UAAM,UAAU,KAAK,WAAW,KAAK,oBAAoB;AAGzD,UAAM,oBACJ,UAAK,eAAL,mBAAiB,cAAa,KAAK,uBAC/B,yBAAyB,KAAK,MAAM,KAAK,WAAW,SAAS,IAC7D,KAAK;AAEP,QAAA;AAEA,QAAA,KAAK,SAAS,QAAQ;AACxB,YAAM,IAAI,KAAK,YAAY,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAA,IAAA,OACnD;AACD,UAAA,CAAC,KAAK,cAAc;AAChB,cAAA,IAAI,MAAM,mDAAmD;AAAA,MAAA;AAG/D,YAAA,cAAc,KAAK,aAAa,eAAe;AACrD,YAAM,cAAc,YAAY,WAAW,IAAI,OAAO,EAAE,IACpD,YAAY,MAAM,IAAI,OAAO,GAAG,MAAM,IACtC,YAAY,WAAW,IAAI,KAAK,SAAS,EAAE,IACzC,YAAY,MAAM,IAAI,KAAK,SAAS,GAAG,MAAM,IAC7C;AAEN,YAAM,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,WAAW;AAAA,IAAA;AAG/C,WAAA;AAAA,MACL,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU,eAAe;AAAA,IACtC;AAAA,EAAA;AAAA,EAGF,UAAU,SAAiB,SAAmC;AACtD,UAAA,SAAS,KAAK,iBAAiB;AACrC,UAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG;AAEhC,WAAA,IAAI,QAAQ,SAAS;AAAA,MAC1B,QAAQ,OAAO;AAAA,MACf,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,QAAQ,gBAAgB,mCAAS,uBAAuB;AAAA,MAC1D;AAAA,MACA,MAAM,OAAO;AAAA,IAAA,CACd;AAAA,EAAA;AAAA,EAGH,MAAM,gBACJ,UACA,SAGA;AAEM,UAAA,OAAO,MAAM,SAAS,KAAK;AACjC,QAAI,CAAC,QAAQ,KAAK,KAAA,MAAW,IAAI;AAE/B,YAAM,eAAe,SAAS,QAAQ,IAAI,uBAAuB;AACjE,YAAM,eAAe,eAAe,SAAS,cAAc,EAAE,IAAI;AAC1D,aAAA;AAAA,QACL,MAAM,EAAE,aAAa;AAAA,QAGrB,OAAO;AAAA,MACT;AAAA,IAAA;AAGI,UAAA,cAAc,KAAK,MAAM,IAAI;AAG/B,QAAA,KAAK,qBAAqB,kBAAkB;AAEvC,aAAA;AAAA,QACL,MAAM;AAAA,QAGN,OAAO;AAAA,MACT;AAAA,IAAA,OACK;AAEL,UAAI,eAAe;AAEf,UAAA,OAAO,gBAAgB,UAAU;AACpB,uBAAA;AAAA,MACN,WAAA,eAAe,OAAO,gBAAgB,UAAU;AAEzD,uBAAgB,YAAoB,gBAAgB;AAAA,MAAA;AAG/C,aAAA;AAAA,QACL,MAAM,EAAE,aAAa;AAAA,QAGrB,OAAO;AAAA,MACT;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/esm/errors.d.ts

@@ -62,12 +62,22 @@ export declare class InvalidLocationHeaderError extends FMODataError {
     readonly locationHeader?: string;
     constructor(message: string, locationHeader?: string);
 }
+export declare class ResponseParseError extends FMODataError {
+    readonly kind: "ResponseParseError";
+    readonly url: string;
+    readonly rawText?: string;
+    constructor(url: string, message: string, options?: {
+        rawText?: string;
+        cause?: Error;
+    });
+}
 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 isSchemaLockedError(error: unknown): error is SchemaLockedError;
 export declare function isResponseStructureError(error: unknown): error is ResponseStructureError;
 export declare function isRecordCountMismatchError(error: unknown): error is RecordCountMismatchError;
+export declare function isResponseParseError(error: unknown): error is ResponseParseError;
 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 | SchemaLockedError | ValidationError | ResponseStructureError | RecordCountMismatchError | InvalidLocationHeaderError;
+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 | SchemaLockedError | ValidationError | ResponseStructureError | RecordCountMismatchError | InvalidLocationHeaderError | ResponseParseError;

package/dist/esm/errors.js

@@ -107,6 +107,16 @@ class InvalidLocationHeaderError extends FMODataError {
     this.locationHeader = locationHeader;
   }
 }
+class ResponseParseError extends FMODataError {
+  constructor(url, message, options) {
+    super(message, (options == null ? void 0 : options.cause) ? { cause: options.cause } : void 0);
+    __publicField(this, "kind", "ResponseParseError");
+    __publicField(this, "url");
+    __publicField(this, "rawText");
+    this.url = url;
+    this.rawText = options == null ? void 0 : options.rawText;
+  }
+}
 function isHTTPError(error) {
   return error instanceof HTTPError;
 }
@@ -125,6 +135,9 @@ function isResponseStructureError(error) {
 function isRecordCountMismatchError(error) {
   return error instanceof RecordCountMismatchError;
 }
+function isResponseParseError(error) {
+  return error instanceof ResponseParseError;
+}
 function isFMODataError(error) {
   return error instanceof FMODataError;
 }
@@ -134,6 +147,7 @@ export {
   InvalidLocationHeaderError,
   ODataError,
   RecordCountMismatchError,
+  ResponseParseError,
   ResponseStructureError,
   SchemaLockedError,
   ValidationError,
@@ -141,6 +155,7 @@ export {
   isHTTPError,
   isODataError,
   isRecordCountMismatchError,
+  isResponseParseError,
   isResponseStructureError,
   isSchemaLockedError,
   isValidationError

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\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 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"],"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;AAEO,MAAM,0BAA0B,aAAa;AAAA,EAMlD,YAAY,KAAa,SAAiB,SAAe;AACjD,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;AAEO,MAAM,mCAAmC,aAAa;AAAA,EAI3D,YAAY,SAAiB,gBAAyB;AACpD,UAAM,OAAO;AAJN,gCAAO;AACP;AAIP,SAAK,iBAAiB;AAAA,EAAA;AAE1B;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,oBACd,OAC4B;AAC5B,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;"}
+{"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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"}

package/dist/esm/index.d.ts

@@ -10,5 +10,5 @@ export type { SchemaManager, Field, StringField, NumericField, DateField, TimeFi
 export type { Result, 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, isHTTPError, isValidationError, isODataError, isSchemaLockedError, isResponseStructureError, isRecordCountMismatchError, isFMODataError, } from './errors.js';
+export { FMODataError, HTTPError, ODataError, SchemaLockedError, ValidationError, ResponseStructureError, RecordCountMismatchError, ResponseParseError, isHTTPError, isValidationError, isODataError, isSchemaLockedError, isResponseStructureError, isRecordCountMismatchError, isResponseParseError, isFMODataError, } from './errors.js';
 export type { FMODataErrorType } from './errors.js';

package/dist/esm/index.js

@@ -3,7 +3,7 @@ import { defineTableOccurrence } from "./client/table-occurrence.js";
 import { buildOccurrences } from "./client/build-occurrences.js";
 import { FMServerConnection } from "./client/filemaker-odata.js";
 import { AbortError, CircuitOpenError, NetworkError, RetryLimitError, TimeoutError } from "@fetchkit/ffetch";
-import { FMODataError, HTTPError, ODataError, RecordCountMismatchError, ResponseStructureError, SchemaLockedError, ValidationError, isFMODataError, isHTTPError, isODataError, isRecordCountMismatchError, isResponseStructureError, isSchemaLockedError, isValidationError } from "./errors.js";
+import { FMODataError, HTTPError, ODataError, RecordCountMismatchError, ResponseParseError, ResponseStructureError, SchemaLockedError, ValidationError, isFMODataError, isHTTPError, isODataError, isRecordCountMismatchError, isResponseParseError, isResponseStructureError, isSchemaLockedError, isValidationError } from "./errors.js";
 export {
   AbortError,
   CircuitOpenError,
@@ -13,6 +13,7 @@ export {
   NetworkError,
   ODataError,
   RecordCountMismatchError,
+  ResponseParseError,
   ResponseStructureError,
   RetryLimitError,
   SchemaLockedError,
@@ -25,6 +26,7 @@ export {
   isHTTPError,
   isODataError,
   isRecordCountMismatchError,
+  isResponseParseError,
   isResponseStructureError,
   isSchemaLockedError,
   isValidationError

package/dist/esm/types.d.ts

@@ -16,9 +16,10 @@ export interface ExecutableBuilder<T> {
     /**
      * Convert this builder to a native Request object for batch processing.
      * @param baseUrl - The base URL for the OData service
+     * @param options - Optional execution options (e.g., includeODataAnnotations)
      * @returns A native Request object
      */
-    toRequest(baseUrl: string): Request;
+    toRequest(baseUrl: string, options?: ExecuteOptions): Request;
     /**
      * Process a raw Response object into a typed Result.
      * This allows builders to apply their own validation and transformation logic.
@@ -92,6 +93,12 @@ export type ExecuteOptions = {
      */
     useEntityIds?: boolean;
 };
+/**
+ * Get the Accept header value based on includeODataAnnotations option
+ * @param includeODataAnnotations - Whether to include OData annotations
+ * @returns Accept header value
+ */
+export declare function getAcceptHeader(includeODataAnnotations?: boolean): string;
 export type ConditionallyWithODataAnnotations<T, IncludeODataAnnotations extends boolean> = IncludeODataAnnotations extends true ? T & {
     "@id": string;
     "@editLink": string;

package/dist/esm/types.js

@@ -0,0 +1,7 @@
+function getAcceptHeader(includeODataAnnotations) {
+  return includeODataAnnotations === true ? "application/json" : "application/json;odata.metadata=none";
+}
+export {
+  getAcceptHeader
+};
+//# sourceMappingURL=types.js.map