@autologix-engineering/shared 1.2.355 → 1.2.356

package/src/lib/models/src/ltr.payout.model.js

@@ -10,6 +10,11 @@ export var LTRPayoutField;
     LTRPayoutField["BilledKM"] = "billedKM";
     LTRPayoutField["ExtraKM"] = "extraKM";
     LTRPayoutField["BillingSummary"] = "billingSummary";
+    LTRPayoutField["Status"] = "status";
+    LTRPayoutField["SignOffMethod"] = "signOffMethod";
+    LTRPayoutField["SignOffTimestamp"] = "signOffTimestamp";
+    LTRPayoutField["SignatureImageUrl"] = "signatureImageUrl";
+    LTRPayoutField["LockedReason"] = "lockedReason";
 })(LTRPayoutField || (LTRPayoutField = {}));
 export var LTRPayoutRowField;
 (function (LTRPayoutRowField) {
@@ -66,5 +71,22 @@ export var LTRPayoutRowField;
     LTRPayoutRowField["GarageStartKM"] = "Garage Start KM";
     LTRPayoutRowField["GarageReturnKM"] = "Garage Return KM";
     LTRPayoutRowField["ExtraHours"] = "extraHrs";
+    // Odometer photos. Kept as separate fields.
+    LTRPayoutRowField["StartKMImage"] = "Start KM Image";
+    LTRPayoutRowField["EndKMImage"] = "End KM Image";
+    LTRPayoutRowField["GarageStartKMImage"] = "Garage Start KM Image";
+    LTRPayoutRowField["GarageReturnKMImage"] = "Garage Return KM Image";
+    /**
+     * Rows entered together in one action share this id — a driver logging
+     * 27th-29th in one go produces three rows carrying the same GroupId, which
+     * is what lets the app show them as a single entry. Rows added one date at
+     * a time get their own id. Absent on every row written before grouping
+     * existed; those are treated as a group of one.
+     *
+     * Status, source and images live on LTRPayoutRowGroup, not here — these
+     * rows share one jsonb column, so storing them here would mean rewriting
+     * every row on the booking to sign one entry or attach one photo.
+     */
+    LTRPayoutRowField["GroupId"] = "groupId";
 })(LTRPayoutRowField || (LTRPayoutRowField = {}));
 //# sourceMappingURL=ltr.payout.model.js.map

package/src/lib/models/src/ltr.payout.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"ltr.payout.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.payout.model.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,cAWX;AAXD,WAAY,cAAc;IACzB,6CAA2B,CAAA;IAC3B,iDAA+B,CAAA;IAC/B,qCAAmB,CAAA;IACnB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,mDAAiC,CAAA;IACjC,qDAAmC,CAAA;IACnC,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,mDAAiC,CAAA;AAClC,CAAC,EAXW,cAAc,KAAd,cAAc,QAWzB;AA4BD,MAAM,CAAN,IAAY,iBAsDX;AAtDD,WAAY,iBAAiB;IAC5B,oCAAe,CAAA;IACf,iEAA4C,CAAA;IAC5C,6DAAwC,CAAA;IACxC,iDAA4B,CAAA;IAC5B,yCAAoB,CAAA;IACpB,qCAAgB,CAAA;IAChB,wCAAmB,CAAA;IACnB,kCAAa,CAAA;IACb,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,+CAA0B,CAAA;IAC1B,wCAAmB,CAAA;IACnB,2CAAsB,CAAA;IACtB,iDAA4B,CAAA;IAC5B,yDAAoC,CAAA;IACpC,iDAA4B,CAAA;IAC5B,0EAAqD,CAAA;IACrD,uEAAkD,CAAA;IAClD,2CAAsB,CAAA;IACtB,8FAAyE,CAAA;IACzE,6GAAwF,CAAA;IACxF,qDAAgC,CAAA;IAChC,mDAA8B,CAAA;IAC9B,uDAAkC,CAAA;IAClC,6CAAwB,CAAA;IACxB,4DAAuC,CAAA;IACvC,qDAAgC,CAAA;IAChC,gEAA2C,CAAA;IAC3C,oEAA+C,CAAA;IAC/C,yDAAoC,CAAA;IACpC,oEAA+C,CAAA;IAC/C,wEAAmD,CAAA;IACnD,+CAA0B,CAAA;IAC1B,iDAA4B,CAAA;IAC5B,uDAAkC,CAAA;IAClC,yDAAoC,CAAA;IACpC,qDAAgC,CAAA;IAChC,yDAAoC,CAAA;IACpC,sDAAiC,CAAA;IACjC,iDAA4B,CAAA;IAC5B,qEAAgD,CAAA;IAChD,uEAAkD,CAAA;IAClD,0DAAqC,CAAA;IACrC,0DAAqC,CAAA;IACrC,sDAAiC,CAAA;IACjC,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAC7B,kDAA6B,CAAA;IAC7B,4DAAuC,CAAA;IACvC,4DAAuC,CAAA;IACvC,sDAAiC,CAAA;IACjC,wDAAmC,CAAA;IACnC,4CAAuB,CAAA;AACxB,CAAC,EAtDW,iBAAiB,KAAjB,iBAAiB,QAsD5B"}
+{"version":3,"file":"ltr.payout.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.payout.model.ts"],"names":[],"mappings":"AASA,MAAM,CAAN,IAAY,cAgBX;AAhBD,WAAY,cAAc;IACzB,6CAA2B,CAAA;IAC3B,iDAA+B,CAAA;IAC/B,qCAAmB,CAAA;IACnB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,mDAAiC,CAAA;IACjC,qDAAmC,CAAA;IACnC,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,mDAAiC,CAAA;IACjC,mCAAiB,CAAA;IACjB,iDAA+B,CAAA;IAC/B,uDAAqC,CAAA;IACrC,yDAAuC,CAAA;IACvC,+CAA6B,CAAA;AAC9B,CAAC,EAhBW,cAAc,KAAd,cAAc,QAgBzB;AAsCD,MAAM,CAAN,IAAY,iBAuEX;AAvED,WAAY,iBAAiB;IAC5B,oCAAe,CAAA;IACf,iEAA4C,CAAA;IAC5C,6DAAwC,CAAA;IACxC,iDAA4B,CAAA;IAC5B,yCAAoB,CAAA;IACpB,qCAAgB,CAAA;IAChB,wCAAmB,CAAA;IACnB,kCAAa,CAAA;IACb,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,+CAA0B,CAAA;IAC1B,wCAAmB,CAAA;IACnB,2CAAsB,CAAA;IACtB,iDAA4B,CAAA;IAC5B,yDAAoC,CAAA;IACpC,iDAA4B,CAAA;IAC5B,0EAAqD,CAAA;IACrD,uEAAkD,CAAA;IAClD,2CAAsB,CAAA;IACtB,8FAAyE,CAAA;IACzE,6GAAwF,CAAA;IACxF,qDAAgC,CAAA;IAChC,mDAA8B,CAAA;IAC9B,uDAAkC,CAAA;IAClC,6CAAwB,CAAA;IACxB,4DAAuC,CAAA;IACvC,qDAAgC,CAAA;IAChC,gEAA2C,CAAA;IAC3C,oEAA+C,CAAA;IAC/C,yDAAoC,CAAA;IACpC,oEAA+C,CAAA;IAC/C,wEAAmD,CAAA;IACnD,+CAA0B,CAAA;IAC1B,iDAA4B,CAAA;IAC5B,uDAAkC,CAAA;IAClC,yDAAoC,CAAA;IACpC,qDAAgC,CAAA;IAChC,yDAAoC,CAAA;IACpC,sDAAiC,CAAA;IACjC,iDAA4B,CAAA;IAC5B,qEAAgD,CAAA;IAChD,uEAAkD,CAAA;IAClD,0DAAqC,CAAA;IACrC,0DAAqC,CAAA;IACrC,sDAAiC,CAAA;IACjC,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAC7B,kDAA6B,CAAA;IAC7B,4DAAuC,CAAA;IACvC,4DAAuC,CAAA;IACvC,sDAAiC,CAAA;IACjC,wDAAmC,CAAA;IACnC,4CAAuB,CAAA;IACvB,4CAA4C;IAC5C,oDAA+B,CAAA;IAC/B,gDAA2B,CAAA;IAC3B,iEAA4C,CAAA;IAC5C,mEAA8C,CAAA;IAC9C;;;;;;;;;;OAUG;IACH,wCAAmB,CAAA;AACpB,CAAC,EAvEW,iBAAiB,KAAjB,iBAAiB,QAuE5B"}

