order3000 0.20.0 → 0.21.0

package/dist/client.cjs

@@ -211,6 +211,26 @@ class ArticlesResource extends BaseResource {
     const path = qs ? `?${qs}` : "";
     return this.request("GET", path);
   }
+  /**
+   * Fetch a single article by id or accessor within the active venue.
+   * Returns the full row including the TipTap `content` document.
+   */
+  async getByAccessor(idOrAccessor) {
+    return this.request("GET", `/${encodeURIComponent(idOrAccessor)}`);
+  }
+  /**
+   * Partial-update an article. Locale-keyed fields (slug, title, excerpt)
+   * merge at the locale level — `{ slug: { en: 'foo' } }` updates `en`
+   * without touching `de`. Plain scalar / array fields fully replace.
+   * Returns the resulting article.
+   */
+  async patch(idOrAccessor, body) {
+    return this.request(
+      "PATCH",
+      `/${encodeURIComponent(idOrAccessor)}`,
+      body
+    );
+  }
 }
 
 class BasketsResource extends BaseResource {
@@ -796,6 +816,44 @@ class TeamOrdersResource {
   }
 }
 
+class VenuesResource {
+  constructor(tokenManager, baseUrl) {
+    this.tokenManager = tokenManager;
+    this.baseUrl = baseUrl;
+  }
+  /**
+   * Fetch a venue by its UUID or its accessor (slug). The path accepts
+   * either form; the server resolves transparently.
+   *
+   * Powers the order3000-cli's `venues use <accessor>` validation step
+   * — the CLI hits this to prove the accessor exists and to cache the
+   * resolved UUID + display fields locally.
+   */
+  async getByAccessor(idOrAccessor) {
+    const token = await this.tokenManager.getToken();
+    const url = `${this.baseUrl}/venues/${encodeURIComponent(idOrAccessor)}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      cache: "no-store"
+    });
+    if (!response.ok) {
+      let body = "";
+      try {
+        body = await response.text();
+      } catch {
+      }
+      throw new Error(
+        `HTTP ${response.status}: ${response.statusText}${body ? ` \u2014 ${body}` : ""}`
+      );
+    }
+    return response.json();
+  }
+}
+
 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);
@@ -1130,6 +1188,7 @@ class Order3000Client {
     __publicField(this, "reservations");
     __publicField(this, "subscriptions");
     __publicField(this, "teamOrders");
+    __publicField(this, "venues");
     __publicField(this, "realtime");
     __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
@@ -1160,6 +1219,7 @@ class Order3000Client {
       this.baseUrl
     );
     this.teamOrders = new TeamOrdersResource(this.tokenManager, this.baseUrl);
+    this.venues = new VenuesResource(this.tokenManager, this.baseUrl);
     this.realtime = new RealtimeManager(this.tokenManager, this.baseUrl);
   }
 }

package/dist/client.d.cts

@@ -50,7 +50,7 @@ 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' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
+    protected request<T>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
 }
 
 interface components {
@@ -234,21 +234,99 @@ interface components {
             };
             excerpt: {
                 [key: string]: string;
-            };
+            } | null;
             content: {
                 [key: string]: unknown;
-            };
+            } | null;
             tags: string[];
             featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
-            publishedAt: string | null;
-            createdAt: string | null;
-            updatedAt: string | null;
+            publishedAt: unknown;
+            createdAt: unknown;
+            updatedAt: unknown;
         };
         /** ListArticlesResponse */
         ListArticlesResponse: components["schemas"]["Article"][];
+        /**
+         * GetArticleResponse
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         */
+        GetArticleResponse: {
+            id: string;
+            venueId: string;
+            accessor: string;
+            slug: {
+                [key: string]: string;
+            };
+            title: {
+                [key: string]: string;
+            };
+            excerpt: {
+                [key: string]: string;
+            } | null;
+            content: {
+                [key: string]: unknown;
+            } | null;
+            tags: string[];
+            featuredImageId: string | null;
+            isActive: boolean;
+            isFeatured: boolean;
+            priority: number;
+            publishedAt: unknown;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
+        /** PatchArticleRequest */
+        PatchArticleRequest: {
+            slug?: {
+                [key: string]: string;
+            };
+            title?: {
+                [key: string]: string;
+            };
+            excerpt?: {
+                [key: string]: string;
+            };
+            content?: {
+                [key: string]: unknown;
+            };
+            tags?: string[];
+            featuredImageId?: string | null;
+            isActive?: boolean;
+            isFeatured?: boolean;
+            priority?: number;
+        };
+        /**
+         * PatchArticleResponse
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         */
+        PatchArticleResponse: {
+            id: string;
+            venueId: string;
+            accessor: string;
+            slug: {
+                [key: string]: string;
+            };
+            title: {
+                [key: string]: string;
+            };
+            excerpt: {
+                [key: string]: string;
+            } | null;
+            content: {
+                [key: string]: unknown;
+            } | null;
+            tags: string[];
+            featuredImageId: string | null;
+            isActive: boolean;
+            isFeatured: boolean;
+            priority: number;
+            publishedAt: unknown;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
         /**
          * AddToBasketRequest
          * @description Add an item to the shopping basket
@@ -1097,6 +1175,23 @@ interface components {
             teamOrderId: string;
             deliveryAddressId: string;
         };
+        /**
+         * GetVenueResponse
+         * @description A venue. The public API exposes only the minimal id + accessor + naming + locale fields the CLI's `venues use` / `auth whoami` consume.
+         */
+        GetVenueResponse: {
+            id: string;
+            accessor: string;
+            officialName: string;
+            legalName: string;
+            shortName: string;
+            brandName: string;
+            primaryLocale: string;
+            supportedLocales: string[];
+            timezone: string;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
     };
     responses: never;
     parameters: never;
@@ -1110,6 +1205,9 @@ type CreateEventRequest = schemas['CreateEventRequest'];
 type CreateEventResponse = schemas['CreateEventResponse'];
 type Article = schemas['Article'];
 type ListArticlesResponse = schemas['ListArticlesResponse'];
+type GetArticleResponse = schemas['GetArticleResponse'];
+type PatchArticleRequest = schemas['PatchArticleRequest'];
+type PatchArticleResponse = schemas['PatchArticleResponse'];
 interface ListArticlesOptions {
     /** Only return articles whose `tags` array contains this value. */
     tag?: string;
@@ -1118,6 +1216,8 @@ interface ListArticlesOptions {
     /** When `true`, include articles whose `isActive` is `false`. Default `false`. */
     includeInactive?: boolean;
 }
+type Venue = schemas['Venue'];
+type GetVenueResponse = schemas['GetVenueResponse'];
 /**
  * Order fulfillment type - matches order_fulfillment_type enum in order3000 database.
  * Keep in sync with apps/order3000/src/drizzle/enums.ts
@@ -1907,6 +2007,18 @@ declare class ArticlesResource extends BaseResource {
      * for human-friendly node addressing.
      */
     list(options?: ListArticlesOptions): Promise<ListArticlesResponse>;
+    /**
+     * Fetch a single article by id or accessor within the active venue.
+     * Returns the full row including the TipTap `content` document.
+     */
+    getByAccessor(idOrAccessor: string): Promise<Article>;
+    /**
+     * Partial-update an article. Locale-keyed fields (slug, title, excerpt)
+     * merge at the locale level — `{ slug: { en: 'foo' } }` updates `en`
+     * without touching `de`. Plain scalar / array fields fully replace.
+     * Returns the resulting article.
+     */
+    patch(idOrAccessor: string, body: PatchArticleRequest): Promise<Article>;
 }
 
 declare class BasketsResource extends BaseResource {
@@ -2592,6 +2704,27 @@ declare class TeamOrdersResource {
     }): Promise<UpdateDeliveryAddressResponse>;
 }
 
+/**
+ * Reads at the venue level. Doesn't extend `BaseResource` because that
+ * class hard-codes a `/venues/{venueId}/<resourcePath>` URL template,
+ * which assumes a venue-scoped sub-resource. Venues themselves are AT
+ * `/venues/:venueIdOrAccessor` directly.
+ */
+declare class VenuesResource {
+    private readonly tokenManager;
+    private readonly baseUrl;
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Fetch a venue by its UUID or its accessor (slug). The path accepts
+     * either form; the server resolves transparently.
+     *
+     * Powers the order3000-cli's `venues use <accessor>` validation step
+     * — the CLI hits this to prove the accessor exists and to cache the
+     * resolved UUID + display fields locally.
+     */
+    getByAccessor(idOrAccessor: string): Promise<Venue>;
+}
+
 type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
 type RealtimeRow = {
     [key: string]: any;
@@ -2763,6 +2896,7 @@ declare class Order3000Client {
     reservations: ReservationsResource;
     subscriptions: SubscriptionsResource;
     teamOrders: TeamOrdersResource;
+    venues: VenuesResource;
     realtime: RealtimeManager;
     private readonly baseUrl;
     private readonly tokenManager;
@@ -2770,4 +2904,4 @@ declare class Order3000Client {
 }
 
 export { Order3000Client, fulfillmentTypeEnum, getScheduleInfo, participantStatusEnum, paymentMethodEnum, teamOrderStatusEnum };
-export type { AddToBasketRequest, AddToBasketResponse, Area, AreaAsset, AreaAvailabilityResponse, AreaAvailabilityWindow, AreaBookingMode, AreaBookingRequestResponse, AreaBookingRequestSource, AreaBookingRequestStatus, AreaBookingStatus, AreaFeature, Article, Basket, BasketItem, BasketItemDeposit, BasketItemMenuItemRef, BasketItemMetadata, BasketStatus, BasketTotals, CancelTeamOrderResponse, ConfirmOrderRequest, ConfirmOrderResponse, CreateDeltaPaymentIntentRequest, CreateDeltaPaymentIntentResponse, CreatePaymentIntentRequest, CreatePaymentIntentResponse, CreateTeamOrderRequest, CreateTeamOrderResponse, CropArea, Currency, DayOfWeek, DeclaredReturn, Event, EventByAccessor, EventMenu, EventPoster, EventRow, ExtendDeadlineResponse as ExtendTeamOrderDeadlineResponse, FetchTeamOrderResponse, GetAreaAvailabilityOptions, GetAreaOptions, GetEventOptions, GetMenuOptions, JoinTeamOrderRequest, JoinTeamOrderResponse, LatestOrder, ListArticlesOptions, ListArticlesResponse, ListEventsOptions, ListEventsResponse, Menu, MenuAsset, MenuBeverage, MenuBundle, MenuBundleDeposit, MenuDish, MenuItem, MenuItemRow, MenuItemType, MenuSubscription, MenuSubscriptionPoster, Order3000ClientConfig, OrderFulfillmentType, OrderStatus, PaymentStatus, PlaceOrderRequest, Promotion, RealtimeConfig, RealtimeEvent, RealtimeSubscription, RemoveFromBasketResponse, Schedule, ScheduleInfo, ScheduleOverride, ScheduleOverrideRow, ScheduleRow, ScheduleTimeSlot, ScheduleWithTimeSlots, SubmitAreaBookingRequestPayload, SubmitTeamOrderResponse, SubscribeRequest, SubscribeResponse, SubscriberStatus, SubscriptionCredit, SubscriptionCreditStatus, SubscriptionOptions, SubscriptionPeriod, SwitchFulfillmentResponse as SwitchTeamOrderFulfillmentResponse, TeamDeliveryAddress, TeamOrderBasketItem, TeamOrderBasketItemMenuItemRef, FulfillmentType as TeamOrderFulfillmentType, TeamOrderParticipant, ParticipantStatus as TeamOrderParticipantStatus, PaymentMethod as TeamOrderPaymentMethod, TeamOrderStatus, ThresholdCheck as TeamOrderThresholdCheck, TimeSlot, Unit, UpdateDeliveryAddressResponse as UpdateTeamOrderDeliveryAddressResponse };
+export type { AddToBasketRequest, AddToBasketResponse, Area, AreaAsset, AreaAvailabilityResponse, AreaAvailabilityWindow, AreaBookingMode, AreaBookingRequestResponse, AreaBookingRequestSource, AreaBookingRequestStatus, AreaBookingStatus, AreaFeature, Article, Basket, BasketItem, BasketItemDeposit, BasketItemMenuItemRef, BasketItemMetadata, BasketStatus, BasketTotals, CancelTeamOrderResponse, ConfirmOrderRequest, ConfirmOrderResponse, CreateDeltaPaymentIntentRequest, CreateDeltaPaymentIntentResponse, CreatePaymentIntentRequest, CreatePaymentIntentResponse, CreateTeamOrderRequest, CreateTeamOrderResponse, CropArea, Currency, DayOfWeek, DeclaredReturn, Event, EventByAccessor, EventMenu, EventPoster, EventRow, ExtendDeadlineResponse as ExtendTeamOrderDeadlineResponse, FetchTeamOrderResponse, GetAreaAvailabilityOptions, GetAreaOptions, GetArticleResponse, GetEventOptions, GetMenuOptions, GetVenueResponse, JoinTeamOrderRequest, JoinTeamOrderResponse, LatestOrder, ListArticlesOptions, ListArticlesResponse, ListEventsOptions, ListEventsResponse, Menu, MenuAsset, MenuBeverage, MenuBundle, MenuBundleDeposit, MenuDish, MenuItem, MenuItemRow, MenuItemType, MenuSubscription, MenuSubscriptionPoster, Order3000ClientConfig, OrderFulfillmentType, OrderStatus, PatchArticleRequest, PatchArticleResponse, PaymentStatus, PlaceOrderRequest, Promotion, RealtimeConfig, RealtimeEvent, RealtimeSubscription, RemoveFromBasketResponse, Schedule, ScheduleInfo, ScheduleOverride, ScheduleOverrideRow, ScheduleRow, ScheduleTimeSlot, ScheduleWithTimeSlots, SubmitAreaBookingRequestPayload, SubmitTeamOrderResponse, SubscribeRequest, SubscribeResponse, SubscriberStatus, SubscriptionCredit, SubscriptionCreditStatus, SubscriptionOptions, SubscriptionPeriod, SwitchFulfillmentResponse as SwitchTeamOrderFulfillmentResponse, TeamDeliveryAddress, TeamOrderBasketItem, TeamOrderBasketItemMenuItemRef, FulfillmentType as TeamOrderFulfillmentType, TeamOrderParticipant, ParticipantStatus as TeamOrderParticipantStatus, PaymentMethod as TeamOrderPaymentMethod, TeamOrderStatus, ThresholdCheck as TeamOrderThresholdCheck, TimeSlot, Unit, UpdateDeliveryAddressResponse as UpdateTeamOrderDeliveryAddressResponse, Venue };

package/dist/client.d.mts

@@ -50,7 +50,7 @@ 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' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
+    protected request<T>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
 }
 
 interface components {
@@ -234,21 +234,99 @@ interface components {
             };
             excerpt: {
                 [key: string]: string;
-            };
+            } | null;
             content: {
                 [key: string]: unknown;
-            };
+            } | null;
             tags: string[];
             featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
-            publishedAt: string | null;
-            createdAt: string | null;
-            updatedAt: string | null;
+            publishedAt: unknown;
+            createdAt: unknown;
+            updatedAt: unknown;
         };
         /** ListArticlesResponse */
         ListArticlesResponse: components["schemas"]["Article"][];
+        /**
+         * GetArticleResponse
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         */
+        GetArticleResponse: {
+            id: string;
+            venueId: string;
+            accessor: string;
+            slug: {
+                [key: string]: string;
+            };
+            title: {
+                [key: string]: string;
+            };
+            excerpt: {
+                [key: string]: string;
+            } | null;
+            content: {
+                [key: string]: unknown;
+            } | null;
+            tags: string[];
+            featuredImageId: string | null;
+            isActive: boolean;
+            isFeatured: boolean;
+            priority: number;
+            publishedAt: unknown;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
+        /** PatchArticleRequest */
+        PatchArticleRequest: {
+            slug?: {
+                [key: string]: string;
+            };
+            title?: {
+                [key: string]: string;
+            };
+            excerpt?: {
+                [key: string]: string;
+            };
+            content?: {
+                [key: string]: unknown;
+            };
+            tags?: string[];
+            featuredImageId?: string | null;
+            isActive?: boolean;
+            isFeatured?: boolean;
+            priority?: number;
+        };
+        /**
+         * PatchArticleResponse
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         */
+        PatchArticleResponse: {
+            id: string;
+            venueId: string;
+            accessor: string;
+            slug: {
+                [key: string]: string;
+            };
+            title: {
+                [key: string]: string;
+            };
+            excerpt: {
+                [key: string]: string;
+            } | null;
+            content: {
+                [key: string]: unknown;
+            } | null;
+            tags: string[];
+            featuredImageId: string | null;
+            isActive: boolean;
+            isFeatured: boolean;
+            priority: number;
+            publishedAt: unknown;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
         /**
          * AddToBasketRequest
          * @description Add an item to the shopping basket
@@ -1097,6 +1175,23 @@ interface components {
             teamOrderId: string;
             deliveryAddressId: string;
         };
+        /**
+         * GetVenueResponse
+         * @description A venue. The public API exposes only the minimal id + accessor + naming + locale fields the CLI's `venues use` / `auth whoami` consume.
+         */
+        GetVenueResponse: {
+            id: string;
+            accessor: string;
+            officialName: string;
+            legalName: string;
+            shortName: string;
+            brandName: string;
+            primaryLocale: string;
+            supportedLocales: string[];
+            timezone: string;
+            createdAt: unknown;
+            updatedAt: unknown;
+        };
     };
     responses: never;
     parameters: never;
@@ -1110,6 +1205,9 @@ type CreateEventRequest = schemas['CreateEventRequest'];
 type CreateEventResponse = schemas['CreateEventResponse'];
 type Article = schemas['Article'];
 type ListArticlesResponse = schemas['ListArticlesResponse'];
+type GetArticleResponse = schemas['GetArticleResponse'];
+type PatchArticleRequest = schemas['PatchArticleRequest'];
+type PatchArticleResponse = schemas['PatchArticleResponse'];
 interface ListArticlesOptions {
     /** Only return articles whose `tags` array contains this value. */
     tag?: string;
@@ -1118,6 +1216,8 @@ interface ListArticlesOptions {
     /** When `true`, include articles whose `isActive` is `false`. Default `false`. */
     includeInactive?: boolean;
 }
+type Venue = schemas['Venue'];
+type GetVenueResponse = schemas['GetVenueResponse'];
 /**
  * Order fulfillment type - matches order_fulfillment_type enum in order3000 database.
  * Keep in sync with apps/order3000/src/drizzle/enums.ts
@@ -1907,6 +2007,18 @@ declare class ArticlesResource extends BaseResource {
      * for human-friendly node addressing.
      */
     list(options?: ListArticlesOptions): Promise<ListArticlesResponse>;
+    /**
+     * Fetch a single article by id or accessor within the active venue.
+     * Returns the full row including the TipTap `content` document.
+     */
+    getByAccessor(idOrAccessor: string): Promise<Article>;
+    /**
+     * Partial-update an article. Locale-keyed fields (slug, title, excerpt)
+     * merge at the locale level — `{ slug: { en: 'foo' } }` updates `en`
+     * without touching `de`. Plain scalar / array fields fully replace.
+     * Returns the resulting article.
+     */
+    patch(idOrAccessor: string, body: PatchArticleRequest): Promise<Article>;
 }
 
 declare class BasketsResource extends BaseResource {
@@ -2592,6 +2704,27 @@ declare class TeamOrdersResource {
     }): Promise<UpdateDeliveryAddressResponse>;
 }
 
+/**
+ * Reads at the venue level. Doesn't extend `BaseResource` because that
+ * class hard-codes a `/venues/{venueId}/<resourcePath>` URL template,
+ * which assumes a venue-scoped sub-resource. Venues themselves are AT
+ * `/venues/:venueIdOrAccessor` directly.
+ */
+declare class VenuesResource {
+    private readonly tokenManager;
+    private readonly baseUrl;
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Fetch a venue by its UUID or its accessor (slug). The path accepts
+     * either form; the server resolves transparently.
+     *
+     * Powers the order3000-cli's `venues use <accessor>` validation step
+     * — the CLI hits this to prove the accessor exists and to cache the
+     * resolved UUID + display fields locally.
+     */
+    getByAccessor(idOrAccessor: string): Promise<Venue>;
+}
+
 type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
 type RealtimeRow = {
     [key: string]: any;
@@ -2763,6 +2896,7 @@ declare class Order3000Client {
     reservations: ReservationsResource;
     subscriptions: SubscriptionsResource;
     teamOrders: TeamOrdersResource;
+    venues: VenuesResource;
     realtime: RealtimeManager;
     private readonly baseUrl;
     private readonly tokenManager;
@@ -2770,4 +2904,4 @@ declare class Order3000Client {
 }
 
 export { Order3000Client, fulfillmentTypeEnum, getScheduleInfo, participantStatusEnum, paymentMethodEnum, teamOrderStatusEnum };
-export type { AddToBasketRequest, AddToBasketResponse, Area, AreaAsset, AreaAvailabilityResponse, AreaAvailabilityWindow, AreaBookingMode, AreaBookingRequestResponse, AreaBookingRequestSource, AreaBookingRequestStatus, AreaBookingStatus, AreaFeature, Article, Basket, BasketItem, BasketItemDeposit, BasketItemMenuItemRef, BasketItemMetadata, BasketStatus, BasketTotals, CancelTeamOrderResponse, ConfirmOrderRequest, ConfirmOrderResponse, CreateDeltaPaymentIntentRequest, CreateDeltaPaymentIntentResponse, CreatePaymentIntentRequest, CreatePaymentIntentResponse, CreateTeamOrderRequest, CreateTeamOrderResponse, CropArea, Currency, DayOfWeek, DeclaredReturn, Event, EventByAccessor, EventMenu, EventPoster, EventRow, ExtendDeadlineResponse as ExtendTeamOrderDeadlineResponse, FetchTeamOrderResponse, GetAreaAvailabilityOptions, GetAreaOptions, GetEventOptions, GetMenuOptions, JoinTeamOrderRequest, JoinTeamOrderResponse, LatestOrder, ListArticlesOptions, ListArticlesResponse, ListEventsOptions, ListEventsResponse, Menu, MenuAsset, MenuBeverage, MenuBundle, MenuBundleDeposit, MenuDish, MenuItem, MenuItemRow, MenuItemType, MenuSubscription, MenuSubscriptionPoster, Order3000ClientConfig, OrderFulfillmentType, OrderStatus, PaymentStatus, PlaceOrderRequest, Promotion, RealtimeConfig, RealtimeEvent, RealtimeSubscription, RemoveFromBasketResponse, Schedule, ScheduleInfo, ScheduleOverride, ScheduleOverrideRow, ScheduleRow, ScheduleTimeSlot, ScheduleWithTimeSlots, SubmitAreaBookingRequestPayload, SubmitTeamOrderResponse, SubscribeRequest, SubscribeResponse, SubscriberStatus, SubscriptionCredit, SubscriptionCreditStatus, SubscriptionOptions, SubscriptionPeriod, SwitchFulfillmentResponse as SwitchTeamOrderFulfillmentResponse, TeamDeliveryAddress, TeamOrderBasketItem, TeamOrderBasketItemMenuItemRef, FulfillmentType as TeamOrderFulfillmentType, TeamOrderParticipant, ParticipantStatus as TeamOrderParticipantStatus, PaymentMethod as TeamOrderPaymentMethod, TeamOrderStatus, ThresholdCheck as TeamOrderThresholdCheck, TimeSlot, Unit, UpdateDeliveryAddressResponse as UpdateTeamOrderDeliveryAddressResponse };
+export type { AddToBasketRequest, AddToBasketResponse, Area, AreaAsset, AreaAvailabilityResponse, AreaAvailabilityWindow, AreaBookingMode, AreaBookingRequestResponse, AreaBookingRequestSource, AreaBookingRequestStatus, AreaBookingStatus, AreaFeature, Article, Basket, BasketItem, BasketItemDeposit, BasketItemMenuItemRef, BasketItemMetadata, BasketStatus, BasketTotals, CancelTeamOrderResponse, ConfirmOrderRequest, ConfirmOrderResponse, CreateDeltaPaymentIntentRequest, CreateDeltaPaymentIntentResponse, CreatePaymentIntentRequest, CreatePaymentIntentResponse, CreateTeamOrderRequest, CreateTeamOrderResponse, CropArea, Currency, DayOfWeek, DeclaredReturn, Event, EventByAccessor, EventMenu, EventPoster, EventRow, ExtendDeadlineResponse as ExtendTeamOrderDeadlineResponse, FetchTeamOrderResponse, GetAreaAvailabilityOptions, GetAreaOptions, GetArticleResponse, GetEventOptions, GetMenuOptions, GetVenueResponse, JoinTeamOrderRequest, JoinTeamOrderResponse, LatestOrder, ListArticlesOptions, ListArticlesResponse, ListEventsOptions, ListEventsResponse, Menu, MenuAsset, MenuBeverage, MenuBundle, MenuBundleDeposit, MenuDish, MenuItem, MenuItemRow, MenuItemType, MenuSubscription, MenuSubscriptionPoster, Order3000ClientConfig, OrderFulfillmentType, OrderStatus, PatchArticleRequest, PatchArticleResponse, PaymentStatus, PlaceOrderRequest, Promotion, RealtimeConfig, RealtimeEvent, RealtimeSubscription, RemoveFromBasketResponse, Schedule, ScheduleInfo, ScheduleOverride, ScheduleOverrideRow, ScheduleRow, ScheduleTimeSlot, ScheduleWithTimeSlots, SubmitAreaBookingRequestPayload, SubmitTeamOrderResponse, SubscribeRequest, SubscribeResponse, SubscriberStatus, SubscriptionCredit, SubscriptionCreditStatus, SubscriptionOptions, SubscriptionPeriod, SwitchFulfillmentResponse as SwitchTeamOrderFulfillmentResponse, TeamDeliveryAddress, TeamOrderBasketItem, TeamOrderBasketItemMenuItemRef, FulfillmentType as TeamOrderFulfillmentType, TeamOrderParticipant, ParticipantStatus as TeamOrderParticipantStatus, PaymentMethod as TeamOrderPaymentMethod, TeamOrderStatus, ThresholdCheck as TeamOrderThresholdCheck, TimeSlot, Unit, UpdateDeliveryAddressResponse as UpdateTeamOrderDeliveryAddressResponse, Venue };

package/dist/client.mjs

@@ -209,6 +209,26 @@ class ArticlesResource extends BaseResource {
     const path = qs ? `?${qs}` : "";
     return this.request("GET", path);
   }
+  /**
+   * Fetch a single article by id or accessor within the active venue.
+   * Returns the full row including the TipTap `content` document.
+   */
+  async getByAccessor(idOrAccessor) {
+    return this.request("GET", `/${encodeURIComponent(idOrAccessor)}`);
+  }
+  /**
+   * Partial-update an article. Locale-keyed fields (slug, title, excerpt)
+   * merge at the locale level — `{ slug: { en: 'foo' } }` updates `en`
+   * without touching `de`. Plain scalar / array fields fully replace.
+   * Returns the resulting article.
+   */
+  async patch(idOrAccessor, body) {
+    return this.request(
+      "PATCH",
+      `/${encodeURIComponent(idOrAccessor)}`,
+      body
+    );
+  }
 }
 
 class BasketsResource extends BaseResource {
@@ -794,6 +814,44 @@ class TeamOrdersResource {
   }
 }
 
+class VenuesResource {
+  constructor(tokenManager, baseUrl) {
+    this.tokenManager = tokenManager;
+    this.baseUrl = baseUrl;
+  }
+  /**
+   * Fetch a venue by its UUID or its accessor (slug). The path accepts
+   * either form; the server resolves transparently.
+   *
+   * Powers the order3000-cli's `venues use <accessor>` validation step
+   * — the CLI hits this to prove the accessor exists and to cache the
+   * resolved UUID + display fields locally.
+   */
+  async getByAccessor(idOrAccessor) {
+    const token = await this.tokenManager.getToken();
+    const url = `${this.baseUrl}/venues/${encodeURIComponent(idOrAccessor)}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      cache: "no-store"
+    });
+    if (!response.ok) {
+      let body = "";
+      try {
+        body = await response.text();
+      } catch {
+      }
+      throw new Error(
+        `HTTP ${response.status}: ${response.statusText}${body ? ` \u2014 ${body}` : ""}`
+      );
+    }
+    return response.json();
+  }
+}
+
 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);
