samaro-uitest 1.0.0

package/helpers/auth.ts

@@ -0,0 +1,125 @@
+import { Page } from '@playwright/test';
+
+export interface UserCredentials {
+  username: string;
+  email: string;
+  password: string;
+}
+
+export interface AuthResult {
+  success: boolean;
+  error?: string;
+}
+
+/**
+ * Register a new user via UI
+ */
+export async function register(
+  page: Page,
+  username: string,
+  email: string,
+  password: string
+): Promise<AuthResult> {
+  await page.goto('/register', { waitUntil: 'networkidle' });
+  await page.fill('input[name="username"]', username);
+  await page.fill('input[name="email"]', email);
+  await page.fill('input[name="password"]', password);
+
+  try {
+    await Promise.all([
+      page.waitForURL('/', { timeout: 10000 }),
+      page.click('button[type="submit"]')
+    ]);
+    return { success: true };
+  } catch (error) {
+    const errorMsg = await page.locator('.error-messages, [data-testid="error-message"]').textContent().catch(() => '');
+    if (errorMsg) {
+      return { success: false, error: `Registration failed: ${errorMsg.trim()}` };
+    }
+    return { success: false, error: `Registration failed: ${error}` };
+  }
+}
+
+/**
+ * Login a user via UI
+ */
+export async function login(
+  page: Page,
+  email: string,
+  password: string
+): Promise<AuthResult> {
+  await page.goto('/login', { waitUntil: 'networkidle' });
+  await page.fill('input[name="email"]', email);
+  await page.fill('input[name="password"]', password);
+
+  try {
+    await Promise.all([
+      page.waitForURL('/', { timeout: 10000 }),
+      page.click('button[type="submit"]')
+    ]);
+    return { success: true };
+  } catch (error) {
+    const errorMsg = await page.locator('.error-messages, [data-testid="error-message"]').textContent().catch(() => '');
+    if (errorMsg) {
+      return { success: false, error: `Login failed: ${errorMsg.trim()}` };
+    }
+    return { success: false, error: `Login failed: ${error}` };
+  }
+}
+
+/**
+ * Logout a user via UI
+ */
+export async function logout(page: Page): Promise<void> {
+  // Try different logout patterns
+  const settingsLink = page.locator('a[href="/settings"], a:has-text("Settings"), [data-testid="settings-link"]').first();
+  
+  if (await settingsLink.isVisible().catch(() => false)) {
+    await settingsLink.click();
+    await page.waitForURL('/settings', { timeout: 5000 });
+  } else {
+    await page.goto('/settings');
+  }
+
+  const logoutButton = page.locator('button:has-text("logout"), button:has-text("Logout"), [data-testid="logout-button"]').first();
+  
+  await Promise.all([
+    page.waitForURL('/', { timeout: 10000 }),
+    logoutButton.click()
+  ]);
+}
+
+/**
+ * Generate unique user credentials to avoid conflicts
+ */
+export function generateUniqueUser(): UserCredentials {
+  const timestamp = Date.now();
+  const random = Math.random().toString(36).substring(2, 8);
+  return {
+    username: `testuser_${timestamp}_${random}`,
+    email: `test_${timestamp}_${random}@example.com`,
+    password: 'TestPassword123!',
+  };
+}
+
+/**
+ * Check if user is logged in
+ */
+export async function isLoggedIn(page: Page): Promise<boolean> {
+  // Check for logout button or user-specific elements
+  const logoutVisible = await page.locator('a[href="/settings"], [data-testid="logout-button"]').isVisible().catch(() => false);
+  const loginVisible = await page.locator('a[href="/login"]').isVisible().catch(() => false);
+  
+  return logoutVisible && !loginVisible;
+}
+
+/**
+ * Get current username if logged in
+ */
+export async function getCurrentUsername(page: Page): Promise<string | null> {
+  const usernameElement = page.locator('[data-testid="username"], .user-name, .username').first();
+  if (await usernameElement.isVisible().catch(() => false)) {
+    return usernameElement.textContent();
+  }
+  return null;
+}

