@transcodely/sdk 0.3.15 → 0.3.16

package/dist/index.mjs

@@ -7302,7 +7302,8 @@ proto3.util.setEnumType(ToneMapping, "transcodely.v1.ToneMapping", [
 ]);
 var HDRConfig = class _HDRConfig extends Message {
   /**
-   * Target HDR format (required for passthrough and force modes).
+   * Target HDR format (required for passthrough and force modes). In tonemap
+   * mode it names the HDR format of the source.
    * `dolby_vision_5` and `dolby_vision_8` are refused at create until the
    * worker produces Dolby Vision output; a refused request creates no job and
    * is neither quoted nor billed.
@@ -7317,14 +7318,17 @@ var HDRConfig = class _HDRConfig extends Message {
    */
   mode = 0 /* HDR_MODE_UNSPECIFIED */;
   /**
-   * Tone mapping algorithm (for tonemap mode).
+   * Tone mapping algorithm (tonemap mode only). Unset means `bt2390`, which,
+   * like an explicit `bt2390`, is approximated with `hable` on CPU.
    *
    * @generated from field: transcodely.v1.ToneMapping tone_mapping = 3;
    */
   toneMapping = 0 /* UNSPECIFIED */;
   /**
-   * Target peak brightness in nits (for tonemap and force modes).
-   * Range: 100-10000.
+   * Target peak brightness in nits. Range: 100-10000. Applies to HDR output
+   * only: refused with `parameter_forbidden` in tonemap mode, whose SDR target
+   * has a fixed peak. Accepted in passthrough and force modes, where the
+   * encoder does not currently read it, so it has no effect on the output.
    *
    * @generated from field: optional int32 target_peak_nits = 4;
    */
@@ -9056,27 +9060,43 @@ proto3.util.setEnumType(ContentAwareMode, "transcodely.v1.ContentAwareMode", [
 ]);
 var AutoABRConfig = class _AutoABRConfig extends Message {
   /**
-   * Minimum number of variants in the ladder.
-   * Default: 2.
+   * Fewest rungs the ladder may be pruned to. Default: 2.
+   *
+   * A ladder can never hold more rungs than the source allows: only one tier
+   * at or above the source's short side is kept, so a 480-line source yields
+   * one rung whatever this says. When pruning would leave fewer rungs than
+   * this, rungs are put back from the bottom of the ladder up. Set it to 1 to
+   * say a single rung is an acceptable result for any source. Must not exceed
+   * max_variants, nor the number of standard rungs between min_resolution and
+   * max_resolution.
    *
    * @generated from field: optional int32 min_variants = 1;
    */
   minVariants;
   /**
-   * Maximum number of variants in the ladder.
-   * Default: 8.
+   * Most rungs the ladder may hold. A ceiling longer than this keeps its TOP
+   * rung (quality) and its BOTTOM rung (reach) and drops interior rungs from
+   * the highest down: 2160p..480p capped at 3 is 2160p, 720p, 480p. Default:
+   * no cap beyond the standard rungs in range (at most five).
    *
    * @generated from field: optional int32 max_variants = 2;
    */
   maxVariants;
   /**
-   * Lowest resolution in the generated ladder.
+   * Lowest rung the ladder may contain. Default: 480p. When the source's short
+   * side is below this, the ladder is one rung: the smallest tier at or above
+   * the source's short side, rendered at the source's own size.
    *
    * @generated from field: transcodely.v1.Resolution min_resolution = 3;
    */
   minResolution = 0 /* RESOLUTION_UNSPECIFIED */;
   /**
-   * Highest resolution in the generated ladder.
+   * Highest rung the ladder may contain. Default: 1080p, NOT the highest the
+   * source allows — 1440p and 2160p rungs must be asked for here. The worker
+   * that renders the job is sized from this ceiling before the source is
+   * known, and a default that sized every job for 4K would bill nobody more
+   * but waste a large machine on most sources. 4320p is accepted and behaves
+   * as 2160p, the largest standard rung.
    *
    * @generated from field: transcodely.v1.Resolution max_resolution = 4;
    */
@@ -9108,8 +9128,7 @@ var AutoABRConfig = class _AutoABRConfig extends Message {
 };
 var ContentAwareConfig = class _ContentAwareConfig extends Message {
   /**
-   * Encoding mode (required). `per_title` is accepted; `auto_abr` is rejected
-   * at create.
+   * Encoding mode (required): `per_title` or `auto_abr`.
    *
    * @generated from field: transcodely.v1.ContentAwareMode mode = 1;
    */
@@ -9130,8 +9149,8 @@ var ContentAwareConfig = class _ContentAwareConfig extends Message {
    */
   vmafTarget;
   /**
-   * Auto ABR constraints (only for auto_abr mode). NOT YET ACCEPTED — an
-   * auto_abr request is rejected at create whatever these say.
+   * Ladder bounds, only for `auto_abr` mode. Refused with
+   * `parameter_forbidden` on `per_title`.
    *
    * @generated from field: optional transcodely.v1.AutoABRConfig auto_abr = 3;
    */
@@ -12074,7 +12093,9 @@ var OutputSpec = class _OutputSpec extends Message {
    * Enables per-title encoding, which tunes this output's CRF to the source
    * rather than to its quality tier. Requires at least one video rendition that
    * is not pinned to an explicit bitrate, and a source of at least 120 seconds.
-   * `auto_abr` mode is not accepted yet.
+   * `auto_abr` mode (choose which rungs of a standard ladder to render, for
+   * streaming outputs) is defined but not accepted yet: it is rejected with
+   * `parameter_unsupported`.
    *
    * @generated from field: optional transcodely.v1.ContentAwareConfig content_aware = 13;
    */
@@ -20342,9 +20363,9 @@ var JobService = {
 
 // src/errors.ts
 var TranscodelyError = class extends Error {
-  /** Server-side error code (e.g. "JOB_NOT_FOUND"). */
+  /** Server-side error code (e.g. "validation_error"). */
   code;
-  /** Top-level error type (e.g. "validation_error"). */
+  /** Connect error code (e.g. "invalid_argument"). */
   type;
   /** Field-level validation violations. */
   errors;
@@ -20442,7 +20463,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.15";
+var SDK_VERSION = "0.3.16";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";
 
@@ -25267,7 +25288,7 @@ function mapHttpError({ status, body, headers }) {
   const requestId = headers.get("x-request-id") ?? void 0;
   const parsed = parseBody(body);
   const message = parsed.message ?? `HTTP ${status}`;
-  const detail = parsed.details?.[0]?.debug;
+  const detail = parsed.details?.find(isErrorDetails)?.debug;
   const code = detail?.code;
   const violations = detail?.field_violations ?? detail?.fieldViolations ?? [];
   const opts = {
@@ -25298,6 +25319,10 @@ function connectionError(cause, message) {
   const msg = (cause instanceof Error ? cause.message : "network request failed");
   return new APIConnectionError({ message: msg, cause });
 }
+var ERROR_DETAILS_TYPE = "transcodely.v1.ErrorDetails";
+function isErrorDetails(d) {
+  return d.type === void 0 || d.type === ERROR_DETAILS_TYPE || d.type.endsWith(`/${ERROR_DETAILS_TYPE}`);
+}
 function parseBody(body) {
   if (typeof body === "string") {
     try {