@crowdedkingdoms/crowdyjs 17.13.0-dev.1 → 18.0.0-dev.1

package/dist/kit/leaderboards.js

@@ -1,133 +0,0 @@
-import { leaderboardsNames, } from './blueprints/index.js';
-import { kitContainerProperties, kitInvoke, } from './shared.js';
-/**
- * Runtime helpers for the {@link leaderboardsBlueprint} conventions: ensure
- * per-player entries, submit scores (trusted — host by default), and rank.
- * There is no server-side ORDER BY on container lists, so reads fetch a
- * board's entries and sort client-side — fine for the few hundred entries a
- * per-app board holds.
- *
- * Obtained via `client.kit(appId).leaderboards`.
- */
-export class LeaderboardsKit {
-    constructor(appId, gameModel, options = {}, engines) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.engines = engines;
-        this.names = leaderboardsNames(options.typePrefix ?? '');
-        this.engineModuleName = options.engineModuleName ?? 'board-engine';
-    }
-    // -- Engine path (Wave 2): server-computed rankings --------------------------
-    /**
-     * Is a board compute engine deployed + enabled (cached per session)? When
-     * true, rankings are computed SERVER-side (tie-aware ranks, percentiles,
-     * pages) instead of the blueprint's client-sorted reads.
-     */
-    engineAvailable() {
-        if (!this.engines)
-            return Promise.resolve(false);
-        return this.engines.has(this.engineModuleName);
-    }
-    /** A server-ranked page (rank/percentile computed module-side). */
-    async engineTop(boardId, page = 0, perPage = 10) {
-        return this.engineInvoke('top', { boardId, page, perPage });
-    }
-    /** Your (or a subject's) server-computed ranked row. */
-    async engineRankOf(boardId, subjectId) {
-        return this.engineInvoke('rank_of', subjectId ? { boardId, subjectId } : { boardId });
-    }
-    /** Submit YOUR OWN score (personal-best semantics) to an engine board. */
-    async engineSubmitSelf(boardId, score) {
-        return this.engineInvoke('submit_self', { boardId, score });
-    }
-    /** Frozen season snapshots (top rows per rolled season). */
-    async engineSeasons(boardId) {
-        return this.engineInvoke('seasons', { boardId });
-    }
-    async engineInvoke(exportName, params) {
-        if (!this.engines) {
-            throw new Error('board engine unavailable: compute domain not wired');
-        }
-        const result = await this.engines.invoke(this.engineModuleName, exportName, params);
-        if (!result.success) {
-            throw new Error(`leaderboards.${exportName} failed: ${result.reason ?? 'unknown'}`);
-        }
-        return result.body;
-    }
-    /** Find-or-create a player's entry on a board. */
-    async ensureEntry(ownerUserId, boardId, options = {}) {
-        const entries = await this.board(boardId);
-        const mine = entries.find((e) => e.ownerUserId === String(ownerUserId));
-        if (mine) {
-            return this.gameModel.container({
-                appId: this.appId,
-                containerId: mine.containerId,
-            });
-        }
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.entryType,
-            displayName: options.displayName ?? `${boardId} ${ownerUserId}`,
-            properties: [
-                { key: 'owner_user_id', valueType: 'int', valueJson: String(ownerUserId) },
-                { key: 'board_id', valueType: 'string', valueJson: JSON.stringify(boardId) },
-            ],
-        });
-    }
-    /**
-     * Submit a score — a **trusted** call (host by default per the blueprint's
-     * `submitAuthority`). Resolves with the entry's (possibly kept-best)
-     * score.
-     */
-    async submit(entryId, points) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.submitFn,
-            selfContainerId: entryId,
-            params: { points },
-        });
-    }
-    /** All entries of one board, sorted best-first with 1-based positions. */
-    async board(boardId) {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.entryType,
-        });
-        const rows = await Promise.all(containers.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            return {
-                containerId: c.containerId,
-                displayName: c.displayName,
-                ownerUserId: c.ownerUserId != null ? String(c.ownerUserId) : null,
-                boardId: String(props.board_id ?? ''),
-                score: Number(props.score ?? 0),
-                season: Number(props.season ?? 1),
-                position: 0,
-            };
-        }));
-        return rows
-            .filter((r) => r.boardId === boardId)
-            .sort((a, b) => b.score - a.score)
-            .map((r, i) => ({ ...r, position: i + 1 }));
-    }
-    /** The top `n` of a board (client-side ranking). */
-    async top(boardId, n = 10) {
-        return (await this.board(boardId)).slice(0, n);
-    }
-    /**
-     * The entries around one player on a board (`radius` above and below),
-     * for "your neighborhood" widgets.
-     */
-    async around(boardId, userId, radius = 2) {
-        const entries = await this.board(boardId);
-        const index = entries.findIndex((e) => e.ownerUserId === String(userId));
-        if (index === -1)
-            return [];
-        return entries.slice(Math.max(0, index - radius), index + radius + 1);
-    }
-    /** The board's current season (max season across its entries; 1 when empty). */
-    async season(boardId) {
-        const entries = await this.board(boardId);
-        return entries.reduce((max, e) => Math.max(max, e.season), 1);
-    }
-}

