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

package/dist/kit/features.js

@@ -1,65 +0,0 @@
-import { featureGate } from './blueprints/index.js';
-/**
- * Runtime **monetization** helpers — the app feature/tier surface in shop
- * terms. Features are string keys (`'vip'`, `'land_owner'`, `'battle_pass'`)
- * defined per app and granted to **access tiers** (the management-side
- * `appAccess` tiers players buy/hold); any model function whose policy
- * carries a `tier_feature` leaf then admits only players on a granted tier.
- *
- * Gate blueprint functions by composing {@link gate} (=`featureGate`) into a
- * builder's `*policyExtra` option, e.g.
- * `plotBlueprint({ buyPolicyExtra: kit.features.gate('land_owner') })`.
- *
- * All methods require the app-admin `manage_apps` permission.
- *
- * Obtained via `client.kit(appId).features`.
- */
-export class FeaturesKit {
-    constructor(appId, gameModel) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-    }
-    /** Define (or re-describe) a feature key for the app. */
-    async define(featureKey, description) {
-        return this.gameModel.defineFeature({
-            appId: this.appId,
-            featureKey,
-            ...(description !== undefined ? { description } : {}),
-        });
-    }
-    /** List the app's defined feature keys. */
-    async list() {
-        return this.gameModel.features({ appId: this.appId });
-    }
-    /** Grant a feature to an access tier (its holders pass `tier_feature` checks). */
-    async grantToTier(tierId, featureKey) {
-        return this.gameModel.grantTierFeature({
-            appId: this.appId,
-            tierId,
-            featureKey,
-        });
-    }
-    /** Revoke a feature from an access tier. */
-    async revokeFromTier(tierId, featureKey) {
-        return this.gameModel.revokeTierFeature({
-            appId: this.appId,
-            tierId,
-            featureKey,
-        });
-    }
-    /** List tier→feature grants (optionally for one tier). */
-    async tierFeatures(tierId) {
-        return this.gameModel.tierFeatures({
-            appId: this.appId,
-            ...(tierId !== undefined ? { tierId } : {}),
-        });
-    }
-    /**
-     * A `tier_feature` policy leaf for `feature` — pass it to any blueprint
-     * builder's `*policyExtra` option to monetization-gate that function.
-     * (Also exported standalone as `featureGate`.)
-     */
-    gate(feature) {
-        return featureGate(feature);
-    }
-}

package/dist/kit/instances.d.ts

@@ -1,52 +0,0 @@
-import type { Scalars } from '../generated/graphql.js';
-import type { EngineDetector } from './engine.js';
-/** Options for {@link InstancesKit}. */
-export interface InstancesKitOptions {
-    /** The instance-engine module name. Defaults to `'instance-engine'`. */
-    moduleName?: string;
-}
-/** A parsed instance (private world slice). */
-export interface KitInstance {
-    instanceId: string;
-    name: string;
-    creator: string;
-    members: string[];
-    /** Decimal string (u64 seeds exceed JS safe integers). */
-    seed: string;
-    status: string;
-    outcome: string;
-    sessionId: string;
-    containerId: string;
-    /** Reserved chunk-volume corner [x, y, z]. */
-    chunkBase: [number, number, number];
-    volumeChunks: number;
-}
-/**
- * Runtime helpers for the instance-engine (Wave 2): private world slices
- * with lifecycle (open/join/complete), per-run seeds for deterministic
- * procedural content, and reserved disjoint chunk volumes. v1 spatial
- * isolation is by-convention (disjoint volumes + distance-scoped emits).
- *
- * Obtained via `client.kit(appId).instances`.
- */
-export declare class InstancesKit {
-    private readonly engines;
-    private readonly moduleName;
-    constructor(_appId: Scalars['BigInt']['input'], engines: EngineDetector, options?: InstancesKitOptions);
-    /** Is the instance engine deployed + enabled (cached per session)? */
-    engineAvailable(): Promise<boolean>;
-    /** Open a new instance (caller becomes creator + first member). */
-    open(input?: {
-        name?: string;
-        seed?: string;
-        sessionId?: string;
-    }): Promise<KitInstance>;
-    /** Join an open instance. */
-    join(instanceId: string): Promise<KitInstance>;
-    /** Complete an instance (member-only; announces `instance_completed`). */
-    complete(instanceId: string, outcome?: string): Promise<KitInstance>;
-    /** One instance's state (or the engine's totals without an id). */
-    state(instanceId?: string): Promise<KitInstance | Record<string, unknown>>;
-    private invoke;
-}
-//# sourceMappingURL=instances.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/kit/instances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAEtE,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;;;;GAOG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,mBAAwB;IAKnC,sEAAsE;IACtE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,mEAAmE;IAC7D,IAAI,CAAC,KAAK,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAKlG,6BAA6B;IACvB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKpD,0EAA0E;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK1E,mEAAmE;IAC7D,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAKlE,MAAM;CAUrB"}

