@autologix-engineering/shared 1.2.367 → 1.2.369

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autologix-engineering/shared",
-  "version": "1.2.367",
+  "version": "1.2.369",
   "dependencies": {
     "tslib": "^2.3.0"
   },

package/src/lib/commands/src/generate.ba.reimbursement.zip.handler.d.ts

@@ -3,4 +3,9 @@ import { BaseCommand } from './base.command';
 export declare class GenerateBAReimbursementSummaryZipCommand implements BaseCommand {
     type: CommandType;
     baReimbursementSummaryId: string;
+    /**
+     * Reuse a reimbursement's already-attached PDF instead of rendering it
+     * again. Off by default, so a plain re-run still refreshes every document.
+     */
+    reuseExistingPdfs?: boolean;
 }

package/src/lib/commands/src/generate.ba.reimbursement.zip.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.ba.reimbursement.zip.handler.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/commands/src/generate.ba.reimbursement.zip.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,OAAO,wCAAwC;IAArD;QACI,SAAI,GAAG,WAAW,CAAC,wCAAwC,CAAC;IAEhE,CAAC;CAAA"}
+{"version":3,"file":"generate.ba.reimbursement.zip.handler.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/commands/src/generate.ba.reimbursement.zip.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,OAAO,wCAAwC;IAArD;QACI,SAAI,GAAG,WAAW,CAAC,wCAAwC,CAAC;IAOhE,CAAC;CAAA"}

package/src/lib/contract-state/src/contract.date.change.display.d.ts

@@ -0,0 +1,27 @@
+import { DateChangeWindowState } from './contract.date.change.window';
+/**
+ * Whether the remaining-budget message carries information worth showing.
+ *
+ * A block always shows, whatever the numbers — the user cannot proceed and is
+ * owed the reason.
+ */
+export declare const shouldShowDateChangeBudget: (state: Pick<DateChangeWindowState, "enabled" | "blocked" | "remaining" | "windowLimit">) => boolean;
+export type WindowResetTier = 
+/** Within ~3 months: say it in days, which is what a user plans around. */
+'relative'
+/** Within ~2 years: an absolute date is still something to diary. */
+ | 'absolute'
+/**
+ * Beyond that. Deliberately carries no date: "resets on 12 Mar 2054" reads
+ * as authoritative while being useless, whereas naming the configuration as
+ * the thing to question points at the only real next step.
+ */
+ | 'unreachable';
+export interface WindowResetDescription {
+    tier: WindowResetTier;
+    /** Whole days until reset, rounded up. Only meaningful for 'relative'. */
+    days: number;
+    /** The reset instant. Only meaningful for 'absolute'. */
+    date: Date;
+}
+export declare const describeWindowReset: (windowEndsAt: Date, now?: Date) => WindowResetDescription;

package/src/lib/contract-state/src/contract.date.change.display.js

@@ -0,0 +1,47 @@
+/**
+ * Presentation decisions for the per-client date-change budget.
+ *
+ * X and Y are operator-configurable with no ceiling, so a tenant can set a
+ * 10,000-day window with a limit of 1,000. At that scale "3 of 1000 changes
+ * used, resets on 12 Mar 2054" is noise on every screen for 997 consecutive
+ * changes, and the date is 27 years of no help to anyone. These helpers decide
+ * *whether* and *in what terms* the budget is worth mentioning.
+ *
+ * They return decisions, not sentences: Orion composes English for its
+ * rejection message, Iris composes the same thing through i18n keys. Neither
+ * side may vary the rule — enforcement is unaffected by any of this, and the
+ * API always returns the exact numbers regardless of what is displayed.
+ */
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+/** A budget this small is meaningful from its very first change. */
+const ALWAYS_SHOW_AT_OR_BELOW_LIMIT = 5;
+/** Above that, stay silent until the cap is genuinely near. */
+const SHOW_WHEN_REMAINING_AT_OR_BELOW = 3;
+const NEAR_HORIZON_DAYS = 90;
+const FAR_HORIZON_DAYS = 730;
+/**
+ * Whether the remaining-budget message carries information worth showing.
+ *
+ * A block always shows, whatever the numbers — the user cannot proceed and is
+ * owed the reason.
+ */
+export const shouldShowDateChangeBudget = (state) => {
+    if (!state.enabled)
+        return false;
+    if (state.blocked)
+        return true;
+    if ((state.windowLimit ?? 0) <= ALWAYS_SHOW_AT_OR_BELOW_LIMIT)
+        return true;
+    return state.remaining <= SHOW_WHEN_REMAINING_AT_OR_BELOW;
+};
+export const describeWindowReset = (windowEndsAt, now = new Date()) => {
+    const _msRemaining = windowEndsAt.getTime() - now.getTime();
+    const days = Math.max(0, Math.ceil(_msRemaining / MS_PER_DAY));
+    const tier = days <= NEAR_HORIZON_DAYS
+        ? 'relative'
+        : days <= FAR_HORIZON_DAYS
+            ? 'absolute'
+            : 'unreachable';
+    return { tier, days, date: new Date(windowEndsAt.getTime()) };
+};
+//# sourceMappingURL=contract.date.change.display.js.map

