@pixelume/sdk 0.4.0 → 0.6.0

package/dist/modules/analytics/AnalyticsModule.js

@@ -0,0 +1,461 @@
+import { SDK_VERSION } from '../../version.js';
+import { NoopAnalyticsProvider, } from './AnalyticsProvider.js';
+import { ANALYTICS_EVENTS, isCatalogEvent, isValidEventName, normalizeLevel, normalizeReason, sanitizeProperties, } from './events.js';
+import { PostHogAnalyticsProvider } from './PostHogAnalyticsProvider.js';
+/** Events kept while the provider loads after consent; older ones are kept, newer dropped. */
+export const MAX_PENDING_EVENTS = 100;
+const MAX_TRACKED_LEVELS = 50;
+const CONSENT_VERSION = 1;
+/** Anonymous reasons meaning "the account is no longer the one playing". */
+const SEPARATING_REASONS = new Set(['logged_out', 'expired', 'session_ended']);
+/** Keys set by the SDK for an event, protected even when the SDK does not set them this time. */
+const NO_PROTECTED_KEYS = new Set();
+const SESSION_END_KEYS = new Set(['duration_ms', 'visible_duration_ms']);
+const LEVEL_KEYS = new Set(['level', 'duration_ms']);
+const LEVEL_FAILED_KEYS = new Set(['level', 'duration_ms', 'reason']);
+export class AnalyticsModule {
+    #config;
+    #provider;
+    #browser;
+    #visibility;
+    #now;
+    #unsubscribeAuth;
+    #consent = 'unknown';
+    #status;
+    #pending = [];
+    #identity = null;
+    #session = null;
+    #loading = false;
+    #loaded = false;
+    /** Consent was revoked while the provider was loading: wipe it as soon as it is ready. */
+    #revokedWhileLoading = false;
+    #destroyed = false;
+    constructor(options) {
+        this.#config = options.config;
+        this.#browser = options.browser;
+        this.#visibility =
+            options.visibility === undefined ? browserVisibilitySource() : options.visibility;
+        this.#now = options.now ?? (() => Date.now());
+        const config = this.#config;
+        if (config === null) {
+            this.#provider = new NoopAnalyticsProvider();
+            this.#status = 'disabled';
+            this.#unsubscribeAuth = () => undefined;
+            return;
+        }
+        this.#provider = (options.createProvider ?? createDefaultProvider)(config);
+        this.#status = 'waiting_consent';
+        this.#identity = identityFor(options.auth.state);
+        this.#unsubscribeAuth = options.auth.subscribe((state) => {
+            this.#onAuthState(state);
+        });
+        const remembered = config.rememberConsent ? this.#readConsent() : null;
+        if (remembered === false)
+            this.#consent = 'denied';
+        if (remembered === true) {
+            this.#consent = 'granted';
+            // Asynchronous: constructing the client never waits for, nor fails because of, the provider.
+            this.#activate();
+        }
+    }
+    get consent() {
+        return this.#consent;
+    }
+    get status() {
+        return this.#status;
+    }
+    get sessionId() {
+        return this.#session?.id ?? null;
+    }
+    isEnabled() {
+        return this.#status === 'loading' || this.#status === 'ready';
+    }
+    setConsent(granted) {
+        const value = granted;
+        if (this.#destroyed || this.#config === null || typeof value !== 'boolean')
+            return;
+        const next = value ? 'granted' : 'denied';
+        // Repeating the decision is a no-op, except to retry a provider that could not load.
+        if (next === this.#consent && this.#status !== 'unavailable')
+            return;
+        this.#consent = next;
+        if (this.#config.rememberConsent)
+            this.#writeConsent(value);
+        if (value) {
+            this.#activate();
+            return;
+        }
+        this.#pending = [];
+        this.#status = 'waiting_consent';
+        if (this.#loading)
+            this.#revokedWhileLoading = true;
+        this.#guard(() => {
+            this.#provider.optOut();
+        });
+    }
+    track(event, properties) {
+        if (!isValidEventName(event)) {
+            this.#report('invalid_event', null);
+            return;
+        }
+        if (isCatalogEvent(event)) {
+            this.#report('reserved_event', event);
+            return;
+        }
+        this.#emit(event, properties, {});
+    }
+    startSession(properties) {
+        if (this.#destroyed || this.#session !== null)
+            return;
+        const now = this.#now();
+        // A no-op client never touches the page, not even to listen.
+        const visibility = this.#config === null ? null : this.#visibility;
+        const session = {
+            id: randomId(this.#browser),
+            startedAt: now,
+            visibleMs: 0,
+            visibleSince: visibility === null || visibility.isVisible() ? now : null,
+            unsubscribeVisibility: visibility?.subscribe(() => {
+                this.#onVisibilityChange(session);
+            }) ?? null,
+            levels: new Map(),
+        };
+        this.#session = session;
+        this.#emit(ANALYTICS_EVENTS.sessionStarted, properties, {});
+    }
+    endSession(properties) {
+        const session = this.#session;
+        if (session === null)
+            return;
+        const now = this.#now();
+        const visibleMs = session.visibleMs + (session.visibleSince === null ? 0 : now - session.visibleSince);
+        this.#emit(ANALYTICS_EVENTS.sessionEnded, properties, {
+            duration_ms: Math.max(0, Math.round(now - session.startedAt)),
+            visible_duration_ms: Math.max(0, Math.round(visibleMs)),
+        }, SESSION_END_KEYS);
+        this.#closeSession();
+    }
+    levelStarted(level, properties) {
+        const normalized = this.#level(ANALYTICS_EVENTS.levelStarted, level);
+        if (normalized === null)
+            return;
+        const levels = this.#session?.levels;
+        if (levels !== undefined) {
+            levels.delete(normalized);
+            if (levels.size >= MAX_TRACKED_LEVELS) {
+                const oldest = levels.keys().next();
+                if (oldest.done !== true)
+                    levels.delete(oldest.value);
+            }
+            levels.set(normalized, this.#now());
+        }
+        this.#emit(ANALYTICS_EVENTS.levelStarted, properties, { level: normalized }, LEVEL_KEYS);
+    }
+    levelCompleted(level, properties) {
+        const normalized = this.#level(ANALYTICS_EVENTS.levelCompleted, level);
+        if (normalized === null)
+            return;
+        this.#emit(ANALYTICS_EVENTS.levelCompleted, properties, { level: normalized, ...this.#levelDuration(normalized) }, LEVEL_KEYS);
+    }
+    levelFailed(level, reason, properties) {
+        const normalized = this.#level(ANALYTICS_EVENTS.levelFailed, level);
+        if (normalized === null)
+            return;
+        const extra = { level: normalized, ...this.#levelDuration(normalized) };
+        if (reason !== undefined) {
+            const value = normalizeReason(reason);
+            if (value === null)
+                this.#report('invalid_property', ANALYTICS_EVENTS.levelFailed, 'reason');
+            else
+                extra.reason = value;
+        }
+        this.#emit(ANALYTICS_EVENTS.levelFailed, properties, extra, LEVEL_FAILED_KEYS);
+    }
+    /**
+     * @internal Called by `PixelumeClient.destroy()`: releases listeners and stops delivery. Does not
+     * end the game session nor change consent; posthog may still flush what it already accepted.
+     */
+    dispose() {
+        if (this.#destroyed)
+            return;
+        this.#destroyed = true;
+        this.#unsubscribeAuth();
+        this.#closeSession();
+        this.#pending = [];
+        this.#status = 'disabled';
+        this.#guard(() => {
+            this.#provider.detach();
+        });
+    }
+    #activate() {
+        if (this.#destroyed || this.#consent !== 'granted')
+            return;
+        if (this.#loading) {
+            this.#status = 'loading';
+            return;
+        }
+        if (this.#loaded) {
+            this.#status = 'ready';
+            this.#guard(() => {
+                this.#provider.optIn();
+            });
+            this.#applyIdentity();
+            return;
+        }
+        this.#status = 'loading';
+        this.#loading = true;
+        let loading;
+        try {
+            loading = this.#provider.load();
+        }
+        catch (error) {
+            loading = Promise.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+        loading.then(() => {
+            this.#onProviderReady();
+        }, () => {
+            this.#onProviderFailed();
+        });
+    }
+    #onProviderReady() {
+        this.#loading = false;
+        if (this.#destroyed)
+            return;
+        this.#loaded = true;
+        if (this.#revokedWhileLoading) {
+            // Revoked while loading: wipe whatever the provider set up before using it again.
+            this.#revokedWhileLoading = false;
+            this.#guard(() => {
+                this.#provider.optOut();
+            });
+        }
+        if (this.#consent !== 'granted')
+            return;
+        this.#status = 'ready';
+        this.#guard(() => {
+            this.#provider.optIn();
+        });
+        this.#applyIdentity();
+        const pending = this.#pending;
+        this.#pending = [];
+        for (const event of pending)
+            this.#deliver(event);
+    }
+    #onProviderFailed() {
+        this.#loading = false;
+        this.#revokedWhileLoading = false;
+        if (this.#destroyed)
+            return;
+        this.#pending = [];
+        if (this.#consent !== 'granted')
+            return;
+        this.#status = 'unavailable';
+        this.#report('provider_unavailable', null);
+    }
+    #onAuthState(state) {
+        const identity = identityFor(state);
+        if (identity === null)
+            return;
+        this.#identity = identity;
+        this.#applyIdentity();
+    }
+    #applyIdentity() {
+        const identity = this.#identity;
+        if (identity === null || this.#status !== 'ready' || this.#consent !== 'granted')
+            return;
+        this.#guard(() => {
+            this.#provider.identify(identity);
+        });
+    }
+    #emit(name, properties, extra, protectedKeys = NO_PROTECTED_KEYS) {
+        if (this.#destroyed || this.#config === null)
+            return;
+        const keys = new Set([...protectedKeys, ...Object.keys(extra)]);
+        let sanitized;
+        try {
+            sanitized = sanitizeProperties(name, properties, keys, this.#reporter);
+        }
+        catch {
+            // Hostile input (throwing getters, proxies): drop the event, never the game.
+            this.#report('invalid_property', name);
+            return;
+        }
+        if (this.#consent !== 'granted')
+            return;
+        if (this.#status !== 'loading' && this.#status !== 'ready')
+            return;
+        const event = {
+            name,
+            properties: { ...sanitized, ...extra, ...this.#metadata() },
+            timestamp: this.#now(),
+        };
+        if (this.#status === 'ready') {
+            this.#deliver(event);
+        }
+        else if (this.#pending.length < MAX_PENDING_EVENTS) {
+            this.#pending.push({ ...event, delayed: true });
+        }
+        else {
+            this.#report('queue_full', name);
+        }
+    }
+    #deliver(event) {
+        this.#guard(() => {
+            this.#provider.capture(event);
+        }, event.name);
+    }
+    #metadata() {
+        const config = this.#config;
+        const metadata = {
+            game_id: config?.gameId ?? null,
+            sdk_version: SDK_VERSION,
+            platform: 'web',
+        };
+        if (config?.gameVersion != null)
+            metadata.game_version = config.gameVersion;
+        if (this.#session !== null)
+            metadata.session_id = this.#session.id;
+        return metadata;
+    }
+    #level(event, level) {
+        const normalized = normalizeLevel(level);
+        if (normalized === null)
+            this.#report('invalid_level', event);
+        return normalized;
+    }
+    #levelDuration(level) {
+        const levels = this.#session?.levels;
+        const startedAt = levels?.get(level);
+        if (levels === undefined || startedAt === undefined)
+            return {};
+        levels.delete(level);
+        return { duration_ms: Math.max(0, Math.round(this.#now() - startedAt)) };
+    }
+    #onVisibilityChange(session) {
+        if (this.#session !== session || this.#visibility === null)
+            return;
+        const now = this.#now();
+        if (this.#visibility.isVisible()) {
+            session.visibleSince ??= now;
+        }
+        else if (session.visibleSince !== null) {
+            session.visibleMs += now - session.visibleSince;
+            session.visibleSince = null;
+        }
+    }
+    #closeSession() {
+        const session = this.#session;
+        this.#session = null;
+        session?.unsubscribeVisibility?.();
+    }
+    #reporter = (code, event, property = null) => {
+        this.#report(code, event, property);
+    };
+    #report(code, event, property = null) {
+        const onIssue = this.#config?.onIssue;
+        if (!onIssue)
+            return;
+        try {
+            onIssue(Object.freeze({ code, event, property }));
+        }
+        catch {
+            // Diagnostics must never affect the game.
+        }
+    }
+    #guard(action, event = null) {
+        try {
+            action();
+        }
+        catch {
+            this.#report('provider_error', event);
+        }
+    }
+    #consentKey() {
+        return `pixelume.analytics.consent.${this.#config?.gameId ?? 'unconfigured'}`;
+    }
+    #storage() {
+        try {
+            if (this.#browser !== undefined)
+                return this.#browser.persistentStorage ?? null;
+            return typeof globalThis.localStorage === 'undefined' ? null : globalThis.localStorage;
+        }
+        catch {
+            // Blocked storage (privacy settings, sandboxed frames).
+            return null;
+        }
+    }
+    #readConsent() {
+        try {
+            const raw = this.#storage()?.getItem(this.#consentKey()) ?? null;
+            if (raw === null)
+                return null;
+            const value = JSON.parse(raw);
+            if (typeof value === 'object' &&
+                value !== null &&
+                value.version === CONSENT_VERSION &&
+                typeof value.granted === 'boolean') {
+                return value.granted;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    #writeConsent(granted) {
+        try {
+            this.#storage()?.setItem(this.#consentKey(), JSON.stringify({ version: CONSENT_VERSION, granted, at: this.#now() }));
+        }
+        catch {
+            // Not remembered: the game asks again on the next visit.
+        }
+    }
+}
+function createDefaultProvider(config) {
+    return new PostHogAnalyticsProvider({
+        token: config.provider.token,
+        host: config.provider.host,
+        gameId: config.gameId,
+    });
+}
+/** `null` while authentication is still settling: keep the previous identity. */
+function identityFor(state) {
+    if (state.status === 'authenticated')
+        return { player: state.player.id, separate: false };
+    if (state.status === 'anonymous') {
+        return { player: null, separate: SEPARATING_REASONS.has(state.reason) };
+    }
+    return null;
+}
+function randomId(browser) {
+    const globalCrypto = Reflect.get(globalThis, 'crypto');
+    const crypto = browser?.crypto ?? globalCrypto;
+    if (typeof crypto?.randomUUID === 'function')
+        return crypto.randomUUID();
+    const bytes = new Uint8Array(16);
+    if (typeof crypto?.getRandomValues === 'function') {
+        crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let index = 0; index < bytes.length; index += 1) {
+            bytes[index] = Math.floor(Math.random() * 256);
+        }
+    }
+    return [...bytes].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+/** `document.visibilityState`, looked up lazily; `null` outside a browser. */
+function browserVisibilitySource() {
+    const document = Reflect.get(globalThis, 'document');
+    if (document === undefined || typeof document.addEventListener !== 'function')
+        return null;
+    return {
+        isVisible: () => document.visibilityState !== 'hidden',
+        subscribe: (onChange) => {
+            document.addEventListener('visibilitychange', onChange);
+            return () => {
+                document.removeEventListener('visibilitychange', onChange);
+            };
+        },
+    };
+}
+//# sourceMappingURL=AnalyticsModule.js.map

