@rhost/testkit 0.1.0

package/dist/reporter.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reporter = void 0;
+// ---------------------------------------------------------------------------
+// ANSI color helpers
+// ---------------------------------------------------------------------------
+const USE_COLOR = process.stdout.isTTY === true;
+function colorize(code, text) {
+    return USE_COLOR ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+const green = (s) => colorize('32', s);
+const red = (s) => colorize('31', s);
+const yellow = (s) => colorize('33', s);
+const gray = (s) => colorize('90', s);
+const bold = (s) => colorize('1', s);
+// ---------------------------------------------------------------------------
+// Reporter
+// ---------------------------------------------------------------------------
+class Reporter {
+    constructor(verbose) {
+        this.verbose = verbose;
+    }
+    suiteStart(name, depth) {
+        if (!this.verbose)
+            return;
+        const indent = '  '.repeat(depth);
+        process.stdout.write(`\n${indent}${bold(name)}\n`);
+    }
+    testPass(name, ms, depth) {
+        if (!this.verbose)
+            return;
+        const indent = '  '.repeat(depth + 1);
+        process.stdout.write(`${indent}${green('✓')} ${name} ${gray(`(${ms}ms)`)}\n`);
+    }
+    testFail(name, ms, depth, error) {
+        if (!this.verbose)
+            return;
+        const indent = '  '.repeat(depth + 1);
+        const errIndent = '  '.repeat(depth + 3);
+        process.stdout.write(`${indent}${red('✗')} ${name} ${gray(`(${ms}ms)`)}\n`);
+        const lines = error.message.split('\n');
+        for (const line of lines) {
+            process.stdout.write(`${errIndent}${line}\n`);
+        }
+    }
+    testSkip(name, depth) {
+        if (!this.verbose)
+            return;
+        const indent = '  '.repeat(depth + 1);
+        process.stdout.write(`${indent}${yellow('○')} ${gray(name)}\n`);
+    }
+    summary(result) {
+        if (!this.verbose)
+            return;
+        const parts = [];
+        if (result.passed > 0)
+            parts.push(green(`${result.passed} passed`));
+        if (result.failed > 0)
+            parts.push(red(`${result.failed} failed`));
+        if (result.skipped > 0)
+            parts.push(yellow(`${result.skipped} skipped`));
+        parts.push(`${result.total} total`);
+        process.stdout.write(`\nTests: ${parts.join(', ')} (${result.duration}ms)\n`);
+    }
+}
+exports.Reporter = Reporter;
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,90 @@
+import { RhostClient, RhostClientOptions } from './client';
+import { RhostAssert } from './assertions';
+import { RhostExpect } from './expect';
+import { RhostWorld } from './world';
+export interface RunResult {
+    passed: number;
+    failed: number;
+    skipped: number;
+    total: number;
+    duration: number;
+    failures: Array<{
+        suite: string;
+        test: string;
+        error: Error;
+    }>;
+}
+export interface TestContext {
+    expect(expression: string): RhostExpect;
+    client: RhostClient;
+    world: RhostWorld;
+}
+export type TestFn = (ctx: TestContext) => Promise<void> | void;
+export type HookFn = (ctx: {
+    client: RhostClient;
+    world: RhostWorld;
+}) => Promise<void> | void;
+export type ItFn = (name: string, fn: TestFn, timeout?: number) => void;
+export type DescribeFn = (name: string, fn: (ctx: SuiteContext) => void) => void;
+export interface SuiteContext {
+    it: ItFn & {
+        skip: ItFn;
+        only: ItFn;
+    };
+    test: ItFn & {
+        skip: ItFn;
+        only: ItFn;
+    };
+    describe: DescribeFn & {
+        skip: DescribeFn;
+        only: DescribeFn;
+    };
+    beforeAll(fn: HookFn): void;
+    afterAll(fn: HookFn): void;
+    beforeEach(fn: HookFn): void;
+    afterEach(fn: HookFn): void;
+}
+export interface RunnerOptions extends RhostClientOptions {
+    /** Character name. Required. */
+    username: string;
+    /** Character password. Required. */
+    password: string;
+    /** Print results to stdout while running. Default: true */
+    verbose?: boolean;
+}
+/**
+ * Jest-style test runner for RhostMUSH softcode.
+ *
+ * Supports nested describes, it.skip/it.only, describe.skip/describe.only,
+ * per-test timeouts, lifecycle hooks, and automatic world cleanup.
+ *
+ * @example
+ *   const runner = new RhostRunner();
+ *
+ *   runner.describe('Math', ({ it }) => {
+ *     it('add(2,3)', async ({ expect }) => {
+ *       await expect('add(2,3)').toBe('5');
+ *     });
+ *   });
+ *
+ *   const result = await runner.run({ username: 'Wizard', password: 'Nyctasia' });
+ *   process.exit(result.failed > 0 ? 1 : 0);
+ */
+export declare class RhostRunner {
+    private topLevel;
+    describe(name: string, fn: (ctx: SuiteContext) => void): this;
+    run(options: RunnerOptions): Promise<RunResult>;
+    private _buildSuite;
+    private _runSuite;
+    private _runTest;
+    /**
+     * Apply `only` semantics: if ANY direct child has mode 'only', only run
+     * those. Otherwise run all non-skip children.
+     */
+    private _resolveOnly;
+    private _countFailedFromBeforeAll;
+    private _countSkipped;
+    private _withTimeout;
+}
+export { RhostAssert };
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

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

package/dist/runner.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RhostAssert = exports.RhostRunner = void 0;
+const client_1 = require("./client");
+const assertions_1 = require("./assertions");
+Object.defineProperty(exports, "RhostAssert", { enumerable: true, get: function () { return assertions_1.RhostAssert; } });
+const expect_1 = require("./expect");
+const world_1 = require("./world");
+const reporter_1 = require("./reporter");
+// ---------------------------------------------------------------------------
+// RhostRunner
+// ---------------------------------------------------------------------------
+/**
+ * Jest-style test runner for RhostMUSH softcode.
+ *
+ * Supports nested describes, it.skip/it.only, describe.skip/describe.only,
+ * per-test timeouts, lifecycle hooks, and automatic world cleanup.
+ *
+ * @example
+ *   const runner = new RhostRunner();
+ *
+ *   runner.describe('Math', ({ it }) => {
+ *     it('add(2,3)', async ({ expect }) => {
+ *       await expect('add(2,3)').toBe('5');
+ *     });
+ *   });
+ *
+ *   const result = await runner.run({ username: 'Wizard', password: 'Nyctasia' });
+ *   process.exit(result.failed > 0 ? 1 : 0);
+ */
+class RhostRunner {
+    constructor() {
+        this.topLevel = [];
+    }
+    // -------------------------------------------------------------------------
+    // Collection-phase API
+    // -------------------------------------------------------------------------
+    describe(name, fn) {
+        this.topLevel.push(this._buildSuite(name, fn, 'normal'));
+        return this;
+    }
+    // -------------------------------------------------------------------------
+    // Execution phase
+    // -------------------------------------------------------------------------
+    async run(options) {
+        const verbose = options.verbose !== false;
+        const client = new client_1.RhostClient(options);
+        await client.connect();
+        await client.login(options.username, options.password);
+        const reporter = new reporter_1.Reporter(verbose);
+        const result = {
+            passed: 0, failed: 0, skipped: 0, total: 0, duration: 0, failures: [],
+        };
+        const start = Date.now();
+        // Wrap top-level nodes in a root suite for uniform execution
+        const root = {
+            kind: 'suite',
+            name: '',
+            mode: 'normal',
+            children: this.topLevel,
+            beforeAll: [], afterAll: [], beforeEach: [], afterEach: [],
+        };
+        await this._runSuite(root, client, reporter, result, [], 0);
+        result.duration = Date.now() - start;
+        reporter.summary(result);
+        await client.disconnect();
+        return result;
+    }
+    // -------------------------------------------------------------------------
+    // Internal: building the tree
+    // -------------------------------------------------------------------------
+    _buildSuite(name, fn, mode) {
+        const node = {
+            kind: 'suite', name, mode,
+            children: [], beforeAll: [], afterAll: [], beforeEach: [], afterEach: [],
+        };
+        const makeItFn = (itMode) => (testName, testFn, timeout) => {
+            node.children.push({ kind: 'test', name: testName, fn: testFn, mode: itMode, timeout });
+        };
+        const makeDescribeFn = (descMode) => (descName, descFn) => {
+            node.children.push(this._buildSuite(descName, descFn, descMode));
+        };
+        const itFn = makeItFn('normal');
+        itFn.skip = makeItFn('skip');
+        itFn.only = makeItFn('only');
+        const describeFn = makeDescribeFn('normal');
+        describeFn.skip = makeDescribeFn('skip');
+        describeFn.only = makeDescribeFn('only');
+        fn({
+            it: itFn,
+            test: itFn,
+            describe: describeFn,
+            beforeAll: (h) => node.beforeAll.push(h),
+            afterAll: (h) => node.afterAll.push(h),
+            beforeEach: (h) => node.beforeEach.push(h),
+            afterEach: (h) => node.afterEach.push(h),
+        });
+        return node;
+    }
+    // -------------------------------------------------------------------------
+    // Internal: executing the tree
+    // -------------------------------------------------------------------------
+    async _runSuite(suite, client, reporter, result, inheritedBeforeEach, depth) {
+        // Skip entire suite if marked skip
+        if (suite.mode === 'skip') {
+            this._countSkipped(suite, result, reporter, depth);
+            return;
+        }
+        if (suite.name)
+            reporter.suiteStart(suite.name, depth);
+        // Resolve which children are active given `only` semantics
+        const activeChildren = this._resolveOnly(suite.children);
+        // Build the cumulative beforeEach/afterEach stack (inherited + suite-level)
+        const combinedBeforeEach = [...inheritedBeforeEach, ...suite.beforeEach];
+        // Run suite-level beforeAll hooks — if one throws, count all suite tests as failures
+        const hookCtx = { client, world: new world_1.RhostWorld(client) };
+        for (const hook of suite.beforeAll) {
+            try {
+                await hook(hookCtx);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                this._countFailedFromBeforeAll(suite, result, reporter, depth, error);
+                return;
+            }
+        }
+        for (const child of suite.children) {
+            if (child.kind === 'suite') {
+                const effectiveMode = activeChildren.includes(child) ? child.mode : 'skip';
+                const childWithMode = effectiveMode !== child.mode
+                    ? { ...child, mode: effectiveMode }
+                    : child;
+                await this._runSuite(childWithMode, client, reporter, result, combinedBeforeEach, depth + (suite.name ? 1 : 0));
+            }
+            else {
+                const skip = !activeChildren.includes(child) || child.mode === 'skip';
+                await this._runTest(child, skip, client, reporter, result, combinedBeforeEach, suite.afterEach, suite.name, depth + (suite.name ? 1 : 0));
+            }
+        }
+        // Run suite-level afterAll hooks
+        for (const hook of suite.afterAll) {
+            await hook(hookCtx);
+        }
+    }
+    async _runTest(test, skip, client, reporter, result, beforeEachHooks, afterEachHooks, suiteName, depth) {
+        result.total++;
+        if (skip || test.mode === 'skip') {
+            result.skipped++;
+            reporter.testSkip(test.name, depth);
+            return;
+        }
+        const world = new world_1.RhostWorld(client);
+        const hookCtx = { client, world };
+        const testCtx = {
+            client,
+            world,
+            expect: (expr) => new expect_1.RhostExpect(client, expr),
+        };
+        // Run inherited + suite beforeEach — if one throws, count as a test failure
+        for (const hook of beforeEachHooks) {
+            try {
+                await hook(hookCtx);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                result.failed++;
+                result.failures.push({ suite: suiteName, test: test.name, error });
+                reporter.testFail(test.name, 0, depth, error);
+                try {
+                    await world.cleanup();
+                }
+                catch { /* ignore */ }
+                return;
+            }
+        }
+        const t0 = Date.now();
+        try {
+            const timeoutMs = test.timeout ?? 15000;
+            await this._withTimeout(test.fn(testCtx), timeoutMs, test.name);
+            const ms = Date.now() - t0;
+            result.passed++;
+            reporter.testPass(test.name, ms, depth);
+        }
+        catch (err) {
+            const ms = Date.now() - t0;
+            result.failed++;
+            const error = err instanceof Error ? err : new Error(String(err));
+            result.failures.push({ suite: suiteName, test: test.name, error });
+            reporter.testFail(test.name, ms, depth, error);
+        }
+        finally {
+            // Auto-cleanup world (ignore errors)
+            try {
+                await world.cleanup();
+            }
+            catch { /* ignore */ }
+        }
+        // Run suite afterEach
+        for (const hook of afterEachHooks) {
+            try {
+                await hook(hookCtx);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    /**
+     * Apply `only` semantics: if ANY direct child has mode 'only', only run
+     * those. Otherwise run all non-skip children.
+     */
+    _resolveOnly(children) {
+        const hasOnly = children.some((c) => c.mode === 'only');
+        if (hasOnly) {
+            return children.filter((c) => c.mode === 'only');
+        }
+        return children.filter((c) => c.mode !== 'skip');
+    }
+    _countFailedFromBeforeAll(suite, result, reporter, depth, error) {
+        for (const child of suite.children) {
+            if (child.kind === 'suite') {
+                this._countFailedFromBeforeAll(child, result, reporter, depth + 1, error);
+            }
+            else {
+                result.total++;
+                result.failed++;
+                result.failures.push({ suite: suite.name, test: child.name, error });
+                reporter.testFail(child.name, 0, depth + 1, error);
+            }
+        }
+    }
+    _countSkipped(suite, result, reporter, depth) {
+        if (suite.name)
+            reporter.suiteStart(suite.name, depth);
+        for (const child of suite.children) {
+            if (child.kind === 'suite') {
+                this._countSkipped(child, result, reporter, depth + 1);
+            }
+            else {
+                result.total++;
+                result.skipped++;
+                reporter.testSkip(child.name, depth + 1);
+            }
+        }
+    }
+    _withTimeout(p, ms, name) {
+        if (!(p instanceof Promise))
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error(`Test "${name}" timed out after ${ms}ms`)), ms);
+            // Unref so Node won't keep the process alive if the test hangs
+            if (typeof timer.unref === 'function')
+                timer.unref();
+            p.then(() => { clearTimeout(timer); resolve(); }, (err) => { clearTimeout(timer); reject(err); });
+        });
+    }
+}
+exports.RhostRunner = RhostRunner;
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/world.d.ts

