Why

API2 now has a Java Transloadit SDK adapter that can mechanically render Java SDK endpoint methods from contract metadata. This companion PR gives that generator real marker regions to rewrite and compare, plus checked-in consumer examples that prove the generated endpoint surface against devdock.

Experimental Status

Experimental work: this PR is part of the API2 contract/generated SDK effort and is intentionally kept as a Draft while the generated surface and consumer proof examples are validated.

What changed

• The checked-in TUS Assembly example now reads createTusAssembly input from generic scenario.preparations[] instead of the removed API2 compatibility field.
• Added API2 generated endpoint markers around Java SDK methods for Assembly create/status/cancel/list, Template create/get/update/delete/list, and Bill retrieval.
• Added an API2 generated feature marker for Transloadit.createTusAssembly(fileCount), which builds the contract-owned TUS Assembly request and delegates to the generated createAssembly(options, extraData) endpoint method.
• Added an API2 generated URL endpoint variant marker for Transloadit.getAssemblyByUrl(url) and a generated Transloadit.waitForAssembly(assemblyUrl) polling feature.
• Kept the existing JavaDoc outside endpoint generated blocks so human-facing SDK docs remain checked in while the mechanical request methods become contract-owned.
• Added hand-written devdock examples for Template lifecycle, TUS Assembly upload, and Assembly lifecycle.
• The new Assembly lifecycle example proves createTusAssembly, getAssemblyByUrl, listAssemblies, and cancelAssembly together against API2 devdock using contract-injected scenario JSON.
• Enabled the examples Gradle project and added :examples:api2DevdockTemplateLifecycle, :examples:api2DevdockTusAssembly, and :examples:api2DevdockAssemblyLifecycle.
• The generated blocks are owned by API2 contracts; fixes should land in API2 and be regenerated here. The example source is intentionally hand-written SDK repo code, not generated.

Validation

• From API2: node api2/bin/cli.ts contracts sdks --no-motd --target transloadit --platform java --sdk-root ../java-sdk --compare-existing
• From API2: node api2/bin/cli.ts contracts sdks qa --no-motd --dry-run --target transloadit --platform java --proof-level git-handwritten-examples
• Java SDK: ./gradlew -q :examples:compileJava
• Java SDK: ./gradlew check
• From API2: core/bin/devdock.ts exec tstrun system/sdk_examples/java-transloadit-examples.test.ts -vv --max-time-per-test 600

Companion PRs

Transloadit

• API2 contract/generator source: https://github.com/transloadit/api2/pull/7928
• Content generated endpoint docs: https://github.com/transloadit/content/pull/5074
• Go SDK generated-region canary: Generated endpoint markers and devdock examples go-sdk#45
• Python SDK generated endpoints: Add asyncio support to the Python SDK python-sdk#57
• Node SDK generated high-level feature markers: Generated Node SDK contract markers and devdock example node-sdk#422

TUS

Allowed outward links from Transloadit to the related tus companion PRs:

• tus-js-client: Mark protocol versions as generated tus/tus-js-client#872
• tus-go-client: Add generated TUS protocol canary tus/tus-go-client#6
• tus-py-client: Add generated TUS protocol canary tus/tus-py-client#114
• tus-java-client: Add generated TUS protocol contract canary tus/tus-java-client#149
• tus-android-client: Add generated TUS protocol contract canary tus/tus-android-client#167