yeow-api 0.2.13 → 0.2.16

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yeow-api",
-    "version": "0.2.13",
+    "version": "0.2.16",
     "description": "Yeow API �?TypeScript OOP wrappers over the task protocol",
     "type": "module",
     "main": "./src/index.ts",

package/src/create-server.ts

@@ -0,0 +1,29 @@
+import { listen, respond, close } from './http.js';
+
+export async function createServer(port?: number) {
+    const routes: Record<string, Record<string, (req: any) => any>> = {};
+    const srv = await listen(async (req: any) => {
+        const method = (req.method || 'GET').toUpperCase();
+        const handler = routes[method]?.[req.path];
+        if (handler) {
+            const result = await handler(req);
+            if (result !== undefined) {
+                const opts = typeof result === 'string' ? { body: result } : result;
+                await respond(req.serverId, req.connId, opts);
+                return;
+            }
+        } else {
+            await respond(req.serverId, req.connId, { status: 404, body: 'Not Found' });
+        }
+    }, port);
+
+    const api = {
+        port: srv.port,
+        get(path: string, handler: (req: any) => any) { (routes['GET'] ??= {})[path] = handler; return api; },
+        post(path: string, handler: (req: any) => any) { (routes['POST'] ??= {})[path] = handler; return api; },
+        put(path: string, handler: (req: any) => any) { (routes['PUT'] ??= {})[path] = handler; return api; },
+        del(path: string, handler: (req: any) => any) { (routes['DELETE'] ??= {})[path] = handler; return api; },
+        close() { close(srv.serverId); },
+    };
+    return api;
+}

package/src/event.ts

@@ -156,6 +156,78 @@ export interface ServerPingEvent {
     motd: string;
 }
 
