@pulse-compute/wasm-contracts 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -7,9 +7,9 @@
 > **Supported entry points:** `@pulse-compute/wasm-contracts/provider/toolchain`<br>
 > **Stability:** The provider toolchain contract is versioned and supported for the Beta; other protocol and proof interfaces remain internal.<br>
 > **npm:** [`@pulse-compute/wasm-contracts`](https://www.npmjs.com/package/@pulse-compute/wasm-contracts)<br>
-> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.2/packages/implementation-packages/)
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.4/packages/implementation-packages/)
 >
-> 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 -->
 
 This package owns stable data contracts shared by the compiler, runtime, and providers.

package/package.json

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

package/src/diagnostics.js

@@ -2,7 +2,7 @@
 
 const path = require('node:path');
 
-const PACKAGE_VERSION = 'pulsewasm-route-extractor@1.0.0-beta.2';
+const PACKAGE_VERSION = 'pulsewasm-route-extractor@1.0.0-beta.4';
 const DIAGNOSTICS_VERSION = 'pulsewasm.diagnostics.v1';
 
 function stableFileName(fileName, cwd) {

package/src/handler/canonical-native-plan.js

@@ -46,6 +46,7 @@ const CANONICAL_NATIVE_INTRINSICS = Object.freeze([
   'request.text',
   'request.json',
   'response.json',
+  'schema.encode.text',
   'response.text',
   'response.custom',
   'kv.namespace',

package/src/handler/canonical-native-runtime.js

@@ -74,6 +74,7 @@ const CANONICAL_NATIVE_IMPORTS = Object.freeze([
   ['router_match', ['i32', 'i32'], ['i32']],
   ['router_param', ['i32', 'i32', 'i32'], ['i32']],
   ['response_json', ['i32', 'i32'], ['i32']],
+  ['schema_encode', ['i32', 'i32'], ['i32']],
   ['response_text', ['i32', 'i32'], ['i32']],
   ['response_custom', ['i32'], ['i32']],
   ['grip_is_websocket', [], ['i32']],

package/src/handler/ctx-contract.js

@@ -6,7 +6,7 @@ const CTX_CONTRACT_VERSION = 'pulse.ctx-contract.v4';
 const CTX_CONTRACT_ID = 'pulse.ctx';
 const CTX_SURFACE_IDS = Object.freeze([
   'ctx.param','ctx.req.method','ctx.req.url','ctx.req.path','ctx.req.header','ctx.req.headers',
-  'ctx.state.get','ctx.state.set','ctx.json','ctx.text','ctx.response','ctx.req.text','ctx.req.json.schema',
+  'ctx.state.get','ctx.state.set','ctx.encodeJson','ctx.json','ctx.text','ctx.response','ctx.req.text','ctx.req.json.schema',
   'ctx.req.json.generic','ctx.fetch.projected','ctx.fetch.opaque-return','ctx.config.get','ctx.secret.get',
   'ctx.kv.get','ctx.kv.put','ctx.kv.getVersioned','ctx.kv.insertIfAbsent','ctx.kv.compareAndSwap','ctx.emit','package.operation'
 ]);
@@ -33,7 +33,7 @@ function defaultCtxContract() {
     handlerSurfaceVersion: HANDLER_SURFACE_CONTRACT_VERSION,
     surfaces: CTX_SURFACES,
     planes: Object.freeze({
-      sharedAuthoring: Object.freeze(['state', 'log', 'fetch', 'parallel', 'config', 'secret', 'kv', 'emit']),
+      sharedAuthoring: Object.freeze(['state', 'log', 'fetch', 'parallel', 'config', 'secret', 'kv', 'emit', 'encodeJson']),
       httpAuthoring: Object.freeze(['req', 'json', 'text', 'response']),
       routeAuthoring: Object.freeze(['param']),
       eventAuthoring: Object.freeze(['event.type', 'event.payload']),

package/src/handler/surface-contract.js

@@ -212,6 +212,18 @@ const HANDLER_SURFACE_DEFINITIONS = Object.freeze([
     nativeBehavior: 'construct-canonical-result',
     status: 'existing-alias-normalization'
   }),
+  surface({
+    id: 'ctx.encodeJson',
+    class: 'sync',
+    canonicalOperation: 'schema.encode.text',
+    publicForms: ["ctx.encodeJson(value, 'schema.id')"],
+    awaitPolicy: 'optional-redundant-warning',
+    validPositions: ['expression', 'statement', 'return'],
+    targetSupport: { javascript: true, native: true },
+    nativeBehavior: 'schema-validated-bounded-json-text',
+    schemaPolicy: 'literal-schema-required',
+    status: 'supported'
+  }),
   surface({
     id: 'ctx.text',
     class: 'sync',

package/src/handler/types-contract.js

@@ -20,7 +20,7 @@ function defaultHandlerTypesContract() {
       set: 'void'
     }),
     executionContexts: Object.freeze({
-      shared: Object.freeze(['state', 'log', 'fetch', 'parallel', 'config', 'secret', 'kv', 'emit']),
+      shared: Object.freeze(['state', 'log', 'fetch', 'parallel', 'config', 'secret', 'kv', 'emit', 'encodeJson']),
       http: Object.freeze(['req', 'json', 'text', 'response']),
       route: Object.freeze(['param']),
       event: Object.freeze(['event.type', 'event.payload']),

package/src/provider/toolchain.js

@@ -51,6 +51,7 @@ const DRIVER_FIELDS = Object.freeze([
   'events',
   'targets',
   'execute',
+  'prepareNativeExecution',
   'createLoweringPlan',
   'inspectRealization',
   'writeTarget',
@@ -366,6 +367,9 @@ function defineProviderDriver(input, expected = {}) {
   if ((targets.native && (targets.native.commands.test || targets.native.commands.dev)) && typeof input.execute !== 'function') {
     throw new TypeError(`Pulse provider driver ${id} is missing execute().`);
   }
+  if (input.prepareNativeExecution !== undefined && typeof input.prepareNativeExecution !== 'function') {
+    throw new TypeError(`Pulse provider driver ${id} prepareNativeExecution must be a function.`);
+  }
   const descriptor = input.descriptor === undefined ? undefined : normalizeDescriptor(input.descriptor);
   if (descriptor && descriptor.id !== id) throw new TypeError(`Pulse provider driver ${id} descriptor identity does not match.`);
   const javascript = normalizeJavascriptDriver(input.javascript, targets.javascript);
@@ -392,6 +396,7 @@ function defineProviderDriver(input, expected = {}) {
     events,
     targets,
     execute: input.execute,
+    prepareNativeExecution: input.prepareNativeExecution,
     createLoweringPlan: input.createLoweringPlan,
     inspectRealization: input.inspectRealization,
     writeTarget: input.writeTarget,
@@ -622,7 +627,7 @@ function createProviderTargetInvocation(input) {
     throw new TypeError(`Pulse provider target invocation version must be ${PROVIDER_TARGET_INVOCATION_VERSION}.`);
   }
   const action = nonEmpty(input.action, 'invocation action');
-  if (!['inspect-native', 'write-native', 'write-javascript'].includes(action)) {
+  if (!['inspect-native', 'write-native', 'write-javascript', 'execute-native'].includes(action)) {
     throw new TypeError(`Pulse provider target invocation action ${action} is unsupported.`);
   }
   const target = action.endsWith('javascript') ? 'javascript' : 'native';

package/src/schema-json/semantic-trace.js

@@ -9,10 +9,11 @@ const JSON_TRACE_EVENT_KINDS = Object.freeze([
   'json.decode.fetch',
   'json.encode.response',
   'json.encode.fetch',
+  'json.encode.value',
   'json.decode.error',
   'json.encode.error'
 ]);
-const JSON_BOUNDARIES = Object.freeze(['request', 'fetch-response', 'application-response', 'fetch-request']);
+const JSON_BOUNDARIES = Object.freeze(['request', 'fetch-response', 'application-response', 'fetch-request', 'application-value']);
 const JSON_BODY_OWNERSHIP = Object.freeze([
   'request-snapshot',
   'fetched-response-snapshot',
@@ -24,8 +25,9 @@ const JSON_EVENT_BOUNDARIES = Object.freeze({
   'json.decode.fetch': Object.freeze(['fetch-response']),
   'json.encode.response': Object.freeze(['application-response']),
   'json.encode.fetch': Object.freeze(['fetch-request']),
+  'json.encode.value': Object.freeze(['application-value']),
   'json.decode.error': Object.freeze(['request', 'fetch-response']),
-  'json.encode.error': Object.freeze(['application-response', 'fetch-request'])
+  'json.encode.error': Object.freeze(['application-response', 'fetch-request', 'application-value'])
 });
 
 function traceError(code, message, details = {}) {