@bookinglab/booking-journey-api 1.0.1 → 1.2.0

package/README.md

@@ -26,6 +26,8 @@ npm install @tanstack/react-query
 
 ### Vanilla JavaScript/TypeScript
 
+#### JRNI API
+
 ```typescript
 import { createJrniClient } from '@bookinglab/booking-journey-api';
 
@@ -43,8 +45,32 @@ const response = await client.login({
 console.log(response.data.auth_token);
 ```
 
+#### BookingLab API
+
+```typescript
+import { createBookingLabClient } from '@bookinglab/booking-journey-api';
+
+const client = createBookingLabClient({ baseUrl: 'https://api.bookinglab.com' });
+client.setAuthToken('your-auth-token');
+
+// Get bookings
+const bookings = await client.getBookings();
+
+// Get services
+const services = await client.getServices();
+
+// Create a booking
+const newBooking = await client.createBooking({
+  userId: 'user-123',
+  serviceId: 'service-456',
+  date: '2024-01-15T10:00:00Z',
+});
+```
+
 ### React Applications
 
+#### Single Provider (JRNI Only)
+
 ```tsx
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { JrniProvider, useLogin } from '@bookinglab/booking-journey-api';
@@ -82,9 +108,71 @@ function LoginForm() {
 }
 ```
 
+#### Single Provider (BookingLab Only)
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { BookingLabProvider, useBookings, useServices } from '@bookinglab/booking-journey-api';
+
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <BookingLabProvider
+        baseUrl="https://api.bookinglab.com"
+        authToken="your-auth-token"
+      >
+        <Dashboard />
+      </BookingLabProvider>
+    </QueryClientProvider>
+  );
+}
+
+function Dashboard() {
+  const { data: bookings, isLoading } = useBookings();
+  const { data: services } = useServices();
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <h2>Bookings: {bookings?.length}</h2>
+      <h2>Services: {services?.length}</h2>
+    </div>
+  );
+}
+```
+
+#### Combined Provider (Both APIs)
+
+```tsx
+import { ApiClientProvider, useJrniClient, useBookingLabClient } from '@bookinglab/booking-journey-api';
+
+function App() {
+  return (
+    <ApiClientProvider
+      bookingLabBaseUrl="https://api.bookinglab.com"
+      jrniBaseUrl="https://api.jrni.com"
+      jrniConfig={{ appId: 'your-app-id', appKey: 'your-app-key' }}
+      authToken="your-auth-token"
+    >
+      <YourApp />
+    </ApiClientProvider>
+  );
+}
+
+function YourApp() {
+  const jrniClient = useJrniClient();
+  const bookingLabClient = useBookingLabClient();
+
+  // Use both clients as needed
+}
+```
+
 ## API Reference
 
-### Core Client
+### Core Clients
 
 #### `createJrniClient(baseUrl, config)`
 
@@ -97,9 +185,31 @@ const client = createJrniClient('https://api.jrni.com', {
 });
 ```
 
-#### Client Methods
-
+**Methods:**
 - `client.login(credentials)` - Authenticate a user
+- `client.getChildCompanies(companyId, params?)` - Get child companies for a parent company
+- `client.getResources(companyId)` - Get bookable resources for a company
+- `client.setAuthToken(token)` - Set auth token for subsequent requests
+
+#### `createBookingLabClient(options)`
+
+Creates a new BookingLab client instance.
+
+```typescript
+const client = createBookingLabClient({ baseUrl: 'https://api.bookinglab.com' });
+client.setAuthToken('your-auth-token');
+```
+
+**Methods:**
+- `client.getBookings()` - Get all bookings
+- `client.getBooking(id)` - Get a specific booking
+- `client.createBooking(data)` - Create a new booking
+- `client.updateBooking(id, data)` - Update a booking
+- `client.cancelBooking(id)` - Cancel a booking
+- `client.deleteBooking(id)` - Delete a booking
+- `client.getServices()` - Get all services
+- `client.getService(id)` - Get a specific service
+- `client.setAuthToken(token)` - Set auth token for subsequent requests
 
 ### React Providers
 
@@ -116,14 +226,29 @@ Provides JRNI client context to React components.
 </JrniProvider>
 ```
 
+#### `BookingLabProvider`
+
+Provides BookingLab client context to React components.
+
+```tsx
+<BookingLabProvider
+  baseUrl="https://api.bookinglab.com"
+  authToken="your-auth-token"
+>
+  {children}
+</BookingLabProvider>
+```
+
 #### `ApiClientProvider`
 
 Combined provider for applications using multiple API clients.
 
 ```tsx
 <ApiClientProvider
+  bookingLabBaseUrl="https://api.bookinglab.com"
   jrniBaseUrl="https://api.jrni.com"
   jrniConfig={{ appId: 'your-app-id', appKey: 'your-app-key' }}
