📝 docs: standardize presence listener pattern across languages

Author: zRelaxz

en/presence/presence-overview.mdx

@@ -20,15 +20,17 @@ The presence system integrates with the sharding system. When your bot runs acro
 The simplest use case is setting a fixed activity that stays until you change it. Call *PresenceManager.setActivity* with a name and a type. The name is the text that appears in the member list, and the type determines the prefix Discord adds (Playing, Watching, Listening, Streaming, or Competing).
 
 ```typescript filename="src/listeners/ready.listener.ts"
-import { Listener, On } from '@spraxium/core';
+import { Events, Listener, Once } from '@spraxium/common';
 import { PresenceManager } from '@spraxium/core';
 
-@Listener()
+@Listener(Events.ClientReady)
 export class ReadyListener {
-  @On('clientReady')
-  onReady() {
+  @Once()
+  onReady(): void {
     PresenceManager.setActivity({
-      name: 'your commands', type: 'Listening', });
+      name: 'your commands',
+      type: 'Listening',
+    });
   }
 }
 ```
@@ -37,7 +39,9 @@ The *setActivity* method only changes the activity. It does not touch the status
 
 ```typescript filename="src/listeners/ready.listener.ts"
 PresenceManager.setPresence({
-  status: 'dnd', activities: [{ name: 'maintenance mode', type: 'Playing' }], });
+  status: 'dnd',
+  activities: [{ name: 'maintenance mode', type: 'Playing' }],
+});
 ```
 
 ## Changing only the status
@@ -89,7 +93,9 @@ Placeholders work everywhere activities are used: in *setActivity*, *setPresence
 
 ```typescript filename="src/listeners/ready.listener.ts"
 PresenceManager.setActivity({
-  name: '{{totalServers}} servers · {{ping}}ms', type: 'Watching', });
+  name: '{{totalServers}} servers · {{ping}}ms',
+  type: 'Watching',
+});
 ```
 
 ## Boot configuration
@@ -102,8 +108,9 @@ Instead of calling *PresenceManager* methods in a listener, you can declare the
 import type { PresenceOptions } from '@spraxium/core';
 
 export const presenceConfig: PresenceOptions = {
-  status: 'online', activities: [
-    { name: '{{totalServers}} servers', type: 'Watching' }, ], };
+  status: 'online',
+  activities: [{ name: '{{totalServers}} servers', type: 'Watching' }],
+};
 ```
   </Tab>
   <Tab label="src/main.ts">
@@ -113,7 +120,9 @@ import { presenceConfig } from '../config/presence.config';
 import { AppModule } from './app.module';
 
 async function main() {
-  const app = await SpraxiumFactory.create({ token: process.env.DISCORD_TOKEN });
+  const app = await SpraxiumFactory.create({
+    token: process.env.DISCORD_TOKEN,
+  });
   app.useModule(AppModule);
   app.initPresence(presenceConfig);
   await app.listen();

en/presence/presence-rotation-shards.mdx

@@ -12,15 +12,21 @@ category: Presence
 When your bot has multiple things to say, you can cycle through activities on a fixed interval. The *startRotation* method accepts an array of activities and a millisecond interval. It sets the first activity immediately, then advances to the next one every time the interval fires. The rotation wraps around when it reaches the end of the array.
 
 ```typescript filename="src/listeners/ready.listener.ts"
-import { Listener, On } from '@spraxium/core';
+import { Events, Listener, Once } from '@spraxium/common';
 import { PresenceManager } from '@spraxium/core';
 
