@utdk/figma 0.37.0-20260408.5-dev.646adf4

package/docs/files.md

@@ -0,0 +1,216 @@
+# Files
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getFile`
+
+- **HTTP**: `GET /v1/files/{file_key}`
+- **What it does**: Get file JSON
+- **OpenAPI operationId**: `getFile`
+- **Path params**: `file_key`
+- **Query params**: `version`, `ids`, `depth`, `geometry`, `plugin_data`, `branch_data`
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; version?: string; ids?: string; depth?: number; geometry?: string; plugin_data?: string; branch_data?: boolean }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ name: string; role: "owner" | "editor" | "viewer"; lastModified: string; editorType: "figma" | "figjam"; thumbnailUrl?: string; version: string; document: { type: "DOCUMENT"; children: ({ type: "CANVAS"; children: ({ ...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetFileInput = Parameters<typeof figma.getFile> extends [infer T, ...unknown[]] ? T : undefined;
+type GetFileOutput = Awaited<ReturnType<typeof figma.getFile>>;
+
+const input: GetFileInput = {} as { file_key: string; version?: string; ids?: string; depth?: number; geometry?: string; plugin_data?: string; branch_data?: boolean };
+const result: GetFileOutput = await figma.getFile(input);
+
+// Result shape (from schema): { name: string; role: "owner" | "editor" | "viewer"; lastModified: string; editorType: "figma" | "figjam"; thumbnailUrl?: string; version: string; document: { type: "DOCUMENT"; children: ({ type: "CANVAS"; children: ({ ...
+```
+
+### `figma.getImageFills`
+
+- **HTTP**: `GET /v1/files/{file_key}/images`
+- **What it does**: Get image fills
+- **OpenAPI operationId**: `getImageFills`
+- **Path params**: `file_key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ error: false; status: 200; meta: { images: { [key: string]: string | undefined } } }`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetImageFillsInput = Parameters<typeof figma.getImageFills> extends [infer T, ...unknown[]] ? T : undefined;
+type GetImageFillsOutput = Awaited<ReturnType<typeof figma.getImageFills>>;
+
+const input: GetImageFillsInput = {} as { file_key: string };
+const result: GetImageFillsOutput = await figma.getImageFills(input);
+
+// Result shape (from schema): { error: false; status: 200; meta: { images: { [key: string]: string | undefined } } }
+```
+
+### `figma.getFileMeta`
+
+- **HTTP**: `GET /v1/files/{file_key}/meta`
+- **What it does**: Get file metadata
+- **OpenAPI operationId**: `getFileMeta`
+- **Path params**: `file_key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ name: string; folder_name?: string; last_touched_at: string; creator: { id: string; handle: string; img_url: string }; last_touched_by?: { id: string; handle: string; img_url: string }; thumbnail_url?: string; editorT...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetFileMetaInput = Parameters<typeof figma.getFileMeta> extends [infer T, ...unknown[]] ? T : undefined;
+type GetFileMetaOutput = Awaited<ReturnType<typeof figma.getFileMeta>>;
+
+const input: GetFileMetaInput = {} as { file_key: string };
+const result: GetFileMetaOutput = await figma.getFileMeta(input);
+
+// Result shape (from schema): { name: string; folder_name?: string; last_touched_at: string; creator: { id: string; handle: string; img_url: string }; last_touched_by?: { id: string; handle: string; img_url: string }; thumbnail_url?: string; editorT...
+```
+
+### `figma.getFileNodes`
+
+- **HTTP**: `GET /v1/files/{file_key}/nodes`
+- **What it does**: Get file JSON for specific nodes
+- **OpenAPI operationId**: `getFileNodes`
+- **Path params**: `file_key`
+- **Query params**: `ids`, `version`, `depth`, `geometry`, `plugin_data`
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; ids: string; version?: string; depth?: number; geometry?: string; plugin_data?: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ name: string; role: "owner" | "editor" | "viewer"; lastModified: string; editorType: "figma" | "figjam"; thumbnailUrl: string; version: string; nodes: { [key: string]: { document: { type: "BOOLEAN_OPERATION"; booleanO...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetFileNodesInput = Parameters<typeof figma.getFileNodes> extends [infer T, ...unknown[]] ? T : undefined;
+type GetFileNodesOutput = Awaited<ReturnType<typeof figma.getFileNodes>>;
+
+const input: GetFileNodesInput = {} as { file_key: string; ids: string; version?: string; depth?: number; geometry?: string; plugin_data?: string };
+const result: GetFileNodesOutput = await figma.getFileNodes(input);
+
+// Result shape (from schema): { name: string; role: "owner" | "editor" | "viewer"; lastModified: string; editorType: "figma" | "figjam"; thumbnailUrl: string; version: string; nodes: { [key: string]: { document: { type: "BOOLEAN_OPERATION"; booleanO...
+```
+
+### `figma.getFileVersions`
+
+- **HTTP**: `GET /v1/files/{file_key}/versions`
+- **What it does**: Get versions of a file
+- **OpenAPI operationId**: `getFileVersions`
+- **Path params**: `file_key`
+- **Query params**: `page_size`, `before`, `after`
+- **Response codes**: `200`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; page_size?: number; before?: number; after?: number }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ versions: ({ id: string; created_at: string; label: string | null; description: string | null; user: { id: string; handle: string; img_url: string }; thumbnail_url?: string })[]; pagination: { prev_page?: string; next...`
+- OpenAPI response codes: `200`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetFileVersionsInput = Parameters<typeof figma.getFileVersions> extends [infer T, ...unknown[]] ? T : undefined;
+type GetFileVersionsOutput = Awaited<ReturnType<typeof figma.getFileVersions>>;
+
+const input: GetFileVersionsInput = {} as { file_key: string; page_size?: number; before?: number; after?: number };
+const result: GetFileVersionsOutput = await figma.getFileVersions(input);
+
+// Result shape (from schema): { versions: ({ id: string; created_at: string; label: string | null; description: string | null; user: { id: string; handle: string; img_url: string }; thumbnail_url?: string })[]; pagination: { prev_page?: string; next...
+```
+
+### `figma.getImages`
+
+- **HTTP**: `GET /v1/images/{file_key}`
+- **What it does**: Render images of file nodes
+- **OpenAPI operationId**: `getImages`
+- **Path params**: `file_key`
+- **Query params**: `ids`, `version`, `scale`, `format`, `svg_outline_text`, `svg_include_id`, `svg_include_node_id`, `svg_simplify_stroke`, `contents_only`, `use_absolute_bounds`
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; ids: string; version?: string; scale?: number; format?: "jpg" | "png" | "svg" | "pdf"; svg_outline_text?: boolean; svg_include_id?: boolean; svg_include_node_id?: boolean; svg_simplify_stroke?: boolean; contents_only?: boolean; use_absolute_bounds?: boolean }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ err: null; images: { [key: string]: string | null | undefined } }`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetImagesInput = Parameters<typeof figma.getImages> extends [infer T, ...unknown[]] ? T : undefined;
+type GetImagesOutput = Awaited<ReturnType<typeof figma.getImages>>;
+
+const input: GetImagesInput = {} as { file_key: string; ids: string; version?: string; scale?: number; format?: "jpg" | "png" | "svg" | "pdf"; svg_outline_text?: boolean; svg_include_id?: boolean; svg_include_node_id?: boolean; svg_simplify_stroke?: boolean; contents_only?: boolean; use_absolute_bounds?: boolean };
+const result: GetImagesOutput = await figma.getImages(input);
+
+// Result shape (from schema): { err: null; images: { [key: string]: string | null | undefined } }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/library-analytics.md

@@ -0,0 +1,216 @@
+# Library Analytics
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getLibraryAnalyticsComponentActions`
+
+- **HTTP**: `GET /v1/analytics/libraries/{file_key}/component/actions`
+- **What it does**: Get library analytics component action data.
+- **OpenAPI operationId**: `getLibraryAnalyticsComponentActions`
+- **Path params**: `file_key`
+- **Query params**: `cursor`, `group_by`, `start_date`, `end_date`
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; cursor?: string; group_by: "component" | "team"; start_date?: string; end_date?: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ rows: ({ week: string; component_key: string; component_name: string; component_set_key?: string; component_set_name?: string; detachments: number; insertions: number })[] | ({ week: string; team_name: string; workspa...`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetLibraryAnalyticsComponentActionsInput = Parameters<typeof figma.getLibraryAnalyticsComponentActions> extends [infer T, ...unknown[]] ? T : undefined;
+type GetLibraryAnalyticsComponentActionsOutput = Awaited<ReturnType<typeof figma.getLibraryAnalyticsComponentActions>>;
+
+const input: GetLibraryAnalyticsComponentActionsInput = {} as { file_key: string; cursor?: string; group_by: "component" | "team"; start_date?: string; end_date?: string };
+const result: GetLibraryAnalyticsComponentActionsOutput = await figma.getLibraryAnalyticsComponentActions(input);
+
+// Result shape (from schema): { rows: ({ week: string; component_key: string; component_name: string; component_set_key?: string; component_set_name?: string; detachments: number; insertions: number })[] | ({ week: string; team_name: string; workspa...
+```
+
+### `figma.getLibraryAnalyticsComponentUsages`
+
+- **HTTP**: `GET /v1/analytics/libraries/{file_key}/component/usages`
+- **What it does**: Get library analytics component usage data.
+- **OpenAPI operationId**: `getLibraryAnalyticsComponentUsages`
+- **Path params**: `file_key`
+- **Query params**: `cursor`, `group_by`
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; cursor?: string; group_by: "component" | "file" }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ rows: ({ component_key: string; component_name: string; component_set_key?: string; component_set_name?: string; usages: number; teams_using: number; files_using: number })[] | ({ file_name: string; team_name: string;...`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetLibraryAnalyticsComponentUsagesInput = Parameters<typeof figma.getLibraryAnalyticsComponentUsages> extends [infer T, ...unknown[]] ? T : undefined;
+type GetLibraryAnalyticsComponentUsagesOutput = Awaited<ReturnType<typeof figma.getLibraryAnalyticsComponentUsages>>;
+
+const input: GetLibraryAnalyticsComponentUsagesInput = {} as { file_key: string; cursor?: string; group_by: "component" | "file" };
+const result: GetLibraryAnalyticsComponentUsagesOutput = await figma.getLibraryAnalyticsComponentUsages(input);
+
+// Result shape (from schema): { rows: ({ component_key: string; component_name: string; component_set_key?: string; component_set_name?: string; usages: number; teams_using: number; files_using: number })[] | ({ file_name: string; team_name: string;...
+```
+
+### `figma.getLibraryAnalyticsStyleActions`
+
+- **HTTP**: `GET /v1/analytics/libraries/{file_key}/style/actions`
+- **What it does**: Get library analytics style action data.
+- **OpenAPI operationId**: `getLibraryAnalyticsStyleActions`
+- **Path params**: `file_key`
+- **Query params**: `cursor`, `group_by`, `start_date`, `end_date`
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; cursor?: string; group_by: "style" | "team"; start_date?: string; end_date?: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ rows: ({ week: string; style_key: string; style_name: string; style_type: string; detachments: number; insertions: number })[] | ({ week: string; team_name: string; workspace_name?: string; detachments: number; insert...`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetLibraryAnalyticsStyleActionsInput = Parameters<typeof figma.getLibraryAnalyticsStyleActions> extends [infer T, ...unknown[]] ? T : undefined;
+type GetLibraryAnalyticsStyleActionsOutput = Awaited<ReturnType<typeof figma.getLibraryAnalyticsStyleActions>>;
+
+const input: GetLibraryAnalyticsStyleActionsInput = {} as { file_key: string; cursor?: string; group_by: "style" | "team"; start_date?: string; end_date?: string };
+const result: GetLibraryAnalyticsStyleActionsOutput = await figma.getLibraryAnalyticsStyleActions(input);
+
+// Result shape (from schema): { rows: ({ week: string; style_key: string; style_name: string; style_type: string; detachments: number; insertions: number })[] | ({ week: string; team_name: string; workspace_name?: string; detachments: number; insert...
+```
+
+### `figma.getLibraryAnalyticsStyleUsages`
+
+- **HTTP**: `GET /v1/analytics/libraries/{file_key}/style/usages`
+- **What it does**: Get library analytics style usage data.
+- **OpenAPI operationId**: `getLibraryAnalyticsStyleUsages`
+- **Path params**: `file_key`
+- **Query params**: `cursor`, `group_by`
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; cursor?: string; group_by: "style" | "file" }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ rows: ({ style_key: string; style_name: string; style_type: string; usages: number; teams_using: number; files_using: number })[] | ({ file_name: string; team_name: string; workspace_name?: string; usages: number })[]...`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetLibraryAnalyticsStyleUsagesInput = Parameters<typeof figma.getLibraryAnalyticsStyleUsages> extends [infer T, ...unknown[]] ? T : undefined;
+type GetLibraryAnalyticsStyleUsagesOutput = Awaited<ReturnType<typeof figma.getLibraryAnalyticsStyleUsages>>;
+
+const input: GetLibraryAnalyticsStyleUsagesInput = {} as { file_key: string; cursor?: string; group_by: "style" | "file" };
+const result: GetLibraryAnalyticsStyleUsagesOutput = await figma.getLibraryAnalyticsStyleUsages(input);
+
+// Result shape (from schema): { rows: ({ style_key: string; style_name: string; style_type: string; usages: number; teams_using: number; files_using: number })[] | ({ file_name: string; team_name: string; workspace_name?: string; usages: number })[]...
+```
+
+### `figma.getLibraryAnalyticsVariableActions`
+
+- **HTTP**: `GET /v1/analytics/libraries/{file_key}/variable/actions`
+- **What it does**: Get library analytics variable action data.
+- **OpenAPI operationId**: `getLibraryAnalyticsVariableActions`
+- **Path params**: `file_key`
+- **Query params**: `cursor`, `group_by`, `start_date`, `end_date`
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; cursor?: string; group_by: "variable" | "team"; start_date?: string; end_date?: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ rows: ({ week: string; variable_key: string; variable_name: string; variable_type: string; collection_key: string; collection_name: string; detachments: number; insertions: number })[] | ({ week: string; team_name: st...`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetLibraryAnalyticsVariableActionsInput = Parameters<typeof figma.getLibraryAnalyticsVariableActions> extends [infer T, ...unknown[]] ? T : undefined;
+type GetLibraryAnalyticsVariableActionsOutput = Awaited<ReturnType<typeof figma.getLibraryAnalyticsVariableActions>>;
+
+const input: GetLibraryAnalyticsVariableActionsInput = {} as { file_key: string; cursor?: string; group_by: "variable" | "team"; start_date?: string; end_date?: string };
+const result: GetLibraryAnalyticsVariableActionsOutput = await figma.getLibraryAnalyticsVariableActions(input);
+
+// Result shape (from schema): { rows: ({ week: string; variable_key: string; variable_name: string; variable_type: string; collection_key: string; collection_name: string; detachments: number; insertions: number })[] | ({ week: string; team_name: st...
+```
+
+### `figma.getLibraryAnalyticsVariableUsages`
+
+- **HTTP**: `GET /v1/analytics/libraries/{file_key}/variable/usages`
+- **What it does**: Get library analytics variable usage data.
+- **OpenAPI operationId**: `getLibraryAnalyticsVariableUsages`
+- **Path params**: `file_key`
+- **Query params**: `cursor`, `group_by`
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; cursor?: string; group_by: "variable" | "file" }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ rows: ({ variable_key: string; variable_name: string; variable_type: string; collection_key: string; collection_name: string; usages: number; teams_using: number; files_using: number })[] | ({ file_name: string; team_...`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetLibraryAnalyticsVariableUsagesInput = Parameters<typeof figma.getLibraryAnalyticsVariableUsages> extends [infer T, ...unknown[]] ? T : undefined;
+type GetLibraryAnalyticsVariableUsagesOutput = Awaited<ReturnType<typeof figma.getLibraryAnalyticsVariableUsages>>;
+
+const input: GetLibraryAnalyticsVariableUsagesInput = {} as { file_key: string; cursor?: string; group_by: "variable" | "file" };
+const result: GetLibraryAnalyticsVariableUsagesOutput = await figma.getLibraryAnalyticsVariableUsages(input);
+
+// Result shape (from schema): { rows: ({ variable_key: string; variable_name: string; variable_type: string; collection_key: string; collection_name: string; usages: number; teams_using: number; files_using: number })[] | ({ file_name: string; team_...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/oembed.md

@@ -0,0 +1,46 @@
+# OEmbed
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getOEmbed`
+
+- **HTTP**: `GET /v1/oembed`
+- **What it does**: Get oEmbed data
+- **OpenAPI operationId**: `getOEmbed`
+- **Path params**: None
+- **Query params**: `url`, `maxwidth`, `maxheight`
+- **Response codes**: `200`, `400`, `404`, `429`, `501`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ url: string; maxwidth?: number; maxheight?: number }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ version: string; type: string; title: string; key?: string; url: string; provider_name: string; provider_url: string; cache_age: number; width: number; height: number; html: string; is_published_site?: boolean; folder...`
+- OpenAPI response codes: `200`, `400`, `404`, `429`, `501`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetOEmbedInput = Parameters<typeof figma.getOEmbed> extends [infer T, ...unknown[]] ? T : undefined;
+type GetOEmbedOutput = Awaited<ReturnType<typeof figma.getOEmbed>>;
+
+const input: GetOEmbedInput = {} as { url: string; maxwidth?: number; maxheight?: number };
+const result: GetOEmbedOutput = await figma.getOEmbed(input);
+
+// Result shape (from schema): { version: string; type: string; title: string; key?: string; url: string; provider_name: string; provider_url: string; cache_age: number; width: number; height: number; html: string; is_published_site?: boolean; folder...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/payments.md

@@ -0,0 +1,46 @@
+# Payments
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getPayments`
+
+- **HTTP**: `GET /v1/payments`
+- **What it does**: Get payments
+- **OpenAPI operationId**: `getPayments`
+- **Path params**: None
+- **Query params**: `plugin_payment_token`, `user_id`, `community_file_id`, `plugin_id`, `widget_id`
+- **Response codes**: `200`, `401`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ plugin_payment_token?: string; user_id?: string; community_file_id?: string; plugin_id?: string; widget_id?: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { user_id: string; resource_id: string; resource_type: "PLUGIN" | "WIDGET" | "COMMUNITY_FILE"; payment_status: { type?: "UNPAID" | "PAID" | "TRIAL" }; date_of_purchase?: string } }`
+- OpenAPI response codes: `200`, `401`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetPaymentsInput = Parameters<typeof figma.getPayments> extends [infer T, ...unknown[]] ? T : undefined;
+type GetPaymentsOutput = Awaited<ReturnType<typeof figma.getPayments>>;
+
+const input: GetPaymentsInput = {} as { plugin_payment_token?: string; user_id?: string; community_file_id?: string; plugin_id?: string; widget_id?: string };
+const result: GetPaymentsOutput = await figma.getPayments(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { user_id: string; resource_id: string; resource_type: "PLUGIN" | "WIDGET" | "COMMUNITY_FILE"; payment_status: { type?: "UNPAID" | "PAID" | "TRIAL" }; date_of_purchase?: string } }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/projects.md

@@ -0,0 +1,80 @@
+# Projects
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getProjectFiles`
+
+- **HTTP**: `GET /v1/projects/{project_id}/files`
+- **What it does**: Get files in a project
+- **OpenAPI operationId**: `getProjectFiles`
+- **Path params**: `project_id`
+- **Query params**: `branch_data`
+- **Response codes**: `200`, `400`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ project_id: string; branch_data?: boolean }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ name: string; files: ({ key: string; name: string; thumbnail_url?: string; last_modified: string })[] }`
+- OpenAPI response codes: `200`, `400`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetProjectFilesInput = Parameters<typeof figma.getProjectFiles> extends [infer T, ...unknown[]] ? T : undefined;
+type GetProjectFilesOutput = Awaited<ReturnType<typeof figma.getProjectFiles>>;
+
+const input: GetProjectFilesInput = {} as { project_id: string; branch_data?: boolean };
+const result: GetProjectFilesOutput = await figma.getProjectFiles(input);
+
+// Result shape (from schema): { name: string; files: ({ key: string; name: string; thumbnail_url?: string; last_modified: string })[] }
+```
+
+### `figma.getTeamProjects`
+
+- **HTTP**: `GET /v1/teams/{team_id}/projects`
+- **What it does**: Get projects in a team
+- **OpenAPI operationId**: `getTeamProjects`
+- **Path params**: `team_id`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ team_id: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ name: string; projects: ({ id: string; name: string })[] }`
+- OpenAPI response codes: `200`, `400`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetTeamProjectsInput = Parameters<typeof figma.getTeamProjects> extends [infer T, ...unknown[]] ? T : undefined;
+type GetTeamProjectsOutput = Awaited<ReturnType<typeof figma.getTeamProjects>>;
+
+const input: GetTeamProjectsInput = {} as { team_id: string };
+const result: GetTeamProjectsOutput = await figma.getTeamProjects(input);
+
+// Result shape (from schema): { name: string; projects: ({ id: string; name: string })[] }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->