Skip to content

Framework Bindings & Meta-Frameworks

Framework-idiomatic reactive stream bindings (litestar-vite-plugin/react, /vue, /svelte) and meta-framework Vite/Nitro integrations (litestar-vite-plugin/astro, /sveltekit, /nuxt).

Subpath Import Specifier Source Entrypoint Exports
./react litestar-vite-plugin/react src/js/src/react/index.ts EventStreamState, ReactEventStreamOptions, ReactQueueEventStreamOptions, AdapterOptions, StreamFactory, useEventStream, +1 more
./vue litestar-vite-plugin/vue src/js/src/vue/index.ts VueEventStreamState, VueEventStreamOptions, VueQueueEventStreamOptions, AdapterOptions, StreamFactory, useEventStream, +1 more
./svelte litestar-vite-plugin/svelte src/js/src/svelte/index.ts EventStreamStoreState, SvelteEventStreamOptions, SvelteQueueEventStreamOptions, AdapterOptions, StreamFactory, createEventStreamStore, +1 more
./astro litestar-vite-plugin/astro src/js/src/astro.ts AstroConfigPartial, AddressInfo, AstroIntegration, AstroIntegrationLogger, AstroTypesConfig, LitestarAstroConfig, +1 more
./sveltekit litestar-vite-plugin/sveltekit src/js/src/sveltekit.ts SvelteKitTypesConfig, LitestarSvelteKitConfig, litestarSvelteKit
./nuxt litestar-vite-plugin/nuxt src/js/src/nuxt.ts NuxtModuleFunction, ListenInfo, NuxtContext, NuxtTypesConfig, LitestarNuxtConfig, litestarModule

litestar-vite-plugin/react

Package Subpath: ./react · Types: ./dist/js/react/index.d.ts · Source: src/js/src/react/index.ts

React bindings for generic and Litestar Queues event streams.

Export Kind Description
EventStreamState interface Exported interface from src/js/src/react/index.ts.
ReactEventStreamOptions type Exported type from src/js/src/react/index.ts.
ReactQueueEventStreamOptions type Exported type from src/js/src/react/index.ts.
AdapterOptions type Exported type from src/js/src/react/index.ts.
StreamFactory type Exported type from src/js/src/react/index.ts.
useEventStream function Subscribe a React component to a generic event stream.
useQueueEventStream function Subscribe a React component to a Litestar Queues event stream.

EventStreamState

export interface EventStreamState<TFrame>
Property Type Default Description
healthy boolean — —
lastEvent TFrame | null — —
lastGap StreamGap | null — —
events TFrame[] — —

ReactEventStreamOptions

