@arkadiuminc/sdk 2.77.0 → 2.78.0

package/dist/pkg/api/core/config-service.d.ts

@@ -14,8 +14,13 @@ export declare enum GameConfigProperty {
     hasGems = "hasGems",
     hasEagle = "hasEagle",
     slug = "slug",
-    gameServerSettings = "gameServerSettings"
+    gameServerSettings = "gameServerSettings",
+    debugMenu = "debugMenu"
 }
+export declare type DebugMenuConfig = {
+    isEnabled: boolean;
+    users: string[];
+};
 export declare type GameServerConnectionSettings = {
     host: string;
     port: string;
@@ -25,6 +30,7 @@ export declare type GameServerConnectionSettings = {
 export declare type GameServerSettings = Partial<Record<ApiEnv, GameServerConnectionSettings>>;
 export declare type DefaultGameConfig = {
     gameServerSettings?: GameServerSettings;
+    debugMenu?: DebugMenuConfig;
 };
 declare type GamePlatformFilterEntry = {
     games?: string[];
@@ -264,7 +270,24 @@ export declare const schema: {
                     };
                     additionalProperties: boolean;
                 };
+                debugMenu: {
+                    type: string;
+                    properties: {
+                        isEnabled: {
+                            type: string;
+                        };
+                        users: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                        };
+                    };
+                    required: string[];
+                    additionalProperties: boolean;
+                };
             };
+            required: string[];
             additionalProperties: boolean;
         };
     };

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

@@ -0,0 +1,4 @@
+/** localStorage / sessionStorage key used to persist SDK debug mode (value {@link DEBUG_SDK_STORAGE_ENABLED_VALUE}). */
+export declare const DEBUG_SDK_STORAGE_KEY = "DEBUG_SDK";
+/** Stored value that enables SDK debug mode. */
+export declare const DEBUG_SDK_STORAGE_ENABLED_VALUE = "*";

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

@@ -1,27 +1,28 @@
 import { ObserverFn } from '../utils/observable';
+import { IDebugMenuRuntimeDependencies } from '../debug';
 
