Mark generated endpoint methods

[kvz]

Experimental Status

Experimental work: this PR is part of an exploratory contract/generated docs and SDK effort, and is intentionally kept as a Draft while the approach is validated.

Why

API2 is becoming the source of truth for endpoint contracts and SDK generation. This draft starts the Go SDK companion cautiously: it marks existing low-level endpoint methods that API2 can regenerate byte-for-byte, so we can prove the generator can delete and rewrite without changing behavior.

What changed

• Added API2 generated-region markers around 14 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.
• Kept the method bodies and comments byte-for-byte identical; API2 rewrites these regions and compares the generated snippets back to this checkout.
• Added a blank line after each opening generated-region marker so the internal marker comments do not become part of exported Godoc blocks.

Companion PRs

• API2 contract/generator source: https://github.com/transloadit/api2/pull/7928
• Content generated docs companion: https://github.com/transloadit/content/pull/5074
• Python SDK generated low-level endpoint companion: Add asyncio support to the Python SDK python-sdk#57
• TUS client protocol-SDK generated island companion: Mark protocol versions as generated tus/tus-js-client#872
• TUS Go client protocol-SDK generated island companion: Add generated TUS protocol canary tus/tus-go-client#6
• TUS Python client protocol-SDK generated island companion: Add generated TUS protocol canary tus/tus-py-client#114

Verification

• From API2: api2/bin/cli.ts contracts sdks --platform go --sdk-root ../go-sdk --rewrite-sdk --compare-existing --no-motd
• Go SDK: go test ./... -run 'Test(NewClient|CreateSignedSmartCDNUrl|Sign|ListRequest|Integer|TemplateContent)'

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.

TUS Android client companion: tus/tus-android-client#167

TUS Java client companion: tus/tus-java-client#149

Transloadit Companion PRs

• 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

TUS Companion PRs

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

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.60%. Comparing base (1878939) to head (d4fcdcd).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #45   +/-   ##
=======================================
  Coverage   82.60%   82.60%           
=======================================
  Files           6        6           
  Lines         345      345           
=======================================
  Hits          285      285           
  Misses         32       32           
  Partials       28       28           

☔ View full report in Codecov by Sentry.
📢 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.