timezest 1.1.3 → 1.1.4

package/LICENSE

@@ -1,9 +1,9 @@
-MIT License
-
-Copyright (c) 2025 PNC IT
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
+MIT License
+
+Copyright (c) 2025 PNC IT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
 THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -133,29 +133,51 @@ async function fetchAllResources() {
 fetchAllResources();
 ```
 
-## Retry Logic
+## Rate Limiting and Retry Logic
 
-The `TimeZestAPI` class includes built-in retry logic for handling transient errors, such as network issues or rate-limiting responses from the TimeZest API. You can configure the retry behavior using the following options when initializing the class:
+The `TimeZestAPI` class includes intelligent retry logic optimized for TimeZest's API limits. TimeZest enforces a **maximum of 180 requests in any 60-second sliding window**.
 
-- **`maxRetryTimeMs`**: The maximum amount of time (in milliseconds) to spend retrying a request. Defaults to a reasonable value defined in the configuration.
-- **`maxRetryDelayMs`**: The maximum delay (in milliseconds) between retry attempts. This helps prevent excessive delays during retries.
+### Retry Strategy
+
+When a request fails due to rate limiting (429 Too Many Requests), the library automatically retries with an optimized strategy:
+
+- **Aggressive Exponential Backoff**: Starts at 1 second and doubles with each retry (1s, 2s, 4s, 8s, 16s, 32s, 64s...)
+- **Jitter**: Adds ±25% random variation to retry delays to prevent a thundering herd problem when multiple clients hit rate limits simultaneously
+- **Retry-After Header**: Always respects the `Retry-After` header from 429 responses when provided by the API
+- **Patient by Default**: Will retry for up to 5 minutes by default, allowing time for rate limit windows to clear
+- **Configurable**: Full control over retry behavior via configuration options
+
+### Configuration Options
+
+You can configure the retry behavior using the following options when initializing the class:
+
+- **`maxRetryTimeMs`**: The maximum amount of time (in milliseconds) to spend retrying a request. Defaults to 5 minutes (300,000ms).
+- **`maxRetryDelayMs`**: The maximum delay (in milliseconds) between individual retry attempts. Defaults to 60 seconds (60,000ms).
 
 ### Example Configuration
 
 ```typescript
 const options = {
-  maxRetryTimeMs: 30000, // Retry for up to 30 seconds
-  maxRetryDelayMs: 2000, // Wait up to 2 seconds between retries
+  maxRetryTimeMs: 10 * 60 * 1000, // Retry for up to 10 minutes
+  maxRetryDelayMs: 60 * 1000, // Max 60 seconds between retries
+  logLevel: "debug", // See detailed retry information in logs
 };
 
 const timeZest = new TimeZestAPI("your-api-key", options);
 ```
 
-### How It Works
+### Retry Behavior Example
 
-When a request fails due to a transient error (e.g., a 429 Too Many Requests response or a network timeout), the library will automatically retry the request until the `maxRetryTimeMs` limit is reached. The delay between retries is capped by `maxRetryDelayMs` and may increase with each attempt to avoid overwhelming the server.
+If you hit a rate limit without a `Retry-After` header, the retry delays will be:
+- 1st retry: ~1 second (0.75-1.25s with jitter)
+- 2nd retry: ~2 seconds (1.5-2.5s with jitter)  
+- 3rd retry: ~4 seconds (3-5s with jitter)
+- 4th retry: ~8 seconds (6-10s with jitter)
+- 5th retry: ~16 seconds (12-20s with jitter)
+- 6th retry: ~32 seconds (24-40s with jitter)
+- 7th+ retry: ~60 seconds (45-60s with jitter, capped at maxRetryDelayMs)
 
-This retry logic ensures that your application can gracefully handle temporary issues without requiring manual intervention.
+The jitter ensures that if multiple clients hit the rate limit at the same time, they won't all retry simultaneously.
 
 ## Logging
 

package/{config → dist/config}/config.d.ts

@@ -30,5 +30,8 @@ export interface TimeZestAPIConfig {
 }
 /**
  * Default configuration for the TimeZest API client.
+ *
+ * Rate limit: 180 requests per 60 seconds (sliding window)
+ * Retry strategy: Aggressive exponential backoff with jitter
  */
 export declare const CONFIG: TimeZestAPIConfig;

package/{config → dist/config}/config.js

@@ -4,13 +4,16 @@ exports.CONFIG = void 0;
 const logger_1 = require("../utils/logger");
 /**
  * Default configuration for the TimeZest API client.
+ *
+ * Rate limit: 180 requests per 60 seconds (sliding window)
+ * Retry strategy: Aggressive exponential backoff with jitter
  */
 exports.CONFIG = {
     logLevel: "error",
     logger: logger_1.defaultLogger,
     baseUrl: "https://api.timezest.com/v1",
-    maxRetryDelayMs: 1.5 * 60 * 1000, // 1.5 minutes
-    maxRetryTimeMs: 15 * 1000, // 15 seconds
+    maxRetryDelayMs: 60 * 1000, // 60 seconds (aligned with rate limit window)
+    maxRetryTimeMs: 5 * 60 * 1000, // 5 minutes (be patient with retries)
     outputValidation: true,
 };
 //# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";;;AAAA,4CAAkE;AAqClE;;;;;GAKG;AACU,QAAA,MAAM,GAAsB;IACvC,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,sBAAa;IACrB,OAAO,EAAE,6BAA6B;IACtC,eAAe,EAAE,EAAE,GAAG,IAAI,EAAE,8CAA8C;IAC1E,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,sCAAsC;IACrE,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/{index.d.ts → dist/index.d.ts}

@@ -1,8 +1,10 @@
 import { log, LogLevel, Logger } from "./utils/logger";
 import { TimeZestAPIConfig } from "./config/config";
 import { Agent, Resource, AppointmentType, SchedulingRequest, Team, SchedulingRequestPost } from "./entities/entities";
+import { TQLFilter } from "./utils/tqlFilter";
 export { Agent, Resource, AppointmentType, SchedulingRequest, SchedulingRequestPost, Team } from "./entities/entities";
 export { ResourceSchema, AgentSchema, AppointmentTypeSchema, SchedulingRequestSchema, TeamSchema } from "./entities/schemas";
+export { TQL, TQLFilter } from "./utils/tqlFilter";
 /**
  * Options for configuring the TimeZest API.
  */
@@ -46,28 +48,28 @@ export declare class TimeZestAPI {
     getConfig(): TimeZestAPIConfig;
     /**
      * Fetches resources from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<Resource[]>} A promise that resolves to an array of resources.
      */
-    getResources: (filter?: string | null) => Promise<Resource[]>;
+    getResources: (filter?: TQLFilter | string | null) => Promise<Resource[]>;
     /**
      * Fetches agents from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<Agent[]>} A promise that resolves to an array of agents.
      */
-    getAgents(filter?: string | null): Promise<Agent[]>;
+    getAgents(filter?: TQLFilter | string | null): Promise<Agent[]>;
     /**
      * Fetches teams from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<Team[]>} A promise that resolves to an array of teams.
      */
-    getTeams(filter?: string | null): Promise<Team[]>;
+    getTeams(filter?: TQLFilter | string | null): Promise<Team[]>;
     /**
      * Fetches appointment types from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<AppointmentType[]>} A promise that resolves to an array of appointment types.
      */
-    getAppointmentTypes(filter?: string | null): Promise<AppointmentType[]>;
+    getAppointmentTypes(filter?: TQLFilter | string | null): Promise<AppointmentType[]>;
     /**
      * Fetches a scheduling request by its ID.
      * @param {string} id - The ID of the scheduling request to fetch.
@@ -76,10 +78,10 @@ export declare class TimeZestAPI {
     getSchedulingRequest(id: string): Promise<SchedulingRequest>;
     /**
      * Fetches scheduling requests from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<SchedulingRequest[]>} A promise that resolves to an array of scheduling requests.
      */
-    getSchedulingRequests(filter?: string | null): Promise<SchedulingRequest[]>;
+    getSchedulingRequests(filter?: TQLFilter | string | null): Promise<SchedulingRequest[]>;
     /**
      * Creates a new scheduling request in the TimeZest API.
      * @param {SchedulingRequestPost} data - The data for the new scheduling request.

package/{index.js → dist/index.js}

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeZestAPI = exports.TeamSchema = exports.SchedulingRequestSchema = exports.AppointmentTypeSchema = exports.AgentSchema = exports.ResourceSchema = void 0;
+exports.TimeZestAPI = exports.TQLFilter = exports.TQL = exports.TeamSchema = exports.SchedulingRequestSchema = exports.AppointmentTypeSchema = exports.AgentSchema = exports.ResourceSchema = void 0;
 const schemas_1 = require("./entities/schemas");
 const config_1 = require("./config/config");
 const makeRequest_1 = require("./utils/makeRequest");
@@ -22,6 +22,9 @@ Object.defineProperty(exports, "AgentSchema", { enumerable: true, get: function
 Object.defineProperty(exports, "AppointmentTypeSchema", { enumerable: true, get: function () { return schemas_2.AppointmentTypeSchema; } });
 Object.defineProperty(exports, "SchedulingRequestSchema", { enumerable: true, get: function () { return schemas_2.SchedulingRequestSchema; } });
 Object.defineProperty(exports, "TeamSchema", { enumerable: true, get: function () { return schemas_2.TeamSchema; } });
+var tqlFilter_1 = require("./utils/tqlFilter");
+Object.defineProperty(exports, "TQL", { enumerable: true, get: function () { return tqlFilter_1.TQL; } });
+Object.defineProperty(exports, "TQLFilter", { enumerable: true, get: function () { return tqlFilter_1.TQLFilter; } });
 /**
  * Represents the TimeZest API client.
  * Provides methods to interact with the TimeZest API.
@@ -35,7 +38,7 @@ class TimeZestAPI {
     constructor(apiKey, options) {
         /**
          * Fetches resources from the TimeZest API.
-         * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+         * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
          * @returns {Promise<Resource[]>} A promise that resolves to an array of resources.
          */
         this.getResources = (...args_1) => __awaiter(this, [...args_1], void 0, function* (filter = null) {
@@ -80,7 +83,7 @@ class TimeZestAPI {
     }
     /**
      * Fetches agents from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<Agent[]>} A promise that resolves to an array of agents.
      */
     getAgents() {
@@ -91,7 +94,7 @@ class TimeZestAPI {
     }
     /**
      * Fetches teams from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<Team[]>} A promise that resolves to an array of teams.
      */
     getTeams() {
@@ -102,7 +105,7 @@ class TimeZestAPI {
     }
     /**
      * Fetches appointment types from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<AppointmentType[]>} A promise that resolves to an array of appointment types.
      */
     getAppointmentTypes() {
@@ -124,7 +127,7 @@ class TimeZestAPI {
     }
     /**
      * Fetches scheduling requests from the TimeZest API.
-     * @param {string | null} [filter=null] - Optional filter string to narrow down results.
+     * @param {TQLFilter | string | null} [filter=null] - Optional filter (TQLFilter instance or string) to narrow down results.
      * @returns {Promise<SchedulingRequest[]>} A promise that resolves to an array of scheduling requests.
      */
     getSchedulingRequests() {

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAUA,gDAM4B;AAC5B,4CAAyC;AACzC,qDAAkD;AAClD,qDAAsD;AACtD,2CAA0D;AAC1D,uEAAoE;AAKpE,8CAA6H;AAApH,yGAAA,cAAc,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAAE,kHAAA,uBAAuB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAChG,+CAAmD;AAA1C,gGAAA,GAAG,OAAA;AAAE,sGAAA,SAAS,OAAA;AAyBvB;;;GAGG;AACH,MAAa,WAAW;IAKtB;;;;OAIG;IACH,YAAY,MAAc,EAAE,OAA4B;QA6DxD;;;;WAIG;QACH,iBAAY,GAAG,YAAsE,EAAE,iDAAjE,SAAoC,IAAI;YAC5D,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAoB,EACzC,IAAI,EACJ,yBAAa,CAAC,SAAS,EACvB,KAAK,EACL,IAAI,EACJ,MAAM,CACP,CAAC;YACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,wBAAc,CAAC,CAAC;QACzD,CAAC,CAAA,CAAC;QA1EA,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG;YACZ,QAAQ,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,KAAI,eAAM,CAAC,QAAQ;YAC9C,MAAM,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,KAAI,eAAM,CAAC,MAAM;YACxC,OAAO,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,KAAI,eAAM,CAAC,OAAO;YAC3C,eAAe,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,KAAI,eAAM,CAAC,eAAe;YACnE,cAAc,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,KAAI,eAAM,CAAC,cAAc;YAChE,gBAAgB,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,gBAAgB,MAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAM,CAAC,gBAAgB;SAC/G,CAAC;QACF,IAAI,CAAC,GAAG,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjE,6DAA6D;QAC7D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4CAA4C,oBACzD,OAAO,EACV,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,2CAA2C,oBACxD,IAAI,CAAC,MAAM,EACd,CAAC;QAEH,uEAAuE;QACvE,IAAI,CAAC,YAAY,GAAG,IAAA,oBAAW,EAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,IAAI,EACJ,cAAc,CACf,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,mBAAmB,GAAG,IAAA,oBAAW,EACpC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EACnC,IAAI,EACJ,qBAAqB,CACtB,CAAC;QACF,IAAI,CAAC,oBAAoB,GAAG,IAAA,oBAAW,EACrC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EACpC,IAAI,EACJ,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,uBAAuB,GAAG,IAAA,oBAAW,EACxC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EACvC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAkBD;;;;OAIG;IACG,SAAS;6DAAC,SAAoC,IAAI;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAoB,EACzC,IAAI,EACJ,yBAAa,CAAC,MAAM,EACpB,KAAK,EACL,IAAI,EACJ,MAAM,CACP,CAAC;YACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,qBAAW,CAAC,CAAC;QACtD,CAAC;KAAA;IAED;;;;OAIG;IACG,QAAQ;6DAAC,SAAoC,IAAI;YACrD,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAoB,EACzC,IAAI,EACJ,yBAAa,CAAC,KAAK,EACnB,KAAK,EACL,IAAI,EACJ,MAAM,CACP,CAAC;YACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,oBAAU,CAAC,CAAC;QACrD,CAAC;KAAA;IAED;;;;OAIG;IACG,mBAAmB;6DACvB,SAAoC,IAAI;YAExC,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAoB,EACzC,IAAI,EACJ,yBAAa,CAAC,iBAAiB,EAC/B,KAAK,EACL,IAAI,EACJ,MAAM,CACP,CAAC;YACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,+BAAqB,CAAC,CAAC;QAChE,CAAC;KAAA;IAED;;;;OAIG;IACG,oBAAoB,CAAC,EAAU;;YACnC,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAW,EAChC,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,GAAG,yBAAa,CAAC,mBAAmB,IAAI,EAAE,EAAE,EAC5C,KAAK,EACL,IAAI,EACJ,IAAI,CAAC,MAAM,CAAC,cAAc,EAC1B,IAAI,CAAC,MAAM,CAAC,eAAe,CAC5B,CAAC;YACF,OAAO,iCAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;KAAA;IAED;;;;OAIG;IACG,qBAAqB;6DACzB,SAAoC,IAAI;YAExC,MAAM,QAAQ,GAAG,MAAM,IAAA,2CAAoB,EACzC,IAAI,EACJ,yBAAa,CAAC,mBAAmB,EACjC,KAAK,EACL,IAAI,EACJ,MAAM,CACP,CAAC;YACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iCAAuB,CAAC,CAAC;QAClE,CAAC;KAAA;IAED;;;;OAIG;IACG,uBAAuB,CAC3B,IAA2B;;YAE3B,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAW,EAChC,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,yBAAa,CAAC,mBAAmB,EACjC,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,MAAM,CAAC,cAAc,EAC1B,IAAI,CAAC,MAAM,CAAC,eAAe,CAC5B,CAAC;YACF,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAED;;;;;OAKG;IACK,gBAAgB,CAAI,QAAa,EAAE,MAAiB;QAC1D,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA/MD,kCA+MC;AAED,kBAAe,WAAW,CAAC"}

package/{utils → dist/utils}/makePaginatedRequest.d.ts

@@ -1,5 +1,6 @@
 import { apiEndpoint } from "../constants/endpoints";
 import { TimeZestAPI } from "../index";
+import { TQLFilter } from "./tqlFilter";
 /**
  * Makes a paginated API request.
  * @template T - The type of the response data.
@@ -7,7 +8,7 @@ import { TimeZestAPI } from "../index";
  * @param endpoint - The API endpoint to call.
  * @param method - The HTTP method (GET or POST).
  * @param data - The request payload.
- * @param filter - An optional filter string.
+ * @param filter - An optional filter string or TQLFilter instance.
  * @returns A promise that resolves to an array of response data.
  */
-export declare const makePaginatedRequest: <T>(apiInstance: TimeZestAPI, endpoint: apiEndpoint, method?: "GET" | "POST", data?: any, filter?: string | null) => Promise<T[]>;
+export declare const makePaginatedRequest: <T>(apiInstance: TimeZestAPI, endpoint: apiEndpoint, method?: "GET" | "POST", data?: any, filter?: TQLFilter | string | null) => Promise<T[]>;

package/{utils → dist/utils}/makePaginatedRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.makePaginatedRequest = void 0;
 const makeRequest_1 = require("./makeRequest");
 const handleError_1 = require("./handleError");
+const tqlFilter_1 = require("./tqlFilter");
 /**
  * Makes a paginated API request.
  * @template T - The type of the response data.
@@ -19,7 +20,7 @@ const handleError_1 = require("./handleError");
  * @param endpoint - The API endpoint to call.
  * @param method - The HTTP method (GET or POST).
  * @param data - The request payload.
- * @param filter - An optional filter string.
+ * @param filter - An optional filter string or TQLFilter instance.
  * @returns A promise that resolves to an array of response data.
  */
 const makePaginatedRequest = (apiInstance_1, endpoint_1, ...args_1) => __awaiter(void 0, [apiInstance_1, endpoint_1, ...args_1], void 0, function* (apiInstance, endpoint, method = "GET", data = null, filter = null) {
@@ -31,7 +32,7 @@ const makePaginatedRequest = (apiInstance_1, endpoint_1, ...args_1) => __awaiter
     try {
         do {
             log("debug", `Fetching page ${nextPage} for ${endpoint}`);
-            const response = yield (0, makeRequest_1.makeRequest)(log, apiKey, baseUrl, endpoint, method, Object.assign(Object.assign({}, data), { filter, page: nextPage }), maxRetryTimeMs, maxRetryDelayMs);
+            const response = yield (0, makeRequest_1.makeRequest)(log, apiKey, baseUrl, endpoint, method, Object.assign(Object.assign({}, data), { filter: (0, tqlFilter_1.normalizeFilter)(filter), page: nextPage }), maxRetryTimeMs, maxRetryDelayMs);
             log("http", `Page ${nextPage} fetched successfully for ${endpoint}`);
             results = results.concat(response.data);
             nextPage = response.next_page;

package/dist/utils/makePaginatedRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makePaginatedRequest.js","sourceRoot":"","sources":["../../src/utils/makePaginatedRequest.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+CAA4C;AAC5C,+CAA4C;AAG5C,2CAAyD;AAEzD;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,uCAMpB,EAAE,8EALhB,WAAwB,EACxB,QAAqB,EACrB,SAAyB,KAAK,EAC9B,OAAY,IAAI,EAChB,SAAoC,IAAI;IAExC,MAAM,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC;IAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IAE7E,IAAI,OAAO,GAAU,EAAE,CAAC;IACxB,IAAI,QAAQ,GAAkB,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,GAAG,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,iBAAiB,QAAQ,QAAQ,QAAQ,EAAE,CAAC,CAAC;YAC1D,MAAM,QAAQ,GACZ,MAAM,IAAA,yBAAW,EAIf,GAAG,EACH,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,kCACD,IAAI,KAAE,MAAM,EAAE,IAAA,2BAAe,EAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,KAC1D,cAAc,EACd,eAAe,CAChB,CAAC;YAEJ,GAAG,CAAC,MAAM,EAAE,QAAQ,QAAQ,6BAA6B,QAAQ,EAAE,CAAC,CAAC;YACrE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC;QAChC,CAAC,QAAQ,QAAQ,EAAE;QAEnB,GAAG,CAAC,MAAM,EAAE,wBAAwB,QAAQ,yBAAyB,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,GAAG,CACD,OAAO,EACP,wBAAwB,QAAQ,wBAAwB,KAAK,CAAC,OAAO,GAAG,CACzE,CAAC;QACF,IAAA,yBAAW,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAA,CAAC;AA/CW,QAAA,oBAAoB,wBA+C/B"}

package/{utils → dist/utils}/makeRequest.js

@@ -49,15 +49,38 @@ function makeRequest(log, apiKey, baseUrl, endpoint, method, data, maxRetryTimeM
             }
             catch (error) {
                 if (((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) === 429) {
-                    const retryAfterHeader = parseInt(error.response.headers["retry-after"], 10);
-                    const retryAfter = retryAfterHeader || Math.min(maxRetryDelayMs, Math.pow(2, retries));
-                    if (totalElapsedTime + retryAfter * 1000 >= maxRetryTimeMs) {
+                    // Parse Retry-After header (can be in seconds or HTTP date format)
+                    let retryAfterMs;
+                    const retryAfterHeader = error.response.headers["retry-after"];
+                    if (retryAfterHeader) {
+                        const retryAfterSeconds = parseInt(retryAfterHeader, 10);
+                        if (!isNaN(retryAfterSeconds)) {
+                            retryAfterMs = retryAfterSeconds * 1000;
+                        }
+                        else {
+                            // HTTP date format - calculate difference
+                            const retryDate = new Date(retryAfterHeader);
+                            retryAfterMs = Math.max(0, retryDate.getTime() - Date.now());
+                        }
+                    }
+                    else {
+                        // No Retry-After header - use aggressive exponential backoff
+                        // Start at 1 second, grow rapidly: 1s, 2s, 4s, 8s, 16s, 32s, 64s
+                        const baseDelayMs = Math.pow(2, retries) * 1000;
+                        // Add jitter (random ±25%) to prevent thundering herd
+                        // If multiple clients hit 429 at the same time, they'll retry at different times
+                        const jitterFactor = 0.75 + Math.random() * 0.5; // Random between 0.75 and 1.25
+                        retryAfterMs = baseDelayMs * jitterFactor;
+                    }
+                    // Cap at maxRetryDelayMs
+                    retryAfterMs = Math.min(maxRetryDelayMs, retryAfterMs);
+                    if (totalElapsedTime + retryAfterMs >= maxRetryTimeMs) {
                         log("error", `Max retry time exceeded for ${endpoint}`);
                         break;
                     }
-                    log("warn", `Rate limited on ${endpoint}. Retrying after ${retryAfter} seconds...`);
-                    yield new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
-                    totalElapsedTime += retryAfter * 1000;
+                    log("warn", `Rate limited (429) on ${endpoint}. Retrying after ${(retryAfterMs / 1000).toFixed(2)} seconds... (attempt ${retries + 1})`);
+                    yield new Promise((resolve) => setTimeout(resolve, retryAfterMs));
+                    totalElapsedTime += retryAfterMs;
                     retries++;
                 }
                 else {
@@ -66,7 +89,7 @@ function makeRequest(log, apiKey, baseUrl, endpoint, method, data, maxRetryTimeM
                 }
             }
         }
-        throw new Error(`Max retry time of ${maxRetryTimeMs} minutes exceeded for ${endpoint}`);
+        throw new Error(`Max retry time of ${maxRetryTimeMs / 1000} seconds exceeded for ${endpoint}`);
     });
 }
 //# sourceMappingURL=makeRequest.js.map

package/dist/utils/makeRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeRequest.js","sourceRoot":"","sources":["../../src/utils/makeRequest.ts"],"names":[],"mappings":"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"}

package/dist/utils/tqlFilter.d.ts

@@ -0,0 +1,260 @@
+/**
+ * TimeZest Query Language (TQL) Filter Builder
+ *
+ * Provides a user-friendly, fluent API for constructing valid TQL filters.
+ * Based on the TimeZest TQL documentation: https://developer.timezest.com/tql/
+ *
+ * @example
+ * ```typescript
+ * // Type-safe filtering with autocomplete (recommended)
+ * const filter = TQL.forSchedulingRequests()
+ *   .filter('status').eq('scheduled');
+ *
+ * // Type-safe chaining with AND/OR
+ * const filter = TQL.forSchedulingRequests()
+ *   .filter('end_user_email').like('@example.com')
+ *   .and('status').eq('scheduled');
+ *
+ * // Using with API - no toString() needed!
+ * const requests = await timeZest.getSchedulingRequests(
+ *   TQL.forSchedulingRequests().filter('status').eq('scheduled')
+ * );
+ *
+ * // Flexible filtering (no type checking, still works)
+ * const filter = TQL.filter('scheduling_request.status').eq('scheduled');
+ *
+ * // Call toString() explicitly if you need the string
+ * const filterString = TQL.forAgents().filter('name').like('John').toString();
+ * ```
+ */
+import type { Agent, Resource, Team, AppointmentType, SchedulingRequest } from '../entities/entities';
+/**
+ * Union of all valid TQL attribute paths.
+ * This is automatically inferred from entity types when using the type-safe helpers.
+ */
+export type TQLAttribute = `agent.${keyof Agent & string}` | `resource.${keyof Resource & string}` | `team.${keyof Team & string}` | `appointment_type.${keyof AppointmentType & string}` | `scheduling_request.${keyof SchedulingRequest & string}`;
+/**
+ * Represents a TQL filter being constructed.
+ */
+export declare class TQLFilter<TAttribute extends string = string> {
+    private predicates;
+    private logicalOperators;
+    private entityPrefix;
+    private currentAttribute;
+    private currentOperator;
+    private currentValue;
+    /**
+     * Creates a new TQL filter starting with the given attribute.
+     * @param attribute - The attribute to filter on (e.g., 'scheduling_request.status')
+     * @param entityPrefix - Optional prefix for this entity type (e.g., 'scheduling_request')
+     */
+    constructor(attribute: TAttribute, entityPrefix?: string);
+    /**
+     * Adds a completed predicate and starts a new one.
+     */
+    private finalizePredicate;
+    /**
+     * Sets the operator and value for comparison operations.
+     */
+    private setComparison;
+    /**
+     * Equals operator (EQ)
+     * @param value - The value to compare against
+     */
+    eq(value: string | number): this;
+    /**
+     * Not equals operator (NOT_EQ)
+     * @param value - The value to compare against
+     */
+    notEq(value: string | number): this;
+    /**
+     * Like operator (contains pattern matching)
+     * @param value - The pattern to match against
+     */
+    like(value: string): this;
+    /**
+     * Not like operator (does not contain pattern)
+     * @param value - The pattern to exclude
+     */
+    notLike(value: string): this;
+    /**
+     * In operator (value is in the provided array)
+     * @param values - Array of values to match against
+     */
+    in(values: string[] | number[]): this;
+    /**
+     * Not in operator (value is not in the provided array)
+     * @param values - Array of values to exclude
+     */
+    notIn(values: string[] | number[]): this;
+    /**
+     * Greater than operator (GT)
+     * @param value - The value to compare against
+     */
+    gt(value: number): this;
+    /**
+     * Greater than or equal operator (GTE)
+     * @param value - The value to compare against
+     */
+    gte(value: number): this;
+    /**
+     * Less than operator (LT)
+     * @param value - The value to compare against
+     */
+    lt(value: number): this;
+    /**
+     * Less than or equal operator (LTE)
+     * @param value - The value to compare against
+     */
+    lte(value: number): this;
+    /**
+     * Adds an AND logical operator and starts a new predicate with the given attribute.
+     * If this filter was created with an entity prefix and you pass just a property name,
+     * it will automatically prepend the entity prefix.
+     * @param attribute - The attribute for the next predicate (full path or property name if using entity prefix)
+     */
+    and(attribute: TAttribute | string): this;
+    /**
+     * Adds an OR logical operator and starts a new predicate with the given attribute.
+     * If this filter was created with an entity prefix and you pass just a property name,
+     * it will automatically prepend the entity prefix.
+     * @param attribute - The attribute for the next predicate (full path or property name if using entity prefix)
+     */
+    or(attribute: TAttribute | string): this;
+    /**
+     * Formats a value for TQL output.
+     * Handles arrays, strings with special characters, and numbers.
+     */
+    private formatValue;
+    /**
+     * Formats a single value for TQL output.
+     */
+    private formatSingleValue;
+    /**
+     * Replaces spaces with tildes outside of quoted strings.
+     * This is needed for URL encoding while preserving spaces inside quoted values.
+     * Handles escaped quotes properly (e.g., "value with \"quotes\"").
+     * @param str - The string to process
+     * @returns The string with spaces outside quotes replaced by tildes
+     */
+    private replaceSpacesOutsideQuotes;
+    /**
+     * Converts the filter to a TQL string suitable for API requests.
+     * In URLs, spaces are replaced with tildes (~).
+     * @param urlEncode - If true, replaces spaces with ~ for URL encoding (default: true)
+     * @returns The TQL filter string
+     */
+    toString(urlEncode?: boolean): string;
+    /**
+     * Returns the filter as a plain string with spaces (not URL encoded).
+     * Useful for debugging or when you need the human-readable format.
+     */
+    toHumanReadableString(): string;
+    /**
+     * Returns the string representation when converted to a primitive.
+     * This allows TQLFilter to be used directly without calling toString().
+     */
+    valueOf(): string;
+    /**
+     * Custom primitive conversion for string contexts.
+     * Allows TQLFilter to be used directly in places expecting strings.
+     */
+    [Symbol.toPrimitive](hint: 'string' | 'number' | 'default'): string;
+}
+/**
+ * Normalizes a filter value to a string.
+ * Converts TQLFilter instances to strings, leaves strings as-is, and returns null for null.
+ * @param filter - The filter value (TQLFilter, string, or null)
+ * @returns The normalized filter string or null
+ */
+export declare function normalizeFilter(filter: TQLFilter | string | null): string | null;
+/**
+ * Helper class for building type-safe filters for specific entity types.
+ * Provides autocomplete and type checking for entity properties.
+ */
+declare class TypedTQLFilterBuilder<T extends Record<string, any>> {
+    private prefix;
+    constructor(prefix: string);
+    /**
+     * Starts a filter with a type-safe attribute from the entity.
+     * @param attribute - A valid property key from the entity type
+     * @returns A TQLFilter instance for method chaining (with entity prefix stored)
+     */
+    filter<K extends keyof T>(attribute: K): TQLFilter<`${string}.${string & K}`>;
+}
+/**
+ * TQL Filter Builder
+ * Provides a user-friendly, fluent API for constructing TimeZest Query Language filters.
+ */
+export declare class TQL {
+    /**
+     * Starts building a TQL filter with the given attribute.
+     * Use this for flexibility - no type checking on the attribute.
+     * For type-safe filtering, use the endpoint-specific helpers like `TQL.forAgents()`.
+     *
+     * @param attribute - The attribute to filter on (e.g., 'scheduling_request.status')
+     * @returns A TQLFilter instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * TQL.filter('scheduling_request.status').eq('scheduled')
+     * ```
+     */
+    static filter(attribute: string): TQLFilter<string>;
+    /**
+     * Creates a type-safe filter builder for Agent entities.
+     * Provides autocomplete and type checking for Agent attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forAgents().filter('name').like('John')
+     * TQL.forAgents().filter('email').eq('user@example.com')
+     * ```
+     */
+    static forAgents(): TypedTQLFilterBuilder<Agent>;
+    /**
+     * Creates a type-safe filter builder for Resource entities.
+     * Provides autocomplete and type checking for Resource attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forResources().filter('name').like('Room')
+     * TQL.forResources().filter('schedulable').eq(true)
+     * ```
+     */
+    static forResources(): TypedTQLFilterBuilder<Resource>;
+    /**
+     * Creates a type-safe filter builder for Team entities.
+     * Provides autocomplete and type checking for Team attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forTeams().filter('internal_name').eq('Tier1')
+     * TQL.forTeams().filter('team_type').eq('support')
+     * ```
+     */
+    static forTeams(): TypedTQLFilterBuilder<Team>;
+    /**
+     * Creates a type-safe filter builder for AppointmentType entities.
+     * Provides autocomplete and type checking for AppointmentType attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forAppointmentTypes().filter('internal_name').eq('consultation')
+     * TQL.forAppointmentTypes().filter('duration_mins').gte(30)
+     * ```
+     */
+    static forAppointmentTypes(): TypedTQLFilterBuilder<AppointmentType>;
+    /**
+     * Creates a type-safe filter builder for SchedulingRequest entities.
+     * Provides autocomplete and type checking for SchedulingRequest attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forSchedulingRequests().filter('status').eq('scheduled')
+     * TQL.forSchedulingRequests().filter('end_user_email').like('@example.com')
+     * ```
+     */
+    static forSchedulingRequests(): TypedTQLFilterBuilder<SchedulingRequest>;
+}
+export default TQL;

