@transcodely/sdk 0.3.11 → 0.3.13

package/dist/index.mjs

@@ -4426,6 +4426,7 @@ var WebhookEndpoint = class _WebhookEndpoint extends 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).
@@ -7361,6 +7362,17 @@ proto3.util.setEnumType(TranscriptFormat, "transcodely.v1.TranscriptFormat", [
   { 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 || {});
+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";
@@ -8253,7 +8265,8 @@ var InsightsHighlight = class _InsightsHighlight extends Message {
 };
 var TranscriptInsights = class _TranscriptInsights extends 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;
    */
@@ -8398,6 +8411,38 @@ var TranscriptInsights = class _TranscriptInsights extends 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();
     proto3.util.initPartial(data, this);
@@ -8493,7 +8538,23 @@ var TranscriptInsights = class _TranscriptInsights extends Message {
       kind: "scalar",
       T: 9
       /* ScalarType.STRING */
-    }
+    },
+    {
+      no: 24,
+      name: "id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    { no: 25, name: "source", kind: "enum", T: 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);
@@ -14304,7 +14365,8 @@ var CreateJobRequest = class _CreateJobRequest extends 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;
    */
@@ -14977,9 +15039,14 @@ var Video = class _Video extends 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;
    */
@@ -15022,12 +15089,13 @@ var Video = class _Video extends 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;
    */
@@ -15550,6 +15618,22 @@ var CreateUploadRequest = class _CreateUploadRequest extends 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();
     proto3.util.initPartial(data, this);
@@ -15597,7 +15681,8 @@ var CreateUploadRequest = class _CreateUploadRequest extends 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);
@@ -15806,6 +15891,22 @@ var CreateFromUrlRequest = class _CreateFromUrlRequest extends 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();
     proto3.util.initPartial(data, this);
@@ -15839,7 +15940,8 @@ var CreateFromUrlRequest = class _CreateFromUrlRequest extends 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);
@@ -16081,6 +16183,22 @@ var CreateMultipartUploadRequest = class _CreateMultipartUploadRequest extends M
    * @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();
     proto3.util.initPartial(data, this);
@@ -16136,7 +16254,8 @@ var CreateMultipartUploadRequest = class _CreateMultipartUploadRequest extends M
       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);
@@ -17737,6 +17856,100 @@ var GetSeoMarkupResponse = class _GetSeoMarkupResponse extends Message {
     return proto3.util.equals(_GetSeoMarkupResponse, a, b);
   }
 };
+var GenerateInsightsRequest = class _GenerateInsightsRequest extends 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();
+    proto3.util.initPartial(data, this);
+  }
+  static runtime = proto3;
+  static typeName = "transcodely.v1.GenerateInsightsRequest";
+  static fields = 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 proto3.util.equals(_GenerateInsightsRequest, a, b);
+  }
+};
+var GenerateInsightsResponse = class _GenerateInsightsResponse extends 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();
+    proto3.util.initPartial(data, this);
+  }
+  static runtime = proto3;
+  static typeName = "transcodely.v1.GenerateInsightsResponse";
+  static fields = 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 proto3.util.equals(_GenerateInsightsResponse, a, b);
+  }
+};
 
 // src/webhooks/types.ts
 var WEBHOOK_EVENT_TYPES = [
@@ -17756,6 +17969,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",
@@ -17778,8 +17993,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;
   }
@@ -19929,7 +20150,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";
 
@@ -23387,7 +23608,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);
   }
@@ -23737,6 +23959,31 @@ var VideoService = {
       I: GetSeoMarkupRequest,
       O: GetSeoMarkupResponse,
       kind: 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: MethodKind.Unary
     }
   }
 };
