@transcodely/sdk 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to the Transcodely JavaScript / TypeScript SDK will be docum
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Breaking changes are allowed on minor bumps until 1.0.0.
 
+## [0.1.4](https://github.com/transcodely/transcodely-js/compare/v0.1.3...v0.1.4) (2026-07-07)
+
+
+### Documentation
+
+* **examples:** add S3-compatible (custom-endpoint) origin example ([#11](https://github.com/transcodely/transcodely-js/issues/11)) ([1d262f7](https://github.com/transcodely/transcodely-js/commit/1d262f7193fefd09f63279921d8781c6f45ae14f))
+
+## [0.1.3](https://github.com/transcodely/transcodely-js/compare/v0.1.2...v0.1.3) (2026-07-02)
+
+
+### Features
+
+* resync proto — thumbnail path_template + accumulated drift ([#9](https://github.com/transcodely/transcodely-js/issues/9)) ([b304946](https://github.com/transcodely/transcodely-js/commit/b30494607e4b969014654e75fc7e3832bc4ad79e))
+
+
+### Bug Fixes
+
+* **webhooks:** accept null request.id in envelope ([#8](https://github.com/transcodely/transcodely-js/issues/8)) ([b1c2b70](https://github.com/transcodely/transcodely-js/commit/b1c2b7073b814b8aba4ac2e4c438d291ae7461ca))
+
 ## [0.1.2](https://github.com/transcodely/transcodely-js/compare/v0.1.1...v0.1.2) (2026-07-01)
 
 

package/dist/index.cjs

@@ -3311,7 +3311,10 @@ var ResendEventRequest = class _ResendEventRequest extends protobuf.Message {
 };
 var ResendEventResponse = class _ResendEventResponse extends protobuf.Message {
   /**
-   * Newly-created pending delivery records, one per target endpoint.
+   * Newly-created pending delivery records, one per target endpoint. These are
+   * freshly queued, so response-side fields (latency_ms, response_status,
+   * response_headers, transport_error) are absent until the worker attempts
+   * delivery — re-fetch via ListWebhookDeliveries to see the completed row.
    *
    * @generated from field: repeated transcodely.v1.WebhookDelivery deliveries = 1;
    */
@@ -3392,7 +3395,9 @@ var SendTestWebhookResponse = class _SendTestWebhookResponse extends protobuf.Me
   /**
    * The newly-queued delivery row. The UI navigates the operator to its
    * detail sheet so they can watch the worker transition it from pending
-   * to succeeded / failed in real time.
+   * to succeeded / failed in real time. Because it is freshly queued,
+   * response-side fields (latency_ms, response_status, response_headers,
+   * transport_error) are absent until the worker attempts delivery.
    *
    * @generated from field: transcodely.v1.WebhookDelivery delivery = 1;
    */
@@ -7414,6 +7419,27 @@ var ThumbnailSpec = class _ThumbnailSpec extends protobuf.Message {
    * @generated from field: optional int32 sprite_columns = 9;
    */
   spriteColumns;
+  /**
+   * Per-thumbnail storage path template, resolved by the worker with
+   * thumbnail-aware variables. Precedence: this field, then the output origin's
+   * path_template, then the built-in default {job_id}/thumbnails/thumb_{thumb_index}.
+   * The job-level output_path_template is NOT applied to thumbnails (it is
+   * documented as applying to every output; thumbnails aren't outputs).
+   *
+   * Variables: {job_id}, {video_id}, {date}, {timestamp}, {uuid},
+   * {format} (image format: jpeg|png|webp), {thumb_index} (0-based),
+   * {thumb_time} (seconds, file-safe), {thumb_time_ms} (milliseconds).
+   *
+   * Example: "video/{video_id}/poster/{thumb_index}".
+   *
+   * Must not start with `/` or contain `..` (no path traversal). When set, it
+   * must reference a uniqueness token ({job_id}, {video_id}, or {uuid}) so
+   * thumbnails from different jobs never collide on a shared origin. Unset →
+   * the default above (existing keys unchanged).
+   *
+   * @generated from field: optional string path_template = 10;
+   */
+  pathTemplate;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -7429,7 +7455,8 @@ var ThumbnailSpec = class _ThumbnailSpec extends protobuf.Message {
     { no: 6, name: "timestamp", kind: "scalar", T: 1, opt: true },
     { no: 7, name: "interval_seconds", kind: "scalar", T: 1, opt: true },
     { no: 8, name: "timestamps", kind: "scalar", T: 1, repeated: true },
-    { no: 9, name: "sprite_columns", kind: "scalar", T: 5, opt: true }
+    { no: 9, name: "sprite_columns", kind: "scalar", T: 5, opt: true },
+    { no: 10, name: "path_template", kind: "scalar", T: 9, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _ThumbnailSpec().fromBinary(bytes, options);
@@ -7444,6 +7471,122 @@ var ThumbnailSpec = class _ThumbnailSpec extends protobuf.Message {
     return protobuf.proto3.util.equals(_ThumbnailSpec, a, b);
   }
 };
+var ThumbnailResult = class _ThumbnailResult extends protobuf.Message {
+  /**
+   * Storage key relative to the output origin
+   * (e.g. "job_xxx/thumbnails/thumb_0.jpg"). Stable identifier for the file.
+   *
+   * @generated from field: string storage_key = 1;
+   */
+  storageKey = "";
+  /**
+   * Fully-qualified storage URL as built by the worker
+   * (e.g. "s3://bucket/prefix/job_xxx/thumbnails/thumb_0.jpg"). Stored as-is
+   * and echoed on the Job response, exactly like JobOutput.output_url.
+   *
+   * @generated from field: string url = 2;
+   */
+  url = "";
+  /**
+   * Generation mode that produced this file: single | interval | sprite |
+   * timestamps. Lowercase string on the wire.
+   *
+   * @generated from field: string mode = 3;
+   */
+  mode = "";
+  /**
+   * File format: jpeg | png | webp. The sprite mode's WebVTT sidecar uses
+   * "vtt".
+   *
+   * @generated from field: string format = 4;
+   */
+  format = "";
+  /**
+   * Pixel dimensions. 0 when not applicable (e.g. the .vtt sidecar).
+   *
+   * @generated from field: int32 width = 5;
+   */
+  width = 0;
+  /**
+   * @generated from field: int32 height = 6;
+   */
+  height = 0;
+  /**
+   * 0-based index within a multi-file spec (interval frames, sprite tiles).
+   *
+   * @generated from field: int32 index = 7;
+   */
+  index = 0;
+  constructor(data) {
+    super();
+    protobuf.proto3.util.initPartial(data, this);
+  }
+  static runtime = protobuf.proto3;
+  static typeName = "transcodely.v1.ThumbnailResult";
+  static fields = protobuf.proto3.util.newFieldList(() => [
+    {
+      no: 1,
+      name: "storage_key",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 2,
+      name: "url",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 3,
+      name: "mode",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 4,
+      name: "format",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 5,
+      name: "width",
+      kind: "scalar",
+      T: 5
+      /* ScalarType.INT32 */
+    },
+    {
+      no: 6,
+      name: "height",
+      kind: "scalar",
+      T: 5
+      /* ScalarType.INT32 */
+    },
+    {
+      no: 7,
+      name: "index",
+      kind: "scalar",
+      T: 5
+      /* ScalarType.INT32 */
+    }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _ThumbnailResult().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _ThumbnailResult().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _ThumbnailResult().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return protobuf.proto3.util.equals(_ThumbnailResult, a, b);
+  }
+};
 
 // src/gen/transcodely/v1/job_pb.ts
 var JobStatus = /* @__PURE__ */ ((JobStatus2) => {
@@ -7933,6 +8076,17 @@ var OutputSpec = class _OutputSpec extends protobuf.Message {
    * @generated from field: optional string effective_path_template = 15;
    */
   effectivePathTemplate;
+  /**
+   * Produce a video-only output, dropping audio entirely.
+   * Override semantics: when unset, the value is inherited from the referenced
+   * preset (or defaults to false). When true, no audio stream is encoded or
+   * packaged even if the source has one. A source that has no audio is always
+   * handled gracefully (video-only) regardless of this flag.
+   * Must not be combined with explicit audio[] tracks.
+   *
+   * @generated from field: optional bool disable_audio = 16;
+   */
+  disableAudio;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -7952,7 +8106,8 @@ var OutputSpec = class _OutputSpec extends protobuf.Message {
     { no: 12, name: "drm", kind: "message", T: DRMConfig, opt: true },
     { no: 13, name: "content_aware", kind: "message", T: ContentAwareConfig, opt: true },
     { no: 14, name: "encoding_mode", kind: "scalar", T: 9, opt: true },
-    { no: 15, name: "effective_path_template", kind: "scalar", T: 9, opt: true }
+    { no: 15, name: "effective_path_template", kind: "scalar", T: 9, opt: true },
+    { no: 16, name: "disable_audio", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _OutputSpec().fromBinary(bytes, options);
@@ -8870,6 +9025,15 @@ var Job = class _Job extends protobuf.Message {
    * @generated from field: repeated transcodely.v1.ThumbnailSpec thumbnails = 25;
    */
   thumbnails = [];
+  /**
+   * Generated thumbnail artifacts (populated after the job completes). Each
+   * entry carries the worker-built storage `url` plus `mode`/`index` to
+   * correlate it back to the spec in `thumbnails` that produced it. Mirrors
+   * how JobOutput.output_url surfaces rendition results.
+   *
+   * @generated from field: repeated transcodely.v1.ThumbnailResult thumbnail_results = 28;
+   */
+  thumbnailResults = [];
   /**
    * Job-level output path template (echoed from request).
    * Variables: {job_id}, {output_id}, {date}, {timestamp}, {codec}, {resolution}, {format}, {quality}, {output_index}, {uuid}
@@ -8954,6 +9118,7 @@ var Job = class _Job extends protobuf.Message {
     },
     { no: 24, name: "execution", kind: "message", T: ExecutionTiming },
     { no: 25, name: "thumbnails", kind: "message", T: ThumbnailSpec, repeated: true },
+    { no: 28, name: "thumbnail_results", kind: "message", T: ThumbnailResult, repeated: true },
     { no: 26, name: "output_path_template", kind: "scalar", T: 9, opt: true },
     {
       no: 27,
@@ -9651,14 +9816,6 @@ var Video = class _Video extends protobuf.Message {
    * @generated from field: optional double encoding_cost = 31;
    */
   encodingCost;
-  /**
-   * @generated from field: optional double storage_cost_monthly = 32;
-   */
-  storageCostMonthly;
-  /**
-   * @generated from field: optional double egress_total = 33;
-   */
-  egressTotal;
   /**
    * Timestamps.
    *
@@ -9744,8 +9901,6 @@ var Video = class _Video extends protobuf.Message {
       /* ScalarType.INT64 */
     },
     { no: 31, name: "encoding_cost", kind: "scalar", T: 1, opt: true },
-    { no: 32, name: "storage_cost_monthly", kind: "scalar", T: 1, opt: true },
-    { no: 33, name: "egress_total", kind: "scalar", T: 1, opt: true },
     { no: 40, name: "created_at", kind: "message", T: protobuf.Timestamp },
     { no: 41, name: "updated_at", kind: "message", T: protobuf.Timestamp },
     { no: 42, name: "ready_at", kind: "message", T: protobuf.Timestamp, opt: true },
@@ -10990,7 +11145,8 @@ var WatchVideoResponse = class _WatchVideoResponse extends protobuf.Message {
    */
   video;
   /**
-   * Type of event that triggered this update (e.g., "snapshot", "status_change", "completed").
+   * Type of event that triggered this update. One of: "snapshot" (initial
+   * state on subscribe), "status_change", "progress", "completed".
    *
    * @generated from field: string event_type = 2;
    */
@@ -11138,6 +11294,12 @@ var UsageSummary = class _UsageSummary extends protobuf.Message {
    * @generated from field: double total_cost = 30;
    */
   totalCost = 0;
+  /**
+   * ISO 4217 currency code for all monetary fields in this summary (e.g. "EUR").
+   *
+   * @generated from field: string currency = 31;
+   */
+  currency = "";
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -11221,6 +11383,13 @@ var UsageSummary = class _UsageSummary extends protobuf.Message {
       kind: "scalar",
       T: 1
       /* ScalarType.DOUBLE */
+    },
+    {
+      no: 31,
+      name: "currency",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
     }
   ]);
   static fromBinary(bytes, options) {
@@ -11688,7 +11857,7 @@ function backoff(attempt) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.2";
+var SDK_VERSION = "0.1.4";
 var API_VERSION = "2026-05-03";
 var DEFAULT_BASE_URL = "https://api.transcodely.com";
 
@@ -12214,9 +12383,11 @@ var UpdateMembershipRoleRequest = class _UpdateMembershipRoleRequest extends pro
 };
 var UpdateMembershipRoleResponse = class _UpdateMembershipRoleResponse extends protobuf.Message {
   /**
-   * The updated membership.
+   * The updated membership, including user details — same shape as
+   * GetMembership / ListMemberships so a client refreshing from this response
+   * doesn't see user fields disappear after a role change.
    *
-   * @generated from field: transcodely.v1.Membership membership = 1;
+   * @generated from field: transcodely.v1.MembershipWithUser membership = 1;
    */
   membership;
   constructor(data) {
@@ -12226,7 +12397,7 @@ var UpdateMembershipRoleResponse = class _UpdateMembershipRoleResponse extends p
   static runtime = protobuf.proto3;
   static typeName = "transcodely.v1.UpdateMembershipRoleResponse";
   static fields = protobuf.proto3.util.newFieldList(() => [
-    { no: 1, name: "membership", kind: "message", T: Membership }
+    { no: 1, name: "membership", kind: "message", T: MembershipWithUser }
   ]);
   static fromBinary(bytes, options) {
     return new _UpdateMembershipRoleResponse().fromBinary(bytes, options);
@@ -13602,14 +13773,6 @@ var Preset = class _Preset extends protobuf.Message {
    * @generated from field: transcodely.v1.DeliveryFormat delivery_format = 8;
    */
   deliveryFormat = 0 /* UNSPECIFIED */;
-  /**
-   * Streaming configuration for HLS/DASH outputs.
-   * Includes segment duration, GOP alignment, and format options.
-   * DEPRECATED: segment_duration field 9 is replaced by this.
-   *
-   * @generated from field: optional transcodely.v1.StreamingConfig streaming = 17;
-   */
-  streaming;
   /**
    * Segment duration in seconds for HLS/DASH (default: 6).
    * DEPRECATED: Use streaming.segment_duration_seconds instead.
@@ -13670,6 +13833,13 @@ var Preset = class _Preset extends protobuf.Message {
    * @generated from field: repeated transcodely.v1.PresetVariant variants = 18;
    */
   variants = [];
+  /**
+   * Produce video-only outputs (no audio). When true, outputs derived from this
+   * preset drop audio entirely unless the output overrides disable_audio.
+   *
+   * @generated from field: bool disable_audio = 19;
+   */
+  disableAudio = false;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -13709,7 +13879,6 @@ var Preset = class _Preset extends protobuf.Message {
       /* ScalarType.BOOL */
     },
     { no: 8, name: "delivery_format", kind: "enum", T: protobuf.proto3.getEnumType(DeliveryFormat) },
-    { no: 17, name: "streaming", kind: "message", T: StreamingConfig, opt: true },
     { no: 9, name: "segment_duration", kind: "scalar", T: 5, opt: true },
     { no: 10, name: "video", kind: "message", T: VideoSettings },
     { no: 11, name: "audio", kind: "message", T: AudioSettings },
@@ -13724,7 +13893,14 @@ var Preset = class _Preset extends protobuf.Message {
     },
     { no: 15, name: "created_at", kind: "message", T: protobuf.Timestamp },
     { no: 16, name: "updated_at", kind: "message", T: protobuf.Timestamp },
-    { no: 18, name: "variants", kind: "message", T: PresetVariant, repeated: true }
+    { no: 18, name: "variants", kind: "message", T: PresetVariant, repeated: true },
+    {
+      no: 19,
+      name: "disable_audio",
+      kind: "scalar",
+      T: 8
+      /* ScalarType.BOOL */
+    }
   ]);
   static fromBinary(bytes, options) {
     return new _Preset().fromBinary(bytes, options);
@@ -13819,11 +13995,18 @@ var CreatePresetRequest = class _CreatePresetRequest extends protobuf.Message {
   /**
    * Multi-variant ABR configuration (max 20 variants).
    * Only valid when delivery_format is hls, dash, or cmaf.
-   * Requires at least 2 variants when non-empty.
+   * Requires at least 1 variant when non-empty; a single variant produces a
+   * single-rendition streaming output (e.g. one vertical 720p HLS stream).
    *
    * @generated from field: repeated transcodely.v1.PresetVariant variants = 14;
    */
   variants = [];
+  /**
+   * Produce video-only outputs (no audio). Default: false.
+   *
+   * @generated from field: optional bool disable_audio = 15;
+   */
+  disableAudio;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -13855,7 +14038,8 @@ var CreatePresetRequest = class _CreatePresetRequest extends protobuf.Message {
     { no: 9, name: "video", kind: "message", T: VideoSettings },
     { no: 10, name: "audio", kind: "message", T: AudioSettings },
     { no: 11, name: "quality_tier", kind: "enum", T: protobuf.proto3.getEnumType(QualityTier) },
-    { no: 14, name: "variants", kind: "message", T: PresetVariant, repeated: true }
+    { no: 14, name: "variants", kind: "message", T: PresetVariant, repeated: true },
+    { no: 15, name: "disable_audio", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _CreatePresetRequest().fromBinary(bytes, options);
@@ -14215,6 +14399,13 @@ var UpdatePresetRequest = class _UpdatePresetRequest extends protobuf.Message {
    * @generated from field: repeated transcodely.v1.PresetVariant variants = 15;
    */
   variants = [];
+  /**
+   * New disable_audio setting (optional). When true, outputs from this preset
+   * are video-only.
+   *
+   * @generated from field: optional bool disable_audio = 16;
+   */
+  disableAudio;
   constructor(data) {
     super();
     protobuf.proto3.util.initPartial(data, this);
@@ -14241,7 +14432,8 @@ var UpdatePresetRequest = class _UpdatePresetRequest extends protobuf.Message {
     { no: 10, name: "video", kind: "message", T: VideoSettings, opt: true },
     { no: 11, name: "audio", kind: "message", T: AudioSettings, opt: true },
     { no: 12, name: "quality_tier", kind: "enum", T: protobuf.proto3.getEnumType(QualityTier), opt: true },
-    { no: 15, name: "variants", kind: "message", T: PresetVariant, repeated: true }
+    { no: 15, name: "variants", kind: "message", T: PresetVariant, repeated: true },
+    { no: 16, name: "disable_audio", kind: "scalar", T: 8, opt: true }
   ]);
   static fromBinary(bytes, options) {
     return new _UpdatePresetRequest().fromBinary(bytes, options);
@@ -16073,7 +16265,12 @@ function buildEvent(parsed) {
   if (!isPlainObject(requestRaw)) {
     throw new WebhookPayloadError("Webhook envelope field `request` must be a JSON object");
   }
-  const requestId = requireString(requestRaw, "id");
+  const requestIdRaw = requestRaw["id"];
+  if (requestIdRaw !== null && (typeof requestIdRaw !== "string" || requestIdRaw.length === 0)) {
+    throw new WebhookPayloadError(
+      "Webhook envelope field `request.id` must be a non-empty string or null"
+    );
+  }
   const idempotencyKeyRaw = requestRaw["idempotency_key"];
   if (idempotencyKeyRaw !== null && typeof idempotencyKeyRaw !== "string") {
     throw new WebhookPayloadError(
@@ -16091,7 +16288,7 @@ function buildEvent(parsed) {
     data,
     livemode,
     pendingWebhooks,
-    request: { id: requestId, idempotencyKey: idempotencyKeyRaw }
+    request: { id: requestIdRaw, idempotencyKey: idempotencyKeyRaw }
   };
 }