package/src/lib/contract-state/src/contract.date.change.display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.date.change.display.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/contract-state/src/contract.date.change.display.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC,oEAAoE;AACpE,MAAM,6BAA6B,GAAG,CAAC,CAAC;AACxC,+DAA+D;AAC/D,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAE1C,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACzC,KAGC,EACS,EAAE;IACZ,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,6BAA6B;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,KAAK,CAAC,SAAS,IAAI,+BAA+B,CAAC;AAC3D,CAAC,CAAC;AAsBF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAClC,YAAkB,EAClB,MAAY,IAAI,IAAI,EAAE,EACG,EAAE;IAC3B,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC;IAE/D,MAAM,IAAI,GACT,IAAI,IAAI,iBAAiB;QACxB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,IAAI,IAAI,gBAAgB;YACzB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,aAAa,CAAC;IAEnB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC/D,CAAC,CAAC"}

package/src/lib/contract-state/src/contract.date.change.window.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The rolling budget for contract date changes.
+ *
+ * Dates may be changed at most `windowLimit` (Y) times within `windowDays` (X)
+ * days, counted across every contract in one bucket. The window is *anchored*
+ * on the first change rather than sliding: once X days have elapsed from that
+ * anchor the budget resets and the next change opens a fresh window at
+ * sequence 1.
+ *
+ * The bucket is (client, rental type) — see contract.date.change.throttle.ts,
+ * which owns that decision. Nothing here knows about it: this module is handed
+ * one bucket's anchor and count and answers for that bucket alone, which is
+ * exactly why splitting STR from LTR needed no change to the rule itself.
+ *
+ * Everything here is pure. Callers supply the two facts a database read
+ * provides — the anchor of the newest recorded change, and how many rows share
+ * that anchor — and get back the decision. That keeps the rule identical
+ * between the two write paths that enforce it and the query that reports it.
+ *
+ * X and Y are read live from `Configurations` on every evaluation, never from
+ * the values stamped on past rows. Raising Y therefore lifts a live block on
+ * the next request, and shrinking X can expire an in-flight window. That is
+ * deliberate: predictable behaviour beats a rule that appears not to respond to
+ * its own configuration. The bypass it opens is closed by *visibility* instead
+ * — changes to either field are written to `ConfigurationsActivityLog` and
+ * surface in the same report as the date changes they permitted.
+ */
+export interface DateChangeWindowInput {
+    /** X, from `ConfigurationField.ContractCanBeExtendedBy`. Null/0 disables. */
+    windowDays?: number | null;
+    /** Y, from `ConfigurationField.NoOfTimesContractCanBeExtended`. Null/0 disables. */
+    windowLimit?: number | null;
+    /**
+     * `windowStartedAt` of the newest recorded change for this client, or null
+     * when the client has never had one.
+     */
+    latestWindowStartedAt?: Date | null;
+    /** How many recorded rows share that anchor. */
+    usedInLatestWindow?: number;
+    /** Evaluation instant; injectable so tests need no clock control. */
+    now?: Date;
+}
+export interface DateChangeWindowState {
+    /** False when either X or Y is unset — the rule never blocks. */
+    enabled: boolean;
+    windowDays: number | null;
+    windowLimit: number | null;
+    /**
+     * The anchor a change made *now* would be counted into: the existing anchor
+     * while it is still live, otherwise `now` — the anchor a fresh window opens
+     * at. Null when the rule is disabled.
+     */
+    windowStartedAt: Date | null;
+    /** `windowStartedAt + X days`. Null when the rule is disabled. */
+    windowEndsAt: Date | null;
+    /** Changes already counted into `windowStartedAt`. Zero for a fresh window. */
+    used: number;
+    remaining: number;
+    blocked: boolean;
+    /** The sequence a change made now would take: `used + 1`. */
+    nextSeqInWindow: number;
+}
+export declare const resolveDateChangeWindow: ({ windowDays, windowLimit, latestWindowStartedAt, usedInLatestWindow, now, }: DateChangeWindowInput) => DateChangeWindowState;