-export interface DebugProvider {
-    isDebugMode?(): boolean;
-    setDebugMode?(isEnabled: boolean): void;
-    sendDebugEvent(type: string, ...args: any[]): void;
-    onDebugEvent?(observer: any): void;
-}
-export declare function isDebugMode(): boolean;
-export declare class DebugProviderArena implements DebugProvider {
+export declare class DebugProvider {
     private static _instance;
     private observers;
     private isDebug;
+    private debugMenuDependencies;
     private constructor();
-    static get Instance(): DebugProviderArena;
+    registerRpcHandlers(): void;
+    static get Instance(): DebugProvider;
+    private isArenaEnvironment;
+    private getStorage;
     private initDebugMode;
+    private syncWithLogger;
     isDebugMode(): boolean;
     setDebugMode(isEnabled: boolean): void;
+    private updateDebugMode;
+    private propagateDebugMode;
     sendDebugEvent(type: string, ...args: any[]): void;
     onDebugEvent(observer: ObserverFn<string>): void;
-}
-export declare class DebugProviderGame implements DebugProvider {
-    private static _instance;
-    private constructor();
-    static get Instance(): DebugProviderGame;
-    sendDebugEvent(type: string, ...args: any[]): void;
+    setDebugMenuDependencies(deps: IDebugMenuRuntimeDependencies): void;
+    private toggleDebugMenu;
+    showDebugMenu(): Promise<void>;
+    hideDebugMenu(): void;
+    isUser(): boolean;
+    private isUserAllowedDebugMenu;
 }

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

@@ -0,0 +1 @@
+export {};

package/dist/pkg/api/debug/debug-menu.d.ts

@@ -0,0 +1,14 @@
+import { IDebugMenuDependencies } from './types';
+
+export declare const DEBUG_MENU_ROOT_ID = "arkadium-sdk-debug-menu";
+export declare class DebugMenu {
+    private readonly deps;
+    private anchor;
+    constructor(deps: IDebugMenuDependencies);
+    mount(): void;
+    destroy(): void;
+}
+export declare function mountDebugMenu(deps: IDebugMenuDependencies): void;
+export declare function hideDebugMenu(): void;
+/** @internal */
+export declare function resetDebugMenuForTests(): void;

package/dist/pkg/api/debug/debug-menu.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/pkg/api/debug/index.d.ts

@@ -0,0 +1,2 @@
+export { mountDebugMenu, hideDebugMenu, DebugMenu, DEBUG_MENU_ROOT_ID, resetDebugMenuForTests, } from './debug-menu';
+export type { IDebugMenuDependencies, IDebugMenuRuntimeDependencies, DebugMenuPersistence, } from './types';

package/dist/pkg/api/debug/panels/local-storage-panel.d.ts

@@ -0,0 +1,3 @@
+import { DebugMenuPersistence } from '../types';
+
+export declare function createLocalStoragePanel(persistence: DebugMenuPersistence): HTMLElement;

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

@@ -0,0 +1,18 @@
+import { IPersistence } from '../features/persistence';
+
+export declare type DebugMenuPersistence = Pick<IPersistence, 'getLocalStorageItem' | 'setLocalStorageItem' | 'removeLocalStorageItem'> & {
+    listLocalStorageKeys(): Promise<string[]>;
+};
+export interface IDebugMenuDependencies {
+    gameSlug: string;
+    persistence: DebugMenuPersistence;
+}
+export interface IDebugMenuRuntimeDependencies {
+    config: {
+        getProperty(propertyName: string): Promise<unknown>;
+    };
+    persistence: DebugMenuPersistence;
+    host: {
+        getGameId(): Promise<string>;
+    };
+}

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

@@ -3,9 +3,9 @@ import { createStore } from '../../utils/observable';
 import { RpcProvider } from '../../core/rpc';
 import { IHost } from '../host';
 import { PersistenceArena } from '../persistence';
-import { UserProfile, AuthFormObserver, AuthStatusObserver } from './types';
+import { UserProfile, AuthFormObserver, AuthStatusObserver, UserIdentity } from './types';
 
-export type { UserProfile, UserProfileImage, AuthFormObserver, AuthStatusObserver } from './types';
+export type { UserProfile, UserProfileImage, AuthFormObserver, AuthStatusObserver, UserIdentity } from './types';
 interface UserProfileReaderContract {
     authStatus: ReturnType<typeof createStore<boolean>>;
     isUserAuthorized(): Promise<boolean>;
@@ -19,11 +19,6 @@ interface AuthUIManagerContract {
     onOpenAuthForm(observer: AuthFormObserver): void;
 }
 export declare function getAvatarLink(avatarName: string, extension: string): string;
-interface UserIdentity {
-    eagleId: string | undefined;
-    arkUserId: string;
-    arkSessionId: string;
-}
 export declare abstract class Auth {
     private backendApi;
     protected userProfileReader: UserProfileReaderContract;

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

@@ -24,3 +24,8 @@ export interface UserProfile {
 }
 export declare type AuthFormObserver = ObserverFn<boolean>;
 export declare type AuthStatusObserver = ObserverFn<boolean>;
+export interface UserIdentity {
+    eagleId: string | undefined;
+    arkUserId: string;
+    arkSessionId: string;
+}

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

@@ -9,6 +9,7 @@ export declare enum LogLevel {
 }
 export interface ILogger {
     readonly Level: typeof LogLevel;
+    syncWithDebugMode(isDebug: boolean): void;
     setLogPrefix(prefix: string): void;
     debug(...args: any[]): void;
     info(...args: any[]): void;
@@ -31,14 +32,10 @@ export declare class Logger implements ILogger {
     private logPrefix;
     private constructor();
     static get Instance(): ILogger;
-    /**
-     * Syncs the log level with DebugProvider's debug mode state.
-     * When DebugProvider is enabled → sets log level to DEBUG
-     * When DebugProvider is disabled → resets to WARN (unless user manually set a level)
-     */
-    private syncWithDebugMode;
     private shouldLog;
+    private logLevelName;
     private formatMessage;
+    syncWithDebugMode(isDebug: boolean): void;
     setLogPrefix(prefix: string): void;
     private log;
     debug(...args: any[]): void;
@@ -47,6 +44,7 @@ export declare class Logger implements ILogger {
     error(...args: any[]): void;
     setLogLevel(level: LogLevel): void;
     getLogLevel(): LogLevel;
+    getLogLevelName(): string;
     onLogEvent(observer: ObserverFn<{
         level: LogLevel;
         args: any[];

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

@@ -1,7 +1,7 @@
 import { RpcProvider } from '../../core/rpc';
 import { Backend } from '../backend/backend.api';
 import { IHost } from '../host';
-import { DebugProvider, DebugProviderArena } from '../../core/debug-provider';
+import { DebugProvider } from '../../core/debug-provider';
 import { IndexedDBStorage } from '../../utils/indexed-db-storage';
 
 declare type RemoteStorageValueType = string | object;
@@ -22,12 +22,13 @@ export declare class PersistenceArena implements IPersistence {
     /**
      * @internal
      */
-    constructor(rpcProvider?: RpcProvider, debugProvider?: DebugProviderArena, storage?: IndexedDBStorage);
+    constructor(rpcProvider?: RpcProvider, debugProvider?: DebugProvider, storage?: IndexedDBStorage);
     static get Instance(): PersistenceArena;
     getCookie(cookieName: string): Promise<string>;
     getLocalStorageItem(key: string): Promise<string | null>;
     setLocalStorageItem(key: string, value: string): Promise<void>;
     removeLocalStorageItem(key: string): Promise<void>;
+    listLocalStorageKeys(prefix: string): Promise<string[]>;
 }
 export declare class PersistenceGame implements IPersistence {
     private rpcProvider;
@@ -45,6 +46,7 @@ export declare class PersistenceGame implements IPersistence {
     getLocalStorageItem(key: string): Promise<string | null>;
     setLocalStorageItem(key: string, value: string): Promise<void>;
     removeLocalStorageItem(key: string): Promise<void>;
+    listLocalStorageKeys(): Promise<string[]>;
     private getCollection;
     private getRemoteToLocalStorageKey;
     private isRemoteStorageBlacklisted;

package/dist/pkg/api/ui/dom.d.ts

@@ -0,0 +1,12 @@
+export declare type DomStyle = Partial<CSSStyleDeclaration> | Record<string, string>;
+export declare type CreateElementOptions = {
+    id?: string;
+    className?: string;
+    text?: string;
+    html?: string;
+    attrs?: Record<string, string>;
+    styles?: DomStyle;
+    children?: (Node | string)[];
+};
+export declare function createElement<K extends keyof HTMLElementTagNameMap>(tag: K, options?: CreateElementOptions): HTMLElementTagNameMap[K];
+export declare function createButton(label: string, onClick: () => void, variant?: 'primary' | 'secondary' | 'danger'): HTMLButtonElement;

package/dist/pkg/api/ui/draggable-edge-anchor.d.ts

@@ -0,0 +1,33 @@
+export declare type SnapEdge = 'top' | 'right' | 'bottom' | 'left';
+export declare function getClosestSnapEdge(rect: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, viewportWidth: number, viewportHeight: number): SnapEdge;
+export declare function applySnapPosition(element: HTMLElement, edge: SnapEdge, rect: DOMRect, viewportWidth: number, viewportHeight: number, margin?: number): void;
+export declare type DraggableEdgeAnchorOptions = {
+    margin?: number;
+    initialEdge?: SnapEdge;
+};
+/**
+ * Wraps content in a fixed-position panel that can be dragged and snaps to the nearest viewport edge on release.
+ */
+export declare class DraggableEdgeAnchor {
+    private readonly content;
+    private readonly root;
+    private readonly dragHandle;
+    private readonly margin;
+    private dragOffsetX;
+    private dragOffsetY;
+    private isDragging;
+    private pointerId;
+    private resizeObserver;
+    constructor(content: HTMLElement, options?: DraggableEdgeAnchorOptions);
+    get element(): HTMLDivElement;
+    setDragHandle(handle: HTMLElement): void;
+    mount(parent?: HTMLElement): void;
+    destroy(): void;
+    snapToClosestEdge(): void;
+    private bindDragEvents;
+}

package/dist/pkg/api/ui/draggable-edge-anchor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/pkg/api/ui/index.d.ts

@@ -0,0 +1,5 @@
+export { createElement, createButton } from './dom';
+export type { CreateElementOptions, DomStyle } from './dom';
+export { DraggableEdgeAnchor, getClosestSnapEdge, applySnapPosition } from './draggable-edge-anchor';
+export type { SnapEdge, DraggableEdgeAnchorOptions } from './draggable-edge-anchor';
+export { debugPanelTheme, UI_FONT_FAMILY } from './theme';

package/dist/pkg/api/ui/theme.d.ts

@@ -0,0 +1,15 @@
+export declare const UI_FONT_FAMILY = "Arial, Helvetica, sans-serif";
+export declare const debugPanelTheme: {
+    readonly background: "#1a1d24";
+    readonly surface: "#252a33";
+    readonly border: "#3d4554";
+    readonly text: "#e8eaed";
+    readonly textMuted: "#9aa0a9";
+    readonly accent: "#4c8bf5";
+    readonly accentHover: "#3a7ae8";
+    readonly danger: "#e57373";
+    readonly radius: "8px";
+    readonly shadow: "0 8px 24px rgba(0, 0, 0, 0.45)";
+    readonly zIndex: 99999;
+    readonly margin: 12;
+};

package/dist/pkg/api/utils/indexed-db-storage.d.ts

@@ -15,4 +15,5 @@ export declare class IndexedDBStorage {
     getItem(key: string): Promise<string | null>;
     setItem(key: string, value: string): Promise<void>;
     removeItem(key: string): Promise<void>;
+    listKeysWithPrefix(prefix: string): Promise<string[]>;
 }

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

@@ -8,7 +8,7 @@ import { TimeoutTesterContract } from './api/core/timeout-tester';
 import { PersistenceArena } from './api/features/persistence';
 import { HostArena } from './api/features/host';
 import { WalletArena } from './api/features/wallet';
-import { DebugProviderArena } from './api/core/debug-provider';
+import { DebugProvider } from './api/core/debug-provider';
 import { SupportV1 } from './api/features/support-v1/support-v1';
 import { LeaderboardArena } from './api/features/leaderboard';
 import { FriendsArena } from './api/features/friends';
@@ -32,7 +32,7 @@ export declare class ArkadiumArenaSdk {
     private timeoutTester;
     persistence: PersistenceArena;
     private wallet;
-    debug: DebugProviderArena;
+    debug: DebugProvider;
     private supportV1;
     private leaderboard;
     friends: FriendsArena;
@@ -49,7 +49,7 @@ export declare class ArkadiumArenaSdk {
     $pingNotification: Observable<number>;
     version: string;
     config: ConfigService;
-    constructor(backendApi: Backend, host: HostArena, lifecycle: GameLifecycleArena, ads: AdsArena, auth: AuthArena, analytics: AnalyticsApiContract, timeoutTester: TimeoutTesterContract, persistence: PersistenceArena, wallet: WalletArena, debug: DebugProviderArena, supportV1: SupportV1, leaderboard: LeaderboardArena, friends: FriendsArena, notifications: NotificationsArena, chats: ChatArena, ratings: RatingsArena, tournaments: TournamentsArena, recorder: RecorderArena, logger: ILogger);
+    constructor(backendApi: Backend, host: HostArena, lifecycle: GameLifecycleArena, ads: AdsArena, auth: AuthArena, analytics: AnalyticsApiContract, timeoutTester: TimeoutTesterContract, persistence: PersistenceArena, wallet: WalletArena, debug: DebugProvider, supportV1: SupportV1, leaderboard: LeaderboardArena, friends: FriendsArena, notifications: NotificationsArena, chats: ChatArena, ratings: RatingsArena, tournaments: TournamentsArena, recorder: RecorderArena, logger: ILogger);
     setEnv(e: ApiEnv): void;
     initialize(env: ApiEnv, isGameSide: boolean, sessionStorage?: SessionStorageType | null): Promise<void>;
     private envDiscoverListener;

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

@@ -8,6 +8,7 @@ import { TimeoutTesterContract } from './api/core/timeout-tester';
 import { PersistenceGame } from './api/features/persistence';
 import { WalletGame } from './api/features/wallet';
 import { HostGame } from './api/features/host';
+import { DebugProvider } from './api/core/debug-provider';
 import { LeaderboardGame } from './api/features/leaderboard';
 import { TournamentsGame } from './api/features/tournaments';
 import { RecorderGame } from './api/features/recorder';
@@ -33,6 +34,7 @@ export declare class ArkadiumGameSdk {
     tournaments: TournamentsGame;
     logger: ILogger;
     config: ConfigGame;
+    debug: DebugProvider;
     constructor({ rpcProvider, backendApi, host, lifecycle, ads, auth, analytics, timeoutTester, persistence, wallet, leaderboard, tournaments, recorder, logger, config }: {
         rpcProvider: RpcProvider;
         backendApi: Backend;

package/package.json

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