package/helpers/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Configuration helpers for SamaroUItest
+ */
+export interface SamaroConfig {
+    apiMode: boolean;
+    apiBase: string;
+    debugInterfaceName: string;
+    timeouts: {
+        navigation: number;
+        action: number;
+        expectation: number;
+    };
+}
+/**
+ * Get SamaroUItest configuration from environment variables
+ */
+export declare function getConfig(): SamaroConfig;
+/**
+ * Check if running in CI environment
+ */
+export declare function isCI(): boolean;
+/**
+ * Check if running in debug mode
+ */
+export declare function isDebug(): boolean;
+/**
+ * Get browser launch options based on environment
+ */
+export declare function getBrowserLaunchOptions(): Record<string, any>;
+/**
+ * Set environment variables for test configuration
+ */
+export declare function setTestEnv(vars: Partial<SamaroConfig>): void;
+//# sourceMappingURL=config.d.ts.map

package/helpers/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAWxC;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,wBAgBtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAU5D"}

package/helpers/config.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Configuration helpers for SamaroUItest
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+exports.isCI = isCI;
+exports.isDebug = isDebug;
+exports.getBrowserLaunchOptions = getBrowserLaunchOptions;
+exports.setTestEnv = setTestEnv;
+/**
+ * Get SamaroUItest configuration from environment variables
+ */
+function getConfig() {
+    return {
+        apiMode: process.env.API_MODE?.toLowerCase() !== 'false',
+        apiBase: process.env.API_BASE || process.env.NG_API_URL || 'http://localhost:4200/api',
+        debugInterfaceName: process.env.DEBUG_INTERFACE_NAME || '__app_debug__',
+        timeouts: {
+            navigation: parseInt(process.env.TIMEOUT_NAVIGATION || '10000', 10),
+            action: parseInt(process.env.TIMEOUT_ACTION || '5000', 10),
+            expectation: parseInt(process.env.TIMEOUT_EXPECTATION || '5000', 10),
+        },
+    };
+}
+/**
+ * Check if running in CI environment
+ */
+function isCI() {
+    return !!process.env.CI;
+}
+/**
+ * Check if running in debug mode
+ */
+function isDebug() {
+    return process.env.DEBUG === 'true' || process.env.PWDEBUG === '1';
+}
+/**
+ * Get browser launch options based on environment
+ */
+function getBrowserLaunchOptions() {
+    const options = {
+        headless: !isDebug(),
+    };
+    if (isCI()) {
+        options.args = [
+            '--no-sandbox',
+            '--disable-setuid-sandbox',
+            '--disable-dev-shm-usage',
+            '--disable-accelerated-2d-canvas',
+            '--disable-gpu',
+        ];
+    }
+    return options;
+}
+/**
+ * Set environment variables for test configuration
+ */
+function setTestEnv(vars) {
+    if (vars.apiMode !== undefined) {
+        process.env.API_MODE = vars.apiMode.toString();
+    }
+    if (vars.apiBase) {
+        process.env.API_BASE = vars.apiBase;
+    }
+    if (vars.debugInterfaceName) {
+        process.env.DEBUG_INTERFACE_NAME = vars.debugInterfaceName;
+    }
+}
+//# sourceMappingURL=config.js.map

