@transcodely/sdk 0.3.11 → 0.3.13

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.13](https://github.com/transcodely/transcodely-js/compare/v0.3.12...v0.3.13) (2026-10-26)
+
+
+### Features
+
+* generate_insights from existing captions (api 5.26.0) ([#82](https://github.com/transcodely/transcodely-js/issues/82)) ([a3b4a8d](https://github.com/transcodely/transcodely-js/commit/a3b4a8da9db11748db6f9b9dd34900fb18b5e2be))
+
+## [0.3.12](https://github.com/transcodely/transcodely-js/compare/v0.3.11...v0.3.12) (2026-10-25)
+
+
+### Features
+
+* auto_insights upload option (api 5.25.0) ([#80](https://github.com/transcodely/transcodely-js/issues/80)) ([fccd526](https://github.com/transcodely/transcodely-js/commit/fccd52644fb83d347be99621ed5de93f40612584))
+
 ## [0.3.11](https://github.com/transcodely/transcodely-js/compare/v0.3.10...v0.3.11) (2026-10-25)
 
 

package/README.md

@@ -64,6 +64,11 @@ comes back already `processing`. Follow it with `client.videos.watch(video.id)`
 until it reaches `ready` (or `error`, or `deleted`), or subscribe to the
 `video.ready` webhook.
 
+Pass `autoCaptions: true` to generate captions inline with the transcode, and
+add `autoInsights: true` to also run AI insights over those captions (requires
+`autoCaptions`; EUR 0.02 per video + EUR 0.005 per source minute on top of
+captions).
+
 **The app does not need managed hosting turned on first.** An app that has never
 hosted anything is provisioned by the create call itself — bucket, managed
 origin and CDN pull zone — which is why a first upload takes a few seconds
@@ -277,6 +282,20 @@ Jobs carry the same data on `job.subtitleResults[i].transcriptRenditions` and
 `job.insights`. The `job.insights.ready` and `job.insights.failed` webhook events
 tell you when an insights pass finishes.
 
+A hosted video that already has AI captions can get insights without
+transcribing again (EUR 0.02 per video + EUR 0.005 per source minute, charged
+only when ready):
+
+```ts
+// `language` is needed only when the video has several AI caption tracks.
+const ins = await client.videos.generateInsights({ id: "vid_a1b2c3d4e5f6g7" });
+console.log(ins.id, ins.status); // ins_..., InsightsStatus.PENDING
+```
+
+The entry also appears on `video.insights`. The `video.insights.ready` and
+`video.insights.failed` webhook events carry the entry itself as a
+`TranscriptInsights` in `event.data`.
+
 ## Authentication
 
 Pass your API key in the constructor:

package/dist/index.cjs

@@ -4428,6 +4428,7 @@ var WebhookEndpoint = class _WebhookEndpoint extends protobuf.Message {
    * "job.insights.failed", "output.created", "output.ready",
    * "output.failed", "output.progress", "video.uploaded", "video.ready",
    * "video.failed", "video.deleted", "video.source_scheduled_for_deletion",
+   * "video.insights.ready", "video.insights.failed",
    * "app.created", "app.updated", "app.spend_limit_warning",
    * "app.spend_limit_exceeded", or "*".
    * Keep in sync with domain.WebhookEventTypes() ("job.updated" does not exist).
@@ -7363,6 +7364,17 @@ protobuf.proto3.util.setEnumType(TranscriptFormat, "transcodely.v1.TranscriptFor
   { no: 2, name: "TRANSCRIPT_FORMAT_TXT" },
   { no: 3, name: "TRANSCRIPT_FORMAT_MD" }
 ]);
+var InsightsSource = /* @__PURE__ */ ((InsightsSource2) => {
+  InsightsSource2[InsightsSource2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+  InsightsSource2[InsightsSource2["JOB"] = 1] = "JOB";
+  InsightsSource2[InsightsSource2["VIDEO"] = 2] = "VIDEO";
+  return InsightsSource2;
+})(InsightsSource || {});
+protobuf.proto3.util.setEnumType(InsightsSource, "transcodely.v1.InsightsSource", [
+  { no: 0, name: "INSIGHTS_SOURCE_UNSPECIFIED" },
+  { no: 1, name: "INSIGHTS_SOURCE_JOB" },
+  { no: 2, name: "INSIGHTS_SOURCE_VIDEO" }
+]);
 var InsightsStatus = /* @__PURE__ */ ((InsightsStatus2) => {
   InsightsStatus2[InsightsStatus2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
   InsightsStatus2[InsightsStatus2["PENDING"] = 1] = "PENDING";
@@ -8255,7 +8267,8 @@ var InsightsHighlight = class _InsightsHighlight extends protobuf.Message {
 };
 var TranscriptInsights = class _TranscriptInsights extends protobuf.Message {
   /**
-   * The out_… output the generate track was configured on.
+   * The out_… output the generate track was configured on. Empty for source
+   * "video".
    *
    * @generated from field: string output_id = 1;
    */
@@ -8400,6 +8413,38 @@ var TranscriptInsights = class _TranscriptInsights extends protobuf.Message {
    * @generated from field: string hint = 23;
    */
   hint = "";
+  /**
+   * Unique identifier of this insights entry (ins_…).
+   *
+   * @generated from field: string id = 24;
+   */
+  id = "";
+  /**
+   * job | video: requested on a captions job, or on a hosted video's existing
+   * captions with VideoService.GenerateInsights.
+   *
+   * @generated from field: transcodely.v1.InsightsSource source = 25;
+   */
+  source = 0 /* UNSPECIFIED */;
+  /**
+   * The hosted video (vid_…) the insights belong to, for source "video".
+   * Empty for source "job" (see Video.insights for a hosted video's
+   * job-sourced insights).
+   *
+   * @generated from field: string video_id = 26;
+   */
+  videoId = "";
+  /**
+   * Price of this entry in EUR, for source "video": EUR 0.02 per video plus
+   * EUR 0.005 per minute of source, fixed when the entry was created. Charged
+   * only when status becomes "ready"; nothing is charged when it fails. An
+   * entry that becomes "ready" after a newer entry for the same language was
+   * already shown on the video is not charged either, and shows 0.
+   * Absent for source "job", whose insights fees are listed on Job.fees.
+   *
+   * @generated from field: optional double fee_eur = 27;
+   */
+  feeEur;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -8495,7 +8540,23 @@ var TranscriptInsights = class _TranscriptInsights extends protobuf.Message {
       kind: "scalar",
       T: 9
       /* ScalarType.STRING */
-    }
+    },
+    {
+      no: 24,
+      name: "id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 25, name: "source", kind: "enum", T: protobuf.proto3.getEnumType(InsightsSource) },
+    {
+      no: 26,
+      name: "video_id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 27, name: "fee_eur", kind: "scalar", T: 1, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _TranscriptInsights().fromBinary(bytes, options);
@@ -14306,7 +14367,8 @@ var CreateJobRequest = class _CreateJobRequest extends protobuf.Message {
    * Optional target app. API-key callers may omit it (their key's app is used)
    * or pass their own app; a different app is rejected with PermissionDenied.
    * Portal/JWT callers pass it to create in a specific app in their org;
-   * omitted selects the org's first active app.
+   * omitted selects the org's first active app, or, when input_video_id
+   * names a video in the org, that video's app.
    *
    * @generated from field: optional string app_id = 21;
    */
@@ -14979,9 +15041,14 @@ var Video = class _Video extends protobuf.Message {
   textTracks = [];
   /**
    * AI insights for this video, one per transcript language, from the
-   * captions job that requested them (SubtitleTrack.insights). Each moves
-   * from "pending" to "ready" or "failed". Signed URLs are computed per
-   * request under the same rules as text track URLs and are never stored.
+   * captions job that requested them (SubtitleTrack.insights) or from
+   * GenerateInsights. Each moves from "pending" to "ready" or "failed". A
+   * GenerateInsights entry still pending for a language that already has
+   * ready insights is listed first, ahead of the ready entry it will replace.
+   * If that entry fails, the ready insights stay and the failed entry is no
+   * longer listed; video.insights.failed reports it.
+   * Signed URLs are computed per request under the same rules as text track
+   * URLs and are never stored.
    *
    * @generated from field: repeated transcodely.v1.TranscriptInsights insights = 53;
    */
@@ -15024,12 +15091,13 @@ var Video = class _Video extends protobuf.Message {
   /**
    * Everything this video has cost, in EUR: the sum of the settled totals of
    * every job billed for it — the transcode that produced it plus any later
-   * job that took it as input (retro captions, for example).
+   * job that took it as input (retro captions, for example) — plus the fee of
+   * every ready GenerateInsights entry (TranscriptInsights.fee_eur).
    *
    * This is the authoritative per-video figure and the one to display. It is
-   * built from the same job totals the billing ledger is written from, so it
+   * built from the same amounts the billing ledger is written from, so it
    * reconciles with the invoice; captions_cost is a breakdown inside it.
-   * Absent while no linked job has settled yet.
+   * Absent while nothing linked to the video has been billed yet.
    *
    * @generated from field: optional double total_cost = 52;
    */
@@ -15552,6 +15620,22 @@ var CreateUploadRequest = class _CreateUploadRequest extends protobuf.Message {
    * @generated from field: optional bool auto_captions = 11;
    */
   autoCaptions;
+  /**
+   * When true, also run AI insights over the inline captions: title
+   * suggestions, a summary, key points, chapters, questions the content
+   * answers, key terms, quotable highlights and topics (the generate track
+   * carries insights.enabled = true; see SubtitleTrack.insights). Requires
+   * auto_captions = true; rejected otherwise with `invalid_argument`, error
+   * code `parameter_incompatible` on auto_insights. Billed as the
+   * `insights_job` (EUR 0.02 per video) and `insights` (EUR 0.005 per source
+   * minute) fees on the transcode job, on top of the captions fee; not
+   * charged when the insights fail. The insights surface as Video.insights.
+   * Deployments without the feature reject it with `invalid_argument`, error
+   * code `parameter_unsupported`. Unset or false = no insights.
+   *
+   * @generated from field: optional bool auto_insights = 12;
+   */
+  autoInsights;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -15599,7 +15683,8 @@ var CreateUploadRequest = class _CreateUploadRequest extends protobuf.Message {
       T: 8
       /* ScalarType.BOOL */
     },
-    { no: 11, name: "auto_captions", kind: "scalar", T: 8, opt: true }
+    { no: 11, name: "auto_captions", kind: "scalar", T: 8, opt: true },
+    { no: 12, name: "auto_insights", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreateUploadRequest().fromBinary(bytes, options);
@@ -15808,6 +15893,22 @@ var CreateFromUrlRequest = class _CreateFromUrlRequest extends protobuf.Message
    * @generated from field: optional bool auto_captions = 9;
    */
   autoCaptions;
+  /**
+   * When true, also run AI insights over the inline captions: title
+   * suggestions, a summary, key points, chapters, questions the content
+   * answers, key terms, quotable highlights and topics (the generate track
+   * carries insights.enabled = true; see SubtitleTrack.insights). Requires
+   * auto_captions = true; rejected otherwise with `invalid_argument`, error
+   * code `parameter_incompatible` on auto_insights. Billed as the
+   * `insights_job` (EUR 0.02 per video) and `insights` (EUR 0.005 per source
+   * minute) fees on the transcode job, on top of the captions fee; not
+   * charged when the insights fail. The insights surface as Video.insights.
+   * Deployments without the feature reject it with `invalid_argument`, error
+   * code `parameter_unsupported`. Unset or false = no insights.
+   *
+   * @generated from field: optional bool auto_insights = 10;
+   */
+  autoInsights;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -15841,7 +15942,8 @@ var CreateFromUrlRequest = class _CreateFromUrlRequest extends protobuf.Message
       T: 8
       /* ScalarType.BOOL */
     },
-    { no: 9, name: "auto_captions", kind: "scalar", T: 8, opt: true }
+    { no: 9, name: "auto_captions", kind: "scalar", T: 8, opt: true },
+    { no: 10, name: "auto_insights", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreateFromUrlRequest().fromBinary(bytes, options);
@@ -16083,6 +16185,22 @@ var CreateMultipartUploadRequest = class _CreateMultipartUploadRequest extends p
    * @generated from field: optional bool auto_captions = 16;
    */
   autoCaptions;
+  /**
+   * When true, also run AI insights over the inline captions: title
+   * suggestions, a summary, key points, chapters, questions the content
+   * answers, key terms, quotable highlights and topics (the generate track
+   * carries insights.enabled = true; see SubtitleTrack.insights). Requires
+   * auto_captions = true; rejected otherwise with `invalid_argument`, error
+   * code `parameter_incompatible` on auto_insights. Billed as the
+   * `insights_job` (EUR 0.02 per video) and `insights` (EUR 0.005 per source
+   * minute) fees on the transcode job, on top of the captions fee; not
+   * charged when the insights fail. The insights surface as Video.insights.
+   * Deployments without the feature reject it with `invalid_argument`, error
+   * code `parameter_unsupported`. Unset or false = no insights.
+   *
+   * @generated from field: optional bool auto_insights = 17;
+   */
+  autoInsights;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -16138,7 +16256,8 @@ var CreateMultipartUploadRequest = class _CreateMultipartUploadRequest extends p
       T: 8
       /* ScalarType.BOOL */
     },
-    { no: 16, name: "auto_captions", kind: "scalar", T: 8, opt: true }
+    { no: 16, name: "auto_captions", kind: "scalar", T: 8, opt: true },
+    { no: 17, name: "auto_insights", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreateMultipartUploadRequest().fromBinary(bytes, options);
@@ -17739,6 +17858,100 @@ var GetSeoMarkupResponse = class _GetSeoMarkupResponse extends protobuf.Message
     return protobuf.proto3.util.equals(_GetSeoMarkupResponse, a, b);
   }
 };
+var GenerateInsightsRequest = class _GenerateInsightsRequest extends protobuf.Message {
+  /**
+   * Video ID.
+   *
+   * @generated from field: string id = 1;
+   */
+  id = "";
+  /**
+   * ISO 639-2 language of the AI caption track to use (e.g. "eng"). Optional
+   * when the video has exactly one AI caption track; required when it has
+   * several (refused with code parameter_required, listing the available
+   * languages).
+   *
+   * @generated from field: optional string language = 2;
+   */
+  language;
+  /**
+   * Optional free-text guidance about the content, its audience or the tone
+   * you want, at most 300 characters. Same meaning as InsightsOptions.hint.
+   *
+   * @generated from field: optional string hint = 3;
+   */
+  hint;
+  /**
+   * Optional app the video belongs to. API-key callers may omit it (their
+   * key's app is used) or pass their own app; a different app is rejected
+   * with PermissionDenied. Portal/JWT callers may pass it; omitted, the app
+   * is resolved from the video.
+   *
+   * @generated from field: optional string app_id = 4;
+   */
+  appId;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.GenerateInsightsRequest";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    {
+      no: 1,
+      name: "id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 2, name: "language", kind: "scalar", T: 9, opt: true },
+    { no: 3, name: "hint", kind: "scalar", T: 9, opt: true },
+    { no: 4, name: "app_id", kind: "scalar", T: 9, opt: true }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _GenerateInsightsRequest().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _GenerateInsightsRequest().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _GenerateInsightsRequest().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_GenerateInsightsRequest, a, b);
+  }
+};
+var GenerateInsightsResponse = class _GenerateInsightsResponse extends protobuf.Message {
+  /**
+   * The insights entry: newly created, or the one already pending for this
+   * video and language. Status is "pending"; poll VideoService.Get (or
+   * Watch) or subscribe to video.insights.ready / video.insights.failed.
+   *
+   * @generated from field: transcodely.v1.TranscriptInsights insights = 1;
+   */
+  insights;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.GenerateInsightsResponse";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    { no: 1, name: "insights", kind: "message", T: TranscriptInsights }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _GenerateInsightsResponse().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _GenerateInsightsResponse().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _GenerateInsightsResponse().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_GenerateInsightsResponse, a, b);
+  }
+};
 
 // src/webhooks/types.ts
 var WEBHOOK_EVENT_TYPES = [
@@ -17758,6 +17971,8 @@ var WEBHOOK_EVENT_TYPES = [
   "video.failed",
   "video.deleted",
   "video.source_scheduled_for_deletion",
+  "video.insights.ready",
+  "video.insights.failed",
   "app.created",
   "app.updated",
   "app.spend_limit_warning",
@@ -17780,8 +17995,14 @@ var NOTIFICATION_EVENT_TYPES = /* @__PURE__ */ new Set([
   "app.spend_limit_warning",
   "app.spend_limit_exceeded"
 ]);
+var EXACT_TYPE_DECODERS = /* @__PURE__ */ new Map([
+  ["video.insights.ready", (json) => fromJson(json, TranscriptInsights)],
+  ["video.insights.failed", (json) => fromJson(json, TranscriptInsights)]
+]);
 function decoderForType(type) {
   if (NOTIFICATION_EVENT_TYPES.has(type)) return void 0;
+  const exact = EXACT_TYPE_DECODERS.get(type);
+  if (exact) return exact;
   for (const entry of RESOURCE_DECODERS) {
     if (type.startsWith(entry.prefix)) return entry.decode;
   }
@@ -19931,7 +20152,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.11";
+var SDK_VERSION = "0.3.13";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";
 
@@ -23389,7 +23610,8 @@ var UploadEngine = class {
       ...opts.visibility !== void 0 ? { visibility: opts.visibility } : {},
       ...opts.preset !== void 0 ? { preset: opts.preset } : {},
       ...opts.hoverPreviews !== void 0 ? { hoverPreviews: opts.hoverPreviews } : {},
-      ...opts.autoCaptions !== void 0 ? { autoCaptions: opts.autoCaptions } : {}
+      ...opts.autoCaptions !== void 0 ? { autoCaptions: opts.autoCaptions } : {},
+      ...opts.autoInsights !== void 0 ? { autoInsights: opts.autoInsights } : {}
     };
     return totalParts === 1 ? await this.single(src, opts, meta, report) : await this.multipart(src, opts, meta, partSize, totalParts, report);
   }
@@ -23739,6 +23961,31 @@ var VideoService = {
       I: GetSeoMarkupRequest,
       O: GetSeoMarkupResponse,
       kind: protobuf.MethodKind.Unary
+    },
+    /**
+     * Generate AI insights (title suggestions, summary, key points, chapters,
+     * questions, key terms, highlights, topics) from a hosted video's existing
+     * AI captions, without transcribing again. Billed EUR 0.02 per video plus
+     * EUR 0.005 per minute of source, charged only when the insights become
+     * ready. Returns the entry in "pending"; it also appears on Video.insights,
+     * and video.insights.ready or video.insights.failed fires when it finishes.
+     *
+     * While an entry for the same video and language is pending, the call
+     * returns that entry and bills nothing new. Once it is ready or failed, a
+     * new call generates (and bills) a new entry; it replaces the ready one
+     * only when it becomes ready itself.
+     *
+     * Refused with failed_precondition and code captions_required when the
+     * video has no AI captions, and insights_transcript_unavailable when the
+     * caption track has no transcript.
+     *
+     * @generated from rpc transcodely.v1.VideoService.GenerateInsights
+     */
+    generateInsights: {
+      name: "GenerateInsights",
+      I: GenerateInsightsRequest,
+      O: GenerateInsightsResponse,
+      kind: protobuf.MethodKind.Unary
     }
   }
 };
@@ -23911,6 +24158,29 @@ var Videos = class {
       opts
     );
   }
+  /**
+   * Generate AI insights (title suggestions, summary, key points, chapters,
+   * questions, key terms, highlights, topics) from a hosted video's existing
+   * AI captions, without transcribing again. Returns the TranscriptInsights
+   * entry in "pending"; it also appears on `video.insights`, and
+   * `video.insights.ready` or `video.insights.failed` fires when it finishes.
+   * Billed EUR 0.02 per video plus EUR 0.005 per minute of source, charged
+   * only when the insights become ready.
+   *
+   * While an entry for the same video and language is pending, the call
+   * returns that entry and bills nothing new. Pass `language` when the video
+   * has several AI caption tracks. A video without AI captions is refused with
+   * failed_precondition (code captions_required).
+   */
+  async generateInsights(req, opts) {
+    const res = await this.transport.unary(
+      VideoService,
+      VideoService.methods.generateInsights,
+      new GenerateInsightsRequest(req),
+      opts
+    );
+    return res.insights;
+  }
 };
 
 // src/resources/uploads.ts
@@ -25295,6 +25565,7 @@ exports.HDRMode = HDRMode;
 exports.HLSPlaylistType = HLSPlaylistType;
 exports.HLSSegmentFormat = HLSSegmentFormat;
 exports.HealthStatus = HealthStatus;
+exports.InsightsSource = InsightsSource;
 exports.InsightsStatus = InsightsStatus;
 exports.InvalidRequestError = InvalidRequestError;
 exports.InvoiceLineType = InvoiceLineType;