Documentation / @zerotal/core / command/builtin / ReloadCommand

Class: ReloadCommand

Defined in: command/builtin/ReloadCommand.ts:19

bun zt reload — hot-reloads routes in the running server.

Sends SIGUSR2 to the running Zerotal server, which triggers a zero-downtime route hot-swap via Bun.serve().reload(). In-flight requests are not dropped — they finish on the old route table while new requests immediately use the updated routes.

Requires: a server started with bun zt serve (writes .zerotal/server.pid).

Platform note: SIGUSR2 is a Unix/macOS signal. On Windows, use WSL or send the signal via another mechanism.

Extends

Command

Constructors

Constructor

new ReloadCommand(): ReloadCommand

Returns

ReloadCommand

Inherited from

Command.constructor

Properties

_writer

_writer: OutputWriter

Defined in: command/Command.ts:71

Output destination. Replaced with BufferWriter by Artisan.call().

Inherited from

Command._writer

args

args: Record<string, string> = {}

Defined in: command/Command.ts:74

Parsed positional arguments — set by CommandRunner before run().

Inherited from

Command.args

flags

flags: Record<string, string | boolean | number> = {}

Defined in: command/Command.ts:76

Parsed flags — set by CommandRunner before run().

Inherited from

Command.flags

app

app: unknown = undefined

Defined in: command/Command.ts:78

Application instance — set by CommandRunner when needsApp is true.

Inherited from

Command.app

commandName

static commandName: string = "reload"

Defined in: command/builtin/ReloadCommand.ts:20

Overrides

Command.commandName

description

static description: string = "Hot-reload routes in the running server (sends SIGUSR2)"

Defined in: command/builtin/ReloadCommand.ts:21

Overrides

Command.description

needsApp

static needsApp: boolean = false

Defined in: command/builtin/ReloadCommand.ts:22

Overrides

Command.needsApp

args

static args: never[] = []

Defined in: command/builtin/ReloadCommand.ts:23

Overrides

Command.args

flags

static flags: never[] = []

Defined in: command/builtin/ReloadCommand.ts:24

Overrides

Command.flags

Methods

info()

info(msg): void

Defined in: command/Command.ts:82

Parameters

msg

string

Returns

void

Inherited from

Command.info

error()

error(msg): void

Defined in: command/Command.ts:85

Parameters

msg

string

Returns

void

Inherited from

Command.error

warn()

warn(msg): void

Defined in: command/Command.ts:88

Parameters

msg

string

Returns

void

Inherited from

Command.warn

line()

line(msg): void

Defined in: command/Command.ts:91

Parameters

msg

string

Returns

void

Inherited from

Command.line

dim()

dim(msg): void

Defined in: command/Command.ts:94

Parameters

msg

string

Returns

void

Inherited from

Command.dim

write()

write(msg): void

Defined in: command/Command.ts:97

Parameters

msg

string

Returns

void

Inherited from

Command.write

newLine()

newLine(): void

Defined in: command/Command.ts:100

Returns

void

Inherited from

Command.newLine

section()

section(title): void

Defined in: command/Command.ts:103

Parameters

title

string

Returns

void

Inherited from

Command.section

table()

table(rows, indent?): void

Defined in: command/Command.ts:106

Parameters

rows

[string, string][]

indent?

number = 2

Returns

void

Inherited from

Command.table

ask()

ask(question, defaultValue?): Promise<string>

Defined in: command/Command.ts:127

Prompt the user for text input and wait for Enter.

Parameters

question

string

defaultValue?

string

Returns

Promise<string>

Example

const name = await this.ask('What is your name?');
const env  = await this.ask('Environment?', 'production');

Inherited from

Command.ask

confirm()

confirm(question, defaultValue?): Promise<boolean>

Defined in: command/Command.ts:142

Prompt the user for a yes/no confirmation. Returns true for y/yes, false otherwise.

Parameters

question

string

defaultValue?

boolean = false

Returns

Promise<boolean>

Example

const ok = await this.confirm('Run migrations?');
const ok = await this.confirm('Overwrite file?', true);

Inherited from

Command.confirm

choice()

choice(question, options): Promise<string>

Defined in: command/Command.ts:157

Prompt the user to select one option from a numbered list. Returns the selected string. Defaults to the first option on invalid input.

Parameters

question

string

options

string[]

Returns

Promise<string>

Example

const env = await this.choice('Environment:', ['local', 'staging', 'production']);

Inherited from

Command.choice

secret()

secret(question): Promise<string>

Defined in: command/Command.ts:170

Parameters

question

string

Returns

Promise<string>

Inherited from

Command.secret

_readLine()

_readLine(): Promise<string>

Defined in: command/Command.ts:213

Read one line from stdin. Override in tests to avoid blocking.

Returns

Promise<string>

Inherited from

Command._readLine

run()

run(): Promise<void>

Defined in: command/builtin/ReloadCommand.ts:26

Returns

Promise<void>

Overrides

Command.run