@maka/maka-cli 5.9.0 → 5.11.0

package/bundle/typescript/src/commands/game/sideQuest/game.d.ts

@@ -2,6 +2,8 @@ import blessed from 'blessed';
 import { ISceneSeedJson } from './types/seed/scene-seed.js';
 import { Item } from './models/item.js';
 import { Player, Inventory, Room, Scene } from './models/_index.js';
+import { ISaveFileV1, ISavedItem, SaveReason } from './types/save-file.js';
+import { IDocwagonContract } from './utilities/docwagon.js';
 import { ILifestyleTier } from './utilities/commerce.js';
 import { NPC } from './models/npc.js';
 import { AutoFight } from './utilities/auto-fight.js';
@@ -36,8 +38,57 @@ export default class Game {
         spent: number;
         gigs: number;
         asked: boolean;
+        role?: string;
     }>;
+    pendingProcurements: {
+        contact: string;
+        itemConfig: ISavedItem;
+        price: number;
+    }[];
+    docwagon?: IDocwagonContract;
+    enlistedAlly?: {
+        name: string;
+        description: string;
+        combat: Record<string, unknown>;
+    };
+    commandRefusals: Record<string, number>;
+    performedThisCycle: boolean;
+    /** The recruited contact joins at the jobsite curb ("takes their own
+     *  ride and meets you there" -- the companion convention). */
+    spawnEnlistedAlly(): string[];
+    /** Bills a DocWagon fee: cred first, shortfall onto the rent tab (the
+     *  street's one universal collections agency). Returns the line. */
+    private billDocwagon;
+    /**
+     * The band answers (SR5e p.450). 'htr': a High Threat Response team
+     * extracts a flatlining KO'd runner instead of the street deciding.
+     * 'resusc': clinical death reversed -- a free resuscitation or the
+     * 5,000 fee -- the sanctioned carve-out to permadeath (player ruling;
+     * overflow-past-Body instant death isn't modeled yet, so every death
+     * is currently within reach of the crash cart). Returns true when the
+     * rescue engages -- the caller must then NOT end the game.
+     */
+    tryDocwagonRescue(kind: 'htr' | 'resusc', opts?: {
+        standingHostiles?: string[];
+    }): boolean;
+    /** Where the wagon drops you (player ruling: the CLINIC, not your own
+     *  cot): the district Street Doc's room, generically -- so generated
+     *  hubs work too. Falls back to the hideout if the hub has no doc. */
+    private docwagonDropOff;
+    /** The ride out on a stretcher: mid-run this is a homecoming (rent and
+     *  all), then the recovery bed at the clinic. */
+    private docwagonMedevac;
     /** How much juice the name carries, read off the role. */
+    /**
+     * A contact's ROLE, the SR5e archetype list (p.98: fixer, arms dealer,
+     * smuggler, talismonger, street doc, mechanic, bartender...) -- same
+     * keyword school as connectionFor below. Stored on the contact entry
+     * at open time so the roster (and the save) carry it.
+     */
+    static roleOf(npc: {
+        name: string;
+        description?: string;
+    }): string;
     static connectionFor(npc: {
         name: string;
         description?: string;
@@ -60,6 +111,10 @@ export default class Game {
         boundDevice?: Item;
     }[];
     private _pendingRedeploys;
+    private _saveFilePath?;
+    private _dead;
+    private _resume?;
+    private _hubSeed?;
     /**
      * The one correct runtime NPC spawn (mirrors scene-factory's seed
      * path): construct with a scene-bound registry, add to the scene
@@ -117,6 +172,9 @@ export default class Game {
      * cumulative spend raises it at each full 1,000 nuyen (cap 3).
      * Returns a player-facing line when something changed, else null.
      */
+    /** A hub-cast member by name, for roster displays that need the live
+     *  actor (contacts.ts reads their commlink to show reachability). */
+    hubActor(name: string): Player | NPC | undefined;
     touchContact(name: string, kind: 'trade' | 'gig', spent?: number): string | null;
     pendingSale?: {
         itemName: string;
@@ -191,6 +249,9 @@ export default class Game {
     get homeRoom(): Room | undefined;
     private _pendingRunSeed?;
     private _pendingRunTier?;
+    pendingRunAccepted: boolean;
+    /** Trash the offer wholesale ("decline", and any future fixer snub). */
+    clearPendingRun(): void;
     get pendingRun(): ISceneSeedJson | undefined;
     get pendingRunTier(): number | undefined;
     /**
@@ -230,6 +291,23 @@ export default class Game {
     get metaBox(): blessed.Widgets.BoxElement;
     get inputBox(): blessed.Widgets.TextboxElement;
     init(options: IMainGameConfig, screen: blessed.Widgets.Screen): Promise<string>;
+    /**
+     * Everything a save restores beyond the seed synthesis: the player,
+     * the hub world overlay, and the Game-level ledgers. Ordering inside
+     * matters less than its POSITION in init(): after seedHomeTurfContacts
+     * and snapshotVendorStock (both deliberately pre-overlay).
+     */
+    private applyResumeState;
+    /**
+     * THE single save routine -- every safe beat funnels here. Guards make
+     * it a silent no-op anywhere a save would lie: mid-run (the "runs are
+     * disposable" ruling lives in the scene === _hubScene check), downed
+     * or KO'd, mid-exchange, dead, or before init finishes. Synchronous by
+     * design so the process-exit quit hook can use it; failures log and
+     * never crash a turn.
+     */
+    requestSave(reason: SaveReason): void;
+    private buildSaveFile;
     /**
      * Synchronous readiness check for continueToNextScene() -- lets callers
      * give instant feedback for the "not ready yet" cases (job not done, no
@@ -352,7 +430,7 @@ export default class Game {
     updateEquipment(_playerEquipment: PlayerEquipment): void;
     updateExits(_room: Room): void;
     updateInventory(_playerInventory: Inventory, _currencyName?: string): void;
-    static getInstance(player: Player, sceneSeed: ISceneSeedJson): Promise<Game>;
+    static getInstance(player: Player, sceneSeed: ISceneSeedJson, resume?: ISaveFileV1): Promise<Game>;
     handleInput(input: string): Promise<string | null>;
     /**
      * The help taxonomy: every entry is [primary, ...aliases], grouped the