All files twitch.ts

100% Statements 123/123
100% Branches 30/30
100% Functions 6/6
100% Lines 123/123

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 1241x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 14x 14x 14x 14x 1x 1x 25x 25x 25x 25x 25x 25x 25x 25x 25x 24x 24x 24x 23x 22x 21x 21x 20x 19x 24x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 25x 23x 25x 25x 25x 25x 25x 25x 25x 1x 1x 1x 1x 12x 12x 12x 12x 12x 12x 12x 12x 12x 9x 9x 7x 6x 5x 4x 3x 3x 2x 12x 8x 8x 8x 8x 12x 12x 1x 39x 39x 39x 39x 39x 39x 23x 23x 23x 23x 23x 39x 39x  
import { z } from "zod"
 
import { createOptionalUrl, nodeEnv } from "./shared"
 
const requiredText = z.string().trim().min(1)
const userId = z.string().regex(/^[1-9]\d*$/)
const privatePath = requiredText.refine(
  (value) => value.startsWith("/") || /^[a-z]:[\\/]/i.test(value),
  "An absolute private path is required."
)
 
export const twitchEventSubSecret = z.string().regex(/^[\x21-\x7e]{10,100}$/)
 
const credentials = z.object({
  NODE_ENV: nodeEnv,
  TWITCH_CLIENT_ID: requiredText,
  TWITCH_CLIENT_SECRET: requiredText,
  TWITCH_BOT_USER_ID: userId,
  TWITCH_BOT_GRANT_PATH: privatePath,
  TWITCH_HTTP_TIMEOUT_MS: z.coerce
    .number()
    .int()
    .min(1000)
    .max(30000)
    .default(10000),
})
 
export type TwitchCredentials = z.infer<typeof credentials>
 
export function resolveTwitchCredentials(
  env: Record<string, string | undefined> = process.env
): TwitchCredentials {
  return parseEnvironment(credentials, env)
}
 
export function resolveTwitchRuntimeEnv(
  env: Record<string, string | undefined> = process.env
) {
  const schema = credentials
    .extend({
      TWITCH_BOOTSTRAP_BROADCASTER_USER_ID: userId.optional(),
      TWITCH_EVENTSUB_CALLBACK_URL: createOptionalUrl({
        nodeEnv: () => env.NODE_ENV,
      }).pipe(
        z.string().refine((value) => {
          const url = new URL(value)
          return (
            url.protocol === "https:" &&
            (!url.port || url.port === "443") &&
            !url.username &&
            !url.password &&
            !url.search &&
            !url.hash &&
            url.pathname === "/eventsub"
          )
        }, "A public HTTPS /eventsub callback on port 443 is required.")
      ),
      TWITCH_EVENTSUB_SECRET: twitchEventSubSecret,
      TWITCH_WORKER_SECRET: requiredText,
      CONVEX_URL: createOptionalUrl({ nodeEnv: () => env.NODE_ENV }).pipe(
        z.string()
      ),
      TWITCH_WEBHOOK_PORT: z.coerce
        .number()
        .int()
        .min(1024)
        .max(65535)
        .default(8087),
      TWITCH_READINESS_PATH: privatePath,
    })
    .refine(
      (value) =>
        value.TWITCH_BOT_USER_ID !== value.TWITCH_BOOTSTRAP_BROADCASTER_USER_ID,
      {
        path: ["TWITCH_BOOTSTRAP_BROADCASTER_USER_ID"],
        message: "The dedicated bot must differ from the broadcaster.",
      }
    )
  return parseEnvironment(schema, env)
}
 
export type TwitchRuntimeEnv = ReturnType<typeof resolveTwitchRuntimeEnv>
 
export function resolveTwitchOperatorEnv(
  env: Record<string, string | undefined> = process.env
) {
  const value = resolveTwitchCredentials(env)
  const redirect = createOptionalUrl({ nodeEnv: () => env.NODE_ENV })
    .pipe(z.string())
    .safeParse(env.TWITCH_BOT_REDIRECT_URI)
  if (!redirect.success)
    throw new Error("Invalid Twitch environment: TWITCH_BOT_REDIRECT_URI")
  const url = new URL(redirect.data)
  if (
    url.protocol !== "http:" ||
    url.hostname !== "localhost" ||
    !url.port ||
    url.pathname !== "/callback" ||
    url.username ||
    url.password ||
    url.search ||
    url.hash
  ) {
    throw new Error(
      "TWITCH_BOT_REDIRECT_URI must be http://localhost:<port>/callback for the local operator utility."
    )
  }
  return { ...value, TWITCH_BOT_REDIRECT_URI: url.href }
}
 
function parseEnvironment<T>(
  schema: z.ZodType<T>,
  env: Record<string, string | undefined>
): T {
  const result = schema.safeParse(env)
  if (!result.success) {
    const keys = [
      ...new Set(result.error.issues.map((issue) => issue.path.join("."))),
    ].join(", ")
    throw new Error(`Invalid Twitch environment: ${keys}`)
  }
  return result.data
}