crowdypy 0.13.0.dev1__tar.gz → 0.14.0.dev1__tar.gz

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/MIGRATION.md

@@ -3,6 +3,25 @@
 CrowdyPy is pre-1.0. Within a minor line, patch releases keep source compatibility; each
 new minor may change the API. Read the section for every minor you skip.
 
+## 0.14.0
+
+CrowdyJS 18.13.0 and CrowdyCPP 0.66.0. Additive: the economy, which lives in hub state and is
+not a ledger (HS-52); the `player` and `market` starters need ckx-sdk 0.12.0.
+
+- **`kit.player`** (`PlayerKit`), the caller's own hub, keyed by `player_id` (pass it to
+  `client.kit()` or let the kit ask who the player is): `watch(*parts)`, `me`, `rules`,
+  `profile_of`, `on_event`, and the stores `profile`, `inventory`, `wallet`, `progress`, filled
+  as they are read. Its views: `kit.inventory` (`items`, `count`, `discard`, `take_mail`),
+  `kit.wallet` (`balances`, `balance`), `kit.progression` (`on_level`, `profile_of`),
+  `kit.achievements` (`list`, `on_unlock`), `kit.quests` (`list`, `accept`, `claim`, `step`),
+  `kit.crafting` (`recipes`, `craft(recipe, times)`), `kit.loot` (`tables`, `open`),
+  `kit.production` (`view`, `collect`).
+- **Markets**: `kit.shops.at(key)` (`vendors`, `buy`, `sell`), `kit.market.at(key)` (`book`,
+  `order(item=, side=, price=, count=)`, `cancel`, `orders` mirrored) and `kit.trades.at(key)`
+  (`open`, `offer`, `accept`, `decline`, `mine` mirrored).
+- **`KIT_CODES["UNAVAILABLE"]`**: a hub refuses a change it could not finish because another hub
+  did not answer and keeps no receipt; the kit sends a call with an action id again.
+
 ## 0.13.0
 
 CrowdyJS 18.12.0 and CrowdyCPP 0.65.0. Additive: a kit module per ck-exec genre starter

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdypy
-Version: 0.13.0.dev1
+Version: 0.14.0.dev1
 Summary: Official Python SDK for Crowded Kingdoms: typed GraphQL clients and a native UDP replication core
 Keywords: crowded-kingdoms,multiplayer,replication,graphql,sdk,udp
 Author: Crowded Kingdoms
