order3000 0.8.2 → 0.10.0

package/dist/client.cjs

@@ -126,6 +126,49 @@ class BaseResource {
   }
 }
 
+class BasketsResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/baskets");
+  }
+  /**
+   * Get the current basket for a session
+   * @param sessionId - The session identifier (from cookie)
+   * @returns The basket with all items, or null if no basket exists
+   */
+  async get(sessionId) {
+    return this.request(
+      "GET",
+      `?sessionId=${encodeURIComponent(sessionId)}`
+    );
+  }
+  /**
+   * Add an item to the basket
+   * Creates basket and guest customer if they don't exist
+   * @param request - The add to basket request
+   * @returns The response with basket item ID and item count
+   */
+  async add(request) {
+    return this.request("POST", "/items", request);
+  }
+  /**
+   * Remove an item from the basket.
+   *
+   * Since each basket item represents a single physical product,
+   * removing it removes the entire item. There is no partial removal.
+   *
+   * @param sessionId - The session identifier
+   * @param basketItemId - The basket item ID to remove
+   * @returns The response with item count
+   */
+  async remove(sessionId, basketItemId) {
+    const params = new URLSearchParams({ sessionId });
+    return this.request(
+      "DELETE",
+      `/items/${basketItemId}?${params.toString()}`
+    );
+  }
+}
+
 class EventsResource extends BaseResource {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/events");
@@ -172,6 +215,20 @@ class EventsResource extends BaseResource {
   async get(eventId) {
     return this.request("GET", `/${eventId}`);
   }
+  /**
+   * Get an event by accessor (slug)
+   * @param accessor - The event accessor (e.g., 'lunch-menu')
+   * @param options - Optional expand options
+   * @returns The event with optional schedule, timeSlots, menus, and posters
+   */
+  async getByAccessor(accessor, options) {
+    const queryString = this.buildQueryString(options);
+    return this.request("GET", `/${accessor}${queryString}`);
+  }
+  buildQueryString(options) {
+    if (!options?.expand?.length) return "";
+    return `?expand=${options.expand.join(",")}`;
+  }
 }
 
 class MenusResource extends BaseResource {
@@ -443,11 +500,126 @@ class RealtimeManager {
   }
 }
 
+const ALL_DAYS = [
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday",
+  "sunday"
+];
+const RRULE_DAY_MAP = {
+  MO: "monday",
+  TU: "tuesday",
+  WE: "wednesday",
+  TH: "thursday",
+  FR: "friday",
+  SA: "saturday",
+  SU: "sunday"
+};
+function parseDaysFromRRule(rrule) {
+  if (!rrule) {
+    return [];
+  }
+  const byDayMatch = rrule.match(/BYDAY=([^;]+)/);
+  if (!byDayMatch) {
+    return [];
+  }
+  const rruleDays = byDayMatch[1].split(",");
+  const days = [];
+  for (const rruleDay of rruleDays) {
+    const day = RRULE_DAY_MAP[rruleDay.trim()];
+    if (day) {
+      days.push(day);
+    }
+  }
+  return ALL_DAYS.filter((day) => days.includes(day));
+}
+function addMinutesToTime(time, minutes) {
+  const parts = time.split(":");
+  const hours = parseInt(parts[0], 10);
+  const mins = parseInt(parts[1], 10);
+  const totalMinutes = hours * 60 + mins + minutes;
+  const newHours = Math.floor(totalMinutes / 60) % 24;
+  const newMins = totalMinutes % 60;
+  return `${newHours.toString().padStart(2, "0")}:${newMins.toString().padStart(2, "0")}`;
+}
+function formatTime(time) {
+  const parts = time.split(":");
+  if (parts.length >= 2) {
+    return `${parts[0]}:${parts[1]}`;
+  }
+  return time;
+}
+function getScheduleInfo(schedule) {
+  const defaultData = {
+    timeRange: null,
+    activeDays: []
+  };
+  if (!schedule?.scheduleTimeSlots?.length) {
+    return defaultData;
+  }
+  const timeSlots = schedule.scheduleTimeSlots;
+  const rrule = schedule.rrule;
+  const intervalMinutes = schedule.intervalMinutes ?? 30;
+  const activeDaysSet = /* @__PURE__ */ new Set();
+  let hasNullDayOfWeek = false;
+  const startTimes = [];
+  let latestEndTime = null;
+  for (const slot of timeSlots) {
+    if (slot.dayOfWeek) {
+      activeDaysSet.add(slot.dayOfWeek);
+    } else {
+      hasNullDayOfWeek = true;
+    }
+    if (slot.timeSlot.startTime) {
+      startTimes.push(slot.timeSlot.startTime);
+    }
+    if (slot.timeSlot.endTime) {
+      if (!latestEndTime || slot.timeSlot.endTime > latestEndTime) {
+        latestEndTime = slot.timeSlot.endTime;
+      }
+    }
+  }
+  let activeDays;
+  if (hasNullDayOfWeek) {
+    const rruleDays = parseDaysFromRRule(rrule);
+    if (rruleDays.length > 0) {
+      activeDays = rruleDays;
+    } else {
+      activeDays = ALL_DAYS.filter((day) => activeDaysSet.has(day));
+    }
+  } else {
+    activeDays = ALL_DAYS.filter((day) => activeDaysSet.has(day));
+  }
+  let timeRange = null;
+  if (startTimes.length > 0) {
+    startTimes.sort();
+    const earliestStart = startTimes[0];
+    const latestStart = startTimes[startTimes.length - 1];
+    let endTime;
+    if (latestEndTime) {
+      endTime = latestEndTime;
+    } else {
+      endTime = addMinutesToTime(latestStart, intervalMinutes);
+    }
+    const startFormatted = formatTime(earliestStart);
+    const endFormatted = formatTime(endTime);
+    timeRange = `${startFormatted}-${endFormatted}`;
+  }
+  return {
+    timeRange,
+    activeDays
+  };
+}
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Order3000Client {
   constructor(config) {
+    __publicField(this, "baskets");
     __publicField(this, "events");
     __publicField(this, "menus");
     __publicField(this, "orders");
@@ -463,6 +635,7 @@ class Order3000Client {
       tokenUrl,
       config.venueId
     );
+    this.baskets = new BasketsResource(this.tokenManager, this.baseUrl);
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
     this.menus = new MenusResource(this.tokenManager, this.baseUrl);
     this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
@@ -475,3 +648,4 @@ class Order3000Client {
 }
 
 exports.Order3000Client = Order3000Client;
+exports.getScheduleInfo = getScheduleInfo;

package/dist/client.d.cts

@@ -22,11 +22,84 @@ declare abstract class BaseResource {
     protected readonly baseUrl: string;
     protected readonly resourcePath: string;
     constructor(tokenManager: TokenManager, baseUrl: string, resourcePath: string);
-    protected request<T>(method: 'GET' | 'POST', path: string, data?: any): Promise<T>;
+    protected request<T>(method: 'GET' | 'POST' | 'DELETE', path: string, data?: unknown): Promise<T>;
 }
 
 interface components {
     schemas: {
+        /**
+         * CreateEventRequest
+         * @description Request payload for creating a new event
+         */
+        CreateEventRequest: {
+            accessor?: string | null;
+            name: (string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[];
+            description?: ((string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[]) | null;
+            scheduleId?: string | null;
+            maxBookings?: number | null;
+            maxGuests?: number | null;
+            minPartySize?: number | null;
+            maxPartySize?: number | null;
+            isPublic?: boolean;
+            isRecurring?: boolean;
+            acceptsReservations?: boolean;
+            bookingOpensAtDays?: number | null;
+            bookingClosesAtHours?: number | null;
+            isActive?: boolean;
+            isFeatured?: boolean;
+            priority?: number;
+            schedule?: {
+                rrule?: string | null;
+                timezone?: string | null;
+                validFrom?: string | null;
+                validTo?: string | null;
+                timeRanges: {
+                    startTime: string;
+                    endTime: string;
+                    lastSeatingTime?: string | null;
+                }[];
+                /** @enum {string|null} */
+                slotMode?: "interval" | "duration" | null;
+                intervalMinutes?: number | null;
+                durationMinutes?: number | null;
+            } | null;
+        };
+        /**
+         * CreateEventResponse
+         * @description Successfully created event
+         */
+        CreateEventResponse: {
+            id: string;
+            venueId: string;
+            accessor: string | null;
+            name: (string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[];
+            description: ((string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[]) | null;
+            scheduleId: string | null;
+            maxBookings: number | null;
+            maxGuests: number | null;
+            minPartySize: number | null;
+            maxPartySize: number | null;
+            isPublic: boolean;
+            isRecurring: boolean;
+            acceptsReservations: boolean;
+            bookingOpensAtDays: number | null;
+            bookingClosesAtHours: number | null;
+            isActive: boolean;
+            isFeatured: boolean;
+            priority: number;
+            createdBy: string | null;
+            updatedBy: string | null;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
         /**
          * PlaceOrderRequest
          * @description Place a new order for a specific venue
@@ -205,79 +278,6 @@ interface components {
             /** @description Last update timestamp */
             updatedAt: unknown;
         };
-        /**
-         * CreateEventRequest
-         * @description Request payload for creating a new event
-         */
-        CreateEventRequest: {
-            accessor?: string | null;
-            name: (string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[];
-            description?: ((string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[]) | null;
-            scheduleId?: string | null;
-            maxBookings?: number | null;
-            maxGuests?: number | null;
-            minPartySize?: number | null;
-            maxPartySize?: number | null;
-            isPublic?: boolean;
-            isRecurring?: boolean;
-            acceptsReservations?: boolean;
-            bookingOpensAtDays?: number | null;
-            bookingClosesAtHours?: number | null;
-            isActive?: boolean;
-            isFeatured?: boolean;
-            priority?: number;
-            schedule?: {
-                rrule?: string | null;
-                timezone?: string | null;
-                validFrom?: string | null;
-                validTo?: string | null;
-                timeRanges: {
-                    startTime: string;
-                    endTime: string;
-                    lastSeatingTime?: string | null;
-                }[];
-                /** @enum {string|null} */
-                slotMode?: "interval" | "duration" | null;
-                intervalMinutes?: number | null;
-                durationMinutes?: number | null;
-            } | null;
-        };
-        /**
-         * CreateEventResponse
-         * @description Successfully created event
-         */
-        CreateEventResponse: {
-            id: string;
-            venueId: string;
-            accessor: string | null;
-            name: (string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[];
-            description: ((string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[]) | null;
-            scheduleId: string | null;
-            maxBookings: number | null;
-            maxGuests: number | null;
-            minPartySize: number | null;
-            maxPartySize: number | null;
-            isPublic: boolean;
-            isRecurring: boolean;
-            acceptsReservations: boolean;
-            bookingOpensAtDays: number | null;
-            bookingClosesAtHours: number | null;
-            isActive: boolean;
-            isFeatured: boolean;
-            priority: number;
-            createdBy: string | null;
-            updatedBy: string | null;
-            createdAt: unknown;
-            updatedAt: unknown;
-        };
     };
     responses: never;
     parameters: never;
@@ -293,11 +293,12 @@ type PlaceOrderRequest = schemas['PlaceOrderRequest'];
 type PlaceOrderResponse = schemas['PlaceOrderResponse'];
 type MakeReservationRequest = schemas['MakeReservationRequest'];
 type MakeReservationResponse = schemas['MakeReservationResponse'];
+type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
 interface TimeSlot {
     id: string;
     startTime: string;
     endTime: string | null;
-    dayOfWeek?: 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | 'SUN' | null;
+    dayOfWeek?: DayOfWeek | null;
     isSchedulable: boolean | null;
 }
 interface ScheduleOverride {
@@ -476,6 +477,158 @@ interface GetMenuOptions {
     /** Expand related resources (items, assets) */
     expand?: ('items' | 'assets')[];
 }
+interface ScheduleTimeSlot {
+    dayOfWeek: DayOfWeek | null;
+    timeSlot: {
+        id: string;
+        startTime: string;
+        endTime: string | null;
+        isActive: boolean | null;
+        isSchedulable: boolean | null;
+    };
+}
+interface ScheduleWithTimeSlots extends Schedule {
+    scheduleTimeSlots?: ScheduleTimeSlot[];
+}
+interface EventMenu {
+    id: string;
+    accessor: string;
+    name: Record<string, string>;
+    category: string;
+}
+interface EventByAccessor {
+    id: string;
+    venueId: string;
+    accessor: string | null;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    scheduleId: string | null;
+    maxBookings: number | null;
+    maxGuests: number | null;
+    minPartySize: number | null;
+    maxPartySize: number | null;
+    isPublic: boolean;
+    isRecurring: boolean;
+    acceptsReservations: boolean;
+    bookingOpensAtDays: number | null;
+    bookingClosesAtHours: number | null;
+    isActive: boolean;
+    isFeatured: boolean;
+    priority: number;
+    createdAt: string | null;
+    updatedAt: string | null;
+    schedule?: ScheduleWithTimeSlots;
+    menus?: EventMenu[];
+    posters?: EventPoster[];
+}
+interface GetEventOptions {
+    /** Expand related resources (schedule, timeSlots, menus, posters) */
+    expand?: ('schedule' | 'timeSlots' | 'menus' | 'posters')[];
+}
+type BasketStatus = 'active' | 'abandoned' | 'converted';
+type Currency = 'EUR' | 'CHF';
+/**
+ * Unit of measurement for portion tracking.
+ */
+type Unit = 'grams' | 'kilograms' | 'liters' | 'milliliters' | 'pieces';
+/**
+ * Reference to a menu item within a basket item.
+ *
+ * Each menu item can have its own portion size (quantity + unit),
+ * allowing for precise tracking like "100g rice, 80g curry".
+ */
+interface BasketItemMenuItemRef {
+    menuItemId: string;
+    role: string | null;
+    quantity: number;
+    unit: Unit;
+}
+interface BasketItemMetadata {
+    type?: 'tiffinbox' | 'bowl' | 'sushi';
+    mode?: 2 | 3;
+    upsell?: {
+        tinOption: string;
+        rollOption: string;
+    };
+    price?: number;
+    [key: string]: unknown;
+}
+/**
+ * A basket item represents a single physical product in the basket.
+ *
+ * Each basket item can contain multiple menu items (e.g., a TiffinBox
+ * with rice, curry, and sides). The itemCount in the response is the
+ * COUNT of basket items, not a sum of quantities.
+ */
+interface BasketItem {
+    id: string;
+    metadata: BasketItemMetadata | null;
+    menuItems: BasketItemMenuItemRef[];
+}
+interface Basket {
+    id: string;
+    sessionId: string;
+    status: BasketStatus;
+    currency: Currency;
+    items: BasketItem[];
+    itemCount: number;
+    expiresAt: string;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+/**
+ * Request to add an item to the basket.
+ *
+ * Menu items can optionally include portion information (quantity/unit).
+ * If not provided, defaults to the menu item's configured portion size.
+ */
+interface AddToBasketRequest {
+    sessionId: string;
+    menuItems: Array<{
+        menuItemId: string;
+        role?: string;
+        quantity?: number;
+        unit?: Unit;
+    }>;
+    metadata?: BasketItemMetadata;
+}
+interface AddToBasketResponse {
+    basketItemId: string;
+    itemCount: number;
+}
+interface RemoveFromBasketResponse {
+    success: boolean;
+    basketItemId: string;
+    itemCount: number;
+}
+
+declare class BasketsResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Get the current basket for a session
+     * @param sessionId - The session identifier (from cookie)
+     * @returns The basket with all items, or null if no basket exists
+     */
+    get(sessionId: string): Promise<Basket | null>;
+    /**
+     * Add an item to the basket
+     * Creates basket and guest customer if they don't exist
+     * @param request - The add to basket request
+     * @returns The response with basket item ID and item count
+     */
+    add(request: AddToBasketRequest): Promise<AddToBasketResponse>;
+    /**
+     * Remove an item from the basket.
+     *
+     * Since each basket item represents a single physical product,
+     * removing it removes the entire item. There is no partial removal.
+     *
+     * @param sessionId - The session identifier
+     * @param basketItemId - The basket item ID to remove
+     * @returns The response with item count
+     */
+    remove(sessionId: string, basketItemId: string): Promise<RemoveFromBasketResponse>;
+}
 
 declare class EventsResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -497,6 +650,14 @@ declare class EventsResource extends BaseResource {
      * @returns The event details
      */
     get(eventId: string): Promise<Event>;
+    /**
+     * Get an event by accessor (slug)
+     * @param accessor - The event accessor (e.g., 'lunch-menu')
+     * @param options - Optional expand options
+     * @returns The event with optional schedule, timeSlots, menus, and posters
+     */
+    getByAccessor(accessor: string, options?: GetEventOptions): Promise<EventByAccessor>;
+    private buildQueryString;
 }
 
 declare class MenusResource extends BaseResource {
@@ -661,6 +822,26 @@ declare class RealtimeManager {
     disconnectAll(): Promise<void>;
 }
 
+interface ScheduleInfo {
+    /** Time range string, e.g. "11:30-15:00" */
+    timeRange: string | null;
+    /** Active days in week order */
+    activeDays: DayOfWeek[];
+}
+interface ScheduleInput {
+    rrule?: string | null;
+    intervalMinutes?: number | null;
+    scheduleTimeSlots?: ScheduleTimeSlot[];
+}
+/**
+ * Extract schedule information from a schedule object.
+ * Returns time range and active days for display purposes.
+ *
+ * @param schedule - Schedule object with rrule, intervalMinutes, and scheduleTimeSlots
+ * @returns ScheduleInfo with timeRange and activeDays
+ */
+declare function getScheduleInfo(schedule: ScheduleInput | null | undefined): ScheduleInfo;
+
 interface Order3000ClientConfig {
     clientId: string;
     clientSecret: string;
@@ -677,6 +858,7 @@ interface Order3000ClientConfig {
     tokenUrl?: string;
 }
 declare class Order3000Client {
+    baskets: BasketsResource;
     events: EventsResource;
     menus: MenusResource;
     orders: OrdersResource;
@@ -687,4 +869,4 @@ declare class Order3000Client {
     constructor(config: Order3000ClientConfig);
 }
 
-export { type CropArea, type Event, type EventPoster, type EventRow, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type Schedule, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type SubscriptionOptions, type TimeSlot };
+export { type AddToBasketRequest, type AddToBasketResponse, type Basket, type BasketItem, type BasketItemMenuItemRef, type BasketItemMetadata, type BasketStatus, type CropArea, type Currency, type DayOfWeek, type Event, type EventByAccessor, type EventMenu, type EventPoster, type EventRow, type GetEventOptions, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type RemoveFromBasketResponse, type Schedule, type ScheduleInfo, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type ScheduleTimeSlot, type ScheduleWithTimeSlots, type SubscriptionOptions, type TimeSlot, type Unit, getScheduleInfo };

package/dist/client.d.mts

@@ -22,11 +22,84 @@ declare abstract class BaseResource {
     protected readonly baseUrl: string;
     protected readonly resourcePath: string;
     constructor(tokenManager: TokenManager, baseUrl: string, resourcePath: string);
-    protected request<T>(method: 'GET' | 'POST', path: string, data?: any): Promise<T>;
+    protected request<T>(method: 'GET' | 'POST' | 'DELETE', path: string, data?: unknown): Promise<T>;
 }
 
 interface components {
     schemas: {
+        /**
+         * CreateEventRequest
+         * @description Request payload for creating a new event
+         */
+        CreateEventRequest: {
+            accessor?: string | null;
+            name: (string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[];
+            description?: ((string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[]) | null;
+            scheduleId?: string | null;
+            maxBookings?: number | null;
+            maxGuests?: number | null;
+            minPartySize?: number | null;
+            maxPartySize?: number | null;
+            isPublic?: boolean;
+            isRecurring?: boolean;
+            acceptsReservations?: boolean;
+            bookingOpensAtDays?: number | null;
+            bookingClosesAtHours?: number | null;
+            isActive?: boolean;
+            isFeatured?: boolean;
+            priority?: number;
+            schedule?: {
+                rrule?: string | null;
+                timezone?: string | null;
+                validFrom?: string | null;
+                validTo?: string | null;
+                timeRanges: {
+                    startTime: string;
+                    endTime: string;
+                    lastSeatingTime?: string | null;
+                }[];
+                /** @enum {string|null} */
+                slotMode?: "interval" | "duration" | null;
+                intervalMinutes?: number | null;
+                durationMinutes?: number | null;
+            } | null;
+        };
+        /**
+         * CreateEventResponse
+         * @description Successfully created event
+         */
+        CreateEventResponse: {
+            id: string;
+            venueId: string;
+            accessor: string | null;
+            name: (string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[];
+            description: ((string | number | boolean | (null)) | {
+                [key: string]: unknown;
+            } | unknown[]) | null;
+            scheduleId: string | null;
+            maxBookings: number | null;
+            maxGuests: number | null;
+            minPartySize: number | null;
+            maxPartySize: number | null;
+            isPublic: boolean;
+            isRecurring: boolean;
+            acceptsReservations: boolean;
+            bookingOpensAtDays: number | null;
+            bookingClosesAtHours: number | null;
+            isActive: boolean;
+            isFeatured: boolean;
+            priority: number;
+            createdBy: string | null;
+            updatedBy: string | null;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
         /**
          * PlaceOrderRequest
          * @description Place a new order for a specific venue
@@ -205,79 +278,6 @@ interface components {
             /** @description Last update timestamp */
             updatedAt: unknown;
         };
-        /**
-         * CreateEventRequest
-         * @description Request payload for creating a new event
-         */
-        CreateEventRequest: {
-            accessor?: string | null;
-            name: (string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[];
-            description?: ((string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[]) | null;
-            scheduleId?: string | null;
-            maxBookings?: number | null;
-            maxGuests?: number | null;
-            minPartySize?: number | null;
-            maxPartySize?: number | null;
-            isPublic?: boolean;
-            isRecurring?: boolean;
-            acceptsReservations?: boolean;
-            bookingOpensAtDays?: number | null;
-            bookingClosesAtHours?: number | null;
-            isActive?: boolean;
-            isFeatured?: boolean;
-            priority?: number;
-            schedule?: {
-                rrule?: string | null;
-                timezone?: string | null;
-                validFrom?: string | null;
-                validTo?: string | null;
-                timeRanges: {
-                    startTime: string;
-                    endTime: string;
-                    lastSeatingTime?: string | null;
-                }[];
-                /** @enum {string|null} */
-                slotMode?: "interval" | "duration" | null;
-                intervalMinutes?: number | null;
-                durationMinutes?: number | null;
-            } | null;
-        };
-        /**
-         * CreateEventResponse
-         * @description Successfully created event
-         */
-        CreateEventResponse: {
-            id: string;
-            venueId: string;
-            accessor: string | null;
-            name: (string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[];
-            description: ((string | number | boolean | (null)) | {
-                [key: string]: unknown;
-            } | unknown[]) | null;
-            scheduleId: string | null;
-            maxBookings: number | null;
-            maxGuests: number | null;
-            minPartySize: number | null;
-            maxPartySize: number | null;
-            isPublic: boolean;
-            isRecurring: boolean;
-            acceptsReservations: boolean;
-            bookingOpensAtDays: number | null;
-            bookingClosesAtHours: number | null;
-            isActive: boolean;
-            isFeatured: boolean;
-            priority: number;
-            createdBy: string | null;
-            updatedBy: string | null;
-            createdAt: unknown;
-            updatedAt: unknown;
-        };
     };
     responses: never;
     parameters: never;
@@ -293,11 +293,12 @@ type PlaceOrderRequest = schemas['PlaceOrderRequest'];
 type PlaceOrderResponse = schemas['PlaceOrderResponse'];
 type MakeReservationRequest = schemas['MakeReservationRequest'];
 type MakeReservationResponse = schemas['MakeReservationResponse'];
+type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
 interface TimeSlot {
     id: string;
     startTime: string;
     endTime: string | null;
-    dayOfWeek?: 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | 'SUN' | null;
+    dayOfWeek?: DayOfWeek | null;
     isSchedulable: boolean | null;
 }
 interface ScheduleOverride {
@@ -476,6 +477,158 @@ interface GetMenuOptions {
     /** Expand related resources (items, assets) */
     expand?: ('items' | 'assets')[];
 }
+interface ScheduleTimeSlot {
+    dayOfWeek: DayOfWeek | null;
+    timeSlot: {
+        id: string;
+        startTime: string;
+        endTime: string | null;
+        isActive: boolean | null;
+        isSchedulable: boolean | null;
+    };
+}
+interface ScheduleWithTimeSlots extends Schedule {
+    scheduleTimeSlots?: ScheduleTimeSlot[];
+}
+interface EventMenu {
+    id: string;
+    accessor: string;
+    name: Record<string, string>;
+    category: string;
+}
+interface EventByAccessor {
+    id: string;
+    venueId: string;
+    accessor: string | null;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    scheduleId: string | null;
+    maxBookings: number | null;
+    maxGuests: number | null;
+    minPartySize: number | null;
+    maxPartySize: number | null;
+    isPublic: boolean;
+    isRecurring: boolean;
+    acceptsReservations: boolean;
+    bookingOpensAtDays: number | null;
+    bookingClosesAtHours: number | null;
+    isActive: boolean;
+    isFeatured: boolean;
+    priority: number;
+    createdAt: string | null;
+    updatedAt: string | null;
+    schedule?: ScheduleWithTimeSlots;
+    menus?: EventMenu[];
+    posters?: EventPoster[];
+}
+interface GetEventOptions {
+    /** Expand related resources (schedule, timeSlots, menus, posters) */
+    expand?: ('schedule' | 'timeSlots' | 'menus' | 'posters')[];
+}
+type BasketStatus = 'active' | 'abandoned' | 'converted';
+type Currency = 'EUR' | 'CHF';
+/**
+ * Unit of measurement for portion tracking.
+ */
+type Unit = 'grams' | 'kilograms' | 'liters' | 'milliliters' | 'pieces';
+/**
+ * Reference to a menu item within a basket item.
+ *
+ * Each menu item can have its own portion size (quantity + unit),
+ * allowing for precise tracking like "100g rice, 80g curry".
+ */
+interface BasketItemMenuItemRef {
+    menuItemId: string;
+    role: string | null;
+    quantity: number;
+    unit: Unit;
+}
+interface BasketItemMetadata {
+    type?: 'tiffinbox' | 'bowl' | 'sushi';
+    mode?: 2 | 3;
+    upsell?: {
+        tinOption: string;
+        rollOption: string;
+    };
+    price?: number;
+    [key: string]: unknown;
+}
+/**
+ * A basket item represents a single physical product in the basket.
+ *
+ * Each basket item can contain multiple menu items (e.g., a TiffinBox
+ * with rice, curry, and sides). The itemCount in the response is the
+ * COUNT of basket items, not a sum of quantities.
+ */
+interface BasketItem {
+    id: string;
+    metadata: BasketItemMetadata | null;
+    menuItems: BasketItemMenuItemRef[];
+}
+interface Basket {
+    id: string;
+    sessionId: string;
+    status: BasketStatus;
+    currency: Currency;
+    items: BasketItem[];
+    itemCount: number;
+    expiresAt: string;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+/**
+ * Request to add an item to the basket.
+ *
+ * Menu items can optionally include portion information (quantity/unit).
+ * If not provided, defaults to the menu item's configured portion size.
+ */
+interface AddToBasketRequest {
+    sessionId: string;
+    menuItems: Array<{
+        menuItemId: string;
+        role?: string;
+        quantity?: number;
+        unit?: Unit;
+    }>;
+    metadata?: BasketItemMetadata;
+}
+interface AddToBasketResponse {
+    basketItemId: string;
+    itemCount: number;
+}
+interface RemoveFromBasketResponse {
+    success: boolean;
+    basketItemId: string;
+    itemCount: number;
+}
+
+declare class BasketsResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Get the current basket for a session
+     * @param sessionId - The session identifier (from cookie)
+     * @returns The basket with all items, or null if no basket exists
+     */
+    get(sessionId: string): Promise<Basket | null>;
+    /**
+     * Add an item to the basket
+     * Creates basket and guest customer if they don't exist
+     * @param request - The add to basket request
+     * @returns The response with basket item ID and item count
+     */
+    add(request: AddToBasketRequest): Promise<AddToBasketResponse>;
+    /**
+     * Remove an item from the basket.
+     *
+     * Since each basket item represents a single physical product,
+     * removing it removes the entire item. There is no partial removal.
+     *
+     * @param sessionId - The session identifier
+     * @param basketItemId - The basket item ID to remove
+     * @returns The response with item count
+     */
+    remove(sessionId: string, basketItemId: string): Promise<RemoveFromBasketResponse>;
+}
 
 declare class EventsResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -497,6 +650,14 @@ declare class EventsResource extends BaseResource {
      * @returns The event details
      */
     get(eventId: string): Promise<Event>;
+    /**
+     * Get an event by accessor (slug)
+     * @param accessor - The event accessor (e.g., 'lunch-menu')
+     * @param options - Optional expand options
+     * @returns The event with optional schedule, timeSlots, menus, and posters
+     */
+    getByAccessor(accessor: string, options?: GetEventOptions): Promise<EventByAccessor>;
+    private buildQueryString;
 }
 
 declare class MenusResource extends BaseResource {
@@ -661,6 +822,26 @@ declare class RealtimeManager {
     disconnectAll(): Promise<void>;
 }
 
+interface ScheduleInfo {
+    /** Time range string, e.g. "11:30-15:00" */
+    timeRange: string | null;
+    /** Active days in week order */
+    activeDays: DayOfWeek[];
+}
+interface ScheduleInput {
+    rrule?: string | null;
+    intervalMinutes?: number | null;
+    scheduleTimeSlots?: ScheduleTimeSlot[];
+}
+/**
+ * Extract schedule information from a schedule object.
+ * Returns time range and active days for display purposes.
+ *
+ * @param schedule - Schedule object with rrule, intervalMinutes, and scheduleTimeSlots
+ * @returns ScheduleInfo with timeRange and activeDays
+ */
+declare function getScheduleInfo(schedule: ScheduleInput | null | undefined): ScheduleInfo;
+
 interface Order3000ClientConfig {
     clientId: string;
     clientSecret: string;
@@ -677,6 +858,7 @@ interface Order3000ClientConfig {
     tokenUrl?: string;
 }
 declare class Order3000Client {
+    baskets: BasketsResource;
     events: EventsResource;
     menus: MenusResource;
     orders: OrdersResource;
@@ -687,4 +869,4 @@ declare class Order3000Client {
     constructor(config: Order3000ClientConfig);
 }
 
-export { type CropArea, type Event, type EventPoster, type EventRow, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type Schedule, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type SubscriptionOptions, type TimeSlot };
+export { type AddToBasketRequest, type AddToBasketResponse, type Basket, type BasketItem, type BasketItemMenuItemRef, type BasketItemMetadata, type BasketStatus, type CropArea, type Currency, type DayOfWeek, type Event, type EventByAccessor, type EventMenu, type EventPoster, type EventRow, type GetEventOptions, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type RemoveFromBasketResponse, type Schedule, type ScheduleInfo, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type ScheduleTimeSlot, type ScheduleWithTimeSlots, type SubscriptionOptions, type TimeSlot, type Unit, getScheduleInfo };

package/dist/client.mjs

@@ -124,6 +124,49 @@ class BaseResource {
   }
 }
 
+class BasketsResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/baskets");
+  }
+  /**
+   * Get the current basket for a session
+   * @param sessionId - The session identifier (from cookie)
+   * @returns The basket with all items, or null if no basket exists
+   */
+  async get(sessionId) {
+    return this.request(
+      "GET",
+      `?sessionId=${encodeURIComponent(sessionId)}`
+    );
+  }
+  /**
+   * Add an item to the basket
+   * Creates basket and guest customer if they don't exist
+   * @param request - The add to basket request
+   * @returns The response with basket item ID and item count
+   */
+  async add(request) {
+    return this.request("POST", "/items", request);
+  }
+  /**
+   * Remove an item from the basket.
+   *
+   * Since each basket item represents a single physical product,
+   * removing it removes the entire item. There is no partial removal.
+   *
+   * @param sessionId - The session identifier
+   * @param basketItemId - The basket item ID to remove
+   * @returns The response with item count
+   */
+  async remove(sessionId, basketItemId) {
+    const params = new URLSearchParams({ sessionId });
+    return this.request(
+      "DELETE",
+      `/items/${basketItemId}?${params.toString()}`
+    );
+  }
+}
+
 class EventsResource extends BaseResource {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/events");
@@ -170,6 +213,20 @@ class EventsResource extends BaseResource {
   async get(eventId) {
     return this.request("GET", `/${eventId}`);
   }
+  /**
+   * Get an event by accessor (slug)
+   * @param accessor - The event accessor (e.g., 'lunch-menu')
+   * @param options - Optional expand options
+   * @returns The event with optional schedule, timeSlots, menus, and posters
+   */
+  async getByAccessor(accessor, options) {
+    const queryString = this.buildQueryString(options);
+    return this.request("GET", `/${accessor}${queryString}`);
+  }
+  buildQueryString(options) {
+    if (!options?.expand?.length) return "";
+    return `?expand=${options.expand.join(",")}`;
+  }
 }
 
 class MenusResource extends BaseResource {
@@ -441,11 +498,126 @@ class RealtimeManager {
   }
 }
 
+const ALL_DAYS = [
+  "monday",
+  "tuesday",
+  "wednesday",
+  "thursday",
+  "friday",
+  "saturday",
+  "sunday"
+];
+const RRULE_DAY_MAP = {
+  MO: "monday",
+  TU: "tuesday",
+  WE: "wednesday",
+  TH: "thursday",
+  FR: "friday",
+  SA: "saturday",
+  SU: "sunday"
+};
+function parseDaysFromRRule(rrule) {
+  if (!rrule) {
+    return [];
+  }
+  const byDayMatch = rrule.match(/BYDAY=([^;]+)/);
+  if (!byDayMatch) {
+    return [];
+  }
+  const rruleDays = byDayMatch[1].split(",");
+  const days = [];
+  for (const rruleDay of rruleDays) {
+    const day = RRULE_DAY_MAP[rruleDay.trim()];
+    if (day) {
+      days.push(day);
+    }
+  }
+  return ALL_DAYS.filter((day) => days.includes(day));
+}
+function addMinutesToTime(time, minutes) {
+  const parts = time.split(":");
+  const hours = parseInt(parts[0], 10);
+  const mins = parseInt(parts[1], 10);
+  const totalMinutes = hours * 60 + mins + minutes;
+  const newHours = Math.floor(totalMinutes / 60) % 24;
+  const newMins = totalMinutes % 60;
+  return `${newHours.toString().padStart(2, "0")}:${newMins.toString().padStart(2, "0")}`;
+}
+function formatTime(time) {
+  const parts = time.split(":");
+  if (parts.length >= 2) {
+    return `${parts[0]}:${parts[1]}`;
+  }
+  return time;
+}
+function getScheduleInfo(schedule) {
+  const defaultData = {
+    timeRange: null,
+    activeDays: []
+  };
+  if (!schedule?.scheduleTimeSlots?.length) {
+    return defaultData;
+  }
+  const timeSlots = schedule.scheduleTimeSlots;
+  const rrule = schedule.rrule;
+  const intervalMinutes = schedule.intervalMinutes ?? 30;
+  const activeDaysSet = /* @__PURE__ */ new Set();
+  let hasNullDayOfWeek = false;
+  const startTimes = [];
+  let latestEndTime = null;
+  for (const slot of timeSlots) {
+    if (slot.dayOfWeek) {
+      activeDaysSet.add(slot.dayOfWeek);
+    } else {
+      hasNullDayOfWeek = true;
+    }
+    if (slot.timeSlot.startTime) {
+      startTimes.push(slot.timeSlot.startTime);
+    }
+    if (slot.timeSlot.endTime) {
+      if (!latestEndTime || slot.timeSlot.endTime > latestEndTime) {
+        latestEndTime = slot.timeSlot.endTime;
+      }
+    }
+  }
+  let activeDays;
+  if (hasNullDayOfWeek) {
+    const rruleDays = parseDaysFromRRule(rrule);
+    if (rruleDays.length > 0) {
+      activeDays = rruleDays;
+    } else {
+      activeDays = ALL_DAYS.filter((day) => activeDaysSet.has(day));
+    }
+  } else {
+    activeDays = ALL_DAYS.filter((day) => activeDaysSet.has(day));
+  }
+  let timeRange = null;
+  if (startTimes.length > 0) {
+    startTimes.sort();
+    const earliestStart = startTimes[0];
+    const latestStart = startTimes[startTimes.length - 1];
+    let endTime;
+    if (latestEndTime) {
+      endTime = latestEndTime;
+    } else {
+      endTime = addMinutesToTime(latestStart, intervalMinutes);
+    }
+    const startFormatted = formatTime(earliestStart);
+    const endFormatted = formatTime(endTime);
+    timeRange = `${startFormatted}-${endFormatted}`;
+  }
+  return {
+    timeRange,
+    activeDays
+  };
+}
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Order3000Client {
   constructor(config) {
+    __publicField(this, "baskets");
     __publicField(this, "events");
     __publicField(this, "menus");
     __publicField(this, "orders");
@@ -461,6 +633,7 @@ class Order3000Client {
       tokenUrl,
       config.venueId
     );
+    this.baskets = new BasketsResource(this.tokenManager, this.baseUrl);
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
     this.menus = new MenusResource(this.tokenManager, this.baseUrl);
     this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
@@ -472,4 +645,4 @@ class Order3000Client {
   }
 }
 
-export { Order3000Client };
+export { Order3000Client, getScheduleInfo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "order3000",
-  "version": "0.8.2",
+  "version": "0.10.0",
   "description": "order3000 node.js sdk",
   "main": "./dist/client.cjs",
   "module": "./dist/client.mjs",
@@ -29,8 +29,8 @@
     "prettier": "^3.7.4",
     "tsx": "^4.19.2",
     "typescript": "^5.9.3",
-    "@kolaveri/eslint-config": "1.0.9",
     "@kolaveri/prettier-config": "1.0.6",
+    "@kolaveri/eslint-config": "1.0.9",
     "@kolaveri/tsconfig": "1.0.1"
   },
   "files": [