export type ReactEventStreamOptions<TFrame> = EventStreamOptions<TFrame> & {

ReactQueueEventStreamOptions

export type ReactQueueEventStreamOptions<TFrame> = QueueEventStreamOptions<TFrame> & {

AdapterOptions

export type AdapterOptions<TFrame> = ReactEventStreamOptions<TFrame> | ReactQueueEventStreamOptions<TFrame>

StreamFactory

export type StreamFactory = (options: never) => EventStream

useEventStream

export function useEventStream<TFrame = unknown>(options: ReactEventStreamOptions<TFrame>): EventStreamState<TFrame>

Subscribe a React component to a generic event stream.

useQueueEventStream

export function useQueueEventStream<TFrame = unknown>(options: ReactQueueEventStreamOptions<TFrame>): EventStreamState<TFrame>

Subscribe a React component to a Litestar Queues event stream.

litestar-vite-plugin/vue

Package Subpath: ./vue · Types: ./dist/js/vue/index.d.ts · Source: src/js/src/vue/index.ts

Vue bindings for generic and Litestar Queues event streams.

Export Kind Description
VueEventStreamState interface Exported interface from src/js/src/vue/index.ts.
VueEventStreamOptions type Exported type from src/js/src/vue/index.ts.
VueQueueEventStreamOptions type Exported type from src/js/src/vue/index.ts.
AdapterOptions type Exported type from src/js/src/vue/index.ts.
StreamFactory type Exported type from src/js/src/vue/index.ts.
useEventStream function Subscribe a Vue scope to a generic event stream.
useQueueEventStream function Subscribe a Vue scope to a Litestar Queues event stream.

VueEventStreamState

export interface VueEventStreamState<TFrame>
Property Type Default Description
healthy Ref<boolean> — —
lastEvent ShallowRef<TFrame | null> — —
lastGap ShallowRef<StreamGap | null> — —
events ShallowRef<TFrame[]> — —

VueEventStreamOptions

export type VueEventStreamOptions<TFrame> = EventStreamOptions<TFrame> & {

VueQueueEventStreamOptions

export type VueQueueEventStreamOptions<TFrame> = QueueEventStreamOptions<TFrame> & {

AdapterOptions

export type AdapterOptions<TFrame> = VueEventStreamOptions<TFrame> | VueQueueEventStreamOptions<TFrame>

StreamFactory

export type StreamFactory = (options: never) => EventStream

useEventStream

export function useEventStream<TFrame = unknown>(options: VueEventStreamOptions<TFrame>): VueEventStreamState<TFrame>

Subscribe a Vue scope to a generic event stream.

useQueueEventStream

export function useQueueEventStream<TFrame = unknown>(options: VueQueueEventStreamOptions<TFrame>): VueEventStreamState<TFrame>

Subscribe a Vue scope to a Litestar Queues event stream.

litestar-vite-plugin/svelte

Package Subpath: ./svelte · Types: ./dist/js/svelte/index.d.ts · Source: src/js/src/svelte/index.ts

Svelte stores for generic and Litestar Queues event streams.

Export Kind Description
EventStreamStoreState interface Exported interface from src/js/src/svelte/index.ts.
SvelteEventStreamOptions type Exported type from src/js/src/svelte/index.ts.
SvelteQueueEventStreamOptions type Exported type from src/js/src/svelte/index.ts.
AdapterOptions type Exported type from src/js/src/svelte/index.ts.
StreamFactory type Exported type from src/js/src/svelte/index.ts.
createEventStreamStore function Create a readable store backed by a generic event stream.
createQueueEventStreamStore function Create a readable store backed by a Litestar Queues event stream.

EventStreamStoreState

export interface EventStreamStoreState<TFrame>
Property Type Default Description
healthy boolean — —
lastEvent TFrame | null — —
lastGap StreamGap | null — —
events TFrame[] — —

SvelteEventStreamOptions

export type SvelteEventStreamOptions<TFrame> = EventStreamOptions<TFrame> & { bufferSize?: number }

SvelteQueueEventStreamOptions

export type SvelteQueueEventStreamOptions<TFrame> = QueueEventStreamOptions<TFrame> & { bufferSize?: number }

AdapterOptions

export type AdapterOptions<TFrame> = SvelteEventStreamOptions<TFrame> | SvelteQueueEventStreamOptions<TFrame>

StreamFactory

export type StreamFactory = (options: never) => EventStream

createEventStreamStore

export function createEventStreamStore<TFrame = unknown>(options: SvelteEventStreamOptions<TFrame>): Readable<EventStreamStoreState<TFrame>>

Create a readable store backed by a generic event stream.

createQueueEventStreamStore

export function createQueueEventStreamStore<TFrame = unknown>(options: SvelteQueueEventStreamOptions<TFrame>): Readable<EventStreamStoreState<TFrame>>

Create a readable store backed by a Litestar Queues event stream.

litestar-vite-plugin/astro

Package Subpath: ./astro · Types: ./dist/js/astro.d.ts · Source: src/js/src/astro.ts

Astro 5 integration for Litestar-Vite.

Export Kind Description
AstroConfigPartial interface Astro config for updateConfig - partial types we support.
AddressInfo interface AddressInfo from Node.js net module.
AstroIntegration interface Exported interface from src/js/src/astro.ts.
AstroIntegrationLogger interface Astro integration logger interface.
AstroTypesConfig type Configuration for TypeScript type generation. Same fields as TypesConfig.
LitestarAstroConfig type Configuration options for the Litestar integration.
litestarAstro default function Litestar integration for Astro.

AstroConfigPartial

export interface AstroConfigPartial

Astro config for updateConfig - partial types we support.

Property Type Default Description
server? object — —
vite? object — —

AddressInfo

export interface AddressInfo

AddressInfo from Node.js net module.

Property Type Default Description
address string — —
family string — —
port number — —

AstroIntegration

export interface AstroIntegration
Property Type Default Description
name string — —
hooks object — —

AstroIntegrationLogger

export interface AstroIntegrationLogger

Astro integration logger interface.

Property Type Default Description
info (message: string) => void — —
warn (message: string) => void — —
error (message: string) => void — —

AstroTypesConfig

export type AstroTypesConfig = TypesConfigShape

Configuration for TypeScript type generation. Same fields as TypesConfig.

LitestarAstroConfig

export type LitestarAstroConfig = LitestarIntegrationConfig

Configuration options for the Litestar integration.

Property Type Default Description
apiProxy? string — —
apiPrefix? string — —
types? boolean | "auto" | TypesConfigShape — —
verbose? boolean — —
executor? IntegrationExecutor — —

litestarAstro

export default function litestarAstro(userConfig: LitestarAstroConfig = {}): AstroIntegration

Litestar integration for Astro.

litestar-vite-plugin/sveltekit

Package Subpath: ./sveltekit · Types: ./dist/js/sveltekit.d.ts · Source: src/js/src/sveltekit.ts

SvelteKit integration for Litestar-Vite.

Export Kind Description
SvelteKitTypesConfig type Configuration for TypeScript type generation. Same fields as TypesConfig.
LitestarSvelteKitConfig type Configuration options for the Litestar integration.
litestarSvelteKit function Litestar integration plugin for SvelteKit.

SvelteKitTypesConfig

export type SvelteKitTypesConfig = TypesConfigShape

Configuration for TypeScript type generation. Same fields as TypesConfig.

LitestarSvelteKitConfig

export type LitestarSvelteKitConfig = LitestarIntegrationConfig

Configuration options for the Litestar integration.

Property Type Default Description
apiProxy? string — —
apiPrefix? string — —
types? boolean | "auto" | TypesConfigShape — —
verbose? boolean — —
executor? IntegrationExecutor — —

litestarSvelteKit

export function litestarSvelteKit(userConfig: LitestarSvelteKitConfig = {}): any[]

Litestar integration plugin for SvelteKit.

litestar-vite-plugin/nuxt

Package Subpath: ./nuxt · Types: ./dist/js/nuxt.d.ts · Source: src/js/src/nuxt.ts

Nuxt 4 module for Litestar-Vite.

Export Kind Description
NuxtModuleFunction interface Nuxt module definition for Litestar integration.
ListenInfo interface Exported interface from src/js/src/nuxt.ts.
NuxtContext interface Exported interface from src/js/src/nuxt.ts.
NuxtTypesConfig type Configuration for TypeScript type generation. Same fields as TypesConfig.
LitestarNuxtConfig type Configuration options for the Litestar integration.
litestarModule const Exported const from src/js/src/nuxt.ts.

NuxtModuleFunction

export interface NuxtModuleFunction

Nuxt module definition for Litestar integration.

Property Type Default Description
meta? object — —
getOptions? () => LitestarNuxtConfig — —

ListenInfo

export interface ListenInfo
Property Type Default Description
url? string — —
address? object — —
host? string — —
port? number — —

NuxtContext

export interface NuxtContext
Property Type Default Description
options object — —
hook? (name: string, fn: (...args: unknown[]) => void | Promise<void>) => void — —

NuxtTypesConfig

export type NuxtTypesConfig = TypesConfigShape

Configuration for TypeScript type generation. Same fields as TypesConfig.

LitestarNuxtConfig

export type LitestarNuxtConfig = LitestarIntegrationConfig

Configuration options for the Litestar integration.

Property Type Default Description
apiProxy? string — —
apiPrefix? string — —
types? boolean | "auto" | TypesConfigShape — —
verbose? boolean — —
executor? IntegrationExecutor — —

litestarModule

export const litestarModule: NuxtModuleFunction