@transcodely/sdk 0.3.8 → 0.3.10

package/CHANGELOG.md

@@ -4,6 +4,20 @@ 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.10](https://github.com/transcodely/transcodely-js/compare/v0.3.9...v0.3.10) (2026-09-22)
+
+
+### Features
+
+* **proto:** per-title search curve — seed_crf, met_target, probes (api 5.23.0) ([#74](https://github.com/transcodely/transcodely-js/issues/74)) ([62deaf2](https://github.com/transcodely/transcodely-js/commit/62deaf2d94fd01af0982a93f5de8d85da04a87a3))
+
+## [0.3.9](https://github.com/transcodely/transcodely-js/compare/v0.3.8...v0.3.9) (2026-09-15)
+
+
+### Bug Fixes
+
+* **cli:** publish the CLI — drop private, pin @transcodely/sdk ^0.3.8 ([#71](https://github.com/transcodely/transcodely-js/issues/71)) ([7f2957a](https://github.com/transcodely/transcodely-js/commit/7f2957a1c9e94da97f32347f2143d618d8ee2e6f))
+
 ## [0.3.8](https://github.com/transcodely/transcodely-js/compare/v0.3.7...v0.3.8) (2026-09-15)
 
 

package/README.md

@@ -175,6 +175,19 @@ on its samples, and the CRF it chose. It describes the SEARCH, not the delivered
 file — `vmafAchieved` scores short samples taken before the real encode, which is
 never scored itself. It is `undefined` on every ordinary output.
 
+It also carries the whole curve the search measured: `seedCrf` (the CRF the
+rung would have used without per-title — compare it with `crfChosen` to see
+what changed), `metTarget` (whether the search reached `vmafTarget`; `false`
+means `crfChosen` is only the best-scoring point it measured), and `probes[]`
+(`OutputReportContentAwareProbe[]`, one entry per sample the search measured,
+in order — each with `crf`, `vmaf`, and `bitrateKbps`). Two probes' bitrates
+compare directly since every sample is the same cut of the source, so the
+ratio between the `seedCrf` probe and the `crfChosen` probe is the honest
+per-title saving on that sample. `bitrateKbps` is the sample's VIDEO-ONLY
+bitrate — the search's cuts drop audio, subtitles and data — so don't compare
+it to a delivered output's muxed `averageBitrateKbps`. All three fields are
+`undefined`/empty on reports from workers older than 1.29.0.
+
 ## AI captions
 
 Add auto-generated captions to any output with a `generate` subtitle track.

package/dist/index.cjs

@@ -11932,6 +11932,32 @@ var OutputReportContentAware = class _OutputReportContentAware extends protobuf.
    * @generated from field: optional int32 crf_chosen = 4;
    */
   crfChosen;
+  /**
+   * Constant-rate-factor the rung would have used WITHOUT the search: the
+   * quality tier's static value, and the first point the search measured.
+   * Compare it with crf_chosen to see what per-title changed. Absent when the
+   * search did not report where it started.
+   *
+   * @generated from field: optional int32 seed_crf = 5;
+   */
+  seedCrf;
+  /**
+   * Whether the search found a setting that reached vmaf_target. When false,
+   * crf_chosen is the best-scoring setting it measured, and vmaf_achieved is
+   * below the target.
+   *
+   * @generated from field: optional bool met_target = 6;
+   */
+  metTarget;
+  /**
+   * Every sample the search measured, in the order it measured them. Each is
+   * a short cut of the source encoded at one CRF with this rung's delivery
+   * settings and scored against the original. Empty when the analysis did not
+   * report its probes (workers before 1.29.0).
+   *
+   * @generated from field: repeated transcodely.v1.OutputReportContentAwareProbe probes = 7;
+   */
+  probes = [];
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -11948,7 +11974,10 @@ var OutputReportContentAware = class _OutputReportContentAware extends protobuf.
     },
     { no: 2, name: "vmaf_target", kind: "scalar", T: 1, opt: true },
     { no: 3, name: "vmaf_achieved", kind: "scalar", T: 1, opt: true },
-    { no: 4, name: "crf_chosen", kind: "scalar", T: 5, opt: true }
+    { no: 4, name: "crf_chosen", kind: "scalar", T: 5, opt: true },
+    { no: 5, name: "seed_crf", kind: "scalar", T: 5, opt: true },
+    { no: 6, name: "met_target", kind: "scalar", T: 8, opt: true },
+    { no: 7, name: "probes", kind: "message", T: OutputReportContentAwareProbe, repeated: true }
   ]);
   static fromBinary(bytes, options) {
     return new _OutputReportContentAware().fromBinary(bytes, options);
@@ -11963,6 +11992,70 @@ var OutputReportContentAware = class _OutputReportContentAware extends protobuf.
     return protobuf.proto3.util.equals(_OutputReportContentAware, a, b);
   }
 };
+var OutputReportContentAwareProbe = class _OutputReportContentAwareProbe extends protobuf.Message {
+  /**
+   * CRF the sample was encoded at.
+   *
+   * @generated from field: int32 crf = 1;
+   */
+  crf = 0;
+  /**
+   * VMAF the sample scored, 0-100.
+   *
+   * @generated from field: double vmaf = 2;
+   */
+  vmaf = 0;
+  /**
+   * Bitrate of the encoded sample in kilobits per second. Two probes' bitrates
+   * compare directly because every sample is the same cut of the source; the
+   * ratio between the seed_crf probe and the crf_chosen probe is the size
+   * change per-title made on that sample. Absent when the encoder did not
+   * report the sample's size.
+   *
+   * The sample is encoded VIDEO-ONLY — the search's cuts drop audio, subtitles
+   * and data streams — so this is the sample's video bitrate, not the rate of a
+   * muxed file. Comparing it against a delivered file's bitrate, which includes
+   * every stream that file carries, compares two different things.
+   *
+   * @generated from field: optional double bitrate_kbps = 3;
+   */
+  bitrateKbps;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.OutputReportContentAwareProbe";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    {
+      no: 1,
+      name: "crf",
+      kind: "scalar",
+      T: 5
+      /* ScalarType.INT32 */
+    },
+    {
+      no: 2,
+      name: "vmaf",
+      kind: "scalar",
+      T: 1
+      /* ScalarType.DOUBLE */
+    },
+    { no: 3, name: "bitrate_kbps", kind: "scalar", T: 1, opt: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _OutputReportContentAwareProbe().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _OutputReportContentAwareProbe().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _OutputReportContentAwareProbe().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_OutputReportContentAwareProbe, a, b);
+  }
+};
 var OutputReportVideo = class _OutputReportVideo extends protobuf.Message {
   /**
    * Codec the stream is encoded with, lowercase, e.g. "h264", "hevc", "vp9",
@@ -18992,7 +19085,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.8";
+var SDK_VERSION = "0.3.10";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";