Skip to content

feat(cache): add etag for payload.json via server middleware - #52

Merged
larbish merged 20 commits into
mainfrom
tmp/unsync-content
Sep 22, 2026
Merged

larbish merged 20 commits into
mainfrom
tmp/unsync-content

Conversation

@larbish

@larbish larbish commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

No description provided.

@coldtea-pr-lens

coldtea-pr-lens Bot commented Sep 22, 2026 •

Copy link
Copy Markdown

◈ PR Lens

🟢 +1 new · 🟠 ~3 changed · 🔴 -0 removed · 1 flow · 6 files · commit e657e71


Architecture

Architecture diagram for comarkdown/comark-docs at e657e71

4 components touched across 5 lanes.

Play the interactive walkthrough


Inside the changed components — 2 views

Component view — Payload ETag & ISR routing

Dynamic ETag generation for production payload JSON files and edge ISR revalidation.

Architecture view of Component view — Payload ETag & ISR routing in comarkdown/comark-docs

Component view — Package patches & runtime cache versioning

Framework patches for same-origin payload preload and content parser v5 cache partitioning.

Architecture view of Component view — Package patches & runtime cache versioning in comarkdown/comark-docs

Data flow

Data flow diagram for comarkdown/comark-docs at e657e71

Client-side payload conditional revalidation

Follow each request, response and payload


View

  • Architecture lens
  • Data flow lens
  • Expand every detail

Tip

Click the link under each diagram to open it on a canvas you can zoom, pan and step through

🪧 More tips
  • Run npx skills add coldteadotai/pr-lens, then tell your coding agent: "Diagram the change you just made with PR Lens and attach it to the pull request."
  • Run npx @coldtea/pr-lens-cli analyze --base origin/main on a branch, then npx @coldtea/pr-lens-cli render .pr-lens/graph.json. Same lenses, your own model key, before the pull request exists
  • Untick Architecture lens or Data flow lens under View to hide a diagram, or tick Expand every detail to open every section. The comment redraws in a few seconds
  • The diagrams are links. Click one to open it on the canvas, then press W or click play to walk through the change
  • Open a diagram on the canvas, then press W or click play to walk through the change one step at a time
  • The CLI's render reads .github/pr-lens.yml and applies your renames, exclusions and lane pins at draw time
  • Set github.comment.collapsed: true in .github/pr-lens.yml to fold the comment behind one View architecture and data flow row. Drawing still runs on every push
  • Set github.draw: on-demand in .github/pr-lens.yml and PR Lens stops drawing every push. Comment @pr-lens draw on a pull request when you want that one drawn
  • Add .github/workflows/pr-lens.yml with coldteadotai/pr-lens/packages/action@v0 and your model provider's key as its api-key to run PR Lens from your own CI. Any /chat/completions endpoint works
  • Push a commit and the comment redraws for the new head. A slow older run never overwrites a newer one
  • Switch GitHub to dark mode and the diagrams follow. The moving dots are this pull request's data in motion

Thanks for using PR Lens! It's built by Coldtea, free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

@vercel

vercel Bot commented Sep 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
comark-docs-layer Building Building Preview Sep 22, 2026 2:18pm UTC

@larbish
larbish merged commit 3fa8d37 into main Sep 22, 2026
5 of 7 checks passed
@github-actions

Copy link
Copy Markdown

Documentation previews

📚 Preview all documentation changes (follows new pushes)

Pinned to the current head: e657e71

@larbish
larbish deleted the tmp/unsync-content branch September 22, 2026 14:18
@coderabbitai

coderabbitai Bot commented Sep 22, 2026

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 02becfaf-a685-4a4f-a60c-5d979d884e41

📥 Commits

Reviewing files that changed from the base of the PR and between 236d467 and e657e71.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (9)
  • docs/cold-page-request.md
  • modules/config/index.ts
  • patches/@nuxt__nitro-server@4.5.2.patch
  • patches/nuxt@4.5.2.patch
  • playground/content/3.concepts/1.architecture.md
  • playground/content/4.deployment/1.vercel.md
  • pnpm-workspace.yaml
  • server/middleware/payload-etag.ts
  • server/utils/cache.ts
 ___________________________________________________________________
< Your tests are like unicorns: frequently referenced, rarely seen. >
 -------------------------------------------------------------------
  \
   \   \
        \ /\
        ( )
      .( o ).
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

Comment @coderabbitai help to get the list of available commands.

This branch was successfully deployed

1 active deployment
Preview — e657e716 Deployed Sep 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant