@transcodely/sdk 0.3.7 → 0.3.8

package/dist/index.d.ts

@@ -747,8 +747,12 @@ declare class CreateAPIKeyRequest extends Message<CreateAPIKeyRequest> {
      */
     expiresAt?: Timestamp;
     /**
-     * App ID to create the key for.
-     * Required when unauthenticated. Ignored when authenticated (uses the authenticated app).
+     * App ID to create the key for. API-key callers may omit it (their key's app
+     * is used) or pass their own app; a different app is rejected with
+     * PermissionDenied. Portal/JWT callers pass it to create in a specific app in
+     * their org; omitted selects the org's first active app. Still REQUIRED on
+     * the unauthenticated onboarding bootstrap path, where nothing else can name
+     * an app: omitting it there is invalid_argument (`app_id_required`).
      *
      * @generated from field: string app_id = 5;
      */
@@ -1044,6 +1048,18 @@ declare class InvalidRequestError extends TranscodelyError {
 /** 412 — preconditions not met (e.g. job not cancelable in current state). */
 declare class PreconditionError extends TranscodelyError {
 }
+/**
+ * Raised by `client.uploads.putFile` when the byte transfer itself fails —
+ * a presigned PUT rejected after retries, a store that returned no ETag, or a
+ * source the SDK refuses to send (empty, over the 5 GB ceiling, a stream with
+ * no declared size). Errors from the upload RPCs themselves stay in their own
+ * classes; this one covers the part of the upload the API never sees.
+ */
+declare class UploadError extends TranscodelyError {
+}
+/** The upload's `signal` fired. The multipart upload is aborted server-side. */
+declare class UploadAbortedError extends UploadError {
+}
 /**
  * Base class for errors thrown by {@link Webhooks.constructEvent}. Unlike the
  * other SDK errors, these originate locally — the SDK never made a network
@@ -1732,13 +1748,22 @@ declare class EnableHostingResponse extends Message<EnableHostingResponse> {
  */
 declare class HostingConfig extends Message<HostingConfig> {
     /**
-     * Default visibility for new uploads: "public", "unlisted", or "private".
+     * Default visibility for videos this app creates: "public", "unlisted", or
+     * "private". Applies to every creation path — CreateUpload,
+     * CreateMultipartUpload, CreateFromUrl and the video a managed CreateJob
+     * produces — whenever the request itself does not name a visibility. Unset
+     * means "unlisted".
      *
      * @generated from field: optional string default_visibility = 1;
      */
     defaultVisibility?: string;
     /**
-     * Max upload file size in bytes (0 = no limit).
+     * Max upload file size in bytes (0 = no limit). Enforced at CreateUpload and
+     * CreateMultipartUpload against the request's declared size_bytes, on top of
+     * the fixed 5 GB per-request ceiling; over-limit requests are rejected with
+     * error code "max_upload_size_exceeded" before anything is created. Not
+     * enforced by CreateFromUrl, whose source size is unknown until the worker
+     * fetches the URL.
      *
      * @generated from field: optional int64 max_upload_size_bytes = 2;
      */
@@ -3859,7 +3884,10 @@ declare class WebhookDelivery extends Message<WebhookDelivery> {
  */
 declare class CreateWebhookEndpointRequest extends Message<CreateWebhookEndpointRequest> {
     /**
-     * App to create the endpoint for.
+     * App to create the endpoint for. API-key callers may omit it (their key's
+     * app is used) or pass their own app; a different app is rejected with
+     * PermissionDenied. Portal/JWT callers pass it to create in a specific app in
+     * their org; omitted selects the org's first active app.
      *
      * @generated from field: string app_id = 1;
      */
@@ -4088,7 +4116,10 @@ declare class DeleteWebhookEndpointResponse extends Message<DeleteWebhookEndpoin
  */
 declare class ListWebhookEndpointsRequest extends Message<ListWebhookEndpointsRequest> {
     /**
-     * App to list endpoints for.
+     * 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 it to list a specific app in their org; omitted
+     * returns endpoints across all apps in the org.
      *
      * @generated from field: string app_id = 1;
      */
@@ -4198,7 +4229,10 @@ declare class RotateWebhookSecretResponse extends Message<RotateWebhookSecretRes
  */
 declare class ListEventsRequest extends Message<ListEventsRequest> {
     /**
-     * App to list events for.
+     * 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 it to list a specific app in their org; omitted
+     * returns events across all apps in the org.
      *
      * @generated from field: string app_id = 1;
      */
@@ -6256,10 +6290,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.
+ * One of the two modes ships: `per_title` is accepted and acted on. `auto_abr`
+ * is still rejected at CreateJob with error code `parameter_unsupported` and
+ * the message "auto_abr is not available yet; per_title is" (issue #167),
+ * because it would change the NUMBER of renditions after the job was already
+ * quoted per rendition at create time.
  *
  * @generated from enum transcodely.v1.ContentAwareMode
  */
@@ -6269,15 +6304,18 @@ declare enum ContentAwareMode {
      */
     UNSPECIFIED = 0,
     /**
-     * Optimize CRF for target VMAF on specific content. NOT YET SUPPORTED —
-     * rejected at create.
+     * Find the CRF this source needs to reach the VMAF target, and encode the
+     * declared ladder at it. The search runs once per output, on the ladder's
+     * highest-resolution quality-driven rendition; the lower rungs move by the
+     * CRF offsets the ladder already declares. Priced at 1.5x. What the search
+     * decided comes back on OutputReport.content_aware.
      *
      * @generated from enum value: CONTENT_AWARE_MODE_PER_TITLE = 1;
      */
     PER_TITLE = 1,
     /**
-     * Generate optimal bitrate ladder automatically. NOT YET SUPPORTED —
-     * rejected at create.
+     * Generate the bitrate ladder automatically. NOT YET ACCEPTED — rejected at
+     * create.
      *
      * @generated from enum value: CONTENT_AWARE_MODE_AUTO_ABR = 2;
      */
@@ -6286,9 +6324,9 @@ 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.
+ * NOT YET ACCEPTED — see ContentAwareConfig. These constraints are validated
+ * for shape but never applied, because a request in auto_abr mode is rejected
+ * at create.
  *
  * @generated from message transcodely.v1.AutoABRConfig
  */
@@ -6331,35 +6369,51 @@ 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.
+ * In `per_title` mode the encode is tuned to this particular source: the worker
+ * measures short samples of it at several CRFs and encodes the declared ladder
+ * at the cheapest one that reaches the VMAF target. The ladder itself is
+ * unchanged — same renditions, same resolutions — so the price quoted at create
+ * still holds, with the 1.5x per-title multiplier applied.
+ *
+ * Three requests are refused at create:
+ *   - `auto_abr` mode (`parameter_unsupported`) — not available yet;
+ *   - an output with no video renditions, or one whose every video rendition is
+ *     pinned to an explicit bitrate (`parameter_incompatible`) — a pinned
+ *     rendition ignores CRF, so the search would change nothing while still
+ *     being billed;
+ *   - a source shorter than 120 seconds, refused at probe with
+ *     `per_title_source_too_short` once the input has been measured.
+ *
+ * What the search decided is reported back on OutputReport.content_aware.
  *
  * @generated from message transcodely.v1.ContentAwareConfig
  */
 declare class ContentAwareConfig extends Message<ContentAwareConfig> {
     /**
-     * Encoding mode (required). NOT YET SUPPORTED — any value here causes the
-     * request to be rejected at create.
+     * Encoding mode (required). `per_title` is accepted; `auto_abr` is rejected
+     * at create.
      *
      * @generated from field: transcodely.v1.ContentAwareMode mode = 1;
      */
     mode: ContentAwareMode;
     /**
-     * Override VMAF target (70-99). NOT YET SUPPORTED — content-aware encoding is
-     * rejected at create, so this value is never applied.
+     * Override VMAF target (80-97). Default: 93, regardless of quality tier.
+     *
+     * The range is the one the per-title search can actually work in, narrowed
+     * from 70-99 before the feature was ever accepted: below 80 the result is not
+     * a quality target anyone would ask for, and above 97 the search cannot
+     * distinguish the last point from the one below it. Asking for a number we
+     * would silently move is worse than refusing it.
+     *
+     * The value the analysis actually searched against is reported back on
+     * OutputReport.content_aware.vmaf_target, which is the one to read.
      *
      * @generated from field: optional double vmaf_target = 2;
      */
     vmafTarget?: number;
     /**
-     * Auto ABR constraints (only for auto_abr mode). NOT YET SUPPORTED — rejected
-     * at create.
+     * Auto ABR constraints (only for auto_abr mode). NOT YET ACCEPTED — an
+     * auto_abr request is rejected at create whatever these say.
      *
      * @generated from field: optional transcodely.v1.AutoABRConfig auto_abr = 3;
      */
@@ -6376,9 +6430,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).
+ * NOT YET POPULATED, and not carried by any RPC. The worker measures these
+ * complexity scores but has nowhere to send them: the API stores the per-title
+ * SEARCH RESULT (see OutputReportContentAware) and not the source scores behind
+ * it. Retained for wire compatibility.
  *
  * @generated from message transcodely.v1.ContentAnalysis
  */
@@ -8751,7 +8806,10 @@ declare class OutputSpec extends Message<OutputSpec> {
     drm?: DRMConfig;
     /**
      * Content-aware encoding configuration.
-     * Enables per-title encoding or automatic ABR ladder generation.
+     * Enables per-title encoding, which tunes this output's CRF to the source
+     * rather than to its quality tier. Requires at least one video rendition that
+     * is not pinned to an explicit bitrate, and a source of at least 120 seconds.
+     * `auto_abr` mode is not accepted yet.
      *
      * @generated from field: optional transcodely.v1.ContentAwareConfig content_aware = 13;
      */
@@ -9206,6 +9264,18 @@ declare class JobOutput extends Message<JobOutput> {
      * @generated from field: optional string signed_url = 26;
      */
     signedUrl?: string;
+    /**
+     * What the produced file actually is, measured from the file itself, plus
+     * the verdict of comparing those measurements against what this output
+     * asked for. See OutputReport.
+     *
+     * Absent until the output has been measured: outputs that never produced a
+     * file, and outputs produced before this field existed, carry no report.
+     * Absence means "not measured" — never "nothing wrong".
+     *
+     * @generated from field: optional transcodely.v1.OutputReport report = 27;
+     */
+    report?: OutputReport;
     constructor(data?: PartialMessage<JobOutput>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "transcodely.v1.JobOutput";
@@ -9215,6 +9285,440 @@ declare class JobOutput extends Message<JobOutput> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): JobOutput;
     static equals(a: JobOutput | PlainMessage<JobOutput> | undefined, b: JobOutput | PlainMessage<JobOutput> | undefined): boolean;
 }
+/**
+ * OutputReport is what the produced file turned out to be: codec, profile,
+ * pixel format, color signaling, dimensions, frame rate, audio and duration,
+ * all read back from the encoded file after it was written — not copied from
+ * the request and not inherited from the input. The one field that is not a
+ * measurement is container, which states the delivery format (see below).
+ *
+ * Alongside the facts sits a verdict: whether the file matches what the job
+ * asked for, and the exact field-by-field differences where it does not. The
+ * facts are measured by the encoder host; the verdict is computed by the API,
+ * so the same request always produces the same verdict.
+ *
+ * For a single-file output the facts describe that file. For a multi-rendition
+ * output (an ABR ladder, HLS, DASH, adaptive) they describe the
+ * HIGHEST-RESOLUTION rendition — the same one width, height and
+ * average_bitrate_kbps already report, and the one the verdict is judged
+ * against. Per-rendition detail stays in variant_results.
+ *
+ * Every value here is a parsed, named fact. The report never carries encoder
+ * command lines, tool output, stack traces, log lines or storage paths, and
+ * values that do not look like the short identifiers media tools emit are
+ * dropped rather than passed through.
+ *
+ * The string-typed fields (container, codec, profile, level, pix_fmt, the
+ * color fields, hdr_format) are deliberately strings and not enums: their
+ * vocabularies belong to the media formats themselves, and a value we have not
+ * catalogued yet must be reportable the day it appears rather than wait for a
+ * new enum value to travel through every SDK. They are always lowercase, and
+ * the documented spellings below are the ones you will see in practice.
+ *
+ * @generated from message transcodely.v1.OutputReport
+ */
+declare class OutputReport extends Message<OutputReport> {
+    /**
+     * Delivery format of this output, lowercase: "mp4", "mov", "webm", "mkv",
+     * "hls", "dash" or "adaptive" — the same vocabulary as the request's
+     * OutputSpec.type, and what a container mismatch is stated in.
+     *
+     * It names what was DELIVERED, not what a demuxer called an intermediate
+     * file: for a streaming output the delivered thing is the manifest and its
+     * segments, while the measurements in the fields below were taken on the
+     * encoded rendition before it was packaged.
+     *
+     * That makes this the one field the verdict cannot really police — a report
+     * echoing the requested type always matches. The check that a file is in the
+     * container it was promised runs on the encoder host, before delivery, and
+     * fails the output outright rather than describing it. This field is here so
+     * the report is self-describing, not as that check's second opinion.
+     *
+     * @generated from field: string container = 1;
+     */
+    container: string;
+    /**
+     * The produced video stream. Absent when the file carries no video stream.
+     *
+     * @generated from field: optional transcodely.v1.OutputReportVideo video = 2;
+     */
+    video?: OutputReportVideo;
+    /**
+     * The produced audio streams, in the order the container carries them.
+     * Empty for an output encoded without audio.
+     *
+     * @generated from field: repeated transcodely.v1.OutputReportAudio audio = 3;
+     */
+    audio: OutputReportAudio[];
+    /**
+     * Measured playback duration of the produced file in seconds.
+     *
+     * This is read from the produced file. It is not the input's duration and
+     * not the requested length, which is exactly what makes it able to catch an
+     * encode that stopped early.
+     *
+     * @generated from field: optional double duration_seconds = 4;
+     */
+    durationSeconds?: number;
+    /**
+     * Whether the produced file matches what this output asked for, and where it
+     * does not. Always present on a report.
+     *
+     * @generated from field: transcodely.v1.OutputReportVerdict verdict = 5;
+     */
+    verdict?: OutputReportVerdict;
+    /**
+     * When the produced file was measured.
+     *
+     * @generated from field: google.protobuf.Timestamp checked_at = 6;
+     */
+    checkedAt?: Timestamp;
+    /**
+     * What the content-aware analysis decided for this output, when the output
+     * was encoded with per-title analysis.
+     *
+     * Present ONLY for an output whose encode ran that analysis. Absent on every
+     * ordinary output, which is the overwhelming majority of them, and absent on
+     * an output that requested content-aware encoding but whose analysis pass
+     * never reported (it fell back to the quality tier's own CRF).
+     *
+     * @generated from field: optional transcodely.v1.OutputReportContentAware content_aware = 7;
+     */
+    contentAware?: OutputReportContentAware;
+    constructor(data?: PartialMessage<OutputReport>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReport";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReport;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReport;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReport;
+    static equals(a: OutputReport | PlainMessage<OutputReport> | undefined, b: OutputReport | PlainMessage<OutputReport> | undefined): boolean;
+}
+/**
+ * What the content-aware analysis decided for one output: the quality it aimed
+ * at, the quality it reached on its samples, and the encoder setting it chose.
+ *
+ * These describe the SEARCH, not the finished file. The search runs on short
+ * samples taken from the source before the real encode starts, so
+ * vmaf_achieved is the score those samples got at the chosen setting — not a
+ * measurement of the delivered output, which is never scored. The facts about
+ * the delivered file are the other fields of OutputReport.
+ *
+ * The fields are strings and numbers for the same reason the rest of the report
+ * is: this records what an encoder did, and a value we have not catalogued must
+ * be reportable the day it appears.
+ *
+ * @generated from message transcodely.v1.OutputReportContentAware
+ */
+declare class OutputReportContentAware extends Message<OutputReportContentAware> {
+    /**
+     * Analysis mode that ran, lowercase: "per_title". Same vocabulary as the
+     * request's ContentAwareMode.
+     *
+     * @generated from field: string mode = 1;
+     */
+    mode: string;
+    /**
+     * VMAF score the search aimed at, 0-100.
+     *
+     * This is the target actually used, which is not always the one requested:
+     * a value outside the range the analysis can search is clamped into it, and
+     * what you read here is the clamped one.
+     *
+     * @generated from field: optional double vmaf_target = 2;
+     */
+    vmafTarget?: number;
+    /**
+     * VMAF score the chosen setting reached on the analysis samples, 0-100.
+     * Absent when the search ended without a scored result.
+     *
+     * @generated from field: optional double vmaf_achieved = 3;
+     */
+    vmafAchieved?: number;
+    /**
+     * Constant-rate-factor the search settled on, in the encoder's own scale
+     * (lower is higher quality). Absent when the search produced none and the
+     * encode fell back to the quality tier's default.
+     *
+     * For a multi-rendition output this is the highest-resolution rendition's
+     * value; the lower rungs derive from it by the ladder's fixed offsets.
+     *
+     * @generated from field: optional int32 crf_chosen = 4;
+     */
+    crfChosen?: number;
+    constructor(data?: PartialMessage<OutputReportContentAware>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReportContentAware";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReportContentAware;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReportContentAware;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReportContentAware;
+    static equals(a: OutputReportContentAware | PlainMessage<OutputReportContentAware> | undefined, b: OutputReportContentAware | PlainMessage<OutputReportContentAware> | undefined): boolean;
+}
+/**
+ * Measured properties of a produced video stream.
+ *
+ * @generated from message transcodely.v1.OutputReportVideo
+ */
+declare class OutputReportVideo extends Message<OutputReportVideo> {
+    /**
+     * Codec the stream is encoded with, lowercase, e.g. "h264", "hevc", "vp9",
+     * "av1". Note "hevc" — that is the decoder name for the codec this API calls
+     * "h265" on a request.
+     *
+     * @generated from field: string codec = 1;
+     */
+    codec: string;
+    /**
+     * Encoded profile, lowercase and without spaces, e.g. "high", "main",
+     * "main10", "baseline", "profile0". Absent when the codec has no profile
+     * concept or the encoder reported none.
+     *
+     * @generated from field: optional string profile = 2;
+     */
+    profile?: string;
+    /**
+     * Encoded level as the codec expresses it, e.g. "4.0", "5.1". Absent when
+     * not reported.
+     *
+     * @generated from field: optional string level = 3;
+     */
+    level?: string;
+    /**
+     * Pixel format, lowercase, e.g. "yuv420p" (8-bit) or "yuv420p10le"
+     * (10-bit). This is how bit depth is read back: a 10-bit output that came
+     * out 8-bit says so here.
+     *
+     * @generated from field: optional string pix_fmt = 4;
+     */
+    pixFmt?: string;
+    /**
+     * Encoded frame dimensions in pixels, as stored.
+     *
+     * @generated from field: int32 width = 5;
+     */
+    width: number;
+    /**
+     * @generated from field: int32 height = 6;
+     */
+    height: number;
+    /**
+     * Measured average frame rate in frames per second, e.g. 29.97, 30, 59.94.
+     *
+     * @generated from field: optional double frame_rate = 7;
+     */
+    frameRate?: number;
+    /**
+     * Measured video bitrate in kbps. Absent when the container does not carry a
+     * per-stream bitrate.
+     *
+     * @generated from field: optional int32 bitrate_kbps = 8;
+     */
+    bitrateKbps?: number;
+    /**
+     * Color signaling carried by the stream.
+     *
+     * @generated from field: optional transcodely.v1.OutputReportColor color = 9;
+     */
+    color?: OutputReportColor;
+    /**
+     * HDR format the stream signals. Today this resolves to exactly one of
+     * "none", "hdr10" or "hlg" — nothing else is ever emitted.
+     *
+     * It is derived from the color signaling above, so it is a reading of the
+     * file and not an echo of the request: an SDR source that arrived wearing HDR
+     * tags, and whose tags we rewrote, reports "none". Wide-gamut primaries with
+     * a PQ transfer read as "hdr10"; with an HLG transfer, as "hlg".
+     *
+     * "hdr10_plus" and "dolby_vision" are RESERVED spellings — documented so
+     * consumers can switch on them ahead of time, and NOT EMITTED. Telling HDR10+
+     * from static HDR10, or finding a Dolby Vision RPU, needs the per-frame side
+     * data this report does not carry. Until that lands, an HDR10+ or Dolby
+     * Vision output reads as "hdr10" here, which is the static layer it also
+     * genuinely signals. Do not read "hdr10" as proof the dynamic layer is
+     * absent.
+     *
+     * @generated from field: string hdr_format = 10;
+     */
+    hdrFormat: string;
+    constructor(data?: PartialMessage<OutputReportVideo>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReportVideo";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReportVideo;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReportVideo;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReportVideo;
+    static equals(a: OutputReportVideo | PlainMessage<OutputReportVideo> | undefined, b: OutputReportVideo | PlainMessage<OutputReportVideo> | undefined): boolean;
+}
+/**
+ * Color signaling read from a produced video stream. Each value is the
+ * lowercase name the format assigns it; absent means the stream carries no
+ * value for it.
+ *
+ * @generated from message transcodely.v1.OutputReportColor
+ */
+declare class OutputReportColor extends Message<OutputReportColor> {
+    /**
+     * Color primaries, e.g. "bt709" (SDR), "bt2020" (wide gamut).
+     *
+     * @generated from field: optional string primaries = 1;
+     */
+    primaries?: string;
+    /**
+     * Transfer characteristics, e.g. "bt709" (SDR), "smpte2084" (PQ / HDR10),
+     * "arib-std-b67" (HLG).
+     *
+     * @generated from field: optional string transfer = 2;
+     */
+    transfer?: string;
+    /**
+     * Matrix coefficients, e.g. "bt709", "bt2020nc".
+     *
+     * @generated from field: optional string matrix = 3;
+     */
+    matrix?: string;
+    /**
+     * Signal range: "tv" (limited) or "pc" (full).
+     *
+     * @generated from field: optional string range = 4;
+     */
+    range?: string;
+    constructor(data?: PartialMessage<OutputReportColor>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReportColor";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReportColor;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReportColor;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReportColor;
+    static equals(a: OutputReportColor | PlainMessage<OutputReportColor> | undefined, b: OutputReportColor | PlainMessage<OutputReportColor> | undefined): boolean;
+}
+/**
+ * Measured properties of a produced audio stream.
+ *
+ * @generated from message transcodely.v1.OutputReportAudio
+ */
+declare class OutputReportAudio extends Message<OutputReportAudio> {
+    /**
+     * Codec the stream is encoded with, lowercase, e.g. "aac", "opus", "mp3",
+     * "flac".
+     *
+     * @generated from field: string codec = 1;
+     */
+    codec: string;
+    /**
+     * Channel count: 1 for mono, 2 for stereo, 6 for 5.1.
+     *
+     * @generated from field: optional int32 channels = 2;
+     */
+    channels?: number;
+    /**
+     * Sampling rate in hertz, e.g. 48000.
+     *
+     * @generated from field: optional int32 sample_rate_hz = 3;
+     */
+    sampleRateHz?: number;
+    /**
+     * Measured audio bitrate in kbps. Absent when the container does not carry
+     * a per-stream bitrate.
+     *
+     * @generated from field: optional int32 bitrate_kbps = 4;
+     */
+    bitrateKbps?: number;
+    /**
+     * Language tag carried by the stream, e.g. "eng", "spa". Absent when the
+     * stream is untagged.
+     *
+     * @generated from field: optional string language = 5;
+     */
+    language?: string;
+    constructor(data?: PartialMessage<OutputReportAudio>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReportAudio";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReportAudio;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReportAudio;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReportAudio;
+    static equals(a: OutputReportAudio | PlainMessage<OutputReportAudio> | undefined, b: OutputReportAudio | PlainMessage<OutputReportAudio> | undefined): boolean;
+}
+/**
+ * The result of comparing a produced file against what the job asked for.
+ *
+ * @generated from message transcodely.v1.OutputReportVerdict
+ */
+declare class OutputReportVerdict extends Message<OutputReportVerdict> {
+    /**
+     * True when every property we can check matched the request.
+     *
+     * Properties the request left open — "keep the original frame rate", a
+     * container that does not pin its audio codec — are not checked and cannot
+     * make this false.
+     *
+     * @generated from field: bool matches_request = 1;
+     */
+    matchesRequest: boolean;
+    /**
+     * Every property that did not match, one entry each. Empty when
+     * matches_request is true; a mismatch list is never empty when it is false.
+     *
+     * @generated from field: repeated transcodely.v1.OutputReportMismatch mismatches = 2;
+     */
+    mismatches: OutputReportMismatch[];
+    constructor(data?: PartialMessage<OutputReportVerdict>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReportVerdict";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReportVerdict;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReportVerdict;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReportVerdict;
+    static equals(a: OutputReportVerdict | PlainMessage<OutputReportVerdict> | undefined, b: OutputReportVerdict | PlainMessage<OutputReportVerdict> | undefined): boolean;
+}
+/**
+ * One property of the produced file that does not match what was requested.
+ *
+ * @generated from message transcodely.v1.OutputReportMismatch
+ */
+declare class OutputReportMismatch extends Message<OutputReportMismatch> {
+    /**
+     * Which property differs, from a fixed vocabulary: "container",
+     * "video.present", "video.codec", "video.profile", "video.pix_fmt",
+     * "video.resolution", "video.width", "video.height", "video.frame_rate",
+     * "video.color.transfer", "video.color.primaries", "audio.present",
+     * "duration_seconds".
+     *
+     * "video.resolution" carries resolution tier names ("1080p") and appears
+     * when the request named a tier; "video.width" / "video.height" carry pixel
+     * counts and appear when the request named exact dimensions.
+     *
+     * Branch on this, not on the values beside it.
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * What the request asked for, as a short value, e.g. "h264", "1920",
+     * "high", "present". Where the request allows several answers — a
+     * multi-codec ABR ladder, for instance — this is the alternatives joined
+     * with "|", e.g. "h264|hevc".
+     *
+     * @generated from field: string expected = 2;
+     */
+    expected: string;
+    /**
+     * What the produced file carries instead, in the same vocabulary as
+     * expected, e.g. "hevc", "1280", "main", "absent".
+     *
+     * @generated from field: string actual = 3;
+     */
+    actual: string;
+    constructor(data?: PartialMessage<OutputReportMismatch>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.OutputReportMismatch";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): OutputReportMismatch;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): OutputReportMismatch;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): OutputReportMismatch;
+    static equals(a: OutputReportMismatch | PlainMessage<OutputReportMismatch> | undefined, b: OutputReportMismatch | PlainMessage<OutputReportMismatch> | undefined): boolean;
+}
 /**
  * Measured encode results for one variant of a multi-variant output.
  * Reported by the worker after encoding; index matches the variant's
@@ -10196,8 +10700,16 @@ declare class CreateJobRequest extends Message<CreateJobRequest> {
      */
     outputPathTemplate?: string;
     /**
-     * Write outputs to managed hosting storage and create a video record.
-     * When true, output_origin_id is not required.
+     * Write outputs to Transcodely-managed storage and create a hosted video
+     * record, playable over our CDN. When true, output_origin_id is not required.
+     *
+     * Managed hosting is enabled for the app the first time a job asks for it —
+     * there is no dashboard step and no AppService.EnableHosting call to make
+     * first. That first request provisions the app's storage bucket, its managed
+     * origin and its CDN pull zone, so it can take a few seconds longer than the
+     * ones after it. If provisioning fails the request is rejected with error
+     * code `hosting_provisioning_failed` (gRPC `unavailable`) and no job is
+     * created; the request is safe to retry unchanged.
      *
      * @generated from field: optional bool managed = 20;
      */
@@ -11029,12 +11541,25 @@ declare class VideoTextTrack extends Message<VideoTextTrack> {
 /**
  * Request to create a presigned upload URL for direct client upload.
  *
+ * Managed hosting is enabled for the app the first time a video is created —
+ * there is no dashboard step and no AppService.EnableHosting call to make
+ * first. That first request provisions the app's storage bucket, its managed
+ * origin and its CDN pull zone, so it can take a few seconds longer than the
+ * ones after it. If provisioning fails the request is rejected with error code
+ * `hosting_provisioning_failed` (gRPC `unavailable`) and no video is created;
+ * the request is safe to retry unchanged.
+ *
  * @generated from message transcodely.v1.CreateUploadRequest
  */
 declare class CreateUploadRequest extends Message<CreateUploadRequest> {
     /**
-     * App to create the video under. Required. The app must have managed hosting
-     * enabled (AppService.EnableHosting) or the call fails with FailedPrecondition.
+     * App to create the video under. API-key callers may omit it (their key's app
+     * is used) or pass their own app; a different app is rejected with
+     * PermissionDenied. Portal/JWT callers pass it to create in a specific app in
+     * their org; omitted selects the org's first active app.
+     *
+     * Managed hosting does not have to be enabled on it first — see the note on
+     * this message; the call enables it.
      *
      * @generated from field: string app_id = 8;
      */
@@ -11076,7 +11601,11 @@ declare class CreateUploadRequest extends Message<CreateUploadRequest> {
      */
     tags: string[];
     /**
-     * Visibility setting. Defaults to "unlisted" if not specified.
+     * Visibility setting: "public", "unlisted" or "private".
+     *
+     * When omitted (or sent as an empty string), the app's hosting
+     * default_visibility applies; if the app has no default_visibility set
+     * either, the video is created "unlisted".
      *
      * @generated from field: optional string visibility = 7;
      */
@@ -11200,12 +11729,25 @@ declare class CompleteUploadResponse extends Message<CompleteUploadResponse> {
 /**
  * Request to create a hosted video from a remote URL (one-call ingest).
  *
+ * Managed hosting is enabled for the app the first time a video is created —
+ * there is no dashboard step and no AppService.EnableHosting call to make
+ * first. That first request provisions the app's storage bucket, its managed
+ * origin and its CDN pull zone, so it can take a few seconds longer than the
+ * ones after it. If provisioning fails the request is rejected with error code
+ * `hosting_provisioning_failed` (gRPC `unavailable`) and no video is created;
+ * the request is safe to retry unchanged.
+ *
  * @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.
+     * App to create the video under. API-key callers may omit it (their key's app
+     * is used) or pass their own app; a different app is rejected with
+     * PermissionDenied. Portal/JWT callers pass it to create in a specific app in
+     * their org; omitted selects the org's first active app.
+     *
+     * Managed hosting does not have to be enabled on it first — see the note on
+     * this message; the call enables it.
      *
      * @generated from field: string app_id = 1;
      */
@@ -11239,7 +11781,11 @@ declare class CreateFromUrlRequest extends Message<CreateFromUrlRequest> {
      */
     tags: string[];
     /**
-     * Visibility setting. Defaults to "unlisted" if not specified.
+     * Visibility setting: "public", "unlisted" or "private".
+     *
+     * When omitted (or sent as an empty string), the app's hosting
+     * default_visibility applies; if the app has no default_visibility set
+     * either, the video is created "unlisted".
      *
      * @generated from field: optional string visibility = 6;
      */
@@ -11363,12 +11909,25 @@ declare class CompletedPart extends Message<CompletedPart> {
 /**
  * Request to create a multipart upload for large files.
  *
+ * Managed hosting is enabled for the app the first time a video is created —
+ * there is no dashboard step and no AppService.EnableHosting call to make
+ * first. That first request provisions the app's storage bucket, its managed
+ * origin and its CDN pull zone, so it can take a few seconds longer than the
+ * ones after it. If provisioning fails the request is rejected with error code
+ * `hosting_provisioning_failed` (gRPC `unavailable`) and no video is created;
+ * the request is safe to retry unchanged.
+ *
  * @generated from message transcodely.v1.CreateMultipartUploadRequest
  */
 declare class CreateMultipartUploadRequest extends Message<CreateMultipartUploadRequest> {
     /**
-     * App to create the video under. Required. The app must have managed hosting
-     * enabled (AppService.EnableHosting) or the call fails with FailedPrecondition.
+     * App to create the video under. API-key callers may omit it (their key's app
+     * is used) or pass their own app; a different app is rejected with
+     * PermissionDenied. Portal/JWT callers pass it to create in a specific app in
+     * their org; omitted selects the org's first active app.
+     *
+     * Managed hosting does not have to be enabled on it first — see the note on
+     * this message; the call enables it.
      *
      * @generated from field: string app_id = 1;
      */
@@ -11424,7 +11983,11 @@ declare class CreateMultipartUploadRequest extends Message<CreateMultipartUpload
      */
     tags: string[];
     /**
-     * Visibility setting. Defaults to "unlisted" if not specified.
+     * Visibility setting: "public", "unlisted" or "private".
+     *
+     * When omitted (or sent as an empty string), the app's hosting
+     * default_visibility applies; if the app has no default_visibility set
+     * either, the video is created "unlisted".
      *
      * @generated from field: optional string visibility = 13;
      */
@@ -12585,106 +13148,1120 @@ declare class Events {
     } & CallOptions): Promise<WebhookDelivery[]>;
 }
 
+declare class Health {
+    private readonly transport;
+    constructor(transport: Transport);
+    check(opts?: CallOptions): Promise<HealthCheckResponse>;
+}
+
 /**
- * Health status.
+ * Which provider shape an inbound event arrived in. Detected from the payload;
+ * you never declare it.
  *
- * @generated from enum transcodely.v1.HealthStatus
+ * @generated from enum transcodely.v1.StorageEventSource
  */
-declare enum HealthStatus {
+declare enum StorageEventSource {
     /**
-     * @generated from enum value: HEALTH_STATUS_UNSPECIFIED = 0;
+     * @generated from enum value: STORAGE_EVENT_SOURCE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * Service is healthy and operational.
+     * Amazon S3 event notification delivered through an SNS HTTPS subscription.
      *
-     * @generated from enum value: HEALTH_STATUS_HEALTHY = 1;
+     * @generated from enum value: STORAGE_EVENT_SOURCE_S3_SNS = 1;
      */
-    HEALTHY = 1,
+    S3_SNS = 1,
     /**
-     * Service is degraded but operational.
+     * Google Cloud Storage notification delivered by a Pub/Sub push
+     * subscription.
      *
-     * @generated from enum value: HEALTH_STATUS_DEGRADED = 2;
+     * @generated from enum value: STORAGE_EVENT_SOURCE_GCS_PUBSUB = 2;
      */
-    DEGRADED = 2,
+    GCS_PUBSUB = 2,
     /**
-     * Service is unhealthy and not operational.
+     * Supabase Storage, delivered by a database webhook on storage.objects.
      *
-     * @generated from enum value: HEALTH_STATUS_UNHEALTHY = 3;
+     * @generated from enum value: STORAGE_EVENT_SOURCE_SUPABASE = 3;
      */
-    UNHEALTHY = 3
+    SUPABASE = 3,
+    /**
+     * The generic shape: {"bucket", "key", "etag", "size", "content_type"}.
+     * Used by the Cloudflare R2 queue-consumer template and anything you write
+     * yourself.
+     *
+     * @generated from enum value: STORAGE_EVENT_SOURCE_GENERIC = 4;
+     */
+    GENERIC = 4
 }
 /**
- * Response from health check.
+ * What happened to a storage event.
  *
- * @generated from message transcodely.v1.HealthCheckResponse
+ * @generated from enum transcodely.v1.StorageEventStatus
  */
-declare class HealthCheckResponse extends Message<HealthCheckResponse> {
+declare enum StorageEventStatus {
     /**
-     * Overall service status.
+     * @generated from enum value: STORAGE_EVENT_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Accepted and stored; not processed yet.
      *
-     * @generated from field: transcodely.v1.HealthStatus status = 1;
+     * @generated from enum value: STORAGE_EVENT_STATUS_RECEIVED = 1;
      */
-    status: HealthStatus;
+    RECEIVED = 1,
     /**
-     * Service version.
+     * Matched the rule's filters; the job is being created.
      *
-     * @generated from field: string version = 2;
+     * @generated from enum value: STORAGE_EVENT_STATUS_MATCHED = 2;
      */
-    version: string;
+    MATCHED = 2,
     /**
-     * Individual component statuses.
+     * Deliberately not turned into a job. `reason` says why — the filters did
+     * not match, the object is in a different bucket than the rule's origin, the
+     * rule is disabled, or the same object was already ingested.
      *
-     * @generated from field: repeated transcodely.v1.ComponentHealth components = 3;
+     * @generated from enum value: STORAGE_EVENT_STATUS_SKIPPED = 3;
      */
-    components: ComponentHealth[];
-    constructor(data?: PartialMessage<HealthCheckResponse>);
-    static readonly runtime: typeof proto3;
-    static readonly typeName = "transcodely.v1.HealthCheckResponse";
-    static readonly fields: FieldList;
-    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): HealthCheckResponse;
-    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): HealthCheckResponse;
-    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): HealthCheckResponse;
-    static equals(a: HealthCheckResponse | PlainMessage<HealthCheckResponse> | undefined, b: HealthCheckResponse | PlainMessage<HealthCheckResponse> | undefined): boolean;
+    SKIPPED = 3,
+    /**
+     * A job was created. `job_id` names it.
+     *
+     * @generated from enum value: STORAGE_EVENT_STATUS_CREATED = 4;
+     */
+    CREATED = 4,
+    /**
+     * Job creation was refused and will not be retried. `reason` carries the API
+     * error code that refused it, e.g. `limit_exceeded` or `billing_past_due`.
+     *
+     * @generated from enum value: STORAGE_EVENT_STATUS_FAILED = 5;
+     */
+    FAILED = 5
+}
+/**
+ * IngestRule is one standing instruction on one origin.
+ *
+ * @generated from message transcodely.v1.IngestRule
+ */
+declare class IngestRule extends Message<IngestRule> {
+    /**
+     * Rule ID, e.g. "ing_a1b2c3d4e5f6".
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * App that owns the rule.
+     *
+     * @generated from field: string app_id = 2;
+     */
+    appId: string;
+    /**
+     * Origin the objects live in. Must have read permission.
+     *
+     * @generated from field: string origin_id = 3;
+     */
+    originId: string;
+    /**
+     * Human-readable name.
+     *
+     * @generated from field: string name = 4;
+     */
+    name: string;
+    /**
+     * Whether the endpoint accepts events. A disabled rule answers 202 and
+     * records the event as skipped, so a provider subscription does not start
+     * failing while the rule is paused.
+     *
+     * @generated from field: bool enabled = 5;
+     */
+    enabled: boolean;
+    /**
+     * Which objects this rule acts on. An empty filter set matches everything in
+     * the origin's bucket.
+     *
+     * @generated from field: transcodely.v1.IngestRuleFilters filters = 6;
+     */
+    filters?: IngestRuleFilters;
+    /**
+     * The job to create for a matching object.
+     *
+     * @generated from field: transcodely.v1.IngestRuleAction action = 7;
+     */
+    action?: IngestRuleAction;
+    /**
+     * Where the event sender posts. Computed; read-only.
+     *
+     * @generated from field: string endpoint_url = 8;
+     */
+    endpointUrl: string;
+    /**
+     * First 8 characters of the inbound secret, e.g. "ings_a1b". Enough to tell
+     * two secrets apart in a log; never enough to use one.
+     *
+     * @generated from field: string secret_prefix = 9;
+     */
+    secretPrefix: string;
+    /**
+     * Last 4 characters of the inbound secret.
+     *
+     * @generated from field: string secret_hint = 10;
+     */
+    secretHint: string;
+    /**
+     * When the secret was last rotated. Absent if it has never been rotated.
+     *
+     * @generated from field: optional google.protobuf.Timestamp secret_rotated_at = 11;
+     */
+    secretRotatedAt?: Timestamp;
+    /**
+     * Until when the PREVIOUS secret is still accepted after a rotation, so the
+     * sender can be updated without dropping an event. Absent when no rotation is
+     * in flight.
+     *
+     * @generated from field: optional google.protobuf.Timestamp previous_secret_expires_at = 12;
+     */
+    previousSecretExpiresAt?: Timestamp;
+    /**
+     * How many events this rule has accepted, all time.
+     *
+     * @generated from field: int64 events_received = 13;
+     */
+    eventsReceived: bigint;
+    /**
+     * How many jobs this rule has created, all time.
+     *
+     * @generated from field: int64 jobs_created = 14;
+     */
+    jobsCreated: bigint;
+    /**
+     * When the last event arrived.
+     *
+     * @generated from field: optional google.protobuf.Timestamp last_event_at = 15;
+     */
+    lastEventAt?: Timestamp;
+    /**
+     * When the rule was created.
+     *
+     * @generated from field: google.protobuf.Timestamp created_at = 16;
+     */
+    createdAt?: Timestamp;
+    /**
+     * When the rule was last updated.
+     *
+     * @generated from field: google.protobuf.Timestamp updated_at = 17;
+     */
+    updatedAt?: Timestamp;
+    constructor(data?: PartialMessage<IngestRule>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.IngestRule";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): IngestRule;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): IngestRule;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): IngestRule;
+    static equals(a: IngestRule | PlainMessage<IngestRule> | undefined, b: IngestRule | PlainMessage<IngestRule> | undefined): boolean;
+}
+/**
+ * IngestRuleFilters narrows which objects a rule acts on. All set filters must
+ * pass. An object that fails any of them is recorded as skipped, never as an
+ * error.
+ *
+ * @generated from message transcodely.v1.IngestRuleFilters
+ */
+declare class IngestRuleFilters extends Message<IngestRuleFilters> {
+    /**
+     * Object key prefix, e.g. "uploads/". Matched against the key as the
+     * provider reports it, after URL-decoding.
+     *
+     * @generated from field: string prefix = 1;
+     */
+    prefix: string;
+    /**
+     * Case-insensitive key suffixes, e.g. [".mp4", ".mov"]. The object matches
+     * if it ends with any one of them. Empty accepts every extension.
+     *
+     * @generated from field: repeated string suffixes = 2;
+     */
+    suffixes: string[];
+    /**
+     * Exact content types, e.g. ["video/mp4"]. The object matches if the event
+     * reports any one of them. Empty accepts every content type — including an
+     * event that reports none, which several providers do.
+     *
+     * @generated from field: repeated string content_types = 3;
+     */
+    contentTypes: string[];
+    /**
+     * Smallest object size to act on, in bytes. 0 means no lower bound. Useful
+     * for ignoring the zero-byte placeholder some clients write first.
+     *
+     * @generated from field: int64 min_bytes = 4;
+     */
+    minBytes: bigint;
+    /**
+     * Largest object size to act on, in bytes. 0 means no upper bound.
+     *
+     * @generated from field: int64 max_bytes = 5;
+     */
+    maxBytes: bigint;
+    constructor(data?: PartialMessage<IngestRuleFilters>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.IngestRuleFilters";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): IngestRuleFilters;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): IngestRuleFilters;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): IngestRuleFilters;
+    static equals(a: IngestRuleFilters | PlainMessage<IngestRuleFilters> | undefined, b: IngestRuleFilters | PlainMessage<IngestRuleFilters> | undefined): boolean;
+}
+/**
+ * IngestRuleAction is the job a rule creates. It is the subset of
+ * CreateJobRequest that can be decided ahead of time; the input is supplied by
+ * the event (the rule's origin, and the key the event names).
+ *
+ * @generated from message transcodely.v1.IngestRuleAction
+ */
+declare class IngestRuleAction extends Message<IngestRuleAction> {
+    /**
+     * Output specifications, exactly as CreateJobRequest.outputs. Presets may be
+     * referenced by ID or slug.
+     *
+     * A rule always has at least one, enforced on the requests that can leave it
+     * without one (`create_ingest_rule.outputs_required` and
+     * `update_ingest_rule.clear_action_is_complete`) rather than on this field —
+     * an Update that changes only the priority sends no outputs at all, and a
+     * min_items here would refuse it.
+     *
+     * @generated from field: repeated transcodely.v1.OutputSpec outputs = 1;
+     */
+    outputs: OutputSpec[];
+    /**
+     * Write outputs to Transcodely-managed storage and create a hosted video,
+     * playable over our CDN. Set this or output_origin_id, not both.
+     *
+     * @generated from field: bool managed = 2;
+     */
+    managed: boolean;
+    /**
+     * Origin to write outputs to. Must have write permission. Set this or
+     * managed, not both.
+     *
+     * @generated from field: optional string output_origin_id = 3;
+     */
+    outputOriginId?: string;
+    /**
+     * Job-level output path template, as CreateJobRequest.output_path_template.
+     * In addition to the job variables it accepts {input_key}, {input_name} (the
+     * key's last segment without its extension) and {input_dir} (everything
+     * before the last segment), so outputs can mirror the source layout.
+     *
+     * @generated from field: optional string output_path_template = 4;
+     */
+    outputPathTemplate?: string;
+    /**
+     * Thumbnail specifications, as CreateJobRequest.thumbnails.
+     *
+     * @generated from field: repeated transcodely.v1.ThumbnailSpec thumbnails = 5;
+     */
+    thumbnails: ThumbnailSpec[];
+    /**
+     * Job priority.
+     *
+     * @generated from field: transcodely.v1.JobPriority priority = 6;
+     */
+    priority: JobPriority;
+    /**
+     * Metadata copied onto every job the rule creates. The rule also adds
+     * `ingest_rule_id` and `ingest_object_key` of its own, which you can read
+     * back on the job and in webhook payloads.
+     *
+     * @generated from field: map<string, string> metadata = 7;
+     */
+    metadata: {
+        [key: string]: string;
+    };
+    constructor(data?: PartialMessage<IngestRuleAction>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.IngestRuleAction";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): IngestRuleAction;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): IngestRuleAction;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): IngestRuleAction;
+    static equals(a: IngestRuleAction | PlainMessage<IngestRuleAction> | undefined, b: IngestRuleAction | PlainMessage<IngestRuleAction> | undefined): boolean;
+}
+/**
+ * StorageEvent is one delivery from a storage provider, and what came of it.
+ *
+ * @generated from message transcodely.v1.StorageEvent
+ */
+declare class StorageEvent extends Message<StorageEvent> {
+    /**
+     * Event ID, e.g. "sev_a1b2c3d4e5f6g7".
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Rule that received it.
+     *
+     * @generated from field: string rule_id = 2;
+     */
+    ruleId: string;
+    /**
+     * App that owns the rule.
+     *
+     * @generated from field: string app_id = 3;
+     */
+    appId: string;
+    /**
+     * Bucket the object is in, as the provider reported it.
+     *
+     * @generated from field: string bucket = 4;
+     */
+    bucket: string;
+    /**
+     * Object key, URL-decoded. S3 percent-encodes keys and writes a space as
+     * "+"; what is stored here is the real key.
+     *
+     * @generated from field: string object_key = 5;
+     */
+    objectKey: string;
+    /**
+     * Object version identity, used for deduplication: an S3/R2 eTag, a GCS
+     * generation, or a Supabase metadata eTag. Empty when the provider sent
+     * none — the key alone then identifies the object.
+     *
+     * @generated from field: string etag = 6;
+     */
+    etag: string;
+    /**
+     * Object size in bytes, when the event reported one.
+     *
+     * @generated from field: int64 size_bytes = 7;
+     */
+    sizeBytes: bigint;
+    /**
+     * Content type, when the event reported one.
+     *
+     * @generated from field: string content_type = 8;
+     */
+    contentType: string;
+    /**
+     * Which provider shape the event arrived in.
+     *
+     * @generated from field: transcodely.v1.StorageEventSource source = 9;
+     */
+    source: StorageEventSource;
+    /**
+     * What happened to it.
+     *
+     * @generated from field: transcodely.v1.StorageEventStatus status = 10;
+     */
+    status: StorageEventStatus;
+    /**
+     * Why, for `skipped` and `failed`. A short machine-readable slug:
+     * "filter_prefix", "filter_suffix", "filter_content_type", "filter_size",
+     * "bucket_mismatch", "rule_disabled", "duplicate", or the API error code
+     * that refused the job.
+     *
+     * @generated from field: string reason = 11;
+     */
+    reason: string;
+    /**
+     * The job created from this event, if one was.
+     *
+     * @generated from field: string job_id = 12;
+     */
+    jobId: string;
+    /**
+     * When the event was accepted.
+     *
+     * @generated from field: google.protobuf.Timestamp received_at = 13;
+     */
+    receivedAt?: Timestamp;
+    /**
+     * When the event reached a terminal status.
+     *
+     * @generated from field: optional google.protobuf.Timestamp processed_at = 14;
+     */
+    processedAt?: Timestamp;
+    constructor(data?: PartialMessage<StorageEvent>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.StorageEvent";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): StorageEvent;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): StorageEvent;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): StorageEvent;
+    static equals(a: StorageEvent | PlainMessage<StorageEvent> | undefined, b: StorageEvent | PlainMessage<StorageEvent> | undefined): boolean;
+}
+/**
+ * Request to create an ingest rule.
+ *
+ * @generated from message transcodely.v1.CreateIngestRuleRequest
+ */
+declare class CreateIngestRuleRequest extends Message<CreateIngestRuleRequest> {
+    /**
+     * Origin the objects land in. Must be active and have read permission.
+     *
+     * @generated from field: string origin_id = 1;
+     */
+    originId: string;
+    /**
+     * Human-readable name.
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * Which objects to act on. Omit to act on everything in the bucket.
+     *
+     * @generated from field: transcodely.v1.IngestRuleFilters filters = 3;
+     */
+    filters?: IngestRuleFilters;
+    /**
+     * The job to create for a matching object.
+     *
+     * @generated from field: transcodely.v1.IngestRuleAction action = 4;
+     */
+    action?: IngestRuleAction;
+    /**
+     * Whether the rule starts enabled. Defaults to true; send false to create it
+     * paused and turn it on once the sender is configured.
+     *
+     * @generated from field: optional bool enabled = 5;
+     */
+    enabled?: boolean;
+    /**
+     * Optional target app. API-key callers may omit it (their key's app is used)
+     * or pass their own app; a different app is rejected with PermissionDenied.
+     * Portal/JWT callers pass it to create in a specific app in their org;
+     * omitted selects the org's first active app.
+     *
+     * @generated from field: optional string app_id = 6;
+     */
+    appId?: string;
+    constructor(data?: PartialMessage<CreateIngestRuleRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.CreateIngestRuleRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CreateIngestRuleRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CreateIngestRuleRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CreateIngestRuleRequest;
+    static equals(a: CreateIngestRuleRequest | PlainMessage<CreateIngestRuleRequest> | undefined, b: CreateIngestRuleRequest | PlainMessage<CreateIngestRuleRequest> | undefined): boolean;
+}
+/**
+ * Response from creating an ingest rule.
+ *
+ * @generated from message transcodely.v1.CreateIngestRuleResponse
+ */
+declare class CreateIngestRuleResponse extends Message<CreateIngestRuleResponse> {
+    /**
+     * The created rule.
+     *
+     * @generated from field: transcodely.v1.IngestRule rule = 1;
+     */
+    rule?: IngestRule;
+    /**
+     * The inbound secret, in full. Returned ONCE, here. We keep only enough of
+     * it to verify a delivery and to show you its first and last characters, so
+     * this value cannot be recovered later — rotate the rule to get a new one.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret: string;
+    constructor(data?: PartialMessage<CreateIngestRuleResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.CreateIngestRuleResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CreateIngestRuleResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CreateIngestRuleResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CreateIngestRuleResponse;
+    static equals(a: CreateIngestRuleResponse | PlainMessage<CreateIngestRuleResponse> | undefined, b: CreateIngestRuleResponse | PlainMessage<CreateIngestRuleResponse> | undefined): boolean;
+}
+/**
+ * Request to get an ingest rule.
+ *
+ * @generated from message transcodely.v1.GetIngestRuleRequest
+ */
+declare class GetIngestRuleRequest extends Message<GetIngestRuleRequest> {
+    /**
+     * ID of the rule.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    constructor(data?: PartialMessage<GetIngestRuleRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetIngestRuleRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetIngestRuleRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetIngestRuleRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetIngestRuleRequest;
+    static equals(a: GetIngestRuleRequest | PlainMessage<GetIngestRuleRequest> | undefined, b: GetIngestRuleRequest | PlainMessage<GetIngestRuleRequest> | undefined): boolean;
+}
+/**
+ * Response from getting an ingest rule.
+ *
+ * @generated from message transcodely.v1.GetIngestRuleResponse
+ */
+declare class GetIngestRuleResponse extends Message<GetIngestRuleResponse> {
+    /**
+     * The requested rule.
+     *
+     * @generated from field: transcodely.v1.IngestRule rule = 1;
+     */
+    rule?: IngestRule;
+    constructor(data?: PartialMessage<GetIngestRuleResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.GetIngestRuleResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetIngestRuleResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetIngestRuleResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetIngestRuleResponse;
+    static equals(a: GetIngestRuleResponse | PlainMessage<GetIngestRuleResponse> | undefined, b: GetIngestRuleResponse | PlainMessage<GetIngestRuleResponse> | undefined): boolean;
+}
+/**
+ * Request to list ingest rules.
+ *
+ * @generated from message transcodely.v1.ListIngestRulesRequest
+ */
+declare class ListIngestRulesRequest extends Message<ListIngestRulesRequest> {
+    /**
+     * Only rules on this origin.
+     *
+     * @generated from field: optional string origin_id = 1;
+     */
+    originId?: string;
+    /**
+     * Only enabled, or only disabled, rules.
+     *
+     * @generated from field: optional bool enabled = 2;
+     */
+    enabled?: boolean;
+    /**
+     * Pagination parameters.
+     *
+     * @generated from field: transcodely.v1.PaginationRequest pagination = 3;
+     */
+    pagination?: PaginationRequest;
+    /**
+     * 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 it to list a specific app in their org; omitted
+     * returns rules across all apps in the org.
+     *
+     * @generated from field: optional string app_id = 4;
+     */
+    appId?: string;
+    constructor(data?: PartialMessage<ListIngestRulesRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListIngestRulesRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListIngestRulesRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListIngestRulesRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListIngestRulesRequest;
+    static equals(a: ListIngestRulesRequest | PlainMessage<ListIngestRulesRequest> | undefined, b: ListIngestRulesRequest | PlainMessage<ListIngestRulesRequest> | undefined): boolean;
+}
+/**
+ * Response from listing ingest rules.
+ *
+ * @generated from message transcodely.v1.ListIngestRulesResponse
+ */
+declare class ListIngestRulesResponse extends Message<ListIngestRulesResponse> {
+    /**
+     * The rules, newest first.
+     *
+     * @generated from field: repeated transcodely.v1.IngestRule rules = 1;
+     */
+    rules: IngestRule[];
+    /**
+     * Pagination metadata.
+     *
+     * @generated from field: transcodely.v1.PaginationResponse pagination = 2;
+     */
+    pagination?: PaginationResponse;
+    constructor(data?: PartialMessage<ListIngestRulesResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListIngestRulesResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListIngestRulesResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListIngestRulesResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListIngestRulesResponse;
+    static equals(a: ListIngestRulesResponse | PlainMessage<ListIngestRulesResponse> | undefined, b: ListIngestRulesResponse | PlainMessage<ListIngestRulesResponse> | undefined): boolean;
+}
+/**
+ * Request to update an ingest rule.
+ *
+ * Every field is optional and an update applies only what it carries: a field
+ * you do not send keeps the value it has, down to the individual filters and
+ * the individual parts of the action. This matters more here than on most
+ * objects, because a rule is a standing instruction to spend money — its
+ * filters are the only thing between "the objects I meant" and "everything that
+ * lands in the bucket", and a request that silently cleared them would be paid
+ * for one transcode at a time.
+ *
+ * Because the fields inside `filters` and `action` carry no presence of their
+ * own, "not sent" means "left at its default" — the same rule
+ * UpdateVideoRequest.tags states. Set `clear_filters` or `clear_action` when
+ * you mean to remove something rather than change it.
+ *
+ * @generated from message transcodely.v1.UpdateIngestRuleRequest
+ */
+declare class UpdateIngestRuleRequest extends Message<UpdateIngestRuleRequest> {
+    /**
+     * ID of the rule to update.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * New name. Omit to leave unchanged.
+     *
+     * @generated from field: optional string name = 2;
+     */
+    name?: string;
+    /**
+     * Enable or disable the rule. Omit to leave unchanged. Turning a rule back on
+     * reports how many events it declined while it was off, in
+     * `events_skipped_while_disabled`.
+     *
+     * @generated from field: optional bool enabled = 3;
+     */
+    enabled?: boolean;
+    /**
+     * Filters to change. Each one you send replaces that filter; each one you
+     * leave out keeps the value it has. Narrowing a rule to a new prefix is
+     * therefore `{"filters": {"prefix": "raw/"}}` and nothing else — the suffix,
+     * content-type and size filters are untouched.
+     *
+     * A filter is removed rather than changed with `clear_filters`, which empties
+     * the set before this one is applied. So `clear_filters` alone widens the rule
+     * to everything in the bucket, and `clear_filters` together with a filter set
+     * replaces the set outright.
+     *
+     * @generated from field: transcodely.v1.IngestRuleFilters filters = 4;
+     */
+    filters?: IngestRuleFilters;
+    /**
+     * Parts of the action to change. Each field you send replaces that part of
+     * the action; each field you leave out keeps what it had. Repeated and map
+     * fields replace whole — sending one output replaces the output list, and
+     * sending one metadata pair replaces the metadata map — because neither
+     * carries the presence needed to merge a single entry.
+     *
+     * The destination is a pair, so it changes as a pair: send `managed` or
+     * `output_origin_id` to move the outputs, or neither to leave them where they
+     * are. Sending both is refused.
+     *
+     * `managed: false` is not a way to turn managed storage off — a false boolean
+     * is indistinguishable from an absent one, so it reads as "leave the
+     * destination alone" and changes nothing. Send `output_origin_id` instead.
+     *
+     * Emptying a repeated or map field is not expressible by sending it empty, so
+     * dropping the thumbnails or the metadata means `clear_action` with the action
+     * you want kept.
+     *
+     * @generated from field: transcodely.v1.IngestRuleAction action = 5;
+     */
+    action?: IngestRuleAction;
+    /**
+     * Issue a new secret. The previous one keeps working for 24 hours so the
+     * sender can be updated without dropping an event; the new secret is
+     * returned once, on this response.
+     *
+     * @generated from field: bool rotate_secret = 6;
+     */
+    rotateSecret: boolean;
+    /**
+     * Empty the filter set before applying `filters`. On its own it widens the
+     * rule to every object in the bucket; with `filters` it replaces the set
+     * outright instead of merging into it.
+     *
+     * @generated from field: bool clear_filters = 7;
+     */
+    clearFilters: boolean;
+    /**
+     * Replace the action outright instead of merging into it. `action` must then
+     * be complete — at least one output and exactly one destination — because
+     * nothing is carried over. This is how thumbnails or metadata are removed.
+     *
+     * @generated from field: bool clear_action = 8;
+     */
+    clearAction: boolean;
+    constructor(data?: PartialMessage<UpdateIngestRuleRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.UpdateIngestRuleRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): UpdateIngestRuleRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): UpdateIngestRuleRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): UpdateIngestRuleRequest;
+    static equals(a: UpdateIngestRuleRequest | PlainMessage<UpdateIngestRuleRequest> | undefined, b: UpdateIngestRuleRequest | PlainMessage<UpdateIngestRuleRequest> | undefined): boolean;
+}
+/**
+ * Response from updating an ingest rule.
+ *
+ * @generated from message transcodely.v1.UpdateIngestRuleResponse
+ */
+declare class UpdateIngestRuleResponse extends Message<UpdateIngestRuleResponse> {
+    /**
+     * The updated rule.
+     *
+     * @generated from field: transcodely.v1.IngestRule rule = 1;
+     */
+    rule?: IngestRule;
+    /**
+     * The new inbound secret, in full. Present only when rotate_secret was set,
+     * and returned only here.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret: string;
+    /**
+     * How many objects this rule declined while it was switched off, and can now
+     * be replayed with ReplayEvent.
+     *
+     * Returned when an update turns a paused rule back on, because pausing is
+     * advertised as safe and that is only half true: the deliveries were accepted
+     * and recorded, but nothing will retry them on its own. This is the number
+     * you would otherwise have to go and discover.
+     *
+     * @generated from field: int64 events_skipped_while_disabled = 3;
+     */
+    eventsSkippedWhileDisabled: bigint;
+    constructor(data?: PartialMessage<UpdateIngestRuleResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.UpdateIngestRuleResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): UpdateIngestRuleResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): UpdateIngestRuleResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): UpdateIngestRuleResponse;
+    static equals(a: UpdateIngestRuleResponse | PlainMessage<UpdateIngestRuleResponse> | undefined, b: UpdateIngestRuleResponse | PlainMessage<UpdateIngestRuleResponse> | undefined): boolean;
+}
+/**
+ * Request to delete an ingest rule.
+ *
+ * @generated from message transcodely.v1.DeleteIngestRuleRequest
+ */
+declare class DeleteIngestRuleRequest extends Message<DeleteIngestRuleRequest> {
+    /**
+     * ID of the rule to delete.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    constructor(data?: PartialMessage<DeleteIngestRuleRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.DeleteIngestRuleRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): DeleteIngestRuleRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): DeleteIngestRuleRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): DeleteIngestRuleRequest;
+    static equals(a: DeleteIngestRuleRequest | PlainMessage<DeleteIngestRuleRequest> | undefined, b: DeleteIngestRuleRequest | PlainMessage<DeleteIngestRuleRequest> | undefined): boolean;
+}
+/**
+ * Response from deleting an ingest rule.
+ *
+ * @generated from message transcodely.v1.DeleteIngestRuleResponse
+ */
+declare class DeleteIngestRuleResponse extends Message<DeleteIngestRuleResponse> {
+    /**
+     * The rule as it was at deletion.
+     *
+     * @generated from field: transcodely.v1.IngestRule rule = 1;
+     */
+    rule?: IngestRule;
+    constructor(data?: PartialMessage<DeleteIngestRuleResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.DeleteIngestRuleResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): DeleteIngestRuleResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): DeleteIngestRuleResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): DeleteIngestRuleResponse;
+    static equals(a: DeleteIngestRuleResponse | PlainMessage<DeleteIngestRuleResponse> | undefined, b: DeleteIngestRuleResponse | PlainMessage<DeleteIngestRuleResponse> | undefined): boolean;
+}
+/**
+ * Request to list storage events.
+ *
+ * @generated from message transcodely.v1.ListIngestEventsRequest
+ */
+declare class ListIngestEventsRequest extends Message<ListIngestEventsRequest> {
+    /**
+     * Only events for this rule. Omit for every rule in scope.
+     *
+     * @generated from field: optional string rule_id = 1;
+     */
+    ruleId?: string;
+    /**
+     * Only events with this status.
+     *
+     * @generated from field: optional transcodely.v1.StorageEventStatus status = 2;
+     */
+    status?: StorageEventStatus;
+    /**
+     * Pagination parameters.
+     *
+     * @generated from field: transcodely.v1.PaginationRequest pagination = 3;
+     */
+    pagination?: PaginationRequest;
+    /**
+     * 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 it to read a specific app in their org; omitted
+     * returns events across all apps in the org.
+     *
+     * @generated from field: optional string app_id = 4;
+     */
+    appId?: string;
+    constructor(data?: PartialMessage<ListIngestEventsRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListIngestEventsRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListIngestEventsRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListIngestEventsRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListIngestEventsRequest;
+    static equals(a: ListIngestEventsRequest | PlainMessage<ListIngestEventsRequest> | undefined, b: ListIngestEventsRequest | PlainMessage<ListIngestEventsRequest> | undefined): boolean;
+}
+/**
+ * Response from listing storage events.
+ *
+ * @generated from message transcodely.v1.ListIngestEventsResponse
+ */
+declare class ListIngestEventsResponse extends Message<ListIngestEventsResponse> {
+    /**
+     * The events, newest first.
+     *
+     * @generated from field: repeated transcodely.v1.StorageEvent events = 1;
+     */
+    events: StorageEvent[];
+    /**
+     * Pagination metadata.
+     *
+     * @generated from field: transcodely.v1.PaginationResponse pagination = 2;
+     */
+    pagination?: PaginationResponse;
+    constructor(data?: PartialMessage<ListIngestEventsResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ListIngestEventsResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ListIngestEventsResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ListIngestEventsResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ListIngestEventsResponse;
+    static equals(a: ListIngestEventsResponse | PlainMessage<ListIngestEventsResponse> | undefined, b: ListIngestEventsResponse | PlainMessage<ListIngestEventsResponse> | undefined): boolean;
 }
 /**
- * Health status of an individual component.
+ * Request to dry-run an object against a rule.
  *
- * @generated from message transcodely.v1.ComponentHealth
+ * @generated from message transcodely.v1.TestIngestRuleRequest
  */
-declare class ComponentHealth extends Message<ComponentHealth> {
+declare class TestIngestRuleRequest extends Message<TestIngestRuleRequest> {
     /**
-     * Component name (e.g., "database", "storage", "queue").
+     * ID of the rule to test.
      *
-     * @generated from field: string name = 1;
+     * @generated from field: string id = 1;
      */
-    name: string;
+    id: string;
     /**
-     * Component status.
+     * Object key to test, e.g. "uploads/clip.mp4".
      *
-     * @generated from field: transcodely.v1.HealthStatus status = 2;
+     * @generated from field: string object_key = 2;
      */
-    status: HealthStatus;
+    objectKey: string;
     /**
-     * Optional message with additional details.
+     * Bucket the object would be in. Omit to use the rule's origin bucket, which
+     * is what a real event will almost always carry.
      *
-     * @generated from field: optional string message = 3;
+     * @generated from field: string bucket = 3;
      */
-    message?: string;
-    constructor(data?: PartialMessage<ComponentHealth>);
+    bucket: string;
+    /**
+     * Object size in bytes, for testing the size filters.
+     *
+     * @generated from field: int64 size_bytes = 4;
+     */
+    sizeBytes: bigint;
+    /**
+     * Content type, for testing the content-type filter.
+     *
+     * @generated from field: string content_type = 5;
+     */
+    contentType: string;
+    /**
+     * Version identity the real event would carry — an S3/R2 eTag, a GCS
+     * generation, a Supabase metadata eTag.
+     *
+     * It changes no filter decision, and it is here for one reason: the
+     * idempotency key on the returned job request is derived from it, so a dry
+     * run that omits it predicts a key no real delivery will ever use. Supply it
+     * when you want the preview to name the key the job will actually carry.
+     *
+     * @generated from field: string etag = 6;
+     */
+    etag: string;
+    constructor(data?: PartialMessage<TestIngestRuleRequest>);
     static readonly runtime: typeof proto3;
-    static readonly typeName = "transcodely.v1.ComponentHealth";
+    static readonly typeName = "transcodely.v1.TestIngestRuleRequest";
     static readonly fields: FieldList;
-    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ComponentHealth;
-    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ComponentHealth;
-    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ComponentHealth;
-    static equals(a: ComponentHealth | PlainMessage<ComponentHealth> | undefined, b: ComponentHealth | PlainMessage<ComponentHealth> | undefined): boolean;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): TestIngestRuleRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): TestIngestRuleRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): TestIngestRuleRequest;
+    static equals(a: TestIngestRuleRequest | PlainMessage<TestIngestRuleRequest> | undefined, b: TestIngestRuleRequest | PlainMessage<TestIngestRuleRequest> | undefined): boolean;
+}
+/**
+ * Request to replay a storage event.
+ *
+ * @generated from message transcodely.v1.ReplayIngestEventRequest
+ */
+declare class ReplayIngestEventRequest extends Message<ReplayIngestEventRequest> {
+    /**
+     * ID of the event to re-queue.
+     *
+     * @generated from field: string event_id = 1;
+     */
+    eventId: string;
+    constructor(data?: PartialMessage<ReplayIngestEventRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ReplayIngestEventRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ReplayIngestEventRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ReplayIngestEventRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ReplayIngestEventRequest;
+    static equals(a: ReplayIngestEventRequest | PlainMessage<ReplayIngestEventRequest> | undefined, b: ReplayIngestEventRequest | PlainMessage<ReplayIngestEventRequest> | undefined): boolean;
+}
+/**
+ * Response from a replay.
+ *
+ * @generated from message transcodely.v1.ReplayIngestEventResponse
+ */
+declare class ReplayIngestEventResponse extends Message<ReplayIngestEventResponse> {
+    /**
+     * The event, back in `received` and waiting to be processed.
+     *
+     * @generated from field: transcodely.v1.StorageEvent event = 1;
+     */
+    event?: StorageEvent;
+    constructor(data?: PartialMessage<ReplayIngestEventResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ReplayIngestEventResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ReplayIngestEventResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ReplayIngestEventResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ReplayIngestEventResponse;
+    static equals(a: ReplayIngestEventResponse | PlainMessage<ReplayIngestEventResponse> | undefined, b: ReplayIngestEventResponse | PlainMessage<ReplayIngestEventResponse> | undefined): boolean;
+}
+/**
+ * Response from a dry run.
+ *
+ * @generated from message transcodely.v1.TestIngestRuleResponse
+ */
+declare class TestIngestRuleResponse extends Message<TestIngestRuleResponse> {
+    /**
+     * Whether the object would produce a job.
+     *
+     * @generated from field: bool matched = 1;
+     */
+    matched: boolean;
+    /**
+     * Why not, when it would not. Same slugs as StorageEvent.reason.
+     *
+     * @generated from field: string reason = 2;
+     */
+    reason: string;
+    /**
+     * The job request this rule would submit for the object. Present only when
+     * matched. Nothing was created — this is what WOULD be sent.
+     *
+     * @generated from field: transcodely.v1.CreateJobRequest job_request = 3;
+     */
+    jobRequest?: CreateJobRequest;
+    constructor(data?: PartialMessage<TestIngestRuleResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.TestIngestRuleResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): TestIngestRuleResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): TestIngestRuleResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): TestIngestRuleResponse;
+    static equals(a: TestIngestRuleResponse | PlainMessage<TestIngestRuleResponse> | undefined, b: TestIngestRuleResponse | PlainMessage<TestIngestRuleResponse> | undefined): boolean;
 }
 
-declare class Health {
+/**
+ * Ingest rules — standing instructions that turn an object landing in a watched
+ * bucket into a job, with no server of yours in the path.
+ *
+ * A rule hangs off one readable storage origin. Your provider posts its
+ * object-created events to the rule's `endpointUrl`, authenticated with the
+ * rule's secret; a delivery that passes the filters becomes a job. Duplicate
+ * deliveries are absorbed — an object is identified by (rule, bucket, key,
+ * etag) and produces exactly one job.
+ *
+ * The inbound endpoint itself is not part of this SDK: your storage provider
+ * calls it, not you.
+ */
+declare class IngestRules {
     private readonly transport;
     constructor(transport: Transport);
-    check(opts?: CallOptions): Promise<HealthCheckResponse>;
+    /**
+     * Creates a rule on a readable origin. The full response is returned because
+     * `secret` rides on it — the inbound secret is shown once, here, and cannot
+     * be read back. Store it wherever the event sender will read it from.
+     */
+    create(req: PartialMessage<CreateIngestRuleRequest>, opts?: CallOptions): Promise<CreateIngestRuleResponse>;
+    /**
+     * Fetches a rule by ID (`ing_*`). The secret is never returned again — the
+     * rule carries only `secretPrefix` and `secretHint`.
+     */
+    get(id: string, opts?: CallOptions): Promise<IngestRule>;
+    /** Rules in scope, newest first. Narrow with `originId` or `enabled`. */
+    list(req?: PartialMessage<ListIngestRulesRequest>, opts?: CallOptions): Page<IngestRule>;
+    /**
+     * Updates name, enabled state, filters or action, and optionally rotates the
+     * secret. It MERGES: an update applies only what it carries, down to the
+     * individual filters and the individual parts of the action. Narrowing a
+     * rule to a new prefix is `{ filters: { prefix: "raw/" } }` and nothing
+     * else — the suffix, content-type and size filters are untouched.
+     *
+     * Removing something rather than changing it takes the two clear flags.
+     * `clearFilters` empties the filter set before `filters` is applied, so on
+     * its own it widens the rule to everything in the bucket. `clearAction`
+     * replaces the action outright, and `action` must then be complete — at
+     * least one output and exactly one destination. That is the only way to drop
+     * an action's thumbnails or metadata, since a repeated or map field sent
+     * empty reads as "not sent".
+     *
+     * For the same reason `managed: false` does not turn managed storage off; it
+     * leaves the destination alone. Send `outputOriginId` instead.
+     *
+     * The full response is returned: a rotation puts the new secret on it (once),
+     * and switching a paused rule back on reports how many deliveries it declined
+     * while off in `eventsSkippedWhileDisabled`. After a rotation the previous
+     * secret keeps working for 24 hours.
+     */
+    update(req: PartialMessage<UpdateIngestRuleRequest>, opts?: CallOptions): Promise<UpdateIngestRuleResponse>;
+    /**
+     * Deletes a rule; its endpoint stops accepting events immediately. The events
+     * it already received are kept, and the rule as it stood is returned.
+     */
+    delete(id: string, opts?: CallOptions): Promise<IngestRule>;
+    /**
+     * Every delivery received and what came of it, newest first. Omit `ruleId`
+     * for all rules in scope; set `status` to read only the skipped or failed.
+     */
+    listEvents(req?: PartialMessage<ListIngestEventsRequest>, opts?: CallOptions): Page<StorageEvent>;
+    /**
+     * Dry-runs an object key against a rule: whether the filters match and, when
+     * they do, the exact job request the rule would submit. Nothing is stored and
+     * no job is created.
+     *
+     * Supply `etag` when you want the preview to name the idempotency key a real
+     * delivery would carry — the key is derived from it.
+     */
+    test(req: PartialMessage<TestIngestRuleRequest>, opts?: CallOptions): Promise<TestIngestRuleResponse>;
+    /**
+     * Re-queues a skipped or refused event (`sev_*`), giving the object one more
+     * pass through the rule.
+     *
+     * It exists because deduplication is permanent: re-sending the event, or
+     * re-uploading the same bytes, is absorbed and produces nothing. The event is
+     * reset rather than duplicated, so it keeps its id and its history.
+     */
+    replayEvent(eventId: string, opts?: CallOptions): Promise<StorageEvent>;
 }
 
 declare class Jobs {
@@ -14505,6 +16082,225 @@ declare class Presets {
     archive(id: string, opts?: CallOptions): Promise<Preset>;
 }
 
+/**
+ * Byte uploader for hosted videos.
+ *
+ * The API hands out presigned S3 URLs but never touches the bytes itself, so
+ * pushing a file at it is three steps: open an upload, PUT the bytes, tell the
+ * API the bytes landed. This module does all three, picking a single PUT for a
+ * file that fits in one part and an S3 multipart upload for anything larger.
+ *
+ * Everything here is plain `fetch` + Web Streams. `node:fs` is imported
+ * dynamically and only when the caller passes a filesystem path, so a bundler
+ * targeting the browser never pulls it in.
+ */
+
+/** Smallest part S3 accepts, except for the final part (5 MiB). */
+declare const MIN_PART_SIZE: number;
+/** Part size used when the caller doesn't pick one (25 MiB — the API default). */
+declare const DEFAULT_PART_SIZE: number;
+/** S3's hard ceiling on parts per multipart upload. */
+declare const MAX_PARTS = 10000;
+/** Platform upload ceiling enforced by the API (5 GB). */
+declare const MAX_UPLOAD_SIZE_BYTES = 5368709120;
+/** Parts uploaded at once when the caller doesn't pick a number. */
+declare const DEFAULT_CONCURRENCY = 4;
+/** Retries per part after the first attempt. */
+declare const DEFAULT_MAX_RETRIES = 4;
+/** First backoff step; doubles per retry, jittered, capped at 10 s. */
+declare const DEFAULT_RETRY_BASE_DELAY_MS = 500;
+/**
+ * Anything {@link Uploads.putFile} can read bytes from.
+ *
+ * - `string` — a filesystem path. Size and filename come from the path itself.
+ * - `Blob` / `File` — size comes from the blob; a `File` also supplies the name.
+ * - `ReadableStream<Uint8Array>` — you must pass `sizeBytes` and `filename`,
+ *   because the API needs both before the first byte moves.
+ */
+type UploadSource = string | Blob | ReadableStream<Uint8Array>;
+/** Progress snapshot, reported once per completed part. */
+interface UploadProgress {
+    uploadedBytes: number;
+    totalBytes: number;
+    partsCompleted: number;
+    totalParts: number;
+    /** 0–100, rounded. */
+    percent: number;
+}
+interface PutFileOptions {
+    /**
+     * App the video is created under. Optional for an API-key client: omit it
+     * and the key's own app is used. Pass it to be explicit, or when the client
+     * authenticates as a portal user, where omitting it selects the
+     * organization's first active app. An API key given a different app's ID is
+     * refused with `permission_denied`.
+     *
+     * The app does not have to have managed hosting turned on first: the create
+     * call provisions the bucket, the managed origin and the CDN pull zone on an
+     * app that has never hosted anything, which is why a first upload can take a
+     * few seconds longer than the ones after it. If that provisioning fails the
+     * request is refused with `hosting_provisioning_failed` and nothing is
+     * created, so the same call is safe to retry. A refusal on billing or
+     * admission grounds carries its own code instead (`billing_past_due`,
+     * `outstanding_balance_exceeded`, `limit_exceeded`, `intake_paused`, …).
+     */
+    appId?: string;
+    /** Required for a `Blob` or stream; inferred from the path or `File.name` otherwise. */
+    filename?: string;
+    /** Inferred from the extension (or `Blob.type`) when omitted. */
+    contentType?: string;
+    /** Required for a `ReadableStream`; ignored for a path or blob. */
+    sizeBytes?: number;
+    title?: string;
+    description?: string;
+    tags?: string[];
+    /** "public", "unlisted" or "private". Omit to take the app's default. */
+    visibility?: string;
+    /** Preset ID or slug driving the auto-transcode. */
+    preset?: string;
+    hoverPreviews?: boolean;
+    autoCaptions?: boolean;
+    /** Bytes per part. Clamped up to 5 MiB, and raised further if 10,000 parts would not cover the file. */
+    partSize?: number;
+    /** Parts in flight at once. Default 4. */
+    concurrency?: number;
+    /** Retries per part after the first attempt. Default 4. */
+    maxRetries?: number;
+    /** First backoff step in ms. Default 500. */
+    retryBaseDelayMs?: number;
+    /** Called after each part lands. Progress is per part, not per byte. */
+    onProgress?: (progress: UploadProgress) => void;
+    /** Abort the upload. In-flight parts are canceled and the multipart upload is aborted server-side. */
+    signal?: AbortSignal;
+}
+/**
+ * Part size for a file: the requested size (or the default), never below the
+ * 5 MiB S3 minimum, and raised as far as it takes to keep the part count
+ * inside S3's 10,000-part ceiling.
+ */
+declare function calculatePartSize(fileSize: number, requestedPartSize?: number): number;
+/** Number of parts a file of `fileSize` splits into at `partSize`. */
+declare function calculateTotalParts(fileSize: number, partSize: number): number;
+/** Best-effort MIME type from a filename extension. */
+declare function contentTypeForFilename(filename: string): string;
+/** The subset of VideoService the uploader drives. Lets tests stand in a double. */
+interface UploadRpcClient {
+    createUpload(req: {
+        appId?: string;
+        filename: string;
+        contentType: string;
+        sizeBytes: bigint;
+        title?: string;
+        description?: string;
+        tags?: string[];
+        visibility?: string;
+        preset?: string;
+        hoverPreviews?: boolean;
+        autoCaptions?: boolean;
+    }): Promise<{
+        video?: Video;
+        uploadUrl: string;
+    }>;
+    completeUpload(req: {
+        id: string;
+    }): Promise<{
+        video?: Video;
+    }>;
+    createMultipartUpload(req: {
+        appId?: string;
+        filename: string;
+        contentType: string;
+        sizeBytes: bigint;
+        totalParts: number;
+        partSizeBytes: bigint;
+        title?: string;
+        description?: string;
+        tags?: string[];
+        visibility?: string;
+        preset?: string;
+        hoverPreviews?: boolean;
+        autoCaptions?: boolean;
+    }): Promise<{
+        video?: Video;
+        uploadId: string;
+        parts: UploadPart[];
+    }>;
+    getUploadPartUrls(req: {
+        id: string;
+        uploadId: string;
+        partNumbers: number[];
+    }): Promise<{
+        parts: UploadPart[];
+    }>;
+    completeMultipartUpload(req: {
+        id: string;
+        uploadId: string;
+        parts: {
+            partNumber: number;
+            etag: string;
+        }[];
+    }): Promise<{
+        video?: Video;
+    }>;
+    abortMultipartUpload(req: {
+        id: string;
+        uploadId: string;
+    }): Promise<unknown>;
+}
+/**
+ * The upload state machine, decoupled from the transport so it can be driven
+ * by a double in tests. `client.uploads` is the wired-up subclass in
+ * `resources/uploads.ts`.
+ *
+ * The API's own transcode fires as soon as the upload is marked complete, so
+ * the returned `Video` is already in `processing` — watch it with
+ * `client.videos.watch(video.id)`.
+ */
+declare class UploadEngine {
+    private readonly rpc;
+    private readonly fetchImpl;
+    constructor(rpc: UploadRpcClient, fetchImpl: typeof fetch);
+    /**
+     * Upload a file and return the hosted video it created.
+     *
+     * A file that fits in one part goes up as a single PUT; anything larger uses
+     * an S3 multipart upload with `concurrency` parts in flight, per-part retry
+     * with jittered backoff, automatic re-signing when a presigned URL expires,
+     * and a server-side abort if the upload can't finish.
+     *
+     * @example
+     * ```ts
+     * const video = await client.uploads.putFile("./talk.mp4", {
+     *   appId: "app_k1l2m3n4o5",
+     *   title: "Conference talk",
+     *   onProgress: (p) => process.stdout.write(`\r${String(p.percent)}%`),
+     * });
+     * ```
+     */
+    putFile(source: UploadSource, opts: PutFileOptions): Promise<Video>;
+    private run;
+    private single;
+    private multipart;
+    /**
+     * One part, with retry/backoff. `invalidate` is what makes a 403 retryable:
+     * pass it on the multipart path, where the URL can be re-signed, and omit it
+     * for the single PUT, where there is nothing new to try.
+     */
+    private attempt;
+}
+
+/**
+ * `client.uploads` — the byte-pushing half of hosted video creation.
+ *
+ * The API only ever hands out presigned URLs; the bytes travel straight from
+ * the caller to object storage. This namespace wires {@link UploadEngine} to
+ * the SDK transport so `putFile` is one call.
+ */
+
+declare class Uploads extends UploadEngine {
+    constructor(transport: Transport);
+}
+
 /**
  * User account status.
  *
@@ -15066,8 +16862,10 @@ declare class Transcodely {
     private readonly transport;
     private _jobs;
     private _videos;
+    private _uploads;
     private _presets;
     private _origins;
+    private _ingestRules;
     private _apps;
     private _apiKeys;
     private _organizations;
@@ -15082,8 +16880,19 @@ declare class Transcodely {
     get lastRequestId(): string | undefined;
     get jobs(): Jobs;
     get videos(): Videos;
+    /**
+     * Byte uploads for hosted videos. `client.uploads.putFile(path, { appId })`
+     * runs the whole create → PUT → complete dance, picking a single PUT or an
+     * S3 multipart upload by file size.
+     */
+    get uploads(): Uploads;
     get presets(): Presets;
     get origins(): Origins;
+    /**
+     * Ingest rules: watch a bucket, transcode what lands in it. See
+     * {@link IngestRules}.
+     */
+    get ingestRules(): IngestRules;
     get apps(): Apps;
     get apiKeys(): ApiKeys;
     get organizations(): Organizations;
@@ -15106,8 +16915,29 @@ declare class Transcodely {
     get webhooks(): typeof Webhooks;
 }
 
+/**
+ * JSON serialization for the Transcodely wire format. Wraps protojson
+ * (`MessageType.toJson` / `fromJson`) with snake_case field names + lowercase
+ * simplified enum values, mirroring `internal/connect/codec.go` on the server.
+ */
+
+interface SerializeOptions {
+    /** Always emit unpopulated fields (matches server's EmitUnpopulated). */
+    emitDefaultValues?: boolean;
+}
+/**
+ * Render a generated message as a plain JSON value in the Transcodely wire
+ * format — snake_case field names, simplified lowercase enums, exactly what
+ * the REST/Connect API returns. Useful for logging and for tools that print
+ * API entities (the `transcodely` CLI's `--json` mode uses it).
+ *
+ * Unlike {@link serialize} it takes no MessageType: the message carries its
+ * own descriptor.
+ */
+declare function toWireJson<T extends Message<T>>(msg: T, opts?: SerializeOptions): JsonValue;
+
 /** SDK version. Bumped by release-please from package.json on each tag. */
-declare const SDK_VERSION = "0.3.7";
+declare const SDK_VERSION = "0.3.8";
 /**
  * API version this SDK release is pinned to. Sent on every request as
  * `Transcodely-Version`. Customers can override per-client via the
@@ -15117,4 +16947,121 @@ 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, BillingPaymentMethod, BillingPortalSession, BillingProfile, BillingStanding, BillingTreatment, BitrateMode, Budget, BurnInStyle, type CallOptions, CancelJobRequest, CancelJobResponse, CaptionStyle, ChapterPoint, ChapterResult, CheckSlugRequest, CheckSlugResponse, ClipConfig, CompleteMultipartUploadRequest, CompleteMultipartUploadResponse, CompleteUploadRequest, CompleteUploadResponse, CompletedPart, ConfirmJobRequest, ConfirmJobResponse, ConflictError, Container, ContentAnalysis, ContentAwareConfig, ContentAwareMode, ContentType, CreateAPIKeyRequest, CreateAPIKeyResponse, CreateAppRequest, CreateAppResponse, CreateBillingPortalSessionRequest, CreateBillingPortalSessionResponse, 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, DunningStage, DuplicatePresetRequest, DuplicatePresetResponse, EVENT_ID_HEADER, EnableHostingRequest, EnableHostingResponse, EncryptionScheme, EndpointHealthSummary, ErrorDetails, type EventBase, ExecutionTiming, ExposureThresholdSource, type FieldViolation, GOPAlignmentMode, GcsCredentials, GcsOriginConfig, GetAPIKeyRequest, GetAPIKeyResponse, GetAppRequest, GetAppResponse, GetBillingProfileRequest, GetBillingProfileResponse, GetBudgetRequest, GetBudgetResponse, GetEndpointHealthRequest, GetEndpointHealthResponse, GetInvoiceRequest, GetInvoiceResponse, GetJobRequest, GetJobResponse, GetMeRequest, GetMeResponse, GetMembershipRequest, GetMembershipResponse, GetOrganizationRequest, GetOrganizationResponse, GetOriginRequest, GetOriginResponse, GetOutstandingBalanceRequest, GetOutstandingBalanceResponse, 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, JobCostBreakdown, JobCostLine, JobCostLineType, 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, OutstandingBalance, Page, PaginationRequest, PaginationResponse, PaymentMethodState, PermissionError, PlayerConfig, 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, SettleOutstandingBalanceRequest, SettleOutstandingBalanceResponse, Settlement, type SpendLimitNotification, StreamingConfig, SubtitleFormat, SubtitleOperation, SubtitleResult, SubtitleStreamInfo, SubtitleTrack, ThumbnailFormat, ThumbnailMode, ThumbnailResult, ThumbnailSpec, ToneMapping, TopVideo, Transcodely, type TranscodelyConfig, TranscodelyError, TrustTier, type UnknownWebhookEvent, UpdateAppRequest, UpdateAppResponse, UpdateBudgetRequest, UpdateBudgetResponse, UpdateHostingConfigRequest, UpdateHostingConfigResponse, UpdateMeRequest, UpdateMeResponse, UpdateMembershipRoleRequest, UpdateMembershipRoleResponse, UpdateOrganizationRequest, UpdateOrganizationResponse, UpdateOriginRequest, UpdateOriginResponse, UpdatePlayerConfigRequest, UpdatePlayerConfigResponse, 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 };
+/**
+ * Health status.
+ *
+ * @generated from enum transcodely.v1.HealthStatus
+ */
+declare enum HealthStatus {
+    /**
+     * @generated from enum value: HEALTH_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Service is healthy and operational.
+     *
+     * @generated from enum value: HEALTH_STATUS_HEALTHY = 1;
+     */
+    HEALTHY = 1,
+    /**
+     * Service is degraded but operational.
+     *
+     * @generated from enum value: HEALTH_STATUS_DEGRADED = 2;
+     */
+    DEGRADED = 2,
+    /**
+     * Service is unhealthy and not operational.
+     *
+     * @generated from enum value: HEALTH_STATUS_UNHEALTHY = 3;
+     */
+    UNHEALTHY = 3
+}
+/**
+ * Request for health check.
+ *
+ * @generated from message transcodely.v1.HealthCheckRequest
+ */
+declare class HealthCheckRequest extends Message<HealthCheckRequest> {
+    /**
+     * Optional: specific service to check (empty = all).
+     *
+     * @generated from field: optional string service = 1;
+     */
+    service?: string;
+    constructor(data?: PartialMessage<HealthCheckRequest>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.HealthCheckRequest";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): HealthCheckRequest;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): HealthCheckRequest;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): HealthCheckRequest;
+    static equals(a: HealthCheckRequest | PlainMessage<HealthCheckRequest> | undefined, b: HealthCheckRequest | PlainMessage<HealthCheckRequest> | undefined): boolean;
+}
+/**
+ * Response from health check.
+ *
+ * @generated from message transcodely.v1.HealthCheckResponse
+ */
+declare class HealthCheckResponse extends Message<HealthCheckResponse> {
+    /**
+     * Overall service status.
+     *
+     * @generated from field: transcodely.v1.HealthStatus status = 1;
+     */
+    status: HealthStatus;
+    /**
+     * Service version.
+     *
+     * @generated from field: string version = 2;
+     */
+    version: string;
+    /**
+     * Individual component statuses.
+     *
+     * @generated from field: repeated transcodely.v1.ComponentHealth components = 3;
+     */
+    components: ComponentHealth[];
+    constructor(data?: PartialMessage<HealthCheckResponse>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.HealthCheckResponse";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): HealthCheckResponse;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): HealthCheckResponse;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): HealthCheckResponse;
+    static equals(a: HealthCheckResponse | PlainMessage<HealthCheckResponse> | undefined, b: HealthCheckResponse | PlainMessage<HealthCheckResponse> | undefined): boolean;
+}
+/**
+ * Health status of an individual component.
+ *
+ * @generated from message transcodely.v1.ComponentHealth
+ */
+declare class ComponentHealth extends Message<ComponentHealth> {
+    /**
+     * Component name (e.g., "database", "storage", "queue").
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Component status.
+     *
+     * @generated from field: transcodely.v1.HealthStatus status = 2;
+     */
+    status: HealthStatus;
+    /**
+     * Optional message with additional details.
+     *
+     * @generated from field: optional string message = 3;
+     */
+    message?: string;
+    constructor(data?: PartialMessage<ComponentHealth>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "transcodely.v1.ComponentHealth";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): ComponentHealth;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): ComponentHealth;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): ComponentHealth;
+    static equals(a: ComponentHealth | PlainMessage<ComponentHealth> | undefined, b: ComponentHealth | PlainMessage<ComponentHealth> | undefined): boolean;
+}
+
+export { APIConnectionError, APIError, Event as APIEvent, APIKey, API_VERSION, AV1Options, AbortMultipartUploadRequest, App, AppStatus, ArchiveAppRequest, ArchiveOriginRequest, ArchivePresetRequest, AudioCodec, AudioSettings, AudioStreamInfo, AudioTrackConfig, AuthenticationError, AutoABRConfig, AutoProfileDefaults, BYOKConfig, BillingPaymentMethod, BillingPortalSession, BillingProfile, BillingStanding, BillingTreatment, BitrateMode, Budget, BurnInStyle, type CallOptions, CancelJobRequest, CancelJobResponse, CaptionStyle, ChapterPoint, ChapterResult, CheckSlugRequest, CheckSlugResponse, ClipConfig, CompleteMultipartUploadRequest, CompleteMultipartUploadResponse, CompleteUploadRequest, CompleteUploadResponse, CompletedPart, ComponentHealth, ConfirmJobRequest, ConfirmJobResponse, ConflictError, Container, ContentAnalysis, ContentAwareConfig, ContentAwareMode, ContentType, CreateAPIKeyRequest, CreateAPIKeyResponse, CreateAppRequest, CreateAppResponse, CreateBillingPortalSessionRequest, CreateBillingPortalSessionResponse, CreateFromUrlRequest, CreateFromUrlResponse, CreateIngestRuleRequest, CreateIngestRuleResponse, CreateJobRequest, CreateJobResponse, CreateMultipartUploadRequest, CreateMultipartUploadResponse, CreateOrganizationRequest, CreateOrganizationResponse, CreateOriginRequest, CreateOriginResponse, CreatePresetRequest, CreatePresetResponse, CreateUploadRequest, CreateUploadResponse, CreateWebhookEndpointRequest, CreateWebhookEndpointResponse, DASHConfig, DEFAULT_BASE_URL, DEFAULT_CONCURRENCY, DEFAULT_MAX_RETRIES, DEFAULT_PART_SIZE, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_TOLERANCE_SECONDS, DRMConfig, DRMSystem, DailyUsage, DeleteIngestRuleRequest, DeleteIngestRuleResponse, DeleteVideoRequest, DeleteWebhookEndpointRequest, DeleteWebhookEndpointResponse, DeliveryFormat, DunningStage, DuplicatePresetRequest, DuplicatePresetResponse, EVENT_ID_HEADER, EnableHostingRequest, EnableHostingResponse, EncryptionScheme, EndpointHealthSummary, ErrorDetails, type EventBase, ExecutionTiming, ExposureThresholdSource, type FieldViolation, GOPAlignmentMode, GcsCredentials, GcsOriginConfig, GetAPIKeyRequest, GetAPIKeyResponse, GetAppRequest, GetAppResponse, GetBillingProfileRequest, GetBillingProfileResponse, GetBudgetRequest, GetBudgetResponse, GetEndpointHealthRequest, GetEndpointHealthResponse, GetIngestRuleRequest, GetIngestRuleResponse, GetInvoiceRequest, GetInvoiceResponse, GetJobRequest, GetJobResponse, GetMeRequest, GetMeResponse, GetMembershipRequest, GetMembershipResponse, GetOrganizationRequest, GetOrganizationResponse, GetOriginRequest, GetOriginResponse, GetOutstandingBalanceRequest, GetOutstandingBalanceResponse, 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, HealthCheckRequest, HealthCheckResponse, HealthStatus, HostingConfig, HttpCredentials, HttpOriginConfig, IngestRule, IngestRuleAction, IngestRuleFilters, InputMetadata, InvalidRequestError, Invoice, InvoiceLineItem, InvoiceLineType, InvoiceStatus, Job, JobCostBreakdown, JobCostLine, JobCostLineType, JobFee, JobOutput, JobPriority, JobStatus, KeyServerConfig, type KnownWebhookEvent, ListAPIKeysRequest, ListAPIKeysResponse, ListAppsRequest, ListAppsResponse, ListEventsRequest, ListEventsResponse, ListIngestEventsRequest, ListIngestEventsResponse, ListIngestRulesRequest, ListIngestRulesResponse, ListInvoicesRequest, ListInvoicesResponse, ListJobsRequest, ListJobsResponse, ListMembershipsRequest, ListMembershipsResponse, ListOrganizationsRequest, ListOrganizationsResponse, ListOriginsRequest, ListOriginsResponse, ListPresetsRequest, ListPresetsResponse, ListTopVideosRequest, ListTopVideosResponse, ListUsersRequest, ListUsersResponse, ListVideosRequest, ListVideosResponse, ListWebhookDeliveriesRequest, ListWebhookDeliveriesResponse, ListWebhookEndpointsRequest, ListWebhookEndpointsResponse, type LogEvent, MAX_PARTS, MAX_UPLOAD_SIZE_BYTES, MIN_PART_SIZE, Membership, MembershipRole, MembershipStatus, MembershipWithUser, NotFoundError, Organization, OrganizationStatus, Origin, OriginPermission, OriginProvider, OriginRef, OriginStatus, OutputFormat, OutputReport, OutputReportAudio, OutputReportColor, OutputReportContentAware, OutputReportMismatch, OutputReportVerdict, OutputReportVideo, OutputSpec, OutputStatus, OutputVariantResult, OutstandingBalance, Page, PaginationRequest, PaginationResponse, PaymentMethodState, PermissionError, PlayerConfig, PreconditionError, Preset, PresetVariant, PricingSnapshot, type PutFileOptions, QualityTier, R2Jurisdiction, R2OriginConfig, RateLimitError, RemoveMembershipRequest, ReplayIngestEventRequest, ReplayIngestEventResponse, ResendEventRequest, ResendEventResponse, Resolution, RetrieveEventRequest, RetrieveEventResponse, RetrieveWebhookEndpointRequest, RetrieveWebhookEndpointResponse, RevokeAPIKeyRequest, RotateWebhookSecretRequest, RotateWebhookSecretResponse, S3Credentials, S3OriginConfig, SDK_VERSION, SIGNATURE_HEADER, SegmentConfig, SendTestWebhookRequest, SendTestWebhookResponse, SettleOutstandingBalanceRequest, SettleOutstandingBalanceResponse, Settlement, type SpendLimitNotification, StorageEvent, StorageEventSource, StorageEventStatus, StreamingConfig, SubtitleFormat, SubtitleOperation, SubtitleResult, SubtitleStreamInfo, SubtitleTrack, TestIngestRuleRequest, TestIngestRuleResponse, ThumbnailFormat, ThumbnailMode, ThumbnailResult, ThumbnailSpec, ToneMapping, TopVideo, Transcodely, type TranscodelyConfig, TranscodelyError, TrustTier, type UnknownWebhookEvent, UpdateAppRequest, UpdateAppResponse, UpdateBudgetRequest, UpdateBudgetResponse, UpdateHostingConfigRequest, UpdateHostingConfigResponse, UpdateIngestRuleRequest, UpdateIngestRuleResponse, UpdateMeRequest, UpdateMeResponse, UpdateMembershipRoleRequest, UpdateMembershipRoleResponse, UpdateOrganizationRequest, UpdateOrganizationResponse, UpdateOriginRequest, UpdateOriginResponse, UpdatePlayerConfigRequest, UpdatePlayerConfigResponse, UpdatePresetRequest, UpdatePresetResponse, UpdateSpendLimitRequest, UpdateSpendLimitResponse, UpdateVideoRequest, UpdateVideoResponse, UpdateWebhookEndpointRequest, UpdateWebhookEndpointResponse, UploadAbortedError, UploadError, UploadPart, type UploadProgress, type UploadSource, Uploads, 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, calculatePartSize, calculateTotalParts, constructEvent, contentTypeForFilename, isEventType, isKnownEvent, toWireJson, verifySignature };