@opentabs-dev/opentabs-plugin-twitch 0.0.74

package/dist/tools/get-user-clips.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const getUserClips: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    login: z.ZodString;
+    period: z.ZodOptional<z.ZodEnum<{
+        LAST_DAY: "LAST_DAY";
+        LAST_WEEK: "LAST_WEEK";
+        LAST_MONTH: "LAST_MONTH";
+        ALL_TIME: "ALL_TIME";
+    }>>;
+    first: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    clips: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        viewCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        thumbnailURL: z.ZodString;
+        durationSeconds: z.ZodNumber;
+        broadcaster: z.ZodObject<{
+            id: z.ZodString;
+            login: z.ZodString;
+            displayName: z.ZodString;
+        }, z.core.$strip>;
+        game: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-user-clips.d.ts.map

package/dist/tools/get-user-clips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-clips.d.ts","sourceRoot":"","sources":["../../src/tools/get-user-clips.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwCvB,CAAC"}

package/dist/tools/get-user-clips.js

@@ -0,0 +1,44 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { gql } from '../twitch-api.js';
+import { clipSchema, mapClip } from './schemas.js';
+export const getUserClips = defineTool({
+    name: 'get_user_clips',
+    displayName: 'Get User Clips',
+    description: 'Get clips from a Twitch channel sorted by view count. Provide the broadcaster login name and optionally filter by time period.',
+    summary: 'Get clips from a Twitch channel',
+    icon: 'clapperboard',
+    group: 'Clips',
+    input: z.object({
+        login: z.string().describe('Broadcaster login name (e.g., "shroud")'),
+        period: z
+            .enum(['LAST_DAY', 'LAST_WEEK', 'LAST_MONTH', 'ALL_TIME'])
+            .optional()
+            .describe('Time period filter (default ALL_TIME)'),
+        first: z.number().int().min(1).max(25).optional().describe('Number of clips to return (default 10, max 25)'),
+    }),
+    output: z.object({ clips: z.array(clipSchema) }),
+    handle: async (params) => {
+        const first = params.first ?? 10;
+        const period = params.period ?? 'ALL_TIME';
+        const data = await gql(`{
+      user(login: "${params.login}") {
+        clips(first: ${first}, criteria: { period: ${period} }) {
+          edges {
+            node {
+              id slug title viewCount createdAt thumbnailURL durationSeconds
+              broadcaster { id login displayName }
+              game { id name }
+            }
+          }
+        }
+      }
+    }`);
+        if (!data.user)
+            throw ToolError.notFound(`User "${params.login}" not found`);
+        return {
+            clips: (data.user.clips?.edges ?? []).map(e => mapClip(e.node)),
+        };
+    },
+});
+//# sourceMappingURL=get-user-clips.js.map

package/dist/tools/get-user-clips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-clips.js","sourceRoot":"","sources":["../../src/tools/get-user-clips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EACT,gIAAgI;IAClI,OAAO,EAAE,iCAAiC;IAC1C,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACrE,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;aACzD,QAAQ,EAAE;aACV,QAAQ,CAAC,uCAAuC,CAAC;QACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KAC7G,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;IAChD,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,GAAG,CAEnB;qBACc,MAAM,CAAC,KAAK;uBACV,KAAK,yBAAyB,MAAM;;;;;;;;;;MAUrD,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,SAAS,MAAM,CAAC,KAAK,aAAa,CAAC,CAAC;QAC7E,OAAO;YACL,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAChE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-user-profile.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const getUserProfile: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    login: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+        login: z.ZodString;
+        displayName: z.ZodString;
+        profileImageURL: z.ZodString;
+        description: z.ZodString;
+        createdAt: z.ZodString;
+        hasPrime: z.ZodBoolean;
+        roles: z.ZodObject<{
+            isPartner: z.ZodBoolean;
+            isAffiliate: z.ZodBoolean;
+        }, z.core.$strip>;
+        followerCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-user-profile.d.ts.map

package/dist/tools/get-user-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-profile.d.ts","sourceRoot":"","sources":["../../src/tools/get-user-profile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;kBAyBzB,CAAC"}

package/dist/tools/get-user-profile.js

