@transcodely/sdk 0.3.3 → 0.3.5

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.5](https://github.com/transcodely/transcodely-js/compare/v0.3.4...v0.3.5) (2026-08-08)
+
+
+### Features
+
+* job cost breakdown + video_id from api 4.9.0 ([#46](https://github.com/transcodely/transcodely-js/issues/46)) ([efe79e2](https://github.com/transcodely/transcodely-js/commit/efe79e24e0e7115d591722a303e2bd3986ceeeae))
+
+## [0.3.4](https://github.com/transcodely/transcodely-js/compare/v0.3.3...v0.3.4) (2026-08-02)
+
+
+### Features
+
+* **client:** auto_captions on video uploads + captions_cost on Video ([dfaa6c8](https://github.com/transcodely/transcodely-js/commit/dfaa6c876fc236c7c3565ebe1f5140d865e8b00d))
+
 ## [0.3.3](https://github.com/transcodely/transcodely-js/compare/v0.3.2...v0.3.3) (2026-08-02)
 
 

package/dist/index.cjs

@@ -9065,6 +9065,21 @@ protobuf.proto3.util.setEnumType(WatchEventType, "transcodely.v1.WatchEventType"
   { no: 4, name: "WATCH_EVENT_TYPE_COMPLETED" },
   { no: 5, name: "WATCH_EVENT_TYPE_HEARTBEAT" }
 ]);
+var JobCostLineType = /* @__PURE__ */ ((JobCostLineType2) => {
+  JobCostLineType2[JobCostLineType2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+  JobCostLineType2[JobCostLineType2["OUTPUT"] = 1] = "OUTPUT";
+  JobCostLineType2[JobCostLineType2["MINIMUM_CHARGE"] = 2] = "MINIMUM_CHARGE";
+  JobCostLineType2[JobCostLineType2["FEE"] = 3] = "FEE";
+  JobCostLineType2[JobCostLineType2["ADJUSTMENT"] = 4] = "ADJUSTMENT";
+  return JobCostLineType2;
+})(JobCostLineType || {});
+protobuf.proto3.util.setEnumType(JobCostLineType, "transcodely.v1.JobCostLineType", [
+  { no: 0, name: "JOB_COST_LINE_TYPE_UNSPECIFIED" },
+  { no: 1, name: "JOB_COST_LINE_TYPE_OUTPUT" },
+  { no: 2, name: "JOB_COST_LINE_TYPE_MINIMUM_CHARGE" },
+  { no: 3, name: "JOB_COST_LINE_TYPE_FEE" },
+  { no: 4, name: "JOB_COST_LINE_TYPE_ADJUSTMENT" }
+]);
 var AudioTrackConfig = class _AudioTrackConfig extends protobuf.Message {
   /**
    * ISO 639-2 language code (e.g., "eng", "spa", "jpn", "fra").
@@ -10716,6 +10731,26 @@ var Job = class _Job extends protobuf.Message {
    * @generated from field: optional transcodely.v1.ClipConfig clip = 36;
    */
   clip;
+  /**
+   * Hosted video this job's managed output belongs to ("vid_..."). Set when
+   * the job writes to Transcodely-managed hosting storage (created with
+   * managed=true, or with input_video_id targeting an existing video); absent
+   * for jobs delivering to your own origin. Server-set; read-only.
+   *
+   * @generated from field: optional string video_id = 37;
+   */
+  videoId;
+  /**
+   * Itemized decomposition of total_estimated_cost and total_actual_cost:
+   * one line per output, one per fee, and the minimum-charge top-up when the
+   * per-job minimum raised a total. The lines always sum to the totals, so
+   * this is the field to render a cost from — the per-output cost fields
+   * alone do not add up to the bill whenever the minimum charge is in effect.
+   * Always present. Server-set; read-only.
+   *
+   * @generated from field: transcodely.v1.JobCostBreakdown cost_breakdown = 38;
+   */
+  costBreakdown;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -10816,7 +10851,9 @@ var Job = class _Job extends protobuf.Message {
       /* ScalarType.STRING */
     },
     { no: 35, name: "chapter_results", kind: "message", T: ChapterResult, repeated: true },
-    { no: 36, name: "clip", kind: "message", T: ClipConfig, opt: true }
+    { no: 36, name: "clip", kind: "message", T: ClipConfig, opt: true },
+    { no: 37, name: "video_id", kind: "scalar", T: 9, opt: true },
+    { no: 38, name: "cost_breakdown", kind: "message", T: JobCostBreakdown }
   ]);
   static fromBinary(bytes, options) {
     return new _Job().fromBinary(bytes, options);
@@ -10878,6 +10915,13 @@ var JobFee = class _JobFee extends protobuf.Message {
    * @generated from field: string currency = 7;
    */
   currency = "";
+  /**
+   * Fee id ("fee_..."). This is what a cost-breakdown fee line's
+   * `reference_id` points at (see JobCostBreakdown).
+   *
+   * @generated from field: string id = 8;
+   */
+  id = "";
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -10933,6 +10977,13 @@ var JobFee = class _JobFee extends protobuf.Message {
       kind: "scalar",
       T: 9
       /* ScalarType.STRING */
+    },
+    {
+      no: 8,
+      name: "id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
     }
   ]);
   static fromBinary(bytes, options) {
@@ -10948,6 +10999,137 @@ var JobFee = class _JobFee extends protobuf.Message {
     return protobuf.proto3.util.equals(_JobFee, a, b);
   }
 };
+var JobCostLine = class _JobCostLine extends protobuf.Message {
+  /**
+   * What kind of charge this line is: output, minimum_charge, fee or
+   * adjustment.
+   *
+   * @generated from field: transcodely.v1.JobCostLineType type = 1;
+   */
+  type = 0 /* UNSPECIFIED */;
+  /**
+   * The thing the line is for: an output id ("out_...") on output lines, a
+   * fee id ("fee_...") on fee lines. Empty on the minimum-charge and
+   * adjustment lines, which belong to the job as a whole rather than to any
+   * one part of it.
+   *
+   * @generated from field: string reference_id = 2;
+   */
+  referenceId = "";
+  /**
+   * Human-readable label: "1080p h264 hls", "Minimum job charge",
+   * "AI Caption Generation". Wording is documentation, not API surface, and
+   * may be reworded in any release — key off `type` and `reference_id`.
+   *
+   * @generated from field: string description = 3;
+   */
+  description = "";
+  /**
+   * What this line contributed to total_estimated_cost. Absent until the
+   * input probe supplies a duration.
+   *
+   * @generated from field: optional double estimated_amount_eur = 4;
+   */
+  estimatedAmountEur;
+  /**
+   * What this line contributed to total_actual_cost. Absent until the job
+   * settles; 0 for a line that settled at no charge (a failed job's outputs,
+   * a fee whose artifact was never produced). Absent and zero are different
+   * answers: one is "not known yet", the other is "free".
+   *
+   * Negative only on an adjustment line.
+   *
+   * @generated from field: optional double actual_amount_eur = 5;
+   */
+  actualAmountEur;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.JobCostLine";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    { no: 1, name: "type", kind: "enum", T: protobuf.proto3.getEnumType(JobCostLineType) },
+    {
+      no: 2,
+      name: "reference_id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 3,
+      name: "description",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 4, name: "estimated_amount_eur", kind: "scalar", T: 1, opt: true },
+    { no: 5, name: "actual_amount_eur", kind: "scalar", T: 1, opt: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _JobCostLine().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _JobCostLine().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _JobCostLine().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_JobCostLine, a, b);
+  }
+};
+var JobCostBreakdown = class _JobCostBreakdown extends protobuf.Message {
+  /**
+   * Lines in reading order: outputs, then fees, then the minimum charge, then
+   * the adjustment.
+   *
+   * @generated from field: repeated transcodely.v1.JobCostLine lines = 1;
+   */
+  lines = [];
+  /**
+   * The totals the lines explain. Same values as Job.total_estimated_cost /
+   * Job.total_actual_cost, repeated here so a breakdown can be verified
+   * without carrying the job around.
+   *
+   * One deliberate difference: a failed job reports total_actual_cost as 0
+   * here even in the rare case where no total was ever written for it (a job
+   * the control plane failed after its worker vanished). A failed job bills
+   * nothing, and "unknown" would be a worse answer than the one the policy
+   * already guarantees.
+   *
+   * @generated from field: optional double total_estimated_cost = 2;
+   */
+  totalEstimatedCost;
+  /**
+   * @generated from field: optional double total_actual_cost = 3;
+   */
+  totalActualCost;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.JobCostBreakdown";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    { no: 1, name: "lines", kind: "message", T: JobCostLine, repeated: true },
+    { no: 2, name: "total_estimated_cost", kind: "scalar", T: 1, opt: true },
+    { no: 3, name: "total_actual_cost", kind: "scalar", T: 1, opt: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _JobCostBreakdown().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _JobCostBreakdown().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _JobCostBreakdown().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_JobCostBreakdown, a, b);
+  }
+};
 var ClipConfig = class _ClipConfig extends protobuf.Message {
   /**
    * Where the clip starts, in seconds from the beginning of the input.
@@ -11812,6 +11994,19 @@ var Video = class _Video extends protobuf.Message {
    * @generated from field: optional double encoding_cost = 31;
    */
   encodingCost;
+  /**
+   * Sum of confirmed AI-caption fees, in EUR, across all of this video's jobs
+   * — captions generated inline with the transcode (the auto_captions upload
+   * flag) and retro captions-only jobs that used this video as their input
+   * (input_video_id). Absent until a captions fee is confirmed; fees are
+   * confirmed only when a caption artifact is actually delivered, so voided
+   * and still-estimated fees are never counted. This is a per-feature
+   * breakdown of already-billed job totals, not an extra charge on top of
+   * them.
+   *
+   * @generated from field: optional double captions_cost = 50;
+   */
+  captionsCost;
   /**
    * Timestamps.
    *
@@ -11925,6 +12120,7 @@ var Video = class _Video extends protobuf.Message {
       /* ScalarType.INT64 */
     },
     { no: 31, name: "encoding_cost", kind: "scalar", T: 1, opt: true },
+    { no: 50, name: "captions_cost", kind: "scalar", T: 1, opt: true },
     { no: 40, name: "created_at", kind: "message", T: protobuf.Timestamp },
     { no: 41, name: "updated_at", kind: "message", T: protobuf.Timestamp },
     { no: 42, name: "ready_at", kind: "message", T: protobuf.Timestamp, opt: true },
@@ -12282,6 +12478,19 @@ var CreateUploadRequest = class _CreateUploadRequest extends protobuf.Message {
    * @generated from field: bool hover_previews = 10;
    */
   hoverPreviews = false;
+  /**
+   * When true, generate AI captions inline with the transcode: the managed
+   * job's output carries a "generate" subtitle track (language auto-detected,
+   * WebVTT), produced by the same job — and on the same worker — as the
+   * encode, and listed in the video's streaming manifest so players discover
+   * it natively. Billed as the per-source-minute captions fee on that job;
+   * the fee is only charged when a caption track is actually delivered. The
+   * track surfaces as Video.text_tracks once ready. Unset or false = no
+   * captions.
+   *
+   * @generated from field: optional bool auto_captions = 11;
+   */
+  autoCaptions;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -12328,7 +12537,8 @@ var CreateUploadRequest = class _CreateUploadRequest extends protobuf.Message {
       kind: "scalar",
       T: 8
       /* ScalarType.BOOL */
-    }
+    },
+    { no: 11, name: "auto_captions", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreateUploadRequest().fromBinary(bytes, options);
@@ -12515,6 +12725,19 @@ var CreateFromUrlRequest = class _CreateFromUrlRequest extends protobuf.Message
    * @generated from field: bool hover_previews = 8;
    */
   hoverPreviews = false;
+  /**
+   * When true, generate AI captions inline with the transcode: the managed
+   * job's output carries a "generate" subtitle track (language auto-detected,
+   * WebVTT), produced by the same job — and on the same worker — as the
+   * encode, and listed in the video's streaming manifest so players discover
+   * it natively. Billed as the per-source-minute captions fee on that job;
+   * the fee is only charged when a caption track is actually delivered. The
+   * track surfaces as Video.text_tracks once ready. Unset or false = no
+   * captions.
+   *
+   * @generated from field: optional bool auto_captions = 9;
+   */
+  autoCaptions;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -12547,7 +12770,8 @@ var CreateFromUrlRequest = class _CreateFromUrlRequest extends protobuf.Message
       kind: "scalar",
       T: 8
       /* ScalarType.BOOL */
-    }
+    },
+    { no: 9, name: "auto_captions", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreateFromUrlRequest().fromBinary(bytes, options);
@@ -12767,6 +12991,19 @@ var CreateMultipartUploadRequest = class _CreateMultipartUploadRequest extends p
    * @generated from field: bool hover_previews = 15;
    */
   hoverPreviews = false;
+  /**
+   * When true, generate AI captions inline with the transcode: the managed
+   * job's output carries a "generate" subtitle track (language auto-detected,
+   * WebVTT), produced by the same job — and on the same worker — as the
+   * encode, and listed in the video's streaming manifest so players discover
+   * it natively. Billed as the per-source-minute captions fee on that job;
+   * the fee is only charged when a caption track is actually delivered. The
+   * track surfaces as Video.text_tracks once ready. Unset or false = no
+   * captions.
+   *
+   * @generated from field: optional bool auto_captions = 16;
+   */
+  autoCaptions;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -12821,7 +13058,8 @@ var CreateMultipartUploadRequest = class _CreateMultipartUploadRequest extends p
       kind: "scalar",
       T: 8
       /* ScalarType.BOOL */
-    }
+    },
+    { no: 16, name: "auto_captions", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreateMultipartUploadRequest().fromBinary(bytes, options);
@@ -14750,7 +14988,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.3";
+var SDK_VERSION = "0.3.5";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";
 
@@ -19407,6 +19645,7 @@ exports.HLSSegmentFormat = HLSSegmentFormat;
 exports.InvalidRequestError = InvalidRequestError;
 exports.InvoiceLineType = InvoiceLineType;
 exports.InvoiceStatus = InvoiceStatus;
+exports.JobCostLineType = JobCostLineType;
 exports.JobPriority = JobPriority;
 exports.JobStatus = JobStatus;
 exports.MembershipRole = MembershipRole;