---
title: "@togohq/sdk-browser changelog"
canonical: https://www.togohq.ai/changelog/sdk-browser
entries: 5
---

# @togohq/sdk-browser changelog

## @togohq/sdk-browser 1.3.0 — Version 1.3.0 introduces session timeout in seconds and fixes session timeout handling

Released November 5, 2026 · Browser SDK
Permalink: https://www.togohq.ai/changelog/sdk-browser/1.3.0

### Breaking

- BREAKING: `DEFAULT_SESSION_TIMEOUT_MS` is now `DEFAULT_SESSION_TIMEOUT_SECONDS`, and `SESSION_HARD_CAP_MS` is no longer exported.
- BREAKING: `batchSize` and `flushIntervalMs` options are removed; batching is fixed at 50 events or 5 seconds.

### Deprecated

- `sessionTimeoutMs` is deprecated in favor of `sessionTimeoutSeconds` and will be removed in a future version.

### New

- `sessionTimeoutSeconds` is now available to set session idle timeout in seconds, defaulting to 1800.

### Fixed

- A null or NaN session timeout now defaults correctly, preventing sessions from being turned off unintentionally.

### Migration

Update session timeout and batching configurations to use new constants and options.

Before:

```ts
(DEFAULT_SESSION_TIMEOUT_MS, sessionTimeoutMs, batchSize, flushIntervalMs);
```

After:

```ts
(DEFAULT_SESSION_TIMEOUT_SECONDS, sessionTimeoutSeconds);
```

The old form stops working in @togohq/sdk-browser 1.3.0.

## @togohq/sdk-browser 1.2.0 — Version 1.2.0 introduces event ID returns and updates email handling rules

Released November 4, 2026 · Browser SDK
Permalink: https://www.togohq.ai/changelog/sdk-browser/1.2.0

### Breaking

- The governance wire's `declared` and `contractSha256` are now `defined` and `definitionSha256`; `DeclaredEvent` is now `DefinedEvent`.

### New

- `track()`, `identify()`, `setPersonProperties()` now return the `eventId` of the event they queued, or `undefined` when no event is sent.

### Improved

- Session IDs are no longer rejected for resembling emails; diagnostics attach to TEST events only.

### Fixed

- The scenario driver's Intl stub now survives a fake clock by using a regular function instead of an arrow function.

### Migration

Update governance wire and event types to use 'defined' instead of 'declared'.

Before:

```ts
(DeclaredEvent, declared, contractSha256);
```

After:

```ts
(DefinedEvent, defined, definitionSha256);
```

The old form stops working in @togohq/sdk-browser 1.2.0.

## @togohq/sdk-browser 1.1.1 — Version 1.1.1 fixes email redaction to use a consistent placeholder

Released October 29, 2026 · Browser SDK
Permalink: https://www.togohq.ai/changelog/sdk-browser/1.1.1

### Fixed

- Email redaction now uses `REDACTED_EMAIL` as the placeholder for email addresses in page fields, ensuring consistency.

## @togohq/sdk-browser 1.1.0 — Version 1.1.0 introduces default properties, timezone, and page context features

Released October 29, 2026 · Browser SDK
Permalink: https://www.togohq.ai/changelog/sdk-browser/1.1.0

### New

- `init({ defaultProperties })` now allows setting default properties that are stamped on every `track()` call. The browser SDK reads the device timezone at initialization, and page context includes URL and path per event, with referrer and UTM parameters captured once at init.

### Fixed

- Email redaction now correctly decodes only `%40` in email addresses from page fields, preventing malformed escape errors and ensuring proper redaction.
- An undefined event value no longer erases a default property, ensuring that undefined values are treated as absent.

## @togohq/sdk-browser 1.0.0 — The first stable release

Released October 24, 2026 · Browser SDK
Permalink: https://www.togohq.ai/changelog/sdk-browser/1.0.0

### Improved

- Semantic versioning. The public API is now stable: from this version on, a breaking change ships only in a new major version.