@intelact/driveup 2.4.8 → 2.5.0

package/lib/finance/payment-method.model.d.ts

@@ -1,10 +1,26 @@
+import { StatusType } from "@driveup/shared";
 import { CompanyPayment } from "./company-payment.model";
 import { Item } from "../item/item.model";
 export declare class CompanyPaymentMethod {
     id: number;
     name: string;
     icon: string;
+    /**
+     * Where the payment method stands
+     * - Pending: registered, still waiting for the provider to verify it
+     * - Active: verified by the provider, and the one the company is charged with
+     * - Inactive: verified by the provider, but replaced, deleted, expired or permanently declined
+     */
+    status: StatusType;
+    /**
+     * Whether this is the payment method the company is charged with
+     * @deprecated read {@link status} instead, this is kept for the clients that have not moved over yet
+     */
     active: boolean;
+    /**
+     * Whether the provider has yet to verify the payment method
+     * @deprecated read {@link status} instead, this is kept for the clients that have not moved over yet
+     */
     pending: boolean;
     details: Item[];
     warnings: string[];

package/lib/finance/payment-method.model.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CompanyPaymentMethod = void 0;
 const class_transformer_1 = require("class-transformer");
+const shared_1 = require("@driveup/shared");
 const company_payment_model_1 = require("./company-payment.model");
 const item_model_1 = require("../item/item.model");
 class CompanyPaymentMethod {
@@ -33,6 +34,10 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     __metadata("design:type", String)
 ], CompanyPaymentMethod.prototype, "icon", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], CompanyPaymentMethod.prototype, "status", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_transformer_1.Type)(() => Boolean),

