@transcodely/sdk 0.3.12 → 0.3.13

package/CHANGELOG.md

@@ -4,6 +4,13 @@ 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)
 
 

package/README.md

@@ -282,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;
    */
@@ -17790,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 = [
@@ -17809,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",
@@ -17831,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;
   }
@@ -19982,7 +20152,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.3.12";
+var SDK_VERSION = "0.3.13";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";
 
@@ -23791,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
     }
   }
 };
@@ -23963,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
@@ -25347,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;