order3000 0.7.2 → 0.8.0

package/dist/client.cjs

@@ -1,18 +1,20 @@
 'use strict';
 
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var supabaseJs = require('@supabase/supabase-js');
+
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
 class TokenManager {
   constructor(clientId, clientSecret, tokenEndpoint, userVenueId) {
     this.clientId = clientId;
     this.clientSecret = clientSecret;
     this.tokenEndpoint = tokenEndpoint;
     this.userVenueId = userVenueId;
-    __publicField$1(this, "accessToken", null);
-    __publicField$1(this, "tokenExpiresAt", 0);
-    __publicField$1(this, "refreshPromise", null);
-    __publicField$1(this, "defaultVenueId");
+    __publicField$3(this, "accessToken", null);
+    __publicField$3(this, "tokenExpiresAt", 0);
+    __publicField$3(this, "refreshPromise", null);
+    __publicField$3(this, "defaultVenueId");
   }
   async initialize() {
     await this.refreshToken();
@@ -172,6 +174,36 @@ class EventsResource extends BaseResource {
   }
 }
 
+class MenusResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/menus");
+  }
+  /**
+   * Get a menu by ID
+   * @param id - The menu UUID
+   * @param options - Optional expand options
+   * @returns The menu with optional items and assets
+   */
+  async get(id, options) {
+    const queryString = this.buildQueryString(options);
+    return this.request("GET", `/${id}${queryString}`);
+  }
+  /**
+   * Get a menu by accessor
+   * @param accessor - The menu accessor (slug)
+   * @param options - Optional expand options
+   * @returns The menu with optional items and assets
+   */
+  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 OrdersResource extends BaseResource {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/orders");
@@ -206,14 +238,221 @@ class ReservationsResource extends BaseResource {
   }
 }
 
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+class BaseRealtimeChannel {
+  constructor(manager, tableName) {
+    this.manager = manager;
+    this.tableName = tableName;
+    __publicField$2(this, "channels", /* @__PURE__ */ new Map());
+    __publicField$2(this, "supabaseClient", null);
+  }
+  async subscribe(options = {}) {
+    const client = await this.manager.getSupabaseClient();
+    this.supabaseClient = client;
+    const venueId = this.manager.getVenueId();
+    const channelName = `${this.tableName}:${venueId}:${Date.now()}`;
+    const filter = this.buildFilter(venueId, options.filter);
+    const requestedEvent = options.event || "*";
+    const channel = client.channel(channelName).on(
+      "postgres_changes",
+      {
+        event: "*",
+        schema: "public",
+        table: this.tableName,
+        filter: filter || void 0
+      },
+      (payload) => {
+        if (requestedEvent !== "*" && payload.eventType !== requestedEvent) {
+          return;
+        }
+        this.handlePayload(payload, options);
+      }
+    ).subscribe((status) => {
+      options.onStatusChange?.(status);
+      if (status === "CHANNEL_ERROR" || status === "TIMED_OUT") {
+        options.onError?.(new Error(`Channel ${status}: ${channelName}`));
+      }
+    });
+    this.channels.set(channelName, channel);
+    return {
+      channelName,
+      unsubscribe: async () => {
+        await client.removeChannel(channel);
+        this.channels.delete(channelName);
+      }
+    };
+  }
+  buildFilter(venueId, additionalFilter) {
+    const baseFilter = `venue_id=eq.${venueId}`;
+    return additionalFilter ? `${baseFilter},${additionalFilter}` : baseFilter;
+  }
+  handlePayload(payload, options) {
+    options.onChange?.(payload);
+    switch (payload.eventType) {
+      case "INSERT":
+        options.onInsert?.(payload.new);
+        break;
+      case "UPDATE":
+        options.onUpdate?.(payload.new, payload.old);
+        break;
+      case "DELETE":
+        options.onDelete?.(payload.old);
+        break;
+    }
+  }
+  async unsubscribeAll() {
+    if (!this.supabaseClient) return;
+    for (const [, channel] of this.channels) {
+      await this.supabaseClient.removeChannel(channel);
+    }
+    this.channels.clear();
+  }
+}
+
+class MenuItemsChannel extends BaseRealtimeChannel {
+  constructor(manager) {
+    super(manager, "menu_items");
+  }
+  // menu_items doesn't have venue_id directly, so we filter by menu_id
+  // RLS policy handles security, client filters by menu_id
+  buildFilter(_venueId, additionalFilter) {
+    return additionalFilter || "";
+  }
+  /**
+   * Subscribe to changes for a specific menu's items
+   */
+  async subscribeToMenu(menuId, options = {}) {
+    return this.subscribe({
+      ...options,
+      filter: `menu_id=eq.${menuId}`
+    });
+  }
+}
+
+class EventsChannel extends BaseRealtimeChannel {
+  constructor(manager) {
+    super(manager, "events");
+  }
+  /**
+   * Subscribe to changes for a specific event
+   */
+  async subscribeToEvent(eventId, options = {}) {
+    return this.subscribe({
+      ...options,
+      filter: `id=eq.${eventId}`
+    });
+  }
+}
+
+class ScheduleOverridesChannel extends BaseRealtimeChannel {
+  constructor(manager) {
+    super(manager, "schedule_overrides");
+  }
+  // schedule_overrides doesn't have venue_id
+  buildFilter(_venueId, additionalFilter) {
+    return additionalFilter || "";
+  }
+  /**
+   * Subscribe to changes for a specific schedule's overrides
+   */
+  async subscribeToSchedule(scheduleId, options = {}) {
+    return this.subscribe({
+      ...options,
+      filter: `schedule_id=eq.${scheduleId}`
+    });
+  }
+}
+
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+class RealtimeManager {
+  constructor(tokenManager, baseUrl) {
+    this.tokenManager = tokenManager;
+    this.baseUrl = baseUrl;
+    __publicField$1(this, "supabaseClient", null);
+    __publicField$1(this, "configPromise", null);
+    __publicField$1(this, "menuItems");
+    __publicField$1(this, "events");
+    __publicField$1(this, "scheduleOverrides");
+    this.menuItems = new MenuItemsChannel(this);
+    this.events = new EventsChannel(this);
+    this.scheduleOverrides = new ScheduleOverridesChannel(this);
+  }
+  /**
+   * Fetch realtime config from the order3000 backend.
+   * This keeps Supabase as an internal implementation detail.
+   */
+  async fetchRealtimeConfig() {
+    if (!this.configPromise) {
+      this.configPromise = (async () => {
+        const token = await this.tokenManager.getToken();
+        const response = await fetch(
+          `${this.baseUrl}/m2m/realtime-config`,
+          {
+            headers: { Authorization: `Bearer ${token}` }
+          }
+        );
+        if (!response.ok) {
+          throw new Error(`Failed to fetch realtime config: ${response.status}`);
+        }
+        return response.json();
+      })();
+    }
+    return this.configPromise;
+  }
+  async getSupabaseClient() {
+    if (!this.supabaseClient) {
+      const config = await this.fetchRealtimeConfig();
+      this.supabaseClient = supabaseJs.createClient(config.url, config.anonKey, {
+        auth: {
+          persistSession: false,
+          autoRefreshToken: false
+        },
+        realtime: {
+          params: {
+            eventsPerSecond: 10
+          }
+        }
+      });
+    }
+    return this.supabaseClient;
+  }
+  getVenueId() {
+    return this.tokenManager.getVenueId();
+  }
+  /**
+   * Get the realtime configuration (Supabase URL and anon key).
+   * Use this to pass the config to client-side code for establishing
+   * realtime connections from the browser.
+   */
+  async getConfig() {
+    return this.fetchRealtimeConfig();
+  }
+  async disconnectAll() {
+    await Promise.all([
+      this.menuItems.unsubscribeAll(),
+      this.events.unsubscribeAll(),
+      this.scheduleOverrides.unsubscribeAll()
+    ]);
+    if (this.supabaseClient) {
+      await this.supabaseClient.removeAllChannels();
+    }
+  }
+}
+
 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, "events");
