fms-odata-js 0.3.0 → 0.4.0

package/dist/schema.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Schema modification (DDL) for FileMaker Server via the OData system tables.
+ *
+ * FMS exposes DDL through two system tables:
+ *
+ *   FileMaker_Tables   — create tables, add fields, delete tables/fields
+ *   FileMaker_Indexes  — create and delete field indexes
+ *
+ * All operations require a FileMaker account with full access (schema
+ * modification) privileges in the target file.
+ *
+ * Destructive operations (`deleteTable`, `deleteField`) require an explicit
+ * `confirm: true` option to prevent accidental data loss, per the spec's
+ * security guidance (docs/10-schema-modification.md).
+ *
+ * @see https://github.com/fsans/fms-odata-spec/blob/main/docs/10-schema-modification.md
+ */
+import { type CreateTableParams, type AddFieldsParams } from '@fms-odata/spec-ts';
+import type { FMSOData } from './client.js';
+import type { RequestOptions } from './types.js';
+/** Options accepted by schema operations. */
+export interface SchemaOptions extends RequestOptions {
+}
+/** Options for destructive schema operations (deleteTable, deleteField). */
+export interface DeleteSchemaOptions extends SchemaOptions {
+    /**
+     * Must be `true` to proceed. Destructive DDL operations permanently destroy
+     * data with no undo. This guard prevents accidental invocation.
+     */
+    confirm: true;
+}
+/**
+ * Schema editor for FileMaker DDL operations.
+ *
+ * Obtain an instance via `db.schema()` or use the convenience methods on
+ * `FMSOData` (`db.createTable`, `db.addFields`, etc.).
+ */
+export declare class SchemaEditor {
+    /** @internal */ readonly _client: FMSOData;
+    constructor(client: FMSOData);
+    /**
+     * Create a new table with the given field definitions.
+     *
+     * ```ts
+     * await db.schema().createTable({
+     *   tableName: 'Company',
+     *   fields: [
+     *     { name: 'Company ID', type: 'int', primary: true },
+     *     { name: 'Company Name', type: 'varchar(100)', nullable: false },
+     *   ],
+     * })
+     * ```
+     */
+    createTable(params: CreateTableParams, opts?: SchemaOptions): Promise<unknown>;
+    /**
+     * Add fields to an existing table.
+     *
+     * ```ts
+     * await db.schema().addFields({
+     *   tableName: 'Company',
+     *   fields: [{ name: 'Phone', type: 'varchar(30)' }],
+     * })
+     * ```
+     */
+    addFields(params: AddFieldsParams, opts?: SchemaOptions): Promise<unknown>;
+    /**
+     * Delete a table and ALL its records. Irreversible.
+     *
+     * Requires `opts.confirm === true` as a safety guard.
+     *
+     * ```ts
+     * await db.schema().deleteTable('OldTable', { confirm: true })
+     * ```
+     */
+    deleteTable(tableName: string, opts: DeleteSchemaOptions): Promise<void>;
+    /**
+     * Delete a field from a table. Irreversible.
+     *
+     * Requires `opts.confirm === true` as a safety guard.
+     *
+     * ```ts
+     * await db.schema().deleteField('Company', 'OldField', { confirm: true })
+     * ```
+     */
+    deleteField(tableName: string, fieldName: string, opts: DeleteSchemaOptions): Promise<void>;
+    /**
+     * Create an index on a field.
+     *
+     * ```ts
+     * await db.schema().createIndex('Company', 'Company Name')
+     * ```
+     */
+    createIndex(tableName: string, fieldName: string, opts?: SchemaOptions): Promise<unknown>;
+    /**
+     * Delete an index from a field.
+     *
+     * ```ts
+     * await db.schema().deleteIndex('Company', 'Company Name')
+     * ```
+     */
+    deleteIndex(tableName: string, fieldName: string, opts?: SchemaOptions): Promise<void>;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAErB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD,6CAA6C;AAC7C,MAAM,WAAW,aAAc,SAAQ,cAAc;CAAG;AAExD,4EAA4E;AAC5E,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD;;;OAGG;IACH,OAAO,EAAE,IAAI,CAAA;CACd;AAkBD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;gBAE/B,MAAM,EAAE,QAAQ;IAI5B;;;;;;;;;;;;OAYG;IACG,WAAW,CACf,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,OAAO,CAAC;IAenB;;;;;;;;;OASG;IACG,SAAS,CACb,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,OAAO,CAAC;IAenB;;;;;;;;OAQG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;OAQG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;;OAMG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,OAAO,CAAC;IAcnB;;;;;;OAMG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,IAAI,CAAC;CAWjB"}

package/dist/webhooks.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Webhook management for FileMaker Server OData.
+ *
+ * FMS exposes webhook management through five endpoints following the
+ * standard OData function-call shape: read endpoints use GET, and action
+ * endpoints use POST with the `<id>` passed as a function argument in the
+ * URL path.
+ *
+ *   GET  /<db>/Webhook.GetAll        — list all webhooks
+ *   GET  /<db>/Webhook.Get(<id>)     — get one webhook by id
+ *   POST /<db>/Webhook.Add           — create a webhook (config in JSON body)
+ *   POST /<db>/Webhook.Delete(<id>)  — delete a webhook (id in URL path)
+ *   POST /<db>/Webhook.Invoke(<id>)  — manually trigger a webhook (id in URL path)
+ *
+ * Webhooks require FileMaker Server 2025+ (v22). Use
+ * `db.hasFeature('webhooks')` to check before calling.
+ *
+ * @see https://github.com/fsans/fms-odata-spec/blob/main/docs/09-webhooks.md
+ */
+import type { WebhookCreateParams, WebhookData } from '@fms-odata/spec-ts';
+import type { FMSOData } from './client.js';
+import type { RequestOptions } from './types.js';
+/** Options accepted by webhook operations. */
+export interface WebhookOptions extends RequestOptions {
+}
+/**
+ * Webhook manager for FileMaker Server webhook CRUD.
+ *
+ * Obtain an instance via `db.webhooks()` or use the convenience methods on
+ * `FMSOData` (`db.createWebhook`, `db.removeWebhook`, etc.).
+ *
+ * Requires FileMaker Server 2025+ (v22).
+ */
+export declare class WebhookManager {
+    /** @internal */ readonly _client: FMSOData;
+    constructor(client: FMSOData);
+    /** Build the URL for a webhook operation. */
+    private _url;
+    /**
+     * Create a webhook.
+     *
+     * ```ts
+     * const { id } = await db.webhooks().create({
+     *   webhook: 'https://my.example.com:8080/webhook',
+     *   tableName: 'contact',
+     *   select: 'id,first_name',
+     *   filter: "status eq 'active'",
+     *   notifySchemaChanges: true,
+     * })
+     * ```
+     *
+     * @returns An object with the server-generated `id` of the new webhook.
+     */
+    create(params: WebhookCreateParams, opts?: WebhookOptions): Promise<{
+        id: string;
+    }>;
+    /**
+     * Delete a webhook by its ID.
+     *
+     * ```ts
+     * await db.webhooks().remove('1')
+     * ```
+     */
+    remove(id: string | number, opts?: WebhookOptions): Promise<unknown>;
+    /** Alias for {@link remove} (matches the FMS endpoint name `Webhook.Delete`). */
+    delete(id: string | number, opts?: WebhookOptions): Promise<unknown>;
+    /**
+     * Get a specific webhook's data by ID.
+     *
+     * ```ts
+     * const data = await db.webhooks().get('1')
+     * ```
+     */
+    get(id: string | number, opts?: WebhookOptions): Promise<WebhookData | unknown>;
+    /**
+     * List all webhooks.
+     *
+     * ```ts
+     * const result = await db.webhooks().getAll()
+     * ```
+     */
+    getAll(opts?: WebhookOptions): Promise<unknown>;
+    /**
+     * Manually invoke (trigger) a webhook by ID. Useful for testing.
+     *
+     * Optionally pass `rowIDs` to target specific records; if omitted, FMS
+     * triggers the webhook for all pending records.
+     *
+     * ```ts
+     * await db.webhooks().invoke('1')
+     * await db.webhooks().invoke('1', { rowIDs: [10, 20] })
+     * ```
+     */
+    invoke(id: string | number, opts?: WebhookOptions & {
+        rowIDs?: ReadonlyArray<string | number>;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD,8CAA8C;AAC9C,MAAM,WAAW,cAAe,SAAQ,cAAc;CAAG;AAmCzD;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;gBAE/B,MAAM,EAAE,QAAQ;IAI5B,6CAA6C;IAC7C,OAAO,CAAC,IAAI;IAKZ;;;;;;;;;;;;;;OAcG;IACG,MAAM,CACV,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB1B;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9E,iFAAiF;IAC3E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E;;;;;;OAMG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC;IASzF;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQzD;;;;;;;;;;OAUG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,GAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;KAAO,GACtE,OAAO,CAAC,OAAO,CAAC;CAgBpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fms-odata-js",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Zero-runtime-dependency TypeScript client for FileMaker Server OData v4 (Web Viewer, browser, Node).",
   "type": "module",
   "main": "./dist/fms-odata.esm.js",
@@ -50,7 +50,7 @@
     "node": ">=18"
   },
   "devDependencies": {
-    "@fms-odata/spec-ts": "^1.1.0",
+    "@fms-odata/spec-ts": "^2.0.1",
     "@playwright/test": "^1.47.0",
     "@types/node": "^20.14.0",
     "@vitest/coverage-v8": "^2.0.0",

package/src/client.ts

@@ -2,8 +2,10 @@ import { Batch } from './batch.js'
 import { executeJson, executeRequest, type HttpClientContext, type HttpRequestOptions } from './http.js'
 import { MetadataFetcher, type MetadataOptions, type ODataMetadata } from './metadata.js'
 import { Query } from './query.js'
+import { SchemaEditor, type DeleteSchemaOptions, type SchemaOptions } from './schema.js'
 import { runScriptAtDatabase, runScriptByIdAtDatabase, type ScriptOptions, type ScriptResult } from './scripts.js'
 import type { FMSODataOptions, RequestOptions } from './types.js'
+import { WebhookManager, type WebhookOptions } from './webhooks.js'
 import {
   type FMVersionMajor,
   type FMVersionInfo,
@@ -145,7 +147,7 @@ export class FMSOData {
    * `@fms-odata/spec-ts` `parseServerVersion`). The result is cached for the
    * lifetime of this `FMSOData` instance.
    *
-   * Returns the major version string (`'19'`, `'21'`, `'22'`, `'26'`) or
+   * Returns the major version string (`'20'`, `'21'`, `'22'`, `'26'`) or
    * `'future'` if the version is newer than the spec knows about. Returns
    * `null` if the version cannot be determined (e.g. the metadata lacks the
    * annotation).
@@ -234,6 +236,121 @@ export class FMSOData {
     return specHasFeature(v, feature)
   }
 
+  // -------------------------------------------------------------------------
+  // Schema modification (DDL)
+  // -------------------------------------------------------------------------
+
+  /** @internal */ private _schemaEditor?: SchemaEditor
+
+  /**
+   * Get a `SchemaEditor` handle for DDL operations (create/delete tables,
+   * add/delete fields, create/delete indexes). Requires a FileMaker account
+   * with full access privileges.
+   *
+   * ```ts
+   * await db.schema().createTable({ tableName: 'Company', fields: [...] })
+   * ```
+   */
+  schema(): SchemaEditor {
+    if (!this._schemaEditor) this._schemaEditor = new SchemaEditor(this)
+    return this._schemaEditor
+  }
+
+  /** Convenience: create a table. See {@link SchemaEditor#createTable}. */
+  async createTable(
+    params: import('@fms-odata/spec-ts').CreateTableParams,
+    opts: SchemaOptions = {},
+  ): Promise<unknown> {
+    return this.schema().createTable(params, opts)
+  }
+
+  /** Convenience: add fields to a table. See {@link SchemaEditor#addFields}. */
+  async addFields(
+    params: import('@fms-odata/spec-ts').AddFieldsParams,
+    opts: SchemaOptions = {},
+  ): Promise<unknown> {
+    return this.schema().addFields(params, opts)
+  }
+
+  /** Convenience: delete a table (requires `confirm: true`). See {@link SchemaEditor#deleteTable}. */
+  async deleteTable(tableName: string, opts: DeleteSchemaOptions): Promise<void> {
+    return this.schema().deleteTable(tableName, opts)
+  }
+
+  /** Convenience: delete a field (requires `confirm: true`). See {@link SchemaEditor#deleteField}. */
+  async deleteField(
+    tableName: string,
+    fieldName: string,
+    opts: DeleteSchemaOptions,
+  ): Promise<void> {
+    return this.schema().deleteField(tableName, fieldName, opts)
+  }
+
+  /** Convenience: create an index. See {@link SchemaEditor#createIndex}. */
+  async createIndex(
+    tableName: string,
+    fieldName: string,
+    opts: SchemaOptions = {},
+  ): Promise<unknown> {
+    return this.schema().createIndex(tableName, fieldName, opts)
+  }
+
+  /** Convenience: delete an index. See {@link SchemaEditor#deleteIndex}. */
+  async deleteIndex(
+    tableName: string,
+    fieldName: string,
+    opts: SchemaOptions = {},
+  ): Promise<void> {
+    return this.schema().deleteIndex(tableName, fieldName, opts)
+  }
+
+  // -------------------------------------------------------------------------
+  // Webhook management (requires FileMaker Server 2025+ / v22)
+  // -------------------------------------------------------------------------
+
+  /** @internal */ private _webhookManager?: WebhookManager
+
+  /**
+   * Get a `WebhookManager` handle for webhook CRUD operations (create, remove,
+   * get, getAll, invoke). Requires FileMaker Server 2025+ (v22).
+   *
+   * ```ts
+   * await db.webhooks().create({ webhook: 'https://...', tableName: 'contact' })
+   * ```
+   */
+  webhooks(): WebhookManager {
+    if (!this._webhookManager) this._webhookManager = new WebhookManager(this)
+    return this._webhookManager
+  }
+
+  /** Convenience: create a webhook. See {@link WebhookManager#create}. */
+  async createWebhook(
+    params: import('@fms-odata/spec-ts').WebhookCreateParams,
+    opts: WebhookOptions = {},
+  ): Promise<unknown> {
+    return this.webhooks().create(params, opts)
+  }
+
+  /** Convenience: delete a webhook by ID. See {@link WebhookManager#remove}. */
+  async removeWebhook(id: string | number, opts: WebhookOptions = {}): Promise<unknown> {
+    return this.webhooks().remove(id, opts)
+  }
+
+  /** Convenience: get a webhook by ID. See {@link WebhookManager#get}. */
+  async getWebhook(id: string | number, opts: WebhookOptions = {}): Promise<unknown> {
+    return this.webhooks().get(id, opts)
+  }
+
+  /** Convenience: list all webhooks. See {@link WebhookManager#getAll}. */
+  async getAllWebhooks(opts: WebhookOptions = {}): Promise<unknown> {
+    return this.webhooks().getAll(opts)
+  }
+
+  /** Convenience: manually invoke a webhook by ID. See {@link WebhookManager#invoke}. */
+  async invokeWebhook(id: string | number, opts: WebhookOptions = {}): Promise<unknown> {
+    return this.webhooks().invoke(id, opts)
+  }
+
   /**
    * Create a new `$batch` builder for composing multiple OData operations
    * into a single HTTP round-trip.

package/src/http.ts

@@ -8,7 +8,7 @@
  * timeout composition, browser/Web Viewer compatibility).
  *
  * Responsibilities:
- * - Authorization header resolution (Basic, Bearer, or FMID, auto-detected).
+ * - Authorization header resolution (Basic or Bearer/OAuth, auto-detected).
  * - Timeout + AbortSignal composition.
  * - 401 retry via `onUnauthorized` (once).
  * - Error envelope normalization into `FMSODataError`.
@@ -19,8 +19,8 @@
 import { parseErrorResponse, FMSODataError } from './errors.js'
 import type { TokenProvider, RequestOptions } from './types.js'
 
-/** A scheme-prefixed Authorization value (e.g. `Basic …`, `Bearer …`, or `FMID …`). */
-const AUTH_SCHEME_RE = /^(basic|bearer|fmid|negotiate|digest)\s+\S/i
+/** A scheme-prefixed Authorization value (e.g. `Basic …` or `Bearer …`). */
+const AUTH_SCHEME_RE = /^(basic|bearer|negotiate|digest)\s+\S/i
 
 /** Resolve a `TokenProvider` to a complete Authorization header value. */
 export async function resolveAuthHeader(provider: TokenProvider): Promise<string> {
@@ -45,9 +45,9 @@ export function basicAuth(user: string, password: string): string {
   return `Basic ${b64}`
 }
 
-/** Build an FMID auth header value for FileMaker Cloud (Claris ID token). */
-export function fmidAuth(token: string): string {
-  return `FMID ${token}`
+/** Build a Bearer auth header value for an OAuth session token (FileMaker Cloud / external IdP). */
+export function bearerAuth(token: string): string {
+  return `Bearer ${token}`
 }
 
 /** Auth scheme type (aligned with spec). */

package/src/index.ts

@@ -23,7 +23,7 @@ export { EntityRef } from './entity.js'
 export type { EntityWriteOptions, EntityRefInfo } from './entity.js'
 export { FMSODataError, FMScriptError, isFMSODataError, isFMScriptError } from './errors.js'
 export type { ODataErrorBody } from './errors.js'
-export { basicAuth, fmidAuth } from './http.js'
+export { basicAuth, bearerAuth } from './http.js'
 export type { FMAuthScheme, FMAuthToken, FMAuthTokenProvider } from './http.js'
 export { MetadataFetcher } from './metadata.js'
 export type {
@@ -39,6 +39,10 @@ export type { FilterFactory, FilterInput, OrderDir, QueryResult } from './query.
 export type { AggregateFunction } from '@fms-odata/spec-ts'
 export { ScriptInvoker } from './scripts.js'
 export type { ScriptOptions, ScriptResult, ScriptScope, ScriptIdentifier } from './scripts.js'
+export { SchemaEditor } from './schema.js'
+export type { SchemaOptions, DeleteSchemaOptions } from './schema.js'
+export { WebhookManager } from './webhooks.js'
+export type { WebhookOptions } from './webhooks.js'
 export type { FMSODataOptions, TokenProvider, RequestOptions } from './types.js'
 export type { ODataLiteral } from './url.js'
 
@@ -65,6 +69,19 @@ export type {
   FMServerVersion,
 } from '@fms-odata/spec-ts'
 
+// Schema (DDL) types from @fms-odata/spec-ts
+export { FIELD_TYPES, FIELD_DEFAULTS, parseFieldType } from '@fms-odata/spec-ts'
+export type {
+  FMFieldType,
+  FMFieldDefault,
+  FMFieldDefinition,
+  CreateTableParams,
+  AddFieldsParams,
+} from '@fms-odata/spec-ts'
+
+// Webhook types from @fms-odata/spec-ts
+export type { WebhookCreateParams, WebhookData, WebhookOperation } from '@fms-odata/spec-ts'
+
 // ---------------------------------------------------------------------------
 // Deprecated aliases (kept for backward compatibility with fm-odata-js).
 // These re-export the renamed symbols under their old names and will be

package/src/query.ts

@@ -212,14 +212,14 @@ export class Query<T = Record<string, unknown>> {
   }
 
   // -------------------------------------------------------------------------
-  // $apply (aggregation) — requires FMS 22.0.1+ (FileMaker 2024)
+  // $apply (aggregation) — requires FMS 22.0.1+ (FileMaker 2025)
   // -------------------------------------------------------------------------
 
   /**
    * Set a raw `$apply` expression. Use this for advanced transformations
    * that the `aggregate()` / `groupBy()` helpers don't cover.
    *
-   * Requires FileMaker Server 2024+ (v22). Use `db.hasFeature('applyAggregation')`
+   * Requires FileMaker Server 2025+ (v22). Use `db.hasFeature('applyAggregation')`
    * to check before calling.
    *
    * @example
@@ -236,7 +236,7 @@ export class Query<T = Record<string, unknown>> {
   /**
    * Aggregate the entity set. Produces a `$apply=aggregate(...)` expression.
    *
-   * Requires FileMaker Server 2024+ (v22).
+   * Requires FileMaker Server 2025+ (v22).
    *
    * @example
    * ```ts
@@ -256,7 +256,7 @@ export class Query<T = Record<string, unknown>> {
    * Group the entity set by one or more fields, optionally with aggregation.
    * Produces a `$apply=groupby((fields), aggregate(...))` expression.
    *
-   * Requires FileMaker Server 2024+ (v22).
+   * Requires FileMaker Server 2025+ (v22).
    *
    * @example
    * ```ts