API Reference — @tuwaio/siwx (CAIP-122 Authentication Layer)

serializeCookieSession()

serializeCookieSession(session, opts?): SerializedCookieSession

Defined in: packages/siwx-server/src/server.ts:142 

Serializes a SiwxSession into an HttpOnly cookie string. The session data is base64url-encoded (not encrypted — use a signed cookie or JWT for production).

This utility is intentionally simple. For production use, wrap the session in a signed/encrypted format using a library like iron-session or jose.

Parameters

session

SiwxSession

The verified session data to serialize.

opts?

CookieOptions = {}

Cookie options (name, maxAge, secure, SameSite, etc.).

Returns

SerializedCookieSession

A SerializedCookieSession containing the Set-Cookie header value and session data.

Example

const { cookieHeader } = serializeCookieSession(session);
return new Response(null, { headers: { 'Set-Cookie': cookieHeader } });