Skip to main content

@tairu/handler

Tairu handler, handling HTTP requests to serve tiles.

Installation​

npm install @tairu/handler

Classes​

Tairu​

Extends​

Constructors​

new Tairu()​

new Tairu(options): Tairu

Parameters​

• options: TairuOptions = {}

Returns​

Tairu

Overrides​

BaseTairu<ValidTileInput>.constructor

Accessors​

app​

get app(): App

Returns​

App

Inherited from​

BaseTairu.app

Defined in​
handler​

get handler(): TairuHandler

Returns​

TairuHandler

Inherited from​

BaseTairu.handler

Defined in​
nodeListener​

get nodeListener(): NodeListener

Returns​

NodeListener

Inherited from​

BaseTairu.nodeListener

Defined in​
plainHandler​

get plainHandler(): PlainHandler

Returns​

PlainHandler

Inherited from​

BaseTairu.plainHandler

Defined in​
urlPrefix​

get urlPrefix(): string

Returns​

string

Inherited from​

BaseTairu.urlPrefix

Defined in​

Methods​

addHandler()​

addHandler<PathParams, SearchParams>(path, handler): void

Type Parameters​

• PathParams extends ParamsRecord = ParamsRecord

• SearchParams extends ParamsRecord = ParamsRecord

Parameters​

• path: string

• handler: TileHandler<PathParams, SearchParams, ValidTileInput, H3EventContext>

Returns​

void

Inherited from​

BaseTairu.addHandler

executeHandler()​

executeHandler<PathParams, SearchParams>(handler, event): Promise<ValidTileInput>

Type Parameters​

• PathParams extends ParamsRecord = ParamsRecord

• SearchParams extends ParamsRecord = ParamsRecord

Parameters​

• handler: TileHandler<PathParams, SearchParams, ValidTileInput, H3EventContext>

• event: TairuEvent

Returns​

Promise<ValidTileInput>

Inherited from​

BaseTairu.executeHandler

parseHandlerResult()​

parseHandlerResult(result): object

Parameters​

• result: ValidTileInput

Returns​

object

props​

readonly props: object

props.actions?​

readonly optional props.actions: (object | object | object)[]

props.children?​

readonly optional props.children: object & object | object & object[]

props.description?​

readonly optional props.description: string

props.input?​

readonly optional props.input: object | object

props.key?​

readonly optional props.key: string

props.style?​

readonly optional props.style: object

props.style.alignItems?​

optional props.style.alignItems: "flex-start" | "center" | "flex-end"

props.style.alignSelf?​

optional props.style.alignSelf: "flex-start" | "center" | "flex-end" | "auto"

props.style.backgroundClip?​

optional props.style.backgroundClip: "border-box" | "text"

props.style.backgroundColor?​

optional props.style.backgroundColor: string

props.style.backgroundImage?​

optional props.style.backgroundImage: string

props.style.backgroundPosition?​

optional props.style.backgroundPosition: string

props.style.backgroundRepeat?​

optional props.style.backgroundRepeat: "repeat" | "repeat-x" | "repeat-y" | "no-repeat"

props.style.backgroundSize?​

optional props.style.backgroundSize: string

props.style.borderBottomColor?​

optional props.style.borderBottomColor: string

props.style.borderBottomLeftRadius?​

optional props.style.borderBottomLeftRadius: number

props.style.borderBottomRightRadius?​

optional props.style.borderBottomRightRadius: number

props.style.borderBottomStyle?​

optional props.style.borderBottomStyle: "solid" | "dashed"

props.style.borderBottomWidth?​

optional props.style.borderBottomWidth: number

props.style.borderColor?​

optional props.style.borderColor: string

props.style.borderLeftColor?​

optional props.style.borderLeftColor: string

props.style.borderLeftStyle?​

optional props.style.borderLeftStyle: "solid" | "dashed"

props.style.borderLeftWidth?​

optional props.style.borderLeftWidth: number

props.style.borderRadius?​

optional props.style.borderRadius: number

props.style.borderRightColor?​

optional props.style.borderRightColor: string

props.style.borderRightStyle?​

optional props.style.borderRightStyle: "solid" | "dashed"

props.style.borderRightWidth?​

optional props.style.borderRightWidth: number

props.style.borderStyle?​

optional props.style.borderStyle: "solid" | "dashed"

props.style.borderTopColor?​

optional props.style.borderTopColor: string

