@hawk.so/types 0.6.2 → 0.6.4

package/build/index.d.ts

@@ -10,6 +10,7 @@ export * from './src/base/event/taskManagerItem';
 export * from './src/base/event/addons';
 export * from './src/base/integrations/integrationToken';
 export * from './src/base/project/ProjectTaskManager';
+export * from './src/base/utm';
 export * from './src/base/workspace/GitHubIntegration';
 export * from './src/base/user/GitHubAuthorization';
 export * from './src/dbScheme/businessOperation';

package/build/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./src/base/event/taskManagerItem"), exports);
 __exportStar(require("./src/base/event/addons"), exports);
 __exportStar(require("./src/base/integrations/integrationToken"), exports);
 __exportStar(require("./src/base/project/ProjectTaskManager"), exports);
+__exportStar(require("./src/base/utm"), exports);
 __exportStar(require("./src/base/workspace/GitHubIntegration"), exports);
 __exportStar(require("./src/base/user/GitHubAuthorization"), exports);
 __exportStar(require("./src/dbScheme/businessOperation"), exports);

package/build/src/base/utm.d.ts

@@ -0,0 +1,25 @@
+/**
+ * UTM parameters captured for analytics.
+ */
+export interface Utm {
+    /**
+     * UTM source - identifies which site sent the traffic.
+     */
+    source?: string;
+    /**
+     * UTM medium - identifies what type of link was used.
+     */
+    medium?: string;
+    /**
+     * UTM campaign - identifies a specific product promotion or strategic campaign.
+     */
+    campaign?: string;
+    /**
+     * UTM content - identifies what specifically was clicked to bring the user to the site.
+     */
+    content?: string;
+    /**
+     * UTM term - identifies search terms.
+     */
+    term?: string;
+}

package/build/src/base/utm.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/catchers/catcher-message.d.ts

@@ -63,6 +63,11 @@ export interface CatcherMessage<Type extends CatcherMessageType> {
      * All information about the event
      */
     payload: CatcherMessagePayload<Type>;
+    /**
+     * Number of identical occurrences this message represents.
+     * Computed on Catcher side to dedupe similar events caused in the same time.
+     */
+    count?: number;
 }
 /**
  * Type that represents a Catcher message accepted by the collector

package/build/src/dbScheme/promoCodeUsage.d.ts

@@ -1,5 +1,6 @@
 import type { ObjectId } from 'bson';
 import type { PromoCodeBenefitType } from './promoCode.ts';
+import type { Utm } from '../base/utm.ts';
 /**
  * Promo code usage representation in DataBase
  */
@@ -43,28 +44,7 @@ export interface PromoCodeUsageDBScheme {
     /**
      * UTM parameters captured when promo code was applied. Used for analytics purposes
      */
-    utm?: {
-        /**
-         * UTM source - identifies which site sent the traffic
-         */
-        source?: string;
-        /**
-         * UTM medium - identifies what type of link was used
-         */
-        medium?: string;
-        /**
-         * UTM campaign - identifies a specific product promotion or strategic campaign
-         */
-        campaign?: string;
-        /**
-         * UTM content - identifies what specifically was clicked to bring the user to the site
-         */
-        content?: string;
-        /**
-         * UTM term - identifies search terms
-         */
-        term?: string;
-    };
+    utm?: Utm;
     /**
      * Date when promo code was successfully applied
      * @example 2026-06-10T12:30:00.000Z

package/build/src/dbScheme/repetition.d.ts

@@ -29,6 +29,12 @@ export interface RepetitionDBScheme {
      * (created by the Collector)
      */
     timestamp: number;
+    /**
+     * Number of real client-side occurrences merged into this single repetition
+     * by Catcher-side debounce (see CatcherMessage.count).
+     * Absent or 1 — this repetition represents a single occurrence.
+     */
+    count?: number;
 }
 /**
  * Repetition with decoded event data

package/build/src/dbScheme/user.d.ts

@@ -4,6 +4,7 @@ import type { BankCard } from './bankCard.ts';
 import type { MembershipDBScheme } from './membership.ts';
 import type { UserProjectsLastVisitDBScheme } from './userProjectsLastVisit.ts';
 import type { GitHubAuthorization } from '../base/user/GitHubAuthorization.ts';
+import type { Utm } from '../base/utm.ts';
 /**
  * Interface representing how user is stored in DB
  */