package/dist/kit/liveops.d.ts

@@ -1,112 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars } from '../generated/graphql.js';
-import type { EngineDetector } from './engine.js';
-/** Options for {@link LiveopsKit}. */
-export interface LiveopsKitOptions {
-    /** The `typePrefix` the liveops blueprint was deployed with. */
-    typePrefix?: string;
-    /** The scheduler engine module name. Defaults to `'liveops-scheduler'`. */
-    moduleName?: string;
-}
-/** A parsed event window. */
-export interface KitEventWindow {
-    containerId: string;
-    windowId: string;
-    active: boolean;
-    opensAtMs: number;
-    closesAtMs: number;
-    modifiers: Record<string, unknown>;
-}
-/** A parsed season definition (+ its battle-pass composition). */
-export interface KitSeason {
-    containerId: string;
-    seasonId: string;
-    active: boolean;
-    startsAtMs: number;
-    endsAtMs: number;
-    passTrack: string;
-    passFeatures: string[];
-}
-/** A parsed type-98 zone-change event (BR circles, event areas). */
-export interface ZoneChangeEvent {
-    kind: string;
-    phase: number | null;
-    radiusNow: number;
-    centerX: number;
-    centerZ: number;
-    body: Record<string, unknown>;
-}
-/**
- * Runtime helpers for the liveops blueprint: event windows (admin CRUD +
- * active reads — engine-backed when the liveops-scheduler is deployed),
- * seasons with battle-pass composition, and the type-98 zone-change parser.
- *
- * Obtained via `client.kit(appId).liveops`.
- */
-export declare class LiveopsKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines?;
-    private readonly names;
-    private readonly moduleName;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LiveopsKitOptions, engines?: EngineDetector | undefined);
-    /** Is the liveops-scheduler engine deployed + enabled (cached)? */
-    engineAvailable(): Promise<boolean>;
-    /** STUDIO (admin) — create an event window. */
-    defineWindow(input: {
-        windowId: string;
-        displayName?: string;
-        opensAtMs?: number;
-        closesAtMs?: number;
-        modifiers?: Record<string, unknown>;
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** Every window (model read). */
-    windows(): Promise<KitEventWindow[]>;
-    /**
-     * The ACTIVE windows. Engine path (scheduler deployed): the module's
-     * authoritative view; otherwise filters the model read.
-     */
-    activeWindows(): Promise<KitEventWindow[]>;
-    /** STUDIO (admin/automation) — open a window through the model function. */
-    openWindow(windowContainerId: string, sessionId?: string): Promise<import("./shared.js").KitInvokeResult<boolean>>;
-    /** STUDIO (admin/automation) — close a window through the model function. */
-    closeWindow(windowContainerId: string, sessionId?: string): Promise<import("./shared.js").KitInvokeResult<boolean>>;
-    /** STUDIO (admin) — create a season (+ battle-pass composition). */
-    defineSeason(input: {
-        seasonId: string;
-        displayName?: string;
-        startsAtMs?: number;
-        endsAtMs?: number;
-        passTrack?: string;
-        passFeatures?: string[];
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** Every season (model read). */
-    seasons(): Promise<KitSeason[]>;
-    /** The active season, when one exists. */
-    currentSeason(): Promise<KitSeason | null>;
-    /** STUDIO (admin/automation) — activate a season through the model function. */
-    activateSeason(seasonContainerId: string, sessionId?: string): Promise<import("./shared.js").KitInvokeResult<boolean>>;
-    /** Parse a type-98 zone-change server event (BR circles, event areas). */
-    parseZoneChange(bytes: Uint8Array): ZoneChangeEvent | null;
-}
-//# sourceMappingURL=liveops.d.ts.map

package/dist/kit/liveops.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"liveops.d.ts","sourceRoot":"","sources":["../../src/kit/liveops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IAKnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAP3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,iBAAsB,EACd,OAAO,CAAC,EAAE,cAAc,YAAA;IAM3C,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKnC,+CAA+C;IACzC,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC;;;;;;;;;;;IAsBD,iCAAiC;IAC3B,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IA0B1C;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAchD,4EAA4E;IACtE,UAAU,CAAC,iBAAiB,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAS9D,6EAA6E;IACvE,WAAW,CAAC,iBAAiB,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAS/D,oEAAoE;IAC9D,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB;;;;;;;;;;;IAyBD,iCAAiC;IAC3B,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA2BrC,0CAA0C;IACpC,aAAa,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIhD,gFAAgF;IAC1E,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IASlE,0EAA0E;IAC1E,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;CAY3D"}

package/dist/kit/liveops.js

@@ -1,183 +0,0 @@
-import { liveopsNames } from './blueprints/liveops.js';
-import { kitContainerProperties, kitInvoke } from './shared.js';
-import { parseEngineEvent, EVENT_ZONE_CHANGE } from './wire.js';
-/**
- * Runtime helpers for the liveops blueprint: event windows (admin CRUD +
- * active reads — engine-backed when the liveops-scheduler is deployed),
- * seasons with battle-pass composition, and the type-98 zone-change parser.
- *
- * Obtained via `client.kit(appId).liveops`.
- */
-export class LiveopsKit {
-    constructor(appId, gameModel, options = {}, engines) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.engines = engines;
-        this.names = liveopsNames(options.typePrefix ?? '');
-        this.moduleName = options.moduleName ?? 'liveops-scheduler';
-    }
-    /** Is the liveops-scheduler engine deployed + enabled (cached)? */
-    engineAvailable() {
-        if (!this.engines)
-            return Promise.resolve(false);
-        return this.engines.has(this.moduleName);
-    }
-    /** STUDIO (admin) — create an event window. */
-    async defineWindow(input) {
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.windowType,
-            displayName: input.displayName ?? `Window ${input.windowId}`,
-            properties: [
-                { key: 'window_id', valueType: 'string', valueJson: JSON.stringify(input.windowId) },
-                ...(input.opensAtMs !== undefined
-                    ? [{ key: 'opens_at_ms', valueType: 'int', valueJson: String(input.opensAtMs) }]
-                    : []),
-                ...(input.closesAtMs !== undefined
-                    ? [{ key: 'closes_at_ms', valueType: 'int', valueJson: String(input.closesAtMs) }]
-                    : []),
-                {
-                    key: 'modifiers',
-                    valueType: 'string',
-                    valueJson: JSON.stringify(JSON.stringify(input.modifiers ?? {})),
-                },
-            ],
-        });
-    }
-    /** Every window (model read). */
-    async windows() {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.windowType,
-        });
-        return Promise.all(containers.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            let modifiers = {};
-            try {
-                modifiers = JSON.parse(String(props.modifiers ?? '{}'));
-            }
-            catch {
-                /* opaque */
-            }
-            return {
-                containerId: c.containerId,
-                windowId: String(props.window_id ?? ''),
-                active: props.active === true,
-                opensAtMs: Number(props.opens_at_ms ?? 0),
-                closesAtMs: Number(props.closes_at_ms ?? 0),
-                modifiers,
-            };
-        }));
-    }
-    /**
-     * The ACTIVE windows. Engine path (scheduler deployed): the module's
-     * authoritative view; otherwise filters the model read.
-     */
-    async activeWindows() {
-        if (this.engines && (await this.engineAvailable())) {
-            const result = await this.engines.invoke(this.moduleName, 'active_windows', {});
-            if (result.success && Array.isArray(result.body.windows)) {
-                const all = await this.windows();
-                const activeIds = new Set(result.body.windows.map((w) => String(w.windowId)));
-                return all.filter((w) => activeIds.has(w.windowId));
-            }
-        }
-        return (await this.windows()).filter((w) => w.active);
-    }
-    /** STUDIO (admin/automation) — open a window through the model function. */
-    async openWindow(windowContainerId, sessionId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.openWindowFn,
-            selfContainerId: windowContainerId,
-            ...(sessionId !== undefined ? { sessionId } : {}),
-        });
-    }
-    /** STUDIO (admin/automation) — close a window through the model function. */
-    async closeWindow(windowContainerId, sessionId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.closeWindowFn,
-            selfContainerId: windowContainerId,
-            ...(sessionId !== undefined ? { sessionId } : {}),
-        });
-    }
-    /** STUDIO (admin) — create a season (+ battle-pass composition). */
-    async defineSeason(input) {
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.seasonType,
-            displayName: input.displayName ?? `Season ${input.seasonId}`,
-            properties: [
-                { key: 'season_id', valueType: 'string', valueJson: JSON.stringify(input.seasonId) },
-                ...(input.startsAtMs !== undefined
-                    ? [{ key: 'starts_at_ms', valueType: 'int', valueJson: String(input.startsAtMs) }]
-                    : []),
-                ...(input.endsAtMs !== undefined
-                    ? [{ key: 'ends_at_ms', valueType: 'int', valueJson: String(input.endsAtMs) }]
-                    : []),
-                ...(input.passTrack !== undefined
-                    ? [{ key: 'pass_track', valueType: 'string', valueJson: JSON.stringify(input.passTrack) }]
-                    : []),
-                {
-                    key: 'pass_features',
-                    valueType: 'string',
-                    valueJson: JSON.stringify(JSON.stringify(input.passFeatures ?? [])),
-                },
-            ],
-        });
-    }
-    /** Every season (model read). */
-    async seasons() {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.seasonType,
-        });
-        return Promise.all(containers.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            let passFeatures = [];
-            try {
-                passFeatures = JSON.parse(String(props.pass_features ?? '[]')).map(String);
-            }
-            catch {
-                /* opaque */
-            }
-            return {
-                containerId: c.containerId,
-                seasonId: String(props.season_id ?? ''),
-                active: props.active === true,
-                startsAtMs: Number(props.starts_at_ms ?? 0),
-                endsAtMs: Number(props.ends_at_ms ?? 0),
-                passTrack: String(props.pass_track ?? ''),
-                passFeatures,
-            };
-        }));
-    }
-    /** The active season, when one exists. */
-    async currentSeason() {
-        return (await this.seasons()).find((s) => s.active) ?? null;
-    }
-    /** STUDIO (admin/automation) — activate a season through the model function. */
-    async activateSeason(seasonContainerId, sessionId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.activateSeasonFn,
-            selfContainerId: seasonContainerId,
-            ...(sessionId !== undefined ? { sessionId } : {}),
-        });
-    }
-    /** Parse a type-98 zone-change server event (BR circles, event areas). */
-    parseZoneChange(bytes) {
-        const parsed = parseEngineEvent(bytes);
-        if (!parsed || parsed.eventType !== EVENT_ZONE_CHANGE)
-            return null;
-        return {
-            kind: String(parsed.body.kind ?? ''),
-            phase: parsed.body.phase != null ? Number(parsed.body.phase) : null,
-            radiusNow: Number(parsed.body.radiusNow ?? 0),
-            centerX: Number(parsed.body.centerX ?? 0),
-            centerZ: Number(parsed.body.centerZ ?? 0),
-            body: parsed.body,
-        };
-    }
-}