package/dist/utils/tqlFilter.js

@@ -0,0 +1,439 @@
+"use strict";
+/**
+ * TimeZest Query Language (TQL) Filter Builder
+ *
+ * Provides a user-friendly, fluent API for constructing valid TQL filters.
+ * Based on the TimeZest TQL documentation: https://developer.timezest.com/tql/
+ *
+ * @example
+ * ```typescript
+ * // Type-safe filtering with autocomplete (recommended)
+ * const filter = TQL.forSchedulingRequests()
+ *   .filter('status').eq('scheduled');
+ *
+ * // Type-safe chaining with AND/OR
+ * const filter = TQL.forSchedulingRequests()
+ *   .filter('end_user_email').like('@example.com')
+ *   .and('status').eq('scheduled');
+ *
+ * // Using with API - no toString() needed!
+ * const requests = await timeZest.getSchedulingRequests(
+ *   TQL.forSchedulingRequests().filter('status').eq('scheduled')
+ * );
+ *
+ * // Flexible filtering (no type checking, still works)
+ * const filter = TQL.filter('scheduling_request.status').eq('scheduled');
+ *
+ * // Call toString() explicitly if you need the string
+ * const filterString = TQL.forAgents().filter('name').like('John').toString();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TQL = exports.TQLFilter = void 0;
+exports.normalizeFilter = normalizeFilter;
+/**
+ * Represents a TQL filter being constructed.
+ */
+class TQLFilter {
+    /**
+     * Creates a new TQL filter starting with the given attribute.
+     * @param attribute - The attribute to filter on (e.g., 'scheduling_request.status')
+     * @param entityPrefix - Optional prefix for this entity type (e.g., 'scheduling_request')
+     */
+    constructor(attribute, entityPrefix) {
+        this.predicates = [];
+        this.logicalOperators = [];
+        this.entityPrefix = null;
+        this.currentOperator = null;
+        this.currentValue = null;
+        this.currentAttribute = attribute;
+        this.entityPrefix = entityPrefix || null;
+    }
+    /**
+     * Adds a completed predicate and starts a new one.
+     */
+    finalizePredicate() {
+        if (this.currentAttribute && this.currentOperator !== null && this.currentValue !== null) {
+            this.predicates.push({
+                attribute: this.currentAttribute,
+                operator: this.currentOperator,
+                value: this.currentValue,
+            });
+        }
+        this.currentAttribute = '';
+        this.currentOperator = null;
+        this.currentValue = null;
+    }
+    /**
+     * Sets the operator and value for comparison operations.
+     */
+    setComparison(operator, value) {
+        if (!this.currentAttribute) {
+            throw new Error('Must call filter() or and() or or() before using comparison operators');
+        }
+        this.currentOperator = operator;
+        this.currentValue = value;
+        this.finalizePredicate();
+        return this;
+    }
+    // String comparison operators
+    /**
+     * Equals operator (EQ)
+     * @param value - The value to compare against
+     */
+    eq(value) {
+        return this.setComparison('EQ', value);
+    }
+    /**
+     * Not equals operator (NOT_EQ)
+     * @param value - The value to compare against
+     */
+    notEq(value) {
+        return this.setComparison('NOT_EQ', value);
+    }
+    /**
+     * Like operator (contains pattern matching)
+     * @param value - The pattern to match against
+     */
+    like(value) {
+        return this.setComparison('LIKE', value);
+    }
+    /**
+     * Not like operator (does not contain pattern)
+     * @param value - The pattern to exclude
+     */
+    notLike(value) {
+        return this.setComparison('NOT_LIKE', value);
+    }
+    /**
+     * In operator (value is in the provided array)
+     * @param values - Array of values to match against
+     */
+    in(values) {
+        if (!Array.isArray(values) || values.length === 0) {
+            throw new Error('IN operator requires a non-empty array');
+        }
+        return this.setComparison('IN', values);
+    }
+    /**
+     * Not in operator (value is not in the provided array)
+     * @param values - Array of values to exclude
+     */
+    notIn(values) {
+        if (!Array.isArray(values) || values.length === 0) {
+            throw new Error('NOT_IN operator requires a non-empty array');
+        }
+        return this.setComparison('NOT_IN', values);
+    }
+    // Numeric/timestamp comparison operators
+    /**
+     * Greater than operator (GT)
+     * @param value - The value to compare against
+     */
+    gt(value) {
+        return this.setComparison('GT', value);
+    }
+    /**
+     * Greater than or equal operator (GTE)
+     * @param value - The value to compare against
+     */
+    gte(value) {
+        return this.setComparison('GTE', value);
+    }
+    /**
+     * Less than operator (LT)
+     * @param value - The value to compare against
+     */
+    lt(value) {
+        return this.setComparison('LT', value);
+    }
+    /**
+     * Less than or equal operator (LTE)
+     * @param value - The value to compare against
+     */
+    lte(value) {
+        return this.setComparison('LTE', value);
+    }
+    /**
+     * Adds an AND logical operator and starts a new predicate with the given attribute.
+     * If this filter was created with an entity prefix and you pass just a property name,
+     * it will automatically prepend the entity prefix.
+     * @param attribute - The attribute for the next predicate (full path or property name if using entity prefix)
+     */
+    and(attribute) {
+        if (this.predicates.length === 0) {
+            throw new Error('Must have at least one predicate before using AND');
+        }
+        this.logicalOperators.push('AND');
+        // If we have an entity prefix and the attribute doesn't contain a dot, prepend the prefix
+        if (this.entityPrefix && !attribute.includes('.')) {
+            this.currentAttribute = `${this.entityPrefix}.${attribute}`;
+        }
+        else {
+            this.currentAttribute = attribute;
+        }
+        return this;
+    }
+    /**
+     * Adds an OR logical operator and starts a new predicate with the given attribute.
+     * If this filter was created with an entity prefix and you pass just a property name,
+     * it will automatically prepend the entity prefix.
+     * @param attribute - The attribute for the next predicate (full path or property name if using entity prefix)
+     */
+    or(attribute) {
+        if (this.predicates.length === 0) {
+            throw new Error('Must have at least one predicate before using OR');
+        }
+        this.logicalOperators.push('OR');
+        // If we have an entity prefix and the attribute doesn't contain a dot, prepend the prefix
+        if (this.entityPrefix && !attribute.includes('.')) {
+            this.currentAttribute = `${this.entityPrefix}.${attribute}`;
+        }
+        else {
+            this.currentAttribute = attribute;
+        }
+        return this;
+    }
+    /**
+     * Formats a value for TQL output.
+     * Handles arrays, strings with special characters, and numbers.
+     */
+    formatValue(value) {
+        if (Array.isArray(value)) {
+            // Arrays are comma-separated (no spaces) according to TQL spec
+            return value.map(v => this.formatSingleValue(v)).join(',');
+        }
+        return this.formatSingleValue(value);
+    }
+    /**
+     * Formats a single value for TQL output.
+     */
+    formatSingleValue(value) {
+        if (typeof value === 'number') {
+            return String(value);
+        }
+        // Strings containing spaces, commas, or tildes should be enclosed in quotes
+        if (/[\s,~"]/.test(value) || value === '') {
+            // Escape quotes in the value
+            const escaped = value.replace(/"/g, '\\"');
+            return `"${escaped}"`;
+        }
+        return value;
+    }
+    /**
+     * Replaces spaces with tildes outside of quoted strings.
+     * This is needed for URL encoding while preserving spaces inside quoted values.
+     * Handles escaped quotes properly (e.g., "value with \"quotes\"").
+     * @param str - The string to process
+     * @returns The string with spaces outside quotes replaced by tildes
+     */
+    replaceSpacesOutsideQuotes(str) {
+        let result = '';
+        let insideQuotes = false;
+        let i = 0;
+        while (i < str.length) {
+            const char = str[i];
+            if (char === '\\' && insideQuotes && i + 1 < str.length) {
+                // Handle escaped characters (like \")
+                result += char + str[i + 1];
+                i += 2;
+                continue;
+            }
+            if (char === '"') {
+                // Toggle quote state
+                insideQuotes = !insideQuotes;
+                result += char;
+            }
+            else if (char === ' ' || char === '\t' || char === '\n') {
+                // Only replace whitespace if we're NOT inside quotes
+                result += insideQuotes ? char : '~';
+            }
+            else {
+                result += char;
+            }
+            i++;
+        }
+        return result;
+    }
+    /**
+     * Converts the filter to a TQL string suitable for API requests.
+     * In URLs, spaces are replaced with tildes (~).
+     * @param urlEncode - If true, replaces spaces with ~ for URL encoding (default: true)
+     * @returns The TQL filter string
+     */
+    toString(urlEncode = true) {
+        // Finalize any pending predicate
+        if (this.currentAttribute && this.currentOperator !== null && this.currentValue !== null) {
+            this.finalizePredicate();
+        }
+        if (this.predicates.length === 0) {
+            throw new Error('Filter must have at least one predicate');
+        }
+        // Build the filter string
+        // Format: predicate1 [operator] predicate2 [operator] predicate3 ...
+        const parts = [];
+        for (let i = 0; i < this.predicates.length; i++) {
+            const predicate = this.predicates[i];
+            const predicateStr = `${predicate.attribute} ${predicate.operator} ${this.formatValue(predicate.value)}`;
+            parts.push(predicateStr);
+            // Add logical operator AFTER this predicate if it's not the last one
+            // logicalOperators[i] contains the operator between predicates[i] and predicates[i+1]
+            if (i < this.predicates.length - 1 && this.logicalOperators[i]) {
+                parts.push(this.logicalOperators[i]);
+            }
+        }
+        let result = parts.join(' ');
+        // Replace spaces with ~ for URL encoding if requested
+        // Only replace spaces outside of quoted strings to preserve spaces in values
+        if (urlEncode) {
+            result = this.replaceSpacesOutsideQuotes(result);
+        }
+        return result;
+    }
+    /**
+     * Returns the filter as a plain string with spaces (not URL encoded).
+     * Useful for debugging or when you need the human-readable format.
+     */
+    toHumanReadableString() {
+        return this.toString(false);
+    }
+    /**
+     * Returns the string representation when converted to a primitive.
+     * This allows TQLFilter to be used directly without calling toString().
+     */
+    valueOf() {
+        return this.toString();
+    }
+    /**
+     * Custom primitive conversion for string contexts.
+     * Allows TQLFilter to be used directly in places expecting strings.
+     */
+    [Symbol.toPrimitive](hint) {
+        return this.toString();
+    }
+}
+exports.TQLFilter = TQLFilter;
+/**
+ * Normalizes a filter value to a string.
+ * Converts TQLFilter instances to strings, leaves strings as-is, and returns null for null.
+ * @param filter - The filter value (TQLFilter, string, or null)
+ * @returns The normalized filter string or null
+ */
+function normalizeFilter(filter) {
+    if (filter === null) {
+        return null;
+    }
+    if (typeof filter === 'string') {
+        return filter;
+    }
+    // filter is a TQLFilter instance
+    return filter.toString();
+}
+/**
+ * Helper class for building type-safe filters for specific entity types.
+ * Provides autocomplete and type checking for entity properties.
+ */
+class TypedTQLFilterBuilder {
+    constructor(prefix) {
+        this.prefix = prefix;
+    }
+    /**
+     * Starts a filter with a type-safe attribute from the entity.
+     * @param attribute - A valid property key from the entity type
+     * @returns A TQLFilter instance for method chaining (with entity prefix stored)
+     */
+    filter(attribute) {
+        const fullPath = `${this.prefix}.${String(attribute)}`;
+        return new TQLFilter(fullPath, this.prefix);
+    }
+}
+/**
+ * TQL Filter Builder
+ * Provides a user-friendly, fluent API for constructing TimeZest Query Language filters.
+ */
+class TQL {
+    /**
+     * Starts building a TQL filter with the given attribute.
+     * Use this for flexibility - no type checking on the attribute.
+     * For type-safe filtering, use the endpoint-specific helpers like `TQL.forAgents()`.
+     *
+     * @param attribute - The attribute to filter on (e.g., 'scheduling_request.status')
+     * @returns A TQLFilter instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * TQL.filter('scheduling_request.status').eq('scheduled')
+     * ```
+     */
+    static filter(attribute) {
+        return new TQLFilter(attribute);
+    }
+    /**
+     * Creates a type-safe filter builder for Agent entities.
+     * Provides autocomplete and type checking for Agent attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forAgents().filter('name').like('John')
+     * TQL.forAgents().filter('email').eq('user@example.com')
+     * ```
+     */
+    static forAgents() {
+        return new TypedTQLFilterBuilder('agent');
+    }
+    /**
+     * Creates a type-safe filter builder for Resource entities.
+     * Provides autocomplete and type checking for Resource attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forResources().filter('name').like('Room')
+     * TQL.forResources().filter('schedulable').eq(true)
+     * ```
+     */
+    static forResources() {
+        return new TypedTQLFilterBuilder('resource');
+    }
+    /**
+     * Creates a type-safe filter builder for Team entities.
+     * Provides autocomplete and type checking for Team attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forTeams().filter('internal_name').eq('Tier1')
+     * TQL.forTeams().filter('team_type').eq('support')
+     * ```
+     */
+    static forTeams() {
+        return new TypedTQLFilterBuilder('team');
+    }
+    /**
+     * Creates a type-safe filter builder for AppointmentType entities.
+     * Provides autocomplete and type checking for AppointmentType attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forAppointmentTypes().filter('internal_name').eq('consultation')
+     * TQL.forAppointmentTypes().filter('duration_mins').gte(30)
+     * ```
+     */
+    static forAppointmentTypes() {
+        return new TypedTQLFilterBuilder('appointment_type');
+    }
+    /**
+     * Creates a type-safe filter builder for SchedulingRequest entities.
+     * Provides autocomplete and type checking for SchedulingRequest attributes.
+     *
+     * @example
+     * ```typescript
+     * TQL.forSchedulingRequests().filter('status').eq('scheduled')
+     * TQL.forSchedulingRequests().filter('end_user_email').like('@example.com')
+     * ```
+     */
+    static forSchedulingRequests() {
+        return new TypedTQLFilterBuilder('scheduling_request');
+    }
+}
+exports.TQL = TQL;
+exports.default = TQL;
+//# sourceMappingURL=tqlFilter.js.map

package/dist/utils/tqlFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tqlFilter.js","sourceRoot":"","sources":["../../src/utils/tqlFilter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "timezest",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "main": "index.js",
   "scripts": {
     "build": "tsc",

package/config/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";;;AAAA,4CAAkE;AAqClE;;GAEG;AACU,QAAA,MAAM,GAAsB;IACvC,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,sBAAa;IACrB,OAAO,EAAE,6BAA6B;IACtC,eAAe,EAAE,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,cAAc;IAChD,cAAc,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa;IACxC,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

package/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/utils/makePaginatedRequest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"makePaginatedRequest.js","sourceRoot":"","sources":["../../src/utils/makePaginatedRequest.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+CAA4C;AAC5C,+CAA4C;AAI5C;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,uCAMpB,EAAE,8EALhB,WAAwB,EACxB,QAAqB,EACrB,SAAyB,KAAK,EAC9B,OAAY,IAAI,EAChB,SAAwB,IAAI;IAE5B,MAAM,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC;IAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IAE7E,IAAI,OAAO,GAAU,EAAE,CAAC;IACxB,IAAI,QAAQ,GAAkB,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,GAAG,CAAC;YACF,GAAG,CAAC,OAAO,EAAE,iBAAiB,QAAQ,QAAQ,QAAQ,EAAE,CAAC,CAAC;YAC1D,MAAM,QAAQ,GACZ,MAAM,IAAA,yBAAW,EAIf,GAAG,EACH,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,kCACD,IAAI,KAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KACjC,cAAc,EACd,eAAe,CAChB,CAAC;YAEJ,GAAG,CAAC,MAAM,EAAE,QAAQ,QAAQ,6BAA6B,QAAQ,EAAE,CAAC,CAAC;YACrE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC;QAChC,CAAC,QAAQ,QAAQ,EAAE;QAEnB,GAAG,CAAC,MAAM,EAAE,wBAAwB,QAAQ,yBAAyB,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,GAAG,CACD,OAAO,EACP,wBAAwB,QAAQ,wBAAwB,KAAK,CAAC,OAAO,GAAG,CACzE,CAAC;QACF,IAAA,yBAAW,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAA,CAAC;AA/CW,QAAA,oBAAoB,wBA+C/B"}

package/utils/makeRequest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"makeRequest.js","sourceRoot":"","sources":["../../src/utils/makeRequest.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAkBA,kCA+DC;AAjFD,kDAA0B;AAC1B,+CAA4C;AAI5C;;;;;;;;;;;;GAYG;AACH,SAAsB,WAAW,CAC/B,GAA2D,EAC3D,MAAc,EACd,OAAe,EACf,QAAqB,EACrB,MAAsB,EACtB,IAAS,EACT,cAAsB,EACtB,eAAuB;;;QAEvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,gBAAgB,GAAG,cAAc,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,GAAG,CACD,OAAO,EACP,yBAAyB,QAAQ,kBAAkB,OAAO,EAAE,CAC7D,CAAC;gBACF,MAAM,QAAQ,GAAG,MAAM,IAAA,eAAK,EAAC;oBAC3B,GAAG,EAAE,GAAG,OAAO,GAAG,QAAQ,EAAE;oBAC5B,MAAM;oBACN,OAAO,EAAE;wBACP,aAAa,EAAE,UAAU,MAAM,EAAE;wBACjC,cAAc,EAAE,kBAAkB;qBACnC;oBACD,IAAI;iBACL,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,CAAA,MAAA,KAAK,CAAC,QAAQ,0CAAE,MAAM,MAAK,GAAG,EAAE,CAAC;oBACnC,MAAM,gBAAgB,GAAG,QAAQ,CAC/B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,EACrC,EAAE,CACH,CAAC;oBACF,MAAM,UAAU,GACd,gBAAgB,IAAI,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;oBAEtE,IAAI,gBAAgB,GAAG,UAAU,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC;wBAC3D,GAAG,CAAC,OAAO,EAAE,+BAA+B,QAAQ,EAAE,CAAC,CAAC;wBACxD,MAAM;oBACR,CAAC;oBAED,GAAG,CACD,MAAM,EACN,mBAAmB,QAAQ,oBAAoB,UAAU,aAAa,CACvE,CAAC;oBACF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;oBACvE,gBAAgB,IAAI,UAAU,GAAG,IAAI,CAAC;oBACtC,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,GAAG,CACD,OAAO,EACP,cAAc,QAAQ,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAC7D,CAAC;oBACF,IAAA,yBAAW,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CACb,qBAAqB,cAAc,yBAAyB,QAAQ,EAAE,CACvE,CAAC;IACJ,CAAC;CAAA"}