package/src/lib/models/src/ltr.payout.month.sign.off.model.d.ts

@@ -0,0 +1,85 @@
+import { LTRPayoutSignOffMethod } from '@autologix/shared/enums';
+import { ILTRPayout } from './ltr.payout.model';
+import { IRequest } from './request.model';
+export declare enum LTRPayoutMonthSignOffField {
+    MonthSignOffId = "monthSignOffId",
+    Payout = "payout",
+    PayoutId = "payoutId",
+    Request = "request",
+    RequestId = "requestId",
+    /** Registered user of the driver who signed. */
+    RegisteredUserId = "registeredUserId",
+    /** Their driver persona, resolved at sign-off time. */
+    DriverPersonaId = "driverPersonaId",
+    /** The month signed, as `YYYY-MM`. */
+    Month = "month",
+    /** First locked day, inclusive — start-of-day. */
+    LockFrom = "lockFrom",
+    /** Last locked day, inclusive — end-of-day. */
+    LockTo = "lockTo",
+    SignedOffAt = "signedOffAt",
+    SignOffMethod = "signOffMethod",
+    SignatureImageUrl = "signatureImageUrl",
+    /** Dates still missing or in draft when the driver chose to proceed. */
+    IncompleteDates = "incompleteDates",
+    /** How many of the driver's entries this sign-off settled. */
+    SignedEntryCount = "signedEntryCount",
+    CreatedAt = "createdAt",
+    UpdatedAt = "updatedAt"
+}
+/**
+ * One driver's monthly sign-off on one LTR booking. (AD-3206)
+ *
+ * Distinct from both the daily sign-off — which settles a single entry on
+ * `LTRPayoutRowGroup` — and the payout-wide sign-off held on `LTRPayout`,
+ * which settles the whole booking for the client.
+ *
+ * ### Why this is its own record rather than a status on the payout
+ *
+ * LTR bookings support driver replacement, so one booking and one month can
+ * have more than one driver. A driver signs off **his own days only**, and
+ * signing must not settle or lock another driver's days in the same month.
+ * `LTRPayout.status` is booking-wide and cannot express that; a per-(booking,
+ * driver, month) record can.
+ *
+ * ### Why the lock is a date range and not a month string
+ *
+ * After sign-off the driver may no longer create or edit a log in the locked
+ * period — including the days he left missing or in draft. Those days have no
+ * entry to hold a status, so the lock cannot live on `LTRPayoutRowGroup`
+ * either: a missing day is precisely the case with no group.
+ *
+ * `lockFrom`/`lockTo` hold the driver's **applicable** range within the month
+ * — the part of the month the booking covered and a replacement did not take
+ * from him — rather than the calendar month's bounds. Product had not settled
+ * which of the two the lock should mean when this was built (AD-3206 §5), so
+ * storing the range makes that a stored value rather than a code branch: to
+ * lock whole calendar months instead, widen these two columns at write time
+ * and every enforcement site follows.
+ */
+export interface ILTRPayoutMonthSignOff {
+    [LTRPayoutMonthSignOffField.MonthSignOffId]: string;
+    [LTRPayoutMonthSignOffField.Payout]: ILTRPayout;
+    [LTRPayoutMonthSignOffField.PayoutId]: string;
+    /** Denormalised so a lock can be checked without loading the payout. */
+    [LTRPayoutMonthSignOffField.Request]: IRequest;
+    [LTRPayoutMonthSignOffField.RequestId]: string;
+    [LTRPayoutMonthSignOffField.RegisteredUserId]: string;
+    [LTRPayoutMonthSignOffField.DriverPersonaId]: string;
+    [LTRPayoutMonthSignOffField.Month]: string;
+    [LTRPayoutMonthSignOffField.LockFrom]: Date;
+    [LTRPayoutMonthSignOffField.LockTo]: Date;
+    [LTRPayoutMonthSignOffField.SignedOffAt]: Date;
+    [LTRPayoutMonthSignOffField.SignOffMethod]?: LTRPayoutSignOffMethod;
+    /** Set only when the sign-off captured a signature. */
+    [LTRPayoutMonthSignOffField.SignatureImageUrl]?: string;
+    /**
+     * The `yyyy-MM-dd` dates that were still incomplete when the driver
+     * proceeded past the warning. Kept because the lock leaves them permanently
+     * unlogged — without this there is no record of what was given up.
+     */
+    [LTRPayoutMonthSignOffField.IncompleteDates]?: string[];
+    [LTRPayoutMonthSignOffField.SignedEntryCount]: number;
+    [LTRPayoutMonthSignOffField.CreatedAt]: Date;
+    [LTRPayoutMonthSignOffField.UpdatedAt]: Date;
+}