package/src/lib/contract-state/src/contract.date.change.window.js

@@ -0,0 +1,85 @@
+/**
+ * The rolling budget for contract date changes.
+ *
+ * Dates may be changed at most `windowLimit` (Y) times within `windowDays` (X)
+ * days, counted across every contract in one bucket. The window is *anchored*
+ * on the first change rather than sliding: once X days have elapsed from that
+ * anchor the budget resets and the next change opens a fresh window at
+ * sequence 1.
+ *
+ * The bucket is (client, rental type) — see contract.date.change.throttle.ts,
+ * which owns that decision. Nothing here knows about it: this module is handed
+ * one bucket's anchor and count and answers for that bucket alone, which is
+ * exactly why splitting STR from LTR needed no change to the rule itself.
+ *
+ * Everything here is pure. Callers supply the two facts a database read
+ * provides — the anchor of the newest recorded change, and how many rows share
+ * that anchor — and get back the decision. That keeps the rule identical
+ * between the two write paths that enforce it and the query that reports it.
+ *
+ * X and Y are read live from `Configurations` on every evaluation, never from
+ * the values stamped on past rows. Raising Y therefore lifts a live block on
+ * the next request, and shrinking X can expire an in-flight window. That is
+ * deliberate: predictable behaviour beats a rule that appears not to respond to
+ * its own configuration. The bypass it opens is closed by *visibility* instead
+ * — changes to either field are written to `ConfigurationsActivityLog` and
+ * surface in the same report as the date changes they permitted.
+ */
+/** Milliseconds in a day. India has no DST, and a window is a duration from an
+ * instant rather than a calendar-day boundary, so exact arithmetic is both
+ * correct and free of the timezone questions `toISTStartOfDay` exists to
+ * answer. */
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+export const resolveDateChangeWindow = ({ windowDays, windowLimit, latestWindowStartedAt, usedInLatestWindow = 0, now = new Date(), }) => {
+    const _days = windowDays ?? 0;
+    const _limit = windowLimit ?? 0;
+    // Either half unset means the operator has not opted in. Both are nullable
+    // with no default, so this is the state every tenant starts in.
+    if (_days <= 0 || _limit <= 0) {
+        return {
+            enabled: false,
+            windowDays: null,
+            windowLimit: null,
+            windowStartedAt: null,
+            windowEndsAt: null,
+            used: 0,
+            remaining: Number.POSITIVE_INFINITY,
+            blocked: false,
+            nextSeqInWindow: 1,
+        };
+    }
+    const _existingAnchor = latestWindowStartedAt ?? null;
+    const _existingEnd = _existingAnchor
+        ? new Date(_existingAnchor.getTime() + _days * MS_PER_DAY)
+        : null;
+    // The anchor is live only while `now` is still inside it. Once it elapses —
+    // or if X was shrunk far enough to expire it retroactively — a change made
+    // now opens a fresh window anchored at `now`, with nothing counted against
+    // it yet.
+    //
+    // Narrowed on the anchor itself rather than on a `_windowIsLive` boolean:
+    // liveness implies a non-null anchor, but that implication travels through
+    // an intermediate boolean that the compiler cannot follow back, and under
+    // strict null checks the reuse below is then rejected.
+    const _liveAnchor = _existingAnchor && _existingEnd && now.getTime() < _existingEnd.getTime()
+        ? _existingAnchor
+        : null;
+    const windowStartedAt = _liveAnchor
+        ? new Date(_liveAnchor.getTime())
+        : new Date(now.getTime());
+    const used = _liveAnchor ? usedInLatestWindow : 0;
+    return {
+        enabled: true,
+        windowDays: _days,
+        windowLimit: _limit,
+        windowStartedAt,
+        windowEndsAt: new Date(windowStartedAt.getTime() + _days * MS_PER_DAY),
+        used,
+        // Clamped at zero: `used` can exceed the limit after an override, or
+        // after Y was lowered below what a window had already spent.
+        remaining: Math.max(0, _limit - used),
+        blocked: used >= _limit,
+        nextSeqInWindow: used + 1,
+    };
+};
+//# sourceMappingURL=contract.date.change.window.js.map