@@ -0,0 +1,31 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { gql } from '../twitch-api.js';
+import { userSchema, mapUser } from './schemas.js';
+export const getUserProfile = defineTool({
+    name: 'get_user_profile',
+    displayName: 'Get User Profile',
+    description: 'Get a Twitch user profile by their login name. Returns display name, bio, follower count, partner/affiliate status, profile image, and account creation date.',
+    summary: 'Get a Twitch user profile by login name',
+    icon: 'user',
+    group: 'Users',
+    input: z.object({
+        login: z.string().describe('Twitch login name (e.g., "shroud", "ninja")'),
+    }),
+    output: z.object({ user: userSchema }),
+    handle: async (params) => {
+        const data = await gql(`{
+      user(login: "${params.login.replace(/"/g, '\\"')}") {
+        id login displayName description
+        profileImageURL(width: 300)
+        createdAt
+        roles { isPartner isAffiliate }
+        followers { totalCount }
+      }
+    }`);
+        if (!data.user)
+            throw ToolError.notFound(`User "${params.login}" not found`);
+        return { user: mapUser(data.user) };
+    },
+});
+//# sourceMappingURL=get-user-profile.js.map

package/dist/tools/get-user-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-profile.js","sourceRoot":"","sources":["../../src/tools/get-user-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EACT,+JAA+J;IACjK,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KAC1E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACtC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,GAAG,CAA2B;qBAChC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;;;;;;;MAOhD,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,SAAS,MAAM,CAAC,KAAK,aAAa,CAAC,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-user-videos.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export declare const getUserVideos: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    login: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        ARCHIVE: "ARCHIVE";
+        HIGHLIGHT: "HIGHLIGHT";
+        UPLOAD: "UPLOAD";
+        PAST_PREMIERE: "PAST_PREMIERE";
+    }>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        TIME: "TIME";
+        VIEWS: "VIEWS";
+    }>>;
+    first: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    videos: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        viewCount: z.ZodNumber;
+        publishedAt: z.ZodString;
+        lengthSeconds: z.ZodNumber;
+        game: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        thumbnailURL: z.ZodString;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-user-videos.d.ts.map

package/dist/tools/get-user-videos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-videos.d.ts","sourceRoot":"","sources":["../../src/tools/get-user-videos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyDxB,CAAC"}

package/dist/tools/get-user-videos.js

@@ -0,0 +1,58 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { gql } from '../twitch-api.js';
+import { videoSchema, mapVideo } from './schemas.js';
+export const getUserVideos = defineTool({
+    name: 'get_user_videos',
+    displayName: 'Get User Videos',
+    description: 'Get videos (VODs, highlights, uploads) from a Twitch channel. Optionally filter by video type and sort order.',
+    summary: 'Get videos from a Twitch channel',
+    icon: 'video',
+    group: 'Videos',
+    input: z.object({
+        login: z.string().describe('Broadcaster login name (e.g., "shroud")'),
+        type: z
+            .enum(['ARCHIVE', 'HIGHLIGHT', 'UPLOAD', 'PAST_PREMIERE'])
+            .optional()
+            .describe('Video type filter (default: all types)'),
+        sort: z.enum(['TIME', 'VIEWS']).optional().describe('Sort order (default TIME — most recent first)'),
+        first: z.number().int().min(1).max(25).optional().describe('Number of videos to return (default 10, max 25)'),
+    }),
+    output: z.object({
+        videos: z.array(videoSchema),
+        totalCount: z.number().describe('Total number of videos available'),
+    }),
+    handle: async (params) => {
+        const first = params.first ?? 10;
+        const sort = params.sort ?? 'TIME';
+        const typeArg = params.type ? `, type: ${params.type}` : '';
+        const data = await gql(`{
+      user(login: "${params.login}") {
+        videos(first: ${first}, sort: ${sort}${typeArg}) {
+          totalCount
+          edges {
+            node {
+              id title viewCount publishedAt lengthSeconds
+              game { id name }
+              thumbnailURLs(width: 320, height: 180)
+            }
+          }
+        }
+      }
+    }`);
+        if (!data.user)
+            throw ToolError.notFound(`User "${params.login}" not found`);
+        const edges = data.user.videos?.edges ?? [];
+        return {
+            videos: edges.map(e => {
+                const node = e.node;
+                return mapVideo({
+                    ...node,
+                    thumbnailURL: node.thumbnailURLs?.[0] ?? '',
+                });
+            }),
+            totalCount: data.user.videos?.totalCount ?? 0,
+        };
+    },
+});
+//# sourceMappingURL=get-user-videos.js.map

