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

package/dist/kit/pets.d.ts

@@ -1,85 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars, SeedPropertyInput } from '../generated/graphql.js';
-import type { EngineDetector } from './engine.js';
-/** Options for {@link PetsKit}. Must match the deployed npc engine. */
-export interface PetsKitOptions {
-    /** The compute module serving summon/dismiss/rename. Defaults to `'npc-engine'`. */
-    moduleName?: string;
-    /** The pet container type. Defaults to `'Pet'`. */
-    typeName?: string;
-}
-/** A parsed pet container. */
-export interface KitPet {
-    containerId: string;
-    displayName: string;
-    species: string;
-    name: string;
-    ownerUserId: string | null;
-    bond: number;
-    active: boolean;
-    actorUuid: string;
-    x: number;
-    y: number;
-    z: number;
-    properties: Record<string, unknown>;
-}
-/** An engine verdict for a pet invoke. */
-export interface KitPetResult {
-    success: boolean;
-    reason?: string;
-}
-/**
- * Runtime helpers for engine-driven pets (the Wave 1 npc-engine template):
- * `Pet` containers hold species/name/owner/bond; the engine walks active
- * pets after their owner (kit-ai `follow_owner`) and streams FLAG_NPC actor
- * poses with the pet's container id as the payload suffix — decode the lane
- * with `kit/wire` and match `pose.suffix` to the container id.
- *
- * Obtained via `client.kit(appId).pets`.
- */
-export declare class PetsKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly engines;
-    private readonly moduleName;
-    private readonly typeName;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, engines: EngineDetector, options?: PetsKitOptions);
-    /** Is the pet-driving npc engine deployed + enabled (cached per session)? */
-    engineAvailable(): Promise<boolean>;
-    /**
-     * Adopt a pet: creates the caller-owned Pet container (active). Member
-     * instantiation defaults the owner to the caller; admin tokens must pass
-     * `ownerUserId` explicitly (the engine validates ownership on every
-     * summon/dismiss/rename).
-     */
-    adopt(input: {
-        species: string;
-        name: string;
-        ownerUserId?: Scalars['BigInt']['input'];
-        position?: {
-            x: number;
-            y: number;
-            z: number;
-        };
-        properties?: SeedPropertyInput[];
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** List pets (all, or one owner's with `ownerUserId`). */
-    list(ownerUserId?: Scalars['BigInt']['input']): Promise<KitPet[]>;
-    /** Summon your pet: it starts following you (owner-validated engine-side). */
-    summon(containerId: string): Promise<KitPetResult>;
-    /** Dismiss your pet: it stops simulating until summoned again. */
-    dismiss(containerId: string): Promise<KitPetResult>;
-    /** Rename your pet (1-32 chars; owner-validated engine-side). */
-    rename(containerId: string, name: string): Promise<KitPetResult>;
-}
-//# sourceMappingURL=pets.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pets.d.ts","sourceRoot":"","sources":["../../src/kit/pets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAKhB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,cAAmB;IAM9B,6EAA6E;IAC7E,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC;;;;;OAKG;IACG,KAAK,CAAC,KAAK,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;KAClC;;;;;;;;;;;IAuBD,0DAA0D;IACpD,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoCvE,8EAA8E;IACxE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKxD,kEAAkE;IAC5D,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKzD,iEAAiE;IAC3D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAOvE"}

package/dist/kit/pets.js

@@ -1,96 +0,0 @@
-import { kitContainerProperties } from './shared.js';
-/**
- * Runtime helpers for engine-driven pets (the Wave 1 npc-engine template):
- * `Pet` containers hold species/name/owner/bond; the engine walks active
- * pets after their owner (kit-ai `follow_owner`) and streams FLAG_NPC actor
- * poses with the pet's container id as the payload suffix — decode the lane
- * with `kit/wire` and match `pose.suffix` to the container id.
- *
- * Obtained via `client.kit(appId).pets`.
- */
-export class PetsKit {
-    constructor(appId, gameModel, engines, options = {}) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.engines = engines;
-        this.moduleName = options.moduleName ?? 'npc-engine';
-        this.typeName = options.typeName ?? 'Pet';
-    }
-    /** Is the pet-driving npc engine deployed + enabled (cached per session)? */
-    engineAvailable() {
-        return this.engines.has(this.moduleName);
-    }
-    /**
-     * Adopt a pet: creates the caller-owned Pet container (active). Member
-     * instantiation defaults the owner to the caller; admin tokens must pass
-     * `ownerUserId` explicitly (the engine validates ownership on every
-     * summon/dismiss/rename).
-     */
-    async adopt(input) {
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.typeName,
-            displayName: input.name,
-            ...(input.ownerUserId !== undefined ? { ownerUserId: input.ownerUserId } : {}),
-            properties: [
-                { key: 'species', valueType: 'string', valueJson: JSON.stringify(input.species) },
-                { key: 'name', valueType: 'string', valueJson: JSON.stringify(input.name) },
-                { key: 'bond', valueType: 'int', valueJson: '0' },
-                { key: 'active', valueType: 'string', valueJson: '"true"' },
-                ...(input.position
-                    ? [
-                        { key: 'x', valueType: 'int', valueJson: String(Math.round(input.position.x)) },
-                        { key: 'y', valueType: 'int', valueJson: String(Math.round(input.position.y)) },
-                        { key: 'z', valueType: 'int', valueJson: String(Math.round(input.position.z)) },
-                    ]
-                    : []),
-                ...(input.properties ?? []),
-            ],
-        });
-    }
-    /** List pets (all, or one owner's with `ownerUserId`). */
-    async list(ownerUserId) {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.typeName,
-        });
-        const filtered = ownerUserId === undefined
-            ? containers
-            : containers.filter((c) => c.ownerUserId != null && String(c.ownerUserId) === String(ownerUserId));
-        return Promise.all(filtered.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            return {
-                containerId: c.containerId,
-                displayName: c.displayName,
-                species: String(props.species ?? ''),
-                name: String(props.name ?? c.displayName),
-                ownerUserId: c.ownerUserId != null ? String(c.ownerUserId) : null,
-                bond: Number(props.bond ?? 0),
-                active: props.active !== 'false' && props.active !== false,
-                actorUuid: String(props.actor_uuid ?? ''),
-                x: Number(props.x ?? 0),
-                y: Number(props.y ?? 0),
-                z: Number(props.z ?? 0),
-                properties: props,
-            };
-        }));
-    }
-    /** Summon your pet: it starts following you (owner-validated engine-side). */
-    async summon(containerId) {
-        const result = await this.engines.invoke(this.moduleName, 'summon', { containerId });
-        return { success: result.success, reason: result.reason };
-    }
-    /** Dismiss your pet: it stops simulating until summoned again. */
-    async dismiss(containerId) {
-        const result = await this.engines.invoke(this.moduleName, 'dismiss', { containerId });
-        return { success: result.success, reason: result.reason };
-    }
-    /** Rename your pet (1-32 chars; owner-validated engine-side). */
-    async rename(containerId, name) {
-        const result = await this.engines.invoke(this.moduleName, 'rename_pet', {
-            containerId,
-            name,
-        });
-        return { success: result.success, reason: result.reason };
-    }
-}

