@iblai/mcp 1.0.0 → 1.1.3

package/dist/resources/guides-layout.js

@@ -62,7 +62,7 @@ export function StoreProvider({ children }) {
 // providers/index.tsx
 'use client';
 
-import { AuthProvider, TenantProvider } from '@iblai/web-utils';
+import { AuthProvider, TenantProvider } from '@iblai/iblai-js/web-utils';
 import { getTenant, getUsername, redirectToAuthSpa } from '@/lib/utils';
 
 export function Providers({ children }) {
@@ -94,7 +94,7 @@ export function Providers({ children }) {
 'use client';
 
 import { ThemeProvider } from 'next-themes';
-import { Toaster } from '@iblai/web-containers';
+import { Toaster } from '@iblai/iblai-js/web-containers';
 
 export function ClientLayout({ children }) {
   return (
@@ -139,7 +139,7 @@ export function AppLayout({ children }) {
 ### For Mentor App with Sidebar
 
 \`\`\`typescript
-import { SidebarProvider, SidebarInset } from '@iblai/web-containers';
+import { SidebarProvider, SidebarInset } from '@iblai/iblai-js/web-containers';
 
 <SidebarProvider>
   <AppSidebar />
@@ -206,7 +206,7 @@ app/
 
 \`\`\`typescript
 // app/dashboard/loading.tsx
-import { Skeleton } from '@iblai/web-containers';
+import { Skeleton } from '@iblai/iblai-js/web-containers';
 
 export default function Loading() {
   return (
@@ -224,7 +224,7 @@ export default function Loading() {
 // app/error.tsx
 'use client';
 
-import { ClientErrorPage } from '@iblai/web-containers/next';
+import { ClientErrorPage } from '@iblai/iblai-js/web-containers/next';
 
 export default function Error({ error, reset }) {
   return <ClientErrorPage error={error} reset={reset} />;

package/dist/resources/guides-playwright.d.ts

@@ -0,0 +1,8 @@
+export declare const guidesPlaywright: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    content: string;
+};
+//# sourceMappingURL=guides-playwright.d.ts.map

package/dist/resources/guides-playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides-playwright.d.ts","sourceRoot":"","sources":["../../src/resources/guides-playwright.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;CA0O5B,CAAC"}

package/dist/resources/guides-playwright.js

@@ -0,0 +1,235 @@
+export const guidesPlaywright = {
+    uri: 'ibl://guides/playwright',
+    name: 'Playwright E2E Testing Guide',
+    description: 'Step-by-step guide for setting up Playwright E2E tests in IBL.ai apps using @iblai/iblai-js/playwright',
+    mimeType: 'text/markdown',
+    content: `# Playwright E2E Testing Guide
+
+## 1. Prerequisites
+
+Install required dev dependencies:
+
+\`\`\`bash
+pnpm add -D @iblai/iblai-js @playwright/test @axe-core/playwright dotenv cross-env
+\`\`\`
+
+Install Playwright browsers:
+
+\`\`\`bash
+npx playwright install
+\`\`\`
+
+## 2. Directory Structure
+
+\`\`\`
+e2e/
+├── playwright.config.ts     # Uses createPlaywrightConfig()
+├── auth.setup.ts            # Uses createAuthSetup()
+├── custom-reporter.ts       # Re-exports CustomReporter from SDK
+├── .env.development         # Environment variables
+├── tests/
+│   ├── utils.ts             # App-specific env var exports
+│   ├── helpers.ts           # App-specific auth/login helpers
+│   ├── shared.ts            # Shared test helpers (re-exports from SDK)
+│   └── <feature>/           # Test spec files by feature
+└── utils/                   # App-specific helper modules
+\`\`\`
+
+## 3. Playwright Config
+
+Use \`createPlaywrightConfig()\` from the SDK to generate a full Playwright configuration:
+
+\`\`\`typescript
+// e2e/playwright.config.ts
+import { createPlaywrightConfig } from '@iblai/iblai-js/playwright';
+import dotenv from 'dotenv';
+import path from 'path';
+
+dotenv.config({ path: path.resolve(__dirname, '.env.development') });
+
+export default createPlaywrightConfig({
+  platforms: [
+    {
+      name: 'mentornextjs',
+      dependencies: ['setup'],
+      otherTestMatch: ['**mentornextjs/*/*.spec.ts'],
+    },
+  ],
+});
+\`\`\`
+
+### What this generates
+
+- **Auth setup projects** per browser: \`setup-chrome\`, \`setup-firefox\`, \`setup-safari\`, \`setup-edge\`. Each runs \`auth.setup.ts\` to authenticate and save storage state.
+- **Test projects** for each platform x browser combination (e.g. \`mentornextjs-desktop-chrome\`, \`mentornextjs-desktop-firefox\`, etc.).
+- **Default devices**: Desktop Chrome, Firefox, Safari, Edge.
+- **CI settings** (auto-detected via \`process.env.CI\`): \`retries=3\`, \`workers=1\`, \`headless=true\`, \`trace=retain-on-failure\`.
+- **Local settings**: \`retries=0\`, \`workers=undefined\` (Playwright default parallelism).
+
+## 4. Auth Setup
+
+Use \`createAuthSetup()\` to authenticate once per browser and persist storage state:
+
+\`\`\`typescript
+// e2e/auth.setup.ts
+import { test as setup, createAuthSetup } from '@iblai/iblai-js/playwright';
+
+setup(
+  'authenticate',
+  createAuthSetup({
+    hostUrl: process.env.MENTOR_NEXTJS_HOST || '',
+    authHost: process.env.AUTH_HOST || '',
+    appName: 'mentor',
+    postLoginUrlMatcher: (url) => url.href.includes('/platform/'),
+  }),
+);
+\`\`\`
+
+### How it works
+
+- Authenticates once per browser and saves storage state to \`playwright/.auth/user-{browser}.json\`.
+- Supports per-browser credentials via environment variables: \`PLAYWRIGHT_USERNAME_CHROME\`, \`PLAYWRIGHT_PASSWORD_CHROME\`, etc. Falls back to \`PLAYWRIGHT_USERNAME\` / \`PLAYWRIGHT_PASSWORD\`.
+- The \`postLoginUrlMatcher\` function is used to wait until the app has fully loaded after login.
+
+### Auth flow options
+
+Set the \`AUTH_FLOW\` environment variable to control the authentication strategy:
+
+| Flow | Description |
+|------|-------------|
+| \`username_password\` | **Default.** Standard email + password form login. |
+| \`magic_link\` | Email-only login with Mailsac email verification. Requires \`MAILSAC_API_KEY\`. |
+| \`sso\` | Platform SSO via an identity provider. Requires \`AUTH_IDP\`. |
+| \`direct_sso\` | Client-specific SSO (e.g., Microsoft). Requires \`AUTH_IDP\`. |
+
+## 5. Custom Reporter
+
+Re-export the SDK's custom reporter so Playwright can resolve it locally:
+
+\`\`\`typescript
+// e2e/custom-reporter.ts
+export { CustomReporter as default } from '@iblai/iblai-js/playwright';
+\`\`\`
+
+The custom reporter provides structured JSON output suitable for CI pipelines and test result dashboards.
+
+## 6. Environment Variables
+
+Create an \`.env.development\` file in the \`e2e/\` directory:
+
+\`\`\`
+SKILLS_HOST=https://skills.example.com
+MENTOR_NEXTJS_HOST=https://mentor.example.com
+AUTH_HOST=https://auth.example.com
+PLAYWRIGHT_USERNAME=test@example.com
+PLAYWRIGHT_PASSWORD=testpassword
+AUTH_FLOW=username_password
+AUTH_IDP=
+\`\`\`
+
+### Full environment variable reference
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| \`SKILLS_HOST\` | Base URL for the Skills app | Per app |
+| \`MENTOR_NEXTJS_HOST\` | Base URL for the Mentor app | Per app |
+| \`AUTH_HOST\` | Base URL for the Auth app | Yes |
+| \`PLAYWRIGHT_USERNAME\` | Default test user email | Yes |
+| \`PLAYWRIGHT_PASSWORD\` | Default test user password | Yes |
+| \`PLAYWRIGHT_USERNAME_CHROME\` | Per-browser username override | No |
+| \`PLAYWRIGHT_PASSWORD_CHROME\` | Per-browser password override | No |
+| \`PLAYWRIGHT_USERNAME_FIREFOX\` | Per-browser username override | No |
+| \`PLAYWRIGHT_PASSWORD_FIREFOX\` | Per-browser password override | No |
+| \`PLAYWRIGHT_USERNAME_SAFARI\` | Per-browser username override | No |
+| \`PLAYWRIGHT_PASSWORD_SAFARI\` | Per-browser password override | No |
+| \`PLAYWRIGHT_USERNAME_EDGE\` | Per-browser username override | No |
+| \`PLAYWRIGHT_PASSWORD_EDGE\` | Per-browser password override | No |
+| \`AUTH_FLOW\` | Auth strategy: \`username_password\`, \`magic_link\`, \`sso\`, \`direct_sso\` | No (defaults to \`username_password\`) |
+| \`AUTH_IDP\` | Identity provider name for SSO flows | Only for SSO flows |
+| \`MAILSAC_API_KEY\` | Mailsac API key for magic link flow | Only for \`magic_link\` |
+
+## 7. Writing a Test
+
+\`\`\`typescript
+import { test, expect } from '@playwright/test';
+import { logger, safeWaitForURL } from '@iblai/iblai-js/playwright';
+import { waitForPageReady, reliableClick } from '@iblai/iblai-js/playwright';
+import { MENTOR_NEXTJS_HOST } from '../utils';
+
+test.describe('Feature Name', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto(MENTOR_NEXTJS_HOST);
+    await waitForPageReady(page);
+  });
+
+  test('should do something', async ({ page }) => {
+    await reliableClick(page, page.getByRole('button', { name: 'Submit' }));
+    await safeWaitForURL(page, (url) => url.pathname.includes('/success'));
+    await expect(page.getByText('Success')).toBeVisible();
+  });
+});
+\`\`\`
+
+### Key patterns
+
+- **Import \`test\` and \`expect\` from \`@playwright/test\` directly** — do not re-import from the SDK.
+- **Import utilities from \`@iblai/iblai-js/playwright\`** — this includes \`waitForPageReady\`, \`reliableClick\`, \`reliableFill\`, \`safeWaitForURL\`, \`logger\`, and more.
+- **Use \`waitForPageReady(page)\` after navigation** — waits for network idle and DOM stability.
+- **Use \`reliableClick(page, locator)\` and \`reliableFill(page, locator, value)\`** — these retry interactions and handle flaky element states (detached, covered, etc.).
+- **Use \`safeWaitForURL(page, matcher)\` instead of \`page.waitForURL()\`** — handles browser-specific URL timing quirks.
+- **Use \`logger\` for structured logging** — integrates with the custom reporter for better debugging output.
+
+## 8. Running Tests
+
+\`\`\`bash
+# Run all tests
+pnpm test:e2e
+
+# UI mode
+pnpm test:e2e:ui
+
+# Headed mode
+pnpm test:e2e:headed
+
+# Specific test file
+npx playwright test --config e2e/playwright.config.ts e2e/tests/feature/test.spec.ts
+
+# Specific browser
+npx playwright test --config e2e/playwright.config.ts --project='mentornextjs-desktop-chrome'
+\`\`\`
+
+### package.json scripts
+
+Add these scripts to your app's \`package.json\`:
+
+\`\`\`json
+{
+  "scripts": {
+    "test:e2e": "cross-env CI=true npx playwright test --config e2e/playwright.config.ts",
+    "test:e2e:ui": "npx playwright test --config e2e/playwright.config.ts --ui",
+    "test:e2e:headed": "npx playwright test --config e2e/playwright.config.ts --headed"
+  }
+}
+\`\`\`
+
+## 9. Accessibility Testing
+
+Use the \`expectNoAccessibilityViolations\` helper (powered by axe-core) to check for WCAG violations:
+
+\`\`\`typescript
+import { test, expect } from '@playwright/test';
+import { expectNoAccessibilityViolations } from '@iblai/iblai-js/playwright';
+import { waitForPageReady } from '@iblai/iblai-js/playwright';
+import { MENTOR_NEXTJS_HOST } from '../utils';
+
+test('page should be accessible', async ({ page }) => {
+  await page.goto(MENTOR_NEXTJS_HOST);
+  await waitForPageReady(page);
+  await expectNoAccessibilityViolations(page);
+});
+\`\`\`
+
+This runs an axe-core accessibility scan against the current page and fails the test if any violations are found. It checks WCAG 2.1 AA compliance by default.
+`,
+};
+//# sourceMappingURL=guides-playwright.js.map

package/dist/resources/guides-playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides-playwright.js","sourceRoot":"","sources":["../../src/resources/guides-playwright.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,yBAAyB;IAC9B,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,wGAAwG;IAC1G,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmOV;CACA,CAAC"}

package/dist/resources/guides-rbac.js

@@ -58,7 +58,7 @@ export default rbacSlice.reducer;
 
 \`\`\`typescript
 // hoc/withPermissions.tsx
-import { WithPermissions as BaseWithPermissions, checkRbacPermission } from '@iblai/web-utils';
+import { WithPermissions as BaseWithPermissions, checkRbacPermission } from '@iblai/iblai-js/web-utils';
 import { useAppSelector } from '@/lib/hooks';
 import { selectRbacPermissions } from '@/features/rbac';
 import { config } from '@/lib/config';
@@ -132,7 +132,7 @@ function NavBar() {
 ### Programmatic Permission Check
 
 \`\`\`typescript
-import { checkRbacPermission } from '@iblai/web-utils';
+import { checkRbacPermission } from '@iblai/iblai-js/web-utils';
 import { useAppSelector } from '@/lib/hooks';
 import { selectRbacPermissions } from '@/features/rbac';
 

package/dist/resources/guides-theme.js

@@ -11,7 +11,7 @@ Import the base theme in your app:
 
 \`\`\`typescript
 // In your root layout or global CSS
-import '@iblai/web-containers/styles/base.css';
+import '@iblai/iblai-js/web-containers/styles/base.css';
 \`\`\`
 
 ## Theme Variables
@@ -95,7 +95,7 @@ export function ClientLayout({ children }) {
 \`\`\`typescript
 import { useTheme } from 'next-themes';
 import { Sun, Moon } from 'lucide-react';
-import { Button } from '@iblai/web-containers';
+import { Button } from '@iblai/iblai-js/web-containers';
 
 export function ThemeToggle() {
   const { theme, setTheme } = useTheme();
@@ -134,7 +134,7 @@ useEffect(() => {
 ## Button Variants
 
 \`\`\`typescript
-import { Button } from '@iblai/web-containers';
+import { Button } from '@iblai/iblai-js/web-containers';
 
 // Available variants
 <Button variant="default">Primary</Button>
@@ -154,7 +154,7 @@ import { Button } from '@iblai/web-containers';
 ## Class Merging Utility
 
 \`\`\`typescript
-import { cn } from '@iblai/web-containers';
+import { cn } from '@iblai/iblai-js/web-containers';
 
 // Merge classes with conflict resolution
 <div className={cn(

package/dist/resources/index.d.ts

@@ -1,10 +1,12 @@
 import { packagesOverview } from './packages-overview.js';
+import { packagesPlaywright } from './packages-playwright.js';
 import { webContainers } from './web-containers.js';
 import { webUtils } from './web-utils.js';
 import { dataLayer } from './data-layer.js';
 import { guidesLayout } from './guides-layout.js';
 import { guidesRbac } from './guides-rbac.js';
 import { guidesTheme } from './guides-theme.js';
+import { guidesPlaywright } from './guides-playwright.js';
 export interface Resource {
     uri: string;
     name: string;
@@ -13,5 +15,5 @@ export interface Resource {
     content: string;
 }
 export declare const RESOURCES: Record<string, Resource>;
-export { packagesOverview, webContainers, webUtils, dataLayer, guidesLayout, guidesRbac, guidesTheme, };
+export { packagesOverview, packagesPlaywright, webContainers, webUtils, dataLayer, guidesLayout, guidesRbac, guidesTheme, guidesPlaywright, };
 //# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAQ9C,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAU9C,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,CAAC"}

package/dist/resources/index.js

@@ -1,18 +1,22 @@
 import { packagesOverview } from './packages-overview.js';
+import { packagesPlaywright } from './packages-playwright.js';
 import { webContainers } from './web-containers.js';
 import { webUtils } from './web-utils.js';
 import { dataLayer } from './data-layer.js';
 import { guidesLayout } from './guides-layout.js';
 import { guidesRbac } from './guides-rbac.js';
 import { guidesTheme } from './guides-theme.js';
+import { guidesPlaywright } from './guides-playwright.js';
 export const RESOURCES = {
     [packagesOverview.uri]: packagesOverview,
+    [packagesPlaywright.uri]: packagesPlaywright,
     [webContainers.uri]: webContainers,
     [webUtils.uri]: webUtils,
     [dataLayer.uri]: dataLayer,
     [guidesLayout.uri]: guidesLayout,
     [guidesRbac.uri]: guidesRbac,
     [guidesTheme.uri]: guidesTheme,
+    [guidesPlaywright.uri]: guidesPlaywright,
 };
-export { packagesOverview, webContainers, webUtils, dataLayer, guidesLayout, guidesRbac, guidesTheme, };
+export { packagesOverview, packagesPlaywright, webContainers, webUtils, dataLayer, guidesLayout, guidesRbac, guidesTheme, guidesPlaywright, };
 //# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD,MAAM,CAAC,MAAM,SAAS,GAA6B;IACjD,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,gBAAgB;IACxC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,aAAa;IAClC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ;IACxB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS;IAC1B,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,YAAY;IAChC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU;IAC5B,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW;CAC/B,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU1D,MAAM,CAAC,MAAM,SAAS,GAA6B;IACjD,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,gBAAgB;IACxC,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,kBAAkB;IAC5C,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,aAAa;IAClC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ;IACxB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS;IAC1B,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,YAAY;IAChC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU;IAC5B,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW;IAC9B,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,gBAAgB;CACzC,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,CAAC"}

package/dist/resources/packages-overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packages-overview.d.ts","sourceRoot":"","sources":["../../src/resources/packages-overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;CAmD5B,CAAC"}
+{"version":3,"file":"packages-overview.d.ts","sourceRoot":"","sources":["../../src/resources/packages-overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;CAyD5B,CAAC"}

package/dist/resources/packages-overview.js

@@ -19,25 +19,31 @@ ibl-frontend/
 │   ├── data-layer/          # Redux store, RTK Query APIs
 │   ├── web-containers/      # Shared React components (Radix UI)
 │   ├── web-utils/           # Authentication, providers, hooks
+│   ├── iblai-js/            # Unified SDK wrapper (@iblai/iblai-js)
+│   │   └── src/playwright/  # Shared E2E test utilities subpath
 │   ├── api-ai/              # Generated AI API client
 │   ├── api-core/            # Generated Core API client
 │   └── api-ai-plus/         # Generated AI Plus API client
-└── playwright/              # E2E test suite
+└── playwright/              # E2E test suite (legacy, migrating to per-app repos)
 \`\`\`
 
 ## Package Import Patterns
 
 \`\`\`typescript
 // Data Layer - Redux and RTK Query
-import { useGetMentorSettingsQuery, mentorReducer } from '@iblai/data-layer';
+import { useGetMentorSettingsQuery, mentorReducer } from '@iblai/iblai-js/data-layer';
 
 // Web Containers - UI Components
-import { Button, Card, Dialog } from '@iblai/web-containers';
-import { Profile, NotificationDropdown } from '@iblai/web-containers';
+import { Button, Card, Dialog } from '@iblai/iblai-js/web-containers';
+import { Profile, NotificationDropdown } from '@iblai/iblai-js/web-containers';
 
 // Web Utils - Providers and Hooks
-import { AuthProvider, TenantProvider, MentorProvider } from '@iblai/web-utils';
-import { useAdvancedChat, useMentorSettings } from '@iblai/web-utils';
+import { AuthProvider, TenantProvider, MentorProvider } from '@iblai/iblai-js/web-utils';
+import { useAdvancedChat, useMentorSettings } from '@iblai/iblai-js/web-utils';
+
+// iblai-js SDK - Playwright E2E test utilities
+import { createPlaywrightConfig, createAuthSetup } from '@iblai/iblai-js/playwright';
+import { reliableClick, safeWaitForURL, waitForPageReady } from '@iblai/iblai-js/playwright';
 \`\`\`
 
 ## Key Technologies

package/dist/resources/packages-overview.js.map

@@ -1 +1 @@
-{"version":3,"file":"packages-overview.js","sourceRoot":"","sources":["../../src/resources/packages-overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,yBAAyB;IAC9B,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,8DAA8D;IAC3E,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CV;CACA,CAAC"}
+{"version":3,"file":"packages-overview.js","sourceRoot":"","sources":["../../src/resources/packages-overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,yBAAyB;IAC9B,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,8DAA8D;IAC3E,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDV;CACA,CAAC"}

package/dist/resources/packages-playwright.d.ts

@@ -0,0 +1,8 @@
+export declare const packagesPlaywright: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    content: string;
+};
+//# sourceMappingURL=packages-playwright.d.ts.map

package/dist/resources/packages-playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages-playwright.d.ts","sourceRoot":"","sources":["../../src/resources/packages-playwright.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;CAgK9B,CAAC"}

package/dist/resources/packages-playwright.js

@@ -0,0 +1,161 @@
+export const packagesPlaywright = {
+    uri: 'ibl://packages/playwright',
+    name: 'IBL Playwright Test Utilities',
+    description: 'Complete reference for @iblai/iblai-js/playwright — shared E2E test utilities for IBL.ai apps',
+    mimeType: 'text/markdown',
+    content: `# @iblai/iblai-js/playwright
+
+Shared E2E test utilities for IBL.ai applications. This is an original subpath export from the \`@iblai/iblai-js\` SDK (not a re-export). It is used by the **mentorai** and **skillsai** E2E test suites to provide consistent authentication flows, page interaction helpers, accessibility auditing, config generation, and more.
+
+## Installation
+
+\`\`\`bash
+pnpm add -D @playwright/test @axe-core/playwright dotenv cross-env
+\`\`\`
+
+> \`@iblai/iblai-js\` must also be installed. \`winston\`, \`axios\`, and \`dotenv\` are transitive dependencies.
+
+## Export Reference
+
+### Core Test Fixtures
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`test\` | TestType | Extended Playwright test with \`step\` fixture |
+| \`expect\` | ExpectType | Re-exported from \`@playwright/test\` |
+| \`StepFn\` | Type | \`(title: string, fn: () => unknown) => unknown\` |
+
+### Navigation
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`safeWaitForURL\` | Function | \`(page, urlMatcher, options?) => Promise<void>\` — Browser-safe URL waiting that handles Firefox \`NS_BINDING_ABORTED\` and Safari navigation policy errors |
+| \`waitForPageLoad\` | Function | \`(page) => Promise<void>\` — Waits for \`load\`, \`domcontentloaded\`, \`networkidle\`, and dismisses any dialogs |
+| \`isFirefox\` | Function | \`(page) => boolean\` — Check if browser is Firefox |
+| \`SafeWaitForURLOptions\` | Type | \`{ timeout?, waitUntil?, maxRetries? }\` |
+
+### Utility Functions
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`closeWithEsc\` | Function | \`(page) => Promise<void>\` — Press Escape to close modals |
+| \`retry\` | Function | \`(action, errorMessage, retryCount?) => Promise<void>\` — Retry with count |
+| \`isJSON\` | Function | \`(value: string) => boolean\` — Check if string is valid JSON |
+
+### Page Interaction Helpers
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`waitForPageReady\` | Function | \`(page, timeout?) => Promise<void>\` — Wait for \`readyState\` complete |
+| \`checkAdminStatus\` | Function | \`(page) => Promise<boolean>\` — Check admin from localStorage |
+| \`waitForElementStable\` | Function | \`(page, locator, timeout?) => Promise<void>\` — Wait for element attached, visible, not animating |
+| \`reliableClick\` | Function | \`(page, locator, timeout?, maxRetries?) => Promise<void>\` — Click with retry |
+| \`reliableFill\` | Function | \`(page, locator, value, timeout?, maxRetries?) => Promise<void>\` — Fill with retry and verification |
+| \`waitForDialogReady\` | Function | \`(page, dialogLocator, timeout?) => Promise<void>\` — Wait for dialog visible and loaded |
+| \`selectDateFromCalendar\` | Function | \`(page, dialogLocator, targetDate, timeout?) => Promise<void>\` — Calendar date picker |
+
+### Accessibility
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`expectNoAccessibilityViolations\` | Function | \`(page) => Promise<void>\` — Run axe-core on full page |
+| \`expectNoAccessibilityViolationsOnDialogs\` | Function | \`(page, rules?, exclude?) => Promise<void>\` — Run axe-core on dialog elements |
+
+### Auth Helpers
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`AuthFlowBuilder\` | Class | Constructor: \`(flow, idp, authHost)\`. Method: \`run(page, step, username, password, hostUrl, authUrl, postLoginUrlMatcher?)\`. Supports \`username_password\`, \`magic_link\`, \`sso\`, \`direct_sso\` flows |
+| \`createAuthSetup\` | Function | \`(config: AuthSetupConfig) => SetupFn\` — Factory for Playwright auth setup tests |
+| \`AuthSetupConfig\` | Type | \`{ hostUrl, authHost, appName, postLoginUrlMatcher, authFlow?, authIdp? }\` |
+| \`loginWithEmailAndPassword\` | Function | \`(page, username, password, hostUrl, postLoginUrlMatcher?) => Promise<void>\` |
+| \`signUpWithEmailAndPassword\` | Function | \`(page, authHost, postSignUpUrl, credentials?, alreadyInSignupPage?) => Promise<void>\` |
+| \`SignUpCredentials\` | Type | \`{ email: string, password: string }\` |
+| \`loginWithMicrosoftIdp\` | Function | \`(page, username, password) => Promise<void>\` |
+| \`canChatWithEmbedMentor\` | Function | \`(page, openChatButton) => Promise<void>\` — Test chat with embedded mentor widget |
+| \`getMentorIdFromUrl\` | Function | \`(url: string) => string\` — Extract mentor ID from URL |
+
+### Config Generation
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`createPlaywrightConfig\` | Function | \`(options: CreatePlaywrightConfigOptions) => PlaywrightTestConfig\` — Complete config with per-browser auth setup |
+| \`CreatePlaywrightConfigOptions\` | Type | \`{ testDir?, devices?, platforms, customReporterPath?, extraProjects? }\` |
+| \`PlatformConfig\` | Type | \`{ name, devices?, dependencies?, otherTestMatch?, testIgnore? }\` |
+| \`generateProjectConfig\` | Function | Generate per-browser project config |
+| \`generateBrowserSetupProjects\` | Function | Generate auth setup projects per browser |
+| \`getBrowserKey\` | Function | \`(deviceName) => string\` — e.g., \`'Desktop Chrome'\` → \`'chrome'\` |
+
+### Environment Configuration
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`createEnvConfig\` | Function | \`(overrides?) => EnvConfig\` — Typed env var reader from \`process.env\` |
+| \`EnvConfig\` | Type | Interface with: \`skillHost\`, \`authHost\`, \`analyticsHost\`, \`mentorHost\`, \`mentorNextjsHost\`, \`authNextjsHost\`, \`playwrightUsername\`, \`playwrightPassword\`, \`inviteUsername\`, \`inviteUserPassword\`, \`authFlow\`, \`authIdp\`, \`enableStripeTest\`, \`iblMentorDisabledTabs\`, \`embedUrl\`, \`wcagRange\` |
+| \`AuthFlowType\` | Type | \`'username_password' \\| 'magic_link' \\| 'sso' \\| 'direct_sso'\` |
+
+### Report Download
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`buildReportUrl\` | Function | \`(baseUrl, platformKey, reportName) => string\` |
+| \`parseReportUrlParams\` | Function | \`(url) => { platformKey, reportName }\` |
+| \`navigateToReportDownload\` | Function | \`(page, options) => Promise<void>\` |
+| \`verifyPreparingPhase\` | Function | \`(page, options?) => Promise<void>\` |
+| \`verifyDownloadingPhase\` | Function | \`(page, options?) => Promise<void>\` |
+| \`verifyDonePhase\` | Function | \`(page, options?) => Promise<void>\` |
+| \`verifyErrorPhase\` | Function | \`(page, options?) => Promise<void>\` |
+| \`clickBackHome\` | Function | \`(page) => Promise<void>\` |
+| \`clickDownloadAgain\` | Function | \`(page) => Promise<void>\` |
+| \`clickManualDownloadLink\` | Function | \`(page) => Promise<void>\` |
+| \`waitForReportDownload\` | Function | \`(page, options) => Promise<void>\` — Full flow |
+| \`ReportDownloadOptions\` | Type | \`{ baseUrl, platformKey, reportName, timeout? }\` |
+
+### Shared Test Helpers
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`inviteUserTest\` | Function | \`(page, inviteModal) => Promise<void>\` |
+| \`navigateToAccountComponent\` | Function | \`(page, profileBtn) => Promise<void>\` |
+| \`navigateToDataReports\` | Function | \`(page) => Promise<void>\` |
+| \`shouldDisplayReportCards\` | Function | \`(page, REPORT_CARDS[]) => Promise<void>\` |
+| And 13 more CSV editor and combined report helpers | | |
+
+### Infrastructure
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`logger\` | Object | Winston logger instance — info level locally, silent in CI |
+| \`MailsacClient\` | Class | Email testing client. Constructor: \`(apiKey)\`. Methods: \`getEmails(inbox)\`, \`getEmailById(email, messageId)\`, \`deleteEmail(emailId)\` |
+| \`CustomReporter\` | Class | Playwright custom reporter with \`onBegin\`, \`onTestBegin\`, \`onTestEnd\`, \`onEnd\` |
+
+## Import Patterns
+
+\`\`\`typescript
+// SDK utilities
+import {
+  logger,
+  safeWaitForURL,
+  waitForPageReady,
+  createAuthSetup,
+} from '@iblai/iblai-js/playwright';
+
+// Playwright core (use directly, not from SDK)
+import {
+  test,
+  expect,
+  Page,
+  Locator,
+  BrowserContext,
+  devices,
+} from '@playwright/test';
+\`\`\`
+
+> **Note:** Most test files import \`test\`/\`expect\` from \`@playwright/test\` directly. The SDK supplements Playwright with shared utilities.
+
+## Source Location
+
+\`packages/iblai-js/src/playwright/\` in the \`ibl-web-frontend\` monorepo.
+`,
+};
+//# sourceMappingURL=packages-playwright.js.map

package/dist/resources/packages-playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages-playwright.js","sourceRoot":"","sources":["../../src/resources/packages-playwright.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,2BAA2B;IAChC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,+FAA+F;IACjG,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJV;CACA,CAAC"}

package/dist/resources/web-containers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-containers.d.ts","sourceRoot":"","sources":["../../src/resources/web-containers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;CAwHzB,CAAC"}
+{"version":3,"file":"web-containers.d.ts","sourceRoot":"","sources":["../../src/resources/web-containers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;CAoLzB,CAAC"}