package/src/lib/models/src/ltr.payout.month.sign.off.model.js

@@ -0,0 +1,28 @@
+export var LTRPayoutMonthSignOffField;
+(function (LTRPayoutMonthSignOffField) {
+    LTRPayoutMonthSignOffField["MonthSignOffId"] = "monthSignOffId";
+    LTRPayoutMonthSignOffField["Payout"] = "payout";
+    LTRPayoutMonthSignOffField["PayoutId"] = "payoutId";
+    LTRPayoutMonthSignOffField["Request"] = "request";
+    LTRPayoutMonthSignOffField["RequestId"] = "requestId";
+    /** Registered user of the driver who signed. */
+    LTRPayoutMonthSignOffField["RegisteredUserId"] = "registeredUserId";
+    /** Their driver persona, resolved at sign-off time. */
+    LTRPayoutMonthSignOffField["DriverPersonaId"] = "driverPersonaId";
+    /** The month signed, as `YYYY-MM`. */
+    LTRPayoutMonthSignOffField["Month"] = "month";
+    /** First locked day, inclusive — start-of-day. */
+    LTRPayoutMonthSignOffField["LockFrom"] = "lockFrom";
+    /** Last locked day, inclusive — end-of-day. */
+    LTRPayoutMonthSignOffField["LockTo"] = "lockTo";
+    LTRPayoutMonthSignOffField["SignedOffAt"] = "signedOffAt";
+    LTRPayoutMonthSignOffField["SignOffMethod"] = "signOffMethod";
+    LTRPayoutMonthSignOffField["SignatureImageUrl"] = "signatureImageUrl";
+    /** Dates still missing or in draft when the driver chose to proceed. */
+    LTRPayoutMonthSignOffField["IncompleteDates"] = "incompleteDates";
+    /** How many of the driver's entries this sign-off settled. */
+    LTRPayoutMonthSignOffField["SignedEntryCount"] = "signedEntryCount";
+    LTRPayoutMonthSignOffField["CreatedAt"] = "createdAt";
+    LTRPayoutMonthSignOffField["UpdatedAt"] = "updatedAt";
+})(LTRPayoutMonthSignOffField || (LTRPayoutMonthSignOffField = {}));
+//# sourceMappingURL=ltr.payout.month.sign.off.model.js.map

package/src/lib/models/src/ltr.payout.month.sign.off.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltr.payout.month.sign.off.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.payout.month.sign.off.model.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,0BAyBX;AAzBD,WAAY,0BAA0B;IACrC,+DAAiC,CAAA;IACjC,+CAAiB,CAAA;IACjB,mDAAqB,CAAA;IACrB,iDAAmB,CAAA;IACnB,qDAAuB,CAAA;IACvB,gDAAgD;IAChD,mEAAqC,CAAA;IACrC,uDAAuD;IACvD,iEAAmC,CAAA;IACnC,sCAAsC;IACtC,6CAAe,CAAA;IACf,kDAAkD;IAClD,mDAAqB,CAAA;IACrB,+CAA+C;IAC/C,+CAAiB,CAAA;IACjB,yDAA2B,CAAA;IAC3B,6DAA+B,CAAA;IAC/B,qEAAuC,CAAA;IACvC,wEAAwE;IACxE,iEAAmC,CAAA;IACnC,8DAA8D;IAC9D,mEAAqC,CAAA;IACrC,qDAAuB,CAAA;IACvB,qDAAuB,CAAA;AACxB,CAAC,EAzBW,0BAA0B,KAA1B,0BAA0B,QAyBrC"}

package/src/lib/models/src/ltr.payout.row.group.model.d.ts

@@ -0,0 +1,73 @@
+import { LTRPayoutRowSource, LTRPayoutSignOffMethod, LTRPayoutStatus } from '@autologix/shared/enums';
+import { ILTRPayout } from './ltr.payout.model';
+import { ILTRPayoutRowImage } from './ltr.payout.row.image.model';
+import { IRequest } from './request.model';
+export declare enum LTRPayoutRowGroupField {
+    RowGroupId = "rowGroupId",
+    Payout = "payout",
+    PayoutId = "payoutId",
+    Request = "request",
+    RequestId = "requestId",
+    Status = "status",
+    Source = "source",
+    /** First date the entry covers, inclusive. */
+    StartDate = "startDate",
+    /** Last date the entry covers, inclusive. */
+    EndDate = "endDate",
+    /** How many payout rows the entry produced — one per calendar date. */
+    RowCount = "rowCount",
+    Images = "images",
+    /** Registered user of the driver who made this entry. */
+    CreatedByRegisteredUserId = "createdByRegisteredUserId",
+    SignedOffAt = "signedOffAt",
+    SignOffMethod = "signOffMethod",
+    SignatureImageUrl = "signatureImageUrl",
+    CreatedAt = "createdAt",
+    UpdatedAt = "updatedAt"
+}
+/**
+ * One entry the driver made in the LTR app, however many dates it covers.
+ *
+ * A garage window of 17 Aug 00:00 → 17 Aug 23:59 produces one group and one
+ * payout row. A window of 27 Aug → 29 Aug produces one group and three payout
+ * rows, each stamped with this group's id in `LTRPayoutRowField.GroupId`. The
+ * app shows one menu item per group, which is why the grouping has to be
+ * recorded rather than inferred from the dates.
+ *
+ * Status and images live here, not on the rows. The rows sit inside a single
+ * jsonb array on LTRPayout, so putting either there would mean rewriting every
+ * row on the booking to sign one entry or attach one photo.
+ *
+ * Rows with no group predate this and came from the Excel upload or the
+ * webapp: the absence of a group is what marks them as the admin's record.
+ */
+export interface ILTRPayoutRowGroup {
+    [LTRPayoutRowGroupField.RowGroupId]: string;
+    [LTRPayoutRowGroupField.Payout]: ILTRPayout;
+    [LTRPayoutRowGroupField.PayoutId]: string;
+    /** Denormalised so the app can list a booking's entries without the payout. */
+    [LTRPayoutRowGroupField.Request]: IRequest;
+    [LTRPayoutRowGroupField.RequestId]: string;
+    [LTRPayoutRowGroupField.Status]: LTRPayoutStatus;
+    [LTRPayoutRowGroupField.Source]: LTRPayoutRowSource;
+    [LTRPayoutRowGroupField.StartDate]: Date;
+    [LTRPayoutRowGroupField.EndDate]: Date;
+    [LTRPayoutRowGroupField.RowCount]: number;
+    [LTRPayoutRowGroupField.Images]?: ILTRPayoutRowImage[];
+    /**
+     * The driver who made this entry, as their registered user id.
+     *
+     * Only they may edit it or sign it off. A booking can change hands through
+     * replacement, so "assigned to this booking" is not the same question as
+     * "recorded this entry" — the second is what ownership of an entry means.
+     *
+     * Absent on entries written before this was recorded.
+     */
+    [LTRPayoutRowGroupField.CreatedByRegisteredUserId]?: string;
+    [LTRPayoutRowGroupField.SignedOffAt]?: Date;
+    [LTRPayoutRowGroupField.SignOffMethod]?: LTRPayoutSignOffMethod;
+    /** Set only when the daily sign-off captured a signature. */
+    [LTRPayoutRowGroupField.SignatureImageUrl]?: string;
+    [LTRPayoutRowGroupField.CreatedAt]: Date;
+    [LTRPayoutRowGroupField.UpdatedAt]: Date;
+}