@@ -1128,6 +1186,7 @@ class Order3000Client {
     __publicField(this, "reservations");
     __publicField(this, "subscriptions");
     __publicField(this, "teamOrders");
+    __publicField(this, "venues");
     __publicField(this, "realtime");
     __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
@@ -1158,6 +1217,7 @@ class Order3000Client {
       this.baseUrl
     );
     this.teamOrders = new TeamOrdersResource(this.tokenManager, this.baseUrl);
+    this.venues = new VenuesResource(this.tokenManager, this.baseUrl);
     this.realtime = new RealtimeManager(this.tokenManager, this.baseUrl);
   }
 }

package/dist/schemas.cjs

@@ -9,8 +9,11 @@ const GetAreaAvailabilityResponse = zod.z.object({ from: zod.z.string().regex(/^
 const SubmitAreaBookingRequest = zod.z.object({ requestedDate: zod.z.string().regex(/^\d{4}-\d{2}-\d{2}$/), requestedStartTime: zod.z.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).optional(), requestedEndTime: zod.z.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).optional(), partySize: zod.z.number().int().lte(9007199254740991), customerFirstName: zod.z.string().min(1), customerLastName: zod.z.string().min(1), customerEmail: zod.z.string().regex(/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/).email(), customerPhone: zod.z.string().optional(), message: zod.z.string().optional(), source: zod.z.enum(["website", "phone", "walk_in"]).optional() }).strict();
 const SubmitAreaBookingResponse = zod.z.object({ id: zod.z.string(), venueId: zod.z.string(), areaId: zod.z.string(), requestedDate: zod.z.string().regex(/^\d{4}-\d{2}-\d{2}$/), requestedStartTime: zod.z.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).nullable(), requestedEndTime: zod.z.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).nullable(), partySize: zod.z.number().int().gte(-9007199254740991).lte(9007199254740991), customerFirstName: zod.z.string(), customerLastName: zod.z.string(), customerEmail: zod.z.string(), customerPhone: zod.z.string().nullable(), message: zod.z.string().nullable(), source: zod.z.enum(["website", "phone", "walk_in"]), status: zod.z.enum(["pending", "approved", "rejected", "cancelled"]), areaBookingId: zod.z.string().nullable(), createdAt: zod.z.string().nullable(), updatedAt: zod.z.string().nullable() }).strict();
 const includeDrafts = zod.z.union([zod.z.literal("true"), zod.z.literal("false")]).optional();
