samaro-uitest 1.0.0

package/helpers/index.ts

@@ -0,0 +1,62 @@
+// Debug interface helpers
+export {
+  setDebugInterfaceName,
+  getDebugInterfaceName,
+  getToken,
+  getAuthState,
+  getCurrentUser,
+  waitForAuthState,
+  isDebugInterfaceAvailable,
+  getDebugData,
+  type AuthState,
+  type User,
+} from './debug';
+
+// Authentication helpers
+export {
+  register,
+  login,
+  logout,
+  generateUniqueUser,
+  isLoggedIn,
+  getCurrentUsername,
+  type UserCredentials,
+  type AuthResult,
+} from './auth';
+
+// API helpers
+export {
+  getAPIConfig,
+  registerUserViaAPI,
+  loginUserViaAPI,
+  createArticleViaAPI,
+  deleteArticleViaAPI,
+  updateUserViaAPI,
+  getCurrentUserViaAPI,
+  type APIConfig,
+  type APIUser,
+  type APIAuthResponse,
+} from './api';
+
+// Setup utilities
+export {
+  createUserInIsolation,
+  createUserViaAPI,
+  setupAuthenticatedPage,
+  createManyArticles,
+  cleanupTestData,
+  waitForAngular,
+  safeGoto,
+  type TestUser,
+  type IsolatedUserContext,
+} from './setup';
+
+// Configuration helpers
+export {
+  getConfig,
+  isCI,
+  isDebug,
+  getBrowserLaunchOptions,
+  setTestEnv,
+  type SamaroConfig,
+} from './config';

package/helpers/setup.d.ts

@@ -0,0 +1,50 @@
+import { Browser, BrowserContext, Page, APIRequestContext } from '@playwright/test';
+import { APIUser } from './api';
+export interface TestUser extends APIUser {
+    token?: string;
+}
+export interface IsolatedUserContext {
+    context: BrowserContext;
+    page: Page;
+    user: TestUser;
+}
+/**
+ * Create a user in an isolated browser context
+ * This provides full isolation for tests
+ */
+export declare function createUserInIsolation(browser: Browser, user?: Partial<TestUser>): Promise<IsolatedUserContext>;
+/**
+ * Create a user via API (faster, no browser context needed)
+ */
+export declare function createUserViaAPI(request: APIRequestContext, user?: Partial<TestUser>): Promise<TestUser & {
+    token: string;
+}>;
+/**
+ * Setup authenticated page with token
+ */
+export declare function setupAuthenticatedPage(page: Page, token: string): Promise<void>;
+/**
+ * Create multiple articles via API
+ */
+export declare function createManyArticles(request: APIRequestContext, token: string, count: number, baseTitle?: string): Promise<Array<{
+    slug: string;
+    title: string;
+}>>;
+/**
+ * Cleanup helper for test data
+ */
+export declare function cleanupTestData(request: APIRequestContext, token: string, articles: Array<{
+    slug: string;
+}>): Promise<void>;
+/**
+ * Wait for Angular to be stable
+ */
+export declare function waitForAngular(page: Page): Promise<void>;
+/**
+ * Safe navigation with retry
+ */
+export declare function safeGoto(page: Page, url: string, options?: {
+    timeout?: number;
+    retries?: number;
+}): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/helpers/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,EAAsB,OAAO,EAAE,MAAM,OAAO,CAAC;AAEpD,MAAM,WAAW,QAAS,SAAQ,OAAO;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAa9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GACvB,OAAO,CAAC,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CASvC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAuB,GACjC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAejD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/helpers/setup.js

