Kysely

[matejchalk]

Closes #21

Features

• Set up local database using postgres Docker image.
  • Also integrated Adminer for UI access to database (also via Docker).
• Set up Kysely for using database in TypeScript.
  • Types are generated from local database using Kanel, with some customizations like de-pluralizing type names and adding suffix (e.g. public.users Postgres table transformed to UserModel type).
  • Set up migrations with initial creation of users table.
  • Implemented database client for users table.
  • Set up seeds which insert test user ([email protected]) in non-production environment.
• Created new db library for client and models.
  • Customized defaults for Nx generator.
• Integrated @th/db in api to resolve "current" user.
  • Using mappers to use database models in resolvers.

Testing

Running npm start will spin up local database (requires Docker Compose) and run migration.

Visit http://localhost:8080/?pgsql=db&username=admin&db=th_db&ns=public in browser and sign in with password admin:

View test user [email protected] in users table:

(Optional) Add new user

Go to users table and add new item. You can use SHA256 - Online Tools to hash your password, or just generate a random hash with node -e "console.log(require('crypto').randomBytes(32).toString('hex'))".

See user logged by website and cms (as in #27 description), or query GraphQL API directly:

If you need to drop local database, run docker compose down (loses data!).

Next steps

This database setup with npm-run-all works, but isn't very compatible Nx cache. I would like to convert these package.json scripts (starting DB container, migration, seeding) into Nx targets for the db library, so that the dependencies are part of the Nx task graph.

[Tlacenka]

Good job, thank you for the extensive documentation and guide on how to run it. 👍