import { createAuthenticatedFetch, credential, kody } from 'kody:runtime' /** * Declared X OAuth integration slots (see package.json#kody.credentials). * Add a case + credential slot together when connecting another account. */ export const DECLARED_X_INTEGRATIONS = ['x', 'x-kodykoala'] as const export type DeclaredXIntegration = (typeof DECLARED_X_INTEGRATIONS)[number] export function normalizeIntegrationName(name: string): string { return name.trim().toLowerCase() } export function assertDeclaredXIntegration(name: string): DeclaredXIntegration { const normalized = normalizeIntegrationName(name) if (normalized === 'x' || normalized === 'x-kodykoala') { return normalized } throw new Error( `Undeclared X OAuth integration "${name}". Connect it and add a literal case in src/auth.ts plus a kody.credentials oauth slot (currently: ${DECLARED_X_INTEGRATIONS.join(', ')}).`, ) } /** createAuthenticatedFetch with a stampable literal name per declared account. */ export async function authenticatedFetchFor(integrationName: string) { const name = assertDeclaredXIntegration(integrationName) switch (name) { case 'x': return createAuthenticatedFetch('x') case 'x-kodykoala': return createAuthenticatedFetch('x-kodykoala') default: { const _exhaustive: never = name throw new Error(`Unhandled X integration: ${String(_exhaustive)}`) } } } let lastCredentialFetchError: string | null = null /** Why the credential() client could not be opened (diagnostics only; never secret values). */ export function getLastCredentialFetchError(): string | null { return lastCredentialFetchError } function clientFetch(client: unknown): typeof fetch | null { return client && typeof (client as { fetch?: unknown }).fetch === 'function' ? (client as { fetch: typeof fetch }).fetch : null } async function openCredentialFetch(name: DeclaredXIntegration): Promise { const errors: string[] = [] // Literal need keys only (stamped packages). Under `kody execute --local` from a // checkout pass `--credential x=x` so the key is not ambiguous. try { const viaKey = clientFetch( name === 'x-kodykoala' ? await credential('x-kodykoala') : await credential('x'), ) if (viaKey) return viaKey } catch (error) { errors.push(String((error as Error)?.message ?? error)) } lastCredentialFetchError = errors.join(' | ').slice(0, 500) || 'credential client has no fetch' return null } /** Credential-bound fetch for media. CLI >=3.33.1 streams binary bodies at every size. * Ambiguous/unavailable credentials fail closed; never select another auth path implicitly. */ const binaryFetchCache = new Map>() export async function binaryFetchFor(integrationName: string): Promise { const name = assertDeclaredXIntegration(integrationName) let cached = binaryFetchCache.get(name) if (!cached) { cached = (async () => { const client = await openCredentialFetch(name) if (!client) throw new Error('Explicit X credential mapping required for ' + name) return client })() binaryFetchCache.set(name, cached) cached.catch(() => binaryFetchCache.delete(name)) } return cached } /** integrationTokenRefresh with a stampable literal name per declared account. */ export async function refreshIntegrationToken(integrationName: string) { const name = assertDeclaredXIntegration(integrationName) switch (name) { case 'x': return kody.integrationTokenRefresh({ name: 'x' }) case 'x-kodykoala': return kody.integrationTokenRefresh({ name: 'x-kodykoala' }) default: { const _exhaustive: never = name throw new Error(`Unhandled X integration: ${String(_exhaustive)}`) } } }