@transcodely/sdk 0.3.15 → 0.3.16

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to the Transcodely JavaScript / TypeScript SDK will be docum
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Breaking changes are allowed on minor bumps until 1.0.0.
 
+## [0.3.16](https://github.com/transcodely/transcodely-js/compare/v0.3.15...v0.3.16) (2026-10-31)
+
+
+### Features
+
+* resync protos — auto_abr accepted, tone-mapping refusal rule, validation error envelope ([8f88507](https://github.com/transcodely/transcodely-js/commit/8f8850782adc63ef789ec852a5feac5aeebb1c12))
+* resync protos — auto_abr accepted, tone-mapping refusal rule, validation error envelope ([de3f67b](https://github.com/transcodely/transcodely-js/commit/de3f67b48ffc8c472674bc5f03850616d796d41a))
+
+
+### Bug Fixes
+
+* read the ErrorDetails detail by type, and document type as the Connect code ([f6af4e9](https://github.com/transcodely/transcodely-js/commit/f6af4e9c80398768f8fe5883d18e199ca746b386))
+
+
+### Documentation
+
+* describe the validation error envelope and pin it with a test ([1c44049](https://github.com/transcodely/transcodely-js/commit/1c4404907b4a01577960e1d832c9c25928fc5db3))
+
 ## [0.3.15](https://github.com/transcodely/transcodely-js/compare/v0.3.14...v0.3.15) (2026-10-30)
 
 

package/README.md

@@ -652,6 +652,14 @@ try {
 }
 ```
 
+Every validation refusal, whether the request schema, a codec check or a feature
+rule caught it, comes back as an `InvalidRequestError` listing every bad field
+at once. Each violation's `description` starts with that field's error code in
+brackets, for example `[parameter_out_of_range] value must be ...`, and `code`
+holds the error type, such as `validation_error`, `invalid_request_error`,
+`codec_error` or `feature_error`. A refusal that names no field carries no
+detail, so its code is empty. `type` holds the Connect code, `invalid_argument`.
+
 The hierarchy:
 
 | Class | Status | When |

package/dist/index.cjs

@@ -7304,7 +7304,8 @@ protobuf.proto3.util.setEnumType(ToneMapping, "transcodely.v1.ToneMapping", [
 ]);
 var HDRConfig = class _HDRConfig extends protobuf.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.
@@ -7319,14 +7320,17 @@ var HDRConfig = class _HDRConfig extends protobuf.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;
    */
@@ -9058,27 +9062,43 @@ protobuf.proto3.util.setEnumType(ContentAwareMode, "transcodely.v1.ContentAwareM
 ]);
 var AutoABRConfig = class _AutoABRConfig extends protobuf.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;
    */
@@ -9110,8 +9130,7 @@ var AutoABRConfig = class _AutoABRConfig extends protobuf.Message {
 };
 var ContentAwareConfig = class _ContentAwareConfig extends protobuf.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;
    */
@@ -9132,8 +9151,8 @@ var ContentAwareConfig = class _ContentAwareConfig extends protobuf.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;
    */
@@ -12076,7 +12095,9 @@ var OutputSpec = class _OutputSpec extends protobuf.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;
    */
@@ -20344,9 +20365,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;
@@ -20444,7 +20465,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";
 
@@ -25269,7 +25290,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 = {
@@ -25300,6 +25321,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 {