@jphil/bookwhen-client 0.0.10 → 0.1.1

package/dist/request/BookwhenRequest.unit.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { BookwhenRequest } from './BookwhenRequest.js';
+describe('BookwhenRequest', () => {
+    const testpath = "path";
+    describe('path handling', () => {
+        it('should return a /"path" when called with "path"', () => {
+            const request = new BookwhenRequest(testpath);
+            expect(request.toString()).toBe('/' + testpath);
+        });
+        it('should throw an error if the path is empty', () => {
+            expect(() => new BookwhenRequest('')).toThrow('Path is required');
+        });
+        it('should throw an error if the path is undefined', () => {
+            expect(() => new BookwhenRequest(undefined)).toThrow('Path is required');
+        });
+    });
+    describe('addIncludes', () => {
+        it('should return the given path with an empty string when no resources are provided', () => {
+            const resources = [];
+            const query = new BookwhenRequest(testpath);
+            query.addIncludes(resources);
+            expect(query.toString()).toEqual('/' + testpath);
+        });
+        it('should return a query string with a single resource', () => {
+            const resources = ['resource1'];
+            const query = new BookwhenRequest(testpath);
+            query.addIncludes(resources);
+            expect(query.toString()).toEqual('/' + testpath + '?include=resource1');
+        });
+        it('should return a query string with multiple resources separated by commas', () => {
+            const resources = ['resource1', 'resource2', 'resource3'];
+            const query = new BookwhenRequest(testpath);
+            query.addIncludes(resources);
+            expect(query.toString()).toEqual('/' + testpath + '?include=resource1,resource2,resource3');
+        });
+    });
+    describe('addFilters', () => {
+        it('should return a query with no filters, if an empty filters array is given', () => {
+            const filters = {};
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath);
+        });
+        it('should return a query string with a single filter', () => {
+            const filters = { 'key': "value" };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key]=value');
+        });
+        it('should return a query string with a single filter and multiple values', () => {
+            const filters = { 'key': ['value one', 'value two'] };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key]=value%20one,value%20two');
+        });
+        it('should return a query string with multiple filters where values are strings', () => {
+            const filters = {
+                title: 'advanced',
+                detail: 'masterclass',
+            };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[title]=advanced&filter[detail]=masterclass');
+        });
+        it('should return a query string with multiple filters where values are arrays of strings', () => {
+            const filters = {
+                title: ['title1', 'title2'],
+                detail: ['detail1', 'detail2', 'detail3'],
+            };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[title]=title1,title2&filter[detail]=detail1,detail2,detail3');
+        });
+        it('should ignore empty string filter values', () => {
+            const filters = { key: '', key2: 'value' };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key2]=value');
+        });
+        it('should ignore undefined filter values', () => {
+            const filters = { key: undefined, key2: 'value' };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key2]=value');
+        });
+        it('should ignore null filter values', () => {
+            const filters = { key: null, key2: 'value' };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key2]=value');
+        });
+        it('should ignore an "empty array" filter value', () => {
+            const filters = { key: [] };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath);
+        });
+        it('should ignore empty string elements, where a filter value is an array', () => {
+            const filters = { key: ['', 'value'] };
+            const query = new BookwhenRequest(testpath);
+            expect(query.toString()).toEqual('/' + testpath);
+        });
+        it('should ignore undefined array elements, where a filter value is an array', () => {
+            const filters = { key: [undefined, 'value'], key2: 'value2' };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key]=value&filter[key2]=value2');
+        });
+        it('should ignore null array elements, where a filter value is an array', () => {
+            const filters = { key: [null, 'value'], key2: 'value2' };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key]=value&filter[key2]=value2');
+        });
+        it('should return a query string with a single filter when value is an array with a single value', () => {
+            const filters = { key: ['value'] };
+            const query = new BookwhenRequest(testpath);
+            query.addFilters(filters);
+            expect(query.toString()).toEqual('/' + testpath + '?filter[key]=value');
+        });
+        it('should build a URL query string from the provided parameters, skipping invalid value types', () => {
+            const params = {
+                key1: 'value1',
+                key2: ['value2', null, 'value3', ''],
+                key3: undefined,
+                key4: ['key3skipped', undefined, '123'],
+                key5: "1234",
+                key6: null,
+                key7: undefined,
+                key8: [],
+                key9: 'undefined',
+            };
+            const expectedFilterString = '/path?filter[key1]=value1&filter[key2]=value2,value3&filter[key4]=key3skipped,123&filter[key5]=1234&filter[key9]=undefined';
+            const query = new BookwhenRequest(testpath);
+            // @ts-ignore
+            query.addFilters(params);
+            expect(query.toString()).toEqual(expectedFilterString);
+        });
+    });
+});
+//# sourceMappingURL=BookwhenRequest.unit.test.js.map

