@transcodely/sdk 0.3.13 → 0.3.15

package/CHANGELOG.md

@@ -4,6 +4,21 @@ 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.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)
+
+
+### Features
+
+* rate cards — GetPricing (your effective prices) and resynced protos ([b9554f3](https://github.com/transcodely/transcodely-js/commit/b9554f31612b8080e51de75f055c061fa1f661ac))
+* sync protos for rate cards; add getPricing ([e7d5591](https://github.com/transcodely/transcodely-js/commit/e7d5591eff446ccb70c3f32207f17a74ca3f2ac0))
+
 ## [0.3.13](https://github.com/transcodely/transcodely-js/compare/v0.3.12...v0.3.13) (2026-10-26)
 
 

package/README.md

@@ -313,7 +313,7 @@ client.videos          // upload RPCs, multipart, createFromUrl, get / list / up
 client.presets         // create / get / getBySlug / list / update / duplicate / archive
 client.origins         // create / get / list / update / validate / archive
 client.ingestRules     // create / get / list / update / delete / listEvents / test / replayEvent
-client.apps            // create / get / list / update / archive / enableHosting
+client.apps            // create / get / list / update / archive / enableHosting / getSpend / getPricing
 client.apiKeys         // create / get / list / revoke
 client.organizations   // create / get / list / update / checkSlug
 client.memberships     // list / get / updateRole / remove
@@ -335,6 +335,26 @@ for (const component of health.components) {
 }
 ```
 
+## Your prices
+
+`client.apps.getPricing()` lists every chargeable item with the EUR rate your app
+pays, whether your account has a custom rate for it, and the public list price.
+Omit the app id to price the API key's own app.
+
+```ts
+const pricing = await client.apps.getPricing();
+for (const entry of pricing.entries) {
+  if (entry.basePrice !== undefined) {
+    console.log(`${entry.groupLabel} / ${entry.label}: ${entry.basePrice} ${pricing.currency} (${entry.unit})`, entry.custom ? "custom" : "");
+  }
+  if (entry.multiplier !== undefined) {
+    console.log(`${entry.groupLabel} / ${entry.label}: x${entry.multiplier}`, entry.custom ? "custom" : "");
+  }
+}
+```
+
+Prices are fixed when a job is created, so a price change applies to jobs created after it.
+
 ## Origins
 
 An origin tells Transcodely where to read source media from and where to write outputs. Every origin belongs to a single provider; pass exactly one provider-config field (`s3`, `gcs`, `http`, or `r2`) on create.

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;
    */
@@ -2228,6 +2229,228 @@ var GetSpendResponse = class _GetSpendResponse extends protobuf.Message {
     return protobuf.proto3.util.equals(_GetSpendResponse, a, b);
   }
 };
+var GetPricingRequest = class _GetPricingRequest extends protobuf.Message {
+  /**
+   * App ID. API-key callers may omit it or pass their own app; a different app
+   * is rejected with PermissionDenied. Dashboard callers pass it to pick an app
+   * in their organization; omitted selects the organization's first active
+   * app in list order (the same default every app-scoped read uses).
+   *
+   * @generated from field: optional string app_id = 1;
+   */
+  appId;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.GetPricingRequest";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    { no: 1, name: "app_id", kind: "scalar", T: 9, opt: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _GetPricingRequest().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _GetPricingRequest().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _GetPricingRequest().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_GetPricingRequest, a, b);
+  }
+};
+var PricingEntry = class _PricingEntry extends protobuf.Message {
+  /**
+   * Charge class: codec, resolution, quality, feature, fee, storage, egress.
+   * Other values may appear as new charges are introduced.
+   *
+   * @generated from field: string rule_type = 1;
+   */
+  ruleType = "";
+  /**
+   * Charge within its class, e.g. h264, 1080p, captions, processing_m.
+   *
+   * @generated from field: string rule_key = 2;
+   */
+  ruleKey = "";
+  /**
+   * Human label, e.g. "H.264".
+   *
+   * @generated from field: string label = 3;
+   */
+  label = "";
+  /**
+   * Human label of the class, e.g. "Encoding".
+   *
+   * @generated from field: string group_label = 4;
+   */
+  groupLabel = "";
+  /**
+   * What base_price is per: eur_per_output_minute, eur_per_source_minute,
+   * eur_per_video, eur_per_job, eur_per_gb_month, eur_per_gb, or eur_per_unit
+   * for a charge whose unit is not known yet. Empty for a charge that has only
+   * a multiplier.
+   *
+   * @generated from field: string unit = 5;
+   */
+  unit = "";
+  /**
+   * The price per unit, in EUR, this app pays. Absent for a charge that has
+   * only a multiplier.
+   *
+   * @generated from field: optional double base_price = 6;
+   */
+  basePrice;
+  /**
+   * The multiplier this app pays. Absent for a charge that has only a per-unit
+   * price.
+   *
+   * @generated from field: optional double multiplier = 7;
+   */
+  multiplier;
+  /**
+   * True when this account has a custom rate for this charge, so base_price or
+   * multiplier differs from the list price.
+   *
+   * @generated from field: bool custom = 8;
+   */
+  custom = false;
+  /**
+   * The public list price per unit, in EUR. Absent when base_price is.
+   *
+   * @generated from field: optional double list_base_price = 9;
+   */
+  listBasePrice;
+  /**
+   * The public list multiplier. Absent when multiplier is.
+   *
+   * @generated from field: optional double list_multiplier = 10;
+   */
+  listMultiplier;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.PricingEntry";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    {
+      no: 1,
+      name: "rule_type",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 2,
+      name: "rule_key",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 3,
+      name: "label",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 4,
+      name: "group_label",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 5,
+      name: "unit",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 6, name: "base_price", kind: "scalar", T: 1, opt: true },
+    { no: 7, name: "multiplier", kind: "scalar", T: 1, opt: true },
+    {
+      no: 8,
+      name: "custom",
+      kind: "scalar",
+      T: 8
+      /* ScalarType.BOOL */
+    },
+    { no: 9, name: "list_base_price", kind: "scalar", T: 1, opt: true },
+    { no: 10, name: "list_multiplier", kind: "scalar", T: 1, opt: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _PricingEntry().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _PricingEntry().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _PricingEntry().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_PricingEntry, a, b);
+  }
+};
+var GetPricingResponse = class _GetPricingResponse extends protobuf.Message {
+  /**
+   * The app these prices are for.
+   *
+   * @generated from field: string app_id = 1;
+   */
+  appId = "";
+  /**
+   * Currency of every price. Always "EUR".
+   *
+   * @generated from field: string currency = 2;
+   */
+  currency = "";
+  /**
+   * Every chargeable item, grouped by class in display order.
+   *
+   * @generated from field: repeated transcodely.v1.PricingEntry entries = 3;
+   */
+  entries = [];
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.GetPricingResponse";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    {
+      no: 1,
+      name: "app_id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 2,
+      name: "currency",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 3, name: "entries", kind: "message", T: PricingEntry, repeated: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _GetPricingResponse().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _GetPricingResponse().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _GetPricingResponse().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_GetPricingResponse, a, b);
+  }
+};
 var AppService = {
   typeName: "transcodely.v1.AppService",
   methods: {
@@ -2350,6 +2573,18 @@ var AppService = {
       I: GetSpendRequest,
       O: GetSpendResponse,
       kind: protobuf.MethodKind.Unary
+    },
+    /**
+     * Get the prices an app pays: every chargeable item with its effective rate,
+     * whether the account has a custom rate for it, and the public list price.
+     *
+     * @generated from rpc transcodely.v1.AppService.GetPricing
+     */
+    getPricing: {
+      name: "GetPricing",
+      I: GetPricingRequest,
+      O: GetPricingResponse,
+      kind: protobuf.MethodKind.Unary
     }
   }
 };
@@ -2474,6 +2709,21 @@ var Apps = class {
       opts
     );
   }
+  /**
+   * Get the prices an app pays: every chargeable item with its effective EUR
+   * rate, whether the account has a custom rate for it (`custom`), and the
+   * public list price. Omit `id` to price the API key's own app (dashboard
+   * callers: the organization's first active app). Prices are fixed when a job is
+   * created, so a price change applies to jobs created after it.
+   */
+  getPricing(id, opts) {
+    return this.transport.unary(
+      AppService,
+      AppService.methods.getPricing,
+      new GetPricingRequest(id ? { appId: id } : {}),
+      opts
+    );
+  }
 };
 var InvoiceStatus = /* @__PURE__ */ ((InvoiceStatus2) => {
   InvoiceStatus2[InvoiceStatus2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
@@ -7055,6 +7305,9 @@ protobuf.proto3.util.setEnumType(ToneMapping, "transcodely.v1.ToneMapping", [
 var HDRConfig = class _HDRConfig extends protobuf.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;
    */
@@ -7093,7 +7346,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;
    */
@@ -11830,6 +12085,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;
    */
@@ -12138,7 +12397,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;
    */
@@ -17077,6 +17339,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;
@@ -17091,6 +17360,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;
@@ -17110,6 +17383,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,
@@ -17214,6 +17499,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) {
@@ -20152,7 +20444,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.13";
+var SDK_VERSION = "0.3.15";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";