timezest 1.0.4 → 1.0.6

package/config/config.d.ts

@@ -0,0 +1,9 @@
+import { LogLevel, Logger } from "../utils/logger";
+export interface TimeZestAPIConfig {
+    logLevel: LogLevel;
+    logger: Logger;
+    baseUrl: string;
+    maxRetryDelayMs: number;
+    maxRetryTimeMs: number;
+}
+export declare const CONFIG: TimeZestAPIConfig;

package/config/config.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG = void 0;
+const logger_1 = require("../utils/logger");
+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
+};
+//# sourceMappingURL=config.js.map

package/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";;;AAAA,4CAAkE;AAUrD,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;CACzC,CAAC"}

package/constants/endpoints.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Defines the API endpoints used in the TimeZest application.
+ */
+export type apiEndpoints = {
+    /** Endpoint for managing resources. */
+    RESOURCES: apiEndpoint;
+    /** Endpoint for managing agents. */
+    AGENTS: apiEndpoint;
+    /** Endpoint for managing teams. */
+    TEAMS: apiEndpoint;
+    /** Endpoint for managing appointment types. */
+    APPOINTMENT_TYPES: apiEndpoint;
+    /** Endpoint for managing scheduling requests. */
+    SCHEDULING_REQUESTS: apiEndpoint;
+};
+export type BaseApiEndpoint = "/resources" | "/agents" | "/teams" | "/appointment_types" | "/scheduling_requests";
+export type apiEndpoint = BaseApiEndpoint | `${BaseApiEndpoint}/${string}`;
+export declare const API_ENDPOINTS: apiEndpoints;

package/constants/endpoints.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.API_ENDPOINTS = void 0;
+exports.API_ENDPOINTS = {
+    RESOURCES: "/resources",
+    AGENTS: "/agents",
+    TEAMS: "/teams",
+    APPOINTMENT_TYPES: "/appointment_types",
+    SCHEDULING_REQUESTS: "/scheduling_requests",
+};
+//# sourceMappingURL=endpoints.js.map

package/constants/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/constants/endpoints.ts"],"names":[],"mappings":";;;AA6Ba,QAAA,aAAa,GAAiB;IACzC,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;IACf,iBAAiB,EAAE,oBAAoB;IACvC,mBAAmB,EAAE,sBAAsB;CAC5C,CAAC"}

package/entities/entities.d.ts

@@ -0,0 +1,78 @@
+export interface Agent {
+    id: string;
+    object: string;
+    name: string;
+    email: string;
+    role: string;
+    schedulable: boolean;
+    two_factor_enabled: boolean;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}
+export interface AppointmentType {
+    id: string;
+    object: string;
+    internal_name: string;
+    external_name: string;
+    duration_mins: number;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}
+export interface Resource {
+    id: string;
+    object: string;
+    name: string;
+    email: string;
+    role: string;
+    schedulable: boolean;
+    two_factor_enabled: boolean;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}
+export interface SchedulingRequest {
+    id: string;
+    object: string;
+    appointment_type_id: string;
+    end_user_email: string;
+    end_user_name: string;
+    associated_entities: Array<{
+        type: string;
+        id: number;
+        number?: string;
+    }>;
+    resources: Array<{
+        type: string;
+        id: string;
+        name: string;
+    }>;
+    scheduled_agents: Array<unknown>;
+    scheduled_at: number;
+    scheduling_url: string;
+    selected_start_time: number;
+    selected_time_zone: string;
+    status: string;
+    created_at: number;
+    updated_at: number;
+}
+export interface SchedulingRequestPost {
+    appointment_type_id: string;
+    trigger_mode: string;
+    associated_entities: Array<{
+        type: string;
+        number: string;
+    }>;
+    resource_ids: string[];
+}
+export interface Team {
+    id: string;
+    object: string;
+    internal_name: string;
+    external_name: string;
+    team_type: string;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}

package/entities/entities.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=entities.js.map

package/entities/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/entities/entities.ts"],"names":[],"mappings":""}

package/entities/schemas.d.ts

