order3000 0.21.0 → 0.22.0

package/dist/client.cjs

@@ -134,6 +134,38 @@ class BaseResource {
     }
     return response.json();
   }
+  /**
+   * Multipart counterpart to `request`. Skips the JSON Content-Type
+   * default — `fetch` sets `multipart/form-data; boundary=…`
+   * automatically when the body is a `FormData`. Use for binary uploads
+   * (e.g. article feature image).
+   */
+  async requestMultipart(method, path, formData) {
+    const token = await this.tokenManager.getToken();
+    const venueId = this.tokenManager.getVenueId();
+    const url = `${this.baseUrl}/venues/${venueId}${this.resourcePath}${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${token}`
+        // Intentionally NO Content-Type — fetch sets the boundary.
+      },
+      body: formData,
+      cache: "no-store",
+      signal: AbortSignal.timeout(36e4)
+    });
+    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();
+  }
 }
 
 class AreasResource extends BaseResource {
@@ -231,6 +263,59 @@ class ArticlesResource extends BaseResource {
       body
     );
   }
+  /**
+   * Read the article's resolved feature image — asset id, public URL,
+   * matched locale, plus the FULL per-locale caption + alt records.
+   * Returns null when the article has no feature image yet (the wire
+   * 404 is mapped here for ergonomic null-checking on the caller side).
+   */
+  async getFeatureImage(idOrAccessor, options) {
+    const params = new URLSearchParams();
+    if (options?.locale) params.set("locale", options.locale);
+    const qs = params.toString();
+    const path = `/${encodeURIComponent(idOrAccessor)}/feature-image${qs ? `?${qs}` : ""}`;
+    try {
+      return await this.request("GET", path);
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("HTTP 404")) {
+        return null;
+      }
+      throw err;
+    }
+  }
+  /**
+   * Upload a new feature image. Replaces any existing feature image
+   * for the venue's primary locale (the previous one is demoted to
+   * `role='inline'`). The SDK builds the multipart body internally —
+   * pass a Buffer/Uint8Array, the original filename, and the MIME
+   * type.
+   */
+  async uploadFeatureImage(idOrAccessor, file) {
+    const form = new FormData();
+    form.append(
+      "file",
+      new Blob([new Uint8Array(file.data)], { type: file.contentType }),
+      file.filename
+    );
+    return this.requestMultipart(
+      "POST",
+      `/${encodeURIComponent(idOrAccessor)}/feature-image`,
+      form
+    );
+  }
+  /**
+   * Update per-locale caption / alt on the article's feature image.
+   * Locale-keyed merge — `{ caption: { en: '…' } }` does not touch
+   * `de`. Plain-string locale values are server-side wrapped into
+   * minimal TipTap docs (the storage shape).
+   */
+  async patchFeatureImage(idOrAccessor, body) {
+    return this.request(
+      "PATCH",
+      `/${encodeURIComponent(idOrAccessor)}/feature-image`,
+      body
+    );
+  }
 }
 
 class BasketsResource extends BaseResource {

package/dist/client.d.cts

@@ -51,6 +51,13 @@ declare abstract class BaseResource {
     protected readonly resourcePath: string;
     constructor(tokenManager: TokenManager, baseUrl: string, resourcePath: string);
     protected request<T>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
+    /**
+     * Multipart counterpart to `request`. Skips the JSON Content-Type
+     * default — `fetch` sets `multipart/form-data; boundary=…`
+     * automatically when the body is a `FormData`. Use for binary uploads
+     * (e.g. article feature image).
+     */
+    protected requestMultipart<T>(method: 'POST' | 'PATCH' | 'PUT', path: string, formData: FormData): Promise<T>;
 }
 
 interface components {
@@ -218,9 +225,24 @@ interface components {
             createdAt: string | null;
             updatedAt: string | null;
         };
+        /**
+         * FeatureImage
+         * @description An article's resolved feature image. `caption` / `alt` are per-locale TipTap docs (PATCH accepts plain strings — server normalises).
+         */
+        FeatureImage: {
+            id: string;
+            publicUrl: string | null;
+            locale: string;
+            caption: {
+                [key: string]: unknown;
+            } | null;
+            alt: {
+                [key: string]: unknown;
+            } | null;
+        };
         /**
          * Article
-         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire. `featureImage` is resolved per-locale with a fallback to the venue's primary locale.
          */
         Article: {
             id: string;
@@ -239,19 +261,19 @@ interface components {
                 [key: string]: unknown;
             } | null;
             tags: string[];
-            featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
             publishedAt: unknown;
             createdAt: unknown;
             updatedAt: unknown;
+            featureImage: components["schemas"]["FeatureImage"] | null;
         };
         /** ListArticlesResponse */
         ListArticlesResponse: components["schemas"]["Article"][];
         /**
          * GetArticleResponse
-         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire. `featureImage` is resolved per-locale with a fallback to the venue's primary locale.
          */
         GetArticleResponse: {
             id: string;
@@ -270,13 +292,13 @@ interface components {
                 [key: string]: unknown;
             } | null;
             tags: string[];
-            featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
             publishedAt: unknown;
             createdAt: unknown;
             updatedAt: unknown;
+            featureImage: components["schemas"]["FeatureImage"] | null;
         };
         /** PatchArticleRequest */
         PatchArticleRequest: {
@@ -293,14 +315,13 @@ interface components {
                 [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.
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire. `featureImage` is resolved per-locale with a fallback to the venue's primary locale.
          */
         PatchArticleResponse: {
             id: string;
@@ -319,13 +340,30 @@ interface components {
                 [key: string]: unknown;
             } | null;
             tags: string[];
-            featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
             publishedAt: unknown;
             createdAt: unknown;
             updatedAt: unknown;
+            featureImage: components["schemas"]["FeatureImage"] | null;
+        };
+        /** UploadFeatureImageRequest */
+        UploadFeatureImageRequest: {
+            /** @description Image file (multipart/form-data field) */
+            file: unknown;
+        };
+        /**
+         * PatchFeatureImageRequest
+         * @description Locale-keyed merge of the asset-side `caption` and `alt` records. Each locale value may be a plain string OR a TipTap doc; strings are wrapped server-side. Setting `en` does not touch `de`.
+         */
+        PatchFeatureImageRequest: {
+            caption?: {
+                [key: string]: unknown;
+            };
+            alt?: {
+                [key: string]: unknown;
+            };
         };
         /**
          * AddToBasketRequest
@@ -1208,6 +1246,19 @@ type ListArticlesResponse = schemas['ListArticlesResponse'];
 type GetArticleResponse = schemas['GetArticleResponse'];
 type PatchArticleRequest = schemas['PatchArticleRequest'];
 type PatchArticleResponse = schemas['PatchArticleResponse'];
+type FeatureImage = schemas['FeatureImage'];
+type PatchFeatureImageRequest = schemas['PatchFeatureImageRequest'];
+/**
+ * Args for `client.articles.uploadFeatureImage()`. The SDK accepts a
+ * `Buffer` or `Uint8Array` payload + filename + content-type — it
+ * builds the FormData internally so callers don't have to know about
+ * multipart wire encoding.
+ */
+interface UploadFeatureImageArgs {
+    data: Buffer | Uint8Array;
+    filename: string;
+    contentType: string;
+}
 interface ListArticlesOptions {
     /** Only return articles whose `tags` array contains this value. */
     tag?: string;
@@ -2019,6 +2070,30 @@ declare class ArticlesResource extends BaseResource {
      * Returns the resulting article.
      */
     patch(idOrAccessor: string, body: PatchArticleRequest): Promise<Article>;
+    /**
+     * Read the article's resolved feature image — asset id, public URL,
+     * matched locale, plus the FULL per-locale caption + alt records.
+     * Returns null when the article has no feature image yet (the wire
+     * 404 is mapped here for ergonomic null-checking on the caller side).
+     */
+    getFeatureImage(idOrAccessor: string, options?: {
+        locale?: string;
+    }): Promise<FeatureImage | null>;
+    /**
+     * Upload a new feature image. Replaces any existing feature image
+     * for the venue's primary locale (the previous one is demoted to
+     * `role='inline'`). The SDK builds the multipart body internally —
+     * pass a Buffer/Uint8Array, the original filename, and the MIME
+     * type.
+     */
+    uploadFeatureImage(idOrAccessor: string, file: UploadFeatureImageArgs): Promise<FeatureImage>;
+    /**
+     * Update per-locale caption / alt on the article's feature image.
+     * Locale-keyed merge — `{ caption: { en: '…' } }` does not touch
+     * `de`. Plain-string locale values are server-side wrapped into
+     * minimal TipTap docs (the storage shape).
+     */
+    patchFeatureImage(idOrAccessor: string, body: PatchFeatureImageRequest): Promise<FeatureImage>;
 }
 
 declare class BasketsResource extends BaseResource {
@@ -2904,4 +2979,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, 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 };
+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, FeatureImage, 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, PatchFeatureImageRequest, 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, UploadFeatureImageArgs, Venue };

package/dist/client.d.mts

@@ -51,6 +51,13 @@ declare abstract class BaseResource {
     protected readonly resourcePath: string;
     constructor(tokenManager: TokenManager, baseUrl: string, resourcePath: string);
     protected request<T>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
+    /**
+     * Multipart counterpart to `request`. Skips the JSON Content-Type
+     * default — `fetch` sets `multipart/form-data; boundary=…`
+     * automatically when the body is a `FormData`. Use for binary uploads
+     * (e.g. article feature image).
+     */
+    protected requestMultipart<T>(method: 'POST' | 'PATCH' | 'PUT', path: string, formData: FormData): Promise<T>;
 }
 
 interface components {
@@ -218,9 +225,24 @@ interface components {
             createdAt: string | null;
             updatedAt: string | null;
         };
+        /**
+         * FeatureImage
+         * @description An article's resolved feature image. `caption` / `alt` are per-locale TipTap docs (PATCH accepts plain strings — server normalises).
+         */
+        FeatureImage: {
+            id: string;
+            publicUrl: string | null;
+            locale: string;
+            caption: {
+                [key: string]: unknown;
+            } | null;
+            alt: {
+                [key: string]: unknown;
+            } | null;
+        };
         /**
          * Article
-         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire. `featureImage` is resolved per-locale with a fallback to the venue's primary locale.
          */
         Article: {
             id: string;
@@ -239,19 +261,19 @@ interface components {
                 [key: string]: unknown;
             } | null;
             tags: string[];
-            featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
             publishedAt: unknown;
             createdAt: unknown;
             updatedAt: unknown;
+            featureImage: components["schemas"]["FeatureImage"] | null;
         };
         /** ListArticlesResponse */
         ListArticlesResponse: components["schemas"]["Article"][];
         /**
          * GetArticleResponse
-         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire.
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire. `featureImage` is resolved per-locale with a fallback to the venue's primary locale.
          */
         GetArticleResponse: {
             id: string;
@@ -270,13 +292,13 @@ interface components {
                 [key: string]: unknown;
             } | null;
             tags: string[];
-            featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
             publishedAt: unknown;
             createdAt: unknown;
             updatedAt: unknown;
+            featureImage: components["schemas"]["FeatureImage"] | null;
         };
         /** PatchArticleRequest */
         PatchArticleRequest: {
@@ -293,14 +315,13 @@ interface components {
                 [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.
+         * @description A venue's article. `content` is a TipTap JSON document; treat it as opaque on the wire. `featureImage` is resolved per-locale with a fallback to the venue's primary locale.
          */
         PatchArticleResponse: {
             id: string;
@@ -319,13 +340,30 @@ interface components {
                 [key: string]: unknown;
             } | null;
             tags: string[];
-            featuredImageId: string | null;
             isActive: boolean;
             isFeatured: boolean;
             priority: number;
             publishedAt: unknown;
             createdAt: unknown;
             updatedAt: unknown;
+            featureImage: components["schemas"]["FeatureImage"] | null;
+        };
+        /** UploadFeatureImageRequest */
+        UploadFeatureImageRequest: {
+            /** @description Image file (multipart/form-data field) */
+            file: unknown;
+        };
+        /**
+         * PatchFeatureImageRequest
+         * @description Locale-keyed merge of the asset-side `caption` and `alt` records. Each locale value may be a plain string OR a TipTap doc; strings are wrapped server-side. Setting `en` does not touch `de`.
+         */
+        PatchFeatureImageRequest: {
+            caption?: {
+                [key: string]: unknown;
+            };
+            alt?: {
+                [key: string]: unknown;
+            };
         };
         /**
          * AddToBasketRequest
@@ -1208,6 +1246,19 @@ type ListArticlesResponse = schemas['ListArticlesResponse'];
 type GetArticleResponse = schemas['GetArticleResponse'];
 type PatchArticleRequest = schemas['PatchArticleRequest'];
 type PatchArticleResponse = schemas['PatchArticleResponse'];
+type FeatureImage = schemas['FeatureImage'];
+type PatchFeatureImageRequest = schemas['PatchFeatureImageRequest'];
+/**
+ * Args for `client.articles.uploadFeatureImage()`. The SDK accepts a
+ * `Buffer` or `Uint8Array` payload + filename + content-type — it
+ * builds the FormData internally so callers don't have to know about
+ * multipart wire encoding.
+ */
+interface UploadFeatureImageArgs {
+    data: Buffer | Uint8Array;
+    filename: string;
+    contentType: string;
+}
 interface ListArticlesOptions {
     /** Only return articles whose `tags` array contains this value. */
     tag?: string;
@@ -2019,6 +2070,30 @@ declare class ArticlesResource extends BaseResource {
      * Returns the resulting article.
      */
     patch(idOrAccessor: string, body: PatchArticleRequest): Promise<Article>;
+    /**
+     * Read the article's resolved feature image — asset id, public URL,
+     * matched locale, plus the FULL per-locale caption + alt records.
+     * Returns null when the article has no feature image yet (the wire
+     * 404 is mapped here for ergonomic null-checking on the caller side).
+     */
+    getFeatureImage(idOrAccessor: string, options?: {
+        locale?: string;
+    }): Promise<FeatureImage | null>;
+    /**
+     * Upload a new feature image. Replaces any existing feature image
+     * for the venue's primary locale (the previous one is demoted to
+     * `role='inline'`). The SDK builds the multipart body internally —
+     * pass a Buffer/Uint8Array, the original filename, and the MIME
+     * type.
+     */
+    uploadFeatureImage(idOrAccessor: string, file: UploadFeatureImageArgs): Promise<FeatureImage>;
+    /**
+     * Update per-locale caption / alt on the article's feature image.
+     * Locale-keyed merge — `{ caption: { en: '…' } }` does not touch
+     * `de`. Plain-string locale values are server-side wrapped into
+     * minimal TipTap docs (the storage shape).
+     */
+    patchFeatureImage(idOrAccessor: string, body: PatchFeatureImageRequest): Promise<FeatureImage>;
 }
 
 declare class BasketsResource extends BaseResource {
@@ -2904,4 +2979,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, 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 };
+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, FeatureImage, 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, PatchFeatureImageRequest, 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, UploadFeatureImageArgs, Venue };

package/dist/client.mjs

@@ -132,6 +132,38 @@ class BaseResource {
     }
     return response.json();
   }
+  /**
+   * Multipart counterpart to `request`. Skips the JSON Content-Type
+   * default — `fetch` sets `multipart/form-data; boundary=…`
+   * automatically when the body is a `FormData`. Use for binary uploads
+   * (e.g. article feature image).
+   */
+  async requestMultipart(method, path, formData) {
+    const token = await this.tokenManager.getToken();
+    const venueId = this.tokenManager.getVenueId();
+    const url = `${this.baseUrl}/venues/${venueId}${this.resourcePath}${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${token}`
+        // Intentionally NO Content-Type — fetch sets the boundary.
+      },
+      body: formData,
+      cache: "no-store",
+      signal: AbortSignal.timeout(36e4)
+    });
+    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();
+  }
 }
 
 class AreasResource extends BaseResource {
@@ -229,6 +261,59 @@ class ArticlesResource extends BaseResource {
       body
     );
   }
+  /**
+   * Read the article's resolved feature image — asset id, public URL,
+   * matched locale, plus the FULL per-locale caption + alt records.
+   * Returns null when the article has no feature image yet (the wire
+   * 404 is mapped here for ergonomic null-checking on the caller side).
+   */
+  async getFeatureImage(idOrAccessor, options) {
+    const params = new URLSearchParams();
+    if (options?.locale) params.set("locale", options.locale);
+    const qs = params.toString();
+    const path = `/${encodeURIComponent(idOrAccessor)}/feature-image${qs ? `?${qs}` : ""}`;
+    try {
+      return await this.request("GET", path);
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("HTTP 404")) {
+        return null;
+      }
+      throw err;
+    }
+  }
+  /**
+   * Upload a new feature image. Replaces any existing feature image
+   * for the venue's primary locale (the previous one is demoted to
+   * `role='inline'`). The SDK builds the multipart body internally —
+   * pass a Buffer/Uint8Array, the original filename, and the MIME
+   * type.
+   */
+  async uploadFeatureImage(idOrAccessor, file) {
+    const form = new FormData();
+    form.append(
+      "file",
+      new Blob([new Uint8Array(file.data)], { type: file.contentType }),
+      file.filename
+    );
+    return this.requestMultipart(
+      "POST",
+      `/${encodeURIComponent(idOrAccessor)}/feature-image`,
+      form
+    );
+  }
+  /**
+   * Update per-locale caption / alt on the article's feature image.
+   * Locale-keyed merge — `{ caption: { en: '…' } }` does not touch
+   * `de`. Plain-string locale values are server-side wrapped into
+   * minimal TipTap docs (the storage shape).
+   */
+  async patchFeatureImage(idOrAccessor, body) {
+    return this.request(
+      "PATCH",
+      `/${encodeURIComponent(idOrAccessor)}/feature-image`,
+      body
+    );
+  }
 }
 
 class BasketsResource extends BaseResource {

package/dist/schemas.cjs

@@ -9,11 +9,14 @@ 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()).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 FeatureImage = zod.z.object({ id: zod.z.string(), publicUrl: zod.z.string().nullable(), locale: zod.z.string(), caption: zod.z.object({}).partial().strict().passthrough().nullable(), alt: zod.z.object({}).partial().strict().passthrough().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()), 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(), featureImage: FeatureImage.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 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()), 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(), featureImage: FeatureImage.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()), 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()), 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(), featureImage: FeatureImage.nullable() }).strict();
+const UploadFeatureImageRequest = zod.z.object({ file: zod.z.unknown() }).strict();
+const PatchFeatureImageRequest = zod.z.object({ caption: zod.z.object({}).partial().strict().passthrough(), alt: zod.z.object({}).partial().strict().passthrough() }).partial().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();
@@ -74,11 +77,14 @@ const schemas = {
   SubmitAreaBookingRequest,
   SubmitAreaBookingResponse,
   includeDrafts,
+  FeatureImage,
   Article,
   ListArticlesResponse,
   GetArticleResponse,
   PatchArticleRequest,
   PatchArticleResponse,
+  UploadFeatureImageRequest,
+  PatchFeatureImageRequest,
   AddToBasketRequest,
   AddToBasketResponse,
   RemoveFromBasketResponse,