Struct CookieSessionView 

pub struct CookieSessionView<'a> { /* private fields */ }

Cookie-only operations on a PubkySession.

Implementations

impl<'a> CookieSessionView<'a>

pub fn session_info(&self) -> CookieSessionRecord

Returns the full cookie session record.

This gives access to cookie-specific fields like created_at and the binary serialization format that are not available via the shared PubkySession::info accessor.

pub fn export(&self) -> String

Export session metadata for rehydrating after a tab refresh or process restart.

The returned string contains no secrets; it is a base64 encoding of the public SessionInfo. The caller remains responsible for persisting the HTTP-only session cookie; export() merely captures the metadata needed to reconstruct a PubkySession handle.

pub fn export_secret(&self) -> Option<String>

Export the minimum data needed to restore this session later. Returns a single compact secret token <pubkey>:<cookie_secret>.

Useful for scripts that need restarting. Helps avoid a new auth flow from a signer on a script restart.

Treat the returned String as a bearer secret. Do not log it; store it securely.

Returns

• Some(token) on native and Node.js WASM (the SDK captured the secret from Set-Cookie).
• None on browser WASM, where Set-Cookie is hidden from JavaScript by the WHATWG fetch spec — only the browser cookie jar holds the value.

pub fn write_secret_file<P: AsRef<Path>>( &self, secret_file_path: P, ) -> Result<()>

Write the session secret token to disk. Ensures a .sess extension. Native-only — depends on the standard filesystem APIs.

Behavior:

• If secret_file_path already ends with .sess, it is used as-is.
• If it has no extension, .sess is added.
• If it has a different extension, the filename gains .sess (e.g., foo.txt -> foo.sess).

On Unix, permissions are set to 0o600.

Errors

• Returns std::io::Error if the file cannot be written or permissions cannot be set. On native the secret is always present, so this never errors with NotFound for that reason.

Trait Implementations

impl<'a> Debug for CookieSessionView<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.