@trpc/react NPM | npm.io

9.27.4 • Published 2 years ago

Install

Weekly downloads

1,102

License

MIT

Repository

Last release

2 years ago

Motivation

This library is undergoing rapid development and should be considered experimental. 🤙

tRPC is a framework for building strongly typed RPC APIs with TypeScript. Alternatively, you can think of it as a way to avoid APIs altogether.

Usage

:construction: Under construction, for now see ./examples

Data transformers

You are able to serialize the output data & input args (in order to be able to transparently use e.g. standard Dates). The transformers need to be added both to the server and the client.

Data transformers currently live on the edges - in client-specific implementation & in the API response adapters. See a reference of how superjson is attached to ..

createNextApiHandler() in ./examples/next-ssg-chat/[...trpc.ts], and
createReactQueryHooks in ./examples/next-ssg-chat/pages/_app.tsx

Internals

HTTP Methods <-> endpoint type mapping

HTTP Method	Mapping	Notes
`GET`	`.queries()`	Args in query string
`POST`	`.mutations()`	Args in post body
`PATCH`	`.subscriptions()`	Experimental API using long-pulling. Implementation details are likely to change.

Development

yarn install

This will install all dependencies in each project, build them, and symlink them via Lerna

Development workflow

git clone git@github.com:@trpc/trpc.git
cd trpc
yarn

In one terminal, run tsdx watch in parallel:

yarn dev

This builds each package to <packages>/<package>/dist and runs the project in watch mode so any edits you save inside <packages>/<package>/src cause a rebuild to <packages>/<package>/dist. The results will stream to to the terminal.

Using the examples/playground

You can play with local examples:

yarn playground - runs examples/playground
cd examples next-ssg-chat && yarn dev

Running Cypress

(todo)

(In a third terminal) you can run Cypress and it will run your integration tests against the playground/example. If you want to keep integration tests and examples seperate you can copy the example folder to another folder called like app or whatever. Cypress will look for localhost:1234 by default. If you change ports, also make sure to update .github/integration.yaml as well.

ikura @everything-registry/sub-chunk-935 @apeiromont/opshop-server eddev @zalastax/nolb-_trp next-trpc planetsheet @heytellus/widget @interval/server @buchungnl/trpc @dodas/api-client-react @teditor/frontend

10.0.0-alpha-issues-2915-2022-10-05-15-55-22.4

2 years ago

10.0.0-alpha-issues-2915-2022-10-05-15-52-16.3

2 years ago

10.0.0-alpha-refactor-root-config-2022-10-08-01-50-12.37

2 years ago

10.0.0-alpha-refactor-root-config-2022-10-08-02-13-50.38

2 years ago

2 years ago

10.0.0-proxy-beta.20

2 years ago

10.0.0-proxy-beta.19

2 years ago

10.0.0-proxy-beta.18

2 years ago

10.0.0-proxy-beta.17

2 years ago

10.0.0-proxy-beta.16

2 years ago

10.0.0-proxy-beta.15

2 years ago

10.0.0-proxy-beta.14

2 years ago

10.0.0-proxy-beta.13

2 years ago

10.0.0-proxy-beta.12

2 years ago

10.0.0-proxy-beta.11

2 years ago

2 years ago

10.0.0-alpha-refactor-root-config-2022-10-04-00-34-34.22

2 years ago

10.0.0-proxy-alpha.62

2 years ago

10.0.0-proxy-alpha.61

2 years ago

10.0.0-proxy-alpha.64

2 years ago

10.0.0-proxy-alpha.63

2 years ago

10.0.0-proxy-alpha.60

2 years ago

10.0.0-proxy-alpha.69

2 years ago

10.0.0-proxy-alpha.66

2 years ago

10.0.0-proxy-alpha.65

2 years ago

10.0.0-proxy-alpha.68

2 years ago

10.0.0-proxy-alpha.67

2 years ago

10.0.0-proxy-alpha.53

2 years ago

10.0.0-proxy-alpha.59

2 years ago

10.0.0-proxy-alpha.58

2 years ago

10.0.0-proxy-alpha.55

2 years ago

10.0.0-proxy-alpha.54

2 years ago

10.0.0-proxy-alpha.57

2 years ago

10.0.0-proxy-alpha.56

2 years ago

10.0.0-proxy-alpha.80

2 years ago

10.0.0-proxy-alpha.81

2 years ago

10.0.0-proxy-alpha.73

2 years ago

10.0.0-proxy-alpha.72

2 years ago

10.0.0-proxy-alpha.75

2 years ago

10.0.0-proxy-alpha.74

2 years ago

10.0.0-proxy-alpha.71

2 years ago

10.0.0-proxy-alpha.70

2 years ago

10.0.0-proxy-alpha.77

2 years ago

10.0.0-proxy-alpha.76

2 years ago

10.0.0-proxy-alpha.79

2 years ago

10.0.0-proxy-alpha.78

2 years ago

10.0.0-alpha-katt-more-play-2022-09-04-20-05-14.6

2 years ago

10.0.0-alpha-katt-more-play-2022-09-04-19-42-36.2

2 years ago

10.0.0-alpha-katt-fix-deps-2022-09-24-16-52-17.4

2 years ago

2 years ago

10.0.0-proxy-beta.8

2 years ago

10.0.0-proxy-beta.7

2 years ago

10.0.0-proxy-beta.6

2 years ago

10.0.0-proxy-beta.5

2 years ago

10.0.0-proxy-beta.9

2 years ago

10.0.0-proxy-beta.0

2 years ago

10.0.0-proxy-beta.4

2 years ago

10.0.0-proxy-beta.3

2 years ago

10.0.0-proxy-beta.2

2 years ago

10.0.0-proxy-beta.1

2 years ago

10.0.0-proxy-beta.10

