Application API

Bytes

Clear API and contract surface for Bytes, grouped under the application instead of split across generic reference sections.

curated svc_r2_media_manager

Documentation Map

Authority

Service IDs:

svc_r2_media_manager

Repos: PlatformApplications/TopoloBytes

Hosts:

https://bytes.topolo.app https://bytes.pages.dev

Dependencies: topolo-auth, applications-packages

Depends on Topolo Auth: yes

Contract Source

Type: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/bytes.mdx

Source exists: yes

Canonical Bytes coverage now lives in the docs application, the browser launcher lane now reads Auth-owned catalog data through same-origin /api/auth/* on the Bytes host, the browser callback delegates one-time `sso_code` exchange to the shared Auth client without exposing a legacy `/sso?token=` route or app-local `/sso/exchange` parser, accepts a compact exchanged-token payload, and SPA-navigates after auth update events so the memory-only token survives protected-route hydration. First-party embedded password login also completes through Bytes-owned router navigation after shared Auth token persistence. Closed lazy panels and modals are deferred until opened so `/browse` startup is not held behind hidden Suspense loaders. The worker now requires Topolo Auth validation for all operator bearer tokens with no Bytes-local JWT secret path. Bytes route permission checks evaluate unscoped route requirements against the `svc_r2_media_manager` service id so Auth-scoped grants match correctly. Bytes exposes `GET /api/widget` with the shared `@topolo/sdk` widget response contract for TopoloOne live workspace.

API key scopes in Auth catalog: 9

Auth Requirements

No global OpenAPI security scheme is declared.

  • api_keys.write
  • files.delete
  • files.read
  • files.write
  • folders.read
  • folders.write
  • sharing.read
  • sharing.write
  • storage.read

Runtime and Deployment

Wrangler surfaces: PlatformApplications/TopoloBytes/apps/web/wrangler.toml, PlatformApplications/TopoloBytes/apps/worker/wrangler.toml

Environment variables: NEXUS_GATEWAY_URL, SERVICE_ID

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

README-Derived Interface Surface

Source: PlatformApplications/TopoloBytes/README.md

No route-level highlights were extracted from the current README.

Package Surfaces

desktop

No package description recorded.

Source: PlatformApplications/TopoloBytes/apps/desktop/package.json

Scripts: dev, build, tauri

web

No package description recorded.

Source: PlatformApplications/TopoloBytes/apps/web/package.json

Scripts: dev, build, lint, preview, test, typecheck, test:ui, test:coverage, test:watch

worker

Cloudflare Worker for R2 Media Manager

Source: PlatformApplications/TopoloBytes/apps/worker/package.json

Scripts: dev, deploy, deploy:dry-run, start, cf-typegen, lint, typecheck, test, build

topolo-bytes

No package description recorded.

Source: PlatformApplications/TopoloBytes/package.json

Scripts: dev, dev:desktop, dev:worker, dev:worker:bg, dev:worker:remote, dev:web, build, build:desktop, build:all, deploy:worker, deploy:web, deploy, smoke:local, smoke:prod, test

Runtime Surface

Wrangler surfaces: PlatformApplications/TopoloBytes/apps/web/wrangler.toml, PlatformApplications/TopoloBytes/apps/worker/wrangler.toml

This application does not yet have a source-controlled OpenAPI spec in the docs platform. The current API page is derived from the registered contract source and repository surface.