Skip to content
This repository was archived by the owner on Sep 24, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,12 +168,12 @@ export default async function headers(request, context, next) {
```

Reuse middleware on other routes, return a response early, or share request-local
values through `context.state`. Under the pinned `0.5.8` runtime
values through `context.state`. Under the pinned `0.5.9` runtime
middleware runs trusted and in-process by default, exactly as functions do: a
chain shares one deadline, but not a sandbox unless the route opts in with
`sandbox: true`. The regular redirect keeps its native fast path without
middleware.
See [middleware semantics for this pin](https://github.com/jimhoyd-com/urlcode/blob/v0.5.8/docs/MIDDLEWARE.md)
See [middleware semantics for this pin](https://github.com/jimhoyd-com/urlcode/blob/v0.5.9/docs/MIDDLEWARE.md)
for ordering, native body limits, binding policy and explicit test requirements.

## Method defaults
Expand Down Expand Up @@ -248,7 +248,7 @@ checks, outgoing headers and native text/JSON responses in YAML. See the
The runtime also supports [pages, files and downloads](https://github.com/jimhoyd-com/urlcode/blob/main/docs/ASSETS.md).
These features need no extra example clutter in your starting project.

In the `0.5.8` runtime this template pins, `function` and `middleware`
In the `0.5.9` runtime this template pins, `function` and `middleware`
routes run **trusted and unsandboxed** in the host process, with full Node,
filesystem and network access, exactly like any other project code
([decision record](https://github.com/jimhoyd-com/urlcode/blob/main/docs/SPIKE-DEFAULT-TRUST-MODEL.md)).
Expand All @@ -270,11 +270,11 @@ neither input validation nor authentication. The example routes in this template
are trusted deliberately and need no secrets.
Keep any future secret values in ignored `.env.local` locally or injected by your
host; external bindings require a separate operator policy. Read the
[security model for this pin](https://github.com/jimhoyd-com/urlcode/blob/v0.5.8/docs/FUNCTION-SECURITY.md).
[security model for this pin](https://github.com/jimhoyd-com/urlcode/blob/v0.5.9/docs/FUNCTION-SECURITY.md).
Never commit credentials, tokens or session cookies in YAML headers.

This template pins the `0.5.8` published local/self-hosted runtime. Review the
[release-readiness gates](https://github.com/jimhoyd-com/urlcode/blob/v0.5.8/docs/RELEASE-READINESS.md) before deployment. Read the
This template pins the `0.5.9` published local/self-hosted runtime. Review the
[release-readiness gates](https://github.com/jimhoyd-com/urlcode/blob/v0.5.9/docs/RELEASE-READINESS.md) before deployment. Read the
[operations guide](https://github.com/jimhoyd-com/urlcode/blob/main/docs/OPERATIONS.md)
before deploying. Provider adapters and URLCode Cloud remain future work.

Expand All @@ -287,15 +287,15 @@ After adding references in YAML, run `npm run scaffold -- --dry-run` to preview
missing files, then `npm run scaffold` to create them. Existing files stay intact.
Function/middleware placeholders return 501 until implemented; binary assets and
external bindings are reported for you to supply.
[Full guide](https://github.com/jimhoyd-com/urlcode/blob/v0.5.8/docs/SCAFFOLDING.md).
[Full guide](https://github.com/jimhoyd-com/urlcode/blob/v0.5.9/docs/SCAFFOLDING.md).

## Security notes for the pinned runtime

The pinned runtime includes security fixes for failed log collectors, management
HTTP admission/timeouts, and metadata-only development watching. Review the
[security audit and remaining gates](https://github.com/jimhoyd-com/urlcode/blob/v0.5.8/docs/SECURITY-AUDIT.md) before production use.
[security audit and remaining gates](https://github.com/jimhoyd-com/urlcode/blob/v0.5.9/docs/SECURITY-AUDIT.md) before production use.

The pinned runtime includes bounded configuration loading, loopback-only management,
scoped/expiring/revocable operator credentials and atomic mutation audits. Read the
[management security guide](https://github.com/jimhoyd-com/urlcode/blob/v0.5.8/docs/MANAGEMENT-SECURITY.md)
[management security guide](https://github.com/jimhoyd-com/urlcode/blob/v0.5.9/docs/MANAGEMENT-SECURITY.md)
before operating the management endpoint. Independent assessment and deployment acceptance remain open.
8 changes: 4 additions & 4 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,6 @@
"scaffold": "urlcode scaffold"
},
"dependencies": {
"@jimhoyd/urlcode": "0.5.8"
"@jimhoyd/urlcode": "0.5.9"
}
}
2 changes: 1 addition & 1 deletion routes/functions.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=https://raw.githubusercontent.com/jimhoyd-com/urlcode/v0.5.8/schemas/urlcode.schema.json
# yaml-language-server: $schema=https://raw.githubusercontent.com/jimhoyd-com/urlcode/v0.5.9/schemas/urlcode.schema.json
# File locations do not change route paths. GET/HEAD are the default methods.
version: "1"
routes:
Expand Down
2 changes: 1 addition & 1 deletion routes/marketing/links.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# yaml-language-server: $schema=https://raw.githubusercontent.com/jimhoyd-com/urlcode/v0.5.8/schemas/urlcode.schema.json
# yaml-language-server: $schema=https://raw.githubusercontent.com/jimhoyd-com/urlcode/v0.5.9/schemas/urlcode.schema.json
version: "1"
routes:
# A regular redirect needs no custom code.
Expand Down
Loading