@@ -0,0 +1,137 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUserInIsolation = createUserInIsolation;
+exports.createUserViaAPI = createUserViaAPI;
+exports.setupAuthenticatedPage = setupAuthenticatedPage;
+exports.createManyArticles = createManyArticles;
+exports.cleanupTestData = cleanupTestData;
+exports.waitForAngular = waitForAngular;
+exports.safeGoto = safeGoto;
+const auth_1 = require("./auth");
+const api_1 = require("./api");
+/**
+ * Create a user in an isolated browser context
+ * This provides full isolation for tests
+ */
+async function createUserInIsolation(browser, user) {
+    const context = await browser.newContext();
+    const page = await context.newPage();
+    const uniqueUser = { ...(0, auth_1.generateUniqueUser)(), ...user };
+    const result = await (0, auth_1.register)(page, uniqueUser.username, uniqueUser.email, uniqueUser.password);
+    if (!result.success) {
+        await context.close();
+        throw new Error(result.error || 'Failed to create user in isolation');
+    }
+    return { context, page, user: uniqueUser };
+}
+/**
+ * Create a user via API (faster, no browser context needed)
+ */
+async function createUserViaAPI(request, user) {
+    const uniqueUser = { ...(0, auth_1.generateUniqueUser)(), ...user };
+    const { token, username, email } = await (0, api_1.registerUserViaAPI)(request, uniqueUser);
+    return {
+        username,
+        email,
+        password: uniqueUser.password,
+        token
+    };
+}
+/**
+ * Setup authenticated page with token
+ */
+async function setupAuthenticatedPage(page, token) {
+    // Set token in localStorage
+    await page.goto('/');
+    await page.evaluate((t) => {
+        localStorage.setItem('token', t);
+    }, token);
+    // Reload to apply token
+    await page.reload();
+}
+/**
+ * Create multiple articles via API
+ */
+async function createManyArticles(request, token, count, baseTitle = 'Test Article') {
+    const { createArticleViaAPI } = await Promise.resolve().then(() => __importStar(require('./api')));
+    const articles = [];
+    for (let i = 0; i < count; i++) {
+        const article = await createArticleViaAPI(request, token, {
+            title: `${baseTitle} ${i + 1}`,
+            description: `Description for article ${i + 1}`,
+            body: `Body content for article ${i + 1}`,
+            tagList: ['test', `tag-${i}`],
+        });
+        articles.push(article);
+    }
+    return articles;
+}
+/**
+ * Cleanup helper for test data
+ */
+async function cleanupTestData(request, token, articles) {
+    const { deleteArticleViaAPI } = await Promise.resolve().then(() => __importStar(require('./api')));
+    await Promise.all(articles.map(article => deleteArticleViaAPI(request, token, article.slug).catch(() => {
+        // Ignore cleanup errors
+    })));
+}
+/**
+ * Wait for Angular to be stable
+ */
+async function waitForAngular(page) {
+    await page.waitForFunction(() => {
+        return window.getAngularTestability ?
+            window.getAngularTestability().isStable() : true;
+    });
+}
+/**
+ * Safe navigation with retry
+ */
+async function safeGoto(page, url, options = {}) {
+    const { timeout = 10000, retries = 3 } = options;
+    for (let i = 0; i < retries; i++) {
+        try {
+            await page.goto(url, { waitUntil: 'networkidle', timeout });
+            return;
+        }
+        catch (error) {
+            if (i === retries - 1)
+                throw error;
+            await page.waitForTimeout(1000);
+        }
+    }
+}
+//# sourceMappingURL=setup.js.map

package/helpers/setup.js.map

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

package/helpers/setup.ts

