chore: publish accepted SDK and Alchemy prerequisite base - #11
Conversation
Accepted prerequisite integration base for consumed 0003 SDK and 0005 Alchemy content; this node makes no one-to-one implementation PR or completed journey claim.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 4f1db21553
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| const pageSize = Number(params?.itemsPerPage ?? params?.pageSize ?? 30) | ||
| const collectionSchema = Schema.Struct({ | ||
| "hydra:member": Schema.Array(itemSchema), | ||
| "hydra:totalItems": Schema.optional(Schema.Number), |
There was a problem hiding this comment.
Require hydra:totalItems in collection responses
When an otherwise valid Hydra response omits hydra:totalItems, this optional field lets decoding succeed and line 221 reports totalItems: 0, even when hydra:member contains records. That exposes an internally inconsistent page and can make pagination or empty-state logic hide valid results; the collection boundary should reject the malformed envelope instead of synthesizing a count.
Useful? React with 👍 / 👎.
| const ValidIsoDateString = Schema.String.pipe( | ||
| Schema.check( | ||
| Schema.makeFilter( | ||
| (value: string) => !Number.isNaN(new Date(value).getTime()), |
There was a problem hiding this comment.
Validate ISO syntax instead of Date parseability
When the API returns a parseable but invalid or non-ISO value, this predicate accepts it: for example, JavaScript normalizes 2026-02-30 to March 2 and parses strings such as March 1, 2026. The new strict boundary therefore exposes silently altered or platform-dependent receipt dates despite describing the input as a valid ISO string; validate the permitted ISO forms and calendar components before constructing the Date.
Useful? React with 👍 / 👎.
Accepted prerequisite base
This is an explicit stacked integration-base exception, not a one-to-one implementation PR and not a lifecycle advance.
It carries the accepted Effect v4 SDK compatibility payload from spec
0003and the accepted local Alchemy declaration payload from spec0005. Later completed one-to-one PRs consume these shared package, lock, SDK, and preview-declaration edges.Review boundary
design-specs/0003-effect-v4-receipt-sdk-compatibility.mddesign-specs/0005-cloudflare-alchemy-preview.mdWhat is real
The local prerequisite code and declarations are present. Spec 0003 remains consumed/Ready rather than a standalone completed journey, and spec 0005 still lacks provider plan/deploy/reachability/destroy evidence. This PR authorizes no provider, deployment, credential, remote, production, or lifecycle claim.