@spytecgps/nova-orm 1.4.243 → 1.4.244

package/dist/entities/job.d.ts

@@ -1,4 +1,24 @@
-export type JobStatus = 'Upcoming' | 'In Progress' | 'Completed';
+/**
+ * Legacy three-state status. The processor keeps this in sync with `lifecycle`
+ * via {@link deriveLegacyStatus} so existing FE callers continue to work while
+ * the three-axis model rolls out.
+ */
+export type JobStatus = 'Upcoming' | 'In Progress' | 'Completed' | 'Cancelled';
+/**
+ * Mutually exclusive lifecycle phase. Exactly one at any time.
+ * Drives the primary status chip on the job card.
+ */
+export type JobLifecycle = 'Upcoming' | 'AwaitingUpdate' | 'AtOrigin' | 'InProgress' | 'Arriving' | 'Arrived' | 'Complete' | 'Cancelled';
+/**
+ * Non-exclusive health signals. Zero or more apply at once.
+ */
+export type JobHealthChip = 'OnTrack' | 'Delayed' | 'DelayedStart' | 'NotReporting' | 'RuleViolation' | 'LowBattery';
+/**
+ * Arrival evidence state. Mutually exclusive.
+ */
+export type JobProofState = 'NotArrived' | 'FirstObserved' | 'ArrivalConfirmed' | 'Unknown';
+/** Derived when lifecycle reaches Complete. */
+export type JobOutcome = 'on_time' | 'late' | 'early';
 export interface JobRule {
     id: string;
     kind: string;
@@ -6,6 +26,7 @@ export interface JobRule {
     config?: Record<string, unknown>;
     violated?: boolean;
     violationDetail?: string;
+    violatedAt?: string;
 }
 export interface JobTimelineEvent {
     id: string;
@@ -13,23 +34,43 @@ export interface JobTimelineEvent {
     time: string;
     kind?: 'now' | 'alert' | 'info';
 }
+export declare const ACTIVE_JOB_LIFECYCLES: ReadonlySet<JobLifecycle>;
+export declare const deriveLegacyStatus: (lifecycle: JobLifecycle) => JobStatus;
 export declare class Job {
     id: number;
     clientId: number;
     imei: string;
     name: string;
+    /** Legacy three-state — kept in sync with {@link lifecycle} by the processor. */
     status: JobStatus;
+    lifecycle: JobLifecycle;
+    healthChips: JobHealthChip[] | null;
+    proofState: JobProofState;
+    outcome: JobOutcome | null;
     startLat: number | null;
     startLng: number | null;
     startLabel: string | null;
     startDetail: string | null;
+    startRadiusM: number;
     endLat: number | null;
     endLng: number | null;
     endLabel: string | null;
     endDetail: string | null;
+    endRadiusM: number;
     scheduledStart: Date | null;
     targetArrival: Date | null;
+    startedAt: Date | null;
+    firstObservedAt: Date | null;
     arrivedAt: Date | null;
+    completedAt: Date | null;
+    cancelledAt: Date | null;
+    pingsInEndZone: number;
+    lastPositionAt: Date | null;
+    lastEvaluatedAt: Date | null;
+    etaArrivalAt: Date | null;
+    etaUpdatedAt: Date | null;
+    etaDriveSeconds: number | null;
+    etaDistanceMeters: number | null;
     rules: JobRule[] | null;
     timeline: JobTimelineEvent[] | null;
     liveLinkToken: string | null;

package/dist/entities/job.js

@@ -1 +1 @@
-"use strict";var e=require("../node_modules/tslib/tslib.es6.js"),t=require("typeorm"),a=require("../utils/uuidTransformer.js");exports.Job=class Job{id;clientId;imei;name;status;startLat;startLng;startLabel;startDetail;endLat;endLng;endLabel;endDetail;scheduledStart;targetArrival;arrivedAt;rules;timeline;liveLinkToken;createdBy;createdAt;modifiedBy;modifiedAt;deletedAt;deletedBy},e.__decorate([t.PrimaryGeneratedColumn({type:"int",name:"id"}),e.__metadata("design:type",Number)],exports.Job.prototype,"id",void 0),e.__decorate([t.Column("int",{name:"clientId"}),e.__metadata("design:type",Number)],exports.Job.prototype,"clientId",void 0),e.__decorate([t.Column("varchar",{name:"imei",length:15}),e.__metadata("design:type",String)],exports.Job.prototype,"imei",void 0),e.__decorate([t.Column("varchar",{name:"name",length:255}),e.__metadata("design:type",String)],exports.Job.prototype,"name",void 0),e.__decorate([t.Column("varchar",{name:"status",length:20}),e.__metadata("design:type",String)],exports.Job.prototype,"status",void 0),e.__decorate([t.Column("double",{name:"startLat",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"startLat",void 0),e.__decorate([t.Column("double",{name:"startLng",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"startLng",void 0),e.__decorate([t.Column("varchar",{name:"startLabel",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"startLabel",void 0),e.__decorate([t.Column("varchar",{name:"startDetail",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"startDetail",void 0),e.__decorate([t.Column("double",{name:"endLat",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"endLat",void 0),e.__decorate([t.Column("double",{name:"endLng",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"endLng",void 0),e.__decorate([t.Column("varchar",{name:"endLabel",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"endLabel",void 0),e.__decorate([t.Column("varchar",{name:"endDetail",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"endDetail",void 0),e.__decorate([t.Column("datetime",{name:"scheduledStart",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"scheduledStart",void 0),e.__decorate([t.Column("datetime",{name:"targetArrival",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"targetArrival",void 0),e.__decorate([t.Column("datetime",{name:"arrivedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"arrivedAt",void 0),e.__decorate([t.Column("json",{name:"rules",nullable:!0}),e.__metadata("design:type",Array)],exports.Job.prototype,"rules",void 0),e.__decorate([t.Column("json",{name:"timeline",nullable:!0}),e.__metadata("design:type",Array)],exports.Job.prototype,"timeline",void 0),e.__decorate([t.Column("binary",{name:"liveLinkToken",length:16,nullable:!0,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"liveLinkToken",void 0),e.__decorate([t.Column("binary",{name:"createdBy",length:16,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"createdBy",void 0),e.__decorate([t.CreateDateColumn({name:"createdAt"}),e.__metadata("design:type",Date)],exports.Job.prototype,"createdAt",void 0),e.__decorate([t.Column("binary",{name:"modifiedBy",length:16,nullable:!0,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"modifiedBy",void 0),e.__decorate([t.UpdateDateColumn({name:"modifiedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"modifiedAt",void 0),e.__decorate([t.DeleteDateColumn({name:"deletedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"deletedAt",void 0),e.__decorate([t.Column("binary",{name:"deletedBy",length:16,nullable:!0,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"deletedBy",void 0),exports.Job=e.__decorate([t.Index("ixJobClientIdStatus",["clientId","status"],{}),t.Index("ixJobClientIdCreatedBy",["clientId","createdBy"],{}),t.Index("uxJobLiveLinkToken",["liveLinkToken"],{unique:!0}),t.Entity("job",{schema:"nova"})],exports.Job);
+"use strict";var e=require("../node_modules/tslib/tslib.es6.js"),t=require("typeorm"),a=require("../utils/uuidTransformer.js");exports.Job=class Job{id;clientId;imei;name;status;lifecycle;healthChips;proofState;outcome;startLat;startLng;startLabel;startDetail;startRadiusM;endLat;endLng;endLabel;endDetail;endRadiusM;scheduledStart;targetArrival;startedAt;firstObservedAt;arrivedAt;completedAt;cancelledAt;pingsInEndZone;lastPositionAt;lastEvaluatedAt;etaArrivalAt;etaUpdatedAt;etaDriveSeconds;etaDistanceMeters;rules;timeline;liveLinkToken;createdBy;createdAt;modifiedBy;modifiedAt;deletedAt;deletedBy},e.__decorate([t.PrimaryGeneratedColumn({type:"int",name:"id"}),e.__metadata("design:type",Number)],exports.Job.prototype,"id",void 0),e.__decorate([t.Column("int",{name:"clientId"}),e.__metadata("design:type",Number)],exports.Job.prototype,"clientId",void 0),e.__decorate([t.Column("varchar",{name:"imei",length:15}),e.__metadata("design:type",String)],exports.Job.prototype,"imei",void 0),e.__decorate([t.Column("varchar",{name:"name",length:255}),e.__metadata("design:type",String)],exports.Job.prototype,"name",void 0),e.__decorate([t.Column("varchar",{name:"status",length:20}),e.__metadata("design:type",String)],exports.Job.prototype,"status",void 0),e.__decorate([t.Column("varchar",{name:"lifecycle",length:20,default:"Upcoming"}),e.__metadata("design:type",String)],exports.Job.prototype,"lifecycle",void 0),e.__decorate([t.Column("json",{name:"healthChips",nullable:!0}),e.__metadata("design:type",Array)],exports.Job.prototype,"healthChips",void 0),e.__decorate([t.Column("varchar",{name:"proofState",length:20,default:"NotArrived"}),e.__metadata("design:type",String)],exports.Job.prototype,"proofState",void 0),e.__decorate([t.Column("varchar",{name:"outcome",length:10,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"outcome",void 0),e.__decorate([t.Column("double",{name:"startLat",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"startLat",void 0),e.__decorate([t.Column("double",{name:"startLng",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"startLng",void 0),e.__decorate([t.Column("varchar",{name:"startLabel",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"startLabel",void 0),e.__decorate([t.Column("varchar",{name:"startDetail",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"startDetail",void 0),e.__decorate([t.Column("int",{name:"startRadiusM",default:150}),e.__metadata("design:type",Number)],exports.Job.prototype,"startRadiusM",void 0),e.__decorate([t.Column("double",{name:"endLat",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"endLat",void 0),e.__decorate([t.Column("double",{name:"endLng",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"endLng",void 0),e.__decorate([t.Column("varchar",{name:"endLabel",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"endLabel",void 0),e.__decorate([t.Column("varchar",{name:"endDetail",length:500,nullable:!0}),e.__metadata("design:type",String)],exports.Job.prototype,"endDetail",void 0),e.__decorate([t.Column("int",{name:"endRadiusM",default:150}),e.__metadata("design:type",Number)],exports.Job.prototype,"endRadiusM",void 0),e.__decorate([t.Column("datetime",{name:"scheduledStart",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"scheduledStart",void 0),e.__decorate([t.Column("datetime",{name:"targetArrival",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"targetArrival",void 0),e.__decorate([t.Column("datetime",{name:"startedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"startedAt",void 0),e.__decorate([t.Column("datetime",{name:"firstObservedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"firstObservedAt",void 0),e.__decorate([t.Column("datetime",{name:"arrivedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"arrivedAt",void 0),e.__decorate([t.Column("datetime",{name:"completedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"completedAt",void 0),e.__decorate([t.Column("datetime",{name:"cancelledAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"cancelledAt",void 0),e.__decorate([t.Column("int",{name:"pingsInEndZone",default:0}),e.__metadata("design:type",Number)],exports.Job.prototype,"pingsInEndZone",void 0),e.__decorate([t.Column("datetime",{name:"lastPositionAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"lastPositionAt",void 0),e.__decorate([t.Column("datetime",{name:"lastEvaluatedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"lastEvaluatedAt",void 0),e.__decorate([t.Column("datetime",{name:"etaArrivalAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"etaArrivalAt",void 0),e.__decorate([t.Column("datetime",{name:"etaUpdatedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"etaUpdatedAt",void 0),e.__decorate([t.Column("int",{name:"etaDriveSeconds",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"etaDriveSeconds",void 0),e.__decorate([t.Column("int",{name:"etaDistanceMeters",nullable:!0}),e.__metadata("design:type",Number)],exports.Job.prototype,"etaDistanceMeters",void 0),e.__decorate([t.Column("json",{name:"rules",nullable:!0}),e.__metadata("design:type",Array)],exports.Job.prototype,"rules",void 0),e.__decorate([t.Column("json",{name:"timeline",nullable:!0}),e.__metadata("design:type",Array)],exports.Job.prototype,"timeline",void 0),e.__decorate([t.Column("binary",{name:"liveLinkToken",length:16,nullable:!0,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"liveLinkToken",void 0),e.__decorate([t.Column("binary",{name:"createdBy",length:16,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"createdBy",void 0),e.__decorate([t.CreateDateColumn({name:"createdAt"}),e.__metadata("design:type",Date)],exports.Job.prototype,"createdAt",void 0),e.__decorate([t.Column("binary",{name:"modifiedBy",length:16,nullable:!0,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"modifiedBy",void 0),e.__decorate([t.UpdateDateColumn({name:"modifiedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"modifiedAt",void 0),e.__decorate([t.DeleteDateColumn({name:"deletedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.Job.prototype,"deletedAt",void 0),e.__decorate([t.Column("binary",{name:"deletedBy",length:16,nullable:!0,transformer:a.UUIDTransformer}),e.__metadata("design:type",String)],exports.Job.prototype,"deletedBy",void 0),exports.Job=e.__decorate([t.Index("ixJobClientIdStatus",["clientId","status"],{}),t.Index("ixJobClientIdLifecycle",["clientId","lifecycle"],{}),t.Index("ixJobImeiLifecycle",["imei","lifecycle"],{}),t.Index("ixJobClientIdCreatedBy",["clientId","createdBy"],{}),t.Index("uxJobLiveLinkToken",["liveLinkToken"],{unique:!0}),t.Entity("job",{schema:"nova"})],exports.Job);

package/dist/migration/_virtual/_virtual_multi-entry.js

@@ -1,13 +1,13 @@
 'use strict';
 
 var _1684483704434AddLowerCaseIndex = require('../1684483704434-addLowerCaseIndex.js');
-var _1684483705001UpdateSecurityUserViewsV1 = require('../1684483705001-updateSecurityUserViewsV1.js');
 var _1746434400000AddQuickSearchFulltextIndexes = require('../1746434400000-addQuickSearchFulltextIndexes.js');
+var _1684483705001UpdateSecurityUserViewsV1 = require('../1684483705001-updateSecurityUserViewsV1.js');
 var _1684483705002UpdateSecurityUserViewsV2 = require('../1684483705002-updateSecurityUserViewsV2.js');
 
 
 
 exports.addLowerCaseIndex1684483704434 = _1684483704434AddLowerCaseIndex.addLowerCaseIndex1684483704434;
-exports.updateSecurityUserViewsV11684483705001 = _1684483705001UpdateSecurityUserViewsV1.updateSecurityUserViewsV11684483705001;
 exports.addQuickSearchFulltextIndexes1746434400000 = _1746434400000AddQuickSearchFulltextIndexes.addQuickSearchFulltextIndexes1746434400000;
+exports.updateSecurityUserViewsV11684483705001 = _1684483705001UpdateSecurityUserViewsV1.updateSecurityUserViewsV11684483705001;
 exports.updateSecurityUserViewsV21684483705002 = _1684483705002UpdateSecurityUserViewsV2.updateSecurityUserViewsV21684483705002;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spytecgps/nova-orm",
-  "version": "1.4.243",
+  "version": "1.4.244",
   "description": "ORM with PlanetScale",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/schema.sql

@@ -1,6 +1,6 @@
--- nova-orm-schema-checksum: 2cf05ba22d935b6ff23e793dd72eb97d
+-- nova-orm-schema-checksum: e9c87b87d49ceaf19de90f926e849568
 -- Nova ORM Schema Dump
--- Generated at: 2026-05-25T05:05:23.896Z
+-- Generated at: 2026-05-25T14:56:50.616Z
 
 SET FOREIGN_KEY_CHECKS = 0;
 
@@ -2229,17 +2229,34 @@ CREATE TABLE `job` (
   `imei` varchar(15) NOT NULL,
   `name` varchar(255) NOT NULL,
   `status` varchar(20) NOT NULL,
+  `lifecycle` varchar(20) NOT NULL DEFAULT 'Upcoming',
+  `healthChips` json DEFAULT NULL,
+  `proofState` varchar(20) NOT NULL DEFAULT 'NotArrived',
+  `outcome` varchar(10) DEFAULT NULL,
   `startLat` double DEFAULT NULL,
   `startLng` double DEFAULT NULL,
   `startLabel` varchar(500) DEFAULT NULL,
   `startDetail` varchar(500) DEFAULT NULL,
+  `startRadiusM` int NOT NULL DEFAULT '150',
   `endLat` double DEFAULT NULL,
   `endLng` double DEFAULT NULL,
   `endLabel` varchar(500) DEFAULT NULL,
   `endDetail` varchar(500) DEFAULT NULL,
+  `endRadiusM` int NOT NULL DEFAULT '150',
   `scheduledStart` datetime DEFAULT NULL,
   `targetArrival` datetime DEFAULT NULL,
+  `startedAt` datetime DEFAULT NULL,
+  `firstObservedAt` datetime DEFAULT NULL,
   `arrivedAt` datetime DEFAULT NULL,
+  `completedAt` datetime DEFAULT NULL,
+  `cancelledAt` datetime DEFAULT NULL,
+  `pingsInEndZone` int NOT NULL DEFAULT '0',
+  `lastPositionAt` datetime DEFAULT NULL,
+  `lastEvaluatedAt` datetime DEFAULT NULL,
+  `etaArrivalAt` datetime DEFAULT NULL,
+  `etaUpdatedAt` datetime DEFAULT NULL,
+  `etaDriveSeconds` int DEFAULT NULL,
+  `etaDistanceMeters` int DEFAULT NULL,
   `rules` json DEFAULT NULL,
   `timeline` json DEFAULT NULL,
   `liveLinkToken` binary(16) DEFAULT NULL,
@@ -2252,6 +2269,8 @@ CREATE TABLE `job` (
   PRIMARY KEY (`id`),
   UNIQUE KEY `uxJobLiveLinkToken` (`liveLinkToken`),
   KEY `ixJobClientIdCreatedBy` (`clientId`,`createdBy`),
+  KEY `ixJobImeiLifecycle` (`imei`,`lifecycle`),
+  KEY `ixJobClientIdLifecycle` (`clientId`,`lifecycle`),
   KEY `ixJobClientIdStatus` (`clientId`,`status`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;