@happyvertical/smrt-analytics 0.32.0 → 0.32.2

package/dist/collections/AnalyticsEventCollection.d.ts

@@ -3,6 +3,66 @@ import { AnalyticsEvent } from '../models/AnalyticsEvent.js';
 import { PropertyStatsWithTrend, TrackingEventStatus } from '../types/index.js';
 export declare class AnalyticsEventCollection extends SmrtCollection<AnalyticsEvent> {
     static readonly _itemClass: typeof AnalyticsEvent;
+    /**
+     * Offset of `timeZone` at `instant`, in milliseconds (wall-clock minus UTC).
+     *
+     * Reads the zone's wall-clock Y/M/D h:m:s for `instant` via
+     * `Intl.DateTimeFormat` parts and subtracts the real UTC instant. Positive
+     * east of UTC, negative west (e.g. `America/Los_Angeles` returns roughly
+     * `-7h`/`-8h` depending on DST).
+     *
+     * @throws RangeError if `timeZone` is not a valid IANA identifier.
+     */
+    private zoneOffsetMs;
+    /**
+     * Resolve the UTC instant marking the start of the calendar day (00:00) that
+     * `instant` falls on **within the given IANA time zone**.
+     *
+     * Day-over-day buckets ("today vs yesterday") must respect the property's
+     * configured `timeZone` (defaults to `America/Los_Angeles`), otherwise a
+     * pageview at 11:30pm local time — already the next UTC day — is bucketed
+     * into the wrong day. We read the wall-clock civil date for the zone, then
+     * map that date's local midnight back to a UTC instant, correcting for the
+     * zone offset (and re-correcting once across a DST boundary).
+     *
+     * Invalid/unknown zone identifiers fall back to UTC day boundaries (matching
+     * the previous behaviour) rather than throwing.
+     *
+     * @param instant - Reference instant.
+     * @param timeZone - IANA time zone (e.g. `America/Los_Angeles`).
+     * @returns UTC `Date` for local midnight of the day `instant` is in.
+     */
+    protected startOfDayInZone(instant: Date, timeZone: string): Date;
+    /**
+     * Resolve the UTC instant for the start of the day *before* `todayStart`'s
+     * local day, in `timeZone`.
+     *
+     * Steps back 12h from local midnight (landing safely inside the previous
+     * civil day regardless of DST — a naive `- 24h` skips a day across
+     * spring-forward), then re-resolves start-of-day.
+     *
+     * @param todayStart - Local-midnight UTC instant from {@link startOfDayInZone}.
+     * @param timeZone - IANA time zone.
+     * @returns UTC `Date` for local midnight of the prior calendar day.
+     */
+    protected startOfYesterdayInZone(todayStart: Date, timeZone: string): Date;
+    /**
+     * Classify a day-over-day change into a trend direction + percent.
+     *
+     * - `yesterday > 0`: percent = rounded delta; >5% up, <-5% down, else flat.
+     * - `yesterday === 0 && today > 0`: a brand-new surge from a zero baseline —
+     *   classified `up` with a `null` percent (no finite percentage exists), so
+     *   the UI renders "new" rather than a misleading flat 0%.
+     * - `yesterday === 0 && today === 0`: flat, 0%.
+     *
+     * @param today - Today's count.
+     * @param yesterday - Yesterday's count.
+     * @returns Trend direction and percent (null when growing from zero).
+     */
+    protected classifyTrend(today: number, yesterday: number): {
+        trend: 'up' | 'down' | 'flat';
+        trendPercent: number | null;
+    };
     /**
      * Find events by property
      *
@@ -112,20 +172,33 @@ export declare class AnalyticsEventCollection extends SmrtCollection<AnalyticsEv
      *
      * Compares today's pageview count against yesterday's to produce a
      * trend direction and percentage change. A threshold of 5% is used
-     * to classify 'up' vs 'down' vs 'flat'.
+     * to classify 'up' vs 'down' vs 'flat'; growth from a zero baseline is
+     * classified `up` with a `null` percent (see {@link classifyTrend}).
+     *
+     * Day boundaries are computed in `timeZone` (an IANA identifier such as the
+     * property's `AnalyticsProperty.timeZone`, which defaults to
+     * `America/Los_Angeles`) so an event near local midnight buckets into the
+     * correct calendar day. Defaults to `'UTC'` when omitted.
      *
      * @param propertyId - Property ID
      * @param now - Optional current date (for testing)
+     * @param timeZone - IANA time zone for day boundaries (default `'UTC'`)
      * @returns Stats with trend
      */
-    getPropertyStatsWithTrend(propertyId: string, now?: Date): Promise<PropertyStatsWithTrend>;
+    getPropertyStatsWithTrend(propertyId: string, now?: Date, timeZone?: string): Promise<PropertyStatsWithTrend>;
     /**
      * Get day-over-day stats for multiple properties in batch.
      *
+     * Day boundaries are computed in `timeZone` (default `'UTC'`); see
+     * {@link getPropertyStatsWithTrend}. A single zone applies to the whole
+     * batch, so callers mixing properties with different `timeZone` values
+     * should batch per zone (or fall back to per-property calls).
+     *
      * @param propertyIds - Array of property IDs
      * @param now - Optional current date (for testing)
+     * @param timeZone - IANA time zone for day boundaries (default `'UTC'`)
      * @returns Map of propertyId to stats
      */
-    getBatchPropertyStats(propertyIds: string[], now?: Date): Promise<Map<string, PropertyStatsWithTrend>>;
+    getBatchPropertyStats(propertyIds: string[], now?: Date, timeZone?: string): Promise<Map<string, PropertyStatsWithTrend>>;
 }
 //# sourceMappingURL=AnalyticsEventCollection.d.ts.map

