v0.14.0: What's new?

[pilcrowonpaper]

v0.14.0 is a minor update but it still introduces a small number of breaking changes. This change also completely decouples SvelteKit specific methods and Lucia core methods.

Changes

createSession() and renewSession() returns Session

Previously they returned an object with session, idlePeriodExpires, and setSessionCookie().

// old
const { session } = await auth.createSession();

// new
const session = await auth.createSession();

locals.setSession() and locals.clearSession()

These are methods inside locals that sets the session cookie and clears them respectively.

// old
const { setSessionCookie } = await auth.createSession();
setSessionCookie(cookies);

// new
const session = await auth.createSession();
locals.setSession(session);

// old
auth.deleteAllCookies(cookies);

// new
locals.clearSession()

Removed deleteAllCookies()

This was replaced by locals.clearSession() (above).

Migration

Update App.Locals namespace in app.d.ts:

declare namespace App {
    interface Locals {
        getSession: import("lucia-sveltekit/types").GetSession;
        setSession: import("lucia-sveltekit/types").SetSession;
        clearSession: import("lucia-sveltekit/types").ClearSession;
    }
}

I'm not sure where's the best place to announce both major and minor changes, but I'll continue using discussions until I find a better alternative