-const Article = zod.z.object({ id: zod.z.string(), venueId: zod.z.string(), accessor: zod.z.string(), slug: zod.z.record(zod.z.string()), title: zod.z.record(zod.z.string()), excerpt: zod.z.record(zod.z.string()), content: zod.z.object({}).partial().strict().passthrough(), tags: zod.z.array(zod.z.string()), featuredImageId: zod.z.string().nullable(), isActive: zod.z.boolean(), isFeatured: zod.z.boolean(), priority: zod.z.number().int().gte(-9007199254740991).lte(9007199254740991), publishedAt: zod.z.string().nullable(), createdAt: zod.z.string().nullable(), updatedAt: zod.z.string().nullable() }).strict();
+const Article = zod.z.object({ id: zod.z.string(), venueId: zod.z.string(), accessor: zod.z.string(), slug: zod.z.record(zod.z.string()), title: zod.z.record(zod.z.string()), excerpt: zod.z.record(zod.z.string()).nullable(), content: zod.z.object({}).partial().strict().passthrough().nullable(), tags: zod.z.array(zod.z.string()), featuredImageId: zod.z.string().nullable(), isActive: zod.z.boolean(), isFeatured: zod.z.boolean(), priority: zod.z.number().int().gte(-2147483648).lte(2147483647), publishedAt: zod.z.unknown().nullable(), createdAt: zod.z.unknown().nullable(), updatedAt: zod.z.unknown().nullable() }).strict();
 const ListArticlesResponse = zod.z.array(Article);
