refactor utm

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';

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);

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;
+}

build/src/base/utm.js

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

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

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).

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.json

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

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;
+}

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

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.