Add NOK pricing catalog, credit ledger, success-based charging, and tier-gated model routing

- PricingCatalog.php: single source of truth for plans (free/plus/pro), top-ups,
  Stripe price env keys, tool costs (0–6 credits), STT variable billing, feature limits
- FreeTier.php: monthly-first credit deduction, ledger (user_tool_credit_ledger),
  STT reservation/settle/release, monthly reset, trial logic
- StripeClient.php: canonical SKUs (plus/pro/topup_100/300/1000), legacy aliases kept
- stripe-checkout.php: subscription vs payment mode, trial gating, catalog metadata
- stripe-webhook.php: idempotent via stripe_events, handles subscription lifecycle +
  invoice.paid renewal + one-time topup credit grants
- All API tools: success-based credit deduction (check before, charge after)
- transcribe.php: file-size heuristic reservation, settle from actual provider duration
- ask.php + LegalTools.php: ToolModels engine resolution — Pro gets gpt-4o
- KorrespondAgent.php + korrespond.php: tier-gated draft deployment —
  Free/Plus gets gpt-4o-mini, Pro gets gpt-4o
- pricing.php: NOK-only, plan cards, top-up packs, Organisation contact card,
  tool cost table, separate monthly/prepaid balance display
- 003_pricing_credit_catalog.sql: ledger and STT reservation tables

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

assets/js/barnevernet.js

@@ -564,6 +564,9 @@
     }
 
     lastResult = finalResult;
+    if (typeof finalResult.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+      window.dbnUpdateCredits(finalResult.balance);
+    }
     const meta = finalResult.trace_metadata || {};
     setStatus(
       `Done in ${Math.round((finalResult.latency_ms || 0) / 1000)} s · ${meta.source_count || 0} sources · confidence ${meta.citation_confidence || '?'}`,

assets/js/deep-research.js

@@ -432,6 +432,9 @@
     }
 
     finalResult.query = query;
+    if (typeof finalResult.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+      window.dbnUpdateCredits(finalResult.balance);
+    }
     lastResult = finalResult;
     const meta = finalResult.trace_metadata || {};
     const rc = meta.retrieval_counts || {};

assets/js/discrepancy.js

@@ -354,6 +354,9 @@
     }
 
     lastResult = finalResult;
+    if (typeof finalResult.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+      window.dbnUpdateCredits(finalResult.balance);
+    }
     const meta = finalResult.trace_metadata || {};
     setStatus(
       `Done · ${meta.conflict_count || 0} contradictions · ${meta.deleted_count || 0} deletions · ${meta.added_count || 0} additions · ${meta.source_count || 0} sources`,

assets/js/korrespond.js

@@ -382,6 +382,9 @@
     }
 
     setStatus(t('done_summary', { s: Math.round((finalResult.latency_ms || 0) / 1000), n: (finalResult.cited_law || []).length }), 'ok');
+    if (typeof finalResult.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+      window.dbnUpdateCredits(finalResult.balance);
+    }
     lastFinal = finalResult;
     renderFinal(finalResult);
     pendingClarifications = {}; // reset for next run
@@ -487,6 +490,9 @@
     }
 
     setStatus(t('refined_summary', { s: Math.round((finalResult.latency_ms || 0) / 1000), n: (finalResult.cited_law || []).length, jur: jurLabel }), 'ok');
+    if (typeof finalResult.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+      window.dbnUpdateCredits(finalResult.balance);
+    }
     renderRefined(finalResult);
   }
 

assets/js/tools.js

@@ -1882,6 +1882,9 @@ async function runTranscribe() {
       const resp = await fetch('api/transcribe.php', { method: 'POST', credentials: 'same-origin', body: fd });
       const data = await resp.json().catch(() => ({}));
       if (!resp.ok || !data.ok) throw new Error(data.error?.message || 'Transcription failed.');
+      if (typeof data.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+        window.dbnUpdateCredits(data.balance);
+      }
       if (typeof renderTranscribeResult === 'function') renderTranscribeResult(data);
       else renderResults(data);
       showSaveResultButton('transcribe', { audio_doc_id: storedAudioDocId }, data, {
@@ -1968,6 +1971,9 @@ async function runTranscribe() {
       if (!resp.ok || !data.ok) {
         throw new Error(data.error?.message || currentUiT('transcribeFailed', resp.status));
       }
+      if (typeof data.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+        window.dbnUpdateCredits(data.balance);
+      }
 
       clearInterval(timer);
       item.status = 'done';
@@ -2713,6 +2719,9 @@ function laAddonEvent(data, listEl, pipelineEl, cards) {
     card.insertAdjacentHTML('beforeend', html);
   } else if (data.event === 'final' && data.result) {
     const res = data.result;
+    if (typeof res.balance === 'number' && typeof window.dbnUpdateCredits === 'function') {
+      window.dbnUpdateCredits(res.balance);
+    }
     pipelineEl.innerHTML =
       '<div class="la-step done"><strong>' + escapeHtml(_laT('pass1')) + '</strong> — ' + escapeHtml(_laT('pass1Found', { n: (res.issues || []).length })) + '</div>'
       + '<div class="la-step done"><strong>' + escapeHtml(_laT('pass2')) + '</strong> — ' + escapeHtml(_laT('pass2Answered', { n: (res.issues || []).length })) + '</div>'
@@ -2792,6 +2801,7 @@ function dbnFreeTierError(status, data) {
     const toast = document.createElement('div');
     toast.className = 'credit-toast';
     toast.textContent = 'Rate limit reached — you can make up to 10 requests per hour on the free tier.';
+    toast.textContent = data?.error?.message || 'Rate limit reached. Try again shortly or see pricing for higher caps.';
     document.body.appendChild(toast);
     setTimeout(() => toast.remove(), 5000);
     return;
@@ -2810,6 +2820,12 @@ function dbnFreeTierError(status, data) {
         <button class="credit-modal__dismiss" onclick="this.closest('.credit-modal-overlay').remove()">Close</button>
       </div>
     </div>`;
+  overlay.querySelector('.credit-modal__icon').textContent = 'DBN';
+  overlay.querySelector('#cmTitle').textContent = 'No credits remaining';
+  overlay.querySelector('p').innerHTML = 'Your monthly and prepaid credits have been used.<br>Monthly credits reset next month, and prepaid top-ups never expire.';
+  const pricingLink = overlay.querySelector('.credit-modal__cta');
+  pricingLink.setAttribute('href', '/pricing.php');
+  pricingLink.textContent = 'See plans and top-ups';
   document.body.appendChild(overlay);
   overlay.addEventListener('click', (e) => { if (e.target === overlay) overlay.remove(); });
 }