@hyperframes/aws-lambda 0.8.166 → 0.8.168

package/dist/events.d.ts

@@ -141,7 +141,7 @@ interface PlanLambdaResultBase {
     PlanHash: string;
     ChunkCount: number;
     TotalFrames: number;
-    Fps: 24 | 30 | 60;
+    Fps: SerializableDistributedRenderConfig["fps"];
     Width: number;
     Height: number;
     Format: DistributedFormat;

package/dist/handler.d.ts

@@ -32,6 +32,11 @@ export interface HandlerDeps {
     tmpRoot?: string;
     /** Skip Chrome resolution (used by handler dispatch tests that mock renderChunk). */
     skipChromeResolution?: boolean;
+    /**
+     * The Lambda runtime's `Context` arrives as this second argument and supplies it. Plan
+     * and chunk share one function, so its remaining time at plan start is the chunk limit.
+     */
+    getRemainingTimeInMillis?: () => number;
 }
 /**
  * Lambda entry. Step Functions sometimes wraps the event in

package/dist/handler.js

@@ -166,14 +166,6 @@ async function uploadContentAddressedFileToS3(client, localPath, uri, expectedSh
   if (!existsSync2(localPath)) {
     throw new Error(`[s3Transport] upload source missing: ${localPath}`);
   }
-  const actualSha256 = await sha256File(localPath);
-  if (actualSha256 !== expectedSha256) {
-    const error = new Error(
-      `[s3Transport] PLAN_ARTIFACT_DIGEST_MISMATCH: local artifact ${localPath} expected ${expectedSha256}, got ${actualSha256}`
-    );
-    error.name = "PLAN_ARTIFACT_DIGEST_MISMATCH";
-    throw error;
-  }
   const { bucket, key } = parseS3Uri(uri);
   const size = statSync(localPath).size;
   const existing = await inspectContentAddressedObject(client, bucket, key, size, expectedSha256);
@@ -330,6 +322,7 @@ var S3PlanV2ArtifactPublisher = class {
   async putBlob(blob) {
     this.#assertOpen("publish a blob");
     const digest = assertSha2562(blob.sha256, "S3 published blob sha256");
+    if (this.#publishedDigests.has(digest)) return;
     const sourceSize = statSync2(blob.sourcePath).size;
     if (sourceSize !== blob.sizeBytes) {
       throw new PlanV2IntegrityError(
@@ -421,7 +414,7 @@ async function handler(event, deps) {
 function normalizeTerminalErrorName(error) {
   if (!error || typeof error !== "object") return;
   const candidate = error;
-  if (candidate.code === "PLAN_PROTOCOL_UNSUPPORTED" || candidate.code === "PLAN_TOO_LARGE" || candidate.code === "PLAN_V2_INTEGRITY_UNRECOVERABLE" || candidate.code === "FONT_FETCH_FAILED" || candidate.code === "FONT_FETCH_UNAVAILABLE" || candidate.code === "NOT_MEDIA_PAYLOAD" || candidate.code === "VIDEO_SOURCE_UNRENDERABLE" || candidate.code === "VIDEO_EXTRACTION_FAILED" || candidate.code === "INVALID_VIDEO_METADATA") {
+  if (candidate.code === "PLAN_PROTOCOL_UNSUPPORTED" || candidate.code === "PLAN_TOO_LARGE" || candidate.code === "PLAN_V2_INTEGRITY_UNRECOVERABLE" || candidate.code === "FONT_FETCH_FAILED" || candidate.code === "FONT_FETCH_UNAVAILABLE" || candidate.code === "NOT_MEDIA_PAYLOAD" || candidate.code === "VIDEO_SOURCE_UNRENDERABLE" || candidate.code === "VIDEO_EXTRACTION_FAILED" || candidate.code === "INVALID_VIDEO_METADATA" || candidate.code === "FORMAT_NOT_SUPPORTED_IN_DISTRIBUTED" || candidate.code === "CHUNK_EXCEEDS_WORKER_TIMEOUT") {
     candidate.name = candidate.code;
   }
 }
@@ -522,11 +515,19 @@ function primeRuntimeEnv() {
     process.env.PATH = `${bin}:${process.env.PATH ?? ""}`;
   }
 }
+function planConfig(event, deps) {
+  const remainingMs = deps?.getRemainingTimeInMillis?.();
+  if (event.Config.workerTimeoutSeconds !== void 0 || remainingMs === void 0) {
+    return { ...event.Config };
+  }
+  return { ...event.Config, workerTimeoutSeconds: Math.ceil(remainingMs / 1e3) };
+}
 async function handlePlan(event, deps) {
   if (event.PlanProtocol !== "v1") {
     return handlePlanV2(event, deps);
   }
   const started = Date.now();
+  const config = planConfig(event, deps);
   const s3 = deps?.s3 ?? getS3Client();
   const primitive = deps?.primitives?.plan ?? plan;
   if (!deps?.skipChromeResolution && !process.env.PRODUCER_HEADLESS_SHELL_PATH) {
@@ -540,9 +541,6 @@ async function handlePlan(event, deps) {
   try {
     await downloadS3ObjectToFile(s3, event.ProjectS3Uri, projectArchive);
     await untarDirectory(projectArchive, projectDir);
-    const config = {
-      ...event.Config
-    };
     const result = await primitive(projectDir, config, planDir);
     const planTar = join2(work, "plan.tar.gz");
     await tarDirectory(planDir, planTar);
@@ -576,6 +574,7 @@ async function handlePlan(event, deps) {
 }
 async function handlePlanV2(event, deps) {
   const started = Date.now();
+  const config = planConfig(event, deps);
   const s3 = deps?.s3 ?? getS3Client();
   const primitive = deps?.primitives?.planV2WithPublisher ?? planV2WithPublisher;
   if (!deps?.skipChromeResolution && !process.env.PRODUCER_HEADLESS_SHELL_PATH) {
@@ -585,14 +584,18 @@ async function handlePlanV2(event, deps) {
   const projectArchive = join2(work, "project.tar.gz");
   const projectDir = join2(work, "project");
   try {
+    let stageStarted = Date.now();
     await downloadS3ObjectToFile(s3, event.ProjectS3Uri, projectArchive);
+    logEvent({ event: "plan_stage", stage: "download", ms: Date.now() - stageStarted });
+    stageStarted = Date.now();
     await untarDirectory(projectArchive, projectDir);
+    logEvent({ event: "plan_stage", stage: "untar", ms: Date.now() - stageStarted });
     const publisher = new S3PlanV2ArtifactPublisher({
       s3,
       planOutputS3Prefix: event.PlanOutputS3Prefix,
       temporaryRoot: work
     });
-    const manifest = await primitive(projectDir, { ...event.Config }, publisher, {
+    const manifest = await primitive(projectDir, config, publisher, {
       stagingParentDir: work
     });
     return {
@@ -761,11 +764,14 @@ async function handleAssembleV2(event, deps) {
   try {
     const planDir = await downloadAndMaterializePlanV2(s3, event, { role: "assembler" }, work);
     const audioPath = resolvePlanAudioPath(planDir);
+    const chunksStarted = Date.now();
     const chunkPaths = await downloadChunkObjects(s3, event.ChunkS3Uris, work, event.Format);
+    const chunksMs = Date.now() - chunksStarted;
     const finalOutput = event.Format === "png-sequence" ? join2(work, "output-frames") : join2(work, `output${formatExtension(event.Format)}`);
     const result = await primitive(planDir, chunkPaths, audioPath, finalOutput, {
       cfr: event.Cfr === true
     });
+    const uploadStarted = Date.now();
     if (event.Format === "png-sequence") {
       const tarball = `${finalOutput}.tar.gz`;
       await tarDirectory(finalOutput, tarball);
@@ -773,6 +779,13 @@ async function handleAssembleV2(event, deps) {
     } else {
       await uploadFileToS3(s3, finalOutput, event.OutputS3Uri);
     }
+    logEvent({
+      event: "assemble_stages",
+      planMs: chunksStarted - started,
+      chunksMs,
+      assembleMs: result.durationMs,
+      uploadMs: Date.now() - uploadStarted
+    });
     return {
       Action: "assemble",
       OutputS3Uri: event.OutputS3Uri,

package/dist/index.js

@@ -174,14 +174,6 @@ async function uploadContentAddressedFileToS3(client, localPath, uri, expectedSh
   if (!existsSync2(localPath)) {
     throw new Error(`[s3Transport] upload source missing: ${localPath}`);
   }
-  const actualSha256 = await sha256File(localPath);
-  if (actualSha256 !== expectedSha256) {
-    const error = new Error(
-      `[s3Transport] PLAN_ARTIFACT_DIGEST_MISMATCH: local artifact ${localPath} expected ${expectedSha256}, got ${actualSha256}`
-    );
-    error.name = "PLAN_ARTIFACT_DIGEST_MISMATCH";
-    throw error;
-  }
   const { bucket, key } = parseS3Uri(uri);
   const size = statSync(localPath).size;
   const existing = await inspectContentAddressedObject(client, bucket, key, size, expectedSha256);
@@ -338,6 +330,7 @@ var S3PlanV2ArtifactPublisher = class {
   async putBlob(blob) {
     this.#assertOpen("publish a blob");
     const digest = assertSha2562(blob.sha256, "S3 published blob sha256");
+    if (this.#publishedDigests.has(digest)) return;
     const sourceSize = statSync2(blob.sourcePath).size;
     if (sourceSize !== blob.sizeBytes) {
       throw new PlanV2IntegrityError(
@@ -429,7 +422,7 @@ async function handler(event, deps) {
 function normalizeTerminalErrorName(error) {
   if (!error || typeof error !== "object") return;
   const candidate = error;
-  if (candidate.code === "PLAN_PROTOCOL_UNSUPPORTED" || candidate.code === "PLAN_TOO_LARGE" || candidate.code === "PLAN_V2_INTEGRITY_UNRECOVERABLE" || candidate.code === "FONT_FETCH_FAILED" || candidate.code === "FONT_FETCH_UNAVAILABLE" || candidate.code === "NOT_MEDIA_PAYLOAD" || candidate.code === "VIDEO_SOURCE_UNRENDERABLE" || candidate.code === "VIDEO_EXTRACTION_FAILED" || candidate.code === "INVALID_VIDEO_METADATA") {
+  if (candidate.code === "PLAN_PROTOCOL_UNSUPPORTED" || candidate.code === "PLAN_TOO_LARGE" || candidate.code === "PLAN_V2_INTEGRITY_UNRECOVERABLE" || candidate.code === "FONT_FETCH_FAILED" || candidate.code === "FONT_FETCH_UNAVAILABLE" || candidate.code === "NOT_MEDIA_PAYLOAD" || candidate.code === "VIDEO_SOURCE_UNRENDERABLE" || candidate.code === "VIDEO_EXTRACTION_FAILED" || candidate.code === "INVALID_VIDEO_METADATA" || candidate.code === "FORMAT_NOT_SUPPORTED_IN_DISTRIBUTED" || candidate.code === "CHUNK_EXCEEDS_WORKER_TIMEOUT") {
     candidate.name = candidate.code;
   }
 }
@@ -530,11 +523,19 @@ function primeRuntimeEnv() {
     process.env.PATH = `${bin}:${process.env.PATH ?? ""}`;
   }
 }
+function planConfig(event, deps) {
+  const remainingMs = deps?.getRemainingTimeInMillis?.();
+  if (event.Config.workerTimeoutSeconds !== void 0 || remainingMs === void 0) {
+    return { ...event.Config };
+  }
+  return { ...event.Config, workerTimeoutSeconds: Math.ceil(remainingMs / 1e3) };
+}
 async function handlePlan(event, deps) {
   if (event.PlanProtocol !== "v1") {
     return handlePlanV2(event, deps);
   }
   const started = Date.now();
+  const config = planConfig(event, deps);
   const s3 = deps?.s3 ?? getS3Client();
   const primitive = deps?.primitives?.plan ?? plan;
   if (!deps?.skipChromeResolution && !process.env.PRODUCER_HEADLESS_SHELL_PATH) {
@@ -548,9 +549,6 @@ async function handlePlan(event, deps) {
   try {
     await downloadS3ObjectToFile(s3, event.ProjectS3Uri, projectArchive);
     await untarDirectory(projectArchive, projectDir);
-    const config = {
-      ...event.Config
-    };
     const result = await primitive(projectDir, config, planDir);
     const planTar = join2(work, "plan.tar.gz");
     await tarDirectory(planDir, planTar);
@@ -584,6 +582,7 @@ async function handlePlan(event, deps) {
 }
 async function handlePlanV2(event, deps) {
   const started = Date.now();
+  const config = planConfig(event, deps);
   const s3 = deps?.s3 ?? getS3Client();
   const primitive = deps?.primitives?.planV2WithPublisher ?? planV2WithPublisher;
   if (!deps?.skipChromeResolution && !process.env.PRODUCER_HEADLESS_SHELL_PATH) {
@@ -593,14 +592,18 @@ async function handlePlanV2(event, deps) {
   const projectArchive = join2(work, "project.tar.gz");
   const projectDir = join2(work, "project");
   try {
+    let stageStarted = Date.now();
     await downloadS3ObjectToFile(s3, event.ProjectS3Uri, projectArchive);
+    logEvent({ event: "plan_stage", stage: "download", ms: Date.now() - stageStarted });
+    stageStarted = Date.now();
     await untarDirectory(projectArchive, projectDir);
+    logEvent({ event: "plan_stage", stage: "untar", ms: Date.now() - stageStarted });
     const publisher = new S3PlanV2ArtifactPublisher({
       s3,
       planOutputS3Prefix: event.PlanOutputS3Prefix,
       temporaryRoot: work
     });
-    const manifest = await primitive(projectDir, { ...event.Config }, publisher, {
+    const manifest = await primitive(projectDir, config, publisher, {
       stagingParentDir: work
     });
     return {
@@ -769,11 +772,14 @@ async function handleAssembleV2(event, deps) {
   try {
     const planDir = await downloadAndMaterializePlanV2(s3, event, { role: "assembler" }, work);
     const audioPath = resolvePlanAudioPath(planDir);
+    const chunksStarted = Date.now();
     const chunkPaths = await downloadChunkObjects(s3, event.ChunkS3Uris, work, event.Format);
+    const chunksMs = Date.now() - chunksStarted;
     const finalOutput = event.Format === "png-sequence" ? join2(work, "output-frames") : join2(work, `output${formatExtension(event.Format)}`);
     const result = await primitive(planDir, chunkPaths, audioPath, finalOutput, {
       cfr: event.Cfr === true
     });
+    const uploadStarted = Date.now();
     if (event.Format === "png-sequence") {
       const tarball = `${finalOutput}.tar.gz`;
       await tarDirectory(finalOutput, tarball);
@@ -781,6 +787,13 @@ async function handleAssembleV2(event, deps) {
     } else {
       await uploadFileToS3(s3, finalOutput, event.OutputS3Uri);
     }
+    logEvent({
+      event: "assemble_stages",
+      planMs: chunksStarted - started,
+      chunksMs,
+      assembleMs: result.durationMs,
+      uploadMs: Date.now() - uploadStarted
+    });
     return {
       Action: "assemble",
       OutputS3Uri: event.OutputS3Uri,

package/dist/s3Transport.d.ts

@@ -39,11 +39,9 @@ export declare function downloadS3ObjectToFileVerified(client: S3Client, uri: st
  */
 export declare function uploadFileToS3(client: S3Client, localPath: string, uri: string, contentType?: string): Promise<void>;
 /**
- * Upload one content-addressed plan-v2 artifact exactly once.
- *
- * Existing objects are reused only when their immutable digest metadata and
- * byte length agree. A conflicting object is never overwritten: doing so
- * could change a plan already being consumed by another chunk invocation.
+ * Upload one content-addressed plan-v2 artifact exactly once; S3 verifies the bytes against
+ * `ChecksumSHA256`. An existing object is reused only when its digest metadata and length agree,
+ * and a conflicting one is never overwritten, since a chunk may already be reading that plan.
  */
 export declare function uploadContentAddressedFileToS3(client: S3Client, localPath: string, uri: string, expectedSha256: string, contentType?: string): Promise<"uploaded" | "reused">;
 export declare function sha256File(path: string): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.8.166",
+  "version": "0.8.168",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
@@ -45,7 +45,7 @@
     "ffprobe-static": "^3.1.0",
     "puppeteer-core": "^25.8.0",
     "tar": "^7.4.3",
-    "@hyperframes/producer": "^0.8.166"
+    "@hyperframes/producer": "^0.8.168"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.146",