package/dist/request/BookwhenRequest.unit.test.js.map

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

package/dist/request/httpStatusCodes.d.ts

@@ -0,0 +1,3 @@
+import type { HttpStatus } from '../types/GlobalTypes.js';
+export declare const CLIENT_HTTP_STATUS_CODES: Record<number, HttpStatus>;
+export declare const SERVICE_HTTP_STATUS_CODES: Record<number, HttpStatus>;

package/dist/request/httpStatusCodes.js

@@ -0,0 +1,15 @@
+export const CLIENT_HTTP_STATUS_CODES = {
+    400: { code: 400, message: 'BookwhenClient: Bad request' },
+    401: { code: 401, message: 'BookwhenClient: Unauthorized - check your API key' },
+    403: { code: 403, message: 'BookwhenClient: Forbidden - check your permissions' },
+    500: { code: 500, message: 'BookwhenClient: Internal server error' },
+    502: { code: 502, message: 'BookwhenClient: Bad gateway' },
+    503: { code: 503, message: 'BookwhenClient: Service unavailable' },
+    504: { code: 504, message: 'BookwhenClient: Gateway timeout' },
+};
+export const SERVICE_HTTP_STATUS_CODES = {
+    400: { code: 400, message: 'BookwhenClient: Bad request' },
+    404: { code: 404, message: 'BookwhenClient: The requested resource could not be found' },
+    429: { code: 429, message: 'BookwhenClient: Rate limit exceeded' },
+};
+//# sourceMappingURL=httpStatusCodes.js.map

package/dist/request/httpStatusCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpStatusCodes.js","sourceRoot":"","sources":["../../src/request/httpStatusCodes.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAA+B;IAClE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,6BAA6B,EAAE;IAC1D,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,mDAAmD,EAAE;IAChF,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACjF,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,uCAAuC,EAAE;IACpE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,6BAA6B,EAAE;IAC1D,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,qCAAqC,EAAE;IAClE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,iCAAiC,EAAE;CAC/D,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAA+B;IACnE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,6BAA6B,EAAE;IAC1D,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,2DAA2D,EAAE;IACxF,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,qCAAqC,EAAE;CACnE,CAAC"}

package/dist/services/event/Event.d.ts

@@ -0,0 +1,32 @@
+import type { IEventService, GetMultipleEventsParams } from './EventInterfaces.js';
+import type { BookwhenEvent } from './EventTypes.js';
+import type { AxiosInstance } from 'axios';
+import { GetEventByIdParamsSchema } from './EventSchemas.js';
+import { z } from 'zod';
+/**
+ * Service class for managing events in the Bookwhen API.
+ */
+export declare class EventService implements IEventService {
+    private axiosInstance;
+    /**
+     * Initializes EventService with an Axios instance for dependency injection.
+     * @param axiosInstance - The Axios instance to use for API requests.
+     */
+    constructor(axiosInstance: AxiosInstance);
+    /**
+     * Retrieves a single event by its ID from the Bookwhen API.
+     *
+     * @param {Object} param - The parameters for retrieving an event.
+     * @param {string} param.eventId - The ID of the event to retrieve.
+     * @param {string} [param.include] - Optional parameter to include additional data.
+     * @returns {Promise<BookwhenEvent>} A Promise that resolves to the BookwhenEvent object.
+     */
+    getById(params: z.infer<typeof GetEventByIdParamsSchema>): Promise<BookwhenEvent>;
+    /**
+     * Retrieves multiple events based on filtering and pagination parameters.
+     *
+     * @param {GetMultipleEventsParams} params - Optional parameters for filtering and pagination.
+     * @return {Promise<BookwhenEvent[]>} A Promise that resolves to an array of BookwhenEvent objects.
+     */
+    getMultiple(params?: GetMultipleEventsParams): Promise<BookwhenEvent[]>;
+}