package/helpers/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["config.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAgBH,8BAWC;AAKD,oBAEC;AAKD,0BAEC;AAKD,0DAgBC;AAKD,gCAUC;AAhED;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,OAAO;QACxD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,2BAA2B;QACtF,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,eAAe;QACvE,QAAQ,EAAE;YACR,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,EAAE,EAAE,CAAC;YACnE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC;YAC1D,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,MAAM,EAAE,EAAE,CAAC;SACrE;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI;IAClB,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,MAAM,OAAO,GAAwB;QACnC,QAAQ,EAAE,CAAC,OAAO,EAAE;KACrB,CAAC;IAEF,IAAI,IAAI,EAAE,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,GAAG;YACb,cAAc;YACd,0BAA0B;YAC1B,yBAAyB;YACzB,iCAAiC;YACjC,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,IAA2B;IACpD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,CAAC,kBAAkB,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/helpers/config.ts

@@ -0,0 +1,80 @@
+/**
+ * Configuration helpers for SamaroUItest
+ */
+
+export interface SamaroConfig {
+  apiMode: boolean;
+  apiBase: string;
+  debugInterfaceName: string;
+  timeouts: {
+    navigation: number;
+    action: number;
+    expectation: number;
+  };
+}
+
+/**
+ * Get SamaroUItest configuration from environment variables
+ */
+export function getConfig(): SamaroConfig {
+  return {
+    apiMode: process.env.API_MODE?.toLowerCase() !== 'false',
+    apiBase: process.env.API_BASE || process.env.NG_API_URL || 'http://localhost:4200/api',
+    debugInterfaceName: process.env.DEBUG_INTERFACE_NAME || '__app_debug__',
+    timeouts: {
+      navigation: parseInt(process.env.TIMEOUT_NAVIGATION || '10000', 10),
+      action: parseInt(process.env.TIMEOUT_ACTION || '5000', 10),
+      expectation: parseInt(process.env.TIMEOUT_EXPECTATION || '5000', 10),
+    },
+  };
+}
+
+/**
+ * Check if running in CI environment
+ */
+export function isCI(): boolean {
+  return !!process.env.CI;
+}
+
+/**
+ * Check if running in debug mode
+ */
+export function isDebug(): boolean {
+  return process.env.DEBUG === 'true' || process.env.PWDEBUG === '1';
+}
+
+/**
+ * Get browser launch options based on environment
+ */
+export function getBrowserLaunchOptions() {
+  const options: Record<string, any> = {
+    headless: !isDebug(),
+  };
+
+  if (isCI()) {
+    options.args = [
+      '--no-sandbox',
+      '--disable-setuid-sandbox',
+      '--disable-dev-shm-usage',
+      '--disable-accelerated-2d-canvas',
+      '--disable-gpu',
+    ];
+  }
+
+  return options;
+}
+
+/**
+ * Set environment variables for test configuration
+ */
+export function setTestEnv(vars: Partial<SamaroConfig>): void {
+  if (vars.apiMode !== undefined) {
+    process.env.API_MODE = vars.apiMode.toString();
+  }
+  if (vars.apiBase) {
+    process.env.API_BASE = vars.apiBase;
+  }
+  if (vars.debugInterfaceName) {
+    process.env.DEBUG_INTERFACE_NAME = vars.debugInterfaceName;
+  }
+}

package/helpers/debug.d.ts

@@ -0,0 +1,48 @@
+import { Page } from '@playwright/test';
+export type AuthState = 'authenticated' | 'unauthenticated' | 'unavailable' | 'loading';
+export interface User {
+    username: string;
+    email: string;
+    bio: string | null;
+    image: string | null;
+    token: string;
+}
+export declare function setDebugInterfaceName(name: string): void;
+export declare function getDebugInterfaceName(): string;
+/**
+ * Get the current JWT token from the app's debug interface.
+ * Returns null if no token is set or debug interface is not available.
+ */
+export declare function getToken(page: Page): Promise<string | null>;
+/**
+ * Get the current authentication state from the app's debug interface.
+ * Returns undefined if debug interface is not available.
+ */
+export declare function getAuthState(page: Page): Promise<AuthState | undefined>;
+/**
+ * Get the current user from the app's debug interface.
+ * Returns null if not authenticated or debug interface is not available.
+ */
+export declare function getCurrentUser(page: Page): Promise<User | null>;
+/**
+ * Wait for a specific auth state to be reached.
+ * Useful for waiting after login/logout operations.
+ */
+export declare function waitForAuthState(page: Page, expectedState: AuthState, options?: {
+    timeout?: number;
+}): Promise<void>;
+/**
+ * Check if the debug interface is available.
+ * Can be used to skip tests if implementation doesn't support it.
+ */
+export declare function isDebugInterfaceAvailable(page: Page): Promise<boolean>;
+/**
+ * Get all debug data at once (token, auth state, user)
+ */
+export declare function getDebugData(page: Page): Promise<{
+    token: string | null;
+    authState: AuthState | undefined;
+    user: User | null;
+    available: boolean;
+}>;
+//# sourceMappingURL=debug.d.ts.map

package/helpers/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,iBAAiB,GAAG,aAAa,GAAG,SAAS,CAAC;AAExF,MAAM,WAAW,IAAI;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKjE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAK7E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAKrE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,SAAS,EACxB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAcD"}

package/helpers/debug.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDebugInterfaceName = setDebugInterfaceName;
+exports.getDebugInterfaceName = getDebugInterfaceName;
+exports.getToken = getToken;
+exports.getAuthState = getAuthState;
+exports.getCurrentUser = getCurrentUser;
+exports.waitForAuthState = waitForAuthState;
+exports.isDebugInterfaceAvailable = isDebugInterfaceAvailable;
+exports.getDebugData = getDebugData;
+/**
+ * Configure the debug interface name (defaults to __app_debug__)
+ */
+let DEBUG_INTERFACE_NAME = '__app_debug__';
+function setDebugInterfaceName(name) {
+    DEBUG_INTERFACE_NAME = name;
+}
+function getDebugInterfaceName() {
+    return DEBUG_INTERFACE_NAME;
+}
+/**
+ * Get the current JWT token from the app's debug interface.
+ * Returns null if no token is set or debug interface is not available.
+ */
+async function getToken(page) {
+    return page.evaluate((name) => {
+        const debug = window[name];
+        return debug?.getToken ? debug.getToken() : null;
+    }, DEBUG_INTERFACE_NAME);
+}
+/**
+ * Get the current authentication state from the app's debug interface.
+ * Returns undefined if debug interface is not available.
+ */
+async function getAuthState(page) {
+    return page.evaluate((name) => {
+        const debug = window[name];
+        return debug?.getAuthState ? debug.getAuthState() : undefined;
+    }, DEBUG_INTERFACE_NAME);
+}
+/**
+ * Get the current user from the app's debug interface.
+ * Returns null if not authenticated or debug interface is not available.
+ */
+async function getCurrentUser(page) {
+    return page.evaluate((name) => {
+        const debug = window[name];
+        return debug?.getCurrentUser ? debug.getCurrentUser() : null;
+    }, DEBUG_INTERFACE_NAME);
+}
+/**
+ * Wait for a specific auth state to be reached.
+ * Useful for waiting after login/logout operations.
+ */
+async function waitForAuthState(page, expectedState, options = {}) {
+    const timeout = options.timeout ?? 5000;
+    await page.waitForFunction((state, name) => {
+        const debug = window[name];
+        return debug?.getAuthState ? debug.getAuthState() === state : false;
+    }, expectedState, DEBUG_INTERFACE_NAME, { timeout });
+}
+/**
+ * Check if the debug interface is available.
+ * Can be used to skip tests if implementation doesn't support it.
+ */
+async function isDebugInterfaceAvailable(page) {
+    return page.evaluate((name) => {
+        return typeof window[name] !== 'undefined';
+    }, DEBUG_INTERFACE_NAME);
+}
+/**
+ * Get all debug data at once (token, auth state, user)
+ */
+async function getDebugData(page) {
+    const available = await isDebugInterfaceAvailable(page);
+    if (!available) {
+        return { token: null, authState: undefined, user: null, available: false };
+    }
+    const [token, authState, user] = await Promise.all([
+        getToken(page),
+        getAuthState(page),
+        getCurrentUser(page),
+    ]);
+    return { token, authState, user, available: true };
+}
+//# sourceMappingURL=debug.js.map

package/helpers/debug.js.map

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

package/helpers/debug.ts

@@ -0,0 +1,111 @@
+import { Page } from '@playwright/test';
+
+export type AuthState = 'authenticated' | 'unauthenticated' | 'unavailable' | 'loading';
+
+export interface User {
+  username: string;
+  email: string;
+  bio: string | null;
+  image: string | null;
+  token: string;
+}
+
+/**
+ * Configure the debug interface name (defaults to __app_debug__)
+ */
+let DEBUG_INTERFACE_NAME = '__app_debug__';
+
+export function setDebugInterfaceName(name: string): void {
+  DEBUG_INTERFACE_NAME = name;
+}
+
+export function getDebugInterfaceName(): string {
+  return DEBUG_INTERFACE_NAME;
+}
+
+/**
+ * Get the current JWT token from the app's debug interface.
+ * Returns null if no token is set or debug interface is not available.
+ */
+export async function getToken(page: Page): Promise<string | null> {
+  return page.evaluate((name) => {
+    const debug = (window as any)[name];
+    return debug?.getToken ? debug.getToken() : null;
+  }, DEBUG_INTERFACE_NAME);
+}
+
+/**
+ * Get the current authentication state from the app's debug interface.
+ * Returns undefined if debug interface is not available.
+ */
+export async function getAuthState(page: Page): Promise<AuthState | undefined> {
+  return page.evaluate((name) => {
+    const debug = (window as any)[name];
+    return debug?.getAuthState ? debug.getAuthState() : undefined;
+  }, DEBUG_INTERFACE_NAME);
+}
+
+/**
+ * Get the current user from the app's debug interface.
+ * Returns null if not authenticated or debug interface is not available.
+ */
+export async function getCurrentUser(page: Page): Promise<User | null> {
+  return page.evaluate((name) => {
+    const debug = (window as any)[name];
+    return debug?.getCurrentUser ? debug.getCurrentUser() : null;
+  }, DEBUG_INTERFACE_NAME);
+}
+
+/**
+ * Wait for a specific auth state to be reached.
+ * Useful for waiting after login/logout operations.
+ */
+export async function waitForAuthState(
+  page: Page,
+  expectedState: AuthState,
+  options: { timeout?: number } = {},
+): Promise<void> {
+  const timeout = options.timeout ?? 5000;
+  await page.waitForFunction(
+    ({ state, name }: { state: AuthState; name: string }) => {
+      const debug = (window as any)[name];
+      return debug?.getAuthState ? debug.getAuthState() === state : false;
+    },
+    { state: expectedState, name: DEBUG_INTERFACE_NAME },
+    { timeout }
+  );
+}
+
+/**
+ * Check if the debug interface is available.
+ * Can be used to skip tests if implementation doesn't support it.
+ */
+export async function isDebugInterfaceAvailable(page: Page): Promise<boolean> {
+  return page.evaluate((name) => {
+    return typeof (window as any)[name] !== 'undefined';
+  }, DEBUG_INTERFACE_NAME);
+}
+
+/**
+ * Get all debug data at once (token, auth state, user)
+ */
+export async function getDebugData(page: Page): Promise<{
+  token: string | null;
+  authState: AuthState | undefined;
+  user: User | null;
+  available: boolean;
+}> {
+  const available = await isDebugInterfaceAvailable(page);
+  
+  if (!available) {
+    return { token: null, authState: undefined, user: null, available: false };
+  }
+
+  const [token, authState, user] = await Promise.all([
+    getToken(page),
+    getAuthState(page),
+    getCurrentUser(page),
+  ]);
+
+  return { token, authState, user, available: true };
+}

package/helpers/index.d.ts

@@ -0,0 +1,6 @@
+export { setDebugInterfaceName, getDebugInterfaceName, getToken, getAuthState, getCurrentUser, waitForAuthState, isDebugInterfaceAvailable, getDebugData, type AuthState, type User, } from './debug';
+export { register, login, logout, generateUniqueUser, isLoggedIn, getCurrentUsername, type UserCredentials, type AuthResult, } from './auth';
+export { getAPIConfig, registerUserViaAPI, loginUserViaAPI, createArticleViaAPI, deleteArticleViaAPI, updateUserViaAPI, getCurrentUserViaAPI, type APIConfig, type APIUser, type APIAuthResponse, } from './api';
+export { createUserInIsolation, createUserViaAPI, setupAuthenticatedPage, createManyArticles, cleanupTestData, waitForAngular, safeGoto, type TestUser, type IsolatedUserContext, } from './setup';
+export { getConfig, isCI, isDebug, getBrowserLaunchOptions, setTestEnv, type SamaroConfig, } from './config';
+//# sourceMappingURL=index.d.ts.map

package/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,IAAI,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,QAAQ,EACR,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,eAAe,GACrB,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,SAAS,EACT,IAAI,EACJ,OAAO,EACP,uBAAuB,EACvB,UAAU,EACV,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC"}

package/helpers/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTestEnv = exports.getBrowserLaunchOptions = exports.isDebug = exports.isCI = exports.getConfig = exports.safeGoto = exports.waitForAngular = exports.cleanupTestData = exports.createManyArticles = exports.setupAuthenticatedPage = exports.createUserViaAPI = exports.createUserInIsolation = exports.getCurrentUserViaAPI = exports.updateUserViaAPI = exports.deleteArticleViaAPI = exports.createArticleViaAPI = exports.loginUserViaAPI = exports.registerUserViaAPI = exports.getAPIConfig = exports.getCurrentUsername = exports.isLoggedIn = exports.generateUniqueUser = exports.logout = exports.login = exports.register = exports.getDebugData = exports.isDebugInterfaceAvailable = exports.waitForAuthState = exports.getCurrentUser = exports.getAuthState = exports.getToken = exports.getDebugInterfaceName = exports.setDebugInterfaceName = void 0;
+// Debug interface helpers
+var debug_1 = require("./debug");
+Object.defineProperty(exports, "setDebugInterfaceName", { enumerable: true, get: function () { return debug_1.setDebugInterfaceName; } });
+Object.defineProperty(exports, "getDebugInterfaceName", { enumerable: true, get: function () { return debug_1.getDebugInterfaceName; } });
+Object.defineProperty(exports, "getToken", { enumerable: true, get: function () { return debug_1.getToken; } });
+Object.defineProperty(exports, "getAuthState", { enumerable: true, get: function () { return debug_1.getAuthState; } });
+Object.defineProperty(exports, "getCurrentUser", { enumerable: true, get: function () { return debug_1.getCurrentUser; } });
+Object.defineProperty(exports, "waitForAuthState", { enumerable: true, get: function () { return debug_1.waitForAuthState; } });
+Object.defineProperty(exports, "isDebugInterfaceAvailable", { enumerable: true, get: function () { return debug_1.isDebugInterfaceAvailable; } });
+Object.defineProperty(exports, "getDebugData", { enumerable: true, get: function () { return debug_1.getDebugData; } });
+// Authentication helpers
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "register", { enumerable: true, get: function () { return auth_1.register; } });
+Object.defineProperty(exports, "login", { enumerable: true, get: function () { return auth_1.login; } });
+Object.defineProperty(exports, "logout", { enumerable: true, get: function () { return auth_1.logout; } });
+Object.defineProperty(exports, "generateUniqueUser", { enumerable: true, get: function () { return auth_1.generateUniqueUser; } });
+Object.defineProperty(exports, "isLoggedIn", { enumerable: true, get: function () { return auth_1.isLoggedIn; } });
+Object.defineProperty(exports, "getCurrentUsername", { enumerable: true, get: function () { return auth_1.getCurrentUsername; } });
+// API helpers
+var api_1 = require("./api");
+Object.defineProperty(exports, "getAPIConfig", { enumerable: true, get: function () { return api_1.getAPIConfig; } });
+Object.defineProperty(exports, "registerUserViaAPI", { enumerable: true, get: function () { return api_1.registerUserViaAPI; } });
+Object.defineProperty(exports, "loginUserViaAPI", { enumerable: true, get: function () { return api_1.loginUserViaAPI; } });
+Object.defineProperty(exports, "createArticleViaAPI", { enumerable: true, get: function () { return api_1.createArticleViaAPI; } });
+Object.defineProperty(exports, "deleteArticleViaAPI", { enumerable: true, get: function () { return api_1.deleteArticleViaAPI; } });
+Object.defineProperty(exports, "updateUserViaAPI", { enumerable: true, get: function () { return api_1.updateUserViaAPI; } });
+Object.defineProperty(exports, "getCurrentUserViaAPI", { enumerable: true, get: function () { return api_1.getCurrentUserViaAPI; } });
+// Setup utilities
+var setup_1 = require("./setup");
+Object.defineProperty(exports, "createUserInIsolation", { enumerable: true, get: function () { return setup_1.createUserInIsolation; } });
+Object.defineProperty(exports, "createUserViaAPI", { enumerable: true, get: function () { return setup_1.createUserViaAPI; } });
+Object.defineProperty(exports, "setupAuthenticatedPage", { enumerable: true, get: function () { return setup_1.setupAuthenticatedPage; } });
+Object.defineProperty(exports, "createManyArticles", { enumerable: true, get: function () { return setup_1.createManyArticles; } });
+Object.defineProperty(exports, "cleanupTestData", { enumerable: true, get: function () { return setup_1.cleanupTestData; } });
+Object.defineProperty(exports, "waitForAngular", { enumerable: true, get: function () { return setup_1.waitForAngular; } });
+Object.defineProperty(exports, "safeGoto", { enumerable: true, get: function () { return setup_1.safeGoto; } });
+// Configuration helpers
+var config_1 = require("./config");
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_1.getConfig; } });
+Object.defineProperty(exports, "isCI", { enumerable: true, get: function () { return config_1.isCI; } });
+Object.defineProperty(exports, "isDebug", { enumerable: true, get: function () { return config_1.isDebug; } });
+Object.defineProperty(exports, "getBrowserLaunchOptions", { enumerable: true, get: function () { return config_1.getBrowserLaunchOptions; } });
+Object.defineProperty(exports, "setTestEnv", { enumerable: true, get: function () { return config_1.setTestEnv; } });
+//# sourceMappingURL=index.js.map