package/src/lib/contract-state/src/contract.date.change.window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.date.change.window.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/contract-state/src/contract.date.change.window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;aAGa;AACb,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAuCvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,EACvC,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GAAG,CAAC,EACtB,GAAG,GAAG,IAAI,IAAI,EAAE,GACO,EAAyB,EAAE;IAClD,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,CAAC;IAEhC,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO;YACN,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;YACjB,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,MAAM,CAAC,iBAAiB;YACnC,OAAO,EAAE,KAAK;YACd,eAAe,EAAE,CAAC;SAClB,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,qBAAqB,IAAI,IAAI,CAAC;IACtD,MAAM,YAAY,GAAG,eAAe;QACnC,CAAC,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC;QAC1D,CAAC,CAAC,IAAI,CAAC;IAER,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,UAAU;IACV,EAAE;IACF,0EAA0E;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,uDAAuD;IACvD,MAAM,WAAW,GAChB,eAAe,IAAI,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE;QACxE,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,eAAe,GAAG,WAAW;QAClC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,OAAO;QACN,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,MAAM;QACnB,eAAe;QACf,YAAY,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC;QACtE,IAAI;QACJ,qEAAqE;QACrE,6DAA6D;QAC7D,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,OAAO,EAAE,IAAI,IAAI,MAAM;QACvB,eAAe,EAAE,IAAI,GAAG,CAAC;KACzB,CAAC;AACH,CAAC,CAAC"}

package/src/lib/contract-state/src/index.d.ts

@@ -1,3 +1,5 @@
 export { ContractState } from '../../enums/src/contract.state.enum';
 export * from './derive.contract.state';
 export * from './contract.coverage.bound';
+export * from './contract.date.change.window';
+export * from './contract.date.change.display';

package/src/lib/contract-state/src/index.js

@@ -5,4 +5,6 @@
 export { ContractState } from '../../enums/src/contract.state.enum';
 export * from './derive.contract.state';
 export * from './contract.coverage.bound';
+export * from './contract.date.change.window';
+export * from './contract.date.change.display';
 //# sourceMappingURL=index.js.map

package/src/lib/contract-state/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/contract-state/src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yEAAyE;AACzE,gEAAgE;AAChE,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/contract-state/src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yEAAyE;AACzE,gEAAgE;AAChE,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC"}

package/src/lib/data-transfer-objects/src/command/update.client.persona.contract.file.dto.d.ts

@@ -4,5 +4,11 @@ export declare class UpdateClientPersonaContractFileDTO {
     fileId?: string;
     internalFileName?: string;
     byPersonaId: string;
+    /**
+     * Asks to push this change through a hit date-change cap. Re-checked
+     * against the caller's permission server side — see
+     * `UpdateContractTermsDTO.overrideDateChangeLimit`.
+     */
+    overrideDateChangeLimit?: boolean;
     constructor(_obj?: Partial<UpdateClientPersonaContractFileDTO>);
 }

package/src/lib/data-transfer-objects/src/command/update.client.persona.contract.file.dto.js

@@ -1,5 +1,5 @@
 import { __decorate, __metadata } from "tslib";
