Skip to content

A composables Vue 3 library for using a tRPC.io client.

License

Notifications You must be signed in to change notification settings

michealroberts/usetrpc

Repository files navigation

useTRPC

A composables Vue 3 library for using a tRPC.io client, bringing end-to-end typesafe APIs to Vue 3.

Please reference the tRPC documenation (https://trpc.io/docs/)[https://trpc.io/docs/] before using this library.

N.B. This library is a work in progress and is not yet ready for usage in production.

Installation

npm install @trpc/vue

or

yarn(pnpm) add @trpc/vue

Then, you can simply import what you need:

import { useTRPCClient, useTRPCQuery, useTRPCMutation } from '@trpc/vue'

Usage

Define AppRouter

Be sure to define a tRPC router of type AppRputer, e.g.:

import * as trpc from '@trpc/server';

export const appRouter = trpc
  .router<Context>()
  .query('all', {
    resolve({ ctx }) {
      return {
        greeting: `world`,
      };
    },
  });
  
export type AppRouter = typeof appRouter

Please see https://trpc.io/docs/router for further explanation of defining the router and the AppRouter type.

Instantiating a tRPC client:

import { useTRPCClient } from '@trpc/vue'

// import your router, e.g.:
import type { AppRouter } from './server/router'

const { client } = useTRPCClient<AppRouter>({
  url: 'http://localhost:3000/trpc'
})

Making a tRPC Query

import { TRPCClient } from '@trpc/client'

import type { AppRouter } from '@observerly/pleiades'

import { useTRPCQuery } from '@trpc/vue'

export const useTelescopes = (client: TRPCClient<AppRouter>) => {
  const telescopes = useTRPCQuery(client, ['telescopes.all'])

  return {
    telescopes
  }
}

To-Do

  • Publish as npm public package
  • Add useClient() composable
  • Add comprehensive usage tests for useClient()
  • Add useQuery() composable
  • Improve type inference for useQuery()
  • Add comprehensive usage tests for useQuery()
  • Add useMutation()
  • Add comprehensive usage tests for useMutation()
  • Add useSubscription()
  • Add comprehensive usage tests for useSubscription()
  • Add usage documentation and demo examples.

About

A composables Vue 3 library for using a tRPC.io client.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published