@crowdedkingdoms/crowdyjs 8.2.0 → 8.3.0

package/dist/kit/economy.js

@@ -0,0 +1,365 @@
+import { economyCurrencyFn, economyNames, } from './blueprints/index.js';
+import { kitContainerProperties, kitInvoke, } from './shared.js';
+/**
+ * Runtime helpers for the {@link economyBlueprint} conventions: wallets with
+ * per-currency balances, shop purchases, escrow trades, and player market
+ * listings. Every movement of currency or items is a single gated invoke —
+ * balances, stock, item identity, and ownership are all verified
+ * server-side, and a denial resolves with `success: false` (never an
+ * exception).
+ *
+ * `earn` is a trusted grant: with the default blueprint authority
+ * (`'server'`) it succeeds only for app admins — call it from studio/backend
+ * code, or drive grants through automations instead.
+ *
+ * Obtained via `client.kit(appId).economy`.
+ */
+export class EconomyKit {
+    constructor(appId, gameModel, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        /** Shop (admin-priced listings; atomic buys). */
+        this.shop = {
+            /**
+             * Create a shop listing (admin — the type is admin-instantiable).
+             * `maxStock` feeds the optional restock automation.
+             */
+            create: async (input) => {
+                return this.gameModel.createContainer({
+                    appId: this.appId,
+                    typeName: this.names.listingType,
+                    displayName: input.displayName,
+                    properties: [
+                        { key: 'item_id', valueType: 'string', valueJson: JSON.stringify(input.itemId) },
+                        { key: 'price', valueType: 'int', valueJson: String(input.price) },
+                        { key: 'stock', valueType: 'int', valueJson: String(input.stock ?? 0) },
+                        {
+                            key: 'max_stock',
+                            valueType: 'int',
+                            valueJson: String(input.maxStock ?? input.stock ?? 0),
+                        },
+                        ...(input.properties ?? []),
+                    ],
+                });
+            },
+            /** List shop listings with parsed state. */
+            list: async () => {
+                const containers = await this.gameModel.containers({
+                    appId: this.appId,
+                    typeName: this.names.listingType,
+                });
+                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,
+                        itemId: String(props.item_id ?? ''),
+                        price: Number(props.price ?? 0),
+                        stock: Number(props.stock ?? 0),
+                        maxStock: Number(props.max_stock ?? 0),
+                    };
+                }));
+            },
+            /**
+             * Buy one unit: wallet debit + stock decrement + item grant into
+             * `toStackId` (a stack of the listed item), all in one transaction.
+             * Resolves with the wallet's remaining balance.
+             */
+            buy: async (input) => {
+                return kitInvoke(this.gameModel, {
+                    appId: String(this.appId),
+                    functionName: this.names.buyListingFn,
+                    selfContainerId: input.listingId,
+                    params: { wallet_id: input.walletId, to_stack_id: input.toStackId },
+                });
+            },
+        };
+        /** Escrow trades (player↔player item swaps, atomic on accept). */
+        this.trades = {
+            /**
+             * Create a trade offer to another player. The stacks named here are the
+             * OFFERER's: `giveStackId` is the escrowed source, `receiveStackId`
+             * receives the wanted items when the trade is accepted. The offer's
+             * container ownership (server-assigned to the caller) is what the accept
+             * guards trust — a forged offer over someone else's stacks can never be
+             * accepted.
+             */
+            offer: async (input) => {
+                return this.gameModel.createContainer({
+                    appId: this.appId,
+                    typeName: this.names.tradeType,
+                    displayName: input.displayName ??
+                        `Trade ${input.giveQty}x ${input.giveItemId} for ${input.wantQty}x ${input.wantItemId}`,
+                    ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
+                    properties: [
+                        { key: 'to_user_id', valueType: 'int', valueJson: String(input.toUserId) },
+                        {
+                            key: 'give_stack_id',
+                            valueType: 'string',
+                            valueJson: JSON.stringify(input.giveStackId),
+                        },
+                        {
+                            key: 'receive_stack_id',
+                            valueType: 'string',
+                            valueJson: JSON.stringify(input.receiveStackId),
+                        },
+                        {
+                            key: 'give_item_id',
+                            valueType: 'string',
+                            valueJson: JSON.stringify(input.giveItemId),
+                        },
+                        { key: 'give_qty', valueType: 'int', valueJson: String(input.giveQty) },
+                        {
+                            key: 'want_item_id',
+                            valueType: 'string',
+                            valueJson: JSON.stringify(input.wantItemId),
+                        },
+                        { key: 'want_qty', valueType: 'int', valueJson: String(input.wantQty) },
+                    ],
+                });
+            },
+            /**
+             * Accept a trade as the invited player, supplying YOUR two stacks: the
+             * one paying the wanted items and the one receiving the given items. The
+             * offerer's stacks come from the offer record. All four quantity writes
+             * commit atomically or not at all.
+             */
+            accept: async (input) => {
+                const offer = await this.trades.get(input.offerId);
+                return kitInvoke(this.gameModel, {
+                    appId: String(this.appId),
+                    functionName: this.names.acceptTradeFn,
+                    selfContainerId: input.offerId,
+                    params: {
+                        give_stack_id: offer.giveStackId,
+                        to_give_stack_id: input.toGiveStackId,
+                        want_stack_id: input.wantStackId,
+                        to_want_stack_id: offer.receiveStackId,
+                    },
+                });
+            },
+            /** Cancel an open trade (either party may). */
+            cancel: async (offerId) => {
+                return kitInvoke(this.gameModel, {
+                    appId: String(this.appId),
+                    functionName: this.names.cancelTradeFn,
+                    selfContainerId: offerId,
+                    params: {},
+                });
+            },
+            /** Read one trade offer with parsed state. */
+            get: async (offerId) => {
+                const container = await this.gameModel.container({
+                    appId: this.appId,
+                    containerId: offerId,
+                });
+                return this.toTrade(container.containerId, container.displayName, container.ownerUserId != null ? String(container.ownerUserId) : null);
+            },
+            /** List trades the user created or was invited to (open ones first). */
+            listMine: async (userId) => {
+                const containers = await this.gameModel.containers({
+                    appId: this.appId,
+                    typeName: this.names.tradeType,
+                });
+                const all = await Promise.all(containers.map((c) => this.toTrade(c.containerId, c.displayName, c.ownerUserId != null ? String(c.ownerUserId) : null)));
+                const uid = String(userId);
+                return all
+                    .filter((t) => t.fromUserId === uid || String(t.toUserId) === uid)
+                    .sort((a, b) => Number(b.status === 'open') - Number(a.status === 'open'));
+            },
+        };
+        /** Player market (list a stack for currency; atomic purchases). */
+        this.market = {
+            /**
+             * List items for sale: names YOUR escrowed source stack and the ask
+             * price. Payment lands straight in your wallet when someone buys.
+             */
+            list: async (input) => {
+                return this.gameModel.createContainer({
+                    appId: this.appId,
+                    typeName: this.names.marketType,
+                    displayName: input.displayName ?? `${input.quantity}x ${input.itemId} for ${input.price}`,
+                    ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
+                    properties: [
+                        {
+                            key: 'stack_id',
+                            valueType: 'string',
+                            valueJson: JSON.stringify(input.stackId),
+                        },
+                        {
+                            key: 'item_id',
+                            valueType: 'string',
+                            valueJson: JSON.stringify(input.itemId),
+                        },
+                        { key: 'quantity', valueType: 'int', valueJson: String(input.quantity) },
+                        { key: 'price', valueType: 'int', valueJson: String(input.price) },
+                    ],
+                });
+            },
+            /** Browse market listings (active ones only by default). */
+            browse: async (options = {}) => {
+                const containers = await this.gameModel.containers({
+                    appId: this.appId,
+                    typeName: this.names.marketType,
+                });
+                const all = 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,
+                        sellerUserId: c.ownerUserId != null ? String(c.ownerUserId) : null,
+                        stackId: String(props.stack_id ?? ''),
+                        itemId: String(props.item_id ?? ''),
+                        quantity: Number(props.quantity ?? 0),
+                        price: Number(props.price ?? 0),
+                        active: props.active === true,
+                    };
+                }));
+                return options.includeInactive ? all : all.filter((l) => l.active);
+            },
+            /**
+             * Buy a market listing: pays the seller's wallet and transfers the items
+             * into `toStackId` in one transaction. The seller's wallet and source
+             * stack are resolved from the listing. Resolves with the buyer wallet's
+             * remaining balance.
+             */
+            buy: async (input) => {
+                const container = await this.gameModel.container({
+                    appId: this.appId,
+                    containerId: input.listingId,
+                });
+                const props = await kitContainerProperties(this.gameModel, String(this.appId), input.listingId);
+                if (container.ownerUserId == null) {
+                    throw new Error('Market listing has no seller (unowned container)');
+                }
+                const sellerWallet = await this.ensureSellerWallet(String(container.ownerUserId));
+                return kitInvoke(this.gameModel, {
+                    appId: String(this.appId),
+                    functionName: this.names.buyMarketFn,
+                    selfContainerId: input.listingId,
+                    params: {
+                        wallet_id: input.walletId,
+                        seller_wallet_id: sellerWallet,
+                        from_stack_id: String(props.stack_id ?? ''),
+                        to_stack_id: input.toStackId,
+                    },
+                });
+            },
+            /** Take a listing down (seller only). */
+            cancel: async (listingId) => {
+                return kitInvoke(this.gameModel, {
+                    appId: String(this.appId),
+                    functionName: this.names.cancelMarketFn,
+                    selfContainerId: listingId,
+                    params: {},
+                });
+            },
+        };
+        this.typePrefix = options.typePrefix ?? '';
+        this.names = economyNames(this.typePrefix);
+        this.currencies = options.currencies ?? ['gold'];
+    }
+    get defaultCurrency() {
+        return this.currencies[0];
+    }
+    /**
+     * Find the player's wallet, creating it when absent (member-instantiable;
+     * the server assigns ownership to the caller). Sets the `owner_user_id`
+     * mirror property the blueprint's guards read.
+     *
+     * @param ownerUserId - The calling player's user id (decimal string).
+     */
+    async ensureWallet(ownerUserId, options = {}) {
+        const existing = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.walletType,
+            ...(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.walletType,
+            displayName: options.displayName ?? `Wallet ${ownerUserId}`,
+            ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
+            properties: [
+                { key: 'owner_user_id', valueType: 'int', valueJson: String(ownerUserId) },
+            ],
+        });
+    }
+    /** Read one currency balance (default: the blueprint's first currency). */
+    async balance(walletId, currency) {
+        const props = await kitContainerProperties(this.gameModel, String(this.appId), walletId);
+        return Number(props[currency ?? this.defaultCurrency] ?? 0);
+    }
+    /** Read a wallet with every configured currency balance parsed. */
+    async wallet(walletId) {
+        const container = await this.gameModel.container({
+            appId: this.appId,
+            containerId: walletId,
+        });
+        const props = await kitContainerProperties(this.gameModel, String(this.appId), walletId);
+        const balances = {};
+        for (const c of this.currencies)
+            balances[c] = Number(props[c] ?? 0);
+        return {
+            containerId: container.containerId,
+            displayName: container.displayName,
+            ownerUserId: container.ownerUserId != null ? String(container.ownerUserId) : null,
+            balances,
+        };
+    }
+    /**
+     * Mint currency into a wallet — a **trusted** grant (default blueprint
+     * authority: app admins only). Resolves with the new balance.
+     */
+    async earn(walletId, amount, currency) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: economyCurrencyFn('earn', currency ?? this.defaultCurrency, this.typePrefix),
+            selfContainerId: walletId,
+            params: { amount },
+        });
+    }
+    /**
+     * Spend currency from the caller's own wallet. The server refuses to
+     * overdraw. Resolves with the new balance.
+     */
+    async spend(walletId, amount, currency) {
+        return kitInvoke(this.gameModel, {
+            appId: String(this.appId),
+            functionName: economyCurrencyFn('spend', currency ?? this.defaultCurrency, this.typePrefix),
+            selfContainerId: walletId,
+            params: { amount },
+        });
+    }
+    /** Find an existing wallet container id for a user (no creation). */
+    async ensureSellerWallet(sellerUserId) {
+        const wallets = await this.gameModel.containers({
+            appId: this.appId,
+            typeName: this.names.walletType,
+        });
+        const wallet = wallets.find((c) => c.ownerUserId != null && String(c.ownerUserId) === sellerUserId);
+        if (!wallet) {
+            throw new Error(`Seller ${sellerUserId} has no ${this.names.walletType}; they must ensureWallet() before selling`);
+        }
+        return wallet.containerId;
+    }
+    async toTrade(containerId, displayName, ownerUserId) {
+        const props = await kitContainerProperties(this.gameModel, String(this.appId), containerId);
+        return {
+            containerId,
+            displayName,
+            fromUserId: ownerUserId,
+            toUserId: Number(props.to_user_id ?? 0),
+            giveStackId: String(props.give_stack_id ?? ''),
+            receiveStackId: String(props.receive_stack_id ?? ''),
+            giveItemId: String(props.give_item_id ?? ''),
+            giveQty: Number(props.give_qty ?? 0),
+            wantItemId: String(props.want_item_id ?? ''),
+            wantQty: Number(props.want_qty ?? 0),
+            status: String(props.status ?? ''),
+        };
+    }
+}

