@rhost/testkit 0.1.1 → 1.3.1

package/dist/expect.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RhostExpect = exports.RhostExpectError = exports.isRhostError = void 0;
+const snapshots_1 = require("./snapshots");
 var assertions_1 = require("./assertions");
 Object.defineProperty(exports, "isRhostError", { enumerable: true, get: function () { return assertions_1.isRhostError; } });
 const assertions_2 = require("./assertions");
@@ -33,17 +34,21 @@ exports.RhostExpectError = RhostExpectError;
  *   const ex = new RhostExpect(client, 'add(2,3)');
  *   await ex.toBe('5');
  *   await ex.not.toBe('42');
+ *
+ * @example Snapshot testing (requires runner context)
+ *   await expect('iter(lnum(1,10),##)').toMatchSnapshot();
  */
 class RhostExpect {
-    constructor(client, expression, negated = false) {
+    constructor(client, expression, negated = false, snapshotCtx) {
         this.client = client;
         this.expression = expression;
         this.negated = negated;
+        this.snapshotCtx = snapshotCtx;
         this._cached = undefined;
     }
     /** Negation accessor — returns a new RhostExpect with negation flipped. */
     get not() {
-        return new RhostExpect(this.client, this.expression, !this.negated);
+        return new RhostExpect(this.client, this.expression, !this.negated, this.snapshotCtx);
     }
     // -------------------------------------------------------------------------
     // Internal helpers
@@ -159,6 +164,46 @@ class RhostExpect {
         const words = actual === '' ? [] : actual.split(sep).map((w) => w.trim()).filter(Boolean);
         this.pass(words.length === n, 'toHaveWordCount', actual, `list with ${n} word(s) (got ${words.length})`);
     }
+    // -------------------------------------------------------------------------
+    // Snapshot matcher
+    // -------------------------------------------------------------------------
+    /**
+     * Compare the evaluated result against a stored snapshot.
+     *
+     * **First run**: the value is written to the snapshot file and the test passes.
+     * **Subsequent runs**: the value is compared to the stored snapshot. A mismatch
+     * fails the test and shows a diff.
+     * **Update mode**: pass `updateSnapshots: true` in `RunnerOptions`, or set the
+     * `RHOST_UPDATE_SNAPSHOTS=1` environment variable, to overwrite stored values.
+     *
+     * `.not.toMatchSnapshot()` is not supported and will throw.
+     *
+     * @example
+     *   await expect('iter(lnum(1,10),##)').toMatchSnapshot();
+     *   await expect('table(name,age,role)').toMatchSnapshot();
+     */
+    async toMatchSnapshot() {
+        if (this.negated) {
+            throw new Error('expect().not.toMatchSnapshot() is not supported. ' +
+                'Snapshots are for locking in specific values, not for asserting inequality.');
+        }
+        if (!this.snapshotCtx) {
+            throw new Error('toMatchSnapshot() requires snapshot context. ' +
+                'Use runner.run() to run tests — do not call toMatchSnapshot() on a standalone RhostExpect.');
+        }
+        const actual = await this.resolve();
+        const key = this.snapshotCtx.manager.nextKey(this.snapshotCtx.testName);
+        const result = this.snapshotCtx.manager.check(key, actual);
+        if (result.status === 'mismatch') {
+            const diff = (0, snapshots_1.formatSnapshotDiff)(result.expected, actual);
+            throw new Error(`Snapshot mismatch for "${key}"\n\n` +
+                `  - Snapshot  (stored)\n` +
+                `  + Received  (actual)\n\n` +
+                `${diff}\n\n` +
+                `Run with RHOST_UPDATE_SNAPSHOTS=1 to update the stored snapshot.`);
+        }
+        // 'written', 'matched', 'updated' — all pass silently
+    }
 }
 exports.RhostExpect = RhostExpect;
 //# sourceMappingURL=expect.js.map

package/dist/expect.js.map

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

package/dist/index.d.ts

@@ -1,9 +1,16 @@
-export { RhostClient, RhostClientOptions, stripAnsi } from './client';
+export { RhostClient, RhostClientOptions, PreviewOptions, stripAnsi } from './client';
 export { MushConnection } from './connection';
 export { RhostContainer, ContainerConnectionInfo } from './container';
 export { RhostAssert, RhostAssertionError, AssertionResult, isRhostError } from './assertions';
 export { RhostExpect, RhostExpectError } from './expect';
-export { RhostWorld } from './world';
+export { RhostWorld, WorldSnapshot, WorldDiff, WorldObjectDiff, WorldSideEffectError } from './world';
+export { preflight, preflightCheck, assertFunctionExists, assertFunctionMissing, assertConfigEquals, PreflightCheck, PreflightResult, PreflightOptions, PreflightError, } from './preflight';
 export { Reporter } from './reporter';
-export { RhostRunner, RunnerOptions, RunResult, TestContext, TestFn, HookFn, SuiteContext, ItFn, DescribeFn, } from './runner';
+export { RhostRunner, RunnerOptions, RunResult, TestContext, TestFn, HookFn, PersonaTestFn, PersonaCredentials, SuiteContext, ItFn, DescribeFn, PersonasFn, } from './runner';
+export { validate, validateFile, compatibilityReport, ValidationResult, Diagnostic, Severity, FunctionSignature, BUILTIN_FUNCTIONS, Platform, CompatibilityReport, CompatibilityEntry, } from './validator';
+export { format, FormatOptions, FormatResult } from './validator/formatter';
+export { RhostBenchmark, runBench, formatBenchResults, BenchOptions, BenchmarkResult } from './benchmark';
+export { deploy, parseDeployFile, snapshotObjects, restoreSnapshot, DeployCommand, DeploySnapshot, DeployOptions, DeployResult, } from './deployer';
+export { SnapshotManager, SnapshotStats, SnapshotStatus, SnapshotCheckResult, formatSnapshotDiff } from './snapshots';
+export { RhostWatcher, WatchOptions, discoverTestFiles } from './watcher';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG/F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EACH,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,MAAM,EACN,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,UAAU,GACb,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGtF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG/F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGtG,OAAO,EACH,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,cAAc,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EACH,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,MAAM,EACN,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,UAAU,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1G,OAAO,EACH,MAAM,EACN,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RhostRunner = exports.Reporter = exports.RhostWorld = exports.RhostExpectError = exports.RhostExpect = exports.isRhostError = exports.RhostAssertionError = exports.RhostAssert = exports.RhostContainer = exports.MushConnection = exports.stripAnsi = exports.RhostClient = void 0;
+exports.discoverTestFiles = exports.RhostWatcher = exports.formatSnapshotDiff = exports.SnapshotManager = exports.restoreSnapshot = exports.snapshotObjects = exports.parseDeployFile = exports.deploy = exports.formatBenchResults = exports.runBench = exports.RhostBenchmark = exports.format = exports.BUILTIN_FUNCTIONS = exports.compatibilityReport = exports.validateFile = exports.validate = exports.RhostRunner = exports.Reporter = exports.PreflightError = exports.assertConfigEquals = exports.assertFunctionMissing = exports.assertFunctionExists = exports.preflightCheck = exports.preflight = exports.WorldSideEffectError = exports.WorldSnapshot = exports.RhostWorld = exports.RhostExpectError = exports.RhostExpect = exports.isRhostError = exports.RhostAssertionError = exports.RhostAssert = exports.RhostContainer = exports.MushConnection = exports.stripAnsi = exports.RhostClient = void 0;
 // Core client
 var client_1 = require("./client");
 Object.defineProperty(exports, "RhostClient", { enumerable: true, get: function () { return client_1.RhostClient; } });
@@ -23,10 +23,48 @@ Object.defineProperty(exports, "RhostExpectError", { enumerable: true, get: func
 // World fixture manager
 var world_1 = require("./world");
 Object.defineProperty(exports, "RhostWorld", { enumerable: true, get: function () { return world_1.RhostWorld; } });
+Object.defineProperty(exports, "WorldSnapshot", { enumerable: true, get: function () { return world_1.WorldSnapshot; } });
+Object.defineProperty(exports, "WorldSideEffectError", { enumerable: true, get: function () { return world_1.WorldSideEffectError; } });
+// Pre-flight assertions
+var preflight_1 = require("./preflight");
+Object.defineProperty(exports, "preflight", { enumerable: true, get: function () { return preflight_1.preflight; } });
+Object.defineProperty(exports, "preflightCheck", { enumerable: true, get: function () { return preflight_1.preflightCheck; } });
+Object.defineProperty(exports, "assertFunctionExists", { enumerable: true, get: function () { return preflight_1.assertFunctionExists; } });
+Object.defineProperty(exports, "assertFunctionMissing", { enumerable: true, get: function () { return preflight_1.assertFunctionMissing; } });
+Object.defineProperty(exports, "assertConfigEquals", { enumerable: true, get: function () { return preflight_1.assertConfigEquals; } });
+Object.defineProperty(exports, "PreflightError", { enumerable: true, get: function () { return preflight_1.PreflightError; } });
 // Reporter
 var reporter_1 = require("./reporter");
 Object.defineProperty(exports, "Reporter", { enumerable: true, get: function () { return reporter_1.Reporter; } });
 // Runner + types
 var runner_1 = require("./runner");
 Object.defineProperty(exports, "RhostRunner", { enumerable: true, get: function () { return runner_1.RhostRunner; } });
+// Offline softcode validator + compat report
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return validator_1.validate; } });
+Object.defineProperty(exports, "validateFile", { enumerable: true, get: function () { return validator_1.validateFile; } });
+Object.defineProperty(exports, "compatibilityReport", { enumerable: true, get: function () { return validator_1.compatibilityReport; } });
+Object.defineProperty(exports, "BUILTIN_FUNCTIONS", { enumerable: true, get: function () { return validator_1.BUILTIN_FUNCTIONS; } });
+// Softcode formatter
+var formatter_1 = require("./validator/formatter");
+Object.defineProperty(exports, "format", { enumerable: true, get: function () { return formatter_1.format; } });
+// Benchmark mode
+var benchmark_1 = require("./benchmark");
+Object.defineProperty(exports, "RhostBenchmark", { enumerable: true, get: function () { return benchmark_1.RhostBenchmark; } });
+Object.defineProperty(exports, "runBench", { enumerable: true, get: function () { return benchmark_1.runBench; } });
+Object.defineProperty(exports, "formatBenchResults", { enumerable: true, get: function () { return benchmark_1.formatBenchResults; } });
+// Deploy pipeline
+var deployer_1 = require("./deployer");
+Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deployer_1.deploy; } });
+Object.defineProperty(exports, "parseDeployFile", { enumerable: true, get: function () { return deployer_1.parseDeployFile; } });
+Object.defineProperty(exports, "snapshotObjects", { enumerable: true, get: function () { return deployer_1.snapshotObjects; } });
+Object.defineProperty(exports, "restoreSnapshot", { enumerable: true, get: function () { return deployer_1.restoreSnapshot; } });
+// Snapshot manager
+var snapshots_1 = require("./snapshots");
+Object.defineProperty(exports, "SnapshotManager", { enumerable: true, get: function () { return snapshots_1.SnapshotManager; } });
+Object.defineProperty(exports, "formatSnapshotDiff", { enumerable: true, get: function () { return snapshots_1.formatSnapshotDiff; } });
+// Watch mode
+var watcher_1 = require("./watcher");
+Object.defineProperty(exports, "RhostWatcher", { enumerable: true, get: function () { return watcher_1.RhostWatcher; } });
+Object.defineProperty(exports, "discoverTestFiles", { enumerable: true, get: function () { return watcher_1.discoverTestFiles; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,mCAAsE;AAA7D,qGAAA,WAAW,OAAA;AAAsB,mGAAA,SAAS,OAAA;AAEnD,aAAa;AACb,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAEvB,YAAY;AACZ,yCAAsE;AAA7D,2GAAA,cAAc,OAAA;AAEvB,+BAA+B;AAC/B,2CAA+F;AAAtF,yGAAA,WAAW,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAAmB,0GAAA,YAAY,OAAA;AAExE,iBAAiB;AACjB,mCAAyD;AAAhD,qGAAA,WAAW,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAEtC,wBAAwB;AACxB,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AAEnB,WAAW;AACX,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,iBAAiB;AACjB,mCAUkB;AATd,qGAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,mCAAsF;AAA7E,qGAAA,WAAW,OAAA;AAAsC,mGAAA,SAAS,OAAA;AAEnE,aAAa;AACb,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAEvB,YAAY;AACZ,yCAAsE;AAA7D,2GAAA,cAAc,OAAA;AAEvB,+BAA+B;AAC/B,2CAA+F;AAAtF,yGAAA,WAAW,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAAmB,0GAAA,YAAY,OAAA;AAExE,iBAAiB;AACjB,mCAAyD;AAAhD,qGAAA,WAAW,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAEtC,wBAAwB;AACxB,iCAAsG;AAA7F,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAA8B,6GAAA,oBAAoB,OAAA;AAEpF,wBAAwB;AACxB,yCAUqB;AATjB,sGAAA,SAAS,OAAA;AACT,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AACpB,kHAAA,qBAAqB,OAAA;AACrB,+GAAA,kBAAkB,OAAA;AAIlB,2GAAA,cAAc,OAAA;AAGlB,WAAW;AACX,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,iBAAiB;AACjB,mCAakB;AAZd,qGAAA,WAAW,OAAA;AAcf,6CAA6C;AAC7C,yCAYqB;AAXjB,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,gHAAA,mBAAmB,OAAA;AAKnB,8GAAA,iBAAiB,OAAA;AAMrB,qBAAqB;AACrB,mDAA4E;AAAnE,mGAAA,MAAM,OAAA;AAEf,iBAAiB;AACjB,yCAA0G;AAAjG,2GAAA,cAAc,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AAErD,kBAAkB;AAClB,uCASoB;AARhB,kGAAA,MAAM,OAAA;AACN,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AAOnB,mBAAmB;AACnB,yCAAsH;AAA7G,4GAAA,eAAe,OAAA;AAAsD,+GAAA,kBAAkB,OAAA;AAEhG,aAAa;AACb,qCAA0E;AAAjE,uGAAA,YAAY,OAAA;AAAgB,4GAAA,iBAAiB,OAAA"}

package/dist/preflight.d.ts

@@ -0,0 +1,70 @@
+import { RhostClient } from './client';
+export interface PreflightCheckResult {
+    name: string;
+    passed: boolean;
+    message?: string;
+}
+export interface PreflightResult {
+    passed: number;
+    failed: number;
+    checks: PreflightCheckResult[];
+}
+export interface PreflightCheck {
+    name: string;
+    run(client: RhostClient): Promise<{
+        passed: boolean;
+        message?: string;
+    }>;
+}
+export interface PreflightOptions {
+    /**
+     * Throw a PreflightError if any check fails. Default: true.
+     * Set false to collect all results without throwing.
+     */
+    throwOnFailure?: boolean;
+}
+export declare class PreflightError extends Error {
+    readonly result: PreflightResult;
+    constructor(result: PreflightResult);
+}
+/**
+ * Run a set of pre-flight checks against a live server before tests start.
+ *
+ * By default throws `PreflightError` if any check fails. Pass
+ * `{ throwOnFailure: false }` to collect results without throwing.
+ *
+ * @example
+ *   await preflight(client, [
+ *     assertFunctionExists('json'),
+ *     assertFunctionExists('localize'),
+ *     assertConfigEquals('attr_limit', '500'),
+ *   ]);
+ */
+export declare function preflight(client: RhostClient, checks: PreflightCheck[], options?: PreflightOptions): Promise<PreflightResult>;
+/**
+ * Factory for a custom preflight check with an arbitrary async predicate.
+ */
+export declare function preflightCheck(name: string, fn: (client: RhostClient) => Promise<{
+    passed: boolean;
+    message?: string;
+}>): PreflightCheck;
+/**
+ * Assert that a softcode function is available on the server.
+ *
+ * Evals `funcname()` and checks that the response does not include "NOT FOUND".
+ * A "wrong number of arguments" error means the function exists.
+ */
+export declare function assertFunctionExists(name: string): PreflightCheck;
+/**
+ * Assert that a softcode function is NOT available on the server.
+ *
+ * Useful to confirm a restricted or removed function is absent.
+ */
+export declare function assertFunctionMissing(name: string): PreflightCheck;
+/**
+ * Assert that a server config key equals an expected value.
+ *
+ * Evals `config(key)` and compares the trimmed result to `expected`.
+ */
+export declare function assertConfigEquals(key: string, expected: string): PreflightCheck;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMvC,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAe,SAAQ,KAAK;aACT,MAAM,EAAE,eAAe;gBAAvB,MAAM,EAAE,eAAe;CAQtD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC3B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,GAAE,gBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAyB1B;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5E,cAAc,CAEhB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAWjE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAWlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAWhF"}

package/dist/preflight.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreflightError = void 0;
+exports.preflight = preflight;
+exports.preflightCheck = preflightCheck;
+exports.assertFunctionExists = assertFunctionExists;
+exports.assertFunctionMissing = assertFunctionMissing;
+exports.assertConfigEquals = assertConfigEquals;
+class PreflightError extends Error {
+    constructor(result) {
+        const failedNames = result.checks
+            .filter((c) => !c.passed)
+            .map((c) => `  ✗ ${c.name}${c.message ? ': ' + c.message : ''}`)
+            .join('\n');
+        super(`preflight: ${result.failed} check(s) failed\n${failedNames}`);
+        this.result = result;
+        this.name = 'PreflightError';
+    }
+}
+exports.PreflightError = PreflightError;
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+/**
+ * Run a set of pre-flight checks against a live server before tests start.
+ *
+ * By default throws `PreflightError` if any check fails. Pass
+ * `{ throwOnFailure: false }` to collect results without throwing.
+ *
+ * @example
+ *   await preflight(client, [
+ *     assertFunctionExists('json'),
+ *     assertFunctionExists('localize'),
+ *     assertConfigEquals('attr_limit', '500'),
+ *   ]);
+ */
+async function preflight(client, checks, options = {}) {
+    const throwOnFailure = options.throwOnFailure !== false;
+    const results = [];
+    for (const check of checks) {
+        let checkResult;
+        try {
+            const outcome = await check.run(client);
+            checkResult = { name: check.name, passed: outcome.passed, message: outcome.message };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            checkResult = { name: check.name, passed: false, message };
+        }
+        results.push(checkResult);
+    }
+    const passed = results.filter((r) => r.passed).length;
+    const failed = results.filter((r) => !r.passed).length;
+    const result = { passed, failed, checks: results };
+    if (throwOnFailure && failed > 0) {
+        throw new PreflightError(result);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Built-in check factories
+// ---------------------------------------------------------------------------
+/**
+ * Factory for a custom preflight check with an arbitrary async predicate.
+ */
+function preflightCheck(name, fn) {
+    return { name, run: fn };
+}
+/**
+ * Assert that a softcode function is available on the server.
+ *
+ * Evals `funcname()` and checks that the response does not include "NOT FOUND".
+ * A "wrong number of arguments" error means the function exists.
+ */
+function assertFunctionExists(name) {
+    return {
+        name: `function exists: ${name}`,
+        async run(client) {
+            const result = await client.eval(`${name}()`);
+            const passed = !result.toUpperCase().includes('NOT FOUND');
+            return passed
+                ? { passed: true }
+                : { passed: false, message: `function '${name}' is not available on this server` };
+        },
+    };
+}
+/**
+ * Assert that a softcode function is NOT available on the server.
+ *
+ * Useful to confirm a restricted or removed function is absent.
+ */
+function assertFunctionMissing(name) {
+    return {
+        name: `function absent: ${name}`,
+        async run(client) {
+            const result = await client.eval(`${name}()`);
+            const passed = result.toUpperCase().includes('NOT FOUND');
+            return passed
+                ? { passed: true }
+                : { passed: false, message: `function '${name}' exists but was expected to be absent` };
+        },
+    };
+}
+/**
+ * Assert that a server config key equals an expected value.
+ *
+ * Evals `config(key)` and compares the trimmed result to `expected`.
+ */
+function assertConfigEquals(key, expected) {
+    return {
+        name: `config: ${key} = ${expected}`,
+        async run(client) {
+            const actual = (await client.eval(`config(${key})`)).trim();
+            const passed = actual === expected;
+            return passed
+                ? { passed: true }
+                : { passed: false, message: `config(${key}): expected '${expected}', got '${actual}'` };
+        },
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

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

package/dist/reporter.d.ts

@@ -1,4 +1,5 @@
 import { RunResult } from './runner';
+import { SnapshotStats } from './snapshots';
 export declare class Reporter {
     private readonly verbose;
     constructor(verbose: boolean);
@@ -7,5 +8,6 @@ export declare class Reporter {
     testFail(name: string, ms: number, depth: number, error: Error): void;
     testSkip(name: string, depth: number): void;
     summary(result: RunResult): void;
+    snapshotSummary(stats: SnapshotStats): void;
 }
 //# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAsBrC,qBAAa,QAAQ;IACL,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMvD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAWrE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3C,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CASnC"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuB5C,qBAAa,QAAQ;IACL,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMvD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAWrE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3C,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAWhC,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;CAoB9C"}

package/dist/reporter.js

@@ -11,6 +11,7 @@ function colorize(code, text) {
 const green = (s) => colorize('32', s);
 const red = (s) => colorize('31', s);
 const yellow = (s) => colorize('33', s);
+const cyan = (s) => colorize('36', s);
 const gray = (s) => colorize('90', s);
 const bold = (s) => colorize('1', s);
 // ---------------------------------------------------------------------------
@@ -60,7 +61,29 @@ class Reporter {
         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`);
+        process.stdout.write(`\nTests:     ${parts.join(', ')} ${gray(`(${result.duration}ms)`)}\n`);
+        this.snapshotSummary(result.snapshots);
+    }
+    snapshotSummary(stats) {
+        if (!this.verbose)
+            return;
+        const { matched, written, updated, obsolete } = stats;
+        const total = matched + written + updated;
+        if (total === 0 && obsolete === 0)
+            return;
+        const parts = [];
+        if (matched > 0)
+            parts.push(green(`${matched} passed`));
+        if (written > 0)
+            parts.push(cyan(`${written} written`));
+        if (updated > 0)
+            parts.push(yellow(`${updated} updated`));
+        if (obsolete > 0)
+            parts.push(gray(`${obsolete} obsolete`));
+        process.stdout.write(`Snapshots: ${parts.join(', ')}\n`);
+        if (obsolete > 0) {
+            process.stdout.write(gray(`           Run with RHOST_UPDATE_SNAPSHOTS=1 to remove obsolete snapshots.\n`));
+        }
     }
 }
 exports.Reporter = Reporter;

package/dist/reporter.js.map

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

package/dist/runner.d.ts

@@ -1,7 +1,8 @@
-import { RhostClient, RhostClientOptions } from './client';
+import { RhostClient, RhostClientOptions, PreviewOptions } from './client';
 import { RhostAssert } from './assertions';
 import { RhostExpect } from './expect';
 import { RhostWorld } from './world';
+import { SnapshotStats } from './snapshots';
 export interface RunResult {
     passed: number;
     failed: number;
@@ -13,19 +14,41 @@ export interface RunResult {
         test: string;
         error: Error;
     }>;
+    snapshots: SnapshotStats;
 }
 export interface TestContext {
     expect(expression: string): RhostExpect;
     client: RhostClient;
     world: RhostWorld;
+    /**
+     * Evaluate a softcode expression (default) or run a raw MUSH command and
+     * print the raw server output to stdout exactly as a player would see it —
+     * ANSI colours, formatting, all of it.
+     *
+     * Returns the raw string so you can still assert on it if needed.
+     *
+     * @example Softcode result with colour
+     *   await preview('ansi(rh,CRITICAL HIT!)');
+     *
+     * @example Room description as a player sees it
+     *   await preview('look here', { mode: 'command' });
+     *
+     * @example Score screen
+     *   await preview('score', { mode: 'command' });
+     */
+    preview(input: string, options?: PreviewOptions): Promise<string>;
 }
 export type TestFn = (ctx: TestContext) => Promise<void> | void;
 export type HookFn = (ctx: {
     client: RhostClient;
     world: RhostWorld;
 }) => Promise<void> | void;
+export type PersonaTestFn = (ctx: TestContext & {
+    persona: string;
+}) => Promise<void> | void;
 export type ItFn = (name: string, fn: TestFn, timeout?: number) => void;
 export type DescribeFn = (name: string, fn: (ctx: SuiteContext) => void) => void;
+export type PersonasFn = (names: string[], testName: string, fn: PersonaTestFn, timeout?: number) => void;
 export interface SuiteContext {
     it: ItFn & {
         skip: ItFn;
@@ -43,6 +66,28 @@ export interface SuiteContext {
     afterAll(fn: HookFn): void;
     beforeEach(fn: HookFn): void;
     afterEach(fn: HookFn): void;
+    /**
+     * Register one test per persona. Each test connects to the MUSH server
+     * using the credentials defined under `runner.run({ personas: {...} })`.
+     *
+     * @example
+     *   personas(
+     *     ['mortal', 'builder', 'wizard'],
+     *     'hidden room visibility',
+     *     async ({ expect, persona }) => {
+     *       if (persona === 'mortal') {
+     *         await expect('can_see_hidden()').toBe('0');
+     *       } else {
+     *         await expect('can_see_hidden()').toBe('1');
+     *       }
+     *     },
+     *   );
+     */
+    personas: PersonasFn;
+}
+export interface PersonaCredentials {
+    username: string;
+    password: string;
 }
 export interface RunnerOptions extends RhostClientOptions {
     /** Character name. Required. */
@@ -51,12 +96,39 @@ export interface RunnerOptions extends RhostClientOptions {
     password: string;
     /** Print results to stdout while running. Default: true */
     verbose?: boolean;
+    /**
+     * Credentials for named personas used by `personas()` tests.
+     *
+     * @example
+     *   runner.run({
+     *     username: 'Wizard',
+     *     password: 'Nyctasia',
+     *     personas: {
+     *       mortal:  { username: 'TestMortal',  password: 'mortalpass' },
+     *       builder: { username: 'TestBuilder', password: 'builderpass' },
+     *     },
+     *   });
+     */
+    personas?: Record<string, PersonaCredentials>;
+    /**
+     * Absolute or relative path to the snapshot file.
+     * Default: `__snapshots__/<calling-file>.snap` next to the test file,
+     * or `__snapshots__/testkit.snap` in cwd if the caller cannot be determined.
+     */
+    snapshotFile?: string;
+    /**
+     * Overwrite stored snapshots with current values instead of comparing.
+     * Also activated by the `RHOST_UPDATE_SNAPSHOTS=1` environment variable.
+     * Default: false
+     */
+    updateSnapshots?: 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.
+ * per-test timeouts, lifecycle hooks, automatic world cleanup, and snapshot
+ * testing via `expect().toMatchSnapshot()`.
  *
  * @example
  *   const runner = new RhostRunner();
@@ -72,6 +144,8 @@ export interface RunnerOptions extends RhostClientOptions {
  */
 export declare class RhostRunner {
     private topLevel;
+    /** Set at the start of run() so persona test closures can access credentials. */
+    private _options;
     describe(name: string, fn: (ctx: SuiteContext) => void): this;
     run(options: RunnerOptions): Promise<RunResult>;
     private _buildSuite;
@@ -85,6 +159,13 @@ export declare class RhostRunner {
     private _countFailedFromBeforeAll;
     private _countSkipped;
     private _withTimeout;
+    private resolveSnapshotFile;
+    /**
+     * Walk the Error.stack to find the first file that is not the runner
+     * itself and not inside node_modules. Used to auto-derive the snapshot
+     * file path from the test file's location.
+     */
+    private getCallerFile;
 }
 export { RhostAssert };
 //# sourceMappingURL=runner.d.ts.map