package/dist/modules/analytics/AnalyticsModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsModule.js","sourceRoot":"","sources":["../../../src/modules/analytics/AnalyticsModule.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ResolvedAnalyticsConfig } from '../../core/config.js';\nimport type {\n  PixelumeAnalyticsIssue,\n  PixelumeBrowserAdapter,\n  PixelumeSessionStorage,\n} from '../../core/types.js';\nimport { SDK_VERSION } from '../../version.js';\nimport type { PixelumeAuthListener, PixelumeAuthState } from '../auth/AuthModule.js';\nimport {\n  NoopAnalyticsProvider,\n  type AnalyticsEvent,\n  type AnalyticsIdentity,\n  type AnalyticsProvider,\n} from './AnalyticsProvider.js';\nimport {\n  ANALYTICS_EVENTS,\n  isCatalogEvent,\n  isValidEventName,\n  normalizeLevel,\n  normalizeReason,\n  sanitizeProperties,\n  type AnalyticsProperties,\n  type IssueReporter,\n} from './events.js';\nimport { PostHogAnalyticsProvider } from './PostHogAnalyticsProvider.js';\n\n/** Flat values accepted as event properties. Other values are dropped (see `onIssue`). */\nexport type PixelumeAnalyticsProperties = Readonly<\n  Record<string, string | number | boolean | null | undefined>\n>;\n\n/**\n * - `unknown`: the player has not decided (or the choice is not remembered). Nothing is sent.\n * - `granted`: events are sent.\n * - `denied`: nothing is sent and the analytics identifiers were removed from the browser.\n */\nexport type PixelumeAnalyticsConsent = 'unknown' | 'granted' | 'denied';\n\n/**\n * - `disabled`: not configured (or the client was destroyed): every call is a no-op.\n * - `waiting_consent`: configured, consent not granted. Events are discarded, not queued.\n * - `loading`: consent granted, provider loading; events wait in a small in-memory queue.\n * - `ready`: events are being delivered.\n * - `unavailable`: the provider could not load here (no browser, blocked script/network). Events\n *   are discarded; a later `setConsent(true)` tries again.\n */\nexport type PixelumeAnalyticsStatus =\n  'disabled' | 'waiting_consent' | 'loading' | 'ready' | 'unavailable';\n\n/**\n * Gameplay analytics, decoupled from the provider (PostHog today). Every method is synchronous,\n * never throws and never waits for the network: a failing provider cannot stop the game.\n *\n * A **game session** is one continuous play period defined by the game (e.g. from \"Play\" until the\n * player returns to the menu, or one match); it is unrelated to the Pixelume login session.\n */\nexport interface PixelumeAnalyticsApi {\n  readonly consent: PixelumeAnalyticsConsent;\n  readonly status: PixelumeAnalyticsStatus;\n  /** Id of the current game session (`session_id` of every event), or `null` outside one. */\n  readonly sessionId: string | null;\n  /** `true` when events are (or will shortly be) delivered: configured, consented, available. */\n  isEnabled(): boolean;\n  /**\n   * Records the player's explicit decision. `false` discards pending events, stops delivery and\n   * removes the analytics identifiers from the browser; `true` after `false` starts a new\n   * anonymous identity. Repeating the current value does nothing.\n   */\n  setConsent(granted: boolean): void;\n  /** Custom event: snake_case name (1–64 chars) not in the built-in catalog. */\n  track(event: string, properties?: PixelumeAnalyticsProperties): void;\n  /** Starts a game session (`game_session_started`). Does nothing while one is active. */\n  startSession(properties?: PixelumeAnalyticsProperties): void;\n  /**\n   * Ends the current game session (`game_session_ended` with `duration_ms` and\n   * `visible_duration_ms`). Does nothing without an active session. Closing the tab does **not**\n   * end the session: only the game knows when play really ended.\n   */\n  endSession(properties?: PixelumeAnalyticsProperties): void;\n  levelStarted(level: string | number, properties?: PixelumeAnalyticsProperties): void;\n  /** `level_completed`; carries `duration_ms` when the matching `levelStarted` was seen. */\n  levelCompleted(level: string | number, properties?: PixelumeAnalyticsProperties): void;\n  /** `level_failed` with an optional short `reason` (e.g. `'out_of_moves'`). */\n  levelFailed(\n    level: string | number,\n    reason?: string,\n    properties?: PixelumeAnalyticsProperties,\n  ): void;\n}\n\n/** Subset of `pixelume.auth` used to follow the player's identity. */\nexport interface AnalyticsAuthSource {\n  readonly state: PixelumeAuthState;\n  subscribe(listener: PixelumeAuthListener): () => void;\n}\n\n/** Visibility signals; tests inject a double. */\nexport interface VisibilitySource {\n  isVisible(): boolean;\n  subscribe(onChange: () => void): () => void;\n}\n\nexport interface AnalyticsModuleOptions {\n  readonly config: ResolvedAnalyticsConfig | null;\n  readonly auth: AnalyticsAuthSource;\n  readonly browser?: PixelumeBrowserAdapter | undefined;\n  /** Test seams. */\n  readonly createProvider?: (config: ResolvedAnalyticsConfig) => AnalyticsProvider;\n  readonly visibility?: VisibilitySource | null;\n  readonly now?: () => number;\n}\n\n/** Events kept while the provider loads after consent; older ones are kept, newer dropped. */\nexport const MAX_PENDING_EVENTS = 100;\nconst MAX_TRACKED_LEVELS = 50;\nconst CONSENT_VERSION = 1;\n/** Anonymous reasons meaning \"the account is no longer the one playing\". */\nconst SEPARATING_REASONS: ReadonlySet<string> = new Set(['logged_out', 'expired', 'session_ended']);\n/** Keys set by the SDK for an event, protected even when the SDK does not set them this time. */\nconst NO_PROTECTED_KEYS: ReadonlySet<string> = new Set();\nconst SESSION_END_KEYS: ReadonlySet<string> = new Set(['duration_ms', 'visible_duration_ms']);\nconst LEVEL_KEYS: ReadonlySet<string> = new Set(['level', 'duration_ms']);\nconst LEVEL_FAILED_KEYS: ReadonlySet<string> = new Set(['level', 'duration_ms', 'reason']);\n\ninterface GameSession {\n  readonly id: string;\n  readonly startedAt: number;\n  visibleMs: number;\n  visibleSince: number | null;\n  readonly unsubscribeVisibility: (() => void) | null;\n  readonly levels: Map<string, number>;\n}\n\nexport class AnalyticsModule implements PixelumeAnalyticsApi {\n  readonly #config: ResolvedAnalyticsConfig | null;\n  readonly #provider: AnalyticsProvider;\n  readonly #browser: PixelumeBrowserAdapter | undefined;\n  readonly #visibility: VisibilitySource | null;\n  readonly #now: () => number;\n  readonly #unsubscribeAuth: () => void;\n  #consent: PixelumeAnalyticsConsent = 'unknown';\n  #status: PixelumeAnalyticsStatus;\n  #pending: AnalyticsEvent[] = [];\n  #identity: AnalyticsIdentity | null = null;\n  #session: GameSession | null = null;\n  #loading = false;\n  #loaded = false;\n  /** Consent was revoked while the provider was loading: wipe it as soon as it is ready. */\n  #revokedWhileLoading = false;\n  #destroyed = false;\n\n  constructor(options: AnalyticsModuleOptions) {\n    this.#config = options.config;\n    this.#browser = options.browser;\n    this.#visibility =\n      options.visibility === undefined ? browserVisibilitySource() : options.visibility;\n    this.#now = options.now ?? (() => Date.now());\n    const config = this.#config;\n    if (config === null) {\n      this.#provider = new NoopAnalyticsProvider();\n      this.#status = 'disabled';\n      this.#unsubscribeAuth = () => undefined;\n      return;\n    }\n    this.#provider = (options.createProvider ?? createDefaultProvider)(config);\n    this.#status = 'waiting_consent';\n    this.#identity = identityFor(options.auth.state);\n    this.#unsubscribeAuth = options.auth.subscribe((state) => {\n      this.#onAuthState(state);\n    });\n    const remembered = config.rememberConsent ? this.#readConsent() : null;\n    if (remembered === false) this.#consent = 'denied';\n    if (remembered === true) {\n      this.#consent = 'granted';\n      // Asynchronous: constructing the client never waits for, nor fails because of, the provider.\n      this.#activate();\n    }\n  }\n\n  get consent(): PixelumeAnalyticsConsent {\n    return this.#consent;\n  }\n\n  get status(): PixelumeAnalyticsStatus {\n    return this.#status;\n  }\n\n  get sessionId(): string | null {\n    return this.#session?.id ?? null;\n  }\n\n  isEnabled(): boolean {\n    return this.#status === 'loading' || this.#status === 'ready';\n  }\n\n  setConsent(granted: boolean): void {\n    const value: unknown = granted;\n    if (this.#destroyed || this.#config === null || typeof value !== 'boolean') return;\n    const next: PixelumeAnalyticsConsent = value ? 'granted' : 'denied';\n    // Repeating the decision is a no-op, except to retry a provider that could not load.\n    if (next === this.#consent && this.#status !== 'unavailable') return;\n    this.#consent = next;\n    if (this.#config.rememberConsent) this.#writeConsent(value);\n    if (value) {\n      this.#activate();\n      return;\n    }\n    this.#pending = [];\n    this.#status = 'waiting_consent';\n    if (this.#loading) this.#revokedWhileLoading = true;\n    this.#guard(() => {\n      this.#provider.optOut();\n    });\n  }\n\n  track(event: string, properties?: PixelumeAnalyticsProperties): void {\n    if (!isValidEventName(event)) {\n      this.#report('invalid_event', null);\n      return;\n    }\n    if (isCatalogEvent(event)) {\n      this.#report('reserved_event', event);\n      return;\n    }\n    this.#emit(event, properties, {});\n  }\n\n  startSession(properties?: PixelumeAnalyticsProperties): void {\n    if (this.#destroyed || this.#session !== null) return;\n    const now = this.#now();\n    // A no-op client never touches the page, not even to listen.\n    const visibility = this.#config === null ? null : this.#visibility;\n    const session: GameSession = {\n      id: randomId(this.#browser),\n      startedAt: now,\n      visibleMs: 0,\n      visibleSince: visibility === null || visibility.isVisible() ? now : null,\n      unsubscribeVisibility:\n        visibility?.subscribe(() => {\n          this.#onVisibilityChange(session);\n        }) ?? null,\n      levels: new Map(),\n    };\n    this.#session = session;\n    this.#emit(ANALYTICS_EVENTS.sessionStarted, properties, {});\n  }\n\n  endSession(properties?: PixelumeAnalyticsProperties): void {\n    const session = this.#session;\n    if (session === null) return;\n    const now = this.#now();\n    const visibleMs =\n      session.visibleMs + (session.visibleSince === null ? 0 : now - session.visibleSince);\n    this.#emit(\n      ANALYTICS_EVENTS.sessionEnded,\n      properties,\n      {\n        duration_ms: Math.max(0, Math.round(now - session.startedAt)),\n        visible_duration_ms: Math.max(0, Math.round(visibleMs)),\n      },\n      SESSION_END_KEYS,\n    );\n    this.#closeSession();\n  }\n\n  levelStarted(level: string | number, properties?: PixelumeAnalyticsProperties): void {\n    const normalized = this.#level(ANALYTICS_EVENTS.levelStarted, level);\n    if (normalized === null) return;\n    const levels = this.#session?.levels;\n    if (levels !== undefined) {\n      levels.delete(normalized);\n      if (levels.size >= MAX_TRACKED_LEVELS) {\n        const oldest = levels.keys().next();\n        if (oldest.done !== true) levels.delete(oldest.value);\n      }\n      levels.set(normalized, this.#now());\n    }\n    this.#emit(ANALYTICS_EVENTS.levelStarted, properties, { level: normalized }, LEVEL_KEYS);\n  }\n\n  levelCompleted(level: string | number, properties?: PixelumeAnalyticsProperties): void {\n    const normalized = this.#level(ANALYTICS_EVENTS.levelCompleted, level);\n    if (normalized === null) return;\n    this.#emit(\n      ANALYTICS_EVENTS.levelCompleted,\n      properties,\n      { level: normalized, ...this.#levelDuration(normalized) },\n      LEVEL_KEYS,\n    );\n  }\n\n  levelFailed(\n    level: string | number,\n    reason?: string,\n    properties?: PixelumeAnalyticsProperties,\n  ): void {\n    const normalized = this.#level(ANALYTICS_EVENTS.levelFailed, level);\n    if (normalized === null) return;\n    const extra: AnalyticsProperties = { level: normalized, ...this.#levelDuration(normalized) };\n    if (reason !== undefined) {\n      const value = normalizeReason(reason);\n      if (value === null) this.#report('invalid_property', ANALYTICS_EVENTS.levelFailed, 'reason');\n      else extra.reason = value;\n    }\n    this.#emit(ANALYTICS_EVENTS.levelFailed, properties, extra, LEVEL_FAILED_KEYS);\n  }\n\n  /**\n   * @internal Called by `PixelumeClient.destroy()`: releases listeners and stops delivery. Does not\n   * end the game session nor change consent; posthog may still flush what it already accepted.\n   */\n  dispose(): void {\n    if (this.#destroyed) return;\n    this.#destroyed = true;\n    this.#unsubscribeAuth();\n    this.#closeSession();\n    this.#pending = [];\n    this.#status = 'disabled';\n    this.#guard(() => {\n      this.#provider.detach();\n    });\n  }\n\n  #activate(): void {\n    if (this.#destroyed || this.#consent !== 'granted') return;\n    if (this.#loading) {\n      this.#status = 'loading';\n      return;\n    }\n    if (this.#loaded) {\n      this.#status = 'ready';\n      this.#guard(() => {\n        this.#provider.optIn();\n      });\n      this.#applyIdentity();\n      return;\n    }\n    this.#status = 'loading';\n    this.#loading = true;\n    let loading: Promise<void>;\n    try {\n      loading = this.#provider.load();\n    } catch (error) {\n      loading = Promise.reject(error instanceof Error ? error : new Error(String(error)));\n    }\n    loading.then(\n      () => {\n        this.#onProviderReady();\n      },\n      () => {\n        this.#onProviderFailed();\n      },\n    );\n  }\n\n  #onProviderReady(): void {\n    this.#loading = false;\n    if (this.#destroyed) return;\n    this.#loaded = true;\n    if (this.#revokedWhileLoading) {\n      // Revoked while loading: wipe whatever the provider set up before using it again.\n      this.#revokedWhileLoading = false;\n      this.#guard(() => {\n        this.#provider.optOut();\n      });\n    }\n    if (this.#consent !== 'granted') return;\n    this.#status = 'ready';\n    this.#guard(() => {\n      this.#provider.optIn();\n    });\n    this.#applyIdentity();\n    const pending = this.#pending;\n    this.#pending = [];\n    for (const event of pending) this.#deliver(event);\n  }\n\n  #onProviderFailed(): void {\n    this.#loading = false;\n    this.#revokedWhileLoading = false;\n    if (this.#destroyed) return;\n    this.#pending = [];\n    if (this.#consent !== 'granted') return;\n    this.#status = 'unavailable';\n    this.#report('provider_unavailable', null);\n  }\n\n  #onAuthState(state: PixelumeAuthState): void {\n    const identity = identityFor(state);\n    if (identity === null) return;\n    this.#identity = identity;\n    this.#applyIdentity();\n  }\n\n  #applyIdentity(): void {\n    const identity = this.#identity;\n    if (identity === null || this.#status !== 'ready' || this.#consent !== 'granted') return;\n    this.#guard(() => {\n      this.#provider.identify(identity);\n    });\n  }\n\n  #emit(\n    name: string,\n    properties: PixelumeAnalyticsProperties | undefined,\n    extra: AnalyticsProperties,\n    protectedKeys: ReadonlySet<string> = NO_PROTECTED_KEYS,\n  ): void {\n    if (this.#destroyed || this.#config === null) return;\n    const keys = new Set([...protectedKeys, ...Object.keys(extra)]);\n    let sanitized: AnalyticsProperties;\n    try {\n      sanitized = sanitizeProperties(name, properties, keys, this.#reporter);\n    } catch {\n      // Hostile input (throwing getters, proxies): drop the event, never the game.\n      this.#report('invalid_property', name);\n      return;\n    }\n    if (this.#consent !== 'granted') return;\n    if (this.#status !== 'loading' && this.#status !== 'ready') return;\n    const event: AnalyticsEvent = {\n      name,\n      properties: { ...sanitized, ...extra, ...this.#metadata() },\n      timestamp: this.#now(),\n    };\n    if (this.#status === 'ready') {\n      this.#deliver(event);\n    } else if (this.#pending.length < MAX_PENDING_EVENTS) {\n      this.#pending.push({ ...event, delayed: true });\n    } else {\n      this.#report('queue_full', name);\n    }\n  }\n\n  #deliver(event: AnalyticsEvent): void {\n    this.#guard(() => {\n      this.#provider.capture(event);\n    }, event.name);\n  }\n\n  #metadata(): AnalyticsProperties {\n    const config = this.#config;\n    const metadata: AnalyticsProperties = {\n      game_id: config?.gameId ?? null,\n      sdk_version: SDK_VERSION,\n      platform: 'web',\n    };\n    if (config?.gameVersion != null) metadata.game_version = config.gameVersion;\n    if (this.#session !== null) metadata.session_id = this.#session.id;\n    return metadata;\n  }\n\n  #level(event: string, level: unknown): string | null {\n    const normalized = normalizeLevel(level);\n    if (normalized === null) this.#report('invalid_level', event);\n    return normalized;\n  }\n\n  #levelDuration(level: string): { duration_ms?: number } {\n    const levels = this.#session?.levels;\n    const startedAt = levels?.get(level);\n    if (levels === undefined || startedAt === undefined) return {};\n    levels.delete(level);\n    return { duration_ms: Math.max(0, Math.round(this.#now() - startedAt)) };\n  }\n\n  #onVisibilityChange(session: GameSession): void {\n    if (this.#session !== session || this.#visibility === null) return;\n    const now = this.#now();\n    if (this.#visibility.isVisible()) {\n      session.visibleSince ??= now;\n    } else if (session.visibleSince !== null) {\n      session.visibleMs += now - session.visibleSince;\n      session.visibleSince = null;\n    }\n  }\n\n  #closeSession(): void {\n    const session = this.#session;\n    this.#session = null;\n    session?.unsubscribeVisibility?.();\n  }\n\n  readonly #reporter: IssueReporter = (code, event, property = null) => {\n    this.#report(code, event, property);\n  };\n\n  #report(\n    code: PixelumeAnalyticsIssue['code'],\n    event: string | null,\n    property: string | null = null,\n  ): void {\n    const onIssue = this.#config?.onIssue;\n    if (!onIssue) return;\n    try {\n      onIssue(Object.freeze({ code, event, property }));\n    } catch {\n      // Diagnostics must never affect the game.\n    }\n  }\n\n  #guard(action: () => void, event: string | null = null): void {\n    try {\n      action();\n    } catch {\n      this.#report('provider_error', event);\n    }\n  }\n\n  #consentKey(): string {\n    return `pixelume.analytics.consent.${this.#config?.gameId ?? 'unconfigured'}`;\n  }\n\n  #storage(): PixelumeSessionStorage | null {\n    try {\n      if (this.#browser !== undefined) return this.#browser.persistentStorage ?? null;\n      return typeof globalThis.localStorage === 'undefined' ? null : globalThis.localStorage;\n    } catch {\n      // Blocked storage (privacy settings, sandboxed frames).\n      return null;\n    }\n  }\n\n  #readConsent(): boolean | null {\n    try {\n      const raw = this.#storage()?.getItem(this.#consentKey()) ?? null;\n      if (raw === null) return null;\n      const value: unknown = JSON.parse(raw);\n      if (\n        typeof value === 'object' &&\n        value !== null &&\n        (value as { version?: unknown }).version === CONSENT_VERSION &&\n        typeof (value as { granted?: unknown }).granted === 'boolean'\n      ) {\n        return (value as { granted: boolean }).granted;\n      }\n      return null;\n    } catch {\n      return null;\n    }\n  }\n\n  #writeConsent(granted: boolean): void {\n    try {\n      this.#storage()?.setItem(\n        this.#consentKey(),\n        JSON.stringify({ version: CONSENT_VERSION, granted, at: this.#now() }),\n      );\n    } catch {\n      // Not remembered: the game asks again on the next visit.\n    }\n  }\n}\n\nfunction createDefaultProvider(config: ResolvedAnalyticsConfig): AnalyticsProvider {\n  return new PostHogAnalyticsProvider({\n    token: config.provider.token,\n    host: config.provider.host,\n    gameId: config.gameId,\n  });\n}\n\n/** `null` while authentication is still settling: keep the previous identity. */\nfunction identityFor(state: PixelumeAuthState): AnalyticsIdentity | null {\n  if (state.status === 'authenticated') return { player: state.player.id, separate: false };\n  if (state.status === 'anonymous') {\n    return { player: null, separate: SEPARATING_REASONS.has(state.reason) };\n  }\n  return null;\n}\n\nfunction randomId(browser: PixelumeBrowserAdapter | undefined): string {\n  const globalCrypto = Reflect.get(globalThis, 'crypto') as Crypto | undefined;\n  const crypto = browser?.crypto ?? globalCrypto;\n  if (typeof crypto?.randomUUID === 'function') return crypto.randomUUID();\n  const bytes = new Uint8Array(16);\n  if (typeof crypto?.getRandomValues === 'function') {\n    crypto.getRandomValues(bytes);\n  } else {\n    for (let index = 0; index < bytes.length; index += 1) {\n      bytes[index] = Math.floor(Math.random() * 256);\n    }\n  }\n  return [...bytes].map((byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\n/** `document.visibilityState`, looked up lazily; `null` outside a browser. */\nfunction browserVisibilitySource(): VisibilitySource | null {\n  const document = Reflect.get(globalThis, 'document') as Document | undefined;\n  if (document === undefined || typeof document.addEventListener !== 'function') return null;\n  return {\n    isVisible: () => document.visibilityState !== 'hidden',\n    subscribe: (onChange) => {\n      document.addEventListener('visibilitychange', onChange);\n      return () => {\n        document.removeEventListener('visibilitychange', onChange);\n      };\n    },\n  };\n}\n"]}

package/dist/modules/analytics/AnalyticsProvider.d.ts

@@ -0,0 +1,51 @@
+import type { AnalyticsProperties } from './events.js';
+/** One validated, authorized event, ready for a transport. */
+export interface AnalyticsEvent {
+    readonly name: string;
+    readonly properties: AnalyticsProperties;
+    /** Local time (ms since epoch) when the game reported it. */
+    readonly timestamp: number;
+    /** Waited in the module's queue while the provider loaded: deliver with `timestamp`. */
+    readonly delayed?: true;
+}
+/**
+ * Identity the provider should use:
+ * - `player`: a signed-in Pixelume account (internal, non-sensitive id);
+ * - `null` with `separate: true`: the account is gone (logout, expiry): start a new anonymous id;
+ * - `null` with `separate: false`: a visitor; keep whatever anonymous id exists.
+ */
+export interface AnalyticsIdentity {
+    readonly player: string | null;
+    readonly separate: boolean;
+}
+/**
+ * Transport seam behind `pixelume.analytics`. The module validates events, applies consent and
+ * owns game sessions; a provider only delivers. Providers must never throw synchronously into the
+ * game: the module still guards every call. Internal: not part of the public API.
+ */
+export interface AnalyticsProvider {
+    readonly name: 'posthog' | 'none';
+    /** Prepares the transport. Called only after consent. Rejects when it cannot run here. */
+    load(): Promise<void>;
+    /** Consent granted (again): allow capture and persistence. */
+    optIn(): void;
+    /**
+     * Consent revoked: stop capturing, discard anything not yet sent and forget the analytics
+     * identifiers stored in the browser.
+     */
+    optOut(): void;
+    capture(event: AnalyticsEvent): void;
+    identify(identity: AnalyticsIdentity): void;
+    /** The owning client was destroyed: stop forwarding. Shared resources may stay for reuse. */
+    detach(): void;
+}
+/** Used when analytics is disabled or not configured: does nothing, loads nothing. */
+export declare class NoopAnalyticsProvider implements AnalyticsProvider {
+    readonly name = "none";
+    load(): Promise<void>;
+    optIn(): void;
+    optOut(): void;
+    capture(): void;
+    identify(): void;
+    detach(): void;
+}

package/dist/modules/analytics/AnalyticsProvider.js

@@ -0,0 +1,23 @@
+/** Used when analytics is disabled or not configured: does nothing, loads nothing. */
+export class NoopAnalyticsProvider {
+    name = 'none';
+    load() {
+        return Promise.resolve();
+    }
+    optIn() {
+        // Nothing to enable.
+    }
+    optOut() {
+        // Nothing stored.
+    }
+    capture() {
+        // Dropped by design.
+    }
+    identify() {
+        // No identity to keep.
+    }
+    detach() {
+        // Nothing to release.
+    }
+}
+//# sourceMappingURL=AnalyticsProvider.js.map

package/dist/modules/analytics/AnalyticsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.js","sourceRoot":"","sources":["../../../src/modules/analytics/AnalyticsProvider.ts"],"names":[],"mappings":"AA6CA,sFAAsF;AACtF,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAG,MAAM,CAAC;IAEvB,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,qBAAqB;IACvB,CAAC;IAED,MAAM;QACJ,kBAAkB;IACpB,CAAC;IAED,OAAO;QACL,qBAAqB;IACvB,CAAC;IAED,QAAQ;QACN,uBAAuB;IACzB,CAAC;IAED,MAAM;QACJ,sBAAsB;IACxB,CAAC;CACF","sourcesContent":["import type { AnalyticsProperties } from './events.js';\n\n/** One validated, authorized event, ready for a transport. */\nexport interface AnalyticsEvent {\n  readonly name: string;\n  readonly properties: AnalyticsProperties;\n  /** Local time (ms since epoch) when the game reported it. */\n  readonly timestamp: number;\n  /** Waited in the module's queue while the provider loaded: deliver with `timestamp`. */\n  readonly delayed?: true;\n}\n\n/**\n * Identity the provider should use:\n * - `player`: a signed-in Pixelume account (internal, non-sensitive id);\n * - `null` with `separate: true`: the account is gone (logout, expiry): start a new anonymous id;\n * - `null` with `separate: false`: a visitor; keep whatever anonymous id exists.\n */\nexport interface AnalyticsIdentity {\n  readonly player: string | null;\n  readonly separate: boolean;\n}\n\n/**\n * Transport seam behind `pixelume.analytics`. The module validates events, applies consent and\n * owns game sessions; a provider only delivers. Providers must never throw synchronously into the\n * game: the module still guards every call. Internal: not part of the public API.\n */\nexport interface AnalyticsProvider {\n  readonly name: 'posthog' | 'none';\n  /** Prepares the transport. Called only after consent. Rejects when it cannot run here. */\n  load(): Promise<void>;\n  /** Consent granted (again): allow capture and persistence. */\n  optIn(): void;\n  /**\n   * Consent revoked: stop capturing, discard anything not yet sent and forget the analytics\n   * identifiers stored in the browser.\n   */\n  optOut(): void;\n  capture(event: AnalyticsEvent): void;\n  identify(identity: AnalyticsIdentity): void;\n  /** The owning client was destroyed: stop forwarding. Shared resources may stay for reuse. */\n  detach(): void;\n}\n\n/** Used when analytics is disabled or not configured: does nothing, loads nothing. */\nexport class NoopAnalyticsProvider implements AnalyticsProvider {\n  readonly name = 'none';\n\n  load(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  optIn(): void {\n    // Nothing to enable.\n  }\n\n  optOut(): void {\n    // Nothing stored.\n  }\n\n  capture(): void {\n    // Dropped by design.\n  }\n\n  identify(): void {\n    // No identity to keep.\n  }\n\n  detach(): void {\n    // Nothing to release.\n  }\n}\n"]}

package/dist/modules/analytics/PostHogAnalyticsProvider.d.ts

@@ -0,0 +1,39 @@
+import type { PostHogConfig } from 'posthog-js/dist/module.slim.no-external.js';
+import type { AnalyticsEvent, AnalyticsIdentity, AnalyticsProvider } from './AnalyticsProvider.js';
+/** The part of the `posthog-js` instance API the provider relies on. */
+export interface PostHogInstanceLike {
+    init(token: string, config: Partial<PostHogConfig>): unknown;
+    capture(event: string, properties?: Record<string, unknown> | null, options?: {
+        readonly timestamp?: Date;
+    }): unknown;
+    identify(distinctId: string): void;
+    reset(resetDeviceId?: boolean): void;
+    opt_in_capturing(options?: {
+        readonly captureEventName?: false | null;
+    }): void;
+    opt_out_capturing(): void;
+    has_opted_out_capturing(): boolean;
+    get_distinct_id(): string;
+    get_property(key: string): unknown;
+}
+export interface PostHogModuleLike {
+    readonly PostHog: new () => PostHogInstanceLike;
+}
+export interface PostHogProviderOptions {
+    readonly token: string;
+    readonly host: string;
+    readonly gameId: string;
+    /** Test seam; defaults to a dynamic import of the slim, self-contained posthog-js bundle. */
+    readonly loadModule?: () => Promise<PostHogModuleLike>;
+}
+export declare class PostHogAnalyticsProvider implements AnalyticsProvider {
+    #private;
+    readonly name = "posthog";
+    constructor(options: PostHogProviderOptions);
+    load(): Promise<void>;
+    optIn(): void;
+    optOut(): void;
+    capture(event: AnalyticsEvent): void;
+    identify(identity: AnalyticsIdentity): void;
+    detach(): void;
+}