@autologix-engineering/shared 1.2.379 → 1.2.380

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

@@ -1,73 +0,0 @@
-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

@@ -1,25 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,34 +0,0 @@
-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

@@ -1,11 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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.sign.off.otp.model.d.ts

@@ -1,40 +0,0 @@
-export declare enum LTRSignOffOTPField {
-    SignOffOtpId = "signOffOtpId",
-    /** The number the code was sent to. Verification looks it up by this. */
-    Phone = "phone",
-    HashedOtp = "hashedOtp",
-    ExpiresAt = "expiresAt",
-    /** Stamp the resend cooldown is claimed against. */
-    SentAt = "sentAt",
-    /** Set once consumed, so a code cannot be spent twice. */
-    Verified = "verified",
-    Request = "request",
-    RequestId = "requestId",
-    CreatedAt = "createdAt",
-    UpdatedAt = "updatedAt"
-}
-/**
- * A one-time code issued to an LTR renter so a driver can sign off a duty log.
- *
- * Held here rather than on `AuthProfile` because the renter need not have an
- * account: `LTRVehicleMaster.renter` is a `Passenger`, which may be backed only
- * by a `PlaceholderUser`. Keying on the phone lets both kinds take one path.
- *
- * It is also not a credential. The renter reads it aloud to the driver in front
- * of them, so keeping it out of the auth entity removes any chance of it being
- * replayed against a login endpoint.
- */
-export interface ILTRSignOffOTP {
-    [LTRSignOffOTPField.SignOffOtpId]: string;
-    [LTRSignOffOTPField.Phone]: string;
-    [LTRSignOffOTPField.HashedOtp]: string;
-    [LTRSignOffOTPField.ExpiresAt]?: Date;
-    [LTRSignOffOTPField.SentAt]?: Date;
-    [LTRSignOffOTPField.Verified]: boolean;
-    /** The booking the code was issued for; a code is not valid for another. */
-    [LTRSignOffOTPField.RequestId]?: string;
-    [LTRSignOffOTPField.CreatedAt]: Date;
-    [LTRSignOffOTPField.UpdatedAt]: Date;
-    setOtp: (otp: string) => void;
-    isOtpValid: (otp: string) => boolean;
-}

package/src/lib/models/src/ltr.sign.off.otp.model.js

@@ -1,17 +0,0 @@
-export var LTRSignOffOTPField;
-(function (LTRSignOffOTPField) {
-    LTRSignOffOTPField["SignOffOtpId"] = "signOffOtpId";
-    /** The number the code was sent to. Verification looks it up by this. */
-    LTRSignOffOTPField["Phone"] = "phone";
-    LTRSignOffOTPField["HashedOtp"] = "hashedOtp";
-    LTRSignOffOTPField["ExpiresAt"] = "expiresAt";
-    /** Stamp the resend cooldown is claimed against. */
-    LTRSignOffOTPField["SentAt"] = "sentAt";
-    /** Set once consumed, so a code cannot be spent twice. */
-    LTRSignOffOTPField["Verified"] = "verified";
-    LTRSignOffOTPField["Request"] = "request";
-    LTRSignOffOTPField["RequestId"] = "requestId";
-    LTRSignOffOTPField["CreatedAt"] = "createdAt";
-    LTRSignOffOTPField["UpdatedAt"] = "updatedAt";
-})(LTRSignOffOTPField || (LTRSignOffOTPField = {}));
-//# sourceMappingURL=ltr.sign.off.otp.model.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ltr.sign.off.otp.model.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/models/src/ltr.sign.off.otp.model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,kBAcX;AAdD,WAAY,kBAAkB;IAC7B,mDAA6B,CAAA;IAC7B,yEAAyE;IACzE,qCAAe,CAAA;IACf,6CAAuB,CAAA;IACvB,6CAAuB,CAAA;IACvB,oDAAoD;IACpD,uCAAiB,CAAA;IACjB,0DAA0D;IAC1D,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;IACnB,6CAAuB,CAAA;IACvB,6CAAuB,CAAA;IACvB,6CAAuB,CAAA;AACxB,CAAC,EAdW,kBAAkB,KAAlB,kBAAkB,QAc7B"}

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

@@ -1,56 +0,0 @@
-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

@@ -1,26 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/utilities/src/ba.payout.workshop.days.d.ts

