Build a RESTful API with Fastify, Prisma & TypeScript
Vložit
- čas přidán 26. 07. 2024
- Fastify is fast becoming the go-to web server technology for Node.js developers and Prisma is a staple ORM, used by more than 100,000 users. In this video, we will build a RESTful API with both Fastify & Prisma, along with Zod & TypeScript.
Repository: github.com/TomDoesTech/fastif...
0:00 Intro
2:35 Demo
5:47 Code walk-through
11:52 Bootstrap
17:51 Create user
20:35 Prisma setup
31:21 Hash and verify passwords
45:05 Login
55:10 List users
1:00:14 Product schemas
1:05:30 Product services
1:07:50 Product handlers
1:11:13 Product routes
1:17:48 Swagger docs
1:20:52 Outro
🌎 Follow me here:
Discord: / discord
Twitter: / tomdoes_tech
Facebook: / tomdoestech
Instagram: / tomdoestech
TikTok: / tomdoes_tech
☕ Buy me a coffee: www.buymeacoffee.com/tomn
I started following you few weeks ago and I can say that you have one of the best tutorials and video quality out there. I love the uniqueness and the way you approach things, I believe my nodejs skills will greatly advance by following your courses. Thank you once again.
Honestly one of the best tutorials I have ever seen. Starting from a more intermediate-advanced level. Understanding that the audience should know the difference between what is important for development vs production and explaining everything in a clear and consize way. You earned a new subscriber and helped me tremendously with setting up the API for the start-up I am working with.
I'm a frontend dev and I wanted to get my feet wet with some backend stuff and this video was exactly what I was looking for. Well prepared, decently fast-paced, and finally a tutorial for people who are not complete beginners. Fantastic job Tom, thank you very much!
Man, I’m just in love with your tutorials.
Keep on creating amazing content ❤️
I would love to see more fastify videos, this is the best one out there by far 🙌
Once again, Tom, you knock it out of the park. Sorry. Gratuitous baseball metaphor. Great video. I just spent a few weeks doing your mongo API video, shaking things up here and there, trying to explore more of the ecosystem. Great stuff. This one? Wow. Lots of time and thought went into this. THANKS!
This video has been so important to me and my journey. I've spent hours dissecting each part of it and expanding/adapting to my needs. I was able to build a bad arse API to power the front end app. I never seen a video as thorough as this!!!
Thank you so much! I'm glad it helped :)
Tom you did a wonderful job. I'm learning TypeScript now and this video made me realize the advantages of a superset language in regards to node development. Keep up the good work.
Glad it was helpful!
Fantastic video, Tom!! Other than a few things being slightly out of date (other users should check the pinned posts comments for details), I really enjoyed how you walked through this. I really like the way things are laid out with Fastify. It all rhymes with Express, but I needed something like this to really feel equipped building servers in the future.
Really great tutorial! The biggest thing I liked is the (rare) nicety of detailing which things are for demo purposes, AND THEN giving an idea of what you'd actually do in production. It really showcases just how much you know what you're talking about, and provides new users an alternative if they're building production applications. This is really great content and the time just flies by, thank you for producing such high quality content!
Thank you! That is very generous of you, my first CZcams donation.
Great! As I am a beginner with fastify and api's, this is a great tutorial! Comprehensive explanation and very satisfying results. Thanks a lot!
Glad it was helpful!
This is like poetry, amazing clarity - thank you Tom
Glad you enjoyed it!
This video is absolutely amazing! A hidden highly underrated gem...
You are GOAT! Please keep making such videos
I really like the approach you took.
Simple yet very informational because you are making almost everything from scratch except for the things you are explaining.
Glad it was helpful!
amazing video, learned a lot from this. keep up :)
I love this stack. Thank you for the video!
Thanks for watching!
Thank you very much. Please make another video about Fastify.
Nice stuff, thanks!
Thank you for this!
wow, this is great content! thank you.
Thank you for this tutorial
Great video! Thank you!
Glad you liked it!
Guys his Discord is gold!
wonderful tutorial thanks
Great video!! I’m the person who asked for it on Discord and finally had the time to watch it :)
One thing I noticed is, at 1:17:43 the Products don’t have the owner on them even though they are defined to do so in product.service. I fixed it by exporting userCore from user.schema, and adding `owner: z.object(userCore),` to productGenerated in product.schema.
The only thing I’m not sure of is, in terms of design is exporting userCore the way to go here or would you be better off creating something like a productOwnerSchema?
Same here.
Thanks for you solution, @MrKeepItTrill.
Though, I also want to know if this is the way to go...
I am following this tutorial using supabase's database. If anyone is doing the same make sure to add
shadowDatabaseUrl = env("DATABASE_URL") line inside the datasource db block in schema file to run the migration successfully.
at the time 1:09:22, where can you get the user? how can you assign user to the request before defining the module 'fastify-jwt'. I still don't understand how can you use request.user here on the line 12. Can you explain? Because request param has the type of FastifyRequest and it originally doesn't have user prop in it
Hi Tom, great tutorial! It helped me a lot. One thing I cannot figure out though is that why the automatic type inference doesn't work in the route files. In my opinion it should know the type of request.body based on the schema. Can you help me with this?
Hey thanks for the tutorial, its awesome, but can you please tell me why server.authenticate was not avaiable in the Fastify instance even though we created a decorator for it and why did declaring a module make it worK? Thanks in advance
I am seeing an issue while passing required accessToken from Swagger if possible please let me know how we can pass accessToken using swagger
Nice done vid good to see a fellow aussie
Curious would you of gone BigInt UTC for DateTime types so that the browser does not affect the timestamp?
For prisma migrations is there a good package to use for implementing a field that can't be null? (for example if the API for stripe changes and you want to now insert a nonnull field pulling the data from stripe) or is it just easiest doing it manually with SQL then testing it locally with prisma migrate to see that it works?
Yeah dates should be stored in UTC. I'm not sure about non-null
When I created zod schema, I customized some error messages for verification.
But when I tried to verify, the custom error message didn't work.
Same issue here
Wonderful video. Thank you for your time showing the power of this framework. Is it possible to use decorated to use different databases for each user? A multitenant app where each user has his own database. In Prisma, we can change the database URL string at runtime. Any thoughts on it.
That's not a good approach to multitenancy imo, in fact it's not even really multitenant at that point, it's part of your app having different deployments. A much easier way to do it is separate all your data with an organization_id or application_id.
Property 'jwtVerify' does not exist on type, why ya?
In case you want to group schemas in the docs, use "tags" key inside the routes. Just don't use multiple tags unless you want to duplicate the routes inside the docs.
Example:
schema: {
body: $ref('createUserSchema'),
response: {
201: $ref('createUserResponseSchema')
},
tags: ['User']
}
Fastify support validation of JSON data via ajv JSON validator. so where does Zod fit in which is also a JSON validator?
Zod isn't a validator, it parses the data. You can use ajv if you like, I just wanted to use Zod
@@TomDoesTech so what does it mean when a property in Json schema is set to required ?
For example, in your zod schema it says the email field is required, it should be a string and an email
Thank you for the awesome tutorial.
I am getting this runtime error when I run the tutorial.
FastifyError [Error]: Failed building the validation schema for POST: /product, due to error can't resolve reference Schema#/properties/createProductSchema from id # .
Not sure if the error is because I am using Mongodb or because of the wrong configuration. Going crazy trying to resolve it. Any help would be appreciated.
Need to make sure the schema id matches the registered schema
Thanks for the video but when I run the application after adding the product schema, I get an error : FastifyError: Schema with id 'Schema' already declared.
You need to give your schemas different names
@@TomDoesTech Thanks, I solved it
@@TomDoesTech Hi I'm having same problem as Gontran, what exactly do you mean by giving schemas different name ?
@@TomDoesTech I am having same issue, where should we differentiate the Schema name
@@danielklein2694 @Buddhika senevirathna I solved the problem by adding to BuildJsonSchemas the id of the schema : { $id: 'UserSchema' } and { $id: 'ProductSchema' }
i tried your pinned answer but the error still persists plus i am not able to install this version of zod
Install a different version
Hi, I followed everything in your code but my createUser always return error 500 even though the user is successfully created in the table... and I don't know why
I don't know either
@@TomDoesTech Hey I fixed it by moving the logic from user.service straight into the user.controller ... not sure why but it works now 😁
Nice tutorial, but I think the `preHandler` code to authenticate a route is old, doesn't seem be to working anymore
On app.ts, on the line with server.decorate() check if you used 'auth' vs 'authenticate'.
There's only a postman enviroment file on the repo, not the collection.
I've added the colleciton
I'm struggling with the resolution of the upload and can barely read what you've typed. I suspect it's the compression that's removed the sharpness.
The video is in 4k, try selecting the resolution manually and letting it load
Can you add a additional part how we test this application
I'm working on it right now :) Should be out early next week!
@@TomDoesTech I'm interested as well.
Please keep us informed.
Thanks in advance for your time & effort.
Really GREAT tuts !
@@johnnydriesen7575 Hey, I did a video where I tested this application czcams.com/video/gq8ZQrBJb2M/video.html
@@TomDoesTech Thank you
Need a tutorial, fastify + typescript + mongodb(using mongoose)
FastifyError: Missing schema $id property how to solve this error
When creating the object that combines all the schemas, add an id
export const { schemas: userSchemas, $ref } = buildJsonSchemas(
{
createUserSchema,
createUserResponseSchema,
loginSchema,
loginResponseSchema,
},
{ $id: "userSchemas" }
);
i am failed, but used npx tsc --init instead
FastifyError: Schema with id 'Schema' already declared!
Check the pinned comment
@@TomDoesTech I was attempt changing the "$id" as "productSchemas[0]['$id'] = 'OtherSchema' but getting error that property readonly. However app begins working despite this issue
@@TomDoesTech i reinstalled anyway fastify-zod to 0.0.2 ver
Is this tutorial still up to date?
I managed to update the necessary bits, let me know if you're keen. I can share you a repo.
@@tlourammala Hi, I would like the updated repo please.
Hi Tom
Thanks for this gread crash course. I like your way of teaching. But I did not understand one part of your tut, where you said use 0.0.0.0 instead of localhost because Docker expect us to use it and it wont work otherwise. Would you like to share some link/ref/tut/video/anything about it with me. I am very keen.
A truely fanstastic tutorial, love how you bring all the tools together so quickly. I followed all the way through fixing some of the deprecated module issues listed below, and the duplicate schema.
Where I got stuck was at 1h13m where we resolve the 'request.user.id' being missing. As fastify-jwt is deprecated I moved to use @fastify/jwt instead and did the following declare:
declare module '@fastify/jwt' {
interface FastifyJwt {
user: {
id: number;
email: string;
name: string;
};
}
}
however that did not resolve my missing id issue. on closer inspection I find that the IDE thinks the 'user' property is of type 'string', unfortunatley I'm strugging to understand how the 'user' property should be defined. I see the following definition in jwt.d.ts
user: fastifyJwt.UserType
export type UserType = FastifyJWT extends { user: infer T }
? T
: SignPayloadType
from that point on I was not able to get any of the products endpoints to work and got the following error response:
{
"statusCode": 500,
"error": "Internal Server Error",
"message": "Cannot read properties of undefined (reading 'product')"
}
but no uncaught exception on the server side debug output...
any thoughts?