@jphil/bookwhen-client 0.0.9 → 0.1.0

package/README.md

@@ -21,8 +21,8 @@ You'll likely be at least somewhat familiar with the [Bookwhen](www.bookwhen.com
 
 ## Features
 
-- Lightweight and easy to integrate
-- Fully typed for TypeScript support
+- Provides an easy way to pull your data from Bookwhen for NodeJS environments
+- Provides fully typed methods for each model (so far just the events model) in the Bookwhen API v2
 
 ## Installation
 
@@ -34,10 +34,18 @@ pnpm add @jphil/bookwhen-client
 
 ## Usage
 
-\[wip\]!
+!N.B. this usage structure may change as I progress towards a 1.0.0
 
 ```typescript
-// ... todo
+import { createBookwhenClient } from 'bookwhen-client';
+
+const client = createBookwhenClient(YOUR_API_KEY)
+const event = client.event.getByID({myEventId});
+const events = client.event.getMultiple({
+  filters: ["filter1", "filter2"]
+  includes: ["inc1", "inc2"]
+});
+
 ```
 
 ## Configuration
@@ -56,9 +64,15 @@ Please see the docs in the CONTRIBUTIONS.md file, thanks!
 
 ## Roadmap
 
-- Keep up with any future changes or additions to the [Bookwhen API](https://api.bookwhen.com/v2).
+- Keep up with any future changes or additions to the [Bookwhen API](https://api.bookwhen.com/v2), additions will be driven mainly by this.
+- Possibly add a "fields" param to service methods to allow response filtering
+
+- Todos
+[] - put Zod in place in more areas to strengthen runtime type guards
+[] - refine error handling
+[] - write more integration tests
+[] - write services for the other integrations
 
 ## License
 
 ISC License. See [LICENSE](LICENSE) for more information.
-

package/dist/client/BookwhenClient.d.ts

@@ -0,0 +1,38 @@
+import type { AxiosInstance } from 'axios';
+import { EventService } from '../services/event/Event.js';
+/**
+ * Client for the Bookwhen API.
+ *
+ * @see https://petstore.swagger.io/?url=https://api.bookwhen.com/v2/openapi.yaml#/ClassPass/get_class_passes__class_pass_id_
+ */
+export declare class BookwhenClient {
+    private axiosInstance;
+    private eventService?;
+    /**
+     * Creates a new instance of the BookwhenClient class.
+     * @param axiosInstance - Configured Axios instance for making HTTP requests.
+     * @throws Error if axiosInstance is not provided.
+     */
+    constructor(axiosInstance: AxiosInstance);
+    /**
+     * Gets the EventService instance.
+     *
+     * Available methods:
+     * - getById(params: GetEventByIdParams): Promise<BookwhenEvent>
+     * - getMultiple(params: GetMultipleEventsParams): Promise<BookwhenEvent[]>
+     *
+     * @returns The EventService instance.
+     */
+    get events(): EventService;
+}
+interface BookwhenClientOptions {
+    apiKey: string;
+    baseURL?: string;
+}
+/**
+ * Creates an instance of Axios with the provided API key.
+ * @param apiKey - The API key used for authentication.
+ * @returns The Axios instance.
+ */
+export declare function createBookwhenClient(options: BookwhenClientOptions): BookwhenClient;
+export {};

package/dist/client/BookwhenClient.integration.test.d.ts

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

package/dist/client/BookwhenClient.integration.test.js

@@ -0,0 +1,78 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { BookwhenClient } from './BookwhenClient.js';
+import { EventService } from '../services/event/Event.js';
+vi.mock('axios');
+vi.mock('../src/services/event/Event');
+describe('BookwhenClient Integration', () => {
+    describe('BookwhenClient - Events Service', () => {
+        it('should call the correct endpoint when getById is called', async () => {
+            const mockAxiosInstance = {
+                get: vi.fn().mockResolvedValue({
+                    data: {
+                        data: { id: 'event123' }
+                    }
+                }),
+            };
+            const client = new BookwhenClient(mockAxiosInstance);
+            const eventId = 'event123';
+            const event = await client.events.getById({ eventId });
+            expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events/event123');
+            expect(event).toEqual({ id: 'event123' });
+        });
+        it('should call the correct endpoint with correct parameters when events.getMultiple is called', async () => {
+            const mockAxiosInstance = {
+                get: vi.fn().mockResolvedValue({
+                    data: {
+                        data: [{ id: 'event1' }, { id: 'event2' }],
+                    },
+                }),
+            };
+            const client = new BookwhenClient(mockAxiosInstance);
+            const includes = ['location', 'tickets'];
+            const filters = {
+                title: ['Workshop'],
+                start_at: ['2023-01-01']
+            };
+            const eventsData = [
+                { id: '1', type: 'event' },
+                { id: '2', type: 'event' },
+            ];
+            const events = await client.events.getMultiple({ includes, filters });
+            expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events?filter[title]=Workshop&filter[start_at]=2023-01-01&include=location,tickets');
+            expect(events).toEqual([{ id: 'event1' }, { id: 'event2' }]);
+        });
+        it('should correctly initialize and expose the events service via the client', () => {
+            const mockAxiosInstance = {};
+            const client = new BookwhenClient(mockAxiosInstance);
+            const eventsService = client.events;
+            expect(eventsService).toBeInstanceOf(EventService);
+        });
+        it('should use the same axios instance in events service as in the BookwhenClient', () => {
+            const mockAxiosInstance = {};
+            const client = new BookwhenClient(mockAxiosInstance);
+            const eventsService = client.events;
+            expect(eventsService['axiosInstance']).toBe(client['axiosInstance']);
+        });
+        it('should handle errors thrown by the events service methods', async () => {
+            const mockAxiosInstance = {
+                get: vi.fn().mockRejectedValue(new Error('Network Error')),
+            };
+            const client = new BookwhenClient(mockAxiosInstance);
+            // @ts-ignore - Testing invalid parameter type
+            await expect(client.events.getById(453453)).rejects.toThrow('events.getById: Schema Validation failed: Expected object, received number');
+            // @ts-ignore - Testing invalid parameter type
+            await expect(client.events.getById('invalidId')).rejects.toThrow('events.getById: Schema Validation failed: Expected object, received string');
+        });
+        it('should correctly pass filters and includes to events.getMultiple method', async () => {
+            const mockAxiosInstance = {
+                get: vi.fn().mockResolvedValue({ data: { data: [] } }),
+            };
+            const client = new BookwhenClient(mockAxiosInstance);
+            const filters = { tag: ['workshop', 'seminar'], from: '20220101' };
+            const includes = ['location', 'tickets.events'];
+            await client.events.getMultiple({ filters, includes });
+            expect(mockAxiosInstance.get).toHaveBeenCalledWith('/events?filter[tag]=workshop,seminar&filter[from]=20220101&include=location,tickets.events');
+        });
+    });
+});
+//# sourceMappingURL=BookwhenClient.integration.test.js.map

package/dist/client/BookwhenClient.integration.test.js.map

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

package/dist/client/BookwhenClient.js

@@ -0,0 +1,69 @@
+// src/clients/BookwhenClient.ts
+import axios from 'axios';
+import { EventService } from '../services/event/Event.js'; // Ensure this file and class are setup accordingly
+import { CLIENT_HTTP_STATUS_CODES } from '../request/httpStatusCodes.js';
+/**
+ * Client for the Bookwhen API.
+ *
+ * @see https://petstore.swagger.io/?url=https://api.bookwhen.com/v2/openapi.yaml#/ClassPass/get_class_passes__class_pass_id_
+ */
+export class BookwhenClient {
+    axiosInstance;
+    eventService;
+    /**
+     * Creates a new instance of the BookwhenClient class.
+     * @param axiosInstance - Configured Axios instance for making HTTP requests.
+     * @throws Error if axiosInstance is not provided.
+     */
+    constructor(axiosInstance) {
+        this.axiosInstance = axiosInstance;
+        if (!axiosInstance) {
+            throw new Error('BookwhenClient - you must provide an axios instance');
+        }
+    }
+    /**
+     * Gets the EventService instance.
+     *
+     * Available methods:
+     * - getById(params: GetEventByIdParams): Promise<BookwhenEvent>
+     * - getMultiple(params: GetMultipleEventsParams): Promise<BookwhenEvent[]>
+     *
+     * @returns The EventService instance.
+     */
+    get events() {
+        if (!this.eventService) {
+            this.eventService = new EventService(this.axiosInstance);
+        }
+        return this.eventService;
+    }
+}
+/**
+ * Creates an instance of Axios with the provided API key.
+ * @param apiKey - The API key used for authentication.
+ * @returns The Axios instance.
+ */
+export function createBookwhenClient(options) {
+    const { apiKey, baseURL = 'https://api.bookwhen.com/v2' } = options;
+    const axiosInstance = axios.create({
+        baseURL: 'https://api.bookwhen.com/v2',
+        auth: { username: apiKey, password: '' },
+    });
+    axiosInstance.interceptors.response.use((response) => response.data ?? response, (error) => {
+        if (error.response) {
+            const status = error.response.status;
+            const clientError = CLIENT_HTTP_STATUS_CODES[status];
+            if (clientError) {
+                return Promise.reject(new Error(clientError.message));
+            }
+        }
+        else if (error.request) {
+            throw new Error('No response received from the server');
+        }
+        else {
+            throw new Error('An error occurred setting up the request');
+        }
+        return Promise.reject(error);
+    });
+    return new BookwhenClient(axiosInstance);
+}
+//# sourceMappingURL=BookwhenClient.js.map

package/dist/client/BookwhenClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BookwhenClient.js","sourceRoot":"","sources":["../../src/client/BookwhenClient.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC,CAAE,mDAAmD;AAC/G,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAQL;IAPZ,YAAY,CAAgB;IAEpC;;;;OAIG;IACH,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF;AAOD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA8B;IAE9B,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,6BAA6B,EAAE,GAAG,OAAO,CAAC;IAEpE,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,OAAO,EAAE,6BAA6B;QACtC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;KACzC,CAAC,CAAC;IAEH,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACrC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,EACvC,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC,CACF,CAAC;IAEF,OAAO,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;AAC3C,CAAC"}

package/dist/client/BookwhenClient.unit.test.d.ts

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

package/dist/client/BookwhenClient.unit.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import axios from 'axios';
+import { createBookwhenClient } from './BookwhenClient.js';
+import { BookwhenClient } from './BookwhenClient.js';
+import { EventService } from '../services/event/Event.js';
+vi.mock('axios');
+vi.mock('../src/services/event/Event');
+describe('BookwhenClient', () => {
+    it('should throw an error if axiosInstance is not provided', () => {
+        expect(() => new BookwhenClient(undefined)).toThrowError('BookwhenClient - you must provide an axios instance');
+    });
+    it('should assign axiosInstance correctly', () => {
+        const mockAxiosInstance = {};
+        const client = new BookwhenClient(mockAxiosInstance);
+        expect(client['axiosInstance']).toBe(mockAxiosInstance);
+    });
+    it('should expose EventService via getter', () => {
+        const mockAxiosInstance = {};
+        const client = new BookwhenClient(mockAxiosInstance);
+        const eventService = client.events;
+        expect(eventService['axiosInstance']).toBe(mockAxiosInstance);
+        expect(eventService).toBeInstanceOf(EventService);
+    });
+    it('should share axiosInstance with EventService', () => {
+        const mockAxiosInstance = {};
+        const client = new BookwhenClient(mockAxiosInstance);
+        const eventService = client.events;
+        expect(eventService['axiosInstance']).toBe(mockAxiosInstance);
+    });
+});
+describe('createBookwhenClient', () => {
+    let mockAxiosInstance;
+    beforeEach(() => {
+        // Create mock axios instance with interceptors
+        mockAxiosInstance = {
+            interceptors: {
+                response: {
+                    use: vi.fn()
+                },
+                request: {
+                    use: vi.fn()
+                }
+            }
+        };
+        // Mock axios.create to return our mock instance
+        vi.spyOn(axios, 'create').mockReturnValue(mockAxiosInstance);
+    });
+    it('should create an axiosInstance with correct config and return a BookwhenClient', () => {
+        const apiKey = 'test-api-key';
+        const client = createBookwhenClient({ apiKey });
+        expect(axios.create).toHaveBeenCalledWith({
+            baseURL: 'https://api.bookwhen.com/v2',
+            auth: { username: apiKey, password: '' },
+        });
+        expect(mockAxiosInstance.interceptors.response.use).toHaveBeenCalled();
+        expect(client).toBeInstanceOf(BookwhenClient);
+    });
+    it('should handle errors using the interceptor', async () => {
+        const axiosInstance = axios.create();
+        const errorResponse = { response: { status: 400 } };
+        vi.spyOn(axios, 'create').mockReturnValue(axiosInstance);
+        // Mock the interceptor
+        const interceptor = vi.fn();
+        axiosInstance.interceptors.response.use = interceptor;
+        createBookwhenClient({ apiKey: 'test-api-key' });
+        const [, errorHandler] = interceptor.mock.calls[0];
+        await expect(errorHandler(errorResponse)).rejects.toThrowError('BookwhenClient: Bad request');
+    });
+});
+//# sourceMappingURL=BookwhenClient.unit.test.js.map

package/dist/client/BookwhenClient.unit.test.js.map

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

package/dist/index.d.ts

@@ -1 +1,3 @@
-export declare const test: () => void;
+export * from './types/GlobalTypes.js';
+export * from './services/event/EventInterfaces.js';
+export { createBookwhenClient } from './client/BookwhenClient.js';

package/dist/index.js

@@ -1,4 +1,6 @@
-export const test = () => {
-    console.log('hello test');
-};
+import * as dotenv from 'dotenv';
+dotenv.config();
+export * from './types/GlobalTypes.js';
+export * from './services/event/EventInterfaces.js';
+export { createBookwhenClient } from './client/BookwhenClient.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE;IACvB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC5B,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.test.js

@@ -1,7 +1,13 @@
 import { describe, it, expect } from 'vitest';
-describe('something', () => {
-    it('should pass CI', () => {
-        expect(1).toBe(1);
+import * as dotenv from 'dotenv';
+import { createBookwhenClient } from './index.js';
+dotenv.config();
+describe('index.ts', () => {
+    it('should load environment variables', () => {
+        expect(process.env).toHaveProperty('NODE_ENV');
+    });
+    it('should export BookwhenClient', () => {
+        expect(createBookwhenClient).toBeDefined();
     });
 });
 //# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/request/BookwhenRequest.d.ts

@@ -0,0 +1,46 @@
+import type { Resources, Filters } from "../types/GlobalTypes.js";
+/**
+ * QueryBuilder class to help build query strings for Bookwhen API requests.
+ */
+export declare class BookwhenRequest {
+    private path;
+    private filters;
+    private includes;
+    constructor(path: string);
+    /**
+     * Adds filters to the BookwhenQuery object.
+     * @param filters - An array of key-value pairs representing the filters to be added.
+     *
+     * Example resultant query strings:
+     * /v2/events?filter[from]=20200401&filter[to]=20200404
+     * /v2/events?filter[tag]=tag%20one,tag%20two
+     * /v2/events?filter[title]=advanced,pro&filter[detail]=masterclass
+     *
+     * @see https://petstore.swagger.io/?url=https://api.bookwhen.com/v2/openapi.yaml
+     *
+     * @returns The updated BookwhenQuery object.
+     */
+    addFilters(filters: Filters): BookwhenRequest;
+    /**
+     * Adds an include query parameter to the BookwhenRequest object.
+     * @param includes - An array of strings representing the resources to include.
+     *
+     * @returns The updated BookwhenRequest object.
+     *
+     * @throws Error if any include is not a valid string.
+     */
+    addIncludes(includes: Resources): BookwhenRequest;
+    /**
+     * Does the actual work of putting together a valid query string given:
+     * - filters
+     * - includes
+     * - segments
+     *
+     * @returns
+     */
+    build(): string;
+    /**
+     * @returns the constructed query string
+     */
+    toString(): string;
+}

package/dist/request/BookwhenRequest.js

@@ -0,0 +1,126 @@
+import z from 'zod';
+/**
+ * QueryBuilder class to help build query strings for Bookwhen API requests.
+ */
+export class BookwhenRequest {
+    path = '';
+    filters = [];
+    includes = [];
+    constructor(path) {
+        try {
+            if (!path) {
+                throw new Error('Path is required');
+            }
+            this.path = path;
+        }
+        catch (error) {
+            throw new Error("BookwhenQuery error: " + error.message);
+        }
+    }
+    /**
+     * Adds filters to the BookwhenQuery object.
+     * @param filters - An array of key-value pairs representing the filters to be added.
+     *
+     * Example resultant query strings:
+     * /v2/events?filter[from]=20200401&filter[to]=20200404
+     * /v2/events?filter[tag]=tag%20one,tag%20two
+     * /v2/events?filter[title]=advanced,pro&filter[detail]=masterclass
+     *
+     * @see https://petstore.swagger.io/?url=https://api.bookwhen.com/v2/openapi.yaml
+     *
+     * @returns The updated BookwhenQuery object.
+     */
+    addFilters(filters) {
+        // @todo add zod validation for filters?
+        try {
+            for (let key in filters) {
+                let value = filters[key];
+                if (Array.isArray(value) && value && value.length > 0) {
+                    // const encodedValues = value.map((v: string) => {
+                    //   console.log('typeof v', typeof v);
+                    //   if (typeof v === 'undefined') {
+                    //     return '';
+                    //   }
+                    //   if (v.length === 0) {
+                    //     return '';
+                    //   }
+                    //   return encodeURIComponent(v);
+                    // }).join(',');
+                    const encodedValues = value
+                        .filter((v) => typeof v === 'string' && v.length > 0)
+                        .map((v) => encodeURIComponent(v))
+                        .join(',');
+                    this.filters.push(`filter[${encodeURIComponent(key)}]=${encodedValues}`);
+                }
+                else if (typeof value === 'string' && value !== '') {
+                    if (key.length === 0) {
+                        throw new Error('Invalid filter key' + key);
+                    }
+                    this.filters.push(`filter[${encodeURIComponent(key)}]=${encodeURIComponent(value)}`);
+                }
+                else if (typeof value === 'undefined' && value !== '') {
+                    // ignore undefined values
+                }
+            }
+        }
+        catch (error) {
+            throw new Error("BookwhenQuery error: " + error.message);
+        }
+        return this;
+    }
+    /**
+     * Adds an include query parameter to the BookwhenRequest object.
+     * @param includes - An array of strings representing the resources to include.
+     *
+     * @returns The updated BookwhenRequest object.
+     *
+     * @throws Error if any include is not a valid string.
+     */
+    addIncludes(includes) {
+        try {
+            const validIncludes = includes.filter((include) => include.length > 0);
+            if (validIncludes.length !== includes.length) {
+                throw new Error('Invalid includes');
+            }
+            if (validIncludes.length > 0) {
+                const includeQuery = validIncludes.join(',');
+                this.includes.push(`include=${includeQuery}`);
+            }
+        }
+        catch (error) {
+            throw new Error("BookwhenQuery error: " + error.message);
+        }
+        return this;
+    }
+    /**
+     * Does the actual work of putting together a valid query string given:
+     * - filters
+     * - includes
+     * - segments
+     *
+     * @returns
+     */
+    build() {
+        let queryString = '';
+        // Concatenate filters and includes, if any
+        if (this.filters.length > 0) {
+            queryString += this.filters.join('&');
+        }
+        if (this.includes.length > 0) {
+            // Add '&' if filters already added to queryString
+            queryString += queryString ? '&' : '';
+            queryString += this.includes.join('&');
+        }
+        // Strip any leading slashes from this.path
+        const cleanedPath = this.path.replace(/^\/+/, '');
+        // Return the full URI, including query string only if it's non-empty
+        return `/${cleanedPath}${queryString ? '?' + queryString : ''}`;
+    }
+    /**
+     * @returns the constructed query string
+     */
+    toString() {
+        return this.build();
+    }
+}
+//# sourceMappingURL=BookwhenRequest.js.map

package/dist/request/BookwhenRequest.js.map

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

package/dist/request/BookwhenRequest.unit.test.d.ts

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

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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jphil/bookwhen-client",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "description": "",
   "private": false,
   "main": "dist/index.js",
@@ -33,8 +33,15 @@
     "@changesets/cli": "^2.27.9",
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
+    "@types/node": "^22.9.0",
+    "@typescript-eslint/eslint-plugin": "^8.13.0",
+    "@typescript-eslint/parser": "^8.13.0",
+    "@vitest/coverage-v8": "2.1.3",
+    "axios": "^1.7.7",
+    "c8": "^10.1.2",
     "commitizen": "^4.3.1",
     "cz-conventional-changelog": "^3.3.0",
+    "dotenv": "^16.4.5",
     "eslint": "^9.13.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.2.1",
@@ -43,21 +50,21 @@
     "tsup": "^8.3.4",
     "typescript": "^5.6.3",
     "vite": "^5.4.10",
-    "vitest": "^2.1.3"
+    "vite-tsconfig-paths": "^5.1.0",
+    "vitest": "^2.1.3",
+    "zod": "^3.23.8"
   },
   "config": {
     "commitizen": {
       "path": "./node_modules/cz-conventional-changelog"
     }
   },
-  "dependencies": {
-    "rollup": "^4.24.0"
-  },
   "scripts": {
     "dev": "vitest",
     "build": "tsc",
     "lint": "tsc",
     "test": "vitest run",
+    "coverage": "vitest run --coverage",
     "type-check": "tsc --noEmit",
     "check-exports": "attw --pack . --ignore-rules=cjs-resolves-to-esm",
     "prettier-check": "prettier --check 'src/**/*.ts'",