order3000 0.19.1 → 0.21.0

package/dist/client.cjs

@@ -184,6 +184,55 @@ class AreasResource extends BaseResource {
   }
 }
 
+class ArticlesResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/articles");
+  }
+  /**
+   * List articles for the venue. Default behaviour returns published +
+   * active articles, ordered by `priority` (desc) then `publishedAt`
+   * (desc). Override defaults via `includeDrafts` / `includeInactive`,
+   * or filter by a single tag.
+   *
+   * `content` on each article is a TipTap JSON document — opaque on the
+   * wire. Use the order3000-cli's `articles outline` command (forthcoming)
+   * for human-friendly node addressing.
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.tag) params.set("tag", options.tag);
+    if (options?.includeDrafts !== void 0) {
+      params.set("includeDrafts", String(options.includeDrafts));
+    }
+    if (options?.includeInactive !== void 0) {
+      params.set("includeInactive", String(options.includeInactive));
+    }
+    const qs = params.toString();
+    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 {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/baskets");
@@ -767,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);
@@ -1092,6 +1179,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 class Order3000Client {
   constructor(config) {
     __publicField(this, "areas");
+    __publicField(this, "articles");
     __publicField(this, "baskets");
     __publicField(this, "events");
     __publicField(this, "menus");
@@ -1100,11 +1188,12 @@ class Order3000Client {
     __publicField(this, "reservations");
     __publicField(this, "subscriptions");
     __publicField(this, "teamOrders");
+    __publicField(this, "venues");
     __publicField(this, "realtime");
     __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
     this.baseUrl = config.baseUrl || "https://order3000.com/api";
-    const tokenUrl = config.tokenUrl || `${this.baseUrl}/auth/token`;
+    const tokenUrl = config.tokenUrl || `${this.baseUrl}/m2m/token`;
     this.tokenManager = new TokenManager(
       config.clientId,
       config.clientSecret,
@@ -1112,6 +1201,7 @@ class Order3000Client {
       config.venueId
     );
     this.areas = new AreasResource(this.tokenManager, this.baseUrl);
+    this.articles = new ArticlesResource(this.tokenManager, this.baseUrl);
     this.baskets = new BasketsResource(this.tokenManager, this.baseUrl);
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
     this.menus = new MenusResource(this.tokenManager, this.baseUrl);
@@ -1129,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 {
@@ -218,6 +218,115 @@ interface components {
             createdAt: string | null;
             updatedAt: string | null;
         };
+        /**
+         * Article
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         */
+        Article: {
+            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;
+        };
+        /** 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
@@ -1066,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;
@@ -1077,6 +1203,21 @@ interface components {
 type schemas = components['schemas'];
 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;
+    /** When `true`, include articles whose `publishedAt` is null. Default `false`. */
+    includeDrafts?: boolean;
+    /** 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
@@ -1853,6 +1994,33 @@ declare class AreasResource extends BaseResource {
     private buildExpandQuery;
 }
 
+declare class ArticlesResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * List articles for the venue. Default behaviour returns published +
+     * active articles, ordered by `priority` (desc) then `publishedAt`
+     * (desc). Override defaults via `includeDrafts` / `includeInactive`,
+     * or filter by a single tag.
+     *
+     * `content` on each article is a TipTap JSON document — opaque on the
+     * wire. Use the order3000-cli's `articles outline` command (forthcoming)
+     * 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 {
     constructor(tokenManager: TokenManager, baseUrl: string);
     /**
@@ -2536,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;
@@ -2688,13 +2877,17 @@ interface Order3000ClientConfig {
      */
     baseUrl?: string;
     /**
-     * OAuth 2.0 token endpoint
-     * @default "${baseUrl}/auth/token"
+     * Machine-to-machine token endpoint. The order3000 server hosts user
+     * session routes under `/auth/*` and robot-account M2M token exchange
+     * under `/m2m/token`; the SDK is exclusively an M2M consumer, so the
+     * default points at the latter.
+     * @default "${baseUrl}/m2m/token"
      */
     tokenUrl?: string;
 }
 declare class Order3000Client {
     areas: AreasResource;
+    articles: ArticlesResource;
     baskets: BasketsResource;
     events: EventsResource;
     menus: MenusResource;
@@ -2703,6 +2896,7 @@ declare class Order3000Client {
     reservations: ReservationsResource;
     subscriptions: SubscriptionsResource;
     teamOrders: TeamOrdersResource;
+    venues: VenuesResource;
     realtime: RealtimeManager;
     private readonly baseUrl;
     private readonly tokenManager;
@@ -2710,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, 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, 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 {
@@ -218,6 +218,115 @@ interface components {
             createdAt: string | null;
             updatedAt: string | null;
         };
+        /**
+         * Article
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         */
+        Article: {
+            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;
+        };
+        /** 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
@@ -1066,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;
@@ -1077,6 +1203,21 @@ interface components {
 type schemas = components['schemas'];
 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;
+    /** When `true`, include articles whose `publishedAt` is null. Default `false`. */
+    includeDrafts?: boolean;
+    /** 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
@@ -1853,6 +1994,33 @@ declare class AreasResource extends BaseResource {
     private buildExpandQuery;
 }
 
+declare class ArticlesResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * List articles for the venue. Default behaviour returns published +
+     * active articles, ordered by `priority` (desc) then `publishedAt`
+     * (desc). Override defaults via `includeDrafts` / `includeInactive`,
+     * or filter by a single tag.
+     *
+     * `content` on each article is a TipTap JSON document — opaque on the
+     * wire. Use the order3000-cli's `articles outline` command (forthcoming)
+     * 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 {
     constructor(tokenManager: TokenManager, baseUrl: string);
     /**
@@ -2536,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;
@@ -2688,13 +2877,17 @@ interface Order3000ClientConfig {
      */
     baseUrl?: string;
     /**
-     * OAuth 2.0 token endpoint
-     * @default "${baseUrl}/auth/token"
+     * Machine-to-machine token endpoint. The order3000 server hosts user
+     * session routes under `/auth/*` and robot-account M2M token exchange
+     * under `/m2m/token`; the SDK is exclusively an M2M consumer, so the
+     * default points at the latter.
+     * @default "${baseUrl}/m2m/token"
      */
     tokenUrl?: string;
 }
 declare class Order3000Client {
     areas: AreasResource;
+    articles: ArticlesResource;
     baskets: BasketsResource;
     events: EventsResource;
     menus: MenusResource;
@@ -2703,6 +2896,7 @@ declare class Order3000Client {
     reservations: ReservationsResource;
     subscriptions: SubscriptionsResource;
     teamOrders: TeamOrdersResource;
+    venues: VenuesResource;
     realtime: RealtimeManager;
     private readonly baseUrl;
     private readonly tokenManager;
@@ -2710,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, 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, 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 };