+  authToken="your-auth-token"
 >
   {children}
 </ApiClientProvider>
@@ -131,23 +256,46 @@ Combined provider for applications using multiple API clients.
 
 ### React Hooks
 
-#### `useLogin()`
+#### JRNI Hooks
 
-Hook for user authentication.
+- `useLogin()` - Hook for user authentication
+- `useChildCompanies(companyId, params?, enabled?)` - Get child companies
+- `useResources(companyId, enabled?)` - Get bookable resources
+- `useJrniClient()` - Access the JRNI client directly
 
 ```typescript
-const { mutate, isPending, isError, data } = useLogin();
+const loginMutation = useLogin();
+loginMutation.mutate({ email: 'user@example.com', password: 'password' });
 
-mutate({ email: 'user@example.com', password: 'password' });
+const { data: childCompanies } = useChildCompanies(37000);
+const { data: resources } = useResources(37000);
+
+const client = useJrniClient();
 ```
 
-#### `useJrniClient()`
+#### BookingLab Hooks
 
-Access the JRNI client directly for custom operations.
+- `useBookings()` - Get all bookings
+- `useBooking(id)` - Get a specific booking
+- `useCreateBooking()` - Create a new booking
+- `useUpdateBooking()` - Update a booking
+- `useCancelBooking()` - Cancel a booking
+- `useServices()` - Get all services
+- `useService(id)` - Get a specific service
+- `useBookingLabClient()` - Access the BookingLab client directly
 
 ```typescript
-const client = useJrniClient();
-const response = await client.login(credentials);
+const { data: bookings, isLoading } = useBookings();
+const { data: services } = useServices();
+const createBookingMutation = useCreateBooking();
+
+createBookingMutation.mutate({
+  userId: 'user-123',
+  serviceId: 'service-456',
+  date: '2024-01-15T10:00:00Z',
+});
+
+const client = useBookingLabClient();
 ```
 
 ## Types
@@ -156,8 +304,17 @@ The library exports comprehensive TypeScript types:
 
 ```typescript
 import type {
+  // JRNI Types
   LoginRequest,
   LoginResponse,
+  ChildCompany,
+  ChildCompanyAddress,
+  ChildCompanySettings,
+  ChildCompaniesResponse,
+  GetChildCompaniesParams,
+  Resource,
+  ResourceLinks,
+  ResourcesResponse,
   JrniService,
   ServicesResponse,
   Question,
@@ -170,6 +327,10 @@ import type {
   MemberBookingsResponse,
   AvailabilityTime,
   AvailabilityTimesResponse,
+  // BookingLab Types
+  Booking,
+  CreateBookingRequest,
+  Service,
 } from '@bookinglab/booking-journey-api';
 ```
 

package/dist/index.d.mts

@@ -25,6 +25,28 @@ interface ApiError {
     code?: string;
     details?: any;
 }
+interface Booking {
+    id: string;
+    userId: string;
+    serviceId: string;
+    date: string;
+    status: 'pending' | 'confirmed' | 'cancelled';
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateBookingRequest {
+    userId: string;
+    serviceId: string;
+    date: string;
+    notes?: string;
+}
+interface Service {
+    id: string;
+    name: string;
+    description: string;
+    duration: number;
+    price: number;
+}
 /**
  * JRNI Configuration
  */
@@ -286,6 +308,109 @@ interface UpdateMemberDetailsData {
         answer_id: number;
     }>;
 }
