feat: GuildSeason table. Everything else is WIP

Author: aureateAnatidae

apps/backend/src/db/init_tables.ts

@@ -1,5 +1,6 @@
 import { knexDb } from "@db/knexfile";
 import { getLogger } from "@logtape/logtape";
+import { GuildSeasonTable } from "@v1/guild/models";
 import {
     MatchCharacterTable,
     MatchPlayerTable,
@@ -8,7 +9,6 @@ import {
 } from "@v1/match/models";
 import { MatchReportView, MatchWinnerView } from "@v1/match/views";
 import { SeasonTable } from "@v1/season/models";
-import { Season } from "@v1/season/schemas";
 import type { Knex } from "knex";
 
 const log = getLogger(["grindcord", "db"]);
@@ -19,6 +19,7 @@ const tables = [
     MatchCharacterTable,
     SSBUCharTable,
     SeasonTable,
+    GuildSeasonTable,
 ];
 const views = [MatchWinnerView, MatchReportView];
 

apps/backend/src/v1/guild/models.ts

@@ -0,0 +1,24 @@
+import type { Knex } from "knex";
+import { z } from "zod";
+
+export const GuildSeasonRecord = z.object({
+    guild_id: z.string(),
+    season_id: z.int(),
+});
+export type GuildSeasonRecord = z.infer<typeof GuildSeasonRecord>;
+export const GuildSeasonTable = {
+    table_name: "GuildSeason",
+    initialize(table: Knex.TableBuilder) {
+        table.primary(["guild_id"]);
+
+        table.string("guild_id");
+        table.integer("season_id");
+
+        table
+            .foreign("season_id")
+            .references("season_id")
+            .inTable("Season")
+            .onUpdate("CASCADE")
+            .onDelete("RESTRICT");
+    },
+};

apps/backend/src/v1/guild/router.ts

@@ -0,0 +1,32 @@
+import { SeasonId } from "@v1/season/schemas";
+import { Hono } from "hono";
+import { describeRoute, resolver, validator } from "hono-openapi";
+import { z } from "zod";
+
+const app = new Hono();
+
+app.get(
+    "/season/:season_id",
+    describeRoute({
+        description: "Get the guild's currently active season",
+        responses: {
+            200: {
+                description: "Successful response",
+                content: {
+                    "application/json": {
+                        // schema: resolver(UserPoints),
+                    },
+                },
+            },
+        },
+    }),
+    validator("param", SeasonId),
+    async (c) => {
+        const { season_id } = c.req.valid("param");
+        // return c.json({ points: await getUserPoints( user_id) });
+    },
+);
+// Get a guild's leaderboard
+// app.get("/:guild_id", c);
+
+export default app;

apps/backend/src/v1/season/models.ts

@@ -3,7 +3,6 @@ import { z } from "zod";
 
 export const SeasonRecord = z.object({
     season_id: z.int(),
-    guild_id: z.string(),
     season_name: z.string(),
     start_at: z.iso.datetime(),
     end_at: z.iso.datetime(),
@@ -12,10 +11,9 @@ export type SeasonRecord = z.infer<typeof SeasonRecord>;
 export const SeasonTable = {
     table_name: "Season",
     initialize(table: Knex.TableBuilder) {
-        table.primary(["season_id", "guild_id"]);
+        table.primary(["season_id"]);
 
         table.increments("season_id");
-        table.string("guild_id");
 
         table.string("season_name");
         table.dateTime("start_at");

apps/backend/src/v1/season/schemas.ts

@@ -2,7 +2,6 @@ import { z } from "zod";
 
 export const Season = z.object({
     season_id: z.int(),
-    guild_id: z.string(),
     season_name: z.string(),
     start_at: z.iso.datetime(),
     end_at: z.iso.datetime(),
@@ -21,7 +20,6 @@ export type SeasonId = z.infer<typeof SeasonId>;
 
 export const SeasonQuery = z
     .object({
-        guild_id: z.string(),
         season_name: z.string(),
         after: z.iso.datetime(),
         before: z.iso.datetime(),

apps/backend/src/v1/season/service.ts

@@ -12,11 +12,9 @@ export async function getSeasonIds(
     season_query: SeasonQuery,
     db: Knex = knexDb,
 ): Promise<Array<number>> {
-    const { guild_id, season_name, after, before } = season_query;
+    const { season_name, after, before } = season_query;
     const query = db<SeasonRecord>("Season").select("season_id");
-    if (guild_id) {
-        query.where({ guild_id });
-    }
+
     if (season_name) {
         // https://github.com/knex/knex/issues/5920
         query.whereLike("season_name", `%${season_name}%`);

apps/backend/src/v1/season/test/models.factories.ts

@@ -1,13 +1,11 @@
 import { faker } from "@faker-js/faker";
-import { snowflake } from "@test/factories";
 import type { SeasonRecord } from "@v1/season/models";
 import type { Knex } from "knex";
 
 export const seasonRecordFactory = (
     season_record: Partial<SeasonRecord> | undefined = undefined,
 ): Omit<SeasonRecord, "season_id"> => {
     return {
-        guild_id: snowflake(),
         season_name: faker.animal.fish(),
         start_at: faker.date.recent().toISOString(),
         end_at: faker.date.soon().toISOString(),

apps/backend/src/v1/season/test/schemas.factory.ts

@@ -1,12 +1,10 @@
 import { faker } from "@faker-js/faker";
-import { snowflake } from "@test/factories";
 import type { SeasonCreate } from "@v1/season/schemas";
 
 export const seasonCreateFactory = (
     season_create: SeasonCreate | undefined = undefined,
 ): SeasonCreate => {
     return {
-        guild_id: snowflake(),
         season_name: faker.animal.fish(),
         start_at: faker.date.recent().toISOString(),
         end_at: faker.date.soon().toISOString(),