@crowdedkingdoms/crowdyjs 17.6.0 → 17.7.0-dev.1

package/dist/grid-program/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@crowdedkingdoms/crowdyjs/grid-program` — player-authored JS that uses the
+ * full CrowdyJS SDK inside one grid (DN-10 §5).
+ *
+ * The program runs in a sandboxed, network-less iframe or worker and builds
+ * its client with {@link createGridProgramClient}. The page runs
+ * {@link hostGridProgram}, which relays that client's traffic with a
+ * grid-scoped token, so the server confines the program to the grid no
+ * matter what its code does.
+ */
+export * from './protocol.js';
+export { createGridProgramClient, type GridProgramClient, } from './program.js';
+export { GridProgramHost, hostGridProgram, type GridProgramHostOptions, type HeldGridToken, } from './host.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/grid-program/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grid-program/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC"}

package/dist/grid-program/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@crowdedkingdoms/crowdyjs/grid-program` — player-authored JS that uses the
+ * full CrowdyJS SDK inside one grid (DN-10 §5).
+ *
+ * The program runs in a sandboxed, network-less iframe or worker and builds
+ * its client with {@link createGridProgramClient}. The page runs
+ * {@link hostGridProgram}, which relays that client's traffic with a
+ * grid-scoped token, so the server confines the program to the grid no
+ * matter what its code does.
+ */
+export * from './protocol.js';
+export { createGridProgramClient, } from './program.js';
+export { GridProgramHost, hostGridProgram, } from './host.js';

package/dist/grid-program/program.d.ts

@@ -0,0 +1,19 @@
+import { type CrowdyClient } from '../crowdy-client.js';
+import { type GridProgramPort } from './protocol.js';
+import type { GridScope, GridBox } from '../grid-scope.js';
+export interface GridProgramClient {
+    /** Real CrowdyJS; every request leaves through the host. */
+    client: CrowdyClient;
+    /** The grid, bound: `client.grid(appId, gridId, box)`. */
+    grid: GridScope;
+    appId: string;
+    gridId: string;
+    box: GridBox;
+}
+/**
+ * Build CrowdyJS inside a grid program. Waits for the host's `hello` (which
+ * names the app, the grid and its box), then returns a client whose HTTP and
+ * realtime ride the port. Call it once per program.
+ */
+export declare function createGridProgramClient(port: GridProgramPort): Promise<GridProgramClient>;
+//# sourceMappingURL=program.d.ts.map

package/dist/grid-program/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/grid-program/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAiI3D,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,MAAM,EAAE,YAAY,CAAC;IACrB,0DAA0D;IAC1D,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAgC5B"}

package/dist/grid-program/program.js

