feat(list): add support for creating new lists

Author: seferturan

projects/api/src/contracts/_internal/response/listPrivacyEnumSchema.ts

@@ -0,0 +1,8 @@
+import { asString, z } from '../z.ts';
+
+export const listPrivacyEnumSchema = asString(z.enum([
+  'private',
+  'public',
+  'friends',
+  'link',
+]));

projects/api/src/contracts/_internal/response/listResponseSchema.ts

@@ -1,15 +1,13 @@
 import { sortEnumSchema } from '../../users/_internal/request/sortParamsSchema.ts';
 import { asString, z } from '../z.ts';
+import { listPrivacyEnumSchema } from './listPrivacyEnumSchema.ts';
 import { profileResponseSchema } from './profileResponseSchema.ts';
 import { sortDirectionSchema } from './sortDirectionSchema.ts';
 
 export const listResponseSchema = z.object({
   name: z.string(),
   description: z.string().nullish(),
-  privacy: asString(z.enum([
-    'public',
-    'private',
-  ])),
+  privacy: listPrivacyEnumSchema,
   share_link: z.string(),
   type: asString(z.enum([
     'all',

projects/api/src/contracts/users/_internal/request/createListRequestSchema.ts

@@ -0,0 +1,14 @@
+import { listPrivacyEnumSchema } from '../../../_internal/response/listPrivacyEnumSchema.ts';
+import { sortDirectionSchema } from '../../../_internal/response/sortDirectionSchema.ts';
+import { z } from '../../../_internal/z.ts';
+import { sortEnumSchema } from './sortParamsSchema.ts';
+
+export const createListRequestSchema = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  privacy: listPrivacyEnumSchema.optional(),
+  display_numbers: z.boolean().optional(),
+  allow_comments: z.boolean().optional(),
+  sort_by: sortEnumSchema.optional(),
+  sort_how: sortDirectionSchema.optional(),
+});

projects/api/src/contracts/users/_internal/request/listUpdateRequestSchema.ts

@@ -1,9 +1,10 @@
+import { listPrivacyEnumSchema } from '../../../_internal/response/listPrivacyEnumSchema.ts';
 import { z } from '../../../_internal/z.ts';
 
 export const listUpdateRequestSchema = z.object({
   name: z.string().nullish(),
   description: z.string().nullish(),
-  privacy: z.enum(['private', 'link', 'friends', 'public']).nullish(),
+  privacy: listPrivacyEnumSchema.nullish(),
   display_numbers: z.boolean().nullish(),
   allow_comments: z.boolean().nullish(),
 });

projects/api/src/contracts/users/_internal/request/sortParamsSchema.ts

@@ -1,5 +1,6 @@
 import { asString, z } from '../../../_internal/z.ts';
 
+// FIXME: add vip-only sort options
 export const sortEnumSchema = asString(z.enum([
   'rank',
   'added',

projects/api/src/contracts/users/subroutes/userLists.ts

@@ -14,6 +14,7 @@ import { listedShowResponseSchema } from '../../_internal/response/listedShowRes
 import { listRemoveResponseSchema } from '../../_internal/response/listRemoveResponseSchema.ts';
 import { listResponseSchema } from '../../_internal/response/listResponseSchema.ts';
 import { z } from '../../_internal/z.ts';
+import { createListRequestSchema } from '../_internal/request/createListRequestSchema.ts';
 import { listCommentsSortParamsSchema } from '../_internal/request/listCommentsSortParamsSchema.ts';
 import { listParamsSchema } from '../_internal/request/listParamsSchema.ts';
 import { listUpdateRequestSchema } from '../_internal/request/listUpdateRequestSchema.ts';
@@ -172,6 +173,14 @@ export const userLists = builder.router({
       200: reorderListsResponseSchema,
     },
   },
+  create: {
+    path: '',
+    method: 'POST',
+    body: createListRequestSchema,
+    responses: {
+      201: listResponseSchema,
+    },
+  },
   list,
 }, {
   pathPrefix: '/:id/lists',
@@ -188,3 +197,5 @@ export type ListCommentsSortParams = z.infer<
 >;
 export type ListRequest = z.infer<typeof listRequestSchema>;
 export type ListUpdateRequest = z.infer<typeof listUpdateRequestSchema>;
+
+export type CreateListRequest = z.infer<typeof createListRequestSchema>;