change metadata field to be processor only and update docs

Signed-off-by: Frank Ye <franky@spotify.com>

plugins/notifications-backend/migrations/20250521_addMetadata.js

@@ -1,33 +0,0 @@
-/*
- * Copyright 2024 The Backstage Authors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-exports.up = async function up(knex) {
-  await knex.schema.alterTable('notification', table => {
-    table.text('metadata').nullable();
-  });
-  await knex.schema.alterTable('broadcast', table => {
-    table.text('metadata').nullable();
-  });
-};
-
-exports.down = async function down(knex) {
-  await knex.schema.alterTable('notification', table => {
-    table.dropColumn('metadata');
-  });
-  await knex.schema.alterTable('broadcast', table => {
-    table.dropColumn('metadata');
-  });
-};

plugins/notifications-backend/report.sql.md

@@ -11,7 +11,6 @@
 | `icon`        | `character varying`        | true     | 255        | -                   |
 | `id`          | `uuid`                     | false    | -          | -                   |
 | `link`        | `text`                     | true     | -          | -                   |
-| `metadata`    | `text`                     | true     | -          | -                   |
 | `origin`      | `character varying`        | false    | 255        | -                   |
 | `scope`       | `character varying`        | true     | 255        | -                   |
 | `severity`    | `character varying`        | false    | 8          | -                   |
@@ -46,7 +45,6 @@
 | `icon`        | `character varying`        | true     | 255        | -                   |
 | `id`          | `uuid`                     | false    | -          | -                   |
 | `link`        | `text`                     | true     | -          | -                   |
-| `metadata`    | `text`                     | true     | -          | -                   |
 | `origin`      | `character varying`        | false    | 255        | -                   |
 | `read`        | `timestamp with time zone` | true     | -          | -                   |
 | `saved`       | `timestamp with time zone` | true     | -          | -                   |

plugins/notifications-backend/src/database/DatabaseNotificationsStore.test.ts

@@ -69,9 +69,6 @@ const testNotification1: Notification = {
     link: '/catalog',
     severity: 'critical',
     icon: 'docs',
-    metadata: {
-      attribute1: 'value1',
-    },
   },
 };
 const testNotification2: Notification = {
@@ -212,9 +209,6 @@ describe.each(databases.eachSupportedId())(
         expect(notification?.payload?.link).toBe('/catalog');
         expect(notification?.payload?.severity).toBe('critical');
         expect(notification?.payload?.icon).toBe('docs');
-        expect(notification?.payload?.metadata).toEqual({
-          attribute1: 'value1',
-        });
       });
     });
 

plugins/notifications-backend/src/database/DatabaseNotificationsStore.ts

@@ -53,7 +53,6 @@ const NOTIFICATION_COLUMNS = [
   'user',
   'read',
   'saved',
-  'metadata',
 ];
 
 type NotificationRowType = {
@@ -165,7 +164,6 @@ export class DatabaseNotificationsStore implements NotificationsStore {
         severity: row.severity,
         scope: row.scope,
         icon: row.icon,
-        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
       },
     }));
   };
@@ -226,12 +224,9 @@ export class DatabaseNotificationsStore implements NotificationsStore {
       description: notification.payload?.description,
       severity: normalizeSeverity(notification.payload?.severity),
       scope: notification.payload?.scope,
-      icon: notification.payload?.icon,
+      icon: notification.payload.icon,
       saved: notification.saved,
       read: notification.read,
-      metadata: notification.payload?.metadata
-        ? JSON.stringify(notification.payload.metadata)
-        : undefined,
     };
   };
 
@@ -247,9 +242,6 @@ export class DatabaseNotificationsStore implements NotificationsStore {
       severity: normalizeSeverity(notification.payload?.severity),
       icon: notification.payload.icon,
       scope: notification.payload?.scope,
-      metadata: notification.payload?.metadata
-        ? JSON.stringify(notification.payload.metadata)
-        : undefined,
     };
   };
 

plugins/notifications-backend/src/service/router.test.ts

@@ -241,6 +241,9 @@ describe.each(databases.eachSupportedId())('createRouter (%s)', databaseId => {
         },
         payload: {
           title: 'test notification',
+          metadata: {
+            attr: 1,
+          },
         },
       });
 
@@ -253,6 +256,9 @@ describe.each(databases.eachSupportedId())('createRouter (%s)', databaseId => {
           payload: {
             severity: 'normal',
             title: 'test notification',
+            metadata: {
+              attr: 1,
+            },
           },
           user: 'user:default/mock',
         },
@@ -529,9 +535,6 @@ describe.each(databases.eachSupportedId())('createRouter (%s)', databaseId => {
         title: 'Test broadcast notification',
         created: new Date(),
         severity: 'high',
-        metadata: {
-          attr1: 'value1',
-        },
       });
       await client('notification').insert({
         id: uuid(),
@@ -540,9 +543,6 @@ describe.each(databases.eachSupportedId())('createRouter (%s)', databaseId => {
         title: 'Test notification',
         created: new Date(),
         severity: 'normal',
-        metadata: {
-          attr1: 'value1',
-        },
       });
 
       const response = await request(app).get('/');
@@ -561,9 +561,6 @@ describe.each(databases.eachSupportedId())('createRouter (%s)', databaseId => {
               severity: 'normal',
               title: 'Test notification',
               topic: null,
-              metadata: {
-                attr1: 'value1',
-              },
             },
             read: null,
             saved: null,
@@ -582,9 +579,6 @@ describe.each(databases.eachSupportedId())('createRouter (%s)', databaseId => {
               severity: 'high',
               title: 'Test broadcast notification',
               topic: null,
-              metadata: {
-                attr1: 'value1',
-              },
             },
             read: null,
             saved: null,