package/src/lib/models/src/ltr.payout.row.group.model.js

@@ -0,0 +1,25 @@
+export var LTRPayoutRowGroupField;
+(function (LTRPayoutRowGroupField) {
+    LTRPayoutRowGroupField["RowGroupId"] = "rowGroupId";
+    LTRPayoutRowGroupField["Payout"] = "payout";
+    LTRPayoutRowGroupField["PayoutId"] = "payoutId";
+    LTRPayoutRowGroupField["Request"] = "request";
+    LTRPayoutRowGroupField["RequestId"] = "requestId";
+    LTRPayoutRowGroupField["Status"] = "status";
+    LTRPayoutRowGroupField["Source"] = "source";
+    /** First date the entry covers, inclusive. */
+    LTRPayoutRowGroupField["StartDate"] = "startDate";
+    /** Last date the entry covers, inclusive. */
+    LTRPayoutRowGroupField["EndDate"] = "endDate";
+    /** How many payout rows the entry produced — one per calendar date. */
+    LTRPayoutRowGroupField["RowCount"] = "rowCount";
+    LTRPayoutRowGroupField["Images"] = "images";
+    /** Registered user of the driver who made this entry. */
+    LTRPayoutRowGroupField["CreatedByRegisteredUserId"] = "createdByRegisteredUserId";
+    LTRPayoutRowGroupField["SignedOffAt"] = "signedOffAt";
+    LTRPayoutRowGroupField["SignOffMethod"] = "signOffMethod";
+    LTRPayoutRowGroupField["SignatureImageUrl"] = "signatureImageUrl";
+    LTRPayoutRowGroupField["CreatedAt"] = "createdAt";
+    LTRPayoutRowGroupField["UpdatedAt"] = "updatedAt";
+})(LTRPayoutRowGroupField || (LTRPayoutRowGroupField = {}));
+//# sourceMappingURL=ltr.payout.row.group.model.js.map

package/src/lib/models/src/ltr.payout.row.group.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltr.payout.row.group.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.payout.row.group.model.ts"],"names":[],"mappings":"AASA,MAAM,CAAN,IAAY,sBAsBX;AAtBD,WAAY,sBAAsB;IACjC,mDAAyB,CAAA;IACzB,2CAAiB,CAAA;IACjB,+CAAqB,CAAA;IACrB,6CAAmB,CAAA;IACnB,iDAAuB,CAAA;IACvB,2CAAiB,CAAA;IACjB,2CAAiB,CAAA;IACjB,8CAA8C;IAC9C,iDAAuB,CAAA;IACvB,6CAA6C;IAC7C,6CAAmB,CAAA;IACnB,uEAAuE;IACvE,+CAAqB,CAAA;IACrB,2CAAiB,CAAA;IACjB,yDAAyD;IACzD,iFAAuD,CAAA;IACvD,qDAA2B,CAAA;IAC3B,yDAA+B,CAAA;IAC/B,iEAAuC,CAAA;IACvC,iDAAuB,CAAA;IACvB,iDAAuB,CAAA;AACxB,CAAC,EAtBW,sBAAsB,KAAtB,sBAAsB,QAsBjC"}

package/src/lib/models/src/ltr.payout.row.image.model.d.ts

@@ -0,0 +1,34 @@
+import { IFile } from './file.model';
+import { ILTRPayoutRowGroup } from './ltr.payout.row.group.model';
+export declare enum LTRPayoutRowImageField {
+    RowImageId = "rowImageId",
+    Group = "group",
+    GroupId = "groupId",
+    Type = "type",
+    Files = "files",
+    CreatedAt = "createdAt",
+    UpdatedAt = "updatedAt"
+}
+/**
+ * The photos attached to one entry for one purpose — all the start-KM shots,
+ * all the toll receipts, and so on.
+ *
+ * One row per (group, type), holding every file for that type, because a
+ * driver may photograph the same reading two or three times. Attaching another
+ * photo rewrites only this row rather than the booking's whole payout array.
+ *
+ * `Type` is free text, not a database enum. The four odometer readings are
+ * fixed and come from LTRPayoutRowImageType, but expense proofs are named
+ * after the expense, and those are configured per client — a Postgres enum
+ * would need altering every time a client adds one.
+ */
+export interface ILTRPayoutRowImage {
+    [LTRPayoutRowImageField.RowImageId]: string;
+    [LTRPayoutRowImageField.Group]: ILTRPayoutRowGroup;
+    [LTRPayoutRowImageField.GroupId]: string;
+    /** `LTRPayoutRowImageType` for odometer shots, else the expense name. */
+    [LTRPayoutRowImageField.Type]: string;
+    [LTRPayoutRowImageField.Files]: IFile[];
+    [LTRPayoutRowImageField.CreatedAt]: Date;
+    [LTRPayoutRowImageField.UpdatedAt]: Date;
+}

package/src/lib/models/src/ltr.payout.row.image.model.js

@@ -0,0 +1,11 @@
+export var LTRPayoutRowImageField;
+(function (LTRPayoutRowImageField) {
+    LTRPayoutRowImageField["RowImageId"] = "rowImageId";
+    LTRPayoutRowImageField["Group"] = "group";
+    LTRPayoutRowImageField["GroupId"] = "groupId";
+    LTRPayoutRowImageField["Type"] = "type";
+    LTRPayoutRowImageField["Files"] = "files";
+    LTRPayoutRowImageField["CreatedAt"] = "createdAt";
+    LTRPayoutRowImageField["UpdatedAt"] = "updatedAt";
+})(LTRPayoutRowImageField || (LTRPayoutRowImageField = {}));
+//# sourceMappingURL=ltr.payout.row.image.model.js.map