+export interface PlayerTeleportEvent {
+    player: Player;
+    from: Location;
+    to: Location;
+    cause: string;
+}
+
+export interface PlayerItemConsumeEvent {
+    player: Player;
+    itemType: string;
+}
+
+export interface EntityExplodeEvent {
+    entity: string;
+    entityType: string;
+    x: number;
+    y: number;
+    z: number;
+    blockCount: number;
+}
+
+export interface EntityRegainHealthEvent {
+    entity: string;
+    amount: number;
+    reason: string;
+}
+
+export interface EntityTargetEvent {
+    entity: string;
+    target: string | null;
+}
+
+export interface ProjectileHitEvent {
+    entity: string;
+    projectileType: string;
+    hitEntity: string | null;
+    hitBlock: { x: number; y: number; z: number; type: string } | null;
+}
+
+export interface BlockFadeEvent {
+    block: string;
+    x: number;
+    y: number;
+    z: number;
+}
+
+export interface BlockGrowEvent {
+    block: string;
+    x: number;
+    y: number;
+    z: number;
+}
+
+export interface BlockSpreadEvent {
+    block: string;
+    x: number;
+    y: number;
+    z: number;
+}
+
+export interface BlockExplodeEvent {
+    block: string;
+    x: number;
+    y: number;
+    z: number;
+}
+
+export interface ServerCommandEvent {
+    command: string;
+    sender: string;
+}
+
 // ── Event Type Mapping ─────────────────────────────────────────────
 
 type EventMap = {
@@ -181,9 +253,20 @@ type EventMap = {
     projectileLaunch: ProjectileLaunchEvent;
     blockBreak: BlockBreakEvent;
     blockPlace: BlockPlaceEvent;
+    blockFade: BlockFadeEvent;
+    blockGrow: BlockGrowEvent;
+    blockSpread: BlockSpreadEvent;
+    blockExplode: BlockExplodeEvent;
     inventoryOpen: InventoryOpenEvent;
     inventoryClose: InventoryCloseEvent;
     serverPing: ServerPingEvent;
+    serverCommand: ServerCommandEvent;
+    playerTeleport: PlayerTeleportEvent;
+    playerItemConsume: PlayerItemConsumeEvent;
+    entityExplode: EntityExplodeEvent;
+    entityRegainHealth: EntityRegainHealthEvent;
+    entityTarget: EntityTargetEvent;
+    projectileHit: ProjectileHitEvent;
 };
 
 // ── Event Data Adapter ──────────────────────────────────────────────
@@ -203,6 +286,7 @@ function adaptEvent(type: string, data: any): any {
     switch (type) {
         case 'playerJoin': case 'playerQuit': case 'playerChat': case 'playerMove':
         case 'playerInteract': case 'playerCommand': case 'playerDeath': case 'playerRespawn':
+        case 'playerTeleport': case 'playerItemConsume':
         case 'playerDropItem': case 'playerPickupItem': case 'playerBucketFill': case 'playerBucketEmpty':
         case 'playerExpChange': case 'playerLevelChange': case 'playerGameModeChange': case 'foodLevelChange':
         case 'blockBreak': case 'blockPlace': case 'inventoryOpen': case 'inventoryClose':

package/src/index.ts

@@ -7,15 +7,19 @@ export { eventOn, eventOff } from './event.js';
 export type {
     PlayerJoinEvent, PlayerQuitEvent, PlayerChatEvent, PlayerMoveEvent,
     PlayerInteractEvent, PlayerCommandEvent, PlayerDeathEvent, PlayerRespawnEvent,
+    PlayerTeleportEvent, PlayerItemConsumeEvent,
     PlayerDropItemEvent, PlayerPickupItemEvent, PlayerBucketFillEvent, PlayerBucketEmptyEvent,
     PlayerExpChangeEvent, PlayerLevelChangeEvent, PlayerGameModeChangeEvent, FoodLevelChangeEvent,
-    EntityDamageEvent, EntityDeathEvent, EntitySpawnEvent, ProjectileLaunchEvent,
-    BlockBreakEvent, BlockPlaceEvent,
+    EntityDamageEvent, EntityDeathEvent, EntitySpawnEvent, EntityExplodeEvent,
+    EntityRegainHealthEvent, EntityTargetEvent,
+    ProjectileLaunchEvent, ProjectileHitEvent,
+    BlockBreakEvent, BlockPlaceEvent, BlockFadeEvent, BlockGrowEvent, BlockSpreadEvent, BlockExplodeEvent,
     InventoryOpenEvent, InventoryCloseEvent,
-    ServerPingEvent,
+    ServerPingEvent, ServerCommandEvent,
 } from './event.js';
 export { onInit, onLoad } from './lifecycle.js';
 export { broadcast, broadcastSync, dispatchCommand, dispatchCommandSync, setMotd, setMotdSync, setIcon, setIconSync, getMotd, getVersion } from './server.js';
 export { fs, readFile, readFileSync, readFileBase64, readFileBase64Sync, writeFile, writeFileSync, writeFileBase64, writeFileBase64Sync, existsSync, deleteFile, mkdir, list } from './fs.js';
 export { assets, read as assetsRead, readSync as assetsReadSync, readBase64 as assetsReadBase64, readBase64Sync as assetsReadBase64Sync, extract as assetsExtract, extractSync as assetsExtractSync } from './assets.js';
 export { listen, respond, close, request, requestSync } from './http.js';
+export { createServer } from './create-server.js';

package/src/player.ts

@@ -20,6 +20,8 @@ export class Player {
     get location(): Location | null { const r = call('player.getLocation', { uuid: this.uuid }); return r ? Location.from(r as any) : null; }
     get displayName(): string { return call('player.getDisplayName', { uuid: this.uuid }) as string; }
     set displayName(v: string | null) { call('player.setDisplayName', { uuid: this.uuid, value: v }); }
+    get saturation(): number { return call('player.getSaturation', { uuid: this.uuid }) as number; }
+    get totalExperience(): number { return call('player.getTotalExperience', { uuid: this.uuid }) as number; }
 
     // Methods (async by default)
     sendMessage(msg: string): Promise<void> { return post('player.sendMessage', { uuid: this.uuid, message: msg }) as Promise<void>; }

package/src/world.ts

@@ -18,6 +18,7 @@ export class World {
     get spawnLocation(): Location | null { const r = call('world.getSpawnLocation', { world: this.name }) as any; return r ? new Location(r.x,r.y,r.z,r.yaw,r.pitch) : null; }
     set spawnLocation(v: Location) { call('world.setSpawnLocation', { world: this.name, ...v.toObject() }); }
 
+    getHighestBlockY(x: number, z: number): number { return call('world.getHighestBlockY', { world: this.name, x, z }) as number; }
     getGameRule(rule: string): string | null { return call('world.getGameRule', { world: this.name, rule }) as string | null; }
     setGameRule(rule: string, value: string): Promise<boolean> { return post('world.setGameRule', { world: this.name, rule, value }) as Promise<boolean>; }
     setGameRuleSync(rule: string, value: string): boolean { return call('world.setGameRule', { world: this.name, rule, value }) as boolean; }