import test from "node:test"; import assert from "node:assert/strict"; import { mkdtempSync } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; import { BlockType } from "../../shared/definitions/tiles.js"; import { ItemId } from "../../shared/definitions/items.js"; import { pigeonSpeedAtProgress, advanceCourierFlight } from "../../shared/courier/flight.js"; import { ensureCourierLegs } from "../../shared/courier/doorwayGraph.js"; import { OVERWORLD_ID, DimensionLightingMode, DimensionSeasonMode } from "../../shared/world/dimensions.js"; import { createEmptyChunkData, encodeChunkBlob } from "../src/world/chunkData.js"; import { WorldDatabase } from "../src/persistence/worldDb.js"; import { StateDatabase } from "../src/persistence/stateDb.js"; import { Simulation } from "../src/simulation/simulation.js"; import { makeCharacter, makeSimulation, stepTimes, writeOpenChunk, openChunkStrip } from "./helpers/simulationHarness.js"; test("pigeon flight uses takeoff, cruise, then landing speeds", () => { const settings = { pigeonTakeoffTilesPerSec: 3, pigeonCruiseTilesPerSec: 8, pigeonLandingTilesPerSec: 3, pigeonPhaseTiles: 5 }; assert.equal(pigeonSpeedAtProgress(0, 40, settings), 3); assert.equal(pigeonSpeedAtProgress(4.9, 40, settings), 3); assert.equal(pigeonSpeedAtProgress(10, 40, settings), 8); assert.equal(pigeonSpeedAtProgress(36, 40, settings), 3); const takeoff = advanceCourierFlight({ originX: 0, originY: 0, destX: 40, destY: 0, traveled: 0, dt: 1, settings }); assert.equal(takeoff.speed, 3); assert.ok(Math.abs(takeoff.traveled - 3) < 1e-6); const cruise = advanceCourierFlight({ originX: 0, originY: 0, destX: 40, destY: 0, traveled: 10, dt: 1, settings }); assert.equal(cruise.speed, 8); assert.ok(Math.abs(cruise.traveled - 18) < 1e-6); }); function placeBank (worldDb, tileX, tileY) { const chunkX = Math.floor(tileX / 16); const chunkY = Math.floor(tileY / 16); const data = createEmptyChunkData(); data.open = true; const localX = tileX - chunkX * 16; const localY = tileY - chunkY * 16; data.blocks[localY * 16 + localX] = { typeId: BlockType.bank, state: 0 }; worldDb.saveChunkVersion( chunkX, chunkY, worldDb.getActiveRevisionId(), true, encodeChunkBlob(data) ); } function countItem (slots, itemId) { return (slots ?? []) .filter((slot) => slot?.itemId === itemId) .reduce((sum, slot) => sum + (slot.quantity | 0), 0); } const CAVE_ID = "courier-cave"; function placeBlock (worldDb, tileX, tileY, block, dimensionId = OVERWORLD_ID) { const chunkX = Math.floor(tileX / 16); const chunkY = Math.floor(tileY / 16); const rev = worldDb.getActiveRevisionId(); const existing = worldDb.getChunkVersion(chunkX, chunkY, rev, dimensionId); const chunkData = createEmptyChunkData(); chunkData.open = true; if (existing?.data_blob) { const parsed = typeof existing.data_blob === "string" ? JSON.parse(existing.data_blob) : existing.data_blob; chunkData.grounds = parsed.grounds ?? chunkData.grounds; chunkData.blocks = parsed.blocks ?? chunkData.blocks; chunkData.open = parsed.open ?? true; } const localX = tileX - chunkX * 16; const localY = tileY - chunkY * 16; chunkData.blocks[localY * 16 + localX] = block; worldDb.saveChunkVersion( chunkX, chunkY, rev, true, encodeChunkBlob(chunkData), dimensionId ); } function placeDoorway (worldDb, tileX, tileY, targetDimensionId, targetTileX, targetTileY, dimensionId = OVERWORLD_ID) { placeBlock(worldDb, tileX, tileY, { typeId: BlockType.doorway, state: "door", config: { targetDimensionId, tileX: targetTileX, tileY: targetTileY } }, dimensionId); } function placeBankDim (worldDb, tileX, tileY, dimensionId = OVERWORLD_ID) { placeBlock(worldDb, tileX, tileY, { typeId: BlockType.bank, state: 0 }, dimensionId); } function makeDimCourierHarness () { const dir = mkdtempSync(join(tmpdir(), "mmo-courier-dim-")); const worldDb = new WorldDatabase(join(dir, "world.sqlite")); const stateDb = new StateDatabase(join(dir, "state.sqlite")); openChunkStrip(worldDb, 2); const rev = worldDb.getActiveRevisionId(); worldDb.saveDimension(rev, { dimensionId: CAVE_ID, displayName: "Courier Cave", lightingMode: DimensionLightingMode.alwaysLit, seasonMode: DimensionSeasonMode.summer, defaultGroundTypeId: 1 }); const cave = createEmptyChunkData(); cave.open = true; worldDb.saveChunkVersion(0, 0, rev, true, encodeChunkBlob(cave), CAVE_ID); writeOpenChunk(worldDb, 0, 0); writeOpenChunk(worldDb, 1, 0); let now = 1_000; const simulation = new Simulation(worldDb, stateDb, { workerCount: 1, workerMode: "inprocess", now: () => now }); return { simulation, worldDb, stateDb, advance (ms) { now += ms; }, close () { simulation.forceUnloadAll(); worldDb.close(); stateDb.close(); } }; } test("pigeon to bank deposits coin stacks into the sender vault", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 20, 8); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 20, pigeonCruiseTilesPerSec: 20, pigeonLandingTilesPerSec: 20, pigeonPhaseTiles: 5, simulationTickHz: 20 }); const character = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8 }); const entityId = harness.simulation.spawnCharacter(1, character); const before = harness.simulation.bagOf(entityId); const coinSlot = before.inventory.findIndex((slot) => slot?.itemId === ItemId.coins); assert.ok(coinSlot >= 0); assert.ok(before.inventory[coinSlot].quantity >= 5); const beforeCoins = before.inventory[coinSlot].quantity; const result = harness.simulation.dispatchPigeon({ characterId: character.character_id, destination: { kind: "bank" }, cargo: { kind: "item", slotIndex: coinSlot, quantity: 5 } }); assert.equal(result.transit.destinationKind, "bank"); assert.equal(harness.simulation.bagOf(entityId).inventory[coinSlot].quantity, beforeCoins - 5); stepTimes(harness.simulation, 80); const after = harness.stateDb.getBag(character.character_id); assert.equal(countItem(after.vault, ItemId.coins), 5); assert.equal(harness.stateDb.listActiveCourierTransits().length, 0); } finally { harness.close(); } }); test("pigeon to offline player flies to the bank and credits the recipient vault", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 20, 8); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const sender = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8, firstName: "Ada", lastName: "Sender" }); const receiver = makeCharacter(harness.stateDb, { tileX: 10, tileY: 8, firstName: "Bob", lastName: "Receiver" }); const senderId = harness.simulation.spawnCharacter(1, sender); harness.simulation.despawnCharacter(receiver.character_id); const bag = harness.simulation.bagOf(senderId); const appleSlot = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.apple); assert.ok(appleSlot >= 0); const result = harness.simulation.dispatchPigeon({ characterId: sender.character_id, destination: { kind: "player", firstName: "Bob", lastName: "Receiver" }, cargo: { kind: "item", slotIndex: appleSlot, quantity: 1 } }); assert.equal(result.transit.destinationKind, "bank"); assert.equal(result.transit.vaultCharacterId, receiver.character_id); assert.ok(Math.hypot(result.transit.destX - 20.5, result.transit.destY - 8.5) < 1); stepTimes(harness.simulation, 40); const receiverVault = harness.stateDb.getBag(receiver.character_id); assert.equal(countItem(receiverVault.vault, ItemId.apple), 1); assert.equal(harness.stateDb.listActiveCourierTransits().length, 0); } finally { harness.close(); } }); test("logging in after offline bank deposits sends a bank resting notice by pigeon", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 20, 8); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const sender = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8, firstName: "Ada", lastName: "Sender" }); const receiver = makeCharacter(harness.stateDb, { tileX: 10, tileY: 8, firstName: "Bob", lastName: "Receiver" }); const senderId = harness.simulation.spawnCharacter(1, sender); harness.simulation.despawnCharacter(receiver.character_id); const bag = harness.simulation.bagOf(senderId); const appleSlot = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.apple); harness.simulation.dispatchPigeon({ characterId: sender.character_id, destination: { kind: "player", firstName: "Bob", lastName: "Receiver" }, cargo: { kind: "item", slotIndex: appleSlot, quantity: 1 } }); stepTimes(harness.simulation, 40); assert.equal(harness.stateDb.listBankRestNotices(receiver.character_id).length, 1); const receiverId = harness.simulation.spawnCharacter(2, receiver); const active = harness.stateDb.listActiveCourierTransits(); assert.equal(active.length, 1); assert.equal(active[0].destinationKind, "player"); assert.equal(active[0].cargo.stack.itemId, ItemId.letter); assert.match(active[0].cargo.stack.instance.body, /While you have been resting/); assert.match(active[0].cargo.stack.instance.body, /Ada Sender/); stepTimes(harness.simulation, 40); const receiverBag = harness.simulation.bagOf(receiverId); const letterSlot = receiverBag.inventory.find((slot) => slot?.itemId === ItemId.letter); assert.ok(letterSlot); assert.equal(letterSlot.instance.authorDisplayName, "The Bank"); assert.equal(letterSlot.origins?.[0]?.origin?.verb, "Written"); assert.equal(letterSlot.origins?.[0]?.origin?.displayName, "The Bank"); assert.doesNotMatch(letterSlot.instance.body, /Signed,/); } finally { harness.close(); } }); test("pigeon delivers an item to an online player inventory", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const sender = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8, firstName: "Ada", lastName: "Sender" }); const receiver = makeCharacter(harness.stateDb, { tileX: 10, tileY: 8, firstName: "Bob", lastName: "Receiver" }); const senderId = harness.simulation.spawnCharacter(1, sender); const receiverId = harness.simulation.spawnCharacter(2, receiver); const bag = harness.simulation.bagOf(senderId); const appleSlot = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.apple); assert.ok(appleSlot >= 0); const senderQty = bag.inventory[appleSlot].quantity; const receiverBefore = harness.simulation.bagOf(receiverId); const receiverApples = receiverBefore.inventory .filter((slot) => slot?.itemId === ItemId.apple) .reduce((sum, slot) => sum + slot.quantity, 0); harness.simulation.dispatchPigeon({ characterId: sender.character_id, destination: { kind: "player", firstName: "Bob", lastName: "Receiver" }, cargo: { kind: "item", slotIndex: appleSlot, quantity: 1 } }); assert.equal(harness.simulation.bagOf(senderId).inventory[appleSlot].quantity, senderQty - 1); const events = stepTimes(harness.simulation, 40); const receiverAfter = harness.simulation.bagOf(receiverId); const receiverApplesAfter = receiverAfter.inventory .filter((slot) => slot?.itemId === ItemId.apple) .reduce((sum, slot) => sum + slot.quantity, 0); assert.equal(receiverApplesAfter, receiverApples + 1); assert.equal(harness.stateDb.listActiveCourierTransits().length, 0); assert.ok(events.some((event) => event.type === "item-bubble" && event.entityId === receiverId && event.itemId === ItemId.apple && event.quantity === 1 ), "pigeon delivery should show the craft-style item bubble"); } finally { harness.close(); } }); test("pigeon rejects blank cheques", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 8, 8); harness.simulation.reloadWorld(); const character = makeCharacter(harness.stateDb, { tileX: 8, tileY: 9 }); const entityId = harness.simulation.spawnCharacter(1, character); harness.simulation.enqueue(1, { type: "get-blank-cheques", characterId: character.character_id }); harness.simulation.step(); const bag = harness.simulation.bagOf(entityId); const blankIndex = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.blankCheque); assert.ok(blankIndex >= 0); assert.throws( () => harness.simulation.dispatchPigeon({ characterId: character.character_id, destination: { kind: "bank" }, cargo: { kind: "item", slotIndex: blankIndex, quantity: 1 } }), (err) => err.message === "Blank cheques cannot be sent by pigeon." ); } finally { harness.close(); } }); test("pigeon to bank redeems a filled cheque into reserved goods", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 20, 8); placeBank(harness.worldDb, 8, 8); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const character = makeCharacter(harness.stateDb, { tileX: 8, tileY: 9 }); const entityId = harness.simulation.spawnCharacter(1, character); harness.simulation.enqueue(1, { type: "get-blank-cheques", characterId: character.character_id }); harness.simulation.step(); let bag = harness.simulation.bagOf(entityId); harness.simulation.enqueue(1, { type: "bank-deposit", characterId: character.character_id, slotIndex: bag.inventory.findIndex((slot) => slot?.itemId === ItemId.apple), quantity: null }); harness.simulation.step(); bag = harness.simulation.bagOf(entityId); const applesBefore = countItem(bag.vault, ItemId.apple); harness.simulation.enqueue(1, { type: "write-cheque", characterId: character.character_id, slotIndex: bag.inventory.findIndex((slot) => slot?.itemId === ItemId.blankCheque), vaultSlotIndex: bag.vault.findIndex((slot) => slot?.itemId === ItemId.apple), quantity: 2 }); harness.simulation.step(); bag = harness.simulation.bagOf(entityId); const chequeIndex = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.filledCheque); assert.ok(chequeIndex >= 0); assert.equal((bag.vaultReserved ?? []).length, 1); harness.simulation.dispatchPigeon({ characterId: character.character_id, destination: { kind: "bank" }, cargo: { kind: "item", slotIndex: chequeIndex, quantity: 1 } }); stepTimes(harness.simulation, 80); bag = harness.simulation.bagOf(entityId); assert.equal(bag.inventory.findIndex((slot) => slot?.itemId === ItemId.filledCheque), -1); assert.equal(countItem(bag.vault, ItemId.filledCheque), 0); assert.equal((bag.vaultReserved ?? []).length, 0); assert.equal(countItem(bag.vault, ItemId.apple), applesBefore); } finally { harness.close(); } }); test("same-dimension pigeon still delivers with multi-leg schema", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 20, 8); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const character = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8 }); const entityId = harness.simulation.spawnCharacter(1, character); const bag = harness.simulation.bagOf(entityId); const coinSlot = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.coins); const result = harness.simulation.dispatchPigeon({ characterId: character.character_id, destination: { kind: "bank" }, cargo: { kind: "item", slotIndex: coinSlot, quantity: 3 } }); assert.equal(result.transit.originDimensionId, OVERWORLD_ID); assert.equal(result.transit.destDimensionId, OVERWORLD_ID); assert.ok(Array.isArray(result.transit.legs)); assert.equal(result.transit.legs.length, 1); assert.equal(result.transit.legs[0].kind, "fly"); stepTimes(harness.simulation, 80); const after = harness.stateDb.getBag(character.character_id); assert.equal(countItem(after.vault, ItemId.coins), 3); } finally { harness.close(); } }); test("cross-dimension pigeon flies through doorway portals", () => { const harness = makeDimCourierHarness(); try { placeBankDim(harness.worldDb, 20, 8, OVERWORLD_ID); placeDoorway(harness.worldDb, 4, 8, OVERWORLD_ID, 8, 8, CAVE_ID); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const character = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8 }); harness.stateDb.saveCharacterPosition(character.character_id, 2, 8, "walk", CAVE_ID); const entityId = harness.simulation.spawnCharacter(1, character); assert.equal(harness.simulation.positionOf(entityId).dimensionId, CAVE_ID); const bag = harness.simulation.bagOf(entityId); const coinSlot = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.coins); const result = harness.simulation.dispatchPigeon({ characterId: character.character_id, destination: { kind: "bank" }, cargo: { kind: "item", slotIndex: coinSlot, quantity: 2 } }); assert.equal(result.transit.originDimensionId, CAVE_ID); assert.equal(result.transit.destDimensionId, OVERWORLD_ID); assert.ok(result.transit.legs.some((leg) => leg.kind === "portal")); assert.ok(result.transit.legs.some((leg) => leg.kind === "fly")); stepTimes(harness.simulation, 200); const after = harness.stateDb.getBag(character.character_id); assert.equal(countItem(after.vault, ItemId.coins), 2); assert.equal(harness.stateDb.listActiveCourierTransits().length, 0); } finally { harness.close(); } }); test("cross-dimension pigeon without doorway path uses fade/abstract fallback", () => { const harness = makeDimCourierHarness(); try { placeBankDim(harness.worldDb, 20, 8, OVERWORLD_ID); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const character = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8 }); harness.stateDb.saveCharacterPosition(character.character_id, 2, 8, "walk", CAVE_ID); const entityId = harness.simulation.spawnCharacter(1, character); const bag = harness.simulation.bagOf(entityId); const coinSlot = bag.inventory.findIndex((slot) => slot?.itemId === ItemId.coins); const result = harness.simulation.dispatchPigeon({ characterId: character.character_id, destination: { kind: "bank" }, cargo: { kind: "item", slotIndex: coinSlot, quantity: 1 } }); assert.ok(result.transit.legs.some((leg) => leg.kind === "abstract")); assert.ok(!result.transit.legs.some((leg) => leg.kind === "portal")); stepTimes(harness.simulation, 300); const after = harness.stateDb.getBag(character.character_id); assert.equal(countItem(after.vault, ItemId.coins), 1); assert.equal(harness.stateDb.listActiveCourierTransits().length, 0); } finally { harness.close(); } }); test("legacy courier_transits rows migrate to overworld single-fly legs", () => { const harness = makeSimulation({ workerCount: 1, maxChunkX: 2 }); try { placeBank(harness.worldDb, 20, 8); harness.simulation.reloadWorld(); harness.simulation.applySettings({ pigeonTakeoffTilesPerSec: 40, pigeonCruiseTilesPerSec: 40, pigeonLandingTilesPerSec: 40, simulationTickHz: 20 }); const character = makeCharacter(harness.stateDb, { tileX: 2, tileY: 8 }); harness.simulation.spawnCharacter(1, character); const now = Date.now(); harness.stateDb.db.prepare(` INSERT INTO courier_transits ( sender_character_id, destination_kind, destination_character_id, cargo_blob, origin_x, origin_y, dest_x, dest_y, traveled, status, entity_id, updated_at, created_at, vault_character_id ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) `).run( character.character_id, "bank", null, JSON.stringify({ kind: "item", stack: { itemId: ItemId.coins, quantity: 4 } }), 2.5, 8.5, 20.5, 8.5, 0, "in_transit", null, now, now, character.character_id ); const listed = harness.stateDb.listActiveCourierTransits(); assert.equal(listed.length, 1); assert.equal(listed[0].originDimensionId, OVERWORLD_ID); assert.equal(listed[0].destDimensionId, OVERWORLD_ID); assert.equal(listed[0].legs, null); ensureCourierLegs(listed[0]); assert.equal(listed[0].legs.length, 1); stepTimes(harness.simulation, 80); const after = harness.stateDb.getBag(character.character_id); assert.equal(countItem(after.vault, ItemId.coins), 4); assert.equal(harness.stateDb.listActiveCourierTransits().length, 0); } finally { harness.close(); } });