musora-content-services 2.155.9 → 2.155.12

package/.agent/decisions/2026-04-28-tma-275-mcs-sanity-add-a-v2-url-segmen.md

@@ -0,0 +1,26 @@
+---
+date: 2026-04-28
+pr: railroadmedia/musora-content-services#946
+branch: TMA-275-mcs-sanity-add-a-v2-url-segment-to-to-all-sanity-r
+status: open
+tags: [[jira]], [[bug-fix]]
+components: [[sanity]]
+---
+
+# Add /v2 URL segment to all Sanity requests to force cache refresh
+
+## Context
+Sanity responses were being served from a stale CDN cache. To force a cache refresh, a new URL segment `/v2` needed to be appended after the dataset name in all Sanity API requests. The Jira ticket provided the target URL format: `https://sanity.musora.com/{projectId}/apicdn/v{version}/{dataset}/v2?perspective=...`
+
+## Decision
+Modified the `baseUrl` construction in `src/services/sanity.js` (line 1570) to append `/v2` after the dataset segment. This is the single place where all Sanity API request URLs are built, so this one-line change affects all queries made through MCS.
+
+## Alternatives Considered
+- Adding a cache-busting query parameter instead of a path segment — rejected because the Jira description explicitly shows the `/v2` path segment as the desired approach.
+- Updating config to pass the segment dynamically — unnecessary complexity for a single constant value.
+
+## Process Notes
+The URL is constructed in a single location in `fetchFromSanity()` inside `src/services/sanity.js`. Both GET and POST requests use the same `baseUrl`, so the fix applies to all request methods automatically.
+
+## Consequences
+All Sanity API requests will now include `/v2` in the path, causing the CDN to treat them as new cache keys and serve fresh data.

package/.claude/settings.local.json

@@ -0,0 +1,14 @@
+{
+  "enabledMcpjsonServers": [
+    "nightwatch",
+    "atlassian",
+    "figma",
+    "google-workspace",
+    "snowflake",
+    "aws",
+    "hex",
+    "sanity",
+    "mysql",
+    "slack"
+  ]
+}

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [2.155.12](https://github.com/railroadmedia/musora-content-services/compare/v2.155.11...v2.155.12) (2026-04-29)
+
+### [2.155.11](https://github.com/railroadmedia/musora-content-services/compare/v2.155.10...v2.155.11) (2026-04-28)
+
+
+### Bug Fixes
+
+* **TMA-275:** MCS - Sanity - Add a v2 url segment to to all sanity requests to force a cache refresh ([#946](https://github.com/railroadmedia/musora-content-services/issues/946)) ([b5df1dc](https://github.com/railroadmedia/musora-content-services/commit/b5df1dc943cc9d477dcac5879daaf0725fa60f76))
+
+### [2.155.10](https://github.com/railroadmedia/musora-content-services/compare/v2.155.9...v2.155.10) (2026-04-28)
+
 ### [2.155.9](https://github.com/railroadmedia/musora-content-services/compare/v2.155.8...v2.155.9) (2026-04-28)
 
 ### [2.155.8](https://github.com/railroadmedia/musora-content-services/compare/v2.155.7...v2.155.8) (2026-04-28)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musora-content-services",
-  "version": "2.155.9",
+  "version": "2.155.12",
   "description": "A package for Musoras content services ",
   "main": "src/index.js",
   "type": "module",

package/src/services/contentProgress.js

@@ -604,7 +604,7 @@ async function saveContentProgress(
   // (only to siblings/parents via le bubbles)
 
   // skip bubbling if progress hasnt changed, or if offline
-  if (progress === currentProgress || offline) {
+  if (progress === currentProgress || isOffline) {
     if (!skipPush) db.contentProgress.requestPushUnsynced('save-content-progress')
     return response
   }

package/src/services/sanity.js

@@ -1567,7 +1567,7 @@ export async function fetchSanity(
   }
   const perspective = globalConfig.sanityConfig.perspective ?? 'published'
   const api = globalConfig.sanityConfig.useCachedAPI ? 'apicdn' : 'api'
-  const baseUrl = `https://sanity.musora.com/${globalConfig.sanityConfig.projectId}/${api}/v${globalConfig.sanityConfig.version}/${globalConfig.sanityConfig.dataset}?perspective=${perspective}&v=2`
+  const baseUrl = `https://sanity.musora.com/${globalConfig.sanityConfig.projectId}/${api}/v${globalConfig.sanityConfig.version}/${globalConfig.sanityConfig.dataset}/v2?perspective=${perspective}`
 
   try {
     const encodedQuery = encodeURIComponent(query)

package/.agent/decisions/2026-04-21-tma-239-mcs-sanity-add-a-v2-query-para.md

@@ -1,26 +0,0 @@
----
-date: 2026-04-21
-pr: railroadmedia/musora-content-services#933
-branch: TMA-239-mcs-sanity-add-a-v2-query-parameter-to-all-sanity-
-status: open
-tags: [[jira]], [[bug-fix]], [[sanity]], [[cache]]
-components: [[fetchSanity]]
----
-
-# Add v=2 query parameter to all Sanity requests to force cache refresh
-
-## Context
-All Sanity API requests from musora-content-services were being served with cached responses. Adding a `v=2` query parameter forces a cache refresh, ensuring clients receive up-to-date content.
-
-## Decision
-Appended `&v=2` to the `baseUrl` string inside `fetchSanity()` in `src/services/sanity.js`. This is the single location where all Sanity request URLs are constructed, so one targeted change covers every request made through the library.
-
-## Alternatives Considered
-- Adding the parameter per call-site: There are dozens of call sites and they all funnel through `fetchSanity`, so modifying the base URL there is cleaner and less error-prone.
-- Making it configurable via `sanityConfig`: The ticket does not ask for configurability — it asks for the parameter to be added to all requests unconditionally.
-
-## Process Notes
-The `fetchSanity` function at line 1477 of `src/services/sanity.js` is the sole entry point for all Sanity API calls. It builds `baseUrl` on line 1488 and then appends `&query=...` for GET requests or uses it as the POST URL. Appending `&v=2` to `baseUrl` ensures the parameter is present in both cases.
-
-## Consequences
-All future Sanity requests from this library will include `v=2`, bypassing any CDN or server-side cache and ensuring fresh content is returned.