v0.8.6 - Another breaking change

[pilcrowonpaper]

Hi everyone!

First, at the time of writing this, we have 184 Github stars and 70 discord members! A big thank you to everyone, and a very big thank you to those who contributed! We're currently the fastest growing authentication library for SvelteKit as well. A bit niche, but I think that's amazing.

So... v0.8.6 introduces another batch of breaking changes. I know people were tired of SvelteKit breaking every few hours and it doesn't help that Lucia breaks every few days as well. I'm hoping this will be the last major breaking change, but no promises.

With this update, I've reverted the recent change of load functions, where you use wrapper functions provided by Lucia to set them. However this led to SvelteKit's type interference to break and it didn't provide a good DX, so I've removed them while keeping all the features that were introduced.

Major breaking changes

Root server load function

import { auth } from "$lib/lucia";

export const load = auth.handleServerSession(customServerLoad)

Load functions

import { getSession } from "lucia-sveltekit/load";

export const load: PageLoad = async (event) => {
   const session = await getSession(event)
}

Server load functions

import { auth } from "$lib/lucia";

export const load: PageServerLoad = async (event) => {
   try {
     const session = await auth.validateRequestByCookie(event.request);
   } catch {}
}

Other changes

I've also added a way to validate form submissions.

<script>
    import { getSession } from "lucia-sveltekit/client";

    const session = getSession();
</script>

<form method="post">
    <input name="_lucia" value="{$session?.access_token}" hidden />
</form>

// +page.server.ts
import { auth } from "$lib/lucia";
import type { Actions } from "@sveltejs/kit";

export const actions: Actions = {
    default: async ({ request }) => {
        try {
            const session = await auth.validateFormSubmission(request);
        } catch {
            // ...
        }
    },
};

Finally, I've improved the example app and the documentation as a whole. Thanks for sticking with us!