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

package/MIGRATION.md

@@ -120,6 +120,31 @@ super-admin's session). There is no SDK replacement.
 `dev`'s SDL after #417 merged (`npm run schema:sync:paths -- --schema <that schema.gql>`, then
 `npm run codegen`).
 
+## 18.13.0: the economy
+
+Additive. **Needs a compute toolchain whose starter pack has the `player` and `market`
+starters** (ckx-sdk 0.12.1; dev's toolchain v1.15.0). The economy lives in hub state and is
+not a ledger (the operator's decision HS-52): no double-entry book, no real money, transfers as
+steps each hub answers once.
+
+- **The caller's own `player` hub**, keyed by their player id (the kit needs it: `playerId` in
+  `client.kit()`'s options, or the identity it can ask): `kit.player` (`watch`, `me`, `rules`,
+  `profileOf`, `onEvent`) and its views `kit.inventory` (`items`, `count`, `discard`,
+  `takeMail`), `kit.wallet` (`balances`, `balance`), `kit.progression` (`progress`, `profile`,
+  `onLevel`), `kit.achievements` (`list`, `onUnlock`), `kit.quests` (`list`, `accept`, `claim`,
+  `step` for the counters the game lets a client report), `kit.crafting` (`recipes`, `craft`),
+  `kit.loot` (`tables`, `open`) and `kit.production` (`view`, `collect`). The inventory, wallet
+  and progress are read by calls only the player may make, and read again when the hub's
+  `changed` message names them; the profile is public.
+- **Markets** by name: `kit.shops.at(key)` (`vendors`, `buy`, `sell`), `kit.market.at(key)`
+  (`book`, `order`, `cancel`, `orders` mirrored) and `kit.trades.at(key)` (`open`, `offer`,
+  `accept`, `decline`, `mine` mirrored). An order or an offer holds what it puts up in the
+  player's own hub; a fill or an accepted trade moves it hub to hub.
+- **`unavailable`** (`KIT_CODES.UNAVAILABLE`): a hub refuses a change it could not finish
+  because another hub did not answer. The kit sends a call with an action id again, as it does
+  after a platform `Unavailable`; the hub keeps no receipt for it, so the resend finishes what
+  the first began.
+
 ## 18.12.0: the genre starters
 
 Additive. **Needs a compute toolchain whose starter pack has the genre starters** (ckx-sdk

package/README.md

@@ -759,6 +759,8 @@ modules are the tree's starter types:
 | `kit.arenas.arena(key)` | `arena` | real-time fights: `join` as a class, `move` (the hub's warden keeps what the speed allows), `cast` (cooldown, resource, range; projectiles and areas land on the hub's ticks) |
 | `kit.racing.race(key)` / `ball(key)` | `race`, `ball` (`racing`) | races (gates in order, laps, splits, places, the winner's `ghost`) and ball games (`claim`, `pass`, `shoot`, goals) on reported positions the warden keeps |
 | `kit.territory.map(key)` / `zone(key)` | `territory`, `zone` (`territory`) | control points a faction captures by standing on them (the hub reads where players are), and a circle that shrinks and wears down whoever is outside |
+| `kit.player` and its views: `kit.inventory`, `kit.wallet`, `kit.progression`, `kit.achievements`, `kit.quests`, `kit.crafting`, `kit.loot`, `kit.production` | `player` (keyed by the player's id) | the caller's own hub: stacks and mail, soft currencies, levels and public profiles, achievements, quests with tutorials (`step` for the counters a client may report), crafting, loot with pity, idle production; private parts read again when the hub says they changed (18.13.0) |
+| `kit.shops.at(key)`, `kit.market.at(key)`, `kit.trades.at(key)` | `market` | vendors with stock and restocks (`buy`, `sell`), order books (`order`, `cancel`, `book`), trades between two players (`open`, `offer`, `accept`, `decline`); what a player puts up is held in their own hub, and a call that could not reach it is refused `unavailable` and sent again |
 | `kit.topology` | — | composes a manifest from `exec.starters` (the types picked, what they hang under and call), checks the tree, builds and deploys (developers, `manage_compute`) |
 | `kit.spectate`, `kit.emotes`, `kit.shards` | — | a viewer's heartbeat so the world's messages reach it; emotes as client events every kit client reads; shard keys as the hubs compute them |
 | `kit.social` | — | parties, guilds and chat rooms over teams and channels |
@@ -791,7 +793,11 @@ await kit.sessions.open(key).act({ points: 2 });   // sent with an action id: pl
   shape React's `useSyncExternalStore` takes. `PrivateState` reads what only its player may
   see with a call, again whenever the hub says it changed for them.
 - **Refusals** are `KitError` (a `CrowdyExecError` with status `AppError`) with a `code` to
-  branch on: `not_your_turn`, `cooldown`, `full`, `forbidden`, ... (`KIT_CODES`).
+  branch on: `not_your_turn`, `cooldown`, `full`, `forbidden`, ... (`KIT_CODES`). A call with an
+  action id refused `unavailable` (a hub it needed did not answer) is sent again (18.13.0).
+- **The economy is not a ledger.** Items and soft currency are hub state; a transfer between
+  players is steps each hub answers once. See the Game Kit's economy page before you put
+  anything of real value in it.
 - **Kit types are the hubs' MessagePack maps as they arrive**, field names and all
   (`time_of_day`, `expires_in_ms`), the same in CrowdyCPP and CrowdyPy.
 - **Realtime**: hubs show server-driven actors through the realtime tier; `kitActorCodec`,

package/dist/default-origin.d.ts

@@ -1,6 +1,6 @@
 /**
  * GENERATED — do not edit. The operator tooling's
- * `sync-client-origins.mjs --write --tier dev` writes this file, and
+ * `sync-client-origins.mjs --write --tier test` writes this file, and
  * `check-sdk-default-origin.mjs` refuses it when it names the wrong tier or a
  * host that declaration does not carry. Regenerate; never hand-edit.
  *
@@ -10,14 +10,14 @@
  * than no default at all. Every fallback this SDK ever removed named a host that
  * was already dead. A generated file plus a gate is what makes this one different.
  *
- * Source: the operator's per-tier public CK API origin declaration, tier 'dev'
+ * Source: the operator's per-tier public CK API origin declaration, tier 'test'
  */
 /** The tier this build of the SDK is published for. */
-export declare const CROWDY_DEFAULT_TIER = "dev";
+export declare const CROWDY_DEFAULT_TIER = "test";
 /** The public CK API origin for that tier. */
-export declare const CROWDY_DEFAULT_HTTP_ORIGIN = "https://ck.dev.crowdedkingdoms.com";
+export declare const CROWDY_DEFAULT_HTTP_ORIGIN = "https://ck.test.crowdedkingdoms.com";
 /** The same host over WebSocket. A scheme is composed; a hostname is looked up. */
-export declare const CROWDY_DEFAULT_WS_ORIGIN = "wss://ck.dev.crowdedkingdoms.com";
+export declare const CROWDY_DEFAULT_WS_ORIGIN = "wss://ck.test.crowdedkingdoms.com";
 /** The bare hostname, for callers that need to compare rather than dial. */
-export declare const CROWDY_DEFAULT_HOST = "ck.dev.crowdedkingdoms.com";
+export declare const CROWDY_DEFAULT_HOST = "ck.test.crowdedkingdoms.com";
 //# sourceMappingURL=default-origin.d.ts.map

package/dist/default-origin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-origin.d.ts","sourceRoot":"","sources":["../src/default-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,uCAAuC,CAAC;AAE/E,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,qCAAqC,CAAC;AAE3E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,+BAA+B,CAAC"}
+{"version":3,"file":"default-origin.d.ts","sourceRoot":"","sources":["../src/default-origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAEhF,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,gCAAgC,CAAC"}

package/dist/default-origin.js

@@ -1,6 +1,6 @@
 /**
  * GENERATED — do not edit. The operator tooling's
- * `sync-client-origins.mjs --write --tier dev` writes this file, and
+ * `sync-client-origins.mjs --write --tier test` writes this file, and
  * `check-sdk-default-origin.mjs` refuses it when it names the wrong tier or a
  * host that declaration does not carry. Regenerate; never hand-edit.
  *
@@ -10,13 +10,13 @@
  * than no default at all. Every fallback this SDK ever removed named a host that
  * was already dead. A generated file plus a gate is what makes this one different.
  *
- * Source: the operator's per-tier public CK API origin declaration, tier 'dev'
+ * Source: the operator's per-tier public CK API origin declaration, tier 'test'
  */
 /** The tier this build of the SDK is published for. */
-export const CROWDY_DEFAULT_TIER = 'dev';
+export const CROWDY_DEFAULT_TIER = 'test';
 /** The public CK API origin for that tier. */
-export const CROWDY_DEFAULT_HTTP_ORIGIN = 'https://ck.dev.crowdedkingdoms.com';
+export const CROWDY_DEFAULT_HTTP_ORIGIN = 'https://ck.test.crowdedkingdoms.com';
 /** The same host over WebSocket. A scheme is composed; a hostname is looked up. */
-export const CROWDY_DEFAULT_WS_ORIGIN = 'wss://ck.dev.crowdedkingdoms.com';
+export const CROWDY_DEFAULT_WS_ORIGIN = 'wss://ck.test.crowdedkingdoms.com';
 /** The bare hostname, for callers that need to compare rather than dial. */
-export const CROWDY_DEFAULT_HOST = 'ck.dev.crowdedkingdoms.com';
+export const CROWDY_DEFAULT_HOST = 'ck.test.crowdedkingdoms.com';

package/dist/generated/graphql-schema.d.ts

@@ -3760,14 +3760,14 @@ export type ExecStarterFile = {
     /** The path within the crate, as `execBuild` takes it. */
     path: Scalars['String']['output'];
 };
-/** 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. */
 export type ExecStarterPack = {
     __typename?: '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: Scalars['String']['output'];
     /** 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. */
     mod: Maybe<ExecStarter>;
-    /** The crates. */
+    /** One entry per node type of the manifest: a crate that serves two types appears twice, so build each crate once. */
     starters: Array<ExecStarter>;
 };
 /** A deployed version of an app’s ck-exec topology. */
@@ -6799,7 +6799,7 @@ export type Query = {
     execMods: Array<ExecMod>;
     /** Your mods in an app, on every grid. */
     execMyMods: Array<ExecMod>;
-    /** 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: ExecStarterPack;
     /** An app's deployed ck-exec versions, newest first, and which is active. Requires the org 'view_compute_diagnostics' permission. */
     execVersions: Array<ExecVersion>;