package/dist/tools/get-user-videos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-videos.js","sourceRoot":"","sources":["../../src/tools/get-user-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EACT,+GAA+G;IACjH,OAAO,EAAE,kCAAkC;IAC3C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACrE,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;aACzD,QAAQ,EAAE;aACV,QAAQ,CAAC,wCAAwC,CAAC;QACrD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QACpG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KAC9G,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;QAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KACpE,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,GAAG,CAEnB;qBACc,MAAM,CAAC,KAAK;wBACT,KAAK,WAAW,IAAI,GAAG,OAAO;;;;;;;;;;;MAWhD,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,SAAS,MAAM,CAAC,KAAK,aAAa,CAAC,CAAC;QAI7E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACpB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAoB,CAAC;gBACpC,OAAO,QAAQ,CAAC;oBACd,GAAG,IAAI;oBACP,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;iBAC5C,CAAC,CAAC;YACL,CAAC,CAAC;YACF,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-video.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const getVideo: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    video: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        viewCount: z.ZodNumber;
+        publishedAt: z.ZodString;
+        lengthSeconds: z.ZodNumber;
+        game: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        thumbnailURL: z.ZodString;
+        broadcaster: z.ZodObject<{
+            id: z.ZodString;
+            login: z.ZodString;
+            displayName: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-video.d.ts.map

package/dist/tools/get-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-video.d.ts","sourceRoot":"","sources":["../../src/tools/get-video.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;kBAgDnB,CAAC"}

package/dist/tools/get-video.js

@@ -0,0 +1,50 @@
+import { defineTool, ToolError } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { gql } from '../twitch-api.js';
+import { videoSchema, mapVideo } from './schemas.js';
+export const getVideo = defineTool({
+    name: 'get_video',
+    displayName: 'Get Video',
+    description: 'Get details about a specific Twitch video by its ID. Returns title, view count, duration, game, and broadcaster info.',
+    summary: 'Get details about a specific video',
+    icon: 'video',
+    group: 'Videos',
+    input: z.object({
+        id: z.string().describe('Video ID (e.g., "2717949378")'),
+    }),
+    output: z.object({
+        video: videoSchema.extend({
+            broadcaster: z
+                .object({
+                id: z.string().describe('Broadcaster user ID'),
+                login: z.string().describe('Broadcaster login name'),
+                displayName: z.string().describe('Broadcaster display name'),
+            })
+                .describe('Video broadcaster'),
+        }),
+    }),
+    handle: async (params) => {
+        const data = await gql(`{
+      video(id: "${params.id}") {
+        id title viewCount publishedAt lengthSeconds
+        game { id name }
+        thumbnailURLs(width: 320, height: 180)
+        owner { id login displayName }
+      }
+    }`);
+        if (!data.video)
+            throw ToolError.notFound(`Video "${params.id}" not found`);
+        const v = data.video;
+        return {
+            video: {
+                ...mapVideo({ ...v, thumbnailURL: v.thumbnailURLs?.[0] ?? '' }),
+                broadcaster: {
+                    id: v.owner?.id ?? '',
+                    login: v.owner?.login ?? '',
+                    displayName: v.owner?.displayName ?? '',
+                },
+            },
+        };
+    },
+});
+//# sourceMappingURL=get-video.js.map

package/dist/tools/get-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-video.js","sourceRoot":"","sources":["../../src/tools/get-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,WAAW;IACxB,WAAW,EACT,uHAAuH;IACzH,OAAO,EAAE,oCAAoC;IAC7C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KACzD,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,CAAC;iBACX,MAAM,CAAC;gBACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;aAC7D,CAAC;iBACD,QAAQ,CAAC,mBAAmB,CAAC;SACjC,CAAC;KACH,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QAKrB,MAAM,IAAI,GAAG,MAAM,GAAG,CAA4C;mBACnD,MAAM,CAAC,EAAE;;;;;;MAMtB,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,OAAO;YACL,KAAK,EAAE;gBACL,GAAG,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/D,WAAW,EAAE;oBACX,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE;oBACrB,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;oBAC3B,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE;iBACxC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+export declare const userSchema: z.ZodObject<{
+    id: z.ZodString;
+    login: z.ZodString;
+    displayName: z.ZodString;
+    profileImageURL: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    hasPrime: z.ZodBoolean;
+    roles: z.ZodObject<{
+        isPartner: z.ZodBoolean;
+        isAffiliate: z.ZodBoolean;
+    }, z.core.$strip>;
+    followerCount: z.ZodNumber;
+}, z.core.$strip>;
+export type User = z.infer<typeof userSchema>;
+export interface RawUser {
+    id?: string;
+    login?: string;
+    displayName?: string;
+    description?: string;
+    profileImageURL?: string;
+    createdAt?: string;
+    hasPrime?: boolean;
+    roles?: {
+        isPartner?: boolean;
+        isAffiliate?: boolean;
+    };
+    followers?: {
+        totalCount?: number;
+    };
+    followerCount?: number;
+}
+export declare function mapUser(raw: RawUser): User;
+export declare const streamSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    viewersCount: z.ZodNumber;
+    type: z.ZodString;
+    createdAt: z.ZodString;
+    broadcaster: z.ZodObject<{
+        id: z.ZodString;
+        login: z.ZodString;
+        displayName: z.ZodString;
+        profileImageURL: z.ZodString;
+    }, z.core.$strip>;
+    game: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Stream = z.infer<typeof streamSchema>;
+export interface RawStream {
+    id?: string;
+    title?: string;
+    viewersCount?: number;
+    type?: string;
+    createdAt?: string;
+    broadcaster?: {
+        id?: string;
+        login?: string;
+        displayName?: string;
+        profileImageURL?: string;
+    };
+    game?: {
+        id?: string;
+        name?: string;
+    };
+}
+export declare function mapStream(raw: RawStream): Stream;
+export declare const gameSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    displayName: z.ZodString;
+    viewersCount: z.ZodNumber;
+    broadcastersCount: z.ZodNumber;
+    boxArtURL: z.ZodString;
+}, z.core.$strip>;
+export type Game = z.infer<typeof gameSchema>;
+export interface RawGame {
+    id?: string;
+    name?: string;
+    displayName?: string;
+    viewersCount?: number;
+    broadcastersCount?: number;
+    boxArtURL?: string;
+}
+export declare function mapGame(raw: RawGame): Game;
+export declare const clipSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodString;
+    viewCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    thumbnailURL: z.ZodString;
+    durationSeconds: z.ZodNumber;
+    broadcaster: z.ZodObject<{
+        id: z.ZodString;
+        login: z.ZodString;
+        displayName: z.ZodString;
+    }, z.core.$strip>;
+    game: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Clip = z.infer<typeof clipSchema>;
+export interface RawClip {
+    id?: string;
+    slug?: string;
+    title?: string;
+    viewCount?: number;
+    createdAt?: string;
+    thumbnailURL?: string;
+    durationSeconds?: number;
+    broadcaster?: {
+        id?: string;
+        login?: string;
+        displayName?: string;
+    };
+    game?: {
+        id?: string;
+        name?: string;
+    };
+}
+export declare function mapClip(raw: RawClip): Clip;
+export declare const videoSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    viewCount: z.ZodNumber;
+    publishedAt: z.ZodString;
+    lengthSeconds: z.ZodNumber;
+    game: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    thumbnailURL: z.ZodString;
+}, z.core.$strip>;
+export type Video = z.infer<typeof videoSchema>;
+export interface RawVideo {
+    id?: string;
+    title?: string;
+    viewCount?: number;
+    publishedAt?: string;
+    lengthSeconds?: number;
+    game?: {
+        id?: string;
+        name?: string;
+    };
+    thumbnailURL?: string;
+}
+export declare function mapVideo(raw: RawVideo): Video;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

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

