@arkadiuminc/sdk 2.59.0 → 2.60.1

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.59.0",
+  "version": "2.60.1",
   "description": "",
   "keywords": [],
   "main": "dist/pkg/arkadium-sdk.umd.js",