package/dist/kit/plots.d.ts

@@ -1,85 +0,0 @@
-import type { GameAppsAPI } from '../domains/gameApps.js';
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars, SeedPropertyInput } from '../generated/graphql.js';
-import { type KitInvokeResult } from './shared.js';
-/** Options for {@link PlotsKit}. Must match the deployed plot blueprint. */
-export interface PlotsKitOptions {
-    /** The `typeName` the plot blueprint was deployed with. Defaults to `'Plot'`. */
-    typeName?: string;
-}
-/** A parsed view of one plot. */
-export interface KitPlot {
-    containerId: string;
-    displayName: string;
-    gridId: number;
-    price: number;
-    /**
-     * 0 when unowned. Parsed numerically for both owner-mirror kinds: with
-     * `ownerIdKind: 'string'` blueprints the stored decimal string converts,
-     * and the for-sale sentinel `""` parses to 0.
-     */
-    ownerUserId: number;
-    rentPrice?: number;
-    rentTtlSeconds?: number;
-}
-/**
- * Runtime helpers for the {@link plotBlueprint} conventions: list/create
- * plots and drive the buy/rent/evict functions whose permission effects grant
- * or revoke real, replication-enforced grid permissions transactionally with
- * the currency mutation. Authorization (wallet ownership, price, plot
- * ownership) is enforced server-side — a denial resolves with
- * `success: false`, never an exception.
- *
- * Obtained via `client.kit(appId).plots`.
- */
-export declare class PlotsKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly gameApps;
-    private readonly names;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, gameApps: GameAppsAPI, options?: PlotsKitOptions);
-    /**
-     * Instantiate a plot over an existing grid (admin — the type is
-     * admin-instantiable). Create the grid first (`client.gameApps.createGrid`)
-     * and pass its id here.
-     */
-    create(input: {
-        displayName: string;
-        gridId: Scalars['BigInt']['input'];
-        price: number;
-        rentPrice?: number;
-        rentTtlSeconds?: number;
-        properties?: SeedPropertyInput[];
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /** List plots with parsed state (grid, price, current owner). */
-    list(): Promise<KitPlot[]>;
-    /**
-     * Buy a plot: spends the price from the caller's wallet AND grants the
-     * blueprint's grid permissions in one transaction. Resolves with the
-     * wallet's remaining balance.
-     */
-    buy(plotId: string, walletId: string): Promise<KitInvokeResult<number>>;
-    /**
-     * Rent a plot (blueprint deployed with `rentable: true`): like {@link buy}
-     * but the grant expires after the plot's `rent_ttl_seconds`.
-     */
-    rent(plotId: string, walletId: string): Promise<KitInvokeResult<number>>;
-    /** Revoke a user's permissions on a plot (plot owner or app admin). */
-    evict(plotId: string, targetUserId: Scalars['BigInt']['input']): Promise<KitInvokeResult>;
-    /**
-     * A user's effective permission keys on a plot's grid (for HUD display —
-     * enforcement happens server-side regardless).
-     */
-    accessOf(userId: Scalars['BigInt']['input'], gridId: Scalars['BigInt']['input']): Promise<string[]>;
-}
-//# sourceMappingURL=plots.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plots.d.ts","sourceRoot":"","sources":["../../src/kit/plots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAQ;IAIjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGf,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,WAAW,EACtC,OAAO,GAAE,eAAoB;IAK/B;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;KAClC;;;;;;;;;;;IA0BD,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA2BhC;;;;OAIG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS7E;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS9E,uEAAuE;IACjE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAS/F;;;OAGG;IACG,QAAQ,CACZ,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC;CAQrB"}

package/dist/kit/plots.js

@@ -1,113 +0,0 @@
-import { plotNames } from './blueprints/index.js';
-import { kitContainerProperties, kitInvoke, } from './shared.js';
-/**
- * Runtime helpers for the {@link plotBlueprint} conventions: list/create
- * plots and drive the buy/rent/evict functions whose permission effects grant
- * or revoke real, replication-enforced grid permissions transactionally with
- * the currency mutation. Authorization (wallet ownership, price, plot
- * ownership) is enforced server-side — a denial resolves with
- * `success: false`, never an exception.
- *
- * Obtained via `client.kit(appId).plots`.
- */
-export class PlotsKit {
-    constructor(appId, gameModel, gameApps, options = {}) {
-        this.appId = appId;
-        this.gameModel = gameModel;
-        this.gameApps = gameApps;
-        this.names = plotNames(options.typeName);
-    }
-    /**
-     * Instantiate a plot over an existing grid (admin — the type is
-     * admin-instantiable). Create the grid first (`client.gameApps.createGrid`)
-     * and pass its id here.
-     */
-    async create(input) {
-        const properties = [
-            { key: 'grid_id', valueType: 'int', valueJson: String(input.gridId) },
-            { key: 'price', valueType: 'int', valueJson: String(input.price) },
-            ...(input.rentPrice !== undefined
-                ? [{ key: 'rent_price', valueType: 'int', valueJson: String(input.rentPrice) }]
-                : []),
-            ...(input.rentTtlSeconds !== undefined
-                ? [
-                    {
-                        key: 'rent_ttl_seconds',
-                        valueType: 'int',
-                        valueJson: String(input.rentTtlSeconds),
-                    },
-                ]
-                : []),
-            ...(input.properties ?? []),
-        ];
-        return this.gameModel.createContainer({
-            appId: this.appId,
-            typeName: this.names.plotType,
-            displayName: input.displayName,
-            properties,
-        });
-    }
-    /** List plots with parsed state (grid, price, current owner). */
-    async list() {
-        const containers = await this.gameModel.containers({
-            appId: this.appId,
-            typeName: this.names.plotType,
-        });
-        return Promise.all(containers.map(async (c) => {
-            const props = await kitContainerProperties(this.gameModel, String(this.appId), c.containerId);
-            return {
-                containerId: c.containerId,
-                displayName: c.displayName,
-                gridId: Number(props.grid_id ?? 0),
-                price: Number(props.price ?? 0),
-                ownerUserId: Number(props.owner_user_id ?? 0),
-                ...(props.rent_price !== undefined ? { rentPrice: Number(props.rent_price) } : {}),
-                ...(props.rent_ttl_seconds !== undefined
-                    ? { rentTtlSeconds: Number(props.rent_ttl_seconds) }
-                    : {}),
-            };
-        }));
-    }
-    /**
-     * Buy a plot: spends the price from the caller's wallet AND grants the
-     * blueprint's grid permissions in one transaction. Resolves with the
-     * wallet's remaining balance.
-     */
-    async buy(plotId, walletId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.buyFn,
-            selfContainerId: plotId,
-            params: { wallet_id: walletId },
-        });
-    }
-    /**
-     * Rent a plot (blueprint deployed with `rentable: true`): like {@link buy}
-     * but the grant expires after the plot's `rent_ttl_seconds`.
-     */
-    async rent(plotId, walletId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.rentFn,
-            selfContainerId: plotId,
-            params: { wallet_id: walletId },
-        });
-    }
-    /** Revoke a user's permissions on a plot (plot owner or app admin). */
-    async evict(plotId, targetUserId) {
-        return kitInvoke(this.gameModel, {
-            appId: String(this.appId),
-            functionName: this.names.evictFn,
-            selfContainerId: plotId,
-            params: { target_user_id: Number(targetUserId) },
-        });
-    }
-    /**
-     * A user's effective permission keys on a plot's grid (for HUD display —
-     * enforcement happens server-side regardless).
-     */
-    async accessOf(userId, gridId) {
-        const res = await this.gameApps.userPermissions(String(this.appId), String(gridId), String(userId));
-        return [...res.permissionKeys];
-    }
-}