package/dist/services/event/Event.js

@@ -0,0 +1,72 @@
+import { handleServiceHTTPErrors } from '../../utils/http-utils.js';
+import { SERVICE_HTTP_STATUS_CODES } from '../../request/httpStatusCodes.js';
+import { BookwhenRequest } from '../../request/BookwhenRequest.js';
+import { GetEventByIdParamsSchema } from './EventSchemas.js';
+import { z } from 'zod';
+/**
+ * Service class for managing events in the Bookwhen API.
+ */
+export class EventService {
+    axiosInstance;
+    /**
+     * Initializes EventService with an Axios instance for dependency injection.
+     * @param axiosInstance - The Axios instance to use for API requests.
+     */
+    constructor(axiosInstance) {
+        this.axiosInstance = axiosInstance;
+    }
+    /**
+     * Retrieves a single event by its ID from the Bookwhen API.
+     *
+     * @param {Object} param - The parameters for retrieving an event.
+     * @param {string} param.eventId - The ID of the event to retrieve.
+     * @param {string} [param.include] - Optional parameter to include additional data.
+     * @returns {Promise<BookwhenEvent>} A Promise that resolves to the BookwhenEvent object.
+     */
+    async getById(params) {
+        try {
+            const validParams = GetEventByIdParamsSchema.parse(params);
+            const query = new BookwhenRequest(`/events/${validParams.eventId}`);
+            if (validParams.includes) {
+                query.addIncludes(validParams.includes);
+            }
+            const response = await this.axiosInstance.get(`${query}`);
+            return response.data?.data;
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const errorMessages = error.errors.map(e => e.message).join(', ');
+                throw new Error(`events.getById: Schema Validation failed: ${errorMessages}`);
+            }
+            else {
+                handleServiceHTTPErrors(error, SERVICE_HTTP_STATUS_CODES, {
+                    404: {
+                        code: 404,
+                        message: 'Event not found. Please check the event ID and try again.',
+                    },
+                });
+            }
+        }
+    }
+    /**
+     * Retrieves multiple events based on filtering and pagination parameters.
+     *
+     * @param {GetMultipleEventsParams} params - Optional parameters for filtering and pagination.
+     * @return {Promise<BookwhenEvent[]>} A Promise that resolves to an array of BookwhenEvent objects.
+     */
+    async getMultiple(params = {}) {
+        try {
+            const query = new BookwhenRequest('/events');
+            if (params.includes)
+                query.addIncludes(params.includes);
+            if (params.filters)
+                query.addFilters(params.filters);
+            const response = await this.axiosInstance.get(`${query}`); // uses the toString method
+            return response.data.data;
+        }
+        catch (error) {
+            handleServiceHTTPErrors(error, SERVICE_HTTP_STATUS_CODES);
+        }
+    }
+}
+//# sourceMappingURL=Event.js.map