@@ -51,6 +51,13 @@ CrowdyPy follows the [CrowdyJS](https://github.com/CrowdedKingdoms/CrowdyJS) API
 client, bound with [nanobind](https://github.com/wjakob/nanobind) and shipped inside the
 wheel. Python never touches a datagram.
 
+**v0.14.0: the economy (CrowdyJS 18.13.0, CrowdyCPP 0.66.0).** `kit.player`, the caller's own
+`player` hub, and its views `kit.inventory`, `kit.wallet`, `kit.progression`,
+`kit.achievements`, `kit.quests`, `kit.crafting`, `kit.loot` and `kit.production`; markets by
+name: `kit.shops.at(key)`, `kit.market.at(key)` and `kit.trades.at(key)`. It lives in hub state
+and is not a ledger. A change refused `unavailable` is sent again with its action id. They need
+ckx-sdk 0.12.1 in the tier's compute toolchain (dev: v1.15.0).
+
 **v0.13.0: the genre starters (CrowdyJS 18.12.0, CrowdyCPP 0.65.0).** Nine more kit modules,
 one per ck-exec genre starter: `kit.leaderboards.board(name)`, `kit.tables.table(key)` (the
 caller's hand as private state), `kit.tactics.battle(key)`, `kit.encounters.encounter(key)`,

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/README.md

@@ -11,6 +11,13 @@ CrowdyPy follows the [CrowdyJS](https://github.com/CrowdedKingdoms/CrowdyJS) API
 client, bound with [nanobind](https://github.com/wjakob/nanobind) and shipped inside the
 wheel. Python never touches a datagram.
 
+**v0.14.0: the economy (CrowdyJS 18.13.0, CrowdyCPP 0.66.0).** `kit.player`, the caller's own
+`player` hub, and its views `kit.inventory`, `kit.wallet`, `kit.progression`,
+`kit.achievements`, `kit.quests`, `kit.crafting`, `kit.loot` and `kit.production`; markets by
+name: `kit.shops.at(key)`, `kit.market.at(key)` and `kit.trades.at(key)`. It lives in hub state
+and is not a ledger. A change refused `unavailable` is sent again with its action id. They need
+ckx-sdk 0.12.1 in the tier's compute toolchain (dev: v1.15.0).
+
 **v0.13.0: the genre starters (CrowdyJS 18.12.0, CrowdyCPP 0.65.0).** Nine more kit modules,
 one per ck-exec genre starter: `kit.leaderboards.board(name)`, `kit.tables.table(key)` (the
 caller's hand as private state), `kit.tactics.battle(key)`, `kit.encounters.encounter(key)`,

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/docs/compatibility.md

@@ -5,7 +5,7 @@ are in `pyproject.toml` (`[project].version`, `[tool.crowdypy.crowdyjs]`,
 `[tool.crowdypy.crowdycpp]`); `tests/unit/test_release_versions.py` refuses this page when
 its version disagrees.
 
-- CrowdyPy `0.13.0`
+- CrowdyPy `0.14.0`
 - API surface: CrowdyJS (the pinned version and commit in `pyproject.toml`); the generated
   `docs/parity-matrix.md` lists every covered method, every native equivalent and every
   browser exclusion with its reason. The gate is strict: there are no portable gaps, and a

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/docs/parity-matrix.md

@@ -4,14 +4,14 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 ## Target
 
-- CrowdyJS: `18.12.0` at `43faedd482469ba520b17097b3a67509d029a59d`
-- CrowdyCPP (native core): `0.65.0` at `866804861bd319a6f376db2dd24b9b6d2f14900c`
+- CrowdyJS: `18.13.0` at `7aeee709ad661c836a045f2d396c9a867f1d278a`
+- CrowdyCPP (native core): `0.66.0` at `d57cafe80c48c45fdf9ae14309d59b80d466d308`
 - schema.gql identical to CrowdyJS's: yes
 - Gate mode: strict portable parity (every portable gap is release-blocking)
 
 ## Summary
 
-- Covered: 1261
+- Covered: 1352
 - Portable gap: 0
 - Native equivalent: 44
 - Browser exclusion: 113
@@ -448,6 +448,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 | CrowdyJS -> CrowdyPy | Status |
 |---|---|
+| `AchievementsKit -> AchievementsKit` | covered |
 | `ActorClient -> ActorClient` | covered |
 | `ActorInbox -> ActorInbox` | covered |
 | `ActorsAPI -> ActorsAPI` | covered |
@@ -467,6 +468,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `ChunkStore -> ChunkStore` | covered |
 | `ChunksAPI -> ChunksAPI` | covered |
 | `CollectionMirror -> CollectionMirror` | covered |
+| `CraftingKit -> CraftingKit` | covered |
 | `CrowdyClient -> AsyncCrowdyClient` | covered |
 | `CrowdyStudioAPI -> CrowdyStudioAPI` | covered |
 | `CrowdyStudioController -> CrowdyStudioController` | covered |
@@ -497,13 +499,18 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `InputLogAPI -> InputLogAPI` | covered |
 | `InstanceRun -> InstanceRun` | covered |
 | `InstancesKit -> InstancesKit` | covered |
+| `InventoryKit -> InventoryKit` | covered |
 | `KitError -> KitError` | covered |
 | `KitRuntime -> KitRuntime` | covered |
 | `KitTopology -> KitTopology` | covered |
 | `LeaderboardHandle -> LeaderboardHandle` | covered |
 | `LeaderboardsKit -> LeaderboardsKit` | covered |
 | `LocalActorStore -> LocalActorStore` | covered |
+| `LootKit -> LootKit` | covered |
+| `MarketCore -> MarketCore` | covered |
+| `MarketHandle -> MarketHandle` | covered |
 | `MarketplaceAPI -> MarketplaceAPI` | covered |
+| `MarketsKit -> MarketsKit` | covered |
 | `MatchQueue -> MatchQueue` | covered |
 | `MatchmakingKit -> MatchmakingKit` | covered |
 | `MinigamesKit -> MinigamesKit` | covered |
@@ -512,9 +519,13 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `OrganizationsAPI -> OrganizationsAPI` | covered |
 | `PaymentsAPI -> PaymentsAPI` | covered |
 | `PlatformAPI -> PlatformAPI` | covered |
+| `PlayerKit -> PlayerKit` | covered |
 | `PlayerWalletAPI -> PlayerWalletAPI` | covered |
 | `PortalAPI -> PortalAPI` | covered |
 | `PrivateState -> PrivateState` | covered |
+| `ProductionKit -> ProductionKit` | covered |
+| `ProgressionKit -> ProgressionKit` | covered |
+| `QuestsKit -> QuestsKit` | covered |
 | `QuotasAPI -> QuotasAPI` | covered |
 | `Race -> Race` | covered |
 | `RacingKit -> RacingKit` | covered |
@@ -525,6 +536,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `SessionsKit -> SessionsKit` | covered |
 | `ShardKit -> ShardKit` | covered |
 | `SharedEnvironmentAPI -> SharedEnvironmentAPI` | covered |
+| `ShopHandle -> ShopHandle` | covered |
+| `ShopsKit -> ShopsKit` | covered |
 | `SocialKit -> SocialKit` | covered |
 | `SpectateKit -> SpectateKit` | covered |
 | `SpectatorHeartbeat -> SpectatorHeartbeat` | covered |
@@ -537,12 +550,15 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `TeleportAPI -> TeleportAPI` | covered |
 | `TerritoryKit -> TerritoryKit` | covered |
 | `TerritoryMap -> TerritoryMap` | covered |
+| `TradeDesk -> TradeDesk` | covered |
+| `TradesKit -> TradesKit` | covered |
 | `UdpAPI -> UdpAPI` | covered |
 | `UsageAPI -> UsageAPI` | covered |
 | `UsersAPI -> UsersAPI` | covered |
 | `VfsLimitError -> (none)` | browser exclusion — the bounded Monaco / browser-language-worker document workspace |
 | `VirtualFileSystem -> (none)` | browser exclusion — the bounded Monaco / browser-language-worker document workspace |
 | `VoxelsAPI -> VoxelsAPI` | covered |
+| `WalletKit -> WalletKit` | covered |
 | `WorkerLanguageClient -> (none)` | browser exclusion — binds vscode-jsonrpc to browser Web Worker messaging |
 | `WorkerMessageReader -> (none)` | browser exclusion — binds vscode-jsonrpc to browser Web Worker messaging |
 | `WorkerMessageWriter -> (none)` | browser exclusion — binds vscode-jsonrpc to browser Web Worker messaging |
@@ -556,6 +572,9 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 | CrowdyJS method | Status |
 |---|---|
+| `AchievementsKit.list` | covered |
+| `AchievementsKit.onUnlock` | covered |
+| `AchievementsKit.watch` | covered |
 | `ActorClient.join` | covered |
 | `ActorClient.sendEvent` | covered |
 | `ActorClient.sendState` | covered |
@@ -731,6 +750,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `ChunksAPI.voxelList` | covered |
 | `CollectionMirror.list` | covered |
 | `CollectionMirror.member` | covered |
+| `CraftingKit.craft` | covered |
+| `CraftingKit.recipes` | covered |
 | `CrowdyClient.close` | native equivalent — AsyncCrowdyClient.aclose(), the asyncio spelling; the blocking CrowdyClient has close() |
 | `CrowdyClient.getToken` | covered |
 | `CrowdyClient.graphqlEndpoint` | covered |
@@ -905,23 +926,35 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `GameAppsAPI.setPermissionLimits` | covered |
 | `GameAppsAPI.transferOwnership` | covered |
 | `GameAppsAPI.userPermissions` | covered |
+| `GameKitClient.achievements` | covered |
 | `GameKitClient.arenas` | covered |
 | `GameKitClient.close` | covered |
+| `GameKitClient.crafting` | covered |
 | `GameKitClient.emotes` | covered |
 | `GameKitClient.encounters` | covered |
 | `GameKitClient.instances` | covered |
+| `GameKitClient.inventory` | covered |
 | `GameKitClient.leaderboards` | covered |
+| `GameKitClient.loot` | covered |
+| `GameKitClient.market` | covered |
 | `GameKitClient.matchmaking` | covered |
 | `GameKitClient.minigames` | covered |
 | `GameKitClient.npcs` | covered |
+| `GameKitClient.player` | covered |
+| `GameKitClient.production` | covered |
+| `GameKitClient.progression` | covered |
+| `GameKitClient.quests` | covered |
 | `GameKitClient.racing` | covered |
 | `GameKitClient.sessions` | covered |
 | `GameKitClient.shards` | covered |
+| `GameKitClient.shops` | covered |
 | `GameKitClient.spectate` | covered |
 | `GameKitClient.tables` | covered |
 | `GameKitClient.tactics` | covered |
 | `GameKitClient.territory` | covered |
 | `GameKitClient.topology` | covered |
+| `GameKitClient.trades` | covered |
+| `GameKitClient.wallet` | covered |
 | `GameKitClient.world` | covered |
 | `GameSessionHandle.act` | covered |
 | `GameSessionHandle.configure` | covered |
@@ -974,6 +1007,11 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `InstanceRun.unwatch` | covered |
 | `InstanceRun.watch` | covered |
 | `InstancesKit.run` | covered |
+| `InventoryKit.count` | covered |
+| `InventoryKit.discard` | covered |
+| `InventoryKit.items` | covered |
+| `InventoryKit.takeMail` | covered |
+| `InventoryKit.watch` | covered |
 | `KitError.from` | native equivalent — KitError.from_error(error): `from` is a Python keyword |
 | `KitRuntime.call` | covered |
 | `KitRuntime.close` | covered |
@@ -1009,6 +1047,16 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `LocalActorStore.setState` | covered |
 | `LocalActorStore.state` | covered |
 | `LocalActorStore.status` | covered |
+| `LootKit.open` | covered |
+| `LootKit.tables` | covered |
+| `MarketCore.change` | covered |
+| `MarketHandle.book` | covered |
+| `MarketHandle.cancel` | covered |
+| `MarketHandle.order` | covered |
+| `MarketHandle.orders` | covered |
+| `MarketHandle.unwatch` | covered |
+| `MarketHandle.view` | covered |
+| `MarketHandle.watch` | covered |
 | `MarketplaceAPI.admissionQueue` | covered |
 | `MarketplaceAPI.appAcquisitions` | covered |
 | `MarketplaceAPI.appListings` | covered |
@@ -1022,6 +1070,7 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `MarketplaceAPI.setGridClaimPolicy` | covered |
 | `MarketplaceAPI.setListingStatus` | covered |
 | `MarketplaceAPI.transferListing` | covered |
+| `MarketsKit.at` | covered |
 | `MatchQueue.accept` | covered |
 | `MatchQueue.configure` | covered |
 | `MatchQueue.decline` | covered |
@@ -1073,6 +1122,18 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `PaymentsAPI.mine` | covered |
 | `PaymentsAPI.mineConnection` | covered |
 | `PlatformAPI.config` | covered |
+| `PlayerKit.call` | covered |
+| `PlayerKit.inventory` | covered |
+| `PlayerKit.key` | covered |
+| `PlayerKit.me` | covered |
+| `PlayerKit.onEvent` | covered |
+| `PlayerKit.profile` | covered |
+| `PlayerKit.profileOf` | covered |
+| `PlayerKit.progress` | covered |
+| `PlayerKit.rules` | covered |
+| `PlayerKit.unwatch` | covered |
+| `PlayerKit.wallet` | covered |
+| `PlayerKit.watch` | covered |
 | `PlayerWalletAPI.appMarkupAccrued` | covered |
 | `PlayerWalletAPI.appMarkupAccruedMicrousd` | covered |
 | `PlayerWalletAPI.appPlayerUsage` | covered |
@@ -1107,6 +1168,18 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `PrivateState.start` | covered |
 | `PrivateState.stop` | covered |
 | `PrivateState.subscribe` | covered |
+| `ProductionKit.collect` | covered |
+| `ProductionKit.view` | covered |
+| `ProgressionKit.onLevel` | covered |
+| `ProgressionKit.profile` | covered |
+| `ProgressionKit.profileOf` | covered |
+| `ProgressionKit.progress` | covered |
+| `ProgressionKit.watch` | covered |
+| `QuestsKit.accept` | covered |
+| `QuestsKit.claim` | covered |
+| `QuestsKit.list` | covered |
+| `QuestsKit.step` | covered |
+| `QuestsKit.watch` | covered |
 | `QuotasAPI.effective` | covered |
 | `QuotasAPI.forApp` | covered |
 | `QuotasAPI.forOrg` | covered |
@@ -1172,6 +1245,13 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `SharedEnvironmentAPI.setReservedThroughput` | covered |
 | `SharedEnvironmentAPI.setSpendCaps` | covered |
 | `SharedEnvironmentAPI.setupPaymentMethod` | covered |
+| `ShopHandle.buy` | covered |
+| `ShopHandle.sell` | covered |
+| `ShopHandle.unwatch` | covered |
+| `ShopHandle.vendors` | covered |
+| `ShopHandle.view` | covered |
+| `ShopHandle.watch` | covered |
+| `ShopsKit.at` | covered |
 | `SocialKit.chat.join` | covered |
 | `SocialKit.chat.onMessage` | covered |
 | `SocialKit.chat.room` | covered |
@@ -1242,6 +1322,14 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `TerritoryMap.reset` | covered |
 | `TerritoryMap.unwatch` | covered |
 | `TerritoryMap.watch` | covered |
+| `TradeDesk.accept` | covered |
+| `TradeDesk.decline` | covered |
+| `TradeDesk.mine` | covered |
+| `TradeDesk.offer` | covered |
+| `TradeDesk.open` | covered |
+| `TradeDesk.unwatch` | covered |
+| `TradeDesk.watch` | covered |
+| `TradesKit.at` | covered |
 | `UdpAPI.connect` | covered |
 | `UdpAPI.connectionStatus` | covered |
 | `UdpAPI.disconnect` | covered |
@@ -1281,6 +1369,9 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 | `VoxelsAPI.listByDistance` | covered |
 | `VoxelsAPI.rollback` | covered |
 | `VoxelsAPI.update` | covered |
+| `WalletKit.balance` | covered |
+| `WalletKit.balances` | covered |
+| `WalletKit.watch` | covered |
 | `WorldClient.actor` | covered |
 | `WorldClient.subscribe` | covered |
 | `WorldKit.cancel` | covered |

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "crowdypy"
-version = "0.13.0.dev1"
+version = "0.14.0.dev1"
 description = "Official Python SDK for Crowded Kingdoms: typed GraphQL clients and a native UDP replication core"
 readme = "README.md"
 license = "MIT AND Apache-2.0"
@@ -119,19 +119,19 @@ environment = { OPENSSL_ROOT_DIR = "C:/vcpkg/installed/x64-windows-static-md" }
 # --------------------------------------------------------------------------------------
 
 [tool.crowdypy.crowdyjs]
-version = "18.12.0"
-commit = "43faedd482469ba520b17097b3a67509d029a59d"
+version = "18.13.0"
+commit = "7aeee709ad661c836a045f2d396c9a867f1d278a"
 
 [tool.crowdypy.crowdycpp]
-version = "0.65.0"
-tag = "dev/v0.65.0"
-commit = "866804861bd319a6f376db2dd24b9b6d2f14900c"
-tree-sha256 = "92c909a4bb760548d9745860eb56cfb5f25f578e8d5614fb9c93dc0648082a37"
+version = "0.66.0"
+tag = "dev/v0.66.0"
+commit = "d57cafe80c48c45fdf9ae14309d59b80d466d308"
+tree-sha256 = "e92629e7d769516bdb126b9ad39f489b6d98d6c2f5f03743437127d370a689cf"
 
 # schema.gql and operations/ are CrowdyJS's, copied from the commit pinned above by
 # scripts/schema_sync.py, which records these hashes and re-derives them in CI.
 [tool.crowdypy.graphql]
-schema-sha256 = "acdebaf09f49900f18b4c6e213f47058aa19512f16ca4de4de6343c39ecd492d"
+schema-sha256 = "b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0"
 operations-sha256 = "37b1e06dc4e997bb42506968c50698a184934581a6d94d9471a29d2ce74ff3d3"
 
 # The SDL the docs site publishes. scripts/schema_drift.py compares the snapshot against it

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/schema.gql

@@ -5998,14 +5998,16 @@ type ExecStarter {
 }
 
 """
-The starter packs: four crates and a manifest that deploys them as one app.
+The starter packs: the starter crates, and a manifest that deploys them as one app.
 """
 type ExecStarterPack {
   """
-  The manifest for `execDeploy` with the build’s id: the root `world` hub, and `matchmaker`, `session` and `npcs` under it, each naming its crate.
+  The manifest for `execDeploy` with the build’s id: the root `world` hub and the types under it, each naming its crate.
   """
   manifestJson: String!
-  """The crates."""
+  """
+  One entry per node type of the manifest: a crate that serves two types appears twice, so build each crate once.
+  """
   starters: [ExecStarter!]!
   """
   The mod starter: a player’s code on a grid they own, built with `execModBuild` and deployed with `execModDeploy` rather than in the manifest. Null on a toolchain without it.
@@ -7877,7 +7879,7 @@ type Query {
     appId: BigInt!
   ): ExecAppStatus! @requiresPermission(scope: "app", permission: "view_compute_diagnostics", scopeArg: "appId")
   """
-  The starter packs, which replace the compute templates: ckx-sdk hub crates for a root world, matchmaking, game sessions, NPCs and mobs, and game genres (leaderboards, cards, tactics, waves, duels, private runs, arenas, races, territory), to pass to `execBuild`, with a manifest for `execDeploy`. `starters` has one entry per node type, so a crate that serves two types appears twice: build it once. Requires the org 'manage_compute' permission.
+  The starter packs, which replace the compute templates: ckx-sdk hub crates for a root world, matchmaking, game sessions, NPCs and mobs, game genres (leaderboards, cards, tactics, waves, duels, private runs, arenas, races, territory), and the economy (a player's own hub, markets), to pass to `execBuild`, with a manifest for `execDeploy`. `starters` has one entry per node type, so a crate that serves two types appears twice: build it once. Requires the org 'manage_compute' permission.
   """
   execStarters(
     """The app they are for."""

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/src/crowdypy/_generated/enums.py

@@ -1,6 +1,6 @@
 """GENERATED by scripts/codegen.py from schema.gql. Do not edit.
 
-schema.gql sha256: acdebaf09f49900f18b4c6e213f47058aa19512f16ca4de4de6343c39ecd492d
+schema.gql sha256: b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0
 """
 
 from enum import StrEnum

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/src/crowdypy/_generated/inputs.py

@@ -4,7 +4,7 @@ Every GraphQL input object as a msgspec Struct. Attributes are snake_case and en
 under their GraphQL names; an attribute left at UNSET is omitted from the request,
 which is how the API tells 'not provided' from an explicit null.
 
-schema.gql sha256: acdebaf09f49900f18b4c6e213f47058aa19512f16ca4de4de6343c39ecd492d
+schema.gql sha256: b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0
 """
 
 from __future__ import annotations

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/src/crowdypy/_generated/operations.py

@@ -1,6 +1,6 @@
 """GENERATED by scripts/codegen.py from schema.gql and operations/. Do not edit.
 
-schema.gql sha256: acdebaf09f49900f18b4c6e213f47058aa19512f16ca4de4de6343c39ecd492d
+schema.gql sha256: b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0
 operations/ sha256: 37b1e06dc4e997bb42506968c50698a184934581a6d94d9471a29d2ce74ff3d3
 """
 

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/src/crowdypy/_sync/kit/__init__.py

@@ -10,9 +10,29 @@ from crowdypy._sync.kit.modules.arenas import ArenaMatch, ArenasKit
 from crowdypy._sync.kit.modules.encounters import Encounter, EncountersKit
 from crowdypy._sync.kit.modules.instances import InstanceRun, InstancesKit
 from crowdypy._sync.kit.modules.leaderboards import LeaderboardHandle, LeaderboardsKit
+from crowdypy._sync.kit.modules.market import (
+    MarketCore,
+    MarketHandle,
+    MarketsKit,
+    ShopHandle,
+    ShopsKit,
+    TradeDesk,
+    TradesKit,
+)
 from crowdypy._sync.kit.modules.matchmaking import MatchmakingKit, MatchQueue
 from crowdypy._sync.kit.modules.minigames import Duel, MinigamesKit
 from crowdypy._sync.kit.modules.npcs import NpcArea, NpcsKit
+from crowdypy._sync.kit.modules.player import (
+    AchievementsKit,
+    CraftingKit,
+    InventoryKit,
+    LootKit,
+    PlayerKit,
+    ProductionKit,
+    ProgressionKit,
+    QuestsKit,
+    WalletKit,
+)
 from crowdypy._sync.kit.modules.presence import EmotesKit, SpectateKit, SpectatorHeartbeat
 from crowdypy._sync.kit.modules.racing import BallMatch, Race, RacingKit
 from crowdypy._sync.kit.modules.sessions import GameSessionHandle, SessionsKit, session_turn
@@ -141,6 +161,7 @@ __all__ = [
     "KIT_SUBSCRIPTIONS_MAX",
     "POSE_BYTES",
     "AbilityEvent",
+    "AchievementsKit",
     "ArenaMatch",
     "ArenasKit",
     "BallMatch",
@@ -148,6 +169,7 @@ __all__ = [
     "CollectionMirror",
     "ContactDamageEvent",
     "ControlPointEvent",
+    "CraftingKit",
     "Duel",
     "EmoteEvent",
     "EmotesKit",
@@ -160,6 +182,7 @@ __all__ = [
     "HubState",
     "InstanceRun",
     "InstancesKit",
+    "InventoryKit",
     "KitActorState",
     "KitChatMessage",
     "KitContainer",
@@ -173,6 +196,10 @@ __all__ = [
     "KitTopologyPlan",
     "LeaderboardHandle",
     "LeaderboardsKit",
+    "LootKit",
+    "MarketCore",
+    "MarketHandle",
+    "MarketsKit",
     "MatchQueue",
     "MatchmakingKit",
     "MinigamesKit",
@@ -180,15 +207,21 @@ __all__ = [
     "NpcArea",
     "NpcsKit",
     "OptimisticActionOutcome",
+    "PlayerKit",
     "PossessionEvent",
     "PrivateState",
+    "ProductionKit",
+    "ProgressionKit",
     "ProposalEvent",
+    "QuestsKit",
     "Race",
     "RaceTimingEvent",
     "RacingKit",
     "ScoreEvent",
     "SessionsKit",
     "ShardKit",
+    "ShopHandle",
+    "ShopsKit",
     "SocialKit",
     "SpectateKit",
     "SpectatorHeartbeat",
@@ -198,7 +231,10 @@ __all__ = [
     "TerritoryKit",
     "TerritoryMap",
     "TopicMirror",
+    "TradeDesk",
+    "TradesKit",
     "TurnEvent",
+    "WalletKit",
     "WeatherEvent",
     "WorldKit",
     "WritableKitStore",

{crowdypy-0.13.0.dev1 → crowdypy-0.14.0.dev1}/src/crowdypy/_sync/kit/kit.py

@@ -10,9 +10,21 @@ from crowdypy._sync.kit.modules.arenas import ArenasKit
 from crowdypy._sync.kit.modules.encounters import EncountersKit
 from crowdypy._sync.kit.modules.instances import InstancesKit
 from crowdypy._sync.kit.modules.leaderboards import LeaderboardsKit
+from crowdypy._sync.kit.modules.market import MarketCore, MarketsKit, ShopsKit, TradesKit
 from crowdypy._sync.kit.modules.matchmaking import MatchmakingKit
 from crowdypy._sync.kit.modules.minigames import MinigamesKit
 from crowdypy._sync.kit.modules.npcs import NpcsKit
+from crowdypy._sync.kit.modules.player import (
+    AchievementsKit,
+    CraftingKit,
+    InventoryKit,
+    LootKit,
+    PlayerKit,
+    ProductionKit,
+    ProgressionKit,
+    QuestsKit,
+    WalletKit,
+)
 from crowdypy._sync.kit.modules.presence import EmotesKit, SpectateKit
 from crowdypy._sync.kit.modules.racing import RacingKit
 from crowdypy._sync.kit.modules.sessions import SessionsKit
@@ -65,7 +77,9 @@ class GameKitClient:
     ``player_id`` are :class:`~crowdypy.kit.runtime.KitRuntime`'s; ``nodes`` renames the starter
     types a game deployed under other names (``world``, ``matchmaker``, ``session``, ``npcs``,
     ``leaderboard``, ``deck``, ``tactics``, ``director``, ``minigame``, ``instance``, ``arena``,
-    ``race``, ``ball``, ``territory``, ``zone``).
+    ``race``, ``ball``, ``territory``, ``zone``, ``player``, ``market``). The economy
+    (:attr:`player` and its views, :attr:`market`, :attr:`shops`, :attr:`trades`) lives in hub
+    state and is not a ledger.
     """
 
     def __init__(
@@ -123,6 +137,9 @@ class GameKitClient:
         self._arenas: ArenasKit | None = None
         self._racing: RacingKit | None = None
         self._territory: TerritoryKit | None = None
+        self._player: PlayerKit | None = None
+        self._views: dict[str, Any] = {}
+        self._markets: dict[str, MarketCore] = {}
         self._topology: KitTopology | None = None
         self._spectate: SpectateKit | None = None
         self._emotes: EmotesKit | None = None
@@ -234,6 +251,88 @@ class GameKitClient:
             )
         return self._territory
 
+    @property
+    def player(self) -> PlayerKit:
+        """The caller's own ``player`` hub: what they own and what they did."""
+        if self._player is None:
+            self._player = PlayerKit(self.runtime, node_type=self._node("player"))
+        return self._player
+
+    def _view(self, name: str, make: Callable[[], Any]) -> Any:
+        if name not in self._views:
+            self._views[name] = make()
+        return self._views[name]
+
+    @property
+    def inventory(self) -> InventoryKit:
+        """The player's items: stacks in slots, and mail for what did not fit."""
+        view: InventoryKit = self._view("inventory", lambda: InventoryKit(self.player))
+        return view
+
+    @property
+    def wallet(self) -> WalletKit:
+        """The player's soft currencies."""
+        view: WalletKit = self._view("wallet", lambda: WalletKit(self.player))
+        return view
+
+    @property
+    def progression(self) -> ProgressionKit:
+        """Experience, levels and public profiles."""
+        view: ProgressionKit = self._view("progression", lambda: ProgressionKit(self.player))
+        return view
+
+    @property
+    def achievements(self) -> AchievementsKit:
+        view: AchievementsKit = self._view("achievements", lambda: AchievementsKit(self.player))
+        return view
+
+    @property
+    def quests(self) -> QuestsKit:
+        """Quests, first-session tutorials among them."""
+        view: QuestsKit = self._view("quests", lambda: QuestsKit(self.player))
+        return view
+
+    @property
+    def crafting(self) -> CraftingKit:
+        view: CraftingKit = self._view("crafting", lambda: CraftingKit(self.player))
+        return view
+
+    @property
+    def loot(self) -> LootKit:
+        """Loot tables with pity."""
+        view: LootKit = self._view("loot", lambda: LootKit(self.player))
+        return view
+
+    @property
+    def production(self) -> ProductionKit:
+        """Idle production that catches up on the time away."""
+        view: ProductionKit = self._view("production", lambda: ProductionKit(self.player))
+        return view
+
+    def _market(self, key: str) -> MarketCore:
+        core = self._markets.get(key)
+        if core is None:
+            core = self._markets[key] = MarketCore(self.runtime, self._node("market"), key)
+        return core
+
+    @property
+    def market(self) -> MarketsKit:
+        """Markets' order books."""
+        view: MarketsKit = self._view("market", lambda: MarketsKit(self._market))
+        return view
+
+    @property
+    def shops(self) -> ShopsKit:
+        """Markets' vendors."""
+        view: ShopsKit = self._view("shops", lambda: ShopsKit(self._market))
+        return view
+
+    @property
+    def trades(self) -> TradesKit:
+        """Trades between two players at a market."""
+        view: TradesKit = self._view("trades", lambda: TradesKit(self._market))
+        return view
+
     @property
     def topology(self) -> KitTopology:
         """Composing and deploying the app's tree of starter hubs (developers)."""