package/lib/finance/payment-method.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-method.model.js","sourceRoot":"","sources":["../../src/finance/payment-method.model.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAiD;AACjD,mEAAyD;AACzD,mDAA0C;AAE1C,MAAa,oBAAoB;IA0ChC,6DAA6D;IAE7D,YAAY,KAAqC;QAChD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;CACD;AA/CD,oDA+CC;AA5CA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;gDACR;AAGX;IADC,IAAA,0BAAM,GAAE;;kDACI;AAGb;IADC,IAAA,0BAAM,GAAE;;kDACI;AAIb;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;oDACJ;AAIhB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;qDACH;AAIjB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,iBAAI,CAAC;;qDACD;AAGhB;IADC,IAAA,0BAAM,GAAE;;sDACU;AAInB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,sCAAc,CAAC;;4DACM;AAMjC;IADC,IAAA,0BAAM,GAAE;;uEACyB;AAGlC;IADC,IAAA,0BAAM,GAAE;;qEACuB;AAGhC;IADC,IAAA,0BAAM,GAAE;;gEACkB"}
+{"version":3,"file":"payment-method.model.js","sourceRoot":"","sources":["../../src/finance/payment-method.model.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAiD;AACjD,4CAA6C;AAC7C,mEAAyD;AACzD,mDAA0C;AAE1C,MAAa,oBAAoB;IA2DhC,6DAA6D;IAE7D,YAAY,KAAqC;QAChD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;CACD;AAhED,oDAgEC;AA7DA;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;gDACR;AAGX;IADC,IAAA,0BAAM,GAAE;;kDACI;AAGb;IADC,IAAA,0BAAM,GAAE;;kDACI;AASb;IADC,IAAA,0BAAM,GAAE;;oDACU;AAQnB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;oDACJ;AAQhB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;qDACH;AAIjB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,iBAAI,CAAC;;qDACD;AAGhB;IADC,IAAA,0BAAM,GAAE;;sDACU;AAInB;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,sCAAc,CAAC;;4DACM;AAMjC;IADC,IAAA,0BAAM,GAAE;;uEACyB;AAGlC;IADC,IAAA,0BAAM,GAAE;;qEACuB;AAGhC;IADC,IAAA,0BAAM,GAAE;;gEACkB"}

package/lib/index.d.ts

@@ -113,6 +113,7 @@ export { IUserAgent } from "./user/agent.interface";
 export { ArrayHelper } from "./utils/array.helper";
 export { CompareWithEndDate } from "./utils/compare.validator";
 export { DateHelper } from "./utils/date.helper";
+export { Money } from "./utils/money";
 export { PhoneHelper } from "./utils/phone.helper";
 export { EitherRequired, EitherRequiredConstraint, MutuallyRequired, MutuallyRequiredConstraint } from "./utils/required.validator";
 export { ToBoolean, ToEnum, ToEnumArray, ToNumber, ToNumberArray, ToStringArray, Trim } from "./utils/transformers.helper";

package/lib/index.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CourseDefinitionCreateDto = exports.CourseCreateDto = exports.CourseAppointmentFilterDto = exports.CoursePartDefinition = exports.Course = exports.CourseAppointment = exports.Country = exports.CountryUpdateDto = exports.CountrySearchDto = exports.CountryCreateDto = exports.CompanyCloseProfileDependency = exports.Company = exports.CompanyDashboardWidgetModel = exports.UrlDto = exports.SortOrderDto = exports.SortListDto = exports.SocialLinksDto = exports.SocialLink = exports.PhraseSearchDto = exports.PromotionCodeDto = exports.ProfileDependency = exports.PriceDto = exports.PhoneDto = exports.LanguageDto = exports.IDsDto = exports.EmailDto = exports.TranslateDto = exports.TitleDto = exports.NameDto = exports.MessageDto = exports.DescriptionDto = exports.BooleanValueDto = exports.AppInfo = exports.WorkingHoursDto = exports.WorkdayDefinition = exports.HolidaysDto = exports.Period = exports.ObligationPeriodDto = exports.MonthYearDto = exports.DateDto = exports.Appointment = exports.CompanyBill = exports.CompanyBillItem = exports.SignupDto = exports.SigninDto = exports.UserAlert = exports.AgentCode = exports.AgentClient = exports.Agent = exports.AgentClientsFilterDto = void 0;
 exports.FinanceFilterDto = exports.CompanyStudentDebtFilterDto = exports.CompanyOnlineTransactionFilterDto = exports.CompanyOnlineTransactionBulkUpdateDto = exports.CompanyFinancialFlowFilterDto = exports.CompanyBankInfoSubmitDto = exports.Expense = exports.SystemExpenseTranslationDto = exports.ExpenseUpdateDto = exports.ExpenseCreateDto = exports.CompanyExpenseFilterDto = exports.ExpenseCategoryTranslation = exports.ExpenseCategory = exports.Event = exports.TaskUpdateDto = exports.TaskFilterDto = exports.TaskCreateDto = exports.DrivingTopic = exports.TopicsSortDto = exports.TopicSubmitDto = exports.DrivingTopicFilterDto = exports.DrivingSkill = exports.SkillScoreDto = exports.CompanySkillSubmitDto = exports.DrivingLesson = exports.DrivingExam = exports.ExamStatusDto = exports.ExamFeedbackDto = exports.DrivingCategory = exports.SystemDrivingCategoryTranslationCreateDto = exports.SystemDrivingCategoryMinAgeDto = exports.SystemDrivingCategoryCreateDto = exports.CompanySubmitCategoryDto = exports.CompanyCategoryPriceDto = exports.CompanyCategoryDurationDto = exports.CompanyCategoryAdministrationFeeDto = exports.CompanyActivateCategoryDto = exports.SubmitDiscountDto = exports.DeviceSignatureDto = exports.Device = exports.Currency = exports.CurrencyUpdateDto = exports.CurrencySearchDto = exports.CurrencyCreateDto = exports.Credit = exports.CoursePart = exports.CoursePartDurationDto = exports.CourseMaxStudentsDto = exports.CourseFilterDto = exports.CourseDefinitionUpdateDto = void 0;
 exports.SettingValueDto = exports.DrivingSessionTopic = exports.DrivingSessionSkill = exports.DrivingSession = exports.InstructorDrivingAppointmentUpdateDto = exports.InstructorDrivingAppointmentCreateDto = exports.RoleDto = exports.SubmitRefundDto = exports.CountrySupportRequestDto = exports.ContactSalesRequestDto = exports.ContactUsRequestDto = exports.PricePlan = exports.SystemPricePlanSubmitDto = exports.PricePlanFilterDto = exports.AgentPayout = exports.SubmitPaymentDto = exports.CompanyPaymentMethod = exports.CompanyPayment = exports.NotificationPreference = exports.NotificationPreferenceDto = exports.Notification = exports.Metric = exports.Log = exports.License = exports.Item = exports.InvoiceItem = exports.Invoice = exports.CompanyInvoiceFilterDto = exports.Instructor = exports.InstructorInviteDto = exports.InstructorFilterDto = exports.InstructorCalendarFilterDto = exports.Handover = exports.HandoverSubmitDto = exports.GiftCode = exports.SystemGiftCodeSubmitDto = exports.SystemGiftCodeGroupUpdateDto = exports.SystemGiftCodeGroupCreateDto = exports.CompanyGiftCodeSubmitDto = exports.GiftCodeGroup = exports.PickupLocationsDto = exports.PickupLocation = exports.ZipCodeDto = exports.LocationDto = exports.FullAddressDto = exports.AddressDto = exports.FreeBenefit = exports.Finance = exports.HandoverTransactionStatusDto = exports.FinanceSortDto = void 0;
-exports.Trim = exports.ToStringArray = exports.ToNumberArray = exports.ToNumber = exports.ToEnumArray = exports.ToEnum = exports.ToBoolean = exports.MutuallyRequiredConstraint = exports.MutuallyRequired = exports.EitherRequiredConstraint = exports.EitherRequired = exports.PhoneHelper = exports.DateHelper = exports.CompareWithEndDate = exports.ArrayHelper = exports.User = exports.CreateProfileDto = exports.CloseProfileDto = exports.ChangeProfileDto = exports.Training = exports.TrainingRatingDto = exports.InstructorTrainingFilterDto = exports.DrivingTransmissionDto = exports.DrivingTrainingFilterDto = exports.CreateTrainingDto = exports.CreateDrivingTrainingDto = exports.CourseTrainingFilterDto = exports.CompanyTrainingFilterDto = exports.TrainingActions = exports.TrainingRequest = exports.TrainingRequestFilterDto = exports.Ticket = exports.TicketSubmitDto = exports.TicketFilterDto = exports.Student = exports.SubmitStudentDto = exports.FilterStudentDto = exports.Signature = exports.Setting = void 0;
+exports.Trim = exports.ToStringArray = exports.ToNumberArray = exports.ToNumber = exports.ToEnumArray = exports.ToEnum = exports.ToBoolean = exports.MutuallyRequiredConstraint = exports.MutuallyRequired = exports.EitherRequiredConstraint = exports.EitherRequired = exports.PhoneHelper = exports.Money = exports.DateHelper = exports.CompareWithEndDate = exports.ArrayHelper = exports.User = exports.CreateProfileDto = exports.CloseProfileDto = exports.ChangeProfileDto = exports.Training = exports.TrainingRatingDto = exports.InstructorTrainingFilterDto = exports.DrivingTransmissionDto = exports.DrivingTrainingFilterDto = exports.CreateTrainingDto = exports.CreateDrivingTrainingDto = exports.CourseTrainingFilterDto = exports.CompanyTrainingFilterDto = exports.TrainingActions = exports.TrainingRequest = exports.TrainingRequestFilterDto = exports.Ticket = exports.TicketSubmitDto = exports.TicketFilterDto = exports.Student = exports.SubmitStudentDto = exports.FilterStudentDto = exports.Signature = exports.Setting = void 0;
 var agent_dto_1 = require("./agent/agent.dto");
 Object.defineProperty(exports, "AgentClientsFilterDto", { enumerable: true, get: function () { return agent_dto_1.AgentClientsFilterDto; } });
 var agent_model_1 = require("./agent/agent.model");
@@ -291,6 +291,8 @@ var compare_validator_1 = require("./utils/compare.validator");
 Object.defineProperty(exports, "CompareWithEndDate", { enumerable: true, get: function () { return compare_validator_1.CompareWithEndDate; } });
 var date_helper_1 = require("./utils/date.helper");
 Object.defineProperty(exports, "DateHelper", { enumerable: true, get: function () { return date_helper_1.DateHelper; } });
+var money_1 = require("./utils/money");
+Object.defineProperty(exports, "Money", { enumerable: true, get: function () { return money_1.Money; } });
 var phone_helper_1 = require("./utils/phone.helper");
 Object.defineProperty(exports, "PhoneHelper", { enumerable: true, get: function () { return phone_helper_1.PhoneHelper; } });
 var required_validator_1 = require("./utils/required.validator");

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/utils/money.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Anything an amount of money can be read from. null and undefined read as 0
+ */
+type Amount = number | string | Money;
+/**
+ * An amount of money, and the rules amounts follow
+ * - Every calculation is done in decimal, never in binary: a JavaScript number cannot hold 0.1 + 0.2 or 30 / 28, and an
+ *   amount rounded after such a calculation can land on the wrong side of a rounding step
+ * - Immutable: every operation returns a new Money. An amount becomes a number again at the end of the calculation,
+ *   through `round`, `roundDown` or `toNumber`
+ * - Amounts are rounded at the end of a calculation, never per item along the way: the items of a bill or an invoice are
+ *   added up as they are, and the total is rounded once
+ * - This class exists twice, identically: here in @intelact/driveup (used by driveup-api) and in @driveup/common
+ *   (used by driveup-schema), because neither package may depend on the other. Change one, change the other
+ */
+export declare class Money {
+    #private;
+    private readonly amount;
+    /**
+     * Every rounded total is a multiple of this step
+     */
+    static readonly step = "0.05";
+    /**
+     * The step an amount is kept to when it is stored per item rather than charged: a bill item, an invoice line. Money
+     * columns hold 2 decimals, so an amount has to land on a cent before it is saved, while the totals it adds up to are
+     * rounded to {@link step}
+     */
+    static readonly cent = "0.01";
+    /**
+     * The decimals a rounding looks at. Anything beyond is noise rather than money: our smallest real amount is a
+     * millionth (an amount of 2 decimals times a tax rate of 2 decimals), while the binary noise a JavaScript number
+     * carries into a calculation is never larger than a ten-billionth for amounts up to a million
+     */
+    private static readonly noiseFreeDecimals;
+    private constructor();
+    /**
+     * Reads an amount: a number, the string a DECIMAL column is read as, or another Money
+     * - A number is read to 15 significant digits, the precision a JavaScript number really has. What lies beyond is
+     *   binary noise, and it must not survive: 0.1 + 0.2 is 0.30000000000000004, which would otherwise be rounded up a
+     *   whole step. A string is read exactly, digit for digit
+     * - null, undefined and an empty string read as 0
+     * @param value Amount - The amount to read
+     * @returns Money - The amount
+     * @throws when the value is not a number, or is not finite: an amount is never NaN or Infinity
+     */
+    static of(value: Amount): Money;
+    /**
+     * @param value Amount - The amount to add
+     * @returns Money - This amount plus the given one
+     */
+    add(value: Amount): Money;
+    /**
+     * @param value Amount - The amount to subtract
+     * @returns Money - This amount minus the given one
+     */
+    subtract(value: Amount): Money;
+    /**
+     * @param value Amount - The factor: an amount, or a plain number such as days or a quantity
+     * @returns Money - This amount times the given one
+     */
+    multiply(value: Amount): Money;
+    /**
+     * @param value Amount - The divisor: an amount, or a plain number such as the days of a month
+     * @returns Money - This amount divided by the given one, to 40 significant digits
+     * @throws when the divisor is 0
+     */
+    divide(value: Amount): Money;
+    /**
+     * The tax due on this amount, unrounded
+     * - The tax of several items is calculated per item, added up, and rounded once at the end
+     * @param vat Amount - The tax rate in percent: 8.1 for 8.1%. null and undefined read as no tax
+     * @returns Money - The tax
+     */
+    tax(vat: Amount): Money;
+    /**
+     * The amount rounded up to the next multiple of 0.05
+     * - An amount above a multiple goes up to the next one: 0.06 becomes 0.10, 0.96 becomes 1.00 and 0.056 becomes 0.10.
+     *   An amount that already is a multiple is kept. A negative amount is rounded away from zero
+     * - Only the first {@link noiseFreeDecimals} decimals decide: an amount is snapped to them first, so noise left by an
+     *   earlier calculation cannot push an amount that sits on a multiple up a whole step
+     * @param step Amount - The step to round to, 0.05 by default. Pass {@link cent} for an amount stored per item
+     * @returns number - The amount, a multiple of the step
+     */
+    round(step?: Amount): number;
+    /**
+     * The amount rounded down to the multiple of 0.05 at or below it
+     * - The exception to rounding up, for an amount that is taken rather than charged: what a company pays is rounded up,
+     *   but the credit taken from it is rounded down, so we never take credit it does not have. 12.29 of credit is taken
+     *   as 12.25, and the 0.04 stays in the company's credit
+     * - A negative amount is rounded towards zero the same way, and noise is dropped first, as in {@link round}
+     * @param step Amount - The step to round to, 0.05 by default
+     * @returns number - The amount, a multiple of the step
+     */
+    roundDown(step?: Amount): number;
+    /**
+     * The amount as a number, unrounded
+     * @returns number - The amount
+     */
+    toNumber(): number;
+}
+export {};

package/lib/utils/money.js

@@ -0,0 +1,150 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _Money_instances, _a, _Money_withoutNoise;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Money = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+// 40 significant digits, far more than any amount needs: a division such as 30 / 28 keeps every digit that could
+// still change a rounding step, and our amounts carry at most 15
+decimal_js_1.default.set({ precision: 40, rounding: decimal_js_1.default.ROUND_HALF_UP });
+/**
+ * An amount of money, and the rules amounts follow
+ * - Every calculation is done in decimal, never in binary: a JavaScript number cannot hold 0.1 + 0.2 or 30 / 28, and an
+ *   amount rounded after such a calculation can land on the wrong side of a rounding step
+ * - Immutable: every operation returns a new Money. An amount becomes a number again at the end of the calculation,
+ *   through `round`, `roundDown` or `toNumber`
+ * - Amounts are rounded at the end of a calculation, never per item along the way: the items of a bill or an invoice are
+ *   added up as they are, and the total is rounded once
+ * - This class exists twice, identically: here in @intelact/driveup (used by driveup-api) and in @driveup/common
+ *   (used by driveup-schema), because neither package may depend on the other. Change one, change the other
+ */
+class Money {
+    constructor(amount) {
+        _Money_instances.add(this);
+        this.amount = amount;
+    }
+    /**
+     * Reads an amount: a number, the string a DECIMAL column is read as, or another Money
+     * - A number is read to 15 significant digits, the precision a JavaScript number really has. What lies beyond is
+     *   binary noise, and it must not survive: 0.1 + 0.2 is 0.30000000000000004, which would otherwise be rounded up a
+     *   whole step. A string is read exactly, digit for digit
+     * - null, undefined and an empty string read as 0
+     * @param value Amount - The amount to read
+     * @returns Money - The amount
+     * @throws when the value is not a number, or is not finite: an amount is never NaN or Infinity
+     */
+    static of(value) {
+        if (value instanceof _a) {
+            return value;
+        }
+        if (value === null || value === undefined || value === '') {
+            return new _a(new decimal_js_1.default(0));
+        }
+        const amount = new decimal_js_1.default(typeof value === 'number' ? value.toPrecision(15) : String(value).trim());
+        if (!amount.isFinite()) {
+            throw new Error(`Money: ${value} is not a finite amount`);
+        }
+        return new _a(amount);
+    }
+    /**
+     * @param value Amount - The amount to add
+     * @returns Money - This amount plus the given one
+     */
+    add(value) {
+        return new _a(this.amount.plus(_a.of(value).amount));
+    }
+    /**
+     * @param value Amount - The amount to subtract
+     * @returns Money - This amount minus the given one
+     */
+    subtract(value) {
+        return new _a(this.amount.minus(_a.of(value).amount));
+    }
+    /**
+     * @param value Amount - The factor: an amount, or a plain number such as days or a quantity
+     * @returns Money - This amount times the given one
+     */
+    multiply(value) {
+        return new _a(this.amount.times(_a.of(value).amount));
+    }
+    /**
+     * @param value Amount - The divisor: an amount, or a plain number such as the days of a month
+     * @returns Money - This amount divided by the given one, to 40 significant digits
+     * @throws when the divisor is 0
+     */
+    divide(value) {
+        const divisor = _a.of(value);
+        if (divisor.amount.isZero()) {
+            throw new Error('Money: cannot divide by 0');
+        }
+        return new _a(this.amount.dividedBy(divisor.amount));
+    }
+    /**
+     * The tax due on this amount, unrounded
+     * - The tax of several items is calculated per item, added up, and rounded once at the end
+     * @param vat Amount - The tax rate in percent: 8.1 for 8.1%. null and undefined read as no tax
+     * @returns Money - The tax
+     */
+    tax(vat) {
+        return this.multiply(vat).divide(100);
+    }
+    /**
+     * The amount rounded up to the next multiple of 0.05
+     * - An amount above a multiple goes up to the next one: 0.06 becomes 0.10, 0.96 becomes 1.00 and 0.056 becomes 0.10.
+     *   An amount that already is a multiple is kept. A negative amount is rounded away from zero
+     * - Only the first {@link noiseFreeDecimals} decimals decide: an amount is snapped to them first, so noise left by an
+     *   earlier calculation cannot push an amount that sits on a multiple up a whole step
+     * @param step Amount - The step to round to, 0.05 by default. Pass {@link cent} for an amount stored per item
+     * @returns number - The amount, a multiple of the step
+     */
+    round(step = _a.step) {
+        return __classPrivateFieldGet(this, _Money_instances, "m", _Money_withoutNoise).call(this).toNearest(_a.of(step).amount, decimal_js_1.default.ROUND_UP).toNumber();
+    }
+    /**
+     * The amount rounded down to the multiple of 0.05 at or below it
+     * - The exception to rounding up, for an amount that is taken rather than charged: what a company pays is rounded up,
+     *   but the credit taken from it is rounded down, so we never take credit it does not have. 12.29 of credit is taken
+     *   as 12.25, and the 0.04 stays in the company's credit
+     * - A negative amount is rounded towards zero the same way, and noise is dropped first, as in {@link round}
+     * @param step Amount - The step to round to, 0.05 by default
+     * @returns number - The amount, a multiple of the step
+     */
+    roundDown(step = _a.step) {
+        return __classPrivateFieldGet(this, _Money_instances, "m", _Money_withoutNoise).call(this).toNearest(_a.of(step).amount, decimal_js_1.default.ROUND_DOWN).toNumber();
+    }
+    /**
+     * The amount as a number, unrounded
+     * @returns number - The amount
+     */
+    toNumber() {
+        return this.amount.toNumber();
+    }
+}
+exports.Money = Money;
+_a = Money, _Money_instances = new WeakSet(), _Money_withoutNoise = function _Money_withoutNoise() {
+    return this.amount.toDecimalPlaces(_a.noiseFreeDecimals, decimal_js_1.default.ROUND_HALF_UP);
+};
+/**
+ * Every rounded total is a multiple of this step
+ */
+Money.step = '0.05';
+/**
+ * The step an amount is kept to when it is stored per item rather than charged: a bill item, an invoice line. Money
+ * columns hold 2 decimals, so an amount has to land on a cent before it is saved, while the totals it adds up to are
+ * rounded to {@link step}
+ */
+Money.cent = '0.01';
+/**
+ * The decimals a rounding looks at. Anything beyond is noise rather than money: our smallest real amount is a
+ * millionth (an amount of 2 decimals times a tax rate of 2 decimals), while the binary noise a JavaScript number
+ * carries into a calculation is never larger than a ten-billionth for amounts up to a million
+ */
+Money.noiseFreeDecimals = 7;
+//# sourceMappingURL=money.js.map

package/lib/utils/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/utils/money.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intelact/driveup",
-  "version": "2.4.8",
+  "version": "2.5.0",
   "description": "Driveup Common",
   "author": "Intelact Solutions Ltd.",
   "main": "lib/index.js",
@@ -27,6 +27,7 @@
     "@driveup/shared": "^0.2.34",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
+    "decimal.js": "^10.6.0",
     "luxon": "^3.5.0",
     "reflect-metadata": "^0.2.2",
     "tslib": "^2.8.1"