@proofkit/fmodata 0.1.0-alpha.0

package/dist/esm/client/filemaker-odata.d.ts

@@ -0,0 +1,26 @@
+import { FFetchOptions } from '@fetchkit/ffetch';
+import { Auth, ExecutionContext } from '../types.js';
+import { Database } from './database.js';
+import { TableOccurrence } from './table-occurrence.js';
+export declare class FileMakerOData implements ExecutionContext {
+    private fetchClient;
+    private serverUrl;
+    private auth;
+    constructor(config: {
+        serverUrl: string;
+        auth: Auth;
+        fetchClientOptions?: FFetchOptions;
+    });
+    /**
+     * @internal
+     */
+    _makeRequest<T>(url: string, options?: RequestInit & FFetchOptions): Promise<T>;
+    database<const Occurrences extends readonly TableOccurrence<any, any, any, any>[]>(name: string, config?: {
+        occurrences?: Occurrences;
+    }): Database<Occurrences>;
+    /**
+     * Lists all available databases from the FileMaker OData service.
+     * @returns Promise resolving to an array of database names
+     */
+    listDatabaseNames(): Promise<string[]>;
+}

package/dist/esm/client/filemaker-odata.js

@@ -0,0 +1,85 @@
+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 createClient from "@fetchkit/ffetch";
+import { Database } from "./database.js";
+class FileMakerOData {
+  constructor(config) {
+    __publicField(this, "fetchClient");
+    __publicField(this, "serverUrl");
+    __publicField(this, "auth");
+    this.fetchClient = createClient({
+      retries: 0,
+      ...config.fetchClientOptions
+    });
+    const url = new URL(config.serverUrl);
+    if (url.protocol !== "https:") {
+      url.protocol = "https:";
+    }
+    url.pathname = url.pathname.replace(/\/+$/, "");
+    this.serverUrl = url.toString().replace(/\/+$/, "");
+    this.auth = config.auth;
+  }
+  /**
+   * @internal
+   */
+  async _makeRequest(url, options) {
+    var _a;
+    const baseUrl = `${this.serverUrl}${"apiKey" in this.auth ? `/otto` : ""}/fmi/odata/v4`;
+    const headers = {
+      Authorization: "apiKey" in this.auth ? `Bearer ${this.auth.apiKey}` : `Basic ${btoa(`${this.auth.username}:${this.auth.password}`)}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      ...(options == null ? void 0 : options.headers) || {}
+    };
+    const fetchHandler = options == null ? void 0 : options.fetchHandler;
+    const {
+      headers: _headers,
+      fetchHandler: _fetchHandler,
+      ...restOptions
+    } = options || {};
+    const clientToUse = fetchHandler ? createClient({ retries: 0, fetchHandler }) : this.fetchClient;
+    const resp = await clientToUse(baseUrl + url, {
+      ...restOptions,
+      headers
+    });
+    if (!resp.ok) {
+      throw new Error(
+        `Failed to make request to ${baseUrl + url}: ${resp.statusText}`
+      );
+    }
+    const affectedRows = resp.headers.get("fmodata.affected_rows");
+    if (affectedRows !== null) {
+      return parseInt(affectedRows, 10);
+    }
+    if (resp.status === 204) {
+      return 0;
+    }
+    if ((_a = resp.headers.get("content-type")) == null ? void 0 : _a.includes("application/json")) {
+      let data = await resp.json();
+      if (data.error) {
+        throw new Error(data.error);
+      }
+      return data;
+    }
+    return await resp.text();
+  }
+  database(name, config) {
+    return new Database(name, this, config);
+  }
+  /**
+   * Lists all available databases from the FileMaker OData service.
+   * @returns Promise resolving to an array of database names
+   */
+  async listDatabaseNames() {
+    const response = await this._makeRequest("/");
+    if (response.value && Array.isArray(response.value)) {
+      return response.value.map((item) => item.name);
+    }
+    return [];
+  }
+}
+export {
+  FileMakerOData
+};
+//# sourceMappingURL=filemaker-odata.js.map

package/dist/esm/client/filemaker-odata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filemaker-odata.js","sources":["../../../src/client/filemaker-odata.ts"],"sourcesContent":["import createClient, { FFetchOptions } from \"@fetchkit/ffetch\";\nimport type { Auth, ExecutionContext } from \"../types\";\nimport { Database } from \"./database\";\nimport { TableOccurrence } from \"./table-occurrence\";\n\nexport class FileMakerOData implements ExecutionContext {\n  private fetchClient: ReturnType<typeof createClient>;\n  private serverUrl: string;\n  private auth: Auth;\n  constructor(config: {\n    serverUrl: string;\n    auth: Auth;\n    fetchClientOptions?: FFetchOptions;\n  }) {\n    this.fetchClient = createClient({\n      retries: 0,\n      ...config.fetchClientOptions,\n    });\n    // Ensure the URL uses https://, is valid, and has no trailing slash\n    const url = new URL(config.serverUrl);\n    if (url.protocol !== \"https:\") {\n      url.protocol = \"https:\";\n    }\n    // Remove any trailing slash from pathname\n    url.pathname = url.pathname.replace(/\\/+$/, \"\");\n    this.serverUrl = url.toString().replace(/\\/+$/, \"\");\n    this.auth = config.auth;\n  }\n\n  /**\n   * @internal\n   */\n  async _makeRequest<T>(\n    url: string,\n    options?: RequestInit & FFetchOptions,\n  ): Promise<T> {\n    const baseUrl = `${this.serverUrl}${\"apiKey\" in this.auth ? `/otto` : \"\"}/fmi/odata/v4`;\n\n    const headers = {\n      Authorization:\n        \"apiKey\" in this.auth\n          ? `Bearer ${this.auth.apiKey}`\n          : `Basic ${btoa(`${this.auth.username}:${this.auth.password}`)}`,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      ...(options?.headers || {}),\n    };\n\n    // TEMPORARY WORKAROUND: Hopefully this feature will be fixed in the ffetch library\n    // Extract fetchHandler and headers separately, only for tests where we're overriding the fetch handler per-request\n    const fetchHandler = options?.fetchHandler;\n    const {\n      headers: _headers,\n      fetchHandler: _fetchHandler,\n      ...restOptions\n    } = options || {};\n\n    // If fetchHandler is provided, create a temporary client with it\n    // Otherwise use the existing client\n    const clientToUse = fetchHandler\n      ? createClient({ retries: 0, fetchHandler })\n      : this.fetchClient;\n\n    const resp = await clientToUse(baseUrl + url, {\n      ...restOptions,\n      headers,\n    });\n\n    if (!resp.ok) {\n      throw new Error(\n        `Failed to make request to ${baseUrl + url}: ${resp.statusText}`,\n      );\n    }\n\n    // Check for affected rows header (for DELETE and bulk PATCH operations)\n    // FileMaker may return this with 204 No Content or 200 OK\n    const affectedRows = resp.headers.get(\"fmodata.affected_rows\");\n    if (affectedRows !== null) {\n      return parseInt(affectedRows, 10) as T;\n    }\n\n    // Handle 204 No Content with no body\n    if (resp.status === 204) {\n      return 0 as T;\n    }\n\n    if (resp.headers.get(\"content-type\")?.includes(\"application/json\")) {\n      let data = await resp.json();\n      if (data.error) {\n        throw new Error(data.error);\n      }\n      return data as T;\n    }\n    return (await resp.text()) as T;\n  }\n\n  database<\n    const Occurrences extends readonly TableOccurrence<any, any, any, any>[],\n  >(\n    name: string,\n    config?: { occurrences?: Occurrences },\n  ): Database<Occurrences> {\n    return new Database(name, this, config);\n  }\n\n  /**\n   * Lists all available databases from the FileMaker OData service.\n   * @returns Promise resolving to an array of database names\n   */\n  async listDatabaseNames(): Promise<string[]> {\n    const response = (await this._makeRequest(\"/\")) as {\n      value?: Array<{ name: string }>;\n    };\n    if (response.value && Array.isArray(response.value)) {\n      return response.value.map((item) => item.name);\n    }\n    return [];\n  }\n}\n"],"names":[],"mappings":";;;;;AAKO,MAAM,eAA2C;AAAA,EAItD,YAAY,QAIT;AAPK;AACA;AACA;AAMN,SAAK,cAAc,aAAa;AAAA,MAC9B,SAAS;AAAA,MACT,GAAG,OAAO;AAAA,IAAA,CACX;AAED,UAAM,MAAM,IAAI,IAAI,OAAO,SAAS;AAChC,QAAA,IAAI,aAAa,UAAU;AAC7B,UAAI,WAAW;AAAA,IAAA;AAGjB,QAAI,WAAW,IAAI,SAAS,QAAQ,QAAQ,EAAE;AAC9C,SAAK,YAAY,IAAI,SAAW,EAAA,QAAQ,QAAQ,EAAE;AAClD,SAAK,OAAO,OAAO;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMrB,MAAM,aACJ,KACA,SACY;;AACN,UAAA,UAAU,GAAG,KAAK,SAAS,GAAG,YAAY,KAAK,OAAO,UAAU,EAAE;AAExE,UAAM,UAAU;AAAA,MACd,eACE,YAAY,KAAK,OACb,UAAU,KAAK,KAAK,MAAM,KAC1B,SAAS,KAAK,GAAG,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;AAAA,MAClE,gBAAgB;AAAA,MAChB,QAAQ;AAAA,MACR,IAAI,mCAAS,YAAW,CAAA;AAAA,IAC1B;AAIA,UAAM,eAAe,mCAAS;AACxB,UAAA;AAAA,MACJ,SAAS;AAAA,MACT,cAAc;AAAA,MACd,GAAG;AAAA,IACL,IAAI,WAAW,CAAC;AAIV,UAAA,cAAc,eAChB,aAAa,EAAE,SAAS,GAAG,aAAA,CAAc,IACzC,KAAK;AAET,UAAM,OAAO,MAAM,YAAY,UAAU,KAAK;AAAA,MAC5C,GAAG;AAAA,MACH;AAAA,IAAA,CACD;AAEG,QAAA,CAAC,KAAK,IAAI;AACZ,YAAM,IAAI;AAAA,QACR,6BAA6B,UAAU,GAAG,KAAK,KAAK,UAAU;AAAA,MAChE;AAAA,IAAA;AAKF,UAAM,eAAe,KAAK,QAAQ,IAAI,uBAAuB;AAC7D,QAAI,iBAAiB,MAAM;AAClB,aAAA,SAAS,cAAc,EAAE;AAAA,IAAA;AAI9B,QAAA,KAAK,WAAW,KAAK;AAChB,aAAA;AAAA,IAAA;AAGT,SAAI,UAAK,QAAQ,IAAI,cAAc,MAA/B,mBAAkC,SAAS,qBAAqB;AAC9D,UAAA,OAAO,MAAM,KAAK,KAAK;AAC3B,UAAI,KAAK,OAAO;AACR,cAAA,IAAI,MAAM,KAAK,KAAK;AAAA,MAAA;AAErB,aAAA;AAAA,IAAA;AAED,WAAA,MAAM,KAAK,KAAK;AAAA,EAAA;AAAA,EAG1B,SAGE,MACA,QACuB;AACvB,WAAO,IAAI,SAAS,MAAM,MAAM,MAAM;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOxC,MAAM,oBAAuC;AAC3C,UAAM,WAAY,MAAM,KAAK,aAAa,GAAG;AAG7C,QAAI,SAAS,SAAS,MAAM,QAAQ,SAAS,KAAK,GAAG;AACnD,aAAO,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,IAAI;AAAA,IAAA;AAE/C,WAAO,CAAC;AAAA,EAAA;AAEZ;"}

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

@@ -0,0 +1,23 @@
+import { ExecutionContext, ExecutableBuilder, Result, ODataRecordMetadata } from '../types.js';
+import { TableOccurrence } from './table-occurrence.js';
+import { FFetchOptions } from '@fetchkit/ffetch';
+export declare class InsertBuilder<T extends Record<string, any>, Occ extends TableOccurrence<any, any, any, any> | undefined = undefined> implements ExecutableBuilder<T & ODataRecordMetadata> {
+    private occurrence?;
+    private tableName;
+    private databaseName;
+    private context;
+    private data;
+    constructor(config: {
+        occurrence?: Occ;
+        tableName: string;
+        databaseName: string;
+        context: ExecutionContext;
+        data: Partial<T>;
+    });
+    execute(options?: RequestInit & FFetchOptions): Promise<Result<T & ODataRecordMetadata>>;
+    getRequestConfig(): {
+        method: string;
+        url: string;
+        body?: any;
+    };
+}

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

@@ -0,0 +1,69 @@
+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 { validateSingleResponse } from "../validation.js";
+class InsertBuilder {
+  constructor(config) {
+    __publicField(this, "occurrence");
+    __publicField(this, "tableName");
+    __publicField(this, "databaseName");
+    __publicField(this, "context");
+    __publicField(this, "data");
+    this.occurrence = config.occurrence;
+    this.tableName = config.tableName;
+    this.databaseName = config.databaseName;
+    this.context = config.context;
+    this.data = config.data;
+  }
+  async execute(options) {
+    var _a, _b;
+    try {
+      const url = `/${this.databaseName}/${this.tableName}`;
+      const response = await this.context._makeRequest(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(this.data),
+        ...options
+      });
+      const schema = (_b = (_a = this.occurrence) == null ? void 0 : _a.baseTable) == null ? void 0 : _b.schema;
+      const validation = await validateSingleResponse(
+        response,
+        schema,
+        void 0,
+        // No selected fields for insert
+        void 0,
+        // No expand configs
+        "exact"
+        // Expect exactly one record
+      );
+      if (!validation.valid) {
+        return { data: void 0, error: validation.error };
+      }
+      if (validation.data === null) {
+        return {
+          data: void 0,
+          error: new Error("Insert operation returned null response")
+        };
+      }
+      return { data: validation.data, error: void 0 };
+    } catch (error) {
+      return {
+        data: void 0,
+        error: error instanceof Error ? error : new Error(String(error))
+      };
+    }
+  }
+  getRequestConfig() {
+    return {
+      method: "POST",
+      url: `/${this.databaseName}/${this.tableName}`,
+      body: JSON.stringify(this.data)
+    };
+  }
+}
+export {
+  InsertBuilder
+};
+//# sourceMappingURL=insert-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insert-builder.js","sources":["../../../src/client/insert-builder.ts"],"sourcesContent":["import type {\n  ExecutionContext,\n  ExecutableBuilder,\n  Result,\n  ODataRecordMetadata,\n  InferSchemaType,\n} from \"../types\";\nimport type { TableOccurrence } from \"./table-occurrence\";\nimport { validateSingleResponse } from \"../validation\";\nimport { type FFetchOptions } from \"@fetchkit/ffetch\";\n\nexport class InsertBuilder<\n  T extends Record<string, any>,\n  Occ extends TableOccurrence<any, any, any, any> | undefined = undefined,\n> implements ExecutableBuilder<T & ODataRecordMetadata>\n{\n  private occurrence?: Occ;\n  private tableName: string;\n  private databaseName: string;\n  private context: ExecutionContext;\n  private data: Partial<T>;\n\n  constructor(config: {\n    occurrence?: Occ;\n    tableName: string;\n    databaseName: string;\n    context: ExecutionContext;\n    data: Partial<T>;\n  }) {\n    this.occurrence = config.occurrence;\n    this.tableName = config.tableName;\n    this.databaseName = config.databaseName;\n    this.context = config.context;\n    this.data = config.data;\n  }\n\n  async execute(\n    options?: RequestInit & FFetchOptions,\n  ): Promise<Result<T & ODataRecordMetadata>> {\n    try {\n      const url = `/${this.databaseName}/${this.tableName}`;\n\n      // Make POST request with JSON body\n      const response = await this.context._makeRequest(url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(this.data),\n        ...options,\n      });\n\n      // Get schema from occurrence if available\n      const schema = this.occurrence?.baseTable?.schema;\n\n      // Validate the response (FileMaker returns the created record)\n      const validation = await validateSingleResponse<T>(\n        response,\n        schema,\n        undefined, // No selected fields for insert\n        undefined, // No expand configs\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 (shouldn't happen for insert, but handle it)\n      if (validation.data === null) {\n        return {\n          data: undefined,\n          error: new Error(\"Insert operation returned null response\"),\n        };\n      }\n\n      return { data: validation.data, error: undefined };\n    } catch (error) {\n      return {\n        data: undefined,\n        error: error instanceof Error ? error : new Error(String(error)),\n      };\n    }\n  }\n\n  getRequestConfig(): { method: string; url: string; body?: any } {\n    return {\n      method: \"POST\",\n      url: `/${this.databaseName}/${this.tableName}`,\n      body: JSON.stringify(this.data),\n    };\n  }\n}\n"],"names":[],"mappings":";;;;AAWO,MAAM,cAIb;AAAA,EAOE,YAAY,QAMT;AAZK;AACA;AACA;AACA;AACA;AASN,SAAK,aAAa,OAAO;AACzB,SAAK,YAAY,OAAO;AACxB,SAAK,eAAe,OAAO;AAC3B,SAAK,UAAU,OAAO;AACtB,SAAK,OAAO,OAAO;AAAA,EAAA;AAAA,EAGrB,MAAM,QACJ,SAC0C;;AACtC,QAAA;AACF,YAAM,MAAM,IAAI,KAAK,YAAY,IAAI,KAAK,SAAS;AAGnD,YAAM,WAAW,MAAM,KAAK,QAAQ,aAAa,KAAK;AAAA,QACpD,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,QAClB;AAAA,QACA,MAAM,KAAK,UAAU,KAAK,IAAI;AAAA,QAC9B,GAAG;AAAA,MAAA,CACJ;AAGK,YAAA,UAAS,gBAAK,eAAL,mBAAiB,cAAjB,mBAA4B;AAG3C,YAAM,aAAa,MAAM;AAAA,QACvB;AAAA,QACA;AAAA,QACA;AAAA;AAAA,QACA;AAAA;AAAA,QACA;AAAA;AAAA,MACF;AAEI,UAAA,CAAC,WAAW,OAAO;AACrB,eAAO,EAAE,MAAM,QAAW,OAAO,WAAW,MAAM;AAAA,MAAA;AAIhD,UAAA,WAAW,SAAS,MAAM;AACrB,eAAA;AAAA,UACL,MAAM;AAAA,UACN,OAAO,IAAI,MAAM,yCAAyC;AAAA,QAC5D;AAAA,MAAA;AAGF,aAAO,EAAE,MAAM,WAAW,MAAM,OAAO,OAAU;AAAA,aAC1C,OAAO;AACP,aAAA;AAAA,QACL,MAAM;AAAA,QACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,MACjE;AAAA,IAAA;AAAA,EACF;AAAA,EAGF,mBAAgE;AACvD,WAAA;AAAA,MACL,QAAQ;AAAA,MACR,KAAK,IAAI,KAAK,YAAY,IAAI,KAAK,SAAS;AAAA,MAC5C,MAAM,KAAK,UAAU,KAAK,IAAI;AAAA,IAChC;AAAA,EAAA;AAEJ;"}

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

@@ -0,0 +1,94 @@
+import { QueryOptions } from 'odata-query';
+import { ExecutionContext, WithSystemFields, Result, InferSchemaType, ExecuteOptions, ConditionallyWithODataAnnotations, ExtractSchemaFromOccurrence } from '../types.js';
+import { Filter } from '../filter-types.js';
+import { TableOccurrence } from './table-occurrence.js';
+import { BaseTable } from './base-table.js';
+import { FFetchOptions } from '@fetchkit/ffetch';
+import { z } from 'zod/v4';
+import { StandardSchemaV1 } from '@standard-schema/spec';
+type ExtractNavigationNames<O extends TableOccurrence<any, any, any, any> | undefined> = O extends TableOccurrence<any, any, infer Nav, any> ? Nav extends Record<string, any> ? keyof Nav & string : never : never;
+type ResolveNavigationItem<T> = T extends () => infer R ? R : T;
+type FindNavigationTarget<O extends TableOccurrence<any, any, any, any> | undefined, Name extends string> = O extends TableOccurrence<any, any, infer Nav, any> ? Nav extends Record<string, any> ? Name extends keyof Nav ? ResolveNavigationItem<Nav[Name]> : TableOccurrence<BaseTable<Record<string, z.ZodTypeAny>, any>, any, any, any> : TableOccurrence<BaseTable<Record<string, z.ZodTypeAny>, any>, any, any, any> : TableOccurrence<BaseTable<Record<string, z.ZodTypeAny>, any>, any, any, any>;
+type GetTargetSchemaType<O extends TableOccurrence<any, any, any, any> | undefined, Rel extends string> = [FindNavigationTarget<O, Rel>] extends [
+    TableOccurrence<infer BT, any, any, any>
+] ? [BT] extends [BaseTable<infer S, any>] ? [S] extends [Record<string, StandardSchemaV1>] ? InferSchemaType<S> : Record<string, any> : Record<string, any> : Record<string, any>;
+type ExpandedRelations = Record<string, {
+    schema: any;
+    selected: any;
+}>;
+export declare class QueryBuilder<T extends Record<string, any>, Selected extends keyof T = keyof T, SingleMode extends "exact" | "maybe" | false = false, IsCount extends boolean = false, Occ extends TableOccurrence<any, any, any, any> | undefined = undefined, Expands extends ExpandedRelations = {}> {
+    private queryOptions;
+    private expandConfigs;
+    private singleMode;
+    private isCountMode;
+    private occurrence?;
+    private tableName;
+    private databaseName;
+    private context;
+    private isNavigate?;
+    private navigateRecordId?;
+    private navigateRelation?;
+    private navigateSourceTableName?;
+    private navigateBaseRelation?;
+    constructor(config: {
+        occurrence?: Occ;
+        tableName: string;
+        databaseName: string;
+        context: ExecutionContext;
+    });
+    /**
+     * Helper to conditionally strip OData annotations based on options
+     */
+    private stripODataAnnotationsIfNeeded;
+    select<K extends keyof T>(...fields: K[]): QueryBuilder<T, K, SingleMode, IsCount, Occ, Expands>;
+    /**
+     * Transforms our filter format to odata-query's expected format
+     * - Arrays of operators are converted to AND conditions
+     * - Single operator objects pass through as-is
+     * - Shorthand values are handled by odata-query
+     */
+    private transformFilter;
+    filter(filter: Filter<ExtractSchemaFromOccurrence<Occ>>): QueryBuilder<T, Selected, SingleMode, IsCount, Occ, Expands>;
+    orderBy(orderBy: QueryOptions<T>["orderBy"]): QueryBuilder<T, Selected, SingleMode, IsCount, Occ, Expands>;
+    top(count: number): QueryBuilder<T, Selected, SingleMode, IsCount, Occ, Expands>;
+    skip(count: number): QueryBuilder<T, Selected, SingleMode, IsCount, Occ, Expands>;
+    /**
+     * Formats select fields for use in query strings.
+     * - Wraps "id" fields in double quotes
+     * - URL-encodes special characters but preserves spaces
+     */
+    private formatSelectFields;
+    /**
+     * Builds expand validation configs from internal expand configurations.
+     * These are used to validate expanded navigation properties.
+     */
+    private buildExpandValidationConfigs;
+    /**
+     * Builds OData expand query string from expand configurations.
+     * Handles nested expands recursively.
+     */
+    private buildExpandString;
+    expand<Rel extends ExtractNavigationNames<Occ> | (string & {}), TargetOcc extends FindNavigationTarget<Occ, Rel> = FindNavigationTarget<Occ, Rel>, TargetSchema extends GetTargetSchemaType<Occ, Rel> = GetTargetSchemaType<Occ, Rel>, TargetSelected extends keyof TargetSchema = keyof TargetSchema>(relation: Rel, callback?: (builder: QueryBuilder<TargetSchema, keyof TargetSchema, false, false, TargetOcc extends TableOccurrence<any, any, any, any> ? TargetOcc : undefined>) => QueryBuilder<WithSystemFields<TargetSchema>, TargetSelected, any, any, any>): QueryBuilder<T, Selected, SingleMode, IsCount, Occ, Expands & {
+        [K in Rel]: {
+            schema: TargetSchema;
+            selected: TargetSelected;
+        };
+    }>;
+    single(): QueryBuilder<T, Selected, "exact", IsCount, Occ, Expands>;
+    maybeSingle(): QueryBuilder<T, Selected, "maybe", IsCount, Occ, Expands>;
+    count(): QueryBuilder<T, Selected, SingleMode, true, Occ, Expands>;
+    execute<EO extends ExecuteOptions>(options?: RequestInit & FFetchOptions & EO): Promise<Result<IsCount extends true ? number : SingleMode extends "exact" ? ConditionallyWithODataAnnotations<Pick<T, Selected> & {
+        [K in keyof Expands]: Pick<Expands[K]["schema"], Expands[K]["selected"]>[];
+    }, EO["includeODataAnnotations"] extends true ? true : false> : SingleMode extends "maybe" ? ConditionallyWithODataAnnotations<Pick<T, Selected> & {
+        [K in keyof Expands]: Pick<Expands[K]["schema"], Expands[K]["selected"]>[];
+    }, EO["includeODataAnnotations"] extends true ? true : false> | null : ConditionallyWithODataAnnotations<Pick<T, Selected> & {
+        [K in keyof Expands]: Pick<Expands[K]["schema"], Expands[K]["selected"]>[];
+    }, EO["includeODataAnnotations"] extends true ? true : false>[]>>;
+    getQueryString(): string;
+    getRequestConfig(): {
+        method: string;
+        url: string;
+        body?: any;
+    };
+}
+export {};