@@ -0,0 +1,245 @@
+import { z } from "zod";
+export declare const AgentSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+    role: z.ZodString;
+    schedulable: z.ZodBoolean;
+    two_factor_enabled: z.ZodBoolean;
+    url_slug: z.ZodString;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    id: string;
+    name: string;
+    email: string;
+    role: string;
+    schedulable: boolean;
+    two_factor_enabled: boolean;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}, {
+    object: string;
+    id: string;
+    name: string;
+    email: string;
+    role: string;
+    schedulable: boolean;
+    two_factor_enabled: boolean;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}>;
+export declare const AppointmentTypeSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodString;
+    internal_name: z.ZodString;
+    external_name: z.ZodString;
+    duration_mins: z.ZodNumber;
+    url_slug: z.ZodString;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    id: string;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+    internal_name: string;
+    external_name: string;
+    duration_mins: number;
+}, {
+    object: string;
+    id: string;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+    internal_name: string;
+    external_name: string;
+    duration_mins: number;
+}>;
+export declare const ResourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+    role: z.ZodString;
+    schedulable: z.ZodBoolean;
+    two_factor_enabled: z.ZodBoolean;
+    url_slug: z.ZodString;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    id: string;
+    name: string;
+    email: string;
+    role: string;
+    schedulable: boolean;
+    two_factor_enabled: boolean;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}, {
+    object: string;
+    id: string;
+    name: string;
+    email: string;
+    role: string;
+    schedulable: boolean;
+    two_factor_enabled: boolean;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+}>;
+export declare const SchedulingRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodString;
+    appointment_type_id: z.ZodString;
+    end_user_email: z.ZodString;
+    end_user_name: z.ZodString;
+    associated_entities: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodNumber;
+        number: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        type: string;
+        number?: string | undefined;
+    }, {
+        id: number;
+        type: string;
+        number?: string | undefined;
+    }>, "many">;
+    resources: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        type: string;
+    }, {
+        id: string;
+        name: string;
+        type: string;
+    }>, "many">;
+    scheduled_agents: z.ZodArray<z.ZodUnknown, "many">;
+    scheduled_at: z.ZodNumber;
+    scheduling_url: z.ZodString;
+    selected_start_time: z.ZodNumber;
+    selected_time_zone: z.ZodString;
+    status: z.ZodString;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    id: string;
+    created_at: number;
+    updated_at: number;
+    status: string;
+    appointment_type_id: string;
+    end_user_email: string;
+    end_user_name: string;
+    associated_entities: {
+        id: number;
+        type: string;
+        number?: string | undefined;
+    }[];
+    resources: {
+        id: string;
+        name: string;
+        type: string;
+    }[];
+    scheduled_agents: unknown[];
+    scheduled_at: number;
+    scheduling_url: string;
+    selected_start_time: number;
+    selected_time_zone: string;
+}, {
+    object: string;
+    id: string;
+    created_at: number;
+    updated_at: number;
+    status: string;
+    appointment_type_id: string;
+    end_user_email: string;
+    end_user_name: string;
+    associated_entities: {
+        id: number;
+        type: string;
+        number?: string | undefined;
+    }[];
+    resources: {
+        id: string;
+        name: string;
+        type: string;
+    }[];
+    scheduled_agents: unknown[];
+    scheduled_at: number;
+    scheduling_url: string;
+    selected_start_time: number;
+    selected_time_zone: string;
+}>;
+export declare const SchedulingRequestPostSchema: z.ZodObject<{
+    appointment_type_id: z.ZodString;
+    trigger_mode: z.ZodString;
+    associated_entities: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        number: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        number: string;
+        type: string;
+    }, {
+        number: string;
+        type: string;
+    }>, "many">;
+    resource_ids: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    appointment_type_id: string;
+    associated_entities: {
+        number: string;
+        type: string;
+    }[];
+    trigger_mode: string;
+    resource_ids: string[];
+}, {
+    appointment_type_id: string;
+    associated_entities: {
+        number: string;
+        type: string;
+    }[];
+    trigger_mode: string;
+    resource_ids: string[];
+}>;
+export declare const TeamSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodString;
+    internal_name: z.ZodString;
+    external_name: z.ZodString;
+    team_type: z.ZodString;
+    url_slug: z.ZodString;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    id: string;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+    internal_name: string;
+    external_name: string;
+    team_type: string;
+}, {
+    object: string;
+    id: string;
+    url_slug: string;
+    created_at: number;
+    updated_at: number;
+    internal_name: string;
+    external_name: string;
+    team_type: string;
+}>;

