@seekprotocol/game 0.0.0-stage → 0.1.1

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@seekprotocol/game",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "GameKit: the bridge between a minigame and the Seek app.",
+  "author": {
+    "name": "Seek Protocol",
+    "url": "https://www.seekprotocol.ai/en"
+  },
+  "homepage": "https://www.seekprotocol.ai/en",
+  "keywords": [
+    "seek",
+    "seekprotocol",
+    "quests",
+    "games"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  }
+}

package/perf.d.ts

@@ -0,0 +1,25 @@
+export interface PerfWindow {
+    requestAnimationFrame?: (fn: (t: number) => void) => number;
+    cancelAnimationFrame?: (id: number) => void;
+    performance?: {
+        now(): number;
+        memory?: {
+            usedJSHeapSize?: number;
+        };
+    };
+    document?: {
+        hidden?: boolean;
+    };
+}
+export interface PerfSample {
+    fps?: number;
+    jank?: number;
+    heap_mb?: number;
+}
+export interface PerfSampler {
+    sample(): PerfSample;
+    sinceLoad(): number | undefined;
+    stop(): void;
+}
+export declare const JANK_FRAME_MS = 50;
+export declare function createPerfSampler(win: PerfWindow): PerfSampler;

package/protocol.d.ts

@@ -0,0 +1,61 @@
+export declare const PROTOCOL: "seek-game";
+export declare const PROTOCOL_VERSION: 1;
+export declare const BRIDGE_VERSION = "0.1.0";
+export declare const MAX_MESSAGE_BYTES: number;
+export declare const STORAGE_MAX_BYTES: number;
+export declare const STORAGE_KEY: RegExp;
+export declare const TRACK_EVENT: RegExp;
+export declare const TRACK_PROP_KEY: RegExp;
+export declare const TRACK_MAX_PROPS = 8;
+export declare const TRACK_MAX_STRING = 64;
+export declare const MAX_TOKEN_LENGTH = 4096;
+export declare const PROXY_ORIGIN = "https://api.play.seekprotocol.ai";
+export declare const DEFAULT_HOST_ORIGINS: readonly string[];
+export type GameRequestType = "ready" | "finish" | "storage.get" | "storage.set" | "storage.remove" | "track" | "heartbeat" | "diagnostics";
+export type HostEventType = "pause" | "resume" | "exit";
+export interface GameRequest {
+    seek: typeof PROTOCOL;
+    v: typeof PROTOCOL_VERSION;
+    id: string;
+    type: GameRequestType;
+    payload: unknown;
+}
+export interface HostReply {
+    seek: typeof PROTOCOL;
+    v: typeof PROTOCOL_VERSION;
+    re: string;
+    ok: boolean;
+    payload?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface HostEvent {
+    seek: typeof PROTOCOL;
+    v: typeof PROTOCOL_VERSION;
+    event: HostEventType;
+}
+export interface ReadyPayload {
+    token: string;
+    transport?: "proxy" | "host";
+}
+export interface LaunchInfo {
+    runId: string;
+    seed: number;
+    lang: string;
+    sub: string;
+    game: string;
+    version: string;
+    expiresAt: number;
+}
+export declare const utf8Bytes: (s: string) => number;
+export declare function jsonBytes(value: unknown): number;
+export declare function isJsonValue(v: unknown, depth?: number): boolean;
+export declare const storageKeyProblem: (key: unknown) => string | null;
+export type TrackProps = Record<string, string | number | boolean>;
+export declare function trackProblem(event: unknown, props: unknown): string | null;
+export declare function finishProblem(r: unknown): string | null;
+export declare function parseHostMessage(data: unknown): HostReply | HostEvent | null;
+export declare function parseGameRequest(data: unknown): GameRequest | null;
+export declare function decodeLaunchToken(token: unknown): LaunchInfo | null;