@iblai/iblai-js 1.5.3 → 1.6.0

package/dist/data-layer/playwright/billing-tab-helpers.d.ts

@@ -0,0 +1,88 @@
+import { Locator, Page } from '@playwright/test';
+import type { CreditBalancePlan } from './credit-balance-helpers';
+export type BillingAutoRechargeStatus = 'Enabled' | 'Disabled';
+/** Locator for the Plan section card on the BillingTab. */
+export declare function billingPlanSection(page: Page): Locator;
+/** Locator for the Credits section card on the BillingTab. */
+export declare function billingCreditsSection(page: Page): Locator;
+/** Locator for the Auto Recharge section card on the BillingTab.
+ *  This section is only rendered for non-Free plans with a payment method on file.
+ */
+export declare function billingAutoRechargeSection(page: Page): Locator;
+/** Reads the plan label (Free / Trial / Premium) from the Plan section. */
+export declare function getBillingPlanLabel(page: Page): Promise<CreditBalancePlan | null>;
+/** Reads the auto-recharge status badge (Enabled / Disabled) when the section is rendered. */
+export declare function getBillingAutoRechargeStatus(page: Page): Promise<BillingAutoRechargeStatus | null>;
+/** Waits for the BillingTab loading skeletons to clear by waiting for the Plan
+ *  section card to mount. */
+export declare function waitForBillingTabReady(page: Page): Promise<void>;
+/**
+ * Asserts the Plan section state for a given plan. Verifies:
+ *  - The plan label text matches `options.plan`
+ *  - The "Current" pill is visible
+ *  - The Upgrade button is visible iff the plan is not Premium
+ */
+export declare function expectBillingPlanSection(page: Page, options: {
+    plan: CreditBalancePlan;
+}): Promise<void>;
+/**
+ * Asserts the Credits section state. Always verifies the "Available" stat row.
+ * The action button rule mirrors the component:
+ *   - Free plan → no Add Credits / Manage Billing button
+ *   - Non-Free + hasPaymentMethod=true → "Add Credits" visible, "Manage Billing" absent
+ *   - Non-Free + hasPaymentMethod=false → "Manage Billing" visible, "Add Credits" absent
+ *   - Non-Free with hasPaymentMethod omitted → only the "Available" row is asserted
+ */
+export declare function expectBillingCreditsSection(page: Page, options: {
+    plan: CreditBalancePlan;
+    hasPaymentMethod?: boolean;
+}): Promise<void>;
+/**
+ * Asserts the Auto Recharge section visibility. Section is rendered only when
+ * `hasPaymentMethod && !isFreePlan` in the component. Pass `expectVisible: false`
+ * to assert the section is absent. When visible and `status` is provided, also
+ * asserts the Enabled/Disabled badge text.
+ */
+export declare function expectBillingAutoRechargeSection(page: Page, options: {
+    expectVisible: boolean;
+    status?: BillingAutoRechargeStatus;
+}): Promise<void>;
+/**
+ * Free plan: Plan="Free" with Upgrade visible; Credits section has no action;
+ * Auto Recharge section is hidden entirely (regardless of has_payment_method).
+ */
+export declare function expectBillingTabForFreePlan(page: Page): Promise<void>;
+/**
+ * Trial plan: Plan="Trial" with Upgrade visible; Credits action depends on
+ * `hasPaymentMethod` (Add Credits when true, Manage Billing when false);
+ * Auto Recharge section is rendered iff `hasPaymentMethod` is true.
+ */
+export declare function expectBillingTabForTrialPlan(page: Page, options: {
+    hasPaymentMethod: boolean;
+}): Promise<void>;
+/**
+ * Premium plan: Plan="Premium" with Upgrade hidden; Credits action depends on
+ * `hasPaymentMethod` (Add Credits when true, Manage Billing when false);
+ * Auto Recharge section is rendered iff `hasPaymentMethod` is true.
+ */
+export declare function expectBillingTabForPremiumPlan(page: Page, options: {
+    hasPaymentMethod: boolean;
+}): Promise<void>;
+/**
+ * Convenience: detects the active plan from the Plan section badge and runs
+ * the matching state assertions. Returns the detected plan.
+ *
+ * For non-Free plans, pass `hasPaymentMethod` to assert the Credits/Auto Recharge
+ * sub-states; if omitted, only the Plan section + base Credits row is verified.
+ */
+export declare function expectBillingTabForCurrentPlan(page: Page, options?: {
+    hasPaymentMethod?: boolean;
+}): Promise<CreditBalancePlan>;
+/** Clicks the Upgrade button in the Plan section (visible only on non-Premium plans). */
+export declare function clickBillingUpgrade(page: Page): Promise<void>;
+/** Clicks the Add Credits button in the Credits section (non-Free + has payment method). */
+export declare function clickBillingAddCredits(page: Page): Promise<void>;
+/** Clicks the Manage Billing button in the Credits section (non-Free + no payment method). */
+export declare function clickBillingManageBilling(page: Page): Promise<void>;
+/** Clicks the Manage Usage button in the Auto Recharge section. */
+export declare function clickBillingManageUsage(page: Page): Promise<void>;

