order3000 0.17.0 → 0.18.0

package/dist/client.cjs

@@ -103,20 +103,25 @@ class BaseResource {
     this.baseUrl = baseUrl;
     this.resourcePath = resourcePath;
   }
-  async request(method, path, data) {
+  async request(method, path, data, cacheOptions) {
     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, {
+    const init = {
       method,
       headers: {
         Authorization: `Bearer ${token}`,
         "Content-Type": "application/json"
       },
       body: data ? JSON.stringify(data) : void 0,
-      cache: "no-store",
       signal: AbortSignal.timeout(36e4)
-    });
+    };
+    if (cacheOptions?.next !== void 0) {
+      init.next = cacheOptions.next;
+    } else {
+      init.cache = cacheOptions?.cache ?? "no-store";
+    }
+    const response = await fetch(url, init);
     if (!response.ok) {
       let body = "";
       try {
@@ -324,7 +329,12 @@ class EventsResource extends BaseResource {
    */
   async getByAccessor(accessor, options) {
     const queryString = this.buildQueryString(options);
-    return this.request("GET", `/${accessor}${queryString}`);
+    return this.request(
+      "GET",
+      `/${accessor}${queryString}`,
+      void 0,
+      { next: { revalidate: 2700 } }
+    );
   }
   buildQueryString(options) {
     if (!options?.expand?.length) return "";
@@ -712,6 +722,22 @@ class TeamOrdersResource {
       request
     );
   }
+  /**
+   * Toggle a participant's "settled" tick on the team Lead's
+   * post-placement settle-up checklist. Writes to
+   * `orders.leadSettledAt` — sets it to `NOW()` when `settled` is
+   * `true`, clears it back to `null` when `false`.
+   *
+   * Authorized only for the team Lead's session — server rejects
+   * non-Lead callers and `orderId`s that don't belong to this team.
+   */
+  async setOrderLeadSettled(publicId, request) {
+    return this.request(
+      "POST",
+      `${this.baseUrl}/team-orders/${encodeURIComponent(publicId)}/lead-settled`,
+      request
+    );
+  }
   /**
    * Any participant proposes an auto-extend when their local clock sees
    * that `fulfillmentAt` has passed while the team order is still

package/dist/client.d.cts

@@ -28,12 +28,29 @@ declare class TokenManager {
     private setDefaultVenueId;
 }
 
+/**
+ * Per-call cache override. Default behaviour is `cache: 'no-store'`
+ * — correct for live-read endpoints (basket, team-order, payment
+ * intents) where any caching causes stale responses against realtime
+ * mutations. Resources that surface near-static data consumed during
+ * static generation (e.g. `events.getByAccessor` for the Tiffinbox
+ * event schedule) can override with `next: { revalidate: N }` so
+ * Next.js can pre-render the calling page during the build instead
+ * of bailing out to dynamic rendering with `DYNAMIC_SERVER_USAGE`.
+ */
+interface RequestCacheOptions {
+    cache?: RequestCache;
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
+}
 declare abstract class BaseResource {
     protected readonly tokenManager: TokenManager;
     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): Promise<T>;
+    protected request<T>(method: 'GET' | 'POST' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
 }
 
 interface components {
@@ -1518,6 +1535,14 @@ interface TeamOrderParticipant {
         depositwareTemplateId: string;
         count: number;
     }>;
+    /**
+     * ISO timestamp the team Lead checked off this participant on
+     * their post-placement settle-up checklist — a private "this
+     * person has handed over what they owe me" tick. `null` while
+     * unchecked. Lead-private; consumer-side rendering decides
+     * whether to surface it.
+     */
+    leadSettledAt: string | null;
 }
 interface ThresholdCheck {
     meets: boolean;
@@ -1734,6 +1759,23 @@ declare class TeamOrdersResource {
         diningTime: string;
         diningOffsetMinutes: number;
     }>;
+    /**
+     * Toggle a participant's "settled" tick on the team Lead's
+     * post-placement settle-up checklist. Writes to
+     * `orders.leadSettledAt` — sets it to `NOW()` when `settled` is
+     * `true`, clears it back to `null` when `false`.
+     *
+     * Authorized only for the team Lead's session — server rejects
+     * non-Lead callers and `orderId`s that don't belong to this team.
+     */
+    setOrderLeadSettled(publicId: string, request: {
+        sessionId: string;
+        orderId: string;
+        settled: boolean;
+    }): Promise<{
+        orderId: string;
+        leadSettledAt: string | null;
+    }>;
     /**
      * Any participant proposes an auto-extend when their local clock sees
      * that `fulfillmentAt` has passed while the team order is still

package/dist/client.d.mts

@@ -28,12 +28,29 @@ declare class TokenManager {
     private setDefaultVenueId;
 }
 
+/**
+ * Per-call cache override. Default behaviour is `cache: 'no-store'`
+ * — correct for live-read endpoints (basket, team-order, payment
+ * intents) where any caching causes stale responses against realtime
+ * mutations. Resources that surface near-static data consumed during
+ * static generation (e.g. `events.getByAccessor` for the Tiffinbox
+ * event schedule) can override with `next: { revalidate: N }` so
+ * Next.js can pre-render the calling page during the build instead
+ * of bailing out to dynamic rendering with `DYNAMIC_SERVER_USAGE`.
+ */
+interface RequestCacheOptions {
+    cache?: RequestCache;
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
+}
 declare abstract class BaseResource {
     protected readonly tokenManager: TokenManager;
     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): Promise<T>;
+    protected request<T>(method: 'GET' | 'POST' | 'DELETE', path: string, data?: unknown, cacheOptions?: RequestCacheOptions): Promise<T>;
 }
 
 interface components {
@@ -1518,6 +1535,14 @@ interface TeamOrderParticipant {
         depositwareTemplateId: string;
         count: number;
     }>;
+    /**
+     * ISO timestamp the team Lead checked off this participant on
+     * their post-placement settle-up checklist — a private "this
+     * person has handed over what they owe me" tick. `null` while
+     * unchecked. Lead-private; consumer-side rendering decides
+     * whether to surface it.
+     */
+    leadSettledAt: string | null;
 }
 interface ThresholdCheck {
     meets: boolean;
@@ -1734,6 +1759,23 @@ declare class TeamOrdersResource {
         diningTime: string;
         diningOffsetMinutes: number;
     }>;
+    /**
+     * Toggle a participant's "settled" tick on the team Lead's
+     * post-placement settle-up checklist. Writes to
+     * `orders.leadSettledAt` — sets it to `NOW()` when `settled` is
+     * `true`, clears it back to `null` when `false`.
+     *
+     * Authorized only for the team Lead's session — server rejects
+     * non-Lead callers and `orderId`s that don't belong to this team.
+     */
+    setOrderLeadSettled(publicId: string, request: {
+        sessionId: string;
+        orderId: string;
+        settled: boolean;
+    }): Promise<{
+        orderId: string;
+        leadSettledAt: string | null;
+    }>;
     /**
      * Any participant proposes an auto-extend when their local clock sees
      * that `fulfillmentAt` has passed while the team order is still

package/dist/client.mjs

@@ -101,20 +101,25 @@ class BaseResource {
     this.baseUrl = baseUrl;
     this.resourcePath = resourcePath;
   }
-  async request(method, path, data) {
+  async request(method, path, data, cacheOptions) {
     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, {
+    const init = {
       method,
       headers: {
         Authorization: `Bearer ${token}`,
         "Content-Type": "application/json"
       },
       body: data ? JSON.stringify(data) : void 0,
-      cache: "no-store",
       signal: AbortSignal.timeout(36e4)
-    });
+    };
+    if (cacheOptions?.next !== void 0) {
+      init.next = cacheOptions.next;
+    } else {
+      init.cache = cacheOptions?.cache ?? "no-store";
+    }
+    const response = await fetch(url, init);
     if (!response.ok) {
       let body = "";
       try {
@@ -322,7 +327,12 @@ class EventsResource extends BaseResource {
    */
   async getByAccessor(accessor, options) {
     const queryString = this.buildQueryString(options);
-    return this.request("GET", `/${accessor}${queryString}`);
+    return this.request(
+      "GET",
+      `/${accessor}${queryString}`,
+      void 0,
+      { next: { revalidate: 2700 } }
+    );
   }
   buildQueryString(options) {
     if (!options?.expand?.length) return "";
@@ -710,6 +720,22 @@ class TeamOrdersResource {
       request
     );
   }
+  /**
+   * Toggle a participant's "settled" tick on the team Lead's
+   * post-placement settle-up checklist. Writes to
+   * `orders.leadSettledAt` — sets it to `NOW()` when `settled` is
+   * `true`, clears it back to `null` when `false`.
+   *
+   * Authorized only for the team Lead's session — server rejects
+   * non-Lead callers and `orderId`s that don't belong to this team.
+   */
+  async setOrderLeadSettled(publicId, request) {
+    return this.request(
+      "POST",
+      `${this.baseUrl}/team-orders/${encodeURIComponent(publicId)}/lead-settled`,
+      request
+    );
+  }
   /**
    * Any participant proposes an auto-extend when their local clock sees
    * that `fulfillmentAt` has passed while the team order is still

package/package.json

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