@pulse-compute/wasm-schema-json 1.0.0-beta.3 → 1.0.0-beta.5

package/README.md

@@ -8,9 +8,9 @@
 > **Stability:** Internal schema compiler interface synchronized with this release set.<br>
 > **npm:** [`@pulse-compute/wasm-schema-json`](https://www.npmjs.com/package/@pulse-compute/wasm-schema-json)<br>
 > **Canonical replacement:** `schemas in .pulse/config.ts through the Pulse project workflow`<br>
-> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.3/packages/implementation-packages/)
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.5/packages/implementation-packages/)
 >
-> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.3` package policy.
+> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.5` package policy.
 <!-- pulse-package-status:end -->
 
 JSON schema compiler, canonical codec, registry, sidecar, and body-policy implementation for Pulse.
@@ -35,4 +35,4 @@ Application projects declare schemas in `pulse.config.*`; they do not install or
 
 The exported compiler modules are synchronized implementation interfaces without an application-author compatibility promise.
 
-See [Explicit JSON schemas](https://pulsecompute.io/v1.0.0-beta.3/guides/json-schemas/), [Project configuration](https://pulsecompute.io/v1.0.0-beta.3/reference/project-config/#json-schema-policy), and [Implementation packages](https://pulsecompute.io/v1.0.0-beta.3/packages/implementation-packages/).
+See [Explicit JSON schemas](https://pulsecompute.io/v1.0.0-beta.5/guides/json-schemas/), [Project configuration](https://pulsecompute.io/v1.0.0-beta.5/reference/project-config/#json-schema-policy), and [Implementation packages](https://pulsecompute.io/v1.0.0-beta.5/packages/implementation-packages/).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulse-compute/wasm-schema-json",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.5",
   "license": "Apache-2.0",
   "engines": {
     "node": "^22.14.0 || ^24.0.0"
@@ -19,8 +19,8 @@
     "./compiler/schema-registry": "./src/compiler/schema-registry.js"
   },
   "dependencies": {
-    "@pulse-compute/wasm-build-support": "1.0.0-beta.3",
-    "@pulse-compute/wasm-contracts": "1.0.0-beta.3",
+    "@pulse-compute/wasm-build-support": "1.0.0-beta.5",
+    "@pulse-compute/wasm-contracts": "1.0.0-beta.5",
     "typescript": "5.9.3"
   },
   "publishConfig": {
@@ -37,7 +37,7 @@
     "url": "git+https://github.com/pulse-compute/pulse.git",
     "directory": "wasm/packages/schema-json"
   },
-  "homepage": "https://pulsecompute.io/v1.0.0-beta.3/packages/implementation-packages/",
+  "homepage": "https://pulsecompute.io/v1.0.0-beta.5/packages/implementation-packages/",
   "bugs": {
     "url": "https://github.com/pulse-compute/pulse/issues"
   }

package/src/compiler/canonical-schema-codecs.js

@@ -13,8 +13,8 @@ const {
 const CANONICAL_SCHEMA_BUNDLE_VERSION = 'pulse.canonical-schema-bundle.v2';
 const CANONICAL_SCHEMA_REGISTRY_VERSION = 'pulse.canonical-schema-registry.v2';
 const CANONICAL_SCHEMA_CODECS_VERSION = 'pulse.canonical-schema-codecs.v2';
-const JAVASCRIPT_SCHEMA_CODEC_VERSION = 'pulse.javascript-schema-codec.v1';
-const NATIVE_SCHEMA_CODEC_VERSION = 'pulse.native-json-as-schema-codec.v1';
+const JAVASCRIPT_SCHEMA_CODEC_VERSION = 'pulse.javascript-schema-codec.v2';
+const NATIVE_SCHEMA_CODEC_VERSION = 'pulse.native-json-as-schema-codec.v2';
 
 function stableObject(value) {
   if (Array.isArray(value)) return value.map(stableObject);
@@ -225,6 +225,7 @@ function renderCanonicalSchemaCodecDeclaration(registryInput, options = {}) {
   lines.push("    if (!value || typeof value !== 'object' || Array.isArray(value)) throw __pulse_schema_failure(mode, undefined, schemaId, path, 'object', __pulse_schema_kind(value), source);");
   lines.push('    const output = {};');
   lines.push('    for (const field of node.fields) {');
+  lines.push("      if (!field.required && !Object.prototype.hasOwnProperty.call(value, field.name)) continue;");
   lines.push('      const fieldPath = __pulse_schema_pointer(path, field.name);');
   lines.push('      const fieldValue = __pulse_schema_data_value(value, field.name, mode, schemaId, fieldPath, source);');
   lines.push('      Object.defineProperty(output, field.name, { enumerable: true, configurable: false, writable: false, value: __pulse_schema_apply_node(field.value, fieldValue, mode, schemaId, fieldPath, source) });');

package/src/compiler/schema-registry.js

@@ -330,7 +330,7 @@ function classifyType(graph, record, typeNode, state) {
   if (typeNode.kind === ts.SyntaxKind.BooleanKeyword) return Object.freeze({ kind: 'boolean' });
   if (typeNode.kind === ts.SyntaxKind.NumberKeyword) return Object.freeze({ kind: 'f64' });
   if (typeNode.kind === ts.SyntaxKind.UndefinedKeyword || typeNode.kind === ts.SyntaxKind.VoidKeyword) {
-    fail('PULSE_SCHEMA_OPTIONAL_FIELD_RESERVED', 'undefined and optional schema fields are reserved beyond IR v1.', typeNode, record);
+    fail('PULSE_SCHEMA_OPTIONAL_FIELD_RESERVED', 'Explicit undefined schema types are reserved; use a question-mark property for absence.', typeNode, record);
   }
   if (ts.isArrayTypeNode(typeNode)) {
     return Object.freeze({ kind: 'array', element: classifyType(graph, record, typeNode.elementType, state) });
@@ -420,15 +420,7 @@ function classifyMembers(graph, record, members, state) {
     if (!ts.isPropertySignature(member)) {
       fail(
         'PULSE_SCHEMA_OBJECT_MEMBER_UNSUPPORTED',
-        'Schema object types allow required property signatures only.',
-        member,
-        record
-      );
-    }
-    if (member.questionToken) {
-      fail(
-        'PULSE_SCHEMA_OPTIONAL_FIELD_RESERVED',
-        'Optional schema fields are reserved until absence-preserving encode semantics are defined.',
+        'Schema object types allow property signatures only.',
         member,
         record
       );
@@ -444,7 +436,7 @@ function classifyMembers(graph, record, members, state) {
     names.add(name);
     fields.push(Object.freeze({
       name,
-      required: true,
+      required: !member.questionToken,
       value: classifyType(graph, record, member.type, { ...state, node: member }),
       source: sourceLocation(record, member.name)
     }));
@@ -621,7 +613,7 @@ function schemaRegistryLegacyBridge(registry) {
   const deferred = [];
   for (const schema of registry.schemas) {
     const fieldPairs = schema.root.fields.map((field) => [field.name, legacyFieldType(field.value)]);
-    if (schema.typeName.startsWith('Inline_') || fieldPairs.some(([, type]) => type === null)) {
+    if (schema.typeName.startsWith('Inline_') || schema.root.fields.some(field => !field.required) || fieldPairs.some(([, type]) => type === null)) {
       deferred.push(schema.id);
       continue;
     }