@pulse-compute/runtime 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -7,9 +7,9 @@
 > **Supported entry points:** `@pulse-compute/runtime`<br>
 > **Stability:** Supported application authoring and execution contract.<br>
 > **npm:** [`@pulse-compute/runtime`](https://www.npmjs.com/package/@pulse-compute/runtime)<br>
-> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.2/packages/runtime/)
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.4/packages/runtime/)
 >
-> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.2` package policy.
+> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.4` package policy.
 <!-- pulse-package-status:end -->
 
 `@pulse-compute/runtime` is the low-level, provider-neutral Pulse application contract.

package/docs/API.md

@@ -1,11 +1,11 @@
 # Pulse runtime contract
 
 For source eligibility, use [Managed handler TypeScript and
-JavaScript](https://pulsecompute.io/v1.0.0-beta.2/reference/handler-authoring/). For provider and target
+JavaScript](https://pulsecompute.io/v1.0.0-beta.4/reference/handler-authoring/). For provider and target
 differences, use the [compatibility
-matrix](https://pulsecompute.io/v1.0.0-beta.2/reference/compatibility-matrix/). For CLI and runtime failures,
+matrix](https://pulsecompute.io/v1.0.0-beta.4/reference/compatibility-matrix/). For CLI and runtime failures,
 use the stable codes in the [diagnostics
-reference](https://pulsecompute.io/v1.0.0-beta.2/reference/diagnostics/).
+reference](https://pulsecompute.io/v1.0.0-beta.4/reference/diagnostics/).
 
 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.
 
@@ -27,6 +27,7 @@ process, provider SDK, or global network surface behind it.
 | [`ctx.state`](#ctxstate) | HTTP and event handlers | Invocation-local string state shared across one execution. |
 | [`ctx.fetch`](#ctxfetch) | HTTP and event handlers | Explicit outbound HTTP effect and structured or opaque response ownership. |
 | [`ctx.parallel`](#ctxparallel) | HTTP and event handlers | Statically keyed concurrent Pulse effects. |
+| [`ctx.encodeJson`](#ctxencodejson) | HTTP and event handlers | Synchronous schema-bound, size-limited JSON text. |
 | [`ctx.emit`](#ctxemit) | HTTP and event handlers | One-way, schema-bound event acceptance effect. |
 | [`ctx.log`](#ctxlog) | HTTP and event handlers | Synchronous thresholded logging. |
 | [`ctx.config`, `ctx.secret`](#config-and-secrets) | HTTP and event handlers | Explicit configured binding reads. |
@@ -49,7 +50,7 @@ Every managed handler is async-shaped:
 type Handler = (ctx: PulseContext) => Promise<PulseResult | PulseFetchResponse>
 ```
 
-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.2/reference/handler-authoring/) defines the static language subset; the [compatibility matrix](https://pulsecompute.io/v1.0.0-beta.2/reference/compatibility-matrix/) owns the tested four-mode claims.
+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.4/reference/handler-authoring/) defines the static language subset; the [compatibility matrix](https://pulsecompute.io/v1.0.0-beta.4/reference/compatibility-matrix/) owns the tested four-mode claims.
 
 ## Static `Router`
 
@@ -137,9 +138,9 @@ eligibility. Fastly targets fail closed because no event ingress/emit adapter is
 claimed. There is no public event injection command, no event-aware development
 listener, no HTTP/GRIP translation, and no automatic target fallback.
 
-The [static events guide](https://pulsecompute.io/v1.0.0-beta.2/guides/events/) owns the complete frame,
+The [static events guide](https://pulsecompute.io/v1.0.0-beta.4/guides/events/) owns the complete frame,
 queue, target-eligibility, diagnostic, and Native-extension contract. The
-source-bound [event example](https://pulsecompute.io/v1.0.0-beta.2/examples/11-events/) runs the same mixed project
+source-bound [event example](https://pulsecompute.io/v1.0.0-beta.4/examples/11-events/) runs the same mixed project
 on Node JavaScript and Node Native.
 
 ## `ctx.req`
@@ -441,6 +442,19 @@ incomplete capability mapping and does not define or block
 Pulse's contract. Conditional wire values use the strict
 `{"__pulseKv":1,"value":...}` envelope; legacy raw JSON requires explicit migration.
 
+## `ctx.encodeJson`
+
+```ts
+const text = ctx.encodeJson(candidate, 'app.Candidate')
+```
+
+Requires a literal registered schema even in non-strict mode. Validates and
+projects the value, then returns detached JSON text bounded by `schemas.maxBytes`
+in UTF-8 bytes. It does not create a response or dispatch an effect. Invalid
+values and oversized text fail before subsequent writes. Declaration order and
+array order are preserved; cross-target parity is semantic, not a universal
+canonical-byte format. See [application-owned encoding](https://pulsecompute.io/v1.0.0-beta.4/guides/json-schemas/#encode-application-owned-text).
+
 ## Explicit JSON schemas
 
 <!-- pulse-doc-source: examples/02-request-schema/.pulse/config.ts -->
@@ -482,12 +496,12 @@ forms lower into canonical package operations; JavaScript targets execute the
 real package implementation.
 
 Older `/pulsewasm` imports are compatibility-only and are isolated in the
-[migration guide](https://pulsecompute.io/v1.0.0-beta.2/guides/compatibility-imports/). See the
-[GRIP package guide](https://pulsecompute.io/v1.0.0-beta.2/packages/grip/) for the complete current surface.
+[migration guide](https://pulsecompute.io/v1.0.0-beta.4/guides/compatibility-imports/). See the
+[GRIP package guide](https://pulsecompute.io/v1.0.0-beta.4/packages/grip/) for the complete current surface.
 
 ## Entities API
 
-`@pulse-compute/entities` is part of the synchronized `1.0.0-beta.2` package
+`@pulse-compute/entities` is part of the synchronized `1.0.0-beta.4` package
 set. The application surface has two runtime values:
 
 ```ts
@@ -549,9 +563,9 @@ Registrations and the terminal binding must use the supported static form. The
 first-party JSON-RPC adapter accepts bounded JSON-RPC 2.0 request objects and
 named params, validates declared schemas, uses stable error framing, and
 acknowledges notifications with HTTP `204`. See the [package
-guide](https://pulsecompute.io/v1.0.0-beta.2/packages/entities/), [entity/adapter
-model](https://pulsecompute.io/v1.0.0-beta.2/concepts/entities-and-adapters/), and [executable
-example](https://pulsecompute.io/v1.0.0-beta.2/examples/10-entities-tools/).
+guide](https://pulsecompute.io/v1.0.0-beta.4/packages/entities/), [entity/adapter
+model](https://pulsecompute.io/v1.0.0-beta.4/concepts/entities-and-adapters/), and [executable
+example](https://pulsecompute.io/v1.0.0-beta.4/examples/10-entities-tools/).
 
 ## Project workflow
 
@@ -568,5 +582,5 @@ selected profile, handler entry, schema declarations, provider bindings, and
 output directory through `.pulse/config.ts`. `pulse inspect` is optional
 observability, and `pulse compile` is the advanced provider-neutral Native
 artifact command; neither is required before `pulse build`. See the [project
-lifecycle guide](https://pulsecompute.io/v1.0.0-beta.2/guides/project-lifecycle/) and [CLI
-reference](https://pulsecompute.io/v1.0.0-beta.2/reference/cli/).
+lifecycle guide](https://pulsecompute.io/v1.0.0-beta.4/guides/project-lifecycle/) and [CLI
+reference](https://pulsecompute.io/v1.0.0-beta.4/reference/cli/).

package/docs/guides/routing.md

@@ -1,6 +1,6 @@
 # Static Router authoring
 
-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.2/reference/handler-authoring/); target claims live in the [compatibility matrix](https://pulsecompute.io/v1.0.0-beta.2/reference/compatibility-matrix/).
+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.4/reference/handler-authoring/); target claims live in the [compatibility matrix](https://pulsecompute.io/v1.0.0-beta.4/reference/compatibility-matrix/).
 
 <!-- pulse-doc-source: examples/09-router-lowering/src/index.ts -->
 ```ts

package/docs/preview-scope.md

@@ -1,6 +1,6 @@
 # Beta scope
 
-Pulse `1.0.0-beta.2` is a Beta of one provider-neutral application contract
+Pulse `1.0.0-beta.4` is a Beta of one provider-neutral application contract
 with explicit Native and JavaScript execution targets. The intended 1.0
 surface is present, but deliberate corrections may still occur before the
 stable `1.0.0` release.
@@ -106,13 +106,13 @@ JavaScript-selected project into a Native one.
 ## Compatibility authority
 
 The single source-form, provider-binding, artifact, and deployment-boundary
-table is [Provider and target compatibility](https://pulsecompute.io/v1.0.0-beta.2/reference/compatibility-matrix/).
+table is [Provider and target compatibility](https://pulsecompute.io/v1.0.0-beta.4/reference/compatibility-matrix/).
 It uses one public target order—Node JavaScript, Fastly JavaScript, Node Native,
 and Fastly Native—and links every row to a focused proof or canonical contract.
 
 The exact portable language subset and the JavaScript-only Native eligibility
 boundaries are defined in
-[Managed handler TypeScript and JavaScript](https://pulsecompute.io/v1.0.0-beta.2/reference/handler-authoring/).
+[Managed handler TypeScript and JavaScript](https://pulsecompute.io/v1.0.0-beta.4/reference/handler-authoring/).
 
 ## Body model
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulse-compute/runtime",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "license": "Apache-2.0",
   "engines": {
     "node": "^22.14.0 || ^24.0.0"
@@ -41,7 +41,7 @@
     "url": "git+https://github.com/pulse-compute/pulse.git",
     "directory": "packages/runtime"
   },
-  "homepage": "https://pulsecompute.io/v1.0.0-beta.2/packages/runtime/",
+  "homepage": "https://pulsecompute.io/v1.0.0-beta.4/packages/runtime/",
   "bugs": {
     "url": "https://github.com/pulse-compute/pulse/issues"
   }

package/src/index.d.ts

@@ -135,6 +135,8 @@ export type PulseEmitEvent<Payload = unknown> =
 
 /** Plane-neutral authority shared by one isolated HTTP request or event invocation. */
 export interface PulseExecutionContext {
+  /** Validate/project a value through a literal registered schema and return bounded JSON text. */
+  encodeJson(value: unknown, schemaId: string): string;
   readonly state: PulseState;
   readonly log: PulseLogger;
   fetch(url: string, init?: PulseFetchInit): PulseFetchOperation;

package/src/internal/context.js

@@ -2,7 +2,7 @@
 
 const { createStructuredBodyReader, normalizeBodyLimit } = require('./body.js');
 const { normalizeFetchRequest } = require('./fetch.js');
-const { decodeSchemaText, strictSchemaPolicy } = require('./schema.js');
+const { decodeSchemaText, encodeSchemaValue, requireExplicitSchemaId, strictSchemaPolicy } = require('./schema.js');
 const {
   cloneKvValue,
   normalizeBindingName,
@@ -157,6 +157,10 @@ function createContext(frame) {
 
   const eventContext = frame.event !== undefined;
   const ctx = {
+    encodeJson(value, schemaId) {
+      const id = requireExplicitSchemaId(schemaId, options, 'application-value');
+      return encodeSchemaValue(id, value, options, { source: 'application-value' }).text;
+    },
     ...(eventContext ? {} : { req }),
     state,
     log,

package/src/internal/schema.js

@@ -247,9 +247,10 @@ function encodeSchemaValue(schemaId, value, options = {}, context = {}) {
   const codecs = requireSchemaCodecs(options, id, source);
   try {
     const text = codecs.encodeJsonText(id, value, source);
+    if (source === 'application-value') assertSchemaBodySize(options, text, id, source);
     const normalized = codecs.decodeJsonText(id, text, `${source}-trace`);
     emitSchemaTrace(options, {
-      kind: source === 'fetch-request' ? 'json.encode.fetch' : 'json.encode.response',
+      kind: source === 'application-value' ? 'json.encode.value' : source === 'fetch-request' ? 'json.encode.fetch' : 'json.encode.response',
       boundary: source,
       schemaId: id,
       responseCaseId: context.responseCaseId || null,