rhythia-api 242.0.0 → 243.0.0

package/handleApi.ts

@@ -1,21 +1,24 @@
-import { z } from "zod";
-let env = "development";
-import { profanity, CensorType } from "@2toad/profanity";
-export function setEnvironment(
-  stage: "development" | "testing" | "production"
-) {
-  env = stage;
-}
-export function handleApi<
-  T extends { url: string; input: z.ZodObject<any>; output: z.ZodObject<any> }
->(apiSchema: T) {
-  profanity.whitelist.addWords(["willy"]);
-  return async (input: T["input"]["_type"]): Promise<T["output"]["_type"]> => {
-    const response = await fetch(`https://${env}.rhythia.com${apiSchema.url}`, {
-      method: "POST",
-      body: JSON.stringify(input),
-    });
-    const output = await response.text();
-    return JSON.parse(profanity.censor(output));
-  };
-}
+import { z } from "zod";
+let endpoint = "https://development.rhythia.com";
+import { profanity, CensorType } from "@2toad/profanity";
+export function setEnvironment(
+  stage: "development" | "testing" | "production"
+) {
+  endpoint = `https://${stage}.rhythia.com`;
+}
+export function setEndpoint(value: string) {
+  endpoint = value;
+}
+export function handleApi<
+  T extends { url: string; input: z.ZodObject<any>; output: z.ZodObject<any> }
+>(apiSchema: T) {
+  profanity.whitelist.addWords(["willy"]);
+  return async (input: T["input"]["_type"]): Promise<T["output"]["_type"]> => {
+    const response = await fetch(`${endpoint}${apiSchema.url}`, {
+      method: "POST",
+      body: JSON.stringify(input),
+    });
+    const output = await response.text();
+    return JSON.parse(profanity.censor(output));
+  };
+}

package/index.ts

