@jd-data-limited/easy-fm 4.1.15 → 5.0.0-beta.1

package/dist/records/field.js

@@ -1,145 +1,75 @@
 /*
  * Copyright (c) 2023-2024. See LICENSE file for more information
  */
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
-    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
-    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
-};
 import { RecordTypes } from '../types.js';
-import { ApiFieldDisplayTypes, ApiFieldResultTypes, ApiFieldTypes } from '../models/apiResults.js';
+import { ApiFieldDisplayTypes, ApiFieldResultTypes, ApiFieldTypes, ApiResults } from '../models/apiResults.js';
 import { FMError } from '../FMError.js';
+import { Readable } from 'node:stream';
+import { HttpError } from '../connection/Session.js';
 /**
  * A class representing a field in a record.
  *
  * @template T - The type of the field value.
  */
-let Field = (() => {
-    let _instanceExtraInitializers = [];
-    let _private_streamAsync_decorators;
-    let _private_streamAsync_descriptor;
-    let _arrayBuffer_decorators;
-    return class Field {
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
-            _private_streamAsync_decorators = [containerDownloadFunction];
-            _arrayBuffer_decorators = [containerDownloadFunction];
-            __esDecorate(this, _private_streamAsync_descriptor = { value: __setFunctionName(async function () {
-                    const req = await this.parent.layout.database._apiRequestRaw(this.string, { useCookieJar: true });
-                    if (!req.ok || !req.body) {
-                        throw new Error(`HTTP Error: ${req.status} (${req.statusText})`);
-                    }
-                    return { data: req.body, mime: req.headers.get('Content-Type') ?? '' };
-                }, "#streamAsync") }, _private_streamAsync_decorators, { kind: "method", name: "#streamAsync", static: false, private: true, access: { has: obj => #streamAsync in obj, get: obj => obj.#streamAsync }, metadata: _metadata }, null, _instanceExtraInitializers);
-            __esDecorate(this, null, _arrayBuffer_decorators, { kind: "method", name: "arrayBuffer", static: false, private: false, access: { has: obj => "arrayBuffer" in obj, get: obj => obj.arrayBuffer }, metadata: _metadata }, null, _instanceExtraInitializers);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        parent = __runInitializers(this, _instanceExtraInitializers);
-        id;
-        _value;
-        #originalContents;
-        static firstContainerDownload = null;
-        constructor(record, id, originalContents) {
-            this.parent = record;
-            this.id = id;
-            this._value = originalContents;
-            this.#originalContents = originalContents;
-        }
-        get edited() {
-            return this.#originalContents !== this._value;
-        }
-        /**
-         * Resets the 'edited' state of this field, without changing its value
-         */
-        updateOriginalContents() {
-            this.#originalContents = this._value;
-        }
-        /**
-         * Sets the value of the field.
-         *
-         * @param {T | null} content - The new content value to be set. Can be either the type T or null.
-         * @throws {Error} Cannot set container value using set(). Use upload() instead, if the result is a 'container'.
-         */
-        set(content) {
-            if (this.metadata.result === 'container')
-                throw new Error('Cannot set container value using set(). Use upload() instead.');
-            else
-                this._value = content;
-        }
-        get metadata() {
-            if (!this.parent.layout.metadata) {
-                // Default to a regular text field
-                return {
-                    name: this.id.toString(),
-                    type: ApiFieldTypes.NORMAL,
-                    displayType: ApiFieldDisplayTypes.EDIT_TEXT,
-                    result: ApiFieldResultTypes.TEXT,
-                    global: false,
-                    autoEnter: true,
-                    fourDigitYear: false,
-                    maxRepeat: 1,
-                    maxCharacters: 0,
-                    notEmpty: false,
-                    numeric: false,
-                    timeOfDay: false,
-                    repetitions: 1,
-                    valueList: ''
-                };
-            }
-            if (this.parent.type === RecordTypes.PORTAL && this.parent.portal) {
-                return this.parent.layout.metadata.portalMetaData[this.parent.portal.name || 'portal not attached'].find(i => i.name === this.id) ??
-                    {
-                        name: this.id.toString(),
-                        type: ApiFieldTypes.NORMAL,
-                        displayType: ApiFieldDisplayTypes.EDIT_TEXT,
-                        result: ApiFieldResultTypes.TEXT,
-                        global: false,
-                        autoEnter: true,
-                        fourDigitYear: false,
-                        maxRepeat: 1,
-                        maxCharacters: 0,
-                        notEmpty: false,
-                        numeric: false,
-                        timeOfDay: false,
-                        repetitions: 1,
-                        valueList: ''
-                    };
-            }
-            else {
-                return this.parent.layout.metadata.fieldMetaData.find(i => i.name === this.id) ?? {
+export class Field {
+    parent;
+    id;
+    _value;
+    #originalContents;
+    static firstContainerDownload = null;
+    constructor(record, id, originalContents) {
+        this.parent = record;
+        this.id = id;
+        this._value = originalContents;
+        this.#originalContents = originalContents;
+    }
+    /** `true` if this field has changed since it was last loaded or saved. */
+    get edited() {
+        return this.#originalContents !== this._value;
+    }
+    /**
+     * Resets the 'edited' state of this field, without changing its value
+     */
+    updateOriginalContents() {
+        this.#originalContents = this._value;
+    }
+    /**
+     * Sets the value of the field.
+     *
+     * @param {T | null} content - The new content value to be set. Can be either the type T or null.
+     * @throws {Error} Cannot set container value using set(). Use upload() instead, if the result is a 'container'.
+     */
+    set(content) {
+        if (this.metadata.result === 'container')
+            throw new Error('Cannot set container value using set(). Use upload() instead.');
+        else
+            this._value = content;
+    }
+    /** Returns the FileMaker metadata for this field. */
+    get metadata() {
+        if (!this.parent.layout.metadata) {
+            // Default to a regular text field
+            return {
+                name: this.id.toString(),
+                type: ApiFieldTypes.NORMAL,
+                displayType: ApiFieldDisplayTypes.EDIT_TEXT,
+                result: ApiFieldResultTypes.TEXT,
+                global: false,
+                autoEnter: true,
+                fourDigitYear: false,
+                maxRepeat: 1,
+                maxCharacters: 0,
+                notEmpty: false,
+                numeric: false,
+                timeOfDay: false,
+                repetitionStart: 1,
+                repetitionEnd: 1,
+                valueList: ''
+            };
+        }
+        if (this.parent.type === RecordTypes.PORTAL && this.parent.portal) {
+            return this.parent.layout.metadata.portalMetaData[this.parent.portal.name || 'portal not attached'].find(i => i.name === this.id) ??
+                {
                     name: this.id.toString(),
                     type: ApiFieldTypes.NORMAL,
                     displayType: ApiFieldDisplayTypes.EDIT_TEXT,
@@ -152,117 +82,111 @@ let Field = (() => {
                     notEmpty: false,
                     numeric: false,
                     timeOfDay: false,
-                    repetitions: 1,
+                    repetitionStart: 1,
+                    repetitionEnd: 1,
                     valueList: ''
                 };
-            }
-        }
-        get value() {
-            // if (this.metadata.result === "container") throw "Use await field.stream() to get the contents of a container field, instead of field.value"
-            return this._value;
-        }
-        set value(value) {
-            this.set(value);
-        }
-        get string() {
-            if (typeof this._value === 'string') {
-                return this._value;
-            }
-            throw new Error('Field value is not a string');
-        }
-        /**
-         * Uploads a file to the container field.
-         *
-         * @param {Buffer} file - The file content as a buffer.
-         *
-         * @throws {Error} - Cannot upload a file to the field if it's not a container field.
-         * @throws {Error} - Upload failed with HTTP error.
-         *
-         * @returns {Promise<void>} - A promise that resolves when the file is successfully uploaded.
-         */
-        async upload(file) {
-            if (this.metadata.result !== 'container') {
-                throw new Error('Cannot upload a file to the field; ' + this.id + ' (not a container field)');
-            }
-            const form = new FormData();
-            form.append('upload', file);
-            const res = await this.parent.layout.database._apiRequestRaw(`${this.parent.endpoint}/containers/${this.id}/1`, {
-                method: 'POST',
-                headers: {
-                // Authorization: 'Bearer ' + this.parent.layout.database.token,
-                // 'Content-Type': 'multipart/form-data'
-                },
-                body: form
-            });
-            if (!res.ok) {
-                throw new Error(`Upload failed with HTTP error: ${res.status} (${res.statusText})`);
-            }
-            const data = await res.json();
-            if (data.messages[0].code === '0')
-                return;
-            else {
-                throw new FMError(data.messages[0].code, res.status, res);
-            }
         }
-        get #streamAsync() { return _private_streamAsync_descriptor.value; }
-        async stream() {
-            return await this.#streamAsync();
+        else {
+            return this.parent.layout.metadata.fieldMetaData.find(i => i.name === this.id) ?? {
+                name: this.id.toString(),
+                type: ApiFieldTypes.NORMAL,
+                displayType: ApiFieldDisplayTypes.EDIT_TEXT,
+                result: ApiFieldResultTypes.TEXT,
+                global: false,
+                autoEnter: true,
+                fourDigitYear: false,
+                maxRepeat: 1,
+                maxCharacters: 0,
+                notEmpty: false,
+                numeric: false,
+                timeOfDay: false,
+                repetitionStart: 1,
+                repetitionEnd: 1,
+                valueList: ''
+            };
         }
-        async arrayBuffer() {
-            const req = await this.parent.layout.database._apiRequestRaw(this.string, { useCookieJar: true });
-            if (!req.ok)
-                throw new Error(`HTTP Error: ${req.status} (${req.statusText})`);
-            return { data: await req.arrayBuffer(), mime: req.headers.get('Content-Type') ?? '' };
-        }
-    };
-})();
-export { Field };
-function containerDownloadFunction(originalMethod, context) {
-    async function replacementMethod(...args) {
-        return await ContainerDownloadExecutor.processTask(async () => await originalMethod.call(this, ...args));
     }
-    return replacementMethod;
-}
-class ContainerDownloadExecutorClass {
-    hasDownloadedFirstContainer = 0;
-    waitingFuncs = [];
-    async processTask(task) {
-        const isFirstTask = this.hasDownloadedFirstContainer === 0;
-        if (isFirstTask) {
-            this.hasDownloadedFirstContainer = 1;
-            let res;
-            try {
-                res = await task();
-            }
-            catch (e) {
-                this.hasDownloadedFirstContainer = 0;
-                const nextTask = this.waitingFuncs.splice(0, 1)[0];
-                if (nextTask) {
-                    this.processTask(nextTask.func)
-                        .then(res => nextTask.done(res))
-                        .catch(e => nextTask.err(e));
-                }
-                throw e;
-            }
-            this.hasDownloadedFirstContainer = 2;
-            for (const task of this.waitingFuncs) {
-                task.func()
-                    .then((res) => task.done(res))
-                    .catch((e) => task.err(e));
-            }
-            return res;
+    /** Gets or sets the current field value. */
+    get value() {
+        // if (this.metadata.result === "container") throw "Use await field.stream() to get the contents of a container field, instead of field.value"
+        return this._value;
+    }
+    set value(value) {
+        this.set(value);
+    }
+    /** Returns this field value as a string. Throws if the value is not a string. */
+    get string() {
+        if (typeof this._value === 'string') {
+            return this._value;
         }
-        else if (this.hasDownloadedFirstContainer === 1) {
-            return await new Promise((resolve, reject) => {
-                this.waitingFuncs.push({
-                    func: task,
-                    done: resolve,
-                    err: reject
-                });
-            });
+        throw new Error('Field value is not a string');
+    }
+    /**
+     * Uploads a file to the container field.
+     *
+     * @param {Buffer} file - The file content as a buffer.
+     *
+     * @throws {Error} - Cannot upload a file to the field if it's not a container field.
+     * @throws {Error} - Upload failed with HTTP error.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the file is successfully uploaded.
+     */
+    async upload(file) {
+        if (this.metadata.result !== 'container') {
+            throw new Error('Cannot upload a file to the field; ' + this.id + ' (not a container field)');
+        }
+        const form = new FormData();
+        form.append('upload', file);
+        const res = await this.parent.layout.database.fetch(`${this.parent.endpoint}/containers/${this.id}/1`, {
+            method: 'POST',
+            body: form
+        });
+        if (!res.ok) {
+            throw await HttpError.new(res);
+        }
+        const data = ApiResults.parse(await res.json());
+        if (data.messages[0].code === 0)
+            return;
+        else {
+            throw new FMError(data.messages[0].code, res.status, res);
         }
-        else
-            return await task();
+    }
+    async #streamAsync(options = {}) {
+        const req = await this.parent.layout.database.fetch(this.string, {
+            signal: options.abortSignal ?? null,
+        });
+        // const req = await this.parent.layout.database._apiRequestRaw(this.string, {useCookieJar: true})
+        if (!req.ok || !req.body) {
+            throw new Error(`HTTP Error: ${req.status} (${req.statusText})`);
+        }
+        return req;
+    }
+    /**
+     * @deprecated use webStream instead.
+     */
+    async stream() {
+        const stream = await this.#streamAsync();
+        if (!stream.body) {
+            throw await HttpError.new(stream);
+        }
+        return {
+            // @ts-expect-error stream types are correct
+            data: Readable.fromWeb(stream.body),
+            mime: stream.headers.get('Content-Type') ?? ''
+        };
+    }
+    /**
+     * Returns the container download as a Web `Response`.
+     */
+    async webStream(options) {
+        return await this.#streamAsync(options);
+    }
+    /** Downloads the full container contents into memory. */
+    async arrayBuffer() {
+        const stream = await this.#streamAsync();
+        if (!stream.ok)
+            throw await HttpError.new(stream);
+        return { data: await stream.arrayBuffer(), mime: stream.headers.get('Content-Type') ?? '' };
     }
 }
-const ContainerDownloadExecutor = new ContainerDownloadExecutorClass();

package/dist/records/getOperations/recordGetOperation.d.ts

@@ -4,7 +4,9 @@ import { type LayoutBase } from '../../layouts/layoutBase.js';
 import { LayoutRecord } from '../layoutRecord.js';
 import { type Query } from '../../utils/query.js';
 export type SortOrder = 'ascend' | 'descend';
+/** Raw FileMaker find request strings, already escaped/formatted. */
 export type FindRequestRaw = Record<string, string>;
+/** Safe find request built from `query` tagged template helpers. */
 export type FindRequest = Record<string, Query>;
 export interface PortalRequest {
     name: string;
@@ -24,6 +26,7 @@ export interface GetOperationOptions<T extends LayoutInterface> {
     limit?: number;
     offset?: number;
 }
+/** Builder/executor for list and find operations against one layout. */
 export declare class RecordGetOperation<T extends LayoutInterface, OPTIONS extends GetOperationOptions<T>> {
     protected layout: LayoutBase;
     protected limit: number;
@@ -51,7 +54,7 @@ export declare class RecordGetOperation<T extends LayoutInterface, OPTIONS exten
      */
     scripts(scripts: ScriptRequestData): this;
     /**
-     * Sorts the data based on the given field name and sort order.
+     * Add sort clause in request order.
      *
      * @param {string} fieldName - The name of the field by which the data should be sorted.
      * @param {SortOrder} sortOrder - The sort order to be applied (either "asc" for ascending or "desc" for descending).
@@ -61,7 +64,7 @@ export declare class RecordGetOperation<T extends LayoutInterface, OPTIONS exten
     sort(fieldName: string, sortOrder: SortOrder): this;
     private parseFindRequest;
     /**
-     * Adds a new request/query to the list of queries.
+     * Add one FileMaker find request block.
      *
      * @param {FindRequest} query - The find request to be added.
      * @param {boolean} [omit=false] - Flag to indicate if the find request should be omitted.
@@ -69,14 +72,14 @@ export declare class RecordGetOperation<T extends LayoutInterface, OPTIONS exten
      */
     addRequest(query: FindRequest, omit?: boolean): this;
     /**
-     * Perform a fetch operation.
+     * Execute request and return current page of records.
      *
      * @returns {Promise} A promise that resolves with the result of the fetch operation.
      */
     fetch(): Promise<LayoutRecord<PickPortals<T, keyof OPTIONS["portals"]>>[]>;
     private performFind;
     /**
-     * Creates an iterator that iterates throguh all results
+     * Create async iterator that pages through results lazily.
      * @param pageSize min: 1, max: 999
      */
     iterate(pageSize?: number): {

package/dist/records/getOperations/recordGetOperation.js

@@ -2,8 +2,10 @@
  * Copyright (c) 2023-2024. See LICENSE file for more information
  */
 import { LayoutRecord } from '../layoutRecord.js';
+import { ApiRecordResponseObj } from '../../models/apiResults.js';
 import { FMError } from '../../FMError.js';
 import { FindRequestSymbol } from '../../utils/query.js';
+/** Builder/executor for list and find operations against one layout. */
 export class RecordGetOperation {
     layout;
     limit = 100;
@@ -111,7 +113,7 @@ export class RecordGetOperation {
         return this;
     }
     /**
-     * Sorts the data based on the given field name and sort order.
+     * Add sort clause in request order.
      *
      * @param {string} fieldName - The name of the field by which the data should be sorted.
      * @param {SortOrder} sortOrder - The sort order to be applied (either "asc" for ascending or "desc" for descending).
@@ -135,7 +137,7 @@ export class RecordGetOperation {
                     .utcOffset(this.layout.database.host.timezoneOffsetFunc(item.moment))
                     .format(item.type === 'date'
                     ? this.layout.database.host.dateFormat
-                    : item.type == 'time'
+                    : item.type === 'time'
                         ? this.layout.database.host.timeFormat
                         : this.layout.database.host.timeStampFormat);
             }).join('');
@@ -143,7 +145,7 @@ export class RecordGetOperation {
         return out;
     }
     /**
-     * Adds a new request/query to the list of queries.
+     * Add one FileMaker find request block.
      *
      * @param {FindRequest} query - The find request to be added.
      * @param {boolean} [omit=false] - Flag to indicate if the find request should be omitted.
@@ -154,7 +156,7 @@ export class RecordGetOperation {
         return this;
     }
     /**
-     * Perform a fetch operation.
+     * Execute request and return current page of records.
      *
      * @returns {Promise} A promise that resolves with the result of the fetch operation.
      */
@@ -162,7 +164,6 @@ export class RecordGetOperation {
         return await this.performFind(this.offset, this.limit);
     }
     async performFind(offset, limit) {
-        const trace = new Error();
         await this.layout.getLayoutMeta();
         const isFind = this.isFindRequest;
         let endpoint = this.layout.endpoint + (isFind ? '/_find' : '/records');
@@ -171,21 +172,17 @@ export class RecordGetOperation {
         const reqData = {
             // port: 443,
             method: isFind ? 'POST' : 'GET',
+            type: ApiRecordResponseObj,
             body: isFind ? JSON.stringify(this.generateParamsBody(offset, limit)) : undefined
         };
         try {
-            const res = await this.layout.database._apiRequestJSON(endpoint, reqData);
-            if (res.messages[0].code === '0' && res.response) {
-                // console.log("RESOLVING")
-                if (!this.layout.metadata)
-                    await this.layout.getLayoutMeta();
-                return res.response.data.map(item => {
-                    return new LayoutRecord(this.layout, item.recordId, item.modId, item.fieldData, item.portalData);
-                });
-            }
-            else {
-                throw new FMError(res.messages[0].code, res.httpStatus, res, trace);
-            }
+            const res = await this.layout.database.fetchJSON(endpoint, reqData);
+            // console.log("RESOLVING")
+            if (!this.layout.metadata)
+                await this.layout.getLayoutMeta();
+            return res.data.map(item => {
+                return new LayoutRecord(this.layout, item.recordId, item.modId, item.fieldData, item.portalData);
+            });
         }
         catch (e) {
             if (e instanceof FMError) {
@@ -198,7 +195,7 @@ export class RecordGetOperation {
         }
     }
     /**
-     * Creates an iterator that iterates throguh all results
+     * Create async iterator that pages through results lazily.
      * @param pageSize min: 1, max: 999
      */
     iterate(pageSize = 100) {

package/dist/records/layoutRecord.d.ts

@@ -7,30 +7,47 @@ import { type LayoutRecordBase } from './layoutRecordBase.js';
 import { type ApiPortalData, type ApiRowDataDef } from '../models/apiResults.js';
 import { type LayoutBase } from '../layouts/layoutBase.js';
 import { type Field, type FieldValue } from './field.js';
+import z from 'zod';
 export declare class LayoutRecord<LAYOUT extends LayoutInterface> extends RecordBase<LAYOUT['fields']> implements LayoutRecordBase {
     portals: LAYOUT['portals'];
     private readonly portalsToInclude;
-    constructor(layout: LayoutBase, recordId: number | string, modId?: string | number, fieldData?: Record<string, string | number>, portalData?: ApiPortalData | null, portalsToInclude?: Array<keyof LAYOUT['portals']>);
+    constructor(layout: LayoutBase, recordId: number | string, modId?: string | number, fieldData?: Record<string, string | number>, portalData?: z.infer<typeof ApiPortalData> | null, portalsToInclude?: Array<keyof LAYOUT['portals']>);
+    /** Returns all loaded portals on this record as an array. */
     get portalsArray(): Array<Portal<any>>;
     /**
-     * Asynchronously commits the changes made to the current record.
+     * Saves this record back to FileMaker.
      * @param {extraBodyOptions} extraBody - The options for the extra body elements.
      * @returns {Promise<this>} - A promise that resolves with the modified object.
      * @throws {FMError} - If an error occurs during the commit process.
      */
     commit(extraBody?: extraBodyOptions): Promise<this>;
-    protected processPortalData(portalData: ApiPortalData): void;
+    protected processPortalData(portalData: z.infer<typeof ApiPortalData>): void;
     /**
-     * Re-fetches the current record from the database server.
-     * Throws an error if commit() has not been called.
+     * Reloads this record from FileMaker.
+     * Throws if this record has not been saved yet.
      *
      * @return {Promise<this>} A Promise that resolves to this RecordBase instance if the record is successfully retrieved.
      * @throws {Error} If commit() has not been called.
      * @throws {FMError} If the retrieval fails.
      */
     get(): Promise<this>;
+    /** Creates a duplicate of this record in FileMaker. */
     duplicate(): Promise<LayoutRecord<LAYOUT>>;
+    /** Deletes this record from FileMaker. */
     delete(): Promise<void>;
-    fieldsToObject(filter?: (a: Field<FieldValue>) => boolean): Omit<ApiRowDataDef, 'portalData'>;
-    toObject(filter?: (a: Field<FieldValue>) => any, portalFilter?: (a: Portal<any>) => any, portalRowFilter?: (a: PortalRecord<any>) => any, portalFieldFilter?: (a: Field<FieldValue>) => any): ApiRowDataDef;
+    /** Returns this record's edited fields as a FileMaker API payload. */
+    fieldsToObject(filter?: (a: Field<FieldValue>) => boolean): Omit<z.infer<typeof ApiRowDataDef>, 'portalData'>;
+    /** Returns this record and its portal edits as a FileMaker API payload. */
+    toObject(filter?: (a: Field<FieldValue>) => any, portalFilter?: (a: Portal<any>) => any, portalRowFilter?: (a: PortalRecord<any>) => any, portalFieldFilter?: (a: Field<FieldValue>) => any): {
+        fieldData: Record<string, string | number>;
+        portalData: Record<string, Record<string, string | number>[]>;
+        modId: string;
+        recordId: string;
+        portalDataInfo?: {
+            database: string;
+            table: string;
+            foundCount: number;
+            returnedCount: number;
+        }[] | undefined;
+    };
 }