package/src/lib/models/src/ltr.payout.row.image.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltr.payout.row.image.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.payout.row.image.model.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,sBAQX;AARD,WAAY,sBAAsB;IACjC,mDAAyB,CAAA;IACzB,yCAAe,CAAA;IACf,6CAAmB,CAAA;IACnB,uCAAa,CAAA;IACb,yCAAe,CAAA;IACf,iDAAuB,CAAA;IACvB,iDAAuB,CAAA;AACxB,CAAC,EARW,sBAAsB,KAAtB,sBAAsB,QAQjC"}

package/src/lib/models/src/ltr.vehicle.master.model.d.ts

@@ -13,6 +13,7 @@ export declare enum LTRVehicleMasterField {
     ClientId = "clientId",
     StartDate = "startDate",
     EndDate = "endDate",
+    LTRStartMonth = "ltrStartMonth",
     Driver = "driver",
     DriverId = "driverId",
     Renter = "renter",
@@ -64,6 +65,7 @@ export interface ILTRVehicleMaster extends TypedModel {
     [LTRVehicleMasterField.ClientId]: string;
     [LTRVehicleMasterField.StartDate]: Date;
     [LTRVehicleMasterField.EndDate]?: Date;
+    [LTRVehicleMasterField.LTRStartMonth]?: Date;
     [LTRVehicleMasterField.Driver]: IDriverPersona;
     [LTRVehicleMasterField.DriverId]: string;
     [LTRVehicleMasterField.Renter]?: IPassenger;

package/src/lib/models/src/ltr.vehicle.master.model.js

@@ -6,6 +6,7 @@ export var LTRVehicleMasterField;
     LTRVehicleMasterField["ClientId"] = "clientId";
     LTRVehicleMasterField["StartDate"] = "startDate";
     LTRVehicleMasterField["EndDate"] = "endDate";
+    LTRVehicleMasterField["LTRStartMonth"] = "ltrStartMonth";
     LTRVehicleMasterField["Driver"] = "driver";
     LTRVehicleMasterField["DriverId"] = "driverId";
     LTRVehicleMasterField["Renter"] = "renter";

package/src/lib/models/src/ltr.vehicle.master.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"ltr.vehicle.master.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.vehicle.master.model.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAN,IAAY,qBAkDX;AAlDD,WAAY,qBAAqB;IAChC,4DAAmC,CAAA;IACnC,sEAA6C,CAAA;IAC7C,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,gDAAuB,CAAA;IACvB,4CAAmB,CAAA;IACnB,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,yEAAgD,CAAA;IAChD,8CAAqB,CAAA;IACrB,kDAAyB,CAAA;IACzB,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,0DAAiC,CAAA;IACjC,sDAA6B,CAAA;IAC7B,wEAA+C,CAAA;IAC/C,4EAAmD,CAAA;IACnD,gDAAuB,CAAA;IACvB,4CAAmB,CAAA;IACnB,wDAA+B,CAAA;IAC/B,kDAAyB,CAAA;IACzB,sEAA6C,CAAA;IAC7C,sEAA6C,CAAA;IAC7C,kEAAyC,CAAA;IACzC,0DAAiC,CAAA;IACjC,0EAAiD,CAAA;IACjD,0CAAiB,CAAA;IACjB,sDAA6B,CAAA;IAC7B,0DAAiC,CAAA;IACjC,sDAA6B,CAAA;IAC7B,0DAAiC,CAAA;IACjC,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,sDAA6B,CAAA;IAC7B,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,8CAAqB,CAAA;IACrB,kEAAyC,CAAA;IACzC,oDAA2B,CAAA;IAC3B,kEAAyC,CAAA;IACzC,8CAAqB,CAAA;IACrB,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;AAClB,CAAC,EAlDW,qBAAqB,KAArB,qBAAqB,QAkDhC"}
+{"version":3,"file":"ltr.vehicle.master.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.vehicle.master.model.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAN,IAAY,qBAmDX;AAnDD,WAAY,qBAAqB;IAChC,4DAAmC,CAAA;IACnC,sEAA6C,CAAA;IAC7C,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,gDAAuB,CAAA;IACvB,4CAAmB,CAAA;IACnB,wDAA+B,CAAA;IAC/B,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,yEAAgD,CAAA;IAChD,8CAAqB,CAAA;IACrB,kDAAyB,CAAA;IACzB,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,0DAAiC,CAAA;IACjC,sDAA6B,CAAA;IAC7B,wEAA+C,CAAA;IAC/C,4EAAmD,CAAA;IACnD,gDAAuB,CAAA;IACvB,4CAAmB,CAAA;IACnB,wDAA+B,CAAA;IAC/B,kDAAyB,CAAA;IACzB,sEAA6C,CAAA;IAC7C,sEAA6C,CAAA;IAC7C,kEAAyC,CAAA;IACzC,0DAAiC,CAAA;IACjC,0EAAiD,CAAA;IACjD,0CAAiB,CAAA;IACjB,sDAA6B,CAAA;IAC7B,0DAAiC,CAAA;IACjC,sDAA6B,CAAA;IAC7B,0DAAiC,CAAA;IACjC,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,sDAA6B,CAAA;IAC7B,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,8CAAqB,CAAA;IACrB,kEAAyC,CAAA;IACzC,oDAA2B,CAAA;IAC3B,kEAAyC,CAAA;IACzC,8CAAqB,CAAA;IACrB,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;AAClB,CAAC,EAnDW,qBAAqB,KAArB,qBAAqB,QAmDhC"}

package/src/lib/models/src/passenger.persona.model.d.ts

@@ -7,7 +7,7 @@ import { IPassenger } from './passenger.model';
 import { IPassengerPersonaFile } from './passenger.persona.file.model';
 import { IPickup } from './pickup.model';
 import { IPickupRequest } from './pickup.request.model';
-import { BloodGroup, PersonaRelationType, PersonaStatus } from '../../enums/src/index';
+import { BloodGroup, PassengerBookerAss, PersonaRelationType, PersonaStatus } from '../../enums/src/index';
 import { TypedModel } from './typed.model';
 import { IClientPersona } from './client.persona.model';
 import { IVendorPersona } from './vendor.persona.model';
@@ -74,7 +74,15 @@ export declare enum PassengerPersonaField {
     PoliceVerification = "policeVerification",
     Bookers = "bookers",
     Passengers = "passengers",
-    OrganizationDetails = "orgDetails"
+    OrganizationDetails = "orgDetails",
+    PassengerBookerAss = "passengerBookerAss",
+    CreateBooker = "crtBkr",
+    CreatePassenger = "crtPsngr",
+    ManageProfile = "mngProfile",
+    CreateBooking = "crtBk",
+    UpdateBooking = "updBk",
+    CancelBooking = "cnclBk",
+    ViewInvoice = "viewInvoice"
 }
 export interface IPassengerPersona extends TypedModel {
     [PassengerPersonaField.PassengerPersonaId]: string;
@@ -134,6 +142,14 @@ export interface IPassengerPersona extends TypedModel {
     [PassengerPersonaField.Bookers]: IPassengerPersona[];
     [PassengerPersonaField.Passengers]: IPassengerPersona[];
     [PassengerPersonaField.OrganizationDetails]?: IOrgDetails;
+    [PassengerPersonaField.PassengerBookerAss]: PassengerBookerAss;
+    [PassengerPersonaField.CreateBooker]: boolean;
+    [PassengerPersonaField.CreatePassenger]: boolean;
+    [PassengerPersonaField.ManageProfile]: boolean;
+    [PassengerPersonaField.CreateBooking]: boolean;
+    [PassengerPersonaField.UpdateBooking]: boolean;
+    [PassengerPersonaField.CancelBooking]: boolean;
+    [PassengerPersonaField.ViewInvoice]: boolean;
 }
 export interface IOrgDetails {
     organizationName: string;

package/src/lib/models/src/passenger.persona.model.js

@@ -61,5 +61,13 @@ export var PassengerPersonaField;
     PassengerPersonaField["Bookers"] = "bookers";
     PassengerPersonaField["Passengers"] = "passengers";
     PassengerPersonaField["OrganizationDetails"] = "orgDetails";
+    PassengerPersonaField["PassengerBookerAss"] = "passengerBookerAss";
+    PassengerPersonaField["CreateBooker"] = "crtBkr";
+    PassengerPersonaField["CreatePassenger"] = "crtPsngr";
+    PassengerPersonaField["ManageProfile"] = "mngProfile";
+    PassengerPersonaField["CreateBooking"] = "crtBk";
+    PassengerPersonaField["UpdateBooking"] = "updBk";
+    PassengerPersonaField["CancelBooking"] = "cnclBk";
+    PassengerPersonaField["ViewInvoice"] = "viewInvoice";
 })(PassengerPersonaField || (PassengerPersonaField = {}));
 //# sourceMappingURL=passenger.persona.model.js.map

package/src/lib/models/src/passenger.persona.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"passenger.persona.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/passenger.persona.model.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAN,IAAY,qBAqEX;AArED,WAAY,qBAAqB;IAChC,8DAAqC,CAAA;IACrC,sCAAa,CAAA;IACb,wCAAe,CAAA;IACf,iDAAwB,CAAA;IAExB,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;IACjB,+DAAsC,CAAA;IACtC,yCAAgB,CAAA;IAChB,6CAAoB,CAAA;IACpB,uCAAc,CAAA;IACd,2CAAkB,CAAA;IAElB,gDAAuB,CAAA;IACvB,oDAA2B,CAAA;IAC3B,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,0DAAiC,CAAA;IACjC,sDAA6B,CAAA;IAC7B,4CAAmB,CAAA;IACnB,wCAAe,CAAA;IACf,gDAAuB,CAAA;IACvB,oDAA2B,CAAA;IAC3B,4CAAmB,CAAA;IACnB,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IAEvB,gDAAuB,CAAA;IACvB,qDAA4B,CAAA;IAE5B,0DAAiC,CAAA;IACjC,wDAA+B,CAAA;IAE/B,oDAA2B,CAAA;IAC3B,wCAAe,CAAA;IAEf,sDAA6B,CAAA;IAC7B,8CAAqB,CAAA;IACrB,0DAAiC,CAAA;IACjC,4DAAmC,CAAA;IACnC,gDAAuB,CAAA;IAEvB,YAAY;IACZ,gDAAuB,CAAA;IACvB,8CAAqB,CAAA;IACrB,oEAA2C,CAAA;IAC3C,oEAA2C,CAAA;IAC3C,oDAA2B,CAAA;IAC3B,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,wDAA+B,CAAA;IAC/B,4DAAmC,CAAA;IACnC,oDAA2B,CAAA;IAC3B,oDAA2B,CAAA;IAC3B,wDAA+B,CAAA;IAC/B,wCAAe,CAAA;IACf,4CAAmB,CAAA;IACnB,wDAA+B,CAAA;IAC/B,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,wCAAe,CAAA;IACf,sEAA6C,CAAA;IAC7C,sEAA6C,CAAA;IAC7C,kEAAyC,CAAA;IACzC,4CAAmB,CAAA;IACnB,kDAAyB,CAAA;IACzB,2DAAkC,CAAA;AACnC,CAAC,EArEW,qBAAqB,KAArB,qBAAqB,QAqEhC"}
+{"version":3,"file":"passenger.persona.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/passenger.persona.model.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAN,IAAY,qBA6EX;AA7ED,WAAY,qBAAqB;IAChC,8DAAqC,CAAA;IACrC,sCAAa,CAAA;IACb,wCAAe,CAAA;IACf,iDAAwB,CAAA;IAExB,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;IACjB,+DAAsC,CAAA;IACtC,yCAAgB,CAAA;IAChB,6CAAoB,CAAA;IACpB,uCAAc,CAAA;IACd,2CAAkB,CAAA;IAElB,gDAAuB,CAAA;IACvB,oDAA2B,CAAA;IAC3B,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,0DAAiC,CAAA;IACjC,sDAA6B,CAAA;IAC7B,4CAAmB,CAAA;IACnB,wCAAe,CAAA;IACf,gDAAuB,CAAA;IACvB,oDAA2B,CAAA;IAC3B,4CAAmB,CAAA;IACnB,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IAEvB,gDAAuB,CAAA;IACvB,qDAA4B,CAAA;IAE5B,0DAAiC,CAAA;IACjC,wDAA+B,CAAA;IAE/B,oDAA2B,CAAA;IAC3B,wCAAe,CAAA;IAEf,sDAA6B,CAAA;IAC7B,8CAAqB,CAAA;IACrB,0DAAiC,CAAA;IACjC,4DAAmC,CAAA;IACnC,gDAAuB,CAAA;IAEvB,YAAY;IACZ,gDAAuB,CAAA;IACvB,8CAAqB,CAAA;IACrB,oEAA2C,CAAA;IAC3C,oEAA2C,CAAA;IAC3C,oDAA2B,CAAA;IAC3B,sCAAa,CAAA;IACb,0CAAiB,CAAA;IACjB,wDAA+B,CAAA;IAC/B,4DAAmC,CAAA;IACnC,oDAA2B,CAAA;IAC3B,oDAA2B,CAAA;IAC3B,wDAA+B,CAAA;IAC/B,wCAAe,CAAA;IACf,4CAAmB,CAAA;IACnB,wDAA+B,CAAA;IAC/B,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,wCAAe,CAAA;IACf,sEAA6C,CAAA;IAC7C,sEAA6C,CAAA;IAC7C,kEAAyC,CAAA;IACzC,4CAAmB,CAAA;IACnB,kDAAyB,CAAA;IACzB,2DAAkC,CAAA;IAClC,kEAAyC,CAAA;IACzC,gDAAuB,CAAA;IACvB,qDAA4B,CAAA;IAC5B,qDAA4B,CAAA;IAC5B,gDAAuB,CAAA;IACvB,gDAAuB,CAAA;IACvB,iDAAwB,CAAA;IACxB,oDAA2B,CAAA;AAC5B,CAAC,EA7EW,qBAAqB,KAArB,qBAAqB,QA6EhC"}

