@hyperframes/producer 0.8.231 → 0.9.0

package/dist/index.d.ts

@@ -27,4 +27,4 @@ export { FONT_FETCH_FAILED, FONT_FETCH_UNAVAILABLE, FontFetchError, FontFetchUna
 export { quantizeTimeToFrame } from "./utils/parityContract.js";
 export { resolveRenderPaths, type RenderPaths } from "./utils/paths.js";
 export { prepareHyperframeLintBody, runHyperframeLint, type PreparedHyperframeLintInput, } from "./services/hyperframeLint.js";
-export { assemble, assembleV2, CURRENT_PLAN_PROTOCOL, DISTRIBUTED_RENDER_CAPABILITIES, getDistributedRenderCapabilities, PLAN_ARTIFACT_LAYOUT, PLAN_HASH_SCHEMA, PLAN_PROTOCOL_V1, PLAN_PROTOCOL_V2, PLAN_PROTOCOL_UNSUPPORTED, PLAN_SCHEMA_VERSION, PLAN_V2_ARTIFACT_LAYOUT, PLAN_V2_HASH_SCHEMA, PLAN_V2_INTEGRITY_UNRECOVERABLE, PLAN_V2_MATERIALIZATION_MARKER, PLAN_V2_SCHEMA_VERSION, createPlanV2FromExecutionPlan, createPlanV2FromV1, getPlanV2ExecutionPlanHash, listPlanV2ArtifactsForTarget, materializePlanV2Target, plan, planV2, planV2WithPublisher, PlanV2IntegrityError, PlanProtocolUnsupportedError, readPlanProtocol, readPlanProtocolV1, readPlanV2Manifest, publishPlanV2FromExecutionPlan, publishPlanV2FromV1, renderChunk, renderChunkV2, validatePlanV2MaterializedTarget, type AssembleResult, type ChunkRenderer, type ChunkResult, type EffectiveChunkResult, type DistributedRenderCapabilities, type DistributedRenderConfig, type PlanProtocolConsumerCapabilities, type PlanProtocolDescriptor, type PlanProtocolV1Descriptor, type PlanProtocolV2Descriptor, type PlanResult, type PlanV2Artifact, type PlanV2Limitations, type PlanV2Manifest, type PlanV2MaterializationResult, type PlanV2MaterializationTarget, type PlanV2Result, type PlanV2WithPublisherOptions, type PlanV2ArtifactPublisher, type PlanV2PublishBlob, type SupportedPlanProtocolDescriptor, } from "./distributed.js";
+export { assemble, assembleV2, PLAN_PROTOCOL_V2, PLAN_PROTOCOL_UNSUPPORTED, PLAN_V2_ARTIFACT_LAYOUT, PLAN_V2_HASH_SCHEMA, PLAN_V2_INTEGRITY_UNRECOVERABLE, PLAN_V2_MATERIALIZATION_MARKER, PLAN_V2_SCHEMA_VERSION, createPlanV2FromExecutionPlan, getPlanV2ExecutionPlanHash, listPlanV2ArtifactsForTarget, materializePlanV2Target, planV2, planV2WithPublisher, PlanV2IntegrityError, PlanProtocolUnsupportedError, readPlanV2Manifest, publishPlanV2FromExecutionPlan, renderChunk, renderChunkV2, validatePlanV2MaterializedTarget, type AssembleResult, type ChunkRenderer, type ChunkResult, type EffectiveChunkResult, type DistributedRenderConfig, type PlanProtocolDescriptor, type PlanProtocolV2Descriptor, type PlanV2Artifact, type PlanV2Limitations, type PlanV2Manifest, type PlanV2MaterializationResult, type PlanV2MaterializationTarget, type PlanV2Result, type PlanV2WithPublisherOptions, type PlanV2ArtifactPublisher, type PlanV2PublishBlob, } from "./distributed.js";

package/dist/index.js

@@ -16412,7 +16412,6 @@ var PLAN_PROTOCOL_V1 = Object.freeze({
   artifactLayout: PLAN_ARTIFACT_LAYOUT,
   hashSchema: PLAN_HASH_SCHEMA
 });
-var CURRENT_PLAN_PROTOCOL = PLAN_PROTOCOL_V1;
 var PLAN_PROTOCOL_V2 = Object.freeze({
   schemaVersion: PLAN_V2_SCHEMA_VERSION,
   artifactLayout: PLAN_V2_ARTIFACT_LAYOUT,
@@ -16434,9 +16433,6 @@ var DISTRIBUTED_RENDER_CAPABILITIES = Object.freeze({
   }),
   chunkFrameRange: true
 });
-function getDistributedRenderCapabilities() {
-  return DISTRIBUTED_RENDER_CAPABILITIES;
-}
 var PlanProtocolUnsupportedError = class extends Error {
   // Public adapters inspect this typed code even though OSS producer does not.
   // fallow-ignore-next-line unused-class-member
@@ -18522,9 +18518,6 @@ function createPlanV2FromExecutionPlan(executionPlanDir, planV2Dir) {
     throw error;
   }
 }
-function createPlanV2FromV1(executionPlanDir, planV2Dir) {
-  return createPlanV2FromExecutionPlan(executionPlanDir, planV2Dir);
-}
 async function publishPlanV2FromExecutionPlan(executionPlanDir, publisher) {
   return publishExecutionPlan(executionPlanDir, publisher, {});
 }
@@ -18554,9 +18547,6 @@ async function publishExecutionPlan(executionPlanDir, publisher, { digests, log
     throw error;
   }
 }
-async function publishPlanV2FromV1(executionPlanDir, publisher) {
-  return publishPlanV2FromExecutionPlan(executionPlanDir, publisher);
-}
 async function planV2WithPublisher(projectDir, config, publisher, options = {}) {
   const stagingRoot = mkdtempSync6(join39(options.stagingParentDir ?? tmpdir3(), ".execution-plan-"));
   const digests = /* @__PURE__ */ new Map();
@@ -21472,19 +21462,13 @@ var AUDIO_SIDECAR_MIN_BYTES = 32 * 1024 * 1024;
 // src/services/distributed/probeFacts.ts
 import { buildProbeFactsText } from "@hyperframes/engine";
 export {
-  CURRENT_PLAN_PROTOCOL,
   DEFAULT_CONFIG2 as DEFAULT_CONFIG,
-  DISTRIBUTED_RENDER_CAPABILITIES,
   FONT_FETCH_FAILED,
   FONT_FETCH_UNAVAILABLE,
   FontFetchError,
   FontFetchUnavailableError,
-  PLAN_ARTIFACT_LAYOUT,
-  PLAN_HASH_SCHEMA,
   PLAN_PROTOCOL_UNSUPPORTED,
-  PLAN_PROTOCOL_V1,
   PLAN_PROTOCOL_V2,
-  PLAN_SCHEMA_VERSION,
   PLAN_V2_ARTIFACT_LAYOUT,
   PLAN_V2_HASH_SCHEMA,
   PLAN_V2_INTEGRITY_UNRECOVERABLE,
@@ -21509,7 +21493,6 @@ export {
   createFileServer,
   createOwnedRenderDir,
   createPlanV2FromExecutionPlan,
-  createPlanV2FromV1,
   createProducerApp,
   createRenderHandlers,
   createRenderJob,
@@ -21521,7 +21504,6 @@ export {
   extractSafeRenderErrorCode,
   getCapturePerfSummary4 as getCapturePerfSummary,
   getCompositionDuration2 as getCompositionDuration,
-  getDistributedRenderCapabilities,
   getPlanV2ExecutionPlanHash,
   initializeSession11 as initializeSession,
   injectDeterministicFontFaces2 as injectDeterministicFontFaces,
@@ -21535,7 +21517,6 @@ export {
   mediaProfileMatchesElementType,
   normalizeErrorMessage,
   parseRenderRequest,
-  plan,
   planV2,
   planV2WithPublisher,
   prepareAnimatedGifInputs,
@@ -21543,10 +21524,7 @@ export {
   prepareHeifImageInputs,
   prepareHyperframeLintBody,
   publishPlanV2FromExecutionPlan,
-  publishPlanV2FromV1,
   quantizeTimeToFrame,
-  readPlanProtocol,
-  readPlanProtocolV1,
   readPlanV2Manifest,
   renderChunk,
   renderChunkV2,

package/dist/regression-harness-distributed.d.ts

@@ -72,7 +72,7 @@ export type DistributedSupportResult = {
  *     `{ num: 30000, den: 1001 }` (NTSC) trip the type system at the call
  *     site. We surface this gate in code rather than only in TS so the
  *     harness can skip the fixture cleanly instead of throwing.
- *   - hdr must not be `true`. Distributed mode is SDR-only at v1.
+ *   - hdr must not be `true`. Distributed mode is SDR-only.
  *
  * Callers that want the structured reason can read it off the returned
  * `reason` field; the message is intended to be log-friendly.

package/dist/regression-harness-lambda-local-types.d.ts

@@ -12,8 +12,6 @@ import type { DistributedFps } from "@hyperframes/core";
 import type { DistributedFormat } from "./services/distributed/shared.js";
 /** Inputs for {@link runLambdaLocalRender}. Same contract as `runDistributedSimulatedRender`. */
 export interface RunLambdaLocalInput {
-    /** Explicit plan transport. Omitted only for legacy regression callers, where it defaults to v1. */
-    protocol?: "v1" | "v2";
     projectDir: string;
     tempRoot: string;
     renderedOutputPath: string;
@@ -33,12 +31,10 @@ export interface RunLambdaLocalInput {
     codec?: "h264" | "h265";
     chunkSize?: number;
     maxParallelChunks?: number;
-    /** Test-only low cap for exercising typed v1 PLAN_TOO_LARGE behavior. */
-    planDirSizeLimitBytes?: number;
     variables?: Record<string, unknown>;
 }
 export interface LambdaLocalRenderResult {
-    protocol: "v1" | "v2";
+    protocol: "v2";
     outputPath: string;
     chunks: Array<{
         index: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.231",
+  "version": "0.9.0",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
-    "@hyperframes/core": "0.8.231",
-    "@hyperframes/engine": "0.8.231",
-    "@hyperframes/lint": "0.8.231",
-    "@hyperframes/studio-server": "0.8.231",
-    "@hyperframes/parsers": "0.8.231"
+    "@hyperframes/core": "0.9.0",
+    "@hyperframes/parsers": "0.9.0",
+    "@hyperframes/engine": "0.9.0",
+    "@hyperframes/studio-server": "0.9.0",
+    "@hyperframes/lint": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.8.231"
+    "@hyperframes/aws-lambda": "0.9.0"
   },
   "engines": {
     "node": ">=22"
@@ -58,7 +58,6 @@
     "build:hf-early-stub": "bun run scripts/build-hf-early-stub.ts",
     "typecheck": "tsc --noEmit",
     "parity:check": "tsx src/parity-harness.ts",
-    "parity:plans": "tsx src/plan-parity-harness.ts",
     "parity:fixtures": "tsx src/parity-fixtures.ts",
     "parity:fixtures:ci": "tsx src/parity-fixtures.ts",
     "parity:check:ci": "tsx src/parity-harness.ts --preview-url \"http://127.0.0.1:4173/minimal-wysiwyg.html\" --producer-url \"http://127.0.0.1:4173/minimal-wysiwyg.html?mode=producer\" --checkpoints \"0,0.5,1,1.5\" --allow-mismatch-ratio 0 --emulate-producer-swap true --artifacts-dir \".debug/parity-harness-ci\"",

package/dist/plan-parity-analysis.d.ts

@@ -1,4 +0,0 @@
-import type { PlanParityDriverResult, PlanParityMeasurement, PlanParityStreamMetadata } from "./plan-parity-contract.js";
-export declare function parseCanonicalFrameHashes(framemd5: string): string[];
-export declare function normalizeFfprobeMetadata(value: unknown): PlanParityStreamMetadata;
-export declare function analyzePlanParityDriverResult(driverName: string, result: PlanParityDriverResult): Promise<PlanParityMeasurement>;

package/dist/plan-parity-contract.d.ts

@@ -1,139 +0,0 @@
-/**
- * Protocol-neutral contract for comparing distributed render plans.
- *
- * The comparator intentionally has no `planHash` field. v1 and v2 use
- * different artifact layouts and hash schemas, so their plan hashes are not
- * expected to match even when they render identical output.
- */
-import type { DistributedFps } from "@hyperframes/core";
-export type PlanParityProtocol = "v1" | "v2";
-export interface PlanParityRenderConfig {
-    fps: DistributedFps;
-    width: number;
-    height: number;
-    format: "mp4";
-    chunkSize?: number;
-    maxParallelChunks?: number;
-}
-export interface PlanParityDriverInput {
-    protocol: PlanParityProtocol;
-    projectDir: string;
-    outputDir: string;
-    renderConfig: PlanParityRenderConfig;
-    /**
-     * Test-only plan limit. The Lambda-local driver forwards this to v1 as
-     * `planDirSizeLimitBytes`; v2 ignores it because it does not materialize a
-     * monolithic plan directory.
-     */
-    planSizeCapBytes?: number;
-}
-export interface PlanParityChunkArtifact {
-    index: number;
-    path: string;
-    /** Adapter-reported digest, retained for diagnostics. */
-    reportedSha256?: string;
-}
-export interface PlanParityDriverResult {
-    protocol: PlanParityProtocol;
-    outputPath: string;
-    chunks: PlanParityChunkArtifact[];
-    transferBytes: {
-        downloaded: number;
-        uploaded: number;
-    };
-    /**
-     * Maximum materialized bytes observed in the worker scratch directory.
-     * This is distinct from S3 storage and from process RSS.
-     */
-    peakMaterializedBytes: number;
-}
-export interface PlanParityDriver {
-    readonly name: string;
-    render(input: PlanParityDriverInput): Promise<PlanParityDriverResult>;
-}
-export interface PlanParityStreamMetadata {
-    video: {
-        codecName: string | null;
-        width: number;
-        height: number;
-        pixelFormat: string | null;
-        averageFrameRate: string | null;
-        realFrameRate: string | null;
-        frameCount: number | null;
-        colorSpace: string | null;
-        colorTransfer: string | null;
-        colorPrimaries: string | null;
-    } | null;
-    audio: {
-        codecName: string | null;
-        sampleRate: number | null;
-        channels: number | null;
-        channelLayout: string | null;
-    } | null;
-    durationSeconds: number;
-}
-export interface PlanParityMediaMeasurement {
-    outputSha256: string;
-    outputBytes: number;
-    frameSha256: string[];
-    pcmAudio: {
-        sha256: string;
-        /**
-         * Interleaved audio frames after canonical decoding to signed 16-bit,
-         * 48 kHz, stereo PCM. One sample frame contains two channel samples.
-         */
-        sampleCount: number;
-        bytes: number;
-    } | null;
-    metadata: PlanParityStreamMetadata;
-}
-export interface PlanParityChunkMeasurement {
-    index: number;
-    sha256: string;
-    bytes: number;
-    reportedSha256?: string;
-}
-export interface PlanParityMeasurement {
-    protocol: PlanParityProtocol;
-    driver: string;
-    media: PlanParityMediaMeasurement;
-    chunks: PlanParityChunkMeasurement[];
-    transferBytes: {
-        downloaded: number;
-        uploaded: number;
-        total: number;
-    };
-    peakMaterializedBytes: number;
-}
-export interface PlanParityComparisonOptions {
-    /** ffprobe duration tolerance. Defaults to 1 ms. */
-    durationToleranceSeconds?: number;
-    /**
-     * Encoded containers can contain non-semantic metadata. Default false:
-     * report output digest/size without requiring byte-identical containers.
-     */
-    requireEncodedOutputEquality?: boolean;
-    /** Optional ceiling applied independently to the v2 run. */
-    maxV2TransferBytes?: number;
-    /** Optional ceiling applied independently to the v2 run. */
-    maxV2PeakMaterializedBytes?: number;
-}
-export interface PlanParityCheck {
-    name: string;
-    passed: boolean;
-    detail: string;
-}
-export interface PlanParityComparison {
-    passed: boolean;
-    checks: PlanParityCheck[];
-    v1: PlanParityMeasurement;
-    v2: PlanParityMeasurement;
-}
-/**
- * Compare semantic render output plus transport/resource measurements.
- *
- * `outputBytes`, transfer bytes, and working-set bytes are always surfaced.
- * They are not equality gates by default: v2 is expected to change artifact
- * packaging, and encoded containers may carry non-semantic differences.
- */
-export declare function comparePlanParityMeasurements(v1: PlanParityMeasurement, v2: PlanParityMeasurement, options?: PlanParityComparisonOptions): PlanParityComparison;

package/dist/plan-parity-fixture.d.ts

@@ -1,18 +0,0 @@
-interface GeneratedAudioConfig {
-    path: string;
-    durationSeconds: number;
-    frequencyHz: number;
-    sampleRate: number;
-}
-/** Generate a deterministic mono PCM WAV without relying on ffmpeg. */
-export declare function generateToneWav(config: Omit<GeneratedAudioConfig, "path">): Buffer;
-/** Deterministic xorshift bytes that do not collapse into a tiny gzip. */
-export declare function generatePressureBytes(bytes: number, seed: number): Buffer;
-/**
- * Copy a checked-in fixture into a driver-owned project directory and
- * materialize its generated binary assets. Source fixtures stay small and
- * reviewable; size-pressure tests can vary their v1 cap without allocating
- * multi-gigabyte files.
- */
-export declare function preparePlanParityFixture(sourceDir: string, projectDir: string): void;
-export {};

package/dist/plan-parity-harness.d.ts

@@ -1,82 +0,0 @@
-import { type PlanParityComparison, type PlanParityComparisonOptions, type PlanParityDriver, type PlanParityDriverResult, type PlanParityMeasurement, type PlanParityRenderConfig } from "./plan-parity-contract.js";
-export type PlanParityTarget = "lambda-local" | `aws:${string}`;
-export interface RunPlanProtocolParityOptions {
-    fixtureDir: string;
-    artifactsDir: string;
-    v1Driver: PlanParityDriver;
-    v2Driver: PlanParityDriver;
-    renderConfig: PlanParityRenderConfig;
-    v1PlanSizeCapBytes?: number;
-    comparison?: PlanParityComparisonOptions;
-}
-export interface PlanParityCliOptions {
-    fixtureDir: string;
-    artifactsDir: string;
-    v1Target: PlanParityTarget;
-    v2Target: PlanParityTarget;
-    renderConfig: PlanParityRenderConfig;
-    v1PlanSizeCapBytes?: number;
-    expectV1PlanTooLarge: boolean;
-    comparison: PlanParityComparisonOptions;
-}
-export interface RunPlanV2SizePressureOptions {
-    fixtureDir: string;
-    artifactsDir: string;
-    driver: PlanParityDriver;
-    renderConfig: PlanParityRenderConfig;
-    v1PlanSizeCapBytes: number;
-    /**
-     * Test seam for the post-render media analyzer. Production callers use
-     * the canonical ffmpeg/ffprobe analyzer.
-     */
-    analyzeDriverResult?: (driverName: string, result: PlanParityDriverResult) => Promise<PlanParityMeasurement>;
-}
-export type PlanTooLargeProbeOutcome = {
-    status: "expected-failure";
-    code: "PLAN_TOO_LARGE";
-    message: string;
-    sizeBytes: number | null;
-    limitBytes: number | null;
-} | {
-    status: "unexpected-success";
-    message: string;
-} | {
-    status: "unexpected-failure";
-    code: string | null;
-    message: string;
-};
-export type PlanV2PressureOutcome = {
-    status: "success";
-    measurement: PlanParityMeasurement;
-} | {
-    status: "failure";
-    message: string;
-};
-export interface PlanV2SizePressureReport {
-    passed: boolean;
-    checks: Array<{
-        name: "v1-plan-too-large" | "v2-render-success";
-        passed: boolean;
-        detail: string;
-    }>;
-    v1: PlanTooLargeProbeOutcome;
-    v2: PlanV2PressureOutcome;
-}
-export declare function parsePlanParityArgs(argv: string[]): PlanParityCliOptions;
-export declare function classifyPlanTooLargeProbeFailure(error: unknown): PlanTooLargeProbeOutcome;
-/**
- * Prove the migration boundary directly:
- *
- * 1. explicit v1 with a deliberately low cap must fail PLAN_TOO_LARGE;
- * 2. explicit v2 must still run to completion for the same prepared fixture.
- *
- * Unlike semantic parity mode, this API does not compare v1/v2 output because
- * the expected v1 run never produces output. Its durable report records both
- * the typed failure and the fully analyzed v2 success.
- */
-export declare function runPlanV2SizePressure(options: RunPlanV2SizePressureOptions): Promise<PlanV2SizePressureReport>;
-/**
- * Run the same prepared project through explicit v1 and v2 drivers, analyze
- * their artifacts, and persist a machine-readable comparison report.
- */
-export declare function runPlanProtocolParity(options: RunPlanProtocolParityOptions): Promise<PlanParityComparison>;