fix: resolve host-relative follow-up links against the origin, not baseUrl

[sundar-svg]

Description

TypeScript mirror of Comfy-Org/ComfyPythonSDK#17 — the same bug existed verbatim in urlFor (src/low/transport.ts).

The serverless gateway serves the v2 contract under /deployment/{id}/api/v2 and returns job.urls.* follow-up links that are host-relative and already include that mount prefix. urlFor only recognized links starting with /api/, so a gateway self link fell into the internal-shorthand branch and was built as baseUrl + /api/v2 + link → double prefix → 404 on the first poll after submit.

Fix: a leading-slash path containing /api/ is a server-returned link and resolves against the origin — the link is authoritative about its own path. Internal shorthand paths (/jobs/…, /assets…) still resolve under baseUrl + /api/v2; Cloud / self-hosted construction is byte-identical (baseUrl == origin there); auth attachment is unaffected (same origin, existing isSameOrigin logic).

The resolution rule is being pinned in the contract itself: Comfy-Org/cloud#5498 documents it on the JobUrls schema.

How tested

• pnpm test — 134 passed (130 existing + 4 new resolution/auth regression tests in src/low/followUpLinks.test.ts, driven through a capturing fetch so the full request path is exercised)
• pnpm lint, pnpm typecheck clean

🤖 Generated with Claude Code

https://claude.ai/code/session_01KV7wUb2hyzKHsR52ZJTvAm

[coderabbitai]

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (1)

Validation error: Too big: expected string to have <=250 characters at "tone_instructions"

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: ee955765-dc9b-4bc8-a537-13d96de250b8

📥 Commits

Reviewing files that changed from the base of the PR and between 3716a17 and 684168e.

📒 Files selected for processing (2)

• src/low/followUpLinks.test.ts
• src/low/transport.ts

---

📝 Walkthrough

Walkthrough

Changes

Follow-up Link URL Resolution

Layer / File(s)	Summary
Mounted link resolution and validation src/low/transport.ts, src/low/followUpLinks.test.ts	ComfyLow.urlFor resolves server paths containing /api/ against the origin of baseUrl, while tests verify gateway prefixes, shorthand paths, bare-surface links, and authorization headers.

Suggested reviewers: wei-hai

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch sundar/host-relative-follow-up-links

✨ Simplify code

• Create PR with simplified code
• Commit simplified code in branch sundar/host-relative-follow-up-links

---

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

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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