package/dist/services/event/Event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Event.js","sourceRoot":"","sources":["../../../src/services/event/Event.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,OAAO,YAAY;IAEf,aAAa,CAAgB;IAErC;;;OAGG;IACH,YAAY,aAA4B;QACtC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,MAAgD;QAC5D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAE3D,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,WAAW,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;gBACzB,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAgB,GAAG,KAAK,EAAE,CAAC,CAAC;YACzE,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClE,MAAM,IAAI,KAAK,CAAC,6CAA6C,aAAa,EAAE,CAAC,CAAC;YAChF,CAAC;iBAAM,CAAC;gBACN,uBAAuB,CAAC,KAAK,EAAE,yBAAyB,EAAE;oBACxD,GAAG,EAAE;wBACH,IAAI,EAAE,GAAG;wBACT,OAAO,EAAE,2DAA2D;qBACrE;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,SAAkC,EAAE;QACpD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,QAAQ;gBAAE,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxD,IAAI,MAAM,CAAC,OAAO;gBAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAErD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAiB,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,2BAA2B;YACtG,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uBAAuB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}

package/dist/services/event/Event.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/event/Event.unit.test.js

@@ -0,0 +1,104 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import axios from 'axios';
+import { EventService } from './Event.js';
+describe('EventService', () => {
+    let eventService;
+    let mockAxiosInstance;
+    beforeEach(() => {
+        // Create a mock instance of axios for dependency injection
+        mockAxiosInstance = axios.create();
+        eventService = new EventService(mockAxiosInstance); // Inject mock axios instance
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should retrieve a single event by ID', async () => {
+        const eventId = '123';
+        const eventData = {
+            id: eventId,
+        };
+        // Mock Axios request using vi.spyOn
+        mockAxiosInstance.get = vi.fn().mockResolvedValue({ data: { data: eventData } });
+        const result = await eventService.getById({ eventId });
+        expect(mockAxiosInstance.get).toHaveBeenCalledWith(`/events/${eventId}`);
+        expect(result).toEqual(eventData);
+    });
+    it('should handle error when retrieving a single event by ID', async () => {
+        const eventId = '123';
+        const errorMessage = 'Event not found. Please check the event ID and try again.';
+        // Mock Axios request using vi.spyOn
+        vi.spyOn(mockAxiosInstance, 'get').mockRejectedValue({
+            response: {
+                status: 404,
+                data: { message: errorMessage }
+            }
+        });
+        expect(eventService.getById({ eventId })).rejects.toThrow(errorMessage);
+    });
+    it('should handle error when retrieving multiple events', async () => {
+        const errorMessage = 'BookwhenClient: The requested resource could not be found';
+        // Mock Axios request using vi.spyOn
+        vi.spyOn(mockAxiosInstance, 'get').mockRejectedValue({
+            response: {
+                status: 404,
+                data: { message: errorMessage }
+            }
+        });
+        expect(eventService.getMultiple()).rejects.toThrow(errorMessage);
+        expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events');
+    });
+    it('should retrieve multiple events', async () => {
+        const eventsData = [
+            { id: '1', type: 'event' },
+            { id: '2', type: 'event' },
+        ];
+        // Mock Axios request using vi.spyOn
+        vi.spyOn(mockAxiosInstance, 'get').mockResolvedValue({ data: { data: eventsData } });
+        const result = await eventService.getMultiple();
+        expect(result).toEqual(eventsData);
+    });
+    it('should retrieve multiple events with filters', async () => {
+        const filters = {
+            title: ['Test Event'],
+            from: 'test',
+            detail: ['Event Details'],
+        };
+        const eventsData = [
+            { id: '1', type: 'event' },
+            { id: '2', type: 'event' },
+        ];
+        // Mock Axios request using vi.spyOn
+        vi.spyOn(mockAxiosInstance, 'get').mockResolvedValue({ data: { data: eventsData } });
+        const result = await eventService.getMultiple({ filters });
+        expect(result).toEqual(eventsData);
+        expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events?filter[title]=Test%20Event&filter[from]=test&filter[detail]=Event%20Details');
+    });
+    it('should retrieve multiple events with includes', async () => {
+        const includes = ['location', 'attachments'];
+        const eventsData = [
+            { id: '1', type: 'event' },
+            { id: '2', type: 'event' },
+        ];
+        // Mock Axios request using vi.spyOn
+        vi.spyOn(mockAxiosInstance, 'get').mockResolvedValue({ data: { data: eventsData } });
+        const result = await eventService.getMultiple({ includes });
+        expect(result).toEqual(eventsData);
+        expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events?include=location,attachments');
+    });
+    it('should retrieve multiple events with includes and filters', async () => {
+        const includes = ['location', 'tickets'];
+        const filters = {
+            title: ['Workshop'],
+            start_at: ['2023-01-01']
+        };
+        const eventsData = [
+            { id: '1', type: 'event' },
+            { id: '2', type: 'event' },
+        ];
+        vi.spyOn(mockAxiosInstance, 'get').mockResolvedValue({ data: { data: eventsData } });
+        const result = await eventService.getMultiple({ filters, includes });
+        expect(result).toEqual(eventsData);
+        expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events?filter[title]=Workshop&filter[start_at]=2023-01-01&include=location,tickets');
+    });
+});
+//# sourceMappingURL=Event.unit.test.js.map