package/entities/schemas.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamSchema = exports.SchedulingRequestPostSchema = exports.SchedulingRequestSchema = exports.ResourceSchema = exports.AppointmentTypeSchema = exports.AgentSchema = void 0;
+const zod_1 = require("zod");
+exports.AgentSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    object: zod_1.z.string(),
+    name: zod_1.z.string(),
+    email: zod_1.z.string(),
+    role: zod_1.z.string(),
+    schedulable: zod_1.z.boolean(),
+    two_factor_enabled: zod_1.z.boolean(),
+    url_slug: zod_1.z.string(),
+    created_at: zod_1.z.number(),
+    updated_at: zod_1.z.number(),
+});
+exports.AppointmentTypeSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    object: zod_1.z.string(),
+    internal_name: zod_1.z.string(),
+    external_name: zod_1.z.string(),
+    duration_mins: zod_1.z.number(),
+    url_slug: zod_1.z.string(),
+    created_at: zod_1.z.number(),
+    updated_at: zod_1.z.number(),
+});
+exports.ResourceSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    object: zod_1.z.string(),
+    name: zod_1.z.string(),
+    email: zod_1.z.string(),
+    role: zod_1.z.string(),
+    schedulable: zod_1.z.boolean(),
+    two_factor_enabled: zod_1.z.boolean(),
+    url_slug: zod_1.z.string(),
+    created_at: zod_1.z.number(),
+    updated_at: zod_1.z.number(),
+});
+exports.SchedulingRequestSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    object: zod_1.z.string(),
+    appointment_type_id: zod_1.z.string(),
+    end_user_email: zod_1.z.string(),
+    end_user_name: zod_1.z.string(),
+    associated_entities: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.string(),
+        id: zod_1.z.number(),
+        number: zod_1.z.string().optional(),
+    })),
+    resources: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.string(),
+        id: zod_1.z.string(),
+        name: zod_1.z.string(),
+    })),
+    scheduled_agents: zod_1.z.array(zod_1.z.unknown()),
+    scheduled_at: zod_1.z.number(),
+    scheduling_url: zod_1.z.string(),
+    selected_start_time: zod_1.z.number(),
+    selected_time_zone: zod_1.z.string(),
+    status: zod_1.z.string(),
+    created_at: zod_1.z.number(),
+    updated_at: zod_1.z.number(),
+});
+exports.SchedulingRequestPostSchema = zod_1.z.object({
+    appointment_type_id: zod_1.z.string(),
+    trigger_mode: zod_1.z.string(),
+    associated_entities: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.string(),
+        number: zod_1.z.string(),
+    })),
+    resource_ids: zod_1.z.array(zod_1.z.string()),
+});
+exports.TeamSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    object: zod_1.z.string(),
+    internal_name: zod_1.z.string(),
+    external_name: zod_1.z.string(),
+    team_type: zod_1.z.string(),
+    url_slug: zod_1.z.string(),
+    created_at: zod_1.z.number(),
+    updated_at: zod_1.z.number(),
+});
+//# sourceMappingURL=schemas.js.map

package/entities/schemas.js.map

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

package/index.d.ts

