@crowdedkingdoms/crowdyjs 18.12.0-dev.1 → 18.13.0-dev.1

package/dist/index.d.ts

@@ -46,7 +46,7 @@
  * never an untrusted browser.
  */
 /** The published package version. Mirrors `package.json`. */
-export declare const VERSION = "18.12.0-dev.1";
+export declare const VERSION = "18.13.0-dev.1";
 export { LbCookieStore } from './lb-cookie-store.js';
 export { CrowdyClient, createCrowdyClient, type CrowdyClientConfig, } from './crowdy-client.js';
 export { CROWDY_DEFAULT_TIER, CROWDY_DEFAULT_HOST, CROWDY_DEFAULT_HTTP_ORIGIN, CROWDY_DEFAULT_WS_ORIGIN, } from './default-origin.js';

package/dist/index.js

@@ -46,7 +46,7 @@
  * never an untrusted browser.
  */
 /** The published package version. Mirrors `package.json`. */
-export const VERSION = '18.12.0-dev.1';
+export const VERSION = '18.13.0-dev.1';
 export { LbCookieStore } from './lb-cookie-store.js';
 export { CrowdyClient, createCrowdyClient, } from './crowdy-client.js';
 // The tier this build defaults to, exported so a consumer can PRINT what it is

package/dist/kit/index.d.ts

