@camstack/ui-library 1.2.200 → 1.2.201

package/dist/index.cjs

@@ -45811,9 +45811,11 @@ function resolveControlAlign(type, placement) {
 * Relative "last seen" formatter for the offline affordance.
 *
 * Renders a short relative-time label from a millisecond epoch:
-* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for
-* missing/non-positive inputs so callers can render nothing rather
-* than a misleading "—" or "NaN ago".
+* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for missing
+* inputs, or inputs below {@link MIN_PLAUSIBLE_TIMESTAMP_MS} (a
+* placeholder or a seeded "known value, unknown change time" stamp), so
+* callers can render nothing rather than a misleading "—", "NaN ago", or
+* (for a seeded `1`) "20000 days ago".
 *
 * Future timestamps (clock skew between the device and the browser)
 * collapse to "just now" instead of a negative duration.
@@ -45823,8 +45825,15 @@ var MINUTE_MS = 60 * SECOND_MS;
 var HOUR_MS = 60 * MINUTE_MS;
 var DAY_MS = 24 * HOUR_MS;
 var JUST_NOW_MS = 30 * SECOND_MS;
+/**
+* The earliest timestamp a real "last seen" could plausibly carry. Below
+* this, a value is a placeholder or a seeded "known value, unknown change
+* time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
+* instant. Year 2000 predates every device this renders.
+*/
+var MIN_PLAUSIBLE_TIMESTAMP_MS = Date.UTC(2e3, 0, 1);
 function formatLastSeen(timestampMs) {
-	if (timestampMs === null || timestampMs === void 0 || timestampMs <= 0) return null;
+	if (timestampMs === null || timestampMs === void 0 || timestampMs < MIN_PLAUSIBLE_TIMESTAMP_MS) return null;
 	const delta = Date.now() - timestampMs;
 	if (delta < JUST_NOW_MS) return "just now";
 	if (delta < HOUR_MS) return `${String(Math.floor(delta / MINUTE_MS))}m ago`;

package/dist/index.js

@@ -45787,9 +45787,11 @@ function resolveControlAlign(type, placement) {
 * Relative "last seen" formatter for the offline affordance.
 *
 * Renders a short relative-time label from a millisecond epoch:
-* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for
-* missing/non-positive inputs so callers can render nothing rather
-* than a misleading "—" or "NaN ago".
+* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for missing
+* inputs, or inputs below {@link MIN_PLAUSIBLE_TIMESTAMP_MS} (a
+* placeholder or a seeded "known value, unknown change time" stamp), so
+* callers can render nothing rather than a misleading "—", "NaN ago", or
+* (for a seeded `1`) "20000 days ago".
 *
 * Future timestamps (clock skew between the device and the browser)
 * collapse to "just now" instead of a negative duration.
@@ -45799,8 +45801,15 @@ var MINUTE_MS = 60 * SECOND_MS;
 var HOUR_MS = 60 * MINUTE_MS;
 var DAY_MS = 24 * HOUR_MS;
 var JUST_NOW_MS = 30 * SECOND_MS;
+/**
+* The earliest timestamp a real "last seen" could plausibly carry. Below
+* this, a value is a placeholder or a seeded "known value, unknown change
+* time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
+* instant. Year 2000 predates every device this renders.
+*/
+var MIN_PLAUSIBLE_TIMESTAMP_MS = Date.UTC(2e3, 0, 1);
 function formatLastSeen(timestampMs) {
-	if (timestampMs === null || timestampMs === void 0 || timestampMs <= 0) return null;
+	if (timestampMs === null || timestampMs === void 0 || timestampMs < MIN_PLAUSIBLE_TIMESTAMP_MS) return null;
 	const delta = Date.now() - timestampMs;
 	if (delta < JUST_NOW_MS) return "just now";
 	if (delta < HOUR_MS) return `${String(Math.floor(delta / MINUTE_MS))}m ago`;

package/dist/lib/format-last-seen.d.ts

@@ -2,11 +2,20 @@
  * Relative "last seen" formatter for the offline affordance.
  *
  * Renders a short relative-time label from a millisecond epoch:
- * "just now", "5m ago", "3h ago", "2d ago". Returns `null` for
- * missing/non-positive inputs so callers can render nothing rather
- * than a misleading "—" or "NaN ago".
+ * "just now", "5m ago", "3h ago", "2d ago". Returns `null` for missing
+ * inputs, or inputs below {@link MIN_PLAUSIBLE_TIMESTAMP_MS} (a
+ * placeholder or a seeded "known value, unknown change time" stamp), so
+ * callers can render nothing rather than a misleading "—", "NaN ago", or
+ * (for a seeded `1`) "20000 days ago".
  *
  * Future timestamps (clock skew between the device and the browser)
  * collapse to "just now" instead of a negative duration.
  */
+/**
+ * The earliest timestamp a real "last seen" could plausibly carry. Below
+ * this, a value is a placeholder or a seeded "known value, unknown change
+ * time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
+ * instant. Year 2000 predates every device this renders.
+ */
+export declare const MIN_PLAUSIBLE_TIMESTAMP_MS: number;
 export declare function formatLastSeen(timestampMs: number | null | undefined): string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.200",
+  "version": "1.2.201",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",