order3000 0.10.1 → 0.11.0

package/dist/client.cjs

@@ -273,12 +273,45 @@ class OrdersResource extends BaseResource {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/orders");
   }
+  /**
+   * Place a new order.
+   *
+   * The order3000 backend calculates taxAmount and totalAmount from the basket items:
+   * - totalAmount: derived from basket items' prices (bundleId -> price)
+   * - taxAmount: derived from basket items' tax rates (bundleId -> taxRateId -> rate)
+   *
+   * SDK callers cannot provide these values - they're implicit from the basket contents.
+   */
   async place(order) {
     return this.request("POST", "", order);
   }
   async get(orderId) {
     return this.request("GET", `/${orderId}`);
   }
+  /**
+   * Confirm an order after client-side Stripe payment has succeeded.
+   *
+   * Verifies the PaymentIntent status with Stripe and transitions
+   * the order to 'paid' status.
+   */
+  async confirm(orderId, request) {
+    return this.request("POST", `/${orderId}/confirm`, request);
+  }
+}
+
+class PaymentIntentsResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/payment-intents");
+  }
+  /**
+   * Create a Stripe PaymentIntent via order3000's Stripe Connect integration.
+   *
+   * Returns a clientSecret for client-side payment confirmation and an orderId
+   * for the draft order that was created.
+   */
+  async create(request) {
+    return this.request("POST", "", request);
+  }
 }
 
 class ReservationsResource extends BaseResource {
@@ -631,6 +664,7 @@ class Order3000Client {
     __publicField(this, "events");
     __publicField(this, "menus");
     __publicField(this, "orders");
+    __publicField(this, "paymentIntents");
     __publicField(this, "reservations");
     __publicField(this, "realtime");
     __publicField(this, "baseUrl");
@@ -647,6 +681,10 @@ class Order3000Client {
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
     this.menus = new MenusResource(this.tokenManager, this.baseUrl);
     this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
+    this.paymentIntents = new PaymentIntentsResource(
+      this.tokenManager,
+      this.baseUrl
+    );
     this.reservations = new ReservationsResource(
       this.tokenManager,
       this.baseUrl

package/dist/client.d.cts

@@ -110,6 +110,8 @@ interface components {
             id?: string;
             venueId: string;
             basketId: string;
+            publicId?: string | null;
+            quickReferenceNumber?: number | null;
             /** @enum {string} */
             status?: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId?: string | null;
@@ -119,6 +121,9 @@ interface components {
             totalAmount: number;
             /** @enum {string} */
             currency?: "EUR" | "CHF";
+            /** @enum {string|null} */
+            fulfillmentType?: "pickup" | "delivery" | null;
+            fulfillmentAt?: unknown;
             orderedAt?: unknown;
             orderedBy: string;
             updatedAt?: unknown;
@@ -129,6 +134,8 @@ interface components {
             id: string;
             venueId: string;
             basketId: string;
+            publicId: string | null;
+            quickReferenceNumber: number | null;
             /** @enum {string} */
             status: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId: string | null;
@@ -138,6 +145,9 @@ interface components {
             totalAmount: number;
             /** @enum {string} */
             currency: "EUR" | "CHF";
+            /** @enum {string|null} */
+            fulfillmentType: "pickup" | "delivery" | null;
+            fulfillmentAt: unknown;
             orderedAt: unknown;
             orderedBy: string;
             updatedAt: unknown;
@@ -292,7 +302,17 @@ interface components {
 type schemas = components['schemas'];
 type CreateEventRequest = schemas['CreateEventRequest'];
 type CreateEventResponse = schemas['CreateEventResponse'];
-type PlaceOrderRequest = schemas['PlaceOrderRequest'];
+/**
+ * Order fulfillment type - matches order_fulfillment_type enum in order3000 database.
+ * Keep in sync with apps/order3000/src/drizzle/enums.ts
+ */
+type OrderFulfillmentType = 'pickup' | 'delivery';
+type PlaceOrderRequest = Omit<schemas['PlaceOrderRequest'], 'taxAmount' | 'totalAmount'> & {
+    /** Fulfillment type for the order (pickup or delivery) */
+    fulfillmentType?: OrderFulfillmentType;
+    /** When the order should be fulfilled (pickup/delivery time) */
+    fulfillmentAt?: Date;
+};
 type PlaceOrderResponse = schemas['PlaceOrderResponse'];
 type MakeReservationRequest = schemas['MakeReservationRequest'];
 type MakeReservationResponse = schemas['MakeReservationResponse'];
@@ -623,6 +643,26 @@ interface RemoveFromBasketResponse {
     basketItemId: string;
     itemCount: number;
 }
+interface CreatePaymentIntentRequest {
+    basketId: string;
+    currency: Currency;
+    sessionId: string;
+    fulfillmentType?: OrderFulfillmentType;
+    fulfillmentTime?: string;
+}
+interface CreatePaymentIntentResponse {
+    clientSecret: string;
+    paymentIntentId: string;
+    orderId: string;
+}
+interface ConfirmOrderRequest {
+    paymentIntentId: string;
+}
+interface ConfirmOrderResponse {
+    id: string;
+    status: string;
+    publicId: string | null;
+}
 
 declare class BasketsResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -709,8 +749,35 @@ declare class MenusResource extends BaseResource {
 
 declare class OrdersResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Place a new order.
+     *
+     * The order3000 backend calculates taxAmount and totalAmount from the basket items:
+     * - totalAmount: derived from basket items' prices (bundleId -> price)
+     * - taxAmount: derived from basket items' tax rates (bundleId -> taxRateId -> rate)
+     *
+     * SDK callers cannot provide these values - they're implicit from the basket contents.
+     */
     place(order: PlaceOrderRequest): Promise<PlaceOrderResponse>;
     get(orderId: string): Promise<PlaceOrderRequest>;
+    /**
+     * Confirm an order after client-side Stripe payment has succeeded.
+     *
+     * Verifies the PaymentIntent status with Stripe and transitions
+     * the order to 'paid' status.
+     */
+    confirm(orderId: string, request: ConfirmOrderRequest): Promise<ConfirmOrderResponse>;
+}
+
+declare class PaymentIntentsResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Create a Stripe PaymentIntent via order3000's Stripe Connect integration.
+     *
+     * Returns a clientSecret for client-side payment confirmation and an orderId
+     * for the draft order that was created.
+     */
+    create(request: CreatePaymentIntentRequest): Promise<CreatePaymentIntentResponse>;
 }
 
 declare class ReservationsResource extends BaseResource {
@@ -890,6 +957,7 @@ declare class Order3000Client {
     events: EventsResource;
     menus: MenusResource;
     orders: OrdersResource;
+    paymentIntents: PaymentIntentsResource;
     reservations: ReservationsResource;
     realtime: RealtimeManager;
     private readonly baseUrl;
@@ -897,4 +965,4 @@ declare class Order3000Client {
     constructor(config: Order3000ClientConfig);
 }
 
-export { type AddToBasketRequest, type AddToBasketResponse, type Basket, type BasketItem, type BasketItemMenuItemRef, type BasketItemMetadata, type BasketStatus, type CropArea, type Currency, type DayOfWeek, type Event, type EventByAccessor, type EventMenu, type EventPoster, type EventRow, type GetEventOptions, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuBundle, type MenuBundleDeposit, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type RemoveFromBasketResponse, type Schedule, type ScheduleInfo, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type ScheduleTimeSlot, type ScheduleWithTimeSlots, type SubscriptionOptions, type TimeSlot, type Unit, getScheduleInfo };
+export { type AddToBasketRequest, type AddToBasketResponse, type Basket, type BasketItem, type BasketItemMenuItemRef, type BasketItemMetadata, type BasketStatus, type ConfirmOrderRequest, type ConfirmOrderResponse, type CreatePaymentIntentRequest, type CreatePaymentIntentResponse, type CropArea, type Currency, type DayOfWeek, type Event, type EventByAccessor, type EventMenu, type EventPoster, type EventRow, type GetEventOptions, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuBundle, type MenuBundleDeposit, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type OrderFulfillmentType, type PlaceOrderRequest, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type RemoveFromBasketResponse, type Schedule, type ScheduleInfo, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type ScheduleTimeSlot, type ScheduleWithTimeSlots, type SubscriptionOptions, type TimeSlot, type Unit, getScheduleInfo };

package/dist/client.d.mts

@@ -110,6 +110,8 @@ interface components {
             id?: string;
             venueId: string;
             basketId: string;
+            publicId?: string | null;
+            quickReferenceNumber?: number | null;
             /** @enum {string} */
             status?: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId?: string | null;
@@ -119,6 +121,9 @@ interface components {
             totalAmount: number;
             /** @enum {string} */
             currency?: "EUR" | "CHF";
+            /** @enum {string|null} */
+            fulfillmentType?: "pickup" | "delivery" | null;
+            fulfillmentAt?: unknown;
             orderedAt?: unknown;
             orderedBy: string;
             updatedAt?: unknown;
@@ -129,6 +134,8 @@ interface components {
             id: string;
             venueId: string;
             basketId: string;
+            publicId: string | null;
+            quickReferenceNumber: number | null;
             /** @enum {string} */
             status: "draft" | "pending" | "paid" | "fulfilled" | "cancelled" | "refunded";
             paymentIntentId: string | null;
@@ -138,6 +145,9 @@ interface components {
             totalAmount: number;
             /** @enum {string} */
             currency: "EUR" | "CHF";
+            /** @enum {string|null} */
+            fulfillmentType: "pickup" | "delivery" | null;
+            fulfillmentAt: unknown;
             orderedAt: unknown;
             orderedBy: string;
             updatedAt: unknown;
@@ -292,7 +302,17 @@ interface components {
 type schemas = components['schemas'];
 type CreateEventRequest = schemas['CreateEventRequest'];
 type CreateEventResponse = schemas['CreateEventResponse'];
-type PlaceOrderRequest = schemas['PlaceOrderRequest'];
+/**
+ * Order fulfillment type - matches order_fulfillment_type enum in order3000 database.
+ * Keep in sync with apps/order3000/src/drizzle/enums.ts
+ */
+type OrderFulfillmentType = 'pickup' | 'delivery';
+type PlaceOrderRequest = Omit<schemas['PlaceOrderRequest'], 'taxAmount' | 'totalAmount'> & {
+    /** Fulfillment type for the order (pickup or delivery) */
+    fulfillmentType?: OrderFulfillmentType;
+    /** When the order should be fulfilled (pickup/delivery time) */
+    fulfillmentAt?: Date;
+};
 type PlaceOrderResponse = schemas['PlaceOrderResponse'];
 type MakeReservationRequest = schemas['MakeReservationRequest'];
 type MakeReservationResponse = schemas['MakeReservationResponse'];
@@ -623,6 +643,26 @@ interface RemoveFromBasketResponse {
     basketItemId: string;
     itemCount: number;
 }
+interface CreatePaymentIntentRequest {
+    basketId: string;
+    currency: Currency;
+    sessionId: string;
+    fulfillmentType?: OrderFulfillmentType;
+    fulfillmentTime?: string;
+}
+interface CreatePaymentIntentResponse {
+    clientSecret: string;
+    paymentIntentId: string;
+    orderId: string;
+}
+interface ConfirmOrderRequest {
+    paymentIntentId: string;
+}
+interface ConfirmOrderResponse {
+    id: string;
+    status: string;
+    publicId: string | null;
+}
 
 declare class BasketsResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -709,8 +749,35 @@ declare class MenusResource extends BaseResource {
 
 declare class OrdersResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Place a new order.
+     *
+     * The order3000 backend calculates taxAmount and totalAmount from the basket items:
+     * - totalAmount: derived from basket items' prices (bundleId -> price)
+     * - taxAmount: derived from basket items' tax rates (bundleId -> taxRateId -> rate)
+     *
+     * SDK callers cannot provide these values - they're implicit from the basket contents.
+     */
     place(order: PlaceOrderRequest): Promise<PlaceOrderResponse>;
     get(orderId: string): Promise<PlaceOrderRequest>;
+    /**
+     * Confirm an order after client-side Stripe payment has succeeded.
+     *
+     * Verifies the PaymentIntent status with Stripe and transitions
+     * the order to 'paid' status.
+     */
+    confirm(orderId: string, request: ConfirmOrderRequest): Promise<ConfirmOrderResponse>;
+}
+
+declare class PaymentIntentsResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Create a Stripe PaymentIntent via order3000's Stripe Connect integration.
+     *
+     * Returns a clientSecret for client-side payment confirmation and an orderId
+     * for the draft order that was created.
+     */
+    create(request: CreatePaymentIntentRequest): Promise<CreatePaymentIntentResponse>;
 }
 
 declare class ReservationsResource extends BaseResource {
@@ -890,6 +957,7 @@ declare class Order3000Client {
     events: EventsResource;
     menus: MenusResource;
     orders: OrdersResource;
+    paymentIntents: PaymentIntentsResource;
     reservations: ReservationsResource;
     realtime: RealtimeManager;
     private readonly baseUrl;
@@ -897,4 +965,4 @@ declare class Order3000Client {
     constructor(config: Order3000ClientConfig);
 }
 
-export { type AddToBasketRequest, type AddToBasketResponse, type Basket, type BasketItem, type BasketItemMenuItemRef, type BasketItemMetadata, type BasketStatus, type CropArea, type Currency, type DayOfWeek, type Event, type EventByAccessor, type EventMenu, type EventPoster, type EventRow, type GetEventOptions, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuBundle, type MenuBundleDeposit, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type RemoveFromBasketResponse, type Schedule, type ScheduleInfo, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type ScheduleTimeSlot, type ScheduleWithTimeSlots, type SubscriptionOptions, type TimeSlot, type Unit, getScheduleInfo };
+export { type AddToBasketRequest, type AddToBasketResponse, type Basket, type BasketItem, type BasketItemMenuItemRef, type BasketItemMetadata, type BasketStatus, type ConfirmOrderRequest, type ConfirmOrderResponse, type CreatePaymentIntentRequest, type CreatePaymentIntentResponse, type CropArea, type Currency, type DayOfWeek, type Event, type EventByAccessor, type EventMenu, type EventPoster, type EventRow, type GetEventOptions, type GetMenuOptions, type ListEventsOptions, type ListEventsResponse, type Menu, type MenuAsset, type MenuBeverage, type MenuBundle, type MenuBundleDeposit, type MenuDish, type MenuItem, type MenuItemRow, type MenuItemType, Order3000Client, type Order3000ClientConfig, type OrderFulfillmentType, type PlaceOrderRequest, type Promotion, type RealtimeConfig, type RealtimeEvent, type RealtimeSubscription, type RemoveFromBasketResponse, type Schedule, type ScheduleInfo, type ScheduleOverride, type ScheduleOverrideRow, type ScheduleRow, type ScheduleTimeSlot, type ScheduleWithTimeSlots, type SubscriptionOptions, type TimeSlot, type Unit, getScheduleInfo };

package/dist/client.mjs

@@ -271,12 +271,45 @@ class OrdersResource extends BaseResource {
   constructor(tokenManager, baseUrl) {
     super(tokenManager, baseUrl, "/orders");
   }
+  /**
+   * Place a new order.
+   *
+   * The order3000 backend calculates taxAmount and totalAmount from the basket items:
+   * - totalAmount: derived from basket items' prices (bundleId -> price)
+   * - taxAmount: derived from basket items' tax rates (bundleId -> taxRateId -> rate)
+   *
+   * SDK callers cannot provide these values - they're implicit from the basket contents.
+   */
   async place(order) {
     return this.request("POST", "", order);
   }
   async get(orderId) {
     return this.request("GET", `/${orderId}`);
   }
+  /**
+   * Confirm an order after client-side Stripe payment has succeeded.
+   *
+   * Verifies the PaymentIntent status with Stripe and transitions
+   * the order to 'paid' status.
+   */
+  async confirm(orderId, request) {
+    return this.request("POST", `/${orderId}/confirm`, request);
+  }
+}
+
+class PaymentIntentsResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/payment-intents");
+  }
+  /**
+   * Create a Stripe PaymentIntent via order3000's Stripe Connect integration.
+   *
+   * Returns a clientSecret for client-side payment confirmation and an orderId
+   * for the draft order that was created.
+   */
+  async create(request) {
+    return this.request("POST", "", request);
+  }
 }
 
 class ReservationsResource extends BaseResource {
@@ -629,6 +662,7 @@ class Order3000Client {
     __publicField(this, "events");
     __publicField(this, "menus");
     __publicField(this, "orders");
+    __publicField(this, "paymentIntents");
     __publicField(this, "reservations");
     __publicField(this, "realtime");
     __publicField(this, "baseUrl");
@@ -645,6 +679,10 @@ class Order3000Client {
     this.events = new EventsResource(this.tokenManager, this.baseUrl);
     this.menus = new MenusResource(this.tokenManager, this.baseUrl);
     this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
+    this.paymentIntents = new PaymentIntentsResource(
+      this.tokenManager,
+      this.baseUrl
+    );
     this.reservations = new ReservationsResource(
       this.tokenManager,
       this.baseUrl

package/package.json

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