@iblai/mcp 1.3.3 → 1.4.0

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

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

package/dist/resources/packages-playwright.js

@@ -121,6 +121,53 @@ pnpm add -D @playwright/test @axe-core/playwright dotenv cross-env
 | \`shouldDisplayReportCards\` | Function | \`(page, REPORT_CARDS[]) => Promise<void>\` |
 | And 13 more CSV editor and combined report helpers | | |
 
+### Credit Balance Helpers (paywall trigger + plan-aware dropdown assertions)
+
+These helpers drive the navbar \`CreditBalance\` dropdown — the icon trigger gated on \`current_tenant.show_paywall\` and the plan-specific UI states (\`Free\` / \`Trial\` / \`Premium\`).
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`getCurrentTenantShowPaywall\` | Function | \`(page) => Promise<boolean>\` — Read \`current_tenant.show_paywall\` from localStorage |
+| \`creditBalanceTrigger\` | Function | \`(page) => Locator\` — Trigger button (\`data-testid="credit-balance-trigger"\`) |
+| \`creditBalancePanel\` | Function | \`(page) => Locator\` — Dropdown panel (\`data-testid="credit-balance-panel"\`) |
+| \`creditBalancePlanBadge\` | Function | \`(page) => Locator\` — Plan badge inside panel (\`data-testid="credit-balance-plan-badge"\`) |
+| \`expectCreditBalanceVisibilityForTenant\` | Function | \`(page) => Promise<{ shouldBeVisible: boolean }>\` — Assert visibility against tenant flag |
+| \`openCreditBalanceDropdown\` | Function | \`(page) => Promise<Locator>\` — Open and wait for content load |
+| \`waitForCreditBalanceLoaded\` | Function | \`(page) => Promise<void>\` — Wait for "Loading credits..." to clear |
+| \`closeCreditBalanceDropdown\` | Function | \`(page) => Promise<void>\` — Press Escape and assert detach |
+| \`getCreditBalancePlanLabel\` | Function | \`(page) => Promise<'Free' \\| 'Trial' \\| 'Premium' \\| null>\` |
+| \`getCreditBalanceRemaining\` | Function | \`(page) => Promise<number \\| null>\` — Read "X,XXX Credits" remaining |
+| \`expectCreditBalancePanelForFreePlan\` | Function | \`(page) => Promise<void>\` |
+| \`expectCreditBalancePanelForTrialPlan\` | Function | \`(page) => Promise<void>\` |
+| \`expectCreditBalancePanelForPremiumPlan\` | Function | \`(page, { hasPaymentMethod }) => Promise<void>\` |
+| \`expectCreditBalanceForCurrentPlan\` | Function | \`(page, { hasPaymentMethod? }) => Promise<CreditBalancePlan>\` — Detect plan + run matching assertions |
+| \`CreditBalancePlan\` | Type | \`'Free' \\| 'Trial' \\| 'Premium'\` |
+
+### Billing Tab Helpers (Profile > Billing — plan-aware section assertions)
+
+Drive the BillingTab inside the user profile modal (\`Plan\`, \`Credits\`, \`Auto Recharge\` sections).
+
+| Export | Type | Description |
+|--------|------|-------------|
+| \`billingPlanSection\` | Function | \`(page) => Locator\` — \`data-testid="billing-plan-section"\` |
+| \`billingCreditsSection\` | Function | \`(page) => Locator\` — \`data-testid="billing-credits-section"\` |
+| \`billingAutoRechargeSection\` | Function | \`(page) => Locator\` — \`data-testid="billing-auto-recharge-section"\` |
+| \`getBillingPlanLabel\` | Function | \`(page) => Promise<CreditBalancePlan \\| null>\` |
+| \`getBillingAutoRechargeStatus\` | Function | \`(page) => Promise<'Enabled' \\| 'Disabled' \\| null>\` |
+| \`waitForBillingTabReady\` | Function | \`(page) => Promise<void>\` |
+| \`expectBillingPlanSection\` | Function | \`(page, { plan }) => Promise<void>\` |
+| \`expectBillingCreditsSection\` | Function | \`(page, { plan, hasPaymentMethod? }) => Promise<void>\` |
+| \`expectBillingAutoRechargeSection\` | Function | \`(page, { expectVisible, status? }) => Promise<void>\` |
+| \`expectBillingTabForFreePlan\` | Function | \`(page) => Promise<void>\` |
+| \`expectBillingTabForTrialPlan\` | Function | \`(page, { hasPaymentMethod }) => Promise<void>\` |
+| \`expectBillingTabForPremiumPlan\` | Function | \`(page, { hasPaymentMethod }) => Promise<void>\` |
+| \`expectBillingTabForCurrentPlan\` | Function | \`(page, { hasPaymentMethod? }) => Promise<CreditBalancePlan>\` |
+| \`clickBillingUpgrade\` | Function | \`(page) => Promise<void>\` — Click "Upgrade" in Plan section |
+| \`clickBillingAddCredits\` | Function | \`(page) => Promise<void>\` — Click "Add Credits" in Credits section |
+| \`clickBillingManageBilling\` | Function | \`(page) => Promise<void>\` — Click "Manage Billing" in Credits section |
+| \`clickBillingManageUsage\` | Function | \`(page) => Promise<void>\` — Click "Manage Usage" in Auto Recharge section |
+| \`BillingAutoRechargeStatus\` | Type | \`'Enabled' \\| 'Disabled'\` |
+
 ### Infrastructure
 
 | Export | Type | Description |

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwMV;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;;;;;;CAoLzB,CAAC"}
+{"version":3,"file":"web-containers.d.ts","sourceRoot":"","sources":["../../src/resources/web-containers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;CAkNzB,CAAC"}

package/dist/resources/web-containers.js

@@ -69,6 +69,36 @@ import {
 </ChartFiltersProvider>
 \`\`\`
 
+### Billing & Paywall
+\`\`\`typescript
+import {
+  CreditBalance,
+  PaywallModal,
+  UpgradePackageModal,
+} from '@iblai/iblai-js/web-containers';
+
+// Plan-aware credit-balance dropdown for the navbar.
+// Gate \`enabled\` on the current tenant's \`show_paywall\` flag.
+<CreditBalance
+  tenant={tenantKey}
+  username={username}
+  mainPlatformKey={mainPlatformKey}
+  currentUserEmail={user.email}
+  redirectUrl={window.location.href}
+  enabled={Boolean(currentTenant.show_paywall)}
+/>
+
+// "Free upgrade" CTA dialog — wires \`useStripeUpgrade\` to the \`free\` payment link.
+<UpgradePackageModal
+  open={isOpen}
+  onClose={() => setIsOpen(false)}
+  redirectUrl={\`\${window.location.origin}/billing/success\`}
+  sourcePlatformKey={tenantKey}
+  mainPlatformKey={mainPlatformKey}
+  currentUserEmail={user.email}
+/>
+\`\`\`
+
 ### Authentication Buttons
 \`\`\`typescript
 import { LoginButton, SignupButton } from '@iblai/iblai-js/web-containers';

package/dist/resources/web-containers.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-containers.js","sourceRoot":"","sources":["../../src/resources/web-containers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,+BAA+B;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,2CAA2C;IACxD,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8KV;CACA,CAAC"}
+{"version":3,"file":"web-containers.js","sourceRoot":"","sources":["../../src/resources/web-containers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,+BAA+B;IACpC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,2CAA2C;IACxD,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4MV;CACA,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"web-utils.d.ts","sourceRoot":"","sources":["../../src/resources/web-utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;;;CAqPpB,CAAC"}
+{"version":3,"file":"web-utils.d.ts","sourceRoot":"","sources":["../../src/resources/web-utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;;;CAyRpB,CAAC"}

package/dist/resources/web-utils.js

@@ -182,6 +182,42 @@ if (isMentorInappropriateContentEnabled()) {
 - \\\`mentor_report_inappropriate_content\\\` (boolean, default: true) — Allow users to report inappropriate content
 - \\\`help_center_url\\\` (string, default: "https://docs.ibl.ai") — Help center URL
 
+## Billing / Stripe Hooks
+
+### useStripeUpgrade
+Resolves the Stripe Pricing Page session for a tenant and exposes ready-to-redirect checkout URLs for the \`free\` and \`premium\` plans. Used by \`CreditBalance\` and \`UpgradePackageModal\` from \`@iblai/iblai-js/web-containers\`.
+
+\`\`\`typescript
+import { useStripeUpgrade } from '@iblai/iblai-js/web-utils';
+
+const { isLoading, freeUrl, premiumUrl, handleUpgrade } = useStripeUpgrade({
+  redirectUrl,
+  sourcePlatformKey: tenantKey,
+  mainPlatformKey,
+  currentUserEmail: user.email,
+});
+
+// Trigger immediate redirect to a specific plan's checkout URL
+await handleUpgrade('premium');
+\`\`\`
+
+The hook calls \`useLazyGetStripePricingPageSessionQuery\`, parses the returned \`payment_link_url\` (\`{ free?, premium? }\` JSON string), and appends \`locked_prefilled_email\` + \`client_reference_id\` to each link. When \`redirectPlan\` is provided, it sets \`window.location.href\` to the matching link.
+
+## Tenant Type — Paywall Flag
+
+The \`Tenant\` type (\`@iblai/iblai-js/web-utils\`) includes a \`show_paywall\` boolean propagated from the platform settings. \`TenantProvider\` includes it on \`current_tenant\` saved to localStorage so consumers (e.g. \`CreditBalance\`) can gate paywall UI per tenant.
+
+\`\`\`typescript
+import type { Tenant } from '@iblai/iblai-js/web-utils';
+
+interface Tenant {
+  // ...
+  is_advertising?: boolean;
+  is_enterprise?: boolean;
+  show_paywall?: boolean;
+}
+\`\`\`
+
 ## Authentication Utilities
 
 \`\`\`typescript

package/dist/resources/web-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-utils.js","sourceRoot":"","sources":["../../src/resources/web-utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,8CAA8C;IAC3D,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+OV;CACA,CAAC"}
+{"version":3,"file":"web-utils.js","sourceRoot":"","sources":["../../src/resources/web-utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,8CAA8C;IAC3D,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmRV;CACA,CAAC"}

package/dist/tools/component-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-info.d.ts","sourceRoot":"","sources":["../../src/tools/component-info.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAc7B,CAAC;AAyoFF,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAgD9D"}
+{"version":3,"file":"component-info.d.ts","sourceRoot":"","sources":["../../src/tools/component-info.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAc7B,CAAC;AAi8GF,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAyD9D"}