Interface INotifyPrimitive

Lightweight notify primitive interface.

Responsibilities:

Accept user-facing notification requests at any time (including before boot).
Buffer messages that arrive before a renderer is registered.
Forward messages to the active renderer once one is registered.
Fall back to console when no renderer is registered.

interface INotifyPrimitive {
    notify(message: string, level?: NotifyLevel): void;
    registerRenderer(renderer: NotifyRenderer): void;
    unregisterRenderer(renderer?: NotifyRenderer): void;
    flush(): void;
}

Index

Methods

notify registerRenderer unregisterRenderer flush

Methods

notify

notify(message: string, level?: NotifyLevel): void
Emits a user-facing notification.
- If a renderer is registered: delegates immediately.
- If no renderer yet: buffers the message and logs a console fallback.
Parameters
- message: string
  Text to display.
- Optionallevel: NotifyLevel
  Severity level (default: "info").
Returns void
- Defined in src/contracts/notify.contract.ts:48

registerRenderer

registerRenderer(renderer: NotifyRenderer): void
Registers the active renderer and flushes any buffered messages. Calling this a second time replaces the previous renderer.
Parameters
- renderer: NotifyRenderer
  Function that displays one notification.
Returns void
- Defined in src/contracts/notify.contract.ts:56

unregisterRenderer

unregisterRenderer(renderer?: NotifyRenderer): void
Detaches the active renderer, returning the primitive to its pre-boot behaviour (buffer + console fallback). A renderer that is torn down MUST call this, or the primitive keeps handing messages to a dead renderer that silently drops them — and the console fallback never fires, because the primitive believes it still has somewhere to render.
Parameters
- Optionalrenderer: NotifyRenderer
  The renderer to detach. Passing the one currently registered clears it; passing any other value is a no-op, so a late teardown cannot unregister a renderer that replaced it in the meantime. Omit the argument to clear unconditionally.
Returns void
- Defined in src/contracts/notify.contract.ts:70

flush

flush(): void
Drains the internal queue, forwarding each buffered message to the currently registered renderer. No-op if no renderer is registered.

Returns void
- Defined in src/contracts/notify.contract.ts:76