-import { IsDateString, IsOptional, IsString, IsUUID } from 'class-validator';
+import { IsBoolean, IsDateString, IsOptional, IsString, IsUUID, } from 'class-validator';
 export class UpdateClientPersonaContractFileDTO {
     constructor(_obj) {
         Object.assign(this, _obj);
@@ -27,4 +27,9 @@ __decorate([
     IsUUID(),
     __metadata("design:type", String)
 ], UpdateClientPersonaContractFileDTO.prototype, "byPersonaId", void 0);
+__decorate([
+    IsOptional(),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], UpdateClientPersonaContractFileDTO.prototype, "overrideDateChangeLimit", void 0);
 //# sourceMappingURL=update.client.persona.contract.file.dto.js.map

package/src/lib/data-transfer-objects/src/command/update.client.persona.contract.file.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.client.persona.contract.file.dto.js","sourceRoot":"","sources":["../../../../../../../../libs/shared/src/lib/data-transfer-objects/src/command/update.client.persona.contract.file.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,OAAO,kCAAkC;IAkB9C,YAAY,IAAkD;QAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;CACD;AAnBA;IADC,MAAM,EAAE;;+EACmB;AAG5B;IADC,YAAY,EAAE;;mEACC;AAIhB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;kEACO;AAIhB;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;4EACe;AAG1B;IADC,MAAM,EAAE;;uEACW"}
+{"version":3,"file":"update.client.persona.contract.file.dto.js","sourceRoot":"","sources":["../../../../../../../../libs/shared/src/lib/data-transfer-objects/src/command/update.client.persona.contract.file.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EACN,SAAS,EACT,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,MAAM,GACN,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,kCAAkC;IA2B9C,YAAY,IAAkD;QAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;CACD;AA5BA;IADC,MAAM,EAAE;;+EACmB;AAG5B;IADC,YAAY,EAAE;;mEACC;AAIhB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;kEACO;AAIhB;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;4EACe;AAG1B;IADC,MAAM,EAAE;;uEACW;AASpB;IAFC,UAAU,EAAE;IACZ,SAAS,EAAE;;mFACsB"}

package/src/lib/data-transfer-objects/src/command/update.contract.terms.dto.d.ts

@@ -8,5 +8,13 @@ export declare class UpdateContractTermsDTO {
     fileId?: string;
     byPersonaId: string;
     contextId?: string;
+    /**
+     * Asks to push this change through a hit date-change cap.
+     *
+     * A request, not a grant — the server re-checks the caller's
+     * `Override contract date-change limit` permission before honouring it, so
+     * setting this flag alone buys nothing.
+     */
+    overrideDateChangeLimit?: boolean;
     constructor(_obj?: Partial<UpdateContractTermsDTO>);
 }

package/src/lib/data-transfer-objects/src/command/update.contract.terms.dto.js

@@ -1,6 +1,6 @@
 import { __decorate, __metadata } from "tslib";
 import { TermRentalType } from '../../../enums/src';
-import { IsDateString, IsNumber, IsOptional, IsUUID, IsEnum } from 'class-validator';
+import { IsBoolean, IsDateString, IsNumber, IsOptional, IsUUID, IsEnum, } from 'class-validator';
 export class UpdateContractTermsDTO {
     constructor(_obj) {
         Object.assign(this, _obj);
@@ -43,4 +43,9 @@ __decorate([
     IsUUID(),
     __metadata("design:type", String)
 ], UpdateContractTermsDTO.prototype, "contextId", void 0);
+__decorate([
+    IsOptional(),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], UpdateContractTermsDTO.prototype, "overrideDateChangeLimit", void 0);
 //# sourceMappingURL=update.contract.terms.dto.js.map

package/src/lib/data-transfer-objects/src/command/update.contract.terms.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.contract.terms.dto.js","sourceRoot":"","sources":["../../../../../../../../libs/shared/src/lib/data-transfer-objects/src/command/update.contract.terms.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAY,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE/F,MAAM,OAAO,sBAAsB;IA6BlC,YAAY,IAAsC;QACjD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;CACD;AA9BA;IADC,MAAM,EAAE;;+DACe;AAGxB;IADC,YAAY,EAAE;;uDACC;AAIhB;IAFC,YAAY,EAAE;IACd,UAAU,EAAE;;yDACM;AAInB;IAFC,UAAU,EAAE;IACZ,MAAM,CAAC,cAAc,CAAC;;0DACK;AAI5B;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;6DACY;AAIvB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;sDACO;AAGhB;IADC,MAAM,EAAE;;2DACW;AAIpB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;yDACU"}
+{"version":3,"file":"update.contract.terms.dto.js","sourceRoot":"","sources":["../../../../../../../../libs/shared/src/lib/data-transfer-objects/src/command/update.contract.terms.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACN,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EAEV,MAAM,EACN,MAAM,GACN,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,sBAAsB;IAyClC,YAAY,IAAsC;QACjD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;CACD;AA1CA;IADC,MAAM,EAAE;;+DACe;AAGxB;IADC,YAAY,EAAE;;uDACC;AAIhB;IAFC,YAAY,EAAE;IACd,UAAU,EAAE;;yDACM;AAInB;IAFC,UAAU,EAAE;IACZ,MAAM,CAAC,cAAc,CAAC;;0DACK;AAI5B;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;6DACY;AAIvB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;sDACO;AAGhB;IADC,MAAM,EAAE;;2DACW;AAIpB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;yDACU;AAWnB;IAFC,UAAU,EAAE;IACZ,SAAS,EAAE;;uEACsB"}

package/src/lib/data-transfer-objects/src/get.ba.reimbursement.zip.dto.d.ts

@@ -1,4 +1,9 @@
 export declare class GetBaReimbursementSummaryZipDto {
     baReimbursementSummaryId: string;
+    /**
+     * Reuse already-attached PDFs rather than re-rendering them. Useful for
+     * repairing a short zip without reissuing documents that are already good.
+     */
+    reuseExistingPdfs?: boolean;
     constructor(obj?: Partial<GetBaReimbursementSummaryZipDto>);
 }

package/src/lib/data-transfer-objects/src/get.ba.reimbursement.zip.dto.js

@@ -1,5 +1,6 @@
 import { __decorate, __metadata } from "tslib";
-import { IsUUID } from "class-validator";
+import { IsBoolean, IsOptional, IsUUID } from "class-validator";
+import { Transform } from "class-transformer";
 export class GetBaReimbursementSummaryZipDto {
     constructor(obj) {
         Object.assign(this, obj);
@@ -9,4 +10,10 @@ __decorate([
     IsUUID(),
     __metadata("design:type", String)
 ], GetBaReimbursementSummaryZipDto.prototype, "baReimbursementSummaryId", void 0);
+__decorate([
+    IsOptional(),
+    Transform(({ value }) => value === true || value === 'true'),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], GetBaReimbursementSummaryZipDto.prototype, "reuseExistingPdfs", void 0);
 //# sourceMappingURL=get.ba.reimbursement.zip.dto.js.map

package/src/lib/data-transfer-objects/src/get.ba.reimbursement.zip.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.ba.reimbursement.zip.dto.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/data-transfer-objects/src/get.ba.reimbursement.zip.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,OAAO,+BAA+B;IAIxC,YAAY,GAA8C;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;CACJ;AALG;IADC,MAAM,EAAE;;iFACwB"}
+{"version":3,"file":"get.ba.reimbursement.zip.dto.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/data-transfer-objects/src/get.ba.reimbursement.zip.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,OAAO,+BAA+B;IAaxC,YAAY,GAA8C;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;CACJ;AAdG;IADC,MAAM,EAAE;;iFACwB;AASjC;IAHC,UAAU,EAAE;IACZ,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;IAC5D,SAAS,EAAE;;0EACgB"}

package/src/lib/data-transfer-objects/src/get.contract.date.changes.dto.d.ts

@@ -0,0 +1,47 @@
+import { TermRentalType } from '../../enums/src/index';
+/**
+ * Current date-change budget for one (client, rental type) bucket.
+ *
+ * Drives the contract-terms banner and the pre-submit warning, so it is a
+ * point read rather than a listing — the last few changes it returns are
+ * context for the message, not a report.
+ */
+export declare class GetClientContractDateChangeWindowDTO {
+    clientPersonaId: string;
+    contextId: string;
+    /**
+     * Part of the bucket key, not a filter. STR and LTR hold separate tallies,
+     * so a caller must say which one it is asking about; omitting it addresses
+     * the contract-file bucket (rental type NULL), never a client-wide total.
+     */
+    rentalType?: TermRentalType;
+    constructor(obj?: Partial<GetClientContractDateChangeWindowDTO>);
+}
+/**
+ * The management report: who has been moving contract dates, for which client,
+ * and whether they had to override a cap to do it.
+ *
+ * Configuration edits to the throttle's own two fields are interleaved into
+ * the same result, because "the limit was raised to 3 an hour before these
+ * three changes" is the shape the report exists to make visible.
+ */
+export declare class GetContractDateChangesDTO {
+    contextId: string;
+    clientPersonaId?: string;
+    skip?: number;
+    take?: number;
+    /** Free text over the acting user's name and the client's name. */
+    searchText?: string;
+    from?: string;
+    to?: string;
+    rentalType?: TermRentalType;
+    /** Narrow to waived changes only — the ones worth a second look. */
+    overriddenOnly?: boolean;
+    /**
+     * Whether to interleave `ConfigurationsActivityLog` entries for the two
+     * throttle fields. Defaults to true at the controller; a caller that wants
+     * only the date changes themselves can turn it off.
+     */
+    includeConfigChanges?: boolean;
+    constructor(obj?: Partial<GetContractDateChangesDTO>);
+}

package/src/lib/data-transfer-objects/src/get.contract.date.changes.dto.js

@@ -0,0 +1,96 @@
+import { __decorate, __metadata } from "tslib";
+import { Transform } from 'class-transformer';
+import { IsBoolean, IsDateString, IsEnum, IsNumber, IsOptional, IsString, IsUUID, Max, } from 'class-validator';
+import { TermRentalType } from '../../enums/src/index';
+/**
+ * Current date-change budget for one (client, rental type) bucket.
+ *
+ * Drives the contract-terms banner and the pre-submit warning, so it is a
+ * point read rather than a listing — the last few changes it returns are
+ * context for the message, not a report.
+ */
+export class GetClientContractDateChangeWindowDTO {
+    constructor(obj) {
+        Object.assign(this, obj);
+    }
+}
+__decorate([
+    IsUUID(),
+    __metadata("design:type", String)
+], GetClientContractDateChangeWindowDTO.prototype, "clientPersonaId", void 0);
+__decorate([
+    IsUUID(),
+    __metadata("design:type", String)
+], GetClientContractDateChangeWindowDTO.prototype, "contextId", void 0);
+__decorate([
+    IsOptional(),
+    IsEnum(TermRentalType),
+    __metadata("design:type", String)
+], GetClientContractDateChangeWindowDTO.prototype, "rentalType", void 0);
+/**
+ * The management report: who has been moving contract dates, for which client,
+ * and whether they had to override a cap to do it.
+ *
+ * Configuration edits to the throttle's own two fields are interleaved into
+ * the same result, because "the limit was raised to 3 an hour before these
+ * three changes" is the shape the report exists to make visible.
+ */
+export class GetContractDateChangesDTO {
+    constructor(obj) {
+        Object.assign(this, obj);
+    }
+}
+__decorate([
+    IsUUID(),
+    __metadata("design:type", String)
+], GetContractDateChangesDTO.prototype, "contextId", void 0);
+__decorate([
+    IsOptional(),
+    IsUUID(),
+    __metadata("design:type", String)
+], GetContractDateChangesDTO.prototype, "clientPersonaId", void 0);
+__decorate([
+    IsOptional(),
+    Transform(Number),
+    __metadata("design:type", Number)
+], GetContractDateChangesDTO.prototype, "skip", void 0);
+__decorate([
+    IsOptional(),
+    IsNumber(),
+    Max(200),
+    Transform(Number),
+    __metadata("design:type", Number)
+], GetContractDateChangesDTO.prototype, "take", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], GetContractDateChangesDTO.prototype, "searchText", void 0);
+__decorate([
+    IsOptional(),
+    IsDateString(),
+    __metadata("design:type", String)
+], GetContractDateChangesDTO.prototype, "from", void 0);
+__decorate([
+    IsOptional(),
+    IsDateString(),
+    __metadata("design:type", String)
+], GetContractDateChangesDTO.prototype, "to", void 0);
+__decorate([
+    IsOptional(),
+    IsEnum(TermRentalType),
+    __metadata("design:type", String)
+], GetContractDateChangesDTO.prototype, "rentalType", void 0);
+__decorate([
+    IsOptional(),
+    Transform(({ value }) => value === true || value === 'true'),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], GetContractDateChangesDTO.prototype, "overriddenOnly", void 0);
+__decorate([
+    IsOptional(),
+    Transform(({ value }) => value === true || value === 'true'),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], GetContractDateChangesDTO.prototype, "includeConfigChanges", void 0);
+//# sourceMappingURL=get.contract.date.changes.dto.js.map

package/src/lib/data-transfer-objects/src/get.contract.date.changes.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.contract.date.changes.dto.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/data-transfer-objects/src/get.contract.date.changes.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACN,SAAS,EACT,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,MAAM,EACN,GAAG,GACH,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,OAAO,oCAAoC;IAgBhD,YAAY,GAAmD;QAC9D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD;AAjBA;IADC,MAAM,EAAE;;6EACe;AAGxB;IADC,MAAM,EAAE;;uEACS;AASlB;IAFC,UAAU,EAAE;IACZ,MAAM,CAAC,cAAc,CAAC;;wEACK;AAO7B;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IAqDrC,YAAY,GAAwC;QACnD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD;AAtDA;IADC,MAAM,EAAE;;4DACS;AAIlB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;kEACgB;AAIzB;IAFC,UAAU,EAAE;IACZ,SAAS,CAAC,MAAM,CAAC;;uDACJ;AAQd;IAJC,UAAU,EAAE;IACZ,QAAQ,EAAE;IACV,GAAG,CAAC,GAAG,CAAC;IACR,SAAS,CAAC,MAAM,CAAC;;uDACJ;AAKd;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;6DACS;AAIpB;IAFC,UAAU,EAAE;IACZ,YAAY,EAAE;;uDACD;AAId;IAFC,UAAU,EAAE;IACZ,YAAY,EAAE;;qDACH;AAIZ;IAFC,UAAU,EAAE;IACZ,MAAM,CAAC,cAAc,CAAC;;6DACK;AAM5B;IAHC,UAAU,EAAE;IACZ,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;IAC5D,SAAS,EAAE;;iEACa;AAUzB;IAHC,UAAU,EAAE;IACZ,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;IAC5D,SAAS,EAAE;;uEACmB"}

package/src/lib/data-transfer-objects/src/get.ltr.driver.monthly.sign.off.preview.dto.d.ts

@@ -1,33 +1,24 @@
 /**
- * Monthly Sign Off — Preview Details screen. (AD-3206)
+ * Sign Off — Preview Details screen. (AD-3206)
  *
- * Everything the screen shows is computed by the backend from the daily logs
- * already on record, scoped to the signing driver and the given month. The app
- * sends nothing to compute.
+ * Everything the screen shows is computed by the backend from the driver's own
+ * open entries, scoped to the signing driver. The app sends nothing to compute.
+ *
+ * **No month.** The preview answers "what have I logged that is still waiting
+ * to be signed", which is a question about the booking rather than about a
+ * calendar month: an entry left unsigned in March is still the driver's to
+ * settle in April, and a month-scoped preview simply stopped showing it. The
+ * range is the whole booking period and the filter is the entry's status.
  */
 export declare class GetLTRDriverMonthlySignOffPreviewDTO {
-    /** The booking whose month is being previewed. */
+    /** The booking being previewed. */
     requestId: string;
     /**
-     * The signing driver. Totals, the day list and the incomplete days are all
-     * computed for this driver alone — a booking can have more than one driver
-     * in a month through replacement.
+     * The signing driver. Totals, the entry list and the day list are computed
+     * for this driver alone — a booking can have more than one driver through
+     * replacement, and he sees only the entries he recorded himself.
      */
     registeredUserId: string;
-    /**
-     * The month being previewed, as `YYYY-MM`.
-     *
-     * Optional. Omitted, the preview covers the **whole booking** rather than
-     * one month: every day the driver logged across the booking period, with
-     * the totals summed over all of them. `month` comes back null and
-     * `monthStart`/`monthEnd` report the booking's own bounds.
-     *
-     * Signing still requires a month — a lock is written per (booking, driver,
-     * month) — so the all-booking preview always returns `canSignOff: false`,
-     * and `incompleteDays` empty: that list warns about what a sign-off would
-     * lock away, and no sign-off is on offer.
-     */
-    month?: string;
     contextId?: string;
     constructor(obj?: Partial<GetLTRDriverMonthlySignOffPreviewDTO>);
 }

package/src/lib/data-transfer-objects/src/get.ltr.driver.monthly.sign.off.preview.dto.js

@@ -1,11 +1,16 @@
 import { __decorate, __metadata } from "tslib";
-import { IsOptional, IsString, IsUUID, Matches } from 'class-validator';
+import { IsOptional, IsUUID } from 'class-validator';
 /**
- * Monthly Sign Off — Preview Details screen. (AD-3206)
+ * Sign Off — Preview Details screen. (AD-3206)
  *
- * Everything the screen shows is computed by the backend from the daily logs
- * already on record, scoped to the signing driver and the given month. The app
- * sends nothing to compute.
+ * Everything the screen shows is computed by the backend from the driver's own
+ * open entries, scoped to the signing driver. The app sends nothing to compute.
+ *
+ * **No month.** The preview answers "what have I logged that is still waiting
+ * to be signed", which is a question about the booking rather than about a
+ * calendar month: an entry left unsigned in March is still the driver's to
+ * settle in April, and a month-scoped preview simply stopped showing it. The
+ * range is the whole booking period and the filter is the entry's status.
  */
 export class GetLTRDriverMonthlySignOffPreviewDTO {
     constructor(obj) {
@@ -20,14 +25,6 @@ __decorate([
     IsUUID(4),
     __metadata("design:type", String)
 ], GetLTRDriverMonthlySignOffPreviewDTO.prototype, "registeredUserId", void 0);
-__decorate([
-    IsOptional(),
-    Matches(/^\d{4}-(0[1-9]|1[0-2])$/, {
-        message: 'month must be in YYYY-MM format',
-    }),
-    IsString(),
-    __metadata("design:type", String)
-], GetLTRDriverMonthlySignOffPreviewDTO.prototype, "month", void 0);
 __decorate([
     IsOptional(),
     IsUUID(),

package/src/lib/data-transfer-objects/src/get.ltr.driver.monthly.sign.off.preview.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.ltr.driver.monthly.sign.off.preview.dto.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/data-transfer-objects/src/get.ltr.driver.monthly.sign.off.preview.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,OAAO,oCAAoC;IAqChD,YAAY,GAAmD;QAC9D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD;AArCA;IADC,MAAM,EAAE;;uEACS;AAQlB;IADC,MAAM,CAAC,CAAC,CAAC;;8EACe;AAoBzB;IALC,UAAU,EAAE;IACZ,OAAO,CAAC,yBAAyB,EAAE;QACnC,OAAO,EAAE,iCAAiC;KAC1C,CAAC;IACD,QAAQ,EAAE;;mEACI;AAIf;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;uEACU"}
+{"version":3,"file":"get.ltr.driver.monthly.sign.off.preview.dto.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/data-transfer-objects/src/get.ltr.driver.monthly.sign.off.preview.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oCAAoC;IAiBhD,YAAY,GAAmD;QAC9D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD;AAjBA;IADC,MAAM,EAAE;;uEACS;AAQlB;IADC,MAAM,CAAC,CAAC,CAAC;;8EACe;AAIzB;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;uEACU"}