Ws poc (#11293)

related to https://github.com/twentyhq/core-team-issues/issues/601

## Done
- add a `onDbEvent` `Subscription` graphql endpoint to listen to
database_event using what we have done with webhooks:
- you can subscribe to any `action` (created, updated, ...) for any
`objectNameSingular` or a specific `recordId`. Parameters are nullable
and treated as wildcards when null.
  - returns events with following shape
```typescript
  @Field(() => String)
  eventId: string;

  @Field()
  emittedAt: string;

  @Field(() => DatabaseEventAction)
  action: DatabaseEventAction;

  @Field(() => String)
  objectNameSingular: string;

  @Field(() => GraphQLJSON)
  record: ObjectRecord;

  @Field(() => [String], { nullable: true })
  updatedFields?: string[];
```
- front provide a componentEffect `<ListenRecordUpdatesEffect />` that
listen for an `objectNameSingular`, a `recordId` and a list of
`listenedFields`. It subscribes to record updates and updates its apollo
cached value for specified `listenedFields`
- subscription is protected with credentials

## Result

Here is an application with `workflowRun`


https://github.com/user-attachments/assets/c964d857-3b54-495f-bf14-587ba26c5a8c

---------

Co-authored-by: prastoin <paul@twenty.com>

packages/twenty-server/src/engine/subscriptions/dtos/on-db-event.dto.ts

@@ -0,0 +1,30 @@
+import { Field, ObjectType, registerEnumType } from '@nestjs/graphql';
+
+import GraphQLJSON from 'graphql-type-json';
+
+import { ObjectRecord } from 'src/engine/api/graphql/workspace-query-builder/interfaces/object-record.interface';
+
+import { DatabaseEventAction } from 'src/engine/api/graphql/graphql-query-runner/enums/database-event-action';
+
+registerEnumType(DatabaseEventAction, {
+  name: 'DatabaseEventAction',
+  description: 'Database Event Action',
+});
+
+@ObjectType()
+export class OnDbEventDTO {
+  @Field(() => DatabaseEventAction)
+  action: DatabaseEventAction;
+
+  @Field(() => String)
+  objectNameSingular: string;
+
+  @Field()
+  eventDate: Date;
+
+  @Field(() => GraphQLJSON)
+  record: ObjectRecord;
+
+  @Field(() => [String], { nullable: true })
+  updatedFields?: string[];
+}

packages/twenty-server/src/engine/subscriptions/dtos/on-db-event.input.ts

@@ -0,0 +1,15 @@
+import { Field, InputType } from '@nestjs/graphql';
+
+import { DatabaseEventAction } from 'src/engine/api/graphql/graphql-query-runner/enums/database-event-action';
+
+@InputType()
+export class OnDbEventInput {
+  @Field(() => DatabaseEventAction, { nullable: true })
+  action?: DatabaseEventAction;
+
+  @Field(() => String, { nullable: true })
+  objectNameSingular?: string;
+
+  @Field(() => String, { nullable: true })
+  recordId?: string;
+}

packages/twenty-server/src/engine/subscriptions/subscriptions.job.ts

@@ -0,0 +1,52 @@
+import { Inject } from '@nestjs/common';
+
+import { isDefined } from 'twenty-shared/utils';
+import { RedisPubSub } from 'graphql-redis-subscriptions';
+
+import { MessageQueue } from 'src/engine/core-modules/message-queue/message-queue.constants';
+import { Processor } from 'src/engine/core-modules/message-queue/decorators/processor.decorator';
+import { Process } from 'src/engine/core-modules/message-queue/decorators/process.decorator';
+import { WorkspaceEventBatch } from 'src/engine/workspace-event-emitter/types/workspace-event.type';
+import { ObjectRecordEvent } from 'src/engine/core-modules/event-emitter/types/object-record-event.event';
+import { removeSecretFromWebhookRecord } from 'src/utils/remove-secret-from-webhook-record';
+
+@Processor(MessageQueue.subscriptionsQueue)
+export class SubscriptionsJob {
+  constructor(@Inject('PUB_SUB') private readonly pubSub: RedisPubSub) {}
+
+  @Process(SubscriptionsJob.name)
+  async handle(
+    workspaceEventBatch: WorkspaceEventBatch<ObjectRecordEvent>,
+  ): Promise<void> {
+    for (const eventData of workspaceEventBatch.events) {
+      const [nameSingular, operation] = workspaceEventBatch.name.split('.');
+      const record =
+        'after' in eventData.properties && isDefined(eventData.properties.after)
+          ? eventData.properties.after
+          : 'before' in eventData.properties &&
+              isDefined(eventData.properties.before)
+            ? eventData.properties.before
+            : {};
+      const updatedFields =
+        'updatedFields' in eventData.properties
+          ? eventData.properties.updatedFields
+          : undefined;
+
+      const isWebhookEvent = nameSingular === 'webhook';
+      const sanitizedRecord = removeSecretFromWebhookRecord(
+        record,
+        isWebhookEvent,
+      );
+
+      await this.pubSub.publish('onDbEvent', {
+        onDbEvent: {
+          action: operation,
+          objectNameSingular: nameSingular,
+          eventDate: new Date(),
+          record: sanitizedRecord,
+          ...(updatedFields && { updatedFields }),
+        },
+      });
+    }
+  }
+}

packages/twenty-server/src/engine/subscriptions/subscriptions.module.ts

@@ -0,0 +1,34 @@
+import { Inject, Module, OnModuleDestroy } from '@nestjs/common';
+
+import { RedisPubSub } from 'graphql-redis-subscriptions';
+
+import { RedisClientService } from 'src/engine/core-modules/redis-client/redis-client.service';
+import { SubscriptionsResolver } from 'src/engine/subscriptions/subscriptions.resolver';
+import { SubscriptionsJob } from 'src/engine/subscriptions/subscriptions.job';
+
+@Module({
+  exports: ['PUB_SUB'],
+  providers: [
+    {
+      provide: 'PUB_SUB',
+      inject: [RedisClientService],
+
+      useFactory: (redisClientService: RedisClientService) =>
+        new RedisPubSub({
+          publisher: redisClientService.getClient().duplicate(),
+          subscriber: redisClientService.getClient().duplicate(),
+        }),
+    },
+    SubscriptionsResolver,
+    SubscriptionsJob,
+  ],
+})
+export class SubscriptionsModule implements OnModuleDestroy {
+  constructor(@Inject('PUB_SUB') private readonly pubSub: RedisPubSub) {}
+
+  async onModuleDestroy() {
+    if (this.pubSub) {
+      await this.pubSub.close();
+    }
+  }
+}

packages/twenty-server/src/engine/subscriptions/subscriptions.resolver.ts

@@ -0,0 +1,43 @@
+import { Args, Resolver, Subscription } from '@nestjs/graphql';
+import { Inject, UseGuards } from '@nestjs/common';
+
+import { RedisPubSub } from 'graphql-redis-subscriptions';
+import { isDefined } from 'twenty-shared/utils';
+
+import { OnDbEventDTO } from 'src/engine/subscriptions/dtos/on-db-event.dto';
+import { OnDbEventInput } from 'src/engine/subscriptions/dtos/on-db-event.input';
+import { WorkspaceAuthGuard } from 'src/engine/guards/workspace-auth.guard';
+import { UserAuthGuard } from 'src/engine/guards/user-auth.guard';
+
+@Resolver()
+@UseGuards(WorkspaceAuthGuard, UserAuthGuard)
+export class SubscriptionsResolver {
+  constructor(@Inject('PUB_SUB') private readonly pubSub: RedisPubSub) {}
+
+  @Subscription(() => OnDbEventDTO, {
+    filter: (
+      payload: { onDbEvent: OnDbEventDTO },
+      variables: { input: OnDbEventInput },
+    ) => {
+      const isActionMatching =
+        !isDefined(variables.input.action) ||
+        payload.onDbEvent.action === variables.input.action;
+
+      const isObjectNameSingularMatching =
+        !isDefined(variables.input.objectNameSingular) ||
+        payload.onDbEvent.objectNameSingular ===
+          variables.input.objectNameSingular;
+
+      const isRecordIdMatching =
+        !isDefined(variables.input.recordId) ||
+        payload.onDbEvent.record.id === variables.input.recordId;
+
+      return (
+        isActionMatching && isObjectNameSingularMatching && isRecordIdMatching
+      );
+    },
+  })
+  onDbEvent(@Args('input') _: OnDbEventInput) {
+    return this.pubSub.asyncIterator('onDbEvent');
+  }
+}