@arkadiuminc/sdk 2.77.1 → 2.78.1

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.d.ts

@@ -1,13 +1,16 @@
 import { ObserverFn } from '../utils/observable';
+import { IDebugMenuRuntimeDependencies } from '../debug';
 
 export declare class DebugProvider {
     private static _instance;
     private observers;
     private isDebug;
+    private debugMenuDependencies;
     private constructor();
     registerRpcHandlers(): void;
     static get Instance(): DebugProvider;
     private isArenaEnvironment;
+    private getStorage;
     private initDebugMode;
     private syncWithLogger;
     isDebugMode(): boolean;
@@ -16,4 +19,10 @@ export declare class DebugProvider {
     private propagateDebugMode;
     sendDebugEvent(type: string, ...args: any[]): void;
     onDebugEvent(observer: ObserverFn<string>): void;
+    setDebugMenuDependencies(deps: IDebugMenuRuntimeDependencies): void;
+    private toggleDebugMenu;
+    showDebugMenu(): Promise<void>;
+    hideDebugMenu(): void;
+    isUser(): boolean;
+    private isUserAllowedDebugMenu;
 }

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;
@@ -45,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/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/persistence/index.d.ts

@@ -28,6 +28,7 @@ export declare class PersistenceArena implements IPersistence {
     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/package.json

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