+const GetArticleResponse = zod.z.object({ id: zod.z.string(), venueId: zod.z.string(), accessor: zod.z.string(), slug: zod.z.record(zod.z.string()), title: zod.z.record(zod.z.string()), excerpt: zod.z.record(zod.z.string()).nullable(), content: zod.z.object({}).partial().strict().passthrough().nullable(), tags: zod.z.array(zod.z.string()), featuredImageId: zod.z.string().nullable(), isActive: zod.z.boolean(), isFeatured: zod.z.boolean(), priority: zod.z.number().int().gte(-2147483648).lte(2147483647), publishedAt: zod.z.unknown().nullable(), createdAt: zod.z.unknown().nullable(), updatedAt: zod.z.unknown().nullable() }).strict();
+const PatchArticleRequest = zod.z.object({ slug: zod.z.record(zod.z.string()), title: zod.z.record(zod.z.string()), excerpt: zod.z.record(zod.z.string()), content: zod.z.object({}).partial().strict().passthrough(), tags: zod.z.array(zod.z.string()), featuredImageId: zod.z.string().nullable(), isActive: zod.z.boolean(), isFeatured: zod.z.boolean(), priority: zod.z.number().int().gte(-9007199254740991).lte(9007199254740991) }).partial().strict();
+const PatchArticleResponse = zod.z.object({ id: zod.z.string(), venueId: zod.z.string(), accessor: zod.z.string(), slug: zod.z.record(zod.z.string()), title: zod.z.record(zod.z.string()), excerpt: zod.z.record(zod.z.string()).nullable(), content: zod.z.object({}).partial().strict().passthrough().nullable(), tags: zod.z.array(zod.z.string()), featuredImageId: zod.z.string().nullable(), isActive: zod.z.boolean(), isFeatured: zod.z.boolean(), priority: zod.z.number().int().gte(-2147483648).lte(2147483647), publishedAt: zod.z.unknown().nullable(), createdAt: zod.z.unknown().nullable(), updatedAt: zod.z.unknown().nullable() }).strict();
 const AddToBasketRequest = zod.z.object({ venueId: zod.z.string().regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/).uuid(), sessionId: zod.z.string().min(1), menuItems: zod.z.array(zod.z.object({ menuItemId: zod.z.string().min(1), role: zod.z.string().optional(), quantity: zod.z.number().gt(0).optional(), unit: zod.z.enum(["grams", "kilograms", "liters", "milliliters", "pieces"]).optional() }).strict()).min(1), metadata: zod.z.object({}).partial().strict().passthrough().optional() }).strict();
 const AddToBasketResponse = zod.z.object({ basketItemId: zod.z.string().regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/).uuid(), itemCount: zod.z.number().int().gte(0).lte(9007199254740991), deposit: zod.z.object({ depositwareTemplateId: zod.z.string(), name: zod.z.record(zod.z.string()), amount: zod.z.number().int().gte(0).lte(9007199254740991), currency: zod.z.enum(["EUR", "CHF"]) }).strict().nullable(), totals: zod.z.object({ currency: zod.z.enum(["EUR", "CHF"]), itemsTotal: zod.z.number().int().gte(0).lte(9007199254740991), taxAmount: zod.z.number().int().gte(0).lte(9007199254740991), depositCharge: zod.z.number().int().gte(0).lte(9007199254740991), grossTotal: zod.z.number().int().gte(0).lte(9007199254740991), depositCredit: zod.z.number().int().gte(0).lte(9007199254740991), effectiveTotal: zod.z.number().int().gte(0).lte(9007199254740991), cashRefund: zod.z.number().int().gte(0).lte(9007199254740991), returnable: zod.z.array(zod.z.object({ depositwareTemplateId: zod.z.string(), count: zod.z.number().int().gte(0).lte(9007199254740991) }).strict()) }).strict() }).strict();
 const RemoveFromBasketResponse = zod.z.object({ success: zod.z.boolean(), basketItemId: zod.z.string().regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/).uuid(), itemCount: zod.z.number().int().gte(0).lte(9007199254740991), totals: zod.z.object({ currency: zod.z.enum(["EUR", "CHF"]), itemsTotal: zod.z.number().int().gte(0).lte(9007199254740991), taxAmount: zod.z.number().int().gte(0).lte(9007199254740991), depositCharge: zod.z.number().int().gte(0).lte(9007199254740991), grossTotal: zod.z.number().int().gte(0).lte(9007199254740991), depositCredit: zod.z.number().int().gte(0).lte(9007199254740991), effectiveTotal: zod.z.number().int().gte(0).lte(9007199254740991), cashRefund: zod.z.number().int().gte(0).lte(9007199254740991), returnable: zod.z.array(zod.z.object({ depositwareTemplateId: zod.z.string(), count: zod.z.number().int().gte(0).lte(9007199254740991) }).strict()) }).strict().nullable() }).strict();
