Skip to content

NAT-335: Add HEVC and 4K upload standardization - #152

Merged
eugene-mux merged 15 commits into
mainfrom
feature/nat-335-hevc-standard-ingest
Sep 16, 2026
Merged

eugene-mux merged 15 commits into
mainfrom
feature/nat-335-hevc-standard-ingest

Conversation

@eugene-mux

@eugene-mux eugene-mux commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Add HEVC and high-resolution support to the Swift Upload SDK. Compliant H.264 and HEVC inputs upload without re-encoding; inputs requiring conversion preserve their codec where supported and are validated before upload.

  • Keep 1080p as the default, with opt-in 1440p and 2160p support.
  • Preserve eligible HDR by default and offer explicit HDR-to-SDR tone mapping.
  • Fall back to the original input when standardization cannot complete.
  • Integrate inspection, conversion, validation, and diagnostic logging into DirectUpload, with cancellation and pause/resume coverage.

Note

High Risk
Large changes to the upload preprocessing path (inspection, transcoding, validation) and a breaking platform bump to iOS 15; incorrect fallback or HDR handling could affect ingest quality or upload success.

Overview
Adds on-device input standardization for Direct Uploads: inspect H.264/HEVC (codec, HDR, GOP, timeline), evaluate against Mux policy tiers (default 1080p, opt-in 1440p/2160p), then upload as-is, transcode with AVAssetReader/AVAssetWriter (including HDR preserve or tone-map to SDR), or fall back to the original file when planning/conversion/validation cannot complete. Inspection moves to async Swift concurrency with cancellable operations; standardization workers are actors with explicit cancel and temp-storage preflight.

The sample app and README wire DirectUploadOptions.inputStandardization to matching new_asset_settings.max_resolution_tier on Direct Upload creation and document nonStandardInputHandler. Minimum iOS/iPadOS is raised from 14 to 15 in Package.swift and the podspec.

Reviewed by Cursor Bugbot for commit 2dee6fa. Bugbot is set up for automated code reviews on this repo. Configure here.

* NAT-481: Add HEVC and 4K public API

* Handle missing iOS simulators
* NAT-485: Inspect GOP and keyframe characteristics

* NAT-485: Synchronize inspection cancellation
* NAT-486: Plan and validate input standardization

* Remove ticket references from validation code

* NAT-486: Fix aspect ratio alignment tolerance

* Serialize upload cancellation and transport start

* Refine cancellation lifecycle synchronization

* Isolate upload lifecycle attempts

* Scope inspection cancellation to upload attempts
…#143)

* NAT-487: Build codec-preserving conversion pipeline

* Coordinate conversion cancellation and failures

* Modernize input standardization concurrency

* Scope standardization cancellation to attempts

* Remove ticket references from test fixtures

* Improve conversion cancellation coverage
* NAT-488: Add Standard Input encoder controls

* Fix edit-list inspection and simulator conversion
* NAT-490: Integrate DirectUpload standardization

* Stabilize direct upload fallback test

* Make direct upload lifecycle tests deterministic

* Isolate asynchronous direct upload tests

* Clean up standardized output after upload failure
* NAT-492: Fix timeline validation and preparation pause

* NAT-492: Archive external fixture test hooks

* Fix deferred inspection test synchronization
@eugene-mux
eugene-mux marked this pull request as ready for review September 14, 2026 22:09
@eugene-mux
eugene-mux requested a review from a team as a code owner September 14, 2026 22:09

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 7096faf. Configure here.

@daytime-em daytime-em left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CI passes, Bugbot is happy, everything is already reviewed.. Easy +1 👍

* NAT-493: Update README and sample app

* NAT-493: Update DocC API reference
@eugene-mux
eugene-mux merged commit 93295af into main Sep 16, 2026
6 checks passed
@eugene-mux
eugene-mux deleted the feature/nat-335-hevc-standard-ingest branch September 16, 2026 23:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants