@arkadiuminc/sdk 2.78.0 → 2.78.2

package/dist/pkg/api/core/debug-provider.d.ts

@@ -1,11 +1,21 @@
 import { ObserverFn } from '../utils/observable';
 import { IDebugMenuRuntimeDependencies } from '../debug';
 
+export declare enum AssignMode {
+    Normal = "normal",
+    Block = "block",
+    Override = "override"
+}
+export declare type DebugModeOptions = {
+    assignMode: AssignMode;
+    stopPropagation?: boolean;
+};
 export declare class DebugProvider {
     private static _instance;
     private observers;
     private isDebug;
     private debugMenuDependencies;
+    private assignMode;
     private constructor();
     registerRpcHandlers(): void;
     static get Instance(): DebugProvider;
@@ -14,9 +24,10 @@ export declare class DebugProvider {
     private initDebugMode;
     private syncWithLogger;
     isDebugMode(): boolean;
-    setDebugMode(isEnabled: boolean): void;
+    setDebugMode(isEnabled: boolean, { assignMode, stopPropagation }?: Partial<DebugModeOptions>): void;
     private updateDebugMode;
     private propagateDebugMode;
+    getAssignMode(): AssignMode;
     sendDebugEvent(type: string, ...args: any[]): void;
     onDebugEvent(observer: ObserverFn<string>): void;
     setDebugMenuDependencies(deps: IDebugMenuRuntimeDependencies): void;

package/dist/pkg/api/core/types.d.ts

@@ -0,0 +1,8 @@
+import { ApiEnv } from '../features/backend/backend.api';
+import { AssignMode } from './debug-provider';
+
+export interface EnvDiscovererResult {
+    env: ApiEnv;
+    isDebugMode: boolean;
+    debugAssignMode: AssignMode;
+}

package/dist/pkg/api/features/auth/index.d.ts

@@ -40,14 +40,30 @@ export declare class AuthArena extends Auth {
     private eagleId?;
     private arkUserId?;
     private arkUserIdPromise?;
-    private arkSessionId?;
     private userProfilePromise?;
     constructor(backendApi: Backend, host: IHost, rpcProvider: RpcProvider, persistence: PersistenceArena);
     getUserProfile(): Promise<UserProfile | null>;
-    getUserIdentity(): Promise<UserIdentity>;
+    getUserIdentity(updateSessionActivity?: boolean): Promise<UserIdentity>;
+    private getEagleId;
+    /**
+     * Returns a stable ark user id for this browser/device. The id is read from local persistence
+     * (`unique-arkadium-id`); if none exists, a new UUID is generated, stored, and reused on later
+     * calls. Cleared browser storage yields a new id. Cached in memory and deduped while in flight.
+     */
     private getOrCreateArkUserId;
     private resolveArkUserId;
+    /**
+     * Returns a persisted ark session id. State is stored in local persistence (`arkadium-ark-session`)
+     * (id, createdAt, lastActivityAt). A new id is generated when storage is missing or cleared,
+     * when the session is older than 24 hours, or — only when `updateSessionActivity` is true —
+     * when no analytics activity was recorded for 30 minutes. Pass `updateSessionActivity` from
+     * analytics sends; game-facing `getUserIdentity()` uses the default (read-only, no inactivity bump).
+     */
     private getOrCreateArkSessionId;
+    private loadArkSessionState;
+    private isArkSessionExpired;
+    private createArkSession;
+    private persistArkSessionState;
 }
 export declare class AuthGame extends Auth {
     private rpcProvider;

package/dist/pkg/arkadium-game-sdk.d.ts

@@ -14,6 +14,7 @@ import { TournamentsGame } from './api/features/tournaments';
 import { RecorderGame } from './api/features/recorder';
 import { ILogger } from './api/features/logger';
 import { ConfigGame } from './api/features/config';
+import { EnvDiscovererResult } from './api/core/types';
 
 export declare class ArkadiumGameSdk {
     version: string;
@@ -69,7 +70,7 @@ declare global {
     }
 }
 interface EnvDiscoverer {
-    discover(): Promise<ApiEnv>;
+    discover(): Promise<EnvDiscovererResult>;
 }
 export declare class GameApi {
     static version: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkadiuminc/sdk",
-  "version": "2.78.0",
+  "version": "2.78.2",
   "description": "",
   "keywords": [],
   "main": "dist/pkg/arkadium-sdk.umd.js",