package/dist/services/event/Event.unit.test.js.map

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

package/dist/services/event/EventInterfaces.d.ts

@@ -0,0 +1,53 @@
+import type { BookwhenEvent } from './EventTypes.js';
+/**
+ * Interface for services handling events via the Bookwhen API V2.
+ */
+export interface IEventService {
+    /**
+     * Retrieves a single event by its ID.
+     * @param eventId The unique identifier of the event.
+     * @param include Optional parameter to include additional data.
+     * @returns A Promise that resolves to an Event object, as defined by the Bookwhen API data structure.
+     */
+    getById(params: GetEventByIdParams): Promise<BookwhenEvent>;
+    /**
+     * Retrieves multiple events based on specified parameters.
+     * @param params Optional parameters to filter and control the list of returned events, according to what the Bookwhen API supports.
+     * @returns A Promise that resolves to an array of Event objects.
+     */
+    getMultiple?(params?: GetMultipleEventsParams): Promise<BookwhenEvent[]>;
+}
+/**
+ * Parameters for querying a single event from the Bookwhen API, including optional include parameter.
+ * @param eventId The unique identifier of the event.
+ * @param include Optional parameter to include additional data.
+ */
+export interface GetEventByIdParams {
+    eventId: string;
+    includes?: EventResource[];
+}
+/**
+ * Represents the parameters for getting multiple events.
+ * @param filter The filter parameters to apply to the query.
+ * @param include The data to side load and include with the returned events.
+ */
+export interface GetMultipleEventsParams {
+    filters?: EventFilters;
+    includes?: EventResource[];
+}
+interface EventFiltersMap {
+    calendar?: string[];
+    entry?: string[];
+    location?: string[];
+    tag?: string[];
+    title?: string[];
+    detail?: string[];
+    from?: string;
+    to?: string;
+    compact?: boolean;
+}
+export type EventFilters = {
+    [K in keyof EventFiltersMap]?: EventFiltersMap[K];
+};
+export type EventResource = 'location' | 'attachments' | 'tickets' | 'tickets.events' | 'tickets.class_passes';
+export {};

package/dist/services/event/EventInterfaces.js

@@ -0,0 +1,3 @@
+;
+export {};
+//# sourceMappingURL=EventInterfaces.js.map

package/dist/services/event/EventInterfaces.js.map

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

package/dist/services/event/EventSchemas.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const EventResourceSchema: z.ZodEnum<["location", "attachments", "tickets", "tickets.events", "tickets.class_passes"]>;
+export declare const GetEventByIdParamsSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    includes: z.ZodOptional<z.ZodArray<z.ZodEnum<["location", "attachments", "tickets", "tickets.events", "tickets.class_passes"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    eventId: string;
+    includes?: ("location" | "attachments" | "tickets" | "tickets.events" | "tickets.class_passes")[] | undefined;
+}, {
+    eventId: string;
+    includes?: ("location" | "attachments" | "tickets" | "tickets.events" | "tickets.class_passes")[] | undefined;
+}>;

