DavstackService is simple and flexible library for building backend services with TypeScript.

DavstackAction is simple and flexible library for building backend services with TypeScript.

- 🏠 Simple and familiar syntax - middleware, input and outputs inspired by trpc procedures

- 🧩 Flexible - Works well with next js server actions as well as trpc

npm install zod @davstack/service

Visit the[DavStackService Docs](https://davstack.com/service/overview) for more information and examples, such as this[trpc usage example](https://davstack.com/service/trpc-usage-example).

Visit the[DavStackAction Docs](https://davstack.com/service/overview) for more information and examples, such as this[trpc usage example](https://davstack.com/service/trpc-usage-example).

- The service definition replaces tRPC procedures, but the syntax is very similar.

- Once the service is integrated into tRPC routers, the API is the same as any other tRPC router.

exportconst generatePdf=authedAction

.input(z.object({ html:z.string() }))

.query(async ({ctx,input })=> {

returnpdf;

});

const pdf=awaitgeneratePdf({ html:'...' });

const pdf=awaitgeneratePdf.raw(ctx, { html:'...' });

import {authedService,publicService }from'@/lib/service';

import {authedAction,publicAction }from'@/lib/service';

exportconst mailAiGeneratedInvoice=authedService

exportconst mailAiGeneratedInvoice=authedAction

.input(z.object({ to:z.string(), projectId:z.string() }))

.query(async ({ctx,input })=> {

awaitcheckSufficientCredits(ctx, { amount:10 });

return'Invoice sent';

});

exportconst generatePdf=authedService

exportconst generatePdf=authedAction

.input(z.object({ html:z.string() }))

.query(async ({ctx,input })=> {

returnpdf;

});

exportconst sendEmail=authedService

exportconst sendEmail=authedAction

.input(z.object({ to:z.string(), subject:z.string(), body:z.string() }))

.query(async ({ctx,input })=> {

return'Email sent';

});

exportconst checkSufficientCredits=authedService

exportconst checkSufficientCredits=authedAction

.input(z.object({ amount:z.number() }))

.query(async ({ctx,input })=> {

exporttypeAuthedServiceCtx=Required<PublicServiceCtx>;

exportconstpublicService=service<PublicServiceCtx>();

exportconstpublicAction=service<PublicServiceCtx>();

exportconstauthedService=service<AuthedServiceCtx>().use(

exportconstauthedAction=service<AuthedServiceCtx>().use(

async ({ctx,next })=> {

if (!ctx.user) {

import {publicService,authedService }from'@/lib/service';

import {publicAction,authedAction }from'@/lib/service';

exportconst getSomePublicData=publicService.query(async ({ctx })=> {

exportconst getSomePublicData=publicAction.query(async ({ctx })=> {

return'Public data';

});

exportconst getSomeUserData=authedService.query(async ({ctx })=> {

exportconst getSomeUserData=authedAction.query(async ({ctx })=> {

return'Protected data';

});

});

Unlike tRPC procedures, services can be called directly from anywhere in your backend, including within other services.

Davstack Store has been heavily inspired by[tRPC](https://trpc.io/), a fantastic library for building type-safe APIs. A big shout-out to the tRPC team for their amazing work.

Nick-Lucas, a tRPC contributor, inspired the creation of DavstackService with his[github comment](https://github.com/trpc/trpc/discussions/4839#discussioncomment-8224476). He suggested "making controllers minimal" and "to separate your business logic from the API logic", which is exactly what DavstackService aims to do.

Nick-Lucas, a tRPC contributor, inspired the creation of DavstackAction with his[github comment](https://github.com/trpc/trpc/discussions/4839#discussioncomment-8224476). He suggested "making controllers minimal" and "to separate your business logic from the API logic", which is exactly what DavstackAction aims to do.