package/dist/kit/loot.d.ts

@@ -1,128 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { EngineDetector } from './engine.js';
-import type { Scalars } from '../generated/graphql.js';
-import { type KitInvokeResult } from './shared.js';
-/** Options for {@link LootKit}. Must match the deployed loot blueprint. */
-export interface LootKitOptions {
-    /**
-     * The big-table loot module (pity timers, audit trails). Defaults to
-     * `'loot-engine'`; the gacha-shrine example ships this contract.
-     */
-    engineModuleName?: string;
-    /** The `typePrefix` the loot blueprint was deployed with. */
-    typePrefix?: string;
-}
-/** A parsed view of one loot roll. */
-export interface KitLootRoll {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    tableId: string;
-    /** Empty until rolled. */
-    rolledItemId: string;
-    rolledQty: number;
-    claimed: boolean;
-}
-/**
- * Runtime helpers for the {@link lootBlueprint} conventions: create durable
- * `LootRoll` containers, roll them (trusted — app admins by default, or the
- * blueprint's event-drop automations), and claim results atomically into an
- * item stack. The weighted selection runs entirely server-side from a stored
- * seed, so clients can neither pick their loot nor claim it twice.
- *
- * Obtained via `client.kit(appId).loot`.
- */
-export declare class LootKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines?;
-    private readonly names;
-    private readonly typePrefix;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LootKitOptions, engines?: EngineDetector | undefined);
-    private readonly engineModuleName;
-    /**
-     * Is a big-table loot module deployed + enabled (cached per session)?
-     * When true, {@link enginePull} routes rolls through server-held RNG with
-     * pity timers + audit trails; the blueprint's weighted model rolls stay
-     * for small tables (the coexistence policy — "the server picks the path").
-     */
-    engineAvailable(): Promise<boolean>;
-    /** Pull from the module's table (pity-timer path); count caps at 10. */
-    enginePull(count?: number): Promise<Record<string, unknown>>;
-    /** Your pity counters + roll totals from the module. */
-    enginePity(): Promise<Record<string, unknown>>;
-    /** Your rolling audit trail from the module (dispute resolution). */
-    engineAudit(): Promise<Record<string, unknown>>;
-    /**
-     * Create an unrolled `LootRoll` for a table, owned by `ownerUserId` (who
-     * will claim it). Event-drop automations pick from the pool of unrolled
-     * rolls — create a few ahead of time for tables wired to `drops`.
-     */
-    createRoll(input: {
-        ownerUserId: Scalars['BigInt']['input'];
-        tableId: string;
-        displayName?: string;
-        sessionId?: string;
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /**
-     * Roll a table on an unrolled `LootRoll` — a **trusted** call (default
-     * blueprint authority: app admins). Resolves with the rolled item id.
-     *
-     * @param tableId - The roll container's table (derives the function name);
-     *   read from the container when omitted.
-     */
-    roll(rollId: string, tableId?: string): Promise<KitInvokeResult<string>>;
-    /**
-     * Claim a rolled loot into a caller-owned stack of the rolled item. The
-     * claimed flag and the grant commit atomically. Resolves with the granted
-     * quantity.
-     */
-    claim(rollId: string, toStackId: string): Promise<KitInvokeResult<number>>;
-    /** Read one roll's state. */
-    state(rollId: string): Promise<KitLootRoll>;
-    /**
-     * List a player's rolls, optionally filtered to one table and/or to
-     * unclaimed rolled loot (the "your drops" screen).
-     */
-    rolls(ownerUserId: Scalars['BigInt']['input'], options?: {
-        tableId?: string;
-        unclaimedOnly?: boolean;
-    }): Promise<KitLootRoll[]>;
-    /**
-     * Roll/claim audit history from the model event log (each roll records its
-     * seed, item, and quantity as applied mutations).
-     */
-    history(options?: {
-        tableId?: string;
-        limit?: number;
-    }): Promise<{
-        __typename?: "GmEvent";
-        eventId: string;
-        flowId: string | null;
-        sessionId: string | null;
-        functionName: string;
-        selfContainerId: string | null;
-        callerUserId: string | null;
-        callerKind: string;
-        automationId: string | null;
-        paramsJson: string;
-        mutationsAppliedJson: string;
-        permissionEffectsAppliedJson: string;
-        returnValueJson: string | null;
-        success: boolean;
-        errorMessage: string | null;
-        executedAt: string;
-    }[]>;
-    private toRoll;
-}
-//# sourceMappingURL=loot.d.ts.map

package/dist/kit/loot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loot.d.ts","sourceRoot":"","sources":["../../src/kit/loot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAKhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAP3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,cAAmB,EACX,OAAO,CAAC,EAAE,cAAc,YAAA;IAO3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C;;;;;OAKG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKnC,wEAAwE;IAClE,UAAU,CAAC,KAAK,SAAI;IAO1B,wDAAwD;IAClD,UAAU;IAOhB,qEAAqE;IAC/D,WAAW;IAOjB;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE;QACtB,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAqBD;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAU9E;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAShF,6BAA6B;IACvB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYjD;;;OAGG;IACG,KAAK,CACT,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1D,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBzB;;;OAGG;IACG,OAAO,CACX,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;;;;;;;;YAYtC,MAAM;CAoBrB"}