@@ -0,0 +1,89 @@
+import { log, LogLevel, Logger } from "./utils/logger";
+import { TimeZestAPIConfig } from "./config/config";
+import { Agent, Resource, AppointmentType, SchedulingRequest, Team } from "./entities/entities";
+/**
+ * Represents the main interface for the TimeZest API.
+ */
+export interface TimeZestAPI {
+    /**
+     * Logs a message with a specified log level.
+     * @param level - The log level (e.g., 'info', 'debug').
+     * @param message - The message to log.
+     * @param data - Optional additional data to log.
+     */
+    log: (level: LogLevel, message: string, data?: any) => void;
+    /**
+     * Retrieves a list of resources, optionally filtered by a query.
+     * @param filter - An optional filter string in TQL format
+     * @returns A promise that resolves to an array of resources.
+     */
+    getResources(filter?: string | null): Promise<Resource[]>;
+    /**
+     * Retrieves a list of agents, optionally filtered by a query.
+     * @param filter - An optional filter string in TQL format
+     * @returns A promise that resolves to an array of agents.
+     */
+    getAgents(filter?: string | null): Promise<Agent[]>;
+    /**
+     * Retrieves a list of teams, optionally filtered by a query.
+     * @param filter - An optional filter string in TQL format
+     * @returns A promise that resolves to an array of teams.
+     */
+    getTeams(filter?: string | null): Promise<Team[]>;
+    /**
+     * Retrieves a list of appointment types, optionally filtered by a query.
+     * @param filter - An optional filter string in TQL format
+     * @returns A promise that resolves to an array of appointment types.
+     */
+    getAppointmentTypes(filter?: string | null): Promise<AppointmentType[]>;
+    /**
+     * Retrieves a specific scheduling request by its ID.
+     * @param id - The ID of the scheduling request.
+     * @returns A promise that resolves to the scheduling request.
+     */
+    getSchedulingRequest(id: string): Promise<SchedulingRequest>;
+    /**
+     * Retrieves a list of scheduling requests, optionally filtered by a query.
+     * @param filter - An optional filter string in TQL format
+     * @returns A promise that resolves to an array of scheduling requests.
+     */
+    getSchedulingRequests(filter?: string | null): Promise<SchedulingRequest[]>;
+    /**
+     * Creates a new scheduling request.
+     * @param data - The data for the new scheduling request.
+     * @returns A promise that resolves to the created scheduling request.
+     */
+    createSchedulingRequest(data: SchedulingRequest): Promise<SchedulingRequest>;
+    /**
+     * Retrieves the API key.
+     * @returns The API key as a string.
+     */
+    getApiKey(): string;
+    /**
+     * Retrieves the configuration object.
+     * @returns The configuration object.
+     */
+    getConfig(): TimeZestAPIConfig;
+}
+/**
+ * Options for configuring the TimeZest API.
+ */
+export interface TimeZestAPIOptions {
+    /** The log level for the API (e.g., 'info', 'debug'). */
+    logLevel?: LogLevel;
+    /** A custom logger implementation. */
+    logger?: Logger;
+    /** The base URL for the API. */
+    baseUrl?: string;
+    /** The maximum delay between retries, in milliseconds. */
+    maxRetryDelayMs?: number;
+    /** The maximum total retry time, in milliseconds. */
+    maxRetryTimeMs?: number;
+}
+export declare class TimeZestAPI implements TimeZestAPI {
+    private config;
+    private apiKey;
+    log: log;
+    constructor(apiKey: string, options?: TimeZestAPIOptions);
+    getResources: (filter?: string | null) => Promise<Resource[]>;
+}

package/index.js.map

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

package/package.json