2 years ago

10.0.0-alpha-katt-more-play-2022-09-04-19-29-39.1

2 years ago

10.0.0-alpha.49

2 years ago

10.0.0-alpha.48

2 years ago

10.0.0-alpha.52

2 years ago

10.0.0-alpha.51

2 years ago

10.0.0-alpha.50

2 years ago

2 years ago

10.0.0-katt-fix-error-inference-2022-08-10-15-04-30.0

2 years ago

10.0.0-alpha.27

2 years ago

10.0.0-alpha.26

2 years ago

10.0.0-alpha.41

2 years ago

10.0.0-alpha.40

2 years ago

10.0.0-alpha.45

2 years ago

10.0.0-alpha.44

2 years ago

10.0.0-alpha.43

2 years ago

10.0.0-alpha.42

2 years ago

10.0.0-alpha.47

2 years ago

10.0.0-alpha.46

2 years ago

10.0.0-alpha.39

2 years ago

10.0.0-alpha.30

2 years ago

10.0.0-alpha.34

2 years ago

10.0.0-alpha.33

2 years ago

10.0.0-alpha.32

2 years ago

10.0.0-alpha.31

2 years ago

10.0.0-alpha.38

2 years ago

10.0.0-alpha.37

2 years ago

10.0.0-alpha.36

2 years ago

10.0.0-alpha.35

2 years ago

10.0.0-alpha.29

2 years ago

10.0.0-alpha.28

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

10.0.0-alpha.23

2 years ago

10.0.0-alpha.25

2 years ago

10.0.0-alpha.24

2 years ago

2 years ago

2 years ago

9.23.5-lambda-support-2022-05-22-18-18-13.17

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

10.0.0-alpha.22

2 years ago

2 years ago

2 years ago

2 years ago

10.0.0-alpha.21

2 years ago

2 years ago

2 years ago

10.0.0-alpha.20

2 years ago

2 years ago

10.0.0-alpha.19

2 years ago

10.0.0-alpha.18

2 years ago

10.0.0-alpha.17

2 years ago

10.0.0-alpha.12

2 years ago

10.0.0-alpha.11

2 years ago

10.0.0-alpha.16

2 years ago

10.0.0-alpha.15

2 years ago

10.0.0-alpha.14

2 years ago

10.0.0-alpha.13

2 years ago

2 years ago

2 years ago

9.20.2-katt-ssr-status-error-2022-03-17-12-00-52.61

2 years ago

9.20.2-katt-ssr-status-error-2022-03-17-02-32-38.59

2 years ago

9.20.2-fix-ssr-2022-03-15-19-08-54.47

2 years ago

9.20.2-katt-ssr-status-error-2022-03-17-12-22-39.63

2 years ago

9.20.2-katt-ssr-status-error-2022-03-17-18-30-58.76

2 years ago

10.0.0-alpha.10

2 years ago

2 years ago

9.17.1-katt-fix-headers-2022-01-25-07-38-27.35

2 years ago

9.17.1-katt-suspense-fix-2022-01-24-08-53-49.38

2 years ago

2 years ago

9.16.1-katt-issue-1393-2022-01-13-22-47-53.43

2 years ago

9.17.1-katt-suspense-fix-2022-01-24-09-30-09.42

2 years ago

2 years ago

9.17.1-katt-suspense-fix-2022-01-24-08-15-24.35

2 years ago

2 years ago

2 years ago

2 years ago

9.17.1-katt-suspense-fix-2022-01-24-10-05-13.49

2 years ago

9.17.1-katt-suspense-fix-2022-01-24-08-20-22.36

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

9.12.3-katt-createQueryHooks-perf-2021-11-10-17-58-13.26

2 years ago

9.15.1-remove-cache-keys-2021-11-26-14-35-08.12

2 years ago

2 years ago

2 years ago

2 years ago

9.15.1-isMutating-2021-11-24-15-49-19.0

2 years ago

9.15.1-isMutating-2021-11-24-15-53-24.1

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

9.12.3-katt-createQueryHooks-perf-2021-11-05-15-28-30.13

3 years ago

9.12.3-katt-createQueryHooks-perf-2021-11-05-16-15-07.14

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

9.10.1-katt-play-no-multi-entry-2021-10-16-14-46-17.1

3 years ago

9.10.1-katt-esm-2021-10-16-23-46-48.11

3 years ago

9.8.1-katt-issue-1020-pin-2021-10-19-16-33-31.2

3 years ago

3 years ago

3 years ago

9.9.2-katt-nuxt-2021-10-16-23-07-50.74

3 years ago

9.10.1-katt-esm-2021-10-16-22-54-13.8

3 years ago

9.10.1-katt-play-no-multi-entry-2021-10-16-15-37-22.2

3 years ago

9.9.2-katt-nuxt-2021-10-16-23-46-48.75

3 years ago

9.10.1-katt-esm-2021-10-16-23-04-40.10

3 years ago

9.10.1-katt-esm-2021-10-16-22-07-08.6

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

9.9.1-katt-bfg-2021-10-05-10-37-19.20

3 years ago

9.8.1-katt-refactor-qu-2021-10-03-21-27-12.52

3 years ago

9.8.1-katt-refactor-qu-2021-10-03-18-36-56.44

3 years ago

9.8.1-katt-issue-1020-pin-2021-09-27-12-36-16.6

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

9.6.1-npmreadme-2021-09-13-00-47-28.19

3 years ago

3 years ago

3 years ago

9.1.1-feature-declarationMap-2021-09-08-11-03-58.2

3 years ago

3 years ago

3 years ago

3 years ago

9.1.1-es2020-2021-09-03-20-55-52.3

3 years ago

3 years ago

9.1.1-feature-declarationMap-2021-09-03-20-18-01.0

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago