@forestrie/mandate-ui-e2e-kit 0.2.0 → 0.2.1

package/dist/burner.d.ts

@@ -0,0 +1,20 @@
+import type { Page } from '@playwright/test';
+/**
+ * Deploy-time / system-test burner-key seeding (plan-2607-01 D2, FOR-322).
+ * Mirrors how a system-test deployment pre-populates `localStorage` with a
+ * key minted out of band, so the operator/user starts already in control of
+ * `K(L)` and the exit gradient can run non-interactively.
+ */
+/** Must match `BURNER_KEY_STORAGE_KEY` in `@mandate/ui` local-burner-key.ts. */
+export declare const BURNER_KEY_STORAGE_KEY = "mandate.burner.privateKey";
+/** Fixed secp256k1 test key (scalar = 1); never used for anything real. */
+export declare const E2E_BURNER_PRIVATE_KEY = "0x0000000000000000000000000000000000000000000000000000000000000001";
+/** Address derived from `E2E_BURNER_PRIVATE_KEY` (well-known scalar-1 EOA). */
+export declare const E2E_BURNER_ADDRESS = "0x7e5f4552091a69125d5dfcb7b8c2659029395bdf";
+/**
+ * Seed the burner key into `localStorage` before any page script runs, so the
+ * delegation console loads already holding the key (no "Create burner" click).
+ * Registers an init script for every subsequent navigation on this page.
+ */
+export declare function seedBurnerKey(page: Page, privateKeyHex?: string): Promise<void>;
+//# sourceMappingURL=burner.d.ts.map

package/dist/burner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burner.d.ts","sourceRoot":"","sources":["../src/burner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,uEACkC,CAAC;AAEtE,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAE/E;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,IAAI,EACV,aAAa,GAAE,MAA+B,GAC5C,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/burner.js

@@ -0,0 +1,22 @@
+/**
+ * Deploy-time / system-test burner-key seeding (plan-2607-01 D2, FOR-322).
+ * Mirrors how a system-test deployment pre-populates `localStorage` with a
+ * key minted out of band, so the operator/user starts already in control of
+ * `K(L)` and the exit gradient can run non-interactively.
+ */
+/** Must match `BURNER_KEY_STORAGE_KEY` in `@mandate/ui` local-burner-key.ts. */
+export const BURNER_KEY_STORAGE_KEY = 'mandate.burner.privateKey';
+/** Fixed secp256k1 test key (scalar = 1); never used for anything real. */
+export const E2E_BURNER_PRIVATE_KEY = '0x0000000000000000000000000000000000000000000000000000000000000001';
+/** Address derived from `E2E_BURNER_PRIVATE_KEY` (well-known scalar-1 EOA). */
+export const E2E_BURNER_ADDRESS = '0x7e5f4552091a69125d5dfcb7b8c2659029395bdf';
+/**
+ * Seed the burner key into `localStorage` before any page script runs, so the
+ * delegation console loads already holding the key (no "Create burner" click).
+ * Registers an init script for every subsequent navigation on this page.
+ */
+export async function seedBurnerKey(page, privateKeyHex = E2E_BURNER_PRIVATE_KEY) {
+    await page.addInitScript(([storageKey, key]) => {
+        window.localStorage.setItem(storageKey, key);
+    }, [BURNER_KEY_STORAGE_KEY, privateKeyHex]);
+}

package/dist/console-fixture.d.ts

@@ -0,0 +1,8 @@
+import { type CoordinatorMockOptions } from './coordinator-bff.js';
+type ConsoleFixtures = {
+    consolePage: import('@playwright/test').Page;
+    mocks: CoordinatorMockOptions;
+};
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & ConsoleFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect } from '@playwright/test';
+//# sourceMappingURL=console-fixture.d.ts.map

package/dist/console-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-fixture.d.ts","sourceRoot":"","sources":["../src/console-fixture.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG5F,KAAK,eAAe,GAAG;IACtB,WAAW,EAAE,OAAO,kBAAkB,EAAE,IAAI,CAAC;IAC7C,KAAK,EAAE,sBAAsB,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,IAAI,+PAOf,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/console-fixture.js

@@ -0,0 +1,12 @@
+import { test as base } from '@playwright/test';
+import { installCoordinatorMocks } from './coordinator-bff.js';
+import { E2E_AUTH_LOG_ID } from './fixtures.js';
+export const test = base.extend({
+    mocks: [{}, { option: true }],
+    consolePage: async ({ page, mocks }, use) => {
+        await installCoordinatorMocks(page, mocks);
+        await page.goto(`/delegations?authLogId=${encodeURIComponent(E2E_AUTH_LOG_ID)}`);
+        await use(page);
+    }
+});
+export { expect } from '@playwright/test';

