Skip to content

docs/test: fetchWebKey example route + conformance coverage - #204

Merged
gmoon merged 2 commits into
masterfrom
feat/fetchwebkey-example
Nov 1, 2026
Merged

gmoon merged 2 commits into
masterfrom
feat/fetchwebkey-example

Conversation

@gmoon

@gmoon gmoon commented Nov 1, 2026

Copy link
Copy Markdown
Owner

Builds on the fetchWebKey API (shipped in #203) with a runnable example and end-to-end conformance coverage, ahead of the 5.1.0 release.

Changes

  • examples/hono-basic.ts: a /download/:id route using fetchWebKey — an alias map (standing in for a DB / token resolver / tenant prefix) decouples the public id from the storage key, demonstrating verbatim key serving (incl. a reserved-character key the URL path can't carry).
  • conformance: bump @forkzero/s3-website-test-kit ^0.4.0 → ^0.5.0 (adds scenarios/s3proxy/key-addressed.yml) and extend make conformance-local to run it against hono-basic on :8083. CI's conformance gate now exercises fetchWebKey end-to-end.

Verified against real S3

  • make conformance-local → exit 0: fastify core/error (expect.ok 16) + hono key-addressed (/download/home & /download/special → 200, /download/bogus → 404, expect.ok 4), vusers.failed: 0.
  • lint / type-check / build / 84 unit tests all green.

Related: #162, forkzero/s3-website-test-kit#11.

🤖 Generated with Claude Code

gmoon and others added 2 commits November 1, 2026 11:00
Demonstrates the key-addressed seam: an alias map (standing in for a DB /
token resolver / tenant prefix) decouples the public id from the storage key,
so a key full of reserved characters is served verbatim — the case the
URL-addressed fetchWeb path can't carry. Verified e2e against s3proxy-public:
/download/home -> index.html (200), /download/special -> the
specialCharacters!... object (200, 46B), /download/bogus -> 404.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Bumps @forkzero/s3-website-test-kit ^0.4.0 -> ^0.5.0 (adds
scenarios/s3proxy/key-addressed.yml) and extends `make conformance-local`
to run it against examples/hono-basic.ts on :8083 — so the CI conformance
gate exercises the new fetchWebKey /download/:id route end-to-end
(/download/home + /download/special -> 200, /download/bogus -> 404).
Verified green against real S3 (make conformance-local exit 0).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@gmoon
gmoon merged commit 348dee7 into master Nov 1, 2026
12 checks passed
@gmoon
gmoon deleted the feat/fetchwebkey-example branch November 1, 2026 16:14
@gmoon gmoon mentioned this pull request Nov 1, 2026
gmoon added a commit that referenced this pull request Nov 1, 2026
Minor: adds the public fetchWebKey(key, request) key-addressed Web seam
(#203) plus its example route and conformance coverage (#204). Backward
compatible; fetchWeb is unchanged.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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