feat: full Figma REST API coverage (46/46 endpoints) (#1)

* feat: expand Figma REST API coverage to 46/46 endpoints (100%)

Add 38 new endpoints covering the complete Figma REST API v0.36.0:

- User: GET /me
- Files: HEAD /files/:key, GET /files/:key/images, GET /files/:key/versions,
  GET /files/:key/variables/published
- Comments: GET/POST/DELETE /files/:key/comments
- Components: GET /components/:key, GET /teams/:id/components
- Component Sets: GET /component_sets/:key, GET /files/:key/component_sets,
  GET /teams/:id/component_sets
- Styles: GET /styles/:key, GET /teams/:id/styles
- Projects: GET /teams/:id/projects, GET /projects/:id/files
- Reactions: GET/POST/DELETE /files/:key/comments/:id/reactions
- Dev Resources: GET/POST/PUT/DELETE /files/:key/dev_resources
- Webhooks (v2): GET/POST/PUT/DELETE /v2/webhooks, GET /v2/teams/:id/webhooks,
  GET /v2/webhooks/:id/requests
- Analytics: activity_logs, payments, library component/style/variable
  actions and usages

Refactor baseURL from https://api.figma.com/v1/ to https://api.figma.com/
so endpoints can target both v1 and v2 paths. This is an internal change
with no impact on the public API.

Add PaginationParams for cursor-based team endpoints, EmptyResponse for
DELETE operations, and 22 new JSON fixtures with 290 total test cases.

* fix: align endpoints with Figma REST API spec and fix critical bugs

- Fix DELETE endpoints crashing on empty 204 No Content responses by
  adding explicit content(from:with:) that handles empty body
- Fix POST/PUT dev_resources to use correct path /v1/dev_resources with
  batch request/response wrapping (dev_resources/links_created/links_updated)
- Fix PostDevResourceBody to include required file_key field per spec
- Fix PutDevResourceBody to match spec (remove dev_status, keep id/name/url)
- Fix GetPaymentsEndpoint to use query params per spec instead of path params
- Fix GetWebhooksEndpoint to use query params (context, context_id) per spec
- Fix GetActivityLogsEndpoint to use correct query filters per spec
- Fix GetFileMetaEndpointTests for Linux FoundationNetworking compatibility
- Remove incorrect @available deprecation from GetTeamWebhooksEndpoint
- Add pageSize validation precondition to PaginationParams
- Narrow Codable to Decodable for read-only models (Webhook, DevResource,
  FileVersion, ComponentSet, User)

* fix: expose FigmaClient.baseURL as public constant

Prevents downstream clients (e.g. ExFig) from hardcoding the base URL
in their mock clients, which would silently break when the URL format
changes (as it did when moving version prefix into individual endpoints).

Author: alexey1312

README.md

@@ -9,10 +9,11 @@ A Swift client for the [Figma REST API](https://www.figma.com/developers/api) wi
 
 ## Features
 
-- 8 Figma API endpoints (files, components, nodes, images, styles, variables)
+- Full Figma REST API coverage (46 endpoints) — files, components, styles, variables, comments, webhooks, dev resources, analytics, and more
 - Token-bucket rate limiting with fair round-robin scheduling
 - Exponential backoff retry with jitter and `Retry-After` support
-- Figma Variables API (read + write codeSyntax)
+- Figma Variables API (read local, read published, write codeSyntax)
+- Support for both API v1 and v2 (webhooks)
 - GitHub Releases endpoint (for version checking)
 - Swift 6 strict concurrency
 
@@ -47,12 +48,18 @@ Then add `FigmaAPI` to your target dependencies:
 ```swift
 import FigmaAPI
 
-// Create a client with your Figma personal access token
+// Create a client
+let figma = FigmaClient(accessToken: "your-figma-token", timeout: nil)
+
+// Wrap with rate limiting and retry
+let rateLimiter = SharedRateLimiter()
 let client = RateLimitedClient(
-    inner: FigmaClient(accessToken: "your-figma-token")
+    client: figma,
+    rateLimiter: rateLimiter,
+    configID: "default"
 )
 
-// Fetch components
+// Fetch components from a file
 let components = try await client.request(
     ComponentsEndpoint(fileId: "your-file-id")
 )
@@ -64,8 +71,22 @@ let variables = try await client.request(
 
 // Export images as SVG
 let images = try await client.request(
-    ImageEndpoint(fileId: "your-file-id", nodeIds: ["1:2", "3:4"], format: .svg)
+    ImageEndpoint(fileId: "your-file-id", nodeIds: ["1:2", "3:4"], params: SVGParams())
 )
+
+// Get current user
+let me = try await client.request(GetMeEndpoint())
+
+// Post a comment
+let comment = try await client.request(
+    PostCommentEndpoint(
+        fileId: "your-file-id",
+        body: PostCommentBody(message: "Looks great!")
+    )
+)
+
+// List webhooks (v2 API)
+let webhooks = try await client.request(GetWebhooksEndpoint())
 ```
 
 ## License

Sources/FigmaAPI/Endpoint/BaseEndpoint.swift

@@ -37,3 +37,4 @@ extension BaseEndpoint {
         }
     }
 }
