Documents / @faasjs/dev

@faasjs/dev

@faasjs/dev

FaasJS development toolkit for local servers, generated route types, and test helpers.

License: MIT NPM Version

Install

npm install -D @faasjs/dev

Features

  • viteFaasJsServer() runs a FaasJS server inside Vite during local development.
  • ViteConfig bundles the standard FaasJS React and Vite Plus defaults.
  • OxfmtConfig and OxlintConfig expose the shared FaasJS formatting and lint rules.
  • generateFaasTypes() emits route declarations for @faasjs/types.
  • testApi() and ApiTester help invoke and assert FaasJS APIs in tests.

Usage: Shared Vite Preset

import { ViteConfig } from '@faasjs/dev'
import { defineConfig } from 'vite-plus'

export default defineConfig({
  ...ViteConfig,
})

Usage: Manual Vite Integration

import { viteFaasJsServer, OxfmtConfig, OxlintConfig } from '@faasjs/dev'
import react from '@vitejs/plugin-react'
import { defineConfig } from 'vite-plus'

export default defineConfig({
  plugins: [react(), viteFaasJsServer()],
  fmt: OxfmtConfig,
  lint: OxlintConfig,
})

Usage: Type Generation

import { generateFaasTypes } from '@faasjs/dev'

await generateFaasTypes()

Usage: Test Helpers

import { testApi } from '@faasjs/dev'
import api from '../demo.api'

const handler = testApi(api)
const response = await handler({ name: 'FaasJS' })

expect(response.statusCode).toBe(200)
expect(response.data).toEqual({ message: 'Hello, FaasJS' })

API

Functions

Classes

Interfaces

Type Aliases

Variables