html-renderer-api 1.0.221 → 1.0.223
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/CLAUDE.md +0 -28
package/package.json
CHANGED
package/CLAUDE.md
DELETED
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
# CLAUDE.md — `html-renderer-api`
|
|
2
|
-
|
|
3
|
-
**Read [`skills/ask-html-renderer-api`](../../skills/ask-html-renderer-api/SKILL.md)
|
|
4
|
-
first.**
|
|
5
|
-
|
|
6
|
-
A Cloudflare **Worker + Durable Object** that keeps a browser warm and renders
|
|
7
|
-
DOM with Puppeteer, to get HTML from JS-rendered pages and get past
|
|
8
|
-
bot-blocking. Published.
|
|
9
|
-
|
|
10
|
-
## The Durable Object is the design
|
|
11
|
-
|
|
12
|
-
- **Its whole purpose is keeping a browser warm.** A change that tears down and
|
|
13
|
-
relaunches per request removes the reason the package exists.
|
|
14
|
-
- A DO is single-threaded and long-lived: a leaked page, an unawaited
|
|
15
|
-
navigation, or an unbounded queue wedges it for everyone routed to it.
|
|
16
|
-
Always close what you open, on the error path too.
|
|
17
|
-
- Browser rendering is billed and rate-limited. Concurrency caps and timeouts
|
|
18
|
-
are cost control, not politeness — don't relax one to make a slow page work.
|
|
19
|
-
|
|
20
|
-
## Rules
|
|
21
|
-
|
|
22
|
-
- It fetches arbitrary user-supplied URLs: block local/private addresses, cap
|
|
23
|
-
page weight and render time.
|
|
24
|
-
- Never return page-supplied content unsanitized to a caller that renders it.
|
|
25
|
-
- Workers constraints apply — no Node-only APIs, no filesystem. A passing Node
|
|
26
|
-
test does not prove it runs; exercise it with wrangler.
|
|
27
|
-
|
|
28
|
-
The self-hosted, non-Worker variants live in `packages/render-url-to-html`.
|