package/dist/kit/instances.js

@@ -1,60 +0,0 @@
-function toInstance(body) {
-    return {
-        instanceId: String(body.instanceId ?? ''),
-        name: String(body.name ?? ''),
-        creator: String(body.creator ?? ''),
-        members: Array.isArray(body.members) ? body.members.map(String) : [],
-        seed: String(body.seed ?? '0'),
-        status: String(body.status ?? ''),
-        outcome: String(body.outcome ?? ''),
-        sessionId: String(body.sessionId ?? ''),
-        containerId: String(body.containerId ?? ''),
-        chunkBase: (Array.isArray(body.chunkBase) ? body.chunkBase : [0, 0, 0]).map(Number),
-        volumeChunks: Number(body.volumeChunks ?? 0),
-    };
-}
-/**
- * Runtime helpers for the instance-engine (Wave 2): private world slices
- * with lifecycle (open/join/complete), per-run seeds for deterministic
- * procedural content, and reserved disjoint chunk volumes. v1 spatial
- * isolation is by-convention (disjoint volumes + distance-scoped emits).
- *
- * Obtained via `client.kit(appId).instances`.
- */
-export class InstancesKit {
-    constructor(_appId, engines, options = {}) {
-        this.engines = engines;
-        this.moduleName = options.moduleName ?? 'instance-engine';
-    }
-    /** Is the instance engine deployed + enabled (cached per session)? */
-    engineAvailable() {
-        return this.engines.has(this.moduleName);
-    }
-    /** Open a new instance (caller becomes creator + first member). */
-    async open(input = {}) {
-        const result = await this.invoke('open', input);
-        return toInstance(result.body);
-    }
-    /** Join an open instance. */
-    async join(instanceId) {
-        const result = await this.invoke('join', { instanceId });
-        return toInstance(result.body);
-    }
-    /** Complete an instance (member-only; announces `instance_completed`). */
-    async complete(instanceId, outcome) {
-        const result = await this.invoke('complete', { instanceId, outcome });
-        return toInstance(result.body);
-    }
-    /** One instance's state (or the engine's totals without an id). */
-    async state(instanceId) {
-        const result = await this.invoke('state', instanceId ? { instanceId } : {});
-        return instanceId ? toInstance(result.body) : result.body;
-    }
-    async invoke(exportName, params) {
-        const result = await this.engines.invoke(this.moduleName, exportName, params);
-        if (!result.success) {
-            throw new Error(`instances.${exportName} failed: ${result.reason ?? 'unknown'}`);
-        }
-        return result;
-    }
-}

package/dist/kit/inventory.d.ts