@@ -392,18 +392,18 @@ export const executeAdminOperation = handleApi({url:"/api/executeAdminOperation"
 // ./api/getAvatarUploadUrl.ts API
 
 /*
-export const Schema = {
-  input: z.strictObject({
-    session: z.string(),
-    contentLength: z.number(),
-    contentType: z.string(),
-    intrinsicToken: z.string(),
-  }),
-  output: z.strictObject({
-    error: z.string().optional(),
-    url: z.string().optional(),
-    objectKey: z.string().optional(),
-  }),
+export const Schema = {
+  input: z.strictObject({
+    session: z.string(),
+    contentLength: z.number(),
+    contentType: z.string(),
+    intrinsicToken: z.string(),
+  }),
+  output: z.strictObject({
+    error: z.string().optional(),
+    url: z.string().optional(),
+    objectKey: z.string().optional(),
+  }),
 };*/
 import { Schema as GetAvatarUploadUrl } from "./api/getAvatarUploadUrl"
 export { Schema as SchemaGetAvatarUploadUrl } from "./api/getAvatarUploadUrl"
@@ -541,6 +541,7 @@ export const Schema = {
         description: z.string().nullable().optional(),
         tags: z.string().nullable().optional(),
         videoUrl: z.string().nullable().optional(),
+        mapHash: z.string().nullable().optional(),
         vetos: z
           .array(
             z.object({
@@ -613,6 +614,7 @@ export const Schema = {
         qualified: z.boolean().nullable().optional(),
         qualifiedAt: z.string().nullable().optional(),
         videoUrl: z.string().nullable(),
+        mapHash: z.string().nullable().optional(),
         vetos: z
           .array(
             z.object({
@@ -636,50 +638,51 @@ export const getBeatmapPageById = handleApi({url:"/api/getBeatmapPageById",...Ge
 // ./api/getBeatmaps.ts API
 
 /*
-export const Schema = {
-  input: z.strictObject({
-    session: z.string(),
-    textFilter: z.string().optional(),
-    authorFilter: z.string().optional(),
-    tagsFilter: z.string().optional(),
-    page: z.number().default(1),
-    maxStars: z.number().optional(),
-    minLength: z.number().optional(),
-    maxLength: z.number().optional(),
-    minStars: z.number().optional(),
-    creator: z.number().optional(),
-    status: z.string().optional(),
-  }),
-  output: z.object({
-    error: z.string().optional(),
-    total: z.number(),
-    viewPerPage: z.number(),
-    currentPage: z.number(),
-    beatmaps: z
-      .array(
-        z.object({
-          id: z.number(),
-          playcount: z.number().nullable().optional(),
-          created_at: z.string().nullable().optional(),
-          difficulty: z.number().nullable().optional(),
-          noteCount: z.number().nullable().optional(),
-          length: z.number().nullable().optional(),
-          title: z.string().nullable().optional(),
-          ranked: z.boolean().nullable().optional(),
-          beatmapFile: z.string().nullable().optional(),
-          image: z.string().nullable().optional(),
-          starRating: z.number().nullable().optional(),
-          owner: z.number().nullable().optional(),
-          ownerUsername: z.string().nullable().optional(),
-          ownerAvatar: z.string().nullable().optional(),
-          status: z.string().nullable().optional(),
-          qualified: z.boolean().nullable().optional(),
-          tags: z.string().nullable().optional(),
-          videoUrl: z.string().nullable().optional(),
-        })
-      )
-      .optional(),
-  }),
+export const Schema = {
+  input: z.strictObject({
+    session: z.string(),
+    textFilter: z.string().optional(),
+    authorFilter: z.string().optional(),
+    tagsFilter: z.string().optional(),
+    page: z.number().default(1),
+    maxStars: z.number().optional(),
+    minLength: z.number().optional(),
+    maxLength: z.number().optional(),
+    minStars: z.number().optional(),
+    creator: z.number().optional(),
+    status: z.string().optional(),
+  }),
+  output: z.object({
+    error: z.string().optional(),
+    total: z.number(),
+    viewPerPage: z.number(),
+    currentPage: z.number(),
+    beatmaps: z
+      .array(
+        z.object({
+          id: z.number(),
+          playcount: z.number().nullable().optional(),
+          created_at: z.string().nullable().optional(),
+          difficulty: z.number().nullable().optional(),
+          noteCount: z.number().nullable().optional(),
+          length: z.number().nullable().optional(),
+          title: z.string().nullable().optional(),
+          ranked: z.boolean().nullable().optional(),
+          beatmapFile: z.string().nullable().optional(),
+          image: z.string().nullable().optional(),
+          starRating: z.number().nullable().optional(),
+          owner: z.number().nullable().optional(),
+          ownerUsername: z.string().nullable().optional(),
+          ownerAvatar: z.string().nullable().optional(),
+          status: z.string().nullable().optional(),
+          qualified: z.boolean().nullable().optional(),
+          tags: z.string().nullable().optional(),
+          videoUrl: z.string().nullable().optional(),
+          mapHash: z.string().nullable().optional(),
+        })
+      )
+      .optional(),
+  }),
 };*/
 import { Schema as GetBeatmaps } from "./api/getBeatmaps"
 export { Schema as SchemaGetBeatmaps } from "./api/getBeatmaps"
@@ -783,19 +786,22 @@ export const Schema = {
   input: z.strictObject({
     session: z.string(),
     collection: z.number(),
+    page: z.number().optional().default(1),
+    itemsPerPage: z.number().optional().default(30),
   }),
   output: z.object({
-    collection: z.object({
-      title: z.string(),
-      description: z.string(),
-      owner: z.object({
-        id: z.number(),
-        username: z.string(),
-        avatar_url: z.string().nullable(),
-      }),
-      isList: z.boolean(),
-      beatmaps: z.array(
-        z.object({
+    collection: z.object({
+      title: z.string(),
+      description: z.string(),
+      owner: z.object({
+        id: z.number(),
+        username: z.string(),
+        avatar_url: z.string().nullable(),
+      }),
+      isList: z.boolean(),
+      beatmapCount: z.number(),
+      beatmaps: z.array(
+        z.object({
           id: z.number(),
           playcount: z.number().nullable().optional(),
           created_at: z.string().nullable().optional(),
@@ -813,6 +819,7 @@ export const Schema = {
         })
       ),
     }),
+    totalPages: z.number(),
     error: z.string().optional(),
   }),
 };*/
@@ -939,19 +946,19 @@ export const getLeaderboard = handleApi({url:"/api/getLeaderboard",...GetLeaderb
 // ./api/getMapUploadUrl.ts API
 
 /*
-export const Schema = {
-  input: z.strictObject({
-    mapName: z.string().optional(),
-    session: z.string(),
-    contentLength: z.number(),
-    contentType: z.string(),
-    intrinsicToken: z.string(),
-  }),
-  output: z.strictObject({
-    error: z.string().optional(),
-    url: z.string().optional(),
-    objectKey: z.string().optional(),
-  }),
+export const Schema = {
+  input: z.strictObject({
+    mapName: z.string().optional(),
+    session: z.string(),
+    contentLength: z.number(),
+    contentType: z.string(),
+    intrinsicToken: z.string(),
+  }),
+  output: z.strictObject({
+    error: z.string().optional(),
+    url: z.string().optional(),
+    objectKey: z.string().optional(),
+  }),
 };*/
 import { Schema as GetMapUploadUrl } from "./api/getMapUploadUrl"
 export { Schema as SchemaGetMapUploadUrl } from "./api/getMapUploadUrl"
@@ -1161,6 +1168,7 @@ export const Schema = {
         username: z.string().optional().nullable(),
         speed: z.number().optional().nullable(),
         spin: z.boolean().optional().nullable(),
+        replay_url: z.string().optional().nullable(),
       })
       .optional(),
   }),
@@ -1321,18 +1329,18 @@ export const getVerified = handleApi({url:"/api/getVerified",...GetVerified})
 // ./api/getVideoUploadUrl.ts API
 
 /*
-export const Schema = {
-  input: z.strictObject({
-    session: z.string(),
-    contentLength: z.number(),
-    contentType: z.string(),
-    intrinsicToken: z.string(),
-  }),
-  output: z.strictObject({
-    error: z.string().optional(),
-    url: z.string().optional(),
-    objectKey: z.string().optional(),
-  }),
+export const Schema = {
+  input: z.strictObject({
+    session: z.string(),
+    contentLength: z.number(),
+    contentType: z.string(),
+    intrinsicToken: z.string(),
+  }),
+  output: z.strictObject({
+    error: z.string().optional(),
+    url: z.string().optional(),
+    objectKey: z.string().optional(),
+  }),
 };*/
 import { Schema as GetVideoUploadUrl } from "./api/getVideoUploadUrl"
 export { Schema as SchemaGetVideoUploadUrl } from "./api/getVideoUploadUrl"
@@ -1479,26 +1487,27 @@ export const submitScore = handleApi({url:"/api/submitScore",...SubmitScore})
 // ./api/submitScoreInternal.ts API
 
 /*
-export const Schema = {
-  input: z.strictObject({
-    session: z.string(),
-    secret: z.string(),
-    token: z.string(),
-    data: z.strictObject({
-      onlineMapId: z.number(),
-      misses: z.number(),
-      hits: z.number(),
-      speed: z.number(),
-      mods: z.array(z.string()),
-      spin: z.boolean(),
-      replayBytes: z.string().nullable().optional(),
-      pauses: z.number().nullable().optional(),
-      failTime: z.number().nullable().optional(),
-    }),
-  }),
-  output: z.object({
-    error: z.string().optional(),
-  }),
+export const Schema = {
+  input: z.strictObject({
+    session: z.string(),
+    secret: z.string(),
+    token: z.string(),
+    data: z.strictObject({
+      beatmapHash: z.string().optional().nullable(),
+      onlineMapId: z.number(),
+      misses: z.number(),
+      hits: z.number(),
+      speed: z.number(),
+      mods: z.array(z.string()),
+      spin: z.boolean(),
+      replayBytes: z.string().nullable().optional(),
+      pauses: z.number().nullable().optional(),
+      failTime: z.number().nullable().optional(),
+    }),
+  }),
+  output: z.object({
+    error: z.string().optional(),
+  }),
 };*/
 import { Schema as SubmitScoreInternal } from "./api/submitScoreInternal"
 export { Schema as SchemaSubmitScoreInternal } from "./api/submitScoreInternal"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhythia-api",
-  "version": "242.0.0",
+  "version": "243.0.0",
   "main": "index.ts",
   "author": "online-contributors-cunev",
   "scripts": {
@@ -10,6 +10,8 @@
     "test": "tsx ./scripts/test.ts",
     "cache:clear-user-scores": "bun run scripts/clear-user-score-cache.ts",
     "db:optimize-user-scores": "bun run scripts/optimize-user-scores-indexes.ts",
+    "db:add-beatmap-page-map-hash": "node --experimental-transform-types scripts/add-beatmap-page-map-hash.ts",
+    "db:backfill-beatmap-page-map-hashes": "node --experimental-transform-types scripts/backfill-beatmap-page-map-hashes.ts",
     "db:create-profile-flags": "node scripts/create-profile-flags-table.ts",
     "db:create-profile-friends": "node scripts/create-profile-friends-table.ts",
     "db:create-profile-reports": "node scripts/create-profile-reports-table.ts",
@@ -28,7 +30,7 @@
     "@supabase/supabase-js": "^2.45.1",
     "@types/bun": "^1.1.6",
     "@types/lodash": "^4.17.7",
-    "@types/node": "^22.2.0",
+    "@types/node": "^25.6.0",
     "@types/pg": "^8.15.5",
     "@types/validator": "^13.12.2",
     "bad-words": "^4.0.0",

package/queries/admin_delete_user.sql

@@ -1,39 +1,42 @@
-CREATE OR REPLACE FUNCTION public.admin_delete_user(user_id integer)
- RETURNS boolean
- LANGUAGE plpgsql
- SECURITY DEFINER
-AS $function$
-DECLARE
-  success BOOLEAN;
-BEGIN
-  -- Delete scores first due to foreign key constraints
-  DELETE FROM public.scores WHERE "userId" = user_id;
-  
-  -- Delete beatmapPageComments
-  DELETE FROM public."beatmapPageComments" WHERE owner = user_id;
-  
-  -- Delete beatmapPages owned by user
-  DELETE FROM public."beatmapPages" WHERE owner = user_id;
-  
-  -- Delete collections owned by user
-  DELETE FROM public."beatmapCollections" WHERE owner = user_id;
-  
-  -- Delete collection relations related to user's collections
-  -- (this is handled by cascade if you have it set up)
-  
-  -- Delete passkeys
-  DELETE FROM public.passkeys WHERE id = user_id;
-  
-  -- Delete profile activity
-  DELETE FROM public."profileActivities" 
-  WHERE uid = (SELECT uid FROM public.profiles WHERE id = user_id);
-  
-  -- Finally, delete the profile
-  DELETE FROM public.profiles WHERE id = user_id;
-  
-  -- Check if deletion was successful
-  success := NOT EXISTS (SELECT 1 FROM public.profiles WHERE id = user_id);
-  
-  RETURN success;
-END;
-$function$
+CREATE OR REPLACE FUNCTION public.admin_delete_user(user_id integer)
+ RETURNS boolean
+ LANGUAGE plpgsql
+ SECURITY DEFINER
+AS $function$
+DECLARE
+  success BOOLEAN;
+BEGIN
+  -- Delete scores first due to foreign key constraints
+  DELETE FROM public.scores WHERE "userId" = user_id;
+  
+  -- Delete beatmapPageComments
+  DELETE FROM public."beatmapPageComments" WHERE owner = user_id;
+  
+  -- Delete beatmapPages owned by user
+  DELETE FROM public."beatmapPages" WHERE owner = user_id;
+  
+  -- Delete collections owned by user
+  DELETE FROM public."beatmapCollections" WHERE owner = user_id;
+  
+  -- Delete collection relations related to user's collections
+  -- (this is handled by cascade if you have it set up)
+  
+  -- Delete passkeys
+  DELETE FROM public.passkeys WHERE id = user_id;
+  
+  -- Delete user HWID records
+  DELETE FROM public.user_hwids WHERE id = user_id;
+
+  -- Delete profile activity
+  DELETE FROM public."profileActivities" 
+  WHERE uid = (SELECT uid FROM public.profiles WHERE id = user_id);
+  
+  -- Finally, delete the profile
+  DELETE FROM public.profiles WHERE id = user_id;
+  
+  -- Check if deletion was successful
+  success := NOT EXISTS (SELECT 1 FROM public.profiles WHERE id = user_id);
+  
+  RETURN success;
+END;
+$function$

package/queries/admin_remove_all_scores.sql

@@ -5,9 +5,12 @@ CREATE OR REPLACE FUNCTION public.admin_remove_all_scores(user_id integer)
 AS $function$
 DECLARE
   deleted_count INTEGER;
-BEGIN
-  -- Delete all scores for this user and count them
-  WITH deleted AS (
+BEGIN
+  DELETE FROM public.leaderboard_map_user
+  WHERE "userId" = user_id;
+
+  -- Delete all scores for this user and count them
+  WITH deleted AS (
     DELETE FROM public.scores
     WHERE "userId" = user_id
     RETURNING *

package/queries/admin_remove_score.sql

@@ -0,0 +1,107 @@
+CREATE OR REPLACE FUNCTION public.admin_remove_score(user_id integer, score_id bigint)
+ RETURNS boolean
+ LANGUAGE plpgsql
+ SECURITY DEFINER
+AS $function$
+DECLARE
+  removed_score public.scores%ROWTYPE;
+  best_score RECORD;
+  total_sp numeric;
+  spin_total_sp numeric;
+BEGIN
+  DELETE FROM public.scores
+  WHERE id = score_id
+    AND "userId" = user_id
+  RETURNING * INTO removed_score;
+
+  IF removed_score.id IS NULL THEN
+    RETURN false;
+  END IF;
+
+  SELECT id, awarded_sp
+    INTO best_score
+  FROM public.scores
+  WHERE "userId" = user_id
+    AND "beatmapHash" = removed_score."beatmapHash"
+    AND passed = true
+  ORDER BY awarded_sp DESC NULLS LAST
+  LIMIT 1;
+
+  IF best_score.id IS NULL THEN
+    DELETE FROM public.leaderboard_map_user
+    WHERE "userId" = user_id
+      AND "beatmapHash" = removed_score."beatmapHash";
+  ELSE
+    INSERT INTO public.leaderboard_map_user (
+      "beatmapHash",
+      "userId",
+      best_score_id,
+      best_sp
+    )
+    VALUES (
+      removed_score."beatmapHash",
+      user_id,
+      best_score.id,
+      best_score.awarded_sp
+    )
+    ON CONFLICT ("beatmapHash", "userId")
+    DO UPDATE SET
+      best_score_id = excluded.best_score_id,
+      best_sp = excluded.best_sp;
+  END IF;
+
+  WITH best_scores AS (
+    SELECT DISTINCT ON ("beatmapHash")
+      "beatmapHash",
+      awarded_sp
+    FROM public.scores
+    WHERE "userId" = user_id
+      AND passed = true
+      AND awarded_sp <> 0
+    ORDER BY "beatmapHash", awarded_sp DESC
+  ),
+  weighted AS (
+    SELECT
+      awarded_sp,
+      power(0.97, row_number() over (ORDER BY awarded_sp DESC) - 1) AS weight
+    FROM best_scores
+  )
+  SELECT COALESCE(round(sum(awarded_sp * weight) FILTER (WHERE weight >= 0.05), 2), 0)
+    INTO total_sp
+  FROM weighted;
+
+  WITH best_scores AS (
+    SELECT DISTINCT ON ("beatmapHash")
+      "beatmapHash",
+      awarded_sp
+    FROM public.scores
+    WHERE "userId" = user_id
+      AND passed = true
+      AND spin = true
+      AND awarded_sp <> 0
+    ORDER BY "beatmapHash", awarded_sp DESC
+  ),
+  weighted AS (
+    SELECT
+      awarded_sp,
+      power(0.97, row_number() over (ORDER BY awarded_sp DESC) - 1) AS weight
+    FROM best_scores
+  )
+  SELECT COALESCE(round(sum(awarded_sp * weight) FILTER (WHERE weight >= 0.05), 2), 0)
+    INTO spin_total_sp
+  FROM weighted;
+
+  UPDATE public.profiles
+  SET
+    play_count = (
+      SELECT count(*)
+      FROM public.scores
+      WHERE "userId" = user_id
+    ),
+    skill_points = total_sp,
+    spin_skill_points = spin_total_sp
+  WHERE id = user_id;
+
+  RETURN true;
+END;
+$function$

package/queries/admin_update_profile.sql

@@ -0,0 +1,22 @@
+CREATE OR REPLACE FUNCTION public.admin_update_profile(user_id integer, profile_data jsonb)
+ RETURNS SETOF public.profiles
+ LANGUAGE plpgsql
+ SECURITY DEFINER
+AS $function$
+BEGIN
+  PERFORM set_config('app.bypass_profile_limits', 'on', true);
+
+  RETURN QUERY
+  UPDATE public.profiles
+  SET
+    username = CASE WHEN profile_data ? 'username' THEN profile_data->>'username' ELSE profiles.username END,
+    "computedUsername" = CASE WHEN profile_data ? 'username' THEN lower(profile_data->>'username') ELSE profiles."computedUsername" END,
+    avatar_url = CASE WHEN profile_data ? 'avatar_url' THEN profile_data->>'avatar_url' ELSE profiles.avatar_url END,
+    flag = CASE WHEN profile_data ? 'flag' THEN profile_data->>'flag' ELSE profiles.flag END,
+    profile_image = CASE WHEN profile_data ? 'profile_image' THEN profile_data->>'profile_image' ELSE profiles.profile_image END,
+    verified = CASE WHEN profile_data ? 'verified' THEN (profile_data->>'verified')::boolean ELSE profiles.verified END,
+    "verificationDeadline" = CASE WHEN profile_data ? 'verified' THEN 2524608000000 ELSE profiles."verificationDeadline" END
+  WHERE id = user_id
+  RETURNING profiles.*;
+END;
+$function$

package/queries/get_beatmaps_v2.sql

@@ -0,0 +1,48 @@
+DROP FUNCTION IF EXISTS public.get_beatmaps_v2(integer, integer, text, text, text, double precision, double precision, double precision, double precision, bigint, text);
+
+CREATE OR REPLACE FUNCTION public.get_beatmaps_v2(page_number integer DEFAULT 1, items_per_page integer DEFAULT 50, text_filter text DEFAULT NULL::text, author_filter text DEFAULT NULL::text, tags_filter text DEFAULT NULL::text, max_stars double precision DEFAULT NULL::double precision, min_length double precision DEFAULT NULL::double precision, max_length double precision DEFAULT NULL::double precision, min_stars double precision DEFAULT NULL::double precision, creator_filter bigint DEFAULT NULL::bigint, status_filter text DEFAULT NULL::text)
+ RETURNS TABLE(total_count bigint, owner bigint, created_at timestamp with time zone, id bigint, status text, qualified boolean, tags text, video_url text, map_hash text, playcount bigint, ranked boolean, beatmap_file text, image text, star_rating double precision, difficulty bigint, length double precision, title text, owner_username text)
+ LANGUAGE sql
+ STABLE
+AS $function$
+  SELECT
+    COUNT(*) OVER () AS total_count,
+    bp.owner::bigint,
+    bp.created_at,
+    bp.id::bigint,
+    bp.status,
+    bp.qualified,
+    bp.tags,
+    bp.video_url,
+    bp."mapHash",
+    b.playcount::bigint,
+    b.ranked,
+    b."beatmapFile",
+    b.image,
+    b."starRating"::double precision,
+    b.difficulty::bigint,
+    b.length::double precision,
+    b.title,
+    p.username
+  FROM public."beatmapPages" bp
+  INNER JOIN public.beatmaps b ON b."beatmapHash" = bp."latestBeatmapHash"
+  INNER JOIN public.profiles p ON p.id = bp.owner
+  WHERE (text_filter IS NULL OR b.title ILIKE '%' || text_filter || '%' OR p.username ILIKE '%' || text_filter || '%')
+    AND (author_filter IS NULL OR p.username ILIKE '%' || author_filter || '%')
+    AND (tags_filter IS NULL OR bp.tags ILIKE '%' || tags_filter || '%')
+    AND (min_stars IS NULL OR b."starRating" > min_stars)
+    AND (max_stars IS NULL OR b."starRating" < max_stars)
+    AND (min_length IS NULL OR b.length > min_length)
+    AND (max_length IS NULL OR b.length < max_length)
+    AND (creator_filter IS NULL OR bp.owner = creator_filter)
+    AND (
+      status_filter IS NULL
+      OR (UPPER(status_filter) = 'QUALIFIED' AND bp.qualified = true)
+      OR (UPPER(status_filter) <> 'QUALIFIED' AND bp.status = status_filter)
+    )
+  ORDER BY
+    CASE WHEN UPPER(status_filter) = 'RANKED' THEN bp.ranked_at END DESC NULLS LAST,
+    CASE WHEN UPPER(status_filter) = 'RANKED' THEN NULL ELSE bp.created_at END DESC NULLS LAST
+  LIMIT items_per_page
+  OFFSET ((page_number - 1) * items_per_page);
+$function$