Application API

Topolo Forecast

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

curated srv_T0sKE7LIelMU

Documentation Map

Authority

Service IDs:

srv_T0sKE7LIelMU

Repos: PlatformApplications/TopoloForecast

Hosts:

https://forecast.topolo.app

Dependencies: topolo-auth, topolo-one, applications-packages

Depends on Topolo Auth: yes

Contract Source

Type: curated

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

Source exists: yes

Canonical Forecast coverage now lives in the docs application. The browser callback delegates Auth SSO one-time sso_code redemption to the shared Topolo auth client and does not support direct bearer-token callback URLs or /sso?token= bridge routes. Embedded first-party password-login success is completed by Forecast with in-app navigation after shared Auth token persistence so the first authenticated workspace refresh is not aborted by a hard redirect. Forecast keeps same-tab sessionStorage access-token restore enabled by default after login and refresh so normal browser reloads do not appear logged out before cookie refresh completes. The authenticated Forecast web workspace renders through the shared `TopoloAppShell` so account, launcher, command, theme, sidebar-collapse, and BugFix chrome stay package-owned while finance workspace switching remains in additive account-menu actions. Auth home-path redirects to /dashboard are routed to the current-year dashboard in the browser, and Forecast static headers must not preload wildcard asset paths. Worker bearer-token authentication now requires Topolo Auth /validate and does not accept an app-local JWT secret.

API key scopes in Auth catalog: 9

Auth Requirements

No global OpenAPI security scheme is declared.

  • api_keys.write
  • dashboard.read
  • forecasts.read
  • forecasts.write
  • reports.read
  • settings.read
  • settings.write
  • transactions.read
  • transactions.write

Runtime and Deployment

Wrangler surfaces: PlatformApplications/TopoloForecast/apps/forecast-web/wrangler.toml, PlatformApplications/TopoloForecast/apps/forecast-worker/wrangler.toml

Environment variables: ENVIRONMENT, SERVICE_ID, SERVICE_NAME, migrations_dir

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

README-Derived Interface Surface

Source: PlatformApplications/TopoloForecast/README.md

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

Package Surfaces

forecast-web

No package description recorded.

Source: PlatformApplications/TopoloForecast/apps/forecast-web/package.json

Scripts: dev, prebuild, build, build:with-types, lint, preview

@forecast/worker

No package description recorded.

Source: PlatformApplications/TopoloForecast/apps/forecast-worker/package.json

Scripts: dev, deploy, deploy:staging, prebuild, build, start, test, test:watch, lint, lint:fix, type-check, clean, cf-typegen

topolo-forecast

Gorgeous keyboard-first cash-flow & P&L SaaS dashboard

Source: PlatformApplications/TopoloForecast/package.json

Scripts: bootstrap, dev, build, build:packages, test, test:watch, lint, lint:fix, format, format:check, type-check, clean, prepare, storybook, build-storybook, deploy

@forecast/config

No package description recorded.

Source: PlatformApplications/TopoloForecast/packages/config/package.json

Scripts: build, dev, lint, lint:fix, type-check, clean

@forecast/core

No package description recorded.

Source: PlatformApplications/TopoloForecast/packages/forecast-core/package.json

Scripts: build, dev

Runtime Surface

Wrangler surfaces: PlatformApplications/TopoloForecast/apps/forecast-web/wrangler.toml, PlatformApplications/TopoloForecast/apps/forecast-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.