@@ -22,4 +22,6 @@ export { InstanceRun, InstancesKit, type InstanceMember, type InstanceRoom, type
 export { ArenaMatch, ArenasKit, type ArenaBlast, type ArenaFighter, type ArenaShot, type ArenaView, } from './modules/arenas.js';
 export { BallMatch, Race, RacingKit, type BallPlayer, type BallState, type BallView, type RaceGate, type RaceGhost, type RaceRacer, type RaceView, } from './modules/racing.js';
 export { TerritoryKit, TerritoryMap, ZoneMatch, type TerritoryPoint, type TerritoryView, type ZoneContender, type ZoneView, } from './modules/territory.js';
+export { AchievementsKit, CraftingKit, InventoryKit, LootKit, PlayerKit, ProductionKit, ProgressionKit, QuestsKit, WalletKit, type AchievementView, type EconBundle, type EconRecipe, type EconStack, type InventoryView, type LootRoll, type LootTableView, type PlayerEarned, type PlayerEvent, type PlayerProfile, type PlayerRules, type PlayerView, type ProductionView, type ProgressView, type QuestObjectiveView, type QuestView, type WalletView, } from './modules/player.js';
+export { MarketCore, MarketHandle, MarketsKit, ShopHandle, ShopsKit, TradeDesk, TradesKit, type MarketBook, type MarketOrder, type MarketPlaced, type MarketQuote, type MarketTrade, type MarketTradeSide, type MarketView, type VendorOfferView, type VendorView, } from './modules/market.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/kit/index.js

@@ -22,3 +22,5 @@ export { InstanceRun, InstancesKit, } from './modules/instances.js';
 export { ArenaMatch, ArenasKit, } from './modules/arenas.js';
 export { BallMatch, Race, RacingKit, } from './modules/racing.js';
 export { TerritoryKit, TerritoryMap, ZoneMatch, } from './modules/territory.js';
+export { AchievementsKit, CraftingKit, InventoryKit, LootKit, PlayerKit, ProductionKit, ProgressionKit, QuestsKit, WalletKit, } from './modules/player.js';
+export { MarketCore, MarketHandle, MarketsKit, ShopHandle, ShopsKit, TradeDesk, TradesKit, } from './modules/market.js';

package/dist/kit/kit.d.ts

@@ -8,8 +8,10 @@ import { ArenasKit } from './modules/arenas.js';
 import { EncountersKit } from './modules/encounters.js';
 import { InstancesKit } from './modules/instances.js';
 import { LeaderboardsKit } from './modules/leaderboards.js';
+import { MarketsKit, ShopsKit, TradesKit } from './modules/market.js';
 import { MatchmakingKit } from './modules/matchmaking.js';
 import { MinigamesKit } from './modules/minigames.js';
+import { AchievementsKit, CraftingKit, InventoryKit, LootKit, PlayerKit, ProductionKit, ProgressionKit, QuestsKit, WalletKit } from './modules/player.js';
 import { NpcsKit } from './modules/npcs.js';
 import { EmotesKit, SpectateKit } from './modules/presence.js';
 import { RacingKit } from './modules/racing.js';
@@ -54,6 +56,10 @@ export interface GameKitNodeTypes {
     /** Control points (`territory`) and shrinking circles (`zone`). */
     territory?: string;
     zone?: string;
+    /** Each player's own hub (`player`): inventory, wallet, progression, crafting, loot. */
+    player?: string;
+    /** Markets (`market`): vendors, order books, trades. */
+    market?: string;
 }
 /** Options for {@link GameKitClient}. */
 export interface GameKitOptions extends KitRuntimeOptions {
@@ -89,7 +95,10 @@ export declare class ShardKit {
  * starter hubs (the root {@link world} with liveops, {@link matchmaking} queues with parties,
  * game {@link sessions}, areas of {@link npcs} with mobs and pets, {@link leaderboards}, card
  * {@link tables}, {@link tactics} battles, {@link encounters}, {@link minigames}, private
- * {@link instances}, {@link arenas}, {@link racing}, {@link territory}), the {@link topology}
+ * {@link instances}, {@link arenas}, {@link racing}, {@link territory}; the economy:
+ * {@link player}, {@link inventory}, {@link wallet}, {@link progression}, {@link achievements},
+ * {@link quests}, {@link crafting}, {@link loot}, {@link production}, {@link market},
+ * {@link shops}, {@link trades}), the {@link topology}
  * that deploys them, the client-side conventions ({@link spectate}, {@link emotes},
  * {@link shards}), and {@link social} (parties, guilds, chat over teams and channels).
  *
@@ -124,6 +133,9 @@ export declare class GameKitClient {
     private arenasKit;
     private racingKit;
     private territoryKit;
+    private playerKit;
+    private readonly economy;
+    private readonly markets;
     constructor(appId: Scalars['BigInt']['input'], gameApps: GameAppsAPI, options?: GameKitOptions, domains?: GameKitDomains);
     /** The root world hub: conditions, resource nodes, liveops. */
     get world(): WorldKit;
@@ -151,6 +163,33 @@ export declare class GameKitClient {
     get racing(): RacingKit;
     /** Control points factions capture, and shrinking circles. */
     get territory(): TerritoryKit;
+    /**
+     * The caller's own `player` hub: what they own and what they did. The economy lives in hub
+     * state and is not a ledger. The modules below are views of it.
+     */
+    get player(): PlayerKit;
+    private view;
+    /** The player's items: stacks in slots, and mail for what did not fit. */
+    get inventory(): InventoryKit;
+    /** The player's soft currencies. */
+    get wallet(): WalletKit;
+    /** Experience, levels and public profiles. */
+    get progression(): ProgressionKit;
+    get achievements(): AchievementsKit;
+    /** Quests, first-session tutorials among them. */
+    get quests(): QuestsKit;
+    get crafting(): CraftingKit;
+    /** Loot tables with pity. */
+    get loot(): LootKit;
+    /** Idle production that catches up on the time away. */
+    get production(): ProductionKit;
+    private marketCore;
+    /** Markets' order books. */
+    get market(): MarketsKit;
+    /** Markets' vendors. */
+    get shops(): ShopsKit;
+    /** Trades between two players at a market. */
+    get trades(): TradesKit;
     /** Composing and deploying the app's tree of starter hubs (developers). */
     get topology(): KitTopology;
     /** Keeping a viewer with no avatar where the world's messages reach it. */

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

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

package/dist/kit/kit.js

@@ -2,8 +2,10 @@ import { ArenasKit } from './modules/arenas.js';
 import { EncountersKit } from './modules/encounters.js';
 import { InstancesKit } from './modules/instances.js';
 import { LeaderboardsKit } from './modules/leaderboards.js';
+import { MarketCore, MarketsKit, ShopsKit, TradesKit } from './modules/market.js';
 import { MatchmakingKit } from './modules/matchmaking.js';
 import { MinigamesKit } from './modules/minigames.js';
+import { AchievementsKit, CraftingKit, InventoryKit, LootKit, PlayerKit, ProductionKit, ProgressionKit, QuestsKit, WalletKit, } from './modules/player.js';
 import { NpcsKit } from './modules/npcs.js';
 import { EmotesKit, SpectateKit } from './modules/presence.js';
 import { RacingKit } from './modules/racing.js';
@@ -32,7 +34,10 @@ export class ShardKit {
  * starter hubs (the root {@link world} with liveops, {@link matchmaking} queues with parties,
  * game {@link sessions}, areas of {@link npcs} with mobs and pets, {@link leaderboards}, card
  * {@link tables}, {@link tactics} battles, {@link encounters}, {@link minigames}, private
- * {@link instances}, {@link arenas}, {@link racing}, {@link territory}), the {@link topology}
+ * {@link instances}, {@link arenas}, {@link racing}, {@link territory}; the economy:
+ * {@link player}, {@link inventory}, {@link wallet}, {@link progression}, {@link achievements},
+ * {@link quests}, {@link crafting}, {@link loot}, {@link production}, {@link market},
+ * {@link shops}, {@link trades}), the {@link topology}
  * that deploys them, the client-side conventions ({@link spectate}, {@link emotes},
  * {@link shards}), and {@link social} (parties, guilds, chat over teams and channels).
  *
@@ -64,6 +69,17 @@ export class GameKitClient {
         this.arenasKit = null;
         this.racingKit = null;
         this.territoryKit = null;
+        this.playerKit = null;
+        this.economy = new Map();
+        this.markets = new Map();
+        this.marketCore = (key) => {
+            let core = this.markets.get(key);
+            if (!core) {
+                core = new MarketCore(this.runtime, this.options.nodes?.market ?? 'market', key);
+                this.markets.set(key, core);
+            }
+            return core;
+        };
         this.social = new SocialKit(appId, domains.teams, domains.channels, domains.udp, gameApps, options.social);
         this.runtime = new KitRuntime(String(appId), domains.exec, options, domains.whoAmI);
     }
@@ -123,6 +139,60 @@ export class GameKitClient {
     get territory() {
         return (this.territoryKit ?? (this.territoryKit = new TerritoryKit(this.runtime, this.options.nodes?.territory, this.options.nodes?.zone)));
     }
+    /**
+     * The caller's own `player` hub: what they own and what they did. The economy lives in hub
+     * state and is not a ledger. The modules below are views of it.
+     */
+    get player() {
+        return (this.playerKit ?? (this.playerKit = new PlayerKit(this.runtime, this.options.nodes?.player)));
+    }
+    view(name, make) {
+        if (!this.economy.has(name))
+            this.economy.set(name, make(this.player));
+        return this.economy.get(name);
+    }
+    /** The player's items: stacks in slots, and mail for what did not fit. */
+    get inventory() {
+        return this.view('inventory', (p) => new InventoryKit(p));
+    }
+    /** The player's soft currencies. */
+    get wallet() {
+        return this.view('wallet', (p) => new WalletKit(p));
+    }
+    /** Experience, levels and public profiles. */
+    get progression() {
+        return this.view('progression', (p) => new ProgressionKit(p));
+    }
+    get achievements() {
+        return this.view('achievements', (p) => new AchievementsKit(p));
+    }
+    /** Quests, first-session tutorials among them. */
+    get quests() {
+        return this.view('quests', (p) => new QuestsKit(p));
+    }
+    get crafting() {
+        return this.view('crafting', (p) => new CraftingKit(p));
+    }
+    /** Loot tables with pity. */
+    get loot() {
+        return this.view('loot', (p) => new LootKit(p));
+    }
+    /** Idle production that catches up on the time away. */
+    get production() {
+        return this.view('production', (p) => new ProductionKit(p));
+    }
+    /** Markets' order books. */
+    get market() {
+        return this.view('market', () => new MarketsKit(this.marketCore));
+    }
+    /** Markets' vendors. */
+    get shops() {
+        return this.view('shops', () => new ShopsKit(this.marketCore));
+    }
+    /** Trades between two players at a market. */
+    get trades() {
+        return this.view('trades', () => new TradesKit(this.marketCore));
+    }
     /** Composing and deploying the app's tree of starter hubs (developers). */
     get topology() {
         return (this.topologyKit ?? (this.topologyKit = new KitTopology(String(this.appId), this.domains.exec)));

package/dist/kit/modules/market.d.ts

@@ -0,0 +1,159 @@
+import { HubState, PrivateState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+import type { EconBundle } from './player.js';
+export interface VendorOfferView {
+    item: string;
+    price: EconBundle;
+    /** Left on the shelf; null for no limit. */
+    stock: number | null;
+    per_player: number | null;
+    /** What the vendor pays for one; null when it does not buy them. */
+    buys_for: EconBundle | null;
+}
+export interface VendorView {
+    id: string;
+    offers: VendorOfferView[];
+    restocked_at: number;
+}
+export interface MarketQuote {
+    bid: number | null;
+    ask: number | null;
+    last: number | null;
+}
+/** What the `market` topic carries. */
+export interface MarketView {
+    vendors: VendorView[];
+    currency: string;
+    quotes: Record<string, MarketQuote>;
+    open_trades: number;
+    pending_steps: number;
+}
+export interface MarketBook {
+    item: string;
+    currency: string;
+    /** `[price, count]` a level, best first. */
+    bids: Array<[number, number]>;
+    asks: Array<[number, number]>;
+    last: number | null;
+}
+export interface MarketOrder {
+    id: number;
+    player: number;
+    item: string;
+    side: 'buy' | 'sell';
+    price: number;
+    count: number;
+    /** What is still open. */
+    open: number;
+    /** The hold that backs it, in the player's hub. */
+    hold: string;
+}
+export interface MarketPlaced {
+    order: number;
+    /** `[price, count]` it traded at once. */
+    fills: Array<[number, number]>;
+    open: number;
+}
+export interface MarketTradeSide {
+    bundle: EconBundle;
+    hold: string | null;
+    accepted: boolean;
+}
+export interface MarketTrade {
+    id: number;
+    players: [number, number];
+    sides: [MarketTradeSide, MarketTradeSide];
+    state: 'open' | 'settling' | 'done' | 'cancelled';
+    expires_at: number;
+    offers: number;
+}
+/** One market hub's mirrors and calls, shared by its market, shop and trade handles. */
+export declare class MarketCore {
+    readonly runtime: KitRuntime;
+    readonly nodeType: string;
+    readonly key: string;
+    readonly view: HubState<MarketView>;
+    /** The caller's open orders, read again when the market says they moved. */
+    readonly orders: PrivateState<MarketOrder[]>;
+    /** The caller's open and settling trades. */
+    readonly trades: PrivateState<MarketTrade[]>;
+    constructor(runtime: KitRuntime, nodeType: string, key: string);
+    change<T>(method: string, args: unknown): Promise<T>;
+}
+/** Markets' order books (the `market` starter): {@link at} a market by its name. */
+export declare class MarketsKit {
+    private readonly core;
+    constructor(core: (key: string) => MarketCore);
+    at(key?: string): MarketHandle;
+}
+/**
+ * A market's order books: limit orders matched at price-time priority. An order holds what it
+ * offers in the player's own hub until it fills or is cancelled; the market moves each fill
+ * between the two players' hubs.
+ */
+export declare class MarketHandle {
+    private readonly core;
+    constructor(core: MarketCore);
+    get view(): HubState<MarketView>;
+    get orders(): PrivateState<MarketOrder[]>;
+    watch(): Promise<MarketView>;
+    unwatch(): Promise<void>;
+    book(item: string): Promise<MarketBook>;
+    /**
+     * Places a limit order; a buy holds `price * count` of the market's currency, a sell the items.
+     * @throws {KitError} `insufficient`, `limit` (open orders), `not_found` (no book), `unavailable`.
+     */
+    order(order: {
+        item: string;
+        side: 'buy' | 'sell';
+        price: number;
+        count: number;
+    }): Promise<MarketPlaced>;
+    /** Cancels an open order; what it still holds comes back. @throws {KitError} `not_found`. */
+    cancel(order: number): Promise<boolean>;
+}
+/** Markets' vendors (the `market` starter): {@link at} a market by its name. */
+export declare class ShopsKit {
+    private readonly core;
+    constructor(core: (key: string) => MarketCore);
+    at(key?: string): ShopHandle;
+}
+/** A market's vendors: fixed prices, stock that restocks, a limit per player. */
+export declare class ShopHandle {
+    private readonly core;
+    constructor(core: MarketCore);
+    get view(): HubState<MarketView>;
+    watch(): Promise<MarketView>;
+    unwatch(): Promise<void>;
+    vendors(): Promise<VendorView[]>;
+    /** Buys `count` (one by default). @throws {KitError} `insufficient` (gold or stock), `limit`, `full`, `not_found`, `unavailable`. */
+    buy(vendor: string, item: string, count?: number): Promise<EconBundle>;
+    /** Sells `count` (one by default). @throws {KitError} `forbidden` (it does not buy them), `insufficient`, `unavailable`. */
+    sell(vendor: string, item: string, count?: number): Promise<EconBundle>;
+}
+/** Trades between two players at a market: {@link at} a market by its name. */
+export declare class TradesKit {
+    private readonly core;
+    constructor(core: (key: string) => MarketCore);
+    at(key?: string): TradeDesk;
+}
+/**
+ * Trades between two players: each offers a bundle, held in their own hub; when both accept
+ * the last offers, the market moves each to the other. A changed offer clears both acceptances.
+ */
+export declare class TradeDesk {
+    private readonly core;
+    constructor(core: MarketCore);
+    get mine(): PrivateState<MarketTrade[]>;
+    watch(): Promise<MarketTrade[]>;
+    unwatch(): Promise<void>;
+    /** Opens a trade with `player`; resolves with its id. */
+    open(player: number | string): Promise<number>;
+    /** Offers `bundle` (held at once; an empty one withdraws). @throws {KitError} `insufficient`, `forbidden`, `finished`. */
+    offer(trade: number, bundle: Partial<EconBundle>): Promise<boolean>;
+    /** Accepts the offers as they stand; resolves with the trade's state. @throws {KitError} `not_ready`, `finished`. */
+    accept(trade: number): Promise<MarketTrade['state']>;
+    /** Calls it off; what each offered comes back. */
+    decline(trade: number): Promise<boolean>;
+}
+//# sourceMappingURL=market.d.ts.map

package/dist/kit/modules/market.d.ts.map

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

package/dist/kit/modules/market.js

@@ -0,0 +1,141 @@
+import { HubState, PrivateState } from '../mirror.js';
+const TOPIC = 'market';
+/** One market hub's mirrors and calls, shared by its market, shop and trade handles. */
+export class MarketCore {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, TOPIC);
+        const source = { nodeType, key, topic: TOPIC };
+        this.orders = new PrivateState(runtime, { ...source, what: 'orders', read: () => runtime.call(nodeType, key, 'orders') });
+        this.trades = new PrivateState(runtime, { ...source, what: 'trades', read: () => runtime.call(nodeType, key, 'trades') });
+    }
+    change(method, args) {
+        return this.runtime.call(this.nodeType, this.key, method, args, { action: true });
+    }
+}
+/** Markets' order books (the `market` starter): {@link at} a market by its name. */
+export class MarketsKit {
+    constructor(core) {
+        this.core = core;
+    }
+    at(key = 'town') {
+        return new MarketHandle(this.core(key));
+    }
+}
+/**
+ * A market's order books: limit orders matched at price-time priority. An order holds what it
+ * offers in the player's own hub until it fills or is cancelled; the market moves each fill
+ * between the two players' hubs.
+ */
+export class MarketHandle {
+    constructor(core) {
+        this.core = core;
+    }
+    get view() {
+        return this.core.view;
+    }
+    get orders() {
+        return this.core.orders;
+    }
+    async watch() {
+        const [view] = await Promise.all([this.core.view.start(), this.core.orders.start()]);
+        return view;
+    }
+    async unwatch() {
+        await Promise.all([this.core.view.stop(), this.core.orders.stop()]);
+    }
+    book(item) {
+        return this.core.runtime.call(this.core.nodeType, this.core.key, 'book', { item });
+    }
+    /**
+     * Places a limit order; a buy holds `price * count` of the market's currency, a sell the items.
+     * @throws {KitError} `insufficient`, `limit` (open orders), `not_found` (no book), `unavailable`.
+     */
+    order(order) {
+        return this.core.change('order', order);
+    }
+    /** Cancels an open order; what it still holds comes back. @throws {KitError} `not_found`. */
+    cancel(order) {
+        return this.core.change('cancel', { order });
+    }
+}
+/** Markets' vendors (the `market` starter): {@link at} a market by its name. */
+export class ShopsKit {
+    constructor(core) {
+        this.core = core;
+    }
+    at(key = 'town') {
+        return new ShopHandle(this.core(key));
+    }
+}
+/** A market's vendors: fixed prices, stock that restocks, a limit per player. */
+export class ShopHandle {
+    constructor(core) {
+        this.core = core;
+    }
+    get view() {
+        return this.core.view;
+    }
+    watch() {
+        return this.core.view.start();
+    }
+    unwatch() {
+        return this.core.view.stop();
+    }
+    vendors() {
+        return this.core.runtime.call(this.core.nodeType, this.core.key, 'vendors');
+    }
+    /** Buys `count` (one by default). @throws {KitError} `insufficient` (gold or stock), `limit`, `full`, `not_found`, `unavailable`. */
+    buy(vendor, item, count) {
+        return this.core.change('buy', count === undefined ? { vendor, item } : { vendor, item, count });
+    }
+    /** Sells `count` (one by default). @throws {KitError} `forbidden` (it does not buy them), `insufficient`, `unavailable`. */
+    sell(vendor, item, count) {
+        return this.core.change('sell', count === undefined ? { vendor, item } : { vendor, item, count });
+    }
+}
+/** Trades between two players at a market: {@link at} a market by its name. */
+export class TradesKit {
+    constructor(core) {
+        this.core = core;
+    }
+    at(key = 'town') {
+        return new TradeDesk(this.core(key));
+    }
+}
+/**
+ * Trades between two players: each offers a bundle, held in their own hub; when both accept
+ * the last offers, the market moves each to the other. A changed offer clears both acceptances.
+ */
+export class TradeDesk {
+    constructor(core) {
+        this.core = core;
+    }
+    get mine() {
+        return this.core.trades;
+    }
+    async watch() {
+        return this.core.trades.start();
+    }
+    unwatch() {
+        return this.core.trades.stop();
+    }
+    /** Opens a trade with `player`; resolves with its id. */
+    open(player) {
+        return this.core.change('trade', { with: Number(player) });
+    }
+    /** Offers `bundle` (held at once; an empty one withdraws). @throws {KitError} `insufficient`, `forbidden`, `finished`. */
+    offer(trade, bundle) {
+        return this.core.change('offer', { trade, bundle });
+    }
+    /** Accepts the offers as they stand; resolves with the trade's state. @throws {KitError} `not_ready`, `finished`. */
+    accept(trade) {
+        return this.core.change('accept', { trade });
+    }
+    /** Calls it off; what each offered comes back. */
+    decline(trade) {
+        return this.core.change('decline', { trade });
+    }
+}