props.style.borderTopLeftRadius?​

optional props.style.borderTopLeftRadius: number

props.style.borderTopRightRadius?​

optional props.style.borderTopRightRadius: number

props.style.borderTopStyle?​

optional props.style.borderTopStyle: "solid" | "dashed"

props.style.borderTopWidth?​

optional props.style.borderTopWidth: number

props.style.borderWidth?​

optional props.style.borderWidth: number

props.style.bottom?​

optional props.style.bottom: number

props.style.boxShadow?​

optional props.style.boxShadow: string

props.style.display?​

optional props.style.display: "flex" | "none"

props.style.flexBasis?​

optional props.style.flexBasis: number

props.style.flexDirection?​

optional props.style.flexDirection: "row" | "row-reverse" | "column" | "column-reverse"

props.style.flexGrow?​

optional props.style.flexGrow: number

props.style.flexShrink?​

optional props.style.flexShrink: number

props.style.flexWrap?​

optional props.style.flexWrap: "nowrap" | "wrap" | "wrap-reverse"

props.style.gap?​

optional props.style.gap: number

props.style.height?​

optional props.style.height: number

props.style.justifyContent?​

optional props.style.justifyContent: "flex-start" | "center" | "flex-end" | "space-between" | "space-around"

props.style.left?​

optional props.style.left: number

props.style.margin?​

optional props.style.margin: number

props.style.marginBottom?​

optional props.style.marginBottom: number

props.style.marginLeft?​

optional props.style.marginLeft: number

props.style.marginRight?​

optional props.style.marginRight: number

props.style.marginTop?​

optional props.style.marginTop: number

props.style.maxHeight?​

optional props.style.maxHeight: number

props.style.maxWidth?​

optional props.style.maxWidth: number

props.style.minHeight?​

optional props.style.minHeight: number

props.style.minWidth?​

optional props.style.minWidth: number

props.style.objectFit?​

optional props.style.objectFit: "none" | "contain" | "cover"

props.style.opacity?​

optional props.style.opacity: number

props.style.overflow?​

optional props.style.overflow: "visible" | "hidden"

props.style.padding?​

optional props.style.padding: number

props.style.paddingBottom?​

optional props.style.paddingBottom: number

props.style.paddingLeft?​

optional props.style.paddingLeft: number

props.style.paddingRight?​

optional props.style.paddingRight: number

props.style.paddingTop?​

optional props.style.paddingTop: number

props.style.position?​

optional props.style.position: "relative" | "absolute"

props.style.right?​

optional props.style.right: number

props.style.top?​

optional props.style.top: number

props.style.width?​

optional props.style.width: number

props.title​

readonly props.title: string

type​

readonly type: "Tile"

version​

readonly version: "0.1"

Overrides​

BaseTairu.parseHandlerResult

render()​

render(event, tile): Promise<Response>

Parameters​

• event: TairuEvent

• tile

• tile.props

• tile.props.actions?: (object | object | object)[]

• tile.props.children?: object & object | object & object[]

• tile.props.description?: string

• tile.props.input?: object | object

• tile.props.key?: string

• tile.props.style?

• tile.props.style.alignItems?: "flex-start" | "center" | "flex-end"

• tile.props.style.alignSelf?: "flex-start" | "center" | "flex-end" | "auto"

• tile.props.style.backgroundClip?: "border-box" | "text"

• tile.props.style.backgroundColor?: string

• tile.props.style.backgroundImage?: string

• tile.props.style.backgroundPosition?: string

• tile.props.style.backgroundRepeat?: "repeat" | "repeat-x" | "repeat-y" | "no-repeat"

• tile.props.style.backgroundSize?: string

• tile.props.style.borderBottomColor?: string

• tile.props.style.borderBottomLeftRadius?: number

• tile.props.style.borderBottomRightRadius?: number

• tile.props.style.borderBottomStyle?: "solid" | "dashed"

• tile.props.style.borderBottomWidth?: number

• tile.props.style.borderColor?: string

• tile.props.style.borderLeftColor?: string

• tile.props.style.borderLeftStyle?: "solid" | "dashed"

• tile.props.style.borderLeftWidth?: number

• tile.props.style.borderRadius?: number

• tile.props.style.borderRightColor?: string

• tile.props.style.borderRightStyle?: "solid" | "dashed"

• tile.props.style.borderRightWidth?: number

• tile.props.style.borderStyle?: "solid" | "dashed"