@@ -1,17 +1,14 @@
 {
   "name": "timezest",
-  "version": "1.0.4",
-  "main": "dist/index.js",
-  "files": [
-    "dist/index.js"
-  ],
+  "version": "1.0.6",
+  "main": "index.js",
   "scripts": {
     "build": "tsc",
     "test": "node dist/src/tests/test.js",
     "format": "prettier --write .",
     "clean": "if exist dist rmdir /s /q dist",
     "prep-publish": "npm run clean && npm run build && copy package.json dist\\package.json && copy README.md dist\\README.md && copy LICENSE dist\\LICENSE",
-    "publish": "npm run prep-publish && npm publish dist --access public"
+    "publish": "npm run prep-publish && npm publish .\\dist"
   },
   "keywords": [],
   "author": "",

package/utils/handleError.d.ts

@@ -0,0 +1,9 @@
+import { LogLevel } from "./logger";
+/**
+ * Handles errors from API requests.
+ * @param log - A logging function to log error details.
+ * @param error - The error object to handle.
+ * @returns An empty array if the error is a 404, otherwise throws an error.
+ */
+export type handleError = (log: (level: LogLevel, message: string, data?: any) => void, error: any) => void | [];
+export declare const handleError: handleError;

package/utils/handleError.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleError = void 0;
+const handleError = (log, error) => {
+    if (error.response) {
+        const { status, data } = error.response;
+        if (status === 404) {
+            log("warn", "Resource not found, returning an empty array.", {
+                status,
+                data,
+            });
+            return [];
+        }
+        log("error", `API Error: ${status} - ${data.message || "Unknown error"}`, data);
+        if (data.errors) {
+            log("error", "Details:", data.errors);
+        }
+        throw new Error(data.message || `HTTP ${status}`);
+    }
+    else if (error.request) {
+        log("error", "No response received from the API.", {
+            message: error.message,
+        });
+        throw new Error("No response received from the API");
+    }
+    else {
+        log("error", "Error setting up the request.", { message: error.message });
+        throw new Error("Error setting up the request");
+    }
+};
+exports.handleError = handleError;
+//# sourceMappingURL=handleError.js.map

package/utils/handleError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleError.js","sourceRoot":"","sources":["../../src/utils/handleError.ts"],"names":[],"mappings":";;;AAaO,MAAM,WAAW,GAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IACrD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QACxC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,GAAG,CAAC,MAAM,EAAE,+CAA+C,EAAE;gBAC3D,MAAM;gBACN,IAAI;aACL,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,GAAG,CACD,OAAO,EACP,cAAc,MAAM,MAAM,IAAI,CAAC,OAAO,IAAI,eAAe,EAAE,EAC3D,IAAI,CACL,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACzB,GAAG,CAAC,OAAO,EAAE,oCAAoC,EAAE;YACjD,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,OAAO,EAAE,+BAA+B,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC,CAAC;AA5BW,QAAA,WAAW,eA4BtB"}

package/utils/logger.d.ts

@@ -0,0 +1,20 @@
+export type log = {
+    (level: LogLevel, message: string, data?: any): void;
+};
+export interface Logger {
+    silent: (message: string, data?: any) => void;
+    error: (message: string, data?: any) => void;
+    warn: (message: string, data?: any) => void;
+    info: (message: string, data?: any) => void;
+    http: (message: string, data?: any) => void;
+    verbose: (message: string, data?: any) => void;
+    debug: (message: string, data?: any) => void;
+    silly: (message: string, data?: any) => void;
+}
+export type LogLevel = "silent" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+export declare const logLevelPriority: Record<LogLevel, number>;
+export declare const defaultLogger: Logger;
+export declare function buildLogger(logger: Logger, logLevel: LogLevel): (level: LogLevel, message: string, data?: any) => void;
+export declare function withLogging<T>(fn: (...args: any[]) => Promise<T>, instance: {
+    log: (level: LogLevel, message: string, data?: any) => void;
+}, functionName: string): (...args: any[]) => Promise<T>;

package/utils/logger.js

@@ -0,0 +1,62 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultLogger = exports.logLevelPriority = void 0;
+exports.buildLogger = buildLogger;
+exports.withLogging = withLogging;
+exports.logLevelPriority = {
+    silent: -1,
+    error: 0,
+    warn: 1,
+    info: 2,
+    http: 3,
+    verbose: 4,
+    debug: 5,
+    silly: 6,
+};
+exports.defaultLogger = {
+    silent: (_message, _data) => { },
+    error: (message, data) => data ? console.error(message, data) : console.error(message),
+    warn: (message, data) => data ? console.warn(message, data) : console.warn(message),
+    info: (message, data) => data ? console.info(message, data) : console.info,
+    http: (message, data) => data ? console.log(message, data) : console.log(message),
+    verbose: (message, data) => data ? console.debug(message, data) : console.debug(message),
+    debug: (message, data) => data ? console.debug(message, data) : console.debug(message),
+    silly: (message, data) => data ? console.debug(message, data) : console.debug(message),
+};
+function buildLogger(logger, logLevel) {
+    return (level, message, data) => {
+        if (exports.logLevelPriority[level] <= exports.logLevelPriority[logLevel]) {
+            logger[level](message, data);
+        }
+    };
+}
+function withLogging(fn, instance, functionName) {
+    return (...args) => __awaiter(this, void 0, void 0, function* () {
+        instance.log("debug", `Entering ${functionName}`);
+        args ? instance.log("silly", `Entering ${functionName}`, { args }) : null;
+        try {
+            const result = yield fn(...args);
+            instance.log("debug", `Exiting ${functionName} successfully`);
+            result
+                ? instance.log("silly", `Exiting ${functionName} successfully`, {
+                    result,
+                })
+                : null;
+            return result;
+        }
+        catch (error) {
+            instance.log("error", `Error in ${functionName}`, { error });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=logger.js.map

package/utils/logger.js.map

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

package/utils/makePaginatedRequest.d.ts

@@ -0,0 +1,13 @@
+import { apiEndpoint } from "../constants/endpoints";
+import { TimeZestAPI } from "../index";
+/**
+ * Makes a paginated API request.
+ * @template T - The type of the response data.
+ * @param apiInstance - The instance of the TimeZestAPI.
+ * @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.
+ * @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[]>;

package/utils/makePaginatedRequest.js

@@ -0,0 +1,49 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makePaginatedRequest = void 0;
+const makeRequest_1 = require("./makeRequest");
+const handleError_1 = require("./handleError");
+/**
+ * Makes a paginated API request.
+ * @template T - The type of the response data.
+ * @param apiInstance - The instance of the TimeZestAPI.
+ * @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.
+ * @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) {
+    const { log } = apiInstance;
+    const apiKey = apiInstance.getApiKey();
+    const { baseUrl, maxRetryTimeMs, maxRetryDelayMs } = apiInstance.getConfig();
+    let results = [];
+    let nextPage = 1;
+    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);
+            log("http", `Page ${nextPage} fetched successfully for ${endpoint}`);
+            results = results.concat(response.data);
+            nextPage = response.next_page;
+        } while (nextPage);
+        log("http", `Paginated request to ${endpoint} completed successfully`);
+        return results;
+    }
+    catch (error) {
+        log("error", `Paginated request to ${endpoint} failed with error: '${error.message}'`);
+        (0, handleError_1.handleError)(log, error);
+    }
+    return results;
+});
+exports.makePaginatedRequest = makePaginatedRequest;
+//# sourceMappingURL=makePaginatedRequest.js.map

package/utils/makePaginatedRequest.js.map

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,16 @@
+import { apiEndpoint } from "../constants/endpoints";
+import { LogLevel } from "./logger";
+/**
+ * Makes an API request with retry logic.
+ * @template T - The type of the response data.
+ * @param log - A logging function to log request details.
+ * @param apiKey - The API key for authentication.
+ * @param baseUrl - The base URL of the API.
+ * @param endpoint - The API endpoint to call.
+ * @param method - The HTTP method (GET or POST).
+ * @param data - The request payload.
+ * @param maxRetryTimeMs - The maximum retry time in milliseconds.
+ * @param maxRetryDelayMs - The maximum delay between retries in milliseconds.
+ * @returns A promise that resolves to the response data.
+ */
+export declare function makeRequest<T>(log: (level: LogLevel, message: string, data?: any) => void, apiKey: string, baseUrl: string, endpoint: apiEndpoint, method: "GET" | "POST", data: any, maxRetryTimeMs: number, maxRetryDelayMs: number): Promise<T>;

package/utils/makeRequest.js

@@ -0,0 +1,73 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeRequest = makeRequest;
+const axios_1 = __importDefault(require("axios"));
+const handleError_1 = require("./handleError");
+/**
+ * Makes an API request with retry logic.
+ * @template T - The type of the response data.
+ * @param log - A logging function to log request details.
+ * @param apiKey - The API key for authentication.
+ * @param baseUrl - The base URL of the API.
+ * @param endpoint - The API endpoint to call.
+ * @param method - The HTTP method (GET or POST).
+ * @param data - The request payload.
+ * @param maxRetryTimeMs - The maximum retry time in milliseconds.
+ * @param maxRetryDelayMs - The maximum delay between retries in milliseconds.
+ * @returns A promise that resolves to the response data.
+ */
+function makeRequest(log, apiKey, baseUrl, endpoint, method, data, maxRetryTimeMs, maxRetryDelayMs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        let totalElapsedTime = 0;
+        let retries = 0;
+        while (totalElapsedTime < maxRetryTimeMs) {
+            try {
+                log("debug", `Attempting request to ${endpoint}. Retry count: ${retries}`);
+                const response = yield (0, axios_1.default)({
+                    url: `${baseUrl}${endpoint}`,
+                    method,
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    data,
+                });
+                return response.data;
+            }
+            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) {
+                        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;
+                    retries++;
+                }
+                else {
+                    log("error", `Request to ${endpoint} failed with error: ${error.message}`);
+                    (0, handleError_1.handleError)(log, error);
+                }
+            }
+        }
+        throw new Error(`Max retry time of ${maxRetryTimeMs} minutes exceeded for ${endpoint}`);
+    });
+}
+;
+//# sourceMappingURL=makeRequest.js.map

package/utils/makeRequest.js.map

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