Initial commit

CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+## 0.3.0
+
+Breaking changes — the package was aligned with the Rudder SDK glossary and
+the regenerated wire types (`src/generated`, apigen). No compatibility shims
+are provided.
+
+### Auth
+
+- `client.auth.loginViaDevice(region, language, nickname?)` replaced by
+  `client.auth.loginWithDevice(options?: { region?, language?, nickname? })`.
+  Default region is now `'global'` (was `'en'`); default language stays `'en'`.
+- New `client.auth.onAuthStateChange(cb)` — fires immediately with the current
+  state, then on every `'signed-in' | 'signed-out'` transition (login, logout,
+  and unrecoverable session expiry in the transport).
+- New `client.auth.isAuthenticated`.
+
+### Client configuration
+
+- `tokenStore` in `RudderClientOptions` is now optional. Default:
+  localStorage-backed store with a silent in-memory fallback where
+  localStorage is unavailable (SSR, private mode). New `createDefaultTokenStore()` export.
+- Invalid client options (`baseUrl` / `projectKey` missing) now throw
+  `RudderError` with `code: 'sdk/invalid-options'` instead of a plain `Error`.
+- New `onEffectError` option — called when an effect handler throws
+  (default: `console.error`); previously such errors were swallowed silently.
+
+### Renames
+
+- `client.config` → `client.remoteConfig` (canonical glossary name).
+- `client.battlepass` → `client.battlePass`; `BattlepassService` → `BattlePassService`.
+- Effects: `onBattlepass` / `BattlepassEffect` → `onBattlePass` / `BattlePassEffect`;
+  `onBattlepassLevel` / `BattlepassLevelEffect` → `onBattlePassLevel` / `BattlePassLevelEffect`.
+- Generated types: `SdkQuest` → `Quest`; `*Battlepass*` request/response types → `*BattlePass*`.
+- Internal transport `sendAsync` → `request` (not part of the public surface).
+
+### Leaderboards
+
+- Removed `LeaderboardsService.getRanking(slug, limit)` and
+  `LeaderboardsService.submitScore(slug, score)`. Single path:
+  `client.leaderboards.findBySlug(slug)` → `handle.list(limit?)` / `handle.submit(score)`.
+
+### Errors
+
+- `RudderNetworkError.inner` → standard `Error.cause`.
+- `RudderHttpError.code` is typed as `RudderErrorCode | (string & {})`
+  (generated union of server error codes, plus room for unknown strings).
+- New exports: `RudderErrorCode` (type), `RudderErrorCodes` (constants),
+  `SDK_ERROR_INVALID_OPTIONS`, `RudderErrorCodeLike` (type).
+
+### Public surface
+
+- The barrel no longer exports `getOrCreateDeviceId`, domain classes
+  (`PlayerDomain`, …) or service constructors (`AuthService`, …) as values —
+  they remain available as types. Instances live on the client.
+- `SubmittedBy` is no longer re-exported (UGC is unsupported on web).
+
+### Bundle
+
+- The scenario engine and the IndexedDB plan store are loaded lazily (dynamic
+  import) on first login / first runtime access — a thin client never pulls
+  the scenario machinery into the initial chunk.
+- The package now ships both ESM (`dist/index.js`) and CJS (`dist/index.cjs`)
+  builds with matching `exports` entries.