@arkadiuminc/sdk 2.58.1 → 2.60.0

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

@@ -4,6 +4,7 @@ declare type RpcRequest = {
     payload: any[];
     executionTimeLimitMs?: number;
 };
+export declare const EXECUTION_TIME_NO_LIMIT = -1;
 declare class RpcPublisher {
     private rpcCallbacks;
     private target;

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

@@ -3,9 +3,17 @@ import { ApiEnv } from '../backend/backend.api';
 import { Auth } from '../auth/';
 import { VideoAdOptions } from './video-ad';
 import { BannerAdOptions, AdTypes } from './display-ad';
-import { GameLifecycleArena } from '../game-lifecycle/game-lifecycle.api';
+import { GameLifecycleArena, GameLifecycleGame } from '../game-lifecycle/game-lifecycle.api';
 import { IHost } from '../host';
 
+export declare type ShowInterstitialAdOptions = {
+    duration?: number;
+};
+export declare type ShowRewardAdOptions = {
+    duration?: number;
+    context?: 'core' | 'default';
+    data?: any;
+};
 /** @hidden */
 export interface AdsArena extends Ads, AdsArenaBanner {
 }
@@ -46,19 +54,16 @@ export declare class AdsArenaProvider implements AdsArena {
     showBannerAd(options: BannerAdOptions): any;
 }
 export declare class AdsGameProvider implements AdsGame {
-    bannerSizes: typeof AdTypes;
-    private interstitial;
-    private rewarded;
-    private banner;
-    constructor(rpcProvider: RpcProvider, env: ApiEnv, auth: Auth);
-    showInterstitialAd({ duration }?: {
-        duration?: number | undefined;
-    }): Promise<void>;
-    showRewardAd({ duration }?: {
-        duration?: number | undefined;
-    }): Promise<{
+    private readonly lifecycle;
+    readonly bannerSizes: typeof AdTypes;
+    private readonly interstitial;
+    private readonly rewarded;
+    private readonly banner;
+    constructor(rpcProvider: RpcProvider, env: ApiEnv, auth: Auth, lifecycle: GameLifecycleGame);
+    showInterstitialAd({ duration }?: ShowInterstitialAdOptions): Promise<void>;
+    showRewardAd({ duration, context, data }?: ShowRewardAdOptions): Promise<{
         value: number;
     }>;
-    showBannerAd(adId: string, dimensions: AdTypes[]): any;
+    showBannerAd(adId: string, dimensions: AdTypes[]): Promise<void>;
 }
 export {};

package/dist/pkg/api/features/game-lifecycle/game-lifecycle.api.d.ts

@@ -17,7 +17,10 @@ export declare enum LifecycleEvent {
     AD_REWARDED_REQUESTED = 12,
     AD_REWARDED_SHOWN = 13,
     LEVEL_START = 14,
-    LEVEL_END = 15
+    LEVEL_END = 15,
+    REDEEM_POWERUP = 16,
+    OPT_LOG_IN = 17,
+    REWARD_START = 18
 }
 declare type LifecycleFn = (event: LifecycleEvent, payload?: any) => void;
 declare global {
@@ -34,7 +37,7 @@ export declare class GameLifecycleArena {
     LifecycleEvent: typeof LifecycleEvent;
     constructor(rpcProvider: RpcProvider, host: IHost);
     setVirtualItemsApiProvider(provider: VirtualItemsApiProvider): void;
-    onEvent(event: LifecycleEvent, payload?: any): Promise<void>;
+    onEvent(event: LifecycleEvent, payload?: any): Promise<any>;
     dispatchEvent(event: LifecycleEvent): Promise<void>;
     subscribe(cb: LifecycleFn, override?: boolean): void;
     onFtueEvent(eventId: string): Promise<boolean>;
@@ -54,6 +57,7 @@ export declare class GameLifecycleGame {
     LifecycleEvent: typeof LifecycleEvent;
     constructor(rpcProvider: RpcProvider);
     private onEvent;
+    private getExecutionTimeLimitMs;
     dispatchEvent(event: LifecycleEvent, payload?: any): Promise<any>;
     onTestReady(): Promise<void>;
     onGameStart(): Promise<void>;
@@ -75,5 +79,11 @@ export declare class GameLifecycleGame {
     onLevelEnd(level: number): Promise<void>;
     registerEventCallback(event: LifecycleEvent, callback: () => void): void;
     onFtueEvent(eventId: string): Promise<boolean>;
+    onRedeemPowerup(data: any): Promise<any>;
+    onOptLogin(data: any): Promise<any>;
+    onRewardStart(data: any): Promise<any>;
+    private getPromiseForEvent;
+    private getCallbackType;
+    private setupPostMessageHandler;
 }
 export {};

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

@@ -1,5 +1,6 @@
 import { DebugProvider } from '../../core/debug-provider';
 import { RpcProvider } from '../../core/rpc';
+import { ObserverFn } from '../../utils/observable';
 
 export declare enum ArenaType {
     ARKCOM = "ARKCOM",
@@ -34,6 +35,11 @@ declare class WebEnvironmentDetails {
     constructor(siteName?: string, siteDomain?: string, referrer?: string, activeLocale?: string, devEnvironment?: string, darkMode?: boolean);
     clone(p: Partial<WebEnvironmentDetails>): WebEnvironmentDetails;
 }
+export declare type UrlState = {
+    url: 'string';
+    params?: URLSearchParams;
+};
+export declare type UrlStateUnsubscribeFn = () => void;
 /** @hidden */
 export declare class HostArena implements IHost {
     private rpcProvider;
@@ -41,6 +47,7 @@ export declare class HostArena implements IHost {
     private gameIdOverride;
     private data;
     private openRequest;
+    private readonly urlState;
     /**
      * @internal
      */
@@ -63,10 +70,14 @@ export declare class HostArena implements IHost {
         width: number;
         height: number;
     }>;
+    sendUrlState(urlState: UrlState): Promise<void>;
+    private updateUrlState;
+    subscribeToUrlStateChange(observer: ObserverFn<UrlState | undefined>): UrlStateUnsubscribeFn;
 }
 export declare class HostGame implements IHost {
     private rpcProvider;
     private purchaseFormState;
+    private readonly urlState;
     /**
      * @internal
      */
@@ -90,5 +101,8 @@ export declare class HostGame implements IHost {
         height: number;
     }>;
     getGameAssetsUrl(): string;
+    sendUrlState(urlState: UrlState): Promise<void>;
+    private updateUrlState;
+    subscribeToUrlStateChange(observer: ObserverFn<UrlState | undefined>): UrlStateUnsubscribeFn;
 }
 export {};

package/dist/pkg/api/utils/validate-input.d.ts

@@ -0,0 +1,42 @@
+export declare type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    expected: string;
+    received: string;
+};
+export declare type ArgumentValidator = (value: unknown) => ValidationResult;
+/**
+ * Schema primitives for defining object shapes. Use these as the single source of truth:
+ * define the schema once, derive the type with InferSchema, and pass to schema() for validation.
+ */
+export declare type SchemaPrimitive = 'string' | 'number' | 'boolean' | 'object' | 'array';
+/**
+ * Infers a TypeScript type from a schema object. Use with: type T = InferSchema<typeof mySchema>
+ */
+export declare type InferSchema<T> = T extends Record<string, SchemaPrimitive> ? {
+    [K in keyof T]: SchemaPrimitiveToType<T[K]>;
+} : never;
+declare type SchemaPrimitiveToType<P> = P extends 'string' ? string : P extends 'number' ? number : P extends 'boolean' ? boolean : P extends 'object' ? Record<string, unknown> : P extends 'array' ? unknown[] : never;
+/**
+ * Creates a validator from a schema object. The schema is the single source of truth:
+ * use InferSchema<typeof schema> for the type and schema(schema) for the decorator.
+ *
+ * @example
+ * const UrlStateSchema = { url: 'string' } as const;
+ * type UrlState = InferSchema<typeof UrlStateSchema>;
+ * @ValidateInput(schema(UrlStateSchema))
+ * private updateUrlState(urlState: UrlState): void { ... }
+ */
+export declare function schema<T extends Record<string, SchemaPrimitive>>(shape: T): ArgumentValidator;
+/**
+ * Decorator that validates method arguments before invocation.
+ * Pass one validator per argument in order.
+ * Throws an Error with details about which argument(s) failed validation.
+ *
+ * @example
+ * @ValidateInput(schema(UrlStateSchema))
+ * private updateUrlState(urlState: UrlState): void { ... }
+ */
+export declare function ValidateInput(...validators: ArgumentValidator[]): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export {};

package/package.json

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