package/dist/kit/progression.d.ts

@@ -1,181 +0,0 @@
-import type { GameModelAPI } from '../domains/gameModel.js';
-import type { Scalars, SeedPropertyInput } from '../generated/graphql.js';
-import { type KitInvokeResult } from './shared.js';
-/** Options for {@link ProgressionKit}. Must match the deployed blueprint. */
-export interface ProgressionKitOptions {
-    /** The `typePrefix` the progression blueprint was deployed with. */
-    typePrefix?: string;
-}
-/** A parsed view of one player's progression. */
-export interface KitProgress {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    xp: number;
-    level: number;
-    skillPoints: number;
-    rating: number;
-}
-/** A parsed view of one skill catalog row. */
-export interface KitSkillDef {
-    containerId: string;
-    displayName: string;
-    skillId: string;
-    cost: number;
-    requiresSkillId: string;
-    maxRank: number;
-}
-/** A parsed view of one player skill rank. */
-export interface KitSkillRank {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    skillId: string;
-    rank: number;
-}
-/** A parsed view of one achievement definition. */
-export interface KitAchievementDef {
-    containerId: string;
-    displayName: string;
-    achievementId: string;
-    threshold: number;
-}
-/** A parsed view of one player achievement unlock. */
-export interface KitAchievementUnlock {
-    containerId: string;
-    displayName: string;
-    ownerUserId: string | null;
-    achievementId: string;
-    unlocked: boolean;
-}
-/**
- * Runtime helpers for the {@link progressionBlueprint} conventions: ensure a
- * player's `Progress`, grant XP (trusted — app admins by default), buy
- * skills against the catalog's costs and prerequisites, unlock threshold
- * achievements, and apply match rating results. Everything is
- * authority-checked server-side; denials resolve with `success: false`.
- *
- * Obtained via `client.kit(appId).progression`.
- */
-export declare class ProgressionKit {
-    private readonly appId;
-    private readonly gameModel;
-    private readonly names;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: ProgressionKitOptions);
-    /**
-     * Find the player's Progress container, creating it when absent (with the
-     * `owner_user_id` mirror the guards read).
-     */
-    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;
-    }>;
-    /** Read one player's progression state. */
-    state(progressId: string): Promise<KitProgress>;
-    /**
-     * Grant XP — a **trusted** call (default blueprint authority: app admins
-     * via server scope; or drive it from an event automation). Awards skill
-     * points and levels up when the curve is crossed. Resolves with the new
-     * level.
-     */
-    grantXp(progressId: string, amount: number): Promise<KitInvokeResult<number>>;
-    /** List the skill catalog (admin-seeded SkillDef containers). */
-    skillCatalog(): Promise<KitSkillDef[]>;
-    /** Define a skill (admin — the catalog type is admin-instantiable). */
-    defineSkill(input: {
-        skillId: string;
-        cost?: number;
-        requiresSkillId?: string;
-        maxRank?: number;
-        displayName?: string;
-        properties?: SeedPropertyInput[];
-    }): Promise<{
-        __typename?: "GmContainer";
-        containerId: string;
-        appId: string;
-        sessionId: string | null;
-        typeName: string;
-        displayName: string;
-        description: string | null;
-        ownerUserId: string | null;
-        metadataJson: string;
-    }>;
-    /**
-     * Find-or-create the caller's SkillRank row for a skill (rank 0 until
-     * bought).
-     */
-    ensureSkillRank(ownerUserId: Scalars['BigInt']['input'], skillId: 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;
-    }>;
-    /**
-     * Buy one rank of a skill. `prereqRankId` is the caller's SkillRank for
-     * the prerequisite skill; omit it for skills without one (the rank row
-     * itself is passed to satisfy the required param — the condition ignores
-     * it when the def declares no prerequisite).
-     */
-    buySkill(input: {
-        skillRankId: string;
-        progressId: string;
-        skillDefId: string;
-        prereqRankId?: string;
-    }): Promise<KitInvokeResult<number>>;
-    /** List a player's skill ranks. */
-    skills(ownerUserId: Scalars['BigInt']['input']): Promise<KitSkillRank[]>;
-    /** List the achievement catalog (admin-seeded AchievementDef containers). */
-    achievementCatalog(): Promise<KitAchievementDef[]>;
-    /** Define an achievement (admin). */
-    defineAchievement(input: {
-        achievementId: string;
-        threshold: number;
-        displayName?: 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 achievement unlocks. */
-    achievements(ownerUserId: Scalars['BigInt']['input']): Promise<KitAchievementUnlock[]>;
-    /**
-     * Unlock an achievement once its xp threshold is met. Creates the caller's
-     * unlock row when absent, then invokes the gated function (idempotent).
-     */
-    unlockAchievement(input: {
-        ownerUserId: Scalars['BigInt']['input'];
-        progressId: string;
-        achievementDefId: string;
-        achievementId: string;
-    }): Promise<KitInvokeResult<boolean>>;
-    /**
-     * Apply a match result as a rating delta (trusted — host-gated by
-     * default; `kit.matches` computes the delta). Resolves with the new
-     * rating.
-     */
-    applyMatchResult(progressId: string, delta: number): Promise<KitInvokeResult<number>>;
-}
-//# sourceMappingURL=progression.d.ts.map

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

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