Documentation

Documentation / @zerotal/devtools / index / DevtoolsProvider

Class: DevtoolsProvider

Defined in: devtools/src/provider/DevtoolsProvider.ts:61

Activates Zerotal DevTools for web environments. No-op in production.

Register in bootstrap/app.ts:

import { DevtoolsProvider } from '@zerotal/devtools';

Application.create()
  .register([DatabaseProvider, DevtoolsProvider])

In development the floating panel is auto-injected into HTML responses — no DevTools.start() in your app bundle. (You can still import it manually from @zerotal/devtools/client if you prefer to control startup.)

Routes served automatically: GET /__zerotal/devtools standalone inspector dashboard GET /__zerotal/devtools/client.js injected in-page panel bundle GET /__zerotal/devtools/sse SSE stream (EventSource) GET /__zerotal/devtools/api/traces recent request traces (JSON) GET /__zerotal/devtools/api/channels declared trace channels (JSON) POST /__zerotal/devtools/api/clear clear trace history

Extends

• ServiceProvider

Constructors

Constructor

new DevtoolsProvider(app): DevtoolsProvider

Defined in: core/src/provider/ServiceProvider.ts:44

Parameters

app

Application

Returns

DevtoolsProvider

Inherited from

ServiceProvider.constructor

Properties

dependsOn?

static optional dependsOn?: (app) => ServiceProvider[]

Defined in: core/src/provider/ServiceProvider.ts:35

Other providers this one needs. They are pulled into the application automatically (transitively, de-duplicated) and guaranteed to boot before this provider — so you only have to register the feature you want, not its plumbing. Reference the provider classes directly:

Parameters

app

Application

Returns

ServiceProvider

Example

static override dependsOn = [FlowProvider];

Inherited from

ServiceProvider.dependsOn

priority?

static optional priority?: number

Defined in: core/src/provider/ServiceProvider.ts:42

Boot-order tiebreak among providers with no dependsOn relationship. Lower boots earlier; defaults to 0. Handy for framework-core providers (e.g. static override priority = -100).

Inherited from

ServiceProvider.priority

app

protected app: Application

Defined in: core/src/provider/ServiceProvider.ts:44

Inherited from

ServiceProvider.app

provides

static provides: readonly []

Defined in: devtools/src/provider/DevtoolsProvider.ts:66

Container tokens this provider registers. Required when using the array form of app.defer([Provider, ...]).

Example

static override provides = ['cache'] as const;

Overrides

ServiceProvider.provides

environments

static environments: AppEnvironment[]

Defined in: devtools/src/provider/DevtoolsProvider.ts:67

Environments in which this provider is active. Defaults to all of them.

Overrides

ServiceProvider.environments

Methods

onRegister()

onRegister(): void

Defined in: core/src/provider/ServiceProvider.ts:47

Register container bindings. Runs before any provider boots; do not resolve services here.

Returns

void

Inherited from

ServiceProvider.onRegister

onStarting()

onStarting(): Promise<void>

Defined in: core/src/provider/ServiceProvider.ts:53

Run just before the app starts accepting work (e.g. the HTTP server).

Returns

Promise<void>

Inherited from

ServiceProvider.onStarting

onStarted()

onStarted(): Promise<void>

Defined in: core/src/provider/ServiceProvider.ts:55

Run once the app has started.

Returns

Promise<void>

Inherited from

ServiceProvider.onStarted

onStopped()

onStopped(): Promise<void>

Defined in: core/src/provider/ServiceProvider.ts:59

Run once shutdown is complete.

Returns

Promise<void>

Inherited from

ServiceProvider.onStopped

onRequestReceived()

onRequestReceived(_ctx): Promise<void>

Defined in: core/src/provider/ServiceProvider.ts:66

Called before the middleware pipeline runs.

Parameters

_ctx

HttpContext

Returns

Promise<void>

Inherited from

ServiceProvider.onRequestReceived

onRequestProcessed()

onRequestProcessed(_ctx): Promise<void>

Defined in: core/src/provider/ServiceProvider.ts:69

Called after the pipeline completes and ctx.response is set.

Parameters

_ctx

HttpContext

Returns

Promise<void>

Inherited from

ServiceProvider.onRequestProcessed

onResponseSent()

onResponseSent(_ctx): Promise<void>

Defined in: core/src/provider/ServiceProvider.ts:72

Called after the response has been sent to the client.

Parameters

_ctx

HttpContext

Returns

Promise<void>

Inherited from

ServiceProvider.onResponseSent

replContext()

replContext(): Record<string, unknown>

Defined in: core/src/provider/ServiceProvider.ts:81

Variables to expose in bun zt repl. Override in any provider to make its facades available by name in the REPL session.

Returns

Record<string, unknown>

Example

override replContext() { return { DB, Mail }; }

Inherited from

ServiceProvider.replContext

onBooting()

onBooting(): Promise<void>

Defined in: devtools/src/provider/DevtoolsProvider.ts:73

Resolve and prepare services before the app is considered booted.

Returns

Promise<void>

Overrides

ServiceProvider.onBooting

onBooted()

onBooted(): Promise<void>

Defined in: devtools/src/provider/DevtoolsProvider.ts:118

Run once all providers have booted and every binding is available.

Returns

Promise<void>

Overrides

ServiceProvider.onBooted

onStopping()

onStopping(): Promise<void>

Defined in: devtools/src/provider/DevtoolsProvider.ts:134

Run when the app begins a graceful shutdown; release resources here.

Returns

Promise<void>

Overrides

ServiceProvider.onStopping