package/dist/collections/AnalyticsEventCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsEventCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AnalyticsEventCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,KAAK,sBAAsB,EAC3B,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,wBAAyB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC1E,MAAM,CAAC,QAAQ,CAAC,UAAU,wBAAkB;IAE5C;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOnE;;;;;OAKG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOnE;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOjE;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAO7D;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAO1E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI7C;;;;;OAKG;IACG,YAAY,CAAC,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKrE;;;;;OAKG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAU1E;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B;;;;;OAKG;IACG,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAcrE;;;;;OAKG;IACG,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWnE;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYxE;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAClD,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAeF;;;;;;;;;;OAUG;IACG,yBAAyB,CAC7B,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,sBAAsB,CAAC;IA2DlC;;;;;;OAMG;IACG,qBAAqB,CACzB,WAAW,EAAE,MAAM,EAAE,EACrB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAqEhD"}
+{"version":3,"file":"AnalyticsEventCollection.d.ts","sourceRoot":"","sources":["../../src/collections/AnalyticsEventCollection.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -556,6 +556,134 @@ AnalyticsEvent = __decorateClass$2([
 ], AnalyticsEvent);
 class AnalyticsEventCollection extends SmrtCollection {
   static _itemClass = AnalyticsEvent;
+  /**
+   * Offset of `timeZone` at `instant`, in milliseconds (wall-clock minus UTC).
+   *
+   * Reads the zone's wall-clock Y/M/D h:m:s for `instant` via
+   * `Intl.DateTimeFormat` parts and subtracts the real UTC instant. Positive
+   * east of UTC, negative west (e.g. `America/Los_Angeles` returns roughly
+   * `-7h`/`-8h` depending on DST).
+   *
+   * @throws RangeError if `timeZone` is not a valid IANA identifier.
+   */
+  zoneOffsetMs(instant, timeZone) {
+    const parts = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: false
+    }).formatToParts(instant);
+    const lookup = (type) => Number.parseInt(parts.find((p) => p.type === type)?.value ?? "0", 10);
+    let hour = lookup("hour");
+    if (hour === 24) hour = 0;
+    const asUtc = Date.UTC(
+      lookup("year"),
+      lookup("month") - 1,
+      lookup("day"),
+      hour,
+      lookup("minute"),
+      lookup("second")
+    );
+    return asUtc - instant.getTime();
+  }
+  /**
+   * Resolve the UTC instant marking the start of the calendar day (00:00) that
+   * `instant` falls on **within the given IANA time zone**.
+   *
+   * Day-over-day buckets ("today vs yesterday") must respect the property's
+   * configured `timeZone` (defaults to `America/Los_Angeles`), otherwise a
+   * pageview at 11:30pm local time — already the next UTC day — is bucketed
+   * into the wrong day. We read the wall-clock civil date for the zone, then
+   * map that date's local midnight back to a UTC instant, correcting for the
+   * zone offset (and re-correcting once across a DST boundary).
+   *
+   * Invalid/unknown zone identifiers fall back to UTC day boundaries (matching
+   * the previous behaviour) rather than throwing.
+   *
+   * @param instant - Reference instant.
+   * @param timeZone - IANA time zone (e.g. `America/Los_Angeles`).
+   * @returns UTC `Date` for local midnight of the day `instant` is in.
+   */
+  startOfDayInZone(instant, timeZone) {
+    let civil;
+    try {
+      const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit"
+      }).formatToParts(instant);
+      const lookup = (type) => Number.parseInt(parts.find((p) => p.type === type)?.value ?? "0", 10);
+      civil = {
+        year: lookup("year"),
+        month: lookup("month"),
+        day: lookup("day")
+      };
+    } catch {
+      return new Date(
+        Date.UTC(
+          instant.getUTCFullYear(),
+          instant.getUTCMonth(),
+          instant.getUTCDate()
+        )
+      );
+    }
+    const guess = Date.UTC(civil.year, civil.month - 1, civil.day);
+    const offset = this.zoneOffsetMs(new Date(guess), timeZone);
+    let utc = guess - offset;
+    const offset2 = this.zoneOffsetMs(new Date(utc), timeZone);
+    if (offset2 !== offset) utc = guess - offset2;
+    return new Date(utc);
+  }
+  /**
+   * Resolve the UTC instant for the start of the day *before* `todayStart`'s
+   * local day, in `timeZone`.
+   *
+   * Steps back 12h from local midnight (landing safely inside the previous
+   * civil day regardless of DST — a naive `- 24h` skips a day across
+   * spring-forward), then re-resolves start-of-day.
+   *
+   * @param todayStart - Local-midnight UTC instant from {@link startOfDayInZone}.
+   * @param timeZone - IANA time zone.
+   * @returns UTC `Date` for local midnight of the prior calendar day.
+   */
+  startOfYesterdayInZone(todayStart, timeZone) {
+    return this.startOfDayInZone(
+      new Date(todayStart.getTime() - 12 * 36e5),
+      timeZone
+    );
+  }
+  /**
+   * Classify a day-over-day change into a trend direction + percent.
+   *
+   * - `yesterday > 0`: percent = rounded delta; >5% up, <-5% down, else flat.
+   * - `yesterday === 0 && today > 0`: a brand-new surge from a zero baseline —
+   *   classified `up` with a `null` percent (no finite percentage exists), so
+   *   the UI renders "new" rather than a misleading flat 0%.
+   * - `yesterday === 0 && today === 0`: flat, 0%.
+   *
+   * @param today - Today's count.
+   * @param yesterday - Yesterday's count.
+   * @returns Trend direction and percent (null when growing from zero).
+   */
+  classifyTrend(today, yesterday) {
+    if (yesterday > 0) {
+      const change = (today - yesterday) / yesterday * 100;
+      const trendPercent = Math.round(change);
+      let trend = "flat";
+      if (change > 5) trend = "up";
+      else if (change < -5) trend = "down";
+      return { trend, trendPercent };
+    }
+    if (today > 0) {
+      return { trend: "up", trendPercent: null };
+    }
+    return { trend: "flat", trendPercent: 0 };
+  }
   /**
    * Find events by property
    *
@@ -745,22 +873,23 @@ class AnalyticsEventCollection extends SmrtCollection {
    *
    * Compares today's pageview count against yesterday's to produce a
    * trend direction and percentage change. A threshold of 5% is used
-   * to classify 'up' vs 'down' vs 'flat'.
+   * to classify 'up' vs 'down' vs 'flat'; growth from a zero baseline is
+   * classified `up` with a `null` percent (see {@link classifyTrend}).
+   *
+   * Day boundaries are computed in `timeZone` (an IANA identifier such as the
+   * property's `AnalyticsProperty.timeZone`, which defaults to
+   * `America/Los_Angeles`) so an event near local midnight buckets into the
+   * correct calendar day. Defaults to `'UTC'` when omitted.
    *
    * @param propertyId - Property ID
    * @param now - Optional current date (for testing)
+   * @param timeZone - IANA time zone for day boundaries (default `'UTC'`)
    * @returns Stats with trend
    */