package/dist/tools/schemas.js

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Shared fragments
+// ---------------------------------------------------------------------------
+const userRefSchema = z.object({
+    id: z.string().describe('Twitch user ID'),
+    login: z.string().describe('Twitch login name (lowercase, URL-safe)'),
+    displayName: z.string().describe('User display name'),
+    profileImageURL: z.string().describe("URL of the user's profile image"),
+});
+const gameRefSchema = z.object({
+    id: z.string().describe('Game/category ID'),
+    name: z.string().describe('Game/category name'),
+});
+// ---------------------------------------------------------------------------
+// User
+// ---------------------------------------------------------------------------
+const userRolesSchema = z.object({
+    isPartner: z.boolean().describe('Whether the user is a Twitch Partner'),
+    isAffiliate: z.boolean().describe('Whether the user is a Twitch Affiliate'),
+});
+export const userSchema = userRefSchema.extend({
+    description: z.string().describe('User bio / channel description'),
+    createdAt: z.string().describe('ISO 8601 timestamp of account creation'),
+    hasPrime: z.boolean().describe('Whether the user has Twitch Prime'),
+    roles: userRolesSchema.describe('Partner and Affiliate status'),
+    followerCount: z.number().describe('Total number of followers'),
+});
+export function mapUser(raw) {
+    return {
+        id: raw.id ?? '',
+        login: raw.login ?? '',
+        displayName: raw.displayName ?? '',
+        description: raw.description ?? '',
+        profileImageURL: raw.profileImageURL ?? '',
+        createdAt: raw.createdAt ?? '',
+        hasPrime: raw.hasPrime ?? false,
+        roles: {
+            isPartner: raw.roles?.isPartner ?? false,
+            isAffiliate: raw.roles?.isAffiliate ?? false,
+        },
+        followerCount: raw.followers?.totalCount ?? raw.followerCount ?? 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Stream
+// ---------------------------------------------------------------------------
+export const streamSchema = z.object({
+    id: z.string().describe('Stream ID'),
+    title: z.string().describe('Stream title'),
+    viewersCount: z.number().describe('Current number of viewers'),
+    type: z.string().describe('Stream type (e.g. "live")'),
+    createdAt: z.string().describe('ISO 8601 timestamp when the stream started'),
+    broadcaster: userRefSchema.describe('Broadcaster info'),
+    game: gameRefSchema.describe('Game/category being streamed'),
+});
+export function mapStream(raw) {
+    return {
+        id: raw.id ?? '',
+        title: raw.title ?? '',
+        viewersCount: raw.viewersCount ?? 0,
+        type: raw.type ?? '',
+        createdAt: raw.createdAt ?? '',
+        broadcaster: {
+            id: raw.broadcaster?.id ?? '',
+            login: raw.broadcaster?.login ?? '',
+            displayName: raw.broadcaster?.displayName ?? '',
+            profileImageURL: raw.broadcaster?.profileImageURL ?? '',
+        },
+        game: {
+            id: raw.game?.id ?? '',
+            name: raw.game?.name ?? '',
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Game
+// ---------------------------------------------------------------------------
+export const gameSchema = gameRefSchema.extend({
+    displayName: z.string().describe('Localized display name for the game'),
+    viewersCount: z.number().describe('Total viewers across all streams'),
+    broadcastersCount: z.number().describe('Number of channels currently streaming this game'),
+    boxArtURL: z.string().describe('URL of the game box art image'),
+});
+export function mapGame(raw) {
+    return {
+        id: raw.id ?? '',
+        name: raw.name ?? '',
+        displayName: raw.displayName ?? raw.name ?? '',
+        viewersCount: raw.viewersCount ?? 0,
+        broadcastersCount: raw.broadcastersCount ?? 0,
+        boxArtURL: raw.boxArtURL ?? '',
+    };
+}
+// ---------------------------------------------------------------------------
+// Clip
+// ---------------------------------------------------------------------------
+const broadcasterRefSchema = z.object({
+    id: z.string().describe('Broadcaster user ID'),
+    login: z.string().describe('Broadcaster login name'),
+    displayName: z.string().describe('Broadcaster display name'),
+});
+export const clipSchema = z.object({
+    id: z.string().describe('Clip ID'),
+    slug: z.string().describe('URL-safe slug for the clip'),
+    title: z.string().describe('Clip title'),
+    viewCount: z.number().describe('Total number of views'),
+    createdAt: z.string().describe('ISO 8601 timestamp when the clip was created'),
+    thumbnailURL: z.string().describe('URL of the clip thumbnail image'),
+    durationSeconds: z.number().describe('Clip duration in seconds'),
+    broadcaster: broadcasterRefSchema.describe('Broadcaster who was clipped'),
+    game: gameRefSchema.describe('Game/category at the time of the clip'),
+});
+export function mapClip(raw) {
+    return {
+        id: raw.id ?? '',
+        slug: raw.slug ?? '',
+        title: raw.title ?? '',
+        viewCount: raw.viewCount ?? 0,
+        createdAt: raw.createdAt ?? '',
+        thumbnailURL: raw.thumbnailURL ?? '',
+        durationSeconds: raw.durationSeconds ?? 0,
+        broadcaster: {
+            id: raw.broadcaster?.id ?? '',
+            login: raw.broadcaster?.login ?? '',
+            displayName: raw.broadcaster?.displayName ?? '',
+        },
+        game: {
+            id: raw.game?.id ?? '',
+            name: raw.game?.name ?? '',
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Video
+// ---------------------------------------------------------------------------
+export const videoSchema = z.object({
+    id: z.string().describe('Video ID'),
+    title: z.string().describe('Video title'),
+    viewCount: z.number().describe('Total number of views'),
+    publishedAt: z.string().describe('ISO 8601 timestamp when the video was published'),
+    lengthSeconds: z.number().describe('Video duration in seconds'),
+    game: gameRefSchema.describe('Game/category associated with the video'),
+    thumbnailURL: z.string().describe('URL of the video thumbnail image'),
+});
+export function mapVideo(raw) {
+    return {
+        id: raw.id ?? '',
+        title: raw.title ?? '',
+        viewCount: raw.viewCount ?? 0,
+        publishedAt: raw.publishedAt ?? '',
+        lengthSeconds: raw.lengthSeconds ?? 0,
+        game: {
+            id: raw.game?.id ?? '',
+            name: raw.game?.name ?? '',
+        },
+        thumbnailURL: raw.thumbnailURL ?? '',
+    };
+}
+//# sourceMappingURL=schemas.js.map