Generated endpoint markers and devdock examples

[kvz]

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 is validated.

Why

API2 is becoming the source of truth for endpoint contracts and SDK generation. This Go SDK companion proves two things cautiously: API2 can delete/rewrite generated Go regions without behavior drift, and checked-in Go examples can exercise that generated surface against devdock as normal consumer code.

What changed

• Added API2 generated-region markers around existing Go SDK endpoint methods: Assembly status/cancel/list, Assembly notification replay, Template create/get/update/delete/list, and Template Credential create/get/update/delete/list.
• Added generated high-level feature methods including Client.CreateTusAssembly() and Client.WaitForAssembly() coverage through API2's generator.
• Added generated model conformance guard coverage for AssemblyInfo / FileInfo fields that the contract says SDK examples need.
• Added a checked-in, hand-written devdock TUS Assembly example at examples/api2-devdock-tus-assembly/main.go.
• The generated regions are owned by API2 contracts; fixes should land in API2 and be regenerated here.
• The examples are deliberately not generated: they are idiomatic consumer proofs. API2 injects scenario JSON and validates the results.
• The TUS Assembly example now reads generic scenario.preparations[] feature-call input for createTusAssembly instead of the temporary scenario.createTusAssembly compatibility field.

Verification

• From API2: api2/bin/cli.ts contracts sdks --no-motd --target transloadit --platform go --sdk-root ../go-sdk --rewrite-sdk --compare-existing
• From API2: core/bin/devdock.ts exec tstrun system/sdk_examples/go-transloadit-examples.test.ts -vv --max-time-per-test 420
• Go SDK: go test ./examples/api2-devdock-tus-assembly ./examples/api2-devdock-template-lifecycle
• Go SDK: go test ./... -run 'Test(NewClient|FormFieldValue|AssemblyInfo_TusFields)'

Notes

Full go test ./... still expects live TRANSLOADIT_KEY/TRANSLOADIT_SECRET for integration-style tests. I left those untouched and ran the credential-free subset plus API2's devdock system example lane.

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
• Python SDK generated endpoints: Add asyncio support to the Python SDK python-sdk#57
• Node SDK generated markers: Generated Node SDK contract markers and devdock example node-sdk#422
• Java SDK generated endpoint markers: Generated Java SDK contract markers java-sdk#101

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

[codecov-commenter]

Codecov Report

❌ Patch coverage is 13.82979% with 81 lines in your changes missing coverage. Please review.
✅ Project coverage is 67.88%. Comparing base (1878939) to head (3311a27).

Files with missing lines	Patch %	Lines
assembly.go	0.00%	74 Missing ⚠️
transloadit.go	65.00%	6 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##             main      #45       +/-   ##
===========================================
- Coverage   82.60%   67.88%   -14.73%     
===========================================
  Files           6        6               
  Lines         345      439       +94     
===========================================
+ Hits          285      298       +13     
- Misses         32      112       +80     
- Partials       28       29        +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.