@trillboards/edge-core 0.4.0 → 0.4.1

package/dist/centroidTracker.d.ts

@@ -0,0 +1,107 @@
+/**
+ * centroidTracker — ONE nearest-centroid tracker, for everything that needs one.
+ *
+ * ── WHY THIS FILE EXISTS ───────────────────────────────────────────────────
+ *
+ * Three independent implementations of "give this box the same id it had last
+ * frame" were in the tree, and they did not agree:
+ *
+ *   edge-sensing  FaceDetector.assignTrackingIds   best-match, size-relative
+ *                                                  threshold, staleness pruning
+ *   platform-web  WebFaceDetector.assignFaceId     FIRST match, fixed threshold,
+ *                                                  eviction by insertion order
+ *   agent-core    VehicleFlowProcessor.updateTracks (Kotlin — re-implements
+ *                                                  association scoring rather
+ *                                                  than calling the
+ *                                                  TrackAssociation.bestMatch
+ *                                                  sitting next to it)
+ *
+ * This is the TypeScript half consolidated onto the first one's algorithm, which
+ * is the only one of the three that is correct. The Kotlin pair is a different
+ * artifact with its own release cycle and is not touched here; the note above is
+ * so the next person does not make it a fourth.
+ *
+ * ── THE TWO DEFECTS THE WEB VERSION HAD ────────────────────────────────────
+ *
+ * 1. FIRST match, not BEST. It returned the first track inside the threshold
+ *    rather than the closest, so with two people standing near each other the id
+ *    that got assigned depended on Map insertion order. Two frames apart, the
+ *    same two people could swap ids — and a swapped id is worse than a new one,
+ *    because a new id is visibly a new person while a swap silently attributes
+ *    one person's dwell to another.
+ *
+ * 2. Eviction by insertion order, not staleness. It dropped the OLDEST-INSERTED
+ *    entry once the map passed 50 — which is the person who has been standing
+ *    there longest, i.e. exactly the one a dwell metric cares about — while a
+ *    track last seen an hour ago and re-inserted recently survived.
+ *
+ * Both are fixed by using this. The threshold also becomes size-relative
+ * (`max(w,h) * ratio`), which is what makes one constant work for a face filling
+ * the frame and a face across the room: a fixed pixel threshold is either too
+ * tight up close or too loose far away, and there is no value that is neither.
+ *
+ * ── WHAT THIS IS NOT ───────────────────────────────────────────────────────
+ *
+ * Not a motion model — no velocity, no prediction, no Kalman. It matches on
+ * position alone, so it holds an id across small movements between frames and
+ * loses it across an occlusion. That is sufficient for what consumes it today
+ * (per-frame face ids and dwell) and it is deliberately not more: a constant-
+ * velocity model and 512-d re-ID both already exist in `TrackAssociation.kt` and
+ * `TrackReId.kt`, and if this side ever needs them they should be ported, not
+ * reinvented here for a third time.
+ */
+export interface TrackedBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface TrackRecord {
+    id: number;
+    box: TrackedBox;
+    firstSeen: number;
+    lastSeen: number;
+}
+export interface CentroidTrackerOptions {
+    /**
+     * Match radius as a fraction of the detection's longest side.
+     *
+     * Size-relative on purpose — see the note above on why no fixed pixel value
+     * works at two distances.
+     */
+    matchRatio?: number;
+    /** Drop a track not seen for this long. */
+    staleMs?: number;
+    /**
+     * Hard cap on retained tracks, evicted STALEST-FIRST.
+     *
+     * A safety valve for a pathological scene, not a working limit. Eviction order
+     * is the whole point: dropping the oldest-inserted entry removes the person
+     * who has been present longest, which is the one every dwell metric is about.
+     */
+    maxTracks?: number;
+}
+export declare const DEFAULT_MATCH_RATIO = 0.5;
+export declare const DEFAULT_STALE_MS = 2000;
+export declare const DEFAULT_MAX_TRACKS = 256;
+export declare class CentroidTracker {
+    private readonly tracks;
+    private readonly matchRatio;
+    private readonly staleMs;
+    private readonly maxTracks;
+    private nextId;
+    constructor(options?: CentroidTrackerOptions);
+    /**
+     * Assign ids to one frame's detections, in order.
+     *
+     * Returns one record per input box, same length and same order, so a caller
+     * can zip it against its own richer per-detection data.
+     */
+    track(detections: TrackedBox[], now: number): TrackRecord[];
+    /** Live tracks, for callers that need to inspect state. */
+    active(): TrackRecord[];
+    reset(): void;
+    private pruneStale;
+    private enforceCap;
+}
+//# sourceMappingURL=centroidTracker.d.ts.map

