@avi770/testteam 1.2.0

package/dist/helpers/env-resolver.js

@@ -0,0 +1,51 @@
+/**
+ * Check whether a URL responds with a non-5xx status within a timeout.
+ * Exported so agents can use it directly without duplicating the function.
+ */
+export async function isUrlReachable(url, timeoutMs = 5000) {
+    try {
+        const response = await fetch(url, {
+            method: 'HEAD',
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        return response.ok || response.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the environment for a given phase with automatic fallback.
+ *
+ * 1. Try the phase's configured environment (`config.environments[phase]`).
+ * 2. If the URL is reachable → return `{ env, fallback: false }`.
+ * 3. If unreachable → try `config.environments['alpha']` (localhost).
+ * 4. If alpha is reachable → return `{ env: alphaEnv, fallback: true }`.
+ * 5. If neither is reachable → return the phase's env with `fallback: false`
+ *    so the agent can decide how to handle the failure.
+ */
+export async function resolveEnvironment(config, phase) {
+    // Phase-specific environment
+    const phaseEnv = config.environments[phase];
+    if (phaseEnv) {
+        const reachable = await isUrlReachable(phaseEnv.baseUrl);
+        if (reachable) {
+            return { env: phaseEnv, fallback: false };
+        }
+    }
+    // Fallback chain: alpha → first available
+    const alphaEnv = config.environments['alpha'];
+    if (alphaEnv && alphaEnv.baseUrl !== phaseEnv?.baseUrl) {
+        const reachable = await isUrlReachable(alphaEnv.baseUrl);
+        if (reachable) {
+            return { env: alphaEnv, fallback: true };
+        }
+    }
+    // Nothing reachable — return phase env (or first available) and let agent handle it
+    const fallbackEnv = phaseEnv ?? Object.values(config.environments)[0];
+    if (!fallbackEnv) {
+        throw new Error(`No environment configured for phase "${phase}"`);
+    }
+    return { env: fallbackEnv, fallback: false };
+}
+//# sourceMappingURL=env-resolver.js.map

package/dist/helpers/env-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-resolver.js","sourceRoot":"","sources":["../../helpers/env-resolver.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,SAAS,GAAG,IAAI;IAChE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAuB,EACvB,KAAY;IAEZ,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,OAAO,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,MAAM,WAAW,GAAG,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}

package/dist/helpers/form-filler.d.ts

@@ -0,0 +1,13 @@
+import type { Page } from 'playwright';
+/**
+ * Generates a valid test value based on the input's name and type attributes.
+ * Handles common field patterns used across the target application.
+ */
+export declare function generateTestValue(inputType: string, inputName: string): string;
+/**
+ * Fills all visible, enabled form inputs within the given form selector.
+ * If testData is provided, uses its values for fields matching the key names;
+ * otherwise auto-generates values using generateTestValue.
+ */
+export declare function fillForm(page: Page, formSelector: string, testData?: Record<string, string>): Promise<void>;
+//# sourceMappingURL=form-filler.d.ts.map

package/dist/helpers/form-filler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-filler.d.ts","sourceRoot":"","sources":["../../helpers/form-filler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA6B9E;AAyCD;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/helpers/form-filler.js

@@ -0,0 +1,98 @@
+/**
+ * Generates a valid test value based on the input's name and type attributes.
+ * Handles common field patterns used across the target application.
+ */
+export function generateTestValue(inputType, inputName) {
+    const nameLower = inputName.toLowerCase();
+    if (nameLower.includes('email')) {
+        const random = Math.random().toString(36).slice(2, 8);
+        return `test-${random}@example.com`;
+    }
+    if (nameLower.includes('phone')) {
+        const digits = Math.floor(Math.random() * 900000 + 100000).toString();
+        return `+61 400 ${digits}`;
+    }
+    if (nameLower.includes('abn')) {
+        return generateValidAbn();
+    }
+    if (nameLower.includes('date')) {
+        const future = new Date();
+        future.setDate(future.getDate() + 30);
+        return future.toISOString().split('T')[0];
+    }
+    if (inputType === 'number') {
+        return '100';
+    }
+    const random = Math.random().toString(36).slice(2, 8);
+    return `Test Value ${random}`;
+}
+/**
+ * Generates a valid 11-digit Australian Business Number (ABN).
+ * Applies the official ABN checksum algorithm.
+ */
+function generateValidAbn() {
+    // ABN weights for digits 1-11
+    const weights = [10, 1, 3, 5, 7, 9, 11, 13, 15, 17, 19];
+    // Generate random 8-digit core (positions 3-10)
+    // We fix the last 8 digits, then solve for digits 1-2
+    for (let attempt = 0; attempt < 100; attempt++) {
+        const digits = new Array(11).fill(0);
+        // Fill digits 3-10 randomly
+        for (let i = 2; i < 11; i++) {
+            digits[i] = Math.floor(Math.random() * 10);
+        }
+        // Try all combinations for digits 1-2 (first digit can't be 0 in reduced form)
+        for (let d1 = 1; d1 <= 9; d1++) {
+            for (let d2 = 0; d2 <= 9; d2++) {
+                digits[0] = d1;
+                digits[1] = d2;
+                // ABN validation: subtract 1 from first digit, sum weighted digits, divisible by 89
+                const checkDigits = [...digits];
+                checkDigits[0] -= 1;
+                const sum = checkDigits.reduce((acc, d, i) => acc + d * weights[i], 0);
+                if (sum % 89 === 0) {
+                    return digits.join('');
+                }
+            }
+        }
+    }
+    // Known valid fallback ABN
+    return '51824753556';
+}
+/**
+ * Fills all visible, enabled form inputs within the given form selector.
+ * If testData is provided, uses its values for fields matching the key names;
+ * otherwise auto-generates values using generateTestValue.
+ */
+export async function fillForm(page, formSelector, testData) {
+    const inputs = await page.$$(`${formSelector} input:not([type="hidden"]):not([type="submit"]):not([type="button"]):not([type="reset"]):not([disabled])`);
+    for (const input of inputs) {
+        const name = (await input.getAttribute('name')) ?? '';
+        const type = (await input.getAttribute('type')) ?? 'text';
+        if (testData && name && Object.prototype.hasOwnProperty.call(testData, name)) {
+            await input.fill(testData[name]);
+            continue;
+        }
+        if (type === 'checkbox' || type === 'radio') {
+            const checked = await input.isChecked();
+            if (!checked) {
+                await input.check();
+            }
+            continue;
+        }
+        const value = generateTestValue(type, name);
+        await input.fill(value);
+    }
+    const textareas = await page.$$(`${formSelector} textarea:not([disabled])`);
+    for (const textarea of textareas) {
+        const name = (await textarea.getAttribute('name')) ?? '';
+        if (testData && name && Object.prototype.hasOwnProperty.call(testData, name)) {
+            await textarea.fill(testData[name]);
+        }
+        else {
+            const random = Math.random().toString(36).slice(2, 8);
+            await textarea.fill(`Test textarea value ${random}`);
+        }
+    }
+}
+//# sourceMappingURL=form-filler.js.map

package/dist/helpers/form-filler.js.map

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

package/dist/helpers/modal-handler.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from 'playwright';
+/**
+ * Clicks the trigger element and waits for a modal/dialog to become visible.
+ * Returns true if a modal is detected within 5 seconds; false otherwise.
+ */
+export declare function openModal(page: Page, triggerSelector: string): Promise<boolean>;
+/**
+ * Closes the currently open modal using the specified method.
+ * Returns true if the modal is no longer visible after the action; false otherwise.
+ */
+export declare function closeModal(page: Page, method: 'x-button' | 'escape' | 'overlay'): Promise<boolean>;
+/**
+ * Returns true if any recognised modal or dialog element is currently visible.
+ */
+export declare function isModalOpen(page: Page): Promise<boolean>;
+//# sourceMappingURL=modal-handler.d.ts.map

package/dist/helpers/modal-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-handler.d.ts","sourceRoot":"","sources":["../../helpers/modal-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA8BvC;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAarF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GACxC,OAAO,CAAC,OAAO,CAAC,CAiClB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAa9D"}

package/dist/helpers/modal-handler.js

@@ -0,0 +1,95 @@
+/** CSS selectors used to detect an open modal or dialog. */
+const MODAL_SELECTORS = [
+    '[role="dialog"]',
+    '[role="alertdialog"]',
+    '.modal',
+    '[data-modal]',
+    '[data-testid="modal"]',
+];
+/** CSS selectors used to locate the close (×) button inside a modal. */
+const CLOSE_BUTTON_SELECTORS = [
+    '[aria-label="Close"]',
+    '[aria-label="close"]',
+    '[data-testid="modal-close"]',
+    'button.modal-close',
+    'button[class*="close"]',
+    '[role="dialog"] button:first-of-type',
+];
+/** CSS selectors for the overlay/backdrop behind a modal. */
+const OVERLAY_SELECTORS = [
+    '[data-testid="modal-overlay"]',
+    '.modal-overlay',
+    '.modal-backdrop',
+    '[class*="overlay"]',
+    '[class*="backdrop"]',
+];
+/**
+ * Clicks the trigger element and waits for a modal/dialog to become visible.
+ * Returns true if a modal is detected within 5 seconds; false otherwise.
+ */
+export async function openModal(page, triggerSelector) {
+    await page.click(triggerSelector);
+    for (const selector of MODAL_SELECTORS) {
+        try {
+            await page.waitForSelector(selector, { state: 'visible', timeout: 5000 });
+            return true;
+        }
+        catch {
+            // Selector not found — try the next candidate
+        }
+    }
+    return false;
+}
+/**
+ * Closes the currently open modal using the specified method.
+ * Returns true if the modal is no longer visible after the action; false otherwise.
+ */
+export async function closeModal(page, method) {
+    switch (method) {
+        case 'x-button': {
+            for (const selector of CLOSE_BUTTON_SELECTORS) {
+                const button = page.locator(selector);
+                if (await button.isVisible().catch(() => false)) {
+                    await button.click();
+                    break;
+                }
+            }
+            break;
+        }
+        case 'escape': {
+            await page.keyboard.press('Escape');
+            break;
+        }
+        case 'overlay': {
+            for (const selector of OVERLAY_SELECTORS) {
+                const overlay = page.locator(selector);
+                if (await overlay.isVisible().catch(() => false)) {
+                    await overlay.click({ position: { x: 1, y: 1 } });
+                    break;
+                }
+            }
+            break;
+        }
+    }
+    // Give the DOM a moment to react then verify the modal is gone
+    await page.waitForTimeout(300);
+    return !(await isModalOpen(page));
+}
+/**
+ * Returns true if any recognised modal or dialog element is currently visible.
+ */
+export async function isModalOpen(page) {
+    for (const selector of MODAL_SELECTORS) {
+        try {
+            const locator = page.locator(selector);
+            if (await locator.isVisible()) {
+                return true;
+            }
+        }
+        catch {
+            // Element not present — continue checking
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=modal-handler.js.map

package/dist/helpers/modal-handler.js.map

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

package/dist/helpers/navigation.d.ts

@@ -0,0 +1,37 @@
+import type { Page } from 'playwright';
+/**
+ * Navigate to `loginUrl`, fill the email and password inputs, submit the form,
+ * and wait for the browser to navigate away from the login page.
+ */
+export declare function login(page: Page, credentials: {
+    email: string;
+    password: string;
+}, loginUrl: string): Promise<void>;
+/**
+ * Resolve `moduleId` to its route via `config.modules`, navigate to that route,
+ * and wait for the section's lazy-loaded content to appear.
+ *
+ * @throws {Error} when `moduleId` is not found in `config.modules`.
+ */
+export declare function navigateToSection(page: Page, moduleId: string, config: {
+    modules: Array<{
+        id: string;
+        route: string;
+    }>;
+}): Promise<void>;
+/**
+ * Wait for all React Suspense loading fallbacks (spinners, skeletons) to
+ * disappear, indicating that lazy-loaded section content has fully rendered.
+ *
+ * @param timeout Maximum time in milliseconds to wait (default: 10 000 ms).
+ */
+export declare function waitForSectionLoad(page: Page, timeout?: number): Promise<void>;
+/**
+ * Switch between the bookkeeper portal and the client portal by manipulating
+ * the `portal` query-string parameter on the current page URL.
+ *
+ * @param portalQueryParam Pass `"client"` (or any portal slug) to set
+ *   `?portal=<value>`, or `null` to remove the query parameter entirely.
+ */
+export declare function switchPortal(page: Page, portalQueryParam: string | null): Promise<void>;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/helpers/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../helpers/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAiBvC;;;GAGG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,IAAI,EACV,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAChD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GACxD,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,SAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrG;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7F"}

package/dist/helpers/navigation.js

@@ -0,0 +1,83 @@
+/** Default milliseconds to wait for all loading indicators to disappear. */
+const DEFAULT_WAIT_TIMEOUT_MS = 10_000;
+/**
+ * Selectors that represent loading / skeleton states produced by React Suspense
+ * fallback components. All must be absent before `waitForSectionLoad` resolves.
+ */
+const LOADING_SELECTORS = [
+    '[aria-label="Loading"]',
+    '[data-testid="loading-spinner"]',
+    '[data-testid="skeleton"]',
+    '.loading-spinner',
+    '.skeleton',
+];
+/**
+ * Navigate to `loginUrl`, fill the email and password inputs, submit the form,
+ * and wait for the browser to navigate away from the login page.
+ */
+export async function login(page, credentials, loginUrl) {
+    await page.goto(loginUrl, { waitUntil: 'domcontentloaded', timeout: 10000 });
+    await page.fill('input[type="email"], input[name="email"], #login-email', credentials.email);
+    await page.fill('input[type="password"], input[name="password"], #login-password', credentials.password);
+    // Use Promise.race — SPAs may not trigger a traditional navigation after login
+    await Promise.all([
+        page.waitForURL((url) => !url.toString().includes('/login'), { timeout: 10000 }).catch(() => {
+            // SPA fallback: wait for the login form to disappear
+            return page.waitForSelector('input[type="email"], #login-email', { state: 'hidden', timeout: 5000 }).catch(() => {
+                // Graceful return — login may have failed (wrong credentials, no API)
+                // Caller should check page URL to determine if login succeeded
+            });
+        }),
+        page.click('button[type="submit"]'),
+    ]);
+}
+/**
+ * Resolve `moduleId` to its route via `config.modules`, navigate to that route,
+ * and wait for the section's lazy-loaded content to appear.
+ *
+ * @throws {Error} when `moduleId` is not found in `config.modules`.
+ */
+export async function navigateToSection(page, moduleId, config) {
+    const module = config.modules.find((m) => m.id === moduleId);
+    if (module === undefined) {
+        throw new Error(`navigateToSection: moduleId "${moduleId}" not found in config. ` +
+            `Available ids: [${config.modules.map((m) => m.id).join(', ')}]`);
+    }
+    // Resolve relative routes against the current page origin
+    const currentUrl = page.url();
+    const origin = currentUrl.startsWith('http') ? new URL(currentUrl).origin : '';
+    const fullUrl = module.route.startsWith('http') ? module.route : `${origin}${module.route}`;
+    await page.goto(fullUrl);
+    await waitForSectionLoad(page);
+}
+/**
+ * Wait for all React Suspense loading fallbacks (spinners, skeletons) to
+ * disappear, indicating that lazy-loaded section content has fully rendered.
+ *
+ * @param timeout Maximum time in milliseconds to wait (default: 10 000 ms).
+ */
+export async function waitForSectionLoad(page, timeout = DEFAULT_WAIT_TIMEOUT_MS) {
+    for (const selector of LOADING_SELECTORS) {
+        // waitForSelector with state "hidden" resolves immediately if the element
+        // is already absent, so this is safe even when the spinner never appears.
+        await page.waitForSelector(selector, { state: 'hidden', timeout });
+    }
+}
+/**
+ * Switch between the bookkeeper portal and the client portal by manipulating
+ * the `portal` query-string parameter on the current page URL.
+ *
+ * @param portalQueryParam Pass `"client"` (or any portal slug) to set
+ *   `?portal=<value>`, or `null` to remove the query parameter entirely.
+ */
+export async function switchPortal(page, portalQueryParam) {
+    const currentUrl = new URL(page.url());
+    if (portalQueryParam === null) {
+        currentUrl.searchParams.delete('portal');
+    }
+    else {
+        currentUrl.searchParams.set('portal', portalQueryParam);
+    }
+    await page.goto(currentUrl.toString());
+}
+//# sourceMappingURL=navigation.js.map

package/dist/helpers/navigation.js.map

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

package/dist/helpers/quality-gate.d.ts

@@ -0,0 +1,17 @@
+export interface QualityViolation {
+    rule: string;
+    message: string;
+    line?: number;
+    severity: 'error' | 'warning';
+}
+/**
+ * Validates the given source code content against AVI-OS coding quality rules.
+ * Returns an array of QualityViolation objects; an empty array means the code
+ * passes all checks.
+ */
+export declare function validateCodeQuality(fileContent: string, filePath: string): QualityViolation[];
+/**
+ * Reads a file from disk and runs validateCodeQuality on its contents.
+ */
+export declare function runQualityGate(filePath: string): QualityViolation[];
+//# sourceMappingURL=quality-gate.d.ts.map

package/dist/helpers/quality-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../helpers/quality-gate.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAiJD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAWpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAGnE"}

package/dist/helpers/quality-gate.js

@@ -0,0 +1,144 @@
+import { readFileSync } from 'fs';
+// Matches `: any` type annotations
+const ANY_TYPE_PATTERN = /:\s*any\b/;
+// Matches function declarations and arrow functions that open a block body on the same line
+const FUNCTION_START_PATTERN = /(?:function\s+\w+\s*\([^)]*\)\s*\{|(?:\([^)]*\)|\w+)\s*=>\s*\{)/;
+// Matches hardcoded secret assignments with literal string values
+const HARDCODED_SECRET_PATTERN = /(?:password|secret|apiKey|api_key|token)\s*=\s*['"][^'"]+['"]/i;
+// Matches lines that safely read from process.env
+const PROCESS_ENV_PATTERN = /process\.env\./;
+// Maximum lines allowed inside a single function body before a violation is raised
+const MAX_FUNCTION_LINES = 30;
+// Maximum brace-nesting depth before a violation is raised
+const MAX_NESTING_DEPTH = 3;
+function isCommentLine(line) {
+    const trimmed = line.trim();
+    return (trimmed.startsWith('//') ||
+        trimmed.startsWith('*') ||
+        trimmed.startsWith('/*'));
+}
+function checkAnyType(lines) {
+    const violations = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (isCommentLine(line))
+            continue;
+        // Strip string literals to avoid false positives from values containing "any"
+        const stripped = line.replace(/(['"`])(?:(?!\1)[^\\]|\\.)*\1/g, '""');
+        if (ANY_TYPE_PATTERN.test(stripped)) {
+            violations.push({
+                rule: 'no-any',
+                message: `Avoid \`any\` type — use explicit types to preserve TypeScript safety (line ${i + 1}).`,
+                line: i + 1,
+                severity: 'error',
+            });
+        }
+    }
+    return violations;
+}
+function checkLongFunctions(lines) {
+    const violations = [];
+    // Stack entries: { startLine (0-based), braceDepthAtStart }
+    const stack = [];
+    let braceDepth = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const opens = (line.match(/\{/g) ?? []).length;
+        const closes = (line.match(/\}/g) ?? []).length;
+        if (FUNCTION_START_PATTERN.test(line)) {
+            // Record function start; its body starts at the `{` on this line, so the
+            // depth before processing this line's braces is `braceDepth`.
+            stack.push({ startLine: i, braceDepthAtStart: braceDepth });
+        }
+        braceDepth += opens - closes;
+        // Pop any functions whose body just closed (depth returned to start level)
+        while (stack.length > 0) {
+            const top = stack[stack.length - 1];
+            if (braceDepth <= top.braceDepthAtStart) {
+                const functionLineCount = i - top.startLine + 1;
+                if (functionLineCount > MAX_FUNCTION_LINES) {
+                    violations.push({
+                        rule: 'max-function-lines',
+                        message: `Function starting at line ${top.startLine + 1} is ${functionLineCount} lines long ` +
+                            `— keep functions under ${MAX_FUNCTION_LINES + 1} lines.`,
+                        line: top.startLine + 1,
+                        severity: 'warning',
+                    });
+                }
+                stack.pop();
+            }
+            else {
+                break;
+            }
+        }
+    }
+    return violations;
+}
+function checkHardcodedSecrets(lines) {
+    const violations = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (isCommentLine(line))
+            continue;
+        if (PROCESS_ENV_PATTERN.test(line))
+            continue;
+        if (HARDCODED_SECRET_PATTERN.test(line)) {
+            violations.push({
+                rule: 'no-hardcoded-secrets',
+                message: `Hardcoded secret detected at line ${i + 1} — use environment variables instead.`,
+                line: i + 1,
+                severity: 'error',
+            });
+        }
+    }
+    return violations;
+}
+function checkDeepNesting(lines) {
+    const violations = [];
+    let depth = 0;
+    let violationActive = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const opens = (line.match(/\{/g) ?? []).length;
+        const closes = (line.match(/\}/g) ?? []).length;
+        depth += opens - closes;
+        if (depth > MAX_NESTING_DEPTH && !violationActive) {
+            violations.push({
+                rule: 'max-nesting-depth',
+                message: `Nesting depth exceeds ${MAX_NESTING_DEPTH} levels at line ${i + 1} ` +
+                    `— refactor to reduce complexity.`,
+                line: i + 1,
+                severity: 'warning',
+            });
+            violationActive = true;
+        }
+        if (depth <= MAX_NESTING_DEPTH) {
+            violationActive = false;
+        }
+    }
+    return violations;
+}
+/**
+ * Validates the given source code content against AVI-OS coding quality rules.
+ * Returns an array of QualityViolation objects; an empty array means the code
+ * passes all checks.
+ */
+export function validateCodeQuality(fileContent, filePath) {
+    // filePath is available for future rule extensions (e.g. path-based exclusions)
+    void filePath;
+    const lines = fileContent.split('\n');
+    return [
+        ...checkAnyType(lines),
+        ...checkHardcodedSecrets(lines),
+        ...checkLongFunctions(lines),
+        ...checkDeepNesting(lines),
+    ];
+}
+/**
+ * Reads a file from disk and runs validateCodeQuality on its contents.
+ */
+export function runQualityGate(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    return validateCodeQuality(content, filePath);
+}
+//# sourceMappingURL=quality-gate.js.map

package/dist/helpers/quality-gate.js.map

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

package/dist/helpers/screenshot.d.ts

@@ -0,0 +1,24 @@
+import type { Page } from 'playwright';
+export interface ScreenshotCompareResult {
+    match: boolean;
+    diffPercentage: number;
+    diffPath?: string;
+}
+/**
+ * Captures a screenshot of the current page state and saves it to outputDir.
+ * Returns the absolute file path of the saved screenshot.
+ */
+export declare function captureScreenshot(page: Page, name: string, outputDir: string): Promise<string>;
+/**
+ * Compares two PNG screenshots using pixelmatch.
+ * Returns match=true when the diff percentage is at or below the threshold.
+ * Default threshold: 0.1 (0.1% pixel difference).
+ * Writes a diff PNG alongside the current screenshot when images differ.
+ */
+export declare function compareScreenshots(currentPath: string, baselinePath: string, threshold?: number): Promise<ScreenshotCompareResult>;
+/**
+ * Copies the current screenshot to the baseline directory, establishing it
+ * as the new reference image. Returns the path of the new baseline file.
+ */
+export declare function updateBaseline(currentPath: string, baselineDir: string): Promise<string>;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/helpers/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../helpers/screenshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,SAAM,GACd,OAAO,CAAC,uBAAuB,CAAC,CAyClC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAYjB"}