@@ -0,0 +1,144 @@
+import { Browser, BrowserContext, Page, APIRequestContext } from '@playwright/test';
+import { generateUniqueUser, register } from './auth';
+import { registerUserViaAPI, APIUser } from './api';
+
+export interface TestUser extends APIUser {
+  token?: string;
+}
+
+export interface IsolatedUserContext {
+  context: BrowserContext;
+  page: Page;
+  user: TestUser;
+}
+
+/**
+ * Create a user in an isolated browser context
+ * This provides full isolation for tests
+ */
+export async function createUserInIsolation(
+  browser: Browser,
+  user?: Partial<TestUser>
+): Promise<IsolatedUserContext> {
+  const context = await browser.newContext();
+  const page = await context.newPage();
+  const uniqueUser = { ...generateUniqueUser(), ...user };
+
+  const result = await register(page, uniqueUser.username, uniqueUser.email, uniqueUser.password);
+  
+  if (!result.success) {
+    await context.close();
+    throw new Error(result.error || 'Failed to create user in isolation');
+  }
+
+  return { context, page, user: uniqueUser };
+}
+
+/**
+ * Create a user via API (faster, no browser context needed)
+ */
+export async function createUserViaAPI(
+  request: APIRequestContext,
+  user?: Partial<TestUser>
+): Promise<TestUser & { token: string }> {
+  const uniqueUser = { ...generateUniqueUser(), ...user };
+  const { token, username, email } = await registerUserViaAPI(request, uniqueUser);
+  return { 
+    username, 
+    email, 
+    password: uniqueUser.password, 
+    token 
+  };
+}
+
+/**
+ * Setup authenticated page with token
+ */
+export async function setupAuthenticatedPage(
+  page: Page,
+  token: string
+): Promise<void> {
+  // Set token in localStorage
+  await page.goto('/');
+  await page.evaluate((t) => {
+    localStorage.setItem('token', t);
+  }, token);
+  
+  // Reload to apply token
+  await page.reload();
+}
+
+/**
+ * Create multiple articles via API
+ */
+export async function createManyArticles(
+  request: APIRequestContext,
+  token: string,
+  count: number,
+  baseTitle: string = 'Test Article'
+): Promise<Array<{ slug: string; title: string }>> {
+  const { createArticleViaAPI } = await import('./api');
+  const articles: Array<{ slug: string; title: string }> = [];
+  
+  for (let i = 0; i < count; i++) {
+    const article = await createArticleViaAPI(request, token, {
+      title: `${baseTitle} ${i + 1}`,
+      description: `Description for article ${i + 1}`,
+      body: `Body content for article ${i + 1}`,
+      tagList: ['test', `tag-${i}`],
+    });
+    articles.push(article);
+  }
+  
+  return articles;
+}
+
+/**
+ * Cleanup helper for test data
+ */
+export async function cleanupTestData(
+  request: APIRequestContext,
+  token: string,
+  articles: Array<{ slug: string }>
+): Promise<void> {
+  const { deleteArticleViaAPI } = await import('./api');
+  
+  await Promise.all(
+    articles.map(article => 
+      deleteArticleViaAPI(request, token, article.slug).catch(() => {
+        // Ignore cleanup errors
+      })
+    )
+  );
+}
+
+/**
+ * Wait for Angular to be stable
+ */
+export async function waitForAngular(page: Page): Promise<void> {
+  await page.waitForFunction(() => {
+    return (window as any).getAngularTestability ? 
+      (window as any).getAngularTestability().isStable() : true;
+  });
+}
+
+/**
+ * Safe navigation with retry
+ */
+export async function safeGoto(
+  page: Page,
+  url: string,
+  options: { timeout?: number; retries?: number } = {}
+): Promise<void> {
+  const { timeout = 10000, retries = 3 } = options;
+  
+  for (let i = 0; i < retries; i++) {
+    try {
+      await page.goto(url, { waitUntil: 'networkidle', timeout });
+      return;
+    } catch (error) {
+      if (i === retries - 1) throw error;
+      await page.waitForTimeout(1000);
+    }
+  }
+}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "samaro-uitest",
+  "version": "1.0.0",
+  "description": "Comprehensive testing framework for Angular with Vitest, Playwright, and Allure reporting",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "samaro": "./bin/samaro-init.js",
+    "samaro-init": "./bin/samaro-init.js",
+    "samaro-test": "./bin/samaro-test.js",
+    "samaro-allure": "./bin/samaro-allure.js"
+  },
+  "files": [
+    "dist/**/*",
+    "bin/**/*",
+    "config/**/*",
+    "helpers/**/*",
+    "scripts/**/*",
+    "schematics/**/*",
+    "types/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prebuild": "rimraf dist",
+    "postbuild": "cpy 'config/**/*' 'helpers/**/*' 'scripts/**/*' 'types/**/*' dist/ --parents",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "format": "prettier --write ."
+  },
+  "keywords": [
+    "angular",
+    "testing",
+    "vitest",
+    "playwright",
+    "allure",
+    "e2e",
+    "component-testing",
+    "test-framework",
+    "automation"
+  ],
+  "author": "Samaro",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samaro/samaro-uitest.git"
+  },
+  "bugs": {
+    "url": "https://github.com/samaro/samaro-uitest/issues"
+  },
+  "homepage": "https://github.com/samaro/samaro-uitest#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=15.0.0",
+    "@angular/platform-browser-dynamic": ">=15.0.0",
+    "typescript": ">=4.8.0"
+  },
+  "dependencies": {
+    "@analogjs/vite-plugin-angular": "^2.2.2",
+    "@playwright/test": "^1.58.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "@vitest/ui": "^4.0.18",
+    "allure": "^3.14.2",
+    "allure-commandline": "^2.43.0",
+    "allure-js-commons": "^3.10.2",
+    "allure-playwright": "^3.10.2",
+    "allure-vitest": "^3.10.2",
+    "jsdom": "^27.4.0",
+    "playwright": "^1.58.0",
+    "vitest": "^4.0.18",
+    "zone.js": "^0.16.0",
+    "cross-spawn": "^7.0.3",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6"
+  },
+  "devDependencies": {
+    "@angular-devkit/schematics": "^17.0.0",
+    "@types/cross-spawn": "^6.0.6",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.0.0",
+    "cpy-cli": "^5.0.0",
+    "prettier": "^3.0.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.0"
+  },
+  "schematics": "./schematics/collection.json",
+  "ng-add": {
+    "save": "devDependencies"
+  }
+}

package/schematics/collection.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Add SamaroUItest to the project",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json",
+      "aliases": ["install", "setup"]
+    }
+  }
+}

package/schematics/ng-add/index.js