-@Listener()
+@Listener(Events.ClientReady)
 export class ReadyListener {
-  @On('clientReady')
-  onReady() {
-    PresenceManager.startRotation([
-      { name: '{{totalServers}} servers', type: 'Watching' }, { name: '/help for commands', type: 'Playing' }, { name: 'feedback from users', type: 'Listening' }, ], 30_000);
+  @Once()
+  onReady(): void {
+    PresenceManager.startRotation(
+      [
+        { name: '{{totalServers}} servers', type: 'Watching' },
+        { name: '/help for commands', type: 'Playing' },
+        { name: 'feedback from users', type: 'Listening' },
+      ],
+      30_000,
+    );
   }
 }
 ```
@@ -35,8 +41,14 @@ You can also configure rotation at boot time by setting *rotateInterval* in your
 import type { PresenceOptions } from '@spraxium/core';
 
 export const presenceConfig: PresenceOptions = {
-  status: 'online', activities: [
-    { name: '{{totalServers}} servers', type: 'Watching' }, { name: '/help', type: 'Playing' }, { name: '{{ping}}ms latency', type: 'Competing' }, ], rotateInterval: 20_000, };
+  status: 'online',
+  activities: [
+    { name: '{{totalServers}} servers', type: 'Watching' },
+    { name: '/help', type: 'Playing' },
+    { name: '{{ping}}ms latency', type: 'Competing' },
+  ],
+  rotateInterval: 20_000,
+};
 ```
   </Tab>
   <Tab label="src/main.ts">
@@ -46,7 +58,9 @@ import { presenceConfig } from '../config/presence.config';
 import { AppModule } from './app.module';
 
 async function main() {
-  const app = await SpraxiumFactory.create({ token: process.env.DISCORD_TOKEN });
+  const app = await SpraxiumFactory.create({
+    token: process.env.DISCORD_TOKEN,
+  });
   app.useModule(AppModule);
   app.initPresence(presenceConfig);
   await app.listen();
@@ -65,7 +79,10 @@ The *stopRotation* method clears the interval timer. The last active activity re
 import { PresenceManager } from '@spraxium/core';
 
 PresenceManager.stopRotation();
-PresenceManager.setActivity({ name: 'maintenance in progress', type: 'Playing' });
+PresenceManager.setActivity({
+  name: 'maintenance in progress',
+  type: 'Playing',
+});
 ```
 
 ## Per-shard presence at boot
@@ -80,10 +97,19 @@ For deeper customization, the *PresenceOptions* object supports a *perShard* rec
 import type { PresenceOptions } from '@spraxium/core';
 
 export const presenceConfig: PresenceOptions = {
-  status: 'online', activities: [
-    { name: 'Shard {{shardNumber}}/{{totalShards}}', type: 'Playing' }, ], perShard: {
+  status: 'online',
+  activities: [
+    { name: 'Shard {{shardNumber}}/{{totalShards}}', type: 'Playing' },
+  ],
+  perShard: {
     0: {
-      status: 'dnd', activities: [{ name: 'Primary shard · {{totalServers}} guilds', type: 'Watching' }], }, }, };
+      status: 'dnd',
+      activities: [
+        { name: 'Primary shard · {{totalServers}} guilds', type: 'Watching' },
+      ],
+    },
+  },
+};
 ```
   </Tab>
   <Tab label="src/main.ts">
@@ -93,7 +119,9 @@ import { presenceConfig } from '../config/presence.config';
 import { AppModule } from './app.module';
 
 async function main() {
-  const app = await SpraxiumFactory.create({ token: process.env.DISCORD_TOKEN });
+  const app = await SpraxiumFactory.create({
+    token: process.env.DISCORD_TOKEN,
+  });
   app.useModule(AppModule);
   app.initPresence(presenceConfig);
   await app.listen();
@@ -117,8 +145,14 @@ import { PresenceManager } from '@spraxium/core';
 @Injectable()
 export class ShardStatusService {
   updateShardActivity(shardId: number, version: string) {
-    PresenceManager.setShardActivity(shardId, {
-      name: 'v{{version}} · {{totalServers}} guilds on shard {{shardNumber}}', type: 'Playing', }, { version });
+    PresenceManager.setShardActivity(
+      shardId,
+      {
+        name: 'v{{version}} · {{totalServers}} guilds on shard {{shardNumber}}',
+        type: 'Playing',
+      },
+      { version },
+    );
   }
 
   resetShard(shardId: number) {

es/presence/presence-overview.mdx

@@ -20,15 +20,17 @@ El sistema de presencia se integra con el sistema de sharding. Cuando tu bot cor
 El caso de uso más simple es definir una actividad fija que permanece hasta que la cambies. Llama a *PresenceManager.setActivity* con un nombre y un tipo. El nombre es el texto que aparece en la lista de miembros, y el tipo determina el prefijo que Discord agrega (Jugando, Viendo, Escuchando, Transmitiendo o Compitiendo).
 
 ```typescript filename="src/listeners/ready.listener.ts"
-import { Listener, On } from '@spraxium/core';
+import { Events, Listener, Once } from '@spraxium/common';
 import { PresenceManager } from '@spraxium/core';
 
-@Listener()
+@Listener(Events.ClientReady)
 export class ReadyListener {
-  @On('clientReady')
-  onReady() {
+  @Once()
+  onReady(): void {
     PresenceManager.setActivity({
-      name: 'your commands', type: 'Listening', });
+      name: 'your commands',
+      type: 'Listening',
+    });
   }
 }
 ```
@@ -37,7 +39,9 @@ El método *setActivity* solo cambia la actividad. No toca el indicador de estad
 
 ```typescript filename="src/listeners/ready.listener.ts"
 PresenceManager.setPresence({
-  status: 'dnd', activities: [{ name: 'maintenance mode', type: 'Playing' }], });
+  status: 'dnd',
+  activities: [{ name: 'maintenance mode', type: 'Playing' }],
+});
 ```
 
 ## Cambiando solo el estado
@@ -89,7 +93,9 @@ Los placeholders funcionan en todos los lugares donde se usan actividades: en *s
 
 ```typescript filename="src/listeners/ready.listener.ts"
 PresenceManager.setActivity({
-  name: '{{totalServers}} servers · {{ping}}ms', type: 'Watching', });
+  name: '{{totalServers}} servers · {{ping}}ms',
+  type: 'Watching',
+});
 ```
 
 ## Configuración de boot
@@ -102,8 +108,9 @@ En lugar de llamar métodos del *PresenceManager* en un listener, puedes declara
 import type { PresenceOptions } from '@spraxium/core';
 
 export const presenceConfig: PresenceOptions = {
-  status: 'online', activities: [
-    { name: '{{totalServers}} servers', type: 'Watching' }, ], };
+  status: 'online',
+  activities: [{ name: '{{totalServers}} servers', type: 'Watching' }],
+};
 ```
   </Tab>
   <Tab label="src/main.ts">
@@ -113,7 +120,9 @@ import { presenceConfig } from '../config/presence.config';
 import { AppModule } from './app.module';
 
 async function main() {
-  const app = await SpraxiumFactory.create({ token: process.env.DISCORD_TOKEN });
+  const app = await SpraxiumFactory.create({
+    token: process.env.DISCORD_TOKEN,
+  });
   app.useModule(AppModule);
   app.initPresence(presenceConfig);
   await app.listen();

es/presence/presence-rotation-shards.mdx

@@ -12,15 +12,21 @@ category: Presence
 Cuando tu bot tiene múltiples cosas para mostrar, puedes ciclar actividades en un intervalo fijo. El método *startRotation* acepta un array de actividades y un intervalo en milisegundos. Define la primera actividad inmediatamente, luego avanza a la siguiente cada vez que el intervalo se dispara. La rotación vuelve al inicio cuando llega al final del array.
 
 ```typescript filename="src/listeners/ready.listener.ts"
-import { Listener, On } from '@spraxium/core';
+import { Events, Listener, Once } from '@spraxium/common';
 import { PresenceManager } from '@spraxium/core';
 
-@Listener()
+@Listener(Events.ClientReady)
 export class ReadyListener {
-  @On('clientReady')
-  onReady() {
-    PresenceManager.startRotation([
-      { name: '{{totalServers}} servers', type: 'Watching' }, { name: '/help for commands', type: 'Playing' }, { name: 'feedback from users', type: 'Listening' }, ], 30_000);
+  @Once()
+  onReady(): void {
+    PresenceManager.startRotation(
+      [
+        { name: '{{totalServers}} servers', type: 'Watching' },
+        { name: '/help for commands', type: 'Playing' },
+        { name: 'feedback from users', type: 'Listening' },
+      ],
+      30_000,
+    );
   }
 }
 ```
@@ -35,8 +41,14 @@ También puedes configurar la rotación en el boot definiendo *rotateInterval* e
 import type { PresenceOptions } from '@spraxium/core';
 
 export const presenceConfig: PresenceOptions = {
-  status: 'online', activities: [
-    { name: '{{totalServers}} servers', type: 'Watching' }, { name: '/help', type: 'Playing' }, { name: '{{ping}}ms latency', type: 'Competing' }, ], rotateInterval: 20_000, };
+  status: 'online',
+  activities: [
+    { name: '{{totalServers}} servers', type: 'Watching' },
+    { name: '/help', type: 'Playing' },
+    { name: '{{ping}}ms latency', type: 'Competing' },
+  ],
+  rotateInterval: 20_000,
+};
 ```
   </Tab>
   <Tab label="src/main.ts">
@@ -46,7 +58,9 @@ import { presenceConfig } from '../config/presence.config';
 import { AppModule } from './app.module';
 
 async function main() {
-  const app = await SpraxiumFactory.create({ token: process.env.DISCORD_TOKEN });
+  const app = await SpraxiumFactory.create({
+    token: process.env.DISCORD_TOKEN,
+  });
   app.useModule(AppModule);
   app.initPresence(presenceConfig);
   await app.listen();
@@ -65,7 +79,10 @@ El método *stopRotation* limpia el temporizador de intervalo. La última activi
 import { PresenceManager } from '@spraxium/core';
 
 PresenceManager.stopRotation();
-PresenceManager.setActivity({ name: 'maintenance in progress', type: 'Playing' });
+PresenceManager.setActivity({
+  name: 'maintenance in progress',
+  type: 'Playing',
+});
 ```
 
 ## Presencia por shard en el boot
@@ -80,10 +97,19 @@ Para una personalización más profunda, el objeto *PresenceOptions* soporta un
 import type { PresenceOptions } from '@spraxium/core';
 
 export const presenceConfig: PresenceOptions = {
-  status: 'online', activities: [
-    { name: 'Shard {{shardNumber}}/{{totalShards}}', type: 'Playing' }, ], perShard: {
+  status: 'online',
+  activities: [
+    { name: 'Shard {{shardNumber}}/{{totalShards}}', type: 'Playing' },
+  ],
+  perShard: {
     0: {
-      status: 'dnd', activities: [{ name: 'Primary shard · {{totalServers}} guilds', type: 'Watching' }], }, }, };
+      status: 'dnd',
+      activities: [
+        { name: 'Primary shard · {{totalServers}} guilds', type: 'Watching' },
+      ],
+    },
+  },
+};
 ```
   </Tab>
   <Tab label="src/main.ts">
@@ -93,7 +119,9 @@ import { presenceConfig } from '../config/presence.config';
 import { AppModule } from './app.module';
 
 async function main() {
-  const app = await SpraxiumFactory.create({ token: process.env.DISCORD_TOKEN });
+  const app = await SpraxiumFactory.create({
+    token: process.env.DISCORD_TOKEN,
+  });
   app.useModule(AppModule);
   app.initPresence(presenceConfig);
   await app.listen();
@@ -117,8 +145,14 @@ import { PresenceManager } from '@spraxium/core';
 @Injectable()
 export class ShardStatusService {
   updateShardActivity(shardId: number, version: string) {
-    PresenceManager.setShardActivity(shardId, {
-      name: 'v{{version}} · {{totalServers}} guilds on shard {{shardNumber}}', type: 'Playing', }, { version });
+    PresenceManager.setShardActivity(
+      shardId,
+      {
+        name: 'v{{version}} · {{totalServers}} guilds on shard {{shardNumber}}',
+        type: 'Playing',
+      },
+      { version },
+    );
   }
 
   resetShard(shardId: number) {