@transcodely/sdk 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -900,6 +900,15 @@ interface Service {
 }
 interface TransportConfig {
     apiKey: string;
+    /**
+     * Organization every request is made against, sent as `X-Organization-ID`.
+     *
+     * API-key callers never need this — a key is already scoped to one app, and
+     * therefore to one organization. It is required for the org-scoped surfaces a
+     * dashboard session token reaches, `client.billing` among them, which answer
+     * 400 invalid_argument without it.
+     */
+    organizationId?: string;
     baseUrl?: string;
     timeoutMs?: number;
     maxRetries?: number;
@@ -935,6 +944,7 @@ interface CallOptions {
 declare class Transport {
     readonly baseUrl: string;
     readonly apiKey: string;
+    readonly organizationId: string | undefined;
     readonly timeoutMs: number;
     readonly maxRetries: number;
     readonly apiVersion: string;
@@ -997,7 +1007,15 @@ declare enum AppStatus {
      *
      * @generated from enum value: APP_STATUS_ARCHIVED = 2;
      */
-    ARCHIVED = 2
+    ARCHIVED = 2,
+    /**
+     * Cut off by platform admin action. API keys scoped to the app are rejected
+     * with 403 until it is set back to active. Unlike archived, this is
+     * reversible and preserves all of the app's resources.
+     *
+     * @generated from enum value: APP_STATUS_SUSPENDED = 3;
+     */
+    SUSPENDED = 3
 }
 /**
  * An app is a project within an organization.
@@ -1088,6 +1106,18 @@ declare class App extends Message<App> {
      * @generated from field: string object = 14;
      */
     object: string;
+    /**
+     * Monthly spend limit in EUR for transcoding charges. Unset = unlimited (the
+     * default). Once the app's spend for the current period reaches this limit,
+     * new jobs are rejected with `limit_exceeded`; in-flight jobs are never
+     * stopped. A warning webhook (`app.spend_limit_warning`) fires once at 80% of
+     * the limit and `app.spend_limit_exceeded` fires once on breach. The period
+     * follows the app's billing anchor day in UTC. Set or clear via
+     * AppService.UpdateSpendLimit; read current spend via AppService.GetSpend.
+     *
+     * @generated from field: optional double monthly_spend_limit_eur = 15;
+     */
+    monthlySpendLimitEur?: number;
     constructor(data?: PartialMessage<App>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.App";
@@ -1410,6 +1440,19 @@ declare class HostingConfig extends Message<HostingConfig> {
      * @generated from field: optional transcodely.v1.AutoProfileDefaults auto_profile_defaults = 4;
      */
     autoProfileDefaults?: AutoProfileDefaults;
+    /**
+     * Days after a hosted video becomes ready before its ORIGINAL SOURCE FILE is
+     * deleted from managed storage (0 = disabled/clear). Applies ONLY to the
+     * uploaded source object; renditions and playback are NEVER affected, and BYO
+     * origins are out of scope. A warning webhook (video.source_scheduled_for_deletion)
+     * fires at least the configured warning lead ahead of deletion. Once the source
+     * is deleted, future re-processing (new codecs/renditions, retro-captions) falls
+     * back to the best available rendition. Per-video source_pinned exempts an
+     * individual video from this rule.
+     *
+     * @generated from field: optional int32 delete_source_after_days = 5;
+     */
+    deleteSourceAfterDays?: number;
     constructor(data?: PartialMessage<HostingConfig>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.HostingConfig";
@@ -1514,6 +1557,142 @@ declare class UpdateHostingConfigResponse extends Message<UpdateHostingConfigRes
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): UpdateHostingConfigResponse;
     static equals(a: UpdateHostingConfigResponse | PlainMessage<UpdateHostingConfigResponse> | undefined, b: UpdateHostingConfigResponse | PlainMessage<UpdateHostingConfigResponse> | undefined): boolean;
 }
+/**
+ * Request to set or clear an app's monthly spend limit.
+ *
+ * @generated from message transcodely.v1.UpdateSpendLimitRequest
+ */
+declare class UpdateSpendLimitRequest extends Message<UpdateSpendLimitRequest> {
+    /**
+     * App ID.
+     *
+     * @generated from field: string app_id = 1;
+     */
+    appId: string;
+    /**
+     * Monthly spend limit in EUR. When present, sets the cap (must be > 0). When
+     * ABSENT, the cap is cleared and the app returns to unlimited (the default).
+     * The upper bound matches the NUMERIC(12,2) storage column.
+     *
+     * @generated from field: optional double monthly_spend_limit_eur = 2;
+     */
+    monthlySpendLimitEur?: number;
+    constructor(data?: PartialMessage<UpdateSpendLimitRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.UpdateSpendLimitRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): UpdateSpendLimitRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): UpdateSpendLimitRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): UpdateSpendLimitRequest;
+    static equals(a: UpdateSpendLimitRequest | PlainMessage<UpdateSpendLimitRequest> | undefined, b: UpdateSpendLimitRequest | PlainMessage<UpdateSpendLimitRequest> | undefined): boolean;
+}
+/**
+ * Response from updating a spend limit.
+ *
+ * @generated from message transcodely.v1.UpdateSpendLimitResponse
+ */
+declare class UpdateSpendLimitResponse extends Message<UpdateSpendLimitResponse> {
+    /**
+     * The updated app (monthly_spend_limit_eur reflects the new value, or is
+     * unset when the limit was cleared).
+     *
+     * @generated from field: transcodely.v1.App app = 1;
+     */
+    app?: App;
+    constructor(data?: PartialMessage<UpdateSpendLimitResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.UpdateSpendLimitResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): UpdateSpendLimitResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): UpdateSpendLimitResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): UpdateSpendLimitResponse;
+    static equals(a: UpdateSpendLimitResponse | PlainMessage<UpdateSpendLimitResponse> | undefined, b: UpdateSpendLimitResponse | PlainMessage<UpdateSpendLimitResponse> | undefined): boolean;
+}
+/**
+ * Request to read an app's current-period transcoding spend.
+ *
+ * @generated from message transcodely.v1.GetSpendRequest
+ */
+declare class GetSpendRequest extends Message<GetSpendRequest> {
+    /**
+     * App ID.
+     *
+     * @generated from field: string app_id = 1;
+     */
+    appId: string;
+    constructor(data?: PartialMessage<GetSpendRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetSpendRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetSpendRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetSpendRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetSpendRequest;
+    static equals(a: GetSpendRequest | PlainMessage<GetSpendRequest> | undefined, b: GetSpendRequest | PlainMessage<GetSpendRequest> | undefined): boolean;
+}
+/**
+ * Response with an app's current-period transcoding spend.
+ *
+ * Spend is the sum of billed charges for terminal jobs plus recorded estimates
+ * for in-flight jobs, and includes the per-job minimum charge where applied.
+ * Jobs are attributed to the period by their creation time. All amounts are in
+ * EUR.
+ *
+ * @generated from message transcodely.v1.GetSpendResponse
+ */
+declare class GetSpendResponse extends Message<GetSpendResponse> {
+    /**
+     * Start of the current billing period (inclusive), UTC.
+     *
+     * @generated from field: google.protobuf.Timestamp period_start = 1;
+     */
+    periodStart?: Timestamp;
+    /**
+     * End of the current billing period (exclusive), UTC.
+     *
+     * @generated from field: google.protobuf.Timestamp period_end = 2;
+     */
+    periodEnd?: Timestamp;
+    /**
+     * Transcoding spend recorded so far this period, in EUR.
+     *
+     * @generated from field: double spent_eur = 3;
+     */
+    spentEur: number;
+    /**
+     * The app's monthly spend limit in EUR. Unset = unlimited.
+     *
+     * @generated from field: optional double monthly_spend_limit_eur = 4;
+     */
+    monthlySpendLimitEur?: number;
+    /**
+     * Currency of all amounts in this response. Always "EUR".
+     *
+     * @generated from field: string currency = 5;
+     */
+    currency: string;
+    /**
+     * True once the 80% warning event (`app.spend_limit_warning`) has fired this
+     * period. Fire-once per period; not re-armed by a mid-period limit change.
+     *
+     * @generated from field: bool warning_triggered = 6;
+     */
+    warningTriggered: boolean;
+    /**
+     * True once the breach event (`app.spend_limit_exceeded`) has fired this
+     * period. Fire-once per period; not re-armed by a mid-period limit change.
+     *
+     * @generated from field: bool limit_reached = 7;
+     */
+    limitReached: boolean;
+    constructor(data?: PartialMessage<GetSpendResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetSpendResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetSpendResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetSpendResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetSpendResponse;
+    static equals(a: GetSpendResponse | PlainMessage<GetSpendResponse> | undefined, b: GetSpendResponse | PlainMessage<GetSpendResponse> | undefined): boolean;
+}
 
 declare class Apps {
     private readonly transport;
@@ -1525,6 +1704,466 @@ declare class Apps {
     archive(id: string, opts?: CallOptions): Promise<App>;
     enableHosting(req: PartialMessage<EnableHostingRequest>, opts?: CallOptions): Promise<EnableHostingResponse>;
     updateHostingConfig(req: PartialMessage<UpdateHostingConfigRequest>, opts?: CallOptions): Promise<UpdateHostingConfigResponse>;
+    /**
+     * Set or clear an app's monthly transcoding spend cap. Provide
+     * `monthlySpendLimitEur` (must be > 0) to set the cap; omit it to clear the
+     * cap and return the app to unlimited. {@link setSpendLimit} and
+     * {@link clearSpendLimit} are the ergonomic shorthands.
+     */
+    updateSpendLimit(req: PartialMessage<UpdateSpendLimitRequest>, opts?: CallOptions): Promise<App>;
+    /**
+     * Set the app's monthly transcoding spend cap in EUR (must be > 0). Once
+     * recorded spend for the current billing period reaches the cap, new jobs are
+     * rejected with the `limit_exceeded` error code; in-flight jobs are never
+     * stopped. Use {@link clearSpendLimit} to return the app to unlimited.
+     */
+    setSpendLimit(id: string, monthlySpendLimitEur: number, opts?: CallOptions): Promise<App>;
+    /**
+     * Clear the app's monthly spend cap, returning it to unlimited (the default).
+     * Omitting the optional limit field tells the server to clear any existing cap.
+     */
+    clearSpendLimit(id: string, opts?: CallOptions): Promise<App>;
+    /**
+     * Get the app's current-period transcoding spend against its limit: the
+     * billing-period bounds, EUR spent so far, the cap (if set), and whether the
+     * 80% warning and 100% breach events have fired this period.
+     */
+    getSpend(id: string, opts?: CallOptions): Promise<GetSpendResponse>;
+}
+
+/**
+ * Invoice lifecycle.
+ *
+ * draft -> open -> paid | void | uncollectible. Only "open" and later states
+ * are ever returned by ListInvoices; "draft" appears only on the upcoming
+ * invoice.
+ *
+ * @generated from enum transcodely.v1.InvoiceStatus
+ */
+declare enum InvoiceStatus {
+    /**
+     * @generated from enum value: INVOICE_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Being generated, or the live upcoming statement. Not a bill yet.
+     *
+     * @generated from enum value: INVOICE_STATUS_DRAFT = 1;
+     */
+    DRAFT = 1,
+    /**
+     * Finalized and awaiting payment.
+     *
+     * @generated from enum value: INVOICE_STATUS_OPEN = 2;
+     */
+    OPEN = 2,
+    /**
+     * Paid in full.
+     *
+     * @generated from enum value: INVOICE_STATUS_PAID = 3;
+     */
+    PAID = 3,
+    /**
+     * Canceled without payment; nothing is owed.
+     *
+     * @generated from enum value: INVOICE_STATUS_VOID = 4;
+     */
+    VOID = 4,
+    /**
+     * Written off as unpayable after collection attempts failed.
+     *
+     * @generated from enum value: INVOICE_STATUS_UNCOLLECTIBLE = 5;
+     */
+    UNCOLLECTIBLE = 5
+}
+/**
+ * What an invoice line represents.
+ *
+ * @generated from enum transcodely.v1.InvoiceLineType
+ */
+declare enum InvoiceLineType {
+    /**
+     * @generated from enum value: INVOICE_LINE_TYPE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Encoding work, grouped by app, codec, resolution and quality tier.
+     *
+     * @generated from enum value: INVOICE_LINE_TYPE_USAGE = 1;
+     */
+    USAGE = 1,
+    /**
+     * A metered add-on, such as AI captions.
+     *
+     * @generated from enum value: INVOICE_LINE_TYPE_FEE = 2;
+     */
+    FEE = 2,
+    /**
+     * The per-job minimum charge, summed over the jobs it applied to.
+     *
+     * @generated from enum value: INVOICE_LINE_TYPE_MIN_CHARGE = 3;
+     */
+    MIN_CHARGE = 3,
+    /**
+     * The residue that reconciles the itemized lines with the amount charged.
+     * Per-line rounding cannot always add up to the sum of per-job rounding; this
+     * line carries the difference so the breakdown always matches the total.
+     *
+     * @generated from enum value: INVOICE_LINE_TYPE_ADJUSTMENT = 4;
+     */
+    ADJUSTMENT = 4
+}
+/**
+ * A billing statement for one period.
+ *
+ * All monetary amounts are integer minor units (cents) of the invoice's
+ * currency — 1250 in EUR is €12.50. Following the protobuf JSON mapping for
+ * 64-bit integers, they are rendered as JSON strings ("1250"), not numbers.
+ *
+ * @generated from message transcodely.v1.Invoice
+ */
+declare class Invoice extends Message<Invoice> {
+    /**
+     * Unique identifier (e.g., "inv_a1b2c3d4e5f6").
+     * Empty on the upcoming invoice, which is computed and not yet stored.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Object type, always "invoice".
+     *
+     * @generated from field: string object = 2;
+     */
+    object: string;
+    /**
+     * Organization this statement bills.
+     *
+     * @generated from field: string org_id = 3;
+     */
+    orgId: string;
+    /**
+     * Lifecycle state. The upcoming invoice reports "draft".
+     *
+     * @generated from field: transcodely.v1.InvoiceStatus status = 4;
+     */
+    status: InvoiceStatus;
+    /**
+     * Start of the billing period (inclusive).
+     *
+     * @generated from field: google.protobuf.Timestamp period_start = 5;
+     */
+    periodStart?: Timestamp;
+    /**
+     * End of the billing period (exclusive). A job that settles at or after this
+     * instant belongs to the next period, even if it started before it.
+     *
+     * @generated from field: google.protobuf.Timestamp period_end = 6;
+     */
+    periodEnd?: Timestamp;
+    /**
+     * ISO 4217 currency code. Always "EUR" today.
+     *
+     * @generated from field: string currency = 7;
+     */
+    currency: string;
+    /**
+     * Sum of the itemized lines, excluding the rounding adjustment, in cents.
+     *
+     * @generated from field: int64 subtotal_cents = 8;
+     */
+    subtotalCents: bigint;
+    /**
+     * Amount charged, in cents. Equals the sum of every line item including the
+     * rounding adjustment, and equals the sum of the settled jobs it covers.
+     *
+     * @generated from field: int64 total_cents = 9;
+     */
+    totalCents: bigint;
+    /**
+     * The payment provider's invoice number, once the statement has been matched
+     * to the provider's own record. Absent until then; its absence never means
+     * unpaid.
+     *
+     * @generated from field: optional string provider_invoice_number = 10;
+     */
+    providerInvoiceNumber?: string;
+    /**
+     * When the statement was finalized and became visible. Absent on the
+     * upcoming invoice.
+     *
+     * @generated from field: google.protobuf.Timestamp finalized_at = 11;
+     */
+    finalizedAt?: Timestamp;
+    /**
+     * When payment was received. Absent unless status is "paid".
+     *
+     * @generated from field: google.protobuf.Timestamp paid_at = 12;
+     */
+    paidAt?: Timestamp;
+    /**
+     * The itemized breakdown, in display order.
+     *
+     * @generated from field: repeated transcodely.v1.InvoiceLineItem line_items = 13;
+     */
+    lineItems: InvoiceLineItem[];
+    /**
+     * When the statement row was created.
+     *
+     * @generated from field: google.protobuf.Timestamp created_at = 14;
+     */
+    createdAt?: Timestamp;
+    constructor(data?: PartialMessage<Invoice>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.Invoice";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): Invoice;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): Invoice;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Invoice;
+    static equals(a: Invoice | PlainMessage<Invoice> | undefined, b: Invoice | PlainMessage<Invoice> | undefined): boolean;
+}
+/**
+ * One line of an invoice's breakdown.
+ *
+ * Line items explain the total; they do not compute it. They are regenerated
+ * wholesale whenever a statement is rebuilt before finalization, so a line item
+ * id is not stable until the invoice is finalized.
+ *
+ * @generated from message transcodely.v1.InvoiceLineItem
+ */
+declare class InvoiceLineItem extends Message<InvoiceLineItem> {
+    /**
+     * Unique identifier (e.g., "li_a1b2c3d4e5f6g7"). Empty on the upcoming
+     * invoice, whose lines are computed rather than stored.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * What kind of charge this line represents.
+     *
+     * @generated from field: transcodely.v1.InvoiceLineType line_type = 2;
+     */
+    lineType: InvoiceLineType;
+    /**
+     * Human-readable description, e.g. "Encoding — h264 1080p standard".
+     *
+     * @generated from field: string description = 3;
+     */
+    description: string;
+    /**
+     * How many units the line covers (e.g. 12 outputs). Absent for lines that
+     * are not metered, such as the rounding adjustment.
+     *
+     * @generated from field: optional double quantity = 4;
+     */
+    quantity?: number;
+    /**
+     * Unit that quantity is counted in, e.g. "output" or "minute".
+     *
+     * @generated from field: string unit = 5;
+     */
+    unit: string;
+    /**
+     * Amount for this line, in cents. Signed: the rounding adjustment is
+     * routinely negative.
+     *
+     * @generated from field: int64 amount_cents = 6;
+     */
+    amountCents: bigint;
+    /**
+     * The grouping key that produced this line, e.g.
+     * {"app_id": "app_k1l2m3n4o5", "codec": "h264", "resolution": "1080p"}.
+     * Keys vary by line_type and new ones may be added.
+     *
+     * @generated from field: map<string, string> dimensions = 7;
+     */
+    dimensions: {
+        [key: string]: string;
+    };
+    constructor(data?: PartialMessage<InvoiceLineItem>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.InvoiceLineItem";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): InvoiceLineItem;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): InvoiceLineItem;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): InvoiceLineItem;
+    static equals(a: InvoiceLineItem | PlainMessage<InvoiceLineItem> | undefined, b: InvoiceLineItem | PlainMessage<InvoiceLineItem> | undefined): boolean;
+}
+/**
+ * Request to list the organization's invoices.
+ *
+ * @generated from message transcodely.v1.ListInvoicesRequest
+ */
+declare class ListInvoicesRequest extends Message<ListInvoicesRequest> {
+    /**
+     * Pagination parameters.
+     *
+     * @generated from field: transcodely.v1.PaginationRequest pagination = 1;
+     */
+    pagination?: PaginationRequest;
+    constructor(data?: PartialMessage<ListInvoicesRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListInvoicesRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListInvoicesRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListInvoicesRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListInvoicesRequest;
+    static equals(a: ListInvoicesRequest | PlainMessage<ListInvoicesRequest> | undefined, b: ListInvoicesRequest | PlainMessage<ListInvoicesRequest> | undefined): boolean;
+}
+/**
+ * Response from listing invoices.
+ *
+ * @generated from message transcodely.v1.ListInvoicesResponse
+ */
+declare class ListInvoicesResponse extends Message<ListInvoicesResponse> {
+    /**
+     * Invoices, newest period first. Line items are omitted here; fetch a single
+     * invoice to get them.
+     *
+     * @generated from field: repeated transcodely.v1.Invoice invoices = 1;
+     */
+    invoices: Invoice[];
+    /**
+     * Pagination metadata.
+     *
+     * @generated from field: transcodely.v1.PaginationResponse pagination = 2;
+     */
+    pagination?: PaginationResponse;
+    constructor(data?: PartialMessage<ListInvoicesResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListInvoicesResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListInvoicesResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListInvoicesResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListInvoicesResponse;
+    static equals(a: ListInvoicesResponse | PlainMessage<ListInvoicesResponse> | undefined, b: ListInvoicesResponse | PlainMessage<ListInvoicesResponse> | undefined): boolean;
+}
+/**
+ * Request to retrieve one invoice.
+ *
+ * @generated from message transcodely.v1.GetInvoiceRequest
+ */
+declare class GetInvoiceRequest extends Message<GetInvoiceRequest> {
+    /**
+     * Invoice ID (e.g., "inv_a1b2c3d4e5f6").
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    constructor(data?: PartialMessage<GetInvoiceRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetInvoiceRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetInvoiceRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetInvoiceRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetInvoiceRequest;
+    static equals(a: GetInvoiceRequest | PlainMessage<GetInvoiceRequest> | undefined, b: GetInvoiceRequest | PlainMessage<GetInvoiceRequest> | undefined): boolean;
+}
+/**
+ * Response from retrieving an invoice.
+ *
+ * @generated from message transcodely.v1.GetInvoiceResponse
+ */
+declare class GetInvoiceResponse extends Message<GetInvoiceResponse> {
+    /**
+     * The requested invoice, with its line items.
+     *
+     * @generated from field: transcodely.v1.Invoice invoice = 1;
+     */
+    invoice?: Invoice;
+    constructor(data?: PartialMessage<GetInvoiceResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetInvoiceResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetInvoiceResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetInvoiceResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetInvoiceResponse;
+    static equals(a: GetInvoiceResponse | PlainMessage<GetInvoiceResponse> | undefined, b: GetInvoiceResponse | PlainMessage<GetInvoiceResponse> | undefined): boolean;
+}
+/**
+ * Request to retrieve the statement for the period currently accruing.
+ *
+ * @generated from message transcodely.v1.GetUpcomingInvoiceRequest
+ */
+declare class GetUpcomingInvoiceRequest extends Message<GetUpcomingInvoiceRequest> {
+    constructor(data?: PartialMessage<GetUpcomingInvoiceRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetUpcomingInvoiceRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetUpcomingInvoiceRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetUpcomingInvoiceRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetUpcomingInvoiceRequest;
+    static equals(a: GetUpcomingInvoiceRequest | PlainMessage<GetUpcomingInvoiceRequest> | undefined, b: GetUpcomingInvoiceRequest | PlainMessage<GetUpcomingInvoiceRequest> | undefined): boolean;
+}
+/**
+ * Response carrying the upcoming statement.
+ *
+ * @generated from message transcodely.v1.GetUpcomingInvoiceResponse
+ */
+declare class GetUpcomingInvoiceResponse extends Message<GetUpcomingInvoiceResponse> {
+    /**
+     * The computed statement. Its id is empty and its status is "draft". Totals
+     * are zero when nothing has been billed in the period yet.
+     *
+     * @generated from field: transcodely.v1.Invoice invoice = 1;
+     */
+    invoice?: Invoice;
+    constructor(data?: PartialMessage<GetUpcomingInvoiceResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetUpcomingInvoiceResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetUpcomingInvoiceResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetUpcomingInvoiceResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetUpcomingInvoiceResponse;
+    static equals(a: GetUpcomingInvoiceResponse | PlainMessage<GetUpcomingInvoiceResponse> | undefined, b: GetUpcomingInvoiceResponse | PlainMessage<GetUpcomingInvoiceResponse> | undefined): boolean;
+}
+
+/**
+ * An organization's billing statements — read-only.
+ *
+ * Unlike every other namespace, billing settles a whole organization rather
+ * than a single app, so it is **not** available to API-key callers: a key is
+ * scoped to one app, and there is no app-scoped subset of an invoice worth
+ * serving. An API key gets a `PermissionError`.
+ *
+ * Reading invoices needs a dashboard session token for an organization
+ * **owner**, plus the organization the request is for:
+ *
+ * ```ts
+ * const client = new Transcodely({
+ *   apiKey: sessionToken,
+ *   organizationId: "org_f6g7h8i9j0",
+ * });
+ * const upcoming = await client.billing.retrieveUpcoming();
+ * ```
+ *
+ * Invoices are generated automatically when a period closes. There is no API to
+ * create, edit, or delete one — a statement records what happened.
+ */
+declare class Billing {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Page through the organization's finalized invoices, newest period first.
+     *
+     * Line items are omitted here; use {@link retrieve} for one invoice's
+     * breakdown. A statement still being generated for a just-ended period is
+     * never returned — for the period currently accruing use
+     * {@link retrieveUpcoming}.
+     */
+    listInvoices(req?: PartialMessage<ListInvoicesRequest>, opts?: CallOptions): Page<Invoice>;
+    /** Retrieve one invoice by ID (`inv_*`), including its line items. */
+    retrieve(id: string, opts?: CallOptions): Promise<Invoice>;
+    /**
+     * Retrieve the statement for the period currently accruing.
+     *
+     * Computed live from settled jobs rather than stored, so its `id` is empty,
+     * its status is `draft`, and its totals move as jobs finish. Jobs still
+     * running are not included at any price — a job is billed only once it
+     * settles.
+     */
+    retrieveUpcoming(opts?: CallOptions): Promise<Invoice>;
 }
 
 /**
@@ -1560,10 +2199,13 @@ declare class WebhookEndpoint extends Message<WebhookEndpoint> {
     /**
      * Event types this endpoint subscribes to.
      * Use "*" to subscribe to all event types.
-     * Possible values: "job.created", "job.updated", "job.succeeded",
-     * "job.failed", "job.canceled", "job.progress", "output.created",
-     * "output.ready", "output.failed", "output.progress",
-     * "video.uploaded", "video.deleted", "app.created", "app.updated", or "*".
+     * Possible values: "job.created", "job.succeeded", "job.failed",
+     * "job.canceled", "job.progress", "output.created", "output.ready",
+     * "output.failed", "output.progress", "video.uploaded", "video.ready",
+     * "video.failed", "video.deleted", "video.source_scheduled_for_deletion",
+     * "app.created", "app.updated", "app.spend_limit_warning",
+     * "app.spend_limit_exceeded", or "*".
+     * Keep in sync with domain.WebhookEventTypes() ("job.updated" does not exist).
      *
      * @generated from field: repeated string enabled_events = 5;
      */
@@ -1614,8 +2256,9 @@ declare class WebhookEndpoint extends Message<WebhookEndpoint> {
      * Reason the endpoint is in `status: "disabled"`. Absent when status is "enabled".
      * One of:
      *   "manual"        — operator paused via UpdateWebhookEndpoint
-     *   "auto_failures" — scheduler tripped after 10 consecutive terminal failures
-     *                     spanning ≥72 h
+     *   "auto_failures" — scheduler tripped after an opt-in sustained-failure
+     *                     rule: 50+ consecutive terminal failures with zero
+     *                     successes for at least 168 h (7 days)
      * Wire value is lowercase per project convention.
      *
      * @generated from field: optional string disabled_reason = 12;
@@ -1637,6 +2280,15 @@ declare class WebhookEndpoint extends Message<WebhookEndpoint> {
      * @generated from field: optional google.protobuf.Timestamp previous_secret_expires_at = 14;
      */
     previousSecretExpiresAt?: Timestamp;
+    /**
+     * Compact rolling-24h delivery-health summary. Populated ONLY by
+     * ListWebhookEndpoints when the request sets include_health=true; absent on
+     * every other RPC and when include_health is false. Shares the
+     * GetEndpointHealth cache, so values may be up to ~30 s stale.
+     *
+     * @generated from field: optional transcodely.v1.EndpointHealthSummary health = 15;
+     */
+    health?: EndpointHealthSummary;
     constructor(data?: PartialMessage<WebhookEndpoint>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.WebhookEndpoint";
@@ -1646,6 +2298,44 @@ declare class WebhookEndpoint extends Message<WebhookEndpoint> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): WebhookEndpoint;
     static equals(a: WebhookEndpoint | PlainMessage<WebhookEndpoint> | undefined, b: WebhookEndpoint | PlainMessage<WebhookEndpoint> | undefined): boolean;
 }
+/**
+ * Compact delivery-health summary attached to a WebhookEndpoint in
+ * ListWebhookEndpoints responses when include_health=true. A minimal
+ * rolling-24h rollup; call GetEndpointHealth for the full bucketed series,
+ * pending count, and latency percentiles. Values may be up to ~30 s stale.
+ *
+ * @generated from message transcodely.v1.EndpointHealthSummary
+ */
+declare class EndpointHealthSummary extends Message<EndpointHealthSummary> {
+    /**
+     * Total delivery attempts in the last 24 h.
+     *
+     * @generated from field: int32 total_attempts = 1;
+     */
+    totalAttempts: number;
+    /**
+     * Failed terminal attempts in the last 24 h.
+     *
+     * @generated from field: int32 failed = 2;
+     */
+    failed: number;
+    /**
+     * succeeded / (succeeded + failed) over the last 24 h; in-flight (pending)
+     * attempts are excluded from the denominator. Zero when there were no
+     * terminal attempts in the window.
+     *
+     * @generated from field: double success_rate = 3;
+     */
+    successRate: number;
+    constructor(data?: PartialMessage<EndpointHealthSummary>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.EndpointHealthSummary";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): EndpointHealthSummary;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): EndpointHealthSummary;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): EndpointHealthSummary;
+    static equals(a: EndpointHealthSummary | PlainMessage<EndpointHealthSummary> | undefined, b: EndpointHealthSummary | PlainMessage<EndpointHealthSummary> | undefined): boolean;
+}
 /**
  * An immutable record of a platform event emitted for an app.
  *
@@ -2088,6 +2778,19 @@ declare class ListWebhookEndpointsRequest extends Message<ListWebhookEndpointsRe
      * @generated from field: transcodely.v1.PaginationRequest pagination = 2;
      */
     pagination?: PaginationRequest;
+    /**
+     * When true, populate each returned endpoint's `health` field with a compact
+     * rolling-24h delivery summary (success_rate, total_attempts, failed),
+     * replacing N client-side GetEndpointHealth calls with this one list call.
+     * The summary is computed from the same server-side rollup as
+     * GetEndpointHealth and shares its ~30 s cache, so values may be up to ~30 s
+     * stale; on a cold cache the server still computes one rollup per listed
+     * endpoint, so expect a slower first response on apps with many endpoints.
+     * Defaults to false (health omitted).
+     *
+     * @generated from field: bool include_health = 3;
+     */
+    includeHealth: boolean;
     constructor(data?: PartialMessage<ListWebhookEndpointsRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.ListWebhookEndpointsRequest";
@@ -2203,6 +2906,18 @@ declare class ListEventsRequest extends Message<ListEventsRequest> {
      * @generated from field: transcodely.v1.PaginationRequest pagination = 5;
      */
     pagination?: PaginationRequest;
+    /**
+     * Filter to events concerning a specific resource, matched against the
+     * resource id embedded in the event's data snapshot (data.id). Accepts any
+     * prefixed Transcodely resource id — e.g. a job ("job_…") or a video
+     * ("vid_…") — and returns every event whose snapshot carries that id. Lets a
+     * dashboard resource page (e.g. a job page) load that resource's webhook
+     * history in one call. Synthetic SendTestWebhook events are stored separately
+     * and never match.
+     *
+     * @generated from field: optional string object_id = 6;
+     */
+    objectId?: string;
     constructor(data?: PartialMessage<ListEventsRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.ListEventsRequest";
@@ -3609,7 +4324,14 @@ declare enum SubtitleOperation {
      *
      * @generated from enum value: SUBTITLE_OPERATION_EXTRACT = 4;
      */
-    EXTRACT = 4
+    EXTRACT = 4,
+    /**
+     * Generate captions from the audio track using automatic speech
+     * recognition. Tracks produced this way carry auto_generated: true.
+     *
+     * @generated from enum value: SUBTITLE_OPERATION_GENERATE = 5;
+     */
+    GENERATE = 5
 }
 /**
  * Subtitle format.
@@ -3728,7 +4450,11 @@ declare class SubtitleTrack extends Message<SubtitleTrack> {
      */
     outputFormat: SubtitleFormat;
     /**
-     * ISO 639-2 language code (e.g., "eng", "spa", "fra").
+     * ISO 639-2 language code (e.g., "eng", "spa", "fra"), or "auto".
+     * "auto" is valid only for the generate operation and selects
+     * automatic language detection; it is the default when empty on a
+     * generate track. The other operations require a real ISO 639-2 code
+     * (or empty) and reject "auto".
      *
      * @generated from field: optional string language = 6;
      */
@@ -3763,14 +4489,198 @@ declare class SubtitleTrack extends Message<SubtitleTrack> {
      * @generated from field: optional transcodely.v1.BurnInStyle burn_in_style = 11;
      */
     burnInStyle?: BurnInStyle;
+    /**
+     * Generate an AI chapters track from the transcript this track produces.
+     *
+     * Only meaningful together with the (upcoming) `generate` subtitle operation:
+     * when enabled, an AI pass over the generated transcript produces a chapters
+     * track delivered as WebVTT plus JSON. Free — no pricing impact. The
+     * transcript text is processed via the Anthropic API (an external
+     * subprocessor). Until the `generate` operation ships, setting this is
+     * rejected at job creation.
+     *
+     * @generated from field: optional bool generate_chapters = 12;
+     */
+    generateChapters?: boolean;
     constructor(data?: PartialMessage<SubtitleTrack>);
     static readonly runtime: typeof proto3;
-    static readonly typeName = "transcodely.v1.SubtitleTrack";
+    static readonly typeName = "transcodely.v1.SubtitleTrack";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SubtitleTrack;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SubtitleTrack;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SubtitleTrack;
+    static equals(a: SubtitleTrack | PlainMessage<SubtitleTrack> | undefined, b: SubtitleTrack | PlainMessage<SubtitleTrack> | undefined): boolean;
+}
+/**
+ * ChapterPoint is one chapter marker. Times are seconds from the start of the
+ * video.
+ *
+ * @generated from message transcodely.v1.ChapterPoint
+ */
+declare class ChapterPoint extends Message<ChapterPoint> {
+    /**
+     * Chapter start, in seconds from the start of the video.
+     *
+     * @generated from field: double start_seconds = 1;
+     */
+    startSeconds: number;
+    /**
+     * Chapter end, in seconds from the start of the video.
+     *
+     * @generated from field: double end_seconds = 2;
+     */
+    endSeconds: number;
+    /**
+     * Short, human-readable chapter title, in the caption track's language.
+     *
+     * @generated from field: string title = 3;
+     */
+    title: string;
+    constructor(data?: PartialMessage<ChapterPoint>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ChapterPoint";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ChapterPoint;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ChapterPoint;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ChapterPoint;
+    static equals(a: ChapterPoint | PlainMessage<ChapterPoint> | undefined, b: ChapterPoint | PlainMessage<ChapterPoint> | undefined): boolean;
+}
+/**
+ * ChapterResult reports an auto-generated chapters track (read-only on Job
+ * responses). It is produced by the opt-in auto-chapters pass over generated
+ * captions (SubtitleTrack.generate_chapters).
+ *
+ * Not yet populated: the auto-chapters feature is rolling out together with
+ * generated captions. Fields are documented here so consumers can code against
+ * the shape ahead of the rollout.
+ *
+ * @generated from message transcodely.v1.ChapterResult
+ */
+declare class ChapterResult extends Message<ChapterResult> {
+    /**
+     * The out_… output the generate track was configured on.
+     *
+     * @generated from field: string output_id = 1;
+     */
+    outputId: string;
+    /**
+     * ISO 639-2 language code, matching the caption track's language.
+     *
+     * @generated from field: string language = 2;
+     */
+    language: string;
+    /**
+     * Storage key of the WebVTT chapters file in the output destination.
+     *
+     * @generated from field: string storage_key = 3;
+     */
+    storageKey: string;
+    /**
+     * Resolved URL for the chapters file (same resolution rules as the caption
+     * artifact URL).
+     *
+     * @generated from field: string url = 4;
+     */
+    url: string;
+    /**
+     * The chapter markers, ordered by start time.
+     *
+     * @generated from field: repeated transcodely.v1.ChapterPoint chapters = 5;
+     */
+    chapters: ChapterPoint[];
+    constructor(data?: PartialMessage<ChapterResult>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ChapterResult";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ChapterResult;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ChapterResult;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ChapterResult;
+    static equals(a: ChapterResult | PlainMessage<ChapterResult> | undefined, b: ChapterResult | PlainMessage<ChapterResult> | undefined): boolean;
+}
+/**
+ * A generated or processed subtitle artifact, reported by the worker on job
+ * completion and surfaced on the Job response. Mirrors the rendition pattern:
+ * the worker computes both the storage key and the storage URL, and the API
+ * persists them verbatim (the same way JobOutput.output_url works). Read-only
+ * on Job responses.
+ *
+ * @generated from message transcodely.v1.SubtitleResult
+ */
+declare class SubtitleResult extends Message<SubtitleResult> {
+    /**
+     * Output ID (out_…) the subtitle track was configured on.
+     *
+     * @generated from field: string output_id = 1;
+     */
+    outputId: string;
+    /**
+     * Processing operation that produced this artifact
+     * (generate | extract | convert). Lowercase string on the wire.
+     *
+     * @generated from field: transcodely.v1.SubtitleOperation operation = 2;
+     */
+    operation: SubtitleOperation;
+    /**
+     * Subtitle file format: webvtt | srt | ttml | ass.
+     *
+     * @generated from field: transcodely.v1.SubtitleFormat format = 3;
+     */
+    format: SubtitleFormat;
+    /**
+     * Detected language (generate with auto-detect) or the configured
+     * ISO 639-2 language code.
+     *
+     * @generated from field: string language = 4;
+     */
+    language: string;
+    /**
+     * Human-readable label (e.g., "English", "Spanish (CC)").
+     *
+     * @generated from field: string label = 5;
+     */
+    label: string;
+    /**
+     * True iff this track was produced by the generate operation
+     * (automatic speech recognition).
+     *
+     * @generated from field: bool auto_generated = 6;
+     */
+    autoGenerated: boolean;
+    /**
+     * Caption file storage key in the output destination
+     * (e.g. "job_xxx/subtitles/out_yyy_eng.vtt").
+     *
+     * @generated from field: string storage_key = 7;
+     */
+    storageKey: string;
+    /**
+     * Fully-qualified storage URL as built by the worker, stored as-is and
+     * echoed on the Job response, exactly like JobOutput.output_url.
+     *
+     * @generated from field: string url = 8;
+     */
+    url: string;
+    /**
+     * Segment-level transcript JSON storage key. Set only for generate
+     * tracks (the machine-readable transcript consumed by auto-chapters).
+     *
+     * @generated from field: string transcript_storage_key = 9;
+     */
+    transcriptStorageKey: string;
+    /**
+     * Fully-qualified transcript URL. Set only for generate tracks.
+     *
+     * @generated from field: string transcript_url = 10;
+     */
+    transcriptUrl: string;
+    constructor(data?: PartialMessage<SubtitleResult>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.SubtitleResult";
     static readonly fields: FieldList;
-    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SubtitleTrack;
-    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SubtitleTrack;
-    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SubtitleTrack;
-    static equals(a: SubtitleTrack | PlainMessage<SubtitleTrack> | undefined, b: SubtitleTrack | PlainMessage<SubtitleTrack> | undefined): boolean;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SubtitleResult;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SubtitleResult;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SubtitleResult;
+    static equals(a: SubtitleResult | PlainMessage<SubtitleResult> | undefined, b: SubtitleResult | PlainMessage<SubtitleResult> | undefined): boolean;
 }
 
 /**
@@ -3962,6 +4872,11 @@ declare class DRMConfig extends Message<DRMConfig> {
 /**
  * Content-aware encoding mode.
  *
+ * NOT YET SUPPORTED. The worker pipeline does not yet act on content-aware
+ * encoding, so any output carrying a ContentAwareConfig is rejected at CreateJob
+ * with error code `parameter_unsupported` (see issue #167). The enum values are
+ * retained for wire compatibility and will become active when the feature ships.
+ *
  * @generated from enum transcodely.v1.ContentAwareMode
  */
 declare enum ContentAwareMode {
@@ -3970,13 +4885,15 @@ declare enum ContentAwareMode {
      */
     UNSPECIFIED = 0,
     /**
-     * Optimize CRF for target VMAF on specific content.
+     * Optimize CRF for target VMAF on specific content. NOT YET SUPPORTED —
+     * rejected at create.
      *
      * @generated from enum value: CONTENT_AWARE_MODE_PER_TITLE = 1;
      */
     PER_TITLE = 1,
     /**
-     * Generate optimal bitrate ladder automatically.
+     * Generate optimal bitrate ladder automatically. NOT YET SUPPORTED —
+     * rejected at create.
      *
      * @generated from enum value: CONTENT_AWARE_MODE_AUTO_ABR = 2;
      */
@@ -3985,6 +4902,10 @@ declare enum ContentAwareMode {
 /**
  * Auto ABR ladder generation constraints.
  *
+ * NOT YET SUPPORTED — see ContentAwareConfig. These constraints are validated
+ * for shape but never applied, because a request carrying content_aware is
+ * rejected at create.
+ *
  * @generated from message transcodely.v1.AutoABRConfig
  */
 declare class AutoABRConfig extends Message<AutoABRConfig> {
@@ -4026,24 +4947,35 @@ declare class AutoABRConfig extends Message<AutoABRConfig> {
 /**
  * Content-aware encoding configuration for an output.
  *
+ * NOT YET SUPPORTED. Setting content_aware on any output causes CreateJob to
+ * fail with error code `parameter_unsupported` and the message "content-aware
+ * encoding (per_title/auto_abr) is not yet supported". The worker does not yet
+ * implement per-title CRF optimization or auto-ABR ladder generation — both
+ * modes would run the identical plain-encode path — so the API rejects the
+ * request rather than silently no-op it while charging the content-aware
+ * multiplier (issue #167 / transcodely/worker#90). The message and fields are
+ * retained for wire compatibility and forward-planning.
+ *
  * @generated from message transcodely.v1.ContentAwareConfig
  */
 declare class ContentAwareConfig extends Message<ContentAwareConfig> {
     /**
-     * Encoding mode (required).
+     * Encoding mode (required). NOT YET SUPPORTED — any value here causes the
+     * request to be rejected at create.
      *
      * @generated from field: transcodely.v1.ContentAwareMode mode = 1;
      */
     mode: ContentAwareMode;
     /**
-     * Override VMAF target (70-99).
-     * Defaults from quality tier: economy=88, standard=93, premium=97.
+     * Override VMAF target (70-99). NOT YET SUPPORTED — content-aware encoding is
+     * rejected at create, so this value is never applied.
      *
      * @generated from field: optional double vmaf_target = 2;
      */
     vmafTarget?: number;
     /**
-     * Auto ABR constraints (only for auto_abr mode).
+     * Auto ABR constraints (only for auto_abr mode). NOT YET SUPPORTED — rejected
+     * at create.
      *
      * @generated from field: optional transcodely.v1.AutoABRConfig auto_abr = 3;
      */
@@ -4060,6 +4992,10 @@ declare class ContentAwareConfig extends Message<ContentAwareConfig> {
 /**
  * Content analysis results from extended probe.
  *
+ * NOT YET POPULATED. Produced only when content-aware analysis is wired in the
+ * worker; today no job carries it, because content_aware requests are rejected
+ * at create (see ContentAwareConfig).
+ *
  * @generated from message transcodely.v1.ContentAnalysis
  */
 declare class ContentAnalysis extends Message<ContentAnalysis> {
@@ -4097,6 +5033,168 @@ declare class ContentAnalysis extends Message<ContentAnalysis> {
     static equals(a: ContentAnalysis | PlainMessage<ContentAnalysis> | undefined, b: ContentAnalysis | PlainMessage<ContentAnalysis> | undefined): boolean;
 }
 
+/**
+ * Anchor position for a relatively-placed watermark. The watermark is aligned
+ * to the named region of each rendition's frame, so a single config places the
+ * overlay consistently across every ABR rung regardless of output resolution.
+ * Wire form is lowercase (e.g. "bottom_right") via the codec.
+ *
+ * @generated from enum transcodely.v1.WatermarkAnchor
+ */
+declare enum WatermarkAnchor {
+    /**
+     * Default value; treated as bottom_right when unset.
+     *
+     * @generated from enum value: WATERMARK_ANCHOR_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_TOP_LEFT = 1;
+     */
+    TOP_LEFT = 1,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_TOP_CENTER = 2;
+     */
+    TOP_CENTER = 2,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_TOP_RIGHT = 3;
+     */
+    TOP_RIGHT = 3,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_MIDDLE_LEFT = 4;
+     */
+    MIDDLE_LEFT = 4,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_MIDDLE_CENTER = 5;
+     */
+    MIDDLE_CENTER = 5,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_MIDDLE_RIGHT = 6;
+     */
+    MIDDLE_RIGHT = 6,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_BOTTOM_LEFT = 7;
+     */
+    BOTTOM_LEFT = 7,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_BOTTOM_CENTER = 8;
+     */
+    BOTTOM_CENTER = 8,
+    /**
+     * @generated from enum value: WATERMARK_ANCHOR_BOTTOM_RIGHT = 9;
+     */
+    BOTTOM_RIGHT = 9
+}
+/**
+ * Absolute pixel placement for a watermark (advanced / "hacker mode"). The
+ * overlay is drawn at an exact pixel offset and scaled to an exact pixel width;
+ * unlike the relative anchor/width_pct fields, these coordinates do NOT adapt
+ * across ABR rungs — a placement tuned for a 1080p rung will sit at the same
+ * pixel offset on a 360p rung, so this is intended for single-rendition outputs
+ * or advanced users who accept that trade-off.
+ *
+ * @generated from message transcodely.v1.WatermarkPixelPlacement
+ */
+declare class WatermarkPixelPlacement extends Message<WatermarkPixelPlacement> {
+    /**
+     * Horizontal offset in pixels from the top-left origin of the frame.
+     *
+     * @generated from field: int32 x = 1;
+     */
+    x: number;
+    /**
+     * Vertical offset in pixels from the top-left origin of the frame.
+     *
+     * @generated from field: int32 y = 2;
+     */
+    y: number;
+    /**
+     * Watermark width in pixels. The overlay image is scaled to this width and
+     * its height is derived automatically from the source aspect ratio.
+     *
+     * @generated from field: int32 width = 3;
+     */
+    width: number;
+    constructor(data?: PartialMessage<WatermarkPixelPlacement>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.WatermarkPixelPlacement";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): WatermarkPixelPlacement;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): WatermarkPixelPlacement;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): WatermarkPixelPlacement;
+    static equals(a: WatermarkPixelPlacement | PlainMessage<WatermarkPixelPlacement> | undefined, b: WatermarkPixelPlacement | PlainMessage<WatermarkPixelPlacement> | undefined): boolean;
+}
+/**
+ * Watermark / logo overlay baked into the encoded video of an output.
+ *
+ * Two placement modes exist and are mutually exclusive:
+ *   * Relative (default): anchor + width_pct + margin_pct scale the overlay
+ *     consistently across every ABR rung.
+ *   * Pixel (advanced): the `pixel` submessage places the overlay at an exact
+ *     pixel offset and width (does not adapt across rungs).
+ * `image_url` and `opacity` apply in both modes. The mutual exclusivity of
+ * `pixel` with the relative fields is enforced server-side by the feature
+ * validator.
+ *
+ * @generated from message transcodely.v1.WatermarkConfig
+ */
+declare class WatermarkConfig extends Message<WatermarkConfig> {
+    /**
+     * Public http(s) URL of the overlay image. Must be a PNG or WebP image
+     * (alpha-capable formats only). Validated server-side at job creation: the
+     * image is fetched through the SSRF-guarded transport, its format is checked
+     * by magic bytes + decode, and size/dimension caps are enforced.
+     *
+     * @generated from field: string image_url = 1;
+     */
+    imageUrl: string;
+    /**
+     * Anchor region the overlay is aligned to (relative mode). Defaults to
+     * bottom_right when unset. Ignored when `pixel` is set.
+     *
+     * @generated from field: optional transcodely.v1.WatermarkAnchor anchor = 2;
+     */
+    anchor?: WatermarkAnchor;
+    /**
+     * Watermark width as a percentage of each rendition's output width (relative
+     * mode). Scales consistently across every ABR rung. Range (0, 100].
+     * Defaults to 15 when unset. Ignored when `pixel` is set.
+     *
+     * @generated from field: optional double width_pct = 3;
+     */
+    widthPct?: number;
+    /**
+     * Margin from the anchored edges as a percentage of output width (relative
+     * mode). Range [0, 40]. Defaults to 2 when unset. Ignored when `pixel` is set.
+     *
+     * @generated from field: optional double margin_pct = 4;
+     */
+    marginPct?: number;
+    /**
+     * Overlay opacity. Range (0, 1]. Defaults to 1.0 (fully opaque) when unset.
+     * Applies in both relative and pixel modes.
+     *
+     * @generated from field: optional double opacity = 5;
+     */
+    opacity?: number;
+    /**
+     * Absolute pixel placement (advanced mode). Mutually exclusive with anchor,
+     * width_pct, and margin_pct — supplying `pixel` together with any of those is
+     * rejected at job creation.
+     *
+     * @generated from field: optional transcodely.v1.WatermarkPixelPlacement pixel = 6;
+     */
+    pixel?: WatermarkPixelPlacement;
+    constructor(data?: PartialMessage<WatermarkConfig>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.WatermarkConfig";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): WatermarkConfig;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): WatermarkConfig;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): WatermarkConfig;
+    static equals(a: WatermarkConfig | PlainMessage<WatermarkConfig> | undefined, b: WatermarkConfig | PlainMessage<WatermarkConfig> | undefined): boolean;
+}
+
 /**
  * Storage provider type.
  *
@@ -5443,7 +6541,33 @@ declare enum ThumbnailMode {
      *
      * @generated from enum value: THUMBNAIL_MODE_TIMESTAMPS = 4;
      */
-    TIMESTAMPS = 4
+    TIMESTAMPS = 4,
+    /**
+     * Generate short animated hover-preview loops for card/grid previews.
+     *
+     * Free and bundled — animated previews add NO cost to a job (thumbnails are
+     * priced at 0). By default the worker produces BOTH an animated WebP and a
+     * muted MP4 loop from the same samples, so a consumer can pick whichever its
+     * surface supports. Set `format = webp` to emit only the WebP.
+     *
+     * Sampling is deterministic: unless `start_offsets` is set, clips are taken at
+     * fixed 25% / 50% / 75% marks of the source duration (no scene detection).
+     * Smart defaults (applied worker-side; the API stores exactly what was sent):
+     * ~4 s total duration, 12 fps, 320 px wide.
+     *
+     * The animated WebP is hard-capped at 10 s: when `duration_seconds` exceeds
+     * 10 the WebP is skipped and the output is MP4-only (documented, not an
+     * error) — unless `format = webp` is set explicitly, in which case a
+     * `duration_seconds` above 10 is rejected at job creation.
+     *
+     * Valid config for this mode: `width`, `height`, `quality` (maps to WebP
+     * encode quality), `duration_seconds`, `fps`, `start_offsets`, `path_template`.
+     * The single/interval/sprite/timestamps fields (`timestamp`,
+     * `interval_seconds`, `timestamps`, `sprite_columns`) are not valid here.
+     *
+     * @generated from enum value: THUMBNAIL_MODE_ANIMATED = 5;
+     */
+    ANIMATED = 5
 }
 /**
  * Thumbnail output format.
@@ -5506,7 +6630,10 @@ declare class ThumbnailSpec extends Message<ThumbnailSpec> {
      */
     quality?: number;
     /**
-     * Timestamp in seconds for single mode.
+     * Timestamp in seconds for single mode. When omitted, the worker
+     * smart-selects a representative non-black frame from the opening of the
+     * video (deterministic per input) instead of extracting the frame at t=0.
+     * An explicit value — including 0 — extracts exactly that frame.
      *
      * @generated from field: optional double timestamp = 6;
      */
@@ -5542,6 +6669,13 @@ declare class ThumbnailSpec extends Message<ThumbnailSpec> {
      * {format} (image format: jpeg|png|webp), {thumb_index} (0-based),
      * {thumb_time} (seconds, file-safe), {thumb_time_ms} (milliseconds).
      *
+     * Output-only variables ({output_id}, {codec}, {resolution}, {bitrate},
+     * {quality}, {preset_id}, {output_index}, {segment_*}) are NOT valid here — a
+     * thumbnail is not a rendition, so a thumbnail render context can't resolve
+     * them and the literal token would land in the storage key. Setting one is a
+     * validation error. (When a thumbnail INHERITS the output origin's template
+     * instead, those variables are stripped automatically.)
+     *
      * Example: "video/{video_id}/poster/{thumb_index}".
      *
      * Must not start with `/` or contain `..` (no path traversal). When set, it
@@ -5552,6 +6686,34 @@ declare class ThumbnailSpec extends Message<ThumbnailSpec> {
      * @generated from field: optional string path_template = 10;
      */
     pathTemplate?: string;
+    /**
+     * Total length of each animated preview clip, in seconds (animated mode only).
+     * Range: 2-30. Default (unset): ~4 s, applied worker-side. The animated WebP
+     * is hard-capped at 10 s: above 10 s the WebP is skipped and only the MP4 loop
+     * is produced (unless format=webp is set explicitly, which then rejects
+     * duration_seconds > 10). Only valid for animated mode.
+     *
+     * @generated from field: optional double duration_seconds = 11;
+     */
+    durationSeconds?: number;
+    /**
+     * Frames per second of the animated preview (animated mode only).
+     * Range: 8-15. Default (unset): 12, applied worker-side. Only valid for
+     * animated mode.
+     *
+     * @generated from field: optional int32 fps = 12;
+     */
+    fps?: number;
+    /**
+     * Explicit clip start offsets in seconds from the source start (animated mode
+     * only). When set (max 3 entries, each >= 0), these replace the default
+     * 25%/50%/75% sampling marks; the worker clamps each offset to the source
+     * duration. Unset → the deterministic 25%/50%/75% marks. Only valid for
+     * animated mode.
+     *
+     * @generated from field: repeated double start_offsets = 13;
+     */
+    startOffsets: number[];
     constructor(data?: PartialMessage<ThumbnailSpec>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.ThumbnailSpec";
@@ -5589,14 +6751,16 @@ declare class ThumbnailResult extends Message<ThumbnailResult> {
     url: string;
     /**
      * Generation mode that produced this file: single | interval | sprite |
-     * timestamps. Lowercase string on the wire.
+     * timestamps | animated. Lowercase string on the wire.
      *
      * @generated from field: string mode = 3;
      */
     mode: string;
     /**
      * File format: jpeg | png | webp. The sprite mode's WebVTT sidecar uses
-     * "vtt".
+     * "vtt". Animated mode yields "webp" (the animated WebP) and "mp4" (the muted
+     * MP4 loop) — "mp4" rides this free-form string; it is not a ThumbnailFormat
+     * enum value.
      *
      * @generated from field: string format = 4;
      */
@@ -6164,6 +7328,16 @@ declare class OutputSpec extends Message<OutputSpec> {
      * @generated from field: optional bool disable_audio = 16;
      */
     disableAudio?: boolean;
+    /**
+     * Watermark / logo overlay for this output. When set, the overlay is baked
+     * into the encoded video of this output (like subtitle burn-in). Billed under
+     * the unified overlay multiplier class: 1.1x once per output regardless of how
+     * many pixel-burning overlays are enabled (a watermark and burned-in subtitles
+     * together are still a single 1.1x, never 1.21x).
+     *
+     * @generated from field: optional transcodely.v1.WatermarkConfig watermark = 17;
+     */
+    watermark?: WatermarkConfig;
     constructor(data?: PartialMessage<OutputSpec>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.OutputSpec";
@@ -6453,8 +7627,9 @@ declare class JobOutput extends Message<JobOutput> {
     estimatedCost?: number;
     /**
      * Actual cost (calculated after encoding using locked pricing and actual duration).
-     * For canceled outputs, this reflects cost of encoded portion.
-     * For failed outputs, this is zero.
+     * Only a completed output is billable, so this is zero for both canceled and
+     * failed outputs — a canceled output produced nothing usable, no matter how
+     * far its encode got.
      *
      * @generated from field: optional double actual_cost = 11;
      */
@@ -6851,8 +8026,21 @@ declare class Job extends Message<Job> {
      */
     totalEstimatedCost?: number;
     /**
-     * Total actual cost (sum of completed/canceled outputs).
-     * Failed outputs contribute zero to this total.
+     * Total actual cost — what the job is billed, in the job's currency.
+     *
+     * Only completed outputs are billable, and what happened to the job as a
+     * whole decides whether they are billed at all:
+     *   - completed: the sum of its outputs' actual costs, raised to
+     *     minimum_charge_eur if that minimum is in effect.
+     *   - canceled: the sum of the outputs that had already completed and been
+     *     delivered when the cancel landed. Identical whether the job was
+     *     canceled through CancelJob or observed as canceled by the worker. The
+     *     minimum charge never applies.
+     *   - failed: zero. A job that ends failed is not billed, even if some of
+     *     its outputs completed before the failure.
+     *   - partial: the sum of the outputs that completed, un-floored.
+     * Additive fees (see fees) are included on top, and are charged only on jobs
+     * that ended completed or partial.
      *
      * @generated from field: optional double total_actual_cost = 9;
      */
@@ -6954,6 +8142,16 @@ declare class Job extends Message<Job> {
      * @generated from field: repeated transcodely.v1.ThumbnailResult thumbnail_results = 28;
      */
     thumbnailResults: ThumbnailResult[];
+    /**
+     * Generated/processed subtitle artifacts (populated after the job
+     * completes). Each entry carries the worker-built storage `url` plus the
+     * `output_id` it was configured on. Auto-generated captions (operation
+     * generate) additionally expose a segment-level transcript. Mirrors how
+     * JobOutput.output_url surfaces rendition results.
+     *
+     * @generated from field: repeated transcodely.v1.SubtitleResult subtitle_results = 32;
+     */
+    subtitleResults: SubtitleResult[];
     /**
      * Job-level output path template (echoed from request).
      * Variables: {job_id}, {output_id}, {date}, {timestamp}, {codec}, {resolution}, {format}, {quality}, {output_index}, {uuid}
@@ -6972,6 +8170,72 @@ declare class Job extends Message<Job> {
      * @generated from field: string object = 27;
      */
     object: string;
+    /**
+     * Minimum charge for this job in EUR, locked at creation and never changed
+     * retroactively. It is derived from the job's assigned billing class — a size
+     * band (small/medium/large/extra-large) reflecting the compute the job is
+     * guaranteed to cover — or, in legacy configurations, from the recommended
+     * machine size; either way it is a stable quote, not re-derived from the
+     * machine the job ultimately runs on. When the minimum charge is in effect,
+     * the billed total for a successfully completed job is
+     * max(sum of output costs, minimum_charge_eur) — see minimum_charge_applied
+     * for whether it determined this job's total. The minimum applies only to
+     * jobs that reach completed: a failed job is billed zero, and a canceled or
+     * partial job is billed the un-floored sum of the outputs it did complete.
+     * Absent when no minimum was computed for this job.
+     *
+     * @generated from field: optional double minimum_charge_eur = 30;
+     */
+    minimumChargeEur?: number;
+    /**
+     * Whether minimum_charge_eur determined the job's most recently computed
+     * total — true when the sum of output costs came in below the minimum and
+     * the total was raised to it (estimated total after probe; actual total
+     * after successful completion). When true, total_estimated_cost or
+     * total_actual_cost exceeds the sum of the per-output cost fields, which
+     * are never raised themselves. The minimum is a stable quote locked at
+     * creation (from the job's billing class, or the recommended machine size in
+     * legacy configurations); it is never re-derived from the machine the job
+     * ultimately runs on.
+     *
+     * @generated from field: bool minimum_charge_applied = 31;
+     */
+    minimumChargeApplied: boolean;
+    /**
+     * Additive fee line items (v1: AI caption generation). Fees are charged ON
+     * TOP of the encode bill and sit OUTSIDE the minimum-charge floor:
+     * billed total = max(sum of output costs, minimum_charge_eur) + sum of fees.
+     * total_estimated_cost / total_actual_cost INCLUDE fees; this list exposes
+     * the decomposition. Only live fees are listed — a fee that was voided
+     * (job failed/canceled, or the artifact was never produced) is dropped
+     * from the list and never charged. Server-set; read-only.
+     *
+     * @generated from field: repeated transcodely.v1.JobFee fees = 33;
+     */
+    fees: JobFee[];
+    /**
+     * Hosted video ID used as the input source (video mode), echoed from the
+     * request. Empty when the job was created with input_url or
+     * input_origin_id. Server-set; read-only.
+     *
+     * @generated from field: string input_video_id = 34;
+     */
+    inputVideoId: string;
+    /**
+     * Auto-generated chapter tracks, one per output whose generated caption track
+     * had chapters enabled (SubtitleTrack.generate_chapters). Not yet populated:
+     * the auto-chapters feature is rolling out together with generated captions.
+     *
+     * @generated from field: repeated transcodely.v1.ChapterResult chapter_results = 35;
+     */
+    chapterResults: ChapterResult[];
+    /**
+     * Clip range this job encodes (echoed from request). Absent when the job
+     * encodes the full input.
+     *
+     * @generated from field: optional transcodely.v1.ClipConfig clip = 36;
+     */
+    clip?: ClipConfig;
     constructor(data?: PartialMessage<Job>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.Job";
@@ -6981,6 +8245,120 @@ declare class Job extends Message<Job> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Job;
     static equals(a: Job | PlainMessage<Job> | undefined, b: Job | PlainMessage<Job> | undefined): boolean;
 }
+/**
+ * A single additive fee line item on a job (see Job.fees). Fees are metered
+ * charges for services performed alongside the encode (v1: AI caption
+ * generation at EUR 0.05 per source minute). A fee is charged once per job,
+ * estimated when the input probe supplies the source duration, and only
+ * billed when the completion report shows the fee's artifact was actually
+ * produced (no artifact, no fee). Fees are never absorbed by the per-job
+ * minimum charge: billed total = max(sum of output costs, minimum_charge_eur)
+ * + sum of fees. Read-only.
+ *
+ * @generated from message transcodely.v1.JobFee
+ */
+declare class JobFee extends Message<JobFee> {
+    /**
+     * Fee discriminator — the fee pricing rule's key. v1: "captions".
+     *
+     * @generated from field: string fee_type = 1;
+     */
+    feeType: string;
+    /**
+     * Human-readable description of what the fee is for
+     * (e.g., "AI Caption Generation").
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * Metering unit. v1: "source_minute" (input duration in minutes).
+     *
+     * @generated from field: string unit = 3;
+     */
+    unit: string;
+    /**
+     * Metered quantity in `unit`s — the exact fraction, e.g. a 90-second
+     * source is 1.5 source minutes. 0 until the input probe completes.
+     *
+     * @generated from field: double quantity = 4;
+     */
+    quantity: number;
+    /**
+     * Price per unit in `currency`, locked at job creation from the
+     * then-effective fee pricing rule (e.g., 0.05).
+     *
+     * @generated from field: double rate = 5;
+     */
+    rate: number;
+    /**
+     * quantity x rate, in `currency`. 0 until the input probe completes.
+     *
+     * @generated from field: double amount = 6;
+     */
+    amount: number;
+    /**
+     * Currency for rate/amount (ISO 4217 code, e.g., "EUR"). Matches the
+     * job-level currency field.
+     *
+     * @generated from field: string currency = 7;
+     */
+    currency: string;
+    constructor(data?: PartialMessage<JobFee>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.JobFee";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): JobFee;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): JobFee;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): JobFee;
+    static equals(a: JobFee | PlainMessage<JobFee> | undefined, b: JobFee | PlainMessage<JobFee> | undefined): boolean;
+}
+/**
+ * ClipConfig selects a sub-range of the input to encode instead of the full
+ * duration. Applies to the whole job: every output is encoded from the
+ * clipped range, and thumbnails/sprites are computed within it. Cuts are
+ * frame-accurate (outputs are always re-encoded). Billing keys off the
+ * produced output duration, so clipping reduces cost accordingly (the
+ * per-job minimum charge, when in effect, still applies).
+ *
+ * Bounds are stored with 0.1ms (4-decimal) precision; finer-grained values
+ * are rounded. The minimum clip length is 1ms. A clip of {0, 0} is treated
+ * as no clip (encode the full input).
+ *
+ * @generated from message transcodely.v1.ClipConfig
+ */
+declare class ClipConfig extends Message<ClipConfig> {
+    /**
+     * Where the clip starts, in seconds from the beginning of the input.
+     * Default 0 (start of input). Must be within the input's duration:
+     * validated against the probed duration, failing the job with error code
+     * `input_clip_out_of_range` when out of range.
+     * The upper bound is a CEL expression rather than double.lte: combining
+     * gte+lte trips a broken double.gte_lte composite rule in the pinned
+     * protovalidate-go ("no such attribute(s): rules").
+     *
+     * @generated from field: double start_seconds = 1;
+     */
+    startSeconds: number;
+    /**
+     * Where the clip ends, in seconds from the beginning of the input.
+     * 0 (or unset) means end of input. When set, must be at least 0.001s
+     * greater than start_seconds and no greater than the probed input
+     * duration; otherwise the job fails at probe time with error code
+     * `input_clip_out_of_range`.
+     *
+     * @generated from field: double end_seconds = 2;
+     */
+    endSeconds: number;
+    constructor(data?: PartialMessage<ClipConfig>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ClipConfig";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ClipConfig;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ClipConfig;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ClipConfig;
+    static equals(a: ClipConfig | PlainMessage<ClipConfig> | undefined, b: ClipConfig | PlainMessage<ClipConfig> | undefined): boolean;
+}
 /**
  * Request to create a new job.
  *
@@ -7011,6 +8389,18 @@ declare class CreateJobRequest extends Message<CreateJobRequest> {
      * @generated from field: optional string input_path = 10;
      */
     inputPath?: string;
+    /**
+     * Hosted video ID to use as the input source (video mode).
+     * The job's input is resolved server-side from the referenced video's
+     * original source (falling back to its highest-bitrate rendition if the
+     * ingest source is gone). Outputs are written to the video's managed
+     * storage and linked to it. Use this OR input_url OR input_origin_id.
+     * Primarily for retro-captioning an existing hosted video with a
+     * captions-only output.
+     *
+     * @generated from field: optional string input_video_id = 13;
+     */
+    inputVideoId?: string;
     /**
      * Origin ID for outputs (origin mode).
      * If specified, all outputs will be written to this origin.
@@ -7026,7 +8416,8 @@ declare class CreateJobRequest extends Message<CreateJobRequest> {
      */
     outputs: OutputSpec[];
     /**
-     * Job priority (affects processing order and cost).
+     * Job priority (affects worker selection and scheduling order; has no
+     * effect on cost — pricing is driven by codec/resolution/framerate/quality).
      *
      * @generated from field: transcodely.v1.JobPriority priority = 3;
      */
@@ -7105,6 +8496,14 @@ declare class CreateJobRequest extends Message<CreateJobRequest> {
      * @generated from field: optional string app_id = 21;
      */
     appId?: string;
+    /**
+     * Encode only a sub-range of the input (job-level; applies to all outputs).
+     * Omit to encode the full input. See ClipConfig for range semantics and
+     * probe-time validation.
+     *
+     * @generated from field: optional transcodely.v1.ClipConfig clip = 22;
+     */
+    clip?: ClipConfig;
     constructor(data?: PartialMessage<CreateJobRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.CreateJobRequest";
@@ -7186,11 +8585,14 @@ declare class GetJobResponse extends Message<GetJobResponse> {
 /**
  * Request to list jobs.
  *
+ * Filters combine with AND: a job is returned only if it satisfies every filter
+ * supplied on the request. Omitted filters are not applied.
+ *
  * @generated from message transcodely.v1.ListJobsRequest
  */
 declare class ListJobsRequest extends Message<ListJobsRequest> {
     /**
-     * Optional status filter.
+     * Optional status filter. Superseded by `statuses` — see that field.
      *
      * @generated from field: optional transcodely.v1.JobStatus status = 1;
      */
@@ -7210,6 +8612,45 @@ declare class ListJobsRequest extends Message<ListJobsRequest> {
      * @generated from field: optional string app_id = 3;
      */
     appId?: string;
+    /**
+     * Only include jobs created at or after this timestamp (RFC 3339). Inclusive.
+     *
+     * @generated from field: optional google.protobuf.Timestamp created_after = 4;
+     */
+    createdAfter?: Timestamp;
+    /**
+     * Only include jobs created at or before this timestamp (RFC 3339). Inclusive.
+     *
+     * @generated from field: optional google.protobuf.Timestamp created_before = 5;
+     */
+    createdBefore?: Timestamp;
+    /**
+     * Filter by several statuses at once: a job matches if its status is any one
+     * of the listed values (OR within the field), e.g. [failed, canceled] to list
+     * everything that did not finish.
+     *
+     * Precedence: when this field is non-empty it replaces `status` entirely and
+     * `status` is ignored — the two are never intersected. Send one or the other.
+     * `status` remains supported for existing clients.
+     *
+     * @generated from field: repeated transcodely.v1.JobStatus statuses = 6;
+     */
+    statuses: JobStatus[];
+    /**
+     * Filter on the job's user-provided metadata (the `metadata` map supplied at
+     * create time). Every pair must be present on the job with exactly that value
+     * (AND across pairs); a job carrying additional metadata keys still matches.
+     * Values are compared as exact strings — no prefix, range, or wildcard match.
+     * Jobs created without metadata never match a non-empty filter.
+     *
+     * Example: {"batch": "2026-07", "tenant": "acme"} returns only jobs tagged
+     * with both.
+     *
+     * @generated from field: map<string, string> metadata = 7;
+     */
+    metadata: {
+        [key: string]: string;
+    };
     constructor(data?: PartialMessage<ListJobsRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.ListJobsRequest";
@@ -7459,7 +8900,11 @@ declare enum VideoVisibility {
      */
     UNLISTED = 2,
     /**
-     * Requires authentication to view.
+     * Not playable via the public player or embed: the player page returns 404 and
+     * embed_url/embed_code are never populated. Authenticated API reads
+     * (VideoService.Get/List/Watch) for the owning app DO return signed, expiring
+     * playback_url/poster_url once the video is "ready", so the owner can watch a
+     * private video via the API even though it stays off the public player.
      *
      * @generated from enum value: VIDEO_VISIBILITY_PRIVATE = 3;
      */
@@ -7484,7 +8929,8 @@ declare class Video extends Message<Video> {
      */
     appId: string;
     /**
-     * How the video was created: "upload" (direct upload) or "job" (from transcoding job).
+     * How the video was created: "upload" (direct upload or CreateFromUrl ingest)
+     * or "job" (from a managed transcoding job created via JobService.Create).
      *
      * @generated from field: string source = 3;
      */
@@ -7540,20 +8986,38 @@ declare class Video extends Message<Video> {
      */
     preset?: string;
     /**
-     * Playback (computed per-request, not stored — signed CDN tokens).
+     * Playback surface — all computed per-request and never stored. Populated for
+     * "ready" videos of any visibility (public, unlisted, and — on authenticated
+     * owner reads — private); absent otherwise. On apps with CDN token auth
+     * enabled the URL is signed and expiring (HMAC token + expiry query params);
+     * it is re-issued on every read, so clients should use the value from the
+     * latest response rather than caching it. On apps not yet migrated to token
+     * auth the URL is unsigned and access control comes from the managed-storage
+     * bucket policy; unsigned URLs are never issued for private videos.
      *
      * @generated from field: optional string playback_url = 20;
      */
     playbackUrl?: string;
     /**
+     * Public embed surface — populated only for playable videos (status "ready"
+     * and NOT private). Always absent for private videos.
+     *
      * @generated from field: optional string embed_url = 21;
      */
     embedUrl?: string;
     /**
+     * Ready-to-paste responsive HTML embed snippet: a 16:9 aspect-ratio wrapper
+     * div containing a lazy-loaded, borderless <iframe src=embed_url> that fills
+     * its container (no fixed width/height). Same population rules as embed_url.
+     *
      * @generated from field: optional string embed_code = 22;
      */
     embedCode?: string;
     /**
+     * Poster image URL, resolved from the worker-reported poster key. Signed and
+     * expiring on token-auth apps, unsigned otherwise — same rules and per-request
+     * re-issuance as playback_url. Absent when the video has no generated poster.
+     *
      * @generated from field: optional string poster_url = 23;
      */
     posterUrl?: string;
@@ -7561,12 +9025,36 @@ declare class Video extends Message<Video> {
      * @generated from field: optional double duration_seconds = 24;
      */
     durationSeconds?: number;
+    /**
+     * Animated hover-preview URLs, populated when the video was created with
+     * hover_previews enabled and its transcode produced the animated artifacts.
+     * Same resolution and per-request re-issuance rules as poster_url: signed and
+     * expiring on token-auth apps, unsigned otherwise, absent for private videos
+     * without a signable key. hover_preview_url is the animated WebP; the muted
+     * MP4 loop rides hover_preview_mp4_url. Either may be absent (e.g. the WebP is
+     * skipped for previews longer than 10 s). Field numbers 44/45.
+     *
+     * @generated from field: optional string hover_preview_url = 44;
+     */
+    hoverPreviewUrl?: string;
+    /**
+     * @generated from field: optional string hover_preview_mp4_url = 45;
+     */
+    hoverPreviewMp4Url?: string;
     /**
      * Renditions available for playback.
      *
      * @generated from field: repeated transcodely.v1.VideoRendition renditions = 25;
      */
     renditions: VideoRendition[];
+    /**
+     * Caption/subtitle tracks attached to this video, in the order they were
+     * attached. Populated for videos whose transcode produced caption files —
+     * either in the same job or by a later captions-only job. Empty otherwise.
+     *
+     * @generated from field: repeated transcodely.v1.VideoTextTrack text_tracks = 49;
+     */
+    textTracks: VideoTextTrack[];
     /**
      * Storage and cost transparency.
      *
@@ -7591,6 +9079,31 @@ declare class Video extends Message<Video> {
      * @generated from field: optional google.protobuf.Timestamp ready_at = 42;
      */
     readyAt?: Timestamp;
+    /**
+     * Source lifecycle (managed hosting only). These concern ONLY the original
+     * uploaded source file; renditions and playback are never affected.
+     *
+     * Whether this video's source file is exempt from the app's
+     * delete_source_after_days lifecycle rule. Set via UpdateVideo.
+     *
+     * @generated from field: bool source_pinned = 46;
+     */
+    sourcePinned: boolean;
+    /**
+     * When the source file is scheduled to be deleted by the app's
+     * delete_source_after_days rule. Server-set, read-only; present only while a
+     * deletion is scheduled (cleared on pin, on setting change, and on delete).
+     *
+     * @generated from field: optional google.protobuf.Timestamp source_scheduled_for_deletion_at = 47;
+     */
+    sourceScheduledForDeletionAt?: Timestamp;
+    /**
+     * When the source file was deleted by the lifecycle rule. Server-set,
+     * read-only. Once set, re-processing falls back to the best rendition.
+     *
+     * @generated from field: optional google.protobuf.Timestamp source_deleted_at = 48;
+     */
+    sourceDeletedAt?: Timestamp;
     /**
      * Resource type discriminator. Always "video" for this message.
      * Lets webhook consumers and polyglot SDKs identify the resource without
@@ -7651,19 +9164,103 @@ declare class VideoRendition extends Message<VideoRendition> {
      */
     height: number;
     /**
-     * Encoded file size in bytes.
+     * Encoded file size in bytes.
+     *
+     * @generated from field: int64 size_bytes = 7;
+     */
+    sizeBytes: bigint;
+    constructor(data?: PartialMessage<VideoRendition>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.VideoRendition";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): VideoRendition;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): VideoRendition;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): VideoRendition;
+    static equals(a: VideoRendition | PlainMessage<VideoRendition> | undefined, b: VideoRendition | PlainMessage<VideoRendition> | undefined): boolean;
+}
+/**
+ * A caption/subtitle track attached to a video for playback.
+ *
+ * @generated from message transcodely.v1.VideoTextTrack
+ */
+declare class VideoTextTrack extends Message<VideoTextTrack> {
+    /**
+     * Unique text track identifier (e.g., "trk_a1b2c3d4e5f6g7").
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Track role, as understood by players: "subtitles", "captions", "chapters",
+     * or "descriptions".
+     *
+     * @generated from field: string kind = 2;
+     */
+    kind: string;
+    /**
+     * Language of the track: the ISO 639-2 code that was requested, or the code
+     * detected by speech recognition when the track was generated with "auto".
+     * Empty when the producing job recorded no language.
+     *
+     * @generated from field: string language = 3;
+     */
+    language: string;
+    /**
+     * Human-readable track label shown in the player's caption menu (e.g.
+     * "English"). Empty when none was supplied.
+     *
+     * @generated from field: string label = 4;
+     */
+    label: string;
+    /**
+     * Subtitle file format: "webvtt", "srt", "ttml", or "ass".
+     *
+     * @generated from field: string format = 5;
+     */
+    format: string;
+    /**
+     * Whether the track was produced by speech recognition (a subtitle track with
+     * the "generate" operation) rather than supplied or extracted from the source.
+     *
+     * @generated from field: bool auto_generated = 6;
+     */
+    autoGenerated: boolean;
+    /**
+     * Whether the track is already listed inside the video's HLS/DASH manifest.
+     * When true, players discover it from the manifest during normal playback and
+     * must NOT also attach it as a separate track — doing so lists the language
+     * twice. False for tracks produced by a captions-only job that ran after the
+     * transcode, which are attached as sidecar files instead.
+     *
+     * @generated from field: bool in_manifest = 7;
+     */
+    inManifest: boolean;
+    /**
+     * URL of the caption file. Computed per-request and never stored: on apps with
+     * CDN token auth enabled it is signed and expiring, and it is re-issued on
+     * every read, so clients should use the value from the latest response rather
+     * than caching it. On apps not yet migrated to token auth it is unsigned and
+     * access control comes from the managed-storage bucket policy; unsigned URLs
+     * are never issued for private videos. Absent when no URL may be issued —
+     * same rules as poster_url.
+     *
+     * @generated from field: optional string url = 8;
+     */
+    url?: string;
+    /**
+     * When the track was attached to the video.
      *
-     * @generated from field: int64 size_bytes = 7;
+     * @generated from field: google.protobuf.Timestamp created_at = 9;
      */
-    sizeBytes: bigint;
-    constructor(data?: PartialMessage<VideoRendition>);
+    createdAt?: Timestamp;
+    constructor(data?: PartialMessage<VideoTextTrack>);
     static readonly runtime: typeof proto3;
-    static readonly typeName = "transcodely.v1.VideoRendition";
+    static readonly typeName = "transcodely.v1.VideoTextTrack";
     static readonly fields: FieldList;
-    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): VideoRendition;
-    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): VideoRendition;
-    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): VideoRendition;
-    static equals(a: VideoRendition | PlainMessage<VideoRendition> | undefined, b: VideoRendition | PlainMessage<VideoRendition> | undefined): boolean;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): VideoTextTrack;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): VideoTextTrack;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): VideoTextTrack;
+    static equals(a: VideoTextTrack | PlainMessage<VideoTextTrack> | undefined, b: VideoTextTrack | PlainMessage<VideoTextTrack> | undefined): boolean;
 }
 /**
  * Request to create a presigned upload URL for direct client upload.
@@ -7672,7 +9269,8 @@ declare class VideoRendition extends Message<VideoRendition> {
  */
 declare class CreateUploadRequest extends Message<CreateUploadRequest> {
     /**
-     * App to create the video under. Required — must have hosting enabled.
+     * App to create the video under. Required. The app must have managed hosting
+     * enabled (AppService.EnableHosting) or the call fails with FailedPrecondition.
      *
      * @generated from field: string app_id = 8;
      */
@@ -7714,7 +9312,7 @@ declare class CreateUploadRequest extends Message<CreateUploadRequest> {
      */
     tags: string[];
     /**
-     * Visibility setting. Defaults to "private" if not specified.
+     * Visibility setting. Defaults to "unlisted" if not specified.
      *
      * @generated from field: optional string visibility = 7;
      */
@@ -7729,6 +9327,15 @@ declare class CreateUploadRequest extends Message<CreateUploadRequest> {
      * @generated from field: optional string preset = 9;
      */
     preset?: string;
+    /**
+     * When true, attach an animated hover-preview (mode=animated, worker smart
+     * defaults: ~4 s, 12 fps, 320 px) to the managed transcode, in addition to the
+     * poster. Free — animated previews add no cost. The produced WebP/MP4 loop
+     * surface as Video.hover_preview_url / hover_preview_mp4_url once ready.
+     *
+     * @generated from field: bool hover_previews = 10;
+     */
+    hoverPreviews: boolean;
     constructor(data?: PartialMessage<CreateUploadRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.CreateUploadRequest";
@@ -7813,6 +9420,102 @@ declare class CompleteUploadResponse extends Message<CompleteUploadResponse> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CompleteUploadResponse;
     static equals(a: CompleteUploadResponse | PlainMessage<CompleteUploadResponse> | undefined, b: CompleteUploadResponse | PlainMessage<CompleteUploadResponse> | undefined): boolean;
 }
+/**
+ * Request to create a hosted video from a remote URL (one-call ingest).
+ *
+ * @generated from message transcodely.v1.CreateFromUrlRequest
+ */
+declare class CreateFromUrlRequest extends Message<CreateFromUrlRequest> {
+    /**
+     * App to create the video under. Required. The app must have managed hosting
+     * enabled (AppService.EnableHosting) or the call fails with FailedPrecondition.
+     *
+     * @generated from field: string app_id = 1;
+     */
+    appId: string;
+    /**
+     * Publicly-reachable source URL to ingest. Must be http:// or https:// —
+     * storage-origin schemes (gs://, s3://) are not accepted here; use an origin
+     * and JobService.Create for those. The URL is fetched by the worker at
+     * transcode time (the API never fetches it); private/internal addresses are
+     * rejected up front and again, authoritatively, at fetch time (SSRF defense).
+     *
+     * @generated from field: string url = 2;
+     */
+    url: string;
+    /**
+     * Optional title for the video.
+     *
+     * @generated from field: optional string title = 3;
+     */
+    title?: string;
+    /**
+     * Optional description.
+     *
+     * @generated from field: optional string description = 4;
+     */
+    description?: string;
+    /**
+     * Optional tags for categorization (max 20).
+     *
+     * @generated from field: repeated string tags = 5;
+     */
+    tags: string[];
+    /**
+     * Visibility setting. Defaults to "unlisted" if not specified.
+     *
+     * @generated from field: optional string visibility = 6;
+     */
+    visibility?: string;
+    /**
+     * Optional preset reference for the auto-transcode job.
+     * Accepts either a preset ID (e.g., "pst_abc123") or slug (e.g., "gaming_1080p_60_standard").
+     * When provided, the preset's settings drive the encoding instead of the
+     * app's default auto-profile ABR ladder.
+     *
+     * @generated from field: optional string preset = 7;
+     */
+    preset?: string;
+    /**
+     * When true, attach an animated hover-preview (mode=animated, worker smart
+     * defaults) to the managed transcode, in addition to the poster. Free. The
+     * produced loop surfaces as Video.hover_preview_url / hover_preview_mp4_url.
+     *
+     * @generated from field: bool hover_previews = 8;
+     */
+    hoverPreviews: boolean;
+    constructor(data?: PartialMessage<CreateFromUrlRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.CreateFromUrlRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CreateFromUrlRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CreateFromUrlRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CreateFromUrlRequest;
+    static equals(a: CreateFromUrlRequest | PlainMessage<CreateFromUrlRequest> | undefined, b: CreateFromUrlRequest | PlainMessage<CreateFromUrlRequest> | undefined): boolean;
+}
+/**
+ * Response from creating a video from a URL.
+ *
+ * @generated from message transcodely.v1.CreateFromUrlResponse
+ */
+declare class CreateFromUrlResponse extends Message<CreateFromUrlResponse> {
+    /**
+     * The created video (status: "processing"). No video.uploaded event fires for
+     * URL ingest (no bytes are uploaded); the job lifecycle plus video.ready /
+     * video.failed cover the outcome.
+     *
+     * @generated from field: transcodely.v1.Video video = 1;
+     */
+    video?: Video;
+    constructor(data?: PartialMessage<CreateFromUrlResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.CreateFromUrlResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CreateFromUrlResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CreateFromUrlResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CreateFromUrlResponse;
+    static equals(a: CreateFromUrlResponse | PlainMessage<CreateFromUrlResponse> | undefined, b: CreateFromUrlResponse | PlainMessage<CreateFromUrlResponse> | undefined): boolean;
+}
 /**
  * A single part in a multipart upload with its presigned URL.
  *
@@ -7874,7 +9577,8 @@ declare class CompletedPart extends Message<CompletedPart> {
  */
 declare class CreateMultipartUploadRequest extends Message<CreateMultipartUploadRequest> {
     /**
-     * App to create the video under. Required — must have hosting enabled.
+     * App to create the video under. Required. The app must have managed hosting
+     * enabled (AppService.EnableHosting) or the call fails with FailedPrecondition.
      *
      * @generated from field: string app_id = 1;
      */
@@ -7941,6 +9645,14 @@ declare class CreateMultipartUploadRequest extends Message<CreateMultipartUpload
      * @generated from field: optional string preset = 14;
      */
     preset?: string;
+    /**
+     * When true, attach an animated hover-preview (mode=animated, worker smart
+     * defaults) to the managed transcode, in addition to the poster. Free. The
+     * produced loop surfaces as Video.hover_preview_url / hover_preview_mp4_url.
+     *
+     * @generated from field: bool hover_previews = 15;
+     */
+    hoverPreviews: boolean;
     constructor(data?: PartialMessage<CreateMultipartUploadRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.CreateMultipartUploadRequest";
@@ -8288,7 +10000,9 @@ declare class UpdateVideoRequest extends Message<UpdateVideoRequest> {
      */
     description?: string;
     /**
-     * Updated tags (replaces existing tags).
+     * Updated tags (replaces existing tags). Because proto3 repeated fields carry
+     * no presence, an empty list is indistinguishable from "unset" on the wire
+     * and leaves existing tags unchanged. To remove all tags, set clear_tags.
      *
      * @generated from field: repeated string tags = 4;
      */
@@ -8299,6 +10013,21 @@ declare class UpdateVideoRequest extends Message<UpdateVideoRequest> {
      * @generated from field: optional string visibility = 5;
      */
     visibility?: string;
+    /**
+     * Set to true to remove all tags. Mutually exclusive with tags.
+     *
+     * @generated from field: optional bool clear_tags = 6;
+     */
+    clearTags?: boolean;
+    /**
+     * Pin or unpin this video's source file against the app's
+     * delete_source_after_days lifecycle rule. Pinning also immediately clears any
+     * pending deletion schedule. Unpinning does NOT reschedule — the sweeper
+     * re-evaluates later with a fresh warning webhook.
+     *
+     * @generated from field: optional bool source_pinned = 7;
+     */
+    sourcePinned?: boolean;
     constructor(data?: PartialMessage<UpdateVideoRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.UpdateVideoRequest";
@@ -8508,6 +10237,19 @@ declare class UsageSummary extends Message<UsageSummary> {
      * @generated from field: string currency = 31;
      */
     currency: string;
+    /**
+     * Per-day usage breakdown for the billing period identified by
+     * billing_month, oldest day first. With a billing anchor day other than 1,
+     * the period spans into the following calendar month, so dates are not
+     * limited to the named month. Only days with recorded activity are present
+     * (no zero-fill): a day is omitted when it had no storage snapshot, no
+     * egress, and no video encoded. Powers the dashboard's usage-trend charts.
+     * Populated for both app-scoped and org-scoped (aggregated across the
+     * org's apps) calls.
+     *
+     * @generated from field: repeated transcodely.v1.DailyUsage daily = 40;
+     */
+    daily: DailyUsage[];
     constructor(data?: PartialMessage<UsageSummary>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.UsageSummary";
@@ -8517,6 +10259,311 @@ declare class UsageSummary extends Message<UsageSummary> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): UsageSummary;
     static equals(a: UsageSummary | PlainMessage<UsageSummary> | undefined, b: UsageSummary | PlainMessage<UsageSummary> | undefined): boolean;
 }
+/**
+ * One calendar day's slice of usage within a billing period (see
+ * UsageSummary.daily for period semantics). All monetary fields are in the
+ * parent UsageSummary's `currency`.
+ *
+ * @generated from message transcodely.v1.DailyUsage
+ */
+declare class DailyUsage extends Message<DailyUsage> {
+    /**
+     * Calendar day in YYYY-MM-DD format (UTC).
+     *
+     * @generated from field: string date = 1;
+     */
+    date: string;
+    /**
+     * Total stored bytes as of this day's snapshot. Point-in-time (the day's
+     * recorded storage level), not an increment over the prior day. Zero when
+     * no snapshot was taken that day.
+     *
+     * @generated from field: int64 storage_bytes = 2;
+     */
+    storageBytes: bigint;
+    /**
+     * Bytes egressed during this day (sum of the day's hourly egress records).
+     *
+     * @generated from field: int64 egress_bytes = 3;
+     */
+    egressBytes: bigint;
+    /**
+     * CDN requests served during this day (sum of the day's hourly records).
+     *
+     * @generated from field: int64 request_count = 4;
+     */
+    requestCount: bigint;
+    /**
+     * Encoding cost for videos created on this day, derived from the linked
+     * transcoding jobs' actual cost. Zero when no billable video was created.
+     *
+     * @generated from field: double encoding_cost = 5;
+     */
+    encodingCost: number;
+    constructor(data?: PartialMessage<DailyUsage>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.DailyUsage";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): DailyUsage;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): DailyUsage;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): DailyUsage;
+    static equals(a: DailyUsage | PlainMessage<DailyUsage> | undefined, b: DailyUsage | PlainMessage<DailyUsage> | undefined): boolean;
+}
+/**
+ * Request for a single video's playback stats.
+ *
+ * @generated from message transcodely.v1.GetStatsRequest
+ */
+declare class GetStatsRequest extends Message<GetStatsRequest> {
+    /**
+     * Video ID to fetch stats for.
+     *
+     * @generated from field: string video_id = 1;
+     */
+    videoId: string;
+    /**
+     * Optional inclusive start of the UTC date range, YYYY-MM-DD (e.g.
+     * "2026-07-01"). Omitted means unbounded (all retained history).
+     *
+     * @generated from field: optional string start_date = 2;
+     */
+    startDate?: string;
+    /**
+     * Optional inclusive end of the UTC date range, YYYY-MM-DD. Omitted means
+     * unbounded (up to today).
+     *
+     * @generated from field: optional string end_date = 3;
+     */
+    endDate?: string;
+    constructor(data?: PartialMessage<GetStatsRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetStatsRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetStatsRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetStatsRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetStatsRequest;
+    static equals(a: GetStatsRequest | PlainMessage<GetStatsRequest> | undefined, b: GetStatsRequest | PlainMessage<GetStatsRequest> | undefined): boolean;
+}
+/**
+ * Response with a video's daily playback stats and range totals.
+ *
+ * @generated from message transcodely.v1.GetStatsResponse
+ */
+declare class GetStatsResponse extends Message<GetStatsResponse> {
+    /**
+     * Per-day rows within the requested range, oldest day first. Only days with
+     * recorded activity are present (no zero-fill).
+     *
+     * @generated from field: repeated transcodely.v1.VideoStatsDay daily = 1;
+     */
+    daily: VideoStatsDay[];
+    /**
+     * Totals across the returned days.
+     *
+     * @generated from field: transcodely.v1.VideoStatsTotals totals = 2;
+     */
+    totals?: VideoStatsTotals;
+    constructor(data?: PartialMessage<GetStatsResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetStatsResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetStatsResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetStatsResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetStatsResponse;
+    static equals(a: GetStatsResponse | PlainMessage<GetStatsResponse> | undefined, b: GetStatsResponse | PlainMessage<GetStatsResponse> | undefined): boolean;
+}
+/**
+ * One UTC day of playback stats for a video.
+ *
+ * @generated from message transcodely.v1.VideoStatsDay
+ */
+declare class VideoStatsDay extends Message<VideoStatsDay> {
+    /**
+     * Calendar day in YYYY-MM-DD format (UTC).
+     *
+     * @generated from field: string date = 1;
+     */
+    date: string;
+    /**
+     * Number of playback starts (one 'play' beacon per pageview that began
+     * playing).
+     *
+     * @generated from field: int32 plays = 2;
+     */
+    plays: number;
+    /**
+     * Approximate watch time in seconds. Derived from playback heartbeats
+     * (heartbeat count × the ~10s heartbeat interval), not exact wall-clock
+     * time — a partial final interval still counts as a whole one.
+     *
+     * @generated from field: int64 watch_seconds = 3;
+     */
+    watchSeconds: bigint;
+    /**
+     * Distinct viewers, counted by an anonymous per-pageview session id (no PII).
+     *
+     * @generated from field: int32 unique_viewers = 4;
+     */
+    uniqueViewers: number;
+    constructor(data?: PartialMessage<VideoStatsDay>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.VideoStatsDay";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): VideoStatsDay;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): VideoStatsDay;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): VideoStatsDay;
+    static equals(a: VideoStatsDay | PlainMessage<VideoStatsDay> | undefined, b: VideoStatsDay | PlainMessage<VideoStatsDay> | undefined): boolean;
+}
+/**
+ * Aggregated playback totals over a date range.
+ *
+ * @generated from message transcodely.v1.VideoStatsTotals
+ */
+declare class VideoStatsTotals extends Message<VideoStatsTotals> {
+    /**
+     * Sum of daily plays.
+     *
+     * @generated from field: int32 plays = 1;
+     */
+    plays: number;
+    /**
+     * Sum of daily approximate watch seconds.
+     *
+     * @generated from field: int64 watch_seconds = 2;
+     */
+    watchSeconds: bigint;
+    /**
+     * Sum of per-day unique viewers. A viewer active on N distinct days counts N
+     * times (it is not de-duplicated across days); for a single-day range it is
+     * exact.
+     *
+     * @generated from field: int32 unique_viewers = 3;
+     */
+    uniqueViewers: number;
+    constructor(data?: PartialMessage<VideoStatsTotals>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.VideoStatsTotals";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): VideoStatsTotals;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): VideoStatsTotals;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): VideoStatsTotals;
+    static equals(a: VideoStatsTotals | PlainMessage<VideoStatsTotals> | undefined, b: VideoStatsTotals | PlainMessage<VideoStatsTotals> | undefined): boolean;
+}
+/**
+ * Request for an app's top videos by plays.
+ *
+ * @generated from message transcodely.v1.ListTopVideosRequest
+ */
+declare class ListTopVideosRequest extends Message<ListTopVideosRequest> {
+    /**
+     * Optional app filter. 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 the app to scope the leaderboard; omitted resolves
+     * to the org's first app.
+     *
+     * @generated from field: optional string app_id = 1;
+     */
+    appId?: string;
+    /**
+     * Optional inclusive UTC date range bounds, YYYY-MM-DD. Omitted means
+     * unbounded on that side.
+     *
+     * @generated from field: optional string start_date = 2;
+     */
+    startDate?: string;
+    /**
+     * @generated from field: optional string end_date = 3;
+     */
+    endDate?: string;
+    /**
+     * Maximum number of videos to return (1-100). Defaults to 10.
+     *
+     * @generated from field: optional int32 limit = 4;
+     */
+    limit?: number;
+    constructor(data?: PartialMessage<ListTopVideosRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListTopVideosRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListTopVideosRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListTopVideosRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListTopVideosRequest;
+    static equals(a: ListTopVideosRequest | PlainMessage<ListTopVideosRequest> | undefined, b: ListTopVideosRequest | PlainMessage<ListTopVideosRequest> | undefined): boolean;
+}
+/**
+ * Response with an app's ranked videos.
+ *
+ * @generated from message transcodely.v1.ListTopVideosResponse
+ */
+declare class ListTopVideosResponse extends Message<ListTopVideosResponse> {
+    /**
+     * Videos ordered by plays (then watch time) descending.
+     *
+     * @generated from field: repeated transcodely.v1.TopVideo items = 1;
+     */
+    items: TopVideo[];
+    constructor(data?: PartialMessage<ListTopVideosResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListTopVideosResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListTopVideosResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListTopVideosResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListTopVideosResponse;
+    static equals(a: ListTopVideosResponse | PlainMessage<ListTopVideosResponse> | undefined, b: ListTopVideosResponse | PlainMessage<ListTopVideosResponse> | undefined): boolean;
+}
+/**
+ * A single ranked video with its playback totals over the requested range.
+ *
+ * @generated from message transcodely.v1.TopVideo
+ */
+declare class TopVideo extends Message<TopVideo> {
+    /**
+     * Video ID.
+     *
+     * @generated from field: string video_id = 1;
+     */
+    videoId: string;
+    /**
+     * Video title, if set.
+     *
+     * @generated from field: optional string title = 2;
+     */
+    title?: string;
+    /**
+     * Poster image URL, computed from the app's CDN config. Absent when no CDN
+     * is configured or the video has no poster.
+     *
+     * @generated from field: optional string poster_url = 3;
+     */
+    posterUrl?: string;
+    /**
+     * Total plays over the range.
+     *
+     * @generated from field: int64 plays = 4;
+     */
+    plays: bigint;
+    /**
+     * Total approximate watch seconds over the range.
+     *
+     * @generated from field: int64 watch_seconds = 5;
+     */
+    watchSeconds: bigint;
+    /**
+     * Unique viewers over the range, summed per day (a viewer active on N days
+     * counts N times; exact for a single-day range). See VideoStatsTotals.
+     *
+     * @generated from field: int64 unique_viewers = 6;
+     */
+    uniqueViewers: bigint;
+    constructor(data?: PartialMessage<TopVideo>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.TopVideo";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): TopVideo;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): TopVideo;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): TopVideo;
+    static equals(a: TopVideo | PlainMessage<TopVideo> | undefined, b: TopVideo | PlainMessage<TopVideo> | undefined): boolean;
+}
 
 /**
  * Public types for the webhook surface — the discriminated union customers
@@ -8548,12 +10595,18 @@ interface EventBase {
     };
 }
 /**
- * Every event the platform may emit, discriminated by `type`. The final
- * `string` arm is intentional forward-compat: an older SDK receiving a
- * `type` the API has since added still parses; `data` is left as the raw
- * decoded JSON object and customers should handle it in a `default:` arm.
+ * Every event this SDK version knows, discriminated by `type`. Each arm's
+ * `data` is a decoded resource, so once an event is narrowed to this union —
+ * via {@link isKnownEvent} (then a `switch`) or {@link isEventType} — reading
+ * `event.data` yields the exact resource type.
+ *
+ * Kept free of any `string` catch-all arm on purpose: a `type: string` member
+ * is a supertype of every literal, so TypeScript keeps it live in every
+ * `case`, collapsing `data` back to `unknown` and defeating narrowing (the
+ * bug in transcodely-js#34). Forward-compat lives in the sibling
+ * {@link UnknownWebhookEvent} instead.
  */
-type WebhookEvent = (EventBase & {
+type KnownWebhookEvent = (EventBase & {
     type: "job.created";
     data: Job;
 }) | (EventBase & {
@@ -8583,9 +10636,18 @@ type WebhookEvent = (EventBase & {
 }) | (EventBase & {
     type: "video.uploaded";
     data: Video;
+}) | (EventBase & {
+    type: "video.ready";
+    data: Video;
+}) | (EventBase & {
+    type: "video.failed";
+    data: Video;
 }) | (EventBase & {
     type: "video.deleted";
     data: Video;
+}) | (EventBase & {
+    type: "video.source_scheduled_for_deletion";
+    data: Video;
 }) | (EventBase & {
     type: "app.created";
     data: App;
@@ -8593,11 +10655,60 @@ type WebhookEvent = (EventBase & {
     type: "app.updated";
     data: App;
 }) | (EventBase & {
+    type: "app.spend_limit_warning";
+    data: SpendLimitNotification;
+}) | (EventBase & {
+    type: "app.spend_limit_exceeded";
+    data: SpendLimitNotification;
+});
+/**
+ * Forward-compat arm: an event whose `type` this SDK version does not know
+ * because the API added it after this release. The envelope still verifies
+ * and parses; `data` is the raw decoded JSON object, left as `unknown` for the
+ * consumer to inspect. Handle it in the `else` branch of {@link isKnownEvent}
+ * or the `default:` of a `switch`.
+ */
+interface UnknownWebhookEvent extends EventBase {
     type: string;
     data: unknown;
-});
+}
 /**
- * The 13 concrete webhook event types the API can emit. Mirrors the source of
+ * A verified, decoded webhook event: the closed, precisely-typed
+ * {@link KnownWebhookEvent} union plus the open {@link UnknownWebhookEvent}
+ * forward-compat arm.
+ *
+ * This is a structural superset of `KnownWebhookEvent` — every known arm is
+ * still assignable to `WebhookEvent`, and `WebhookEvent["type"]` is still
+ * `string` — so code written against the previous single-union shape keeps
+ * compiling. To *narrow* by `type`, first funnel through {@link isKnownEvent}
+ * or {@link isEventType}; a bare `switch (event.type)` on the open union
+ * cannot narrow (see {@link KnownWebhookEvent}).
+ */
+type WebhookEvent = KnownWebhookEvent | UnknownWebhookEvent;
+/**
+ * Payload of the `app.spend_limit_warning` and `app.spend_limit_exceeded`
+ * events. Unlike the resource-carrying events, these carry a small notification
+ * object (snake_case, as delivered on the wire) rather than a resource snapshot,
+ * so `data` is the raw parsed JSON — it is not run through the resource codec.
+ */
+interface SpendLimitNotification {
+    /** The app the spend limit belongs to (`app_*`). */
+    app_id: string;
+    /** Inclusive start of the billing period, an RFC 3339 full-date in UTC (e.g. `"2026-01-01"`). */
+    period_start: string;
+    /** Exclusive end of the billing period, an RFC 3339 full-date in UTC (e.g. `"2026-02-01"`). */
+    period_end: string;
+    /** The app's monthly spend limit in EUR. */
+    limit_eur: number;
+    /** Recorded spend for the period in EUR at the time the event fired. */
+    spent_eur: number;
+    /** Threshold crossed: `80` for the warning event, `100` for the breach event. */
+    threshold_pct: 80 | 100;
+    /** Currency of the amounts in this payload. Always `"EUR"`. */
+    currency: "EUR";
+}
+/**
+ * The 18 concrete webhook event types the API can emit. Mirrors the source of
  * truth in `domain.WebhookEventTypes()` (api/internal/domain/webhook.go). The
  * `"*"` wildcard is a subscription-only value and is intentionally absent.
  *
@@ -8605,9 +10716,45 @@ type WebhookEvent = (EventBase & {
  * catalog-drift regression test can compare this set against the discriminated
  * union literals above.
  */
-declare const WEBHOOK_EVENT_TYPES: readonly ["job.created", "job.succeeded", "job.failed", "job.canceled", "job.progress", "output.created", "output.ready", "output.failed", "output.progress", "video.uploaded", "video.deleted", "app.created", "app.updated"];
+declare const WEBHOOK_EVENT_TYPES: readonly ["job.created", "job.succeeded", "job.failed", "job.canceled", "job.progress", "output.created", "output.ready", "output.failed", "output.progress", "video.uploaded", "video.ready", "video.failed", "video.deleted", "video.source_scheduled_for_deletion", "app.created", "app.updated", "app.spend_limit_warning", "app.spend_limit_exceeded"];
 /** A concrete event type the API can emit (excludes the `"*"` wildcard). */
 type WebhookEventType = (typeof WEBHOOK_EVENT_TYPES)[number];
+/**
+ * Narrow an event to the closed {@link KnownWebhookEvent} union, which this
+ * SDK version types precisely. Gate a `switch (event.type)` on it so each
+ * `case` narrows `event.data` to the right resource (with exhaustiveness
+ * checking); the `else` branch keeps {@link UnknownWebhookEvent} — a raw
+ * `data: unknown` — so events added to the API after this SDK release still
+ * flow through untyped rather than being dropped.
+ *
+ * @example
+ * ```ts
+ * if (Webhooks.isKnownEvent(event)) {
+ *   switch (event.type) {
+ *     case "job.succeeded":
+ *       console.log(event.data.id); // event.data is a fully-typed Job
+ *       break;
+ *   }
+ * } else {
+ *   console.log("unhandled future event", event.type);
+ * }
+ * ```
+ */
+declare function isKnownEvent(event: WebhookEvent): event is KnownWebhookEvent;
+/**
+ * Narrow an event to a single known type. Convenient for a receiver that only
+ * cares about one or two events and would rather not `switch`.
+ *
+ * @example
+ * ```ts
+ * if (Webhooks.isEventType(event, "output.ready")) {
+ *   console.log(event.data.outputUrl); // event.data is a fully-typed JobOutput
+ * }
+ * ```
+ */
+declare function isEventType<T extends WebhookEventType>(event: WebhookEvent, type: T): event is Extract<KnownWebhookEvent, {
+    type: T;
+}>;
 
 /**
  * Query and replay events. Each event the SDK hands back is the same
@@ -10883,6 +13030,11 @@ declare class Videos {
     constructor(transport: Transport);
     createUpload(req: PartialMessage<CreateUploadRequest>, opts?: CallOptions): Promise<CreateUploadResponse>;
     completeUpload(req: PartialMessage<CompleteUploadRequest>, opts?: CallOptions): Promise<CompleteUploadResponse>;
+    /** Create a hosted video from a publicly-reachable http(s) URL in one call —
+     * no separate upload step. Returns the video in "processing" status; the
+     * app must have managed hosting enabled. Playback/embed URLs populate once
+     * the video reaches "ready" (subscribe to `video.ready` or `watch`). */
+    createFromUrl(req: PartialMessage<CreateFromUrlRequest>, opts?: CallOptions): Promise<Video>;
     createMultipartUpload(req: PartialMessage<CreateMultipartUploadRequest>, opts?: CallOptions): Promise<CreateMultipartUploadResponse>;
     getUploadPartUrls(req: PartialMessage<GetUploadPartUrlsRequest>, opts?: CallOptions): Promise<GetUploadPartUrlsResponse>;
     completeMultipartUpload(req: PartialMessage<CompleteMultipartUploadRequest>, opts?: CallOptions): Promise<CompleteMultipartUploadResponse>;
@@ -10897,6 +13049,14 @@ declare class Videos {
         includeHeartbeats?: boolean;
     }): AsyncIterable<WatchVideoResponse>;
     getUsage(req?: PartialMessage<GetUsageRequest>, opts?: CallOptions): Promise<GetUsageResponse>;
+    /** Get playback analytics for a single video: plays, watch time, and unique
+     * viewers aggregated per UTC day, plus range totals. Stats come from a
+     * best-effort playback beacon rolled up hourly, so recent activity may lag by
+     * up to an hour. Returns the full response (`daily` rows + `totals`). */
+    getStats(req: PartialMessage<GetStatsRequest>, opts?: CallOptions): Promise<GetStatsResponse>;
+    /** List an app's top videos ranked by plays over a date range. Returns the
+     * full response (`items`). */
+    listTopVideos(req?: PartialMessage<ListTopVideosRequest>, opts?: CallOptions): Promise<ListTopVideosResponse>;
 }
 
 /**
@@ -10985,6 +13145,8 @@ declare function constructEvent(rawBody: string | Uint8Array | Buffer, sigHeader
 
 declare const Webhooks: {
     readonly constructEvent: typeof constructEvent;
+    readonly isKnownEvent: typeof isKnownEvent;
+    readonly isEventType: typeof isEventType;
     readonly WebhookError: typeof WebhookError;
     readonly WebhookSignatureError: typeof WebhookSignatureError;
     readonly WebhookTimestampError: typeof WebhookTimestampError;
@@ -11015,6 +13177,7 @@ declare class Transcodely {
     private _health;
     private _webhookEndpoints;
     private _events;
+    private _billing;
     constructor(config: TranscodelyConfig);
     /** ID of the most recent successful or failed request, Stripe-style. */
     get lastRequestId(): string | undefined;
@@ -11030,6 +13193,11 @@ declare class Transcodely {
     get health(): Health;
     get webhookEndpoints(): WebhookEndpoints;
     get events(): Events;
+    /**
+     * The organization's invoices. Needs a dashboard session token for an org
+     * owner plus `organizationId` in the client config; API keys are rejected.
+     */
+    get billing(): Billing;
     /**
      * Stateless verify-and-decode helper. `client.webhooks.constructEvent(...)`
      * mirrors the Stripe SDK convention. The namespace is also exported at the
@@ -11040,7 +13208,7 @@ declare class Transcodely {
 }
 
 /** SDK version. Bumped by release-please from package.json on each tag. */
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.3.1";
 /**
  * API version this SDK release is pinned to. Sent on every request as
  * `Transcodely-Version`. Customers can override per-client via the
@@ -11050,4 +13218,4 @@ declare const API_VERSION = "2026-05-03";
 /** Default base URL for the production Transcodely API. */
 declare const DEFAULT_BASE_URL = "https://api.transcodely.com";
 
-export { APIConnectionError, APIError, Event as APIEvent, APIKey, API_VERSION, AV1Options, AbortMultipartUploadRequest, App, AppStatus, ArchiveAppRequest, ArchiveOriginRequest, ArchivePresetRequest, AudioCodec, AudioSettings, AudioStreamInfo, AudioTrackConfig, AuthenticationError, AutoABRConfig, AutoProfileDefaults, BYOKConfig, BitrateMode, BurnInStyle, type CallOptions, CancelJobRequest, CancelJobResponse, CheckSlugRequest, CheckSlugResponse, CompleteMultipartUploadRequest, CompleteMultipartUploadResponse, CompleteUploadRequest, CompleteUploadResponse, CompletedPart, ConfirmJobRequest, ConfirmJobResponse, ConflictError, Container, ContentAnalysis, ContentAwareConfig, ContentAwareMode, ContentType, CreateAPIKeyRequest, CreateAPIKeyResponse, CreateAppRequest, CreateAppResponse, CreateJobRequest, CreateJobResponse, CreateMultipartUploadRequest, CreateMultipartUploadResponse, CreateOrganizationRequest, CreateOrganizationResponse, CreateOriginRequest, CreateOriginResponse, CreatePresetRequest, CreatePresetResponse, CreateUploadRequest, CreateUploadResponse, CreateWebhookEndpointRequest, CreateWebhookEndpointResponse, DASHConfig, DEFAULT_BASE_URL, DEFAULT_TOLERANCE_SECONDS, DRMConfig, DRMSystem, DeleteVideoRequest, DeleteWebhookEndpointRequest, DeleteWebhookEndpointResponse, DeliveryFormat, DuplicatePresetRequest, DuplicatePresetResponse, EVENT_ID_HEADER, EnableHostingRequest, EnableHostingResponse, EncryptionScheme, ErrorDetails, type EventBase, ExecutionTiming, type FieldViolation, GOPAlignmentMode, GcsCredentials, GcsOriginConfig, GetAPIKeyRequest, GetAPIKeyResponse, GetAppRequest, GetAppResponse, GetEndpointHealthRequest, GetEndpointHealthResponse, GetJobRequest, GetJobResponse, GetMeRequest, GetMeResponse, GetMembershipRequest, GetMembershipResponse, GetOrganizationRequest, GetOrganizationResponse, GetOriginRequest, GetOriginResponse, GetPresetBySlugRequest, GetPresetBySlugResponse, GetPresetRequest, GetPresetResponse, GetUploadPartUrlsRequest, GetUploadPartUrlsResponse, GetUsageRequest, GetUsageResponse, GetUserRequest, GetUserResponse, GetVideoRequest, GetVideoResponse, H264Options, H265Options, HDRConfig, HDRFormat, HDRMode, HLSConfig, HLSPlaylistType, HLSSegmentFormat, HealthBucket, HostingConfig, HttpCredentials, HttpOriginConfig, InputMetadata, InvalidRequestError, Job, JobOutput, JobPriority, JobStatus, KeyServerConfig, ListAPIKeysRequest, ListAPIKeysResponse, ListAppsRequest, ListAppsResponse, ListEventsRequest, ListEventsResponse, ListJobsRequest, ListJobsResponse, ListMembershipsRequest, ListMembershipsResponse, ListOrganizationsRequest, ListOrganizationsResponse, ListOriginsRequest, ListOriginsResponse, ListPresetsRequest, ListPresetsResponse, ListUsersRequest, ListUsersResponse, ListVideosRequest, ListVideosResponse, ListWebhookDeliveriesRequest, ListWebhookDeliveriesResponse, ListWebhookEndpointsRequest, ListWebhookEndpointsResponse, type LogEvent, Membership, MembershipRole, MembershipStatus, MembershipWithUser, NotFoundError, Organization, OrganizationStatus, Origin, OriginPermission, OriginProvider, OriginRef, OriginStatus, OutputFormat, OutputSpec, OutputStatus, OutputVariantResult, Page, PaginationRequest, PaginationResponse, PermissionError, PreconditionError, Preset, PresetVariant, PricingSnapshot, QualityTier, R2Jurisdiction, R2OriginConfig, RateLimitError, RemoveMembershipRequest, ResendEventRequest, ResendEventResponse, Resolution, RetrieveEventRequest, RetrieveEventResponse, RetrieveWebhookEndpointRequest, RetrieveWebhookEndpointResponse, RevokeAPIKeyRequest, RotateWebhookSecretRequest, RotateWebhookSecretResponse, S3Credentials, S3OriginConfig, SDK_VERSION, SIGNATURE_HEADER, SegmentConfig, SendTestWebhookRequest, SendTestWebhookResponse, StreamingConfig, SubtitleFormat, SubtitleOperation, SubtitleStreamInfo, SubtitleTrack, ThumbnailFormat, ThumbnailMode, ThumbnailResult, ThumbnailSpec, ToneMapping, Transcodely, type TranscodelyConfig, TranscodelyError, UpdateAppRequest, UpdateAppResponse, UpdateHostingConfigRequest, UpdateHostingConfigResponse, UpdateMeRequest, UpdateMeResponse, UpdateMembershipRoleRequest, UpdateMembershipRoleResponse, UpdateOrganizationRequest, UpdateOrganizationResponse, UpdateOriginRequest, UpdateOriginResponse, UpdatePresetRequest, UpdatePresetResponse, UpdateVideoRequest, UpdateVideoResponse, UpdateWebhookEndpointRequest, UpdateWebhookEndpointResponse, UploadPart, UsageSummary, User, UserApprovalStatus, UserOrganization, UserStatus, UserWithOrganizations, VP9Options, ValidateOriginRequest, ValidateOriginResponse, ValidationResult, VariantPricingSnapshot, type VerifyOptions, Video, VideoCodec, VideoRendition, VideoSettings, VideoStatus, VideoStreamInfo, VideoVariant, VideoVisibility, WEBHOOK_EVENT_TYPES, WatchEventType, WatchJobRequest, WatchJobResponse, WatchVideoRequest, WatchVideoResponse, WebhookDelivery, WebhookEndpoint, WebhookError, type WebhookEvent, type WebhookEventType, WebhookPayloadError, WebhookSignatureError, WebhookTimestampError, Webhooks, constructEvent, verifySignature };
+export { APIConnectionError, APIError, Event as APIEvent, APIKey, API_VERSION, AV1Options, AbortMultipartUploadRequest, App, AppStatus, ArchiveAppRequest, ArchiveOriginRequest, ArchivePresetRequest, AudioCodec, AudioSettings, AudioStreamInfo, AudioTrackConfig, AuthenticationError, AutoABRConfig, AutoProfileDefaults, BYOKConfig, BitrateMode, BurnInStyle, type CallOptions, CancelJobRequest, CancelJobResponse, ChapterPoint, ChapterResult, CheckSlugRequest, CheckSlugResponse, ClipConfig, CompleteMultipartUploadRequest, CompleteMultipartUploadResponse, CompleteUploadRequest, CompleteUploadResponse, CompletedPart, ConfirmJobRequest, ConfirmJobResponse, ConflictError, Container, ContentAnalysis, ContentAwareConfig, ContentAwareMode, ContentType, CreateAPIKeyRequest, CreateAPIKeyResponse, CreateAppRequest, CreateAppResponse, CreateFromUrlRequest, CreateFromUrlResponse, CreateJobRequest, CreateJobResponse, CreateMultipartUploadRequest, CreateMultipartUploadResponse, CreateOrganizationRequest, CreateOrganizationResponse, CreateOriginRequest, CreateOriginResponse, CreatePresetRequest, CreatePresetResponse, CreateUploadRequest, CreateUploadResponse, CreateWebhookEndpointRequest, CreateWebhookEndpointResponse, DASHConfig, DEFAULT_BASE_URL, DEFAULT_TOLERANCE_SECONDS, DRMConfig, DRMSystem, DailyUsage, DeleteVideoRequest, DeleteWebhookEndpointRequest, DeleteWebhookEndpointResponse, DeliveryFormat, DuplicatePresetRequest, DuplicatePresetResponse, EVENT_ID_HEADER, EnableHostingRequest, EnableHostingResponse, EncryptionScheme, EndpointHealthSummary, ErrorDetails, type EventBase, ExecutionTiming, type FieldViolation, GOPAlignmentMode, GcsCredentials, GcsOriginConfig, GetAPIKeyRequest, GetAPIKeyResponse, GetAppRequest, GetAppResponse, GetEndpointHealthRequest, GetEndpointHealthResponse, GetInvoiceRequest, GetInvoiceResponse, GetJobRequest, GetJobResponse, GetMeRequest, GetMeResponse, GetMembershipRequest, GetMembershipResponse, GetOrganizationRequest, GetOrganizationResponse, GetOriginRequest, GetOriginResponse, GetPresetBySlugRequest, GetPresetBySlugResponse, GetPresetRequest, GetPresetResponse, GetSpendRequest, GetSpendResponse, GetStatsRequest, GetStatsResponse, GetUpcomingInvoiceRequest, GetUpcomingInvoiceResponse, GetUploadPartUrlsRequest, GetUploadPartUrlsResponse, GetUsageRequest, GetUsageResponse, GetUserRequest, GetUserResponse, GetVideoRequest, GetVideoResponse, H264Options, H265Options, HDRConfig, HDRFormat, HDRMode, HLSConfig, HLSPlaylistType, HLSSegmentFormat, HealthBucket, HostingConfig, HttpCredentials, HttpOriginConfig, InputMetadata, InvalidRequestError, Invoice, InvoiceLineItem, InvoiceLineType, InvoiceStatus, Job, JobFee, JobOutput, JobPriority, JobStatus, KeyServerConfig, type KnownWebhookEvent, ListAPIKeysRequest, ListAPIKeysResponse, ListAppsRequest, ListAppsResponse, ListEventsRequest, ListEventsResponse, ListInvoicesRequest, ListInvoicesResponse, ListJobsRequest, ListJobsResponse, ListMembershipsRequest, ListMembershipsResponse, ListOrganizationsRequest, ListOrganizationsResponse, ListOriginsRequest, ListOriginsResponse, ListPresetsRequest, ListPresetsResponse, ListTopVideosRequest, ListTopVideosResponse, ListUsersRequest, ListUsersResponse, ListVideosRequest, ListVideosResponse, ListWebhookDeliveriesRequest, ListWebhookDeliveriesResponse, ListWebhookEndpointsRequest, ListWebhookEndpointsResponse, type LogEvent, Membership, MembershipRole, MembershipStatus, MembershipWithUser, NotFoundError, Organization, OrganizationStatus, Origin, OriginPermission, OriginProvider, OriginRef, OriginStatus, OutputFormat, OutputSpec, OutputStatus, OutputVariantResult, Page, PaginationRequest, PaginationResponse, PermissionError, PreconditionError, Preset, PresetVariant, PricingSnapshot, QualityTier, R2Jurisdiction, R2OriginConfig, RateLimitError, RemoveMembershipRequest, ResendEventRequest, ResendEventResponse, Resolution, RetrieveEventRequest, RetrieveEventResponse, RetrieveWebhookEndpointRequest, RetrieveWebhookEndpointResponse, RevokeAPIKeyRequest, RotateWebhookSecretRequest, RotateWebhookSecretResponse, S3Credentials, S3OriginConfig, SDK_VERSION, SIGNATURE_HEADER, SegmentConfig, SendTestWebhookRequest, SendTestWebhookResponse, type SpendLimitNotification, StreamingConfig, SubtitleFormat, SubtitleOperation, SubtitleResult, SubtitleStreamInfo, SubtitleTrack, ThumbnailFormat, ThumbnailMode, ThumbnailResult, ThumbnailSpec, ToneMapping, TopVideo, Transcodely, type TranscodelyConfig, TranscodelyError, type UnknownWebhookEvent, UpdateAppRequest, UpdateAppResponse, UpdateHostingConfigRequest, UpdateHostingConfigResponse, UpdateMeRequest, UpdateMeResponse, UpdateMembershipRoleRequest, UpdateMembershipRoleResponse, UpdateOrganizationRequest, UpdateOrganizationResponse, UpdateOriginRequest, UpdateOriginResponse, UpdatePresetRequest, UpdatePresetResponse, UpdateSpendLimitRequest, UpdateSpendLimitResponse, UpdateVideoRequest, UpdateVideoResponse, UpdateWebhookEndpointRequest, UpdateWebhookEndpointResponse, UploadPart, UsageSummary, User, UserApprovalStatus, UserOrganization, UserStatus, UserWithOrganizations, VP9Options, ValidateOriginRequest, ValidateOriginResponse, ValidationResult, VariantPricingSnapshot, type VerifyOptions, Video, VideoCodec, VideoRendition, VideoSettings, VideoStatsDay, VideoStatsTotals, VideoStatus, VideoStreamInfo, VideoTextTrack, VideoVariant, VideoVisibility, WEBHOOK_EVENT_TYPES, WatchEventType, WatchJobRequest, WatchJobResponse, WatchVideoRequest, WatchVideoResponse, WatermarkAnchor, WatermarkConfig, WatermarkPixelPlacement, WebhookDelivery, WebhookEndpoint, WebhookError, type WebhookEvent, type WebhookEventType, WebhookPayloadError, WebhookSignatureError, WebhookTimestampError, Webhooks, constructEvent, isEventType, isKnownEvent, verifySignature };