@@ -0,0 +1,121 @@
+const { chain, externalSchematic, schematic } = require('@angular-devkit/schematics');
+const { NodePackageInstallTask } = require('@angular-devkit/schematics/tasks');
+
+function ngAdd(options) {
+  return (tree, context) => {
+    context.addTask(new NodePackageInstallTask());
+    
+    context.logger.info('🚀 Installing SamaroUItest...');
+    
+    return chain([
+      updatePackageJson(),
+      createConfigFiles(options),
+      createDirectories(),
+    ])(tree, context);
+  };
+}
+
+function updatePackageJson() {
+  return (tree, context) => {
+    const packageJsonPath = '/package.json';
+    const packageJsonBuffer = tree.read(packageJsonPath);
+    
+    if (!packageJsonBuffer) {
+      throw new Error('Could not read package.json');
+    }
+    
+    const packageJson = JSON.parse(packageJsonBuffer.toString());
+    
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      'test': 'samaro-test vitest',
+      'test:run': 'samaro-test "vitest --run"',
+      'test:ui': 'samaro-test "vitest --ui"',
+      'test:coverage': 'samaro-test "vitest --coverage"',
+      'test:e2e': 'samaro-test "playwright test"',
+      'test:e2e:ui': 'samaro-test "playwright test --ui"',
+      'test:e2e:headed': 'samaro-test "playwright test --headed"',
+      'test:e2e:debug': 'samaro-test "playwright test --debug"',
+      'test:ct': 'samaro-test "playwright test --config playwright.component.config.ts"',
+      'test:ct:ui': 'samaro-test "playwright test --config playwright.component.config.ts --ui"',
+      'allure:generate': 'samaro-allure generate',
+      'allure:open': 'samaro-allure open',
+      'allure:clean': 'samaro-allure clean',
+    };
+    
+    tree.overwrite(packageJsonPath, JSON.stringify(packageJson, null, 2));
+    context.logger.info('✅ Updated package.json scripts');
+    
+    return tree;
+  };
+}
+
+function createConfigFiles(options) {
+  return (tree, context) => {
+    // Create vitest.config.ts
+    tree.create('/vitest.config.ts', `import { createVitestConfig } from 'samaro-uitest/config';
+
+export default createVitestConfig({
+  projectRoot: __dirname,
+  testGlob: 'src/**/*.spec.ts',
+  resultsDir: 'allure-unit-results',
+});
+`);
+    context.logger.info('✅ Created vitest.config.ts');
+
+    // Create playwright.config.ts
+    tree.create('/playwright.config.ts', `import { createPlaywrightConfig } from 'samaro-uitest/config';
+
+export default createPlaywrightConfig({
+  baseURL: 'http://localhost:4200',
+  testDir: './e2e',
+  resultsDir: 'allure-e2e-results',
+  webServerCommand: 'npm run start',
+  webServerPort: 4200,
+});
+`);
+    context.logger.info('✅ Created playwright.config.ts');
+
+    // Create playwright.component.config.ts
+    tree.create('/playwright.component.config.ts', `import { createComponentConfig } from 'samaro-uitest/config';
+
+export default createComponentConfig({
+  baseURL: 'http://localhost:4200',
+  testDir: './ct-tests',
+  resultsDir: 'allure-ct-results',
+});
+`);
+    context.logger.info('✅ Created playwright.component.config.ts');
+
+    // Create test-setup.ts in src if it exists
+    if (tree.exists('/src')) {
+      tree.create('/src/test-setup.ts', `import 'zone.js';
+import 'zone.js/testing';
+import { getTestBed } from '@angular/core/testing';
+import { BrowserDynamicTestingModule, platformBrowserDynamicTesting } from '@angular/platform-browser-dynamic/testing';
+
+getTestBed().initTestEnvironment(
+  BrowserDynamicTestingModule,
+  platformBrowserDynamicTesting()
+);
+`);
+      context.logger.info('✅ Created src/test-setup.ts');
+    }
+
+    return tree;
+  };
+}
+
+function createDirectories() {
+  return (tree, context) => {
+    tree.create('/e2e/.gitkeep', '');
+    tree.create('/e2e/helpers/.gitkeep', '');
+    tree.create('/ct-tests/.gitkeep', '');
+    
+    context.logger.info('✅ Created test directories');
+    
+    return tree;
+  };
+}
+
+module.exports = { ngAdd };

package/schematics/ng-add/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SamaroUItestNgAddSchema",
+  "title": "SamaroUItest ng-add Options Schema",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the project to add SamaroUItest to",
+      "$default": {
+        "$source": "projectName"
+      }
+    },
+    "skipInstall": {
+      "type": "boolean",
+      "default": false,
+      "description": "Skip installing dependencies"
+    },
+    "includeSampleTests": {
+      "type": "boolean",
+      "default": true,
+      "description": "Include sample test files"
+    }
+  },
+  "required": []
+}