v0.5.0: Introducing keys! (+migration checklist)

[pilcrowonpaper]

I'm excited to announce version 0.5.0!

The biggest change is the introduction of keys. Keys are similar to the provider id in the previous versions but it's now decoupled to user, allowing you to link multiple providers to a single user.

Migration

Update your packages

Every single package has a new version!

Update your database

1. New key table
2. Removed provider_id, hashed_password from user table
3. Renamed expires column to active_expires in session table

Refer to this guide for details.

Update APIs

• Replaced getUserByProviderId(): getKeyUser()
• Replaced authenticateUser(): validateKeyPassword()
• Replaced updateUserPassword(): updateKeyPassword()
• Removed updateUserProviderId
• Updated createUser(): docs

Update configuration

By default, Lucia will now generate its own user id. Add generateCustomUserId() if you want to let the database handle it (previous default behavior):

lucia({
  generateCustomUserId: () => null
})

Astro and SvelteKit integration packages

The signOut() function has been removed. Follow the following guides to implement sign out:

• Astro
• SvelteKit

0.6.0

Minor update: #324

[pilcrowonpaper]

Also, this should be the last update to the database model before 1.0. There likely will be changes to the API but it won't be something drastic, I think.