package/dist/data-layer/playwright/credit-balance-helpers.d.ts

@@ -0,0 +1,73 @@
+import { Locator, Page } from '@playwright/test';
+export type CreditBalancePlan = 'Free' | 'Trial' | 'Premium';
+/**
+ * Reads `current_tenant` from localStorage and returns its `show_paywall` flag.
+ * Returns false if the entry is missing, malformed, or the flag is unset.
+ */
+export declare function getCurrentTenantShowPaywall(page: Page): Promise<boolean>;
+/** Locator for the credit-balance trigger button (icon in the nav). */
+export declare function creditBalanceTrigger(page: Page): Locator;
+/** Locator for the credit-balance dropdown panel (rendered in a Radix portal). */
+export declare function creditBalancePanel(page: Page): Locator;
+/** Locator for the plan badge (Free / Trial / Premium) inside the open panel. */
+export declare function creditBalancePlanBadge(page: Page): Locator;
+/**
+ * Asserts the credit-balance trigger is visible iff the current tenant has
+ * `show_paywall=true`. Returns the resolved expectation so callers can branch.
+ */
+export declare function expectCreditBalanceVisibilityForTenant(page: Page): Promise<{
+    shouldBeVisible: boolean;
+}>;
+/**
+ * Opens the credit-balance dropdown if not already open, waits for the panel
+ * to be visible, and waits for the initial "Loading credits..." placeholder to
+ * clear so callers can immediately read content. Idempotent — safe to call
+ * when the panel is already up.
+ */
+export declare function openCreditBalanceDropdown(page: Page): Promise<Locator>;
+/**
+ * Waits for the "Loading credits..." placeholder to disappear from the open
+ * panel. Resolves in the success path (real content rendered) or the error
+ * path ("Unable to load credit balance." rendered) — both replace the loading
+ * row. Returns immediately if the placeholder was never present.
+ */
+export declare function waitForCreditBalanceLoaded(page: Page): Promise<void>;
+/** Closes the credit-balance dropdown via Escape and waits for it to detach. */
+export declare function closeCreditBalanceDropdown(page: Page): Promise<void>;
+/**
+ * Reads the plan label text from the open panel. Returns null if the badge is
+ * not rendered (e.g. billing data still loading or errored).
+ */
+export declare function getCreditBalancePlanLabel(page: Page): Promise<CreditBalancePlan | null>;
+/**
+ * Reads the "Remaining" credits value from the open panel ("X,XXX Credits").
+ * Returns null when the row is not rendered or unparseable.
+ */
+export declare function getCreditBalanceRemaining(page: Page): Promise<number | null>;
+/**
+ * Free plan UI: Upgrade Plan only. No payment buttons. No auto-recharge section.
+ */
+export declare function expectCreditBalancePanelForFreePlan(page: Page): Promise<void>;
+/**
+ * Trial plan UI: Upgrade Plan only. No Manage Usage / Add Credits / Manage Billing.
+ */
+export declare function expectCreditBalancePanelForTrialPlan(page: Page): Promise<void>;
+/**
+ * Premium plan UI: Upgrade Plan must NOT appear.
+ *  - With payment method: Manage Usage + Add Credits both visible; Manage Billing hidden.
+ *  - Without payment method: Manage Billing visible; Manage Usage + Add Credits hidden.
+ */
+export declare function expectCreditBalancePanelForPremiumPlan(page: Page, options: {
+    hasPaymentMethod: boolean;
+}): Promise<void>;
+/**
+ * Convenience: opens the dropdown, detects the active plan from the badge,
+ * and runs the matching state assertions on the already-open panel. Returns
+ * the detected plan label.
+ *
+ * For Premium plans you may pass `hasPaymentMethod` to assert the specific
+ * sub-state; if omitted on Premium, only the "no Upgrade Plan button" check runs.
+ */
+export declare function expectCreditBalanceForCurrentPlan(page: Page, options?: {
+    hasPaymentMethod?: boolean;
+}): Promise<CreditBalancePlan>;

package/dist/data-layer/playwright/index.d.ts