+/**
+ * Child Company Types
+ */
+interface ChildCompanyAddress {
+    id: number;
+    address1: string;
+    address2: string;
+    address3: string;
+    address4: string;
+    address5: string;
+    postcode: string;
+    country: string;
+    lat: number;
+    long: number;
+    map_url: string;
+    map_marker: string;
+    phone: string;
+    homephone: string;
+    pretty_workphone: string;
+    _links: Record<string, any>;
+}
+interface ChildCompanySettings {
+    has_services: boolean;
+    has_resources: boolean;
+    has_groups: boolean;
+    payment_tax: number;
+    currency: string;
+    requires_login: boolean;
+    has_wallets: boolean;
+    has_question_groups: boolean;
+    _links: Record<string, any>;
+}
+interface ChildCompany {
+    id: number;
+    name: string;
+    description: string;
+    company_type: string;
+    address_id: number;
+    website: string;
+    multi_status: string[];
+    numeric_widget_id: number;
+    currency_code: string;
+    timezone: string;
+    country_code: string;
+    live: boolean;
+    ref: string;
+    created_at: string;
+    updated_at: string;
+    children_count: number;
+    locale: string;
+    available_locales: string[];
+    membership_id: number;
+    address: ChildCompanyAddress;
+    _embedded: {
+        settings: ChildCompanySettings;
+    };
+    _links: Record<string, any>;
+}
+interface ChildCompaniesResponse {
+    total_entries: number;
+    _embedded: {
+        companies: ChildCompany[];
+    };
+    _links: Record<string, any>;
+}
+interface GetChildCompaniesParams {
+    person_id?: number;
+    Person_Id?: string;
+    service_id?: string;
+}
+/**
+ * Resource Types
+ */
+interface ResourceLinks {
+    self: {
+        href: string;
+    };
+    items: {
+        href: string;
+    };
+    images: {
+        href: string;
+    };
+}
+interface Resource {
+    id: number;
+    name: string;
+    type: string;
+    group_id: number;
+    deleted: boolean;
+    disabled: boolean;
+    company_id: number;
+    order: number;
+    max_book: number;
+    _links: ResourceLinks;
+}
+interface ResourcesResponse {
+    total_entries: number;
+    _embedded: {
+        resources: Resource[];
+    };
+    _links: Record<string, any>;
+}
 
 /**
  * Core API Client
@@ -335,6 +460,50 @@ declare class ApiClient {
     private normalizeError;
 }
 
+/**
+ * BookingLab API Client
+ * Provides methods for interacting with the BookingLab API
+ */
+
+declare class BookingLabClient extends ApiClient {
+    /**
+     * Get all bookings
+     */
+    getBookings(userId?: string): Promise<ApiResponse<Booking[]>>;
+    /**
+     * Get a single booking by ID
+     */
+    getBooking(bookingId: string): Promise<ApiResponse<Booking>>;
+    /**
+     * Create a new booking
+     */
+    createBooking(booking: CreateBookingRequest): Promise<ApiResponse<Booking>>;
+    /**
+     * Update an existing booking
+     */
+    updateBooking(bookingId: string, updates: Partial<Booking>): Promise<ApiResponse<Booking>>;
+    /**
+     * Cancel a booking
+     */
+    cancelBooking(bookingId: string): Promise<ApiResponse<Booking>>;
+    /**
+     * Delete a booking
+     */
+    deleteBooking(bookingId: string): Promise<ApiResponse<void>>;
+    /**
+     * Get all services
+     */
+    getServices(): Promise<ApiResponse<Service[]>>;
+    /**
+     * Get a single service by ID
+     */
+    getService(serviceId: string): Promise<ApiResponse<Service>>;
+}
+/**
+ * Create a new BookingLab client instance
+ */
+declare function createBookingLabClient(baseUrl: string, authToken?: string): BookingLabClient;
+
 /**
  * JRNI API Client
  * Provides methods for interacting with the JRNI API
@@ -344,10 +513,25 @@ declare class JrniClient extends ApiClient {
     private appId;
     private appKey;
     constructor(baseUrl: string, config: JrniConfig);
+    /**
+     * Get default headers for JRNI API requests
+     */
+    private getDefaultHeaders;
     /**
      * Login to JRNI
      */
     login(credentials: LoginRequest): Promise<ApiResponse<LoginResponse>>;
+    /**
+     * Get child companies for a parent company
+     * @param companyId - The parent company ID
+     * @param params - Optional query parameters (person_id, Person_Id)
+     */
+    getChildCompanies(companyId: number, params?: GetChildCompaniesParams): Promise<ApiResponse<ChildCompaniesResponse>>;
+    /**
+     * Get resources for a company
+     * @param companyId - The company ID
+     */
+    getResources(companyId: number): Promise<ApiResponse<ResourcesResponse>>;
     /**
      * Update JRNI configuration
      */
