application public active Verified 2026-04-07

Topolo Nexus

Gateway and usage-management layer for standardized AI, email, and payment provider access across the Topolo platform.

Documentation Map

What It Is

Gateway and usage-management layer for standardized AI, email, and payment provider access across the Topolo platform.

Canonical documentation for Nexus lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Runtime shape, API contracts, provider policy, deployment behavior, and migration status must be updated in the docs application rather than in repo-local guides.

Architecture

Owners: ai-platform

Source repos: PlatformApplications/TopoloNexus

Dependencies: topolo-auth

Repo shape

  • PlatformApplications/TopoloNexus/README.md
  • PlatformApplications/TopoloNexus/apps/
  • PlatformApplications/TopoloNexus/docs/
  • PlatformApplications/TopoloNexus/infra/
  • PlatformApplications/TopoloNexus/package-lock.json
  • PlatformApplications/TopoloNexus/package.json
  • PlatformApplications/TopoloNexus/packages/
  • PlatformApplications/TopoloNexus/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

No primary host is registered.

topolo-nexus-dashboard

Config: PlatformApplications/TopoloNexus/apps/dashboard/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

topolo-nexus-gateway

Config: PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloNexus/package.json

Source exists in repo: yes

Canonical docs and gateway routes define Nexus as the typed provider gateway for AI, email, payments, and provider-credential resolution, with platform-default credential mutation restricted to the configured platform super-admin account in the Auth admin organization.

App API page: /reference/apps/topolo-nexus

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

No Auth service ID mapped in docs yet.

API key scopes

No API key scopes were found in the checked-in Auth catalog for this system.

Service permissions

No role/permission catalog rows were found in the checked-in Auth permissions seed.

Data Ownership

d1

Binding: DB

Target: 61281311-2c2a-4e29-a472-cc448bcace42

Environment: default

Source: PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml

kv

Binding: CACHE

Target: c62ad2cee7044d0b868889b3206b8168

Environment: default

Source: PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

CORS_ORIGINS ENVIRONMENT

All wrangler bindings

  • DB (d1) -> 61281311-2c2a-4e29-a472-cc448bcace42
  • CACHE (kv) -> c62ad2cee7044d0b868889b3206b8168

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TopoloNexus/apps/dashboard/wrangler.toml -> topolo-nexus-dashboard
  • PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml -> topolo-nexus-gateway

Build and deploy commands

  • deploy:gateway — PlatformApplications/TopoloNexus/package.json :: cd apps/gateway && npm run deploy
  • deploy:dashboard — PlatformApplications/TopoloNexus/package.json :: cd apps/dashboard && npm run deploy
  • build — PlatformApplications/TopoloNexus/apps/dashboard/package.json :: tsc && vite build
  • preview — PlatformApplications/TopoloNexus/apps/dashboard/package.json :: vite preview
  • deploy — PlatformApplications/TopoloNexus/apps/dashboard/package.json :: npm run build && wrangler pages deploy dist --project-name topolo-nexus-dashboard
  • build — PlatformApplications/TopoloNexus/apps/gateway/package.json :: tsc --noEmit
  • deploy — PlatformApplications/TopoloNexus/apps/gateway/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloNexus/apps/gateway/package.json :: wrangler deploy --dry-run --outdir .wrangler/build
  • build — PlatformApplications/TopoloNexus/packages/nexus-client/package.json :: tsup src/index.ts --format cjs,esm --dts

Failure Modes

  • No Auth service ID is registered for this system.
  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloNexus/apps/dashboard/wrangler.toml
  • PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml
  • PlatformApplications/TopoloNexus/package.json
  • PlatformApplications/TopoloNexus/README.md
  • PlatformApplications/TopoloNexus/apps/dashboard/package.json
  • PlatformApplications/TopoloNexus/apps/gateway/package.json
  • PlatformApplications/TopoloNexus/packages/nexus-client/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-07

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.