package/dist/kit/features.d.ts

@@ -0,0 +1,60 @@
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars } from '../generated/graphql.js';
+import type { KitInvokePolicy } 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 declare class FeaturesKit {
+    private readonly appId;
+    private readonly gameModel;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI);
+    /** Define (or re-describe) a feature key for the app. */
+    define(featureKey: string, description?: string): Promise<{
+        __typename?: "GmAppFeature";
+        appId: string;
+        featureKey: string;
+        description: string | null;
+    }>;
+    /** List the app's defined feature keys. */
+    list(): Promise<{
+        __typename?: "GmAppFeature";
+        appId: string;
+        featureKey: string;
+        description: string | null;
+    }[]>;
+    /** Grant a feature to an access tier (its holders pass `tier_feature` checks). */
+    grantToTier(tierId: Scalars['BigInt']['input'], featureKey: string): Promise<{
+        __typename?: "GmTierFeature";
+        appId: string;
+        tierId: string;
+        featureKey: string;
+    }>;
+    /** Revoke a feature from an access tier. */
+    revokeFromTier(tierId: Scalars['BigInt']['input'], featureKey: string): Promise<boolean>;
+    /** List tier→feature grants (optionally for one tier). */
+    tierFeatures(tierId?: Scalars['BigInt']['input']): Promise<{
+        __typename?: "GmTierFeature";
+        appId: string;
+        tierId: string;
+        featureKey: string;
+    }[]>;
+    /**
+     * 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: string): KitInvokePolicy;
+}
+//# sourceMappingURL=features.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/kit/features.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,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY;IAG1C,yDAAyD;IACnD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;;;;;;IAQrD,2CAA2C;IACrC,IAAI;;;;;;IAIV,kFAAkF;IAC5E,WAAW,CACf,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,UAAU,EAAE,MAAM;;;;;;IASpB,4CAA4C;IACtC,cAAc,CAClB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IAQnB,0DAA0D;IACpD,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;;;;;;IAOtD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;CAGvC"}

package/dist/kit/features.js

@@ -0,0 +1,65 @@
+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/index.d.ts

@@ -1,8 +1,19 @@
-export { inventoryBlueprint, inventoryNames, kitPolicyJson, lockBlueprint, lockNames, mergeBlueprints, npcBehaviorFunctionName, npcBlueprint, plotBlueprint, plotNames, toSnakeCase, type InventoryBlueprintOptions, type InventoryNames, type KitAutomationSpec, type KitAutomationTriggerSpec, type KitBlueprint, type KitInvokePolicy, type KitSelectorSpec, type LockAuthority, type LockBlueprintOptions, type LockNames, type MergedBlueprints, type NpcBehaviorSpec, type NpcBehaviorTrigger, type NpcBlueprintOptions, type PlotBlueprintOptions, type PlotNames, type SelectorPermissionPredicate, } from './blueprints.js';
-export { GameKitClient, type GameKitOptions, type KitDeployResult, } from './kit.js';
+export { andPolicies, combatBlueprint, combatNames, composeBlueprints, decksBlueprint, decksNames, economyBlueprint, economyCurrencyFn, economyNames, featureGate, guildBlueprint, guildNames, inventoryBlueprint, inventoryNames, kitPolicyJson, leaderboardsBlueprint, leaderboardsNames, lockBlueprint, lockNames, lootBlueprint, lootNames, lootRollFn, matchesBlueprint, matchesNames, mergeBlueprints, npcBehaviorFunctionName, npcBlueprint, ownerEquals, ownerEqualsCaller, ownerMirrorProperty, plotBlueprint, plotNames, progressionBlueprint, progressionNames, questsBlueprint, questsNames, toSnakeCase, trustedAuthorityFields, worldsimBlueprint, worldsimNames, type CombatBlueprintOptions, type CombatNames, type DecksBlueprintOptions, type DecksNames, type EconomyBlueprintOptions, type EconomyNames, type GuildBlueprintOptions, type GuildNames, type InventoryBlueprintOptions, type InventoryNames, type KitAutomationSpec, type KitAutomationTriggerSpec, type KitBlueprint, type KitInvokePolicy, type KitOwnerIdKind, type KitSelectorSpec, type KitTrustedAuthority, type LeaderboardsBlueprintOptions, type LeaderboardsNames, type LockAuthority, type LockBlueprintOptions, type LockNames, type LootBlueprintOptions, type LootDropSpec, type LootEntrySpec, type LootNames, type LootTableSpec, type MatchesBlueprintOptions, type MatchesNames, type MergedBlueprints, type NpcBehaviorSpec, type NpcBehaviorTrigger, type NpcBlueprintOptions, type PlotBlueprintOptions, type PlotNames, type ProgressionBlueprintOptions, type ProgressionNames, type QuestAdvanceSpec, type QuestsBlueprintOptions, type QuestsNames, type SelectorPermissionPredicate, type WorldsimBlueprintOptions, type WorldsimNames, } from './blueprints/index.js';
+export { GameKitClient, type GameKitDomains, type GameKitOptions, type KitDeployResult, } from './kit.js';
+export { MatchesKit, type KitMatch, type KitMatchScore, type MatchesKitOptions, } from './matches.js';
 export { InventoryKit, type InventoryKitOptions, type KitItemStack } from './inventory.js';
+export { CombatKit, type CombatKitOptions, type KitCombatant, type KitStatusEffect, } from './combat.js';
+export { DecksKit, type DecksKitOptions, type KitCard } from './decks.js';
+export { FeaturesKit } from './features.js';
+export { EconomyKit, type EconomyKitOptions, type KitMarketListing, type KitShopListing, type KitTradeOffer, type KitWallet, } from './economy.js';
+export { LeaderboardsKit, type KitLeaderboardEntry, type LeaderboardsKitOptions, } from './leaderboards.js';
+export { LootKit, type KitLootRoll, type LootKitOptions } from './loot.js';
 export { ObjectsKit, type ObjectsKitOptions } from './objects.js';
 export { NpcsKit, type NpcsKitOptions, type KitNpc } from './npcs.js';
 export { PlotsKit, type PlotsKitOptions, type KitPlot } from './plots.js';
+export { QuestsKit, type KitQuestDef, type KitQuestProgress, type QuestsKitOptions, } from './quests.js';
+export { ProgressionKit, type KitAchievementDef, type KitAchievementUnlock, type KitProgress, type KitSkillDef, type KitSkillRank, type ProgressionKitOptions, } from './progression.js';
+export { SocialKit, type KitChatMessage, type KitGroupWithChannel, type SocialKitOptions, } from './social.js';
+export { WorldsimKit, type KitCrop, type KitResourceNode, type KitWaveSpawner, type KitWorldState, type WorldsimKitOptions, } from './worldsim.js';
 export { kitInvoke, toKitInvokeResult, type KitInvokeResult, type RawInvokeResult, } from './shared.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":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kit/index.ts"],"names":[],"mappings":"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"}

package/dist/kit/index.js

@@ -1,7 +1,18 @@
-export { inventoryBlueprint, inventoryNames, kitPolicyJson, lockBlueprint, lockNames, mergeBlueprints, npcBehaviorFunctionName, npcBlueprint, plotBlueprint, plotNames, toSnakeCase, } from './blueprints.js';
+export { andPolicies, combatBlueprint, combatNames, composeBlueprints, decksBlueprint, decksNames, economyBlueprint, economyCurrencyFn, economyNames, featureGate, guildBlueprint, guildNames, inventoryBlueprint, inventoryNames, kitPolicyJson, leaderboardsBlueprint, leaderboardsNames, lockBlueprint, lockNames, lootBlueprint, lootNames, lootRollFn, matchesBlueprint, matchesNames, mergeBlueprints, npcBehaviorFunctionName, npcBlueprint, ownerEquals, ownerEqualsCaller, ownerMirrorProperty, plotBlueprint, plotNames, progressionBlueprint, progressionNames, questsBlueprint, questsNames, toSnakeCase, trustedAuthorityFields, worldsimBlueprint, worldsimNames, } from './blueprints/index.js';
 export { GameKitClient, } from './kit.js';
+export { MatchesKit, } from './matches.js';
 export { InventoryKit } from './inventory.js';
+export { CombatKit, } from './combat.js';
+export { DecksKit } from './decks.js';
+export { FeaturesKit } from './features.js';
+export { EconomyKit, } from './economy.js';
+export { LeaderboardsKit, } from './leaderboards.js';
+export { LootKit } from './loot.js';
 export { ObjectsKit } from './objects.js';
 export { NpcsKit } from './npcs.js';
 export { PlotsKit } from './plots.js';
+export { QuestsKit, } from './quests.js';
+export { ProgressionKit, } from './progression.js';
+export { SocialKit, } from './social.js';
+export { WorldsimKit, } from './worldsim.js';
 export { kitInvoke, toKitInvokeResult, } from './shared.js';

package/dist/kit/inventory.d.ts

@@ -59,6 +59,10 @@ export declare class InventoryKit {
      * 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;
@@ -66,6 +70,7 @@ export declare class InventoryKit {
         slot?: number;
         displayName?: string;
         sessionId?: string;
+        ownerUserId?: Scalars['BigInt']['input'];
     }): Promise<{
         __typename?: "GmContainer";
         containerId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../src/kit/inventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAGpB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,mBAAwB;IAKnC;;;;;;;OAOG;IACG,MAAM,CACV,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;IAmB5D;;;OAGG;IACG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2B9E;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAcD,4EAA4E;IACtE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS9E;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAShF,0EAA0E;IACpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS7E;;;;OAIG;IACG,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IASnC;;;;OAIG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;IASpD,gFAAgF;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA4B7D"}
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../src/kit/inventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAGpB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,mBAAwB;IAKnC;;;;;;;OAOG;IACG,MAAM,CACV,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;IAmB5D;;;OAGG;IACG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2B9E;;;;;;;;OAQG;IACG,WAAW,CAAC,KAAK,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;KAC1C;;;;;;;;;;;IAuBD,4EAA4E;IACtE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS9E;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAShF,0EAA0E;IACpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS7E;;;;OAIG;IACG,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IASnC;;;;OAIG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;IASpD,gFAAgF;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA4B7D"}

package/dist/kit/inventory.js

@@ -1,4 +1,4 @@
-import { inventoryNames } from './blueprints.js';
+import { inventoryNames } from './blueprints/index.js';
 import { kitContainerProperties, kitInvoke, } from './shared.js';
 /**
  * Runtime helpers for the {@link inventoryBlueprint} conventions: find or
@@ -64,6 +64,10 @@ export class InventoryKit {
      * 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({
@@ -75,6 +79,15 @@ export class InventoryKit {
                 { 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: 'int',
+                            valueJson: String(input.ownerUserId),
+                        },
+                    ]
+                    : []),
             ],
         });
     }