@jd-data-limited/easy-fm 4.0.5 → 4.0.8

package/README.md

@@ -1,30 +1,38 @@
-# easy-fm
+# Introduction
 
-A [FileMaker Data API](https://help.claris.com/en/data-api-guide/content/index.html) client for NodeJS
+A FileMaker Data API client for NodeJS
 
 easy-fm is a Node.js module that allows you to interact with
-a [FileMaker database](https://www.claris.com/filemaker/) stored on a [FileMaker server](https://www.claris.com/filemaker/server/)
-or [FileMaker Cloud](https://store.claris.com/filemaker-cloud). This module interacts with your server using the
-[FileMaker Data API](https://help.claris.com/en/data-api-guide/content/index.html).
-<!-- TOC -->
+a FileMaker database stored on a FileMaker server
+or FileMaker Cloud. This module interacts with your server using the
+FileMaker Data API.
+
+# Contents
 
-* [easy-fm](#easy-fm)
-    * [FileMaker setup instructions](#filemaker-setup-instructions)
-    * [Before you begin](#before-you-begin)
-    * [Connecting to a database](#connecting-to-a-database)
-    * [Getting records](#getting-records)
-        * [Fetch a range of records](#fetch-a-range-of-records)
-        * [Searching for records](#searching-for-records)
-        * [Fetch a record using its record ID (NOT RECOMMENDED)](#fetch-a-record-using-its-record-id-not-recommended)
-        * [Create a record](#create-a-record)
-        * [Modify a record](#modify-a-record)
+<!-- TOC -->
+* [Introduction](#introduction)
+* [Contents](#contents)
+* [Installation](#installation)
+* [Usage](#usage)
+  * [Connecting to a database](#connecting-to-a-database)
+  * [Getting records](#getting-records)
+    * [Fetch a range of records](#fetch-a-range-of-records)
+    * [Searching for records](#searching-for-records)
+    * [Fetch a record using its record ID (NOT RECOMMENDED)](#fetch-a-record-using-its-record-id-not-recommended)
+    * [Create a record](#create-a-record)
+    * [Modify a record](#modify-a-record)
 * [Field names](#field-names)
 * [Portal names](#portal-names)
 * [Typescript Implementation](#typescript-implementation)
-
 <!-- TOC -->
 
-## FileMaker setup instructions
+# Installation
+
+```npm
+npm install @jd-data-limited/easy-fm --save
+```
+
+easy-fm also requires the following to be configured within your FileMaker enviroment:
 
 1. Enable the FileMaker Data API from the server's admin console. This setting is located
    in `Connectors > FileMaker Data API`.
@@ -33,7 +41,7 @@ or [FileMaker Cloud](https://store.claris.com/filemaker-cloud). This module inte
 
 ---
 
-## Before you begin
+# Usage
 
 - You need to know what your server's UTC time offset (in minutes) is.
     - Running `0 - (new Date()).getTimezoneOffset()` in javascript will give you the UTC time offset for your current

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@jd-data-limited/easy-fm",
-  "version": "4.0.5",
+  "version": "4.0.8",
   "dependencies": {
     "follow-redirects": "^1.15.5",
+    "@types/follow-redirects": "^1.14.4",
     "moment": "^2.29.4"
   },
   "type": "module",
@@ -35,7 +36,6 @@
   "devDependencies": {
     "@types/btoa": "^1.2.3",
     "@types/events": "^3.0.0",
-    "@types/follow-redirects": "^1.14.4",
     "@types/inquirer": "^9.0.7",
     "dotenv": "^16.3.1",
     "inquirer": "^9.2.13",

package/src/connection/database.d.ts

@@ -18,10 +18,11 @@ export declare class Database<T extends DatabaseStructure> extends EventEmitter
     constructor(host: HostBase, conn: databaseOptionsWithExternalSources);
     private generateExternalSourceLogin;
     logout(): Promise<void>;
-    login(): Promise<any>;
+    login(forceLogin?: boolean): Promise<any>;
     get token(): any;
     get endpoint(): string;
-    apiRequest<T = any>(url: string | Request, options?: any, autoRelogin?: boolean): Promise<ApiResults<T>>;
+    apiRequestRaw(url: string | Request, options?: any, autoRelogin?: boolean): Promise<Response>;
+    apiRequestJSON<T = any>(url: string | Request, options?: any): Promise<ApiResults<T>>;
     listLayouts(): Promise<Layout<LayoutInterface>[]>;
     getLayout<R extends keyof T["layouts"]>(name: R): Layout<T["layouts"][R]>;
     getLayout<R extends LayoutInterface>(name: string): Layout<R>;

package/src/connection/database.js

@@ -44,11 +44,11 @@ export class Database extends EventEmitter {
         // console.log(data)
         this._token = null;
     }
-    async login() {
+    async login(forceLogin = false) {
         // Reset cookies
         this.cookies = {};
         await this.host.getMetadata();
-        if (this.token)
+        if (this.token && !forceLogin)
             throw new Error("Already logged in. Run logout() first");
         if (this.connection_details.credentials.method === "token") {
             this._token = this.connection_details.credentials.token;
@@ -85,10 +85,11 @@ export class Database extends EventEmitter {
     get endpoint() {
         return `${this.host.hostname}/fmi/data/v2/databases/${this.name}`;
     }
-    async apiRequest(url, options = {}, autoRelogin = true) {
+    async apiRequestRaw(url, options = {}, autoRelogin = true) {
+        if (!this.token)
+            await this.login(true);
         if (!options.headers)
             options.headers = {};
-        options.headers["content-type"] = options.headers["content-type"] ? options.headers["content-type"] : "application/json";
         options.headers["authorization"] = "Bearer " + this._token;
         options.rejectUnauthorized = this.host.verify;
         let _fetch = await fetch(url, options);
@@ -98,24 +99,30 @@ export class Database extends EventEmitter {
                 this.cookies[cookie_split[0]] = cookie_split[1];
             }
         }
+        if (_fetch.status === 401 && autoRelogin) {
+            await this.login(true);
+            return await this.apiRequestRaw(url, options, false);
+        }
+        return _fetch;
+    }
+    async apiRequestJSON(url, options = {}) {
+        if (!options.headers)
+            options.headers = {};
+        options.headers["content-type"] = options.headers["content-type"] ? options.headers["content-type"] : "application/json";
+        let _fetch = await this.apiRequestRaw(url, options);
         let data = await _fetch.json();
         // Remove response if it is empty. This makes checking for an empty response easier
         if (data.response && Object.keys(data.response).length === 0)
             delete data.response;
         // console.log(data.messages[0])
-        if (data.messages[0].code === "952" && autoRelogin) {
-            this._token = null;
-            await this.login();
-            return await this.apiRequest(url, options, false);
-        }
-        else if (data.messages[0].code !== "0") {
+        if (data.messages[0].code !== "0") {
             throw new FMError(data.messages[0].code, _fetch.status, data);
         }
         data.httpStatus = _fetch.status;
         return data;
     }
     async listLayouts() {
-        let req = await this.apiRequest(`${this.endpoint}/layouts?page=2`);
+        let req = await this.apiRequestJSON(`${this.endpoint}/layouts?page=2`);
         if (!req.response)
             throw new FMError(req.messages[0].code, req.httpStatus, req.messages[0].message);
         const cycleLayoutNames = (layouts) => {

package/src/connection/database.ts

@@ -65,12 +65,12 @@ export class Database<T extends DatabaseStructure> extends EventEmitter implemen
         this._token = null
     }
 
-    async login() {
+    async login(forceLogin = false) {
         // Reset cookies
         this.cookies = {}
 
         await this.host.getMetadata()
-        if (this.token) throw new Error("Already logged in. Run logout() first")
+        if (this.token && !forceLogin) throw new Error("Already logged in. Run logout() first")
 
         if (this.connection_details.credentials.method === "token") {
             this._token = (<loginOptionsToken>this.connection_details.credentials).token
@@ -110,9 +110,10 @@ export class Database<T extends DatabaseStructure> extends EventEmitter implemen
         return `${this.host.hostname}/fmi/data/v2/databases/${this.name}`
     }
 
-    async apiRequest<T = any>(url: string | Request, options: any = {}, autoRelogin = true): Promise<ApiResults<T>> {
+    async apiRequestRaw(url: string | Request, options: any = {}, autoRelogin = true): Promise<Response> {
+        if (!this.token) await this.login(true)
+
         if (!options.headers) options.headers = {}
-        options.headers["content-type"] = options.headers["content-type"] ? options.headers["content-type"] : "application/json"
         options.headers["authorization"] = "Bearer " + this._token
         options.rejectUnauthorized = this.host.verify
 
@@ -123,18 +124,24 @@ export class Database<T extends DatabaseStructure> extends EventEmitter implemen
                 this.cookies[cookie_split[0]] = cookie_split[1]
             }
         }
+
+        if (_fetch.status === 401 && autoRelogin) {
+            await this.login(true)
+            return await this.apiRequestRaw(url, options, false)
+        }
+        return _fetch
+    }
+    async apiRequestJSON<T = any>(url: string | Request, options: any = {}): Promise<ApiResults<T>> {
+        if (!options.headers) options.headers = {}
+        options.headers["content-type"] = options.headers["content-type"] ? options.headers["content-type"] : "application/json"
+        let _fetch = await this.apiRequestRaw(url, options)
         let data = await _fetch.json() as ApiResults<T>
 
         // Remove response if it is empty. This makes checking for an empty response easier
         if (data.response && Object.keys(data.response).length === 0) delete data.response
 
         // console.log(data.messages[0])
-        if (data.messages[0].code === "952" && autoRelogin) {
-            this._token = null
-            await this.login()
-            return await this.apiRequest(url, options, false)
-        }
-        else if (data.messages[0].code !== "0") {
+        if (data.messages[0].code !== "0") {
             throw new FMError(data.messages[0].code, _fetch.status, data)
         }
 
@@ -143,7 +150,7 @@ export class Database<T extends DatabaseStructure> extends EventEmitter implemen
     }
 
     async listLayouts() {
-        let req = await this.apiRequest<{layouts: ApiLayout[]}>(`${this.endpoint}/layouts?page=2`)
+        let req = await this.apiRequestJSON<{layouts: ApiLayout[]}>(`${this.endpoint}/layouts?page=2`)
         if (!req.response) throw new FMError(req.messages[0].code, req.httpStatus, req.messages[0].message)
 
         const cycleLayoutNames = (layouts: ApiLayout[]) => {

package/src/connection/databaseBase.d.ts

@@ -6,6 +6,7 @@ export interface DatabaseBase {
     host: HostBase;
     readonly name: string;
     endpoint: string;
-    apiRequest<T = unknown>(url: string | Request, options?: any, autoRelogin?: boolean): Promise<ApiResults<T>>;
+    apiRequestJSON<T = unknown>(url: string | Request, options?: RequestInit | undefined, autoRelogin?: boolean): Promise<ApiResults<T>>;
+    apiRequestRaw(url: string | Request, options?: RequestInit | undefined): Promise<Response>;
     streamURL(url: string): Promise<IncomingMessage>;
 }

package/src/connection/databaseBase.ts

@@ -13,6 +13,7 @@ export interface DatabaseBase {
 
     // layouts: DatabaseStructure["layouts"]
 
-    apiRequest<T = unknown>(url: string | Request, options?: any, autoRelogin?: boolean): Promise<ApiResults<T>>
+    apiRequestJSON<T = unknown>(url: string | Request, options?: RequestInit | undefined, autoRelogin?: boolean): Promise<ApiResults<T>>
+    apiRequestRaw(url: string | Request, options?: RequestInit | undefined): Promise<Response>
     streamURL(url: string): Promise<IncomingMessage>
 }

package/src/layouts/layout.js

@@ -19,8 +19,7 @@ export class Layout {
         let url = `${this.endpoint}/script/${encodeURIComponent(script.name)}`;
         if (script.parameter)
             url += "?script.param=" + encodeURIComponent(script.parameter);
-        let res = await this.database.apiRequest(url, {
-            port: 443,
+        let res = await this.database.apiRequestJSON(url, {
             method: "GET"
         });
         if (res.response && res.messages[0].code === "0") {
@@ -38,7 +37,7 @@ export class Layout {
         if (this.metadata) {
             return this.metadata;
         }
-        let res = await this.database.apiRequest(this.endpoint);
+        let res = await this.database.apiRequestJSON(this.endpoint);
         if (!res.response)
             throw new FMError(res.messages[0].code, res.httpStatus, res);
         this.metadata = res.response;

package/src/layouts/layout.ts

@@ -29,8 +29,7 @@ export class Layout<T extends LayoutInterface> implements LayoutBase {
     async runScript(script: Script): Promise<ScriptResult> {
         let url = `${this.endpoint}/script/${encodeURIComponent(script.name)}`
         if (script.parameter) url += "?script.param=" + encodeURIComponent(script.parameter)
-        let res = await this.database.apiRequest<ApiScriptResult>(url, {
-            port: 443,
+        let res = await this.database.apiRequestJSON<ApiScriptResult>(url, {
             method: "GET"
         })
         if (res.response && res.messages[0].code === "0") {
@@ -49,7 +48,7 @@ export class Layout<T extends LayoutInterface> implements LayoutBase {
             return this.metadata
         }
 
-        let res = await this.database.apiRequest<ApiLayoutMetadata>(this.endpoint)
+        let res = await this.database.apiRequestJSON<ApiLayoutMetadata>(this.endpoint)
         if (!res.response) throw new FMError(res.messages[0].code, res.httpStatus, res)
         this.metadata = res.response
         return this.metadata

package/src/records/fieldBase.js

@@ -120,12 +120,13 @@ export class FieldBase {
             throw "Cannot upload a file to the field; " + this.id + " (not a container field)";
         let form = new FormData();
         form.append("upload", new File([buffer], filename, { type: mime }));
-        await this.parent.layout.database.apiRequest(`${this.parent.endpoint}/containers/${this.id}/1`, {
+        let res = await this.parent.layout.database.apiRequestRaw(`${this.parent.endpoint}/containers/${this.id}/1`, {
             method: "POST",
             // @ts-ignore
-            headers: { "Authorization": "Bearer " + this.parent.layout.database.token },
             body: form
         });
+        if (!res.ok)
+            throw new Error(`Upload failed with HTTP error: ${res.status} (${res.statusText})`);
     }
     async download(mode = DOWNLOAD_MODES.Stream) {
         if (this.metadata.result !== ApiFieldResultTypes.CONTAINER)

package/src/records/fieldBase.ts

@@ -136,12 +136,12 @@ export class FieldBase<T extends FieldValue> {
         let form = new FormData()
         form.append("upload", new File([buffer], filename, {type: mime}))
 
-        await this.parent.layout.database.apiRequest<null>(`${this.parent.endpoint}/containers/${this.id}/1`, {
+        let res = await this.parent.layout.database.apiRequestRaw(`${this.parent.endpoint}/containers/${this.id}/1`, {
             method: "POST",
             // @ts-ignore
-            headers: {"Authorization": "Bearer " + this.parent.layout.database.token},
             body: form
         })
+        if (!res.ok) throw new Error(`Upload failed with HTTP error: ${res.status} (${res.statusText})`)
     }
 
     download(mode: DOWNLOAD_MODES.Stream): Promise<http.IncomingMessage>

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

@@ -2,9 +2,10 @@ import { LayoutInterface } from "../../layouts/layoutInterface.js";
 import { PickPortals, ScriptRequestData } from "../../types.js";
 import { LayoutBase } from "../../layouts/layoutBase.js";
 import { LayoutRecord } from "../layoutRecord.js";
+import { Query } from "../../utils/query.js";
 export type SortOrder = "ascend" | "descend";
 export type FindRequest = {
-    [key: string]: string;
+    [key: string]: Query;
 } & {
     omit?: "true" | "false";
 };
@@ -35,6 +36,7 @@ export declare class RecordGetOperation<T extends LayoutInterface, OPTIONS exten
     protected queries: FindRequest[];
     constructor(layout: LayoutBase, options: OPTIONS);
     get isFindRequest(): boolean;
+    private formatQueries;
     protected generateParamsBody(offset: number, limit: number): {
         [key: string]: any;
     };

package/src/records/getOperations/recordGetOperation.js

@@ -3,6 +3,7 @@
  */
 import { LayoutRecord } from "../layoutRecord.js";
 import { FMError } from "../../FMError.js";
+import { FindRequestSymbol } from "../../utils/query.js";
 export class RecordGetOperation {
     layout;
     limit = 100;
@@ -21,6 +22,19 @@ export class RecordGetOperation {
     get isFindRequest() {
         return this.queries.length !== 0;
     }
+    formatQueries() {
+        return this.queries.map(query => {
+            let out = {};
+            for (let key of Object.keys(query)) {
+                if (query[key][FindRequestSymbol])
+                    out[key] = query[key][FindRequestSymbol];
+                else {
+                    out[key] = query[key];
+                }
+            }
+            return out;
+        });
+    }
     generateParamsBody(offset, limit) {
         const params = {
             limit: limit.toString(),
@@ -41,7 +55,7 @@ export class RecordGetOperation {
         if (this.scriptData.prerequest?.parameter)
             params["script.prerequest.param"] = this.scriptData.prerequest.parameter;
         if (this.queries.length !== 0)
-            params["query"] = this.queries;
+            params["query"] = this.formatQueries();
         let portals = Object.keys(this.portals);
         params["portal"] = portals;
         for (let portal of portals) {
@@ -105,7 +119,7 @@ export class RecordGetOperation {
             body: is_find ? JSON.stringify(this.generateParamsBody(offset, limit)) : undefined,
         };
         try {
-            let res = await this.layout.database.apiRequest(endpoint, reqData);
+            let res = await this.layout.database.apiRequestJSON(endpoint, reqData);
             if (res.messages[0].code === "0" && res.response) {
                 // console.log("RESOLVING")
                 if (!this.layout.metadata)

package/src/records/getOperations/recordGetOperation.ts

@@ -8,10 +8,11 @@ import {LayoutBase} from "../../layouts/layoutBase.js"
 import {LayoutRecord} from "../layoutRecord.js";
 import {ApiRecordResponseObj} from "../../models/apiResults.js";
 import {FMError} from "../../FMError.js";
+import {FindRequestSymbol, Query} from "../../utils/query.js";
 
 export type SortOrder = "ascend" | "descend"
 export type FindRequest = {
-    [key: string]: string,
+    [key: string]: Query
 } & {omit?: "true" | "false"}
 
 export type PortalRequest = {
@@ -51,6 +52,17 @@ export class RecordGetOperation<T extends LayoutInterface, OPTIONS extends GetOp
         return this.queries.length !== 0
     }
 
+    private formatQueries() {
+        return this.queries.map(query => {
+            let out: any = {}
+            for (let key of Object.keys(query)) {
+                if (query[key][FindRequestSymbol]) out[key] = query[key][FindRequestSymbol]
+                else {out[key] = query[key]}
+            }
+            return out
+        })
+    }
+
     protected generateParamsBody(offset: number, limit: number) {
         const params: {[key: string]: any} = {
             limit: limit.toString(),
@@ -68,7 +80,7 @@ export class RecordGetOperation<T extends LayoutInterface, OPTIONS extends GetOp
         if (this.scriptData.prerequest) params["script.prerequest"] = this.scriptData.prerequest.name
         if (this.scriptData.prerequest?.parameter) params["script.prerequest.param"] = this.scriptData.prerequest.parameter
 
-        if (this.queries.length !== 0) params["query"] = this.queries
+        if (this.queries.length !== 0) params["query"] = this.formatQueries()
 
         let portals: (keyof typeof this.portals)[] = Object.keys(this.portals)
         params["portal"] = portals
@@ -140,7 +152,7 @@ export class RecordGetOperation<T extends LayoutInterface, OPTIONS extends GetOp
         }
 
         try {
-            let res = await this.layout.database.apiRequest<ApiRecordResponseObj>(
+            let res = await this.layout.database.apiRequestJSON<ApiRecordResponseObj>(
                 endpoint,
                 reqData
             )

package/src/records/layoutRecord.js

@@ -41,8 +41,7 @@ export class LayoutRecord extends RecordBase {
         }
         if (this.recordId === -1) {
             // This is a new LayoutRecord
-            let res = await this.layout.database.apiRequest(`${this.layout.endpoint}/records`, {
-                port: 443,
+            let res = await this.layout.database.apiRequestJSON(`${this.layout.endpoint}/records`, {
                 method: "POST",
                 body: JSON.stringify(data)
             });
@@ -62,8 +61,7 @@ export class LayoutRecord extends RecordBase {
             }
         }
         // for (let item of Object.keys(data)) extraBody[item] = data[item]
-        let res = await this.layout.database.apiRequest(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON(this.endpoint, {
             method: "PATCH",
             body: JSON.stringify(data)
         });
@@ -102,8 +100,7 @@ export class LayoutRecord extends RecordBase {
         }
         if (!this.layout.metadata)
             await this.layout.getLayoutMeta();
-        let res = await this.layout.database.apiRequest(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON(this.endpoint, {
             method: "GET"
         });
         if (res.response && res.messages[0].code === "0") {
@@ -121,8 +118,7 @@ export class LayoutRecord extends RecordBase {
     }
     async duplicate() {
         let trace = new Error();
-        let res = await this.layout.database.apiRequest(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON(this.endpoint, {
             method: "POST"
         });
         if (!res.response) {
@@ -142,8 +138,7 @@ export class LayoutRecord extends RecordBase {
         }
     }
     async delete() {
-        let res = await this.layout.database.apiRequest(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON(this.endpoint, {
             method: "DELETE"
         });
         console.log(res);

package/src/records/layoutRecord.ts

@@ -57,8 +57,7 @@ export class LayoutRecord<LAYOUT extends LayoutInterface> extends RecordBase<LAY
 
         if (this.recordId === -1) {
             // This is a new LayoutRecord
-             let res = await this.layout.database.apiRequest<{ recordId: string, modId: string }>(`${this.layout.endpoint}/records`, {
-                    port: 443,
+             let res = await this.layout.database.apiRequestJSON<{ recordId: string, modId: string }>(`${this.layout.endpoint}/records`, {
                     method: "POST",
                     body: JSON.stringify(data)
                 })
@@ -80,14 +79,13 @@ export class LayoutRecord<LAYOUT extends LayoutInterface> extends RecordBase<LAY
         }
 
         // for (let item of Object.keys(data)) extraBody[item] = data[item]
-        let res = await this.layout.database.apiRequest<{
+        let res = await this.layout.database.apiRequestJSON<{
             modId: string, newPortalRecordInfo: {
                 tableName: string,
                 recordId: string,
                 modId: string
             }[]
         }>(this.endpoint, {
-            port: 443,
             method: "PATCH",
             body: JSON.stringify(data)
         })
@@ -128,8 +126,7 @@ export class LayoutRecord<LAYOUT extends LayoutInterface> extends RecordBase<LAY
             throw "Cannot get this RecordBase until a commit() is done."
         }
         if (!this.layout.metadata) await this.layout.getLayoutMeta()
-        let res = await this.layout.database.apiRequest<ApiRecordResponseObj>(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON<ApiRecordResponseObj>(this.endpoint, {
             method: "GET"
         })
 
@@ -147,8 +144,7 @@ export class LayoutRecord<LAYOUT extends LayoutInterface> extends RecordBase<LAY
 
     async duplicate(): Promise<LayoutRecord<LAYOUT>> {
         let trace = new Error()
-        let res = await this.layout.database.apiRequest<{recordId: string, modId: string}>(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON<{recordId: string, modId: string}>(this.endpoint, {
             method: "POST"
         })
         if (!res.response) {
@@ -170,8 +166,7 @@ export class LayoutRecord<LAYOUT extends LayoutInterface> extends RecordBase<LAY
     }
 
     async delete(): Promise<void> {
-        let res = await this.layout.database.apiRequest(this.endpoint, {
-            port: 443,
+        let res = await this.layout.database.apiRequestJSON(this.endpoint, {
             method: "DELETE"
         })
         console.log(res)

package/src/utils/query.d.ts

@@ -1,4 +1,10 @@
+export declare const FindRequestSymbol: unique symbol;
 type QueryParameter = string | number | Date;
+export type Query = {
+    [FindRequestSymbol]: string;
+};
 export declare function queryEscape(str: string): string;
-export declare function query(strings: TemplateStringsArray, ...args: QueryParameter[]): string;
+export declare function query(strings: TemplateStringsArray, ...args: QueryParameter[]): {
+    [FindRequestSymbol]: string;
+};
 export {};

package/src/utils/query.js

@@ -1,6 +1,7 @@
 /*
  * Copyright (c) 2024. See LICENSE file for more information
  */
+export const FindRequestSymbol = Symbol("easyfm-findrequest");
 const SPECIAL_CHARACTERS = ["\\", "=", "<", "≤", "≥", ">", "…", "...", "//", "@", "#", "*", "\"", "~"];
 export function queryEscape(str) {
     for (let char of SPECIAL_CHARACTERS) {
@@ -16,5 +17,5 @@ export function query(strings, ...args) {
     const query = strings.map((str, index) => {
         return str + (argStrings[index] || '');
     });
-    return query.join("");
+    return { [FindRequestSymbol]: query.join("") };
 }

package/src/utils/query.ts

@@ -2,8 +2,10 @@
  * Copyright (c) 2024. See LICENSE file for more information
  */
 
+export const FindRequestSymbol = Symbol("easyfm-findrequest");
 const SPECIAL_CHARACTERS = ["\\", "=", "<", "≤", "≥", ">", "…", "...", "//", "@", "#", "*", "\"", "~"]
 type QueryParameter = string | number | Date
+export type Query = {[FindRequestSymbol]: string}
 
 export function queryEscape(str: string) {
     for (let char of SPECIAL_CHARACTERS) {
@@ -21,5 +23,5 @@ export function query(strings: TemplateStringsArray, ...args: QueryParameter[])
     const query = strings.map((str, index) => {
         return str + (argStrings[index] || '')
     })
-    return query.join("")
+    return {[FindRequestSymbol]: query.join("")}
 }

package/src/records/field.d.ts

@@ -1,6 +0,0 @@
-import { RecordBase } from "./recordBase.js";
-import { FieldBase, FieldValue } from "./fieldBase.js";
-export declare abstract class Field<T extends FieldValue> extends FieldBase<T> {
-    record: RecordBase<any>;
-    protected constructor(record: RecordBase<any>);
-}

package/src/records/field.js

@@ -1,11 +0,0 @@
-/*
- * Copyright (c) 2024. See LICENSE file for more information
- */
-import { FieldBase } from "./fieldBase.js";
-export class Field extends FieldBase {
-    record;
-    constructor(record) {
-        super();
-        this.record = record;
-    }
-}

package/src/utils/fmQuery.d.ts

@@ -1,4 +0,0 @@
-type QueryParameter = string | number | Date;
-export declare function fmQueryEscape(str: string): string;
-export declare function fmQuery(strings: TemplateStringsArray, ...args: QueryParameter[]): string;
-export {};

package/src/utils/fmQuery.js

@@ -1,20 +0,0 @@
-/*
- * Copyright (c) 2024. See LICENSE file for more information
- */
-const SPECIAL_CHARACTERS = ["\\", "=", "<", "≤", "≥", ">", "…", "...", "//", "@", "#", "*", "\"", "~"];
-export function fmQueryEscape(str) {
-    for (let char of SPECIAL_CHARACTERS) {
-        str = str.replace(char, `\\${char}`);
-    }
-    return str;
-}
-export function fmQuery(strings, ...args) {
-    let argStrings = args.map(item => {
-        return fmQueryEscape(item.toString());
-    });
-    // Zip the parameters together
-    const query = strings.map((str, index) => {
-        return str + (args[index] || '');
-    });
-    return query.join("");
-}