@@ -0,0 +1,154 @@
+import { createCrowdyClient } from '../crowdy-client.js';
+import { GRID_PROGRAM_ORIGIN, GRID_PROGRAM_PLACEHOLDER_TOKEN, GRID_PROGRAM_WS_PROTOCOL, } from './protocol.js';
+/**
+ * The program side of a grid program: real CrowdyJS whose network is a
+ * MessagePort. Everything it sends is relayed by `GridProgramHost` with a grid
+ * token; nothing here holds a credential.
+ */
+class PortDemux {
+    constructor(port) {
+        this.port = port;
+        this.nextId = 1;
+        this.http = new Map();
+        this.sockets = new Map();
+        this.hello = new Promise((resolve) => (this.helloResolve = resolve));
+        port.addEventListener('message', (event) => this.onMessage(event.data));
+        port.start?.();
+    }
+    id() {
+        return this.nextId++;
+    }
+    send(message) {
+        this.port.postMessage(message);
+    }
+    fetchVia(body) {
+        const id = this.id();
+        return new Promise((resolve, reject) => {
+            this.http.set(id, { resolve, reject });
+            this.send({ t: 'http', id, body });
+        });
+    }
+    onMessage(raw) {
+        if (!raw || typeof raw !== 'object')
+            return;
+        const msg = raw;
+        switch (msg.t) {
+            case 'hello':
+                this.helloResolve(msg);
+                return;
+            case 'http-result': {
+                const pending = this.http.get(msg.id);
+                if (!pending)
+                    return;
+                this.http.delete(msg.id);
+                pending.resolve(new Response(msg.body, {
+                    status: msg.status,
+                    headers: { 'content-type': 'application/json' },
+                }));
+                return;
+            }
+            case 'http-error': {
+                const pending = this.http.get(msg.id);
+                if (!pending)
+                    return;
+                this.http.delete(msg.id);
+                pending.reject(new TypeError(msg.message));
+                return;
+            }
+            case 'ws-opened':
+            case 'ws-message':
+            case 'ws-closed':
+            case 'ws-error':
+                this.sockets.get(msg.sid)?.receive(msg);
+                return;
+        }
+    }
+}
+class PortWebSocketBase {
+    constructor() {
+        this.readyState = 0;
+        this.protocol = '';
+        this.onopen = null;
+        this.onclose = null;
+        this.onerror = null;
+        this.onmessage = null;
+        this.sid = 0;
+    }
+    open(protocols) {
+        const list = protocols === undefined ? [] : Array.isArray(protocols) ? protocols : [protocols];
+        this.sid = this.demux.id();
+        this.demux.sockets.set(this.sid, this);
+        this.demux.send({ t: 'ws-open', sid: this.sid, protocols: list });
+    }
+    send(data) {
+        if (this.readyState !== 1)
+            throw new Error('WebSocket is not open');
+        this.demux.send({ t: 'ws-send', sid: this.sid, data: String(data) });
+    }
+    close(code, reason) {
+        if (this.readyState >= 2)
+            return;
+        this.readyState = 2;
+        this.demux.send({ t: 'ws-close', sid: this.sid, code, reason });
+    }
+    receive(msg) {
+        switch (msg.t) {
+            case 'ws-opened':
+                this.readyState = 1;
+                this.protocol = msg.protocol;
+                this.onopen?.({});
+                return;
+            case 'ws-message':
+                this.onmessage?.({ data: msg.data });
+                return;
+            case 'ws-error':
+                this.onerror?.(new Error(msg.message));
+                return;
+            case 'ws-closed':
+                this.readyState = 3;
+                this.demux.sockets.delete(this.sid);
+                this.onclose?.({ code: msg.code, reason: msg.reason, wasClean: msg.code === 1000 });
+                return;
+        }
+    }
+}
+PortWebSocketBase.CONNECTING = 0;
+PortWebSocketBase.OPEN = 1;
+PortWebSocketBase.CLOSING = 2;
+PortWebSocketBase.CLOSED = 3;
+/**
+ * Build CrowdyJS inside a grid program. Waits for the host's `hello` (which
+ * names the app, the grid and its box), then returns a client whose HTTP and
+ * realtime ride the port. Call it once per program.
+ */
+export async function createGridProgramClient(port) {
+    const demux = new PortDemux(port);
+    const hello = await demux.hello;
+    class PortWebSocket extends PortWebSocketBase {
+        constructor(_url, protocols) {
+            super();
+            this.demux = demux;
+            this.open(protocols ?? GRID_PROGRAM_WS_PROTOCOL);
+        }
+    }
+    const portFetch = ((_input, init) => demux.fetchVia(String(init?.body ?? '')));
+    const client = createCrowdyClient({
+        httpUrl: GRID_PROGRAM_ORIGIN,
+        wsUrl: GRID_PROGRAM_ORIGIN.replace(/^https/, 'wss'),
+        fetch: portFetch,
+        embeddedHost: false,
+        realtime: { webSocketImpl: PortWebSocket, binaryTransport: false },
+    });
+    client.session.setToken(GRID_PROGRAM_PLACEHOLDER_TOKEN, { persist: false });
+    const box = {
+        low: { x: BigInt(hello.low.x), y: BigInt(hello.low.y), z: BigInt(hello.low.z) },
+        high: { x: BigInt(hello.high.x), y: BigInt(hello.high.y), z: BigInt(hello.high.z) },
+    };
+    return {
+        client,
+        grid: client.grid(hello.appId, hello.gridId, box),
+        appId: hello.appId,
+        gridId: hello.gridId,
+        box,
+    };
+}