@@ -1,129 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars } from '../generated/graphql.js';
-import { type KitOwnerIdKind } from './blueprints/index.js';
-import { type KitInvokeResult } from './shared.js';
-/** Options for {@link InventoryKit}. Must match the deployed blueprint's options. */
-export interface InventoryKitOptions {
-    /** The `typePrefix` the inventory blueprint was deployed with. */
-    typePrefix?: string;
-    /** Must match inventoryBlueprint.ownerIdKind. Defaults to `int`. */
-    ownerIdKind?: KitOwnerIdKind;
-}
-/** A parsed view of one item stack. */
-export interface KitItemStack {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    itemId: string;
-    quantity: number;
-    slot: number;
-}
-/**
- * Runtime helpers for the {@link inventoryBlueprint} conventions: find or
- * create the player's inventory, list stacks, and mutate them through the
- * owner-gated model functions. All state lives server-side; every mutation is
- * authority-checked and atomic.
- *
- * Obtained via `client.kit(appId).inventory`.
- */
-export declare class InventoryKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly names;
-    private readonly typePrefix;
-    private readonly ownerIdKind;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: InventoryKitOptions);
-    /**
-     * Find the caller's inventory container, creating it when absent. The
-     * server assigns ownership to the caller (the type is member-instantiable
-     * and `ownerUserId` is omitted on create).
-     *
-     * @param ownerUserId - The calling player's user id (a decimal string, e.g.
-     *   from `client.users.me()`), used to recognize an existing inventory.
-     */
-    ensure(ownerUserId: Scalars['BigInt']['input'], options?: {
-        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;
-    }>;
-    /**
-     * List a player's item stacks with parsed properties (`itemId`, `quantity`,
-     * `slot`). Fetches each stack's visible state in parallel.
-     */
-    stacks(ownerUserId: Scalars['BigInt']['input']): Promise<KitItemStack[]>;
-    /**
-     * Create a new stack owned by the caller (server-assigned ownership).
-     * Use {@link grant} afterwards for authority-checked increments; the initial
-     * quantity here is a seed value on a container the caller owns anyway.
-     *
-     * Pass `ownerUserId` (the caller's own user id) to also set the
-     * `owner_user_id` mirror property that cross-container guards (economy
-     * trades / market listings) verify.
-     */
-    createStack(input: {
-        itemId: string;
-        quantity?: number;
-        slot?: number;
-        displayName?: string;
-        sessionId?: string;
-        ownerUserId?: Scalars['BigInt']['input'];
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** Add items to a stack the caller owns. Resolves with the new quantity. */
-    grant(stackId: string, amount: number): Promise<KitInvokeResult<number>>;
-    /**
-     * Spend items from a stack the caller owns. The server refuses to overdraw
-     * (`success: false`, nothing written). Resolves with the new quantity.
-     */
-    consume(stackId: string, amount: number): Promise<KitInvokeResult<number>>;
-    /** Move a stack to another slot. Resolves with the new (clamped) slot. */
-    move(stackId: string, toSlot: number): Promise<KitInvokeResult<number>>;
-    /**
-     * Atomically move items between two stacks of the same item type — both
-     * writes commit or neither does. The caller must own the source stack.
-     * Resolves with the source stack's remaining quantity.
-     */
-    transfer(fromStackId: string, toStackId: string, amount: number): Promise<KitInvokeResult<number>>;
-    /**
-     * Atomically craft a recipe generated by inventoryBlueprint: every input
-     * decrement and the output grant commit together. A failed guard writes
-     * nothing. `inputStackIds` must follow the recipe input order.
-     */
-    craft(inventoryId: string, recipeId: string, inputStackIds: string[], outputStackId: string): Promise<KitInvokeResult<number>>;
-    /** Atomically execute a generated item-for-item barter offer. */
-    barter(inventoryId: string, barterId: string, payStackId: string, receiveStackId: string): Promise<KitInvokeResult<number>>;
-    /**
-     * Record that a stack belongs to an inventory with an
-     * `inventory_contains` edge, so {@link contents} can read the whole bag in
-     * one traversal.
-     */
-    linkStack(inventoryId: string, stackId: string): Promise<{
-        __typename?: "GmEdge";
-        edgeId: string;
-        fromContainerId: string;
-        toContainerId: string;
-        relationshipType: string;
-        weight: number | null;
-    }>;
-    /** Read every stack linked to an inventory (via `inventory_contains` edges). */
-    contents(inventoryId: string): Promise<KitItemStack[]>;
-}
-//# sourceMappingURL=inventory.d.ts.map

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

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

package/dist/kit/inventory.js

@@ -1,200 +0,0 @@
-import { inventoryBarterFunctionName, inventoryCraftFunctionName, inventoryNames, } from './blueprints/index.js';
-import { kitContainerProperties, kitInvoke, } from './shared.js';
-/**
- * Runtime helpers for the {@link inventoryBlueprint} conventions: find or
- * create the player's inventory, list stacks, and mutate them through the
- * owner-gated model functions. All state lives server-side; every mutation is
- * authority-checked and atomic.
- *
- * Obtained via `client.kit(appId).inventory`.
- */
-export class InventoryKit {
-    constructor(appId, gameModel, options = {}) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.typePrefix = options.typePrefix ?? '';
-        this.ownerIdKind = options.ownerIdKind ?? 'int';
-        this.names = inventoryNames(this.typePrefix);
-    }
-    /**
-     * Find the caller's inventory container, creating it when absent. The
-     * server assigns ownership to the caller (the type is member-instantiable
-     * and `ownerUserId` is omitted on create).
-     *
-     * @param ownerUserId - The calling player's user id (a decimal string, e.g.
-     *   from `client.users.me()`), used to recognize an existing inventory.
-     */
-    async ensure(ownerUserId, options = {}) {
-        const existing = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.inventoryType,
-            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-        });
-        const mine = existing.find((c) => c.ownerUserId != null && String(c.ownerUserId) === String(ownerUserId));
-        if (mine)
-            return mine;
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.inventoryType,
-            displayName: options.displayName ?? `Inventory ${ownerUserId}`,
-            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-        });
-    }
-    /**
-     * List a player's item stacks with parsed properties (`itemId`, `quantity`,
-     * `slot`). Fetches each stack's visible state in parallel.
-     */
-    async stacks(ownerUserId) {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.stackType,
-        });
-        const mine = containers.filter((c) => c.ownerUserId != null && String(c.ownerUserId) === String(ownerUserId));
-        return Promise.all(mine.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,
-                itemId: String(props.item_id ?? ''),
-                quantity: Number(props.quantity ?? 0),
-                slot: Number(props.slot ?? 0),
-            };
-        }));
-    }
-    /**
-     * Create a new stack owned by the caller (server-assigned ownership).
-     * Use {@link grant} afterwards for authority-checked increments; the initial
-     * quantity here is a seed value on a container the caller owns anyway.
-     *
-     * Pass `ownerUserId` (the caller's own user id) to also set the
-     * `owner_user_id` mirror property that cross-container guards (economy
-     * trades / market listings) verify.
-     */
-    async createStack(input) {
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.stackType,
-            displayName: input.displayName ?? `Stack ${input.itemId}`,
-            ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
-            properties: [
-                { key: 'item_id', valueType: 'string', valueJson: JSON.stringify(input.itemId) },
-                { key: 'quantity', valueType: 'int', valueJson: String(input.quantity ?? 0) },
-                { key: 'slot', valueType: 'int', valueJson: String(input.slot ?? 0) },
-                ...(input.ownerUserId !== undefined
-                    ? [
-                        {
-                            key: 'owner_user_id',
-                            valueType: this.ownerIdKind,
-                            valueJson: this.ownerIdKind === 'string'
-                                ? JSON.stringify(String(input.ownerUserId))
-                                : String(input.ownerUserId),
-                        },
-                    ]
-                    : []),
-            ],
-        });
-    }
-    /** Add items to a stack the caller owns. Resolves with the new quantity. */
-    async grant(stackId, amount) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.grantFn,
-            selfContainerId: stackId,
-            params: { amount },
-        });
-    }
-    /**
-     * Spend items from a stack the caller owns. The server refuses to overdraw
-     * (`success: false`, nothing written). Resolves with the new quantity.
-     */
-    async consume(stackId, amount) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.consumeFn,
-            selfContainerId: stackId,
-            params: { amount },
-        });
-    }
-    /** Move a stack to another slot. Resolves with the new (clamped) slot. */
-    async move(stackId, toSlot) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.moveFn,
-            selfContainerId: stackId,
-            params: { to_slot: toSlot },
-        });
-    }
-    /**
-     * Atomically move items between two stacks of the same item type — both
-     * writes commit or neither does. The caller must own the source stack.
-     * Resolves with the source stack's remaining quantity.
-     */
-    async transfer(fromStackId, toStackId, amount) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.transferFn,
-            selfContainerId: fromStackId,
-            params: { to_id: toStackId, amount },
-        });
-    }
-    /**
-     * Atomically craft a recipe generated by inventoryBlueprint: every input
-     * decrement and the output grant commit together. A failed guard writes
-     * nothing. `inputStackIds` must follow the recipe input order.
-     */
-    async craft(inventoryId, recipeId, inputStackIds, outputStackId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: inventoryCraftFunctionName(recipeId, this.typePrefix),
-            selfContainerId: inventoryId,
-            params: {
-                ...Object.fromEntries(inputStackIds.map((id, index) => [`input_${index}_id`, id])),
-                output_id: outputStackId,
-            },
-        });
-    }
-    /** Atomically execute a generated item-for-item barter offer. */
-    async barter(inventoryId, barterId, payStackId, receiveStackId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: inventoryBarterFunctionName(barterId, this.typePrefix),
-            selfContainerId: inventoryId,
-            params: { pay_id: payStackId, receive_id: receiveStackId },
-        });
-    }
-    /**
-     * Record that a stack belongs to an inventory with an
-     * `inventory_contains` edge, so {@link contents} can read the whole bag in
-     * one traversal.
-     */
-    async linkStack(inventoryId, stackId) {
-        return this.gameModel.addEdge({
-            appId: this.appId,
-            fromContainerId: inventoryId,
-            toContainerId: stackId,
-            relationshipType: this.names.containsEdge,
-        });
-    }
-    /** Read every stack linked to an inventory (via `inventory_contains` edges). */
-    async contents(inventoryId) {
-        const result = await this.gameModel.traverse({
-            appId: this.appId,
-            rootId: inventoryId,
-            relationshipType: this.names.containsEdge,
-            depth: 1,
-        });
-        const stacks = result.nodes.filter((n) => n.typeName === this.names.stackType);
-        return Promise.all(stacks.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,
-                itemId: String(props.item_id ?? ''),
-                quantity: Number(props.quantity ?? 0),
-                slot: Number(props.slot ?? 0),
-            };
-        }));
-    }
-}

