Telefunc

Remote Functions.
Instead of API.

// CreateTodo.telefunc.ts
// Environment: Server

// Telefunc makes onNewTodo() remotely callable
// from the browser.
export { onNewTodo }

import { getContext } from 'telefunc'

// Telefunction arguments are automatically validated
// at runtime: `text` is guaranteed to be a string.
async function onNewTodo(text: string) {
  const { user } = getContext()

  // With an ORM
  await Todo.create({ text, authorId: user.id })

  // With SQL
  await sql(
    "INSERT INTO todo_items VALUES (:text, :authorId)",
    { text, authorId: user.id })
}

Server

// CreateTodo.tsx
// Environment: Browser

// CreateTodo.telefunc.ts isn't actually loaded: Tele-
// func transforms it into a thin HTTP client.
import { onNewTodo } from './CreateTodo.telefunc.ts'

async function onClick(form) {
  const text = form.input.value
  // Behind the scenes, Telefunc makes an HTTP request
  // to the server.
  await onNewTodo(text)
}

function CreateTodo() {
  return (
    <form>
      <input input="text"></input>
      <button onClick={onClick}>Add To-Do</button>
    </form>
  )
}

Browser

💫 Simple

With Telefunc, you get a simple frontend-backend relationship: it's just a set of remote functions.

Your frontend can directly use any SQL/ORM query to retrieve & mutate data.

Permissions

Telefunc enables programmatically defined permissions. It's both simple and flexible.

Telefunc introduces new techniques to define advanced permissions and increase safety.

🔌 Any Stack

Telefunc supports Next.js, CRA, Nuxt, Vite, vite-plugin-ssr, React Native and other frameworks based on Webpack, Babel, Parcel or Vite.

⚡ Performance

The frontend can directly tap into the full power of the server. Use tailored SQL/ORM queries for highly performant data retrieval and mutations.

TypeScript

Seamless TypeScript support out-of-the-box including all your favorite IDE features such as auto-import, replace-all-occurrences, etc.

Automatic runtime validation for end-to-end type safety.

💎 Rock-solid

The source code of Telefunc has no known bug (bugs are fixed swiftly) and every release is assailed against a heavy suite of automated tests.

Have a question? Want a feature? Found a bug? Join our Discord or open a GitHub ticket.