feat: implement default query helpers

Author: wheval

src/modules/creator/creator.controller.ts

@@ -12,21 +12,20 @@ import { parseCreatorSortOptions } from './creator.utils';
 import { safeIntParam } from '../../utils/query.utils';
 import { parsePublicQuery } from '../../utils/public-query-parse.utils';
 import {
-   DEFAULT_PAGE,
-   DEFAULT_PAGE_SIZE,
    MIN_PAGE_SIZE,
    MAX_PAGE_SIZE,
 } from '../../constants/pagination.constants';
+import { PUBLIC_PAGE_PAGINATION_DEFAULTS } from '../../utils/public-list-query-defaults';
 
 const LegacyCreatorQuerySchema = z.object({
    page: safeIntParam({
-      defaultValue: DEFAULT_PAGE,
+      defaultValue: PUBLIC_PAGE_PAGINATION_DEFAULTS.page,
       min: MIN_PAGE_SIZE,
       max: Number.MAX_SAFE_INTEGER,
       label: 'Page',
    }),
    limit: safeIntParam({
-      defaultValue: DEFAULT_PAGE_SIZE,
+      defaultValue: PUBLIC_PAGE_PAGINATION_DEFAULTS.limit,
       min: MIN_PAGE_SIZE,
       max: MAX_PAGE_SIZE,
       label: 'Limit',

src/modules/creators/creators.schemas.ts

@@ -5,11 +5,10 @@ import {
 } from './creators.sort';
 import { safeIntParam } from '../../utils/query.utils';
 import {
-   DEFAULT_PAGE_SIZE,
-   DEFAULT_OFFSET,
    MIN_PAGE_SIZE,
    MAX_PAGE_SIZE,
 } from '../../constants/pagination.constants';
+import { PUBLIC_OFFSET_PAGINATION_DEFAULTS } from '../../utils/public-list-query-defaults';
 
 /**
  * Validation schema for creator list query parameters.
@@ -23,13 +22,13 @@ import {
 export const CreatorListQuerySchema = z.object({
    // Pagination
    limit: safeIntParam({
-      defaultValue: DEFAULT_PAGE_SIZE,
+      defaultValue: PUBLIC_OFFSET_PAGINATION_DEFAULTS.limit,
       min: MIN_PAGE_SIZE,
       max: MAX_PAGE_SIZE,
       label: 'Limit',
    }),
    offset: safeIntParam({
-      defaultValue: DEFAULT_OFFSET,
+      defaultValue: PUBLIC_OFFSET_PAGINATION_DEFAULTS.offset,
       min: 0,
       max: Number.MAX_SAFE_INTEGER,
       label: 'Offset',

src/utils/public-list-query-defaults.ts

@@ -0,0 +1,23 @@
+import {
+   DEFAULT_OFFSET,
+   DEFAULT_PAGE,
+   DEFAULT_PAGE_SIZE,
+} from '../constants/pagination.constants';
+
+/**
+ * Shared default query values for offset-based public list endpoints.
+ * Keeps defaults centralized without introducing validation behavior.
+ */
+export const PUBLIC_OFFSET_PAGINATION_DEFAULTS = {
+   limit: DEFAULT_PAGE_SIZE,
+   offset: DEFAULT_OFFSET,
+} as const;
+
+/**
+ * Shared default query values for page-based public list endpoints.
+ * Keeps defaults centralized without introducing validation behavior.
+ */
+export const PUBLIC_PAGE_PAGINATION_DEFAULTS = {
+   page: DEFAULT_PAGE,
+   limit: DEFAULT_PAGE_SIZE,
+} as const;