mustardscript 0.1.0 → 0.1.2

package/index.d.ts

@@ -2,22 +2,70 @@
 /* eslint-disable */
 export declare function cancelCancellationToken(tokenId: string): void
 
-export declare function claimProgressSnapshot(snapshotIdentity: string): boolean
-
-export declare function compileProgram(source: string): Buffer
+export declare function compileProgram(source: string): string
 
 export declare function createCancellationToken(): string
 
+export declare function createExecutionContext(policyJson: string): string
+
+export declare function dumpProgram(programHandle: string): Buffer
+
+export declare function dumpSnapshotHandle(snapshotHandle: string): Buffer
+
+export declare function inspectDetachedSnapshot(programHandle: string, snapshot: Buffer, policyJson: string): string
+
 export declare function inspectSnapshot(snapshot: Buffer, policyJson: string): string
 
-export declare function isProgressSnapshotUsed(snapshotIdentity: string): boolean
+export declare function inspectSnapshotHandle(snapshotHandle: string): string
+
+export declare function loadDetachedSnapshotHandle(programHandle: string, snapshot: Buffer, policyJson: string): string
+
+export declare function loadDetachedSnapshotHandleWithExecutionContext(programHandle: string, contextHandle: string, snapshot: Buffer, snapshotId: string, snapshotKeyBase64: string, snapshotKeyDigest: string, snapshotToken: string): string
+
+export declare function loadProgram(program: Buffer): string
+
+export declare function loadSnapshotHandle(snapshot: Buffer, policyJson: string): string
+
+export declare function loadSnapshotHandleWithExecutionContext(contextHandle: string, snapshot: Buffer, snapshotId: string, snapshotKeyBase64: string, snapshotKeyDigest: string, snapshotToken: string): string
+
+export declare function profileResumeSnapshotHandle(snapshotHandle: string, payloadJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function profileResumeSnapshotHandleBuffer(snapshotHandle: string, payloadBuffer: Buffer, cancellationTokenId?: string | undefined | null): string
+
+export declare function profileStartProgramWithExecutionContextHandle(programHandle: string, contextHandle: string, inputsJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function profileStartProgramWithExecutionContextHandleBuffer(programHandle: string, contextHandle: string, inputsBuffer: Buffer, cancellationTokenId?: string | undefined | null): string
+
+export declare function profileStartProgramWithSnapshotHandle(programHandle: string, optionsJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function profileStartProgramWithSnapshotHandleBuffer(programHandle: string, optionsBuffer: Buffer, cancellationTokenId?: string | undefined | null): string
 
 export declare function releaseCancellationToken(tokenId: string): void
 
-export declare function releaseProgressSnapshot(snapshotIdentity: string): void
+export declare function releaseExecutionContext(contextHandle: string): void
+
+export declare function releaseProgram(programHandle: string): void
+
+export declare function releaseSnapshotHandle(snapshotHandle: string): void
+
+export declare function resumeDetachedProgram(programHandle: string, snapshot: Buffer, payloadJson: string, policyJson: string, cancellationTokenId?: string | undefined | null): string
 
 export declare function resumeProgram(snapshot: Buffer, payloadJson: string, policyJson: string, cancellationTokenId?: string | undefined | null): string
 
+export declare function resumeSnapshotHandle(snapshotHandle: string, payloadJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function resumeSnapshotHandleBuffer(snapshotHandle: string, payloadBuffer: Buffer, cancellationTokenId?: string | undefined | null): string
+
+export declare function retainProgram(programHandle: string): string
+
 export declare function snapshotIdentity(snapshot: Buffer): string
 
-export declare function startProgram(program: Buffer, optionsJson: string, cancellationTokenId?: string | undefined | null): string
+export declare function startProgram(programHandle: string, optionsJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function startProgramWithExecutionContextHandle(programHandle: string, contextHandle: string, inputsJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function startProgramWithExecutionContextHandleBuffer(programHandle: string, contextHandle: string, inputsBuffer: Buffer, cancellationTokenId?: string | undefined | null): string
+
+export declare function startProgramWithSnapshotHandle(programHandle: string, optionsJson: string, cancellationTokenId?: string | undefined | null): string
+
+export declare function startProgramWithSnapshotHandleBuffer(programHandle: string, optionsBuffer: Buffer, cancellationTokenId?: string | undefined | null): string

package/mustard.d.ts

@@ -28,8 +28,16 @@ export interface CompileOptions {
 
 export type SnapshotKey = string | Buffer | Uint8Array;
 
+export interface ExecutionContextOptions {
+  capabilities?: Record<string, Capability>;
+  console?: ConsoleCallbacks;
+  limits?: RuntimeLimits;
+  snapshotKey?: SnapshotKey;
+}
+
 export interface ExecutionOptions {
   inputs?: Record<string, StructuredValue>;
+  context?: ExecutionContext;
   capabilities?: Record<string, Capability>;
   console?: ConsoleCallbacks;
   limits?: RuntimeLimits;
@@ -46,7 +54,7 @@ export interface ProgressLoadOptionsBase {
   snapshotKey: SnapshotKey;
 }
 
-export type ProgressLoadOptions =
+export type ProgressLoadOptionsExplicit =
   | (ProgressLoadOptionsBase & {
       capabilities: Record<string, Capability>;
       console?: ConsoleCallbacks;
@@ -56,6 +64,12 @@ export type ProgressLoadOptions =
       console: ConsoleCallbacks;
     });
 
+export interface ProgressLoadContextOptions {
+  context: ExecutionContext;
+}
+
+export type ProgressLoadOptions = ProgressLoadOptionsExplicit | ProgressLoadContextOptions;
+
 export interface RuntimeLimits {
   instructionBudget?: number;
   heapLimitBytes?: number;
@@ -159,6 +173,10 @@ export interface SerializedProgress {
   snapshot_id: string;
   snapshot_key_digest: string;
   token: string;
+  program?: Buffer;
+  program_id?: string;
+  suspended_manifest?: string;
+  suspended_manifest_token?: string;
 }
 
 export class Progress {
@@ -174,6 +192,10 @@ export class Progress {
   static load(state: SerializedProgress, options: ProgressLoadOptions): Progress;
 }
 
+export class ExecutionContext {
+  constructor(options?: ExecutionContextOptions);
+}
+
 export class Mustard {
   constructor(code: string, options?: CompileOptions);
 

package/package.json

@@ -1,26 +1,16 @@
 {
   "name": "mustardscript",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Sandboxed, subset JavaScript runtime for Node services.",
   "main": "dist/index.js",
   "types": "mustard.d.ts",
   "files": [
-    "Cargo.lock",
-    "Cargo.toml",
     "LICENSE",
     "SECURITY.md",
+    "README.md",
     "dist",
     "index.d.ts",
-    "mustard.d.ts",
-    "crates/mustard/Cargo.toml",
-    "crates/mustard/src/**",
-    "crates/mustard-bridge/Cargo.toml",
-    "crates/mustard-bridge/src/**",
-    "crates/mustard-node/Cargo.toml",
-    "crates/mustard-node/build.rs",
-    "crates/mustard-node/src/**",
-    "crates/mustard-sidecar/Cargo.toml",
-    "crates/mustard-sidecar/src/**"
+    "mustard.d.ts"
   ],
   "directories": {
     "doc": "docs",
@@ -38,13 +28,12 @@
     ]
   },
   "optionalDependencies": {
-    "mustardscript-darwin-arm64": "0.1.0",
-    "mustardscript-darwin-x64": "0.1.0",
-    "mustardscript-linux-x64-gnu": "0.1.0",
-    "mustardscript-win32-x64-msvc": "0.1.0"
+    "@mustardscript/binding-darwin-arm64": "0.1.2",
+    "@mustardscript/binding-darwin-x64": "0.1.2",
+    "@mustardscript/binding-linux-x64-gnu": "0.1.2",
+    "@mustardscript/binding-win32-x64-msvc": "0.1.2"
   },
   "scripts": {
-    "install": "node -e \"const fs=require('node:fs'); const cp=require('node:child_process'); if (!fs.existsSync('dist/install.js')) { cp.execFileSync(process.execPath, ['scripts/build-ts-dist.ts'], { stdio: 'inherit' }); } cp.execFileSync(process.execPath, ['dist/install.js'], { stdio: 'inherit' });\"",
     "prepack": "node scripts/build-ts-dist.ts",
     "build": "node scripts/build-ts-dist.ts && napi build --platform --manifest-path crates/mustard-node/Cargo.toml --js-package-name mustardscript --output-dir . --no-js",
     "ralph-loop": "node scripts/ralph-loop.ts",
@@ -60,16 +49,35 @@
     "test:hardening": "scripts/run-hardening.sh",
     "test:mutation-guards": "npm run build && node --test tests/hardening/**/*.test.js",
     "seed:fuzz-corpus": "node scripts/seed-fuzz-corpus.ts",
-    "bench:smoke": "npm run build && node --expose-gc benchmarks/smoke.ts",
-    "prebuilt:dirs": "napi create-npm-dirs",
+    "bench:smoke": "npm run bench:smoke:dev",
+    "bench:smoke:dev": "npm run build && node --expose-gc benchmarks/smoke.ts --profile dev",
+    "bench:smoke:release": "node scripts/build-ts-dist.ts && napi build --platform --release --manifest-path crates/mustard-node/Cargo.toml --js-package-name mustardscript --output-dir . --no-js && node --expose-gc benchmarks/smoke.ts --profile release",
+    "prebuilt:dirs": "node scripts/generate-prebuilt-packages.ts",
     "prebuilt:artifacts": "napi artifacts --output-dir artifacts",
+    "bench:rust": "cargo bench -p mustard --bench runtime_core -- --noplot",
+    "bench:regress:workloads": "node scripts/benchmark-compare.ts --kind workloads --profile release --tracked-baseline --include-prefix addon. --max-regression-pct 10",
+    "bench:regress:smoke": "node scripts/benchmark-compare.ts --kind smoke --profile release --tracked-baseline --max-regression-pct 50",
+    "bench:regress:ptc": "npm run bench:regress:ptc:broad && npm run bench:regress:ptc:holdout",
+    "bench:regress:ptc:broad": "node scripts/benchmark-compare.ts --kind ptc_broad_release --profile release --tracked-baseline --include-prefix addon.ptc.phase2.scorecards.headlineScore.medium --include-prefix addon.ptc.phase2.scorecards.broadScore.medium --include-prefix addon.ptc.phase2.scorecards.p90LaneRatio.medium --include-prefix addon.ptc.phase2.scorecards.worstLaneRatio.medium --require-path addon.ptc.phase2.scorecards.headlineScore.medium --require-path addon.ptc.phase2.scorecards.broadScore.medium --require-path addon.ptc.phase2.scorecards.p90LaneRatio.medium --require-path addon.ptc.phase2.scorecards.worstLaneRatio.medium --max-regression-pct 10",
+    "bench:regress:ptc:holdout": "node scripts/benchmark-compare.ts --kind ptc_holdout_release --profile release --tracked-baseline --include-prefix addon.ptc.phase2.scorecards.holdoutScore.medium --require-path addon.ptc.phase2.scorecards.holdoutScore.medium --max-regression-pct 10",
     "verify:prebuilt": "node scripts/verify-prebuilt.ts",
     "verify:release": "node scripts/release-verify.ts",
-    "lint": "cargo fmt --all --check && cargo clippy --workspace --all-targets -- -D warnings"
+    "lint": "cargo fmt --all --check && cargo clippy --workspace --all-targets -- -D warnings",
+    "bench:workloads": "npm run bench:workloads:release",
+    "bench:workloads:dev": "node scripts/build-ts-dist.ts && napi build --platform --manifest-path crates/mustard-node/Cargo.toml --js-package-name mustardscript --output-dir . --no-js && cargo build -q -p mustard-sidecar && node --expose-gc benchmarks/workloads.ts --profile dev",
+    "bench:workloads:release": "node scripts/build-ts-dist.ts && napi build --platform --release --manifest-path crates/mustard-node/Cargo.toml --js-package-name mustardscript --output-dir . --no-js && cargo build -q --release -p mustard-sidecar && node --expose-gc benchmarks/workloads.ts --profile release",
+    "bench:ptc:release": "npm run bench:workloads:release",
+    "bench:ptc:public": "npm run bench:workloads:release -- --mode ptc_public",
+    "bench:ptc:headline": "npm run bench:workloads:release -- --mode ptc_headline_release",
+    "bench:ptc:broad": "npm run bench:workloads:release -- --mode ptc_broad_release",
+    "bench:ptc:holdout": "npm run bench:workloads:release -- --mode ptc_holdout_release",
+    "bench:ptc:gallery-canary": "npm run bench:workloads:release -- --mode ptc_gallery_canary",
+    "bench:ptc:sentinel": "npm run bench:workloads:release -- --mode ptc_sentinel_release",
+    "bench:compare": "node scripts/benchmark-compare.ts"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/keppoai/mustardscript.git"
+    "url": "git+https://github.com/mustardscript/mustardscript.git"
   },
   "keywords": [
     "javascript",
@@ -85,12 +93,13 @@
     "@napi-rs/cli": "^3.3.0",
     "@types/node": "^25.6.0",
     "fast-check": "^4.6.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.2",
+    "isolated-vm": "^6.1.2"
   },
   "bugs": {
-    "url": "https://github.com/keppoai/mustardscript/issues"
+    "url": "https://github.com/mustardscript/mustardscript/issues"
   },
-  "homepage": "https://github.com/keppoai/mustardscript#readme",
+  "homepage": "https://github.com/mustardscript/mustardscript#readme",
   "publishConfig": {
     "access": "public"
   }