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

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

@@ -0,0 +1,264 @@
+import type { KitRuntime } from '../runtime.js';
+import { WritableKitStore, type KitStore } from '../store.js';
+/** Items and currency moved together: a price, a reward, a hold. */
+export interface EconBundle {
+    items: Record<string, number>;
+    currency: Record<string, number>;
+}
+export interface EconStack {
+    item: string;
+    count: number;
+}
+/** What the `inventory` read answers: only the player reads it. */
+export interface InventoryView {
+    slots: number;
+    stacks: EconStack[];
+    /** Items given that did not fit, waiting for {@link InventoryKit.takeMail}. */
+    mail: Record<string, number>;
+    /** Items held for a trade or an order. */
+    held: Record<string, number>;
+}
+/** What the `wallet` read answers. */
+export interface WalletView {
+    balances: Record<string, number>;
+    /** Currency held for a trade or an order. */
+    held: Record<string, number>;
+}
+export interface AchievementView {
+    id: string;
+    counter: string;
+    target: number;
+    count: number;
+    unlocked_at: number | null;
+}
+export interface QuestObjectiveView {
+    counter: string;
+    target: number;
+    count: number;
+}
+export interface QuestView {
+    id: string;
+    state: 'locked' | 'available' | 'active' | 'complete' | 'done';
+    objectives: QuestObjectiveView[];
+    reward: EconBundle;
+    xp: number;
+    tutorial: boolean;
+}
+/** What the `progress` read answers. */
+export interface ProgressView {
+    level: number;
+    xp: number;
+    /** What the level takes to finish; null at the top. */
+    next: number | null;
+    total_xp: number;
+    achievements: AchievementView[];
+    quests: QuestView[];
+}
+/** What the `player` topic carries and `profile` answers: anyone may read it. */
+export interface PlayerProfile {
+    player: number;
+    level: number;
+    achievements: string[];
+    quests_done: number;
+}
+export interface ProductionView {
+    producers: Array<[string, number]>;
+    stock: Record<string, number>;
+    capacity: Record<string, number>;
+}
+/** Everything a player's hub keeps for them (`me`). */
+export interface PlayerView {
+    profile: PlayerProfile;
+    inventory: InventoryView;
+    wallet: WalletView;
+    progress: ProgressView;
+    production: ProductionView;
+}
+/** What one change earned: levels, achievements, quests complete. */
+export interface PlayerEarned {
+    levels: number;
+    achievements: string[];
+    quests: string[];
+}
+export interface EconRecipe {
+    id: string;
+    inputs: EconBundle;
+    outputs: EconBundle;
+    level: number;
+}
+export interface LootTableView {
+    id: string;
+    cost: EconBundle;
+    entries: Array<{
+        item: string;
+        count: number;
+        weight: number;
+        pity_group: string | null;
+    }>;
+    pity_within: Record<string, number>;
+}
+/** What `rules` answers: the game's items, recipes, loot tables, quests and achievements. */
+export interface PlayerRules {
+    slots: number;
+    items: Array<{
+        id: string;
+        max_stack: number;
+        tradable: boolean;
+        name: string;
+    }>;
+    currencies: string[];
+    recipes: EconRecipe[];
+    loot: LootTableView[];
+    quests: Array<Record<string, unknown>>;
+    achievements: Array<Record<string, unknown>>;
+    client_counters: string[];
+}
+export interface LootRoll {
+    item: string;
+    count: number;
+    /** Pity picked it. */
+    pity: boolean;
+    roll: number;
+}
+/** A `player` topic event: a level gained, an achievement unlocked. */
+export type PlayerEvent = {
+    type: 'level';
+    player: number;
+    level: number;
+} | {
+    type: 'achievement';
+    player: number;
+    achievement: string;
+};
+/** A store fed by another once it exists. */
+declare class Relay<T> extends WritableKitStore<T | undefined> {
+    constructor();
+    attach(source: KitStore<T | undefined>): void;
+}
+/**
+ * The caller's own `player` hub (the `player` starter), keyed by their player id: what they own
+ * and what they have done. Its stores exist from the start and fill once {@link watch} has read
+ * them; only the player reads `inventory`, `wallet` and `progress`, and each is read again when
+ * the hub says it changed. The economy is not a ledger: see the Game Kit's economy page.
+ */
+export declare class PlayerKit {
+    private readonly runtime;
+    readonly nodeType: string;
+    private readonly playerKey?;
+    readonly profile: Relay<PlayerProfile>;
+    readonly inventory: Relay<InventoryView>;
+    readonly wallet: Relay<WalletView>;
+    readonly progress: Relay<ProgressView>;
+    private parts;
+    private rulesRead;
+    private readonly events;
+    constructor(runtime: KitRuntime, nodeType?: string, playerKey?: string | undefined);
+    /** The hub's key: the player's id. */
+    key(): Promise<string>;
+    private ready;
+    /** Mirrors the profile and reads what only the player reads (all of it, or the parts named). */
+    watch(...which: Array<'profile' | 'inventory' | 'wallet' | 'progress'>): Promise<void>;
+    unwatch(): Promise<void>;
+    /** Levels gained and achievements unlocked, as the `player` topic announces them. */
+    onEvent(listener: (e: PlayerEvent) => void): () => void;
+    /** Calls the player's hub; a change carries an action id. */
+    call<T>(method: string, args?: unknown, change?: boolean): Promise<T>;
+    /** Everything the hub keeps for the player. */
+    me(): Promise<PlayerView>;
+    /** The game's items, recipes, loot tables, quests and achievements (read once). */
+    rules(): Promise<PlayerRules>;
+    /** Another player's public profile. */
+    profileOf(player: number | string): Promise<PlayerProfile>;
+}
+/** The player's items: stacks in slots, and mail for what did not fit. */
+export declare class InventoryKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    get items(): KitStore<InventoryView | undefined>;
+    watch(): Promise<InventoryView | undefined>;
+    /** How many of `item` the player has, as last read. */
+    count(item: string): number;
+    /** @throws {KitError} `insufficient`. */
+    discard(item: string, count: number): Promise<boolean>;
+    /** Moves what fits from the mail into the inventory; resolves with what moved. */
+    takeMail(): Promise<EconBundle>;
+}
+/** The player's soft currencies. */
+export declare class WalletKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    get balances(): KitStore<WalletView | undefined>;
+    watch(): Promise<WalletView | undefined>;
+    /** The balance of `currency`, as last read. */
+    balance(currency: string): number;
+}
+/** Experience and levels, and the public profile. */
+export declare class ProgressionKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    get progress(): KitStore<ProgressView | undefined>;
+    get profile(): KitStore<PlayerProfile | undefined>;
+    watch(): Promise<ProgressView | undefined>;
+    /** Another player's public profile. */
+    profileOf(player: number | string): Promise<PlayerProfile>;
+    /** Called with each level the player reaches. */
+    onLevel(listener: (level: number) => void): () => void;
+}
+/** Achievements: counts of what the player did, unlocked once. */
+export declare class AchievementsKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    watch(): Promise<AchievementView[]>;
+    /** The achievements with their counts, as last read (hidden ones once unlocked). */
+    list(): AchievementView[];
+    /** Called with each achievement the player unlocks. */
+    onUnlock(listener: (achievement: string) => void): () => void;
+}
+/** Quests, first-session tutorials among them. */
+export declare class QuestsKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    watch(): Promise<QuestView[]>;
+    list(): QuestView[];
+    /** @throws {KitError} `conflict` (taken, done, or another first), `forbidden` (level), `not_found`. */
+    accept(quest: string): Promise<boolean>;
+    /** Claims a complete quest's reward. @throws {KitError} `not_ready`, `full`. */
+    claim(quest: string): Promise<EconBundle>;
+    /**
+     * Reports one of the counters the game lets a client report (a tutorial step).
+     * @throws {KitError} `forbidden` for a counter the game's hubs count.
+     */
+    step(counter: string): Promise<PlayerEarned>;
+}
+/** Crafting from the game's recipes. */
+export declare class CraftingKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    recipes(): Promise<EconRecipe[]>;
+    /** Crafts `times` (once by default). @throws {KitError} `insufficient`, `full`, `forbidden` (level), `not_found`. */
+    craft(recipe: string, times?: number): Promise<{
+        made: EconBundle;
+        earned: PlayerEarned;
+    }>;
+}
+/** Loot tables with pity. */
+export declare class LootKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    tables(): Promise<LootTableView[]>;
+    /** Pays the table's cost and rolls once. @throws {KitError} `insufficient`, `full`, `not_found`. */
+    open(table: string): Promise<{
+        roll: LootRoll;
+        earned: PlayerEarned;
+    }>;
+}
+/** Idle production that catches up on the time away. */
+export declare class ProductionKit {
+    private readonly player;
+    constructor(player: PlayerKit);
+    view(): Promise<ProductionView>;
+    /** Moves what the producers made into the inventory, as far as it fits. */
+    collect(): Promise<EconBundle>;
+}
+export {};
+//# sourceMappingURL=player.d.ts.map

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

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

