Skip to content

Say what "No pod URL found" actually means, and stop guessing wrong - #331

Merged
timgent merged 1 commit into
mainfrom
claude/no-pod-url-found-ucoozf
Aug 25, 2026
Merged

Say what "No pod URL found" actually means, and stop guessing wrong#331
timgent merged 1 commit into
mainfrom
claude/no-pod-url-found-ucoozf

Conversation

@timgent

@timgent timgent commented Aug 25, 2026

Copy link
Copy Markdown
Owner

Sentry has been collecting Error: No pod URL found from the packing list
view. It comes from usePodSync: getPrimaryPodUrl returned null, so the hook
threw a bare Error, view-packing-list's onSaveError handed the string to
reportError, and the user was shown "Failed to save to Pod: No pod URL found".

Three things were wrong with that.

The null meant three different things. A signed-out session, a WebID profile
we couldn't read this second, and an account that declares no storage at all
are not the same problem — the first two are a moment, the third is a fact.
resolvePodUrl now returns the reason alongside the URL, and
PodUrlUnavailableError carries it to the callbacks. getPrimaryPodUrl keeps
its old shape for the call sites that only want the URL.

A momentary failure was the loudest thing in the app. The list view polls every
five seconds, so a bad minute of network meant an error per tick; the save path
turned the same condition into an exception in Sentry with only
errorReporting's own frames for a stack, because it was given a string. Sync
now skips a Pod it can't locate yet and lets the next poll pick it up, saves
report through onSaveError with the error itself attached, and the page keeps a
retryable one out of Sentry while still telling the user, in words, that the
change is on this device only. An account with no storage declared reports as
it always did — no later attempt fixes that one.

And the lookup gave up early. A WebID profile is public by design, so when the
authenticated read fails the token is the likeliest culprit: expired between
check and request, a DPoP nonce race, a refresh still in flight. Retrying the
same document unauthenticated costs one request in the only case where we would
otherwise have given up — and giving up here does not just skip a poll, it
drops a save.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01KeURbAVUoDvihv7cvqDkLE

Sentry has been collecting `Error: No pod URL found` from the packing list
view. It comes from usePodSync: `getPrimaryPodUrl` returned null, so the hook
threw a bare Error, view-packing-list's onSaveError handed the *string* to
reportError, and the user was shown "Failed to save to Pod: No pod URL found".

Three things were wrong with that.

The null meant three different things. A signed-out session, a WebID profile
we couldn't read this second, and an account that declares no storage at all
are not the same problem — the first two are a moment, the third is a fact.
`resolvePodUrl` now returns the reason alongside the URL, and
`PodUrlUnavailableError` carries it to the callbacks. `getPrimaryPodUrl` keeps
its old shape for the call sites that only want the URL.

A momentary failure was the loudest thing in the app. The list view polls every
five seconds, so a bad minute of network meant an error per tick; the save path
turned the same condition into an exception in Sentry with only
errorReporting's own frames for a stack, because it was given a string. Sync
now skips a Pod it can't locate yet and lets the next poll pick it up, saves
report through onSaveError with the error itself attached, and the page keeps a
retryable one out of Sentry while still telling the user, in words, that the
change is on this device only. An account with no storage declared reports as
it always did — no later attempt fixes that one.

And the lookup gave up early. A WebID profile is public by design, so when the
authenticated read fails the token is the likeliest culprit: expired between
check and request, a DPoP nonce race, a refresh still in flight. Retrying the
same document unauthenticated costs one request in the only case where we would
otherwise have given up — and giving up here does not just skip a poll, it
drops a save.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeURbAVUoDvihv7cvqDkLE
@vercel

vercel Bot commented Aug 25, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
react-packing-app Ready Ready Preview Aug 25, 2026 8:43pm

@timgent
timgent merged commit 71224c1 into main Aug 25, 2026
4 checks passed
@timgent
timgent deleted the claude/no-pod-url-found-ucoozf branch August 25, 2026 20:47
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.

2 participants