@transcodely/sdk 0.3.14 → 0.3.16

package/CHANGELOG.md

@@ -4,6 +4,31 @@ 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)
+
+
+### Features
+
+* resync protos to api master — usage hosting_estimated_from, encoding_mode echo ([f1f6bee](https://github.com/transcodely/transcodely-js/commit/f1f6bee811da5c86e3a74021ba42fcab8bffb6a8))
+
 ## [0.3.14](https://github.com/transcodely/transcodely-js/compare/v0.3.13...v0.3.14) (2026-10-27)
 
 

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

@@ -1918,9 +1918,10 @@ var AutoProfileDefaults = class _AutoProfileDefaults extends protobuf.Message {
    */
   qualityTier;
   /**
-   * Encoding mode: "fixed" (default, static CRF) or "auto" (input-aware constrained CRF).
+   * Encoding mode: "auto" (default, input-aware constrained CRF) or "fixed" (static CRF).
    * In "auto" mode, the worker caps each variant's bitrate based on the input's bitrate
-   * and resolution ratio, preventing output from exceeding the input's quality ceiling.
+   * and resolution ratio, preventing output from exceeding the input's quality ceiling,
+   * and skips any ladder rung larger than the source instead of upscaling it.
    *
    * @generated from field: optional string encoding_mode = 5;
    */
@@ -7303,7 +7304,11 @@ 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.
    *
    * @generated from field: transcodely.v1.HDRFormat format = 1;
    */
@@ -7315,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;
    */
@@ -7342,7 +7350,9 @@ var HDRConfig = class _HDRConfig extends protobuf.Message {
    */
   contentLightLevel;
   /**
-   * Dolby Vision RPU file URL (for DV metadata injection).
+   * Dolby Vision RPU file URL. Only accepted with a `dolby_vision_*` format,
+   * which is refused at create until the worker produces Dolby Vision output,
+   * so this field is currently unreachable.
    *
    * @generated from field: optional string rpu_url = 7;
    */
@@ -9052,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;
    */
@@ -9104,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;
    */
@@ -9126,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;
    */
@@ -12070,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;
    */
@@ -12079,6 +12106,10 @@ var OutputSpec = class _OutputSpec extends protobuf.Message {
    * Encoding mode: "fixed" (default, static CRF) or "auto" (input-aware constrained CRF).
    * In "auto" mode, the worker caps each variant's bitrate based on the input's bitrate
    * and resolution ratio, preventing output from exceeding the input's quality ceiling.
+   * "auto" also skips any ABR rung larger than the source instead of upscaling it.
+   * A skipped rung is reported with status "skipped" and is not billed.
+   * Outputs created since 2026-10-27 echo the resolved mode on responses (unset
+   * resolves to "fixed"). Outputs created before then omit it: their mode was not stored.
    *
    * @generated from field: optional string encoding_mode = 14;
    */
@@ -12387,7 +12418,10 @@ var VariantPricingSnapshot = class _VariantPricingSnapshot extends protobuf.Mess
    */
   actualCost;
   /**
-   * Variant encoding status: "pending", "processing", "completed", "failed".
+   * Variant encoding status: "pending", "processing", "completed", "failed",
+   * "canceled", or "skipped". A rung is "skipped" when `encoding_mode: auto`
+   * left it unencoded because it would have upscaled the source. A skipped
+   * rung has actual_cost 0 and is not billed.
    *
    * @generated from field: string status = 20;
    */
@@ -17326,6 +17360,13 @@ var UsageSummary = class _UsageSummary extends protobuf.Message {
    */
   storageGbAvg = 0;
   /**
+   * Storage cost of the period so far, as your invoice will carry it. Each
+   * day is one GB-day: the day's stored bytes at the day's monthly price
+   * divided by the days in that month. Days already billed are reported at
+   * the rate they were billed at, so a later price or rate-card change never
+   * re-prices them; the remaining days (see hosting_estimated_from) are
+   * estimated the same way at your current rate.
+   *
    * @generated from field: double storage_cost = 11;
    */
   storageCost = 0;
@@ -17340,6 +17381,10 @@ var UsageSummary = class _UsageSummary extends protobuf.Message {
    */
   egressGb = 0;
   /**
+   * Delivery cost of the period so far, as your invoice will carry it:
+   * billed delivery at the rate it was billed at, delivery not billed yet
+   * estimated at your current rate.
+   *
    * @generated from field: double egress_cost = 21;
    */
   egressCost = 0;
@@ -17359,6 +17404,18 @@ var UsageSummary = class _UsageSummary extends protobuf.Message {
    * @generated from field: string currency = 31;
    */
   currency = "";
+  /**
+   * First day (YYYY-MM-DD, UTC) whose storage or delivery cost is an
+   * estimate rather than billed usage. Hosting is billed daily, through the
+   * previous day, so while you store or deliver video the current period has
+   * an estimated tail, and the estimate turns into the billed amount as each
+   * day is billed. Empty when no day with hosting usage in the period is
+   * still unbilled, which is when storage_cost and egress_cost match your
+   * invoice (to within the sub-cent remainder carried to the next charge).
+   *
+   * @generated from field: string hosting_estimated_from = 32;
+   */
+  hostingEstimatedFrom = "";
   /**
    * Per-day usage breakdown for the billing period identified by
    * billing_month, oldest day first. With a billing anchor day other than 1,
@@ -17463,6 +17520,13 @@ var UsageSummary = class _UsageSummary extends protobuf.Message {
       T: 9
       /* ScalarType.STRING */
     },
+    {
+      no: 32,
+      name: "hosting_estimated_from",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
     { no: 40, name: "daily", kind: "message", T: DailyUsage, repeated: true }
   ]);
   static fromBinary(bytes, options) {
@@ -20301,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;
@@ -20401,7 +20465,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.14";
+var SDK_VERSION = "0.3.16";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";
 
@@ -25226,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 = {
@@ -25257,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 {