@@ -1,77 +0,0 @@
-/**
- * AD-3288 — workshop (maintenance) days excluded from the BA payout
- * min-working-days penalty.
- *
- * A BA whose vehicle sat in the workshop could not run duties on those days,
- * so charging the per-day "worked less than N days" penalty for them is wrong.
- * When a maintenance Work Order exists for the BA's vehicle in the payout
- * month, the workshop days it covers are taken off the minimum before the
- * shortfall is priced.
- *
- * Everything here is pure integer arithmetic over IST-midnight day
- * timestamps. The caller normalises dates to IST calendar days with the SAME
- * helper it uses for on-duty days (`normalizeIstCalendarDay` in the payout
- * controller) so the two day sets are directly comparable — a workshop day and
- * a duty day for the same calendar date always carry the same timestamp.
- */
-/**
- * NRT type that marks a workshop visit raised against a Work Order. The Work
- * Order field on the NRT form is only shown for this type, and an NRT created
- * from a Work Order is forced to it, so "maintenance work order" is exactly
- * "NRT of this type with a Work Order linked". NrtType is a per-context master
- * (free text), hence a string constant and a case-insensitive comparison
- * rather than an enum.
- */
-export declare const MAINTENANCE_NRT_TYPE = "Maintenance";
-/** One workshop window, already reduced to IST calendar days by the caller. */
-export interface IWorkshopPeriodInput {
-    nrtNumber?: string | null;
-    workOrderNumber?: string | null;
-    /** IST-midnight timestamp of the first workshop calendar day. */
-    startDayTs: number;
-    /** IST-midnight timestamp of the last workshop calendar day (inclusive). */
-    endDayTs: number;
-}
-/** One workshop calendar day inside the payout ∩ contract window. */
-export interface IWorkshopDayResult {
-    /** IST-midnight timestamp of the day. */
-    dayTs: number;
-    /** NRTs whose window covers this day (deduped, in input order). */
-    nrtNumbers: string[];
-    /** Work Orders whose NRT covers this day (deduped, in input order). */
-    workOrderNumbers: string[];
-    /**
-     * true when the vehicle also ran a duty that day. Such a day already
-     * counts as an actual working day, so it is NOT excluded — excluding it
-     * would credit the BA twice for the same date.
-     */
-    hasDuty: boolean;
-}
-export interface IWorkshopDayExclusionResult {
-    /** In-window workshop days with no duty — what comes off the minimum. */
-    excludedDays: number;
-    /** Every in-window workshop day, deduped across NRTs, ascending. */
-    days: IWorkshopDayResult[];
-}
-/**
- * Workshop days for one contract, clipped to `windowStartTs..windowEndTs`
- * (the payout month ∩ contract window the penalty already uses).
- *
- * Overlap rule: only days INSIDE the window are returned, so an NRT that
- * started in the previous month or runs into the next one contributes just
- * its in-window days. Overlapping / duplicate NRTs collapse onto one entry per
- * calendar day, so five one-day NRTs raised for the same date exclude one day,
- * not five.
- */
-export declare function computeWorkshopDayExclusion(periods: IWorkshopPeriodInput[], windowStartTs: number, windowEndTs: number, onDutyDayTimestamps: Iterable<number>): IWorkshopDayExclusionResult;
-/**
- * Penalty days for the min-working-days penalty, after workshop exclusion.
- *
- *   effectiveMinimum = minWorkingDays − excludedWorkshopDays   (floored at 0)
- *   penaltyDays      = effectiveMinimum − actualWorkingDays    (floored at 0)
- *
- * With no workshop days this is the untouched original rule
- * (minWorkingDays − actualWorkingDays), so a BA with no maintenance Work
- * Order in the month is unaffected.
- */
-export declare function computeMinWorkingDaysPenaltyDays(minWorkingDays: number, actualWorkingDays: number, excludedWorkshopDays?: number): number;

package/src/lib/utilities/src/ba.payout.workshop.days.js