@@ -17,5 +17,9 @@ export { buildReportUrl, parseReportUrlParams, navigateToReportDownload, verifyP
 export type { ReportDownloadOptions } from './report-download';
 export { isMemoryTabVisible, switchToMemoryTab, verifyMemoryTabSettings, verifyMemoryTabMemoriesList, openAddMemoryDialog, toggleMemorySwitch, addMemory, deleteFirstMemory, deleteMemoryByContent, archiveFirstMemory, archiveMemoryByContent, getMemoryCount, verifyMemoryExists, verifyMemoryNotExists, } from './memory-test-helpers';
 export { navigateToAuditLog, verifyAuditLogTableVisible, getAuditLogRowCount, verifyAuditLogEntryStructure, verifyAuditLogEmptyState, verifyAuditLogPermissionError, verifyAuditLogGenericError, verifyAuditLogLoading, waitForAuditLogDataLoaded, filterByAction, filterByActor, getAvailableActors, filterByDateRange, clearDateRangeFilter, getPaginationInfo, goToNextPage, goToPreviousPage, goToFirstPage, goToLastPage, goToPage, verifyCurrentPage, isOnLastPage, isOnFirstPage, navigateToAuditLogAndWaitForData, filterByActionAndVerify, filterByActorAndVerify, } from './audit-log-helpers';
+export { getCurrentTenantShowPaywall, creditBalanceTrigger, creditBalancePanel, creditBalancePlanBadge, expectCreditBalanceVisibilityForTenant, openCreditBalanceDropdown, waitForCreditBalanceLoaded, closeCreditBalanceDropdown, getCreditBalancePlanLabel, getCreditBalanceRemaining, expectCreditBalancePanelForFreePlan, expectCreditBalancePanelForTrialPlan, expectCreditBalancePanelForPremiumPlan, expectCreditBalanceForCurrentPlan, } from './credit-balance-helpers';
+export type { CreditBalancePlan } from './credit-balance-helpers';
+export { billingPlanSection, billingCreditsSection, billingAutoRechargeSection, getBillingPlanLabel, getBillingAutoRechargeStatus, waitForBillingTabReady, expectBillingPlanSection, expectBillingCreditsSection, expectBillingAutoRechargeSection, expectBillingTabForFreePlan, expectBillingTabForTrialPlan, expectBillingTabForPremiumPlan, expectBillingTabForCurrentPlan, clickBillingUpgrade, clickBillingAddCredits, clickBillingManageBilling, clickBillingManageUsage, } from './billing-tab-helpers';
+export type { BillingAutoRechargeStatus } from './billing-tab-helpers';
 export { createPlaywrightConfig, generateProjectConfig, generateBrowserSetupProjects, getBrowserKey, } from './playwright-config';
 export type { PlatformConfig, CreatePlaywrightConfigOptions } from './playwright-config';

package/dist/playwright/index.cjs

@@ -2078,6 +2078,413 @@ async function filterByActorAndVerify(page, actorName) {
     return count;
 }
 
+const DEFAULT_TIMEOUT$1 = 10000;
+/**
+ * Reads `current_tenant` from localStorage and returns its `show_paywall` flag.
+ * Returns false if the entry is missing, malformed, or the flag is unset.
+ */
+async function getCurrentTenantShowPaywall(page) {
+    return page.evaluate(() => {
+        try {
+            const raw = window.localStorage.getItem('current_tenant');
+            if (!raw)
+                return false;
+            const parsed = JSON.parse(raw);
+            return Boolean(parsed === null || parsed === void 0 ? void 0 : parsed.show_paywall);
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+/** Locator for the credit-balance trigger button (icon in the nav). */
+function creditBalanceTrigger(page) {
+    return page.getByTestId('credit-balance-trigger');
+}
+/** Locator for the credit-balance dropdown panel (rendered in a Radix portal). */
+function creditBalancePanel(page) {
+    return page.getByTestId('credit-balance-panel');
+}
+/** Locator for the plan badge (Free / Trial / Premium) inside the open panel. */
+function creditBalancePlanBadge(page) {
+    return creditBalancePanel(page).getByTestId('credit-balance-plan-badge');
+}
+/**
+ * Asserts the credit-balance trigger is visible iff the current tenant has
+ * `show_paywall=true`. Returns the resolved expectation so callers can branch.
+ */
+async function expectCreditBalanceVisibilityForTenant(page) {
+    const showPaywall = await getCurrentTenantShowPaywall(page);
+    const trigger = creditBalanceTrigger(page);
+    if (showPaywall) {
+        await test$1.expect(trigger).toBeVisible({ timeout: DEFAULT_TIMEOUT$1 });
+        logger.info('Credit balance trigger is visible (current_tenant.show_paywall=true)');
+    }
+    else {
+        await test$1.expect(trigger).toHaveCount(0);
+        logger.info('Credit balance trigger is hidden (current_tenant.show_paywall is falsy or missing)');
+    }
+    return { shouldBeVisible: showPaywall };
+}
+/**
+ * Opens the credit-balance dropdown if not already open, waits for the panel
+ * to be visible, and waits for the initial "Loading credits..." placeholder to
+ * clear so callers can immediately read content. Idempotent — safe to call
+ * when the panel is already up.
+ */
+async function openCreditBalanceDropdown(page) {
+    const panel = creditBalancePanel(page);
+    if (!(await panel.isVisible().catch(() => false))) {
+        const trigger = creditBalanceTrigger(page);
+        await test$1.expect(trigger).toBeVisible({ timeout: DEFAULT_TIMEOUT$1 });
+        await trigger.click();
+    }
+    await test$1.expect(panel).toBeVisible({ timeout: DEFAULT_TIMEOUT$1 });
+    await waitForCreditBalanceLoaded(page);
+    return panel;
+}
+/**
+ * Waits for the "Loading credits..." placeholder to disappear from the open
+ * panel. Resolves in the success path (real content rendered) or the error
+ * path ("Unable to load credit balance." rendered) — both replace the loading
+ * row. Returns immediately if the placeholder was never present.
+ */
+async function waitForCreditBalanceLoaded(page) {
+    const loading = creditBalancePanel(page).getByText(/^Loading credits/i);
+    await test$1.expect(loading).toHaveCount(0, { timeout: DEFAULT_TIMEOUT$1 });
+}
+/** Closes the credit-balance dropdown via Escape and waits for it to detach. */
+async function closeCreditBalanceDropdown(page) {
+    await page.keyboard.press('Escape');
+    await test$1.expect(creditBalancePanel(page)).toHaveCount(0);
+}
+/**
+ * Reads the plan label text from the open panel. Returns null if the badge is
+ * not rendered (e.g. billing data still loading or errored).
+ */
+async function getCreditBalancePlanLabel(page) {
+    const badge = creditBalancePlanBadge(page);
+    if ((await badge.count()) === 0)
+        return null;
+    const text = (await badge.innerText()).trim();
+    if (text === 'Free' || text === 'Trial' || text === 'Premium')
+        return text;
+    return null;
+}
+/**
+ * Reads the "Remaining" credits value from the open panel ("X,XXX Credits").
+ * Returns null when the row is not rendered or unparseable.
+ */
+async function getCreditBalanceRemaining(page) {
+    const panel = creditBalancePanel(page);
+    const row = panel.locator('div', { has: page.getByText(/^Remaining$/) }).first();
+    if ((await row.count()) === 0)
+        return null;
+    const text = await row.innerText().catch(() => '');
+    const match = text.match(/([0-9][0-9,]*)\s*Credits/i);
+    if (!match)
+        return null;
+    return parseInt(match[1].replace(/,/g, ''), 10);
+}
+function panelButtons(panel, page) {
+    return {
+        upgradePlan: panel.getByRole('button', { name: /^Upgrade Plan$/ }),
+        manageUsage: panel.getByRole('button', { name: /^Manage Usage$/ }),
+        addCredits: panel.getByRole('button', { name: /^Add Credits$/ }),
+        manageBilling: panel.getByRole('button', { name: /^Manage Billing$/ }),
+        autoRechargeHeading: panel.getByText(/^Auto Recharge$/),
+    };
+}
+/**
+ * Free plan UI: Upgrade Plan only. No payment buttons. No auto-recharge section.
+ */
+async function expectCreditBalancePanelForFreePlan(page) {
+    const panel = await openCreditBalanceDropdown(page);
+    await test$1.expect(creditBalancePlanBadge(page)).toHaveText('Free');
+    const btn = panelButtons(panel);
+    await test$1.expect(btn.autoRechargeHeading).toHaveCount(0);
+    await test$1.expect(btn.upgradePlan).toBeVisible();
+    await test$1.expect(btn.manageUsage).toHaveCount(0);
+    await test$1.expect(btn.addCredits).toHaveCount(0);
+    await test$1.expect(btn.manageBilling).toHaveCount(0);
+    logger.info('Verified credit balance panel for Free plan');
+}
+/**
+ * Trial plan UI: Upgrade Plan only. No Manage Usage / Add Credits / Manage Billing.
+ */
+async function expectCreditBalancePanelForTrialPlan(page) {
+    const panel = await openCreditBalanceDropdown(page);
+    await test$1.expect(creditBalancePlanBadge(page)).toHaveText('Trial');
+    const btn = panelButtons(panel);
+    await test$1.expect(btn.upgradePlan).toBeVisible();
+    await test$1.expect(btn.manageUsage).toHaveCount(0);
+    await test$1.expect(btn.addCredits).toHaveCount(0);
+    await test$1.expect(btn.manageBilling).toHaveCount(0);
+    logger.info('Verified credit balance panel for Trial plan');
+}
+/**
+ * Premium plan UI: Upgrade Plan must NOT appear.
+ *  - With payment method: Manage Usage + Add Credits both visible; Manage Billing hidden.
+ *  - Without payment method: Manage Billing visible; Manage Usage + Add Credits hidden.
+ */
+async function expectCreditBalancePanelForPremiumPlan(page, options) {
+    const panel = await openCreditBalanceDropdown(page);
+    await test$1.expect(creditBalancePlanBadge(page)).toHaveText('Premium');
+    const btn = panelButtons(panel);
+    await test$1.expect(btn.upgradePlan).toHaveCount(0);
+    if (options.hasPaymentMethod) {
+        await test$1.expect(btn.manageUsage).toBeVisible();
+        await test$1.expect(btn.addCredits).toBeVisible();
+        await test$1.expect(btn.manageBilling).toHaveCount(0);
+    }
+    else {
+        await test$1.expect(btn.manageBilling).toBeVisible();
+        await test$1.expect(btn.manageUsage).toHaveCount(0);
+        await test$1.expect(btn.addCredits).toHaveCount(0);
+    }
+    logger.info(`Verified credit balance panel for Premium plan (hasPaymentMethod=${options.hasPaymentMethod})`);
+}
+/**
+ * Convenience: opens the dropdown, detects the active plan from the badge,
+ * and runs the matching state assertions on the already-open panel. Returns
+ * the detected plan label.
+ *
+ * For Premium plans you may pass `hasPaymentMethod` to assert the specific
+ * sub-state; if omitted on Premium, only the "no Upgrade Plan button" check runs.
+ */
+async function expectCreditBalanceForCurrentPlan(page, options) {
+    const panel = await openCreditBalanceDropdown(page);
+    const plan = await getCreditBalancePlanLabel(page);
+    if (!plan) {
+        throw new Error('Credit balance plan badge was not found in the dropdown panel');
+    }
+    const btn = panelButtons(panel);
+    if (plan === 'Free') {
+        await test$1.expect(btn.autoRechargeHeading).toHaveCount(0);
+        await test$1.expect(btn.upgradePlan).toBeVisible();
+        await test$1.expect(btn.manageUsage).toHaveCount(0);
+        await test$1.expect(btn.addCredits).toHaveCount(0);
+        await test$1.expect(btn.manageBilling).toHaveCount(0);
+    }
+    else if (plan === 'Trial') {
+        await test$1.expect(btn.upgradePlan).toBeVisible();
+        await test$1.expect(btn.manageUsage).toHaveCount(0);
+        await test$1.expect(btn.addCredits).toHaveCount(0);
+        await test$1.expect(btn.manageBilling).toHaveCount(0);
+    }
+    else {
+        // Premium
+        await test$1.expect(btn.upgradePlan).toHaveCount(0);
+        if ((options === null || options === void 0 ? void 0 : options.hasPaymentMethod) === true) {
+            await test$1.expect(btn.manageUsage).toBeVisible();
+            await test$1.expect(btn.addCredits).toBeVisible();
+            await test$1.expect(btn.manageBilling).toHaveCount(0);
+        }
+        else if ((options === null || options === void 0 ? void 0 : options.hasPaymentMethod) === false) {
+            await test$1.expect(btn.manageBilling).toBeVisible();
+            await test$1.expect(btn.manageUsage).toHaveCount(0);
+            await test$1.expect(btn.addCredits).toHaveCount(0);
+        }
+    }
+    logger.info(`Verified credit balance UI for plan="${plan}"`);
+    return plan;
+}
+
+const DEFAULT_TIMEOUT = 10000;
+/** Locator for the Plan section card on the BillingTab. */
+function billingPlanSection(page) {
+    return page.getByTestId('billing-plan-section');
+}
+/** Locator for the Credits section card on the BillingTab. */
+function billingCreditsSection(page) {
+    return page.getByTestId('billing-credits-section');
+}
+/** Locator for the Auto Recharge section card on the BillingTab.
+ *  This section is only rendered for non-Free plans with a payment method on file.
+ */
+function billingAutoRechargeSection(page) {
+    return page.getByTestId('billing-auto-recharge-section');
+}
+/** Reads the plan label (Free / Trial / Premium) from the Plan section. */
+async function getBillingPlanLabel(page) {
+    const label = billingPlanSection(page).getByTestId('billing-plan-label');
+    if ((await label.count()) === 0)
+        return null;
+    const text = (await label.innerText()).trim();
+    if (text === 'Free' || text === 'Trial' || text === 'Premium')
+        return text;
+    return null;
+}
+/** Reads the auto-recharge status badge (Enabled / Disabled) when the section is rendered. */
+async function getBillingAutoRechargeStatus(page) {
+    const badge = billingAutoRechargeSection(page).getByTestId('billing-auto-recharge-status');
+    if ((await badge.count()) === 0)
+        return null;
+    const text = (await badge.innerText()).trim();
+    if (text === 'Enabled' || text === 'Disabled')
+        return text;
+    return null;
+}
+/** Waits for the BillingTab loading skeletons to clear by waiting for the Plan
+ *  section card to mount. */
+async function waitForBillingTabReady(page) {
+    await test$1.expect(billingPlanSection(page)).toBeVisible({ timeout: 15000 });
+}
+/**
+ * Asserts the Plan section state for a given plan. Verifies:
+ *  - The plan label text matches `options.plan`
+ *  - The "Current" pill is visible
+ *  - The Upgrade button is visible iff the plan is not Premium
+ */
+async function expectBillingPlanSection(page, options) {
+    const section = billingPlanSection(page);
+    await test$1.expect(section).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await test$1.expect(section.getByTestId('billing-plan-label')).toHaveText(options.plan);
+    await test$1.expect(section.getByText(/^Current$/)).toBeVisible();
+    const upgradeBtn = section.getByRole('button', { name: /^Upgrade$/ });
+    if (options.plan === 'Premium') {
+        await test$1.expect(upgradeBtn).toHaveCount(0);
+    }
+    else {
+        await test$1.expect(upgradeBtn).toBeVisible();
+    }
+}
+/**
+ * Asserts the Credits section state. Always verifies the "Available" stat row.
+ * The action button rule mirrors the component:
+ *   - Free plan → no Add Credits / Manage Billing button
+ *   - Non-Free + hasPaymentMethod=true → "Add Credits" visible, "Manage Billing" absent
+ *   - Non-Free + hasPaymentMethod=false → "Manage Billing" visible, "Add Credits" absent
+ *   - Non-Free with hasPaymentMethod omitted → only the "Available" row is asserted
+ */
+async function expectBillingCreditsSection(page, options) {
+    const section = billingCreditsSection(page);
+    await test$1.expect(section).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await test$1.expect(section.getByText(/^Available$/)).toBeVisible();
+    const addCreditsBtn = section.getByRole('button', { name: /^Add Credits$/ });
+    const manageBillingBtn = section.getByRole('button', { name: /^Manage Billing$/ });
+    if (options.plan === 'Free') {
+        await test$1.expect(addCreditsBtn).toHaveCount(0);
+        await test$1.expect(manageBillingBtn).toHaveCount(0);
+    }
+    else if (options.hasPaymentMethod === true) {
+        await test$1.expect(addCreditsBtn).toBeVisible();
+        await test$1.expect(manageBillingBtn).toHaveCount(0);
+    }
+    else if (options.hasPaymentMethod === false) {
+        await test$1.expect(manageBillingBtn).toBeVisible();
+        await test$1.expect(addCreditsBtn).toHaveCount(0);
+    }
+}
+/**
+ * Asserts the Auto Recharge section visibility. Section is rendered only when
+ * `hasPaymentMethod && !isFreePlan` in the component. Pass `expectVisible: false`
+ * to assert the section is absent. When visible and `status` is provided, also
+ * asserts the Enabled/Disabled badge text.
+ */
+async function expectBillingAutoRechargeSection(page, options) {
+    const section = billingAutoRechargeSection(page);
+    if (!options.expectVisible) {
+        await test$1.expect(section).toHaveCount(0);
+        return;
+    }
+    await test$1.expect(section).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await test$1.expect(section.getByRole('button', { name: /^Manage Usage$/ })).toBeVisible();
+    if (options.status) {
+        await test$1.expect(section.getByTestId('billing-auto-recharge-status')).toHaveText(options.status);
+    }
+}
+/**
+ * Free plan: Plan="Free" with Upgrade visible; Credits section has no action;
+ * Auto Recharge section is hidden entirely (regardless of has_payment_method).
+ */
+async function expectBillingTabForFreePlan(page) {
+    await expectBillingPlanSection(page, { plan: 'Free' });
+    await expectBillingCreditsSection(page, { plan: 'Free' });
+    await expectBillingAutoRechargeSection(page, { expectVisible: false });
+    logger.info('Verified billing tab for Free plan');
+}
+/**
+ * Trial plan: Plan="Trial" with Upgrade visible; Credits action depends on
+ * `hasPaymentMethod` (Add Credits when true, Manage Billing when false);
+ * Auto Recharge section is rendered iff `hasPaymentMethod` is true.
+ */
+async function expectBillingTabForTrialPlan(page, options) {
+    await expectBillingPlanSection(page, { plan: 'Trial' });
+    await expectBillingCreditsSection(page, {
+        plan: 'Trial',
+        hasPaymentMethod: options.hasPaymentMethod,
+    });
+    await expectBillingAutoRechargeSection(page, { expectVisible: options.hasPaymentMethod });
+    logger.info(`Verified billing tab for Trial plan (hasPaymentMethod=${options.hasPaymentMethod})`);
+}
+/**
+ * Premium plan: Plan="Premium" with Upgrade hidden; Credits action depends on
+ * `hasPaymentMethod` (Add Credits when true, Manage Billing when false);
+ * Auto Recharge section is rendered iff `hasPaymentMethod` is true.
+ */
+async function expectBillingTabForPremiumPlan(page, options) {
+    await expectBillingPlanSection(page, { plan: 'Premium' });
+    await expectBillingCreditsSection(page, {
+        plan: 'Premium',
+        hasPaymentMethod: options.hasPaymentMethod,
+    });
+    await expectBillingAutoRechargeSection(page, { expectVisible: options.hasPaymentMethod });
+    logger.info(`Verified billing tab for Premium plan (hasPaymentMethod=${options.hasPaymentMethod})`);
+}
+/**
+ * Convenience: detects the active plan from the Plan section badge and runs
+ * the matching state assertions. Returns the detected plan.
+ *
+ * For non-Free plans, pass `hasPaymentMethod` to assert the Credits/Auto Recharge
+ * sub-states; if omitted, only the Plan section + base Credits row is verified.
+ */
+async function expectBillingTabForCurrentPlan(page, options) {
+    await waitForBillingTabReady(page);
+    const plan = await getBillingPlanLabel(page);
+    if (!plan) {
+        throw new Error('Could not detect plan label in BillingTab Plan section');
+    }
+    if (plan === 'Free') {
+        await expectBillingTabForFreePlan(page);
+    }
+    else if (plan === 'Trial') {
+        await expectBillingTabForTrialPlan(page, {
+            hasPaymentMethod: Boolean(options === null || options === void 0 ? void 0 : options.hasPaymentMethod),
+        });
+    }
+    else {
+        await expectBillingTabForPremiumPlan(page, {
+            hasPaymentMethod: Boolean(options === null || options === void 0 ? void 0 : options.hasPaymentMethod),
+        });
+    }
+    return plan;
+}
+/** Clicks the Upgrade button in the Plan section (visible only on non-Premium plans). */
+async function clickBillingUpgrade(page) {
+    const btn = billingPlanSection(page).getByRole('button', { name: /^Upgrade$/ });
+    await test$1.expect(btn).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await btn.click();
+}
+/** Clicks the Add Credits button in the Credits section (non-Free + has payment method). */
+async function clickBillingAddCredits(page) {
+    const btn = billingCreditsSection(page).getByRole('button', { name: /^Add Credits$/ });
+    await test$1.expect(btn).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await btn.click();
+}
+/** Clicks the Manage Billing button in the Credits section (non-Free + no payment method). */
+async function clickBillingManageBilling(page) {
+    const btn = billingCreditsSection(page).getByRole('button', { name: /^Manage Billing$/ });
+    await test$1.expect(btn).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await btn.click();
+}
+/** Clicks the Manage Usage button in the Auto Recharge section. */
+async function clickBillingManageUsage(page) {
+    const btn = billingAutoRechargeSection(page).getByRole('button', { name: /^Manage Usage$/ });
+    await test$1.expect(btn).toBeVisible({ timeout: DEFAULT_TIMEOUT });
+    await btn.click();
+}
+
 /** Extract browser key from device name (e.g., 'Desktop Chrome' -> 'chrome') */
 function getBrowserKey(deviceName) {
     return deviceName.toLowerCase().replace(/^desktop\s+/, '');
@@ -2213,19 +2620,42 @@ exports.MailsacClient = MailsacClient;
 exports.addMemory = addMemory;
 exports.archiveFirstMemory = archiveFirstMemory;
 exports.archiveMemoryByContent = archiveMemoryByContent;
+exports.billingAutoRechargeSection = billingAutoRechargeSection;
+exports.billingCreditsSection = billingCreditsSection;
+exports.billingPlanSection = billingPlanSection;
 exports.buildReportUrl = buildReportUrl;
 exports.canChatWithEmbedMentor = canChatWithEmbedMentor;
 exports.checkAdminStatus = checkAdminStatus;
 exports.clearDateRangeFilter = clearDateRangeFilter;
 exports.clickBackHome = clickBackHome;
+exports.clickBillingAddCredits = clickBillingAddCredits;
+exports.clickBillingManageBilling = clickBillingManageBilling;
+exports.clickBillingManageUsage = clickBillingManageUsage;
+exports.clickBillingUpgrade = clickBillingUpgrade;
 exports.clickDownloadAgain = clickDownloadAgain;
 exports.clickManualDownloadLink = clickManualDownloadLink;
+exports.closeCreditBalanceDropdown = closeCreditBalanceDropdown;
 exports.closeWithEsc = closeWithEsc;
 exports.createAuthSetup = createAuthSetup;
 exports.createEnvConfig = createEnvConfig;
 exports.createPlaywrightConfig = createPlaywrightConfig;
+exports.creditBalancePanel = creditBalancePanel;
+exports.creditBalancePlanBadge = creditBalancePlanBadge;
+exports.creditBalanceTrigger = creditBalanceTrigger;
 exports.deleteFirstMemory = deleteFirstMemory;
 exports.deleteMemoryByContent = deleteMemoryByContent;
+exports.expectBillingAutoRechargeSection = expectBillingAutoRechargeSection;
+exports.expectBillingCreditsSection = expectBillingCreditsSection;
+exports.expectBillingPlanSection = expectBillingPlanSection;
+exports.expectBillingTabForCurrentPlan = expectBillingTabForCurrentPlan;
+exports.expectBillingTabForFreePlan = expectBillingTabForFreePlan;
+exports.expectBillingTabForPremiumPlan = expectBillingTabForPremiumPlan;
+exports.expectBillingTabForTrialPlan = expectBillingTabForTrialPlan;
+exports.expectCreditBalanceForCurrentPlan = expectCreditBalanceForCurrentPlan;
+exports.expectCreditBalancePanelForFreePlan = expectCreditBalancePanelForFreePlan;
+exports.expectCreditBalancePanelForPremiumPlan = expectCreditBalancePanelForPremiumPlan;
+exports.expectCreditBalancePanelForTrialPlan = expectCreditBalancePanelForTrialPlan;
+exports.expectCreditBalanceVisibilityForTenant = expectCreditBalanceVisibilityForTenant;
 exports.expectNoAccessibilityViolations = expectNoAccessibilityViolations;
 exports.expectNoAccessibilityViolationsOnDialogs = expectNoAccessibilityViolationsOnDialogs;
 exports.filterByAction = filterByAction;
@@ -2237,7 +2667,12 @@ exports.generateBrowserSetupProjects = generateBrowserSetupProjects;
 exports.generateProjectConfig = generateProjectConfig;
 exports.getAuditLogRowCount = getAuditLogRowCount;
 exports.getAvailableActors = getAvailableActors;
+exports.getBillingAutoRechargeStatus = getBillingAutoRechargeStatus;
+exports.getBillingPlanLabel = getBillingPlanLabel;
 exports.getBrowserKey = getBrowserKey;
+exports.getCreditBalancePlanLabel = getCreditBalancePlanLabel;
+exports.getCreditBalanceRemaining = getCreditBalanceRemaining;
+exports.getCurrentTenantShowPaywall = getCurrentTenantShowPaywall;
 exports.getMemoryCount = getMemoryCount;
 exports.getMentorIdFromUrl = getMentorIdFromUrl;
 exports.getPaginationInfo = getPaginationInfo;
@@ -2261,6 +2696,7 @@ exports.navigateToAuditLogAndWaitForData = navigateToAuditLogAndWaitForData;
 exports.navigateToDataReports = navigateToDataReports;
 exports.navigateToReportDownload = navigateToReportDownload;
 exports.openAddMemoryDialog = openAddMemoryDialog;
+exports.openCreditBalanceDropdown = openCreditBalanceDropdown;
 exports.parseReportUrlParams = parseReportUrlParams;
 exports.reliableClick = reliableClick;
 exports.reliableFill = reliableFill;
@@ -2303,6 +2739,8 @@ exports.verifyMemoryTabMemoriesList = verifyMemoryTabMemoriesList;
 exports.verifyMemoryTabSettings = verifyMemoryTabSettings;
 exports.verifyPreparingPhase = verifyPreparingPhase;
 exports.waitForAuditLogDataLoaded = waitForAuditLogDataLoaded;
+exports.waitForBillingTabReady = waitForBillingTabReady;
+exports.waitForCreditBalanceLoaded = waitForCreditBalanceLoaded;
 exports.waitForDialogReady = waitForDialogReady;
 exports.waitForElementStable = waitForElementStable;
 exports.waitForPageLoad = waitForPageLoad;