@transcodely/sdk 0.3.14 → 0.3.15

package/dist/index.d.cts

@@ -1835,9 +1835,10 @@ declare class AutoProfileDefaults extends Message<AutoProfileDefaults> {
      */
     qualityTier?: string;
     /**
-     * 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;
      */
@@ -5442,13 +5443,17 @@ declare enum HDRFormat {
      */
     HDR_FORMAT_HLG = 3,
     /**
-     * Dolby Vision Profile 5 (single-layer, cross-compatible).
+     * Dolby Vision Profile 5 (single-layer, no HDR10 or SDR compatibility
+     * layer). Not available: refused at create with `parameter_unsupported` on
+     * `hdr.format` until the worker produces Dolby Vision output.
      *
      * @generated from enum value: HDR_FORMAT_DOLBY_VISION_5 = 4;
      */
     HDR_FORMAT_DOLBY_VISION_5 = 4,
     /**
-     * Dolby Vision Profile 8 (MEL, backward-compatible with HDR10).
+     * Dolby Vision Profile 8.1 (single-layer, HDR10-compatible base layer). Not
+     * available: refused at create with `parameter_unsupported` on `hdr.format`
+     * until the worker produces Dolby Vision output.
      *
      * @generated from enum value: HDR_FORMAT_DOLBY_VISION_8 = 5;
      */
@@ -5530,6 +5535,9 @@ declare enum ToneMapping {
 declare class HDRConfig extends Message<HDRConfig> {
     /**
      * Target HDR format (required for passthrough and force modes).
+     * `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;
      */
@@ -5568,7 +5576,9 @@ declare class HDRConfig extends Message<HDRConfig> {
      */
     contentLightLevel?: string;
     /**
-     * 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;
      */
@@ -9531,6 +9541,10 @@ declare class OutputSpec extends Message<OutputSpec> {
      * 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;
      */
@@ -9761,7 +9775,10 @@ declare class VariantPricingSnapshot extends Message<VariantPricingSnapshot> {
      */
     actualCost?: number;
     /**
-     * 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;
      */
@@ -13439,6 +13456,13 @@ declare class UsageSummary extends Message<UsageSummary> {
      */
     storageGbAvg: number;
     /**
+     * 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: number;
@@ -13453,6 +13477,10 @@ declare class UsageSummary extends Message<UsageSummary> {
      */
     egressGb: number;
     /**
+     * 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: number;
@@ -13472,6 +13500,18 @@ declare class UsageSummary extends Message<UsageSummary> {
      * @generated from field: string currency = 31;
      */
     currency: string;
+    /**
+     * 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: string;
     /**
      * Per-day usage breakdown for the billing period identified by
      * billing_month, oldest day first. With a billing anchor day other than 1,
@@ -18005,7 +18045,7 @@ interface SerializeOptions {
 declare function toWireJson<T extends Message<T>>(msg: T, opts?: SerializeOptions): JsonValue;
 
 /** SDK version. Bumped by release-please from package.json on each tag. */
-declare const SDK_VERSION = "0.3.14";
+declare const SDK_VERSION = "0.3.15";
 /**
  * API version this SDK release is pinned to. Sent on every request as
  * `Transcodely-Version`. Customers can override per-client via the

package/dist/index.d.ts

@@ -1835,9 +1835,10 @@ declare class AutoProfileDefaults extends Message<AutoProfileDefaults> {
      */
     qualityTier?: string;
     /**
-     * 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;
      */
@@ -5442,13 +5443,17 @@ declare enum HDRFormat {
      */
     HDR_FORMAT_HLG = 3,
     /**
-     * Dolby Vision Profile 5 (single-layer, cross-compatible).
+     * Dolby Vision Profile 5 (single-layer, no HDR10 or SDR compatibility
+     * layer). Not available: refused at create with `parameter_unsupported` on
+     * `hdr.format` until the worker produces Dolby Vision output.
      *
      * @generated from enum value: HDR_FORMAT_DOLBY_VISION_5 = 4;
      */
     HDR_FORMAT_DOLBY_VISION_5 = 4,
     /**
-     * Dolby Vision Profile 8 (MEL, backward-compatible with HDR10).
+     * Dolby Vision Profile 8.1 (single-layer, HDR10-compatible base layer). Not
+     * available: refused at create with `parameter_unsupported` on `hdr.format`
+     * until the worker produces Dolby Vision output.
      *
      * @generated from enum value: HDR_FORMAT_DOLBY_VISION_8 = 5;
      */
@@ -5530,6 +5535,9 @@ declare enum ToneMapping {
 declare class HDRConfig extends Message<HDRConfig> {
     /**
      * Target HDR format (required for passthrough and force modes).
+     * `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;
      */
@@ -5568,7 +5576,9 @@ declare class HDRConfig extends Message<HDRConfig> {
      */
     contentLightLevel?: string;
     /**
-     * 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;
      */
@@ -9531,6 +9541,10 @@ declare class OutputSpec extends Message<OutputSpec> {
      * 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;
      */
@@ -9761,7 +9775,10 @@ declare class VariantPricingSnapshot extends Message<VariantPricingSnapshot> {
      */
     actualCost?: number;
     /**
-     * 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;
      */
@@ -13439,6 +13456,13 @@ declare class UsageSummary extends Message<UsageSummary> {
      */
     storageGbAvg: number;
     /**
+     * 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: number;
@@ -13453,6 +13477,10 @@ declare class UsageSummary extends Message<UsageSummary> {
      */
     egressGb: number;
     /**
+     * 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: number;
@@ -13472,6 +13500,18 @@ declare class UsageSummary extends Message<UsageSummary> {
      * @generated from field: string currency = 31;
      */
     currency: string;
+    /**
+     * 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: string;
     /**
      * Per-day usage breakdown for the billing period identified by
      * billing_month, oldest day first. With a billing anchor day other than 1,
@@ -18005,7 +18045,7 @@ interface SerializeOptions {
 declare function toWireJson<T extends Message<T>>(msg: T, opts?: SerializeOptions): JsonValue;
 
 /** SDK version. Bumped by release-please from package.json on each tag. */
-declare const SDK_VERSION = "0.3.14";
+declare const SDK_VERSION = "0.3.15";
 /**
  * API version this SDK release is pinned to. Sent on every request as
  * `Transcodely-Version`. Customers can override per-client via the

package/dist/index.mjs

@@ -1916,9 +1916,10 @@ var AutoProfileDefaults = class _AutoProfileDefaults extends 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;
    */
@@ -7302,6 +7303,9 @@ proto3.util.setEnumType(ToneMapping, "transcodely.v1.ToneMapping", [
 var HDRConfig = class _HDRConfig extends Message {
   /**
    * Target HDR format (required for passthrough and force modes).
+   * `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;
    */
@@ -7340,7 +7344,9 @@ var HDRConfig = class _HDRConfig extends 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;
    */
@@ -12077,6 +12083,10 @@ var OutputSpec = class _OutputSpec extends 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;
    */
@@ -12385,7 +12395,10 @@ var VariantPricingSnapshot = class _VariantPricingSnapshot extends Message {
    */
   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;
    */
@@ -17324,6 +17337,13 @@ var UsageSummary = class _UsageSummary extends 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;
@@ -17338,6 +17358,10 @@ var UsageSummary = class _UsageSummary extends 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;
@@ -17357,6 +17381,18 @@ var UsageSummary = class _UsageSummary extends 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,
@@ -17461,6 +17497,13 @@ var UsageSummary = class _UsageSummary extends 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) {
@@ -20399,7 +20442,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.14";
+var SDK_VERSION = "0.3.15";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";