katanakit-js 4.0.4 → 5.2.0

package/dist/schemas/youtube.schema.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+/** Config for the YouTube service. One GCP project serves all repos. */
+export const YoutubeApiConfigSchema = z.object({
+    /** YouTube Data API v3 key (server/build-time only, never public). */
+    apiKey: z.string(),
+    /** Default channel id (`UC…`). Per-call params can override it. */
+    channelId: z.string(),
+});
+/** Params for `useGetChannelVideos`. */
+export const YoutubeListParamsSchema = z.object({
+    /** Channel id (defaults to the one from `useInitYoutube`). */
+    channelId: z.string().min(1).optional(),
+    /** Skip the channels lookup when the uploads playlist id is known. */
+    playlistId: z.string().min(1).optional(),
+    /** Items per page (1–50, defaults to `12`). */
+    maxResults: z.number().int().min(1).max(50).optional(),
+    /** Opaque page token from a previous response. */
+    pageToken: z.string().min(1).optional(),
+});
+/** Resolution-keyed thumbnails (all derivable without an API key). */
+export const YoutubeVideoThumbnailsSchema = z.object({
+    default: z.string().min(1),
+    medium: z.string().min(1),
+    high: z.string().min(1),
+});
+/** Normalized video, enriched with player-ready URLs. */
+export const YoutubeVideoNormalizedSchema = z.object({
+    id: z.string().min(1),
+    title: z.string(),
+    description: z.string(),
+    publishedAt: z.string(),
+    channelTitle: z.string().optional(),
+    thumbnails: YoutubeVideoThumbnailsSchema,
+    /** `hqdefault` shortcut for posters/facades. */
+    thumbnail: z.string().min(1),
+    /** Watch URL. */
+    url: z.string().min(1),
+    /** Privacy-enhanced (`youtube-nocookie`) embed URL. */
+    embedUrl: z.string().min(1),
+    /** From `videos.list` (`contentDetails.duration`), in seconds. */
+    durationSeconds: z.number().nonnegative().optional(),
+    /** From `videos.list` (`statistics.viewCount`). */
+    viewCount: z.number().nonnegative().optional(),
+});
+/** Paginated channel listing result. */
+export const YoutubeVideoPageSchema = z.object({
+    videos: z.array(YoutubeVideoNormalizedSchema),
+    nextPageToken: z.string().optional(),
+    prevPageToken: z.string().optional(),
+    totalResults: z.number().nonnegative().optional(),
+});
+/* -------------------------------------------------------------------------- */
+/* Raw API responses (runtime validation boundary)                            */
+/* -------------------------------------------------------------------------- */
+const optionalThumbnail = z.object({ url: z.string().optional() }).optional();
+/** Minimal `channels.list` shape (only what the service reads). */
+export const YoutubeChannelsResponseSchema = z.object({
+    items: z
+        .array(z.object({
+        contentDetails: z
+            .object({
+            relatedPlaylists: z.object({ uploads: z.string().optional() }).optional(),
+        })
+            .optional(),
+    }))
+        .optional(),
+});
+/** Minimal `playlistItems.list` shape (only what the service reads). */
+export const YoutubePlaylistItemsResponseSchema = z.object({
+    nextPageToken: z.string().optional(),
+    prevPageToken: z.string().optional(),
+    pageInfo: z.object({ totalResults: z.number().optional() }).optional(),
+    items: z
+        .array(z.object({
+        snippet: z
+            .object({
+            title: z.string().optional(),
+            description: z.string().optional(),
+            publishedAt: z.string().optional(),
+            channelTitle: z.string().optional(),
+            resourceId: z.object({ videoId: z.string().optional() }).optional(),
+            thumbnails: z
+                .object({
+                default: optionalThumbnail,
+                medium: optionalThumbnail,
+                high: optionalThumbnail,
+            })
+                .optional(),
+        })
+            .optional(),
+        contentDetails: z.object({ videoId: z.string().optional() }).optional(),
+    }))
+        .optional(),
+});
+/** Minimal `videos.list` shape (only what the service reads). */
+export const YoutubeVideosResponseSchema = z.object({
+    items: z
+        .array(z.object({
+        id: z.string().optional(),
+        snippet: z
+            .object({
+            title: z.string().optional(),
+            description: z.string().optional(),
+            publishedAt: z.string().optional(),
+            channelTitle: z.string().optional(),
+        })
+            .optional(),
+        contentDetails: z.object({ duration: z.string().optional() }).optional(),
+        statistics: z.object({ viewCount: z.string().optional() }).optional(),
+    }))
+        .optional(),
+});
+//# sourceMappingURL=youtube.schema.js.map

package/dist/schemas/youtube.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.schema.js","sourceRoot":"","sources":["../../src/schemas/youtube.schema.ts"],"names":[],"mappings":"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"}