• tile.props.style.borderTopColor?: string

• tile.props.style.borderTopLeftRadius?: number

• tile.props.style.borderTopRightRadius?: number

• tile.props.style.borderTopStyle?: "solid" | "dashed"

• tile.props.style.borderTopWidth?: number

• tile.props.style.borderWidth?: number

• tile.props.style.bottom?: number

• tile.props.style.boxShadow?: string

• tile.props.style.display?: "flex" | "none"

• tile.props.style.flexBasis?: number

• tile.props.style.flexDirection?: "row" | "row-reverse" | "column" | "column-reverse"

• tile.props.style.flexGrow?: number

• tile.props.style.flexShrink?: number

• tile.props.style.flexWrap?: "nowrap" | "wrap" | "wrap-reverse"

• tile.props.style.gap?: number

• tile.props.style.height?: number

• tile.props.style.justifyContent?: "flex-start" | "center" | "flex-end" | "space-between" | "space-around"

• tile.props.style.left?: number

• tile.props.style.margin?: number

• tile.props.style.marginBottom?: number

• tile.props.style.marginLeft?: number

• tile.props.style.marginRight?: number

• tile.props.style.marginTop?: number

• tile.props.style.maxHeight?: number

• tile.props.style.maxWidth?: number

• tile.props.style.minHeight?: number

• tile.props.style.minWidth?: number

• tile.props.style.objectFit?: "none" | "contain" | "cover"

• tile.props.style.opacity?: number

• tile.props.style.overflow?: "visible" | "hidden"

• tile.props.style.padding?: number

• tile.props.style.paddingBottom?: number

• tile.props.style.paddingLeft?: number

• tile.props.style.paddingRight?: number

• tile.props.style.paddingTop?: number

• tile.props.style.position?: "relative" | "absolute"

• tile.props.style.right?: number

• tile.props.style.top?: number

• tile.props.style.width?: number

• tile.props.title: string

• tile.type: "Tile"

• tile.version: "0.1"

Returns​

Promise<Response>

Overrides​

BaseTairu.render

Type Aliases​

AnyTileHandler<Context>​

AnyTileHandler<Context>: TileHandler<any, any, Context>

Type Parameters​

• Context = TileRequestContext

BoxElement​

BoxElement: ReactElement<BoxProps, typeof Box>

BoxProps​

BoxProps: object

Type declaration​

children?​

optional children: ReactNode | BoxV0 | TextV0 | (BoxV0 | TextV0)[]

style?​

optional style: BoxStyleV0

ImageElement​

ImageElement: ReactElement<ImageProps, typeof Image>

ImageProps​

ImageProps: object

Type declaration​

alt​

alt: string

height​

height: number

src​

src: string

width​

width: number

NodeListener()​

NodeListener: (req, res) => void

Parameters​

• req: IncomingMessage

• res: ServerResponse

Returns​

void

OpenActionElement​

OpenActionElement: ReactElement<OpenActionProps, typeof OpenAction>

OpenActionProps​

OpenActionProps: object

Type declaration​

label​

label: string

uri​

uri: string

OptionElement​

OptionElement: ReactElement<OptionProps, typeof Option>

OptionProps​

OptionProps: InputOptionV0

OptionsInputElement​

OptionsInputElement: ReactElement<OptionsInputProps, typeof OptionsInput>

OptionsInputProps​

OptionsInputProps: object

Type declaration​

children​

children: OptionElement | OptionElement[]

multiple?​

optional multiple: boolean

ParamsRecord​

ParamsRecord: Record<string, string>

SignActionElement​

SignActionElement: ReactElement<SignActionProps, typeof SignAction>

SignActionProps​

SignActionProps: object

Type declaration​

label​

label: string

payload?​

optional payload: Record<string, unknown>

state?​

optional state: Record<string, unknown>

SubmitActionElement​

SubmitActionElement: ReactElement<SubmitActionProps, typeof SubmitAction>

SubmitActionProps​

SubmitActionProps: object

Type declaration​

label​

label: string

state?​

optional state: Record<string, unknown>

TairuHandler​

TairuHandler: EventHandler

TairuOptions​

TairuOptions: object

Type declaration​

runtimeScriptURL?​

optional runtimeScriptURL: string

urlPrefix?​

optional urlPrefix: string

TextElement​

TextElement: ReactElement<TextProps, typeof Text>

TextInputElement​