+    __publicField(this, "menus");
     __publicField(this, "orders");
     __publicField(this, "reservations");
+    __publicField(this, "realtime");
     __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
     this.baseUrl = config.baseUrl || "https://order3000.com/api";
@@ -225,11 +464,13 @@ class Order3000Client {
       config.venueId
     );
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
+    this.menus = new MenusResource(this.tokenManager, this.baseUrl);
     this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
     this.reservations = new ReservationsResource(
       this.tokenManager,
       this.baseUrl
     );
+    this.realtime = new RealtimeManager(this.tokenManager, this.baseUrl);
   }
 }
 

package/dist/client.d.cts

@@ -1,3 +1,5 @@
+import { RealtimePostgresChangesPayload, RealtimeChannel, SupabaseClient } from '@supabase/supabase-js';
+
 declare class TokenManager {
     private readonly clientId;
     private readonly clientSecret;
@@ -34,13 +36,14 @@ interface components {
             venueId: string;
             basketId: string;
             /** @enum {string} */
-            status?: "DRAFT" | "PENDING" | "PAID" | "FULFILLED" | "CANCELLED" | "REFUNDED";
+            status?: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId?: string | null;
             /** @enum {string|null} */
-            paymentMethod?: "CARD" | "CASH" | "VOUCHER" | null;
-            taxAmount: string;
-            totalAmount: string;
-            currency?: string;
+            paymentMethod?: "card" | "cash" | "voucher" | null;
+            taxAmount: number;
+            totalAmount: number;
+            /** @enum {string} */
+            currency?: "EUR" | "CHF";
             orderedAt?: unknown;
             orderedBy: string;
             updatedAt?: unknown;
@@ -52,13 +55,14 @@ interface components {
             venueId: string;
             basketId: string;
             /** @enum {string} */
-            status: "DRAFT" | "PENDING" | "PAID" | "FULFILLED" | "CANCELLED" | "REFUNDED";
+            status: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId: string | null;
             /** @enum {string|null} */
-            paymentMethod: "CARD" | "CASH" | "VOUCHER" | null;
-            taxAmount: string;
-            totalAmount: string;
-            currency: string;
+            paymentMethod: "card" | "cash" | "voucher" | null;
+            taxAmount: number;
+            totalAmount: number;
+            /** @enum {string} */
+            currency: "EUR" | "CHF";
             orderedAt: unknown;
             orderedBy: string;
             updatedAt: unknown;
@@ -206,6 +210,7 @@ interface components {
          * @description Request payload for creating a new event
          */
         CreateEventRequest: {
+            accessor?: string | null;
             name: (string | number | boolean | (null)) | {
                 [key: string]: unknown;
             } | unknown[];
@@ -223,16 +228,18 @@ interface components {
             bookingOpensAtDays?: number | null;
             bookingClosesAtHours?: number | null;
             isActive?: boolean;
-            isClosed?: boolean;
+            isFeatured?: boolean;
             priority?: number;
             schedule?: {
                 rrule?: string | null;
                 timezone?: string | null;
                 validFrom?: unknown;
                 validTo?: unknown;
-                startTime?: string | null;
-                endTime?: string | null;
-                lastSeatingTime?: string | null;
+                timeRanges: {
+                    startTime: string;
+                    endTime: string;
+                    lastSeatingTime?: string | null;
+                }[];
                 /** @enum {string|null} */
                 slotMode?: "interval" | "duration" | null;
                 intervalMinutes?: number | null;
@@ -246,6 +253,7 @@ interface components {
         CreateEventResponse: {
             id: string;
             venueId: string;
+            accessor: string | null;
             name: (string | number | boolean | (null)) | {
                 [key: string]: unknown;
             } | unknown[];
@@ -263,7 +271,7 @@ interface components {
             bookingOpensAtDays: number | null;
             bookingClosesAtHours: number | null;
             isActive: boolean;
-            isClosed: boolean;
+            isFeatured: boolean;
             priority: number;
             createdBy: string | null;
             updatedBy: string | null;
@@ -368,6 +376,8 @@ interface Event {
     bookingOpensAtDays: number | null;
     bookingClosesAtHours: number | null;
     isActive: boolean;
+    /** Whether this event should be displayed prominently in public-facing areas */
+    isFeatured: boolean;
     /** Priority for conflict resolution (higher = takes precedence) */
     priority: number;
     createdBy: string | null;
@@ -397,6 +407,60 @@ interface ListEventsOptions {
     upcomingWithinDays?: number;
 }
 type ListEventsResponse = Event[];
+type MenuItemType = 'dish' | 'beverage';
+interface MenuAsset {
+    id: string;
+    type: 'image' | 'video' | 'document';
+    tags: string[] | null;
+    filename: string;
+    contentType: string;
+    metadata: {
+        width?: number;
+        height?: number;
+        duration?: number;
+    } | null;
+    publicUrl: string;
+}
+interface MenuDish {
+    id: string;
+    accessor: string;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    isVegetarian: boolean | null;
+    isVegan: boolean | null;
+    isGlutenFree: boolean | null;
+    isDairyFree: boolean | null;
+    assets?: MenuAsset[];
+}
+interface MenuBeverage {
+    id: string;
+    accessor: string;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+}
+interface MenuItem {
+    id: string;
+    type: MenuItemType;
+    tags: string[] | null;
+    price: number;
+    currency: string;
+    isActive: boolean;
+    sortIndex: string | null;
+    dish: MenuDish | null;
+    beverage: MenuBeverage | null;
+}
+interface Menu {
+    id: string;
+    venueId: string;
+    accessor: string;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    items?: MenuItem[];
+}
+interface GetMenuOptions {
+    /** Expand related resources (items, assets) */
+    expand?: ('items' | 'assets')[];
+}
 
 declare class EventsResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -420,6 +484,25 @@ declare class EventsResource extends BaseResource {
     get(eventId: string): Promise<Event>;
 }
 
+declare class MenusResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Get a menu by ID
+     * @param id - The menu UUID
+     * @param options - Optional expand options
+     * @returns The menu with optional items and assets
+     */
+    get(id: string, options?: GetMenuOptions): Promise<Menu>;
+    /**
+     * Get a menu by accessor
+     * @param accessor - The menu accessor (slug)
+     * @param options - Optional expand options
+     * @returns The menu with optional items and assets
+     */
+    getByAccessor(accessor: string, options?: GetMenuOptions): Promise<Menu>;
+    private buildQueryString;
+}
+
 declare class OrdersResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
     place(order: PlaceOrderRequest): Promise<PlaceOrderResponse>;
@@ -442,6 +525,127 @@ declare class ReservationsResource extends BaseResource {
     get(reservationId: string): Promise<MakeReservationResponse>;
 }
 
+type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+type RealtimeRow = {
+    [key: string]: any;
+};
+interface SubscriptionOptions<T extends RealtimeRow> {
+    event?: RealtimeEvent;
+    filter?: string;
+    onInsert?: (record: T) => void;
+    onUpdate?: (newRecord: T, oldRecord: T) => void;
+    onDelete?: (oldRecord: T) => void;
+    onChange?: (payload: RealtimePostgresChangesPayload<T>) => void;
+    onError?: (error: Error) => void;
+    onStatusChange?: (status: 'SUBSCRIBED' | 'CLOSED' | 'CHANNEL_ERROR' | 'TIMED_OUT') => void;
+}
+interface RealtimeSubscription {
+    unsubscribe: () => Promise<void>;
+    channelName: string;
+}
+interface MenuItemRow {
+    id: string;
+    menu_id: string;
+    type: 'dish' | 'beverage';
+    dish_id: string | null;
+    beverage_id: string | null;
+    price: number;
+    currency: string;
+    is_active: boolean;
+    tags: string[] | null;
+    sort_index: string | null;
+}
+interface EventRow {
+    id: string;
+    venue_id: string;
+    accessor: string;
+    name: Record<string, string>;
+    is_public: boolean;
+    is_active: boolean;
+    schedule_id: string | null;
+}
+interface ScheduleRow {
+    id: string;
+    name: Record<string, string>;
+    is_active: boolean;
+    valid_from: string | null;
+    valid_to: string | null;
+}
+interface ScheduleOverrideRow {
+    id: string;
+    schedule_id: string;
+    date: string;
+    reason: Record<string, string> | null;
+    is_active: boolean;
+}
+
+declare abstract class BaseRealtimeChannel<T extends RealtimeRow> {
+    protected readonly manager: RealtimeManager;
+    protected readonly tableName: string;
+    protected channels: Map<string, RealtimeChannel>;
+    private supabaseClient;
+    constructor(manager: RealtimeManager, tableName: string);
+    subscribe(options?: SubscriptionOptions<T>): Promise<RealtimeSubscription>;
+    protected buildFilter(venueId: string, additionalFilter?: string): string;
+    private handlePayload;
+    unsubscribeAll(): Promise<void>;
+}
+
+declare class MenuItemsChannel extends BaseRealtimeChannel<MenuItemRow> {
+    constructor(manager: RealtimeManager);
+    protected buildFilter(_venueId: string, additionalFilter?: string): string;
+    /**
+     * Subscribe to changes for a specific menu's items
+     */
+    subscribeToMenu(menuId: string, options?: Omit<SubscriptionOptions<MenuItemRow>, 'filter'>): Promise<RealtimeSubscription>;
+}
+
+declare class EventsChannel extends BaseRealtimeChannel<EventRow> {
+    constructor(manager: RealtimeManager);
+    /**
+     * Subscribe to changes for a specific event
+     */
+    subscribeToEvent(eventId: string, options?: Omit<SubscriptionOptions<EventRow>, 'filter'>): Promise<RealtimeSubscription>;
+}
+
+declare class ScheduleOverridesChannel extends BaseRealtimeChannel<ScheduleOverrideRow> {
+    constructor(manager: RealtimeManager);
+    protected buildFilter(_venueId: string, additionalFilter?: string): string;
+    /**
+     * Subscribe to changes for a specific schedule's overrides
+     */
+    subscribeToSchedule(scheduleId: string, options?: Omit<SubscriptionOptions<ScheduleOverrideRow>, 'filter'>): Promise<RealtimeSubscription>;
+}
+
+interface RealtimeConfig {
+    url: string;
+    anonKey: string;
+}
+declare class RealtimeManager {
+    private readonly tokenManager;
+    private readonly baseUrl;
+    private supabaseClient;
+    private configPromise;
+    menuItems: MenuItemsChannel;
+    events: EventsChannel;
+    scheduleOverrides: ScheduleOverridesChannel;
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Fetch realtime config from the order3000 backend.
+     * This keeps Supabase as an internal implementation detail.
+     */
+    private fetchRealtimeConfig;
+    getSupabaseClient(): Promise<SupabaseClient>;
+    getVenueId(): string;
+    /**
+     * Get the realtime configuration (Supabase URL and anon key).
+     * Use this to pass the config to client-side code for establishing
+     * realtime connections from the browser.
+     */
+    getConfig(): Promise<RealtimeConfig>;
+    disconnectAll(): Promise<void>;
+}
+
 interface Order3000ClientConfig {
     clientId: string;
     clientSecret: string;
@@ -459,11 +663,13 @@ interface Order3000ClientConfig {
 }
 declare class Order3000Client {
     events: EventsResource;
+    menus: MenusResource;
     orders: OrdersResource;
     reservations: ReservationsResource;
+    realtime: RealtimeManager;
     private readonly baseUrl;
     private readonly tokenManager;
     constructor(config: Order3000ClientConfig);
 }
 
-export { type Event, type EventPoster, type ListEventsOptions, type ListEventsResponse, Order3000Client, type Order3000ClientConfig, type Promotion, type Schedule, type ScheduleOverride, type TimeSlot };
+export { 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 };

package/dist/client.d.mts

@@ -1,3 +1,5 @@
+import { RealtimePostgresChangesPayload, RealtimeChannel, SupabaseClient } from '@supabase/supabase-js';
+
 declare class TokenManager {
     private readonly clientId;
     private readonly clientSecret;
@@ -34,13 +36,14 @@ interface components {
             venueId: string;
             basketId: string;
             /** @enum {string} */
-            status?: "DRAFT" | "PENDING" | "PAID" | "FULFILLED" | "CANCELLED" | "REFUNDED";
+            status?: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId?: string | null;
             /** @enum {string|null} */
-            paymentMethod?: "CARD" | "CASH" | "VOUCHER" | null;
-            taxAmount: string;
-            totalAmount: string;
-            currency?: string;
+            paymentMethod?: "card" | "cash" | "voucher" | null;
+            taxAmount: number;
+            totalAmount: number;
+            /** @enum {string} */
+            currency?: "EUR" | "CHF";
             orderedAt?: unknown;
             orderedBy: string;
             updatedAt?: unknown;
@@ -52,13 +55,14 @@ interface components {
             venueId: string;
             basketId: string;
             /** @enum {string} */
-            status: "DRAFT" | "PENDING" | "PAID" | "FULFILLED" | "CANCELLED" | "REFUNDED";
+            status: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId: string | null;
             /** @enum {string|null} */
-            paymentMethod: "CARD" | "CASH" | "VOUCHER" | null;
-            taxAmount: string;
-            totalAmount: string;
-            currency: string;
+            paymentMethod: "card" | "cash" | "voucher" | null;
+            taxAmount: number;
+            totalAmount: number;
+            /** @enum {string} */
+            currency: "EUR" | "CHF";
             orderedAt: unknown;
             orderedBy: string;
             updatedAt: unknown;
@@ -206,6 +210,7 @@ interface components {
          * @description Request payload for creating a new event
          */
         CreateEventRequest: {
+            accessor?: string | null;
             name: (string | number | boolean | (null)) | {
                 [key: string]: unknown;
             } | unknown[];
@@ -223,16 +228,18 @@ interface components {
             bookingOpensAtDays?: number | null;
             bookingClosesAtHours?: number | null;
             isActive?: boolean;
-            isClosed?: boolean;
+            isFeatured?: boolean;
             priority?: number;
             schedule?: {
                 rrule?: string | null;
                 timezone?: string | null;
                 validFrom?: unknown;
                 validTo?: unknown;
-                startTime?: string | null;
-                endTime?: string | null;
-                lastSeatingTime?: string | null;
+                timeRanges: {
+                    startTime: string;
+                    endTime: string;
+                    lastSeatingTime?: string | null;
+                }[];
                 /** @enum {string|null} */
                 slotMode?: "interval" | "duration" | null;
                 intervalMinutes?: number | null;
@@ -246,6 +253,7 @@ interface components {
         CreateEventResponse: {
             id: string;
             venueId: string;
+            accessor: string | null;
             name: (string | number | boolean | (null)) | {
                 [key: string]: unknown;
             } | unknown[];
@@ -263,7 +271,7 @@ interface components {
             bookingOpensAtDays: number | null;
             bookingClosesAtHours: number | null;
             isActive: boolean;
-            isClosed: boolean;
+            isFeatured: boolean;
             priority: number;
             createdBy: string | null;
             updatedBy: string | null;
@@ -368,6 +376,8 @@ interface Event {
     bookingOpensAtDays: number | null;
     bookingClosesAtHours: number | null;
     isActive: boolean;
+    /** Whether this event should be displayed prominently in public-facing areas */
+    isFeatured: boolean;
     /** Priority for conflict resolution (higher = takes precedence) */
     priority: number;
     createdBy: string | null;
@@ -397,6 +407,60 @@ interface ListEventsOptions {
     upcomingWithinDays?: number;
 }
 type ListEventsResponse = Event[];
+type MenuItemType = 'dish' | 'beverage';
+interface MenuAsset {
+    id: string;
+    type: 'image' | 'video' | 'document';
+    tags: string[] | null;
+    filename: string;
+    contentType: string;
+    metadata: {
+        width?: number;
+        height?: number;
+        duration?: number;
+    } | null;
+    publicUrl: string;
+}
+interface MenuDish {
+    id: string;
+    accessor: string;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    isVegetarian: boolean | null;
+    isVegan: boolean | null;
+    isGlutenFree: boolean | null;
+    isDairyFree: boolean | null;
+    assets?: MenuAsset[];
+}
+interface MenuBeverage {
+    id: string;
+    accessor: string;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+}
+interface MenuItem {
+    id: string;
+    type: MenuItemType;
+    tags: string[] | null;
+    price: number;
+    currency: string;
+    isActive: boolean;
+    sortIndex: string | null;
+    dish: MenuDish | null;
+    beverage: MenuBeverage | null;
+}
+interface Menu {
+    id: string;
+    venueId: string;
+    accessor: string;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    items?: MenuItem[];
+}
+interface GetMenuOptions {
+    /** Expand related resources (items, assets) */
+    expand?: ('items' | 'assets')[];
+}
 
 declare class EventsResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -420,6 +484,25 @@ declare class EventsResource extends BaseResource {
     get(eventId: string): Promise<Event>;
 }
 
+declare class MenusResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Get a menu by ID
+     * @param id - The menu UUID
+     * @param options - Optional expand options
+     * @returns The menu with optional items and assets
+     */
+    get(id: string, options?: GetMenuOptions): Promise<Menu>;
+    /**
+     * Get a menu by accessor
+     * @param accessor - The menu accessor (slug)
+     * @param options - Optional expand options
+     * @returns The menu with optional items and assets
+     */
+    getByAccessor(accessor: string, options?: GetMenuOptions): Promise<Menu>;
+    private buildQueryString;
+}
+
 declare class OrdersResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
     place(order: PlaceOrderRequest): Promise<PlaceOrderResponse>;
@@ -442,6 +525,127 @@ declare class ReservationsResource extends BaseResource {
     get(reservationId: string): Promise<MakeReservationResponse>;
 }
 
+type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+type RealtimeRow = {
+    [key: string]: any;
+};
+interface SubscriptionOptions<T extends RealtimeRow> {
+    event?: RealtimeEvent;
+    filter?: string;
+    onInsert?: (record: T) => void;
+    onUpdate?: (newRecord: T, oldRecord: T) => void;
+    onDelete?: (oldRecord: T) => void;
+    onChange?: (payload: RealtimePostgresChangesPayload<T>) => void;
+    onError?: (error: Error) => void;
+    onStatusChange?: (status: 'SUBSCRIBED' | 'CLOSED' | 'CHANNEL_ERROR' | 'TIMED_OUT') => void;
+}
+interface RealtimeSubscription {
+    unsubscribe: () => Promise<void>;
+    channelName: string;
+}
+interface MenuItemRow {
+    id: string;
+    menu_id: string;
+    type: 'dish' | 'beverage';
+    dish_id: string | null;
+    beverage_id: string | null;
+    price: number;
+    currency: string;
+    is_active: boolean;
+    tags: string[] | null;
+    sort_index: string | null;
+}
+interface EventRow {
+    id: string;
+    venue_id: string;
+    accessor: string;
+    name: Record<string, string>;
+    is_public: boolean;
+    is_active: boolean;
+    schedule_id: string | null;
+}
+interface ScheduleRow {
+    id: string;
+    name: Record<string, string>;
+    is_active: boolean;
+    valid_from: string | null;
+    valid_to: string | null;
+}
+interface ScheduleOverrideRow {
+    id: string;
+    schedule_id: string;
+    date: string;
+    reason: Record<string, string> | null;
+    is_active: boolean;
+}
+
+declare abstract class BaseRealtimeChannel<T extends RealtimeRow> {
+    protected readonly manager: RealtimeManager;
+    protected readonly tableName: string;
+    protected channels: Map<string, RealtimeChannel>;
+    private supabaseClient;
+    constructor(manager: RealtimeManager, tableName: string);
+    subscribe(options?: SubscriptionOptions<T>): Promise<RealtimeSubscription>;
+    protected buildFilter(venueId: string, additionalFilter?: string): string;
+    private handlePayload;
+    unsubscribeAll(): Promise<void>;
+}
+
+declare class MenuItemsChannel extends BaseRealtimeChannel<MenuItemRow> {
+    constructor(manager: RealtimeManager);
+    protected buildFilter(_venueId: string, additionalFilter?: string): string;
+    /**
+     * Subscribe to changes for a specific menu's items
+     */
+    subscribeToMenu(menuId: string, options?: Omit<SubscriptionOptions<MenuItemRow>, 'filter'>): Promise<RealtimeSubscription>;
+}
+
+declare class EventsChannel extends BaseRealtimeChannel<EventRow> {
+    constructor(manager: RealtimeManager);
+    /**
+     * Subscribe to changes for a specific event
+     */
+    subscribeToEvent(eventId: string, options?: Omit<SubscriptionOptions<EventRow>, 'filter'>): Promise<RealtimeSubscription>;
+}
+
+declare class ScheduleOverridesChannel extends BaseRealtimeChannel<ScheduleOverrideRow> {
+    constructor(manager: RealtimeManager);
+    protected buildFilter(_venueId: string, additionalFilter?: string): string;
+    /**
+     * Subscribe to changes for a specific schedule's overrides
+     */
+    subscribeToSchedule(scheduleId: string, options?: Omit<SubscriptionOptions<ScheduleOverrideRow>, 'filter'>): Promise<RealtimeSubscription>;
+}
+
+interface RealtimeConfig {
+    url: string;
+    anonKey: string;
+}
+declare class RealtimeManager {
+    private readonly tokenManager;
+    private readonly baseUrl;
+    private supabaseClient;
+    private configPromise;
+    menuItems: MenuItemsChannel;
+    events: EventsChannel;
+    scheduleOverrides: ScheduleOverridesChannel;
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Fetch realtime config from the order3000 backend.
+     * This keeps Supabase as an internal implementation detail.
+     */
+    private fetchRealtimeConfig;
+    getSupabaseClient(): Promise<SupabaseClient>;
+    getVenueId(): string;
+    /**
+     * Get the realtime configuration (Supabase URL and anon key).
+     * Use this to pass the config to client-side code for establishing
+     * realtime connections from the browser.
+     */
+    getConfig(): Promise<RealtimeConfig>;
+    disconnectAll(): Promise<void>;
+}
+
 interface Order3000ClientConfig {
     clientId: string;
     clientSecret: string;
@@ -459,11 +663,13 @@ interface Order3000ClientConfig {
 }
 declare class Order3000Client {
     events: EventsResource;
+    menus: MenusResource;
     orders: OrdersResource;
     reservations: ReservationsResource;
+    realtime: RealtimeManager;
     private readonly baseUrl;
     private readonly tokenManager;
     constructor(config: Order3000ClientConfig);
 }
 
-export { type Event, type EventPoster, type ListEventsOptions, type ListEventsResponse, Order3000Client, type Order3000ClientConfig, type Promotion, type Schedule, type ScheduleOverride, type TimeSlot };
+export { 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 };

package/dist/client.mjs

@@ -1,16 +1,18 @@
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { createClient } from '@supabase/supabase-js';
+
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
 class TokenManager {
   constructor(clientId, clientSecret, tokenEndpoint, userVenueId) {
     this.clientId = clientId;
     this.clientSecret = clientSecret;
     this.tokenEndpoint = tokenEndpoint;
     this.userVenueId = userVenueId;
-    __publicField$1(this, "accessToken", null);
-    __publicField$1(this, "tokenExpiresAt", 0);
-    __publicField$1(this, "refreshPromise", null);
-    __publicField$1(this, "defaultVenueId");
+    __publicField$3(this, "accessToken", null);
+    __publicField$3(this, "tokenExpiresAt", 0);
+    __publicField$3(this, "refreshPromise", null);
+    __publicField$3(this, "defaultVenueId");
   }
   async initialize() {
     await this.refreshToken();
@@ -170,6 +172,36 @@ class EventsResource extends BaseResource {
   }
 }
 
+class MenusResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/menus");
+  }
+  /**
+   * Get a menu by ID
+   * @param id - The menu UUID
+   * @param options - Optional expand options
+   * @returns The menu with optional items and assets
+   */
+  async get(id, options) {
+    const queryString = this.buildQueryString(options);
+    return this.request("GET", `/${id}${queryString}`);
+  }
+  /**
+   * Get a menu by accessor
+   * @param accessor - The menu accessor (slug)
+   * @param options - Optional expand options
+   * @returns The menu with optional items and assets
+   */
+  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 OrdersResource extends BaseResource {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/orders");
@@ -204,14 +236,221 @@ class ReservationsResource extends BaseResource {
   }
 }
 
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+class BaseRealtimeChannel {
+  constructor(manager, tableName) {
+    this.manager = manager;
+    this.tableName = tableName;
+    __publicField$2(this, "channels", /* @__PURE__ */ new Map());
+    __publicField$2(this, "supabaseClient", null);
+  }
+  async subscribe(options = {}) {
+    const client = await this.manager.getSupabaseClient();
+    this.supabaseClient = client;
+    const venueId = this.manager.getVenueId();
+    const channelName = `${this.tableName}:${venueId}:${Date.now()}`;
+    const filter = this.buildFilter(venueId, options.filter);
+    const requestedEvent = options.event || "*";
+    const channel = client.channel(channelName).on(
+      "postgres_changes",
+      {
+        event: "*",
+        schema: "public",
+        table: this.tableName,
+        filter: filter || void 0
+      },
+      (payload) => {
+        if (requestedEvent !== "*" && payload.eventType !== requestedEvent) {
+          return;
+        }
+        this.handlePayload(payload, options);
+      }
+    ).subscribe((status) => {
+      options.onStatusChange?.(status);
+      if (status === "CHANNEL_ERROR" || status === "TIMED_OUT") {
+        options.onError?.(new Error(`Channel ${status}: ${channelName}`));
+      }
+    });
+    this.channels.set(channelName, channel);
+    return {
+      channelName,
+      unsubscribe: async () => {
+        await client.removeChannel(channel);
+        this.channels.delete(channelName);
+      }
+    };
+  }
+  buildFilter(venueId, additionalFilter) {
+    const baseFilter = `venue_id=eq.${venueId}`;
+    return additionalFilter ? `${baseFilter},${additionalFilter}` : baseFilter;
+  }
+  handlePayload(payload, options) {
+    options.onChange?.(payload);
+    switch (payload.eventType) {
+      case "INSERT":
+        options.onInsert?.(payload.new);
+        break;
+      case "UPDATE":
+        options.onUpdate?.(payload.new, payload.old);
+        break;
+      case "DELETE":
+        options.onDelete?.(payload.old);
+        break;
+    }
+  }
+  async unsubscribeAll() {
+    if (!this.supabaseClient) return;
+    for (const [, channel] of this.channels) {
+      await this.supabaseClient.removeChannel(channel);
+    }
+    this.channels.clear();
+  }
+}
+
+class MenuItemsChannel extends BaseRealtimeChannel {
+  constructor(manager) {
+    super(manager, "menu_items");
+  }
+  // menu_items doesn't have venue_id directly, so we filter by menu_id
+  // RLS policy handles security, client filters by menu_id
+  buildFilter(_venueId, additionalFilter) {
+    return additionalFilter || "";
+  }
+  /**
+   * Subscribe to changes for a specific menu's items
+   */
+  async subscribeToMenu(menuId, options = {}) {
+    return this.subscribe({
+      ...options,
+      filter: `menu_id=eq.${menuId}`
+    });
+  }
+}
+
+class EventsChannel extends BaseRealtimeChannel {
+  constructor(manager) {
+    super(manager, "events");
+  }
+  /**
+   * Subscribe to changes for a specific event
+   */
+  async subscribeToEvent(eventId, options = {}) {
+    return this.subscribe({
+      ...options,
+      filter: `id=eq.${eventId}`
+    });
+  }
+}
+
+class ScheduleOverridesChannel extends BaseRealtimeChannel {
+  constructor(manager) {
+    super(manager, "schedule_overrides");
+  }
+  // schedule_overrides doesn't have venue_id
+  buildFilter(_venueId, additionalFilter) {
+    return additionalFilter || "";
+  }
+  /**
+   * Subscribe to changes for a specific schedule's overrides
+   */
+  async subscribeToSchedule(scheduleId, options = {}) {
+    return this.subscribe({
+      ...options,
+      filter: `schedule_id=eq.${scheduleId}`
+    });
+  }
+}
+
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+class RealtimeManager {
+  constructor(tokenManager, baseUrl) {
+    this.tokenManager = tokenManager;
+    this.baseUrl = baseUrl;
+    __publicField$1(this, "supabaseClient", null);
+    __publicField$1(this, "configPromise", null);
+    __publicField$1(this, "menuItems");
+    __publicField$1(this, "events");
+    __publicField$1(this, "scheduleOverrides");
+    this.menuItems = new MenuItemsChannel(this);
+    this.events = new EventsChannel(this);
+    this.scheduleOverrides = new ScheduleOverridesChannel(this);
+  }
+  /**
+   * Fetch realtime config from the order3000 backend.
+   * This keeps Supabase as an internal implementation detail.
+   */
+  async fetchRealtimeConfig() {
+    if (!this.configPromise) {
+      this.configPromise = (async () => {
+        const token = await this.tokenManager.getToken();
+        const response = await fetch(
+          `${this.baseUrl}/m2m/realtime-config`,
+          {
+            headers: { Authorization: `Bearer ${token}` }
+          }
+        );
+        if (!response.ok) {
+          throw new Error(`Failed to fetch realtime config: ${response.status}`);
+        }
+        return response.json();
+      })();
+    }
+    return this.configPromise;
+  }
+  async getSupabaseClient() {
+    if (!this.supabaseClient) {
+      const config = await this.fetchRealtimeConfig();
+      this.supabaseClient = createClient(config.url, config.anonKey, {
+        auth: {
+          persistSession: false,
+          autoRefreshToken: false
+        },
+        realtime: {
+          params: {
+            eventsPerSecond: 10
+          }
+        }
+      });
+    }
+    return this.supabaseClient;
+  }
+  getVenueId() {
+    return this.tokenManager.getVenueId();
+  }
+  /**
+   * Get the realtime configuration (Supabase URL and anon key).
+   * Use this to pass the config to client-side code for establishing
+   * realtime connections from the browser.
+   */
+  async getConfig() {
+    return this.fetchRealtimeConfig();
+  }
+  async disconnectAll() {
+    await Promise.all([
+      this.menuItems.unsubscribeAll(),
+      this.events.unsubscribeAll(),
+      this.scheduleOverrides.unsubscribeAll()
+    ]);
+    if (this.supabaseClient) {
+      await this.supabaseClient.removeAllChannels();
+    }
+  }
+}
+
 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, "events");
+    __publicField(this, "menus");
     __publicField(this, "orders");
     __publicField(this, "reservations");
+    __publicField(this, "realtime");
     __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
     this.baseUrl = config.baseUrl || "https://order3000.com/api";
@@ -223,11 +462,13 @@ class Order3000Client {
       config.venueId
     );
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
+    this.menus = new MenusResource(this.tokenManager, this.baseUrl);
     this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
     this.reservations = new ReservationsResource(
       this.tokenManager,
       this.baseUrl
     );
+    this.realtime = new RealtimeManager(this.tokenManager, this.baseUrl);
   }
 }
 

package/package.json

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