droboticflow/internal/api/routes_object_sync.go
d-robotics 994fa59982 ♻️ Split API route registration into per-domain routes_*.go files
routes.go keeps only the global middleware chain, the shared business-role
sets, and one mount call per domain: system, dashboard, acceptance, human
loop, annotation, projects, organization, workflows, runs, delivery, data
platform, and object sync. Role-only groups become withRoles/With on the
routes they guard, so each route's permission sits next to it instead of in
a role-shaped group far from the rest of its domain.

No route, handler, or access change: testdata/routes.golden (generated from
the pre-split router) is byte-identical, the Go known-failure gate passes,
and a live API smoke against a throwaway DB matched the access matrix for
every parameter-free GET route across six identities.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 18:50:40 +08:00

80 lines
5.1 KiB
Go

package api
import (
"time"
"github.com/go-chi/chi/v5"
)
// mountObjectSyncRoutes registers the drosync object-sync admin API and the
// credential-authenticated external API used by sync clients. Both are gated
// by the object-sync feature flag.
func (server *server) mountObjectSyncRoutes(router chi.Router) {
router.Route("/api/object-sync", func(router chi.Router) {
router.Use(server.requireObjectSyncFeature)
annotators := server.withRoles(router, rolesAnnotationWork...)
annotators.Get("/spaces", server.handleObjectSyncSpacesList)
annotators.Get("/sessions", server.handleObjectSyncSessionsList)
annotators.Get("/sessions/{id}", server.handleObjectSyncSessionGet)
annotators.Get("/sessions/{id}/items", server.handleObjectSyncSessionItems)
annotators.Get("/client-releases", server.handleObjectSyncClientReleasesList)
annotators.Get("/client-releases/{id}/artifacts/{platform}", server.handleObjectSyncClientReleaseDownload)
annotators.Head("/client-releases/{id}/artifacts/{platform}", server.handleObjectSyncClientReleaseDownload)
admin := server.withRoles(router, rolesAdmin...)
idempotentAdmin := admin.With(server.requireObjectSyncIdempotency)
idempotentAdmin.Post("/spaces", server.handleObjectSyncSpaceCreate)
idempotentAdmin.Put("/spaces/{id}", server.handleObjectSyncSpaceUpdate)
idempotentAdmin.Post("/spaces/{id}/capability-probe", server.handleObjectSyncCapabilityProbe)
idempotentAdmin.Post("/spaces/{id}/reconcile", server.handleObjectSyncReconcileCreate)
idempotentAdmin.Get("/devices", server.handleObjectSyncDevicesList)
idempotentAdmin.Get("/device-authorizations", server.handleObjectSyncDeviceApprovalRemoved)
idempotentAdmin.Get("/device-authorizations/by-code", server.handleObjectSyncDeviceApprovalRemoved)
idempotentAdmin.Post("/device-authorizations/{id}/{decision}", server.handleObjectSyncDeviceApprovalRemoved)
idempotentAdmin.Get("/credentials", server.handleObjectSyncCredentialsList)
idempotentAdmin.Post("/credentials", server.handleObjectSyncCredentialCreate)
idempotentAdmin.Post("/credentials/{id}/{action}", server.handleObjectSyncCredentialMutation)
idempotentAdmin.Post("/sessions/{id}/admin-abort", server.handleObjectSyncSessionAdminAbort)
idempotentAdmin.Post("/leases/{id}/force-release", server.handleObjectSyncLeaseForceRelease)
idempotentAdmin.Post("/items/{id}/force-overwrite", server.handleObjectSyncItemForceOverwrite)
idempotentAdmin.Post("/client-releases", server.handleObjectSyncClientReleaseUpsert)
admin.Get("/releases", server.handleObjectSyncReleasesList)
idempotentAdmin.Post("/releases", server.handleObjectSyncReleaseCreate)
admin.Get("/audit-events", server.handleObjectSyncAuditList)
admin.Get("/audit-events/export", server.handleObjectSyncAuditExport)
admin.Get("/audit-seals/{day}", server.handleObjectSyncAuditSealGet)
})
router.Route("/api/external/object-sync", func(router chi.Router) {
router.Use(server.requireObjectSyncFeature)
unauthenticated := router.With(server.objectSyncDistributedRateLimit(30, time.Minute), server.requireObjectSyncIdempotency)
unauthenticated.Post("/device-authorizations", server.handleObjectSyncDeviceApprovalRemoved)
unauthenticated.Post("/device-authorizations/token", server.handleObjectSyncDeviceApprovalRemoved)
unauthenticated.Post("/auth/token", server.handleExternalObjectSyncAccessKeyAuth)
client := router.With(
server.objectSyncCredentialAuth,
server.objectSyncDistributedRateLimit(600, time.Minute),
server.requireObjectSyncIdempotency,
)
client.Get("/capabilities", server.handleExternalObjectSyncCapabilities)
client.Post("/sessions", server.handleExternalObjectSyncSessionCreate)
client.Post("/sessions/{sessionId}/manifest-pages", server.handleExternalObjectSyncManifestPage)
client.Post("/sessions/{sessionId}/plan", server.handleExternalObjectSyncPlan)
client.Get("/sessions/{sessionId}/status", server.handleExternalObjectSyncSessionStatus)
client.Get("/sessions/{sessionId}/items", server.handleExternalObjectSyncSessionItems)
client.Post("/sessions/{sessionId}/{action}", server.handleExternalObjectSyncSessionFinish)
client.Post("/items/{itemId}/reserve", server.handleExternalObjectSyncItemReserve)
client.Post("/items/{itemId}/uploads/direct", server.handleExternalObjectSyncDirectUpload)
client.Post("/items/{itemId}/uploads/direct/complete", server.handleExternalObjectSyncDirectUploadComplete)
client.Post("/items/{itemId}/uploads/multipart", server.handleExternalObjectSyncMultipartInitiate)
client.Post("/items/{itemId}/uploads/multipart/part-url", server.handleExternalObjectSyncMultipartPartURL)
client.Post("/items/{itemId}/uploads/multipart/parts", server.handleExternalObjectSyncMultipartPartCheckpoint)
client.Post("/items/{itemId}/uploads/multipart/complete", server.handleExternalObjectSyncMultipartComplete)
client.Post("/items/{itemId}/heartbeat", server.handleExternalObjectSyncHeartbeat)
client.Post("/items/{itemId}/abort", server.handleExternalObjectSyncItemAbort)
client.Post("/items/{itemId}/commit", server.handleExternalObjectSyncCommit)
client.Get("/client-updates", server.handleExternalObjectSyncUpdateCheck)
})
}