Add /tag random command

Author: l7ssha

lib/src/commands/tag.dart

@@ -62,6 +62,23 @@ final tag = ChatGroup(
         await Injector.appInstance.get<TagModule>().registerTagUsedEvent(TagUsedEvent.fromTag(tag: tag, hidden: false));
       }),
     ),
+    ChatCommand(
+      'random',
+      'Show a random tag',
+      id('tag-random', (ChatContext context) async {
+        final module = Injector.appInstance.get<TagModule>();
+        final guildOrUser = context.guild?.id ?? context.user.id;
+
+        final randomTag = await module.getRandomTag(guildOrUser);
+
+        if (randomTag == null) {
+          return await context.respond(MessageBuilder(content: 'Cannot fetch random tag...'));
+        }
+        module.registerTagUsedEvent(TagUsedEvent.fromTag(tag: randomTag, hidden: false));
+
+        return context.respond(MessageBuilder(content: randomTag.content));
+      }),
+    ),
     ChatCommand(
       'preview',
       'View a tag, without making it publicly visible',

lib/src/modules/tag.dart

@@ -62,6 +62,10 @@ class TagModule {
     return results.firstOrNull;
   }
 
+  Future<Tag?> getRandomTag(Snowflake guildId) async {
+    return _tagRepository.fetchRandomActiveTag(guildId: guildId.toString());
+  }
+
   Future<Iterable<(TagUsedEvent, Tag)>> getTagUsage(Snowflake guildId, [Tag? tag]) {
     return _tagRepository.fetchTagUsage(guildId: guildId.toString(), tagId: tag?.id);
   }

lib/src/repository/tag.dart

@@ -50,6 +50,23 @@ class TagRepository {
     return result.first.toColumnMap()['count_tags'] ?? 0;
   }
 
+  Future<Tag?> fetchRandomActiveTag({required String guildId}) async {
+    final query = SelectQuery.selectAll('tags')
+      ..andWhere('enabled = TRUE')
+      ..andWhere('guild_id = @guildId')
+      ..orderBy('random()')
+      ..limit(1);
+
+    final params = <String, dynamic>{"guildId": guildId};
+
+    final result = await _database.executeQuery(query, parameters: params);
+    if (result.isEmpty) {
+      return null;
+    }
+
+    return Tag.fromRow(result.first.toColumnMap());
+  }
+
   Future<Iterable<Tag>> searchActiveTags({
     required String query,
     int limit = 25,

lib/src/util/query_builder.dart

@@ -215,12 +215,18 @@ class DeleteQuery extends Query with _WhereQuery {
 
 class SelectQuery extends Query with _WhereQuery, _JoinQuery {
   final List<String> _selects = [];
+  final List<String> _orderBys = [];
+  int? _limit;
+  int? _offset;
 
   SelectQuery(super.from, {super.alias});
   factory SelectQuery.selectAll(String from, {String? alias}) =>
       SelectQuery(from, alias: alias)..select("${alias != null ? '$alias.' : ''}*");
 
   void select(String expression) => _selects.add(expression);
+  void orderBy(String expression) => _orderBys.add(expression);
+  void limit(int n) => _limit = n;
+  void offset(int n) => _offset = n;
 
   @override
   Sql build() {
@@ -232,8 +238,17 @@ class SelectQuery extends Query with _WhereQuery, _JoinQuery {
     buffer.write(" ");
     _buildWheres(buffer);
 
-    buffer.write(";");
+    if (_orderBys.isNotEmpty) {
+      buffer.write(" ORDER BY ${_orderBys.join(",")}");
+    }
+    if (_limit != null) {
+      buffer.write(" LIMIT $_limit");
+    }
+    if (_offset != null) {
+      buffer.write(" OFFSET $_offset");
+    }
 
+    buffer.write(";");
     return Sql.named(buffer.toStringClean());
   }
 }

test/pipelines_test.dart

@@ -16,4 +16,4 @@ void main() {
       expect(embed.author?.name, 'Pipeline Build');
     });
   });
-}
+}