package/dist/grid-program/protocol.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The MessagePort protocol between a GRID PROGRAM (player-authored JS running
+ * in a sandboxed, network-less iframe or worker) and the page that hosts it.
+ *
+ * The program runs real CrowdyJS. Its `fetch` and `WebSocket` are shims that
+ * turn every request into a message on this port; the host relays them to
+ * ck-api with a GRID-SCOPED token the program never sees. The program's reach
+ * is therefore exactly the grid token's reach (DN-10 §5), however hostile its
+ * code is.
+ */
+export declare const GRID_PROGRAM_PROTOCOL_VERSION: 1;
+/** Program -> host. */
+export type GridProgramRequest = {
+    t: 'http';
+    id: number;
+    body: string;
+} | {
+    t: 'ws-open';
+    sid: number;
+    protocols: string[];
+} | {
+    t: 'ws-send';
+    sid: number;
+    data: string;
+} | {
+    t: 'ws-close';
+    sid: number;
+    code?: number;
+    reason?: string;
+};
+/** Host -> program. */
+export type GridProgramReply = {
+    t: 'hello';
+    v: typeof GRID_PROGRAM_PROTOCOL_VERSION;
+    appId: string;
+    gridId: string;
+    low: {
+        x: string;
+        y: string;
+        z: string;
+    };
+    high: {
+        x: string;
+        y: string;
+        z: string;
+    };
+} | {
+    t: 'http-result';
+    id: number;
+    status: number;
+    body: string;
+} | {
+    t: 'http-error';
+    id: number;
+    message: string;
+} | {
+    t: 'ws-opened';
+    sid: number;
+    protocol: string;
+} | {
+    t: 'ws-message';
+    sid: number;
+    data: string;
+} | {
+    t: 'ws-closed';
+    sid: number;
+    code: number;
+    reason: string;
+} | {
+    t: 'ws-error';
+    sid: number;
+    message: string;
+};
+/** The subset of MessagePort both sides use (a Worker or MessagePort fits). */
+export interface GridProgramPort {
+    postMessage(message: unknown): void;
+    addEventListener(type: 'message', listener: (event: MessageEvent<unknown>) => void): void;
+    removeEventListener(type: 'message', listener: (event: MessageEvent<unknown>) => void): void;
+    start?(): void;
+}
+/** The only WebSocket subprotocol a grid program may speak. */
+export declare const GRID_PROGRAM_WS_PROTOCOL = "graphql-transport-ws";
+/** Placeholder origin the program's client is pointed at; never dialed. */
+export declare const GRID_PROGRAM_ORIGIN = "https://grid-program.invalid";
+/** Placeholder bearer the program's client sends; the host replaces it. */
+export declare const GRID_PROGRAM_PLACEHOLDER_TOKEN = "grid-program";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/grid-program/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/grid-program/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,EAAG,CAAU,CAAC;AAExD,uBAAuB;AACvB,MAAM,MAAM,kBAAkB,GAC1B;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAClD;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,CAAC,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,uBAAuB;AACvB,MAAM,MAAM,gBAAgB,GACxB;IACE,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,6BAA6B,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,GACD;IAAE,CAAC,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,CAAC,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,CAAC,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,CAAC,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,CAAC,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,CAAC,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,mBAAmB,CACjB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,iBAAiB,CAAC"}

package/dist/grid-program/protocol.js