package/dist/centroidTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"centroidTracker.d.ts","sourceRoot":"","sources":["../src/centroidTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAMtC,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,GAAE,sBAA2B;IAMhD;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE;IAkE3D,2DAA2D;IAC3D,MAAM,IAAI,WAAW,EAAE;IAIvB,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,UAAU;CAcnB"}

package/dist/centroidTracker.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * centroidTracker — ONE nearest-centroid tracker, for everything that needs one.
+ *
+ * ── WHY THIS FILE EXISTS ───────────────────────────────────────────────────
+ *
+ * Three independent implementations of "give this box the same id it had last
+ * frame" were in the tree, and they did not agree:
+ *
+ *   edge-sensing  FaceDetector.assignTrackingIds   best-match, size-relative
+ *                                                  threshold, staleness pruning
+ *   platform-web  WebFaceDetector.assignFaceId     FIRST match, fixed threshold,
+ *                                                  eviction by insertion order
+ *   agent-core    VehicleFlowProcessor.updateTracks (Kotlin — re-implements
+ *                                                  association scoring rather
+ *                                                  than calling the
+ *                                                  TrackAssociation.bestMatch
+ *                                                  sitting next to it)
+ *
+ * This is the TypeScript half consolidated onto the first one's algorithm, which
+ * is the only one of the three that is correct. The Kotlin pair is a different
+ * artifact with its own release cycle and is not touched here; the note above is
+ * so the next person does not make it a fourth.
+ *
+ * ── THE TWO DEFECTS THE WEB VERSION HAD ────────────────────────────────────
+ *
+ * 1. FIRST match, not BEST. It returned the first track inside the threshold
+ *    rather than the closest, so with two people standing near each other the id
+ *    that got assigned depended on Map insertion order. Two frames apart, the
+ *    same two people could swap ids — and a swapped id is worse than a new one,
+ *    because a new id is visibly a new person while a swap silently attributes
+ *    one person's dwell to another.
+ *
+ * 2. Eviction by insertion order, not staleness. It dropped the OLDEST-INSERTED
+ *    entry once the map passed 50 — which is the person who has been standing
+ *    there longest, i.e. exactly the one a dwell metric cares about — while a
+ *    track last seen an hour ago and re-inserted recently survived.
+ *
+ * Both are fixed by using this. The threshold also becomes size-relative
+ * (`max(w,h) * ratio`), which is what makes one constant work for a face filling
+ * the frame and a face across the room: a fixed pixel threshold is either too
+ * tight up close or too loose far away, and there is no value that is neither.
+ *
+ * ── WHAT THIS IS NOT ───────────────────────────────────────────────────────
+ *
+ * Not a motion model — no velocity, no prediction, no Kalman. It matches on
+ * position alone, so it holds an id across small movements between frames and
+ * loses it across an occlusion. That is sufficient for what consumes it today
+ * (per-frame face ids and dwell) and it is deliberately not more: a constant-
+ * velocity model and 512-d re-ID both already exist in `TrackAssociation.kt` and
+ * `TrackReId.kt`, and if this side ever needs them they should be ported, not
+ * reinvented here for a third time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CentroidTracker = exports.DEFAULT_MAX_TRACKS = exports.DEFAULT_STALE_MS = exports.DEFAULT_MATCH_RATIO = void 0;
+exports.DEFAULT_MATCH_RATIO = 0.5;
+exports.DEFAULT_STALE_MS = 2000;
+exports.DEFAULT_MAX_TRACKS = 256;
+function centre(b) {
+    return { cx: b.x + b.width / 2, cy: b.y + b.height / 2 };
+}
+class CentroidTracker {
+    constructor(options = {}) {
+        this.tracks = new Map();
+        this.nextId = 1;
+        this.matchRatio = options.matchRatio ?? exports.DEFAULT_MATCH_RATIO;
+        this.staleMs = options.staleMs ?? exports.DEFAULT_STALE_MS;
+        this.maxTracks = options.maxTracks ?? exports.DEFAULT_MAX_TRACKS;
+    }
+    /**
+     * Assign ids to one frame's detections, in order.
+     *
+     * Returns one record per input box, same length and same order, so a caller
+     * can zip it against its own richer per-detection data.
+     */
+    track(detections, now) {
+        this.pruneStale(now);
+        // FRAME-LEVEL assignment, not per-detection greedy.
+        //
+        // Taking each detection in turn and giving it its own closest free track is
+        // ORDER-DEPENDENT, and the order it depends on is the detector's output
+        // order — which nothing controls. Measured on the two-person case: tracks at
+        // x=100 and x=140, next frame's boxes at x=125 and x=145.
+        //
+        //   per-detection greedy, boxes in order      125 -> right(15), 145 -> left(45)
+        //   per-detection greedy, boxes reversed      145 -> right(5),  125 -> left(25)
+        //   minimum total distance                    125 -> left(25),  145 -> right(5)
+        //
+        // So the forward order produces exactly the SWAP this class exists to
+        // prevent, and merely reversing the input fixes it. Scoring every candidate
+        // pair and consuming them shortest-first is order-independent and lands on
+        // the minimum-distance assignment here.
+        //
+        // It is a heuristic, not the optimum: shortest-first can be beaten by
+        // Hungarian on contrived layouts. That trade is deliberate — a subtly wrong
+        // O(n^3) implementation is worse than a correct heuristic, the seam is this
+        // one function if it ever needs to change, and what actually mattered was
+        // removing the dependence on input order.
+        const candidates = [];
+        detections.forEach((det, detIndex) => {
+            const { cx, cy } = centre(det);
+            const threshold = Math.max(det.width, det.height) * this.matchRatio;
+            for (const [trackId, track] of this.tracks) {
+                const c = centre(track.box);
+                const dist = Math.hypot(cx - c.cx, cy - c.cy);
+                if (dist < threshold)
+                    candidates.push({ detIndex, trackId, dist });
+            }
+        });
+        // Ties broken on trackId then detIndex so equal distances resolve the same
+        // way every run — Map iteration order must not decide an id.
+        candidates.sort((a, b) => a.dist - b.dist || a.trackId - b.trackId || a.detIndex - b.detIndex);
+        const assignment = new Map();
+        const claimed = new Set();
+        for (const c of candidates) {
+            if (claimed.has(c.trackId) || assignment.has(c.detIndex))
+                continue;
+            assignment.set(c.detIndex, c.trackId);
+            claimed.add(c.trackId);
+        }
+        const out = [];
+        detections.forEach((det, detIndex) => {
+            const matchedId = assignment.get(detIndex);
+            const id = matchedId ?? this.nextId++;
+            const firstSeen = matchedId !== undefined ? this.tracks.get(matchedId).firstSeen : now;
+            const record = {
+                id,
+                box: { x: det.x, y: det.y, width: det.width, height: det.height },
+                firstSeen,
+                lastSeen: now,
+            };
+            this.tracks.set(id, record);
+            out.push(record);
+        });
+        this.enforceCap(claimed);
+        return out;
+    }
+    /** Live tracks, for callers that need to inspect state. */
+    active() {
+        return [...this.tracks.values()];
+    }
+    reset() {
+        this.tracks.clear();
+        this.nextId = 1;
+    }
+    pruneStale(now) {
+        for (const [id, track] of this.tracks) {
+            if (now - track.lastSeen > this.staleMs)
+                this.tracks.delete(id);
+        }
+    }
+    enforceCap(claimedThisFrame) {
+        if (this.tracks.size <= this.maxTracks)
+            return;
+        // Stalest first, and never a track seen in THIS frame — evicting one of
+        // those would hand a present person a brand-new id on the next frame.
+        const evictable = [...this.tracks.values()]
+            .filter((t) => !claimedThisFrame.has(t.id))
+            .sort((a, b) => a.lastSeen - b.lastSeen);
+        let over = this.tracks.size - this.maxTracks;
+        for (const track of evictable) {
+            if (over <= 0)
+                break;
+            this.tracks.delete(track.id);
+            over -= 1;
+        }
+    }
+}
+exports.CentroidTracker = CentroidTracker;
+//# sourceMappingURL=centroidTracker.js.map