@@ -359,24 +543,41 @@ declare class JrniClient extends ApiClient {
 declare function createJrniClient(baseUrl: string, config: JrniConfig): JrniClient;
 
 interface ApiClientContextValue {
+    bookingLabClient: BookingLabClient | null;
     jrniClient: JrniClient | null;
 }
 interface ApiClientProviderProps {
     children: ReactNode;
+    bookingLabBaseUrl?: string;
     jrniBaseUrl?: string;
     jrniConfig?: JrniConfig;
+    authToken?: string;
     queryClient?: QueryClient;
 }
 /**
  * Combined provider for multiple API clients
  * Includes QueryClientProvider for React Query hooks
  */
-declare function ApiClientProvider({ children, jrniBaseUrl, jrniConfig, queryClient, }: ApiClientProviderProps): react_jsx_runtime.JSX.Element;
+declare function ApiClientProvider({ children, bookingLabBaseUrl, jrniBaseUrl, jrniConfig, authToken, queryClient, }: ApiClientProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access API client context
  */
 declare function useApiClientContext(): ApiClientContextValue;
 
+interface BookingLabProviderProps {
+    children: ReactNode;
+    baseUrl: string;
+    authToken?: string;
+}
+/**
+ * Provider component for BookingLab client
+ */
+declare function BookingLabProvider({ children, baseUrl, authToken, }: BookingLabProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access BookingLab client from context
+ */
+declare function useBookingLabContext(): BookingLabClient;
+
 interface JrniProviderProps {
     children: ReactNode;
     baseUrl: string;
@@ -394,6 +595,10 @@ declare function useJrniContext(): JrniClient;
 /**
  * Hook to access API clients from context
  */
+/**
+ * Hook to get BookingLab client from either ApiClientProvider or BookingLabProvider
+ */
+declare function useBookingLabClient(): BookingLabClient;
 /**
  * Hook to get JRNI client from either ApiClientProvider or JrniProvider
  */
@@ -403,5 +608,50 @@ declare function useJrniClient(): JrniClient;
  * Hook for JRNI login
  */
 declare function useLogin(): _tanstack_react_query.UseMutationResult<LoginResponse, Error, LoginRequest, unknown>;
+/**
+ * Hook for fetching child companies
+ * @param companyId - The parent company ID
+ * @param params - Optional query parameters
+ * @param enabled - Whether the query should run
+ */
+declare function useChildCompanies(companyId: number, params?: GetChildCompaniesParams, enabled?: boolean): _tanstack_react_query.UseQueryResult<ChildCompaniesResponse, Error>;
+/**
+ * Hook for fetching resources
+ * @param companyId - The company ID
+ * @param enabled - Whether the query should run
+ */
+declare function useResources(companyId: number, enabled?: boolean): _tanstack_react_query.UseQueryResult<ResourcesResponse, Error>;
+
+/**
+ * Hook to fetch bookings
+ */
+declare function useBookings(userId?: string): _tanstack_react_query.UseQueryResult<Booking[], Error>;
+/**
+ * Hook to fetch a single booking
+ */
+declare function useBooking(bookingId: string): _tanstack_react_query.UseQueryResult<Booking, Error>;
+/**
+ * Hook to create a booking
+ */
+declare function useCreateBooking(): _tanstack_react_query.UseMutationResult<Booking, Error, CreateBookingRequest, unknown>;
+/**
+ * Hook to update a booking
+ */
+declare function useUpdateBooking(): _tanstack_react_query.UseMutationResult<Booking, Error, {
+    id: string;
+    updates: Partial<Booking>;
+}, unknown>;
+/**
+ * Hook to cancel a booking
+ */
+declare function useCancelBooking(): _tanstack_react_query.UseMutationResult<Booking, Error, string, unknown>;
+/**
+ * Hook to fetch services
+ */
+declare function useServices(): _tanstack_react_query.UseQueryResult<Service[], Error>;
+/**
+ * Hook to fetch a single service
+ */
+declare function useService(serviceId: string): _tanstack_react_query.UseQueryResult<Service, Error>;
 
-export { type AddBasketItemRequest, ApiClient, type ApiClientConfig, ApiClientProvider, type ApiError, type ApiResponse, type AvailabilityTime, type AvailabilityTimesResponse, type JrniBooking, JrniClient, type JrniConfig, JrniProvider, type JrniService, type Location, type LocationsResponse, type LoginRequest, type LoginResponse, type MemberBookingsResponse, type PersonImage, type PersonImagesResponse, type Question, type QuestionOption, type QuestionsResponse, type RequestOptions, type ServicesResponse, type UpdateClientDetailsData, type UpdateMemberDetailsData, type Vehicle, type VehiclesResponse, createJrniClient, useApiClientContext, useJrniClient, useJrniContext, useLogin };
+export { type AddBasketItemRequest, ApiClient, type ApiClientConfig, ApiClientProvider, type ApiError, type ApiResponse, type AvailabilityTime, type AvailabilityTimesResponse, type Booking, BookingLabClient, BookingLabProvider, type ChildCompaniesResponse, type ChildCompany, type ChildCompanyAddress, type ChildCompanySettings, type CreateBookingRequest, type GetChildCompaniesParams, type JrniBooking, JrniClient, type JrniConfig, JrniProvider, type JrniService, type Location, type LocationsResponse, type LoginRequest, type LoginResponse, type MemberBookingsResponse, type PersonImage, type PersonImagesResponse, type Question, type QuestionOption, type QuestionsResponse, type RequestOptions, type Resource, type ResourceLinks, type ResourcesResponse, type Service, type ServicesResponse, type UpdateClientDetailsData, type UpdateMemberDetailsData, type Vehicle, type VehiclesResponse, createBookingLabClient, createJrniClient, useApiClientContext, useBooking, useBookingLabClient, useBookingLabContext, useBookings, useCancelBooking, useChildCompanies, useCreateBooking, useJrniClient, useJrniContext, useLogin, useResources, useService, useServices, useUpdateBooking };