Session storage

After identifyUser, the SDK persists identity in browser storage using a simplified model introduced in @scenaro/sdk@0.1.1.

Storage keys

Key	Content
`scenaro_session:app:{applicationId}`	Source of truth — JSON blob `{ user_token, user_id, application_id, external_id }`
`scenaro_scenario_uuid`	Pointer to the active publication UUID (for token refresh context)

Example after identify:

scenaro_session:app:2  →  {"external_id":"guest-…","user_token":"eyJ…","user_id":64,"application_id":2}
scenaro_scenario_uuid  →  "3d4134b3-d3f9-40b1-98d9-fa4f36dec3f7"

Transport session credentials (LiveKit tokens today) are ephemeral — they are not stored. Only the JWT identity is persisted.

Removed keys (v0.1.1+)

The following are no longer written at identify time:

Flat keys: scenaro_user_token, scenaro_user_id, scenaro_application_id, scenaro_external_id
Duplicate scenario blob: scenaro_session:{scenarioUUID}

Automatic migration

On read, the SDK client consolidates legacy storage formats (flat keys or scenario-scoped blobs) into scenaro_session:app:{id} and deletes obsolete keys. Legacy platform-spa keys (user_token, external_id) are still supported once via fallback.

Custom storage

Inject a StorageAdapter for SSR, tests, or non-browser environments:

const client = createScenaroClient({
  apiUrl: 'https://api.scenaro.io',
  storage: myMockStorage, // or null for SSR
});

interface StorageAdapter {
  getItem(key: string): string | null;
  setItem(key: string, value: string): void;
  removeItem(key: string): void;
}

Default: localStorage in browser, null on server.

Multi-embed prefix

For multiple Scenaro embeds on one origin, use storagePrefix:

createScenaroClient({
  apiUrl: 'https://api.scenaro.io',
  storagePrefix: 'brand_a',
});
// Keys become: brand_a_scenaro_session:app:2

Reading stored values

client.getStoredUserToken(scenarioUUID?, applicationId?);
client.getSessionUserId();
client.getSessionApplicationId();

Clear session

// Clear specific scenario context
client.clearStoredSession(scenarioUUID);

// Clear all Scenaro storage for this prefix
client.clearStoredSession();

​Storage keys

​Removed keys (v0.1.1+)

​Automatic migration

​Custom storage

​Multi-embed prefix

​Reading stored values

​Clear session

Storage keys

Removed keys (v0.1.1+)

Automatic migration

Custom storage

Multi-embed prefix

Reading stored values

Clear session