@seekprotocol/game 0.1.1 → 0.1.3

package/README.md

@@ -12,7 +12,7 @@ import { createBridge } from '@seekprotocol/game';
 
 `seek-game.js` is the same bridge as one file, for a game without a bundler.
 
-- Store Connect: https://storeconnect.seekprotocol.ai
-- Seek Protocol: https://www.seekprotocol.ai/en
+The guide is in Store Connect, under Documentation, after you sign in:
+https://storeconnect.seekprotocol.ai
 
 Copyright (c) 2026 Seek Protocol. MIT licensed, see `LICENSE.md`: ship the bridge with your game freely.

package/bridge.d.ts

@@ -49,6 +49,7 @@ export interface FinishResult {
 export interface Bridge {
     ready(): Promise<LaunchInfo>;
     launch(): LaunchInfo;
+    t(key: string, vars?: Record<string, string | number>): string;
     finish(result: {
         score: number;
         seconds: number;

package/index.js

@@ -312,6 +312,26 @@ var TRACK_MAX_STRING = 64;
 var MAX_TOKEN_LENGTH = 4096;
 var PROXY_ORIGIN = "https://api.play.seekprotocol.ai";
 var DEFAULT_HOST_ORIGINS = ["https://storeconnect.seekprotocol.ai"];
+function readGameTexts(v) {
+    if (!isObj2(v))
+        return {};
+    const out = {};
+    let n = 0;
+    for (const [k, x] of Object.entries(v)) {
+        if (n >= 300)
+            break;
+        if (typeof x === "string" && x.length <= 2000 && /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,59}$/.test(k)) {
+            out[k] = x;
+            n++;
+        }
+    }
+    return out;
+}
+function fillText(text, vars) {
+    if (!vars)
+        return text;
+    return text.replace(/\{([A-Za-z][A-Za-z0-9_]{0,30})\}/g, (m, name) => Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : m);
+}
 var utf8Bytes = (s) => new TextEncoder().encode(s).byteLength;
 function jsonBytes(value) {
     try {
@@ -482,12 +502,13 @@ function decodeLaunchToken(token) {
     }
     if (!isObj2(c))
         return null;
-    const { run, seed, lang, sub, game, version, exp } = c;
+    const { run, seed, lang, sub, game, version, exp, variant, step } = c;
     if (typeof run !== "string" || typeof sub !== "string" || typeof game !== "string" || typeof version !== "string" || typeof lang !== "string")
         return null;
     if (typeof seed !== "number" || !Number.isSafeInteger(seed) || typeof exp !== "number")
         return null;
-    return { runId: run, seed, lang, sub, game, version, expiresAt: exp * 1000 };
+    const name = (v) => typeof v === "string" && /^[a-z0-9][a-z0-9-]{0,39}$/.test(v) ? v : null;
+    return { runId: run, seed, lang, sub, game, version, expiresAt: exp * 1000, variant: name(variant), step: name(step) };
 }
 var PRE_READY_ENTRIES = 20;
 function createCollector(opts) {
@@ -729,6 +750,7 @@ function createBridge(opts = {}) {
     let readyPromise = null;
     let launchInfo = null;
     let token = "";
+    let texts = {};
     let transport = "proxy";
     let finished = false;
     let tracked = 0;
@@ -930,6 +952,9 @@ function createBridge(opts = {}) {
         }
     }
     const bridge = {
+        t(key, vars) {
+            return fillText(texts[key] ?? key, vars);
+        },
         ready() {
             if (readyPromise)
                 return readyPromise;
@@ -940,6 +965,7 @@ function createBridge(opts = {}) {
                     throw new BridgeError("bad_launch", "The host sent no valid launch token.");
                 token = p.token;
                 transport = p.transport === "host" ? "host" : "proxy";
+                texts = readGameTexts(p.texts);
                 launchInfo = info;
                 if (vitals && !vitals.session) {
                     const readyMs = perf?.sinceLoad();
@@ -1044,4 +1070,4 @@ function createBridge(opts = {}) {
     };
     return bridge;
 }
-export { BRIDGE_VERSION, BridgeError, DEFAULT_HOST_ORIGINS, DEVICE_CLASSES, DIAG_BODY_MAX_BYTES, DIAG_LIMITS, END_REASONS, ERROR_SOURCES, FINGERPRINT_FRAMES, HOST_EVENTS, HOST_EVENT_TEXT, HOST_HANG_MS, HOST_READY_TIMEOUT_MS, JANK_FRAME_MS, LOG_LEVELS, MAX_MESSAGE_BYTES, MAX_TOKEN_LENGTH, OS_NAMES, PERF_RANGES, PRE_READY_ENTRIES, PROTOCOL, PROTOCOL_VERSION, PROXY_ORIGIN, STORAGE_KEY, STORAGE_MAX_BYTES, TRACK_EVENT, TRACK_MAX_PROPS, TRACK_MAX_STRING, TRACK_PER_LAUNCH, TRACK_PROP_KEY, boundData, cleanDiagnosticEntry, createBridge, createCollector, createHostWatchdog, createPerfSampler, decodeLaunchToken, fingerprint, fingerprintInput, finishProblem, frameKey, isCrashEntry, isFatalSource, isHostEvent, isJsonValue, isLogLevel, jsonBytes, launchContextProblem, normaliseContext, normaliseMessage, parseDiagnosticsBatch, parseGameRequest, parseHostMessage, parseStack, scrubData, scrubText, sessionIdOf, sha256HexOf, shortenGameUrls, storageKeyProblem, trackProblem, utf8Bytes };
+export { BRIDGE_VERSION, BridgeError, DEFAULT_HOST_ORIGINS, DEVICE_CLASSES, DIAG_BODY_MAX_BYTES, DIAG_LIMITS, END_REASONS, ERROR_SOURCES, FINGERPRINT_FRAMES, HOST_EVENTS, HOST_EVENT_TEXT, HOST_HANG_MS, HOST_READY_TIMEOUT_MS, JANK_FRAME_MS, LOG_LEVELS, MAX_MESSAGE_BYTES, MAX_TOKEN_LENGTH, OS_NAMES, PERF_RANGES, PRE_READY_ENTRIES, PROTOCOL, PROTOCOL_VERSION, PROXY_ORIGIN, STORAGE_KEY, STORAGE_MAX_BYTES, TRACK_EVENT, TRACK_MAX_PROPS, TRACK_MAX_STRING, TRACK_PER_LAUNCH, TRACK_PROP_KEY, boundData, cleanDiagnosticEntry, createBridge, createCollector, createHostWatchdog, createPerfSampler, decodeLaunchToken, fillText, fingerprint, fingerprintInput, finishProblem, frameKey, isCrashEntry, isFatalSource, isHostEvent, isJsonValue, isLogLevel, jsonBytes, launchContextProblem, normaliseContext, normaliseMessage, parseDiagnosticsBatch, parseGameRequest, parseHostMessage, parseStack, readGameTexts, scrubData, scrubText, sessionIdOf, sha256HexOf, shortenGameUrls, storageKeyProblem, trackProblem, utf8Bytes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seekprotocol/game",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "GameKit: the bridge between a minigame and the Seek app.",
   "author": {
     "name": "Seek Protocol",

package/protocol.d.ts

@@ -39,7 +39,10 @@ export interface HostEvent {
 export interface ReadyPayload {
     token: string;
     transport?: "proxy" | "host";
+    texts?: Record<string, string>;
 }
+export declare function readGameTexts(v: unknown): Record<string, string>;
+export declare function fillText(text: string, vars?: Record<string, string | number>): string;
 export interface LaunchInfo {
     runId: string;
     seed: number;
@@ -48,6 +51,8 @@ export interface LaunchInfo {
     game: string;
     version: string;
     expiresAt: number;
+    variant: string | null;
+    step: string | null;
 }
 export declare const utf8Bytes: (s: string) => number;
 export declare function jsonBytes(value: unknown): number;

package/seek-game.js

@@ -312,6 +312,26 @@ var TRACK_MAX_STRING = 64;
 var MAX_TOKEN_LENGTH = 4096;
 var PROXY_ORIGIN = "https://api.play.seekprotocol.ai";
 var DEFAULT_HOST_ORIGINS = ["https://storeconnect.seekprotocol.ai"];
+function readGameTexts(v) {
+    if (!isObj2(v))
+        return {};
+    const out = {};
+    let n = 0;
+    for (const [k, x] of Object.entries(v)) {
+        if (n >= 300)
+            break;
+        if (typeof x === "string" && x.length <= 2000 && /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,59}$/.test(k)) {
+            out[k] = x;
+            n++;
+        }
+    }
+    return out;
+}
+function fillText(text, vars) {
+    if (!vars)
+        return text;
+    return text.replace(/\{([A-Za-z][A-Za-z0-9_]{0,30})\}/g, (m, name) => Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : m);
+}
 var utf8Bytes = (s) => new TextEncoder().encode(s).byteLength;
 function jsonBytes(value) {
     try {
@@ -482,12 +502,13 @@ function decodeLaunchToken(token) {
     }
     if (!isObj2(c))
         return null;
-    const { run, seed, lang, sub, game, version, exp } = c;
+    const { run, seed, lang, sub, game, version, exp, variant, step } = c;
     if (typeof run !== "string" || typeof sub !== "string" || typeof game !== "string" || typeof version !== "string" || typeof lang !== "string")
         return null;
     if (typeof seed !== "number" || !Number.isSafeInteger(seed) || typeof exp !== "number")
         return null;
-    return { runId: run, seed, lang, sub, game, version, expiresAt: exp * 1000 };
+    const name = (v) => typeof v === "string" && /^[a-z0-9][a-z0-9-]{0,39}$/.test(v) ? v : null;
+    return { runId: run, seed, lang, sub, game, version, expiresAt: exp * 1000, variant: name(variant), step: name(step) };
 }
 var PRE_READY_ENTRIES = 20;
 function createCollector(opts) {
@@ -729,6 +750,7 @@ function createBridge(opts = {}) {
     let readyPromise = null;
     let launchInfo = null;
     let token = "";
+    let texts = {};
     let transport = "proxy";
     let finished = false;
     let tracked = 0;
@@ -930,6 +952,9 @@ function createBridge(opts = {}) {
         }
     }
     const bridge = {
+        t(key, vars) {
+            return fillText(texts[key] ?? key, vars);
+        },
         ready() {
             if (readyPromise)
                 return readyPromise;
@@ -940,6 +965,7 @@ function createBridge(opts = {}) {
                     throw new BridgeError("bad_launch", "The host sent no valid launch token.");
                 token = p.token;
                 transport = p.transport === "host" ? "host" : "proxy";
+                texts = readGameTexts(p.texts);
                 launchInfo = info;
                 if (vitals && !vitals.session) {
                     const readyMs = perf?.sinceLoad();
@@ -1044,4 +1070,4 @@ function createBridge(opts = {}) {
     };
     return bridge;
 }
-export { BRIDGE_VERSION, BridgeError, DEFAULT_HOST_ORIGINS, DEVICE_CLASSES, DIAG_BODY_MAX_BYTES, DIAG_LIMITS, END_REASONS, ERROR_SOURCES, FINGERPRINT_FRAMES, HOST_EVENTS, HOST_EVENT_TEXT, HOST_HANG_MS, HOST_READY_TIMEOUT_MS, JANK_FRAME_MS, LOG_LEVELS, MAX_MESSAGE_BYTES, MAX_TOKEN_LENGTH, OS_NAMES, PERF_RANGES, PRE_READY_ENTRIES, PROTOCOL, PROTOCOL_VERSION, PROXY_ORIGIN, STORAGE_KEY, STORAGE_MAX_BYTES, TRACK_EVENT, TRACK_MAX_PROPS, TRACK_MAX_STRING, TRACK_PER_LAUNCH, TRACK_PROP_KEY, boundData, cleanDiagnosticEntry, createBridge, createCollector, createHostWatchdog, createPerfSampler, decodeLaunchToken, fingerprint, fingerprintInput, finishProblem, frameKey, isCrashEntry, isFatalSource, isHostEvent, isJsonValue, isLogLevel, jsonBytes, launchContextProblem, normaliseContext, normaliseMessage, parseDiagnosticsBatch, parseGameRequest, parseHostMessage, parseStack, scrubData, scrubText, sessionIdOf, sha256HexOf, shortenGameUrls, storageKeyProblem, trackProblem, utf8Bytes };
+export { BRIDGE_VERSION, BridgeError, DEFAULT_HOST_ORIGINS, DEVICE_CLASSES, DIAG_BODY_MAX_BYTES, DIAG_LIMITS, END_REASONS, ERROR_SOURCES, FINGERPRINT_FRAMES, HOST_EVENTS, HOST_EVENT_TEXT, HOST_HANG_MS, HOST_READY_TIMEOUT_MS, JANK_FRAME_MS, LOG_LEVELS, MAX_MESSAGE_BYTES, MAX_TOKEN_LENGTH, OS_NAMES, PERF_RANGES, PRE_READY_ENTRIES, PROTOCOL, PROTOCOL_VERSION, PROXY_ORIGIN, STORAGE_KEY, STORAGE_MAX_BYTES, TRACK_EVENT, TRACK_MAX_PROPS, TRACK_MAX_STRING, TRACK_PER_LAUNCH, TRACK_PROP_KEY, boundData, cleanDiagnosticEntry, createBridge, createCollector, createHostWatchdog, createPerfSampler, decodeLaunchToken, fillText, fingerprint, fingerprintInput, finishProblem, frameKey, isCrashEntry, isFatalSource, isHostEvent, isJsonValue, isLogLevel, jsonBytes, launchContextProblem, normaliseContext, normaliseMessage, parseDiagnosticsBatch, parseGameRequest, parseHostMessage, parseStack, readGameTexts, scrubData, scrubText, sessionIdOf, sha256HexOf, shortenGameUrls, storageKeyProblem, trackProblem, utf8Bytes };