@hyperframes/aws-lambda 0.6.80 → 0.6.81

package/dist/events.d.ts

@@ -15,7 +15,8 @@
  * inside Step Functions' history budget (under 200 bytes for chunk
  * results per §2.4).
  */
-import type { DistributedFormat, DistributedRenderConfig } from "@hyperframes/producer/distributed";
+import type { DistributedFormat, SerializableDistributedRenderConfig } from "@hyperframes/producer/distributed";
+export type { SerializableDistributedRenderConfig } from "@hyperframes/producer/distributed";
 /** Discriminator for the three roles the one Lambda image fulfills. */
 export type LambdaAction = "plan" | "renderChunk" | "assemble";
 /**
@@ -85,13 +86,6 @@ export interface AssembleEvent {
      */
     Cfr?: boolean;
 }
-/**
- * `DistributedRenderConfig` minus the runtime-only fields (`logger`,
- * `abortSignal`, `producerConfig`). The Step Functions event JSON cannot
- * carry function references; the handler reconstitutes the runtime fields
- * from Lambda environment + the AbortController it owns.
- */
-export type SerializableDistributedRenderConfig = Omit<DistributedRenderConfig, "logger" | "abortSignal" | "producerConfig">;
 /** Result of a `plan` invocation. Carries enough to size the Map(N) state. */
 export interface PlanLambdaResult {
     Action: "plan";

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,mCAAmC,EACpC,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EAAE,mCAAmC,EAAE,MAAM,mCAAmC,CAAC;AAE7F,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,gBAAgB,GAChB,aAAa,GACb;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GACxB;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAE3B,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,MAAM,EAAE,mCAAmC,CAAC;CAC7C;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+FAA+F;IAC/F,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAID,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uEAAuE;AACvE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC"}

package/dist/index.js

@@ -488,12 +488,11 @@ function verifyPlanHash(planDir, expected) {
 }
 
 // src/sdk/deploySite.ts
-import { mkdtempSync as mkdtempSync2, readdirSync, readFileSync as readFileSync2, rmSync as rmSync3, statSync as statSync3 } from "node:fs";
-import { createHash } from "node:crypto";
+import { mkdtempSync as mkdtempSync2, rmSync as rmSync3, statSync as statSync3 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join2, relative } from "node:path";
+import { join as join2 } from "node:path";
 import { HeadObjectCommand, S3Client as S3Client2 } from "@aws-sdk/client-s3";
-import { PLAN_PROJECT_DIR_SKIP_SEGMENTS } from "@hyperframes/producer/distributed";
+import { hashProjectDir } from "@hyperframes/producer/distributed";
 async function deploySite(opts) {
   if (!statSync3(opts.projectDir).isDirectory()) {
     throw new Error(`[deploySite] projectDir is not a directory: ${opts.projectDir}`);
@@ -531,28 +530,6 @@ async function deploySite(opts) {
     rmSync3(workdir, { recursive: true, force: true });
   }
 }
-function hashProjectDir(projectDir) {
-  const hash = createHash("sha256");
-  const files = [];
-  function walk(dir, isRoot) {
-    for (const entry of readdirSync(dir, { withFileTypes: true }).sort(
-      (a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0
-    )) {
-      if (isRoot && PLAN_PROJECT_DIR_SKIP_SEGMENTS.has(entry.name)) continue;
-      const full = join2(dir, entry.name);
-      if (entry.isDirectory()) walk(full, false);
-      else if (entry.isFile()) files.push(full);
-    }
-  }
-  walk(projectDir, true);
-  for (const file of files) {
-    const rel = relative(projectDir, file).replaceAll("\\", "/");
-    hash.update(rel);
-    hash.update("\0");
-    hash.update(readFileSync2(file));
-  }
-  return hash.digest("hex").slice(0, 16);
-}
 async function headObject(s3, bucket, key) {
   try {
     const res = await s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));
@@ -574,130 +551,12 @@ import { randomUUID } from "node:crypto";
 import { SFNClient, StartExecutionCommand } from "@aws-sdk/client-sfn";
 
 // src/sdk/validateConfig.ts
-var InvalidConfigError = class extends Error {
-  // Read via Error.prototype.toString; fallow can't see it.
-  // fallow-ignore-next-line unused-class-member
-  name = "InvalidConfigError";
-  /** Dotted JSON-pointer-ish path to the offending field, e.g. `config.fps`. */
-  field;
-  constructor(field, message) {
-    super(`[validateConfig] ${field}: ${message}`);
-    this.field = field;
-  }
-};
-var ALLOWED_FPS = [24, 30, 60];
-var ALLOWED_FORMATS = [
-  "mp4",
-  "mov",
-  "png-sequence",
-  "webm"
-];
-var ALLOWED_CODECS = ["h264", "h265"];
-var ALLOWED_QUALITIES = ["draft", "standard", "high"];
-var ALLOWED_RUNTIME_CAPS = ["lambda", "temporal", "cloud-run-job", "k8s-job", "none"];
-var ALLOWED_HDR_MODES = ["auto", "force-sdr"];
-var MAX_DIMENSION = 7680;
-var MIN_DIMENSION = 16;
-var MAX_CHUNK_SIZE = 3600;
-var MAX_PARALLEL_CHUNKS_CEILING = 256;
-function validateDistributedRenderConfig(config) {
-  if (config === null || typeof config !== "object") {
-    throw new InvalidConfigError("config", "must be an object");
-  }
-  if (!ALLOWED_FPS.includes(config.fps)) {
-    throw new InvalidConfigError(
-      "config.fps",
-      `must be one of ${ALLOWED_FPS.join(", ")}; got ${String(config.fps)}`
-    );
-  }
-  validateIntDimension("config.width", config.width);
-  validateIntDimension("config.height", config.height);
-  if (!ALLOWED_FORMATS.includes(config.format)) {
-    throw new InvalidConfigError(
-      "config.format",
-      `must be one of ${ALLOWED_FORMATS.join(", ")}; got ${String(config.format)}`
-    );
-  }
-  if (config.codec !== void 0) {
-    if (config.format !== "mp4") {
-      throw new InvalidConfigError(
-        "config.codec",
-        `is only valid with format="mp4"; got format=${String(config.format)}`
-      );
-    }
-    if (!ALLOWED_CODECS.includes(config.codec)) {
-      throw new InvalidConfigError(
-        "config.codec",
-        `must be one of ${ALLOWED_CODECS.join(", ")}; got ${String(config.codec)}`
-      );
-    }
-  }
-  if (config.quality !== void 0 && !ALLOWED_QUALITIES.includes(config.quality)) {
-    throw new InvalidConfigError(
-      "config.quality",
-      `must be one of ${ALLOWED_QUALITIES.join(", ")}; got ${String(config.quality)}`
-    );
-  }
-  if (config.crf !== void 0 && config.bitrate !== void 0) {
-    throw new InvalidConfigError("config.crf", "is mutually exclusive with config.bitrate");
-  }
-  if (config.crf !== void 0 && (!Number.isInteger(config.crf) || config.crf < 0 || config.crf > 51)) {
-    throw new InvalidConfigError("config.crf", `must be an integer in [0, 51]; got ${config.crf}`);
-  }
-  if (config.bitrate !== void 0 && !/^\d+(\.\d+)?[kKmM]?$/.test(config.bitrate)) {
-    throw new InvalidConfigError(
-      "config.bitrate",
-      `must look like "10M" or "5000k"; got ${JSON.stringify(config.bitrate)}`
-    );
-  }
-  if (config.chunkSize !== void 0) {
-    if (!Number.isInteger(config.chunkSize) || config.chunkSize < 1) {
-      throw new InvalidConfigError(
-        "config.chunkSize",
-        `must be a positive integer; got ${config.chunkSize}`
-      );
-    }
-    if (config.chunkSize > MAX_CHUNK_SIZE) {
-      throw new InvalidConfigError(
-        "config.chunkSize",
-        // Lambda 15-min cap leaves no useful headroom past ~3600 frames
-        // at 4 fps capture-equivalent throughput; rejecting up front
-        // avoids a 14-minute Plan-state retry storm.
-        `must be \u2264 ${MAX_CHUNK_SIZE} (Lambda 15-min cap); got ${config.chunkSize}`
-      );
-    }
-  }
-  if (config.maxParallelChunks !== void 0) {
-    if (!Number.isInteger(config.maxParallelChunks) || config.maxParallelChunks < 1) {
-      throw new InvalidConfigError(
-        "config.maxParallelChunks",
-        `must be a positive integer; got ${config.maxParallelChunks}`
-      );
-    }
-    if (config.maxParallelChunks > MAX_PARALLEL_CHUNKS_CEILING) {
-      throw new InvalidConfigError(
-        "config.maxParallelChunks",
-        `must be \u2264 ${MAX_PARALLEL_CHUNKS_CEILING}; got ${config.maxParallelChunks}`
-      );
-    }
-  }
-  if (config.runtimeCap !== void 0 && !ALLOWED_RUNTIME_CAPS.includes(config.runtimeCap)) {
-    throw new InvalidConfigError(
-      "config.runtimeCap",
-      `must be one of ${ALLOWED_RUNTIME_CAPS.join(", ")}; got ${String(config.runtimeCap)}`
-    );
-  }
-  if (config.hdrMode !== void 0 && !ALLOWED_HDR_MODES.includes(config.hdrMode)) {
-    throw new InvalidConfigError(
-      "config.hdrMode",
-      `distributed mode supports only ${ALLOWED_HDR_MODES.join(", ")}; got ${String(config.hdrMode)}`
-    );
-  }
-  if (config.variables !== void 0) {
-    validateVariablesPayload(config.variables);
-  }
-  return config;
-}
+import { InvalidConfigError } from "@hyperframes/producer/distributed";
+import {
+  InvalidConfigError as InvalidConfigError2,
+  validateDistributedRenderConfig,
+  validateVariablesPayload
+} from "@hyperframes/producer/distributed";
 var MAX_STEP_FUNCTIONS_INPUT_BYTES = 256 * 1024;
 var LARGE_VARIABLES_DOCS_URL = "https://hyperframes.heygen.com/deploy/templates-on-lambda#working-with-large-variables";
 function validateStepFunctionsInputSize(input) {
@@ -724,84 +583,6 @@ function validateStepFunctionsInputSize(input) {
     );
   }
 }
-function validateVariablesPayload(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new InvalidConfigError(
-      "config.variables",
-      `must be a plain JSON object (got ${describeValue(value)})`
-    );
-  }
-  walkVariables(value, "config.variables", /* @__PURE__ */ new WeakSet());
-}
-var LEAF_REJECTIONS = {
-  // `JSON.stringify` silently drops `undefined` leaves — caller would never
-  // notice their value isn't actually being sent.
-  undefined: "undefined leaves are silently dropped by JSON.stringify \u2014 use null if you mean an absent value",
-  function: "functions are not JSON-serializable",
-  symbol: "Symbols are not JSON-serializable",
-  bigint: "BigInt values throw at JSON.stringify \u2014 encode as a string if you need 64-bit integers"
-};
-function walkVariables(value, path, seen) {
-  const t = typeof value;
-  if (value === null || t === "string" || t === "boolean") return;
-  if (t === "number") {
-    if (!Number.isFinite(value)) {
-      throw new InvalidConfigError(
-        path,
-        `non-finite numbers (NaN / Infinity) are not JSON-serializable; got ${String(value)}`
-      );
-    }
-    return;
-  }
-  const leafReject = LEAF_REJECTIONS[t];
-  if (leafReject !== void 0) {
-    throw new InvalidConfigError(path, leafReject);
-  }
-  if (seen.has(value)) {
-    throw new InvalidConfigError(
-      path,
-      "circular reference detected \u2014 JSON.stringify cannot serialize cycles"
-    );
-  }
-  seen.add(value);
-  if (Array.isArray(value)) {
-    for (let i = 0; i < value.length; i++) {
-      walkVariables(value[i], `${path}[${i}]`, seen);
-    }
-    return;
-  }
-  const proto = Object.getPrototypeOf(value);
-  if (proto !== Object.prototype && proto !== null) {
-    throw new InvalidConfigError(
-      path,
-      `non-plain objects are not supported (got ${describeValue(value)}); use a plain {\u2026} object`
-    );
-  }
-  for (const key of Object.keys(value)) {
-    walkVariables(value[key], `${path}.${key}`, seen);
-  }
-}
-function describeValue(value) {
-  if (value === null) return "null";
-  if (Array.isArray(value)) return "array";
-  if (typeof value !== "object") return typeof value;
-  const ctorName = value.constructor?.name ?? "Object";
-  return ctorName === "Object" ? "object" : ctorName;
-}
-function validateIntDimension(field, value) {
-  if (typeof value !== "number" || !Number.isInteger(value)) {
-    throw new InvalidConfigError(field, `must be an integer; got ${String(value)}`);
-  }
-  if (value < MIN_DIMENSION || value > MAX_DIMENSION) {
-    throw new InvalidConfigError(
-      field,
-      `must be in [${MIN_DIMENSION}, ${MAX_DIMENSION}]; got ${value}`
-    );
-  }
-  if (value % 2 !== 0) {
-    throw new InvalidConfigError(field, `must be even (yuv420p constraint); got ${value}`);
-  }
-}
 
 // src/sdk/renderToLambda.ts
 async function renderToLambda(opts) {
@@ -1130,7 +911,7 @@ function isTerminalFailure(status) {
 }
 export {
   ChromeBinaryUnavailableError,
-  InvalidConfigError,
+  InvalidConfigError2 as InvalidConfigError,
   computeRenderCost,
   deploySite,
   downloadS3ObjectToFile,