@hawk.so/types 0.6.0-rc.1 → 0.6.1

package/build/index.d.ts

@@ -19,6 +19,8 @@ export * from './src/dbScheme/notificationsChannelSettings';
 export * from './src/dbScheme/membership';
 export * from './src/dbScheme/userProjectsLastVisit';
 export * from './src/dbScheme/plan';
+export * from './src/dbScheme/promoCode';
+export * from './src/dbScheme/promoCodeUsage';
 export * from './src/dbScheme/project';
 export * from './src/dbScheme/projectNotificationsRule';
 export * from './src/dbScheme/release';

package/build/index.js

@@ -35,6 +35,8 @@ __exportStar(require("./src/dbScheme/notificationsChannelSettings"), exports);
 __exportStar(require("./src/dbScheme/membership"), exports);
 __exportStar(require("./src/dbScheme/userProjectsLastVisit"), exports);
 __exportStar(require("./src/dbScheme/plan"), exports);
+__exportStar(require("./src/dbScheme/promoCode"), exports);
+__exportStar(require("./src/dbScheme/promoCodeUsage"), exports);
 __exportStar(require("./src/dbScheme/project"), exports);
 __exportStar(require("./src/dbScheme/projectNotificationsRule"), exports);
 __exportStar(require("./src/dbScheme/release"), exports);

package/build/src/base/workspace/GitHubIntegration.d.ts

@@ -69,9 +69,14 @@ export interface GitHubInstallation {
      */
     updatedAt: Date;
     /**
-     * Delegate user for agent actions in Worker
+     * Delegate user whose GitHub OAuth token is used by the Worker
+     * for user-to-server actions (e.g. Copilot assignment).
+     *
+     * null right after installation is saved — at that point we only have
+     * the installation_id from GitHub but haven't exchanged the OAuth code yet.
+     * Gets populated in the same /oauth callback once the code exchange succeeds.
      */
-    delegatedUser: GitHubInstallationDelegatedUser;
+    delegatedUser: GitHubInstallationDelegatedUser | null;
 }
 /**
  * GitHub integration data stored at workspace level

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

@@ -0,0 +1,44 @@
+import type { ObjectId } from 'bson';
+/**
+ * Promo code representation in DataBase
+ */
+export interface PromoCodeDBScheme {
+    /**
+     * Promo code id
+     */
+    _id: ObjectId;
+    /**
+     * Normalized promo code value
+     * @example HAWK-2026
+     */
+    code: string;
+    /**
+     * Tariff plan assigned by this promo code
+     */
+    planId: ObjectId;
+    /**
+     * Maximum total usages count
+     * @example 100
+     */
+    limit?: number;
+    /**
+     * Date after which promo code cannot be used
+     * @example 2026-12-31T23:59:59.000Z
+     */
+    expiresAt?: Date;
+    /**
+     * Date when promo code was created
+     * @example 2026-06-10T12:00:00.000Z
+     */
+    createdAt: Date;
+    /**
+     * Date when promo code was updated
+     * @example 2026-06-10T12:00:00.000Z
+     */
+    updatedAt: Date;
+    /**
+     * User or system id that created promo code
+     * @example 507f1f77bcf86cd799439013
+     */
+    createdBy: string;
+}

package/build/src/dbScheme/promoCode.js

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

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

@@ -0,0 +1,52 @@
+import type { ObjectId } from 'bson';
+/**
+ * Promo code usage representation in DataBase
+ */
+export interface PromoCodeUsageDBScheme {
+    /**
+     * Promo code usage id
+     */
+    _id: ObjectId;
+    /**
+     * Applied promo code id
+     */
+    promoCodeId: ObjectId;
+    /**
+     * User who applied promo code
+     */
+    userId: string;
+    /**
+     * Workspace where promo code was applied
+     */
+    workspaceId: ObjectId;
+    /**
+     * Date when promo code was applied
+     * @example 2026-06-10T12:30:00.000Z
+     */
+    appliedAt: Date;
+    /**
+     * 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;
+    };
+}

package/build/src/dbScheme/promoCodeUsage.js

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

package/index.ts

@@ -24,6 +24,8 @@ export * from './src/dbScheme/notificationsChannelSettings';
 export * from './src/dbScheme/membership';
 export * from './src/dbScheme/userProjectsLastVisit';
 export * from './src/dbScheme/plan';
+export * from './src/dbScheme/promoCode';
+export * from './src/dbScheme/promoCodeUsage';
 export * from './src/dbScheme/project';
 export * from './src/dbScheme/projectNotificationsRule';
 export * from './src/dbScheme/release';

package/package.json

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

package/src/base/workspace/GitHubIntegration.ts

@@ -81,9 +81,14 @@ export interface GitHubInstallation {
   updatedAt: Date;
 
   /**
-   * Delegate user for agent actions in Worker
+   * Delegate user whose GitHub OAuth token is used by the Worker
+   * for user-to-server actions (e.g. Copilot assignment).
+   *
+   * null right after installation is saved — at that point we only have
+   * the installation_id from GitHub but haven't exchanged the OAuth code yet.
+   * Gets populated in the same /oauth callback once the code exchange succeeds.
    */
-  delegatedUser: GitHubInstallationDelegatedUser;
+  delegatedUser: GitHubInstallationDelegatedUser | null;
 }
 
 /**

package/src/dbScheme/promoCode.ts

@@ -0,0 +1,52 @@
+import type { ObjectId } from 'bson';
+
+/**
+ * Promo code representation in DataBase
+ */
+export interface PromoCodeDBScheme {
+  /**
+   * Promo code id
+   */
+  _id: ObjectId;
+
+  /**
+   * Normalized promo code value
+   * @example HAWK-2026
+   */
+  code: string;
+
+  /**
+   * Tariff plan assigned by this promo code
+   */
+  planId: ObjectId;
+
+  /**
+   * Maximum total usages count
+   * @example 100
+   */
+  limit?: number;
+
+  /**
+   * Date after which promo code cannot be used
+   * @example 2026-12-31T23:59:59.000Z
+   */
+  expiresAt?: Date;
+
+  /**
+   * Date when promo code was created
+   * @example 2026-06-10T12:00:00.000Z
+   */
+  createdAt: Date;
+
+  /**
+   * Date when promo code was updated
+   * @example 2026-06-10T12:00:00.000Z
+   */
+  updatedAt: Date;
+
+  /**
+   * User or system id that created promo code
+   * @example 507f1f77bcf86cd799439013
+   */
+  createdBy: string;
+}

package/src/dbScheme/promoCodeUsage.ts

@@ -0,0 +1,62 @@
+import type { ObjectId } from 'bson';
+
+/**
+ * Promo code usage representation in DataBase
+ */
+export interface PromoCodeUsageDBScheme {
+  /**
+   * Promo code usage id
+   */
+  _id: ObjectId;
+
+  /**
+   * Applied promo code id
+   */
+  promoCodeId: ObjectId;
+
+  /**
+   * User who applied promo code
+   */
+  userId: string;
+
+  /**
+   * Workspace where promo code was applied
+   */
+  workspaceId: ObjectId;
+
+  /**
+   * Date when promo code was applied
+   * @example 2026-06-10T12:30:00.000Z
+   */
+  appliedAt: Date;
+
+  /**
+   * 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;
+  };
+}