package/dist/centroidTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"centroidTracker.js","sourceRoot":"","sources":["../src/centroidTracker.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -24,4 +24,6 @@ export { ModelManager } from './ModelManager';
 export type { ModelManagerOptions, ModelInfo, ModelVersionResponse } from './ModelManager';
 export { ZKAudienceProver } from './ZKAudienceProver';
 export type { AudienceObservation, AudienceAggregate, AudienceProof, VerificationResult, } from './ZKAudienceProver';
+export { CentroidTracker, DEFAULT_MATCH_RATIO, DEFAULT_STALE_MS, DEFAULT_MAX_TRACKS, } from './centroidTracker';
+export type { TrackedBox, TrackRecord, CentroidTrackerOptions } from './centroidTracker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,+BAA+B,EAC/B,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,+BAA+B,EAC/B,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -15,7 +15,7 @@ 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 });
-exports.ZKAudienceProver = exports.ModelManager = exports.MemoryTier = exports.MemoryAttenuationManager = exports.getAttenuationTier = exports.getShedOrder = exports.isModelActive = exports.getCapabilityMatrix = exports.computeTier = exports.classifyObservationSignal = exports.StatusServer = exports.TelemetryScheduler = exports.RecoveryLadder = exports.SubsystemHealthRegistry = exports.SqliteStore = exports.JsonFileStore = exports.SignalBuffer = exports.VASWeightConfig = exports.SocketManager = exports.SensingConfig = exports.DeviceIdentity = void 0;
+exports.DEFAULT_MAX_TRACKS = exports.DEFAULT_STALE_MS = exports.DEFAULT_MATCH_RATIO = exports.CentroidTracker = exports.ZKAudienceProver = exports.ModelManager = exports.MemoryTier = exports.MemoryAttenuationManager = exports.getAttenuationTier = exports.getShedOrder = exports.isModelActive = exports.getCapabilityMatrix = exports.computeTier = exports.classifyObservationSignal = exports.StatusServer = exports.TelemetryScheduler = exports.RecoveryLadder = exports.SubsystemHealthRegistry = exports.SqliteStore = exports.JsonFileStore = exports.SignalBuffer = exports.VASWeightConfig = exports.SocketManager = exports.SensingConfig = exports.DeviceIdentity = void 0;
 __exportStar(require("./types"), exports);
 var DeviceIdentity_1 = require("./DeviceIdentity");
 Object.defineProperty(exports, "DeviceIdentity", { enumerable: true, get: function () { return DeviceIdentity_1.DeviceIdentity; } });
@@ -55,4 +55,12 @@ var ModelManager_1 = require("./ModelManager");
 Object.defineProperty(exports, "ModelManager", { enumerable: true, get: function () { return ModelManager_1.ModelManager; } });
 var ZKAudienceProver_1 = require("./ZKAudienceProver");
 Object.defineProperty(exports, "ZKAudienceProver", { enumerable: true, get: function () { return ZKAudienceProver_1.ZKAudienceProver; } });
+// ONE nearest-centroid tracker. Three independent implementations existed and
+// disagreed; this is the TypeScript half consolidated onto the only correct one.
+// Read its header before writing a fourth.
+var centroidTracker_1 = require("./centroidTracker");
+Object.defineProperty(exports, "CentroidTracker", { enumerable: true, get: function () { return centroidTracker_1.CentroidTracker; } });
+Object.defineProperty(exports, "DEFAULT_MATCH_RATIO", { enumerable: true, get: function () { return centroidTracker_1.DEFAULT_MATCH_RATIO; } });
+Object.defineProperty(exports, "DEFAULT_STALE_MS", { enumerable: true, get: function () { return centroidTracker_1.DEFAULT_STALE_MS; } });
+Object.defineProperty(exports, "DEFAULT_MAX_TRACKS", { enumerable: true, get: function () { return centroidTracker_1.DEFAULT_MAX_TRACKS; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;AAEtF,0CAAwB;AACxB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,6EAGuC;AAFrC,wIAAA,yBAAyB,OAAA;AAG3B,iDAMyB;AALvB,4GAAA,WAAW,OAAA;AACX,oHAAA,mBAAmB,OAAA;AACnB,8GAAA,aAAa,OAAA;AACb,6GAAA,YAAY,OAAA;AACZ,mHAAA,kBAAkB,OAAA;AAEpB,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AAOjC,uEAAwD;AAA/C,sHAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;AAEtF,0CAAwB;AACxB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,6EAGuC;AAFrC,wIAAA,yBAAyB,OAAA;AAG3B,iDAMyB;AALvB,4GAAA,WAAW,OAAA;AACX,oHAAA,mBAAmB,OAAA;AACnB,8GAAA,aAAa,OAAA;AACb,6GAAA,YAAY,OAAA;AACZ,mHAAA,kBAAkB,OAAA;AAEpB,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AAOjC,uEAAwD;AAA/C,sHAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAQzB,8EAA8E;AAC9E,iFAAiF;AACjF,2CAA2C;AAC3C,qDAK2B;AAJzB,kHAAA,eAAe,OAAA;AACf,sHAAA,mBAAmB,OAAA;AACnB,mHAAA,gBAAgB,OAAA;AAChB,qHAAA,kBAAkB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trillboards/edge-core",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Core identity, heartbeat, Socket.io, config, and signal buffer for Trillboards Edge AI SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",