@iblai/iblai-js 1.5.4 → 1.6.1

package/dist/web-utils/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/web-utils/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/web-utils/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/iblai-js",
-  "version": "1.5.4",
+  "version": "1.6.1",
   "description": "Unified JavaScript SDK for IBL.ai — re-exports data-layer, web-containers, and web-utils under a single package",
   "type": "module",
   "engines": {
@@ -61,10 +61,10 @@
     "axios": "1.13.6",
     "dotenv": "16.6.1",
     "winston": "3.19.0",
-    "@iblai/data-layer": "1.3.11",
-    "@iblai/mcp": "1.3.4",
-    "@iblai/web-utils": "1.3.2",
-    "@iblai/web-containers": "1.3.17"
+    "@iblai/data-layer": "1.4.0",
+    "@iblai/web-containers": "1.4.1",
+    "@iblai/mcp": "1.4.1",
+    "@iblai/web-utils": "1.4.0"
   },
   "peerDependencies": {
     "@iblai/iblai-api": "4.166.0-ai",