order3000 2.1.2 → 2.2.0

package/dist/client.cjs

@@ -117,7 +117,8 @@ class BaseResource {
       },
       body: data ? JSON.stringify(data) : void 0,
       signal: AbortSignal.timeout(36e4),
-      cache: cacheOptions?.cache ?? "no-store"
+      cache: cacheOptions?.cache ?? "no-store",
+      ...cacheOptions?.next ? { next: cacheOptions.next } : {}
     };
     const response = await fetch(url, init);
     if (!response.ok) {
@@ -816,9 +817,14 @@ class EventsResource extends BaseResource {
    * @param options - Optional expand options
    * @returns The event with optional schedule, timeSlots, menus, and assets
    */
-  async get(idOrAccessor, options) {
+  async get(idOrAccessor, options, cacheOptions) {
     const queryString = this.buildQueryString(options);
-    return this.request("GET", `/${idOrAccessor}${queryString}`);
+    return this.request(
+      "GET",
+      `/${idOrAccessor}${queryString}`,
+      void 0,
+      cacheOptions
+    );
   }
   buildQueryString(options) {
     if (!options?.expand?.length) return "";
@@ -920,29 +926,44 @@ class MenusResource extends BaseResource {
    * The server resolves either form transparently.
    * @param idOrAccessor - The menu UUID or accessor (slug)
    * @param options - Optional expand options
+   * @param cacheOptions - Next.js fetch-cache options for near-static reads
    * @returns The menu with optional items and assets
    */
-  async get(idOrAccessor, options) {
+  async get(idOrAccessor, options, cacheOptions) {
     const queryString = this.buildQueryString(options);
-    return this.request("GET", `/${idOrAccessor}${queryString}`);
+    return this.request(
+      "GET",
+      `/${idOrAccessor}${queryString}`,
+      void 0,
+      cacheOptions
+    );
   }
   /**
    * Get all bundles for a menu
    * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+   * @param cacheOptions - Next.js fetch-cache options for near-static reads
    * @returns Array of menu bundles
    */
-  async getBundles(menuIdOrAccessor) {
-    return this.request("GET", `/${menuIdOrAccessor}/bundles`);
+  async getBundles(menuIdOrAccessor, cacheOptions) {
+    return this.request(
+      "GET",
+      `/${menuIdOrAccessor}/bundles`,
+      void 0,
+      cacheOptions
+    );
   }
   /**
    * Get all active subscriptions for a menu
    * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+   * @param cacheOptions - Next.js fetch-cache options for near-static reads
    * @returns Array of menu subscriptions with posters
    */
-  async getSubscriptions(menuIdOrAccessor) {
+  async getSubscriptions(menuIdOrAccessor, cacheOptions) {
     return this.request(
       "GET",
-      `/${menuIdOrAccessor}/subscriptions`
+      `/${menuIdOrAccessor}/subscriptions`,
+      void 0,
+      cacheOptions
     );
   }
   buildQueryString(options) {

package/dist/client.d.cts

@@ -32,20 +32,25 @@ declare class TokenManager {
 }
 
 /**
- * Per-call cache override. SDK reads are uniformly `cache: 'no-store'`
- * — correct for live-read endpoints (basket, team-order, payment
- * intents) where any caching causes stale responses against realtime
- * mutations. No SDK method bakes in ISR: apps that consume near-static
- * data during static generation own caching at the call site by
- * wrapping the SDK call in Next.js `unstable_cache(fn, key, { revalidate })`
- * (e.g. thamarai's `getTiffinBoxEvent` / `getALaCarteMenu`), which is
- * what lets Next.js pre-render the page during the build instead of
- * bailing out to dynamic rendering with `DYNAMIC_SERVER_USAGE`. The
- * `cache` field below remains only as a per-call escape hatch for the
- * rare reader that needs a non-default `RequestCache` value.
+ * Per-call cache override. SDK reads default to `cache: 'no-store'` —
+ * correct for live-read endpoints (basket, team-order, payment intents)
+ * where any caching causes stale responses against realtime mutations.
+ *
+ * Near-static reads that a Next.js app renders into many pages (a menu,
+ * its bundles and subscriptions, an event's schedule) pass Next's own
+ * fetch-cache options instead: `{ cache: 'force-cache', next: { revalidate,
+ * tags } }`. Next then caches the response, revalidates it on schedule and
+ * — unlike `unstable_cache` — locks the cache key while the request runs,
+ * so the pages a build renders at the same time share ONE request instead
+ * of each sending its own (THMR-206: one thamarai build sent ~1000).
  */
 interface RequestCacheOptions {
     cache?: RequestCache;
+    /** Next.js fetch-cache options; ignored outside Next.js. */
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
 }
 declare abstract class BaseResource {
     protected readonly tokenManager: TokenManager;
@@ -468,7 +473,7 @@ declare class EventsResource extends BaseResource {
      * @param options - Optional expand options
      * @returns The event with optional schedule, timeSlots, menus, and assets
      */
-    get(idOrAccessor: string, options?: GetEventOptions): Promise<EventByAccessor>;
+    get(idOrAccessor: string, options?: GetEventOptions, cacheOptions?: RequestCacheOptions): Promise<EventByAccessor>;
     private buildQueryString;
     /**
      * Partial-update an event by id or accessor. Every body field is
@@ -523,21 +528,24 @@ declare class MenusResource extends BaseResource {
      * The server resolves either form transparently.
      * @param idOrAccessor - The menu UUID or accessor (slug)
      * @param options - Optional expand options
+     * @param cacheOptions - Next.js fetch-cache options for near-static reads
      * @returns The menu with optional items and assets
      */
-    get(idOrAccessor: string, options?: GetMenuOptions): Promise<Menu>;
+    get(idOrAccessor: string, options?: GetMenuOptions, cacheOptions?: RequestCacheOptions): Promise<Menu>;
     /**
      * Get all bundles for a menu
      * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+     * @param cacheOptions - Next.js fetch-cache options for near-static reads
      * @returns Array of menu bundles
      */
-    getBundles(menuIdOrAccessor: string): Promise<MenuBundle[]>;
+    getBundles(menuIdOrAccessor: string, cacheOptions?: RequestCacheOptions): Promise<MenuBundle[]>;
     /**
      * Get all active subscriptions for a menu
      * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+     * @param cacheOptions - Next.js fetch-cache options for near-static reads
      * @returns Array of menu subscriptions with posters
      */
-    getSubscriptions(menuIdOrAccessor: string): Promise<MenuSubscription[]>;
+    getSubscriptions(menuIdOrAccessor: string, cacheOptions?: RequestCacheOptions): Promise<MenuSubscription[]>;
     private buildQueryString;
 }
 

package/dist/client.d.mts

@@ -32,20 +32,25 @@ declare class TokenManager {
 }
 
 /**
- * Per-call cache override. SDK reads are uniformly `cache: 'no-store'`
- * — correct for live-read endpoints (basket, team-order, payment
- * intents) where any caching causes stale responses against realtime
- * mutations. No SDK method bakes in ISR: apps that consume near-static
- * data during static generation own caching at the call site by
- * wrapping the SDK call in Next.js `unstable_cache(fn, key, { revalidate })`
- * (e.g. thamarai's `getTiffinBoxEvent` / `getALaCarteMenu`), which is
- * what lets Next.js pre-render the page during the build instead of
- * bailing out to dynamic rendering with `DYNAMIC_SERVER_USAGE`. The
- * `cache` field below remains only as a per-call escape hatch for the
- * rare reader that needs a non-default `RequestCache` value.
+ * Per-call cache override. SDK reads default to `cache: 'no-store'` —
+ * correct for live-read endpoints (basket, team-order, payment intents)
+ * where any caching causes stale responses against realtime mutations.
+ *
+ * Near-static reads that a Next.js app renders into many pages (a menu,
+ * its bundles and subscriptions, an event's schedule) pass Next's own
+ * fetch-cache options instead: `{ cache: 'force-cache', next: { revalidate,
+ * tags } }`. Next then caches the response, revalidates it on schedule and
+ * — unlike `unstable_cache` — locks the cache key while the request runs,
+ * so the pages a build renders at the same time share ONE request instead
+ * of each sending its own (THMR-206: one thamarai build sent ~1000).
  */
 interface RequestCacheOptions {
     cache?: RequestCache;
+    /** Next.js fetch-cache options; ignored outside Next.js. */
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
 }
 declare abstract class BaseResource {
     protected readonly tokenManager: TokenManager;
@@ -468,7 +473,7 @@ declare class EventsResource extends BaseResource {
      * @param options - Optional expand options
      * @returns The event with optional schedule, timeSlots, menus, and assets
      */
-    get(idOrAccessor: string, options?: GetEventOptions): Promise<EventByAccessor>;
+    get(idOrAccessor: string, options?: GetEventOptions, cacheOptions?: RequestCacheOptions): Promise<EventByAccessor>;
     private buildQueryString;
     /**
      * Partial-update an event by id or accessor. Every body field is
@@ -523,21 +528,24 @@ declare class MenusResource extends BaseResource {
      * The server resolves either form transparently.
      * @param idOrAccessor - The menu UUID or accessor (slug)
      * @param options - Optional expand options
+     * @param cacheOptions - Next.js fetch-cache options for near-static reads
      * @returns The menu with optional items and assets
      */
-    get(idOrAccessor: string, options?: GetMenuOptions): Promise<Menu>;
+    get(idOrAccessor: string, options?: GetMenuOptions, cacheOptions?: RequestCacheOptions): Promise<Menu>;
     /**
      * Get all bundles for a menu
      * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+     * @param cacheOptions - Next.js fetch-cache options for near-static reads
      * @returns Array of menu bundles
      */
-    getBundles(menuIdOrAccessor: string): Promise<MenuBundle[]>;
+    getBundles(menuIdOrAccessor: string, cacheOptions?: RequestCacheOptions): Promise<MenuBundle[]>;
     /**
      * Get all active subscriptions for a menu
      * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+     * @param cacheOptions - Next.js fetch-cache options for near-static reads
      * @returns Array of menu subscriptions with posters
      */
-    getSubscriptions(menuIdOrAccessor: string): Promise<MenuSubscription[]>;
+    getSubscriptions(menuIdOrAccessor: string, cacheOptions?: RequestCacheOptions): Promise<MenuSubscription[]>;
     private buildQueryString;
 }
 

package/dist/client.mjs

@@ -116,7 +116,8 @@ class BaseResource {
       },
       body: data ? JSON.stringify(data) : void 0,
       signal: AbortSignal.timeout(36e4),
-      cache: cacheOptions?.cache ?? "no-store"
+      cache: cacheOptions?.cache ?? "no-store",
+      ...cacheOptions?.next ? { next: cacheOptions.next } : {}
     };
     const response = await fetch(url, init);
     if (!response.ok) {
@@ -815,9 +816,14 @@ class EventsResource extends BaseResource {
    * @param options - Optional expand options
    * @returns The event with optional schedule, timeSlots, menus, and assets
    */
-  async get(idOrAccessor, options) {
+  async get(idOrAccessor, options, cacheOptions) {
     const queryString = this.buildQueryString(options);
-    return this.request("GET", `/${idOrAccessor}${queryString}`);
+    return this.request(
+      "GET",
+      `/${idOrAccessor}${queryString}`,
+      void 0,
+      cacheOptions
+    );
   }
   buildQueryString(options) {
     if (!options?.expand?.length) return "";
@@ -919,29 +925,44 @@ class MenusResource extends BaseResource {
    * The server resolves either form transparently.
    * @param idOrAccessor - The menu UUID or accessor (slug)
    * @param options - Optional expand options
+   * @param cacheOptions - Next.js fetch-cache options for near-static reads
    * @returns The menu with optional items and assets
    */
-  async get(idOrAccessor, options) {
+  async get(idOrAccessor, options, cacheOptions) {
     const queryString = this.buildQueryString(options);
-    return this.request("GET", `/${idOrAccessor}${queryString}`);
+    return this.request(
+      "GET",
+      `/${idOrAccessor}${queryString}`,
+      void 0,
+      cacheOptions
+    );
   }
   /**
    * Get all bundles for a menu
    * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+   * @param cacheOptions - Next.js fetch-cache options for near-static reads
    * @returns Array of menu bundles
    */
-  async getBundles(menuIdOrAccessor) {
-    return this.request("GET", `/${menuIdOrAccessor}/bundles`);
+  async getBundles(menuIdOrAccessor, cacheOptions) {
+    return this.request(
+      "GET",
+      `/${menuIdOrAccessor}/bundles`,
+      void 0,
+      cacheOptions
+    );
   }
   /**
    * Get all active subscriptions for a menu
    * @param menuIdOrAccessor - The menu UUID or accessor (slug)
+   * @param cacheOptions - Next.js fetch-cache options for near-static reads
    * @returns Array of menu subscriptions with posters
    */
-  async getSubscriptions(menuIdOrAccessor) {
+  async getSubscriptions(menuIdOrAccessor, cacheOptions) {
     return this.request(
       "GET",
-      `/${menuIdOrAccessor}/subscriptions`
+      `/${menuIdOrAccessor}/subscriptions`,
+      void 0,
+      cacheOptions
     );
   }
   buildQueryString(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "order3000",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "order3000 node.js sdk",
   "main": "./dist/client.cjs",
   "module": "./dist/client.mjs",
@@ -67,8 +67,8 @@
     "prettier": "^3.7.4",
     "tsx": "^4.19.2",
     "typescript": "^5.9.3",
-    "@kolaveri/eslint-config": "1.19.2",
     "@kolaveri/prettier-config": "1.0.6",
+    "@kolaveri/eslint-config": "1.20.0",
     "@kolaveri/tsconfig": "1.0.1"
   },
   "files": [