package/src/lib/models/src/retry.task.model.d.ts

@@ -0,0 +1,56 @@
+import { RetryTaskStatus, RetryTaskType } from '@autologix/shared/enums';
+import { TypedModel } from './typed.model';
+export declare enum RetryTaskField {
+    RetryTaskId = "retryTaskId",
+    /** Which operation to replay — selects the processor's handler. */
+    Type = "type",
+    /** Booking the failed operation belongs to (plain id, like AlertFallback). */
+    RequestId = "requestId",
+    /**
+     * Everything the handler needs to replay the operation without re-deriving
+     * it (e.g. the duty slip URL + tripId). Recording this at failure time is
+     * what lets the processor run off one indexed scan instead of reconstructing
+     * failures from activity logs.
+     */
+    Payload = "payload",
+    Status = "status",
+    /** Attempts made so far; bounded by maxAttempts. */
+    Attempts = "attempts",
+    MaxAttempts = "maxAttempts",
+    /** Earliest time the next attempt may run — drives the backoff. */
+    NextAttemptAt = "nextAttemptAt",
+    /** Why the last attempt failed, for triage. */
+    LastError = "lastError",
+    CreatedAt = "createdAt",
+    UpdatedAt = "updatedAt"
+}
+/** Context for a RetryTaskType.ExtDutySlipUpload row. */
+export interface IExtDutySlipRetryPayload {
+    /** Trip whose DutySlipFile / ExtDutyLip need stamping. */
+    tripId: string;
+    /** Original slip URL from the external trip sheet payload. */
+    url: string;
+    /** Booking number, used for the upload filename and logging. */
+    requestNumber?: string;
+    /** HTTP status of the failed download, when the failure was the fetch. */
+    httpStatus?: number;
+    /**
+     * Step that failed: 'download' is MMI's URL being unavailable, 'upload' is
+     * our files-service, 'stamp' is the trip write. Lets triage separate
+     * unrecoverable sources from transient outages without reading logs.
+     */
+    failedAt?: 'download' | 'upload' | 'stamp';
+}
+export interface IRetryTask extends TypedModel {
+    [RetryTaskField.RetryTaskId]: string;
+    [RetryTaskField.Type]: RetryTaskType;
+    [RetryTaskField.RequestId]?: string;
+    [RetryTaskField.Payload]?: Record<string, any>;
+    [RetryTaskField.Status]: RetryTaskStatus;
+    [RetryTaskField.Attempts]: number;
+    [RetryTaskField.MaxAttempts]: number;
+    [RetryTaskField.NextAttemptAt]: Date;
+    [RetryTaskField.LastError]?: string;
+    [RetryTaskField.CreatedAt]: Date;
+    [RetryTaskField.UpdatedAt]: Date;
+}