TextInputElement: ReactElement<TextInputProps, typeof TextInput>

TextInputProps​

TextInputProps: object

Type declaration​

defaultValue?​

optional defaultValue: string

label​

label: string

placeholder?​

optional placeholder: string

secure?​

optional secure: boolean

TextProps​

TextProps: object

Type declaration​

children​

children: ReactNode | TextV0 | TextV0[]

style?​

optional style: TextStyleV0

TileElement​

TileElement: ReactElement<TileProps, typeof Tile>

TileHandler<PathParams, SearchParams, Context>​

TileHandler<PathParams, SearchParams, Context>: BaseTileHandler<PathParams, SearchParams, ValidTileInput, Context>

Type Parameters​

• PathParams extends ParamsRecord = ParamsRecord

• SearchParams extends ParamsRecord = ParamsRecord

• Context = TileRequestContext

TileHandlers<Context>​

TileHandlers<Context>: AnyTileHandler<Context> | Record<string, AnyTileHandler<Context>>

Type Parameters​

• Context = TileRequestContext

TileProps​

TileProps: BoxProps & TileMetaV0 & object

Type declaration​

actions?​

optional actions: TileActionsProp

input?​

optional input: TileInputProp

TileRequest<PathParams, SearchParams, Context>​

TileRequest<PathParams, SearchParams, Context>: object

Type Parameters​

• PathParams extends ParamsRecord = ParamsRecord

• SearchParams extends ParamsRecord = ParamsRecord

• Context = TileRequestContext

Type declaration​

action​

action: VerifiedAction | null

context​

context: Context

pathParams​

pathParams: PathParams

searchParams​

searchParams: SearchParams

urlPrefix​

urlPrefix: string

TileRequestContext​

TileRequestContext: H3EventContext

Functions​

Box()​

Box(props): ReactElement<BoxProps, string | JSXElementConstructor>

Parameters​

• props: BoxProps

Returns​

ReactElement<BoxProps, string | JSXElementConstructor>

handle()​

handle<Handlers>(handlers, options?): TairuHandler

Type Parameters​

• Handlers extends TileHandlers<any>

Parameters​

• handlers: Handlers

• options?: TairuOptions

Returns​

TairuHandler

Image()​

Image(props): ReactElement<ImageProps, string | JSXElementConstructor>

Parameters​

• props: ImageProps

Returns​

ReactElement<ImageProps, string | JSXElementConstructor>

OpenAction()​

OpenAction(props): ReactElement<OpenActionProps, string | JSXElementConstructor>

Parameters​

• props: OpenActionProps

Returns​

ReactElement<OpenActionProps, string | JSXElementConstructor>

Option()​

Option(props): ReactElement<object, string | JSXElementConstructor>

Parameters​

• props

• props.label: string

• props.value: string | number | boolean

Returns​

ReactElement<object, string | JSXElementConstructor>

label​

label: string

value​

value: string | number | boolean

OptionsInput()​

OptionsInput(props): DOMElement

Parameters​

• props: OptionsInputProps

Returns​

DOMElement

SignAction()​

SignAction(props): ReactElement<SignActionProps, string | JSXElementConstructor>

Parameters​

• props: SignActionProps

Returns​

ReactElement<SignActionProps, string | JSXElementConstructor>

SubmitAction()​

SubmitAction(props): ReactElement<SubmitActionProps, string | JSXElementConstructor>

Parameters​

• props: SubmitActionProps

Returns​

ReactElement<SubmitActionProps, string | JSXElementConstructor>

tairu()​

tairu<Handlers>(handlers, options?): Tairu

Type Parameters​

• Handlers extends TileHandlers<H3EventContext>

Parameters​

• handlers: Handlers

• options?: TairuOptions

Returns​

Tairu

Text()​

Text(props): ReactElement<TextProps, string | JSXElementConstructor>

Parameters​

• props: TextProps

Returns​

ReactElement<TextProps, string | JSXElementConstructor>

TextInput()​

TextInput(props): ReactElement<TextInputProps, string | JSXElementConstructor>

Parameters​

• props: TextInputProps

Returns​

ReactElement<TextInputProps, string | JSXElementConstructor>

Tile()​

Tile(props): ReactElement<BoxProps & object & object, string | JSXElementConstructor>

Parameters​

• props: TileProps

Returns​

ReactElement<BoxProps & object & object, string | JSXElementConstructor>