@hyperframes/aws-lambda 0.8.189 → 0.8.191

package/dist/_chunks/{chunk-YS3KY3C5.js → chunk-3UDA73TT.js}

@@ -10,10 +10,14 @@ function contentStoreUri(bucket, sha256) {
   }
   return `s3://${bucket}/${CONTENT_STORE_PREFIX}/${sha256.slice(0, 2)}/${sha256}`;
 }
+function audioSidecarUri(bucket, sha256) {
+  return `${contentStoreUri(bucket, sha256)}.audio.m4a`;
+}
 
 export {
   CONTENT_STORE_PREFIX,
   CONTENT_STORE_RETENTION_DAYS,
   CONTENT_STORE_REFRESH_AFTER_DAYS,
-  contentStoreUri
+  contentStoreUri,
+  audioSidecarUri
 };

package/dist/_chunks/{chunk-CKQ6SAJX.js → chunk-FQDVV4JA.js}

@@ -1,7 +1,8 @@
 import {
   CONTENT_STORE_REFRESH_AFTER_DAYS,
+  audioSidecarUri,
   contentStoreUri
-} from "./chunk-YS3KY3C5.js";
+} from "./chunk-3UDA73TT.js";
 
 // src/s3Transport.ts
 import {
@@ -333,6 +334,24 @@ async function putContentStoreFile(client, localPath, bucket, sha256) {
   if (lastModified) await refreshAgingObject(client, uri, sha256, lastModified, size ?? 0);
   return outcome;
 }
+async function putAudioSidecar(client, localPath, bucket, sha256) {
+  const uri = audioSidecarUri(bucket, sha256);
+  if (await s3ObjectExists(client, uri)) return "reused";
+  const { key } = parseS3Uri(uri);
+  const size = statSync(localPath).size;
+  const own = await sha256File(localPath);
+  try {
+    if (size > MAX_SINGLE_PUT_BYTES) {
+      await uploadFileInParts(client, localPath, size, { Bucket: bucket, Key: key }, own);
+    } else {
+      await putImmutableBody(client, localPath, bucket, key, size, own, "audio/mp4");
+    }
+  } catch (error) {
+    if (!isS3PreconditionFailed(error)) throw error;
+    return "reused";
+  }
+  return "uploaded";
+}
 async function ensureContentStoreObject(client, bucket, sha256, sizeBytes) {
   const uri = contentStoreUri(bucket, sha256);
   const { key } = parseS3Uri(uri);
@@ -519,8 +538,10 @@ async function downloadSiteFiles(s3, manifestUri, projectDir, leaveVideosRemote)
   await mapConcurrent(files, 16, async ({ path, sha256, sizeBytes }) => {
     const uri = contentStoreUri(bucket, sha256);
     if (leaveVideosRemote && VIDEO_EXTENSIONS_PLANNED_IN_PLACE.has(extname(path).toLowerCase())) {
+      const sidecar = audioSidecarUri(bucket, sha256);
       remoteFiles[path] = {
         url: await presignS3GetUrl(s3, uri, REMOTE_URL_TTL_SECONDS),
+        ...await s3ObjectExists(s3, sidecar) ? { audioSidecarUrl: await presignS3GetUrl(s3, sidecar, REMOTE_URL_TTL_SECONDS) } : {},
         sha256,
         sizeBytes
       };
@@ -551,6 +572,7 @@ export {
   mapConcurrent,
   sha256File,
   putContentStoreFile,
+  putAudioSidecar,
   ensureContentStoreObject,
   s3ObjectExists,
   isS3NotFound,

package/dist/_chunks/{chunk-ROTCAPRH.js → chunk-J3OLGMWP.js}

@@ -15,10 +15,10 @@ import {
   untarDirectory,
   uploadContentAddressedFileToS3,
   uploadFileToS3
-} from "./chunk-CKQ6SAJX.js";
+} from "./chunk-FQDVV4JA.js";
 import {
   CONTENT_STORE_PREFIX
-} from "./chunk-YS3KY3C5.js";
+} from "./chunk-3UDA73TT.js";
 
 // src/handler.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, mkdtempSync as mkdtempSync2, readFileSync, rmSync as rmSync2, statSync as statSync2 } from "node:fs";
@@ -345,6 +345,11 @@ function getS3Client() {
   return cachedS3Client;
 }
 async function handler(event, deps) {
+  if (event.Action === "warm") {
+    primeRuntimeEnv();
+    await ensureChromePath(deps);
+    return { Action: "warm" };
+  }
   const unwrapped = unwrapEvent(event);
   validatePlanProtocolShape(unwrapped);
   validateEventS3Uris(unwrapped);

package/dist/_chunks/{chunk-EG2WRNUL.js → chunk-L4R3FJOR.js}

@@ -9,6 +9,7 @@ import {
   mapConcurrent,
   parseS3Uri,
   parseSiteManifest,
+  putAudioSidecar,
   putContentStoreFile,
   s3ObjectExists,
   serializeSiteManifest,
@@ -16,17 +17,23 @@ import {
   siteManifestUri,
   siteTarballUri,
   uploadContentAddressedFileToS3
-} from "./chunk-CKQ6SAJX.js";
+} from "./chunk-FQDVV4JA.js";
 import {
-  CONTENT_STORE_RETENTION_DAYS
-} from "./chunk-YS3KY3C5.js";
+  CONTENT_STORE_RETENTION_DAYS,
+  audioSidecarUri
+} from "./chunk-3UDA73TT.js";
 
 // src/sdk/deploySite.ts
 import { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { S3Client } from "@aws-sdk/client-s3";
-import { hashProjectDir, listSiteFiles } from "@hyperframes/producer/distributed";
+import {
+  buildAudioSidecar,
+  hashProjectDir,
+  listSiteFiles,
+  wantsAudioSidecar
+} from "@hyperframes/producer/distributed";
 function siteHandleFromId(bucketName, siteId) {
   const projectS3Uri = siteManifestUri(bucketName, siteId);
   return { siteId, bucketName, projectS3Uri, bytes: 0, uploadedAt: "", uploaded: false };
@@ -97,6 +104,7 @@ async function deploySite(opts) {
     uploaded ||= outcome === "uploaded";
   });
   stored.sort((a, b) => a.path < b.path ? -1 : 1);
+  await storeAudioSidecars(s3, opts, stored);
   const workdir = mkdtempSync(join(tmpdir(), "hf-deploy-site-"));
   try {
     const manifestPath = join(workdir, "files.json");
@@ -122,6 +130,30 @@ async function deploySite(opts) {
     uploaded
   };
 }
+async function storeAudioSidecars(s3, opts, files) {
+  const videos = files.filter((file) => wantsAudioSidecar(file.path, file.sizeBytes));
+  if (videos.length === 0) return;
+  const workdir = mkdtempSync(join(tmpdir(), "hf-audio-sidecar-"));
+  let unavailable = false;
+  try {
+    await mapConcurrent(videos, 2, async ({ path, sha256 }) => {
+      if (unavailable || await s3ObjectExists(s3, audioSidecarUri(opts.bucketName, sha256)))
+        return;
+      const sidecarPath = join(workdir, `${sha256}.m4a`);
+      const outcome = await buildAudioSidecar(join(opts.projectDir, path), sidecarPath);
+      if (outcome === "unavailable") unavailable = true;
+      if (outcome === "built") await putAudioSidecar(s3, sidecarPath, opts.bucketName, sha256);
+      rmSync(sidecarPath, { force: true });
+    });
+  } finally {
+    rmSync(workdir, { recursive: true, force: true });
+  }
+  if (unavailable) {
+    opts.onNotice?.(
+      "ffmpeg was not found on this machine, so the audio of large videos was not stored on its own: renders will read the whole video for its audio and take longer. Install ffmpeg and run `sites create` again."
+    );
+  }
+}
 
 // src/sdk/validateConfig.ts
 import { InvalidConfigError } from "@hyperframes/producer/distributed";
@@ -190,6 +222,7 @@ async function renderToLambda(opts) {
     projectDir: opts.projectDir,
     bucketName: opts.bucketName,
     region: opts.region,
+    onNotice: opts.onNotice,
     s3: opts.s3
   });
   const input = {

package/dist/cdk/index.js

@@ -1,7 +1,7 @@
 import {
   CONTENT_STORE_PREFIX,
   CONTENT_STORE_RETENTION_DAYS
-} from "../_chunks/chunk-YS3KY3C5.js";
+} from "../_chunks/chunk-3UDA73TT.js";
 
 // src/cdk/HyperframesRenderStack.ts
 import { dirname, resolve } from "node:path";

package/dist/contentStore.d.ts

@@ -3,3 +3,4 @@ export declare const CONTENT_STORE_RETENTION_DAYS = 30;
 /** Reusing an object at least this old rewrites it, so a plan's objects outlive it by 23+ days. */
 export declare const CONTENT_STORE_REFRESH_AFTER_DAYS = 7;
 export declare function contentStoreUri(bucket: string, sha256: string): string;
+export declare function audioSidecarUri(bucket: string, sha256: string): string;

package/dist/events.d.ts

@@ -19,6 +19,9 @@ import type { DistributedFormat, SerializableDistributedRenderConfig } from "@hy
 export type { SerializableDistributedRenderConfig } from "@hyperframes/producer/distributed";
 /** Discriminator for the three roles the one Lambda image fulfills. */
 export type LambdaAction = "plan" | "audio" | "renderChunk" | "assemble";
+export interface WarmEvent {
+    Action: "warm";
+}
 /** Transport protocol selected for one complete distributed render. */
 export type LambdaPlanProtocol = "v1" | "v2";
 /**
@@ -29,7 +32,7 @@ export type LambdaPlanProtocol = "v1" | "v2";
  * handler unwraps both `event.Payload` and `event.Input` before
  * dispatching.
  */
-export type LambdaEvent = PlanEvent | AudioEvent | RenderChunkEvent | AssembleEvent | {
+export type LambdaEvent = PlanEvent | AudioEvent | RenderChunkEvent | AssembleEvent | WarmEvent | {
     Payload: LambdaEvent;
 } | {
     Input: LambdaEvent;
@@ -199,4 +202,7 @@ export interface AssembleLambdaResult {
     FileSize: number;
     DurationMs: number;
 }
-export type LambdaResult = PlanLambdaResult | AudioLambdaResult | RenderChunkLambdaResult | AssembleLambdaResult;
+export interface WarmLambdaResult {
+    Action: "warm";
+}
+export type LambdaResult = WarmLambdaResult | PlanLambdaResult | AudioLambdaResult | RenderChunkLambdaResult | AssembleLambdaResult;

package/dist/handler.js

@@ -1,9 +1,9 @@
 import {
   handler,
   unwrapEvent
-} from "./_chunks/chunk-ROTCAPRH.js";
-import "./_chunks/chunk-CKQ6SAJX.js";
-import "./_chunks/chunk-YS3KY3C5.js";
+} from "./_chunks/chunk-J3OLGMWP.js";
+import "./_chunks/chunk-FQDVV4JA.js";
+import "./_chunks/chunk-3UDA73TT.js";
 export {
   handler,
   unwrapEvent

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   resolveChromeExecutablePath,
   resolveChromeSource,
   unwrapEvent
-} from "./_chunks/chunk-ROTCAPRH.js";
+} from "./_chunks/chunk-J3OLGMWP.js";
 import {
   InvalidConfigError,
   computeRenderCost,
@@ -14,7 +14,7 @@ import {
   getRenderProgress,
   renderToLambda,
   validateDistributedRenderConfig
-} from "./_chunks/chunk-EG2WRNUL.js";
+} from "./_chunks/chunk-L4R3FJOR.js";
 import {
   downloadS3ObjectToFile,
   downloadS3ObjectToFileVerified,
@@ -24,8 +24,8 @@ import {
   untarDirectory,
   uploadContentAddressedFileToS3,
   uploadFileToS3
-} from "./_chunks/chunk-CKQ6SAJX.js";
-import "./_chunks/chunk-YS3KY3C5.js";
+} from "./_chunks/chunk-FQDVV4JA.js";
+import "./_chunks/chunk-3UDA73TT.js";
 export {
   ChromeBinaryUnavailableError,
   InvalidConfigError,

package/dist/s3Transport.d.ts

@@ -65,6 +65,7 @@ export declare function mapConcurrent<T>(values: readonly T[], concurrency: numb
 export declare function sha256File(path: string): Promise<string>;
 /** Put a file into the shared content store once; reusing an aging object restarts its expiry. */
 export declare function putContentStoreFile(client: S3Client, localPath: string, bucket: string, sha256: string): Promise<"uploaded" | "reused">;
+export declare function putAudioSidecar(client: S3Client, localPath: string, bucket: string, sha256: string): Promise<"uploaded" | "reused">;
 /** Confirm an object the caller never uploaded is in the content store, restarting an aging one. */
 export declare function ensureContentStoreObject(client: S3Client, bucket: string, sha256: string, sizeBytes: number): Promise<void>;
 export declare function presignS3GetUrl(client: S3Client, uri: string, expiresInSeconds: number): Promise<string>;

package/dist/sdk/deploySite.d.ts

@@ -25,6 +25,8 @@ export interface DeploySiteOptions {
      * unset, the hash of the project tree picks it.
      */
     siteId?: string;
+    /** Called with a line a user should see, such as audio sidecars skipped for want of ffmpeg. */
+    onNotice?: (message: string) => void;
     /** Injection seam for tests. Production callers leave unset. */
     s3?: S3Client;
 }

package/dist/sdk/index.js

@@ -10,11 +10,11 @@ import {
   validateDistributedRenderConfig,
   validateStepFunctionsInputSize,
   validateVariablesPayload
-} from "../_chunks/chunk-EG2WRNUL.js";
+} from "../_chunks/chunk-L4R3FJOR.js";
 import {
   sha256File
-} from "../_chunks/chunk-CKQ6SAJX.js";
-import "../_chunks/chunk-YS3KY3C5.js";
+} from "../_chunks/chunk-FQDVV4JA.js";
+import "../_chunks/chunk-3UDA73TT.js";
 
 // src/sdk/prebuiltHandler.ts
 import { existsSync, readFileSync } from "node:fs";

package/dist/sdk/renderToLambda.d.ts

@@ -26,6 +26,7 @@ export interface RenderToLambdaOptions {
     projectDir?: string;
     /** Re-use an existing `deploySite` upload (skips tar+S3 PUT). */
     siteHandle?: SiteHandle;
+    onNotice?: (message: string) => void;
     /** Validated `SerializableDistributedRenderConfig` (no logger / abortSignal). */
     config: SerializableDistributedRenderConfig;
     /**

package/package.json

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

package/prebuilt/handler-zip.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.8.189",
-  "url": "https://github.com/heygen-com/hyperframes/releases/download/v0.8.189/hyperframes-lambda-handler.zip",
-  "sha256": "95078b7e47160ad95141a051ae8bf772909229c3d626eea59061ddcd5cfb764f",
-  "bytes": 129250008
+  "version": "0.8.191",
+  "url": "https://github.com/heygen-com/hyperframes/releases/download/v0.8.191/hyperframes-lambda-handler.zip",
+  "sha256": "1f3e446a2c315dd675f283920d6231e3d80fc57a09ba6e16788a1f8ba9470a8d",
+  "bytes": 129256219
 }

package/prebuilt/template.yaml

@@ -254,6 +254,11 @@ Resources:
           SelectPlanProtocol:
             Type: Choice
             Choices:
+              # Only a stack with the arm64 video function has a cold x86 function to warm.
+              # Without one the compared value can never match.
+              - Variable: $.PlanProtocol
+                StringEquals: !If [HasVideoFunction, v2, v2-without-video-function]
+                Next: WarmRender
               - Variable: $.PlanProtocol
                 StringEquals: v2
                 Next: PlanV2
@@ -265,6 +270,23 @@ Resources:
                 Next: UnsupportedPlanProtocol
             Default: PlanV2
 
+          # The audio task runs on this function once the plan is done; starting its container now hides the cold start.
+          WarmRender:
+            Type: Task
+            Resource: arn:aws:states:::lambda:invoke
+            Parameters:
+              FunctionName: !GetAtt RenderFunction.Arn
+              InvocationType: Event
+              Payload:
+                Action: warm
+            ResultPath: null
+            Catch:
+              - ErrorEquals:
+                  - States.ALL
+                ResultPath: null
+                Next: PlanV2
+            Next: PlanV2
+
           UnsupportedPlanProtocol:
             Type: Fail
             Error: PLAN_PROTOCOL_UNSUPPORTED

package/prebuilt/video-image.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.8.189",
-  "url": "https://github.com/heygen-com/hyperframes/releases/download/v0.8.189/hyperframes-lambda-video-arm64.oci.tar",
-  "sha256": "f47d18971cccbdef020abc1e43fb1d5296ece69af7f02e0bde1f951db61aea73",
-  "bytes": 244629504
+  "version": "0.8.191",
+  "url": "https://github.com/heygen-com/hyperframes/releases/download/v0.8.191/hyperframes-lambda-video-arm64.oci.tar",
+  "sha256": "a2aa52fe187cff37f073a5bccad3778832deb720b036b1df41b4329e197750e1",
+  "bytes": 244635136
 }