@parkflow/shared-types 1.6.0 → 1.10.0

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

@@ -0,0 +1,34 @@
+"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-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);
+__exportStar(require("./lot-enforcement-run-info.interface"), exports);
+__exportStar(require("./lot-enforcement-trigger-source.enum"), exports);
+__exportStar(require("./lot-health-response.interface"), exports);
+__exportStar(require("./lot-recent-validation.interface"), exports);
+__exportStar(require("./lot-validation-activity-section.interface"), exports);
+__exportStar(require("./lot-validation-provider-state.enum"), exports);
+__exportStar(require("./lot-validation-provider-status.interface"), exports);
+__exportStar(require("./lot-webhook-activity.interface"), exports);
+__exportStar(require("./validation-reason-bucket.interface"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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-backlog-severity.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum LotBacklogSeverity {
+    Ok = "ok",
+    Warn = "warn",
+    Alert = "alert"
+}

package/dist/types/lot-health/lot-backlog-severity.enum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LotBacklogSeverity = void 0;
+var LotBacklogSeverity;
+(function (LotBacklogSeverity) {
+    LotBacklogSeverity["Ok"] = "ok";
+    LotBacklogSeverity["Warn"] = "warn";
+    LotBacklogSeverity["Alert"] = "alert";
+})(LotBacklogSeverity || (exports.LotBacklogSeverity = LotBacklogSeverity = {}));
+//# sourceMappingURL=lot-backlog-severity.enum.js.map

package/dist/types/lot-health/lot-backlog-severity.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-backlog-severity.enum.js","sourceRoot":"","sources":["../../../src/types/lot-health/lot-backlog-severity.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,+BAAS,CAAA;IACT,mCAAa,CAAA;IACb,qCAAe,CAAA;AACnB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B"}

package/dist/types/lot-health/lot-backlog-status.interface.d.ts

@@ -0,0 +1,8 @@
+import { LotBacklogSeverity } from './lot-backlog-severity.enum';
+export interface LotBacklogStatus {
+    unprocessedCount: number;
+    oldestUnprocessedAtUtc: string | null;
+    oldestUnprocessedAgeSeconds: number | null;
+    severity: LotBacklogSeverity;
+    advisory: string | null;
+}

package/dist/types/lot-health/lot-backlog-status.interface.js

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

package/dist/types/lot-health/lot-backlog-status.interface.js.map

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

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-daily-metrics.interface.d.ts

@@ -0,0 +1,8 @@
+export interface LotDailyMetrics {
+    localDate: string;
+    totalSessions: number;
+    validatedCount: number;
+    ticketedCount: number;
+    unprocessedCount: number;
+    violationRatePct: number | null;
+}

package/dist/types/lot-health/lot-daily-metrics.interface.js

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

package/dist/types/lot-health/lot-daily-metrics.interface.js.map

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

package/dist/types/lot-health/lot-day-funnel.interface.d.ts

@@ -0,0 +1,12 @@
+import { ValidationReasonBucket } from './validation-reason-bucket.interface';
+export interface LotDayFunnel {
+    dayLabel: string;
+    rangeStartUtc: string;
+    rangeEndUtc: string;
+    totalSessions: number;
+    validatedCount: number;
+    ticketedCount: number;
+    unprocessedCount: number;
+    violationRatePct: number | null;
+    validationReasons: ValidationReasonBucket[];
+}

package/dist/types/lot-health/lot-day-funnel.interface.js

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

package/dist/types/lot-health/lot-day-funnel.interface.js.map

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

package/dist/types/lot-health/lot-enforcement-config.interface.d.ts

@@ -0,0 +1,8 @@
+export interface LotEnforcementConfig {
+    isEnforcementActive: boolean;
+    liveEnforcement: boolean;
+    hasLiveEnforcementCheck: boolean;
+    gracePeriodMinutes: number;
+    paidGracePeriodBeforeMinutes: number;
+    paidGracePeriodAfterMinutes: number;
+}

package/dist/types/lot-health/lot-enforcement-config.interface.js

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

package/dist/types/lot-health/lot-enforcement-config.interface.js.map

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

package/dist/types/lot-health/lot-enforcement-run-info.interface.d.ts

@@ -0,0 +1,7 @@
+import { LotEnforcementTriggerSource } from './lot-enforcement-trigger-source.enum';
+export interface LotEnforcementRunInfo {
+    lastRunAtUtc: string;
+    lastSuccessAtUtc: string | null;
+    lastTriggerSource: LotEnforcementTriggerSource;
+    lastError: string | null;
+}

package/dist/types/lot-health/lot-enforcement-run-info.interface.js

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

package/dist/types/lot-health/lot-enforcement-run-info.interface.js.map

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

package/dist/types/lot-health/lot-enforcement-trigger-source.enum.d.ts

@@ -0,0 +1,6 @@
+export declare enum LotEnforcementTriggerSource {
+    Cron = "cron",
+    Manual = "manual",
+    CaptureEvent = "capture-event",
+    Unknown = "unknown"
+}

package/dist/types/lot-health/lot-enforcement-trigger-source.enum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LotEnforcementTriggerSource = void 0;
+var LotEnforcementTriggerSource;
+(function (LotEnforcementTriggerSource) {
+    LotEnforcementTriggerSource["Cron"] = "cron";
+    LotEnforcementTriggerSource["Manual"] = "manual";
+    LotEnforcementTriggerSource["CaptureEvent"] = "capture-event";
+    LotEnforcementTriggerSource["Unknown"] = "unknown";
+})(LotEnforcementTriggerSource || (exports.LotEnforcementTriggerSource = LotEnforcementTriggerSource = {}));
+//# sourceMappingURL=lot-enforcement-trigger-source.enum.js.map

package/dist/types/lot-health/lot-enforcement-trigger-source.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-enforcement-trigger-source.enum.js","sourceRoot":"","sources":["../../../src/types/lot-health/lot-enforcement-trigger-source.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACnC,4CAAa,CAAA;IACb,gDAAiB,CAAA;IACjB,6DAA8B,CAAA;IAC9B,kDAAmB,CAAA;AACvB,CAAC,EALW,2BAA2B,2CAA3B,2BAA2B,QAKtC"}

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

@@ -0,0 +1,22 @@
+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';
+import { LotWebhookActivity } from './lot-webhook-activity.interface';
+import { LotValidationActivitySection } from './lot-validation-activity-section.interface';
+export interface LotHealthResponse {
+    lotId: number;
+    lotCode: string;
+    timeZone: string;
+    generatedAtUtc: string;
+    config: LotEnforcementConfig;
+    backlog: LotBacklogStatus;
+    today: LotDayFunnel;
+    trend: LotDailyMetrics[];
+    lastEnforcementRun: LotEnforcementRunInfo | null;
+    webhooks: LotWebhookActivity[];
+    validations: LotValidationActivitySection;
+    blackoutImpact: LotBlackoutImpact;
+}

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

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

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

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

package/dist/types/lot-health/lot-recent-validation.interface.d.ts

@@ -0,0 +1,10 @@
+export interface LotRecentValidation {
+    id: string;
+    lpn: string;
+    state: string | null;
+    providerName: string | null;
+    receiptId: string | null;
+    startUtc: string;
+    endUtc: string;
+    receivedAtUtc: string;
+}

package/dist/types/lot-health/lot-recent-validation.interface.js

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

package/dist/types/lot-health/lot-recent-validation.interface.js.map

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

package/dist/types/lot-health/lot-validation-activity-section.interface.d.ts

@@ -0,0 +1,6 @@
+import { LotRecentValidation } from './lot-recent-validation.interface';
+import { LotValidationProviderStatus } from './lot-validation-provider-status.interface';
+export interface LotValidationActivitySection {
+    providers: LotValidationProviderStatus[];
+    recent: LotRecentValidation[];
+}

package/dist/types/lot-health/lot-validation-activity-section.interface.js

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

package/dist/types/lot-health/lot-validation-activity-section.interface.js.map

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

package/dist/types/lot-health/lot-validation-provider-state.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum LotValidationProviderState {
+    Active = "active",
+    Stale = "stale",
+    Silent = "silent"
+}

package/dist/types/lot-health/lot-validation-provider-state.enum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LotValidationProviderState = void 0;
+var LotValidationProviderState;
+(function (LotValidationProviderState) {
+    LotValidationProviderState["Active"] = "active";
+    LotValidationProviderState["Stale"] = "stale";
+    LotValidationProviderState["Silent"] = "silent";
+})(LotValidationProviderState || (exports.LotValidationProviderState = LotValidationProviderState = {}));
+//# sourceMappingURL=lot-validation-provider-state.enum.js.map

package/dist/types/lot-health/lot-validation-provider-state.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lot-validation-provider-state.enum.js","sourceRoot":"","sources":["../../../src/types/lot-health/lot-validation-provider-state.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,0BAOX;AAPD,WAAY,0BAA0B;IAElC,+CAAiB,CAAA;IAEjB,6CAAe,CAAA;IAEf,+CAAiB,CAAA;AACrB,CAAC,EAPW,0BAA0B,0CAA1B,0BAA0B,QAOrC"}

package/dist/types/lot-health/lot-validation-provider-status.interface.d.ts

@@ -0,0 +1,8 @@
+import { LotValidationProviderState } from './lot-validation-provider-state.enum';
+export interface LotValidationProviderStatus {
+    paymentIntegrationId: number;
+    providerName: string;
+    state: LotValidationProviderState;
+    countLast24h: number;
+    lastReceivedAtUtc: string | null;
+}

package/dist/types/lot-health/lot-validation-provider-status.interface.js

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

package/dist/types/lot-health/lot-validation-provider-status.interface.js.map

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

package/dist/types/lot-health/lot-webhook-activity.interface.d.ts

@@ -0,0 +1,12 @@
+export interface LotWebhookActivity {
+    id: string;
+    eventType: string;
+    status: string;
+    statusCode: number | null;
+    subscriberName: string | null;
+    destinationUrl: string | null;
+    createdAtUtc: string;
+    retryCount: number;
+    errorMessage: string | null;
+    payload: unknown;
+}

package/dist/types/lot-health/lot-webhook-activity.interface.js

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

package/dist/types/lot-health/lot-webhook-activity.interface.js.map

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

package/dist/types/lot-health/validation-reason-bucket.interface.d.ts

@@ -0,0 +1,4 @@
+export interface ValidationReasonBucket {
+    reasonShort: string;
+    count: number;
+}

package/dist/types/lot-health/validation-reason-bucket.interface.js

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

package/dist/types/lot-health/validation-reason-bucket.interface.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parkflow/shared-types",
-  "version": "1.6.0",
+  "version": "1.10.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-health';
+export * from './lpr';
 export * from './platesmart';
 export * from './rekor';
-export * from './lpr';

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

@@ -0,0 +1,17 @@
+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';
+export * from './lot-enforcement-run-info.interface';
+export * from './lot-enforcement-trigger-source.enum';
+export * from './lot-health-response.interface';
+export * from './lot-recent-validation.interface';
+export * from './lot-validation-activity-section.interface';
+export * from './lot-validation-provider-state.enum';
+export * from './lot-validation-provider-status.interface';
+export * from './lot-webhook-activity.interface';
+export * from './validation-reason-bucket.interface';

package/src/types/lot-health/lot-backlog-severity.enum.ts

@@ -0,0 +1,5 @@
+export enum LotBacklogSeverity {
+    Ok = 'ok',
+    Warn = 'warn',
+    Alert = 'alert',
+}

package/src/types/lot-health/lot-backlog-status.interface.ts

@@ -0,0 +1,10 @@
+import { LotBacklogSeverity } from './lot-backlog-severity.enum';
+
+export interface LotBacklogStatus {
+    unprocessedCount: number;
+    oldestUnprocessedAtUtc: string | null;
+    oldestUnprocessedAgeSeconds: number | null;
+    severity: LotBacklogSeverity;
+    /** Phrased for end-user display so the UI does not derive its own copy. */
+    advisory: string | null;
+}

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-daily-metrics.interface.ts

@@ -0,0 +1,8 @@
+export interface LotDailyMetrics {
+    localDate: string;
+    totalSessions: number;
+    validatedCount: number;
+    ticketedCount: number;
+    unprocessedCount: number;
+    violationRatePct: number | null;
+}

package/src/types/lot-health/lot-day-funnel.interface.ts

@@ -0,0 +1,14 @@
+import { ValidationReasonBucket } from './validation-reason-bucket.interface';
+
+export interface LotDayFunnel {
+    dayLabel: string;
+    rangeStartUtc: string;
+    rangeEndUtc: string;
+    totalSessions: number;
+    validatedCount: number;
+    ticketedCount: number;
+    unprocessedCount: number;
+    /** Null while unprocessedCount > 0 — the rate is not final until enforcement has run. */
+    violationRatePct: number | null;
+    validationReasons: ValidationReasonBucket[];
+}

package/src/types/lot-health/lot-enforcement-config.interface.ts

@@ -0,0 +1,8 @@
+export interface LotEnforcementConfig {
+    isEnforcementActive: boolean;
+    liveEnforcement: boolean;
+    hasLiveEnforcementCheck: boolean;
+    gracePeriodMinutes: number;
+    paidGracePeriodBeforeMinutes: number;
+    paidGracePeriodAfterMinutes: number;
+}

package/src/types/lot-health/lot-enforcement-run-info.interface.ts

@@ -0,0 +1,8 @@
+import { LotEnforcementTriggerSource } from './lot-enforcement-trigger-source.enum';
+
+export interface LotEnforcementRunInfo {
+    lastRunAtUtc: string;
+    lastSuccessAtUtc: string | null;
+    lastTriggerSource: LotEnforcementTriggerSource;
+    lastError: string | null;
+}

package/src/types/lot-health/lot-enforcement-trigger-source.enum.ts

@@ -0,0 +1,6 @@
+export enum LotEnforcementTriggerSource {
+    Cron = 'cron',
+    Manual = 'manual',
+    CaptureEvent = 'capture-event',
+    Unknown = 'unknown',
+}

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

@@ -0,0 +1,27 @@
+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';
+import { LotWebhookActivity } from './lot-webhook-activity.interface';
+import { LotValidationActivitySection } from './lot-validation-activity-section.interface';
+
+export interface LotHealthResponse {
+    lotId: number;
+    lotCode: string;
+    timeZone: string;
+    generatedAtUtc: string;
+    config: LotEnforcementConfig;
+    backlog: LotBacklogStatus;
+    today: LotDayFunnel;
+    /** Days with zero sessions are still returned so chart density is preserved. */
+    trend: LotDailyMetrics[];
+    lastEnforcementRun: LotEnforcementRunInfo | null;
+    /** Most recent outbound webhook deliveries tagged with this lot, capped to a small window. */
+    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/src/types/lot-health/lot-recent-validation.interface.ts

@@ -0,0 +1,14 @@
+/**
+ * One inbound parking validation as displayed in the Health tab.
+ * IDs are synthesised from receiptId + lpn + start so React keys are stable across polls.
+ */
+export interface LotRecentValidation {
+    id: string;
+    lpn: string;
+    state: string | null;
+    providerName: string | null;
+    receiptId: string | null;
+    startUtc: string;
+    endUtc: string;
+    receivedAtUtc: string;
+}

package/src/types/lot-health/lot-validation-activity-section.interface.ts

@@ -0,0 +1,9 @@
+import { LotRecentValidation } from './lot-recent-validation.interface';
+import { LotValidationProviderStatus } from './lot-validation-provider-status.interface';
+
+export interface LotValidationActivitySection {
+    /** One entry per payment integration configured on the lot, ordered by provider name. */
+    providers: LotValidationProviderStatus[];
+    /** Most recent inbound validations for the lot, capped to a small window. */
+    recent: LotRecentValidation[];
+}

package/src/types/lot-health/lot-validation-provider-state.enum.ts

@@ -0,0 +1,8 @@
+export enum LotValidationProviderState {
+    /** Validations in the last 24h with most recent within ~2 hours. */
+    Active = 'active',
+    /** Validations exist in 24h but most recent is older than ~2 hours. */
+    Stale = 'stale',
+    /** Provider is configured on the lot but produced no validations in 24h. */
+    Silent = 'silent',
+}