import { figmaRequest } from './client.ts'
import { mapStyleList } from './models.ts'
import { parseFileKey } from './setup.ts'
import type { FigmaAuthInput, FigmaStyle } from './types.ts'
import { optionalString, requireRecord } from './types.ts'
import { requireAuthMode } from './auth.ts'
export type ListFileStylesInput = FigmaAuthInput & {
/** File key, or a figma.com file/design/board URL. */
fileKey: string
}
export type ListFileStylesResult = {
fileKey: string
items: Array<FigmaStyle>
}
/**
* List published styles in a Figma file. Needs `library_content:read`.
* @example
* import listFileStyles from 'kody:@kody/figma/list-file-styles'
* const { items } = await listFileStyles({ fileKey: 'abc123' })
*/
export async function listFileStyles(input: ListFileStylesInput): Promise<ListFileStylesResult> {
const fileKey = parseFileKey(input.fileKey)
const result = await figmaRequest<unknown>({
...input,
operation: 'library.read',
path: `/v1/files/${encodeURIComponent(fileKey)}/styles`,
})
return {
fileKey,
items: mapStyleList(result.body),
}
}
/**
* List published styles in a Figma file.
* @example
* import listFileStyles from 'kody:@kody/figma/list-file-styles'
* const result = await listFileStyles({ fileKey: 'abc123' })
*/
export default async function listFileStylesEntrypoint(
params: Partial<ListFileStylesInput> & Record<string, unknown> = {},
) {
const input = requireRecord(params, 'list-file-styles')
return listFileStyles({
fileKey: String(input.fileKey ?? input.fileUrl ?? ''),
integrationName: optionalString(input.integrationName, 'integrationName'),
integration: optionalString(input.integration, 'integration'),
account: optionalString(input.account, 'account'),
secretName: optionalString(input.secretName, 'secretName'),
auth: requireAuthMode(input.auth),
})
}