package/src/lib/models/src/retry.task.model.js

@@ -0,0 +1,26 @@
+export var RetryTaskField;
+(function (RetryTaskField) {
+    RetryTaskField["RetryTaskId"] = "retryTaskId";
+    /** Which operation to replay — selects the processor's handler. */
+    RetryTaskField["Type"] = "type";
+    /** Booking the failed operation belongs to (plain id, like AlertFallback). */
+    RetryTaskField["RequestId"] = "requestId";
+    /**
+     * Everything the handler needs to replay the operation without re-deriving
+     * it (e.g. the duty slip URL + tripId). Recording this at failure time is
+     * what lets the processor run off one indexed scan instead of reconstructing
+     * failures from activity logs.
+     */
+    RetryTaskField["Payload"] = "payload";
+    RetryTaskField["Status"] = "status";
+    /** Attempts made so far; bounded by maxAttempts. */
+    RetryTaskField["Attempts"] = "attempts";
+    RetryTaskField["MaxAttempts"] = "maxAttempts";
+    /** Earliest time the next attempt may run — drives the backoff. */
+    RetryTaskField["NextAttemptAt"] = "nextAttemptAt";
+    /** Why the last attempt failed, for triage. */
+    RetryTaskField["LastError"] = "lastError";
+    RetryTaskField["CreatedAt"] = "createdAt";
+    RetryTaskField["UpdatedAt"] = "updatedAt";
+})(RetryTaskField || (RetryTaskField = {}));
+//# sourceMappingURL=retry.task.model.js.map

package/src/lib/models/src/retry.task.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.task.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/retry.task.model.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,cAuBX;AAvBD,WAAY,cAAc;IACzB,6CAA2B,CAAA;IAC3B,mEAAmE;IACnE,+BAAa,CAAA;IACb,8EAA8E;IAC9E,yCAAuB,CAAA;IACvB;;;;;OAKG;IACH,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;IACjB,oDAAoD;IACpD,uCAAqB,CAAA;IACrB,6CAA2B,CAAA;IAC3B,mEAAmE;IACnE,iDAA+B,CAAA;IAC/B,+CAA+C;IAC/C,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;AACxB,CAAC,EAvBW,cAAc,KAAd,cAAc,QAuBzB"}

package/src/lib/models/src/tds.config.activity.log.model.d.ts