@@ -0,0 +1,17 @@
+/**
+ * The MessagePort protocol between a GRID PROGRAM (player-authored JS running
+ * in a sandboxed, network-less iframe or worker) and the page that hosts it.
+ *
+ * The program runs real CrowdyJS. Its `fetch` and `WebSocket` are shims that
+ * turn every request into a message on this port; the host relays them to
+ * ck-api with a GRID-SCOPED token the program never sees. The program's reach
+ * is therefore exactly the grid token's reach (DN-10 §5), however hostile its
+ * code is.
+ */
+export const GRID_PROGRAM_PROTOCOL_VERSION = 1;
+/** The only WebSocket subprotocol a grid program may speak. */
+export const GRID_PROGRAM_WS_PROTOCOL = 'graphql-transport-ws';
+/** Placeholder origin the program's client is pointed at; never dialed. */
+export const GRID_PROGRAM_ORIGIN = 'https://grid-program.invalid';
+/** Placeholder bearer the program's client sends; the host replaces it. */
+export const GRID_PROGRAM_PLACEHOLDER_TOKEN = 'grid-program';

package/dist/grid-scope.d.ts

@@ -0,0 +1,296 @@
+import type { GridsAPI, GridChannel, GridToken } from './domains/grids.js';
+import type { GameModelAPI } from './domains/gameModel.js';
+import type { PlayerModelAPI } from './domains/playerModel.js';
+import type { PlayerComputeAPI } from './domains/playerCompute.js';
+import type { ChannelsAPI } from './domains/channels.js';
+import type { UdpAPI } from './domains/udp.js';
+import type { MarketplaceAPI } from './domains/marketplace.js';
+import type { GameModelCreateSessionMutationVariables, PlayerComputeDeployMutationVariables, PlayerModelCreateContainerMutationVariables, PlayerModelSetPropertyMutationVariables } from './generated/graphql.js';
+/** A chunk address as CrowdyJS passes it on the wire (decimal strings). */
+export interface GridChunk {
+    x: string | number | bigint;
+    y: string | number | bigint;
+    z: string | number | bigint;
+}
+export interface GridBox {
+    low: {
+        x: bigint;
+        y: bigint;
+        z: bigint;
+    };
+    high: {
+        x: bigint;
+        y: bigint;
+        z: bigint;
+    };
+}
+/** The domain clients a GridScope binds (a CrowdyClient satisfies this). */
+export interface GridScopeClients {
+    grids: GridsAPI;
+    gameModel: GameModelAPI;
+    playerModel: PlayerModelAPI;
+    playerCompute: PlayerComputeAPI;
+    channels: ChannelsAPI;
+    udp: UdpAPI;
+    marketplace: MarketplaceAPI;
+}
+/** Thrown locally, before any request, when a call would leave the grid. */
+export declare class GridScopeError extends Error {
+    constructor(message: string);
+}
+/**
+ * One grid, bound once (DN-10: grid scope is app scope intersected with grid
+ * confinement). Every method is the ordinary CrowdyJS call with the app and
+ * grid filled in, and — where the call addresses the world — a local check
+ * that it stays in the grid. The local check is UX; the server enforces the
+ * same rule for grid tokens, and grid-owner rules for everyone.
+ *
+ * Get one from `client.grid(appId, gridId)`. The box is learned from the
+ * first grid token minted (or passed in); world helpers need it.
+ */
+export declare class GridScope {
+    private readonly clients;
+    readonly appId: string;
+    readonly gridId: string;
+    private box;
+    constructor(clients: GridScopeClients, appId: string, gridId: string, box?: GridBox);
+    /** The grid box, when known (after `mintToken`, or when passed in). */
+    get bounds(): GridBox | null;
+    /** Whether a chunk is inside the grid. False while the box is unknown. */
+    contains(chunk: GridChunk): boolean;
+    /** Throws GridScopeError unless the chunk is inside the (known) grid box. */
+    assertContains(chunk: GridChunk): void;
+    /** Mint a grid-scoped token for this grid; also learns the box. */
+    mintToken(ttlSeconds?: number): Promise<GridToken>;
+    /** Grid channels: the only channels this grid's modules may post into. */
+    readonly channels: {
+        list: () => Promise<GridChannel[]>;
+        create: (name: string, options?: {
+            description?: string;
+            membershipPolicy?: string;
+            membersCanSend?: boolean;
+        }) => Promise<{
+            __typename?: "Group";
+            groupId: string;
+            appId: string;
+            groupType: string;
+            name: string;
+            description: string | null;
+            ownerUserId: string | null;
+            membershipPolicy: string;
+            status: string;
+            defaultRoleId: string | null;
+            gridId: string | null;
+            createdAt: string;
+        }>;
+        join: (channelId: string) => Promise<{
+            __typename?: "GroupMember";
+            groupMemberId: string;
+            groupId: string;
+            userId: string;
+            status: string;
+            createdAt: string;
+            roles: Array<{
+                __typename?: "GroupRole";
+                groupRoleId: string;
+                roleName: string;
+                rank: number;
+                isSystem: boolean;
+                permissions: Array<string>;
+            }>;
+        }>;
+        leave: (channelId: string) => Promise<boolean>;
+        send: (channelId: string, uuid: string, payloadBase64: string) => Promise<boolean>;
+    };
+    /** Sessions hosted inside this grid (games within the game). */
+    readonly sessions: {
+        list: (options?: {
+            status?: string;
+            limit?: number;
+        }) => Promise<{
+            __typename?: "GmSession";
+            sessionId: string;
+            appId: string;
+            name: string | null;
+            status: string;
+            createdByUserId: string | null;
+            currentTurnUserId: string | null;
+            metadataJson: string;
+            admission: string;
+            maxParticipants: number | null;
+            participantCount: number;
+            hostUserId: string | null;
+            hostTerm: number;
+            revision: string;
+            endedAt: string | null;
+            endReason: string | null;
+            createdAt: string;
+            presence: string;
+            gridId: string | null;
+            seededContainerCount: number | null;
+        }[]>;
+        create: (input?: Omit<GameModelCreateSessionMutationVariables["input"], "appId" | "gridId">) => Promise<{
+            __typename?: "GmSession";
+            sessionId: string;
+            appId: string;
+            name: string | null;
+            status: string;
+            createdByUserId: string | null;
+            currentTurnUserId: string | null;
+            metadataJson: string;
+            admission: string;
+            maxParticipants: number | null;
+            participantCount: number;
+            hostUserId: string | null;
+            hostTerm: number;
+            revision: string;
+            endedAt: string | null;
+            endReason: string | null;
+            createdAt: string;
+            presence: string;
+            gridId: string | null;
+            seededContainerCount: number | null;
+        }>;
+        join: (sessionId: string, options?: {
+            role?: string;
+            actorUuid?: string;
+        }) => Promise<{
+            __typename?: "GmSessionParticipant";
+            sessionId: string;
+            userId: string;
+            role: string;
+            state: string;
+            incarnation: number;
+            actorUuid: string | null;
+            joinedAt: string;
+            leftAt: string | null;
+            leftReason: string | null;
+        }>;
+        leave: (sessionId: string, incarnation: number) => Promise<{
+            __typename?: "GmSessionParticipant";
+            sessionId: string;
+            userId: string;
+            role: string;
+            state: string;
+            incarnation: number;
+            actorUuid: string | null;
+            joinedAt: string;
+            leftAt: string | null;
+            leftReason: string | null;
+        }>;
+    };
+    /** The player-tier Game Model of this grid. */
+    readonly model: {
+        containers: () => Promise<{
+            __typename?: "PlayerModelContainer";
+            containerId: string;
+            appId: string;
+            gridId: string;
+            ownerUserId: string;
+            typeKey: string;
+            displayName: string | null;
+            stateJson: string;
+            propertiesJson: string;
+            createdAt: string;
+            updatedAt: string;
+        }[]>;
+        container: (containerId: string) => Promise<{
+            __typename?: "PlayerModelContainer";
+            containerId: string;
+            appId: string;
+            gridId: string;
+            ownerUserId: string;
+            typeKey: string;
+            displayName: string | null;
+            stateJson: string;
+            propertiesJson: string;
+            createdAt: string;
+            updatedAt: string;
+        } | null>;
+        create: (input: Omit<PlayerModelCreateContainerMutationVariables["input"], "appId" | "gridId">) => Promise<{
+            __typename?: "PlayerModelContainer";
+            containerId: string;
+            appId: string;
+            gridId: string;
+            ownerUserId: string;
+            typeKey: string;
+            displayName: string | null;
+            stateJson: string;
+            propertiesJson: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        set: (input: Omit<PlayerModelSetPropertyMutationVariables["input"], "appId" | "gridId">) => Promise<{
+            __typename?: "PlayerModelContainer";
+            containerId: string;
+            appId: string;
+            gridId: string;
+            ownerUserId: string;
+            typeKey: string;
+            displayName: string | null;
+            stateJson: string;
+            propertiesJson: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        delete: (containerId: string) => Promise<boolean>;
+    };
+    /** Player compute on this grid (SERVER/CLIENT modules). */
+    readonly compute: {
+        deploy: (input: Omit<PlayerComputeDeployMutationVariables["input"], "appId" | "gridId">) => Promise<{
+            __typename?: "PlayerWasmModuleVersion";
+            versionId: string;
+            moduleId: string;
+            versionNo: number;
+            target: import("./index.js").PlayerComputeTarget;
+            sourceFilesJson: string | null;
+            openSource: boolean;
+            compileStatus: string;
+            compileLog: string | null;
+            compiledSizeBytes: string | null;
+            projectId: string | null;
+            sourceRevision: string | null;
+            githubCommitSha: string | null;
+            createdAt: string;
+        }>;
+        invoke: (moduleName: string, exportName: string, params?: unknown) => Promise<{
+            __typename?: "PlayerComputeInvokeResult";
+            resultBase64: string;
+            resultJson: string | null;
+            fuelUsed: string;
+            durationUs: number;
+        }>;
+        clientMods: () => Promise<{
+            __typename?: "GridClientMod";
+            attachmentId: string;
+            listingId: string | null;
+            listingName: string;
+            versionId: string | null;
+            sourceKind: string;
+            authorKind: import("./generated/graphql.js").PlayerCodeOwnerKind;
+            authorRef: string;
+            serverVersionId: string | null;
+            clientVersionId: string | null;
+            clientArtifactHash: string;
+            gridId: string;
+            capabilitySummaryJson: string;
+            capabilityHash: string;
+            authorCapabilitySummaryJson: string;
+            authorCapabilityHash: string;
+            callerConsented: boolean;
+            callerTrustsAuthor: boolean;
+        }[]>;
+    };
+    /**
+     * Replication that ORIGINATES in the grid. Each send checks its chunk
+     * locally, then goes out as the ordinary udp call; reach still follows
+     * `distance`.
+     */
+    readonly send: {
+        actorUpdate: (input: Omit<Parameters<UdpAPI["sendActorUpdate"]>[0], "appId">) => Promise<boolean>;
+        voxelUpdate: (input: Omit<Parameters<UdpAPI["sendVoxelUpdate"]>[0], "appId">) => Promise<boolean>;
+        text: (input: Omit<Parameters<UdpAPI["sendTextPacket"]>[0], "appId">) => Promise<boolean>;
+        clientEvent: (input: Omit<Parameters<UdpAPI["sendClientEvent"]>[0], "appId">) => Promise<boolean>;
+    };
+}
+//# sourceMappingURL=grid-scope.d.ts.map

package/dist/grid-scope.d.ts.map

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