Skip to main content
zerotal

Documentation

Documentation / zerotal / session / SessionProvider

Class: SessionProvider

Defined in: packages/session/src/provider/SessionProvider.ts:38

Service provider that wires up sessions: it registers the session.driver and session (the SessionAccessor facade) container singletons, auto-registers SessionMiddleware on boot, and warns when running in production without session.secure.

Remarks

The session.driver binding builds a CookieDriver (default) or RedisDriver from the session config namespace. Config keys read:

  • session.driver — 'cookie' (default) | 'redis'
  • session.secret — signing/encryption secret (default: 'changeme')
  • session.cookie — cookie name (default: 'session')
  • session.lifetime — session lifetime in seconds (default: 86400)
  • session.secure — require HTTPS for the cookie (default: false)
  • session.redis — Redis URL, redis driver only (default: 'redis://localhost:6379')

Registered only in the web and test environments.

Extends

Constructors

Constructor

new SessionProvider(app): SessionProvider

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

Parameters

app

Application

Returns

SessionProvider

Inherited from

ServiceProvider.constructor

Properties

dependsOn?

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

Defined in: packages/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: packages/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: packages/core/src/provider/ServiceProvider.ts:44

Inherited from

ServiceProvider.app

provides

static provides: readonly ["session.driver", "session"]

Defined in: packages/session/src/provider/SessionProvider.ts:39

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: packages/session/src/provider/SessionProvider.ts:40

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

Overrides

ServiceProvider.environments

Methods

onStarting()

onStarting(): Promise<void>

Defined in: packages/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: packages/core/src/provider/ServiceProvider.ts:55

Run once the app has started.

Returns

Promise<void>

Inherited from

ServiceProvider.onStarted

onStopping()

onStopping(): Promise<void>

Defined in: packages/core/src/provider/ServiceProvider.ts:57

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

Returns

Promise<void>

Inherited from

ServiceProvider.onStopping

onStopped()

onStopped(): Promise<void>

Defined in: packages/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: packages/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: packages/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: packages/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: packages/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