@helix3/helix-sdk 0.1.1-helix3.20

package/dist/multiplayer.js

@@ -0,0 +1,334 @@
+// Helix.multiplayer — the client half of HELIX multiplayer (plan pillar D). Wraps the official
+// Colyseus browser client (@colyseus/sdk, schema v4 — the renamed colyseus.js, paired with the 0.17
+// room server) so world authors never import it directly. Flow: POST the platform
+// /api/v1/instant-worlds/:worldId/join with the world_session token → { wsUrl, roomName, credential }
+// → Client.joinOrCreate(token) → a curated HelixRoom handle. The engine NetworkDriver consumes the
+// room state; this module owns the connect handshake, the throttled seq-tagged send path (D3), the
+// reconciliation buffer (D4), and teardown/reconnection wiring (D5).
+import { ClientMessageType, ServerMessageType, MESSAGE_RATE, CONTRACT_VERSION, } from './multiplayer-contract';
+// ~12s of inputs at 10Hz — generous reconciliation window; bounded so a missing server ack can't grow it forever.
+const INPUT_BUFFER_MAX = 120;
+// sessionStorage key (per world) for the colyseus reconnectionToken + its wsUrl. sessionStorage is per-tab and
+// SURVIVES A RELOAD but not a tab close — exactly the lifetime we want: a reload resumes the held seat; a new
+// tab / post-close start does a fresh join. This is what makes a reload RECONNECT (bypassing the room's
+// onAuth one-seat-per-account gate, which would otherwise reject the reload's fresh join during the grace
+// window) instead of falling back to single-player.
+const RECONNECT_KEY = (worldId) => `helix:mp:reconnect:${worldId}`;
+export class HelixMultiplayer {
+    host;
+    apiBaseUrl = null;
+    room = null;
+    callbacks = null;
+    seq = 0;
+    entitySeq = {}; // per-entity monotonic upload seq (4.6c owner-entity channel)
+    entityBatchSeq = 0; // per-connection monotonic batch seq (4.10 owner-entity batch channel)
+    pendingInput = null;
+    flushTimer = null;
+    // The clamped player-seat flush cadence (Hz), set on join from JoinRoomOptions.uploadHz. Default = stateHz (10).
+    effectiveUploadHz = MESSAGE_RATE.stateHz;
+    inputBuffer = [];
+    worldId = null; // the joined world (the reconnect-token storage key)
+    // A2 (spec §9) engine consumers of the reconnection acks — set via the handle's onStateAck/onEntityStateAck.
+    onStateAckCb = null;
+    onEntityStateAckCb = null;
+    // Opt-in netlog accumulators (1 s windows) — the SOURCE cadence feeding the engine interpolators: the throttled
+    // upload (flush) rate and the server patch-arrival rate. Off unless globalThis.__HELIX_NETLOG__ is a sink fn.
+    nlSend = { last: 0, count: 0, win: 0, maxGap: 0 };
+    nlPatch = { last: 0, count: 0, win: 0, maxGap: 0 };
+    constructor(host) {
+        this.host = host;
+    }
+    // Pin the platform API base once (local dev / staging where the token issuer isn't the live host).
+    configure(options) {
+        this.apiBaseUrl = options.apiBaseUrl.replace(/\/$/, '');
+    }
+    // The API base other SDK modules should use for direct platform calls (Helix.avatar): the pinned
+    // configure() value, else the world_session token's `iss`. Null → the caller treats it as "no API".
+    resolveApiBase(token) {
+        return this.apiBaseUrl ?? (token !== null ? issuerOf(token) : null);
+    }
+    // Join (or create) this world's room. worldId defaults to the current world. Requires login: a guest
+    // has no world_session and can't reach /join — multiplayer is logged-in only (single-player for guests).
+    async joinRoom(worldId, options = {}) {
+        if (!this.host.isInitialized())
+            throw new Error('Helix: call Helix.init() before Helix.multiplayer.joinRoom()');
+        if (this.room)
+            throw new Error('Helix.multiplayer: already in a room — call leave() first');
+        const token = this.host.getToken();
+        if (!token)
+            throw new Error('Helix.multiplayer: multiplayer requires login (no session) — call Helix.auth.requestLogin() first');
+        const id = worldId ?? this.host.getWorldId();
+        if (!id)
+            throw new Error('Helix.multiplayer: no world id — pass joinRoom(worldId) when running outside a HELIX shell');
+        const apiBase = options.apiBaseUrl?.replace(/\/$/, '') ?? this.resolveApiBase(token);
+        if (!apiBase)
+            throw new Error('Helix.multiplayer: cannot resolve the API base URL — call Helix.multiplayer.configure({ apiBaseUrl })');
+        const colyseus = (await import('@colyseus/sdk'));
+        // RESUME FIRST: on a reload, a seat persisted in sessionStorage is still held in the server's grace window —
+        // reconnect to it (resumes the same seat + its vars, bypassing onAuth) instead of a fresh join that onAuth
+        // would reject as a duplicate. On any failure (grace expired / clean despawn / new tab) fall back to /join.
+        let room = await this.tryReconnect(colyseus, id);
+        if (!room) {
+            const reservation = await this.requestJoin(apiBase, id, token);
+            const client = new colyseus.Client(reservation.wsUrl);
+            // buildId is the matchmaking filter (room filterBy(['buildId'])) — it groups players per active build.
+            // The room re-validates it against the verified credential in onAuth, so a spoofed value can't cross builds.
+            // contractVersion is the wire-protocol version baked into THIS bundle's SDK — onAuth logs a mismatch against
+            // the room's version (diagnostics for cross-version play) but never rejects, since old bundles are frozen.
+            room = await client.joinOrCreate(reservation.roomName, { token: reservation.credential, buildId: reservation.buildId, contractVersion: CONTRACT_VERSION });
+            this.persistReconnect(id, reservation.wsUrl, room.reconnectionToken);
+        }
+        this.worldId = id;
+        this.room = room;
+        this.callbacks = colyseus.getStateCallbacks(room);
+        // Resolve the player-seat upload cadence from the world's uploadHz tier, clamped to the contract's [10,20] range.
+        this.effectiveUploadHz = Math.max(MESSAGE_RATE.stateHz, Math.min(options.uploadHz ?? MESSAGE_RATE.stateHz, MESSAGE_RATE.maxUploadHz));
+        this.startFlush();
+        // A2 (spec §9) reconnection acks. Registered ONCE here (not in the handle) so the reconciliation buffer is
+        // pruned through the accepted seq whether or not a consumer subscribed — then the divergence correction is
+        // handed to the engine consumer (onStateAck/onEntityStateAck). Both fire only when the room's gate rejected
+        // an upload, so they're silent in steady state.
+        room.onMessage(ServerMessageType.StateAck, (p) => {
+            const ack = p;
+            this.inputBuffer = this.inputBuffer.filter((m) => m.seq > ack.seq);
+            this.onStateAckCb?.(ack);
+        });
+        room.onMessage(ServerMessageType.EntityStateAck, (p) => this.onEntityStateAckCb?.(p));
+        // netlog (opt-in): measure server patch-arrival cadence — the rate at which synced state changes feed the
+        // engine interpolators. A jittery patch rate here is the upstream cause of an interp starve/lapse.
+        room.onStateChange(() => this.nlOnPatch());
+        // Keep the persisted token fresh as colyseus rotates it (e.g. after an in-page auto-reconnect).
+        room.onReconnect(() => this.persistReconnect(id, this.reconnectWsUrl(id), room.reconnectionToken));
+        room.onLeave(() => this.teardown());
+        return this.makeHandle(room);
+    }
+    async requestJoin(apiBase, worldId, token) {
+        const res = await fetch(`${apiBase}/api/v1/instant-worlds/${encodeURIComponent(worldId)}/join`, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${token}` },
+        });
+        if (!res.ok) {
+            const detail = await res.json().catch(() => null);
+            const message = (detail && typeof detail.message === 'string' && detail.message) || `HTTP ${res.status}`;
+            throw new Error(`Helix.multiplayer: join failed — ${message}`);
+        }
+        return (await res.json());
+    }
+    makeHandle(room) {
+        const collection = (name) => {
+            if (!this.callbacks)
+                throw new Error('Helix.multiplayer: room not ready');
+            return this.callbacks(room.state)[name];
+        };
+        return {
+            roomId: room.roomId,
+            sessionId: room.sessionId,
+            effectiveUploadHz: this.effectiveUploadHz,
+            get state() {
+                return room.state;
+            },
+            onStateChange: (cb) => void room.onStateChange((s) => cb(s)),
+            onAdd: (name, cb) => void collection(name).onAdd((v, k) => cb(v, k), true),
+            onRemove: (name, cb) => void collection(name).onRemove((v, k) => cb(v, k)),
+            onMessage: (type, cb) => void room.onMessage(type, (p) => cb(p)),
+            onStateAck: (cb) => {
+                this.onStateAckCb = cb;
+            },
+            onEntityStateAck: (cb) => {
+                this.onEntityStateAckCb = cb;
+            },
+            sendState: (input) => {
+                this.pendingInput = input;
+            },
+            sendAbility: (ability, active) => room.send(ClientMessageType.Ability, { ability, active }),
+            sendAction: (name, args) => room.send(ClientMessageType.Action, { name, args }),
+            uploadEntity: (entityId, input) => {
+                const seq = (this.entitySeq[entityId] = (this.entitySeq[entityId] ?? 0) + 1);
+                // (P1.C1) forward the authority epoch (when the caller has it) so the server fence can drop a stale-era frame.
+                // networked-physics: a physics kind also carries velocity/angularVelocity/orientation (omitted for kinematic).
+                room.send(ClientMessageType.EntityState, {
+                    entity: entityId, seq, position: input.position, vars: input.vars,
+                    ...(input.velocity !== undefined ? { velocity: input.velocity } : {}),
+                    ...(input.angularVelocity !== undefined ? { angularVelocity: input.angularVelocity } : {}),
+                    ...(input.orientation !== undefined ? { orientation: input.orientation } : {}),
+                    ...(input.epoch !== undefined ? { epoch: input.epoch } : {}), tMs: performance.now(),
+                });
+            },
+            uploadEntities: (entities) => {
+                if (entities.length === 0)
+                    return;
+                const seq = ++this.entityBatchSeq;
+                const states = entities.map((e) => ({
+                    e: e.id,
+                    p: [e.position.x, e.position.y, e.position.z],
+                    // networked-physics: compact lv/av/q tuples for a physics kind (omitted when the caller passes none).
+                    ...(e.velocity !== undefined ? { lv: [e.velocity.x, e.velocity.y, e.velocity.z] } : {}),
+                    ...(e.angularVelocity !== undefined ? { av: [e.angularVelocity.x, e.angularVelocity.y, e.angularVelocity.z] } : {}),
+                    ...(e.orientation !== undefined ? { q: [e.orientation.x, e.orientation.y, e.orientation.z, e.orientation.w] } : {}),
+                    ...(e.vars !== undefined ? { v: e.vars } : {}),
+                    ...(e.epoch !== undefined ? { ep: e.epoch } : {}),
+                }));
+                room.send(ClientMessageType.EntityStateBatch, { seq, states, tMs: performance.now() });
+            },
+            pendingInputs: () => this.inputBuffer.slice(),
+            acknowledge: (seq) => {
+                this.inputBuffer = this.inputBuffer.filter((m) => m.seq > seq);
+            },
+            onDrop: (cb) => void room.onDrop(() => cb()),
+            onReconnect: (cb) => void room.onReconnect(() => cb()),
+            onLeave: (cb) => void room.onLeave((code) => cb(code)),
+            leave: () => this.leave(),
+        };
+    }
+    // D3: coalesce per-frame sendState calls and flush the latest at most stateHz times/second, tagging a
+    // monotonic seq. D4: buffer each sent state (bounded) so the engine can replay the unacknowledged tail.
+    startFlush() {
+        const periodMs = Math.round(1000 / this.effectiveUploadHz);
+        this.flushTimer = setInterval(() => this.flush(), periodMs);
+    }
+    flush() {
+        if (!this.pendingInput || !this.room)
+            return;
+        // tMs = the send-time stamp (monotonic performance.now()) the server sanitizes into PlayerState.posT for
+        // source-time interpolation. Stamped at flush ≈ sample time (pendingInput is overwritten every frame, so the
+        // latest is ~one frame old); consecutive tMs deltas track the real send cadence → jitter-free keyframe spacing.
+        const message = { ...this.pendingInput, seq: ++this.seq, tMs: performance.now() };
+        this.pendingInput = null;
+        this.room.send(ClientMessageType.State, message);
+        this.inputBuffer.push(message);
+        if (this.inputBuffer.length > INPUT_BUFFER_MAX)
+            this.inputBuffer.shift();
+        if (netSink())
+            this.nlTick(this.nlSend, `player-upload (this client → server state, ≤${this.effectiveUploadHz}Hz, ~${Math.round(1000 / this.effectiveUploadHz)}ms target)`);
+    }
+    // netlog: roll a 1 s window of an event cadence (send / patch) and emit count + max inter-event gap. Off (no
+    // sink) → not called. Diagnostic only.
+    nlOnPatch() {
+        if (netSink())
+            this.nlTick(this.nlPatch, 'server-patches (server → this client state deltas — the interp source)');
+    }
+    nlTick(a, label) {
+        const sink = netSink();
+        if (!sink)
+            return;
+        const now = performance.now();
+        if (a.last)
+            a.maxGap = Math.max(a.maxGap, now - a.last);
+        a.last = now;
+        a.count += 1;
+        if (!a.win)
+            a.win = now;
+        if (now - a.win >= 1000) {
+            sink(`sdk ${label}: ${a.count}/s gapMax=${a.maxGap | 0}ms`);
+            a.count = 0;
+            a.win = now;
+            a.maxGap = 0;
+        }
+    }
+    // D5 RECONNECTION (sessionStorage-backed): persist / read / clear the colyseus reconnectionToken + its wsUrl
+    // per world. sessionStorage is per-tab and survives a RELOAD but not a close — so a reload resumes the held
+    // seat (below) while a new tab does a fresh join. We deliberately do NOT consent-leave on tab unload anymore:
+    // letting the socket drop holds the seat in the server's grace window so a reload can RECONNECT to it (and
+    // keep its vars), instead of a fresh join that the room's one-seat-per-account onAuth gate would reject. A
+    // genuine close just lets the grace window expire (the seat despawns after RECONNECT_GRACE_SEC).
+    persistReconnect(worldId, wsUrl, reconnectionToken) {
+        if (typeof sessionStorage === 'undefined' || !wsUrl || !reconnectionToken)
+            return;
+        try {
+            sessionStorage.setItem(RECONNECT_KEY(worldId), JSON.stringify({ wsUrl, reconnectionToken }));
+        }
+        catch { /* storage unavailable */ }
+    }
+    readReconnect(worldId) {
+        if (typeof sessionStorage === 'undefined')
+            return null;
+        try {
+            const raw = sessionStorage.getItem(RECONNECT_KEY(worldId));
+            const v = raw ? JSON.parse(raw) : null;
+            return v?.wsUrl && v.reconnectionToken ? { wsUrl: v.wsUrl, reconnectionToken: v.reconnectionToken } : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    reconnectWsUrl(worldId) {
+        return this.readReconnect(worldId)?.wsUrl ?? '';
+    }
+    clearReconnect(worldId) {
+        if (typeof sessionStorage === 'undefined')
+            return;
+        try {
+            sessionStorage.removeItem(RECONNECT_KEY(worldId));
+        }
+        catch { /* ignore */ }
+    }
+    // Resume a grace-held seat (a reload). Returns the resumed room, or null to fall through to a fresh join
+    // (no saved token / grace expired / seat despawned / stale wsUrl — reconnect() rejects and we drop the token).
+    async tryReconnect(colyseus, worldId) {
+        const saved = this.readReconnect(worldId);
+        if (!saved)
+            return null;
+        try {
+            const client = new colyseus.Client(saved.wsUrl);
+            const room = await client.reconnect(saved.reconnectionToken);
+            this.persistReconnect(worldId, saved.wsUrl, room.reconnectionToken); // the token may rotate on resume
+            return room;
+        }
+        catch {
+            this.clearReconnect(worldId);
+            return null;
+        }
+    }
+    // Leave for good: consented (frees the seat immediately, no grace) + drop the saved token so we don't try to
+    // resume a seat we deliberately left. (A reload does NOT call this — it just unloads.)
+    async leave() {
+        const room = this.room;
+        if (this.worldId)
+            this.clearReconnect(this.worldId);
+        this.teardown();
+        if (room)
+            await room.leave(true);
+    }
+    // Reset in-memory state. Called on a drop too (onLeave) — it does NOT clear the saved reconnect token, so a
+    // later reload can still resume the grace-held seat.
+    teardown() {
+        if (this.flushTimer)
+            clearInterval(this.flushTimer);
+        this.flushTimer = null;
+        this.room = null;
+        this.callbacks = null;
+        this.pendingInput = null;
+        this.inputBuffer = [];
+        this.worldId = null;
+        this.seq = 0;
+        this.entitySeq = {};
+        this.entityBatchSeq = 0;
+        this.onStateAckCb = null;
+        this.onEntityStateAckCb = null;
+    }
+}
+// netlog sink lookup (opt-in): the host installs globalThis.__HELIX_NETLOG__ = (msg) => ... to turn on the
+// message/movement/interpolation diagnostics. Unset → a cheap typeof check, no logging. Shared shape with the
+// engine's TransformInterpolator sink so one toggle lights up the whole pipeline.
+function netSink() {
+    const s = globalThis.__HELIX_NETLOG__;
+    return typeof s === 'function' ? s : undefined;
+}
+// Read the `iss` claim from a JWT without verifying (the world_session issuer is the platform API
+// origin — the backend sets iss = PUBLIC_API_BASE_URL on every world_session). Verification isn't this
+// side's job; the room verifies the credential against JWKS. Returns null if there's no usable http(s)
+// issuer — in which case the world must configure({ apiBaseUrl }).
+function issuerOf(token) {
+    const segment = token.split('.')[1];
+    if (!segment)
+        return null;
+    try {
+        const json = atob(segment.replace(/-/g, '+').replace(/_/g, '/'));
+        const iss = JSON.parse(json).iss;
+        return typeof iss === 'string' && /^https?:\/\//.test(iss) ? iss.replace(/\/$/, '') : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=multiplayer.js.map

package/dist/multiplayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplayer.js","sourceRoot":"","sources":["../src/multiplayer.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,219 @@
+export declare const PROTOCOL_VERSION = 2;
+export type HelixUser = {
+    id: string;
+    username: string;
+    displayName: string | null;
+};
+export type HelixWorldContext = {
+    id: string;
+    slug: string;
+    title: string;
+};
+export type HelixSession = {
+    token: string;
+    expiresAt: string;
+    scopes: string[];
+    user: HelixUser;
+};
+export type DebugLogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+export type DebugLogEntry = {
+    level: DebugLogLevel;
+    args: string[];
+    t: number;
+};
+export type Balance = {
+    lix: number;
+    coins: number;
+    updatedAt?: string;
+};
+export type PurchaseStatus = 'Pending' | 'Granted' | 'Claimed' | 'AlreadyOwned' | 'InsufficientFunds' | 'MaxPerUserReached' | 'ProductInactive' | 'ProductNotFound' | 'NotInWorld' | 'Unauthorized' | 'RateLimited' | 'Cancelled' | 'Failed' | 'Timeout' | 'NotFound';
+export type PurchaseResult = {
+    status: PurchaseStatus;
+    completed: boolean;
+    reason?: string;
+    itemId?: string | null;
+    balanceAfterLix?: number;
+    priceLix?: number;
+    balanceLix?: number;
+    shortfallLix?: number;
+    ownedCount?: number;
+    maxPerUser?: number | null;
+};
+export type InventoryItem = {
+    id?: string;
+    itemId: string;
+    title: string;
+    kind?: string;
+    category?: string;
+    subCategory?: string | null;
+    quantity: number;
+    description?: string | null;
+    thumbnailUrl?: string | null;
+    equipped?: boolean;
+    avatarSlot?: string | null;
+    socket?: string | null;
+    metadata?: Record<string, unknown>;
+};
+export type EquippedAvatar = {
+    source: 'equipped' | 'auto' | 'default';
+    inventoryItemId?: string | null;
+    itemId: string | null;
+    glbUrl: string | null;
+    skeleton: string | null;
+};
+export type AvatarBaseShape = 'male' | 'female' | 'custom';
+export type AvatarLoadoutSlot = {
+    slot: string;
+    itemId: string;
+    inventoryItemId: string;
+    socket?: string | null;
+    inventoryItem: InventoryItem;
+};
+export type UniversalAvatarBody = {
+    mode: 'preset';
+    baseMeshId: 'helix:humanoid:male' | 'helix:humanoid:female';
+} | {
+    mode: 'customMesh';
+    avatarItemId: string;
+    inventoryItemId: string;
+    glbUrl: string | null;
+    skeleton: string | null;
+};
+export type AvatarLoadout = {
+    version: 1;
+    body: UniversalAvatarBody;
+    baseShape: AvatarBaseShape;
+    customAvatar: EquippedAvatar;
+    equippedSlots: AvatarLoadoutSlot[];
+    inventory: InventoryItem[];
+    updatedAt: string;
+};
+export type AvatarLoadoutPatch = {
+    baseShape?: AvatarBaseShape;
+    customAvatarInventoryItemId?: string | null;
+    equippedSlots?: Record<string, string | null>;
+};
+export type MarketplaceListing = {
+    itemId: string;
+    title: string;
+    description?: string | null;
+    priceLix: number;
+    isFree: boolean;
+    thumbnailUrl?: string | null;
+    kind?: string;
+    category?: string;
+};
+export type MarketplaceQuery = {
+    kind?: string;
+    category?: string;
+    search?: string;
+    limit?: number;
+};
+export type CameraAspect = 'portrait' | 'landscape' | 'square' | 'free';
+export type CameraSavePayload = {
+    bytes: ArrayBuffer;
+    contentType: string;
+    caption?: string;
+    aspect?: CameraAspect;
+};
+export type SavedPhoto = {
+    assetId: string;
+    url: string;
+    thumbnailUrl: string;
+    worldName: string;
+    createdAt: string;
+};
+export type PurchaseContext = {
+    ref: string;
+    title: string;
+    description: string | null;
+    thumbnailUrl: string | null;
+    priceLix: number;
+    isFree: boolean;
+    balanceLix: number;
+    balanceAfterLix: number;
+    owned: boolean;
+    ownedCount: number;
+    maxPerUser: number | null;
+    eligible: boolean;
+    eligibilityStatus: PurchaseStatus | null;
+};
+export type HelixRequestMethod = 'wallet.getBalance' | 'marketplace.purchase' | 'marketplace.getListings' | 'inventory.hasItem' | 'inventory.getQuantity' | 'inventory.getMyItems' | 'inventory.equipItem' | 'avatar.getEquipped' | 'avatar.getLoadout' | 'avatar.updateLoadout' | 'avatar.openCreator' | 'iwp.getContext' | 'iwp.getPurchase' | 'dataStore.get' | 'dataStore.set' | 'dataStore.delete' | 'dataStore.list' | 'camera.savePhoto';
+export type HelixEvent = 'balance-changed' | 'inventory-changed' | 'avatar-changed' | 'equipment-changed' | 'overlay-open' | 'overlay-closed';
+export type HelixNotificationKind = 'success' | 'failure' | 'notification' | 'message';
+export type HelixNotification = {
+    kind: HelixNotificationKind;
+    title: string;
+    message?: string;
+    timeoutMs?: number;
+    actionLabel?: string;
+    actionHref?: string;
+};
+export type HelixPromptState = 'default' | 'available' | 'locked' | 'busy';
+export type HelixDeviceFormFactor = 'phone' | 'tablet';
+export type HelixInteractionPrompt = {
+    id: string;
+    title: string;
+    description?: string;
+    input?: {
+        key?: string;
+        button?: string;
+        label?: string;
+    };
+    actionLabel?: string;
+    state?: HelixPromptState;
+    priority?: number;
+};
+export type WorldToShellMessage = {
+    type: 'helix:ready';
+    protocolVersion: number;
+} | {
+    type: 'helix:request-login';
+    requestId: string;
+} | {
+    type: 'helix:log';
+    entry: DebugLogEntry;
+} | {
+    type: 'helix:open-device';
+    form?: HelixDeviceFormFactor;
+} | {
+    type: 'helix:request';
+    requestId: string;
+    method: HelixRequestMethod;
+    payload?: unknown;
+} | {
+    type: 'helix:notify';
+    notification: HelixNotification;
+} | {
+    type: 'helix:set-interaction-prompt';
+    prompt: HelixInteractionPrompt;
+} | {
+    type: 'helix:clear-interaction-prompt';
+    promptId?: string;
+};
+export type ShellToWorldMessage = {
+    type: 'helix:init';
+    protocolVersion: number;
+    world: HelixWorldContext;
+    session: HelixSession | null;
+    debug?: boolean;
+} | {
+    type: 'helix:session';
+    session: HelixSession | null;
+} | {
+    type: 'helix:login-result';
+    requestId: string;
+    ok: boolean;
+    reason?: 'dismissed' | 'unavailable';
+} | {
+    type: 'helix:response';
+    requestId: string;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+} | {
+    type: 'helix:event';
+    event: HelixEvent;
+    data?: unknown;
+};
+export declare function isShellMessage(data: unknown): data is ShellToWorldMessage;

package/dist/protocol.js

@@ -0,0 +1,25 @@
+// postMessage protocol between a world (sandboxed iframe) and the HELIX shell
+// (the play page, or a local `helix dev` shell). This file IS the wire contract
+// — both sides import it; version any breaking change.
+//
+// v2 is additive on two fronts: (1) debug — helix:init gained `debug`, and helix:log
+// carries world logs to the shell when debug is on; (2) the shell-mediated platform
+// API (wallet / marketplace / inventory) on a generic request/response envelope plus
+// push events. The world SDK is a thin wrapper: it posts a request, the shell (which
+// holds the player's session and renders the purchase popup) settles with the backend
+// and posts the result.
+export const PROTOCOL_VERSION = 2;
+const SHELL_MESSAGE_TYPES = new Set([
+    'helix:init',
+    'helix:session',
+    'helix:login-result',
+    'helix:response',
+    'helix:event',
+]);
+export function isShellMessage(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        typeof data.type === 'string' &&
+        SHELL_MESSAGE_TYPES.has(data.type));
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,uDAAuD;AACvD,EAAE;AACF,qFAAqF;AACrF,oFAAoF;AACpF,qFAAqF;AACrF,qFAAqF;AACrF,sFAAsF;AACtF,wBAAwB;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAqTlC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,YAAY;IACZ,eAAe;IACf,oBAAoB;IACpB,gBAAgB;IAChB,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ;QACrD,mBAAmB,CAAC,GAAG,CAAE,IAAyB,CAAC,IAAI,CAAC,CACzD,CAAC;AACJ,CAAC"}