feat(calendar): add merged media endpoint contract

Adds the `/calendars/:target/media/:start_date/:days` contract: the merged feed
of movies and episodes for the window, ordered by availability date, per target
(`my` / `all`). Optional `type` narrows to a single media type; the response
reuses the movie/episode union schema. Bumps the package to 0.4.23.

Author: vladjerca

projects/api/deno.json

@@ -1,7 +1,7 @@
 {
   "name": "@trakt/api",
   "exports": "./src/index.ts",
-  "version": "0.4.22",
+  "version": "0.4.23",
   "imports": {
     "@anatine/zod-openapi": "npm:@anatine/zod-openapi@^2.2.6",
     "@std/testing": "jsr:@std/testing@^1.0.5",

projects/api/src/contracts/calendars/index.ts

@@ -107,6 +107,25 @@ Returns DVD and physical media releases during the requested UTC date range. Use
       200: calendarMovieResponseSchema.array(),
     },
   },
+  media: {
+    summary: 'Get media',
+    description: `#### ✨ Extended Info 🎚 Filters
+Returns the merged feed of movies and episodes during the requested UTC date range, ordered by availability date. Use \`target\` to choose the authenticated user calendar (\`my\`) or the global calendar (\`all\`), and \`type\` to narrow to a single media type.`,
+    method: 'GET',
+    path: '/:target/media/:start_date/:days',
+    query: extendedMediaQuerySchema
+      .merge(mediaFilterParamsSchema)
+      .merge(z.object({
+        type: z.enum(['movie', 'show']).optional().openapi({
+          description:
+            'Narrow the feed to a single media type. Omit to return both.',
+        }),
+      })),
+    pathParams: calendarRequestParamsSchema,
+    responses: {
+      200: hotReleaseResponseSchema.array(),
+    },
+  },
   releasesHot: {
     summary: 'Get hot releases',
     description: `#### ✨ Extended Info 🎚 Filters