@pulse-compute/runtime 1.0.0-beta.2 → 1.0.0-beta.3
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/README.md +2 -2
- package/docs/API.md +14 -14
- package/docs/guides/routing.md +1 -1
- package/docs/preview-scope.md +3 -3
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
> **Supported entry points:** `@pulse-compute/runtime`<br>
|
|
8
8
|
> **Stability:** Supported application authoring and execution contract.<br>
|
|
9
9
|
> **npm:** [`@pulse-compute/runtime`](https://www.npmjs.com/package/@pulse-compute/runtime)<br>
|
|
10
|
-
> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.
|
|
10
|
+
> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.3/packages/runtime/)
|
|
11
11
|
>
|
|
12
|
-
> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.
|
|
12
|
+
> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.3` package policy.
|
|
13
13
|
<!-- pulse-package-status:end -->
|
|
14
14
|
|
|
15
15
|
`@pulse-compute/runtime` is the low-level, provider-neutral Pulse application contract.
|
package/docs/API.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Pulse runtime contract
|
|
2
2
|
|
|
3
3
|
For source eligibility, use [Managed handler TypeScript and
|
|
4
|
-
JavaScript](https://pulsecompute.io/v1.0.0-beta.
|
|
4
|
+
JavaScript](https://pulsecompute.io/v1.0.0-beta.3/reference/handler-authoring/). For provider and target
|
|
5
5
|
differences, use the [compatibility
|
|
6
|
-
matrix](https://pulsecompute.io/v1.0.0-beta.
|
|
6
|
+
matrix](https://pulsecompute.io/v1.0.0-beta.3/reference/compatibility-matrix/). For CLI and runtime failures,
|
|
7
7
|
use the stable codes in the [diagnostics
|
|
8
|
-
reference](https://pulsecompute.io/v1.0.0-beta.
|
|
8
|
+
reference](https://pulsecompute.io/v1.0.0-beta.3/reference/diagnostics/).
|
|
9
9
|
|
|
10
10
|
This document describes the provider-neutral TypeScript application contract compiled by Pulse. Low-level authoring types and the static `Router` come from `@pulse-compute/runtime`. The public `@pulse-compute/pulse` package owns the conventional `Pulse` application root, deferred project configuration, and schema declarations, while `@pulse-compute/cli` owns workspace orchestration.
|
|
11
11
|
|
|
@@ -49,7 +49,7 @@ Every managed handler is async-shaped:
|
|
|
49
49
|
type Handler = (ctx: PulseContext) => Promise<PulseResult | PulseFetchResponse>
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
For native targets the compiler erases the async wrapper. Awaited Pulse effects lower into the existing explicit effect and continuation state machine; no Promise runtime or Asyncify transform is linked. Awaiting a proven synchronous `ctx` expression is redundant and may warn, while arbitrary non-Pulse awaits mark the native eligibility boundary. The canonical [handler authoring reference](https://pulsecompute.io/v1.0.0-beta.
|
|
52
|
+
For native targets the compiler erases the async wrapper. Awaited Pulse effects lower into the existing explicit effect and continuation state machine; no Promise runtime or Asyncify transform is linked. Awaiting a proven synchronous `ctx` expression is redundant and may warn, while arbitrary non-Pulse awaits mark the native eligibility boundary. The canonical [handler authoring reference](https://pulsecompute.io/v1.0.0-beta.3/reference/handler-authoring/) defines the static language subset; the [compatibility matrix](https://pulsecompute.io/v1.0.0-beta.3/reference/compatibility-matrix/) owns the tested four-mode claims.
|
|
53
53
|
|
|
54
54
|
## Static `Router`
|
|
55
55
|
|
|
@@ -137,9 +137,9 @@ eligibility. Fastly targets fail closed because no event ingress/emit adapter is
|
|
|
137
137
|
claimed. There is no public event injection command, no event-aware development
|
|
138
138
|
listener, no HTTP/GRIP translation, and no automatic target fallback.
|
|
139
139
|
|
|
140
|
-
The [static events guide](https://pulsecompute.io/v1.0.0-beta.
|
|
140
|
+
The [static events guide](https://pulsecompute.io/v1.0.0-beta.3/guides/events/) owns the complete frame,
|
|
141
141
|
queue, target-eligibility, diagnostic, and Native-extension contract. The
|
|
142
|
-
source-bound [event example](https://pulsecompute.io/v1.0.0-beta.
|
|
142
|
+
source-bound [event example](https://pulsecompute.io/v1.0.0-beta.3/examples/11-events/) runs the same mixed project
|
|
143
143
|
on Node JavaScript and Node Native.
|
|
144
144
|
|
|
145
145
|
## `ctx.req`
|
|
@@ -482,12 +482,12 @@ forms lower into canonical package operations; JavaScript targets execute the
|
|
|
482
482
|
real package implementation.
|
|
483
483
|
|
|
484
484
|
Older `/pulsewasm` imports are compatibility-only and are isolated in the
|
|
485
|
-
[migration guide](https://pulsecompute.io/v1.0.0-beta.
|
|
486
|
-
[GRIP package guide](https://pulsecompute.io/v1.0.0-beta.
|
|
485
|
+
[migration guide](https://pulsecompute.io/v1.0.0-beta.3/guides/compatibility-imports/). See the
|
|
486
|
+
[GRIP package guide](https://pulsecompute.io/v1.0.0-beta.3/packages/grip/) for the complete current surface.
|
|
487
487
|
|
|
488
488
|
## Entities API
|
|
489
489
|
|
|
490
|
-
`@pulse-compute/entities` is part of the synchronized `1.0.0-beta.
|
|
490
|
+
`@pulse-compute/entities` is part of the synchronized `1.0.0-beta.3` package
|
|
491
491
|
set. The application surface has two runtime values:
|
|
492
492
|
|
|
493
493
|
```ts
|
|
@@ -549,9 +549,9 @@ Registrations and the terminal binding must use the supported static form. The
|
|
|
549
549
|
first-party JSON-RPC adapter accepts bounded JSON-RPC 2.0 request objects and
|
|
550
550
|
named params, validates declared schemas, uses stable error framing, and
|
|
551
551
|
acknowledges notifications with HTTP `204`. See the [package
|
|
552
|
-
guide](https://pulsecompute.io/v1.0.0-beta.
|
|
553
|
-
model](https://pulsecompute.io/v1.0.0-beta.
|
|
554
|
-
example](https://pulsecompute.io/v1.0.0-beta.
|
|
552
|
+
guide](https://pulsecompute.io/v1.0.0-beta.3/packages/entities/), [entity/adapter
|
|
553
|
+
model](https://pulsecompute.io/v1.0.0-beta.3/concepts/entities-and-adapters/), and [executable
|
|
554
|
+
example](https://pulsecompute.io/v1.0.0-beta.3/examples/10-entities-tools/).
|
|
555
555
|
|
|
556
556
|
## Project workflow
|
|
557
557
|
|
|
@@ -568,5 +568,5 @@ selected profile, handler entry, schema declarations, provider bindings, and
|
|
|
568
568
|
output directory through `.pulse/config.ts`. `pulse inspect` is optional
|
|
569
569
|
observability, and `pulse compile` is the advanced provider-neutral Native
|
|
570
570
|
artifact command; neither is required before `pulse build`. See the [project
|
|
571
|
-
lifecycle guide](https://pulsecompute.io/v1.0.0-beta.
|
|
572
|
-
reference](https://pulsecompute.io/v1.0.0-beta.
|
|
571
|
+
lifecycle guide](https://pulsecompute.io/v1.0.0-beta.3/guides/project-lifecycle/) and [CLI
|
|
572
|
+
reference](https://pulsecompute.io/v1.0.0-beta.3/reference/cli/).
|
package/docs/guides/routing.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Static Router authoring
|
|
2
2
|
|
|
3
|
-
Use `Router` when an application has several method/path entry points or needs compile-time middleware. It is a static authoring marker from `@pulse-compute/runtime`, not a JavaScript runtime dispatcher. The shared async/static restrictions are defined in [Managed handler TypeScript and JavaScript](https://pulsecompute.io/v1.0.0-beta.
|
|
3
|
+
Use `Router` when an application has several method/path entry points or needs compile-time middleware. It is a static authoring marker from `@pulse-compute/runtime`, not a JavaScript runtime dispatcher. The shared async/static restrictions are defined in [Managed handler TypeScript and JavaScript](https://pulsecompute.io/v1.0.0-beta.3/reference/handler-authoring/); target claims live in the [compatibility matrix](https://pulsecompute.io/v1.0.0-beta.3/reference/compatibility-matrix/).
|
|
4
4
|
|
|
5
5
|
<!-- pulse-doc-source: examples/09-router-lowering/src/index.ts -->
|
|
6
6
|
```ts
|
package/docs/preview-scope.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Beta scope
|
|
2
2
|
|
|
3
|
-
Pulse `1.0.0-beta.
|
|
3
|
+
Pulse `1.0.0-beta.3` is a Beta of one provider-neutral application contract
|
|
4
4
|
with explicit Native and JavaScript execution targets. The intended 1.0
|
|
5
5
|
surface is present, but deliberate corrections may still occur before the
|
|
6
6
|
stable `1.0.0` release.
|
|
@@ -106,13 +106,13 @@ JavaScript-selected project into a Native one.
|
|
|
106
106
|
## Compatibility authority
|
|
107
107
|
|
|
108
108
|
The single source-form, provider-binding, artifact, and deployment-boundary
|
|
109
|
-
table is [Provider and target compatibility](https://pulsecompute.io/v1.0.0-beta.
|
|
109
|
+
table is [Provider and target compatibility](https://pulsecompute.io/v1.0.0-beta.3/reference/compatibility-matrix/).
|
|
110
110
|
It uses one public target order—Node JavaScript, Fastly JavaScript, Node Native,
|
|
111
111
|
and Fastly Native—and links every row to a focused proof or canonical contract.
|
|
112
112
|
|
|
113
113
|
The exact portable language subset and the JavaScript-only Native eligibility
|
|
114
114
|
boundaries are defined in
|
|
115
|
-
[Managed handler TypeScript and JavaScript](https://pulsecompute.io/v1.0.0-beta.
|
|
115
|
+
[Managed handler TypeScript and JavaScript](https://pulsecompute.io/v1.0.0-beta.3/reference/handler-authoring/).
|
|
116
116
|
|
|
117
117
|
## Body model
|
|
118
118
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pulse-compute/runtime",
|
|
3
|
-
"version": "1.0.0-beta.
|
|
3
|
+
"version": "1.0.0-beta.3",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"engines": {
|
|
6
6
|
"node": "^22.14.0 || ^24.0.0"
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"url": "git+https://github.com/pulse-compute/pulse.git",
|
|
42
42
|
"directory": "packages/runtime"
|
|
43
43
|
},
|
|
44
|
-
"homepage": "https://pulsecompute.io/v1.0.0-beta.
|
|
44
|
+
"homepage": "https://pulsecompute.io/v1.0.0-beta.3/packages/runtime/",
|
|
45
45
|
"bugs": {
|
|
46
46
|
"url": "https://github.com/pulse-compute/pulse/issues"
|
|
47
47
|
}
|