@helpai/elements 0.28.0 → 0.28.1

package/index.mjs

@@ -1381,6 +1381,7 @@ function messageToWireParts(m) {
 var log4 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
+var CONTENT_CACHE_TTL_MS = 6e4;
 var MAX_REQUEST_RETRIES = 3;
 var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
 function backoffMs(attempt) {
@@ -1419,6 +1420,20 @@ var AgentTransport = class {
     // always sees the visitor's latest context as they navigate.
     __publicField(this, "userContext");
     __publicField(this, "pageContext");
+    // ---- Data API (content / forms — module-help-ai-data-api) --------------
+    //
+    // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
+    // under the module's `/pai/*` group — same auth headers + envelope, same
+    // retry behavior. One endpoint for every content surface (Home / Help /
+    // News / docs); callers pass filters; a thrown StreamError (e.g. 404 on an
+    // older backend) is treated as "no content" by the module and the tab
+    // degrades gracefully.
+    // Per-query content cache: published content barely changes mid-visit, but
+    // every tab switch remounts its module and re-asks. Entries hold the
+    // REQUEST PROMISE (concurrent identical queries share one network call)
+    // and serve repeats for CONTENT_CACHE_TTL_MS; failures are evicted so the
+    // next ask retries.
+    __publicField(this, "contentCache", /* @__PURE__ */ new Map());
   }
   // ---- Public API -------------------------------------------------------
   /**
@@ -1575,16 +1590,22 @@ var AgentTransport = class {
       log4.debug("markRead failed (non-fatal)", { err });
     }
   }
-  // ---- Data API (content / forms — module-help-ai-data-api) --------------
-  //
-  // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
-  // with ROOT-level paths — same auth headers + envelope, same retry
-  // behavior. One endpoint for every content surface (Home / Help / News /
-  // docs); callers pass filters; a thrown StreamError (e.g. 404 on an older
-  // backend) is treated as "no content" by the module and the tab degrades
-  // gracefully.
-  /** Fetch content rows by filter. `GET /content` (data-API). */
-  async listContent(query = {}) {
+  /** Fetch content rows by filter. `GET /pai/content` (data-API), TTL-cached. */
+  listContent(query = {}) {
+    const key = JSON.stringify(query, Object.keys(query).toSorted());
+    const cached = this.contentCache.get(key);
+    if (cached && Date.now() - cached.at < CONTENT_CACHE_TTL_MS) {
+      log4.debug("listContent \u2192 cache", query);
+      return cached.result;
+    }
+    const result = this.fetchContent(query).catch((err) => {
+      this.contentCache.delete(key);
+      throw err;
+    });
+    this.contentCache.set(key, { at: Date.now(), result });
+    return result;
+  }
+  async fetchContent(query) {
     const url = new URL(this.dataUrl(DEFAULT_PATHS.content));
     for (const [key, value] of Object.entries(query)) {
       if (value === void 0) continue;

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.28.0"
+  "version": "0.28.1"
 }

package/web-component.mjs

@@ -1436,6 +1436,7 @@ function messageToWireParts(m) {
 var log4 = logger.scope("transport");
 var MAX_RESUME_ATTEMPTS = 3;
 var RESUME_BACKOFF_MS = 400;
+var CONTENT_CACHE_TTL_MS = 6e4;
 var MAX_REQUEST_RETRIES = 3;
 var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
 function backoffMs(attempt) {
@@ -1474,6 +1475,20 @@ var AgentTransport = class {
     // always sees the visitor's latest context as they navigate.
     __publicField(this, "userContext");
     __publicField(this, "pageContext");
+    // ---- Data API (content / forms — module-help-ai-data-api) --------------
+    //
+    // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
+    // under the module's `/pai/*` group — same auth headers + envelope, same
+    // retry behavior. One endpoint for every content surface (Home / Help /
+    // News / docs); callers pass filters; a thrown StreamError (e.g. 404 on an
+    // older backend) is treated as "no content" by the module and the tab
+    // degrades gracefully.
+    // Per-query content cache: published content barely changes mid-visit, but
+    // every tab switch remounts its module and re-asks. Entries hold the
+    // REQUEST PROMISE (concurrent identical queries share one network call)
+    // and serve repeats for CONTENT_CACHE_TTL_MS; failures are evicted so the
+    // next ask retries.
+    __publicField(this, "contentCache", /* @__PURE__ */ new Map());
   }
   // ---- Public API -------------------------------------------------------
   /**
@@ -1630,16 +1645,22 @@ var AgentTransport = class {
       log4.debug("markRead failed (non-fatal)", { err });
     }
   }
-  // ---- Data API (content / forms — module-help-ai-data-api) --------------
-  //
-  // The DATA surfaces live on `dataApiBaseUrl` (default `${baseUrl}/api/data`)
-  // with ROOT-level paths — same auth headers + envelope, same retry
-  // behavior. One endpoint for every content surface (Home / Help / News /
-  // docs); callers pass filters; a thrown StreamError (e.g. 404 on an older
-  // backend) is treated as "no content" by the module and the tab degrades
-  // gracefully.
-  /** Fetch content rows by filter. `GET /content` (data-API). */
-  async listContent(query = {}) {
+  /** Fetch content rows by filter. `GET /pai/content` (data-API), TTL-cached. */
+  listContent(query = {}) {
+    const key = JSON.stringify(query, Object.keys(query).toSorted());
+    const cached = this.contentCache.get(key);
+    if (cached && Date.now() - cached.at < CONTENT_CACHE_TTL_MS) {
+      log4.debug("listContent \u2192 cache", query);
+      return cached.result;
+    }
+    const result = this.fetchContent(query).catch((err) => {
+      this.contentCache.delete(key);
+      throw err;
+    });
+    this.contentCache.set(key, { at: Date.now(), result });
+    return result;
+  }
+  async fetchContent(query) {
     const url = new URL(this.dataUrl(DEFAULT_PATHS.content));
     for (const [key, value] of Object.entries(query)) {
       if (value === void 0) continue;