package/dist/kit/modules/player.js

@@ -0,0 +1,258 @@
+import { CrowdyError } from '../../errors.js';
+import { HubState, PrivateState } from '../mirror.js';
+import { WritableKitStore } from '../store.js';
+const TOPIC = 'player';
+/** A store fed by another once it exists. */
+class Relay extends WritableKitStore {
+    constructor() {
+        super(undefined);
+    }
+    attach(source) {
+        source.subscribe((v) => this.set(v));
+        if (source.get() !== undefined)
+            this.set(source.get());
+    }
+}
+/**
+ * The caller's own `player` hub (the `player` starter), keyed by their player id: what they own
+ * and what they have done. Its stores exist from the start and fill once {@link watch} has read
+ * them; only the player reads `inventory`, `wallet` and `progress`, and each is read again when
+ * the hub says it changed. The economy is not a ledger: see the Game Kit's economy page.
+ */
+export class PlayerKit {
+    constructor(runtime, nodeType = 'player', playerKey) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.playerKey = playerKey;
+        this.profile = new Relay();
+        this.inventory = new Relay();
+        this.wallet = new Relay();
+        this.progress = new Relay();
+        this.parts = null;
+        this.rulesRead = null;
+        this.events = new Set();
+    }
+    /** The hub's key: the player's id. */
+    async key() {
+        const key = this.playerKey ?? (await this.runtime.playerId());
+        if (key === null || key === undefined) {
+            throw new CrowdyError({ message: 'the kit does not know which player it is: pass playerId to client.kit()' });
+        }
+        return key;
+    }
+    ready() {
+        this.parts ?? (this.parts = (async () => {
+            const key = await this.key();
+            const read = (method) => () => this.runtime.call(this.nodeType, key, method);
+            const source = { nodeType: this.nodeType, key, topic: TOPIC };
+            const parts = {
+                key,
+                profile: new HubState(this.runtime, this.nodeType, key, TOPIC),
+                inventory: new PrivateState(this.runtime, { ...source, what: 'inventory', read: read('inventory') }),
+                wallet: new PrivateState(this.runtime, { ...source, what: 'wallet', read: read('wallet') }),
+                progress: new PrivateState(this.runtime, { ...source, what: 'progress', read: read('progress') }),
+            };
+            this.profile.attach(parts.profile);
+            this.inventory.attach(parts.inventory);
+            this.wallet.attach(parts.wallet);
+            this.progress.attach(parts.progress);
+            parts.profile.onEvent((body) => {
+                for (const l of [...this.events])
+                    l(body);
+            });
+            return parts;
+        })().catch((e) => {
+            this.parts = null;
+            throw e;
+        }));
+        return this.parts;
+    }
+    /** Mirrors the profile and reads what only the player reads (all of it, or the parts named). */
+    async watch(...which) {
+        const parts = await this.ready();
+        const all = which.length ? which : ['profile', 'inventory', 'wallet', 'progress'];
+        await Promise.all(all.map((w) => parts[w].start()));
+    }
+    async unwatch() {
+        if (!this.parts)
+            return;
+        const parts = await this.parts;
+        await Promise.all([parts.profile.stop(), parts.inventory.stop(), parts.wallet.stop(), parts.progress.stop()]);
+    }
+    /** Levels gained and achievements unlocked, as the `player` topic announces them. */
+    onEvent(listener) {
+        this.events.add(listener);
+        return () => this.events.delete(listener);
+    }
+    /** Calls the player's hub; a change carries an action id. */
+    async call(method, args, change = true) {
+        return this.runtime.call(this.nodeType, await this.key(), method, args ?? null, change ? { action: true } : {});
+    }
+    /** Everything the hub keeps for the player. */
+    me() {
+        return this.call('me', null, false);
+    }
+    /** The game's items, recipes, loot tables, quests and achievements (read once). */
+    rules() {
+        this.rulesRead ?? (this.rulesRead = this.call('rules', null, false).catch((e) => {
+            this.rulesRead = null;
+            throw e;
+        }));
+        return this.rulesRead;
+    }
+    /** Another player's public profile. */
+    profileOf(player) {
+        return this.runtime.call(this.nodeType, String(player), 'profile');
+    }
+}
+/** The player's items: stacks in slots, and mail for what did not fit. */
+export class InventoryKit {
+    constructor(player) {
+        this.player = player;
+    }
+    get items() {
+        return this.player.inventory;
+    }
+    async watch() {
+        await this.player.watch('inventory');
+        return this.player.inventory.get();
+    }
+    /** How many of `item` the player has, as last read. */
+    count(item) {
+        return (this.player.inventory.get()?.stacks ?? []).filter((s) => s.item === item).reduce((n, s) => n + s.count, 0);
+    }
+    /** @throws {KitError} `insufficient`. */
+    discard(item, count) {
+        return this.player.call('discard', { item, count });
+    }
+    /** Moves what fits from the mail into the inventory; resolves with what moved. */
+    takeMail() {
+        return this.player.call('take_mail');
+    }
+}
+/** The player's soft currencies. */
+export class WalletKit {
+    constructor(player) {
+        this.player = player;
+    }
+    get balances() {
+        return this.player.wallet;
+    }
+    async watch() {
+        await this.player.watch('wallet');
+        return this.player.wallet.get();
+    }
+    /** The balance of `currency`, as last read. */
+    balance(currency) {
+        return this.player.wallet.get()?.balances[currency] ?? 0;
+    }
+}
+/** Experience and levels, and the public profile. */
+export class ProgressionKit {
+    constructor(player) {
+        this.player = player;
+    }
+    get progress() {
+        return this.player.progress;
+    }
+    get profile() {
+        return this.player.profile;
+    }
+    async watch() {
+        await this.player.watch('profile', 'progress');
+        return this.player.progress.get();
+    }
+    /** Another player's public profile. */
+    profileOf(player) {
+        return this.player.profileOf(player);
+    }
+    /** Called with each level the player reaches. */
+    onLevel(listener) {
+        return this.player.onEvent((e) => e.type === 'level' && listener(e.level));
+    }
+}
+/** Achievements: counts of what the player did, unlocked once. */
+export class AchievementsKit {
+    constructor(player) {
+        this.player = player;
+    }
+    async watch() {
+        await this.player.watch('profile', 'progress');
+        return this.list();
+    }
+    /** The achievements with their counts, as last read (hidden ones once unlocked). */
+    list() {
+        return this.player.progress.get()?.achievements ?? [];
+    }
+    /** Called with each achievement the player unlocks. */
+    onUnlock(listener) {
+        return this.player.onEvent((e) => e.type === 'achievement' && listener(e.achievement));
+    }
+}
+/** Quests, first-session tutorials among them. */
+export class QuestsKit {
+    constructor(player) {
+        this.player = player;
+    }
+    async watch() {
+        await this.player.watch('progress');
+        return this.list();
+    }
+    list() {
+        return this.player.progress.get()?.quests ?? [];
+    }
+    /** @throws {KitError} `conflict` (taken, done, or another first), `forbidden` (level), `not_found`. */
+    accept(quest) {
+        return this.player.call('accept', { quest });
+    }
+    /** Claims a complete quest's reward. @throws {KitError} `not_ready`, `full`. */
+    claim(quest) {
+        return this.player.call('claim', { quest });
+    }
+    /**
+     * Reports one of the counters the game lets a client report (a tutorial step).
+     * @throws {KitError} `forbidden` for a counter the game's hubs count.
+     */
+    step(counter) {
+        return this.player.call('step', { counter });
+    }
+}
+/** Crafting from the game's recipes. */
+export class CraftingKit {
+    constructor(player) {
+        this.player = player;
+    }
+    async recipes() {
+        return (await this.player.rules()).recipes;
+    }
+    /** Crafts `times` (once by default). @throws {KitError} `insufficient`, `full`, `forbidden` (level), `not_found`. */
+    craft(recipe, times) {
+        return this.player.call('craft', times === undefined ? { recipe } : { recipe, times });
+    }
+}
+/** Loot tables with pity. */
+export class LootKit {
+    constructor(player) {
+        this.player = player;
+    }
+    async tables() {
+        return (await this.player.rules()).loot;
+    }
+    /** Pays the table's cost and rolls once. @throws {KitError} `insufficient`, `full`, `not_found`. */
+    open(table) {
+        return this.player.call('open', { table });
+    }
+}
+/** Idle production that catches up on the time away. */
+export class ProductionKit {
+    constructor(player) {
+        this.player = player;
+    }
+    async view() {
+        return (await this.player.me()).production;
+    }
+    /** Moves what the producers made into the inventory, as far as it fits. */
+    collect() {
+        return this.player.call('collect');
+    }
+}