test/query_builder_test.dart

@@ -148,6 +148,83 @@ void main() {
         final query = SelectQuery("test");
         expect(() => query.build().asString(), throwsA(isA<QueryBuilderException>()));
       });
+      test("Select with ORDER BY random() and LIMIT/OFFSET", () {
+        final query = SelectQuery("test")
+          ..select("*")
+          ..andWhere("a = 1")
+          ..orderBy("random()")
+          ..limit(5)
+          ..offset(10);
+
+        expect(query.build().asString(), "SELECT * FROM test WHERE a = 1 ORDER BY random() LIMIT 5 OFFSET 10;");
+      });
+
+      test("Select with multiple ORDER BY clauses", () {
+        final query = SelectQuery("t")
+          ..select("*")
+          ..orderBy("a ASC")
+          ..orderBy("b DESC");
+
+        expect(query.build().asString(), "SELECT * FROM t ORDER BY a ASC,b DESC;");
+      });
+
+      test("Select with LIMIT only", () {
+        final query = SelectQuery("t")
+          ..select("*")
+          ..limit(3);
+
+        expect(query.build().asString(), "SELECT * FROM t LIMIT 3;");
+      });
+
+      test("Select with OFFSET only", () {
+        final query = SelectQuery("t")
+          ..select("*")
+          ..offset(7);
+
+        expect(query.build().asString(), "SELECT * FROM t OFFSET 7;");
+      });
+
+      test("Select with JOIN + WHERE + ORDER BY + LIMIT", () {
+        final query = SelectQuery("tag_usage", alias: "tu")
+          ..select("tu.*")
+          ..addJoin("tags", "t", ["t.id = tu.command_id"])
+          ..andWhere("t.enabled = TRUE")
+          ..orderBy("t.id DESC")
+          ..limit(1);
+
+        expect(
+          query.build().asString(),
+          "SELECT tu.* FROM tag_usage tu JOIN tags t ON t.id = tu.command_id WHERE t.enabled = TRUE ORDER BY t.id DESC LIMIT 1;",
+        );
+      });
+      test("Select alias selectAll with ORDER BY + LIMIT + OFFSET", () {
+        final query = SelectQuery.selectAll("test", alias: "t")
+          ..orderBy("t.a DESC")
+          ..limit(2)
+          ..offset(1);
+
+        expect(query.build().asString(), "SELECT t.* FROM test t ORDER BY t.a DESC LIMIT 2 OFFSET 1;");
+      });
+
+      test("Select LIMIT/OFFSET render order is LIMIT then OFFSET regardless of call order", () {
+        final query = SelectQuery("t")
+          ..select("*")
+          ..offset(100)
+          ..limit(10);
+
+        expect(query.build().asString(), "SELECT * FROM t LIMIT 10 OFFSET 100;");
+      });
+
+      test("Select with mixed AND/OR WHEREs and ORDER BY", () {
+        final query = SelectQuery("t")
+          ..select("*")
+          ..andWhere("a = 1")
+          ..andWhere("b = 2")
+          ..orWhere("c = 3")
+          ..orderBy("id");
+
+        expect(query.build().asString(), "SELECT * FROM t WHERE a = 1 AND b = 2 OR c = 3 ORDER BY id;");
+      });
     });
 
     group("Update tests", () {

test/utils_test.dart

@@ -174,10 +174,7 @@ void main() {
     });
 
     test('getDurationFromStringOrDefault invalid string returns default', () {
-      expect(
-        getDurationFromStringOrDefault('not a duration', const Duration(seconds: 5)),
-        const Duration(seconds: 5),
-      );
+      expect(getDurationFromStringOrDefault('not a duration', const Duration(seconds: 5)), const Duration(seconds: 5));
     });
 
     test('valueOrNull returns original non-empty string (not trimmed)', () {