@autobusal/admin-api-consumers 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.2.0
+
+### Added
+
+- **Credit limit on the partner form, running balance on receivables.** A
+  Mode 1 partner now sells against a running account (obtapi Payments\
+  External\Charge): every sale debits the net they owe, cancellations
+  credit it back, and recorded settlements raise it. `credit_limit` is the
+  floor - 0 means prepaid (deposit before selling), a positive number means
+  postpaid down to -that-much. The receivables table shows the live
+  `balance` and `headroom` alongside the statement figures, deliberately
+  from two books: when they disagree, something needs investigating.
+
 All notable changes to `@autobusal/admin-api-consumers` are documented here.
 This project adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

package/Manage.tsx

@@ -131,6 +131,16 @@ const Manage = ({ url, t }: Props): JSX.Element => {
           type: 'select',
           value: data?.user.comissions?.unique ?? 0,
           values: getAllowed(t)
+        }, {
+          // Claude - 2026-08-22: the floor of the partner's running
+          // account. 0 = prepaid (they deposit before they can sell);
+          // a positive number = postpaid down to -that-much. "Unlimited"
+          // is a big number typed on purpose, never a switch.
+          label: t('admin_api_consumers.manage.credit_limit', { ns: 'common' }),
+          name: 'credit_limit',
+          type: 'text',
+          value: data?.credit_limit ?? 0,
+          rules: 'required|numeric'
         }, {
           label: t('admin_api_consumers.manage.status', { ns: 'common' }),
           name: 'status',

package/Receivables.tsx

@@ -50,6 +50,8 @@ const Receivables = ({ url, t }: Props): JSX.Element => {
                 <th>{ t('admin_api_consumers.receivables.net', { ns: 'common' }) }</th>
                 <th>{ t('admin_api_consumers.receivables.settled', { ns: 'common' }) }</th>
                 <th>{ t('admin_api_consumers.receivables.outstanding', { ns: 'common' }) }</th>
+                <th>{ t('admin_api_consumers.receivables.balance', { ns: 'common' }) }</th>
+                <th>{ t('admin_api_consumers.receivables.headroom', { ns: 'common' }) }</th>
                 <th />
               </tr>
             </thead>
@@ -65,6 +67,11 @@ const Receivables = ({ url, t }: Props): JSX.Element => {
                   <td>{ row.net.toFixed(2) }</td>
                   <td>{ row.settled.toFixed(2) }</td>
                   <td>{ row.outstanding.toFixed(2) }</td>
+                  { /* the running account: negative is what they owe right
+                       now; headroom is what they can still sell before
+                       their credit floor refuses them */ }
+                  <td>{ row.balance.toFixed(2) }</td>
+                  <td>{ row.headroom.toFixed(2) }</td>
                   <td>
                     <Link to={ `${ url }/receivables/${ row.agent_id }?from=${ from }&to=${ to }` }>
                       { t('admin_api_consumers.receivables.view', { ns: 'common' }) }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/admin-api-consumers",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"

package/types.ts

@@ -6,6 +6,10 @@ export interface ApiConsumerData {
   operators: (number | string)[]
   external_providers: (number | string)[]
   is_api_consumer: boolean
+  // Claude - 2026-08-22: the running account and its floor - see
+  // ReceivableData below for what they mean
+  funds?: number
+  credit_limit?: number
   user: {
     id: number
     email: string
@@ -31,6 +35,13 @@ export interface ReceivableData {
   net: number
   settled: number
   outstanding: number
+  // Claude - 2026-08-22: the LIVE running account (debited per sale,
+  // credited by settlements) and its floor - alongside the statement
+  // figures, which describe the same debt from the frozen columns. When
+  // balance and -outstanding disagree, something needs investigating.
+  balance: number
+  credit_limit: number
+  headroom: number
 }
 
 export interface ReceivableOrderData {