package/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA,0BAA0B;AAC1B,iCAWiB;AAVf,8GAAA,qBAAqB,OAAA;AACrB,8GAAA,qBAAqB,OAAA;AACrB,iGAAA,QAAQ,OAAA;AACR,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,yGAAA,gBAAgB,OAAA;AAChB,kHAAA,yBAAyB,OAAA;AACzB,qGAAA,YAAY,OAAA;AAKd,yBAAyB;AACzB,+BASgB;AARd,gGAAA,QAAQ,OAAA;AACR,6FAAA,KAAK,OAAA;AACL,8FAAA,MAAM,OAAA;AACN,0GAAA,kBAAkB,OAAA;AAClB,kGAAA,UAAU,OAAA;AACV,0GAAA,kBAAkB,OAAA;AAKpB,cAAc;AACd,6BAWe;AAVb,mGAAA,YAAY,OAAA;AACZ,yGAAA,kBAAkB,OAAA;AAClB,sGAAA,eAAe,OAAA;AACf,0GAAA,mBAAmB,OAAA;AACnB,0GAAA,mBAAmB,OAAA;AACnB,uGAAA,gBAAgB,OAAA;AAChB,2GAAA,oBAAoB,OAAA;AAMtB,kBAAkB;AAClB,iCAUiB;AATf,8GAAA,qBAAqB,OAAA;AACrB,yGAAA,gBAAgB,OAAA;AAChB,+GAAA,sBAAsB,OAAA;AACtB,2GAAA,kBAAkB,OAAA;AAClB,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,iGAAA,QAAQ,OAAA;AAKV,wBAAwB;AACxB,mCAOkB;AANhB,mGAAA,SAAS,OAAA;AACT,8FAAA,IAAI,OAAA;AACJ,iGAAA,OAAO,OAAA;AACP,iHAAA,uBAAuB,OAAA;AACvB,oGAAA,UAAU,OAAA"}