@seatlayer/core 0.87.0 → 0.88.1

package/dist/index.d.cts

@@ -1900,12 +1900,18 @@ interface PickerTransport {
      */
     asset?(key: string, asset: string): Promise<Blob>;
     /** `default` is the status of every seat NOT in `seats`; absent means `free`
-     *  (an older server names every seat). Never assume it. */
+     *  (an older server names every seat). Never assume it.
+     *  `fetchedAt` is the CLIENT-CLOCK ms at which the transport received this
+     *  answer. It is the snapshot's real age — a bootstrap bundle prewarmed on
+     *  hover is handed to the picker tens of seconds after it was read — and the
+     *  freshness rules below use it in place of the apply instant. Optional: a
+     *  transport that omits it falls back to "now", as every caller did before. */
     objects(key: string): Promise<{
         seats: Record<string, string>;
         default?: string;
         hidden?: string[];
         closed?: string[];
+        fetchedAt?: number;
     }>;
     /** Optional server-resolved ticket offers/prices. `live` bypasses shared cache
      * after a realtime seat frame so quota and fallback prices move together. */
@@ -2851,15 +2857,22 @@ declare class PickerController {
      * `free` would paint a sold-out stadium as fully available, so the default is
      * a parameter rather than a constant.
      */
-    /** @internal */ applySeatsMap(seats: Record<string, string>, defaultStatus?: string, source?: SnapshotSource): void;
+    /** @internal */ applySeatsMap(seats: Record<string, string>, defaultStatus?: string, source?: SnapshotSource, fetchedAt?: number): void;
     /**
-     * When an authoritative map was last painted, and whether one is recent.
+     * When the authoritative map in the renderer was READ, and whether that is
+     * recent.
      *
      * A socket opening is not news. The boot read and the connect read were
      * landing within half a second of each other on a real event page — two full
      * snapshots of the same venue, the second answering a question nobody asked.
      * Five seconds is comfortably longer than a boot takes and far shorter than
      * any window in which a silent server could leave the map wrong.
+     *
+     * It is the READ instant rather than the apply instant because those stopped
+     * being the same thing: a host may prewarm the bootstrap on hover, and the
+     * bundle that eventually paints can be tens of seconds old. Dating it from
+     * the apply made that map look brand new and skipped the connect re-read,
+     * leaving every seat that changed in between wrong until the next delta.
      */
     private lastSnapshotAt;
     /**

package/dist/index.d.ts

@@ -1900,12 +1900,18 @@ interface PickerTransport {
      */
     asset?(key: string, asset: string): Promise<Blob>;
     /** `default` is the status of every seat NOT in `seats`; absent means `free`
-     *  (an older server names every seat). Never assume it. */
+     *  (an older server names every seat). Never assume it.
+     *  `fetchedAt` is the CLIENT-CLOCK ms at which the transport received this
+     *  answer. It is the snapshot's real age — a bootstrap bundle prewarmed on
+     *  hover is handed to the picker tens of seconds after it was read — and the
+     *  freshness rules below use it in place of the apply instant. Optional: a
+     *  transport that omits it falls back to "now", as every caller did before. */
     objects(key: string): Promise<{
         seats: Record<string, string>;
         default?: string;
         hidden?: string[];
         closed?: string[];
+        fetchedAt?: number;
     }>;
     /** Optional server-resolved ticket offers/prices. `live` bypasses shared cache
      * after a realtime seat frame so quota and fallback prices move together. */
@@ -2851,15 +2857,22 @@ declare class PickerController {
      * `free` would paint a sold-out stadium as fully available, so the default is
      * a parameter rather than a constant.
      */
-    /** @internal */ applySeatsMap(seats: Record<string, string>, defaultStatus?: string, source?: SnapshotSource): void;
+    /** @internal */ applySeatsMap(seats: Record<string, string>, defaultStatus?: string, source?: SnapshotSource, fetchedAt?: number): void;
     /**
-     * When an authoritative map was last painted, and whether one is recent.
+     * When the authoritative map in the renderer was READ, and whether that is
+     * recent.
      *
      * A socket opening is not news. The boot read and the connect read were
      * landing within half a second of each other on a real event page — two full
      * snapshots of the same venue, the second answering a question nobody asked.
      * Five seconds is comfortably longer than a boot takes and far shorter than
      * any window in which a silent server could leave the map wrong.
+     *
+     * It is the READ instant rather than the apply instant because those stopped
+     * being the same thing: a host may prewarm the bootstrap on hover, and the
+     * bundle that eventually paints can be tens of seconds old. Dating it from
+     * the apply made that map look brand new and skipped the connect re-read,
+     * leaving every seat that changed in between wrong until the next delta.
      */
     private lastSnapshotAt;
     /**