package/dist/services/event/EventSchemas.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export const EventResourceSchema = z.enum(['location', 'attachments', 'tickets', 'tickets.events', 'tickets.class_passes']);
+// Define GetEventByIdParams schema
+export const GetEventByIdParamsSchema = z.object({
+    eventId: z.string().min(1, 'Invalid event ID'),
+    includes: EventResourceSchema.array().optional(),
+});
+//# sourceMappingURL=EventSchemas.js.map

package/dist/services/event/EventSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventSchemas.js","sourceRoot":"","sources":["../../../src/services/event/EventSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAE5H,mCAAmC;AACnC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,EAAE,mBAAmB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC"}

package/dist/services/event/EventTypes.d.ts

@@ -0,0 +1,36 @@
+export interface EventImage {
+    image_url: string;
+    alt_ratio_16x9_1x_url: string;
+    alt_ratio_16x9_2x_url: string;
+    alt_ratio_16x9_3x_url: string;
+    alt_ratio_4x3_1x_url: string;
+    alt_ratio_4x3_2x_url: string;
+    alt_ratio_4x3_3x_url: string;
+    alt_ratio_1x1_1x_url: string;
+    alt_ratio_1x1_2x_url: string;
+    alt_ratio_1x1_3x_url: string;
+}
+export interface EventAttributes {
+    title: string;
+    details: string;
+    all_day: boolean;
+    start_at: string;
+    end_at: string;
+    attendee_limit: number;
+    attendee_count: number;
+    waiting_list: boolean;
+    max_tickets_per_booking: number;
+    tags: string[];
+    event_image: EventImage;
+}
+export interface BookwhenEvent {
+    id: string;
+    type: string;
+    attributes: EventAttributes;
+}
+export interface EventsResponse {
+    data: BookwhenEvent[];
+}
+export interface EventResponse {
+    data: BookwhenEvent;
+}

package/dist/services/event/EventTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EventTypes.js.map

package/dist/services/event/EventTypes.js.map

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

package/dist/types/GlobalTypes.d.ts

@@ -0,0 +1,9 @@
+export interface HttpStatus {
+    code: number;
+    message: string;
+}
+export type Resource = string;
+export type Resources = Resource[];
+export interface Filters {
+    [key: string]: string | string[] | boolean;
+}

package/dist/types/GlobalTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GlobalTypes.js.map

package/dist/types/GlobalTypes.js.map

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

package/dist/utils/http-utils.d.ts

@@ -0,0 +1,8 @@
+import type { HttpStatus } from '../types/GlobalTypes.js';
+/**
+ * Handles errors for service methods
+ * @param error The error object caught in service methods.
+ * @param statusCodes General service-level status codes and messages.
+ * @param methodErrors Optional method-specific error messages.
+ */
+export declare function handleServiceHTTPErrors(error: any, statusCodes: Record<number, HttpStatus>, methodErrors?: Record<number, HttpStatus>): never;

package/dist/utils/http-utils.js

@@ -0,0 +1,19 @@
+/**
+ * Handles errors for service methods
+ * @param error The error object caught in service methods.
+ * @param statusCodes General service-level status codes and messages.
+ * @param methodErrors Optional method-specific error messages.
+ */
+export function handleServiceHTTPErrors(error, statusCodes, methodErrors = {}) {
+    if (error.response) {
+        const status = error.response.status;
+        // First, check for method-specific errors, then fall back to general service errors
+        const errorMessage = methodErrors[status]?.message || statusCodes[status]?.message || `Unhandled service error with status code: ${status}`;
+        throw new Error(errorMessage);
+    }
+    else {
+        // If no response was received, this is likely a serious client or network issue
+        throw new Error("An unexpected network or client error occurred, with no response property.");
+    }
+}
+//# sourceMappingURL=http-utils.js.map

package/dist/utils/http-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-utils.js","sourceRoot":"","sources":["../../src/utils/http-utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAU,EAAE,WAAuC,EAAE,eAA2C,EAAE;IACxI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrC,oFAAoF;QACpF,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,IAAI,6CAA6C,MAAM,EAAE,CAAC;QAC5I,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACJ,gFAAgF;QAChF,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}