@pulse-compute/wasm-compiler 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -6,10 +6,11 @@
 > **Install directly:** No for application projects; use the pulse CLI.<br>
 > **Supported entry points:** `None for application authors.`<br>
 > **Stability:** Internal compiler interface; no application-author compatibility guarantee.<br>
+> **npm:** [`@pulse-compute/wasm-compiler`](https://www.npmjs.com/package/@pulse-compute/wasm-compiler)<br>
 > **Canonical replacement:** `@pulse-compute/cli`<br>
-> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.1/packages/implementation-packages/)
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.2/packages/implementation-packages/)
 >
-> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.1` package policy.
+> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.2` package policy.
 <!-- pulse-package-status:end -->
 
 Whole-project compiler implementation used by the `pulse` workflow. Application projects should use `@pulse-compute/cli`, not import this package directly.
@@ -51,4 +52,4 @@ The package exports its root implementation plus focused compiler, CLI, extracto
 
 Compiler changes should be covered by focused static/lowering tests, canonical project inspection, provider-plan parity, packed-package discovery where relevant, and the release documentation gates.
 
-See the installed [implementation package guide](https://pulsecompute.io/v1.0.0-beta.1/packages/implementation-packages/) and [compilation concepts](https://pulsecompute.io/v1.0.0-beta.1/concepts/compilation-and-lowering/).
+See the installed [implementation package guide](https://pulsecompute.io/v1.0.0-beta.2/packages/implementation-packages/) and [compilation concepts](https://pulsecompute.io/v1.0.0-beta.2/concepts/compilation-and-lowering/).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulse-compute/wasm-compiler",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "license": "Apache-2.0",
   "description": "PulseWasm compiler package inside the Pulse monorepo.",
   "type": "commonjs",
@@ -9,15 +9,15 @@
     "pulsewasm": "./bin/pulsewasm-extract.js"
   },
   "dependencies": {
-    "@pulse-compute/provider-fastly": "1.0.0-beta.1",
-    "@pulse-compute/provider-node": "1.0.0-beta.1",
-    "@pulse-compute/wasm-build-support": "1.0.0-beta.1",
-    "@pulse-compute/wasm-contracts": "1.0.0-beta.1",
-    "@pulse-compute/wasm-guest-link": "1.0.0-beta.1",
-    "@pulse-compute/wasm-host-runtime": "1.0.0-beta.1",
-    "@pulse-compute/wasm-library-kit": "1.0.0-beta.1",
-    "@pulse-compute/wasm-runtime-core-as": "1.0.0-beta.1",
-    "@pulse-compute/wasm-schema-json": "1.0.0-beta.1",
+    "@pulse-compute/provider-fastly": "1.0.0-beta.2",
+    "@pulse-compute/provider-node": "1.0.0-beta.2",
+    "@pulse-compute/wasm-build-support": "1.0.0-beta.2",
+    "@pulse-compute/wasm-contracts": "1.0.0-beta.2",
+    "@pulse-compute/wasm-guest-link": "1.0.0-beta.2",
+    "@pulse-compute/wasm-host-runtime": "1.0.0-beta.2",
+    "@pulse-compute/wasm-library-kit": "1.0.0-beta.2",
+    "@pulse-compute/wasm-runtime-core-as": "1.0.0-beta.2",
+    "@pulse-compute/wasm-schema-json": "1.0.0-beta.2",
     "assemblyscript": "0.28.18",
     "json-as": "1.5.0",
     "typescript": "5.9.3"
@@ -58,7 +58,7 @@
     "url": "git+https://github.com/pulse-compute/pulse.git",
     "directory": "wasm/packages/compiler"
   },
-  "homepage": "https://pulsecompute.io/v1.0.0-beta.1/packages/implementation-packages/",
+  "homepage": "https://pulsecompute.io/v1.0.0-beta.2/packages/implementation-packages/",
   "bugs": {
     "url": "https://github.com/pulse-compute/pulse/issues"
   },

package/src/canonical-api-compiler.js

@@ -52,9 +52,8 @@ function stableSourceName(file, options = {}) {
   return relative && !relative.startsWith('../') ? relative : path.basename(absolute);
 }
 
-function emitCanonicalProgramFromHandlerIr(ir) {
+function emitCanonicalProgramFromHandlerIr(ir, options = {}) {
   const payload = payloadForCanonicalHandlerIr(ir);
-  const emitted = emitCanonicalHandlerGenerator(payload.operationIr);
   const sourceFile = payload.sourceFile;
   const schemaBundle = payload.schemaBundle;
   const explicitParallelCount = ir.continuationSites.filter((site) => site.kind === 'parallel-group').length;
@@ -100,9 +99,23 @@ function emitCanonicalProgramFromHandlerIr(ir) {
     compilerPreludeHash: ir.compilerPreludeHash,
     userAuthoredAsync: ir.invariants.userAuthoredAsync,
     promiseSemantics: ir.invariants.promiseSemantics,
-    asyncify: ir.invariants.asyncify
+    asyncify: ir.invariants.asyncify,
+    ...(options.target === 'javascript' ? { target: 'javascript', promiseSemantics: true } : {})
+  });
+
+  // JavaScript executes the original module graph through its provider. The
+  // normalized IR describes recognized Pulse behavior only; erased awaits and
+  // source-runtime imports must never become an executable generator.
+  if (options.target === 'javascript') return Object.freeze({
+    ok: true,
+    version: CANONICAL_API_COMPILER_VERSION,
+    target: 'javascript',
+    metadata,
+    schemaBundle,
+    diagnostics: Object.freeze([])
   });
 
+  const emitted = emitCanonicalHandlerGenerator(payload.operationIr);
   const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
   const generatorText = printer.printNode(ts.EmitHint.Unspecified, emitted.generator, sourceFile);
   const metadataSource = JSON.stringify(metadata, null, 2);
@@ -171,8 +184,16 @@ const PLAIN_HANDLER_IMPLEMENTATION = Object.freeze({
   emitCanonicalProgram: emitCanonicalProgramFromHandlerIr
 });
 
+const JAVASCRIPT_HANDLER_INSPECTION = Object.freeze({
+  ...PLAIN_HANDLER_IMPLEMENTATION,
+  emitCanonicalProgram: (ir) => emitCanonicalProgramFromHandlerIr(ir, { target: 'javascript' })
+});
+
 function compileCanonicalSource(sourceText, options = {}) {
-  return executeCanonicalSourceSpine(sourceText, options, PLAIN_HANDLER_IMPLEMENTATION);
+  if (options.target !== undefined && !['native', 'javascript'].includes(options.target)) throw new TypeError('target must be native or javascript.');
+  return executeCanonicalSourceSpine(sourceText, options, options.target === 'javascript'
+    ? JAVASCRIPT_HANDLER_INSPECTION
+    : PLAIN_HANDLER_IMPLEMENTATION);
 }
 
 function compileCanonicalFile(file, options = {}) {
@@ -191,6 +212,9 @@ function loadCanonicalModule(compiled, options = {}) {
 }
 
 function writeCanonicalBuild(compiled, outDir, options = {}) {
+  if (!compiled || compiled.ok !== true || typeof compiled.generatedSource !== 'string') {
+    throw new TypeError('writeCanonicalBuild requires an executable canonical compilation; JavaScript projects use provider source packaging.');
+  }
   const target = path.resolve(outDir);
   fs.mkdirSync(target, { recursive: true });
   const handlerFile = path.join(target, options.handlerFile || 'canonical-handler.cjs');

package/src/canonical-native-plan.js

@@ -222,6 +222,7 @@ function resultKindForEffect(site, decoder, continuation, resultMode) {
   if (site.kind === 'config.get' || site.kind === 'secret.get') return 'string-or-undefined';
   if (site.kind === 'kv.get') return 'json-or-undefined';
   if (site.kind === 'kv.put') return 'ack';
+  if (['kv.getVersioned', 'kv.insertIfAbsent', 'kv.compareAndSwap'].includes(site.kind)) return 'json';
   if (site.kind === 'event.emit') return 'ack';
   return 'unknown';
 }
@@ -1309,10 +1310,10 @@ function assertCanonicalNativePlan(plan) {
         fail('plan crypto realization evidence is invalid', { crypto: plan.crypto });
       } else {
         const knownRealizations = new Map(
-          cryptoContract.CRYPTO_REALIZATIONS.map((entry) => [entry.id, entry])
+          cryptoContract.CRYPTO_REALIZATIONS.map((entry) => [`${entry.id}:${entry.algorithm}`, entry])
         );
         for (const entry of plan.crypto.algorithms) {
-          const known = entry && knownRealizations.get(entry.realization);
+          const known = entry && knownRealizations.get(`${entry.realization}:${entry.algorithm}`);
           if (
             !known
             || known.algorithm !== entry.algorithm

package/src/canonical-project-compiler.js

@@ -304,7 +304,7 @@ function planCanonicalProjectCrypto(options, entryFile, recognizedRequirements =
       declaration: metadata.crypto && metadata.crypto.declaration,
       packageRequirements,
       targetDescriptor: options.packageTargetDescriptor,
-      target: options.packageTarget || metadata.target || null,
+      target: options.target || options.packageTarget || metadata.target || null,
       profile,
       profileSelectionSource: selected && typeof selected === 'object'
         ? selected.source
@@ -324,7 +324,7 @@ function planCanonicalProjectCrypto(options, entryFile, recognizedRequirements =
 }
 
 function assertGraphPreflight(graphBuild, entryFile, options = {}) {
-  const nativeEligibilityMode = options.nativeEligibilityMode || 'enforce';
+  const nativeEligibilityMode = options.nativeEligibilityMode || (options.target === 'javascript' ? 'record' : 'enforce');
   if (!['enforce', 'record'].includes(nativeEligibilityMode)) {
     throw new TypeError('nativeEligibilityMode must be enforce or record.');
   }
@@ -957,8 +957,10 @@ function attachPackageSchemaReferences(compiled, recognition) {
   return Object.freeze({
     ...compiled,
     metadata,
-    generatedSource: replaceGeneratedMetadata(compiled.generatedSource, metadata, 'commonjs'),
-    generatedEsmSource: replaceGeneratedMetadata(compiled.generatedEsmSource, metadata, 'esm')
+    ...(compiled.target !== 'javascript' ? {
+      generatedSource: replaceGeneratedMetadata(compiled.generatedSource, metadata, 'commonjs'),
+      generatedEsmSource: replaceGeneratedMetadata(compiled.generatedEsmSource, metadata, 'esm')
+    } : {})
   });
 }
 
@@ -1046,9 +1048,10 @@ function compileCanonicalProjectLegacy(entryFile, options = {}) {
   if (multiModule) {
     try {
       linkedProjectModules = root.kind === 'router'
-        ? linkProjectRouterModules(graphBuild, { rootDir })
+        ? linkProjectRouterModules(graphBuild, { rootDir, target: options.target })
         : linkProjectPlainHandler(graphBuild, {
             rootDir,
+            target: options.target,
             consumedRuntimeImports: managedHandlerRuntimeImportKeys(packageOperationRecognition.managedHandlers)
           });
     } catch (error) {
@@ -1199,6 +1202,9 @@ function compileCanonicalProjectLegacy(entryFile, options = {}) {
 }
 
 function compileCanonicalProject(entryFile, options = {}) {
+  if (options.target !== undefined && !['native', 'javascript'].includes(options.target)) {
+    throw new TypeError('target must be native or javascript.');
+  }
   return executeCanonicalProjectSpine(entryFile, options, compileCanonicalProjectLegacy);
 }
 

package/src/project/router-module-linker.js

@@ -563,7 +563,7 @@ function linkProjectRouterModules(graphBuild, options = {}) {
 
   const rootGlobalName = routerSymbols.get(`${root.module.path}:${root.localName}`);
   const ordered = orderLinkedRouters(routers, rootGlobalName);
-  validateRuntimeProjectImports(context, consumedImports, diagnostics);
+  if (options.target !== 'javascript') validateRuntimeProjectImports(context, consumedImports, diagnostics);
   const combinedIr = Object.freeze({
     source: entryModule.path,
     routerIR: Object.freeze(ordered.routers),
@@ -652,7 +652,7 @@ function linkProjectPlainHandler(graphBuild, options = {}) {
       { resolvedKind: root && root.kind || 'unknown' }
     ));
   }
-  validateRuntimeProjectImports(context, consumedImports, diagnostics);
+  if (options.target !== 'javascript') validateRuntimeProjectImports(context, consumedImports, diagnostics);
   if (diagnostics.some((entry) => entry.severity !== 'warning')) {
     throw new RouterModuleLinkError(`Project plain-handler linking failed with ${diagnostics.length} diagnostic(s).`, diagnostics, { entry: entryModule.path });
   }

package/src/spine/async-surface-normalizer.js

@@ -6,6 +6,7 @@ const {
 } = require('@pulse-compute/wasm-contracts/handler/surface-contract');
 const {
   recognizeHandlerSurface,
+  extractKvNamespaceDeclaration,
   unwrapExpression
 } = require('./handler-surface-authority.js');
 const {
@@ -92,6 +93,7 @@ function normalizeManagedHandler(functionNode, options = {}) {
   const diagnostics = [];
   const warnings = [];
   const changes = [];
+  let kvAliases = new Map();
   const awaitedRoots = new WeakSet();
   const parallelMemberRoots = new WeakSet();
   const userAuthoredAsync = (functionNode.modifiers || []).some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword);
@@ -115,6 +117,7 @@ function normalizeManagedHandler(functionNode, options = {}) {
   function surfaceFor(node, position) {
     return recognizeHandlerSurface(node, {
       ctxName,
+      kvAliases,
       nextName,
       role: options.role,
       strict,
@@ -126,6 +129,15 @@ function normalizeManagedHandler(functionNode, options = {}) {
 
   const transformer = (context) => {
     function visit(node) {
+      if (ts.isBlock(node)) {
+        const inherited = kvAliases; kvAliases = new Map(inherited);
+        try { return ts.visitEachChild(node, visit, context); } finally { kvAliases = inherited; }
+      }
+      if (ts.isVariableStatement(node)) {
+        const namespace = extractKvNamespaceDeclaration(node, ctxName, { unwrap: true });
+        for (const declaration of node.declarationList.declarations) if (ts.isIdentifier(declaration.name)) kvAliases.delete(declaration.name.text);
+        if (namespace) kvAliases.set(namespace.variableName, namespace.store);
+      }
       if (node !== functionNode && ts.isFunctionLike(node)) {
         const nestedAsync = (node.modifiers || []).some((modifier) => modifier.kind === ts.SyntaxKind.AsyncKeyword);
         if (nestedAsync) diagnostics.push(createHandlerDiagnostic({
@@ -142,6 +154,10 @@ function normalizeManagedHandler(functionNode, options = {}) {
         const inner = unwrapExpression(node.expression);
         const surface = surfaceFor(inner, 'await-expression');
         if (!surface || surface.surfaceId === 'javascript.await' || surface.class === 'javascript-only') {
+          // The explicit JavaScript project path uses this normalized tree only
+          // for inspection. Its original async source executes through the
+          // application loader; Native compilation still rejects this boundary.
+          if (options.target === 'javascript') return ts.visitNode(node.expression, visit);
           diagnostics.push(createHandlerDiagnostic({
             frontend,
             issue: 'handler.await.native-unsupported',

package/src/spine/canonical-handler-ir.js

@@ -119,6 +119,7 @@ function packageEffectSummary(packageEffects) {
     capability: effect.capability,
     result: effect.result,
     placement: effect.placement,
+    ...(effect.redaction ? { redaction: effect.redaction } : {}),
     range: effect.range
   })));
 }

package/src/spine/handler-ir-emitter.js

@@ -61,10 +61,11 @@ function providerEffectExpression(factory, sourceFile, site, providerOperation)
   if (site.groupKey !== undefined) properties.push(literalProperty(factory, 'groupKey', stringLiteral(factory, site.groupKey)));
   if (providerOperation.kind === 'config.get' || providerOperation.kind === 'secret.get') {
     properties.push(literalProperty(factory, 'name', providerOperation.name));
-  } else if (providerOperation.kind === 'kv.get' || providerOperation.kind === 'kv.put') {
+  } else if (providerOperation.providerKind === 'kv') {
     properties.push(literalProperty(factory, 'store', providerOperation.store));
     properties.push(literalProperty(factory, 'key', providerOperation.key));
-    if (providerOperation.kind === 'kv.put') properties.push(literalProperty(factory, 'value', providerOperation.value));
+    if (providerOperation.generation) properties.push(literalProperty(factory, 'generation', providerOperation.generation));
+    if (providerOperation.value) properties.push(literalProperty(factory, 'value', providerOperation.value));
   } else if (providerOperation.kind === 'event.emit') {
     properties.push(literalProperty(factory, 'type', providerOperation.type));
     properties.push(literalProperty(factory, 'emission', providerOperation.emission));

package/src/spine/handler-ir-managed.js

@@ -979,6 +979,7 @@ function compileHandler(resolved, graphBuild, allResolved, diagnostics, packageR
       } else if (provider.providerKind === 'kv') {
         add('store', provider.store || provider.resource);
         add('key', provider.key);
+        add('generation', provider.generation);
         add('value', provider.value);
       } else if (provider.providerKind === 'event') {
         add('type', provider.type);

package/src/spine/handler-surface-authority.js

@@ -182,7 +182,7 @@ function extractProviderCall(expression, ctxName, kvAliases = new Map(), options
     }
   }
 
-  if (['get', 'put'].includes(method)) {
+  if (['get', 'put', 'getVersioned', 'insertIfAbsent', 'compareAndSwap'].includes(method)) {
     let store;
     if (receiver && ts.isCallExpression(receiver) && isPropertyAccessNamed(receiver.expression, ctxName, 'kv', options) && receiver.arguments.length === 1) {
       store = receiver.arguments[0];
@@ -190,7 +190,9 @@ function extractProviderCall(expression, ctxName, kvAliases = new Map(), options
       store = kvAliases.get(receiver.text);
     }
     if (store) {
-      const expected = method === 'get' ? 1 : 2;
+      if (['getVersioned', 'insertIfAbsent', 'compareAndSwap'].includes(method)
+        && !ts.isStringLiteral(store) && !ts.isNoSubstitutionTemplateLiteral(store)) return undefined;
+      const expected = method === 'compareAndSwap' ? 3 : ['get', 'getVersioned'].includes(method) ? 1 : 2;
       if (current.arguments.length === expected) {
         return Object.freeze({
           call: current,
@@ -202,7 +204,8 @@ function extractProviderCall(expression, ctxName, kvAliases = new Map(), options
           resource: store,
           store,
           key: current.arguments[0],
-          value: current.arguments[1],
+          value: current.arguments[method === 'compareAndSwap' ? 2 : 1],
+          generation: method === 'compareAndSwap' ? current.arguments[1] : undefined,
           args: Object.freeze([...current.arguments])
         });
       }

package/src/spine/plain-handler-frontend.js

@@ -375,6 +375,13 @@ function analyzeHandler(sourceFile, handler, ctxName, diagnostics, schemaBundleI
 
 function findCanonicalHandler(sourceFile, diagnostics, options = {}) {
   const allowedRuntimeImports = new Set([...ALLOWED_IMPORTS, ...(options.allowedRuntimeImports || []).map(String)]);
+  if (options.target === 'javascript') {
+    // The project graph owns import resolution and containment. These remain
+    // source-runtime imports, never lowerer grants.
+    for (const statement of sourceFile.statements) {
+      if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) allowedRuntimeImports.add(statement.moduleSpecifier.text);
+    }
+  }
   for (const statement of sourceFile.statements) {
     if (!ts.isImportDeclaration(statement)) continue;
     const moduleName = statement.moduleSpecifier && ts.isStringLiteral(statement.moduleSpecifier) ? statement.moduleSpecifier.text : '';
@@ -486,6 +493,7 @@ function preparePlainHandlerSource(sourceText, options = {}, recognition) {
       role: 'handler',
       strict: options.strict === true,
       frontend: 'canonical-source',
+      target: options.target,
       handlerAuthoring: options.handlerAuthoring,
       requireAsync: options.requireAsync === true,
       requireEffectAwait: options.requireEffectAwait === true,

package/src/spine/router-handler-frontend.js

@@ -193,6 +193,7 @@ function normalizeRouterHandler(topology, descriptor, recognition, classificatio
     role,
     strict: Boolean(topology.options && topology.options.strict === true),
     frontend: 'canonical-router',
+    target: topology.options && topology.options.target,
     handlerAuthoring: topology.options && topology.options.handlerAuthoring,
     requireAsync: topology.options && topology.options.requireAsync === true,
     requireEffectAwait: topology.options && topology.options.requireEffectAwait === true,

package/src/spine/router-topology-frontend.js

@@ -19,6 +19,7 @@ const { buildDispatchTable } = require('../dispatch-table.js');
 const { buildExecutionPlan } = require('../execution-plan.js');
 const { buildEventTopology } = require('../events/event-topology.js');
 const { analyzeEventEmitHandlers } = require('../events/event-emit.js');
+const { ROUTER_API_DEFINITIONS } = require('../definitions/router-api.js');
 
 const ROUTER_TOPOLOGY_FRONTEND_VERSION = 'pulse.router-topology-frontend.v1';
 const CANONICAL_ROUTER_COMPILER_VERSION = 'pulse.canonical-router-compiler.v2';
@@ -28,7 +29,9 @@ const ROUTER_IMPORT = '@pulse-compute/runtime';
 const ROUTER_CLASS = 'Router';
 const PULSE_IMPORT = '@pulse-compute/pulse';
 const PULSE_CLASS = 'Pulse';
-const SUPPORTED_ROUTE_METHODS = new Set(['GET', 'HEAD', 'POST']);
+const SUPPORTED_ROUTE_METHODS = new Set(ROUTER_API_DEFINITIONS
+  .filter((definition) => definition.kind === 'route')
+  .map((definition) => definition.method));
 const DISALLOWED_OPERATION_KINDS = new Map([
   ['lifecycle', 'realtime lifecycle handlers'],
   ['channel', 'realtime channel registration'],