@autobusal/providers 1.41.0 → 1.41.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/providers",
-  "version": "1.41.0",
+  "version": "1.41.2",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"

package/types/settings.ts

@@ -216,20 +216,29 @@ export interface LabelSettings {
     name: string
   },
 
+  /**
+   * Claude - 2026-08-29 (Ferjolt: "remove the tab and proceed with the
+   * rename").
+   *
+   * ONE SETTING LEFT. The six multipliers that were here - label / general
+   * / visitor, each with an agent and an operator rate - adjusted
+   * commissions after a BKT sale, which was the card surcharge done the
+   * wrong way round: recovered quietly from the operator and the agent
+   * rather than asked of the person paying. Payments\Surcharge replaced
+   * them and their admin tab is gone.
+   *
+   * `direct_sale` (formerly `reservation`, which named nothing - every
+   * booking is a reservation) is the extra commission an OPERATOR pays us
+   * when a sale comes through the brand's own website rather than through
+   * an agent. A percentage now, not the raw multiplier it used to be: 5
+   * means 5%. See obtapi's Comissions\Calculate::obtComission, which is
+   * where it is explained in full, and where it is the only reader.
+   *
+   * Optional so an older obtapi, or a brand whose settings predate the
+   * rename, reads as "charges nothing extra" rather than as NaN.
+   */
   comissions: {
-    label: {
-      agent: number
-      operator: number
-    }
-    general: {
-      agent: number
-      operator: number
-    }
-    visitor: {
-      agent: number
-      operator: number
-    }
-    reservation: number
+    direct_sale?: number
   }
 
   social: {
@@ -406,6 +415,21 @@ export interface GatewayCredentials<T> {
   mode: 'sandbox' | 'production'
   sandbox: T
   production: T
+
+  /**
+   * The CARD SURCHARGE this gateway carries on this brand, as a percentage
+   * (5 means 5%).
+   *
+   * Claude - 2026-08-29 (ruling by Ferjolt): what the payer is charged on
+   * top of what they owe, for settling online - see obtapi's
+   * App\Libraries\Payments\Surcharge.
+   *
+   * BESIDE the credentials rather than inside `sandbox`/`production`,
+   * deliberately: a commercial term is not a credential, and it must not
+   * change when a brand flips to production. Optional because no existing
+   * brand has one, which reads as no surcharge.
+   */
+  surcharge?: number
 }
 
 export interface LabelPayments {