@jphil/bookwhen-client 0.2.5 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # `@jphil/bookwhen-client`
 
-An API client library for the [Bookwhen](https://www.bookwhen.com) booking platform [API (v2)](https://api.bookwhen.com/v2), written in Typescript for NodeJS. \[wip\]!
+A universal API client library for the [Bookwhen](https://www.bookwhen.com) booking platform [API (v2)](https://api.bookwhen.com/v2), written in TypeScript for both NodeJS and browser environments.
 
 ## Table of Contents
 
@@ -19,7 +19,8 @@ You'll likely be at least somewhat familiar with the [Bookwhen](https://www.book
 
 ## Features
 
-- Provides an easy way to pull your data from Bookwhen for NodeJS environments
+- Provides an easy way to access Bookwhen API from both NodeJS and browsers
+- Browser-compatible with proper CORS handling
 - Provides fully typed methods for each model (so far just the Events model) provided in the Bookwhen API v2
 
 ## Installation
@@ -30,8 +31,17 @@ Install via pnpm:
 pnpm add @jphil/bookwhen-client
 ```
 
+As `axios` and `zod` are peer dependencies, ensure they are also installed in your project:
+```bash
+pnpm add axios zod 
+# or npm install axios zod
+# or yarn add axios zod
+```
+
 ## Usage
 
+This library is distributed as an ES module. The following usage pattern applies to modern Node.js environments (with `type: "module"` in your `package.json` or when using `.mjs` files) and browser environments when using a bundler. For direct browser usage without a bundler, see the [Browser Usage](#browser-usage) section below.
+
 ```typescript
 // import the client factory
 import { createBookwhenClient } from '@jphil/bookwhen-client';
@@ -69,11 +79,87 @@ Valid filters and includes for each method are detailed in the [API v2 docs](htt
 
 Services for the other models in the API are in the pipeline.
 
-N.B. This library is still a pre-1.0.0 WIP, please use accordingly!
+N.B. This library is still a pre-1.0.0 WIP, please use accordingly, and pls submit issues for any bugs!
+
+## Browser Usage
+
+The client is well-suited for browser environments.
+
+### With a Bundler (Recommended for Browser Projects)
+
+If you are using a JavaScript bundler (like Webpack, Rollup, Vite, Parcel, etc.) in your browser project, you can import and use the client as shown in the main [Usage](#usage) section:
+
+```typescript
+import { createBookwhenClient } from '@jphil/bookwhen-client';
+// ... rest of your code
+```
+Ensure that `axios` and `zod` are also installed in your project, as they are peer dependencies. Your bundler will typically handle resolving these.
+
+### Directly with `<script type="module">` (Advanced)
+
+For direct usage in a browser via `<script type="module">` without a bundler, you will need to:
+1. Ensure ES module versions of `axios` and `zod` are accessible to your page (e.g., served locally or via a CDN).
+2. Use an [import map](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap) to tell the browser how to resolve the module specifiers for `@jphil/bookwhen-client`, `axios`, and `zod`.
+
+Example import map:
+```html
+<script type="importmap">
+{
+  "imports": {
+    "@jphil/bookwhen-client": "/node_modules/@jphil/bookwhen-client/dist/index.es.js",
+    "axios": "/node_modules/axios/dist/esm/axios.js", 
+    "zod": "/node_modules/zod/lib/index.mjs" 
+  }
+}
+</script>
+<script type="module">
+  import { createBookwhenClient } from '@jphil/bookwhen-client';
+  // ...
+</script>
+```
+Note: The exact paths in the import map will depend on how you serve these dependencies. Usage with a bundler is generally simpler for browser projects.
+
+### Important Note on API Keys in Client-Side Usage
+When using this library in a browser (client-side), your Bookwhen API key will necessarily be included in the client-side code and thus visible. 
+- It is crucial to use an API key that has the minimum necessary permissions for the operations you intend to perform from the client-side.
+- This library enables access to Bookwhen API endpoints based on the permissions granted to the API key you provide.
+
+## Error Handling
+
+The library provides comprehensive error handling that works consistently in both Node.js and browser environments. Custom error objects thrown by the library will have the following properties:
+
+- `code`: An error code string identifying the type of error (e.g., `NETWORK_ERROR`, `API_ERROR`).
+- `message`: A human-readable description of the error.
+- `isBrowser`: A boolean indicating if the error occurred in a browser environment.
+- `context`: An object containing additional details, which may include the original error, status codes, etc.
+- `timestamp`: The time the error occurred.
+
+### Error Types
+- `NETWORK_ERROR`: Indicates a failure in API communication (e.g., DNS resolution, connection refused).
+- `SECURITY_ERROR`: Specific to browsers, indicates security restrictions prevented API access (e.g., CORS issues not handled by the server, mixed content).
+- `API_ERROR`: The Bookwhen API returned an error response (e.g., 4xx or 5xx status code). The `context` may include `statusCode` and `responseData`.
+- `CONFIG_ERROR`: The client was configured incorrectly (e.g., missing API key).
+- `UNKNOWN_ERROR`: An unexpected error occurred within the library.
+
+Example:
+```typescript
+try {
+  await client.events.getById({eventId: 'invalid-id'});
+} catch (error: any) { // It's good practice to type the error if you have custom error types defined
+  console.error(`Error Code: ${error.code}`);
+  console.error(`Message: ${error.message}`);
+  if (error.code === 'API_ERROR') {
+    console.error('API Error Details:', error.context?.responseData);
+  } else if (error.code === 'NETWORK_ERROR') {
+    // Handle network issues, maybe retry or inform user
+  }
+  // Other error handling...
+}
+```
 
 ## Configuration
 
-Required configuration options:
+Required configuration:
 
 - **apiKey**: Your Bookwhen API key (required)
 
@@ -85,6 +171,42 @@ API keys can be generated in the [API tokens setup area of your Bookwhen account
 
 Please see the docs in the CONTRIBUTIONS.md file, thanks!
 
+## Mainainter release process
+
+[refining]
+
+From main branch on local:
+- Pull latest code
+- git checkout -b some-new-branch
+- git commit -m 'feat(context): my latest work on feature x'
+- git push, copy URL
+
+On github
+> Open PR on github
+> Perfect, merge when checks pass
+
+On local:
+- checkout main
+- git pull
+- git branch -d release (so we have a clean release branch)
+- git checkout -b release
+- pnpm changeset (provide changelog message, commit will occur after)
+- pnpm changeset version (bumps version numbers, and updates changelog, and commits >>> note new version number)
+- git push
+
+On github:
+- Open PR main <- release on github
+> Perfect, merge when checks pass (check why no build)
+
+On local:
+- git checkout main
+- git tag -a vx.x.x -m 'release vx.x.x'
+- git push origin vx.x.x  <<<< RELEASE to github and NPM
+
+
+
+
+
 ## Roadmap
 
 - Proceed towards a 1.0.0 with community feedback.
@@ -92,9 +214,7 @@ Please see the docs in the CONTRIBUTIONS.md file, thanks!
 
 ### Todos
 
-- [] create e2e test suite with github action workflow
-- [] put Zod in place in more areas to strengthen runtime type guards
-- [] write services for the other models in the API
+@see the issue queue.
 
 ## License
 

package/dist/index.d.ts

@@ -1,3 +1,2 @@
-export * from './types/GlobalTypes.js';
-export * from './services/event/EventInterfaces.js';
-export { createBookwhenClient } from './client/BookwhenClient.js';
+export * from './src/index'
+export {}

package/dist/index.es.js

@@ -0,0 +1,260 @@
+import axios from 'axios';
+import { z } from 'zod';
+
+function handleServiceHTTPErrors(error, statusCodes, methodErrors = {}) {
+  if (error.response) {
+    const status = error.response.status;
+    const errorMessage = methodErrors[status]?.message || statusCodes[status]?.message || `Unhandled service error with status code: ${status}`;
+    throw new Error(errorMessage);
+  }
+  throw new Error("An unexpected network or client error occurred");
+}
+
+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" }
+};
+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" }
+};
+
+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) {
+    try {
+      for (let key in filters) {
+        let value = filters[key];
+        if (Array.isArray(value) && value && value.length > 0) {
+          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 !== "") {
+        }
+      }
+    } 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 = "";
+    if (this.filters.length > 0) {
+      queryString += this.filters.join("&");
+    }
+    if (this.includes.length > 0) {
+      queryString += queryString ? "&" : "";
+      queryString += this.includes.join("&");
+    }
+    const cleanedPath = this.path.replace(/^\/+/, "");
+    return `/${cleanedPath}${queryString ? "?" + queryString : ""}`;
+  }
+  /**
+   * @returns the constructed query string
+   */
+  toString() {
+    return this.build();
+  }
+}
+
+const EventResourceSchema = z.enum(["location", "attachments", "tickets", "tickets.events", "tickets.class_passes"]);
+const GetEventByIdParamsSchema = z.object({
+  eventId: z.string().min(1, "Invalid event ID"),
+  includes: EventResourceSchema.array().optional()
+});
+
+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}`);
+      return response.data.data;
+    } catch (error) {
+      handleServiceHTTPErrors(error, SERVICE_HTTP_STATUS_CODES);
+    }
+  }
+}
+
+class BookwhenClient {
+  /**
+   * 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;
+    this.isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+    if (!axiosInstance) {
+      throw new Error("BookwhenClient - you must provide an axios instance");
+    }
+  }
+  eventService;
+  isBrowser;
+  /** 
+   * 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;
+  }
+}
+function createBookwhenClient(options) {
+  const { apiKey, baseURL = "https://api.bookwhen.com/v2", debug = false } = options;
+  const axiosInstance = axios.create({
+    baseURL,
+    auth: { username: apiKey, password: "" }
+  });
+  if (typeof window !== "undefined" && typeof window.document !== "undefined") {
+    axiosInstance.defaults.withCredentials = true;
+  }
+  axiosInstance.interceptors.response.use(
+    (response) => 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);
+    }
+  );
+  if (debug) {
+    axiosInstance.interceptors.request.use((request) => {
+      console.log("Bookwhen Request Debug:", {
+        request
+      });
+      return request;
+    });
+  }
+  return new BookwhenClient(axiosInstance);
+}
+
+export { createBookwhenClient };
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../src/utils/http-utils.ts","../src/request/httpStatusCodes.ts","../src/request/BookwhenRequest.ts","../src/services/event/EventSchemas.ts","../src/services/event/Event.ts","../src/client/BookwhenClient.ts"],"sourcesContent":["import { AxiosError } from 'axios';\nimport type { BookwhenError, HttpStatus } from '../types/GlobalTypes.js';\n\nexport function handleApiError(error: unknown, isBrowser: boolean): BookwhenError {\n  const timestamp = Date.now();\n  \n  // Handle Axios errors\n  if (error instanceof AxiosError) {\n    return {\n      code: 'NETWORK_ERROR',\n      message: isBrowser \n        ? 'Failed to communicate with Bookwhen API'\n        : `Network error: ${error.message}`,\n      isBrowser,\n      context: { timestamp }\n    };\n  }\n\n  // Handle browser security errors\n  if (isBrowser && (error instanceof DOMException || (error instanceof Error && error.name === 'SecurityError'))) {\n    return {\n      code: 'SECURITY_ERROR',\n      message: 'Browser security restriction prevented API access',\n      isBrowser: true,\n      context: isBrowser ? {\n        browser: {\n          isSecure: typeof window !== 'undefined' ? window.isSecureContext : undefined,\n          userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined\n        },\n        timestamp\n      } : { timestamp }\n    };\n  }\n\n  // Fallback for unknown errors\n  return {\n    code: 'UNKNOWN_ERROR',\n    message: isBrowser \n      ? 'An unexpected error occurred'\n      : String(error),\n    isBrowser,\n    context: { timestamp }\n  };\n}\n\n// Keep existing error handler for backwards compatibility\nexport function handleServiceHTTPErrors(error: any, statusCodes: Record<number, HttpStatus>, methodErrors: Record<number, HttpStatus> = {}): never {\n  if (error.response) {\n    const status = error.response.status;\n    const errorMessage = methodErrors[status]?.message || statusCodes[status]?.message || `Unhandled service error with status code: ${status}`;\n    throw new Error(errorMessage);\n  }\n  throw new Error(\"An unexpected network or client error occurred\");\n}\n","import type { HttpStatus } from '../types/GlobalTypes.js';\n\nexport const CLIENT_HTTP_STATUS_CODES: Record<number, HttpStatus> = {\n  400: { code: 400, message: 'BookwhenClient: Bad request' },\n  401: { code: 401, message: 'BookwhenClient: Unauthorized - check your API key' },\n  403: { code: 403, message: 'BookwhenClient: Forbidden - check your permissions' },\n  500: { code: 500, message: 'BookwhenClient: Internal server error' },\n  502: { code: 502, message: 'BookwhenClient: Bad gateway' },\n  503: { code: 503, message: 'BookwhenClient: Service unavailable' },\n  504: { code: 504, message: 'BookwhenClient: Gateway timeout' },\n};\n\nexport const SERVICE_HTTP_STATUS_CODES: Record<number, HttpStatus> = {\n  400: { code: 400, message: 'BookwhenClient: Bad request' },\n  404: { code: 404, message: 'BookwhenClient: The requested resource could not be found' },\n  429: { code: 429, message: 'BookwhenClient: Rate limit exceeded' },\n};","import type { Resources, Filters } from \"../types/GlobalTypes.js\";\nimport z from 'zod';\n\n/**\n * QueryBuilder class to help build query strings for Bookwhen API requests.\n */\nexport class BookwhenRequest {\n  \n  private path: string = '';\n  private filters: string[] = [];\n  private includes: string[] = [];\n  \n  constructor(path: string) {\n    try {\n      if (!path) {\n        throw new Error('Path is required');\n      }\n      this.path = path;\n    } catch (error) {\n      throw new Error(\"BookwhenQuery error: \" + (error as Error).message);\n    } \n  }\n\n  /**\n   * Adds filters to the BookwhenQuery object.\n   * @param filters - An array of key-value pairs representing the filters to be added.\n   * \n   * Example resultant query strings: \n   * /v2/events?filter[from]=20200401&filter[to]=20200404\n   * /v2/events?filter[tag]=tag%20one,tag%20two\n   * /v2/events?filter[title]=advanced,pro&filter[detail]=masterclass\n   * \n   * @see https://petstore.swagger.io/?url=https://api.bookwhen.com/v2/openapi.yaml\n   * \n   * @returns The updated BookwhenQuery object.\n   */\n  public addFilters(filters: Filters): BookwhenRequest {\n    // @todo add zod validation for filters?\n    try {\n      for (let key in filters) {\n        let value = filters[key];\n        if (Array.isArray(value) && value && value.length > 0) {\n          const encodedValues = value\n          .filter((v: string) => typeof v === 'string' && v.length > 0)\n          .map((v: string) => encodeURIComponent(v))\n          .join(',');\n\n          this.filters.push(`filter[${encodeURIComponent(key)}]=${encodedValues}`);\n        } else if (typeof value === 'string' && value !== '') {\n          if (key.length === 0) {\n            throw new Error('Invalid filter key' + key);\n          }\n          this.filters.push(`filter[${encodeURIComponent(key)}]=${encodeURIComponent(value)}`)\n        } else if (typeof value === 'undefined' && value !== '') {\n          // ignore undefined values\n        }\n      }\n    } catch (error) {\n      throw new Error(\"BookwhenQuery error: \" + (error as Error).message);\n    }\n    return this;\n  }\n\n  /**\n   * Adds an include query parameter to the BookwhenRequest object.\n   * @param includes - An array of strings representing the resources to include.\n   * \n   * @returns The updated BookwhenRequest object.\n   * \n   * @throws Error if any include is not a valid string.\n   */\n  public addIncludes(includes: Resources): BookwhenRequest {\n    try {\n      const validIncludes = includes.filter((include: string) => include.length > 0);\n      if (validIncludes.length !== includes.length) {\n        throw new Error('Invalid includes');\n      }\n      if (validIncludes.length > 0) {\n        const includeQuery = validIncludes.join(',');\n        this.includes.push(`include=${includeQuery}`);\n      }\n    } catch (error) {\n      throw new Error(\"BookwhenQuery error: \" + (error as Error).message);\n    }\n    return this;\n  }\n\n  /**\n   * Does the actual work of putting together a valid query string given:\n   * - filters\n   * - includes\n   * - segments\n   * \n   * @returns \n   */\n  build(): string {\n    let queryString = '';\n  \n    // Concatenate filters and includes, if any\n    if (this.filters.length > 0) {\n      queryString += this.filters.join('&');\n    }\n    if (this.includes.length > 0) {\n      // Add '&' if filters already added to queryString\n      queryString += queryString ? '&' : '';\n      queryString += this.includes.join('&');\n    }\n  \n    // Strip any leading slashes from this.path\n    const cleanedPath = this.path.replace(/^\\/+/, '');\n  \n    // Return the full URI, including query string only if it's non-empty\n    return `/${cleanedPath}${queryString ? '?' + queryString : ''}`;\n  }\n\n  /**\n   * @returns the constructed query string\n   */\n  toString(): string {\n    return this.build();\n  }\n}\n","import { z } from 'zod';\n\nexport const EventResourceSchema = z.enum(['location', 'attachments', 'tickets', 'tickets.events', 'tickets.class_passes']);\n\n// Define GetEventByIdParams schema\nexport const GetEventByIdParamsSchema = z.object({\n  eventId: z.string().min(1, 'Invalid event ID'),\n  includes: EventResourceSchema.array().optional(),\n});\n","// src/services/EventService.ts\nimport type { IEventService, GetMultipleEventsParams, GetEventByIdParams } from './EventInterfaces.js';\nimport type { EventsResponse, EventResponse, BookwhenEvent } from './EventTypes.js';\nimport { handleServiceHTTPErrors } from '../../utils/http-utils.js';\nimport { SERVICE_HTTP_STATUS_CODES } from '../../request/httpStatusCodes.js'; \nimport { BookwhenRequest } from '../../request/BookwhenRequest.js';\nimport type { AxiosInstance } from 'axios';\nimport { GetEventByIdParamsSchema } from './EventSchemas.js';\nimport { z } from 'zod';\n\n/**\n * Service class for managing events in the Bookwhen API.\n */\nexport class EventService implements IEventService {\n\n  private axiosInstance: AxiosInstance;\n\n  /**\n   * Initializes EventService with an Axios instance for dependency injection.\n   * @param axiosInstance - The Axios instance to use for API requests.\n   */\n  constructor(axiosInstance: AxiosInstance) {\n    this.axiosInstance = axiosInstance;\n  }\n\n  /**\n   * Retrieves a single event by its ID from the Bookwhen API.\n   * \n   * @param {Object} param - The parameters for retrieving an event.\n   * @param {string} param.eventId - The ID of the event to retrieve.\n   * @param {string} [param.include] - Optional parameter to include additional data.\n   * @returns {Promise<BookwhenEvent>} A Promise that resolves to the BookwhenEvent object.\n   */\n  async getById(params: z.infer<typeof GetEventByIdParamsSchema>): Promise<BookwhenEvent> {\n    try {\n      const validParams = GetEventByIdParamsSchema.parse(params);\n\n      const query = new BookwhenRequest(`/events/${validParams.eventId}`);\n      if (validParams.includes) {\n        query.addIncludes(validParams.includes);\n      }\n\n      const response = await this.axiosInstance.get<EventResponse>(`${query}`);\n      return response.data?.data;\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        const errorMessages = error.errors.map(e => e.message).join(', ');\n        throw new Error(`events.getById: Schema Validation failed: ${errorMessages}`);\n      } else {\n        handleServiceHTTPErrors(error, SERVICE_HTTP_STATUS_CODES, {\n          404: {\n            code: 404,\n            message: 'Event not found. Please check the event ID and try again.',\n          },\n        });\n      }\n    }\n  }\n\n  /**\n   * Retrieves multiple events based on filtering and pagination parameters.\n   * \n   * @param {GetMultipleEventsParams} params - Optional parameters for filtering and pagination.\n   * @return {Promise<BookwhenEvent[]>} A Promise that resolves to an array of BookwhenEvent objects.\n   */\n  async getMultiple(params: GetMultipleEventsParams = {}): Promise<BookwhenEvent[]> {\n    try {\n      const query = new BookwhenRequest('/events');\n      if (params.includes) query.addIncludes(params.includes);\n      if (params.filters) query.addFilters(params.filters);\n\n      const response = await this.axiosInstance.get<EventsResponse>(`${query}`); // uses the toString method\n      return response.data.data;\n    } catch (error) {\n      handleServiceHTTPErrors(error, SERVICE_HTTP_STATUS_CODES);\n    }\n  }\n}\n","// src/clients/BookwhenClient.ts\nimport axios from 'axios';\nimport type { AxiosInstance } from 'axios';\nimport { EventService } from '../services/event/Event.js';  // Ensure this file and class are setup accordingly\nimport { CLIENT_HTTP_STATUS_CODES } from '../request/httpStatusCodes.js';\n\n/**\n * Client for the Bookwhen API.\n * \n * @see https://petstore.swagger.io/?url=https://api.bookwhen.com/v2/openapi.yaml#/ClassPass/get_class_passes__class_pass_id_\n */\nexport class BookwhenClient {\n  private eventService?: EventService;\n  private readonly isBrowser: boolean;\n\n  /**\n   * Creates a new instance of the BookwhenClient class.\n   * @param axiosInstance - Configured Axios instance for making HTTP requests.\n   * @throws Error if axiosInstance is not provided.\n   */\n  constructor(private axiosInstance: AxiosInstance) {\n    this.isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';\n    if (!axiosInstance) {\n      throw new Error('BookwhenClient - you must provide an axios instance');\n    }\n  }\n\n  /** \n   * Gets the EventService instance.\n   * \n   * Available methods:\n   * - getById(params: GetEventByIdParams): Promise<BookwhenEvent>\n   * - getMultiple(params: GetMultipleEventsParams): Promise<BookwhenEvent[]>\n   * \n   * @returns The EventService instance.\n   */\n  get events(): EventService {\n    if (!this.eventService) {\n      this.eventService = new EventService(this.axiosInstance);\n    }\n    return this.eventService;\n  }\n}\n\ninterface BookwhenClientOptions {\n  apiKey: string;\n  baseURL?: string;\n  debug?: boolean;\n}\n\n/**\n * Creates an instance of Axios with the provided API key.\n * @param apiKey - The API key used for authentication.\n * @returns The Axios instance.\n */\nexport function createBookwhenClient(options: BookwhenClientOptions): BookwhenClient {\n  const { apiKey, baseURL = 'https://api.bookwhen.com/v2', debug = false } = options;\n\n  const axiosInstance = axios.create({\n    baseURL: baseURL,\n    auth: { username: apiKey, password: '' },\n  });\n\n  if (typeof window !== 'undefined' && typeof window.document !== 'undefined') {\n    axiosInstance.defaults.withCredentials = true;\n  }\n\n  axiosInstance.interceptors.response.use(\n    (response) => response,\n    (error) => {\n      if (error.response) {\n        const status = error.response.status;\n        const clientError = CLIENT_HTTP_STATUS_CODES[status];\n        if (clientError) {\n          return Promise.reject(new Error(clientError.message));\n        }\n      } else if (error.request) {\n        throw new Error('No response received from the server');\n      } else {\n        throw new Error('An error occurred setting up the request');\n      }\n      return Promise.reject(error);\n    },\n  );\n\n  if(debug) {\n    // Add a request interceptor to log the details\n    axiosInstance.interceptors.request.use(request => {\n      console.log('Bookwhen Request Debug:', {\n        request: request\n      });\n      return request;\n    });\n  }\n\n  return new BookwhenClient(axiosInstance);\n}\n"],"names":[],"mappings":"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"}

package/dist/{client → src/client}/BookwhenClient.d.ts

@@ -1,4 +1,4 @@
-import type { AxiosInstance } from 'axios';
+import { AxiosInstance } from 'axios';
 import { EventService } from '../services/event/Event.js';
 /**
  * Client for the Bookwhen API.
@@ -8,6 +8,7 @@ import { EventService } from '../services/event/Event.js';
 export declare class BookwhenClient {
     private axiosInstance;
     private eventService?;
+    private readonly isBrowser;
     /**
      * Creates a new instance of the BookwhenClient class.
      * @param axiosInstance - Configured Axios instance for making HTTP requests.

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

@@ -1,4 +1,3 @@
 export * from './types/GlobalTypes.js';
 export * from './services/event/EventInterfaces.js';
 export { createBookwhenClient } from './client/BookwhenClient.js';
-//# sourceMappingURL=index.js.map

package/dist/{request → src/request}/BookwhenRequest.d.ts

@@ -1,4 +1,4 @@
-import type { Resources, Filters } from "../types/GlobalTypes.js";
+import { Resources, Filters } from '../types/GlobalTypes.js';
 /**
  * QueryBuilder class to help build query strings for Bookwhen API requests.
  */

package/dist/{request → src/request}/httpStatusCodes.d.ts

@@ -1,3 +1,3 @@
-import type { HttpStatus } from '../types/GlobalTypes.js';
+import { 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/{services → src/services}/event/Event.d.ts

@@ -1,6 +1,6 @@
-import type { IEventService, GetMultipleEventsParams } from './EventInterfaces.js';
-import type { BookwhenEvent } from './EventTypes.js';
-import type { AxiosInstance } from 'axios';
+import { IEventService, GetMultipleEventsParams } from './EventInterfaces.js';
+import { BookwhenEvent } from './EventTypes.js';
+import { AxiosInstance } from 'axios';
 import { GetEventByIdParamsSchema } from './EventSchemas.js';
 import { z } from 'zod';
 /**

package/dist/{services → src/services}/event/EventInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { BookwhenEvent } from './EventTypes.js';
+import { BookwhenEvent } from './EventTypes.js';
 /**
  * Interface for services handling events via the Bookwhen API V2.
  */

package/dist/src/types/GlobalTypes.d.ts

@@ -0,0 +1,21 @@
+export interface HttpStatus {
+    code: number;
+    message: string;
+}
+export type Resource = string;
+export type Resources = Resource[];
+export interface Filters {
+    [key: string]: string | string[] | boolean;
+}
+export interface BookwhenError {
+    code: 'NETWORK_ERROR' | 'SECURITY_ERROR' | 'API_ERROR' | 'CONFIG_ERROR' | 'UNKNOWN_ERROR';
+    message: string;
+    isBrowser: boolean;
+    context?: {
+        browser?: {
+            isSecure?: boolean;
+            userAgent?: string;
+        };
+        timestamp: number;
+    };
+}

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

@@ -0,0 +1,3 @@
+import { BookwhenError, HttpStatus } from '../types/GlobalTypes.js';
+export declare function handleApiError(error: unknown, isBrowser: boolean): BookwhenError;
+export declare function handleServiceHTTPErrors(error: any, statusCodes: Record<number, HttpStatus>, methodErrors?: Record<number, HttpStatus>): never;

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@jphil/bookwhen-client",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "TypeScript client for the Bookwhen API (v2)",
   "private": false,
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "keywords": [
     "bookwhen",
     "booking",
@@ -34,6 +35,9 @@
     "@changesets/cli": "^2.27.9",
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
+    "@mswjs/data": "^0.16.2",
+    "@mswjs/http-middleware": "^0.10.3",
+    "@playwright/test": "^1.52.0",
     "@types/node": "^22.9.0",
     "@typescript-eslint/eslint-plugin": "^8.13.0",
     "@typescript-eslint/parser": "^8.13.0",
@@ -45,34 +49,50 @@
     "eslint": "^9.13.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.2.1",
+    "http-server": "^14.1.1",
     "husky": "^9.1.6",
+    "msw": "^2.7.5",
+    "playwright": "^1.52.0",
+    "playwright-msw": "^3.0.1",
     "prettier": "^3.3.3",
     "tsup": "^8.3.4",
     "typescript": "^5.6.3",
     "vite": "^5.4.10",
+    "vite-plugin-dts": "^4.5.3",
     "vite-tsconfig-paths": "^5.1.0",
-    "vitest": "^2.1.3"
+    "vitest": "^2.1.3",
+    "axios": "^1.7.7",
+    "zod": "^3.23.8"
   },
   "config": {
     "commitizen": {
       "path": "./node_modules/cz-conventional-changelog"
     }
   },
-  "dependencies": {
-    "axios": "^1.7.7",
-    "zod": "^3.23.8"
+  "peerDependencies": {
+    "axios": "^1.7.0",
+    "zod": "^3.23.0"
   },
+  "dependencies": {},
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "module": "./dist/index.mjs"
+      "browser": "./dist/index.es.js",
+      "node": "./dist/index.js",
+      "import": "./dist/index.es.js",
+      "default": "./dist/index.es.js"
     }
   },
+  "browser": "./dist/index.es.js",
   "scripts": {
     "dev": "vitest",
-    "build": "tsc",
+    "preview": "vite preview --config vite.preview.config.ts",
+    "build": "vite build -c vite.library.config.ts",
+    "build:node": "vite build -c vite.test.config.ts",
     "lint": "tsc",
     "test": "vitest run",
+    "test:browser": "playwright test",
+    "test:node": "vitest run",
     "coverage": "vitest run --coverage",
     "type-check": "tsc --noEmit",
     "check-exports": "attw --pack . --ignore-rules=cjs-resolves-to-esm",

package/dist/client/BookwhenClient.js

@@ -1,78 +0,0 @@
-// 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', debug = false } = options;
-    const axiosInstance = axios.create({
-        baseURL: baseURL,
-        auth: { username: apiKey, password: '' },
-    });
-    axiosInstance.interceptors.response.use((response) => 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);
-    });
-    if (debug) {
-        // Add a request interceptor to log the details
-        axiosInstance.interceptors.request.use(request => {
-            console.log('Bookwhen Request Debug:', {
-                request: request
-            });
-            return request;
-        });
-    }
-    return new BookwhenClient(axiosInstance);
-}
-//# sourceMappingURL=BookwhenClient.js.map

package/dist/client/BookwhenClient.js.map

@@ -1 +0,0 @@
-{"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;AAQD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,6BAA6B,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEnF,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,OAAO,EAAE,OAAO;QAChB,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,EACtB,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,IAAG,KAAK,EAAE,CAAC;QACT,+CAA+C;QAC/C,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YAC/C,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE;gBACrC,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;AAC3C,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/request/BookwhenRequest.js

@@ -1,116 +0,0 @@
-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
-                        .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

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

package/dist/request/httpStatusCodes.js

@@ -1,15 +0,0 @@
-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

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

@@ -1,72 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/EventInterfaces.js

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

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

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

package/dist/services/event/EventSchemas.js

@@ -1,8 +0,0 @@
-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

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

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

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

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

package/dist/types/GlobalTypes.d.ts

@@ -1,9 +0,0 @@
-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

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

package/dist/types/GlobalTypes.js.map

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

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

@@ -1,8 +0,0 @@
-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

@@ -1,19 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}