@@ -23909,6 +24156,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
@@ -25262,6 +25532,6 @@ var Transcodely = class {
 Transcodely.API_VERSION = API_VERSION;
 Transcodely.SDK_VERSION = SDK_VERSION;
 
-export { APIConnectionError, APIError, API_VERSION, AppStatus, AudioCodec, AuthenticationError, BillingStanding, BillingTreatment, BitrateMode, ConflictError, Container, ContentAwareMode, ContentType, DEFAULT_BASE_URL, DEFAULT_CONCURRENCY, DEFAULT_MAX_RETRIES, DEFAULT_PART_SIZE, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_TOLERANCE_SECONDS, DRMSystem, DeliveryFormat, DunningStage, EVENT_ID_HEADER, EncryptionScheme, ExposureThresholdSource, GOPAlignmentMode, HDRFormat, HDRMode, HLSPlaylistType, HLSSegmentFormat, HealthStatus, InsightsStatus, InvalidRequestError, InvoiceLineType, InvoiceStatus, JobCostLineType, JobPriority, JobStatus, MAX_PARTS, MAX_UPLOAD_SIZE_BYTES, MIN_PART_SIZE, MembershipRole, MembershipStatus, NotFoundError, OrganizationStatus, OriginPermission, OriginProvider, OriginStatus, OutputFormat, OutputStatus, Page, PaymentMethodState, PermissionError, PreconditionError, QualityTier, R2Jurisdiction, RateLimitError, Resolution, SDK_VERSION, SIGNATURE_HEADER, StorageEventSource, StorageEventStatus, SubtitleFormat, SubtitleOperation, ThumbnailFormat, ThumbnailMode, ToneMapping, Transcodely, TranscodelyError, TranscriptFormat, TranscriptStyle, TrustTier, UploadAbortedError, UploadError, Uploads, UserApprovalStatus, UserStatus, VideoCodec, VideoStatus, VideoVisibility, WEBHOOK_EVENT_TYPES, WatchEventType, WatermarkAnchor, WebhookError, WebhookPayloadError, WebhookSignatureError, WebhookTimestampError, Webhooks, calculatePartSize, calculateTotalParts, constructEvent, contentTypeForFilename, isEventType, isKnownEvent, toWireJson, verifySignature };
+export { APIConnectionError, APIError, API_VERSION, AppStatus, AudioCodec, AuthenticationError, BillingStanding, BillingTreatment, BitrateMode, ConflictError, Container, ContentAwareMode, ContentType, DEFAULT_BASE_URL, DEFAULT_CONCURRENCY, DEFAULT_MAX_RETRIES, DEFAULT_PART_SIZE, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_TOLERANCE_SECONDS, DRMSystem, DeliveryFormat, DunningStage, EVENT_ID_HEADER, EncryptionScheme, ExposureThresholdSource, GOPAlignmentMode, HDRFormat, HDRMode, HLSPlaylistType, HLSSegmentFormat, HealthStatus, InsightsSource, InsightsStatus, InvalidRequestError, InvoiceLineType, InvoiceStatus, JobCostLineType, JobPriority, JobStatus, MAX_PARTS, MAX_UPLOAD_SIZE_BYTES, MIN_PART_SIZE, MembershipRole, MembershipStatus, NotFoundError, OrganizationStatus, OriginPermission, OriginProvider, OriginStatus, OutputFormat, OutputStatus, Page, PaymentMethodState, PermissionError, PreconditionError, QualityTier, R2Jurisdiction, RateLimitError, Resolution, SDK_VERSION, SIGNATURE_HEADER, StorageEventSource, StorageEventStatus, SubtitleFormat, SubtitleOperation, ThumbnailFormat, ThumbnailMode, ToneMapping, Transcodely, TranscodelyError, TranscriptFormat, TranscriptStyle, TrustTier, UploadAbortedError, UploadError, Uploads, UserApprovalStatus, UserStatus, VideoCodec, VideoStatus, VideoVisibility, WEBHOOK_EVENT_TYPES, WatchEventType, WatermarkAnchor, WebhookError, WebhookPayloadError, WebhookSignatureError, WebhookTimestampError, Webhooks, calculatePartSize, calculateTotalParts, constructEvent, contentTypeForFilename, isEventType, isKnownEvent, toWireJson, verifySignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map