+

Sources/FigmaAPI/Endpoint/ComponentsEndpoint.swift

@@ -18,6 +18,7 @@ public struct ComponentsEndpoint: BaseEndpoint {
 
     public func makeRequest(baseURL: URL) -> URLRequest {
         let url = baseURL
+            .appendingPathComponent("v1")
             .appendingPathComponent("files")
             .appendingPathComponent(fileId)
             .appendingPathComponent("components")

Sources/FigmaAPI/Endpoint/DeleteCommentEndpoint.swift

@@ -0,0 +1,34 @@
+import Foundation
+import YYJSON
+#if canImport(FoundationNetworking)
+    import FoundationNetworking
+#endif
+
+public struct DeleteCommentEndpoint: BaseEndpoint {
+    public typealias Content = EmptyResponse
+
+    private let fileId: String
+    private let commentId: String
+
+    public init(fileId: String, commentId: String) {
+        self.fileId = fileId
+        self.commentId = commentId
+    }
+
+    public func makeRequest(baseURL: URL) -> URLRequest {
+        let url = baseURL
+            .appendingPathComponent("v1")
+            .appendingPathComponent("files")
+            .appendingPathComponent(fileId)
+            .appendingPathComponent("comments")
+            .appendingPathComponent(commentId)
+        var request = URLRequest(url: url)
+        request.httpMethod = "DELETE"
+        return request
+    }
+
+    public func content(from _: URLResponse?, with body: Data) throws -> EmptyResponse {
+        if body.isEmpty { return EmptyResponse() }
+        return try YYJSONDecoder().decode(EmptyResponse.self, from: body)
+    }
+}

Sources/FigmaAPI/Endpoint/DeleteDevResourceEndpoint.swift

@@ -0,0 +1,34 @@
+import Foundation
+import YYJSON
+#if canImport(FoundationNetworking)
+    import FoundationNetworking
+#endif
+
+public struct DeleteDevResourceEndpoint: BaseEndpoint {
+    public typealias Content = EmptyResponse
+
+    private let fileId: String
+    private let resourceId: String
+
+    public init(fileId: String, resourceId: String) {
+        self.fileId = fileId
+        self.resourceId = resourceId
+    }
+
+    public func makeRequest(baseURL: URL) -> URLRequest {
+        let url = baseURL
+            .appendingPathComponent("v1")
+            .appendingPathComponent("files")
+            .appendingPathComponent(fileId)
+            .appendingPathComponent("dev_resources")
+            .appendingPathComponent(resourceId)
+        var request = URLRequest(url: url)
+        request.httpMethod = "DELETE"
+        return request
+    }
+
+    public func content(from _: URLResponse?, with body: Data) throws -> EmptyResponse {
+        if body.isEmpty { return EmptyResponse() }
+        return try YYJSONDecoder().decode(EmptyResponse.self, from: body)
+    }
+}

Sources/FigmaAPI/Endpoint/DeleteReactionEndpoint.swift

@@ -0,0 +1,44 @@
+import Foundation
+import YYJSON
+#if canImport(FoundationNetworking)
+    import FoundationNetworking
+#endif
+
+public struct DeleteReactionEndpoint: BaseEndpoint {
+    public typealias Content = EmptyResponse
+
+    private let fileId: String
+    private let commentId: String
+    private let emoji: String
+
+    public init(fileId: String, commentId: String, emoji: String) {
+        self.fileId = fileId
+        self.commentId = commentId
+        self.emoji = emoji
+    }
+
+    public func makeRequest(baseURL: URL) throws -> URLRequest {
+        let url = baseURL
+            .appendingPathComponent("v1")
+            .appendingPathComponent("files")
+            .appendingPathComponent(fileId)
+            .appendingPathComponent("comments")
+            .appendingPathComponent(commentId)
+            .appendingPathComponent("reactions")
+        guard var comps = URLComponents(url: url, resolvingAgainstBaseURL: false) else {
+            throw URLError(.badURL)
+        }
+        comps.queryItems = [URLQueryItem(name: "emoji", value: emoji)]
+        guard let finalURL = comps.url else {
+            throw URLError(.badURL)
+        }
+        var request = URLRequest(url: finalURL)
+        request.httpMethod = "DELETE"
+        return request
+    }
+
+    public func content(from _: URLResponse?, with body: Data) throws -> EmptyResponse {
+        if body.isEmpty { return EmptyResponse() }
+        return try YYJSONDecoder().decode(EmptyResponse.self, from: body)
+    }
+}

Sources/FigmaAPI/Endpoint/DeleteWebhookEndpoint.swift

@@ -0,0 +1,30 @@
+import Foundation
+import YYJSON
+#if canImport(FoundationNetworking)
+    import FoundationNetworking
+#endif
+
+public struct DeleteWebhookEndpoint: BaseEndpoint {
+    public typealias Content = EmptyResponse
+
+    private let webhookId: String
+
+    public init(webhookId: String) {
+        self.webhookId = webhookId
+    }
+
+    public func makeRequest(baseURL: URL) -> URLRequest {
+        let url = baseURL
+            .appendingPathComponent("v2")
+            .appendingPathComponent("webhooks")
+            .appendingPathComponent(webhookId)
+        var request = URLRequest(url: url)
+        request.httpMethod = "DELETE"
+        return request
+    }
+
+    public func content(from _: URLResponse?, with body: Data) throws -> EmptyResponse {
+        if body.isEmpty { return EmptyResponse() }
+        return try YYJSONDecoder().decode(EmptyResponse.self, from: body)
+    }
+}

Sources/FigmaAPI/Endpoint/FileMetadataEndpoint.swift

@@ -16,6 +16,7 @@ public struct FileMetadataEndpoint: BaseEndpoint {
 
     public func makeRequest(baseURL: URL) throws -> URLRequest {
         let url = baseURL
+            .appendingPathComponent("v1")
             .appendingPathComponent("files")
             .appendingPathComponent(fileId)
 

Sources/FigmaAPI/Endpoint/GetActivityLogsEndpoint.swift

@@ -0,0 +1,60 @@
+import Foundation
+#if canImport(FoundationNetworking)
+    import FoundationNetworking
+#endif
+
+public struct GetActivityLogsEndpoint: BaseEndpoint {
+    public typealias Content = [ActivityLog]
+
+    private let events: String?
+    private let startTime: Double?
+    private let endTime: Double?
+    private let limit: Int?
+    private let order: String?
+
+    public init(
+        events: String? = nil,
+        startTime: Double? = nil,
+        endTime: Double? = nil,
+        limit: Int? = nil,
+        order: String? = nil
+    ) {
+        self.events = events
+        self.startTime = startTime
+        self.endTime = endTime
+        self.limit = limit
+        self.order = order
+    }
+
+    func content(from root: ActivityLogsResponse) -> [ActivityLog] {
+        root.activityLogs
+    }
+
+    public func makeRequest(baseURL: URL) throws -> URLRequest {
+        let url = baseURL
+            .appendingPathComponent("v1")
+            .appendingPathComponent("activity_logs")
+        guard var comps = URLComponents(url: url, resolvingAgainstBaseURL: false) else {
+            throw URLError(.badURL)
+        }
+        var items: [URLQueryItem] = []
+        if let events { items.append(URLQueryItem(name: "events", value: events)) }
+        if let startTime { items.append(URLQueryItem(name: "start_time", value: "\(startTime)")) }
+        if let endTime { items.append(URLQueryItem(name: "end_time", value: "\(endTime)")) }
+        if let limit { items.append(URLQueryItem(name: "limit", value: "\(limit)")) }
+        if let order { items.append(URLQueryItem(name: "order", value: order)) }
+        if !items.isEmpty { comps.queryItems = items }
+        guard let finalURL = comps.url else {
+            throw URLError(.badURL)
+        }
+        return URLRequest(url: finalURL)
+    }
+}
+
+struct ActivityLogsResponse: Decodable {
+    let activityLogs: [ActivityLog]
+
+    private enum CodingKeys: String, CodingKey {
+        case activityLogs = "activity_logs"
+    }
+}

Sources/FigmaAPI/Endpoint/GetCommentsEndpoint.swift

@@ -0,0 +1,31 @@
+import Foundation
+#if canImport(FoundationNetworking)
+    import FoundationNetworking
+#endif
+
+public struct GetCommentsEndpoint: BaseEndpoint {
+    public typealias Content = [Comment]
+
+    private let fileId: String
+
+    public init(fileId: String) {
+        self.fileId = fileId
+    }
+
+    func content(from root: CommentsResponse) -> [Comment] {
+        root.comments
+    }
+
+    public func makeRequest(baseURL: URL) -> URLRequest {
+        let url = baseURL
+            .appendingPathComponent("v1")
+            .appendingPathComponent("files")
+            .appendingPathComponent(fileId)
+            .appendingPathComponent("comments")
+        return URLRequest(url: url)
+    }
+}
+
+struct CommentsResponse: Decodable {
+    let comments: [Comment]
+}