@scenetest/scenes 0.2.0 → 0.4.0

package/dist/__tests__/runner.test.js

@@ -0,0 +1,182 @@
+import { describe, it, expect, vi } from 'vitest';
+import { runCleanup, runSetup } from '../runner.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeScene(overrides = {}) {
+    return {
+        name: 'test scene',
+        file: '/test/scene.spec.md',
+        fn: async () => { },
+        cleanup: [],
+        setup: [],
+        ...overrides,
+    };
+}
+const team = {
+    learner: { key: 'learner-123', username: 'alice', email: 'alice@test.com' },
+    friend: { key: 'friend-456', username: 'bob', email: 'bob@test.com' },
+};
+const teamMeta = {
+    name: 'Kannada Team',
+    tags: { lang: 'kan', region: 'asia' },
+};
+const testStart = '2026-04-02T10:00:00.000Z';
+// ---------------------------------------------------------------------------
+// runCleanup
+// ---------------------------------------------------------------------------
+describe('runCleanup', () => {
+    it('does nothing when cleanup is empty', async () => {
+        const scene = makeScene();
+        const server = { supabase: { ran: false } };
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(server.supabase.ran).toBe(false);
+    });
+    it('evaluates a single cleanup expression with server in scope', async () => {
+        const calls = [];
+        const server = {
+            db: {
+                delete: (table) => { calls.push(`delete:${table}`); return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({ cleanup: ["db.delete('user_deck')"] });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(calls).toEqual(["delete:user_deck"]);
+    });
+    it('runs all expressions when multiple cleanup: lines specified', async () => {
+        const calls = [];
+        const server = {
+            db: {
+                delete: (table) => { calls.push(`delete:${table}`); return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({
+            cleanup: ["db.delete('comments')", "db.delete('notifications')"],
+        });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(calls).toEqual(['delete:comments', 'delete:notifications']);
+    });
+    it('interpolates [role.field] tokens', async () => {
+        let capturedKey = '';
+        const server = {
+            db: {
+                deleteByKey: (key) => { capturedKey = key; return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({ cleanup: ["db.deleteByKey('[learner.key]')"] });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(capturedKey).toBe('learner-123');
+    });
+    it('interpolates [team.field] tokens from team metadata tags', async () => {
+        let capturedLang = '';
+        const server = {
+            db: {
+                deleteByLang: (lang) => { capturedLang = lang; return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({ cleanup: ["db.deleteByLang('[team.lang]')"] });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(capturedLang).toBe('kan');
+    });
+    it('interpolates [testStart] with the ISO timestamp', async () => {
+        let capturedTs = '';
+        const server = {
+            db: {
+                deleteAfter: (ts) => { capturedTs = ts; return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({ cleanup: ["db.deleteAfter('[testStart]')"] });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(capturedTs).toBe(testStart);
+    });
+    it('logs a warning and skips when no server config', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const scene = makeScene({ cleanup: ["db.delete('x')"] });
+        await runCleanup(scene, team, teamMeta, undefined, testStart);
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('no server config'));
+        warnSpy.mockRestore();
+    });
+    it('logs a warning but does not throw when expression errors', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const server = {
+            db: {
+                badCall: () => { throw new Error('db connection refused'); },
+            },
+        };
+        const scene = makeScene({ cleanup: ['db.badCall()'] });
+        await expect(runCleanup(scene, team, teamMeta, server, testStart)).resolves.toBeUndefined();
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('db connection refused'));
+        warnSpy.mockRestore();
+    });
+    it('throws interpolation error and logs warning for unknown role', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const server = { db: {} };
+        const scene = makeScene({ cleanup: ["db.fn('[ghost.key]')"] });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('ghost'));
+        warnSpy.mockRestore();
+    });
+    it('throws interpolation error and logs warning for unknown team tag', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const server = { db: {} };
+        const scene = makeScene({ cleanup: ["db.fn('[team.notexist]')"] });
+        await runCleanup(scene, team, teamMeta, server, testStart);
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('notexist'));
+        warnSpy.mockRestore();
+    });
+});
+// ---------------------------------------------------------------------------
+// runSetup
+// ---------------------------------------------------------------------------
+describe('runSetup', () => {
+    it('does nothing when setup is empty', async () => {
+        const calls = [];
+        const server = { db: { update: (t) => { calls.push(t); return Promise.resolve(); } } };
+        const scene = makeScene();
+        await runSetup(scene, team, teamMeta, server, testStart);
+        expect(calls).toHaveLength(0);
+    });
+    it('evaluates each setup expression in order', async () => {
+        const calls = [];
+        const server = {
+            db: {
+                update: (t) => { calls.push(`update:${t}`); return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({
+            setup: ["db.update('step1')", "db.update('step2')"],
+        });
+        await runSetup(scene, team, teamMeta, server, testStart);
+        expect(calls).toEqual(['update:step1', 'update:step2']);
+    });
+    it('interpolates [role.field] and [team.field] in setup expressions', async () => {
+        const captured = [];
+        const server = {
+            db: {
+                seed: (key, lang) => {
+                    captured.push(`${key}:${lang}`);
+                    return Promise.resolve();
+                },
+            },
+        };
+        const scene = makeScene({ setup: ["db.seed('[learner.key]', '[team.lang]')"] });
+        await runSetup(scene, team, teamMeta, server, testStart);
+        expect(captured).toEqual(['learner-123:kan']);
+    });
+    it('logs a warning but does not throw on error, continues remaining expressions', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const calls = [];
+        const server = {
+            db: {
+                bad: () => { throw new Error('setup failed'); },
+                ok: () => { calls.push('ok'); return Promise.resolve(); },
+            },
+        };
+        const scene = makeScene({ setup: ['db.bad()', 'db.ok()'] });
+        await runSetup(scene, team, teamMeta, server, testStart);
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('setup failed'));
+        expect(calls).toEqual(['ok']);
+        warnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=runner.test.js.map

package/dist/__tests__/runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.js","sourceRoot":"","sources":["../../src/__tests__/runner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAGnD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,SAAS,CAAC,YAAsC,EAAE;IACzD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,qBAAqB;QAC3B,EAAE,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAClB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE;IAC3E,MAAM,EAAG,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAI,KAAK,EAAE,cAAc,EAAE;CACzE,CAAA;AAED,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;CACtC,CAAA;AAED,MAAM,SAAS,GAAG,0BAA0B,CAAA;AAE5C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;QACzB,MAAM,MAAM,GAAG,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAA;QAC3C,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aACvF;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAA;QAChE,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aACvF;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,CAAC,uBAAuB,EAAE,4BAA4B,CAAC;SACjE,CAAC,CAAA;QACF,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,IAAI,WAAW,GAAG,EAAE,CAAA;QACpB,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aAC9E;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAA;QACzE,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,IAAI,YAAY,GAAG,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,GAAG,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aAClF;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAA;QACxE,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,IAAI,UAAU,GAAG,EAAE,CAAA;QACnB,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,WAAW,EAAE,CAAC,EAAU,EAAE,EAAE,GAAG,UAAU,GAAG,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aAC3E;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,+BAA+B,CAAC,EAAE,CAAC,CAAA;QACvE,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAA;QACxD,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;QAC7D,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAA;QACjF,OAAO,CAAC,WAAW,EAAE,CAAA;IACvB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA,CAAC,CAAC;aAC5D;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;QACtD,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;QAC3F,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC,CAAA;QACtF,OAAO,CAAC,WAAW,EAAE,CAAA;IACvB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAA;QAC9D,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;QACtE,OAAO,CAAC,WAAW,EAAE,CAAA;IACvB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAA;QAClE,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAA;QACzE,OAAO,CAAC,WAAW,EAAE,CAAA;IACvB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC,EAAE,EAAE,CAAA;QAC7F,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;QACzB,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aAC/E;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,KAAK,EAAE,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SACpD,CAAC,CAAA;QACF,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,IAAI,EAAE,CAAC,GAAW,EAAE,IAAY,EAAE,EAAE;oBAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAA;oBAC/B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;gBAC1B,CAAC;aACF;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,yCAAyC,CAAC,EAAE,CAAC,CAAA;QAC/E,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACtE,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG;YACb,EAAE,EAAE;gBACF,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA,CAAC,CAAC;gBAC9C,EAAE,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;aACzD;SACF,CAAA;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,CAAA;QAC3D,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QACxD,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAA;QAC7E,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC7B,OAAO,CAAC,WAAW,EAAE,CAAA;IACvB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/actor.d.ts

@@ -1,5 +1,6 @@
 import type { Page, BrowserContext } from 'playwright';
-import type { ActorConfig, SequentialActorHandle, ActionChain, AssertionResult, TimelineEntry, ScriptWarning, Selector } from './types.js';
+import type { ActorConfig, SequentialActorHandle, ActionChain, AssertionResult, TimelineEntry, ScriptWarning, Selector, PageFactory } from './types.js';
+import type { NavigationMode } from './keyboard.js';
 import { MessageBus } from './message-bus.js';
 /**
  * Registered watcher for conditional handling
@@ -29,17 +30,28 @@ export declare class SequentialActorHandleImpl implements SequentialActorHandle
     private actionTimeout;
     private warnAfter;
     readonly role: string;
-    readonly page: Page;
-    readonly context: BrowserContext;
+    private _page;
+    private _context;
     readonly assertions: AssertionResult[];
+    readonly navigationMode: NavigationMode;
+    readonly fuzzyFingers: boolean;
     private watchers;
     private warningTriggers;
+    private _pageFactory;
     readonly key: string;
     readonly username?: string;
     readonly email?: string;
     readonly password?: string;
     [key: string]: unknown;
-    constructor(role: string, config: ActorConfig, page: Page, context: BrowserContext, bus: MessageBus, timeline: TimelineEntry[], warnings: ScriptWarning[], actionTimeout: number, warnAfter: number);
+    constructor(role: string, config: ActorConfig, page: Page, context: BrowserContext, bus: MessageBus, timeline: TimelineEntry[], warnings: ScriptWarning[], actionTimeout: number, warnAfter: number, navigationMode?: NavigationMode, fuzzyFingers?: boolean, pageFactory?: PageFactory | null);
+    /** Playwright page for this actor */
+    get page(): Page;
+    /** Playwright browser context for this actor */
+    get context(): BrowserContext;
+    /** Get the page factory (used by ActionChainImpl for switchDevice) */
+    getPageFactory(): PageFactory | null;
+    /** Update page and context after a device switch */
+    _switchPage(page: Page, context: BrowserContext): void;
     /**
      * Get registered watchers (used by ActionChainImpl)
      */
@@ -55,6 +67,10 @@ export declare class SequentialActorHandleImpl implements SequentialActorHandle
     clearWatchers(): void;
     private createChain;
     openTo(url: string): ActionChain;
+    reload(): ActionChain;
+    goBack(): ActionChain;
+    goForward(): ActionChain;
+    switchDevice(device?: string): ActionChain;
     see(selector: Selector): ActionChain;
     seeInView(selector: Selector): ActionChain;
     notSee(selector: Selector): ActionChain;
@@ -67,6 +83,7 @@ export declare class SequentialActorHandleImpl implements SequentialActorHandle
     wait(ms: number): ActionChain;
     emit(message: string): ActionChain;
     waitFor(message: string): ActionChain;
+    pressKey(key: string): ActionChain;
     do(fn: (page: Page) => Promise<void>): ActionChain;
     scrollToBottom(): ActionChain;
     up(selector?: Selector): ActionChain;

package/dist/actor.d.ts.map

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

package/dist/actor.js

@@ -1,5 +1,7 @@
+import { tabToElement, pressEnter, pressSpace, clearAndType, keyboardSelectOption, fuzzyFingerClick, fuzzyFingerFill, fuzzyFingerCheck } from './keyboard.js';
 import { resolveSelector } from './selectors.js';
 import { parseDslLines, parseAction, applyDslAction } from './dsl.js';
+import { findDevice } from './devices.js';
 /**
  * Format a Selector for display in logs/errors
  */
@@ -19,6 +21,8 @@ class ActionChainImpl {
     warnings;
     actionTimeout;
     warnAfter;
+    navigationMode;
+    fuzzyFingers;
     actions = [];
     // Current scope - starts as page, changes with see()
     currentScope;
@@ -28,7 +32,7 @@ class ActionChainImpl {
     scopeSetUrl = '';
     // Per-entry URLs matching scopeStack (kept in sync)
     scopeStackUrls = [];
-    constructor(actor, page, bus, timeline, warnings, actionTimeout, warnAfter) {
+    constructor(actor, page, bus, timeline, warnings, actionTimeout, warnAfter, navigationMode = 'pointer', fuzzyFingers = false) {
         this.actor = actor;
         this.page = page;
         this.bus = bus;
@@ -36,8 +40,23 @@ class ActionChainImpl {
         this.warnings = warnings;
         this.actionTimeout = actionTimeout;
         this.warnAfter = warnAfter;
+        this.navigationMode = navigationMode;
+        this.fuzzyFingers = fuzzyFingers;
         this.currentScope = page;
     }
+    /**
+     * Whether this chain uses keyboard navigation.
+     */
+    get isKeyboard() {
+        return this.navigationMode === 'keyboard';
+    }
+    /**
+     * Whether fuzzy-finger touch behavior is enabled for pointer mode.
+     * Fuzzy-finger simulates imprecise human touch: miss → pause → correct click.
+     */
+    get useFuzzyFingers() {
+        return this.navigationMode === 'pointer' && this.fuzzyFingers;
+    }
     addAction(name, target, execute) {
         this.actions.push({ name, target, execute });
         return this;
@@ -120,6 +139,53 @@ class ActionChainImpl {
             this.scopeStackUrls = [];
         });
     }
+    reload() {
+        return this.addAction('reload', undefined, async () => {
+            await this.page.reload({ timeout: this.actionTimeout });
+            this.currentScope = this.page;
+            this.scopeStack = [];
+            this.scopeSetUrl = '';
+            this.scopeStackUrls = [];
+        });
+    }
+    goBack() {
+        return this.addAction('goBack', undefined, async () => {
+            await this.page.goBack({ timeout: this.actionTimeout });
+            this.currentScope = this.page;
+            this.scopeStack = [];
+            this.scopeSetUrl = '';
+            this.scopeStackUrls = [];
+        });
+    }
+    goForward() {
+        return this.addAction('goForward', undefined, async () => {
+            await this.page.goForward({ timeout: this.actionTimeout });
+            this.currentScope = this.page;
+            this.scopeStack = [];
+            this.scopeSetUrl = '';
+            this.scopeStackUrls = [];
+        });
+    }
+    switchDevice(device) {
+        return this.addAction('switchDevice', device ?? '(next)', async () => {
+            const factory = this.actor.getPageFactory();
+            if (!factory) {
+                throw new Error('switchDevice requires the scene runner (page factory not available)');
+            }
+            const profile = device ? findDevice(device) : null;
+            // Factory closes old context, creates new one with assertion wiring
+            const { page, context } = await factory(profile);
+            // Update actor's backing references
+            this.actor._switchPage(page, context);
+            // Update chain's local page reference
+            this.page = page;
+            // Reset scope to new page root
+            this.currentScope = this.page;
+            this.scopeStack = [];
+            this.scopeSetUrl = '';
+            this.scopeStackUrls = [];
+        });
+    }
     see(selector) {
         const target = formatSelector(selector);
         return this.addAction('see', target, async () => {
@@ -177,31 +243,85 @@ class ActionChainImpl {
                 if (scope === this.page) {
                     throw new Error('click with no selector requires a scope (use see() first)');
                 }
-                await scope.click({ timeout: this.actionTimeout });
+                if (this.isKeyboard) {
+                    await tabToElement(this.page, scope, { timeout: this.actionTimeout });
+                    await pressEnter(this.page);
+                }
+                else if (this.useFuzzyFingers) {
+                    await fuzzyFingerClick(this.page, scope, this.actionTimeout, '(scope)');
+                }
+                else {
+                    await scope.click({ timeout: this.actionTimeout });
+                }
             });
         }
         const target = formatSelector(selector);
         return this.addAction('click', target, async () => {
-            await resolveSelector(this.getScope(), selector).click({ timeout: this.actionTimeout });
+            const locator = resolveSelector(this.getScope(), selector);
+            if (this.isKeyboard) {
+                await locator.waitFor({ state: 'visible', timeout: this.actionTimeout });
+                await tabToElement(this.page, locator, { timeout: this.actionTimeout });
+                await pressEnter(this.page);
+            }
+            else if (this.useFuzzyFingers) {
+                await fuzzyFingerClick(this.page, locator, this.actionTimeout, selector);
+            }
+            else {
+                await locator.click({ timeout: this.actionTimeout });
+            }
         });
     }
     typeInto(selector, value) {
         const target = `${formatSelector(selector)}=${value}`;
         return this.addAction('typeInto', target, async () => {
-            await resolveSelector(this.getScope(), selector).fill(value, { timeout: this.actionTimeout });
+            const locator = resolveSelector(this.getScope(), selector);
+            if (this.isKeyboard) {
+                await locator.waitFor({ state: 'visible', timeout: this.actionTimeout });
+                await tabToElement(this.page, locator, { timeout: this.actionTimeout });
+                await clearAndType(this.page, value);
+            }
+            else if (this.useFuzzyFingers) {
+                await fuzzyFingerFill(this.page, locator, value, this.actionTimeout, selector);
+            }
+            else {
+                await locator.fill(value, { timeout: this.actionTimeout });
+            }
             // typeInto stays in current scope
         });
     }
     check(selector) {
         const target = formatSelector(selector);
         return this.addAction('check', target, async () => {
-            await resolveSelector(this.getScope(), selector).check({ timeout: this.actionTimeout });
+            const locator = resolveSelector(this.getScope(), selector);
+            if (this.isKeyboard) {
+                await locator.waitFor({ state: 'visible', timeout: this.actionTimeout });
+                await tabToElement(this.page, locator, { timeout: this.actionTimeout });
+                await pressSpace(this.page);
+            }
+            else if (this.useFuzzyFingers) {
+                await fuzzyFingerCheck(this.page, locator, this.actionTimeout, selector);
+            }
+            else {
+                await locator.check({ timeout: this.actionTimeout });
+            }
         });
     }
     select(selector, value) {
         const target = `${formatSelector(selector)}=${value}`;
         return this.addAction('select', target, async () => {
-            await resolveSelector(this.getScope(), selector).selectOption(value, { timeout: this.actionTimeout });
+            const locator = resolveSelector(this.getScope(), selector);
+            if (this.isKeyboard) {
+                await locator.waitFor({ state: 'visible', timeout: this.actionTimeout });
+                await tabToElement(this.page, locator, { timeout: this.actionTimeout });
+                await keyboardSelectOption(this.page, locator, value);
+            }
+            else if (this.useFuzzyFingers) {
+                await fuzzyFingerClick(this.page, locator, this.actionTimeout, selector);
+                await locator.selectOption(value, { timeout: this.actionTimeout });
+            }
+            else {
+                await locator.selectOption(value, { timeout: this.actionTimeout });
+            }
         });
     }
     wait(ms) {
@@ -219,6 +339,11 @@ class ActionChainImpl {
             await this.bus.waitFor(message);
         });
     }
+    pressKey(key) {
+        return this.addAction('pressKey', key, async () => {
+            await this.page.keyboard.press(key);
+        });
+    }
     do(fn) {
         return this.addAction('do', 'custom', async () => {
             await fn(this.page);
@@ -442,19 +567,23 @@ export class SequentialActorHandleImpl {
     actionTimeout;
     warnAfter;
     role;
-    page;
-    context;
+    _page;
+    _context;
     assertions = [];
+    navigationMode;
+    fuzzyFingers;
     // Registered watchers for conditional handling
     watchers = [];
     // Registered warning triggers
     warningTriggers = [];
+    // Page factory for switchDevice support
+    _pageFactory;
     // Forward config properties
     key;
     username;
     email;
     password;
-    constructor(role, config, page, context, bus, timeline, warnings, actionTimeout, warnAfter) {
+    constructor(role, config, page, context, bus, timeline, warnings, actionTimeout, warnAfter, navigationMode = 'pointer', fuzzyFingers = false, pageFactory) {
         this.config = config;
         this.bus = bus;
         this.timeline = timeline;
@@ -462,9 +591,12 @@ export class SequentialActorHandleImpl {
         this.actionTimeout = actionTimeout;
         this.warnAfter = warnAfter;
         this.role = role;
-        this.page = page;
-        this.context = context;
+        this._page = page;
+        this._context = context;
+        this._pageFactory = pageFactory ?? null;
         this.key = config.key;
+        this.navigationMode = navigationMode;
+        this.fuzzyFingers = fuzzyFingers;
         // Copy all config properties to this instance
         for (const [k, value] of Object.entries(config)) {
             if (!(k in this)) {
@@ -475,6 +607,23 @@ export class SequentialActorHandleImpl {
             }
         }
     }
+    /** Playwright page for this actor */
+    get page() {
+        return this._page;
+    }
+    /** Playwright browser context for this actor */
+    get context() {
+        return this._context;
+    }
+    /** Get the page factory (used by ActionChainImpl for switchDevice) */
+    getPageFactory() {
+        return this._pageFactory;
+    }
+    /** Update page and context after a device switch */
+    _switchPage(page, context) {
+        this._page = page;
+        this._context = context;
+    }
     /**
      * Get registered watchers (used by ActionChainImpl)
      */
@@ -495,11 +644,23 @@ export class SequentialActorHandleImpl {
         this.watchers = [];
     }
     createChain() {
-        return new ActionChainImpl(this, this.page, this.bus, this.timeline, this.warnings, this.actionTimeout, this.warnAfter);
+        return new ActionChainImpl(this, this.page, this.bus, this.timeline, this.warnings, this.actionTimeout, this.warnAfter, this.navigationMode, this.fuzzyFingers);
     }
     openTo(url) {
         return this.createChain().openTo(url);
     }
+    reload() {
+        return this.createChain().reload();
+    }
+    goBack() {
+        return this.createChain().goBack();
+    }
+    goForward() {
+        return this.createChain().goForward();
+    }
+    switchDevice(device) {
+        return this.createChain().switchDevice(device);
+    }
     see(selector) {
         return this.createChain().see(selector);
     }
@@ -536,6 +697,9 @@ export class SequentialActorHandleImpl {
     waitFor(message) {
         return this.createChain().waitFor(message);
     }
+    pressKey(key) {
+        return this.createChain().pressKey(key);
+    }
     do(fn) {
         return this.createChain().do(fn);
     }