package/dist/kit/protocol.d.ts

@@ -90,6 +90,8 @@ export declare const KIT_CODES: {
     readonly EXPIRED: "expired";
     readonly INSUFFICIENT: "insufficient";
     readonly ALREADY_DONE: "already_done";
+    /** A hub the call needed did not answer: the kit sends it again with its action id. */
+    readonly UNAVAILABLE: "unavailable";
 };
 /**
  * A kit hub refused the call (`AppError` with a `kit:<code>:` message): `code` is what to

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

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

package/dist/kit/protocol.js

@@ -81,6 +81,8 @@ export const KIT_CODES = {
     EXPIRED: 'expired',
     INSUFFICIENT: 'insufficient',
     ALREADY_DONE: 'already_done',
+    /** A hub the call needed did not answer: the kit sends it again with its action id. */
+    UNAVAILABLE: 'unavailable',
 };
 /**
  * A kit hub refused the call (`AppError` with a `kit:<code>:` message): `code` is what to

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/kit/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8CD;;;;;;GAMG;AACH,qBAAa,UAAU;IAYnB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAd1B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqC;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,EAAE,CAAuC;gBAGtC,KAAK,EAAE,MAAM,EACL,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,OAAO,GAAE,iBAAsB,EAC/B,MAAM,CAAC,GAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,aAAA;IAMxD,2CAA2C;IACrC,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;YAY7B,IAAI;IAmBlB,mFAAmF;IAC7E,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQxC;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IA2Bb;;;;OAIG;IACG,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IA2B/B,sDAAsD;IACtD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,yFAAyF;IACzF,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKzD,wFAAwF;IACxF,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAK7D,mEAAmE;IACnE,KAAK,IAAI,IAAI;CAMd"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/kit/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8CD;;;;;;GAMG;AACH,qBAAa,UAAU;IAYnB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAd1B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqC;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,EAAE,CAAuC;gBAGtC,KAAK,EAAE,MAAM,EACL,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,OAAO,GAAE,iBAAsB,EAC/B,MAAM,CAAC,GAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,aAAA;IAMxD,2CAA2C;IACrC,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;YAY7B,IAAI;IAmBlB,mFAAmF;IAC7E,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQxC;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAgCb;;;;OAIG;IACG,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IA2B/B,sDAAsD;IACtD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,yFAAyF;IACzF,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKzD,wFAAwF;IACxF,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAK7D,mEAAmE;IACnE,KAAK,IAAI,IAAI;CAMd"}

package/dist/kit/runtime.js

@@ -1,5 +1,5 @@
 import { CrowdyExecError, } from '../domains/exec.js';
-import { KitError, newActionId, withActionId } from './protocol.js';
+import { KIT_CODES, KitError, newActionId, withActionId } from './protocol.js';
 /** Subscriptions one connection holds at most (the gateway refuses the next). */
 export const KIT_SUBSCRIPTIONS_MAX = 256;
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -120,6 +120,11 @@ export class KitRuntime {
             }
             catch (e) {
                 const err = KitError.from(e);
+                // A hub that could not hear from another one did not finish, and keeps no receipt.
+                if (attempt < this.retries && actionId && err instanceof KitError && err.code === KIT_CODES.UNAVAILABLE) {
+                    await sleep(Math.min(2000, 200 * 2 ** attempt) * (0.5 + Math.random() / 2));
+                    continue;
+                }
                 if (attempt < this.retries && err instanceof CrowdyExecError && !(err instanceof KitError)) {
                     if (err.status === 'Busy' && err.rateLimited) {
                         this.budget.hold(err.retryAfterMs ?? 1000);