@@ -57,28 +58,7 @@ export interface UserDBScheme {
     /**
      * UTM parameters from signup - Data form where user went to sign up. Used for analytics purposes
      */
-    utm?: {
-        /**
-         * UTM source - identifies which site sent the traffic
-         */
-        source?: string;
-        /**
-         * UTM medium - identifies what type of link was used
-         */
-        medium?: string;
-        /**
-         * UTM campaign - identifies a specific product promotion or strategic campaign
-         */
-        campaign?: string;
-        /**
-         * UTM content - identifies what specifically was clicked to bring the user to the site
-         */
-        content?: string;
-        /**
-         * UTM term - identifies search terms
-         */
-        term?: string;
-    };
+    utm?: Utm;
     /**
      * GitHub OAuth authorizations.
      * Used for user-to-server operations (e.g. Copilot assignment).

package/index.ts

@@ -14,6 +14,7 @@ export * from './src/base/event/addons';
 
 export * from './src/base/integrations/integrationToken';
 export * from './src/base/project/ProjectTaskManager';
+export * from './src/base/utm';
 export * from './src/base/workspace/GitHubIntegration';
 export * from './src/base/user/GitHubAuthorization';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawk.so/types",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "TypeScript definitions for Hawk",
   "types": "build/index.d.ts",
   "main": "build/index.js",

package/src/base/utm.ts

@@ -0,0 +1,29 @@
+/**
+ * UTM parameters captured for analytics.
+ */
+export interface Utm {
+  /**
+   * UTM source - identifies which site sent the traffic.
+   */
+  source?: string;
+
+  /**
+   * UTM medium - identifies what type of link was used.
+   */
+  medium?: string;
+
+  /**
+   * UTM campaign - identifies a specific product promotion or strategic campaign.
+   */
+  campaign?: string;
+
+  /**
+   * UTM content - identifies what specifically was clicked to bring the user to the site.
+   */
+  content?: string;
+
+  /**
+   * UTM term - identifies search terms.
+   */
+  term?: string;
+}

package/src/catchers/catcher-message.ts

@@ -83,6 +83,12 @@ export interface CatcherMessage<Type extends CatcherMessageType> {
    * All information about the event
    */
   payload: CatcherMessagePayload<Type>;
+
+  /**
+   * Number of identical occurrences this message represents.
+   * Computed on Catcher side to dedupe similar events caused in the same time.
+   */
+  count?: number;
 }
 
 /**

package/src/dbScheme/promoCodeUsage.ts

@@ -1,5 +1,6 @@
 import type { ObjectId } from 'bson';
 import type { PromoCodeBenefitType } from './promoCode.ts';
+import type { Utm } from '../base/utm.ts';
 
 /**
  * Promo code usage representation in DataBase
@@ -53,32 +54,7 @@ export interface PromoCodeUsageDBScheme {
   /**
    * UTM parameters captured when promo code was applied. Used for analytics purposes
    */
-  utm?: {
-    /**
-     * UTM source - identifies which site sent the traffic
-     */
-    source?: string;
-
-    /**
-     * UTM medium - identifies what type of link was used
-     */
-    medium?: string;
-
-    /**
-     * UTM campaign - identifies a specific product promotion or strategic campaign
-     */
-    campaign?: string;
-
-    /**
-     * UTM content - identifies what specifically was clicked to bring the user to the site
-     */
-    content?: string;
-
-    /**
-     * UTM term - identifies search terms
-     */
-    term?: string;
-  };
+  utm?: Utm;
 
   /**
    * Date when promo code was successfully applied

package/src/dbScheme/repetition.ts

@@ -34,6 +34,13 @@ export interface RepetitionDBScheme {
    * (created by the Collector)
    */
   timestamp: number;
+
+  /**
+   * Number of real client-side occurrences merged into this single repetition
+   * by Catcher-side debounce (see CatcherMessage.count).
+   * Absent or 1 — this repetition represents a single occurrence.
+   */
+  count?: number;
 }
 
 /**

package/src/dbScheme/user.ts

@@ -4,6 +4,7 @@ import type { BankCard } from './bankCard.ts';
 import type { MembershipDBScheme } from './membership.ts';
 import type { UserProjectsLastVisitDBScheme } from './userProjectsLastVisit.ts';
 import type { GitHubAuthorization } from '../base/user/GitHubAuthorization.ts';
+import type { Utm } from '../base/utm.ts';
 
 /**
  * Interface representing how user is stored in DB
@@ -69,32 +70,7 @@ export interface UserDBScheme {
   /**
    * UTM parameters from signup - Data form where user went to sign up. Used for analytics purposes
    */
-  utm?: {
-    /**
-     * UTM source - identifies which site sent the traffic
-     */
-    source?: string;
-
-    /**
-     * UTM medium - identifies what type of link was used
-     */
-    medium?: string;
-
-    /**
-     * UTM campaign - identifies a specific product promotion or strategic campaign
-     */
-    campaign?: string;
-
-    /**
-     * UTM content - identifies what specifically was clicked to bring the user to the site
-     */
-    content?: string;
-
-    /**
-     * UTM term - identifies search terms
-     */
-    term?: string;
-  };
+  utm?: Utm;
 
   /**
    * GitHub OAuth authorizations.