@@ -0,0 +1,62 @@
+import { RhostClient } from './client';
+/**
+ * RhostWorld — fixture manager for creating and cleaning up in-game objects
+ * during test runs.
+ *
+ * @example
+ *   const world = new RhostWorld(client);
+ *   const obj = await world.create('TestThing');
+ *   await world.set(obj, 'MYATTR', 'hello');
+ *   const val = await world.get(obj, 'MYATTR');  // => 'hello'
+ *   await world.cleanup();   // auto-nukes everything
+ */
+export declare class RhostWorld {
+    private readonly client;
+    private dbrefs;
+    constructor(client: RhostClient);
+    private guardInput;
+    /**
+     * Creates a THING via `@create name`.
+     * Parses the dbref from the command output (e.g. "name created as object #42").
+     * Registers the dbref for automatic cleanup.
+     * Returns the dbref string like '#42'.
+     */
+    create(name: string, cost?: number): Promise<string>;
+    /**
+     * Creates a ROOM via `@dig name`.
+     * Parses the output for the dbref (e.g. "name created as room #NN.").
+     * Registers the dbref for automatic cleanup.
+     */
+    dig(name: string): Promise<string>;
+    /**
+     * Destroys an object with `@nuke dbref`.
+     */
+    destroy(dbref: string): Promise<void>;
+    /**
+     * Sets an attribute: `&ATTR dbref=value`.
+     */
+    set(dbref: string, attr: string, value: string): Promise<void>;
+    /**
+     * Gets an attribute by evaluating `get(dbref/ATTR)`.
+     */
+    get(dbref: string, attr: string): Promise<string>;
+    /**
+     * Locks an object: `@lock dbref=<lockstring>`.
+     */
+    lock(dbref: string, lockstring: string): Promise<void>;
+    /**
+     * Sets a flag: `@set dbref=FLAG` or `@set dbref=!FLAG` to clear.
+     */
+    flag(dbref: string, flag: string, clear?: boolean): Promise<void>;
+    /**
+     * Triggers `@trigger dbref/ATTR=args`. Returns captured output lines.
+     */
+    trigger(dbref: string, attr: string, args?: string): Promise<string[]>;
+    /**
+     * Destroys all objects created by this world instance (in reverse order).
+     */
+    cleanup(): Promise<void>;
+    /** How many objects are tracked for cleanup. */
+    get size(): number;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IAGP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAgB;gBAED,MAAM,EAAE,WAAW;IAEhD,OAAO,CAAC,UAAU;IAQlB;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa1D;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAexC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS5E;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/world.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RhostWorld = void 0;
+/**
+ * RhostWorld — fixture manager for creating and cleaning up in-game objects
+ * during test runs.
+ *
+ * @example
+ *   const world = new RhostWorld(client);
+ *   const obj = await world.create('TestThing');
+ *   await world.set(obj, 'MYATTR', 'hello');
+ *   const val = await world.get(obj, 'MYATTR');  // => 'hello'
+ *   await world.cleanup();   // auto-nukes everything
+ */
+class RhostWorld {
+    constructor(client) {
+        this.client = client;
+        this.dbrefs = [];
+    }
+    guardInput(field, value) {
+        if (/[\n\r]/.test(value)) {
+            throw new RangeError(`world: invalid ${field} — value must not contain newline or carriage return characters`);
+        }
+    }
+    /**
+     * Creates a THING via `@create name`.
+     * Parses the dbref from the command output (e.g. "name created as object #42").
+     * Registers the dbref for automatic cleanup.
+     * Returns the dbref string like '#42'.
+     */
+    async create(name, cost) {
+        this.guardInput('name', name);
+        const expr = cost !== undefined ? `create(${name},${cost})` : `create(${name})`;
+        const result = (await this.client.eval(expr)).trim();
+        const m = result.match(/^#(\d+)$/);
+        if (m) {
+            const dbref = `#${m[1]}`;
+            this.dbrefs.push(dbref);
+            return dbref;
+        }
+        throw new Error(`world.create(${JSON.stringify(name)}) returned unexpected value: ${JSON.stringify(result)}`);
+    }
+    /**
+     * Creates a ROOM via `@dig name`.
+     * Parses the output for the dbref (e.g. "name created as room #NN.").
+     * Registers the dbref for automatic cleanup.
+     */
+    async dig(name) {
+        this.guardInput('name', name);
+        const lines = await this.client.command(`@dig ${name}`);
+        // Match "#42" or "room number 42" or "room number #42"
+        for (const line of lines) {
+            const m = line.match(/(?:room number\s+#?|#)(\d+)/i);
+            if (m) {
+                const dbref = `#${m[1]}`;
+                this.dbrefs.push(dbref);
+                return dbref;
+            }
+        }
+        throw new Error(`world.dig(${JSON.stringify(name)}) could not parse dbref from output: ${JSON.stringify(lines)}`);
+    }
+    /**
+     * Destroys an object with `@nuke dbref`.
+     */
+    async destroy(dbref) {
+        await this.client.command(`@nuke ${dbref}`);
+    }
+    /**
+     * Sets an attribute: `&ATTR dbref=value`.
+     */
+    async set(dbref, attr, value) {
+        this.guardInput('attr', attr);
+        this.guardInput('value', value);
+        await this.client.command(`&${attr} ${dbref}=${value}`);
+    }
+    /**
+     * Gets an attribute by evaluating `get(dbref/ATTR)`.
+     */
+    async get(dbref, attr) {
+        // Strip the '#' for the get() call — Rhost expects get(#42/ATTR)
+        return (await this.client.eval(`get(${dbref}/${attr})`)).trim();
+    }
+    /**
+     * Locks an object: `@lock dbref=<lockstring>`.
+     */
+    async lock(dbref, lockstring) {
+        this.guardInput('lockstring', lockstring);
+        await this.client.command(`@lock ${dbref}=${lockstring}`);
+    }
+    /**
+     * Sets a flag: `@set dbref=FLAG` or `@set dbref=!FLAG` to clear.
+     */
+    async flag(dbref, flag, clear = false) {
+        this.guardInput('flag', flag);
+        const flagStr = clear ? `!${flag}` : flag;
+        await this.client.command(`@set ${dbref}=${flagStr}`);
+    }
+    /**
+     * Triggers `@trigger dbref/ATTR=args`. Returns captured output lines.
+     */
+    async trigger(dbref, attr, args) {
+        this.guardInput('attr', attr);
+        if (args !== undefined)
+            this.guardInput('args', args);
+        const cmd = args
+            ? `@trigger ${dbref}/${attr}=${args}`
+            : `@trigger ${dbref}/${attr}`;
+        return this.client.command(cmd);
+    }
+    /**
+     * Destroys all objects created by this world instance (in reverse order).
+     */
+    async cleanup() {
+        const toDestroy = this.dbrefs.splice(0).reverse();
+        for (const dbref of toDestroy) {
+            try {
+                await this.destroy(dbref);
+            }
+            catch {
+                // Ignore cleanup errors — object may already be gone
+            }
+        }
+    }
+    /** How many objects are tracked for cleanup. */
+    get size() {
+        return this.dbrefs.length;
+    }
+}
+exports.RhostWorld = RhostWorld;
+//# sourceMappingURL=world.js.map

package/dist/world.js.map

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