@@ -62,6 +65,7 @@ const SwitchFulfillmentTeamOrderRequest = zod.z.object({ publicId: zod.z.string(
 const SwitchFulfillmentTeamOrderResponse = zod.z.object({ teamOrderId: zod.z.string().regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/).uuid(), status: zod.z.enum(["draft", "collecting", "locked", "placed", "ready", "completed", "cancelled"]), fulfillmentType: zod.z.enum(["pickup", "delivery"]), deliveryAddressId: zod.z.string().nullable() }).strict();
 const UpdateDeliveryAddressTeamOrderRequest = zod.z.object({ publicId: zod.z.string().min(1), sessionId: zod.z.string().min(1), deliveryAddress: zod.z.object({ street: zod.z.string(), city: zod.z.string(), state: zod.z.string(), postalCode: zod.z.string(), country: zod.z.string() }).strict() }).strict();
 const UpdateDeliveryAddressTeamOrderResponse = zod.z.object({ teamOrderId: zod.z.string().regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/).uuid(), deliveryAddressId: zod.z.string() }).strict();
+const GetVenueResponse = zod.z.object({ id: zod.z.string(), accessor: zod.z.string(), officialName: zod.z.string(), legalName: zod.z.string(), shortName: zod.z.string(), brandName: zod.z.string(), primaryLocale: zod.z.string(), supportedLocales: zod.z.array(zod.z.string()), timezone: zod.z.string(), createdAt: zod.z.unknown().nullable(), updatedAt: zod.z.unknown().nullable() }).strict();
 const schemas = {
   Area,
   ListAreasResponse,
@@ -72,6 +76,9 @@ const schemas = {
   includeDrafts,
   Article,
   ListArticlesResponse,
+  GetArticleResponse,
+  PatchArticleRequest,
+  PatchArticleResponse,
   AddToBasketRequest,
   AddToBasketResponse,
   RemoveFromBasketResponse,
@@ -122,7 +129,8 @@ const schemas = {
   SwitchFulfillmentTeamOrderRequest,
   SwitchFulfillmentTeamOrderResponse,
   UpdateDeliveryAddressTeamOrderRequest,
-  UpdateDeliveryAddressTeamOrderResponse
+  UpdateDeliveryAddressTeamOrderResponse,
+  GetVenueResponse
 };
 
 exports.schemas = schemas;