package/dist/kit/leaderboards.d.ts

@@ -1,86 +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 LeaderboardsKit}. Must match the deployed blueprint. */
-export interface LeaderboardsKitOptions {
-    /** The board engine module for server-computed rankings. Defaults to `'board-engine'`. */
-    engineModuleName?: string;
-    /** The `typePrefix` the leaderboards blueprint was deployed with. */
-    typePrefix?: string;
-}
-/** A parsed view of one leaderboard entry. */
-export interface KitLeaderboardEntry {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    boardId: string;
-    score: number;
-    season: number;
-    /** 1-based position AFTER client-side sorting (not the stamped `rank` property). */
-    position: number;
-}
-/**
- * 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 declare class LeaderboardsKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines?;
-    private readonly names;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LeaderboardsKitOptions, engines?: EngineDetector | undefined);
-    private readonly engineModuleName;
-    /**
-     * 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(): Promise<boolean>;
-    /** A server-ranked page (rank/percentile computed module-side). */
-    engineTop(boardId: string, page?: number, perPage?: number): Promise<Record<string, unknown>>;
-    /** Your (or a subject's) server-computed ranked row. */
-    engineRankOf(boardId: string, subjectId?: string): Promise<Record<string, unknown>>;
-    /** Submit YOUR OWN score (personal-best semantics) to an engine board. */
-    engineSubmitSelf(boardId: string, score: number): Promise<Record<string, unknown>>;
-    /** Frozen season snapshots (top rows per rolled season). */
-    engineSeasons(boardId: string): Promise<Record<string, unknown>>;
-    private engineInvoke;
-    /** Find-or-create a player's entry on a board. */
-    ensureEntry(ownerUserId: Scalars['BigInt']['input'], boardId: string, options?: {
-        displayName?: string;
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /**
-     * Submit a score — a **trusted** call (host by default per the blueprint's
-     * `submitAuthority`). Resolves with the entry's (possibly kept-best)
-     * score.
-     */
-    submit(entryId: string, points: number): Promise<KitInvokeResult<number>>;
-    /** All entries of one board, sorted best-first with 1-based positions. */
-    board(boardId: string): Promise<KitLeaderboardEntry[]>;
-    /** The top `n` of a board (client-side ranking). */
-    top(boardId: string, n?: number): Promise<KitLeaderboardEntry[]>;
-    /**
-     * The entries around one player on a board (`radius` above and below),
-     * for "your neighborhood" widgets.
-     */
-    around(boardId: string, userId: Scalars['BigInt']['input'], radius?: number): Promise<KitLeaderboardEntry[]>;
-    /** The board's current season (max season across its entries; 1 when empty). */
-    season(boardId: string): Promise<number>;
-}
-//# sourceMappingURL=leaderboards.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"leaderboards.d.ts","sourceRoot":"","sources":["../../src/kit/leaderboards.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;AAKvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAN3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAGvB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,sBAA2B,EACnB,OAAO,CAAC,EAAE,cAAc,YAAA;IAM3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAI1C;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKnC,mEAAmE;IAC7D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,OAAO,SAAK;IAIvD,wDAAwD;IAClD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAItD,0EAA0E;IACpE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAIrD,4DAA4D;IACtD,aAAa,CAAC,OAAO,EAAE,MAAM;YAIrB,YAAY;IAW1B,kDAAkD;IAC5C,WAAW,CACf,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;IAqBxC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS/E,0EAA0E;IACpE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6B5D,oDAAoD;IAC9C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAIlE;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,MAAM,SAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOjC,gFAAgF;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI/C"}