@parkflow/shared-types 1.9.0 → 1.11.0

package/dist/types/lot-dashboard/index.d.ts

@@ -0,0 +1,9 @@
+export * from './lot-camera-alert.interface';
+export * from './lot-dashboard-occupancy.interface';
+export * from './lot-dashboard-range-key.type';
+export * from './lot-dashboard-range.interface';
+export * from './lot-dashboard-response.interface';
+export * from './lot-dashboard-summary.interface';
+export * from './lot-dashboard-trend-point.interface';
+export * from './lot-parked-vehicle-status.enum';
+export * from './lot-parked-vehicle.interface';

package/dist/types/lot-dashboard/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lot-camera-alert.interface"), exports);
+__exportStar(require("./lot-dashboard-occupancy.interface"), exports);
+__exportStar(require("./lot-dashboard-range-key.type"), exports);
+__exportStar(require("./lot-dashboard-range.interface"), exports);
+__exportStar(require("./lot-dashboard-response.interface"), exports);
+__exportStar(require("./lot-dashboard-summary.interface"), exports);
+__exportStar(require("./lot-dashboard-trend-point.interface"), exports);
+__exportStar(require("./lot-parked-vehicle-status.enum"), exports);
+__exportStar(require("./lot-parked-vehicle.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/lot-dashboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,sEAAoD;AACpD,iEAA+C;AAC/C,kEAAgD;AAChD,qEAAmD;AACnD,oEAAkD;AAClD,wEAAsD;AACtD,mEAAiD;AACjD,iEAA+C"}

package/dist/types/lot-dashboard/lot-camera-alert.interface.d.ts

@@ -0,0 +1,5 @@
+export interface LotCameraAlert {
+    cameraName: string;
+    lastSeenUtc: string | null;
+    silentThresholdHours: number;
+}

package/dist/types/lot-dashboard/lot-camera-alert.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-camera-alert.interface.js.map

package/dist/types/lot-dashboard/lot-camera-alert.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-camera-alert.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-camera-alert.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-dashboard-occupancy.interface.d.ts

@@ -0,0 +1,5 @@
+export interface LotDashboardOccupancy {
+    currentlyParked: number;
+    maxCapacity: number | null;
+    occupancyPct: number | null;
+}

package/dist/types/lot-dashboard/lot-dashboard-occupancy.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-dashboard-occupancy.interface.js.map

package/dist/types/lot-dashboard/lot-dashboard-occupancy.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-dashboard-occupancy.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-dashboard-occupancy.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-dashboard-range-key.type.d.ts

@@ -0,0 +1 @@
+export type LotDashboardRangeKey = 'today' | 'wtd' | 'mtd' | 'ytd' | 'custom';

package/dist/types/lot-dashboard/lot-dashboard-range-key.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-dashboard-range-key.type.js.map

package/dist/types/lot-dashboard/lot-dashboard-range-key.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-dashboard-range-key.type.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-dashboard-range-key.type.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-dashboard-range.interface.d.ts

@@ -0,0 +1,7 @@
+import { LotDashboardRangeKey } from './lot-dashboard-range-key.type';
+export interface LotDashboardRange {
+    key: LotDashboardRangeKey;
+    startUtc: string;
+    endUtc: string;
+    label: string;
+}

package/dist/types/lot-dashboard/lot-dashboard-range.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-dashboard-range.interface.js.map

package/dist/types/lot-dashboard/lot-dashboard-range.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-dashboard-range.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-dashboard-range.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-dashboard-response.interface.d.ts

@@ -0,0 +1,19 @@
+import { LotCameraAlert } from './lot-camera-alert.interface';
+import { LotDashboardOccupancy } from './lot-dashboard-occupancy.interface';
+import { LotDashboardRange } from './lot-dashboard-range.interface';
+import { LotDashboardSummary } from './lot-dashboard-summary.interface';
+import { LotDashboardTrendPoint } from './lot-dashboard-trend-point.interface';
+import { LotParkedVehicle } from './lot-parked-vehicle.interface';
+export interface LotDashboardResponse {
+    lotId: number;
+    lotCode: string;
+    lotName: string | null;
+    timeZone: string;
+    generatedAtUtc: string;
+    range: LotDashboardRange;
+    summary: LotDashboardSummary;
+    occupancy: LotDashboardOccupancy;
+    trend: LotDashboardTrendPoint[];
+    parkedVehicles: LotParkedVehicle[];
+    cameraAlerts: LotCameraAlert[];
+}

package/dist/types/lot-dashboard/lot-dashboard-response.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-dashboard-response.interface.js.map

package/dist/types/lot-dashboard/lot-dashboard-response.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-dashboard-response.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-dashboard-response.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-dashboard-summary.interface.d.ts

@@ -0,0 +1,10 @@
+export interface LotDashboardSummary {
+    entriesTotal: number;
+    entriesIn: number;
+    entriesOut: number;
+    bookings: number;
+    authorizedCount: number;
+    unauthorizedCount: number;
+    ticketsIssued: number;
+    complianceRatePct: number | null;
+}

package/dist/types/lot-dashboard/lot-dashboard-summary.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-dashboard-summary.interface.js.map

package/dist/types/lot-dashboard/lot-dashboard-summary.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-dashboard-summary.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-dashboard-summary.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-dashboard-trend-point.interface.d.ts

@@ -0,0 +1,5 @@
+export interface LotDashboardTrendPoint {
+    bucketStartUtc: string;
+    label: string;
+    entries: number;
+}

package/dist/types/lot-dashboard/lot-dashboard-trend-point.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-dashboard-trend-point.interface.js.map

package/dist/types/lot-dashboard/lot-dashboard-trend-point.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-dashboard-trend-point.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-dashboard-trend-point.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-dashboard/lot-parked-vehicle-status.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum LotParkedVehicleStatus {
+    PaidInside = "Paid - Inside",
+    PermittedInside = "Permitted - Inside",
+    PaidExpiredInside = "Paid Expired - Inside",
+    GraceInside = "Grace Period - Inside",
+    UnpaidInside = "Unpaid - Inside"
+}

package/dist/types/lot-dashboard/lot-parked-vehicle-status.enum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LotParkedVehicleStatus = void 0;
+var LotParkedVehicleStatus;
+(function (LotParkedVehicleStatus) {
+    LotParkedVehicleStatus["PaidInside"] = "Paid - Inside";
+    LotParkedVehicleStatus["PermittedInside"] = "Permitted - Inside";
+    LotParkedVehicleStatus["PaidExpiredInside"] = "Paid Expired - Inside";
+    LotParkedVehicleStatus["GraceInside"] = "Grace Period - Inside";
+    LotParkedVehicleStatus["UnpaidInside"] = "Unpaid - Inside";
+})(LotParkedVehicleStatus || (exports.LotParkedVehicleStatus = LotParkedVehicleStatus = {}));
+//# sourceMappingURL=lot-parked-vehicle-status.enum.js.map

package/dist/types/lot-dashboard/lot-parked-vehicle-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-parked-vehicle-status.enum.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-parked-vehicle-status.enum.ts"],"names":[],"mappings":";;;AAMA,IAAY,sBAMX;AAND,WAAY,sBAAsB;IAC9B,sDAA4B,CAAA;IAC5B,gEAAsC,CAAA;IACtC,qEAA2C,CAAA;IAC3C,+DAAqC,CAAA;IACrC,0DAAgC,CAAA;AACpC,CAAC,EANW,sBAAsB,sCAAtB,sBAAsB,QAMjC"}

package/dist/types/lot-dashboard/lot-parked-vehicle.interface.d.ts

@@ -0,0 +1,8 @@
+import { LotParkedVehicleStatus } from './lot-parked-vehicle-status.enum';
+export interface LotParkedVehicle {
+    lpn: string;
+    state: string | null;
+    status: LotParkedVehicleStatus;
+    entryTimeUtc: string;
+    durationMinutes: number;
+}

package/dist/types/lot-dashboard/lot-parked-vehicle.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-parked-vehicle.interface.js.map

package/dist/types/lot-dashboard/lot-parked-vehicle.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-parked-vehicle.interface.js","sourceRoot":"","sources":["../../../src/types/lot-dashboard/lot-parked-vehicle.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-health/index.d.ts

@@ -1,5 +1,8 @@
 export * from './lot-backlog-severity.enum';
 export * from './lot-backlog-status.interface';
+export * from './lot-blackout-impact-sample.interface';
+export * from './lot-blackout-impact.interface';
+export * from './lot-blackout-window.interface';
 export * from './lot-daily-metrics.interface';
 export * from './lot-day-funnel.interface';
 export * from './lot-enforcement-config.interface';

package/dist/types/lot-health/index.js

@@ -16,6 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lot-backlog-severity.enum"), exports);
 __exportStar(require("./lot-backlog-status.interface"), exports);
+__exportStar(require("./lot-blackout-impact-sample.interface"), exports);
+__exportStar(require("./lot-blackout-impact.interface"), exports);
+__exportStar(require("./lot-blackout-window.interface"), exports);
 __exportStar(require("./lot-daily-metrics.interface"), exports);
 __exportStar(require("./lot-day-funnel.interface"), exports);
 __exportStar(require("./lot-enforcement-config.interface"), exports);

package/dist/types/lot-health/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/lot-health/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,iEAA+C;AAC/C,gEAA8C;AAC9C,6DAA2C;AAC3C,qEAAmD;AACnD,uEAAqD;AACrD,wEAAsD;AACtD,kEAAgD;AAChD,oEAAkD;AAClD,8EAA4D;AAC5D,uEAAqD;AACrD,6EAA2D;AAC3D,mEAAiD;AACjD,uEAAqD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/lot-health/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,iEAA+C;AAC/C,yEAAuD;AACvD,kEAAgD;AAChD,kEAAgD;AAChD,gEAA8C;AAC9C,6DAA2C;AAC3C,qEAAmD;AACnD,uEAAqD;AACrD,wEAAsD;AACtD,kEAAgD;AAChD,oEAAkD;AAClD,8EAA4D;AAC5D,uEAAqD;AACrD,6EAA2D;AAC3D,mEAAiD;AACjD,uEAAqD"}

package/dist/types/lot-health/lot-blackout-impact-sample.interface.d.ts

@@ -0,0 +1,8 @@
+export interface LotBlackoutImpactSample {
+    ticketId: string;
+    ticketNumber: string;
+    sessionId: string;
+    lpn: string;
+    sessionExitAtUtc: string;
+    ticketStatus: string;
+}

package/dist/types/lot-health/lot-blackout-impact-sample.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-blackout-impact-sample.interface.js.map

package/dist/types/lot-health/lot-blackout-impact-sample.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-blackout-impact-sample.interface.js","sourceRoot":"","sources":["../../../src/types/lot-health/lot-blackout-impact-sample.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-health/lot-blackout-impact.interface.d.ts

@@ -0,0 +1,6 @@
+import { LotBlackoutWindow } from './lot-blackout-window.interface';
+export interface LotBlackoutImpact {
+    lookbackSeconds: number;
+    gapThresholdSeconds: number;
+    windows: LotBlackoutWindow[];
+}

package/dist/types/lot-health/lot-blackout-impact.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-blackout-impact.interface.js.map

package/dist/types/lot-health/lot-blackout-impact.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-blackout-impact.interface.js","sourceRoot":"","sources":["../../../src/types/lot-health/lot-blackout-impact.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-health/lot-blackout-window.interface.d.ts

@@ -0,0 +1,10 @@
+import { LotBlackoutImpactSample } from './lot-blackout-impact-sample.interface';
+export interface LotBlackoutWindow {
+    paymentIntegrationId: number;
+    providerName: string;
+    startUtc: string;
+    endUtc: string;
+    durationSeconds: number;
+    impactedTicketCount: number;
+    sample: LotBlackoutImpactSample | null;
+}

package/dist/types/lot-health/lot-blackout-window.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lot-blackout-window.interface.js.map

package/dist/types/lot-health/lot-blackout-window.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-blackout-window.interface.js","sourceRoot":"","sources":["../../../src/types/lot-health/lot-blackout-window.interface.ts"],"names":[],"mappings":""}

package/dist/types/lot-health/lot-health-response.interface.d.ts

@@ -1,5 +1,6 @@
 import { LotEnforcementConfig } from './lot-enforcement-config.interface';
 import { LotBacklogStatus } from './lot-backlog-status.interface';
+import { LotBlackoutImpact } from './lot-blackout-impact.interface';
 import { LotDayFunnel } from './lot-day-funnel.interface';
 import { LotDailyMetrics } from './lot-daily-metrics.interface';
 import { LotEnforcementRunInfo } from './lot-enforcement-run-info.interface';
@@ -17,4 +18,5 @@ export interface LotHealthResponse {
     lastEnforcementRun: LotEnforcementRunInfo | null;
     webhooks: LotWebhookActivity[];
     validations: LotValidationActivitySection;
+    blackoutImpact: LotBlackoutImpact;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parkflow/shared-types",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Shared type definitions for Vanguard services",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/types/index.ts

@@ -1,4 +1,5 @@
 export * from './adaptive';
+export * from './lot-dashboard';
 export * from './lot-health';
 export * from './lpr';
 export * from './platesmart';

package/src/types/lot-dashboard/index.ts

@@ -0,0 +1,9 @@
+export * from './lot-camera-alert.interface';
+export * from './lot-dashboard-occupancy.interface';
+export * from './lot-dashboard-range-key.type';
+export * from './lot-dashboard-range.interface';
+export * from './lot-dashboard-response.interface';
+export * from './lot-dashboard-summary.interface';
+export * from './lot-dashboard-trend-point.interface';
+export * from './lot-parked-vehicle-status.enum';
+export * from './lot-parked-vehicle.interface';

package/src/types/lot-dashboard/lot-camera-alert.interface.ts

@@ -0,0 +1,12 @@
+/**
+ * A camera at the lot that is marked active but has sent no inbound captures within
+ * the alert window — i.e. it looks offline. Surfaced on the dashboard so a dead
+ * entry/exit lane (which silently produces ghost "parked" cars) is visible.
+ */
+export interface LotCameraAlert {
+    cameraName: string;
+    /** Last inbound capture, UTC ISO-8601, or null if none within the recent lookback. */
+    lastSeenUtc: string | null;
+    /** The silence threshold, in hours, that triggered the alert. */
+    silentThresholdHours: number;
+}

package/src/types/lot-dashboard/lot-dashboard-occupancy.interface.ts

@@ -0,0 +1,9 @@
+/** Live occupancy snapshot, independent of the selected window. */
+export interface LotDashboardOccupancy {
+    /** Vehicles currently inside the lot (entry recorded, no exit yet). */
+    currentlyParked: number;
+    /** Configured capacity, or null when the lot has none set. */
+    maxCapacity: number | null;
+    /** Occupied share of capacity, 0–100. Null when capacity is unknown. */
+    occupancyPct: number | null;
+}

package/src/types/lot-dashboard/lot-dashboard-range-key.type.ts

@@ -0,0 +1,6 @@
+/**
+ * Selectable reporting windows for the lot dashboard.
+ * - `today` / `wtd` / `mtd` / `ytd` are computed in the lot's local time zone.
+ * - `custom` is driven by an explicit start/end supplied by the caller.
+ */
+export type LotDashboardRangeKey = 'today' | 'wtd' | 'mtd' | 'ytd' | 'custom';

package/src/types/lot-dashboard/lot-dashboard-range.interface.ts

@@ -0,0 +1,12 @@
+import { LotDashboardRangeKey } from './lot-dashboard-range-key.type';
+
+/** The resolved window the dashboard metrics were computed over. */
+export interface LotDashboardRange {
+    key: LotDashboardRangeKey;
+    /** Inclusive lower bound, UTC ISO-8601. */
+    startUtc: string;
+    /** Exclusive upper bound, UTC ISO-8601. */
+    endUtc: string;
+    /** Human-readable label for the window, formatted in the lot's time zone. */
+    label: string;
+}

package/src/types/lot-dashboard/lot-dashboard-response.interface.ts

@@ -0,0 +1,24 @@
+import { LotCameraAlert } from './lot-camera-alert.interface';
+import { LotDashboardOccupancy } from './lot-dashboard-occupancy.interface';
+import { LotDashboardRange } from './lot-dashboard-range.interface';
+import { LotDashboardSummary } from './lot-dashboard-summary.interface';
+import { LotDashboardTrendPoint } from './lot-dashboard-trend-point.interface';
+import { LotParkedVehicle } from './lot-parked-vehicle.interface';
+
+/** Everything the lot admin dashboard tab needs, computed live from base tables. */
+export interface LotDashboardResponse {
+    lotId: number;
+    lotCode: string;
+    lotName: string | null;
+    timeZone: string;
+    generatedAtUtc: string;
+    range: LotDashboardRange;
+    summary: LotDashboardSummary;
+    occupancy: LotDashboardOccupancy;
+    /** Ordered oldest-to-newest so charts can render left-to-right. */
+    trend: LotDashboardTrendPoint[];
+    /** Vehicles currently inside, newest entry first. */
+    parkedVehicles: LotParkedVehicle[];
+    /** Active cameras that have gone silent (no inbound data) — empty when all are healthy. */
+    cameraAlerts: LotCameraAlert[];
+}

package/src/types/lot-dashboard/lot-dashboard-summary.interface.ts

@@ -0,0 +1,21 @@
+/** Headline counters for the selected window. */
+export interface LotDashboardSummary {
+    /** Entry plus exit capture events recorded in the window. */
+    entriesTotal: number;
+    /** Entry capture events recorded in the window. */
+    entriesIn: number;
+    /** Exit capture events recorded in the window. */
+    entriesOut: number;
+    /** Parking sessions started in the window (a.k.a. turns). */
+    bookings: number;
+    /** Completed sessions in the window that were paid, permitted, whitelisted, or within grace. */
+    authorizedCount: number;
+    /** Completed sessions in the window that produced a violation. */
+    unauthorizedCount: number;
+    ticketsIssued: number;
+    /**
+     * Share of completed sessions that were compliant, 0–100.
+     * Null when there is not yet enough processed data to compute it.
+     */
+    complianceRatePct: number | null;
+}

package/src/types/lot-dashboard/lot-dashboard-trend-point.interface.ts

@@ -0,0 +1,9 @@
+/** One bucket of the entries trend series spanning the selected window. */
+export interface LotDashboardTrendPoint {
+    /** Bucket lower bound, UTC ISO-8601. */
+    bucketStartUtc: string;
+    /** Short label for the bucket, formatted in the lot's time zone (e.g. "2pm" or "Jun 9"). */
+    label: string;
+    /** Entry capture events that fell in the bucket. */
+    entries: number;
+}

package/src/types/lot-dashboard/lot-parked-vehicle-status.enum.ts

@@ -0,0 +1,13 @@
+/**
+ * Live payment/permit standing of a vehicle that is currently inside the lot
+ * (entry capture recorded, no later exit capture). Computed against the live
+ * validation/permit tables rather than the enforcement verdict, because a
+ * still-parked vehicle has usually not been run through enforcement yet.
+ */
+export enum LotParkedVehicleStatus {
+    PaidInside = 'Paid - Inside',
+    PermittedInside = 'Permitted - Inside',
+    PaidExpiredInside = 'Paid Expired - Inside',
+    GraceInside = 'Grace Period - Inside',
+    UnpaidInside = 'Unpaid - Inside',
+}

package/src/types/lot-dashboard/lot-parked-vehicle.interface.ts

@@ -0,0 +1,12 @@
+import { LotParkedVehicleStatus } from './lot-parked-vehicle-status.enum';
+
+/** A single vehicle currently inside the lot, with its live standing. */
+export interface LotParkedVehicle {
+    lpn: string;
+    state: string | null;
+    status: LotParkedVehicleStatus;
+    /** When the vehicle entered, UTC ISO-8601. */
+    entryTimeUtc: string;
+    /** Minutes elapsed since entry as of the snapshot. */
+    durationMinutes: number;
+}

package/src/types/lot-health/index.ts

@@ -1,5 +1,8 @@
 export * from './lot-backlog-severity.enum';
 export * from './lot-backlog-status.interface';
+export * from './lot-blackout-impact-sample.interface';
+export * from './lot-blackout-impact.interface';
+export * from './lot-blackout-window.interface';
 export * from './lot-daily-metrics.interface';
 export * from './lot-day-funnel.interface';
 export * from './lot-enforcement-config.interface';

package/src/types/lot-health/lot-blackout-impact-sample.interface.ts

@@ -0,0 +1,14 @@
+/**
+ * One representative ticket whose underlying session ended during a payment-integration blackout
+ * and is currently in a mailing-eligible status. The oldest such ticket per blackout window is picked.
+ */
+export interface LotBlackoutImpactSample {
+    ticketId: string;
+    ticketNumber: string;
+    sessionId: string;
+    lpn: string;
+    /** ISO-8601 UTC timestamp of the session's exit capture. */
+    sessionExitAtUtc: string;
+    /** Current ticket status (e.g. "Pending", "Ready", "Dispatched"). */
+    ticketStatus: string;
+}

package/src/types/lot-health/lot-blackout-impact.interface.ts

@@ -0,0 +1,15 @@
+import { LotBlackoutWindow } from './lot-blackout-window.interface';
+
+/**
+ * Summary of payment-integration blackout windows on a lot and the tickets currently at risk
+ * because of them. A blackout window is a gap between consecutive validation rows for a given
+ * (lot, payment integration) longer than a configured threshold within a recent lookback.
+ */
+export interface LotBlackoutImpact {
+    /** Lookback window applied when scanning for gaps, in seconds. */
+    lookbackSeconds: number;
+    /** Minimum gap (in seconds) treated as a blackout. */
+    gapThresholdSeconds: number;
+    /** Detected blackout windows, ordered by startUtc ascending. */
+    windows: LotBlackoutWindow[];
+}

package/src/types/lot-health/lot-blackout-window.interface.ts

@@ -0,0 +1,20 @@
+import { LotBlackoutImpactSample } from './lot-blackout-impact-sample.interface';
+
+/**
+ * A detected gap in inbound payment-integration validations for a lot, paired with the count of
+ * tickets currently in a mailing-eligible status whose session ended inside the gap.
+ */
+export interface LotBlackoutWindow {
+    paymentIntegrationId: number;
+    providerName: string;
+    /** ISO-8601 UTC timestamp marking the start of the blackout. */
+    startUtc: string;
+    /** ISO-8601 UTC timestamp marking the end of the blackout. */
+    endUtc: string;
+    /** Length of the blackout in seconds — convenience for the UI. */
+    durationSeconds: number;
+    /** Tickets in mailing-eligible status whose session exit falls inside this window. */
+    impactedTicketCount: number;
+    /** A representative impacted ticket (oldest by session exit). Null when impactedTicketCount === 0. */
+    sample: LotBlackoutImpactSample | null;
+}

package/src/types/lot-health/lot-health-response.interface.ts

@@ -1,5 +1,6 @@
 import { LotEnforcementConfig } from './lot-enforcement-config.interface';
 import { LotBacklogStatus } from './lot-backlog-status.interface';
+import { LotBlackoutImpact } from './lot-blackout-impact.interface';
 import { LotDayFunnel } from './lot-day-funnel.interface';
 import { LotDailyMetrics } from './lot-daily-metrics.interface';
 import { LotEnforcementRunInfo } from './lot-enforcement-run-info.interface';
@@ -21,4 +22,6 @@ export interface LotHealthResponse {
     webhooks: LotWebhookActivity[];
     /** Inbound payment validations and the configured-provider health summary for the last 24h. */
     validations: LotValidationActivitySection;
+    /** Detected payment-integration blackout windows and tickets currently at risk because of them. */
+    blackoutImpact: LotBlackoutImpact;
 }

package/.npmrc.publish

@@ -1 +0,0 @@
-//registry.npmjs.org/:_authToken=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