@@ -1,109 +0,0 @@
-/**
- * AD-3288 — workshop (maintenance) days excluded from the BA payout
- * min-working-days penalty.
- *
- * A BA whose vehicle sat in the workshop could not run duties on those days,
- * so charging the per-day "worked less than N days" penalty for them is wrong.
- * When a maintenance Work Order exists for the BA's vehicle in the payout
- * month, the workshop days it covers are taken off the minimum before the
- * shortfall is priced.
- *
- * Everything here is pure integer arithmetic over IST-midnight day
- * timestamps. The caller normalises dates to IST calendar days with the SAME
- * helper it uses for on-duty days (`normalizeIstCalendarDay` in the payout
- * controller) so the two day sets are directly comparable — a workshop day and
- * a duty day for the same calendar date always carry the same timestamp.
- */
-/**
- * NRT type that marks a workshop visit raised against a Work Order. The Work
- * Order field on the NRT form is only shown for this type, and an NRT created
- * from a Work Order is forced to it, so "maintenance work order" is exactly
- * "NRT of this type with a Work Order linked". NrtType is a per-context master
- * (free text), hence a string constant and a case-insensitive comparison
- * rather than an enum.
- */
-export const MAINTENANCE_NRT_TYPE = 'Maintenance';
-const DAY_MS = 24 * 60 * 60 * 1000;
-const pushUnique = (target, value) => {
-    if (!value)
-        return;
-    if (!target.includes(value))
-        target.push(value);
-};
-/**
- * Workshop days for one contract, clipped to `windowStartTs..windowEndTs`
- * (the payout month ∩ contract window the penalty already uses).
- *
- * Overlap rule: only days INSIDE the window are returned, so an NRT that
- * started in the previous month or runs into the next one contributes just
- * its in-window days. Overlapping / duplicate NRTs collapse onto one entry per
- * calendar day, so five one-day NRTs raised for the same date exclude one day,
- * not five.
- */
-export function computeWorkshopDayExclusion(periods, windowStartTs, windowEndTs, onDutyDayTimestamps) {
-    const empty = { excludedDays: 0, days: [] };
-    if (!Array.isArray(periods) || periods.length === 0)
-        return empty;
-    if (!Number.isFinite(windowStartTs) || !Number.isFinite(windowEndTs)) {
-        return empty;
-    }
-    if (windowStartTs > windowEndTs)
-        return empty;
-    const dutyDays = new Set();
-    for (const ts of onDutyDayTimestamps ?? []) {
-        if (Number.isFinite(ts))
-            dutyDays.add(ts);
-    }
-    const dayMap = new Map();
-    for (const period of periods) {
-        if (!period)
-            continue;
-        const { startDayTs, endDayTs } = period;
-        if (!Number.isFinite(startDayTs) || !Number.isFinite(endDayTs)) {
-            continue;
-        }
-        // Bad data (return before start) contributes nothing rather than
-        // looping forever or silently crediting the start day.
-        if (startDayTs > endDayTs)
-            continue;
-        const clipStart = Math.max(startDayTs, windowStartTs);
-        const clipEnd = Math.min(endDayTs, windowEndTs);
-        if (clipStart > clipEnd)
-            continue;
-        for (let ts = clipStart; ts <= clipEnd; ts += DAY_MS) {
-            let day = dayMap.get(ts);
-            if (!day) {
-                day = {
-                    dayTs: ts,
-                    nrtNumbers: [],
-                    workOrderNumbers: [],
-                    hasDuty: dutyDays.has(ts),
-                };
-                dayMap.set(ts, day);
-            }
-            pushUnique(day.nrtNumbers, period.nrtNumber);
-            pushUnique(day.workOrderNumbers, period.workOrderNumber);
-        }
-    }
-    const days = Array.from(dayMap.values()).sort((a, b) => a.dayTs - b.dayTs);
-    const excludedDays = days.filter((d) => !d.hasDuty).length;
-    return { excludedDays, days };
-}
-/**
- * Penalty days for the min-working-days penalty, after workshop exclusion.
- *
- *   effectiveMinimum = minWorkingDays − excludedWorkshopDays   (floored at 0)
- *   penaltyDays      = effectiveMinimum − actualWorkingDays    (floored at 0)
- *
- * With no workshop days this is the untouched original rule
- * (minWorkingDays − actualWorkingDays), so a BA with no maintenance Work
- * Order in the month is unaffected.
- */
-export function computeMinWorkingDaysPenaltyDays(minWorkingDays, actualWorkingDays, excludedWorkshopDays = 0) {
-    const minimum = Number(minWorkingDays) || 0;
-    const worked = Number(actualWorkingDays) || 0;
-    const excluded = Number(excludedWorkshopDays) || 0;
-    const effectiveMinimum = Math.max(0, minimum - Math.max(0, excluded));
-    return Math.max(0, effectiveMinimum - worked);
-}
-//# sourceMappingURL=ba.payout.workshop.days.js.map

package/src/lib/utilities/src/ba.payout.workshop.days.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ba.payout.workshop.days.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/ba.payout.workshop.days.ts"],"names":[],"mappings":"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"}

package/src/lib/utilities/src/financial.year.d.ts