@@ -0,0 +1,34 @@
+import { ITdsConfig } from './tds.config.model';
+import { TypedModel } from './typed.model';
+export declare enum TdsConfigActivityLogField {
+    LogId = "logId",
+    TdsConfig = "tdsConfig",
+    TdsConfigId = "tdsConfigId",
+    Date = "date",
+    Field = "field",
+    OldValue = "old",
+    NewValue = "new",
+    EditedBy = "editedBy",
+    Action = "action",
+    EditedByPhone = "edPhone",
+    EditedByEmail = "edEmail"
+}
+/**
+ * Audit trail for the TDS option master. One row per changed field, carrying the
+ * actor, the timestamp and the before/after values — the same shape the master
+ * city group and vendor activity logs already use, so the existing log viewers
+ * and export code read it without special-casing.
+ */
+export interface ITdsConfigActivityLog extends TypedModel {
+    [TdsConfigActivityLogField.LogId]: string;
+    [TdsConfigActivityLogField.TdsConfig]: ITdsConfig;
+    [TdsConfigActivityLogField.TdsConfigId]: string;
+    [TdsConfigActivityLogField.Date]: Date;
+    [TdsConfigActivityLogField.Field]: string;
+    [TdsConfigActivityLogField.OldValue]: string;
+    [TdsConfigActivityLogField.NewValue]: string;
+    [TdsConfigActivityLogField.EditedBy]: string;
+    [TdsConfigActivityLogField.Action]: string;
+    [TdsConfigActivityLogField.EditedByPhone]: string;
+    [TdsConfigActivityLogField.EditedByEmail]: string;
+}

package/src/lib/models/src/tds.config.activity.log.model.js

@@ -0,0 +1,15 @@
+export var TdsConfigActivityLogField;
+(function (TdsConfigActivityLogField) {
+    TdsConfigActivityLogField["LogId"] = "logId";
+    TdsConfigActivityLogField["TdsConfig"] = "tdsConfig";
+    TdsConfigActivityLogField["TdsConfigId"] = "tdsConfigId";
+    TdsConfigActivityLogField["Date"] = "date";
+    TdsConfigActivityLogField["Field"] = "field";
+    TdsConfigActivityLogField["OldValue"] = "old";
+    TdsConfigActivityLogField["NewValue"] = "new";
+    TdsConfigActivityLogField["EditedBy"] = "editedBy";
+    TdsConfigActivityLogField["Action"] = "action";
+    TdsConfigActivityLogField["EditedByPhone"] = "edPhone";
+    TdsConfigActivityLogField["EditedByEmail"] = "edEmail";
+})(TdsConfigActivityLogField || (TdsConfigActivityLogField = {}));
+//# sourceMappingURL=tds.config.activity.log.model.js.map

package/src/lib/models/src/tds.config.activity.log.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tds.config.activity.log.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/tds.config.activity.log.model.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,yBAYX;AAZD,WAAY,yBAAyB;IACpC,4CAAe,CAAA;IACf,oDAAuB,CAAA;IACvB,wDAA2B,CAAA;IAC3B,0CAAa,CAAA;IACb,4CAAe,CAAA;IACf,6CAAgB,CAAA;IAChB,6CAAgB,CAAA;IAChB,kDAAqB,CAAA;IACrB,8CAAiB,CAAA;IACjB,sDAAyB,CAAA;IACzB,sDAAyB,CAAA;AAC1B,CAAC,EAZW,yBAAyB,KAAzB,yBAAyB,QAYpC"}

package/src/lib/models/src/tds.config.model.d.ts

@@ -0,0 +1,47 @@
+import { GenericStatus } from '@autologix/shared/enums';
+import { IBusinessContextOwner } from './business.context.owner.model';
+import { IPassengerPersona } from './passenger.persona.model';
+import { ITdsConfigActivityLog } from './tds.config.activity.log.model';
+import { TypedModel } from './typed.model';
+export declare enum TdsConfigField {
+    TdsConfigId = "tdsConfigId",
+    Context = "context",
+    ContextId = "contextId",
+    Label = "label",
+    TdsApplicable = "tdsApplicable",
+    TdsConfigSeqId = "tdsConfigSeqId",
+    Status = "status",
+    CreatedBy = "crtdBy",
+    CreatedById = "crtdById",
+    CreatedAt = "crtdAt",
+    UpdatedBy = "updtBy",
+    UpdatedById = "updtById",
+    UpdatedAt = "updtdAt",
+    Logs = "logs"
+}
+/**
+ * A globally configurable TDS treatment that a vendor can point at.
+ *
+ * The primary key is the contract with everything downstream: a vendor stores
+ * `tdsConfigId`, never the label and never the rate, so renaming an option or
+ * correcting its percentage does not rewrite history on any vendor record.
+ * Options are therefore never hard-deleted — they are moved to
+ * `GenericStatus.InActive`, which keeps them off new vendor forms while leaving
+ * existing references resolvable.
+ */
+export interface ITdsConfig extends TypedModel {
+    [TdsConfigField.TdsConfigId]: string;
+    [TdsConfigField.Context]: IBusinessContextOwner;
+    [TdsConfigField.ContextId]: string;
+    [TdsConfigField.Label]: string;
+    [TdsConfigField.TdsApplicable]: number;
+    [TdsConfigField.TdsConfigSeqId]: number;
+    [TdsConfigField.Status]: GenericStatus;
+    [TdsConfigField.CreatedBy]: IPassengerPersona;
+    [TdsConfigField.CreatedById]: string;
+    [TdsConfigField.CreatedAt]: Date;
+    [TdsConfigField.UpdatedBy]: IPassengerPersona;
+    [TdsConfigField.UpdatedById]: string;
+    [TdsConfigField.UpdatedAt]: Date;
+    [TdsConfigField.Logs]: ITdsConfigActivityLog[];
+}

package/src/lib/models/src/tds.config.model.js

@@ -0,0 +1,18 @@
+export var TdsConfigField;
+(function (TdsConfigField) {
+    TdsConfigField["TdsConfigId"] = "tdsConfigId";
+    TdsConfigField["Context"] = "context";
+    TdsConfigField["ContextId"] = "contextId";
+    TdsConfigField["Label"] = "label";
+    TdsConfigField["TdsApplicable"] = "tdsApplicable";
+    TdsConfigField["TdsConfigSeqId"] = "tdsConfigSeqId";
+    TdsConfigField["Status"] = "status";
+    TdsConfigField["CreatedBy"] = "crtdBy";
+    TdsConfigField["CreatedById"] = "crtdById";
+    TdsConfigField["CreatedAt"] = "crtdAt";
+    TdsConfigField["UpdatedBy"] = "updtBy";
+    TdsConfigField["UpdatedById"] = "updtById";
+    TdsConfigField["UpdatedAt"] = "updtdAt";
+    TdsConfigField["Logs"] = "logs";
+})(TdsConfigField || (TdsConfigField = {}));
+//# sourceMappingURL=tds.config.model.js.map