chore: Normalize release identifier

Author: Dobrunia

workers/grouper/src/index.ts

@@ -110,10 +110,35 @@ export default class GrouperWorker extends Worker {
     // FIX RELEASE TYPE
     // TODO: REMOVE AFTER 01.01.2026, after the most of the users update to new js catcher
     if (task.payload && task.payload.release !== undefined) {
+      let normalizedRelease = String(task.payload.release);
+
+      // Normalize Date.toString() format to timestamp
+      if (/GMT|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec/.test(normalizedRelease)) {
+        const parsed = Date.parse(normalizedRelease);
+
+        if (!isNaN(parsed)) {
+          normalizedRelease = String(parsed);
+        }
+      }
+
       task.payload = {
         ...task.payload,
-        release: String(task.payload.release),
+        release: normalizedRelease,
       };
+
+      // Ensure release appears in the releases list (used by project.releases in API)
+      if (task.projectId) {
+        try {
+          const releasesCol = this.eventsDb.getConnection().collection('releases');
+          await releasesCol.updateOne(
+            { projectId: task.projectId, release: normalizedRelease },
+            { $setOnInsert: { projectId: task.projectId, release: normalizedRelease, commits: [] } },
+            { upsert: true },
+          );
+        } catch (err) {
+          this.logger.warn('Failed to ensure release in releases collection', { err, projectId: task.projectId, release: normalizedRelease });
+        }
+      }
     }
 
     let existedEvent: GroupedEventDBScheme;

workers/javascript/src/index.ts

@@ -311,6 +311,22 @@ export default class JavascriptEventWorker extends EventWorker {
     });
   }
 
+  /**
+   * Normalize release identifier for DB lookup (same logic as grouper/release worker).
+   * Converts Date.toString() format to timestamp so lookup matches how releases are stored.
+   */
+  private normalizeRelease(release: string): string {
+    if (/GMT|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec/.test(release)) {
+      const parsed = Date.parse(release);
+
+      if (!isNaN(parsed)) {
+        return String(parsed);
+      }
+    }
+
+    return release;
+  }
+
   /**
    * Return source map for passed release from DB
    * Source Map are delivered at the building-time from client's server to the Source Maps Worker
@@ -319,11 +335,13 @@ export default class JavascriptEventWorker extends EventWorker {
    * @param {string} release - bundle version passed with source map and same release passed to the catcher's init
    */
   private async getReleaseRecord(projectId: string, release: string): Promise<SourceMapsRecord> {
+    const normalizedRelease = this.normalizeRelease(release);
+
     try {
       const releaseRecord = await this.releasesDbCollection
         .findOne({
           projectId,
-          release,
+          release: normalizedRelease,
         }, {
           sort: {
             _id: -1,

workers/release/src/index.ts

@@ -79,14 +79,36 @@ export default class ReleaseWorker extends Worker {
     }
   }
 
+  /**
+   * Normalize release identifier (convert Date.toString() format to timestamp if needed)
+   * @param release - raw release value
+   * @returns normalized release identifier
+   */
+  private normalizeRelease(release: string): string {
+    // If release looks like Date.toString() output (contains "GMT" or month names)
+    if (/GMT|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec/.test(release)) {
+      const parsed = Date.parse(release);
+
+      if (!isNaN(parsed)) {
+        // Convert to timestamp (milliseconds)
+        return String(parsed);
+      }
+    }
+
+    // Return as-is (semantic version, timestamp, or custom identifier)
+    return release;
+  }
+
   /**
    * Save user's release
    *
    * @param projectId - project id to bind the corresponding release.
    * @param payload - release payload
    */
   private async saveRelease(projectId: string, payload: ReleaseWorkerAddReleasePayload): Promise<void> {
-    this.logger.info(`saveRelease: save release for project: ${projectId}, release: ${payload.release}`);
+    const normalizedRelease = this.normalizeRelease(payload.release);
+
+    this.logger.info(`saveRelease: save release for project: ${projectId}, release: ${payload.release} (normalized: ${normalizedRelease})`);
     try {
       const commits = payload.commits;
 
@@ -101,7 +123,7 @@ export default class ReleaseWorker extends Worker {
 
         await this.releasesCollection.updateOne({
           projectId: projectId,
-          release: payload.release,
+          release: normalizedRelease,
         }, {
           $set: {
             commits: commitsWithParsedDate,
@@ -113,7 +135,7 @@ export default class ReleaseWorker extends Worker {
 
       // save source maps
       if (payload.files) {
-        await this.saveSourceMap(projectId, payload);
+        await this.saveSourceMap(projectId, { ...payload, release: normalizedRelease });
       }
     } catch (err) {
       this.logger.error(`Couldn't save the release due to: ${err}`);