@@ -1,83 +0,0 @@
-/**
- * Indian financial year helpers, in IST.
- *
- * A financial year runs 1 April 00:00:00.000 IST to 31 March 23:59:59.999 IST.
- * Every boundary here is an IST boundary expressed as a UTC instant, because
- * that is how the database stores time: TimePeriod.startDate for September 2026
- * is 2026-08-31T18:30:00Z, i.e. 1 September 00:00 IST. Deriving the month with
- * plain `getMonth()` on the server's local clock would put every payout period
- * that starts at 18:30 UTC into the previous month on any machine running UTC —
- * a whole column of the RM schedule shifted by one.
- *
- * Written for AD-3098 (BA Retention Money schedule) and deliberately kept free
- * of anything RM-specific so AD-3097 (Security Deposit schedule), which has the
- * same April–March, one-column-group-per-month shape, can use it unchanged.
- */
-/** 1 April 00:00:00.000 IST of `startYear`, as a UTC instant. */
-export declare function financialYearStart(startYear: number): Date;
-/** 31 March 23:59:59.999 IST of `startYear + 1`, as a UTC instant. */
-export declare function financialYearEnd(startYear: number): Date;
-/**
- * The financial year's bounds as plain IST calendar dates, 'YYYY-MM-DD'.
- *
- * Preferred over the Date forms whenever the other side of the comparison also
- * came out of Postgres as an IST calendar day, because string comparison of
- * 'YYYY-MM-DD' cannot be knocked off by the process timezone. `timestamp
- * without time zone` columns — which is what every contract date in this schema
- * is — are parsed by node-postgres in the SERVER's local zone, so the same row
- * yields a different instant on a UTC box than on an IST laptop.
- */
-export declare function financialYearStartDay(startYear: number): string;
-export declare function financialYearEndDay(startYear: number): string;
-/**
- * The financial year that contains `d`, identified by its opening calendar
- * year: 2026 means FY 2026-27 (Apr 2026 – Mar 2027).
- *
- * Takes ANY instant inside the year rather than requiring the caller to pass
- * 1 April, so a report can be re-run from a stored request payload without the
- * caller having to remember which end of the range was canonical.
- */
-export declare function resolveFinancialYearStartYear(d: Date | string): number;
-/** e.g. startYear 2026 -> '2026-27'. */
-export declare function financialYearLabel(startYear: number): string;
-export interface FinancialYearMonth {
-    /** 0-based position in the financial year: 0 = April, 11 = March. */
-    index: number;
-    /** Calendar year of this month (2027 for the March of FY 2026-27). */
-    year: number;
-    /** 0-based calendar month, as `Date.getUTCMonth()` returns it. */
-    month: number;
-    /** 'Apr 26' — the label the RM/SD schedule column groups are titled with. */
-    label: string;
-    /**
-     * 'YYYY-MM'. Matches what `to_char(ts + interval '5 hours 30 minutes',
-     * 'YYYY-MM')` produces in Postgres, so a month can be bucketed in SQL and
-     * looked up here without either side parsing a timestamp in Node.
-     */
-    key: string;
-    /** First instant of the month, 00:00:00.000 IST as a UTC instant. */
-    startUTC: Date;
-    /** Last instant of the month, 23:59:59.999 IST as a UTC instant. */
-    endUTC: Date;
-}
-/**
- * The twelve months of a financial year in order, April first.
- */
-export declare function financialYearMonths(startYear: number): FinancialYearMonth[];
-/**
- * Which financial-year month `d` falls in, as a 0-based index (0 = April), or
- * -1 when it falls outside the year entirely.
- *
- * Accepts either an instant (TimePeriod.startDate, a UTC timestamp) or a plain
- * 'YYYY-MM-DD' calendar date (rvRefundDate, a Postgres `date`). A calendar date
- * has no timezone at all, so it is read as the IST day it names — parsing it as
- * a UTC instant and then adding the IST offset would move 1 April to 1 April
- * 05:30 IST, which is still 1 April, but 31 March would move to 31 March 05:30
- * and stay correct too. The branch exists so the intent is not accidental.
- */
-export declare function financialYearMonthIndex(d: Date | string | null | undefined, startYear: number): number;
-/**
- * True when `d` lands strictly before 1 April 00:00 IST of the financial year —
- * i.e. it belongs to the opening balance rather than to any month column.
- */
-export declare function isBeforeFinancialYear(d: Date | string | null | undefined, startYear: number): boolean;