package/dist/coordinator-bff.d.ts

@@ -0,0 +1,12 @@
+import type { Page } from '@playwright/test';
+import type { EnabledResponse, PendingEntry, ProblemDetails } from '@mandate/coordinator-types';
+export interface CoordinatorMockOptions {
+    pendingEntries?: PendingEntry[];
+    pendingError?: ProblemDetails;
+    certificateSubmitError?: ProblemDetails;
+    onCertificateSubmit?: (body: unknown) => void;
+    enabledByLogId?: Record<string, EnabledResponse>;
+}
+/** Install browser-level mocks for mandate BFF and control-plane auth routes. */
+export declare function installCoordinatorMocks(page: Page, options?: CoordinatorMockOptions): Promise<void>;
+//# sourceMappingURL=coordinator-bff.d.ts.map

package/dist/coordinator-bff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-bff.d.ts","sourceRoot":"","sources":["../src/coordinator-bff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAIX,eAAe,EACf,YAAY,EAEZ,cAAc,EAEd,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACtC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,sBAAsB,CAAC,EAAE,cAAc,CAAC;IACxC,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACjD;AAiBD,iFAAiF;AACjF,wBAAsB,uBAAuB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,sBAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CA2If"}

package/dist/coordinator-bff.js

@@ -0,0 +1,143 @@
+function defaultEnabled(enabled = true) {
+    return {
+        enabled,
+        userEnabled: enabled,
+        operatorEnabled: enabled
+    };
+}
+function problemJson(problem) {
+    return {
+        status: problem.status,
+        body: JSON.stringify(problem)
+    };
+}
+/** Install browser-level mocks for mandate BFF and control-plane auth routes. */
+export async function installCoordinatorMocks(page, options = {}) {
+    const enabledState = new Map(Object.entries(options.enabledByLogId ?? {}));
+    let certificateSubmitCount = 0;
+    await page.route('**/api/auth/challenge', async (route) => {
+        if (route.request().method() !== 'POST') {
+            await route.fallback();
+            return;
+        }
+        const body = route.request().postDataJSON();
+        const now = Math.floor(Date.now() / 1000);
+        const response = {
+            version: 'wcc-1',
+            nonce: 'e2e-nonce',
+            authLogId: body.authLogId,
+            scopes: body.scopes,
+            issuedAt: now,
+            expiresAt: now + 3600,
+            domain: '127.0.0.1',
+            coordinatorOrigin: 'http://127.0.0.1:4173'
+        };
+        await route.fulfill({
+            status: 200,
+            contentType: 'application/json',
+            body: JSON.stringify(response)
+        });
+    });
+    await page.route('**/api/auth/session', async (route) => {
+        if (route.request().method() !== 'POST') {
+            await route.fallback();
+            return;
+        }
+        const body = route.request().postDataJSON();
+        const now = Math.floor(Date.now() / 1000);
+        const response = {
+            token: 'e2e-session-token',
+            expiresAt: now + 3600,
+            authLogId: body.envelope.authLogId,
+            scopes: body.envelope.scopes
+        };
+        await route.fulfill({
+            status: 200,
+            contentType: 'application/json',
+            body: JSON.stringify(response)
+        });
+    });
+    await page.route('**/api/coordinator/**', async (route) => {
+        const request = route.request();
+        const url = new URL(request.url());
+        const path = url.pathname.replace(/^.*\/api\/coordinator\//, '');
+        const method = request.method();
+        if (method === 'GET' && path.startsWith('delegations/pending')) {
+            if (options.pendingError) {
+                const { status, body } = problemJson(options.pendingError);
+                await route.fulfill({ status, contentType: 'application/problem+json', body });
+                return;
+            }
+            const entries = options.pendingEntries ?? [];
+            const response = {
+                entries,
+                offset: 0,
+                limit: 50,
+                shardCount: 1
+            };
+            await route.fulfill({
+                status: 200,
+                contentType: 'application/json',
+                body: JSON.stringify(response)
+            });
+            return;
+        }
+        if (method === 'POST' && path === 'delegations/certificate') {
+            if (options.certificateSubmitError) {
+                const { status, body } = problemJson(options.certificateSubmitError);
+                await route.fulfill({ status, contentType: 'application/problem+json', body });
+                return;
+            }
+            certificateSubmitCount += 1;
+            options.onCertificateSubmit?.(request.postDataJSON());
+            const response = {
+                ok: true,
+                certificateKey: `e2e-cert-${certificateSubmitCount}`
+            };
+            await route.fulfill({
+                status: 200,
+                contentType: 'application/json',
+                body: JSON.stringify(response)
+            });
+            return;
+        }
+        const enabledMatch = path.match(/^logs\/([^/]+)\/enabled$/);
+        if (enabledMatch) {
+            const logId = enabledMatch[1];
+            if (method === 'GET') {
+                const response = enabledState.get(logId) ?? defaultEnabled(true);
+                await route.fulfill({
+                    status: 200,
+                    contentType: 'application/json',
+                    body: JSON.stringify(response)
+                });
+                return;
+            }
+            if (method === 'PUT') {
+                const body = request.postDataJSON();
+                const response = {
+                    enabled: body.enabled,
+                    userEnabled: body.enabled,
+                    operatorEnabled: body.enabled
+                };
+                enabledState.set(logId, response);
+                await route.fulfill({
+                    status: 200,
+                    contentType: 'application/json',
+                    body: JSON.stringify(response)
+                });
+                return;
+            }
+        }
+        await route.fulfill({
+            status: 404,
+            contentType: 'application/problem+json',
+            body: JSON.stringify({
+                type: 'about:blank',
+                title: 'Not Found',
+                status: 404,
+                detail: `Unmocked coordinator path: ${method} ${path}`
+            })
+        });
+    });
+}

package/dist/e2e-wallet.d.ts

@@ -0,0 +1,3 @@
+/** Must match `E2E_MOCK_WALLET_ADDRESS` in `@mandate/ui` mock-client (FOR-220). */
+export declare const E2E_MOCK_WALLET_ADDRESS: "0xE2E0000000000000000000000000000000000001";
+//# sourceMappingURL=e2e-wallet.d.ts.map

package/dist/e2e-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-wallet.d.ts","sourceRoot":"","sources":["../src/e2e-wallet.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,EAAG,4CAAqD,CAAC"}

package/dist/e2e-wallet.js

@@ -0,0 +1,2 @@
+/** Must match `E2E_MOCK_WALLET_ADDRESS` in `@mandate/ui` mock-client (FOR-220). */
+export const E2E_MOCK_WALLET_ADDRESS = '0xE2E0000000000000000000000000000000000001';

package/dist/fixtures.d.ts

@@ -0,0 +1,10 @@
+import type { PendingEntry } from '@mandate/coordinator-types';
+/** Authority log id used across hermetic ui specs. */
+export declare const E2E_AUTH_LOG_ID = "11111111-1111-1111-1111-111111111111";
+/** User log id for kill-switch specs. */
+export declare const E2E_USER_LOG_ID = "b2c3d4e5f67890ab1234567890abcdef12";
+/** Pre-generated P-256 COSE delegated public key (base64). */
+export declare const SAMPLE_DELEGATED_PUBLIC_KEY_B64 = "pAECIAEh2EBYIAhdWHosXL4fALSX75DOf7YF5g862MUyZhGN4Bc4/MJxIthAWCCAtLh7eiOZqeqCchGbn8+uH6jjVty+tgnNSKJFv/16Cg==";
+export declare function samplePendingEntry(overrides?: Partial<PendingEntry>): PendingEntry;
+export declare function samplePendingEntries(count?: number): PendingEntry[];
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,sDAAsD;AACtD,eAAO,MAAM,eAAe,yCAAyC,CAAC;AAEtE,yCAAyC;AACzC,eAAO,MAAM,eAAe,uCAAuC,CAAC;AAEpE,8DAA8D;AAC9D,eAAO,MAAM,+BAA+B,iHACmE,CAAC;AAEhH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAYtF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,SAAI,GAAG,YAAY,EAAE,CAQ9D"}

package/dist/fixtures.js

@@ -0,0 +1,28 @@
+/** Authority log id used across hermetic ui specs. */
+export const E2E_AUTH_LOG_ID = '11111111-1111-1111-1111-111111111111';
+/** User log id for kill-switch specs. */
+export const E2E_USER_LOG_ID = 'b2c3d4e5f67890ab1234567890abcdef12';
+/** Pre-generated P-256 COSE delegated public key (base64). */
+export const SAMPLE_DELEGATED_PUBLIC_KEY_B64 = 'pAECIAEh2EBYIAhdWHosXL4fALSX75DOf7YF5g862MUyZhGN4Bc4/MJxIthAWCCAtLh7eiOZqeqCchGbn8+uH6jjVty+tgnNSKJFv/16Cg==';
+export function samplePendingEntry(overrides = {}) {
+    return {
+        id: 'entry-1',
+        authLogIdHex32: E2E_AUTH_LOG_ID.replace(/-/g, ''),
+        logIdHex32: E2E_USER_LOG_ID,
+        mmrStart: 1,
+        mmrEnd: 100,
+        delegatedPublicKeyHash: 'e2e-delegated-key-hash',
+        delegatedPublicKey: SAMPLE_DELEGATED_PUBLIC_KEY_B64,
+        requestedAt: 1_700_000_000,
+        ...overrides
+    };
+}
+export function samplePendingEntries(count = 2) {
+    const base = samplePendingEntry();
+    return Array.from({ length: count }, (_, i) => ({
+        ...base,
+        id: `entry-${i + 1}`,
+        mmrStart: base.mmrStart + i * 10,
+        mmrEnd: base.mmrEnd + i * 10
+    }));
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { installCoordinatorMocks, type CoordinatorMockOptions } from './coordinator-bff.js';
+export { E2E_AUTH_LOG_ID, E2E_USER_LOG_ID, SAMPLE_DELEGATED_PUBLIC_KEY_B64, samplePendingEntry, samplePendingEntries } from './fixtures.js';
+export { E2E_MOCK_WALLET_ADDRESS } from './e2e-wallet.js';
+export { BURNER_KEY_STORAGE_KEY, E2E_BURNER_ADDRESS, E2E_BURNER_PRIVATE_KEY, seedBurnerKey } from './burner.js';
+export { E2E_EMAIL, E2E_OTP, loadPending, loginWithMockPrivy } from './privy-login.js';
+export { expect, test } from './console-fixture.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EACN,eAAe,EACf,eAAe,EACf,+BAA+B,EAC/B,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACN,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { installCoordinatorMocks } from './coordinator-bff.js';
+export { E2E_AUTH_LOG_ID, E2E_USER_LOG_ID, SAMPLE_DELEGATED_PUBLIC_KEY_B64, samplePendingEntry, samplePendingEntries } from './fixtures.js';
+export { E2E_MOCK_WALLET_ADDRESS } from './e2e-wallet.js';
+export { BURNER_KEY_STORAGE_KEY, E2E_BURNER_ADDRESS, E2E_BURNER_PRIVATE_KEY, seedBurnerKey } from './burner.js';
+export { E2E_EMAIL, E2E_OTP, loadPending, loginWithMockPrivy } from './privy-login.js';
+export { expect, test } from './console-fixture.js';

package/dist/privy-login.d.ts

@@ -0,0 +1,10 @@
+import type { Page } from '@playwright/test';
+import { E2E_MOCK_WALLET_ADDRESS } from './e2e-wallet.js';
+export declare const E2E_EMAIL = "e2e-operator@forestrie.dev";
+export declare const E2E_OTP = "000000";
+/** Drive the in-DOM Privy email OTP login flow (mock Privy accepts any code). */
+export declare function loginWithMockPrivy(page: Page): Promise<void>;
+/** Click Load pending on the delegation console. */
+export declare function loadPending(page: Page): Promise<void>;
+export { E2E_MOCK_WALLET_ADDRESS };
+//# sourceMappingURL=privy-login.d.ts.map

package/dist/privy-login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privy-login.d.ts","sourceRoot":"","sources":["../src/privy-login.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,eAAO,MAAM,SAAS,+BAA+B,CAAC;AACtD,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,iFAAiF;AACjF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlE;AAED,oDAAoD;AACpD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/privy-login.js

@@ -0,0 +1,17 @@
+import { expect } from '@playwright/test';
+import { E2E_MOCK_WALLET_ADDRESS } from './e2e-wallet.js';
+export const E2E_EMAIL = 'e2e-operator@forestrie.dev';
+export const E2E_OTP = '000000';
+/** Drive the in-DOM Privy email OTP login flow (mock Privy accepts any code). */
+export async function loginWithMockPrivy(page) {
+    await page.getByPlaceholder('Email for Privy login').fill(E2E_EMAIL);
+    await page.getByRole('button', { name: 'Send code' }).click();
+    await page.getByTestId('privy-otp').fill(E2E_OTP);
+    await page.getByRole('button', { name: 'Connect wallet' }).click();
+    await expect(page.getByText(`${E2E_MOCK_WALLET_ADDRESS.slice(0, 6)}`)).toBeVisible();
+}
+/** Click Load pending on the delegation console. */
+export async function loadPending(page) {
+    await page.getByRole('button', { name: 'Load pending' }).click();
+}
+export { E2E_MOCK_WALLET_ADDRESS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forestrie/mandate-ui-e2e-kit",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "license": "MIT",
   "type": "module",
   "description": "Reusable Playwright fixtures and BFF mocks for mandate UI e2e (ARC-0024 Layer 1)",