feat(next): external storage

[wangsijie]

Summary

This PR adds support for custom external session storage. Resolves logto-io/logto#6597.

Add sessionWrapper to the config, you can implement your own session wrapper to support custom external session storage.

Take a look at the example below:

import { MemorySessionWrapper } from './storage';

export const config = {
  // ...
  sessionWrapper: new MemorySessionWrapper(),
};

import { randomUUID } from 'node:crypto';

import { type SessionWrapper, type SessionData } from '@logto/next';

export class MemorySessionWrapper implements SessionWrapper {
  private readonly storage = new Map<string, unknown>();

  async wrap(data: unknown, _key: string): Promise<string> {
    const sessionId = randomUUID();
    this.storage.set(sessionId, data);
    return sessionId;
  }

  async unwrap(value: string, _key: string): Promise<SessionData> {
    if (!value) {
      return {};
    }

    const data = this.storage.get(value);
    return data ?? {};
  }
}

You can implement your own session wrapper to support custom external session storage like Redis, Memcached, etc.

Testing

Tested with sample projects.

Checklist

• .changeset
• unit tests
• integration tests
• necessary TSDoc comments