-  async getPropertyStatsWithTrend(propertyId, now) {
+  async getPropertyStatsWithTrend(propertyId, now, timeZone = "UTC") {
     const currentTime = now || /* @__PURE__ */ new Date();
-    const todayStart = new Date(
-      Date.UTC(
-        currentTime.getUTCFullYear(),
-        currentTime.getUTCMonth(),
-        currentTime.getUTCDate()
-      )
-    );
-    const yesterdayStart = new Date(todayStart.getTime() - 864e5);
+    const todayStart = this.startOfDayInZone(currentTime, timeZone);
+    const yesterdayStart = this.startOfYesterdayInZone(todayStart, timeZone);
     const allPageviewEvents = await this.list({
       where: {
         propertyId,
@@ -781,14 +910,10 @@ class AnalyticsEventCollection extends SmrtCollection {
     );
     const todayPageviews = todayPageviewEvents.length;
     const yesterdayPageviews = yesterdayPageviewEvents.length;
-    let trend = "flat";
-    let trendPercent = 0;
-    if (yesterdayPageviews > 0) {
-      const change = (todayPageviews - yesterdayPageviews) / yesterdayPageviews * 100;
-      trendPercent = Math.round(change);
-      if (change > 5) trend = "up";
-      else if (change < -5) trend = "down";
-    }
+    const { trend, trendPercent } = this.classifyTrend(
+      todayPageviews,
+      yesterdayPageviews
+    );
     return {
       todayPageviews,
       todayUsers: todayClients.size,
@@ -801,21 +926,21 @@ class AnalyticsEventCollection extends SmrtCollection {
   /**
    * Get day-over-day stats for multiple properties in batch.
    *
+   * Day boundaries are computed in `timeZone` (default `'UTC'`); see
+   * {@link getPropertyStatsWithTrend}. A single zone applies to the whole
+   * batch, so callers mixing properties with different `timeZone` values
+   * should batch per zone (or fall back to per-property calls).
+   *
    * @param propertyIds - Array of property IDs
    * @param now - Optional current date (for testing)
+   * @param timeZone - IANA time zone for day boundaries (default `'UTC'`)
    * @returns Map of propertyId to stats
    */
-  async getBatchPropertyStats(propertyIds, now) {
+  async getBatchPropertyStats(propertyIds, now, timeZone = "UTC") {
     const results = /* @__PURE__ */ new Map();
     const currentTime = now || /* @__PURE__ */ new Date();
-    const todayStart = new Date(
-      Date.UTC(
-        currentTime.getUTCFullYear(),
-        currentTime.getUTCMonth(),
-        currentTime.getUTCDate()
-      )
-    );
-    const yesterdayStart = new Date(todayStart.getTime() - 864e5);
+    const todayStart = this.startOfDayInZone(currentTime, timeZone);
+    const yesterdayStart = this.startOfYesterdayInZone(todayStart, timeZone);
     const allEvents = await this.list({
       where: {
         eventName: "page_view",
@@ -841,14 +966,10 @@ class AnalyticsEventCollection extends SmrtCollection {
       );
       const todayPageviews = todayPageviewEvents.length;
       const yesterdayPageviews = yesterdayPageviewEvents.length;
-      let trend = "flat";
-      let trendPercent = 0;
-      if (yesterdayPageviews > 0) {
-        const change = (todayPageviews - yesterdayPageviews) / yesterdayPageviews * 100;
-        trendPercent = Math.round(change);
-        if (change > 5) trend = "up";
-        else if (change < -5) trend = "down";
-      }
+      const { trend, trendPercent } = this.classifyTrend(
+        todayPageviews,
+        yesterdayPageviews
+      );
       results.set(propertyId, {
         todayPageviews,
         todayUsers: todayClients.size,