@vulog/aima-billing 1.2.35 → 1.2.37

package/dist/index.d.cts

@@ -122,6 +122,84 @@ type RefundableAmount = {
   refundablePaymentReceipts: Receipt[];
   refundedPaymentReceipts: Receipt[];
 };
+/** Billing line item returned by the trip invoices endpoint (nested in Billing array). */
+type TripBillingItem = {
+  trip?: unknown;
+  product?: unknown;
+  vehiculeModelName?: string;
+  vehiculePlate?: string;
+  modelId?: string;
+  userId?: string;
+  withoutTaxAmountForDriving?: number;
+  withoutTaxAmountForStopover?: number;
+  withoutTaxAmountForBooking?: number;
+  withoutTaxForOvermileage?: number;
+  withoutTaxAmountForStartZoneFee?: number;
+  withoutTaxAmountForEndZoneFee?: number;
+  withoutTaxAmountForCancellationFee?: number;
+  withoutTaxAmountForScheduleTripFee?: number;
+  withoutTaxAmountForTripSystemCredit?: number;
+  withoutTaxAmountForBillingGroupDiscount?: number | null;
+  withTaxAmountForDriving?: number;
+  withTaxAmountForStopover?: number;
+  withTaxAmountForBooking?: number;
+  withTaxForOvermileage?: number;
+  withTaxAmountForStartZoneFee?: number;
+  withTaxAmountForEndZoneFee?: number;
+  withTaxAmountForCancellationFee?: number;
+  withTaxAmountForScheduleTripFee?: number;
+  withTaxAmountForTripSystemCredit?: number;
+  withTaxAmountForBillingGroupDiscount?: number;
+  withoutTaxInitialTotalAmount?: number;
+  withTaxInitialTotalAmount?: number;
+  taxInitialTotalAmount?: number;
+  paymentMethodType?: string;
+  walletId?: string | null;
+  totalTaxAmount?: number;
+  totalWithTax?: number;
+  totalWithoutTax?: number;
+  taxRate?: number;
+  taxName?: string;
+  withoutTaxAmountRideCost?: number;
+  withTaxAmountRideCost?: number;
+  taxAmountRideCost?: number;
+  products?: unknown[];
+  taxesPerRate?: unknown;
+  serviceId?: string | null;
+  profileId?: string | null;
+  profileType?: string | null;
+  profileName?: string | null;
+  withoutTaxUnlockFee?: number;
+  withTaxUnlockFee?: number;
+  taxUnlockFee?: number;
+  withTaxRefundAmount?: number | null;
+  isRefunded?: boolean;
+  cityName?: string | null;
+  cityId?: string | null;
+  tripBillingBreakdown?: unknown;
+  pricingId?: string;
+  netJourney?: number;
+  taxJourney?: number;
+  grossJourney?: number;
+  durationJourney?: number;
+  taxRemainingToBePaid?: number;
+  grossRemainingToBePaid?: number;
+  netRemainingToBePaid?: number;
+  overriddenTripInfo?: unknown;
+  interrupted?: boolean;
+  interruptedReason?: string | null;
+  invoice?: unknown;
+  distanceUnit?: string;
+  isTaxIncluded?: boolean;
+  [key: string]: unknown;
+};
+/** Response shape of GET .../trips/:tripId/invoices */
+type InvoicesByTripIdResponse = {
+  balance: number;
+  userId: string;
+  entityId: string;
+  Billing: TripBillingItem[];
+};
 type Wallet = {
   initialAmount: number;
   validityStartDate: string;
@@ -157,7 +235,7 @@ declare const getInvoiceById: (client: Client, id: string) => Promise<Invoice>;
 declare const getInvoicePdf: (client: Client, invoiceId: string) => Promise<ArrayBuffer | null>;
 //#endregion
 //#region src/getInvoicesByTripId.d.ts
-declare const getInvoicesByTripId: (client: Client, tripId: string) => Promise<Invoice[]>;
+declare const getInvoicesByTripId: (client: Client, tripId: string) => Promise<InvoicesByTripIdResponse>;
 //#endregion
 //#region src/getRefundableAmount.d.ts
 declare const getRefundableAmount: (client: Client, invoiceId: string) => Promise<RefundableAmount>;
@@ -182,4 +260,4 @@ declare const updateWallet: (client: Client, walletId: string, actions: PatchAct
 //#region src/payInvoice.d.ts
 declare const payInvoice: (client: Client, invoiceId: string, manualPayment: ManualPayment) => Promise<Invoice>;
 //#endregion
-export { ChargeProductInfo, Credit, Invoice, ManualPayment, Paths, Receipt, RefundableAmount, Wallet, addCredits, chargeProduct, getInvoiceById, getInvoicePdf, getInvoicesByTripId, getRefundableAmount, getUserCreditsByEntityId, getWalletsByEntity, payInvoice, refund, updateWallet };
+export { ChargeProductInfo, Credit, Invoice, InvoicesByTripIdResponse, ManualPayment, Paths, Receipt, RefundableAmount, TripBillingItem, Wallet, addCredits, chargeProduct, getInvoiceById, getInvoicePdf, getInvoicesByTripId, getRefundableAmount, getUserCreditsByEntityId, getWalletsByEntity, payInvoice, refund, updateWallet };

package/dist/index.d.mts

@@ -122,6 +122,84 @@ type RefundableAmount = {
   refundablePaymentReceipts: Receipt[];
   refundedPaymentReceipts: Receipt[];
 };
+/** Billing line item returned by the trip invoices endpoint (nested in Billing array). */
+type TripBillingItem = {
+  trip?: unknown;
+  product?: unknown;
+  vehiculeModelName?: string;
+  vehiculePlate?: string;
+  modelId?: string;
+  userId?: string;
+  withoutTaxAmountForDriving?: number;
+  withoutTaxAmountForStopover?: number;
+  withoutTaxAmountForBooking?: number;
+  withoutTaxForOvermileage?: number;
+  withoutTaxAmountForStartZoneFee?: number;
+  withoutTaxAmountForEndZoneFee?: number;
+  withoutTaxAmountForCancellationFee?: number;
+  withoutTaxAmountForScheduleTripFee?: number;
+  withoutTaxAmountForTripSystemCredit?: number;
+  withoutTaxAmountForBillingGroupDiscount?: number | null;
+  withTaxAmountForDriving?: number;
+  withTaxAmountForStopover?: number;
+  withTaxAmountForBooking?: number;
+  withTaxForOvermileage?: number;
+  withTaxAmountForStartZoneFee?: number;
+  withTaxAmountForEndZoneFee?: number;
+  withTaxAmountForCancellationFee?: number;
+  withTaxAmountForScheduleTripFee?: number;
+  withTaxAmountForTripSystemCredit?: number;
+  withTaxAmountForBillingGroupDiscount?: number;
+  withoutTaxInitialTotalAmount?: number;
+  withTaxInitialTotalAmount?: number;
+  taxInitialTotalAmount?: number;
+  paymentMethodType?: string;
+  walletId?: string | null;
+  totalTaxAmount?: number;
+  totalWithTax?: number;
+  totalWithoutTax?: number;
+  taxRate?: number;
+  taxName?: string;
+  withoutTaxAmountRideCost?: number;
+  withTaxAmountRideCost?: number;
+  taxAmountRideCost?: number;
+  products?: unknown[];
+  taxesPerRate?: unknown;
+  serviceId?: string | null;
+  profileId?: string | null;
+  profileType?: string | null;
+  profileName?: string | null;
+  withoutTaxUnlockFee?: number;
+  withTaxUnlockFee?: number;
+  taxUnlockFee?: number;
+  withTaxRefundAmount?: number | null;
+  isRefunded?: boolean;
+  cityName?: string | null;
+  cityId?: string | null;
+  tripBillingBreakdown?: unknown;
+  pricingId?: string;
+  netJourney?: number;
+  taxJourney?: number;
+  grossJourney?: number;
+  durationJourney?: number;
+  taxRemainingToBePaid?: number;
+  grossRemainingToBePaid?: number;
+  netRemainingToBePaid?: number;
+  overriddenTripInfo?: unknown;
+  interrupted?: boolean;
+  interruptedReason?: string | null;
+  invoice?: unknown;
+  distanceUnit?: string;
+  isTaxIncluded?: boolean;
+  [key: string]: unknown;
+};
+/** Response shape of GET .../trips/:tripId/invoices */
+type InvoicesByTripIdResponse = {
+  balance: number;
+  userId: string;
+  entityId: string;
+  Billing: TripBillingItem[];
+};
 type Wallet = {
   initialAmount: number;
   validityStartDate: string;
@@ -157,7 +235,7 @@ declare const getInvoiceById: (client: Client, id: string) => Promise<Invoice>;
 declare const getInvoicePdf: (client: Client, invoiceId: string) => Promise<ArrayBuffer | null>;
 //#endregion
 //#region src/getInvoicesByTripId.d.ts
-declare const getInvoicesByTripId: (client: Client, tripId: string) => Promise<Invoice[]>;
+declare const getInvoicesByTripId: (client: Client, tripId: string) => Promise<InvoicesByTripIdResponse>;
 //#endregion
 //#region src/getRefundableAmount.d.ts
 declare const getRefundableAmount: (client: Client, invoiceId: string) => Promise<RefundableAmount>;
@@ -182,4 +260,4 @@ declare const updateWallet: (client: Client, walletId: string, actions: PatchAct
 //#region src/payInvoice.d.ts
 declare const payInvoice: (client: Client, invoiceId: string, manualPayment: ManualPayment) => Promise<Invoice>;
 //#endregion
-export { ChargeProductInfo, Credit, Invoice, ManualPayment, Paths, Receipt, RefundableAmount, Wallet, addCredits, chargeProduct, getInvoiceById, getInvoicePdf, getInvoicesByTripId, getRefundableAmount, getUserCreditsByEntityId, getWalletsByEntity, payInvoice, refund, updateWallet };
+export { ChargeProductInfo, Credit, Invoice, InvoicesByTripIdResponse, ManualPayment, Paths, Receipt, RefundableAmount, TripBillingItem, Wallet, addCredits, chargeProduct, getInvoiceById, getInvoicePdf, getInvoicesByTripId, getRefundableAmount, getUserCreditsByEntityId, getWalletsByEntity, payInvoice, refund, updateWallet };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@vulog/aima-billing",
     "type": "module",
-    "version": "1.2.35",
+    "version": "1.2.37",
     "main": "dist/index.cjs",
     "module": "dist/index.mjs",
     "types": "dist/index.d.cts",
@@ -22,7 +22,7 @@
         "dev": "tsdown --watch",
         "test": "vitest run",
         "test:watch": "vitest",
-        "lint": "eslint src/**/* --ext .ts"
+        "lint": "eslint src/"
     },
     "keywords": [
         "AIMA",
@@ -32,8 +32,8 @@
     "author": "Vulog",
     "license": "MIT",
     "dependencies": {
-        "@vulog/aima-client": "1.2.35",
-        "@vulog/aima-core": "1.2.35"
+        "@vulog/aima-client": "1.2.37",
+        "@vulog/aima-core": "1.2.37"
     },
     "peerDependencies": {
         "zod": "^3.25.76"

package/src/getInvoicesByTripId.test.ts

@@ -1,7 +1,7 @@
 import { describe, test, expect, vi, beforeEach } from 'vitest';
 import { Client } from '@vulog/aima-client';
 import { getInvoicesByTripId } from './getInvoicesByTripId';
-import type { Invoice } from './types';
+import type { InvoicesByTripIdResponse } from './types';
 
 describe('getInvoicesByTripId', () => {
     const getMock = vi.fn();
@@ -29,27 +29,27 @@ describe('getInvoicesByTripId', () => {
         expect(getMock).not.toHaveBeenCalled();
     });
 
-    test('calls GET with correct URL and returns invoices', async () => {
+    test('calls GET with correct URL and returns trip billing response', async () => {
         const tripId = 'BEBD00056A9A16103D418CC36D940E26';
-        const invoices: Invoice[] = [
-            {
-                id: '66bcbd77-37ef-47bd-b9af-877e5d213b8f',
-                sequence: 1,
-                userId: '20fb98a3-b60d-491a-9359-62e55f51fcb9',
-                invoiceDate: '2026-03-03',
-                updateDate: '2026-03-03T09:46:50Z',
-                fleetId: 'FLEET_ID',
-                invoiceYear: 2026,
-                invoicesStatus: 'PAID',
-                amount: 100,
-                currency: 'EUR',
-                entityId: 'entity-1',
-                attempts: 0,
-                pspReference: 'ref-1',
-                withTaxRefundAmount: 0,
-            },
-        ];
-        getMock.mockResolvedValueOnce({ data: invoices });
+        const response: InvoicesByTripIdResponse = {
+            balance: 499.99,
+            userId: '20fb98a3-b60d-491a-9359-62e55f51fcb9',
+            entityId: 'ba0b4e0b-ff0a-49f5-8e98-065b54355df9',
+            Billing: [
+                {
+                    vehiculeModelName: 'Yaris_Subs',
+                    vehiculePlate: 'Yaris_Abo_001',
+                    modelId: '1754',
+                    userId: '20fb98a3-b60d-491a-9359-62e55f51fcb9',
+                    withTaxInitialTotalAmount: 499.99,
+                    totalWithTax: 499.99,
+                    pricingId: '96e1fff7-d422-4181-8e19-1b2759b2f073',
+                    distanceUnit: 'KM',
+                    isTaxIncluded: true,
+                },
+            ],
+        };
+        getMock.mockResolvedValueOnce({ data: response });
 
         const result = await getInvoicesByTripId(client, tripId);
 
@@ -57,17 +57,25 @@ describe('getInvoicesByTripId', () => {
         expect(getMock).toHaveBeenCalledWith(
             `/boapi/proxy/billing/fleets/FLEET_ID/trips/${tripId}/invoices`
         );
-        expect(result).toEqual(invoices);
-        expect(result).toHaveLength(1);
-        expect(result[0].id).toBe(invoices[0].id);
+        expect(result).toEqual(response);
+        expect(result.balance).toBe(499.99);
+        expect(result.Billing).toHaveLength(1);
+        expect(result.Billing[0].vehiculeModelName).toBe('Yaris_Subs');
     });
 
-    test('returns empty array when no invoices', async () => {
+    test('returns response with empty Billing array when no billing items', async () => {
         const tripId = 'some-trip-id';
-        getMock.mockResolvedValueOnce({ data: [] });
+        const response: InvoicesByTripIdResponse = {
+            balance: 0,
+            userId: 'user-id',
+            entityId: 'entity-id',
+            Billing: [],
+        };
+        getMock.mockResolvedValueOnce({ data: response });
 
         const result = await getInvoicesByTripId(client, tripId);
 
-        expect(result).toEqual([]);
+        expect(result).toEqual(response);
+        expect(result.Billing).toEqual([]);
     });
 });

package/src/getInvoicesByTripId.ts

@@ -1,9 +1,9 @@
 import { Client } from '@vulog/aima-client';
 import { z } from 'zod';
 
-import { Invoice } from './types';
+import { InvoicesByTripIdResponse } from './types';
 
-export const getInvoicesByTripId = async (client: Client, tripId: string): Promise<Invoice[]> => {
+export const getInvoicesByTripId = async (client: Client, tripId: string): Promise<InvoicesByTripIdResponse> => {
     const result = z.string().trim().min(1).safeParse(tripId);
     if (!result.success) {
         throw new TypeError('Invalid args', {
@@ -12,6 +12,8 @@ export const getInvoicesByTripId = async (client: Client, tripId: string): Promi
     }
 
     return client
-        .get<Invoice[]>(`/boapi/proxy/billing/fleets/${client.clientOptions.fleetId}/trips/${result.data}/invoices`)
+        .get<InvoicesByTripIdResponse>(
+            `/boapi/proxy/billing/fleets/${client.clientOptions.fleetId}/trips/${result.data}/invoices`
+        )
         .then(({ data }) => data);
 };

package/src/refund.ts

@@ -24,7 +24,6 @@ export const refund = async (client: Client, payload: Payload): Promise<void> =>
     }
 
     const filteredData = Object.fromEntries(
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
         Object.entries(result.data).filter(([_, value]) => value !== undefined && value !== null)
     );
 

package/src/types.ts

@@ -135,6 +135,86 @@ export type RefundableAmount = {
     refundedPaymentReceipts: Receipt[];
 };
 
+/** Billing line item returned by the trip invoices endpoint (nested in Billing array). */
+export type TripBillingItem = {
+    trip?: unknown;
+    product?: unknown;
+    vehiculeModelName?: string;
+    vehiculePlate?: string;
+    modelId?: string;
+    userId?: string;
+    withoutTaxAmountForDriving?: number;
+    withoutTaxAmountForStopover?: number;
+    withoutTaxAmountForBooking?: number;
+    withoutTaxForOvermileage?: number;
+    withoutTaxAmountForStartZoneFee?: number;
+    withoutTaxAmountForEndZoneFee?: number;
+    withoutTaxAmountForCancellationFee?: number;
+    withoutTaxAmountForScheduleTripFee?: number;
+    withoutTaxAmountForTripSystemCredit?: number;
+    withoutTaxAmountForBillingGroupDiscount?: number | null;
+    withTaxAmountForDriving?: number;
+    withTaxAmountForStopover?: number;
+    withTaxAmountForBooking?: number;
+    withTaxForOvermileage?: number;
+    withTaxAmountForStartZoneFee?: number;
+    withTaxAmountForEndZoneFee?: number;
+    withTaxAmountForCancellationFee?: number;
+    withTaxAmountForScheduleTripFee?: number;
+    withTaxAmountForTripSystemCredit?: number;
+    withTaxAmountForBillingGroupDiscount?: number;
+    withoutTaxInitialTotalAmount?: number;
+    withTaxInitialTotalAmount?: number;
+    taxInitialTotalAmount?: number;
+    paymentMethodType?: string;
+    walletId?: string | null;
+    totalTaxAmount?: number;
+    totalWithTax?: number;
+    totalWithoutTax?: number;
+    taxRate?: number;
+    taxName?: string;
+    withoutTaxAmountRideCost?: number;
+    withTaxAmountRideCost?: number;
+    taxAmountRideCost?: number;
+    products?: unknown[];
+    taxesPerRate?: unknown;
+    serviceId?: string | null;
+    profileId?: string | null;
+    profileType?: string | null;
+    profileName?: string | null;
+    withoutTaxUnlockFee?: number;
+    withTaxUnlockFee?: number;
+    taxUnlockFee?: number;
+    withTaxRefundAmount?: number | null;
+    isRefunded?: boolean;
+    cityName?: string | null;
+    cityId?: string | null;
+    tripBillingBreakdown?: unknown;
+    pricingId?: string;
+    netJourney?: number;
+    taxJourney?: number;
+    grossJourney?: number;
+    durationJourney?: number;
+    taxRemainingToBePaid?: number;
+    grossRemainingToBePaid?: number;
+    netRemainingToBePaid?: number;
+    overriddenTripInfo?: unknown;
+    interrupted?: boolean;
+    interruptedReason?: string | null;
+    invoice?: unknown;
+    distanceUnit?: string;
+    isTaxIncluded?: boolean;
+    [key: string]: unknown;
+};
+
+/** Response shape of GET .../trips/:tripId/invoices */
+export type InvoicesByTripIdResponse = {
+    balance: number;
+    userId: string;
+    entityId: string;
+    Billing: TripBillingItem[];
+};
+
 export type Wallet = {
     initialAmount: number;
     validityStartDate: string;

package/.eslintrc.cjs

@@ -1,112 +0,0 @@
-module.exports = {
-    parser: '@typescript-eslint/parser',
-    parserOptions: {
-        // Indicates the location of the TypeScript configuration file
-        project: 'tsconfig.json',
-        // Sets the root directory for the TypeScript configuration
-        tsconfigRootDir: __dirname,
-        // Specifies the version of ECMAScript syntax to be used
-        ecmaVersion: 'latest',
-        // Indicates the type of source code (script or module)
-        sourceType: 'module',
-    },
-    plugins: ['@typescript-eslint', 'prettier', 'import'],
-    extends: [
-        'airbnb-base',
-        'airbnb-typescript/base',
-        'plugin:@typescript-eslint/recommended',
-        'prettier',
-        'plugin:prettier/recommended',
-    ],
-    root: true,
-    env: {
-        es6: true,
-        node: true,
-    },
-    ignorePatterns: [
-        '/dist/**/*', // Ignore built files.
-        '.eslintrc.js',
-        '**/*.test.ts',
-    ],
-    rules: {
-        // Configures the Prettier integration with ESLint
-        'prettier/prettier': ['error', { endOfLine: 'auto' }],
-        // Disables the rule requiring an 'I' prefix for interfaces
-        '@typescript-eslint/interface-name-prefix': 'off',
-        // Configures the naming conventions for various code constructs
-        '@typescript-eslint/naming-convention': [
-            // ... various naming convention configurations ...
-            'error',
-            // Allows any naming format for destructured variables
-            {
-                selector: 'variable',
-                modifiers: ['destructured'],
-                format: null,
-            },
-            // Requires strict camelCase for function names
-            {
-                selector: 'function',
-                format: ['strictCamelCase'],
-            },
-            // Requires boolean variables to have one of the specified prefixes
-            {
-                selector: 'variable',
-                format: null,
-                types: ['boolean'],
-                prefix: ['is', 'should', 'has', 'can', 'did', 'will'],
-            },
-            // Requires enum names to have a strict PascalCase format
-            {
-                selector: 'enum',
-                format: ['StrictPascalCase'],
-            },
-        ],
-        'import/extensions': 'off',
-        // Disables the rule requiring explicit return types for functions
-        '@typescript-eslint/explicit-function-return-type': 'off',
-        // Disables the rule requiring explicit boundary types for modules
-        '@typescript-eslint/explicit-module-boundary-types': 'off',
-        // Disables the rule prohibiting the use of 'any' type
-        '@typescript-eslint/no-explicit-any': 'off',
-        // Disables the rule detecting unused variables
-        'no-unused-vars': 0,
-        // Disables the rule disallowing named exports used as a default export
-        'import/no-named-as-default': 0,
-        // Configures the order and formatting of import statements
-        'import/order': [
-            // ... import order configuration ...
-            'error',
-            {
-                // Configure the alphabetization settings
-                alphabetize: {
-                    // Enforce ascending alphabetical order
-                    order: 'asc',
-                    // Do not ignore the case while sorting
-                    caseInsensitive: false,
-                },
-                // Enforce newlines between different groups and inside groups of imports
-                'newlines-between': 'always-and-inside-groups',
-                // Warn when there is an import statement that is not part of any group
-                warnOnUnassignedImports: true,
-            },
-        ],
-        // Configures the rule detecting extraneous dependencies
-        'import/no-extraneous-dependencies': [
-            // ... extraneous dependencies configuration ...
-            'error',
-            {
-                // Specify the file patterns where devDependencies imports are allowed
-                devDependencies: [
-                    // Allow devDependencies imports in test and spec files
-                    '**/*.test.{ts,js}',
-                    '**/*.spec.{ts,js}',
-                    // Allow devDependencies imports in the 'test' folder
-                    './test/**.{ts,js}',
-                    // Allow devDependencies imports in the 'scripts' folder
-                    './scripts/**/*.{ts,js}',
-                ],
-            },
-        ],
-        'import/prefer-default-export': 'off',
-    },
-};